skillsync

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

type AdoptResult struct {
	Skill  string `json:"skill"`
	Client string `json:"client"`
	// Target is the projected copy the files came from.
	Target string `json:"target"`
	// RegistryDir is the registry skill directory written into.
	RegistryDir string `json:"registry_dir"`
	// BackupFile is the SKILL.md.pre-<sha> backup written registry-side
	// before the overwrite (empty when SKILL.md did not change).
	BackupFile string `json:"backup_file,omitempty"`
	// ChangedFiles lists the relative paths written back.
	ChangedFiles []string `json:"changed_files"`
	// PolicyKeysRestored reports that the projected SKILL.md carried a
	// stack model preference rewrite whose keys were restored to the
	// author's declaration before write-back: policy-owned deltas are
	// never adopted into the registry canonical.
	PolicyKeysRestored bool `json:"policy_keys_restored,omitempty"`
}

type Channel string

type Entry struct {
	// Channel is "symlink" or "copy".
	Channel Channel
	// Target is the absolute path gridctl created (the symlink itself or
	// the copied directory).
	Target string
	// CreatedByGridctl marks the path as gridctl-owned. Always true for
	// recorded entries; adopt reads it to tell managed copies apart.
	CreatedByGridctl bool
	// TreeHash is the registry source tree's hash at sync time (empty
	// for symlinks, whose content lives in the registry). Staleness is
	// judged against it: the registry moved when they disagree.
	TreeHash string
	// InstalledHash is the projected tree's hash exactly as written.
	// Drift (a hand edit of the copy) is judged against it. For plain
	// pass-through copies it equals TreeHash; a model policy rewrite
	// diverges them. Empty in pre-rewrite lockfiles, which migrate on
	// read as equal to TreeHash (exactly the old content-identical
	// contract).
	InstalledHash string
	// ChannelReason marks a channel diverging from what the user or
	// target table chose: ChannelReasonModelPolicy when the projection
	// was forced off symlink because its bytes carry a policy rewrite.
	// Empty for a copy the user requested themselves (--copy stays
	// sticky even when a policy rewrite touches it).
	ChannelReason string
	// ModelValue is the model preference a policy rewrite wrote into the
	// projected SKILL.md; non-empty marks the bytes as rewritten (the
	// preserve rule and adopt key on it), and the value lets adopt tell
	// the policy's write apart from a deliberate user edit. Empty for
	// pass-through projections.
	ModelValue string
	// Pack tags the projection with the pack that applied it (empty =
	// not pack-managed).
	Pack     string
	SyncedAt time.Time
}

type LockFile struct {
	Version int
	// Projections maps skill name → client slug → entry.
	Projections map[string]map[string]*Entry
}

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

type ProjectionStatus struct {
	Skill   string `json:"skill"`
	Client  string `json:"client"`
	Channel string `json:"channel"`
	Target  string `json:"target"`
	// Render is always "identity" for skills (registry content is placed
	// as-is); present so JSON consumers see the same column the status
	// table renders across kinds.
	Render string `json:"render"`
	// ChannelReason marks a channel forced off the user's choice
	// ("model-policy" when the rewrite forced this projection from
	// symlink to copy); the status table renders it beside the channel.
	ChannelReason string `json:"channel_reason,omitempty"`
	// ModelValue is the model preference a policy rewrite wrote into
	// the projected bytes; empty for pass-through projections.
	ModelValue string     `json:"model_value,omitempty"`
	State      string     `json:"state"`
	Detail     string     `json:"detail,omitempty"`
	Unofficial bool       `json:"unofficial,omitempty"`
	SyncedAt   *time.Time `json:"synced_at,omitempty"`
}

type SkillSource interface {
	// GetSkill returns a skill by name (a copy).
	GetSkill(name string) (*registry.AgentSkill, error)
	// ActiveSkills returns skills with state "active" (copies).
	ActiveSkills() []*registry.AgentSkill
	// Dir returns the registry base directory (skills live under
	// Dir()/skills).
	Dir() string
}

type SyncOptions struct {
	// Clients restricts the pass to these target slugs. Empty means every
	// available target.
	Clients []string
	// Copy projects copies instead of symlinks (copy-forced targets copy
	// regardless).
	Copy bool
	// Force overwrites drifted copies and unmanaged destination paths
	// (after a timestamped backup).
	Force bool
	// DryRun reports the plan without writing anything.
	DryRun bool
	// Pack tags recorded projections with the applying pack. Empty keeps
	// any existing tag (a plain re-sync never strips pack ownership).
	Pack string
}

type SyncResult struct {
	Skill   string `json:"skill"`
	Client  string `json:"client"`
	Channel string `json:"channel,omitempty"`
	// Reason names why the channel or bytes diverged from pass-through
	// ("model-policy"); the CLI renders it beside the channel so a
	// forced flip is never silent.
	Reason string `json:"channel_reason,omitempty"`
	Target string `json:"target,omitempty"`
	Action string `json:"action"`
	// Detail carries advisory notes (model policy application or
	// preservation); empty otherwise.
	Detail     string `json:"detail,omitempty"`
	BackupPath string `json:"backup_path,omitempty"`
	Error      string `json:"error,omitempty"`
}

type Target struct {
	Slug string
	Name string
	// SkillsPath is the directory skills are projected into; each skill
	// becomes SkillsPath/<name> (a symlink or a copied directory).
	SkillsPath string
	// DetectDirs mark the client as initialized on this machine when any
	// of them exists. Sync refuses to create client config trees
	// wholesale, so these gate every write unless AlwaysAvailable is set.
	DetectDirs []string
	// AlwaysAvailable targets skip detection: the vendor-neutral
	// ~/.agents/skills interop dir is created on first projection because
	// gating on its existence would silently skip clients (Grok Build)
	// that read it without ever creating it.
	AlwaysAvailable bool
	// DefaultChannel is used when the user does not pass --copy.
	DefaultChannel Channel
	// ForcedChannel, when set, overrides both the default and --copy.
	// Antigravity is copy-forced until symlink discovery is verified on
	// its exact path (symlinks went undiscovered under a related Gemini
	// skills path; vercel-labs/skills#633).
	ForcedChannel Channel
	// Unofficial marks targets whose path rests on unofficial sourcing
	// rather than published client documentation. The projection is
	// supported; the path may move without an upstream release note.
	// Surfaced in status output so the caveat is never silent.
	Unofficial bool
}

type UnsyncOptions struct {
	// All removes every projection instead of named skills.
	All bool
	// Clients restricts removal to these target slugs.
	Clients []string
	// DryRun reports what would be removed without writing.
	DryRun bool
}

type UnsyncResult struct {
	Skill      string `json:"skill"`
	Client     string `json:"client"`
	Target     string `json:"target"`
	Action     string `json:"action"`
	BackupPath string `json:"backup_path,omitempty"`
}