cmd

type CopyState struct {
	Hash     string    `json:"hash"`
	SyncedAt time.Time `json:"synced_at,omitempty"`
}

type ShadowInfo struct {
	SkillID string
	Slug    string
	OrgSlug string // winning org slug; empty for cross-org shadow on the loser side
}

type SkillConflictError struct {
	Slug           string // the slug that conflicted (the one the user tried to create)
	Source         string // "user" or "org" — where the conflicting skill lives
	OwnerOrOrgSlug string // org slug when Source=="org"; empty otherwise
	ServerMessage  string // verbatim server `message` if present
}

type SkillState string

type SkillStateInfo struct {
	// Name is the local directory name when the skill exists locally,
	// otherwise the server slug. Stable across server-side renames because
	// tracking matches by skill_id first.
	Name string

	State SkillState

	// Local is true when the skill has a directory on this machine.
	Local bool

	// Remote is the server-side view, if the server knows about this skill.
	// Nil for purely-local untracked directories.
	Remote *apiSkill

	// Marker is the sync.json entry for this skill, if one exists.
	Marker *SyncEntry

	// LocalHash is the Merkle hash of on-disk content. Empty when the skill
	// is not present locally.
	LocalHash string

	// The four divergence coordinates of the unified model. Meaningful only
	// when State == StateTracked; all false otherwise. Sourced is the
	// ownership axis; the other three are the orthogonal divergence flags.
	Sourced       bool // a Source/forked_from upstream pointer exists
	LocalDirty    bool // working ≠ base — I have edits not yet pushed
	RemoteMoved   bool // my_remote_head ≠ base — another of my machines pushed
	UpstreamMoved bool // forks only: the parent moved past upstream_base

	// Overlay marks the one-skill shape for non-owned skills: the marker
	// tracks the UPSTREAM id, local edits are an overlay backed up in a
	// hidden fork (cli-one-skill-overlay-and-lineage-split.md). For overlay
	// rows the matched remote IS the upstream, so RemoteMoved stays false;
	// standing divergence from the upstream is OverlayDiverged ("local
	// changes"), and UpstreamMoved means the upstream moved past the
	// baseline the user last incorporated.
	Overlay         bool
	OverlayDiverged bool // local ≠ upstream head — the user's standing edits
}

type SkillsetNotFoundError struct {
	RequestedSlug string
	Available     []string
}

type SyncEntry struct {
	SkillID     string `json:"skill_id"`
	Version     string `json:"version"`
	ContentHash string `json:"content_hash,omitempty"`
	Tool        string `json:"tool"`
	// Copies is the per-copy reconciliation ledger, keyed by absolute
	// skill-dir path. Seeded at marker creation (seedCopyLedgerFromDisk)
	// and maintained by the mirror (mirrorLocalSkills); used to tell which
	// agent copy of a skill diverged. Empty only for legacy markers, in
	// which case a divergence is surfaced for reconciliation rather than
	// guessed (never mtime, never the marker-wide hash). See
	// cli-per-copy-skill-divergence.md.
	Copies    map[string]CopyState `json:"copies,omitempty"`
	OwnerKind string               `json:"owner_kind,omitempty"` // "user" or "org"
	OwnerSlug string               `json:"owner_slug,omitempty"` // e.g. "chrismdp" or "cherrypick"
	// LocalAlias is the on-disk directory name when it differs from
	// the server slug. Set by `airskills add --as <alias>` and by the
	// on-disk migration when it has to disambiguate a rename
	// collision. Empty means "dir name matches server slug." The
	// marker stays the source of truth — see CLAUDE.md "Org
	// namespacing lives in the marker, not on disk."
	LocalAlias string       `json:"local_alias,omitempty"`
	Source     *skillSource `json:"source,omitempty"`
	// Backup references the hidden backup fork holding this skill's local
	// edits when the caller can't write the upstream. Only meaningful on
	// overlay markers (SkillID == the upstream's id). Cleared when the
	// edits land upstream (admin fold-in / accepted suggestion) or the
	// backup is promoted to a visible personal skill (upstream lost).
	Backup *backupRef `json:"backup,omitempty"`
	// ResolvedHash records the upstream content hash the user last
	// reviewed against via `airskills resolve`. Only meaningful for
	// sourced skills (Source != nil). Empty for owned skills, and for
	// sourced skills the user has never resolved against — in that
	// case the classifier treats any divergence as modified-pending.
	ResolvedHash    string `json:"resolved_hash,omitempty"`
	SuggestionID    string `json:"suggestion_id,omitempty"`
	SuggestDeclined bool   `json:"suggest_declined,omitempty"`
	// Deleted is set when the skill was transferred away and local edits
	// prevent removing the old dir. Pushes are blocked for deleted markers.
	Deleted bool   `json:"deleted,omitempty"`
	MovedTo string `json:"moved_to,omitempty"` // new dir name after transfer
}

type SyncState struct {
	Version int                   `json:"version"`
	Skills  map[string]*SyncEntry `json:"skills"`
	// LastSuggestionNotifyAt is the cutoff for printing suggestion
	// accept/decline notifications. Anything reviewed at or before this
	// has already been shown. Stateless alternative to tracking IDs.
	LastSuggestionNotifyAt string `json:"last_suggestion_notify_at,omitempty"`
}