installer

type ContentStore interface {
	// Root is the store root that activation and ownership checks resolve
	// symlinks against.
	Root() string
	// Has reports whether content for hash is present (existence only).
	Has(hash string) bool
	// Path returns the content directory for hash, whether or not it exists.
	Path(hash string) string
	// Verify establishes that the content for hash is trustworthy before
	// activation, failing closed on corruption (FR-020/021).
	Verify(hash string) error
	// Put admits srcDir under hash and returns the stored content path. It is
	// idempotent; origin is descriptive metadata for stores that record it.
	Put(ctx context.Context, hash, srcDir string, origin ObjectOrigin) (string, error)
	// Touch records a best-effort last-used signal for hash.
	Touch(ctx context.Context, hash string)
	// ScopeLabel names the store's physical scope for reporting: "project" or
	// "global".
	ScopeLabel() string
}

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

type Mode string

type ObjectOrigin struct {
	SourceType string
	Source     string
	SkillPath  string
	Version    string
	Ref        string
	Commit     string
}

type OriginRecorder interface {
	RecordOrigin(ctx context.Context, hash string, origin ObjectOrigin) error
}

type Request struct {
	Ref         source.Ref
	Revision    resolver.Revision
	Name        string // declared manifest key; must match frontmatter name
	Path        string // explicit in-repo subpath (optional)
	Agents      []agent.Agent
	Scope       Scope
	ModePref    string // symlink | copy | auto
	ProjectRoot string
	Home        string
	// Offline forbids network fetches; material must already be cached (FR-026).
	Offline bool
	// ExpectContentHash, when set, must equal the materialized content hash or
	// the install fails closed (used by frozen restore, FR-015/FR-037).
	ExpectContentHash string
	// PreserveForeign makes activation fail closed instead of replacing a
	// destination gskill does not own (add paths, spec 011 FR-016 — the
	// overwrite guard lives at the point of destruction). Reconcile paths
	// (install/sync/repair/update) leave it false: restoring drifted targets
	// is their contract.
	PreserveForeign bool
	// PriorContentHash is the lockfile-recorded content hash of the previous
	// install at this skill's destinations, accepted as owned content when
	// PreserveForeign is set (a copy-mode install is a real directory).
	PriorContentHash string
}

type Result struct {
	Skill         discovery.Skill
	ContentHash   string
	SkillFileHash string
	Mode          Mode              // representative mode (the first agent's)
	Modes         map[string]string // agentID -> actual mode used
	Agents        []string
	ActivePath    string            // project-relative active entry (empty for global scope)
	Targets       map[string]string // agentID -> recorded dir (relative for project scope)
	Warnings      []string
	// StoreReuse reports whether the content store satisfied the install
	// (StoreReused) or the source was fetched (StoreDownloaded) — spec 015
	// FR-007.
	StoreReuse string
	// StoreScope names the physical store that served the install: "project"
	// or "global".
	StoreScope string
}

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

type Scope string