project

type Entry struct {
	Kind   Kind   `yaml:"kind"`
	Client string `yaml:"client"`
	// Source names what is projected: the skill name for KindSkill, the
	// scope ("global") for KindContext.
	Source string `yaml:"source"`
	// Path is the absolute destination path gridctl wrote or created.
	Path string `yaml:"path"`

	// KindSkill attributes.
	Channel          string `yaml:"channel,omitempty"`
	CreatedByGridctl bool   `yaml:"created_by_gridctl,omitempty"`
	TreeHash         string `yaml:"tree_hash,omitempty"`
	// ChannelReason records why the CHANNEL diverges from what the user
	// or target table chose: ChannelReasonModelPolicy marks a skill
	// projection forced off symlink because its bytes carry a policy
	// rewrite. Empty when the channel is the user's own choice (a --copy
	// the policy merely rewrote keeps its empty reason, so the copy
	// stays sticky when the policy goes away). Absent in pre-existing
	// lockfiles, which migrate-on-read as empty.
	ChannelReason string `yaml:"channel_reason,omitempty"`
	// ModelValue records the model preference a policy rewrite wrote
	// into the projected bytes; non-empty is the "bytes are rewritten"
	// marker the preserve rule and adopt key on, and the value itself
	// lets adopt distinguish the policy's write from a deliberate user
	// edit of the same key. Empty for pass-through projections. Skill
	// and agent kinds both use it.
	ModelValue string `yaml:"model_value,omitempty"`

	// KindContext attributes.
	Strategy      string `yaml:"strategy,omitempty"`
	InstalledHash string `yaml:"installed_hash,omitempty"`
	CanonicalHash string `yaml:"canonical_hash,omitempty"`
	CreatedFile   bool   `yaml:"created_file,omitempty"`
	// InputHashes records, for a compiled context target, each input
	// fragment's canonical hash at sync time (fragment name -> hash), so
	// staleness can name which fragment moved instead of only "the
	// composite changed". Absent outside fragments mode.
	InputHashes map[string]string `yaml:"input_hashes,omitempty"`

	// KindWiring attributes. Path is the composite "<config path>#<entry
	// name>" (one config file legitimately holds several owned entries, and
	// the one-owner invariant keys on the full Path); ConfigPath is the real
	// file path so no consumer parses the composite. Hashes is the short
	// history of canonical value hashes gridctl wrote, newest last, so a
	// shape change by a newer gridctl never reads as user drift.
	ConfigPath string   `yaml:"config_path,omitempty"`
	Group      string   `yaml:"group,omitempty"`
	ClientID   string   `yaml:"client_id,omitempty"`
	Hashes     []string `yaml:"hashes,omitempty"`

	// Pack tags the projection with the pack that applied it (empty =
	// not pack-managed). Any kind may carry it; `gridctl pack` uses it
	// for scoped status and cascade removal.
	Pack string `yaml:"pack,omitempty"`

	SyncedAt time.Time `yaml:"synced_at"`

	Extra map[string]any `yaml:",inline"`
}

type Kind string

type Lock struct {
	// contains filtered or unexported fields
}

type LockFile struct {
	Version     int      `yaml:"version"`
	Revision    int      `yaml:"revision"`
	Projections []*Entry `yaml:"projections"`

	Extra map[string]any `yaml:",inline"`
}

type LockfileState struct {
	// UnifiedPath is where the unified lockfile lives (or will live).
	UnifiedPath string
	// Unified reports whether the unified lockfile exists.
	Unified bool
	// LegacySkill and LegacyContext report live (version 1) legacy
	// lockfiles awaiting migration.
	LegacySkill   bool
	LegacyContext bool
	// Tombstones lists legacy paths already tombstoned by a migration.
	Tombstones []string
	// BackupRoot is where migration backups are kept.
	BackupRoot string
}

type Store struct {
	// contains filtered or unexported fields
}