skills

type Action string

type Change struct {
	Name   string
	Action Action
}

type Marker struct {
	SchemaVersion int               `json:"schema_version"`
	WBVersion     string            `json:"wb_version"`
	SyncedAt      time.Time         `json:"synced_at"`
	Skills        map[string]string `json:"skills"`
}

type Options struct {
	// Source is the embedded skill tree, rooted so each skill's files sit at
	// "<name>/...". Ordinarily fs.Sub(ai.SkillsFS, "skills").
	Source fs.FS
	// Dir is the harness skills directory to install into, e.g.
	// ~/.claude/skills, ~/.cursor/skills, or ~/.codex/skills.
	Dir string
	// WBVersion is the running wb build's version, recorded in the marker.
	WBVersion string
	// DryRun computes and returns the Report without writing, removing, or
	// touching the marker.
	DryRun bool
}

type Report struct {
	// Dir is the harness skills directory Sync targeted.
	Dir string
	// PriorWBVersion is the wb_version recorded in the marker before this
	// run, or "" when there was no marker (a first sync).
	PriorWBVersion string
	// WBVersion is the wb build that performed this sync, now recorded in
	// the marker (unless DryRun).
	WBVersion string
	// Changes covers every shipped skill plus every previously-installed
	// skill this build no longer ships, sorted by name.
	Changes []Change
	// DryRun reports whether this Report describes a plan rather than an
	// applied sync.
	DryRun bool
}

type Skill struct {
	Name string
	Hash string
}

type Status struct {
	// Installed reports whether a marker exists at all, i.e. `wb skills
	// sync` has run on this machine before.
	Installed bool
	// SyncedWBVersion is the wb_version recorded in the marker. Empty when
	// !Installed.
	SyncedWBVersion string
}