installer

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

type Mode string

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), and
	// as the replaceable previous version of the repo-owned active entry.
	PriorContentHash string
	// Override is the resolved override declaration for this skill (spec 023).
	// Empty means the upstream extract ships unchanged, in which case the
	// install behaves exactly as it did before overrides existed.
	Override overrides.Spec
	// LegacyStoreRoots are pre-022 store roots (e.g. the old home store):
	// stale active symlinks into them are replaced by the real copy.
	LegacyStoreRoots []string
	// ReplaceActive allows replacing a repo-owned active entry whose content
	// matches neither the expected nor the prior hash (drifted committed
	// content). Only explicit force/repair paths set it — plain add, install,
	// update, and sync fail closed on drift instead (spec 022 FR-008).
	ReplaceActive bool
}

type Result struct {
	Skill discovery.Skill
	// BaseHash is the upstream extract's hash, before any override. It equals
	// ContentHash when nothing was overridden (spec 023 FR-008).
	BaseHash    string
	ContentHash string
	// CompatHash is the npx-compatible computedHash of the *shipped* content.
	// With an override applied this differs from a hash of the upstream
	// extract, so callers must use it rather than re-hashing Skill.Dir —
	// otherwise the shared lock field would describe content never installed.
	CompatHash    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