mewkit 1.10.2 → 1.10.4

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

@@ -0,0 +1,93 @@
+import { hasHarness } from "./harness-scaffold.js";
+import { type HookRunResult } from "./hook-runner.js";
+/**
+ * Declarative scenario engine that generalizes the hardcoded `doctor --hard-gates`
+ * probes into data-driven given→when→expect cases. Reuses the Phase-1 scaffold +
+ * hook-runner (the real configured-hook execution path) — independent of the event
+ * log. The `assertOutcome` here is THE single assertion path, also consumed by
+ * `doctor-hard-gates.ts`, so the two never diverge.
+ */
+export type SimStatus = "PASS" | "FAIL" | "SKIP";
+export interface ExpectSpec {
+    /** Whether the hook should block the tool call. */
+    blocked: boolean;
+    /** Marker string expected on the named stream when blocked. */
+    marker?: string;
+    /** Exact exit code; when omitted on a block, any non-zero passes. */
+    exitCode?: number;
+    /** Which stream carries the marker — explicit per scenario (block markers vary). */
+    expectStream?: "stdout" | "stderr";
+}
+interface WhenSpec {
+    /** Tool name (matched against settings.json hook matchers). */
+    tool: string;
+    /** Hook script basename to exercise (the `only` filter — keeps runs deterministic). */
+    hook: string;
+    file_path?: string;
+    command?: string;
+    /** Extra env for this step (e.g. MEOWKIT_GATE1_REQUIRE_APPROVED=1). */
+    env?: Record<string, string>;
+}
+interface GivenSpec {
+    /** Create an (unapproved) plan so Gate 1 existence passes. */
+    plan?: boolean;
+    /** Remove all plans (force the no-plan state). */
+    clearPlans?: boolean;
+    /** Arrange arbitrary files in the temp project. */
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+interface StepSpec {
+    given?: GivenSpec;
+    when: WhenSpec;
+    expect: ExpectSpec;
+}
+export interface Scenario {
+    name: string;
+    description?: string;
+    /** Single-step shorthand (mutually exclusive with `steps`). */
+    given?: GivenSpec;
+    when?: WhenSpec;
+    expect?: ExpectSpec;
+    /** Ordered multi-step lifecycle (e.g. full-lifecycle). */
+    steps?: StepSpec[];
+}
+export interface StepResult {
+    status: SimStatus;
+    detail: string;
+    expected: string;
+    actual: string;
+}
+export interface ScenarioResult {
+    name: string;
+    description?: string;
+    status: SimStatus;
+    steps: StepResult[];
+}
+/**
+ * THE shared assertion: compare a hook run result against an expectation. Returns
+ * PASS / FAIL / SKIP. Two honesty guards:
+ *  - an allow-case (`blocked:false`) where NO hook ran → SKIP (never a vacuous PASS),
+ *  - a block-case where no hook ran → FAIL (the gate was not exercised).
+ */
+export declare function assertOutcome(result: HookRunResult | undefined, expect: ExpectSpec): {
+    status: SimStatus;
+    detail: string;
+};
+/** Execute one scenario against a freshly-scaffolded temp harness. Cleans up always. */
+export declare function runScenario(scenario: Scenario, srcRoot: string): ScenarioResult;
+/** Load + validate a scenario YAML file. Throws on a malformed/under-specified scenario. */
+export declare function loadScenario(file: string): Scenario;
+export interface SimulationsDir {
+    /** Absolute path to `<repoRoot>/.claude/simulations`. */
+    dir: string;
+    exists: boolean;
+}
+export declare function simulationsDir(srcRoot: string): SimulationsDir;
+/** List scenario YAML basenames (without extension) in the simulations dir. */
+export declare function listScenarios(srcRoot: string): string[];
+export declare function loadScenarioByName(srcRoot: string, name: string): Scenario;
+export { hasHarness };
+//# sourceMappingURL=simulation-runner.d.ts.map

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

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

package/dist/core/simulation-runner.js

@@ -0,0 +1,161 @@
+import fs from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+import { scaffoldHarnessProject, hasHarness } from "./harness-scaffold.js";
+import { runConfiguredHook } from "./hook-runner.js";
+/**
+ * THE shared assertion: compare a hook run result against an expectation. Returns
+ * PASS / FAIL / SKIP. Two honesty guards:
+ *  - an allow-case (`blocked:false`) where NO hook ran → SKIP (never a vacuous PASS),
+ *  - a block-case where no hook ran → FAIL (the gate was not exercised).
+ */
+export function assertOutcome(result, expect) {
+    const stream = expect.expectStream ?? "stderr";
+    if (!result) {
+        if (expect.blocked === false) {
+            return { status: "SKIP", detail: "No hook matched the tool — allow-case not exercised (would pass vacuously)." };
+        }
+        return { status: "FAIL", detail: "Expected a block but no hook ran for this tool." };
+    }
+    const streamText = stream === "stdout" ? result.stdout : result.stderr;
+    if (expect.blocked) {
+        const markerOk = !expect.marker || streamText.includes(expect.marker);
+        const exitOk = expect.exitCode !== undefined ? result.status === expect.exitCode : result.status !== 0;
+        if (markerOk && exitOk) {
+            return { status: "PASS", detail: `Blocked as expected (exit ${result.status}${expect.marker ? `, ${expect.marker} on ${stream}` : ""}).` };
+        }
+        return {
+            status: "FAIL",
+            detail: `Expected block (exit ${expect.exitCode ?? "≠0"}${expect.marker ? `, ${expect.marker} on ${stream}` : ""}) but got exit ${result.status}; marker ${markerOk ? "present" : "absent"}.`,
+        };
+    }
+    if (result.status === 0)
+        return { status: "PASS", detail: "Allowed (exit 0)." };
+    return { status: "FAIL", detail: `Expected allow (exit 0) but got exit ${result.status}.` };
+}
+/** Apply a step's `given` to the scaffolded project (in-place). */
+function applyGiven(project, given) {
+    if (!given)
+        return;
+    if (given.clearPlans)
+        project.clearPlans();
+    if (given.plan)
+        project.addPlan({ nested: true });
+    for (const f of given.files ?? []) {
+        const abs = path.join(project.dir, f.path);
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, f.content);
+    }
+}
+/** Run a single step's `when` against the project and assert against `expect`. */
+function runStep(project, settings, step) {
+    applyGiven(project, step.given);
+    const results = runConfiguredHook(settings, {
+        projectDir: project.dir,
+        event: "PreToolUse",
+        tool: step.when.tool,
+        toolName: step.when.tool,
+        toolInput: { file_path: step.when.file_path, command: step.when.command },
+        only: step.when.hook,
+        extraEnv: step.when.env,
+    });
+    const result = results.find((r) => r.script === step.when.hook);
+    const outcome = assertOutcome(result, step.expect);
+    const stream = step.expect.expectStream ?? "stderr";
+    return {
+        status: outcome.status,
+        detail: outcome.detail,
+        expected: `${step.when.hook}: ${step.expect.blocked ? `block ${step.expect.marker ?? ""} on ${stream}` : "allow"}`.trim(),
+        actual: result ? `exit ${result.status}` : "no hook ran",
+    };
+}
+/** Normalize a scenario into its ordered step list (single-step shorthand → one step). */
+function scenarioSteps(scenario) {
+    if (scenario.steps && scenario.steps.length > 0)
+        return scenario.steps;
+    if (scenario.when && scenario.expect) {
+        return [{ given: scenario.given, when: scenario.when, expect: scenario.expect }];
+    }
+    return [];
+}
+/** worst of the step statuses: FAIL > SKIP > PASS (SKIP is a soft failure for --all). */
+function rollupSteps(steps) {
+    if (steps.length === 0)
+        return "FAIL";
+    if (steps.some((s) => s.status === "FAIL"))
+        return "FAIL";
+    if (steps.some((s) => s.status === "SKIP"))
+        return "SKIP";
+    return "PASS";
+}
+/** Execute one scenario against a freshly-scaffolded temp harness. Cleans up always. */
+export function runScenario(scenario, srcRoot) {
+    const steps = scenarioSteps(scenario);
+    if (steps.length === 0) {
+        return {
+            name: scenario.name,
+            description: scenario.description,
+            status: "FAIL",
+            steps: [{ status: "FAIL", detail: "Scenario has neither a valid `when/expect` nor `steps`.", expected: "a runnable step", actual: "none" }],
+        };
+    }
+    const project = scaffoldHarnessProject(srcRoot);
+    try {
+        const stepResults = steps.map((step) => runStep(project, settingsOf(srcRoot), step));
+        return { name: scenario.name, description: scenario.description, status: rollupSteps(stepResults), steps: stepResults };
+    }
+    finally {
+        // try/finally so the temp dir (which may hold a synthetic .env) is removed even
+        // on a spawnSync timeout/throw.
+        project.cleanup();
+    }
+}
+let _settingsCache = null;
+function settingsOf(srcRoot) {
+    if (_settingsCache?.root === srcRoot)
+        return _settingsCache.settings;
+    const settings = JSON.parse(fs.readFileSync(path.join(srcRoot, ".claude", "settings.json"), "utf8"));
+    _settingsCache = { root: srcRoot, settings };
+    return settings;
+}
+/** Load + validate a scenario YAML file. Throws on a malformed/under-specified scenario. */
+export function loadScenario(file) {
+    const parsed = yaml.load(fs.readFileSync(file, "utf8"));
+    if (typeof parsed !== "object" || parsed === null)
+        throw new Error(`${path.basename(file)}: not a YAML object`);
+    const s = parsed;
+    if (typeof s.name !== "string" || s.name.length === 0)
+        throw new Error(`${path.basename(file)}: missing 'name'`);
+    const hasSingle = s.when !== undefined && s.expect !== undefined;
+    const hasSteps = Array.isArray(s.steps) && s.steps.length > 0;
+    if (!hasSingle && !hasSteps) {
+        throw new Error(`${path.basename(file)}: must define either when+expect or a non-empty steps list`);
+    }
+    return s;
+}
+export function simulationsDir(srcRoot) {
+    const dir = path.join(srcRoot, ".claude", "simulations");
+    return { dir, exists: fs.existsSync(dir) };
+}
+/** List scenario YAML basenames (without extension) in the simulations dir. */
+export function listScenarios(srcRoot) {
+    const { dir, exists } = simulationsDir(srcRoot);
+    if (!exists)
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"))
+        .map((f) => f.replace(/\.ya?ml$/, ""))
+        .sort();
+}
+export function loadScenarioByName(srcRoot, name) {
+    const { dir } = simulationsDir(srcRoot);
+    for (const ext of [".yaml", ".yml"]) {
+        const file = path.join(dir, `${name}${ext}`);
+        if (fs.existsSync(file))
+            return loadScenario(file);
+    }
+    throw new Error(`Scenario '${name}' not found in ${dir}`);
+}
+export { hasHarness };
+//# sourceMappingURL=simulation-runner.js.map

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

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

package/dist/core/smart-update.d.ts

@@ -6,6 +6,20 @@ export interface UpdateStats {
     userModified: string[];
     orphansDeleted: string[];
     orphansSkipped: string[];
+    /** Paths from release `deletions[]` removed because they were pristine kit-owned files. */
+    deletionsDeleted: string[];
+    /** Listed deletions left in place (user-modified, not kit-owned, or declined). */
+    deletionsSkipped: string[];
+    /** Listed deletions that were already absent on disk. */
+    deletionsAlreadyGone: string[];
+    /** Listed deletions a dry-run would remove. */
+    deletionsPreview: string[];
+    /** Pristine kit files removed because they fall outside the installed profile. */
+    profileTrimmed: string[];
+    /** Out-of-profile files kept (user-modified or declined). */
+    profileTrimSkipped: string[];
+    /** Out-of-profile pristine files a dry-run would trim. */
+    profileTrimPreview: string[];
 }
 export interface SmartUpdateOptions {
     /** Default true. Set false to disable orphan deletion (CLI: `--no-cleanup`). */
@@ -22,6 +36,24 @@ export interface SmartUpdateOptions {
      * the process hangs on stdin.
      */
     confirmOrphans?: (orphans: string[]) => Promise<boolean>;
+    /**
+     * Profile install allow-set: `.claude/`-relative paths the resolved profile
+     * should write. When present, the source walk skips any file NOT in this set,
+     * and a profile-trim pass removes previously-installed pristine kit files that
+     * fall outside it (the full→core downgrade). Absent ⇒ today's full install.
+     */
+    allowedPaths?: Set<string>;
+    /** Installed profile name to record in metadata ("full" for whole-tree). */
+    profile?: string;
+    /** Resolved pack list to record in metadata; omit for full/legacy (sentinel). */
+    packs?: string[];
+    /**
+     * Opt-in profile-trim: delete previously-installed pristine kit files OUTSIDE
+     * `allowedPaths` (the full→core downgrade). ONLY `init --profile` sets this —
+     * `pack add` and `upgrade` pass a narrow allow-set that filters WRITES but must
+     * never trigger a downgrade delete of everything else.
+     */
+    trimToProfile?: boolean;
 }
 /**
  * Smart update from a downloaded release directory.

package/dist/core/smart-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-update.d.ts","sourceRoot":"","sources":["../../src/core/smart-update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAO/D,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,KAAK,UAAQ,EACb,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAkQtB"}
+{"version":3,"file":"smart-update.d.ts","sourceRoot":"","sources":["../../src/core/smart-update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAmB/D,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2FAA2F;IAC3F,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,yDAAyD;IACzD,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kFAAkF;IAClF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAClC,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,KAAK,UAAQ,EACb,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC,CA8ZtB"}