skills

type Agent struct {
	// Name is what --agent matches, case-insensitively.
	Name string `json:"name"`
	// Home is the agent's directory relative to the scope root (".claude").
	// It is the directory whose EXISTENCE decides whether the default install
	// touches this agent at all.
	Home string `json:"home"`
	// Skills is the skill container inside Home ("skills").
	Skills string `json:"skills"`
}

type CollectionInfo struct {
	Slug      string   `json:"slug"`
	Label     string   `json:"label,omitempty"`
	Singular  string   `json:"singular,omitempty"`
	IDType    string   `json:"id_type,omitempty"`
	Ops       []string `json:"ops,omitempty"`      // create read update delete
	Features  []string `json:"features,omitempty"` // drafts versions upload trash auth folders
	KeyFields []string `json:"key_fields,omitempty"`
	Internal  bool     `json:"internal,omitempty"`
	// TotalDocs is negative when unknown.
	TotalDocs int `json:"total_docs,omitempty"`
}

type File struct {
	// Path is relative to the skill root, slash-separated ("SKILL.md",
	// "references/errors.md").
	Path string `json:"path"`
	// Data is the file's content.
	Data []byte `json:"-"`
	// SHA256 is the hex digest recorded in the install manifest.
	SHA256 string `json:"sha256"`
}

type FileResult struct {
	Path   string `json:"path"`
	Status string `json:"status"`
	Reason string `json:"reason,omitempty"`
}

type FileStatus struct {
	Path string `json:"path"`
	// State is "current" | "outdated" | "modified" | "missing" | "unknown".
	State string `json:"state"`
}

type GlobalInfo struct {
	Slug     string   `json:"slug"`
	Label    string   `json:"label,omitempty"`
	Features []string `json:"features,omitempty"`
}

type Manifest struct {
	CLIVersion        string            `json:"cli_version"`
	InstalledAt       string            `json:"installed_at"`
	Scope             string            `json:"scope"`
	Agents            []string          `json:"agents"`
	Profile           string            `json:"profile"`
	BaseURL           string            `json:"base_url"`
	DiscoveryRevision string            `json:"discovery_revision,omitempty"`
	Files             map[string]string `json:"files"`
}

type Options struct {
	// Scope is "" for the §14 default (project when a marker is found by
	// walking up from StartDir, else user).
	Scope Scope
	// StartDir is the working directory used for project detection.
	StartDir string
	// ProjectRoot overrides detection.
	ProjectRoot string
	// Home is the user's home directory. It is injected rather than looked up
	// so the whole package is testable and env-free.
	Home string
	// Agents selects agents by name. Empty means the §14 default: every agent
	// whose Home directory already exists.
	Agents []string
	// AllAgents is --agent all: install into every known agent, creating the
	// directories.
	AllAgents bool
	// ExtraDirs are --dir PATH and skills.extra_dirs. Each is an agent's
	// skills directory; the skill lands in <dir>/pay.
	ExtraDirs []string
	// Force overwrites files the user edited.
	Force bool
	// DryRun computes the plan without touching the filesystem.
	DryRun bool

	// Project is references/PROJECT.md's content from --with-project-context.
	// Nil leaves any existing PROJECT.md alone.
	Project []byte

	// Manifest metadata.
	CLIVersion        string
	Now               time.Time
	Profile           string
	BaseURL           string
	DiscoveryRevision string
}

type ProjectContext struct {
	CLIVersion        string
	GeneratedAt       time.Time
	Profile           string
	BaseURL           string
	APIPath           string
	DiscoveryRevision string
	PayloadVersion    string
	AuthCollection    string
	AuthMode          string
	Locales           []string
	DefaultLocale     string
	Collections       []CollectionInfo
	Globals           []GlobalInfo
	// Examples overrides the three generated example commands.
	Examples []string
}

type Result struct {
	Scope    Scope            `json:"scope"`
	Root     string           `json:"root"`
	Targets  []TargetResult   `json:"targets"`
	Skipped  []TargetResult   `json:"skipped"`
	Warnings []output.Warning `json:"-"`
	DryRun   bool             `json:"dry_run,omitempty"`
}

type Scope string

type StatusReport struct {
	Scope   Scope          `json:"scope"`
	Root    string         `json:"root"`
	Targets []TargetStatus `json:"targets"`
}

type TargetResult struct {
	Agent  string       `json:"agent"`
	Dir    string       `json:"dir"`
	Status string       `json:"status"`
	Reason string       `json:"reason,omitempty"`
	Files  []FileResult `json:"files,omitempty"`
}

type TargetStatus struct {
	Agent             string       `json:"agent"`
	Dir               string       `json:"dir"`
	Installed         bool         `json:"installed"`
	CLIVersion        string       `json:"cli_version,omitempty"`
	Stale             bool         `json:"stale"`
	Profile           string       `json:"profile,omitempty"`
	BaseURL           string       `json:"base_url,omitempty"`
	DiscoveryRevision string       `json:"discovery_revision,omitempty"`
	ProjectDocStale   bool         `json:"project_doc_stale"`
	Files             []FileStatus `json:"files,omitempty"`
}