export interface SkillLockEntry {
    version: string;
    sha: string;
    tier: string;
    installedAt: string;
    source: string;
    /** Marketplace origin (e.g. "specweave") */
    marketplace?: string;
    /** Whether this entry is a plugin directory (not a single SKILL.md) */
    pluginDir?: boolean;
    /** Installation scope: user-global or project-local */
    scope?: "user" | "project";
    /** Absolute path where the plugin was installed */
    installedPath?: string;
    /** Sorted list of relative file paths for ghost file detection */
    files?: string[];
    /** When set, skill is pinned at this version and skipped by `update` */
    pinnedVersion?: string;
    /** 0737 — canonical source repo URL for the upstream SKILL.md (e.g. "https://github.com/owner/repo"). */
    sourceRepoUrl?: string;
    /** 0737 — relative path from the source repo root to the skill's SKILL.md (e.g. "skills/foo/SKILL.md"). */
    sourceSkillPath?: string;
    /** Stable source kind for provenance-aware update checks. */
    sourceType?: "github" | "registry" | "plugin" | "local";
    /** Git ref/branch used when the skill was installed. */
    sourceBranch?: string;
    /** Upstream commit SHA at install time, when resolvable. */
    sourceCommitSha?: string;
    /** Plugin namespace that provided this skill, when installed from a plugin layout. */
    sourcePluginName?: string;
}
export interface VskillLock {
    version: 1;
    agents: string[];
    skills: Record<string, SkillLockEntry>;
    createdAt: string;
    updatedAt: string;
    /** ISO timestamp of last update check (throttle hint to 24h) */
    lastUpdateCheck?: string;
}