mewkit 1.10.2 → 1.11.0

package/dist/commands/pack.js

@@ -0,0 +1,192 @@
+// `mewkit pack <list|add|remove>` — post-install domain management built on the
+// P1 resolver + P2 allow-set filter. add = scoped install; remove = safe,
+// exclusivity-checked delete (never touches base, another installed pack, a
+// settings.json-referenced hook, or a user-modified file).
+import { unlinkSync } from "node:fs";
+import { join } from "node:path";
+import pc from "picocolors";
+import * as p from "@clack/prompts";
+import { availablePacks, BASE_PACK, cleanupDownload, downloadRelease, hasPackManifest, loadPackManifest, resolvePacksDetailed, smartUpdate, } from "../core/index.js";
+import { buildInventory } from "../core/build-inventory.js";
+import { readEvents } from "../core/event-log.js";
+import { analyzeArtifactUsage } from "../core/usage/usage-analyzer.js";
+import { computeRemovablePaths, CorruptInstallMetadataError, pickInstallRelease, readInstalledState, rebuildMetadata, } from "./pack-helpers.js";
+/** Packs that are core safety surface — never removable. */
+const PROTECTED_PACKS = new Set([BASE_PACK, "lifecycle-core"]);
+const BLANK_CONFIG = { description: "", enableCostTracking: true, enableMemory: true, geminiApiKey: null };
+export async function pack(args) {
+    const claudeDir = join(process.cwd(), ".claude");
+    if (!hasPackManifest(claudeDir)) {
+        console.error(pc.red("Pack management requires meowkit with a pack-manifest.json."));
+        console.log(pc.dim("Run `mewkit upgrade` first, then retry."));
+        process.exit(1);
+    }
+    const manifest = loadPackManifest(claudeDir);
+    let state;
+    try {
+        state = readInstalledState(claudeDir, manifest);
+    }
+    catch (err) {
+        if (err instanceof CorruptInstallMetadataError) {
+            console.error(pc.red(`Installed metadata is corrupt: ${err.detail}`));
+            console.log(pc.dim("Run `mewkit upgrade` to repair, then retry."));
+            process.exit(1);
+        }
+        throw err;
+    }
+    switch (args.subcommand) {
+        case "list":
+            return packList(claudeDir, manifest, state.installedPacks, args.json === true);
+        case "add":
+            return packAdd(claudeDir, manifest, state.meta, state.installedPacks, args);
+        case "remove":
+            return packRemove(claudeDir, manifest, state.meta, state.installedPacks, args);
+        case "suggest-prune":
+            return packSuggestPrune(claudeDir, manifest, state.meta, state.installedPacks, args);
+        default:
+            console.error(pc.red(`Unknown pack subcommand: ${args.subcommand ?? "(none)"}`));
+            console.log(pc.dim("Usage: mewkit pack <list|add|remove> [packs...]"));
+            process.exit(1);
+    }
+}
+function packSuggestPrune(claudeDir, manifest, meta, installed, args) {
+    const entries = buildInventory(claudeDir).entries;
+    const { events } = readEvents(claudeDir, { since: args.since });
+    const usage = analyzeArtifactUsage(entries, events);
+    const installedNonBase = installed.filter((n) => n !== BASE_PACK);
+    const rows = installedNonBase.map((packName) => {
+        const removal = computeRemovablePaths(claudeDir, manifest, installedNonBase, [packName], meta?.files ?? []);
+        return {
+            pack: packName,
+            status: usage.status === "na" ? "insufficient-evidence" : "candidate",
+            deletable: removal.deletable.length,
+            preserved: removal.preserved.length,
+            reason: usage.status === "na" ? usage.reason : `Usage threshold ${args.threshold ?? 1}`,
+        };
+    });
+    if (args.json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    console.log(pc.bold(pc.cyan("Pack prune suggestions")));
+    console.log(pc.dim("Report only — no files were deleted."));
+    for (const row of rows) {
+        console.log(`  ${row.pack}: ${row.status}; ${row.deletable} removable, ${row.preserved} preserved`);
+        if (row.reason)
+            console.log(`      ${pc.dim(row.reason)}`);
+    }
+}
+function packList(claudeDir, manifest, installed, json) {
+    const installedSet = new Set(installed);
+    const detailed = resolvePacksDetailed(claudeDir, manifest, installed.filter((n) => n !== BASE_PACK));
+    const rows = availablePacks(manifest).map((name) => ({
+        pack: name,
+        installed: installedSet.has(name),
+        members: detailed.packMembership.get(name)?.size ?? 0,
+    }));
+    if (json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    console.log(pc.bold(pc.cyan("MeowKit packs")));
+    console.log(pc.dim("base is always installed (safety rules, hooks, settings, core commands)."));
+    console.log();
+    for (const r of rows) {
+        const mark = r.installed ? pc.green("installed") : pc.dim("available");
+        const count = r.installed ? pc.dim(` (${r.members} files)`) : "";
+        console.log(`  [${mark}] ${r.pack}${count}`);
+    }
+}
+async function packAdd(claudeDir, manifest, meta, installed, args) {
+    const requested = args.packs.filter((n) => n !== BASE_PACK);
+    for (const n of requested) {
+        if (!(n in manifest.packs)) {
+            console.error(pc.red(`Unknown pack "${n}". Available: ${availablePacks(manifest).join(", ")}`));
+            process.exit(1);
+        }
+    }
+    const installedSet = new Set(installed);
+    const newPacks = requested.filter((n) => !installedSet.has(n));
+    if (newPacks.length === 0) {
+        console.log(pc.dim(`Already installed: ${requested.join(", ") || "(nothing requested)"} — nothing to do.`));
+        return;
+    }
+    const release = await pickInstallRelease(meta?.version);
+    if (!release) {
+        console.error(pc.red("No releases found on GitHub."));
+        process.exit(1);
+    }
+    console.log(pc.dim(`Fetching v${release.version} to add: ${newPacks.join(", ")}...`));
+    const sourceDir = await downloadRelease(release);
+    try {
+        const srcClaude = join(sourceDir, ".claude");
+        const srcManifest = loadPackManifest(srcClaude);
+        const installedPaths = new Set((meta?.files ?? []).map((f) => f.path));
+        const resolved = resolvePacksDetailed(srcClaude, srcManifest, newPacks).paths;
+        const allowed = new Set([...resolved].filter((pth) => !installedPaths.has(pth)));
+        // Store only user-selected packs — `base` is the always-implicit pseudo-pack,
+        // re-prepended by readInstalledState; keeping it out of metadata keeps the
+        // stored list semantically "the optional domains installed".
+        const nextPacks = [...new Set([...installed, ...newPacks])].filter((n) => n !== BASE_PACK);
+        // cleanup:false ⇒ a focused add only WRITES new files; it never deletes.
+        const stats = await smartUpdate(BLANK_CONFIG, sourceDir, process.cwd(), false, false, {
+            cleanup: false,
+            allowedPaths: allowed,
+            profile: meta?.profile,
+            packs: nextPacks,
+            assumeYes: true,
+        });
+        console.log(pc.green(`Added ${newPacks.join(", ")}: ${stats.added} file(s) written, ${stats.updated} updated.`));
+    }
+    finally {
+        cleanupDownload(sourceDir);
+    }
+}
+async function packRemove(claudeDir, manifest, meta, installed, args) {
+    const requested = args.packs;
+    for (const n of requested) {
+        if (PROTECTED_PACKS.has(n)) {
+            console.error(pc.red(`Refusing to remove "${n}" — core safety surface is not removable.`));
+            process.exit(1);
+        }
+        if (!(n in manifest.packs)) {
+            console.error(pc.red(`Unknown pack "${n}". Available: ${availablePacks(manifest).join(", ")}`));
+            process.exit(1);
+        }
+    }
+    const removeSet = new Set(requested);
+    // Stored list excludes the implicit `base` (re-prepended by readInstalledState).
+    const nextPacks = installed.filter((n) => n !== BASE_PACK && !removeSet.has(n));
+    const { deletable, preserved } = computeRemovablePaths(claudeDir, manifest, installed.filter((n) => n !== BASE_PACK), requested, meta?.files ?? []);
+    if (deletable.length === 0) {
+        console.log(pc.dim(`Nothing to remove for ${requested.join(", ")} (no pristine pack-exclusive files).`));
+        if (preserved.length > 0)
+            console.log(pc.yellow(`${preserved.length} shared/modified file(s) preserved.`));
+        return;
+    }
+    if (!args.yes) {
+        const confirm = await p.confirm({ message: `Delete ${deletable.length} file(s) for ${requested.join(", ")}?`, initialValue: false });
+        if (p.isCancel(confirm) || confirm !== true) {
+            console.log(pc.dim("Cancelled."));
+            return;
+        }
+    }
+    // Crash-safety: record the next pack list BEFORE deleting, then full rebuild.
+    await rebuildMetadata(claudeDir, meta, nextPacks);
+    const deleted = [];
+    for (const pth of deletable) {
+        try {
+            unlinkSync(join(claudeDir, pth));
+            deleted.push(pth);
+        }
+        catch (err) {
+            console.log(pc.yellow(`Failed to delete ${pth}: ${err.message}`));
+        }
+    }
+    await rebuildMetadata(claudeDir, meta, nextPacks);
+    console.log(pc.green(`Removed ${requested.join(", ")}: ${deleted.length} file(s) deleted.`));
+    if (preserved.length > 0) {
+        console.log(pc.yellow(`${preserved.length} shared/base/modified file(s) preserved.`));
+    }
+}
+//# sourceMappingURL=pack.js.map

package/dist/commands/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0EAA0E;AAC1E,4EAA4E;AAC5E,2DAA2D;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACN,cAAc,EACd,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,GAEX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GACf,MAAM,mBAAmB,CAAC;AAY3B,4DAA4D;AAC5D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAE/D,MAAM,YAAY,GAAe,EAAE,WAAW,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AAEvH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACJ,KAAK,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,GAAG,YAAY,2BAA2B,EAAE,CAAC;YAChD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,kCAAkC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;IAED,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QACzB,KAAK,MAAM;YACV,OAAO,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChF,KAAK,KAAK;YACT,OAAO,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC7E,KAAK,QAAQ;YACZ,OAAO,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAChF,KAAK,eAAe;YACnB,OAAO,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACtF;YACC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC;YACjF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CACxB,SAAiB,EACjB,QAA6C,EAC7C,IAA4D,EAC5D,SAAmB,EACnB,IAAc;IAEd,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5G,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,WAAW;YACrE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YACnC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE;SACvF,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACR,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,SAAS,eAAe,GAAG,CAAC,SAAS,YAAY,CAAC,CAAC;QACpG,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB,EAAE,QAA6C,EAAE,SAAmB,EAAE,IAAa;IACrH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IACrG,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QACjC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC;KACrD,CAAC,CAAC,CAAC;IAEJ,IAAI,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACR,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC,CAAC;IAChG,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;AACF,CAAC;AAED,KAAK,UAAU,OAAO,CACrB,SAAiB,EACjB,QAA6C,EAC7C,IAA4D,EAC5D,SAAmB,EACnB,IAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,iBAAiB,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qBAAqB,mBAAmB,CAAC,CAAC,CAAC;QAC5G,OAAO;IACR,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,OAAO,YAAY,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC;QAC9E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEjF,8EAA8E;QAC9E,2EAA2E;QAC3E,6DAA6D;QAC7D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAC3F,yEAAyE;QACzE,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;YACrF,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,OAAO;YACrB,OAAO,EAAE,IAAI,EAAE,OAAO;YACtB,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,IAAI;SACf,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,qBAAqB,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;IAClH,CAAC;YAAS,CAAC;QACV,eAAe,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;AACF,CAAC;AAED,KAAK,UAAU,UAAU,CACxB,SAAiB,EACjB,QAA6C,EAC7C,IAA4D,EAC5D,SAAmB,EACnB,IAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,uBAAuB,CAAC,2CAA2C,CAAC,CAAC,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,iBAAiB,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,iFAAiF;IACjF,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,qBAAqB,CACrD,SAAS,EACT,QAAQ,EACR,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EACxC,SAAS,EACT,IAAI,EAAE,KAAK,IAAI,EAAE,CACjB,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,yBAAyB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC,CAAC;QACzG,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,qCAAqC,CAAC,CAAC,CAAC;QAC3G,OAAO;IACR,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,SAAS,CAAC,MAAM,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACrI,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;YAClC,OAAO;QACR,CAAC;IACF,CAAC;IAED,8EAA8E;IAC9E,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACJ,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,GAAG,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IACD,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC;IAC7F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,0CAA0C,CAAC,CAAC,CAAC;IACvF,CAAC;AACF,CAAC"}

package/dist/commands/policy.d.ts

@@ -0,0 +1,8 @@
+export interface PolicyArgs {
+    subcommand?: string;
+    profile?: string;
+    json?: boolean;
+    yes?: boolean;
+}
+export declare function policy(args?: PolicyArgs): Promise<void>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/commands/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/commands/policy.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAeD,wBAAsB,MAAM,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CjE"}

package/dist/commands/policy.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import * as p from "@clack/prompts";
+import { parsePolicyProfile, readGatePolicy, writeGatePolicy } from "../core/gate-policy.js";
+function findClaudeDir() {
+    const candidate = path.join(process.cwd(), ".claude");
+    return fs.existsSync(candidate) && fs.statSync(candidate).isDirectory() ? candidate : null;
+}
+async function confirmWeakening(current, next, yes) {
+    if (yes || current === next)
+        return true;
+    const rank = { lightweight: 1, balanced: 2, strict: 3 };
+    if (rank[next] >= rank[current])
+        return true;
+    const ok = await p.confirm({ message: `Switch policy from ${current} to weaker ${next}?`, initialValue: false });
+    return !p.isCancel(ok) && ok === true;
+}
+export async function policy(args = {}) {
+    const claudeDir = findClaudeDir();
+    if (!claudeDir) {
+        console.error(pc.red("Could not find .claude/ directory in the current directory."));
+        process.exit(1);
+    }
+    const sub = args.subcommand ?? "explain";
+    const current = readGatePolicy(claudeDir);
+    if (sub === "explain") {
+        if (args.json) {
+            console.log(JSON.stringify(current, null, 2));
+            return;
+        }
+        console.log(pc.bold(pc.cyan("MeowKit gate policy")));
+        console.log(`${pc.dim("Profile:")} ${current.policy.profile}`);
+        console.log(`${pc.dim("Source:")} ${current.source}`);
+        if (current.error)
+            console.log(`${pc.yellow("Warning:")} ${current.error}`);
+        console.log(`  plan gate: ${current.policy.planGate}`);
+        console.log(`  approved plan required: ${String(current.policy.requireApprovedPlan)}`);
+        console.log(`  contract gate: ${current.policy.contractGate}`);
+        console.log(`  review gate: ${current.policy.reviewGate}`);
+        console.log(`  build verify: ${current.policy.buildVerify}`);
+        console.log(`  human approval: ${current.policy.humanApproval}`);
+        console.log(pc.dim("Privacy and prompt-injection blocks are never disabled by policy."));
+        return;
+    }
+    if (sub === "set") {
+        const next = parsePolicyProfile(args.profile);
+        if (!next) {
+            console.error(pc.red(`Unknown policy profile: ${args.profile ?? "(missing)"}`));
+            console.log(pc.dim("Usage: mewkit policy set <strict|balanced|lightweight>"));
+            process.exit(1);
+        }
+        if (!(await confirmWeakening(current.policy.profile, next, args.yes))) {
+            console.log(pc.dim("Cancelled."));
+            return;
+        }
+        writeGatePolicy(claudeDir, next);
+        console.log(pc.green(`Policy set to ${next}.`));
+        return;
+    }
+    console.error(pc.red(`Unknown policy subcommand: ${sub}`));
+    console.log(pc.dim("Usage: mewkit policy <explain|set> [profile]"));
+    process.exit(1);
+}
+//# sourceMappingURL=policy.js.map

package/dist/commands/policy.js.map

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

package/dist/commands/portability.d.ts

@@ -0,0 +1,7 @@
+export interface PortabilityArgs {
+    subcommand?: string;
+    provider?: string;
+    json?: boolean;
+}
+export declare function portability(args?: PortabilityArgs): void;
+//# sourceMappingURL=portability.d.ts.map

package/dist/commands/portability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability.d.ts","sourceRoot":"","sources":["../../src/commands/portability.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAMD,wBAAgB,WAAW,CAAC,IAAI,GAAE,eAAoB,GAAG,IAAI,CAyC5D"}

package/dist/commands/portability.js

@@ -0,0 +1,50 @@
+import pc from "picocolors";
+import { buildPortabilityMatrix, coverage, explainProvider } from "../core/portability-matrix.js";
+import { ProviderType } from "../migrate/types.js";
+function pad(s, n) {
+    return s.length >= n ? s : s + " ".repeat(n - s.length);
+}
+export function portability(args = {}) {
+    const sub = args.subcommand ?? "matrix";
+    if (sub === "matrix") {
+        const rows = buildPortabilityMatrix();
+        if (args.json) {
+            console.log(JSON.stringify(rows, null, 2));
+            return;
+        }
+        console.log(pc.bold(pc.cyan("Provider capability matrix")));
+        console.log(`  ${pc.bold(pad("PROVIDER", 16))} ${pc.bold(pad("SURFACE", 8))} ${pc.bold(pad("STATUS", 12))} CONTRACT`);
+        for (const r of rows) {
+            console.log(`  ${pad(r.provider, 16)} ${pad(r.surface, 8)} ${pad(r.displayStatus, 12)} ${r.surfaceStatus}`);
+        }
+        return;
+    }
+    if (sub === "coverage") {
+        const result = coverage();
+        console.log(args.json ? JSON.stringify(result, null, 2) : `${result.documented}/${result.surfaces} documented surfaces, ${result.warn} warn, ${result.fail} fail`);
+        return;
+    }
+    if (sub === "explain") {
+        const parsed = ProviderType.safeParse(args.provider);
+        if (!parsed.success) {
+            console.error(pc.red(`Unknown provider: ${args.provider ?? "(missing)"}`));
+            process.exit(1);
+        }
+        const rows = explainProvider(parsed.data);
+        if (args.json) {
+            console.log(JSON.stringify(rows, null, 2));
+            return;
+        }
+        console.log(pc.bold(pc.cyan(`Provider capability: ${parsed.data}`)));
+        for (const r of rows) {
+            console.log(`  ${pc.bold(r.surface)}: ${r.displayStatus} (${r.message})`);
+            if (r.docs.length > 0)
+                console.log(`      ${pc.dim(r.docs.join(", "))}`);
+        }
+        return;
+    }
+    console.error(pc.red(`Unknown portability subcommand: ${sub}`));
+    console.log(pc.dim("Usage: mewkit portability <matrix|coverage|explain> [provider] [--json]"));
+    process.exit(1);
+}
+//# sourceMappingURL=portability.js.map

package/dist/commands/portability.js.map

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

package/dist/commands/reflect.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `mewkit reflect` — retrospective over the canonical event log: what the harness
+ * actually did (gates blocked, hooks failed, review outcomes, …). Pure consumer of
+ * core/event-log.ts. Honesty rule dominates: metrics with no emitter or no derivable
+ * pairing render `N/A`, never a fabricated zero.
+ */
+export interface ReflectOptions {
+    /** Time window: `Nd` / `Nh` / ISO instant. */
+    last?: string;
+    task?: string;
+    json?: boolean;
+}
+export declare function reflect(opts?: ReflectOptions): void;
+//# sourceMappingURL=reflect.d.ts.map

package/dist/commands/reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../src/commands/reflect.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC9B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AA0JD,wBAAgB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,IAAI,CAgBvD"}

package/dist/commands/reflect.js

@@ -0,0 +1,135 @@
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import { readEvents } from "../core/event-log.js";
+function bump(tally, key) {
+    tally.set(key, (tally.get(key) ?? 0) + 1);
+}
+function tallyToSorted(tally) {
+    return [...tally.entries()].sort((a, b) => b[1] - a[1]).map(([label, count]) => ({ label, count }));
+}
+function str(value, fallback = "?") {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function aggregate(events, malformed, window) {
+    const gateBlocks = new Map();
+    const privacyBlocks = new Map();
+    const hookFailures = new Map();
+    const reviewOutcomes = new Map();
+    const reviewFailBySlug = new Map();
+    let injectionBlocks = 0;
+    for (const e of events) {
+        switch (e.event) {
+            case "gate.blocked":
+                bump(gateBlocks, `${str(e.data.gate)} — ${str(e.data.reason, "")}`);
+                break;
+            case "privacy.blocked":
+                bump(privacyBlocks, str(e.data.kind));
+                break;
+            case "injection.blocked":
+                injectionBlocks++;
+                break;
+            case "hook.failed":
+                bump(hookFailures, `${str(e.data.hook)} (${str(e.data.shell)}) exit ${str(String(e.data.exit_code), "?")}`);
+                break;
+            case "verdict_written": {
+                const overall = str(e.data.overall).toUpperCase();
+                bump(reviewOutcomes, overall);
+                if (overall === "FAIL")
+                    bump(reviewFailBySlug, str(e.data.slug));
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    const repeatedReviewFailures = tallyToSorted(reviewFailBySlug).filter((r) => r.count > 1);
+    return {
+        window,
+        totalEvents: events.length,
+        malformed,
+        gateBlocks: tallyToSorted(gateBlocks),
+        privacyBlocks: tallyToSorted(privacyBlocks),
+        injectionBlocks,
+        hookFailures: tallyToSorted(hookFailures),
+        reviewOutcomes: tallyToSorted(reviewOutcomes),
+        repeatedReviewFailures,
+        // Reserved — no emitter today (trace-schema.md). Never list/zero as if real.
+        skillsInvoked: null,
+        memoryWrites: null,
+        selfHealingAttempts: null,
+        timings: null,
+    };
+}
+function findClaudeDir() {
+    const candidate = path.join(process.cwd(), ".claude");
+    return fs.existsSync(candidate) && fs.statSync(candidate).isDirectory() ? candidate : null;
+}
+const NA = pc.dim("N/A — usage events not emitted");
+function renderList(title, rows) {
+    console.log(pc.bold(title));
+    if (rows.length === 0) {
+        console.log(`  ${pc.dim("none in window")}`);
+        return;
+    }
+    for (const { label, count } of rows) {
+        console.log(`  ${pc.cyan(String(count).padStart(4))}  ${label}`);
+    }
+}
+function renderText(report) {
+    console.log(pc.bold(pc.cyan("MeowKit reflect — harness retrospective")));
+    console.log(pc.dim(`Window: ${report.window} · ${report.totalEvents} events${report.malformed > 0 ? ` · ${report.malformed} malformed (skipped)` : ""}`));
+    if (report.window.includes("task ")) {
+        // Honest caveat: gate/privacy/injection/hook events carry no data.task today,
+        // so a task filter shows only workflow events — not gate/hook blocks.
+        console.log(pc.dim("Note: --task matches workflow events only; gate/privacy/hook events are not task-tagged."));
+    }
+    console.log();
+    if (report.totalEvents === 0) {
+        console.log(pc.yellow("No events in window — nothing to reflect on yet."));
+        console.log(pc.dim("The event log fills as the safety hooks block and the harness runs."));
+        return;
+    }
+    renderList("Gate blocks (by gate · reason)", report.gateBlocks);
+    console.log();
+    renderList("Privacy blocks (by kind)", report.privacyBlocks);
+    console.log();
+    console.log(pc.bold("Injection blocks"));
+    console.log(`  ${pc.cyan(String(report.injectionBlocks).padStart(4))}  prompt-injection (advisory)`);
+    console.log();
+    renderList("Hook failures (by hook · shell · exit)", report.hookFailures);
+    console.log();
+    renderList("Review outcomes (verdict_written)", report.reviewOutcomes);
+    console.log();
+    console.log(pc.bold("Repeated review failures"));
+    if (report.repeatedReviewFailures.length === 0) {
+        console.log(`  ${pc.dim("none repeated in window")}`);
+    }
+    else {
+        for (const { label, count } of report.repeatedReviewFailures) {
+            console.log(`  ${pc.yellow(`×${count}`)}  ${label}`);
+        }
+    }
+    console.log();
+    // Honest N/A panels — reserved/underivable metrics.
+    console.log(pc.bold("Skills invoked") + `  ${NA}`);
+    console.log(pc.bold("Memory writes") + `  ${NA}`);
+    console.log(pc.bold("Self-healing attempts") + `  ${pc.dim("N/A — recovery events not emitted")}`);
+    console.log(pc.bold("Lifecycle timings") + `  ${pc.dim("N/A — phase-transition events not emitted")}`);
+}
+export function reflect(opts = {}) {
+    const claudeDir = findClaudeDir();
+    if (!claudeDir) {
+        console.error(pc.red("Could not find .claude/ directory in the current directory."));
+        process.exit(1);
+    }
+    const { events, malformed } = readEvents(claudeDir, { since: opts.last, task: opts.task });
+    const window = opts.last ? `last ${opts.last}${opts.task ? ` · task ${opts.task}` : ""}` : opts.task ? `task ${opts.task}` : "all";
+    const report = aggregate(events, malformed, window);
+    if (opts.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    renderText(report);
+}
+//# sourceMappingURL=reflect.js.map

package/dist/commands/reflect.js.map

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

package/dist/commands/simulate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `mewkit simulate` — run declarative given→when→expect scenarios against a scaffolded
+ * temp harness via the real configured hooks. Generalizes the `doctor --hard-gates`
+ * probes into data-driven `.claude/simulations/*.yaml`.
+ */
+export interface SimulateOptions {
+    scenario?: string;
+    all?: boolean;
+    json?: boolean;
+    /** Downgrade SKIP from a failure to a pass (off by default — a SKIP means not exercised). */
+    allowSkip?: boolean;
+}
+export declare function simulate(opts?: SimulateOptions): Promise<void>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/commands/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/commands/simulate.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAoBD,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DxE"}

package/dist/commands/simulate.js

@@ -0,0 +1,86 @@
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import { runScenario, loadScenarioByName, listScenarios, hasHarness, } from "../core/simulation-runner.js";
+function findClaudeDir() {
+    const candidate = path.join(process.cwd(), ".claude");
+    return fs.existsSync(candidate) && fs.statSync(candidate).isDirectory() ? candidate : null;
+}
+function chip(status) {
+    if (status === "PASS")
+        return pc.green("PASS");
+    if (status === "FAIL")
+        return pc.red("FAIL");
+    return pc.yellow("SKIP");
+}
+function renderResult(result) {
+    console.log(`  [${chip(result.status)}] ${pc.bold(result.name)}`);
+    for (const step of result.steps) {
+        console.log(`         ${chip(step.status)}  ${pc.dim(`${step.detail} — expected: ${step.expected}; actual: ${step.actual}`)}`);
+    }
+}
+export async function simulate(opts = {}) {
+    const claudeDir = findClaudeDir();
+    if (!claudeDir) {
+        console.error(pc.red("Could not find .claude/ directory in the current directory."));
+        process.exit(1);
+    }
+    const srcRoot = path.dirname(claudeDir);
+    if (process.platform === "win32") {
+        console.error(pc.yellow("simulate is skipped on Windows — POSIX shell hooks cannot be probed here."));
+        return;
+    }
+    if (!hasHarness(srcRoot)) {
+        console.error(pc.red("No .claude/settings.json + hooks/ found; nothing to simulate."));
+        process.exit(1);
+    }
+    let names;
+    if (opts.all) {
+        names = listScenarios(srcRoot);
+        if (names.length === 0) {
+            console.error(pc.red("No scenarios found in .claude/simulations/."));
+            process.exit(1);
+        }
+    }
+    else if (opts.scenario) {
+        names = [opts.scenario];
+    }
+    else {
+        console.error(pc.red("Specify --scenario <name> or --all."));
+        console.log(pc.dim(`Available: ${listScenarios(srcRoot).join(", ") || "(none)"}`));
+        process.exit(1);
+    }
+    const results = [];
+    for (const name of names) {
+        try {
+            results.push(runScenario(loadScenarioByName(srcRoot, name), srcRoot));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            results.push({
+                name,
+                status: "FAIL",
+                steps: [{ status: "FAIL", detail: `Scenario load/run error: ${message}`, expected: "loadable scenario", actual: "error" }],
+            });
+        }
+    }
+    const counts = { PASS: 0, FAIL: 0, SKIP: 0 };
+    for (const r of results)
+        counts[r.status]++;
+    if (opts.json) {
+        console.log(JSON.stringify({ results, summary: counts }, null, 2));
+    }
+    else {
+        console.log(pc.bold(pc.cyan("MeowKit simulate — scenario results")));
+        console.log();
+        for (const r of results)
+            renderResult(r);
+        console.log();
+        console.log(`${pc.green(`${counts.PASS} PASS`)} / ${pc.red(`${counts.FAIL} FAIL`)} / ${pc.yellow(`${counts.SKIP} SKIP`)}`);
+    }
+    const skipIsFailure = !opts.allowSkip;
+    const failed = counts.FAIL > 0 || (skipIsFailure && counts.SKIP > 0);
+    if (failed)
+        process.exit(1);
+}
+//# sourceMappingURL=simulate.js.map