mewkit 1.10.2 → 1.10.4

package/dist/core/is-hook-script.js

@@ -0,0 +1,45 @@
+import { statSync, readFileSync } from "node:fs";
+import path from "node:path";
+/**
+ * True only for actual hook *scripts*. The validators previously treated every
+ * `readdirSync(hooksDir)` entry as a hook and ran `accessSync(X_OK)` on it — but the
+ * execute bit is also set on directories (traverse), so `lib/`, `handlers/`, `__tests__/`,
+ * and non-scripts like `HOOKS_INDEX.md` / `handlers.json` were reported as "Hook executable".
+ * This guard is the single definition shared by validate, validate-install, and doctor.
+ *
+ * A hook script is: a regular FILE, not an index/doc/json sidecar, and either a known
+ * script extension (.sh/.cjs/.js/.mjs) OR an extensionless executable with a shell/node shebang.
+ */
+const HOOK_EXTENSIONS = new Set([".sh", ".cjs", ".js", ".mjs"]);
+const EXCLUDED_BASENAMES = new Set(["HOOKS_INDEX.md", "handlers.json"]);
+export function isHookScript(p) {
+    let stat;
+    try {
+        stat = statSync(p);
+    }
+    catch {
+        return false;
+    }
+    if (!stat.isFile())
+        return false; // directories (lib/, handlers/, __tests__/) are never hooks
+    const base = path.basename(p);
+    if (EXCLUDED_BASENAMES.has(base))
+        return false;
+    const ext = path.extname(base).toLowerCase();
+    if (HOOK_EXTENSIONS.has(ext))
+        return true;
+    // Allow a legitimately extensionless hook: executable + shell/node shebang.
+    if (ext === "") {
+        if ((stat.mode & 0o111) === 0)
+            return false;
+        try {
+            const head = readFileSync(p, "utf8").slice(0, 128);
+            return /^#!.*\b(sh|bash|dash|node|env)\b/.test(head);
+        }
+        catch {
+            return false;
+        }
+    }
+    return false; // .md, .json, .txt, …
+}
+//# sourceMappingURL=is-hook-script.js.map

package/dist/core/is-hook-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-hook-script.js","sourceRoot":"","sources":["../../src/core/is-hook-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AAEH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAChE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;AAExE,MAAM,UAAU,YAAY,CAAC,CAAS;IACrC,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACJ,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO,KAAK,CAAC,CAAC,4DAA4D;IAE9F,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,4EAA4E;IAC5E,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,sBAAsB;AACrC,CAAC"}

package/dist/core/pack-manifest.d.ts

@@ -0,0 +1,48 @@
+export declare const PACK_MANIFEST_FILENAME = "pack-manifest.json";
+/** Always-installed essentials: non-artifact files, safety rules, core commands. */
+export interface PackBase {
+    files: string[];
+    globs: string[];
+    commands: string[];
+}
+/** A pack derives membership from `owners` plus per-artifact add/exclude overrides. */
+export interface PackDef {
+    owners?: string[];
+    artifactsAdd?: string[];
+    artifactsExclude?: string[];
+}
+export interface PackManifest {
+    schemaVersion: string;
+    base: PackBase;
+    packs: Record<string, PackDef>;
+    profiles: Record<string, string[]>;
+}
+/** Reserved profile entry meaning "every pack" — full-tree install. */
+export declare const WILDCARD = "*";
+/** The always-included pseudo-pack name. */
+export declare const BASE_PACK = "base";
+/** Thrown when the manifest is absent, unreadable, or structurally malformed. */
+export declare class PackManifestError extends Error {
+    constructor(message: string);
+}
+/** Path to the manifest under a `.claude/` dir (present or absent). */
+export declare function packManifestPath(claudeDir: string): string;
+/** True when the manifest file exists — used by infra-absent guards (pack/upgrade). */
+export declare function hasPackManifest(claudeDir: string): boolean;
+/** Load + shape-validate the manifest. Throws PackManifestError on any defect. */
+export declare function loadPackManifest(claudeDir: string): PackManifest;
+export declare function availableProfiles(manifest: PackManifest): string[];
+export declare function availablePacks(manifest: PackManifest): string[];
+export interface FlattenResult {
+    /** Concrete pack names (always includes BASE_PACK), deduped. */
+    packs: string[];
+    /** True when the profile transitively references the `*` wildcard (= full tree). */
+    wildcard: boolean;
+}
+/**
+ * Flatten a profile to its concrete pack list. Profile entries may reference a
+ * pack, another profile (extends-style), `base`, or the `*` wildcard. Cycles are
+ * detected and rejected; unknown refs throw with the available names.
+ */
+export declare function flattenProfile(manifest: PackManifest, profileName: string): FlattenResult;
+//# sourceMappingURL=pack-manifest.d.ts.map

package/dist/core/pack-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../../src/core/pack-manifest.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,OAAO;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED,uEAAuE;AACvE,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,4CAA4C;AAC5C,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC,iFAAiF;AACjF,qBAAa,iBAAkB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI3B;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAYhE;AAmCD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAElE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAE/D;AAED,MAAM,WAAW,aAAa;IAC7B,gEAAgE;IAChE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAwCzF"}

package/dist/core/pack-manifest.js

@@ -0,0 +1,126 @@
+// Pack-manifest data model + pure manifest operations (no filesystem walking of
+// artifacts). The manifest (`.claude/pack-manifest.json`) maps install profiles
+// onto the Phase-2 `owner` governance metadata plus an explicit `base` essentials
+// set. This module loads/shape-validates the manifest and flattens a profile to
+// its concrete pack list; pack-resolver.ts turns that into actual file paths.
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export const PACK_MANIFEST_FILENAME = "pack-manifest.json";
+/** Reserved profile entry meaning "every pack" — full-tree install. */
+export const WILDCARD = "*";
+/** The always-included pseudo-pack name. */
+export const BASE_PACK = "base";
+/** Thrown when the manifest is absent, unreadable, or structurally malformed. */
+export class PackManifestError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PackManifestError";
+    }
+}
+/** Path to the manifest under a `.claude/` dir (present or absent). */
+export function packManifestPath(claudeDir) {
+    return join(claudeDir, PACK_MANIFEST_FILENAME);
+}
+/** True when the manifest file exists — used by infra-absent guards (pack/upgrade). */
+export function hasPackManifest(claudeDir) {
+    return existsSync(packManifestPath(claudeDir));
+}
+/** Load + shape-validate the manifest. Throws PackManifestError on any defect. */
+export function loadPackManifest(claudeDir) {
+    const file = packManifestPath(claudeDir);
+    if (!existsSync(file)) {
+        throw new PackManifestError(`pack-manifest.json not found at ${file}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch (err) {
+        throw new PackManifestError(`pack-manifest.json is not valid JSON: ${err.message}`);
+    }
+    return validateManifest(parsed);
+}
+function validateManifest(parsed) {
+    if (typeof parsed !== "object" || parsed === null) {
+        throw new PackManifestError("manifest root is not an object");
+    }
+    const m = parsed;
+    const base = m.base;
+    if (!base || !Array.isArray(base.files) || !Array.isArray(base.globs) || !Array.isArray(base.commands)) {
+        throw new PackManifestError("manifest.base must have array fields files/globs/commands");
+    }
+    if (typeof m.packs !== "object" || m.packs === null) {
+        throw new PackManifestError("manifest.packs must be an object");
+    }
+    if (typeof m.profiles !== "object" || m.profiles === null) {
+        throw new PackManifestError("manifest.profiles must be an object");
+    }
+    const profiles = m.profiles;
+    for (const [name, entry] of Object.entries(profiles)) {
+        if (!Array.isArray(entry)) {
+            throw new PackManifestError(`profile "${name}" must be an array of pack/profile refs`);
+        }
+    }
+    return {
+        schemaVersion: typeof m.schemaVersion === "string" ? m.schemaVersion : "1.0",
+        base: {
+            files: base.files.map(String),
+            globs: base.globs.map(String),
+            commands: base.commands.map(String),
+        },
+        packs: m.packs,
+        profiles: m.profiles,
+    };
+}
+export function availableProfiles(manifest) {
+    return Object.keys(manifest.profiles);
+}
+export function availablePacks(manifest) {
+    return Object.keys(manifest.packs);
+}
+/**
+ * Flatten a profile to its concrete pack list. Profile entries may reference a
+ * pack, another profile (extends-style), `base`, or the `*` wildcard. Cycles are
+ * detected and rejected; unknown refs throw with the available names.
+ */
+export function flattenProfile(manifest, profileName) {
+    if (!(profileName in manifest.profiles)) {
+        throw new PackManifestError(`unknown profile "${profileName}" — available: ${availableProfiles(manifest).join(", ")}`);
+    }
+    const packs = new Set([BASE_PACK]);
+    let wildcard = false;
+    const visiting = new Set();
+    const walk = (name) => {
+        if (visiting.has(name)) {
+            throw new PackManifestError(`profile cycle detected at "${name}"`);
+        }
+        visiting.add(name);
+        for (const ref of manifest.profiles[name]) {
+            if (ref === WILDCARD) {
+                wildcard = true;
+                for (const p of availablePacks(manifest))
+                    packs.add(p);
+            }
+            else if (ref === BASE_PACK) {
+                packs.add(BASE_PACK);
+            }
+            else if (ref in manifest.packs) {
+                // Pack-first: a profile named like its own domain pack (e.g. profile
+                // "atlassian" → pack "atlassian") must bind to the pack, not recurse
+                // into itself. Profile-extension targets (core, developer) are not
+                // pack names, so they fall through to the profile branch below.
+                packs.add(ref);
+            }
+            else if (ref in manifest.profiles) {
+                walk(ref);
+            }
+            else {
+                throw new PackManifestError(`profile "${name}" references unknown pack/profile "${ref}" — packs: ${availablePacks(manifest).join(", ")}`);
+            }
+        }
+        visiting.delete(name);
+    };
+    walk(profileName);
+    return { packs: [...packs], wildcard };
+}
+//# sourceMappingURL=pack-manifest.js.map

package/dist/core/pack-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-manifest.js","sourceRoot":"","sources":["../../src/core/pack-manifest.ts"],"names":[],"mappings":"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"}

package/dist/core/pack-resolver.d.ts

@@ -0,0 +1,18 @@
+import { type PackManifest } from "./pack-manifest.js";
+export interface ResolveResult {
+    /** All `.claude/`-relative paths for the resolved profile/packs (incl. base). */
+    paths: Set<string>;
+    /** Per-pack path sets (incl. the `base` pseudo-pack) for exclusive-delete math. */
+    packMembership: Map<string, Set<string>>;
+    /** Concrete pack names resolved (always includes `base`). */
+    packs: string[];
+}
+/** Resolve a profile name to its install allow-set. `full`/`*` ⇒ the whole tree. */
+export declare function resolveProfile(claudeDir: string, manifest: PackManifest, profileName: string): Set<string>;
+/** Resolve a profile with per-pack membership exposed (for pack remove exclusivity). */
+export declare function resolveProfileDetailed(claudeDir: string, manifest: PackManifest, profileName: string): ResolveResult;
+/** Resolve an explicit pack list to its install allow-set (always includes base). */
+export declare function resolvePacks(claudeDir: string, manifest: PackManifest, packNames: string[]): Set<string>;
+/** Resolve an explicit pack list with per-pack membership exposed. */
+export declare function resolvePacksDetailed(claudeDir: string, manifest: PackManifest, packNames: string[]): ResolveResult;
+//# sourceMappingURL=pack-resolver.d.ts.map

package/dist/core/pack-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-resolver.d.ts","sourceRoot":"","sources":["../../src/core/pack-resolver.ts"],"names":[],"mappings":"AASA,OAAO,EAKN,KAAK,YAAY,EACjB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC7B,iFAAiF;IACjF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,mFAAmF;IACnF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AA2GD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAE1G;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CASpH;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAExG;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,aAAa,CAUlH"}

package/dist/core/pack-resolver.js

@@ -0,0 +1,144 @@
+// Pure profile/pack resolver: turns a profile (or explicit pack list) into the
+// exact set of `.claude/`-relative file paths to install. Membership derives from
+// the Phase-2 `owner` inventory plus the manifest's base essentials and per-pack
+// overrides. No fs writes. The `full`/`*` path short-circuits to the whole tree
+// (collectFiles) for byte parity with today's monolithic install.
+import fs from "node:fs";
+import path from "node:path";
+import { collectFiles } from "./compute-checksums.js";
+import { buildInventory } from "./build-inventory.js";
+import { availablePacks, BASE_PACK, flattenProfile, PackManifestError, } from "./pack-manifest.js";
+/** Normalize to forward slashes so the allow-set matches smartUpdate's manifestPath. */
+function norm(p) {
+    return p.replace(/\\/g, "/");
+}
+/** Expand a base glob (`<dir>/**`) against the source tree, or treat as a literal file. */
+function expandBaseGlob(claudeDir, glob) {
+    if (glob.endsWith("/**")) {
+        const sub = glob.slice(0, -3);
+        const abs = path.join(claudeDir, sub);
+        return fs.existsSync(abs) ? collectFiles(abs, claudeDir) : [];
+    }
+    return [glob];
+}
+/** A skill installs its whole directory; every other artifact is a single file. */
+function artifactPaths(claudeDir, entry) {
+    if (entry.type === "skill") {
+        const dir = path.posix.dirname(entry.path); // skills/<dir>
+        const abs = path.join(claudeDir, dir);
+        if (fs.existsSync(abs))
+            return collectFiles(abs, claudeDir);
+    }
+    return [entry.path];
+}
+/** Always-installed essentials: explicit files, expanded globs, and core commands. */
+function baseSeed(claudeDir, manifest) {
+    const set = new Set();
+    for (const f of manifest.base.files)
+        set.add(norm(f));
+    for (const g of manifest.base.globs)
+        for (const f of expandBaseGlob(claudeDir, g))
+            set.add(norm(f));
+    for (const c of manifest.base.commands)
+        set.add(`commands/mk/${c}.md`);
+    return set;
+}
+/**
+ * Transitive `depends_on` closure across pack boundaries. Inert today — Phase-2
+ * populated owner/criticality/status/runtime but no edges — so this currently
+ * adds nothing; kept so profiles auto-pull future hard runtime dependencies.
+ * Dangling dep ids are tolerated here (P4 `validate --packs` flags them).
+ */
+function closeDependsOn(claudeDir, inv, includedIds, paths) {
+    const byId = new Map(inv.entries.map((e) => [e.id, e]));
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const id of [...includedIds]) {
+            for (const dep of byId.get(id)?.dependsOn ?? []) {
+                const de = byId.get(dep);
+                if (!de || includedIds.has(dep))
+                    continue;
+                includedIds.add(dep);
+                for (const ap of artifactPaths(claudeDir, de))
+                    paths.add(norm(ap));
+                changed = true;
+            }
+        }
+    }
+}
+/** Core builder: union base + each pack's owner/override-selected artifact files. */
+function buildFromPacks(claudeDir, manifest, packNames, inv) {
+    const invIds = new Set(inv.entries.map((e) => e.id));
+    const paths = new Set();
+    const packMembership = new Map();
+    const includedIds = new Set();
+    const base = baseSeed(claudeDir, manifest);
+    packMembership.set(BASE_PACK, base);
+    for (const p of base)
+        paths.add(p);
+    for (const packName of packNames) {
+        if (packName === BASE_PACK)
+            continue;
+        const pack = manifest.packs[packName];
+        if (!pack) {
+            throw new PackManifestError(`unknown pack "${packName}" — available: ${availablePacks(manifest).join(", ")}`);
+        }
+        const owners = new Set(pack.owners ?? []);
+        const add = new Set(pack.artifactsAdd ?? []);
+        const exclude = new Set(pack.artifactsExclude ?? []);
+        for (const id of [...add, ...exclude]) {
+            if (!invIds.has(id)) {
+                throw new PackManifestError(`pack "${packName}" references unknown artifact id "${id}"`);
+            }
+        }
+        const member = new Set();
+        for (const e of inv.entries) {
+            if (exclude.has(e.id))
+                continue;
+            if (!owners.has(e.owner) && !add.has(e.id))
+                continue;
+            includedIds.add(e.id);
+            for (const ap of artifactPaths(claudeDir, e)) {
+                const np = norm(ap);
+                paths.add(np);
+                member.add(np);
+            }
+        }
+        packMembership.set(packName, member);
+    }
+    closeDependsOn(claudeDir, inv, includedIds, paths);
+    return { paths, packMembership };
+}
+/** Resolve a profile name to its install allow-set. `full`/`*` ⇒ the whole tree. */
+export function resolveProfile(claudeDir, manifest, profileName) {
+    return resolveProfileDetailed(claudeDir, manifest, profileName).paths;
+}
+/** Resolve a profile with per-pack membership exposed (for pack remove exclusivity). */
+export function resolveProfileDetailed(claudeDir, manifest, profileName) {
+    const flat = flattenProfile(manifest, profileName);
+    if (flat.wildcard) {
+        const all = new Set(collectFiles(claudeDir, claudeDir).map(norm));
+        return { paths: all, packMembership: new Map([[BASE_PACK, all]]), packs: flat.packs };
+    }
+    const inv = buildInventory(claudeDir);
+    const { paths, packMembership } = buildFromPacks(claudeDir, manifest, flat.packs, inv);
+    return { paths, packMembership, packs: flat.packs };
+}
+/** Resolve an explicit pack list to its install allow-set (always includes base). */
+export function resolvePacks(claudeDir, manifest, packNames) {
+    return resolvePacksDetailed(claudeDir, manifest, packNames).paths;
+}
+/** Resolve an explicit pack list with per-pack membership exposed. */
+export function resolvePacksDetailed(claudeDir, manifest, packNames) {
+    const names = [BASE_PACK, ...packNames.filter((n) => n !== BASE_PACK)];
+    for (const n of names) {
+        if (n !== BASE_PACK && !(n in manifest.packs)) {
+            throw new PackManifestError(`unknown pack "${n}" — available: ${availablePacks(manifest).join(", ")}`);
+        }
+    }
+    const inv = buildInventory(claudeDir);
+    const { paths, packMembership } = buildFromPacks(claudeDir, manifest, names, inv);
+    return { paths, packMembership, packs: names };
+}
+//# sourceMappingURL=pack-resolver.js.map

package/dist/core/pack-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-resolver.js","sourceRoot":"","sources":["../../src/core/pack-resolver.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kFAAkF;AAClF,iFAAiF;AACjF,gFAAgF;AAChF,kEAAkE;AAClE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAuC,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EACN,cAAc,EACd,SAAS,EACT,cAAc,EACd,iBAAiB,GAEjB,MAAM,oBAAoB,CAAC;AAW5B,wFAAwF;AACxF,SAAS,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,2FAA2F;AAC3F,SAAS,cAAc,CAAC,SAAiB,EAAE,IAAY;IACtD,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,SAAS,aAAa,CAAC,SAAiB,EAAE,KAAqB;IAC9D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,sFAAsF;AACtF,SAAS,QAAQ,CAAC,SAAiB,EAAE,QAAsB;IAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK;QAAE,KAAK,MAAM,CAAC,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ;QAAE,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,SAAiB,EAAE,GAAc,EAAE,WAAwB,EAAE,KAAkB;IACtG,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;IACjE,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,EAAE,CAAC;QAChB,OAAO,GAAG,KAAK,CAAC;QAChB,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;YACnC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;gBACjD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,CAAC,EAAE,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC1C,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrB,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACnE,OAAO,GAAG,IAAI,CAAC;YAChB,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC;AAED,qFAAqF;AACrF,SAAS,cAAc,CACtB,SAAiB,EACjB,QAAsB,EACtB,SAAmB,EACnB,GAAc;IAEd,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3C,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,QAAQ,kBAAkB,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QACrD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,iBAAiB,CAAC,SAAS,QAAQ,qCAAqC,EAAE,GAAG,CAAC,CAAC;YAC1F,CAAC;QACF,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,SAAS;YAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,SAAS;YACrD,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtB,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;QACF,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AAClC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAsB,EAAE,WAAmB;IAC5F,OAAO,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC;AACvE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,QAAsB,EAAE,WAAmB;IACpG,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACvF,CAAC;IACD,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvF,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AACrD,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,QAAsB,EAAE,SAAmB;IAC1F,OAAO,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC;AACnE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,QAAsB,EAAE,SAAmB;IAClG,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,CAAC,kBAAkB,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxG,CAAC;IACF,CAAC;IACD,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAClF,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC"}

package/dist/core/portability-matrix.d.ts

@@ -0,0 +1,17 @@
+import { type ProviderContractDiagnostic } from "../migrate/provider-contract-diagnostics.js";
+import type { ProviderType } from "../migrate/types.js";
+export interface PortabilityMatrixRow extends ProviderContractDiagnostic {
+    displayStatus: "native" | "documented" | "disabled" | "unsupported" | "warn" | "fail";
+}
+export interface PortabilityCoverage {
+    providers: number;
+    surfaces: number;
+    documented: number;
+    disabledUnsupported: number;
+    warn: number;
+    fail: number;
+}
+export declare function buildPortabilityMatrix(): PortabilityMatrixRow[];
+export declare function explainProvider(provider: ProviderType): PortabilityMatrixRow[];
+export declare function coverage(rows?: PortabilityMatrixRow[]): PortabilityCoverage;
+//# sourceMappingURL=portability-matrix.d.ts.map

package/dist/core/portability-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability-matrix.d.ts","sourceRoot":"","sources":["../../src/core/portability-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAClI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,oBAAqB,SAAQ,0BAA0B;IACvE,aAAa,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;CACtF;AAED,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAWD,wBAAgB,sBAAsB,IAAI,oBAAoB,EAAE,CAE/D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,oBAAoB,EAAE,CAE9E;AAED,wBAAgB,QAAQ,CAAC,IAAI,yBAA2B,GAAG,mBAAmB,CAS7E"}

package/dist/core/portability-matrix.js

@@ -0,0 +1,31 @@
+import { collectProviderContractDiagnostics } from "../migrate/provider-contract-diagnostics.js";
+function displayStatus(d) {
+    if (d.provider === "claude-code" && d.surfaceStatus === "documented" && d.severity === "pass")
+        return "native";
+    if (d.severity === "fail")
+        return "fail";
+    if (d.severity === "warn")
+        return "warn";
+    if (d.surfaceStatus === "documented")
+        return "documented";
+    if (d.surfaceStatus === "unsupported")
+        return "unsupported";
+    return "disabled";
+}
+export function buildPortabilityMatrix() {
+    return collectProviderContractDiagnostics().map((d) => ({ ...d, displayStatus: displayStatus(d) }));
+}
+export function explainProvider(provider) {
+    return buildPortabilityMatrix().filter((r) => r.provider === provider);
+}
+export function coverage(rows = buildPortabilityMatrix()) {
+    return {
+        providers: new Set(rows.map((r) => r.provider)).size,
+        surfaces: rows.length,
+        documented: rows.filter((r) => r.surfaceStatus === "documented").length,
+        disabledUnsupported: rows.filter((r) => r.surfaceStatus !== "documented" && r.severity !== "fail").length,
+        warn: rows.filter((r) => r.severity === "warn").length,
+        fail: rows.filter((r) => r.severity === "fail").length,
+    };
+}
+//# sourceMappingURL=portability-matrix.js.map

package/dist/core/portability-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability-matrix.js","sourceRoot":"","sources":["../../src/core/portability-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAmC,MAAM,6CAA6C,CAAC;AAgBlI,SAAS,aAAa,CAAC,CAA6B;IACnD,IAAI,CAAC,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,CAAC,aAAa,KAAK,YAAY,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC/G,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,CAAC,CAAC,aAAa,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAC1D,IAAI,CAAC,CAAC,aAAa,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAC5D,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACrC,OAAO,kCAAkC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAsB;IACrD,OAAO,sBAAsB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAI,GAAG,sBAAsB,EAAE;IACvD,OAAO;QACN,SAAS,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QACpD,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,YAAY,CAAC,CAAC,MAAM;QACvE,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,YAAY,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;QACzG,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;QACtD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;KACtD,CAAC;AACH,CAAC"}

package/dist/core/release-metadata.d.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import type { Manifest } from "./compute-checksums.js";
+export declare const RELEASE_MANIFEST_FILENAME = "release-manifest.json";
+export declare const ReleaseFileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    checksum: z.ZodString;
+    size: z.ZodOptional<z.ZodNumber>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    checksum: string;
+    size?: number | undefined;
+    lastModified?: string | undefined;
+}, {
+    path: string;
+    checksum: string;
+    size?: number | undefined;
+    lastModified?: string | undefined;
+}>;
+export type ReleaseFileEntry = z.infer<typeof ReleaseFileEntrySchema>;
+export declare const ReleaseManifestSchema: z.ZodObject<{
+    version: z.ZodString;
+    generatedAt: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        checksum: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        checksum: string;
+        size?: number | undefined;
+        lastModified?: string | undefined;
+    }, {
+        path: string;
+        checksum: string;
+        size?: number | undefined;
+        lastModified?: string | undefined;
+    }>, "many">;
+    deletions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    generatedAt: string;
+    files: {
+        path: string;
+        checksum: string;
+        size?: number | undefined;
+        lastModified?: string | undefined;
+    }[];
+    deletions: string[];
+}, {
+    version: string;
+    generatedAt: string;
+    files: {
+        path: string;
+        checksum: string;
+        size?: number | undefined;
+        lastModified?: string | undefined;
+    }[];
+    deletions?: string[] | undefined;
+}>;
+export type ReleaseManifest = z.infer<typeof ReleaseManifestSchema>;
+/** Thrown when `release-manifest.json` is present but does not match the schema. */
+export declare class CorruptReleaseManifestError extends Error {
+    readonly detail: string;
+    constructor(detail: string);
+}
+/**
+ * Read `release-manifest.json` from an extracted release root.
+ * Returns null when the file is absent; throws on a present-but-corrupt manifest.
+ */
+export declare function readReleaseMetadata(sourceDir: string): ReleaseManifest | null;
+/** Map each release file path to its source commit timestamp (when recorded). */
+export declare function mapPathToLastModified(release: ReleaseManifest | null): Record<string, string>;
+/**
+ * Project a release manifest onto the `Manifest` shape `findOrphans` consumes —
+ * only the checksum keys matter for orphan detection.
+ */
+export declare function toOrphanManifest(release: ReleaseManifest): Manifest;
+//# sourceMappingURL=release-metadata.d.ts.map

package/dist/core/release-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-metadata.d.ts","sourceRoot":"","sources":["../../src/core/release-metadata.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,oFAAoF;AACpF,qBAAa,2BAA4B,SAAQ,KAAK;aACzB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI1C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAY7E;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAMnE"}

package/dist/core/release-metadata.js

@@ -0,0 +1,70 @@
+// CLI-side reader for the release-metadata carrier: `release-manifest.json` at
+// the extracted release root. This is the single parser for that file — it
+// supplies the installed kit version, per-file source timestamps, and the
+// optional maintainer-curated `deletions[]` list.
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+export const RELEASE_MANIFEST_FILENAME = "release-manifest.json";
+export const ReleaseFileEntrySchema = z.object({
+    path: z.string(),
+    checksum: z.string(),
+    size: z.number().optional(),
+    lastModified: z.string().optional(),
+});
+export const ReleaseManifestSchema = z.object({
+    version: z.string(),
+    generatedAt: z.string(),
+    files: z.array(ReleaseFileEntrySchema),
+    deletions: z.array(z.string()).default([]),
+});
+/** Thrown when `release-manifest.json` is present but does not match the schema. */
+export class CorruptReleaseManifestError extends Error {
+    detail;
+    constructor(detail) {
+        super(`Corrupt release-manifest.json: ${detail}`);
+        this.detail = detail;
+        this.name = "CorruptReleaseManifestError";
+    }
+}
+/**
+ * Read `release-manifest.json` from an extracted release root.
+ * Returns null when the file is absent; throws on a present-but-corrupt manifest.
+ */
+export function readReleaseMetadata(sourceDir) {
+    const manifestPath = join(sourceDir, RELEASE_MANIFEST_FILENAME);
+    if (!existsSync(manifestPath))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(manifestPath, "utf-8"));
+    }
+    catch (err) {
+        throw new CorruptReleaseManifestError(err.message);
+    }
+    const result = ReleaseManifestSchema.safeParse(parsed);
+    if (!result.success)
+        throw new CorruptReleaseManifestError(result.error.message);
+    return result.data;
+}
+/** Map each release file path to its source commit timestamp (when recorded). */
+export function mapPathToLastModified(release) {
+    const out = {};
+    for (const f of release?.files ?? []) {
+        if (f.lastModified)
+            out[f.path] = f.lastModified;
+    }
+    return out;
+}
+/**
+ * Project a release manifest onto the `Manifest` shape `findOrphans` consumes —
+ * only the checksum keys matter for orphan detection.
+ */
+export function toOrphanManifest(release) {
+    const checksums = {};
+    for (const f of release.files) {
+        checksums[f.path] = { sha256: f.checksum, layer: "core" };
+    }
+    return { version: release.version, generatedAt: release.generatedAt, checksums };
+}
+//# sourceMappingURL=release-metadata.js.map

package/dist/core/release-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-metadata.js","sourceRoot":"","sources":["../../src/core/release-metadata.ts"],"names":[],"mappings":"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"}