mewkit 1.10.3 → 1.10.5

package/dist/core/evolution/recommendation-renderer.d.ts

@@ -0,0 +1,3 @@
+import type { EvolutionSuggestion } from "./suggestions.js";
+export declare function renderSuggestions(suggestions: EvolutionSuggestion[]): void;
+//# sourceMappingURL=recommendation-renderer.d.ts.map

package/dist/core/evolution/recommendation-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-renderer.d.ts","sourceRoot":"","sources":["../../../src/core/evolution/recommendation-renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5D,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAkB1E"}

package/dist/core/evolution/recommendation-renderer.js

@@ -0,0 +1,24 @@
+import pc from "picocolors";
+function pct(n) {
+    return `${Math.round(n * 100)}%`;
+}
+export function renderSuggestions(suggestions) {
+    console.log(pc.bold(pc.cyan("MeowKit evolve — proposal-only suggestions")));
+    console.log(pc.dim("No rules, skills, hooks, packs, or policies were changed."));
+    console.log();
+    if (suggestions.length === 0) {
+        console.log(pc.yellow("No suggestions met the evidence threshold."));
+        return;
+    }
+    for (const [i, suggestion] of suggestions.entries()) {
+        console.log(`${pc.bold(`${i + 1}. ${suggestion.title}`)} ${pc.dim(`[${suggestion.kind}]`)}`);
+        console.log(`   confidence ${pc.cyan(pct(suggestion.confidence))} · impact ${suggestion.impact} · risk ${suggestion.risk}`);
+        for (const evidence of suggestion.evidence) {
+            const count = evidence.count === undefined ? "" : ` (${evidence.count})`;
+            console.log(`   - ${evidence.source}: ${evidence.detail}${count}`);
+        }
+        console.log(`   proposed: ${suggestion.proposedAction}`);
+        console.log();
+    }
+}
+//# sourceMappingURL=recommendation-renderer.js.map

package/dist/core/evolution/recommendation-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-renderer.js","sourceRoot":"","sources":["../../../src/core/evolution/recommendation-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,SAAS,GAAG,CAAC,CAAS;IACrB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAkC;IACnE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACrE,OAAO;IACR,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,aAAa,UAAU,CAAC,MAAM,WAAW,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5H,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;AACF,CAAC"}

package/dist/core/evolution/review-failure-clusters.d.ts

@@ -0,0 +1,10 @@
+import type { EventRecord } from "../event-log.js";
+export interface ReviewFailureCluster {
+    key: string;
+    count: number;
+    tasks: string[];
+    slug: string;
+    dimension?: string;
+}
+export declare function clusterReviewFailures(events: EventRecord[], minCount?: number): ReviewFailureCluster[];
+//# sourceMappingURL=review-failure-clusters.d.ts.map

package/dist/core/evolution/review-failure-clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-failure-clusters.d.ts","sourceRoot":"","sources":["../../../src/core/evolution/review-failure-clusters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,SAAI,GAAG,oBAAoB,EAAE,CAajG"}

package/dist/core/evolution/review-failure-clusters.js

@@ -0,0 +1,30 @@
+function str(value, fallback = "unknown") {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : fallback;
+}
+function clusterKey(event) {
+    const slug = str(event.data.slug);
+    const dimension = str(event.data.dimension ?? event.data.rubric, "");
+    return {
+        key: dimension ? `${slug}:${dimension}` : slug,
+        slug,
+        dimension: dimension || undefined,
+    };
+}
+export function clusterReviewFailures(events, minCount = 2) {
+    const clusters = new Map();
+    for (const event of events) {
+        if (event.event !== "verdict_written")
+            continue;
+        if (str(event.data.overall).toUpperCase() !== "FAIL")
+            continue;
+        const { key, slug, dimension } = clusterKey(event);
+        const existing = clusters.get(key) ?? { key, count: 0, tasks: [], slug, dimension };
+        existing.count++;
+        const task = str(event.data.task, "");
+        if (task && !existing.tasks.includes(task))
+            existing.tasks.push(task);
+        clusters.set(key, existing);
+    }
+    return [...clusters.values()].filter((c) => c.count >= minCount).sort((a, b) => b.count - a.count || a.key.localeCompare(b.key));
+}
+//# sourceMappingURL=review-failure-clusters.js.map

package/dist/core/evolution/review-failure-clusters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-failure-clusters.js","sourceRoot":"","sources":["../../../src/core/evolution/review-failure-clusters.ts"],"names":[],"mappings":"AAUA,SAAS,GAAG,CAAC,KAAc,EAAE,QAAQ,GAAG,SAAS;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO;QACN,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI;QAC9C,IAAI;QACJ,SAAS,EAAE,SAAS,IAAI,SAAS;KACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAqB,EAAE,QAAQ,GAAG,CAAC;IACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,KAAK,KAAK,iBAAiB;YAAE,SAAS;QAChD,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM;YAAE,SAAS;QAC/D,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACpF,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAClI,CAAC"}

package/dist/core/evolution/suggestions.d.ts

@@ -0,0 +1,24 @@
+export type SuggestionKind = "hook-test" | "review-promotion" | "policy" | "trace-hardening" | "regression-scenario" | "pack-pruning" | "memory-conflict" | "memory-archive";
+export type EvidenceStatus = "available" | "insufficient" | "na";
+export interface SuggestionEvidence {
+    source: string;
+    detail: string;
+    count?: number;
+    status?: EvidenceStatus;
+}
+export interface EvolutionSuggestion {
+    kind: SuggestionKind;
+    title: string;
+    evidence: SuggestionEvidence[];
+    confidence: number;
+    impact: "low" | "medium" | "high";
+    risk: "low" | "medium" | "high";
+    proposedAction: string;
+    neverAutoApply: true;
+}
+export declare function makeSuggestion(args: Omit<EvolutionSuggestion, "neverAutoApply">): EvolutionSuggestion;
+export declare function filterSuggestions(suggestions: EvolutionSuggestion[], opts: {
+    minConfidence?: number;
+    kind?: string;
+}): EvolutionSuggestion[];
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/core/evolution/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../../src/core/evolution/suggestions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACvB,WAAW,GACX,kBAAkB,GAClB,QAAQ,GACR,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,GAAG,IAAI,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,IAAI,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,GAAG,mBAAmB,CAErG;AAED,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,mBAAmB,EAAE,EAClC,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,mBAAmB,EAAE,CAMvB"}

package/dist/core/evolution/suggestions.js

@@ -0,0 +1,11 @@
+export function makeSuggestion(args) {
+    return { ...args, neverAutoApply: true };
+}
+export function filterSuggestions(suggestions, opts) {
+    const min = opts.minConfidence ?? 0;
+    return suggestions
+        .filter((s) => s.confidence >= min)
+        .filter((s) => !opts.kind || s.kind === opts.kind)
+        .sort((a, b) => b.confidence - a.confidence || a.kind.localeCompare(b.kind) || a.title.localeCompare(b.title));
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/core/evolution/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../../../src/core/evolution/suggestions.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,cAAc,CAAC,IAAiD;IAC/E,OAAO,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,WAAkC,EAClC,IAA+C;IAE/C,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;IACpC,OAAO,WAAW;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACjH,CAAC"}

package/dist/core/gate-policy.d.ts

@@ -0,0 +1,20 @@
+export type GatePolicyProfile = "strict" | "balanced" | "lightweight";
+export interface GatePolicy {
+    profile: GatePolicyProfile;
+    planGate: "hard" | "advisory";
+    requireApprovedPlan: boolean;
+    contractGate: "hard" | "optional" | "off";
+    reviewGate: "hard" | "hard-on-fail" | "advisory";
+    buildVerify: "on";
+    humanApproval: "required" | "selected" | "optional";
+}
+export declare const POLICY_PRESETS: Record<GatePolicyProfile, GatePolicy>;
+export declare function policyPath(claudeDir: string): string;
+export declare function parsePolicyProfile(value: string | undefined): GatePolicyProfile | null;
+export declare function readGatePolicy(claudeDir: string): {
+    policy: GatePolicy;
+    source: string;
+    error?: string;
+};
+export declare function writeGatePolicy(claudeDir: string, profile: GatePolicyProfile): void;
+//# sourceMappingURL=gate-policy.d.ts.map

package/dist/core/gate-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-policy.d.ts","sourceRoot":"","sources":["../../src/core/gate-policy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;AAEtE,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;IAC1C,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC;IACjD,WAAW,EAAE,IAAI,CAAC;IAClB,aAAa,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;CACpD;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,UAAU,CA4BhE,CAAC;AAEF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAEtF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAWxG;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAUnF"}

package/dist/core/gate-policy.js

@@ -0,0 +1,64 @@
+import fs from "node:fs";
+import path from "node:path";
+export const POLICY_PRESETS = {
+    strict: {
+        profile: "strict",
+        planGate: "hard",
+        requireApprovedPlan: true,
+        contractGate: "hard",
+        reviewGate: "hard",
+        buildVerify: "on",
+        humanApproval: "required",
+    },
+    balanced: {
+        profile: "balanced",
+        planGate: "hard",
+        requireApprovedPlan: false,
+        contractGate: "optional",
+        reviewGate: "hard-on-fail",
+        buildVerify: "on",
+        humanApproval: "selected",
+    },
+    lightweight: {
+        profile: "lightweight",
+        planGate: "advisory",
+        requireApprovedPlan: false,
+        contractGate: "off",
+        reviewGate: "advisory",
+        buildVerify: "on",
+        humanApproval: "optional",
+    },
+};
+export function policyPath(claudeDir) {
+    return path.join(claudeDir, "policy.json");
+}
+export function parsePolicyProfile(value) {
+    return value === "strict" || value === "balanced" || value === "lightweight" ? value : null;
+}
+export function readGatePolicy(claudeDir) {
+    const p = policyPath(claudeDir);
+    if (!fs.existsSync(p))
+        return { policy: POLICY_PRESETS.balanced, source: "default" };
+    try {
+        const parsed = JSON.parse(fs.readFileSync(p, "utf-8"));
+        const profile = parsePolicyProfile(parsed.profile);
+        if (!profile)
+            return { policy: POLICY_PRESETS.strict, source: p, error: "unknown profile; failing safe as strict" };
+        return { policy: POLICY_PRESETS[profile], source: p };
+    }
+    catch {
+        return { policy: POLICY_PRESETS.strict, source: p, error: "unreadable policy; failing safe as strict" };
+    }
+}
+export function writeGatePolicy(claudeDir, profile) {
+    const p = policyPath(claudeDir);
+    const tmp = `${p}.tmp`;
+    const body = {
+        profile,
+        updatedAt: new Date().toISOString(),
+        note: "Privacy and prompt-injection blocks are never disabled by policy profiles.",
+    };
+    fs.writeFileSync(tmp, `${JSON.stringify(body, null, 2)}\n`, "utf-8");
+    fs.renameSync(tmp, p);
+}
+//# sourceMappingURL=gate-policy.js.map

package/dist/core/gate-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-policy.js","sourceRoot":"","sources":["../../src/core/gate-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAc7B,MAAM,CAAC,MAAM,cAAc,GAA0C;IACpE,MAAM,EAAE;QACP,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,MAAM;QAChB,mBAAmB,EAAE,IAAI;QACzB,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,UAAU;KACzB;IACD,QAAQ,EAAE;QACT,OAAO,EAAE,UAAU;QACnB,QAAQ,EAAE,MAAM;QAChB,mBAAmB,EAAE,KAAK;QAC1B,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,cAAc;QAC1B,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,UAAU;KACzB;IACD,WAAW,EAAE;QACZ,OAAO,EAAE,aAAa;QACtB,QAAQ,EAAE,UAAU;QACpB,mBAAmB,EAAE,KAAK;QAC1B,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,UAAU;KACzB;CACD,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,MAAM,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrF,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAyB,CAAC;QAC/E,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;QACpH,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IACzG,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAA0B;IAC5E,MAAM,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,MAAM,IAAI,GAAG;QACZ,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,4EAA4E;KAClF,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/harness-scaffold.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Build a throwaway project that mirrors a real MeowKit install closely enough to
+ * run its configured hooks: the entire `.claude/hooks/` tree (including `lib/`, so
+ * relative `source` paths resolve under CLAUDE_PROJECT_DIR) plus `.claude/settings.json`.
+ *
+ * Shared by the configured-hook integration tests and `doctor --hard-gates` so there
+ * is exactly one "mkdtemp + copy .claude" implementation. Tests/probes mutate plan and
+ * `.env` state inside the temp dir, never the source repo.
+ */
+export interface HarnessProject {
+    /** Absolute path to the temp project root (use as CLAUDE_PROJECT_DIR). */
+    dir: string;
+    /** Remove the temp project. Safe to call multiple times. */
+    cleanup: () => void;
+    /** Create a plan file so Gate 1 passes. Returns the plan path. */
+    addPlan: (opts?: {
+        nested?: boolean;
+        approved?: boolean;
+        slug?: string;
+    }) => string;
+    /** Remove all plan files (return Gate 1 to the no-plan state). */
+    clearPlans: () => void;
+    /** Create a sensitive file (default `.env`) in the project root. Returns its path. */
+    addEnvFile: (name?: string) => string;
+}
+/** True if `<srcRoot>/.claude/settings.json` and the hooks tree exist. */
+export declare function hasHarness(srcRoot: string): boolean;
+export declare function scaffoldHarnessProject(srcRoot: string): HarnessProject;
+//# sourceMappingURL=harness-scaffold.d.ts.map

package/dist/core/harness-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-scaffold.d.ts","sourceRoot":"","sources":["../../src/core/harness-scaffold.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC9B,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IACpF,kEAAkE;IAClE,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,sFAAsF;IACtF,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAWD,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAsCtE"}

package/dist/core/harness-scaffold.js

@@ -0,0 +1,53 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function copyClaudeHarness(srcRoot, destRoot) {
+    const claudeSrc = path.join(srcRoot, ".claude");
+    const claudeDst = path.join(destRoot, ".claude");
+    fs.mkdirSync(claudeDst, { recursive: true });
+    // Whole hooks tree (incl. lib/) so each hook's relative `source` resolves.
+    fs.cpSync(path.join(claudeSrc, "hooks"), path.join(claudeDst, "hooks"), { recursive: true });
+    fs.copyFileSync(path.join(claudeSrc, "settings.json"), path.join(claudeDst, "settings.json"));
+}
+/** True if `<srcRoot>/.claude/settings.json` and the hooks tree exist. */
+export function hasHarness(srcRoot) {
+    return (fs.existsSync(path.join(srcRoot, ".claude", "settings.json")) &&
+        fs.existsSync(path.join(srcRoot, ".claude", "hooks")));
+}
+export function scaffoldHarnessProject(srcRoot) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "mewkit-hardgate-"));
+    copyClaudeHarness(srcRoot, dir);
+    const plansDir = path.join(dir, "tasks", "plans");
+    fs.mkdirSync(plansDir, { recursive: true });
+    fs.mkdirSync(path.join(dir, "tasks", "contracts"), { recursive: true });
+    fs.writeFileSync(path.join(dir, "CLAUDE.md"), "# test project\n");
+    const frontmatter = (approved) => `---\nstatus: ${approved ? "approved" : "pending"}\n---\n# plan\n`;
+    return {
+        dir,
+        cleanup: () => fs.rmSync(dir, { recursive: true, force: true }),
+        addPlan: (opts = {}) => {
+            const slug = opts.slug ?? "260531-demo";
+            let planPath;
+            if (opts.nested) {
+                const planDir = path.join(plansDir, slug);
+                fs.mkdirSync(planDir, { recursive: true });
+                planPath = path.join(planDir, "plan.md");
+            }
+            else {
+                planPath = path.join(plansDir, `${slug}.md`);
+            }
+            fs.writeFileSync(planPath, frontmatter(opts.approved ?? false));
+            return planPath;
+        },
+        clearPlans: () => {
+            fs.rmSync(plansDir, { recursive: true, force: true });
+            fs.mkdirSync(plansDir, { recursive: true });
+        },
+        addEnvFile: (name = ".env") => {
+            const envPath = path.join(dir, name);
+            fs.writeFileSync(envPath, "SECRET=do-not-read\n");
+            return envPath;
+        },
+    };
+}
+//# sourceMappingURL=harness-scaffold.js.map

package/dist/core/harness-scaffold.js.map

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

package/dist/core/hook-runner.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Replays a Claude Code hook exactly as `.claude/settings.json` configures it:
+ * same interpreter, same script, JSON on stdin (NOT positional args). This is the
+ * single source of truth shared by the configured-hook integration tests and the
+ * `doctor --hard-gates` probes — neither hardcodes `bash`, so both reproduce the
+ * real invocation (and would catch an `sh`/dash runtime mismatch).
+ */
+export interface HookCommand {
+    /** The raw command string from settings.json. */
+    raw: string;
+    /** First token of the command — e.g. "bash", "sh", "node". */
+    interpreter: string;
+    /** Script path as written in settings.json (may contain `$CLAUDE_PROJECT_DIR`). */
+    scriptRef: string;
+    /** Basename of the script, for filtering/identification. */
+    script: string;
+}
+export interface HookRunResult {
+    script: string;
+    interpreter: string;
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface HookToolInput {
+    file_path?: string;
+    command?: string;
+    [key: string]: unknown;
+}
+export interface RunConfiguredHookOptions {
+    projectDir: string;
+    event: string;
+    /** Concrete tool name (e.g. "Write") matched against each group's `matcher` regex. */
+    tool?: string;
+    /** tool_name field in the stdin JSON; defaults to `tool`. */
+    toolName?: string;
+    toolInput?: HookToolInput;
+    extraEnv?: Record<string, string>;
+    /** Skip non-shell (e.g. node) commands. Default true — shell hooks are the runtime-mismatch surface. */
+    shellOnly?: boolean;
+    /** If set, only run the command whose script basename equals this value. */
+    only?: string;
+    /** Script basenames to skip (e.g. a slow bootstrap hook irrelevant to the probe). */
+    exclude?: string[];
+}
+interface HookEntry {
+    type?: string;
+    command?: string;
+}
+interface HookGroup {
+    matcher?: string;
+    hooks?: HookEntry[];
+}
+interface SettingsShape {
+    hooks?: Record<string, HookGroup[]>;
+}
+/**
+ * Walk settings.hooks[event], returning every command whose group matches `tool`.
+ * Pure — does not expand `$CLAUDE_PROJECT_DIR` (that happens at run time).
+ */
+export declare function parseHookCommands(settings: SettingsShape, event: string, tool?: string): HookCommand[];
+/**
+ * Reconstruct and run the configured hook commands for one event/tool against
+ * `projectDir`, feeding the canonical JSON-on-stdin payload. Returns one result
+ * per executed command (in settings order).
+ */
+export declare function runConfiguredHook(settings: SettingsShape, opts: RunConfiguredHookOptions): HookRunResult[];
+export {};
+//# sourceMappingURL=hook-runner.d.ts.map

package/dist/core/hook-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.d.ts","sourceRoot":"","sources":["../../src/core/hook-runner.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC3B,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,wGAAwG;IACxG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,UAAU,SAAS;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,UAAU,SAAS;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACpB;AACD,UAAU,aAAa;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACpC;AA0BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAatG;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,wBAAwB,GAAG,aAAa,EAAE,CAoC1G"}

package/dist/core/hook-runner.js

@@ -0,0 +1,95 @@
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+const SHELL_INTERPRETERS = new Set(["sh", "bash", "dash", "zsh"]);
+/** First token + first double-quoted argument of a hook command string. */
+function parseCommand(raw) {
+    const interpMatch = raw.match(/^(\S+)\s+"([^"]+)"/);
+    if (!interpMatch)
+        return null;
+    const interpreter = interpMatch[1] ?? "";
+    const scriptRef = interpMatch[2] ?? "";
+    return { raw, interpreter, scriptRef, script: path.basename(scriptRef) };
+}
+/** Does a concrete tool name satisfy a group's matcher regex (e.g. "Edit|Write")? */
+function matcherMatches(groupMatcher, tool) {
+    // Matcher-less groups (SessionStart, Stop, …) apply to the event unconditionally.
+    if (!groupMatcher)
+        return true;
+    // A matcher present but no concrete tool requested → include (caller wants all).
+    if (!tool)
+        return true;
+    try {
+        return new RegExp(`^(?:${groupMatcher})$`).test(tool);
+    }
+    catch {
+        return groupMatcher === tool;
+    }
+}
+/**
+ * Walk settings.hooks[event], returning every command whose group matches `tool`.
+ * Pure — does not expand `$CLAUDE_PROJECT_DIR` (that happens at run time).
+ */
+export function parseHookCommands(settings, event, tool) {
+    const groups = settings.hooks?.[event];
+    if (!Array.isArray(groups))
+        return [];
+    const out = [];
+    for (const group of groups) {
+        if (!matcherMatches(group.matcher, tool))
+            continue;
+        for (const entry of group.hooks ?? []) {
+            if (typeof entry.command !== "string")
+                continue;
+            const parsed = parseCommand(entry.command);
+            if (parsed)
+                out.push(parsed);
+        }
+    }
+    return out;
+}
+function expandScriptRef(scriptRef, projectDir) {
+    return scriptRef.replace(/\$\{?CLAUDE_PROJECT_DIR\}?/g, projectDir);
+}
+/**
+ * Reconstruct and run the configured hook commands for one event/tool against
+ * `projectDir`, feeding the canonical JSON-on-stdin payload. Returns one result
+ * per executed command (in settings order).
+ */
+export function runConfiguredHook(settings, opts) {
+    const shellOnly = opts.shellOnly !== false;
+    const commands = parseHookCommands(settings, opts.event, opts.tool);
+    const input = JSON.stringify({
+        hook_event_name: opts.event,
+        tool_name: opts.toolName ?? opts.tool ?? "",
+        tool_input: opts.toolInput ?? {},
+        session_id: "hook-runner",
+        cwd: opts.projectDir,
+        transcript_path: "",
+    });
+    const results = [];
+    for (const cmd of commands) {
+        if (shellOnly && !SHELL_INTERPRETERS.has(cmd.interpreter))
+            continue;
+        if (opts.only && cmd.script !== opts.only)
+            continue;
+        if (opts.exclude?.includes(cmd.script))
+            continue;
+        const scriptPath = expandScriptRef(cmd.scriptRef, opts.projectDir);
+        const proc = spawnSync(cmd.interpreter, [scriptPath], {
+            cwd: opts.projectDir,
+            input,
+            encoding: "utf8",
+            timeout: 15000,
+            env: { ...process.env, CLAUDE_PROJECT_DIR: opts.projectDir, ...opts.extraEnv },
+        });
+        results.push({
+            script: cmd.script,
+            interpreter: cmd.interpreter,
+            status: proc.status,
+            stdout: proc.stdout ?? "",
+            stderr: proc.stderr ?? "",
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=hook-runner.js.map

package/dist/core/hook-runner.js.map

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

package/dist/core/index.d.ts

@@ -14,4 +14,6 @@ export * from "./release-metadata.js";
 export * from "./core-logger.js";
 export * from "./skills-dependencies.js";
 export * from "./dependency-installer.js";
+export * from "./pack-manifest.js";
+export * from "./pack-resolver.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/core/index.js

@@ -14,4 +14,6 @@ export * from "./release-metadata.js";
 export * from "./core-logger.js";
 export * from "./skills-dependencies.js";
 export * from "./dependency-installer.js";
+export * from "./pack-manifest.js";
+export * from "./pack-resolver.js";
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

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

@@ -70,6 +70,13 @@ export declare const InstallMetadataSchema: z.ZodObject<{
     }, {
         merged: string[];
     }>>;
+    /** Installed profile name ("full" for a whole-tree install). */
+    profile: z.ZodOptional<z.ZodString>;
+    /**
+     * Resolved pack list for a partial install. Absent/undefined is the "full,
+     * auto-adopt new packs on upgrade" sentinel — never a frozen all-packs list.
+     */
+    packs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     version: string;
     files: {
@@ -89,6 +96,8 @@ export declare const InstallMetadataSchema: z.ZodObject<{
     settings?: {
         merged: string[];
     } | undefined;
+    profile?: string | undefined;
+    packs?: string[] | undefined;
 }, {
     version: string;
     files: {
@@ -108,6 +117,8 @@ export declare const InstallMetadataSchema: z.ZodObject<{
     settings?: {
         merged: string[];
     } | undefined;
+    profile?: string | undefined;
+    packs?: string[] | undefined;
 }>;
 export type InstallMetadata = z.infer<typeof InstallMetadataSchema>;
 export type MetadataSource = "new" | "legacy-manifest" | "legacy-metadata" | "none";
@@ -147,6 +158,10 @@ export interface BuildInstallMetadataOptions {
     scope?: string;
     /** settings.json files merged this install. */
     mergedSettings?: string[];
+    /** Installed profile name (recorded verbatim; "full" for whole-tree installs). */
+    profile?: string;
+    /** Resolved pack list for a partial install; omit for full/legacy (sentinel). */
+    packs?: string[];
 }
 /**
  * Scan an installed `.claude/` and build canonical metadata. Ownership for kit

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

@@ -1 +1 @@
-{"version":3,"file":"install-metadata.d.ts","sourceRoot":"","sources":["../../src/core/install-metadata.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AACpF,MAAM,WAAW,yBAAyB;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7B;AAED,0FAA0F;AAC1F,qBAAa,2BAA4B,SAAQ,KAAK;aACzB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI1C;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAIzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAyChF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAGpF;AA6BD,MAAM,WAAW,2BAA2B;IAC3C,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACtD,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,GAAG,eAAe,CA2C1G"}
+{"version":3,"file":"install-metadata.d.ts","sourceRoot":"","sources":["../../src/core/install-metadata.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQjC,gEAAgE;;IAEhE;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEF,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AACpF,MAAM,WAAW,yBAAyB;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7B;AAED,0FAA0F;AAC1F,qBAAa,2BAA4B,SAAQ,KAAK;aACzB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI1C;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAIzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAyChF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAGpF;AA6BD,MAAM,WAAW,2BAA2B;IAC3C,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACtD,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,GAAG,eAAe,CA6C1G"}

package/dist/core/install-metadata.js

@@ -26,6 +26,13 @@ export const InstallMetadataSchema = z.object({
     installedAt: z.string(),
     files: z.array(InstallFileEntrySchema),
     settings: z.object({ merged: z.array(z.string()) }).optional(),
+    /** Installed profile name ("full" for a whole-tree install). */
+    profile: z.string().optional(),
+    /**
+     * Resolved pack list for a partial install. Absent/undefined is the "full,
+     * auto-adopt new packs on upgrade" sentinel — never a frozen all-packs list.
+     */
+    packs: z.array(z.string()).optional(),
 });
 /** Thrown when a canonical metadata.json carries `schemaVersion` but fails validation. */
 export class CorruptInstallMetadataError extends Error {
@@ -175,6 +182,10 @@ export function buildInstallMetadata(claudeDir, opts) {
         meta.scope = opts.scope;
     if (opts.mergedSettings && opts.mergedSettings.length > 0)
         meta.settings = { merged: opts.mergedSettings };
+    if (opts.profile)
+        meta.profile = opts.profile;
+    if (opts.packs)
+        meta.packs = opts.packs;
     return meta;
 }
 //# sourceMappingURL=install-metadata.js.map