skillslock

type Entry struct {
	Source       string
	Ref          string // optional branch/tag used for installation (npx "ref")
	SourceType   string
	SkillPath    string
	ComputedHash string
	Ext          *Ext
}

type Ext struct {
	SourceURL   string   `json:"sourceUrl,omitempty"`
	Ref         string   `json:"ref,omitempty"`
	Commit      string   `json:"commit,omitempty"`
	Version     string   `json:"version,omitempty"`
	Agents      []string `json:"agents,omitempty"`
	InstallMode string   `json:"installMode,omitempty"`
	// BaseHash is the content hash of the upstream extract *before* any
	// override is applied (spec 023). With no override declared it equals
	// ContentHash and is omitted, so spec 022 entries stay byte-identical.
	BaseHash string `json:"baseHash,omitempty"`
	// ContentHash is the canonical full-content hash of the committed skill
	// copy (spec 022): it covers symlinks that the shared core computedHash
	// (npx-compat) skips, so restores verify against it. Since spec 023 it is
	// the *post-override* result — the name and its role in verification are
	// unchanged, which is what lets drift detection and restore keep working.
	ContentHash string `json:"contentHash,omitempty"`
	// OverrideDigest is the canonical digest over the resolved override
	// declaration plus the content hash of every file it references (spec 023
	// FR-007). Empty when no override is declared. Because the referenced
	// files' bytes feed the digest, editing one is detected as drift without
	// any file watching.
	OverrideDigest string `json:"overrideDigest,omitempty"`
	// Override records the resolved declaration itself, so the lockfile stays
	// self-describing about what was applied: an audit or a --frozen-lockfile
	// check can detect a changed declaration without consulting the manifest
	// (spec 023 plan.md Deviation 1).
	Override *OverrideDecl `json:"override,omitempty"`
	// Scope records the agent-target scope and is written ONLY for
	// user-global installs (`add --global`): that placement is not derivable
	// from anything else in the entry, and dropping it would silently
	// re-materialize the skill into the project on the next sync. The
	// pre-022 store-location value "project" is read for migration but never
	// written — entries drop it on their first rewrite (spec 022
	// data-model §3), which is what marks them legacy.
	Scope string `json:"scope,omitempty"`
	// StoreHash is the pre-022 content-hash field: read for migration, never
	// written — superseded by ContentHash.
	StoreHash     string `json:"storeHash,omitempty"`
	SkillFileHash string `json:"skillFileHash,omitempty"`
	InstalledAt   string `json:"installedAt,omitempty"`
	UpdatedAt     string `json:"updatedAt,omitempty"`
	// State nests the residual machine state existing commands still consume;
	// see ExtState (bridge.go).
	State *ExtState `json:"state,omitempty"`
}

type ExtState struct {
	// SourceKind is gskill's resolved source type (e.g. a "local" entry whose
	// path is a git repo resolves as "git"); the entry's core sourceType stays
	// whatever the external tool wrote.
	SourceKind     string `json:"sourceKind,omitempty"`
	SourceOriginal string `json:"sourceOriginal,omitempty"`
	SourceOwner    string `json:"sourceOwner,omitempty"`
	SourceRepo     string `json:"sourceRepo,omitempty"`
	SourcePath     string `json:"sourcePath,omitempty"`

	RequestedVersion string `json:"requestedVersion,omitempty"`
	RequestedRef     string `json:"requestedRef,omitempty"`
	RequestedCommit  string `json:"requestedCommit,omitempty"`
	DeclarationKind  string `json:"declarationKind,omitempty"`

	RefKind       string `json:"refKind,omitempty"`
	Tag           string `json:"tag,omitempty"`
	Branch        string `json:"branch,omitempty"`
	TreeHash      string `json:"treeHash,omitempty"`
	MutableRef    bool   `json:"mutableRef,omitempty"`
	LocalPathHash string `json:"localPathHash,omitempty"`

	MetaName        string `json:"metaName,omitempty"`
	MetaDescription string `json:"metaDescription,omitempty"`
	MetaVersion     string `json:"metaVersion,omitempty"`
	MetaLicense     string `json:"metaLicense,omitempty"`

	RequiresSkills      []string `json:"requiresSkills,omitempty"`
	RequiresCommands    []string `json:"requiresCommands,omitempty"`
	RequiresEnvironment []string `json:"requiresEnvironment,omitempty"`
	RequiresMCP         []string `json:"requiresMcp,omitempty"`

	ActivePath string            `json:"activePath,omitempty"`
	Targets    map[string]string `json:"targets,omitempty"`
	Modes      map[string]string `json:"modes,omitempty"`

	Trust string `json:"trust,omitempty"`
}

type Installation struct {
	Scope      string
	Mode       string
	Agents     []string
	ActivePath string
	Targets    map[string]string
	Modes      map[string]string
}

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

type Metadata struct {
	Name        string
	Description string
	Version     string
	License     string
}

type OverrideDecl struct {
	Replace map[string]string `json:"replace,omitempty"`
	Patch   []string          `json:"patch,omitempty"`
	Prepend []string          `json:"prepend,omitempty"`
	Append  []string          `json:"append,omitempty"`
}

type Provenance struct {
	FetchedAt string
	UpdatedAt string
	Trust     string
}

type Record struct {
	Source       Source
	Requested    Requested
	Resolved     Resolved
	Metadata     Metadata
	Requires     Requires
	Installation Installation
	Provenance   Provenance
}

type Requested struct {
	Version string
	Ref     string
	Commit  string
	Kind    string
}

type Requires struct {
	Skills      []string
	Commands    []string
	Environment []string
	MCP         []string
}

type Resolved struct {
	Version       string
	RefKind       string
	Tag           string
	Branch        string
	Commit        string
	TreeHash      string
	ContentHash   string
	SkillFileHash string
	// BaseHash, OverrideDigest, and Override carry the spec 023 override
	// identity: the upstream hash before transformation, the canonical digest
	// of the declaration plus its inputs, and the declaration itself. All
	// three are empty for a skill with no override, so spec 022 records are
	// unaffected.
	BaseHash       string
	OverrideDigest string
	Override       *OverrideDecl
	MutableRef     bool
	LocalPathHash  string
	// CompatHash is the npx-skills-compatible computedHash (spec 012). The
	// shared skills-lock.json persists it as the core computedHash field.
	CompatHash string
}

type Source struct {
	Type     string
	Original string
	URL      string
	Owner    string
	Repo     string
	Path     string
}

type State struct {
	Skills map[string]Record
}