skillsync

type Channel string

type Entry struct {
	// Channel is "symlink" or "copy".
	Channel Channel `yaml:"channel"`
	// Target is the absolute path gridctl created (the symlink itself or
	// the copied directory).
	Target string `yaml:"target"`
	// CreatedByGridctl marks the path as gridctl-owned. Always true for
	// recorded entries; present in the schema so a future adopt flow can
	// track foreign paths without a format break.
	CreatedByGridctl bool `yaml:"created_by_gridctl"`
	// TreeHash is the copied directory's tree hash at sync time (empty
	// for symlinks, whose content lives in the registry).
	TreeHash string    `yaml:"tree_hash,omitempty"`
	SyncedAt time.Time `yaml:"synced_at"`
}

type LockFile struct {
	Version int `yaml:"version"`
	// Projections maps skill name → client slug → entry.
	Projections map[string]map[string]*Entry `yaml:"projections"`
}

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"`
	State        string     `json:"state"`
	Detail       string     `json:"detail,omitempty"`
	Experimental bool       `json:"experimental,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
}

type SyncResult struct {
	Skill      string `json:"skill"`
	Client     string `json:"client"`
	Channel    string `json:"channel,omitempty"`
	Target     string `json:"target,omitempty"`
	Action     string `json:"action"`
	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
	// Experimental marks targets whose documented path rests on
	// unofficial sourcing; surfaced in status output.
	Experimental 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"`
}