agentopology 0.9.2 → 0.10.0

package/dist/__tests__/e2e/guard-target.test.js

@@ -0,0 +1,198 @@
+/**
+ * [N41] `guard <file> --target claude-code` writes only the guard part of what
+ * scaffold would write, into a project that was built by hand: the hook
+ * scripts settings.json runs, the gate wrappers and check scripts they call,
+ * and the `hooks` and `permissions` keys of settings.json, merged. It never
+ * writes an agent, skill, command, rule, .mcp.json or CLAUDE.md, never
+ * overwrites a script the user edited or a check that is no longer a stub,
+ * and a rerun changes nothing.
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import { createHash } from "node:crypto";
+import { resolve, dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "../../parser/index.js";
+import { claudeCodeBinding } from "../../bindings/claude-code.js";
+import { guardFiles, planGuardTarget } from "../../guard/target.js";
+import { checkGuards } from "../../guard/check.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const FIXTURE = resolve(here, "fixtures/compile.at");
+const CLI = resolve(here, "../../../dist/cli/index.js");
+const ast = parse(fs.readFileSync(FIXTURE, "utf-8"));
+const SCRIPTS = ".claude/skills/compile/scripts";
+const AGENT = ".claude/agents/drafter/AGENT.md";
+const AGENT_BYTES = "---\nname: drafter\ndescription: by hand\n---\nWrite the copy. Hand-written, do not touch.\n";
+const USER_CHECK = "#!/usr/bin/env python3\nprint('my own check')\n";
+const USER_BRIEF = "#!/usr/bin/env bash\n# mine, implemented\nexit 0\n";
+let root;
+const at = (p) => join(root, p);
+const settings = () => JSON.parse(fs.readFileSync(at(".claude/settings.json"), "utf8"));
+const cli = (...a) => spawnSync("node", [CLI, "guard", FIXTURE, "--target", "claude-code", "--dir", root, ...a], { encoding: "utf8" });
+function snapshot() {
+    const out = {};
+    const walk = (d) => {
+        for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+            const p = join(d, e.name);
+            if (e.isDirectory()) {
+                out[relative(root, p) + "/"] = "";
+                walk(p);
+            }
+            else
+                out[relative(root, p)] = createHash("sha256").update(fs.readFileSync(p)).digest("hex");
+        }
+    };
+    walk(root);
+    return out;
+}
+beforeEach(() => {
+    root = fs.mkdtempSync(join(os.tmpdir(), "at-guard-target-"));
+    fs.mkdirSync(at(".claude/agents/drafter"), { recursive: true });
+    fs.writeFileSync(at(AGENT), AGENT_BYTES);
+    fs.writeFileSync(at(".claude/settings.json"), JSON.stringify({
+        hooks: { PreToolUse: [{ matcher: "Bash", hooks: [{ type: "command", command: "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/mine.sh\"" }] }] },
+        permissions: { allow: ["Bash(ls:*)"] },
+        model: "sonnet",
+    }, null, 2));
+    fs.mkdirSync(at("docs/tools"), { recursive: true });
+    fs.writeFileSync(at("docs/tools/check.py"), USER_CHECK);
+    fs.mkdirSync(at(SCRIPTS), { recursive: true });
+    fs.writeFileSync(at(`${SCRIPTS}/brief-check.sh`), USER_BRIEF);
+});
+describe("[N41] guard --target", () => {
+    it("[N41] keeps the hook scripts, the gates they call and the checks the gates run, and nothing else", () => {
+        const paths = guardFiles(claudeCodeBinding.scaffold(ast)).map((f) => f.path).sort();
+        expect(paths).toContain(`${SCRIPTS}/before-agent.sh`);
+        expect(paths).toContain(`${SCRIPTS}/gate-brief-check.sh`);
+        expect(paths).toContain(`${SCRIPTS}/gate-copy-check.sh`);
+        expect(paths).toContain(`${SCRIPTS}/brief-check.sh`);
+        expect(paths).toContain("docs/tools/check.py");
+        expect(paths).toContain(".claude/settings.json");
+        for (const p of paths)
+            expect(p).not.toMatch(/AGENT\.md|SKILL\.md|\.mcp\.json|CLAUDE\.md|rules\/|commands\/|crontab|schedule-|action-/);
+    });
+    it("[N41] the function plans the same as the command and writes nothing", () => {
+        const before = snapshot();
+        const plan = planGuardTarget(ast, root, "compile.at");
+        expect(snapshot()).toEqual(before);
+        expect(plan.actions.some((a) => a.path === `${SCRIPTS}/before-agent.sh` && a.type === "create")).toBe(true);
+    });
+    it("[N41] writes our guard, leaves the agent and the user's hook and permission", () => {
+        const r = cli();
+        expect(r.status).toBe(0);
+        expect(fs.readFileSync(at(AGENT), "utf8")).toBe(AGENT_BYTES);
+        const s = settings();
+        expect(JSON.stringify(s.hooks.PreToolUse)).toContain(".claude/hooks/mine.sh");
+        expect(s.permissions.allow).toContain("Bash(ls:*)");
+        expect(s.permissions.deny).toContain("mcp__notes__delete");
+        expect(JSON.stringify(s.hooks.PreToolUse)).toContain("before-agent.sh");
+        expect(JSON.stringify(s.hooks.SubagentStop)).toContain("gate-copy-check.sh");
+        expect(s.model).toBe("sonnet");
+        expect(fs.existsSync(at(`${SCRIPTS}/before-agent.sh`))).toBe(true);
+        expect(fs.existsSync(at(`${SCRIPTS}/gate-brief-check.sh`))).toBe(true);
+        for (const p of [".mcp.json", "CLAUDE.md", ".claude/skills/compile/SKILL.md", ".claude/rules/compile.md", ".claude/agents/auditor/AGENT.md", "crontab.fragment"]) {
+            expect(fs.existsSync(at(p)), p).toBe(false);
+        }
+        expect(s.hooks.Stop).toBeUndefined(); // a prompt hook is not a guard script
+    });
+    it("[N41] a second run changes nothing and adds no duplicates", () => {
+        cli();
+        const first = snapshot();
+        const hooks = JSON.stringify(settings().hooks);
+        const r = cli();
+        expect(r.status).toBe(0);
+        expect(snapshot()).toEqual(first);
+        expect(JSON.stringify(settings().hooks)).toBe(hooks);
+        const perms = settings().permissions.allow;
+        expect(new Set(perms).size).toBe(perms.length);
+    });
+    it("[N41] --dry-run prints the plan and writes nothing", () => {
+        const before = snapshot();
+        const r = cli("--dry-run");
+        expect(r.status).toBe(0);
+        expect(r.stdout).toContain("before-agent.sh");
+        expect(snapshot()).toEqual(before);
+    });
+    it("[N41] a hand-written check, and a check no longer a stub, are untouched and reported", () => {
+        const r = cli();
+        expect(fs.readFileSync(at("docs/tools/check.py"), "utf8")).toBe(USER_CHECK);
+        expect(fs.readFileSync(at(`${SCRIPTS}/brief-check.sh`), "utf8")).toBe(USER_BRIEF);
+        expect(r.stdout).toContain("docs/tools/check.py");
+        expect(r.stdout).toMatch(/brief-check\.sh.*(skipped|kept)/);
+    });
+    it("[N41] a script the user edited after a guard run is kept on the next one", () => {
+        cli();
+        const p = at(`${SCRIPTS}/gate-brief-check.sh`);
+        fs.appendFileSync(p, "# my edit\n");
+        const edited = fs.readFileSync(p, "utf8");
+        const r = cli();
+        expect(fs.readFileSync(p, "utf8")).toBe(edited);
+        expect(r.stdout).toMatch(/gate-brief-check\.sh.*(edited|kept)/);
+    });
+    it("[N41] then runs guard --check: the gates refuse and the exit is 0", () => {
+        const r = cli();
+        expect(r.status).toBe(0);
+        expect(r.stdout).toMatch(/brief-check[^\n]*refuse/);
+        expect(r.stdout).toMatch(/copy-check[^\n]*refuse/);
+        const report = checkGuards(ast, root);
+        expect(report.items.filter((i) => i.kind === "gate").every((i) => i.strength === "refuse")).toBe(true);
+        expect(report.missing).toBe(0);
+    });
+    it("[N41] on a bare directory it exits 1 until the stubs are written, like --check", () => {
+        const bare = fs.mkdtempSync(join(os.tmpdir(), "at-guard-target-bare-"));
+        const r = spawnSync("node", [CLI, "guard", FIXTURE, "--target", "claude-code", "--dir", bare], { encoding: "utf8" });
+        expect(fs.existsSync(join(bare, SCRIPTS, "before-agent.sh"))).toBe(true);
+        expect(r.stdout).toContain("enforcement:");
+    });
+    it("[N41] picks up the before-action.sh of a gate before a script step and guard --check reports it as refuse", () => {
+        const src = `topology ship : [pipeline] {
+  meta {
+    version: "1.0.0"
+    description: "Render then publish"
+  }
+  orchestrator {
+    model: sonnet
+    handles: [render, publish]
+  }
+  action render {
+    kind: external
+    commands: ["./tool render"]
+  }
+  action publish {
+    kind: external
+    commands: ["./tool publish"]
+    unit-from: "./tool publish (\\S+)"
+  }
+  records {
+    record trace { path: "logs/{unit}/trace.jsonl" }
+  }
+  gates {
+    gate publish-ready {
+      after: render
+      before: publish
+      ledger: trace
+      on-fail: halt
+    }
+  }
+  flow { render -> publish }
+}
+`;
+        const dir = fs.mkdtempSync(join(os.tmpdir(), "at-guard-target-action-"));
+        const file = join(dir, "ship.at");
+        fs.writeFileSync(file, src);
+        const r = spawnSync("node", [CLI, "guard", file, "--target", "claude-code", "--dir", dir], { encoding: "utf8" });
+        const script = join(dir, ".claude/skills/ship/scripts/before-action.sh");
+        expect(fs.existsSync(script), r.stdout + r.stderr).toBe(true);
+        const cfg = fs.readFileSync(join(dir, ".claude/settings.json"), "utf8");
+        expect(cfg).toContain("before-action.sh");
+        expect(r.status, r.stdout + r.stderr).toBe(0);
+        expect(r.stdout).toMatch(/publish-ready[^\n]*refuse/);
+        const report = checkGuards(parse(src), dir);
+        const gate = report.items.find((i) => i.kind === "gate");
+        expect(gate?.strength).toBe("refuse");
+        expect(gate?.by).toBe("hook");
+    });
+});
+//# sourceMappingURL=guard-target.test.js.map

package/dist/__tests__/e2e/guard-target.test.js.map

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

package/dist/__tests__/e2e/inventory.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `agentopology inventory <dir>` and `validate <file> --inventory` (N34):
+ * which live things in a project the .at accounts for, and which things the
+ * .at points at that are not there.
+ *
+ * inventory lists what is live under a project (the .claude tree, each
+ * settings.json hook handler, .mcp.json servers, package.json scripts), with a
+ * sha256 fingerprint per file. It reads and prints; it never writes.
+ *
+ * Coverage matches each live thing to the .at in two ways: the file or hook is
+ * what scaffold would write from this .at, or the .at points at it by hand
+ * (file:, a hook's run, a gate's run, a tool's script, at:, an mcp server).
+ * A live thing nothing accounts for is unmapped (a warning). A path the .at
+ * points at that is not on disk is missing (an error, exit 1). Things tagged
+ * "e" (the platform, the machine) are counted apart and never required.
+ */
+export {};
+//# sourceMappingURL=inventory.test.d.ts.map

package/dist/__tests__/e2e/inventory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/e2e/inventory.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/e2e/inventory.test.js

@@ -0,0 +1,187 @@
+/**
+ * `agentopology inventory <dir>` and `validate <file> --inventory` (N34):
+ * which live things in a project the .at accounts for, and which things the
+ * .at points at that are not there.
+ *
+ * inventory lists what is live under a project (the .claude tree, each
+ * settings.json hook handler, .mcp.json servers, package.json scripts), with a
+ * sha256 fingerprint per file. It reads and prints; it never writes.
+ *
+ * Coverage matches each live thing to the .at in two ways: the file or hook is
+ * what scaffold would write from this .at, or the .at points at it by hand
+ * (file:, a hook's run, a gate's run, a tool's script, at:, an mcp server).
+ * A live thing nothing accounts for is unmapped (a warning). A path the .at
+ * points at that is not on disk is missing (an error, exit 1). Things tagged
+ * "e" (the platform, the machine) are counted apart and never required.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "../../parser/index.js";
+import { claudeCodeBinding } from "../../bindings/claude-code.js";
+import { collectInventory, coverage } from "../../inventory/index.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const FIXTURE = resolve(here, "fixtures/compile.at");
+const CLI = resolve(here, "../../../dist/cli/index.js");
+const source = fs.readFileSync(FIXTURE, "utf-8");
+const ast = parse(source);
+let root;
+const at = (p) => join(root, p);
+const write = (p, text) => { fs.mkdirSync(dirname(at(p)), { recursive: true }); fs.writeFileSync(at(p), text); };
+const settings = () => JSON.parse(fs.readFileSync(at(".claude/settings.json"), "utf8"));
+const report = () => coverage(ast, collectInventory(root), root);
+const ids = (items) => items.map((i) => i.id);
+const cli = (...a) => spawnSync("node", [CLI, ...a], { encoding: "utf-8", cwd: root });
+beforeEach(() => {
+    root = fs.mkdtempSync(join(os.tmpdir(), "at-inventory-"));
+    for (const f of claudeCodeBinding.scaffold(ast))
+        write(f.path, f.content);
+});
+afterEach(() => fs.rmSync(root, { recursive: true, force: true }));
+describe("inventory lists what is live", () => {
+    it("[N34] [IV1] agents, skills, skill scripts, settings hooks and mcp servers, each file with its sha256", () => {
+        const items = collectInventory(root);
+        const byId = new Map(items.map((i) => [i.id, i]));
+        expect(byId.get("agent:drafter")).toMatchObject({ kind: "agent", path: ".claude/agents/drafter/AGENT.md" });
+        expect(byId.get("skill:tone")).toMatchObject({ kind: "skill", path: ".claude/skills/tone/SKILL.md" });
+        expect(byId.get("skill-file:compile/scripts/before-agent.sh")).toMatchObject({ kind: "skill-file" });
+        expect(byId.get("mcp:search")).toMatchObject({ kind: "mcp-server" });
+        expect(items.filter((i) => i.kind === "hook").length).toBeGreaterThan(3);
+        const tone = byId.get("skill:tone");
+        expect(tone.fingerprint).toBe(createHash("sha256").update(fs.readFileSync(at(tone.path))).digest("hex"));
+    });
+    it("[N34] [IV1] the listing is sorted and stable, and settings.local.json is suggested as e (machine-local)", () => {
+        write(".claude/settings.local.json", "{}\n");
+        const a = collectInventory(root);
+        expect(ids(a)).toEqual([...ids(a)].sort());
+        expect(collectInventory(root)).toEqual(a);
+        expect(a.find((i) => i.path === ".claude/settings.local.json")).toMatchObject({ tag: "e" });
+    });
+    it("[N34] [IV1] worktrees and node_modules are skipped, and a skill's working folder is one item, not every file in it", () => {
+        write(".claude/worktrees/agent-1/.claude/agents/copy.md", "x\n");
+        write(".claude/node_modules/pkg/index.js", "x\n");
+        write(".claude/skills/tone/scripts/node_modules/dep/index.js", "x\n");
+        write(".claude/skills/tone/references/style.md", "x\n");
+        write(".claude/skills/tone/workspace/p1/render.mp4", "x\n");
+        write(".claude/skills/tone/workspace/p2/render.mp4", "x\n");
+        write(".claude/skills/tone/scripts/__pycache__/lock.cpython-312.pyc", "x\n");
+        const got = ids(collectInventory(root));
+        expect(got.filter((id) => /worktrees|node_modules|__pycache__/.test(id))).toEqual([]);
+        expect(got).toContain("skill-file:tone/references/style.md");
+        expect(got.filter((id) => id.includes("tone/workspace"))).toEqual(["skill-dir:tone/workspace"]);
+    });
+    it("[N34] [IV1] package.json scripts are live things too", () => {
+        write("package.json", JSON.stringify({ scripts: { post: "node media.js post", test: "vitest" } }));
+        expect(ids(collectInventory(root))).toEqual(expect.arrayContaining(["script:post", "script:test"]));
+    });
+});
+describe("coverage: the .at against what is live", () => {
+    it("[N34] [IV2] a freshly scaffolded project is fully covered, nothing unmapped, nothing missing", () => {
+        const r = report();
+        expect(r.unmapped).toEqual([]);
+        expect(r.missing).toEqual([]);
+        expect(r.mapped).toBe(r.total);
+        expect(r.total).toBeGreaterThan(20);
+    });
+    it("[N34] [IV3] hand-built things nothing in the .at accounts for are unmapped, by kind", () => {
+        write(".claude/agents/stray.md", "---\nname: stray\n---\nA hand-made agent.\n");
+        write(".claude/commands/ship.md", "Ship it.\n");
+        const s = settings();
+        s.hooks.PreToolUse = [...(s.hooks.PreToolUse ?? []), { matcher: "mcp__chrome__upload_image", hooks: [{ type: "command", command: "python3 \"$CLAUDE_PROJECT_DIR/tools/lock.py\"" }] }];
+        fs.writeFileSync(at(".claude/settings.json"), JSON.stringify(s, null, 2));
+        const mcp = JSON.parse(fs.readFileSync(at(".mcp.json"), "utf8"));
+        mcp.mcpServers.chrome = { command: "chrome-mcp" };
+        fs.writeFileSync(at(".mcp.json"), JSON.stringify(mcp));
+        const r = report();
+        const un = ids(r.unmapped);
+        expect(un).toEqual(expect.arrayContaining(["agent:stray", "command:ship", "mcp:chrome"]));
+        expect(un.some((id) => id.startsWith("hook:PreToolUse") && id.includes("tools/lock.py"))).toBe(true);
+        expect(r.unmapped).toHaveLength(4);
+        expect(r.mapped).toBe(r.total - 4);
+    });
+    it("[N34] [IV3] a hand-written file inside a skill the .at declares counts under that skill", () => {
+        write(".claude/skills/tone/references/house-style.md", "Short sentences.\n");
+        expect(report().unmapped).toEqual([]);
+    });
+    it("[N34] [IV3] a declared store's data files count under the store", () => {
+        const mem = parse(fs.readFileSync(resolve(here, "../../../examples/memory-system.at"), "utf-8").replace('".memory/semantic/"', '".claude/stores/semantic/"'));
+        write(".claude/stores/semantic/index.db", "x\n");
+        write(".claude/stores/stray/rows.json", "x\n");
+        const un = ids(coverage(mem, collectInventory(root), root).unmapped);
+        expect(un).toContain("claude-file:stores/stray/rows.json");
+        expect(un).not.toContain("claude-file:stores/semantic/index.db");
+    });
+    it("[N34] [IV4] a path the .at points at that is not on disk is missing, named with what points at it", () => {
+        fs.rmSync(at("docs/tools/check.py"));
+        fs.rmSync(at("tools/render.py"));
+        const r = report();
+        expect(r.missing.map((m) => m.path).sort()).toEqual(["docs/tools/check.py", "tools/render.py"]);
+        expect(r.missing.find((m) => m.path === "docs/tools/check.py").from).toContain("copy-check");
+        expect(r.missing.find((m) => m.path === "tools/render.py").from).toContain("render");
+    });
+    it("[N34] [IV4] a generated file that is not there is reported as not scaffolded, not as missing", () => {
+        fs.rmSync(at(".claude/skills/compile/scripts/before-agent.sh"));
+        const r = report();
+        expect(r.missing).toEqual([]);
+        expect(r.notScaffolded).toContain(".claude/skills/compile/scripts/before-agent.sh");
+    });
+    it("[N34] [IV5] things tagged e are counted apart and never required", () => {
+        write(".claude/agents/stray.md", "x\n");
+        const items = collectInventory(root).map((i) => (i.id === "agent:stray" ? { ...i, tag: "e" } : i));
+        const r = coverage(ast, items, root);
+        expect(r.unmapped).toEqual([]);
+        expect(ids(r.external)).toEqual(["agent:stray"]);
+        expect(r.total).toBe(items.length - 1);
+    });
+    it("[N34] [IV6] a hand-written hook the .at declares by its run maps the hand-built settings entry", () => {
+        const withLock = parse(source.replace("    hook finished {", `    hook lock {\n      on: PreToolUse\n      matcher: "Bash"\n      run: "tools/lock.py"\n    }\n    hook finished {`));
+        write("tools/lock.py", "print('ok')\n");
+        const s = settings();
+        s.hooks.PreToolUse = [...(s.hooks.PreToolUse ?? []), { matcher: "Bash", hooks: [{ type: "command", command: "python3 \"$CLAUDE_PROJECT_DIR/tools/lock.py\" --strict" }] }];
+        fs.writeFileSync(at(".claude/settings.json"), JSON.stringify(s, null, 2));
+        expect(coverage(withLock, collectInventory(root), root).unmapped).toEqual([]);
+        expect(coverage(ast, collectInventory(root), root).unmapped).toHaveLength(1);
+    });
+});
+describe("matcher gaps against the inventory's tool names", () => {
+    it("[N36] a refuse hook that guards a server is checked against every tool the inventory lists for it", () => {
+        const locked = parse(source.replace("    hook finished {", `    hook lock-search {\n      on: PreToolUse\n      matcher: "mcp__search__find"\n      run: "scripts/lock.sh"\n      strength: refuse\n    }\n    hook finished {`));
+        const items = [...collectInventory(root), { id: "mcp-tool:mcp__search__find", kind: "mcp-tool" }, { id: "mcp-tool:mcp__search__crawl", kind: "mcp-tool" }];
+        const r = coverage(locked, items, root);
+        // crawl comes from the inventory; find.all from the drafter's own tools: list.
+        expect(r.gaps.map((g) => g.tool).sort()).toEqual(["mcp__search__crawl", "mcp__search__find.all"]);
+        expect(ids(r.unmapped)).not.toContain("mcp-tool:mcp__search__crawl");
+    });
+});
+describe("the CLI", () => {
+    it("[N34] [IV7] inventory <dir> prints JSON and writes nothing", () => {
+        const before = fs.readdirSync(root, { recursive: true }).sort();
+        const r = cli("inventory", root);
+        expect(r.status).toBe(0);
+        const json = JSON.parse(r.stdout);
+        expect(json.version).toBe(1);
+        expect(json.items.map((i) => i.id)).toContain("agent:drafter");
+        expect(fs.readdirSync(root, { recursive: true }).sort()).toEqual(before);
+    });
+    it("[N34] [IV7] validate --inventory <dir> prints coverage; unmapped warns, exit 0", () => {
+        write(".claude/agents/stray.md", "x\n");
+        const r = cli("validate", FIXTURE, "--inventory", root);
+        expect(r.stdout).toMatch(/coverage: \d+ of \d+ live things are in the \.at/);
+        expect(r.stdout).toContain("agent:stray");
+        expect(r.status).toBe(0);
+    });
+    it("[N34] [IV7] validate --inventory reads a saved inventory.json; a missing path exits 1", () => {
+        fs.rmSync(at("tools/render.py"));
+        const saved = join(root, "inventory.json");
+        fs.writeFileSync(saved, cli("inventory", root).stdout);
+        const r = cli("validate", FIXTURE, "--inventory", saved, "--dir", root);
+        expect(r.stdout).toMatch(/missing \(1\)/);
+        expect(r.stdout).toContain("tools/render.py");
+        expect(r.status).toBe(1);
+    });
+});
+//# sourceMappingURL=inventory.test.js.map

package/dist/__tests__/e2e/inventory.test.js.map

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

package/dist/__tests__/e2e/matcher.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hook matchers, read the way Claude Code reads them (N36), and the two hook
+ * findings that ride with them (N29, N30).
+ *
+ * From https://code.claude.com/docs/en/hooks.md (checked 2026-11-10 against
+ * the raw page): a matcher of only letters, digits, `_`, `-`, spaces, `,` and
+ * `|` is an exact name or a list of names; anything else is a JavaScript
+ * regex, unanchored. `*`, `""` and no matcher match all. MCP tools are named
+ * `mcp__<server>__<tool>`, so `mcp__memory` (exact) matches no tool. An
+ * argument filter goes in the handler's `if` (permission-rule syntax, tool
+ * events only; on any other event the hook never runs). Only exit 2 blocks.
+ */
+export {};
+//# sourceMappingURL=matcher.test.d.ts.map

package/dist/__tests__/e2e/matcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/e2e/matcher.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/__tests__/e2e/matcher.test.js

@@ -0,0 +1,145 @@
+/**
+ * Hook matchers, read the way Claude Code reads them (N36), and the two hook
+ * findings that ride with them (N29, N30).
+ *
+ * From https://code.claude.com/docs/en/hooks.md (checked 2026-11-10 against
+ * the raw page): a matcher of only letters, digits, `_`, `-`, spaces, `,` and
+ * `|` is an exact name or a list of names; anything else is a JavaScript
+ * regex, unanchored. `*`, `""` and no matcher match all. MCP tools are named
+ * `mcp__<server>__<tool>`, so `mcp__memory` (exact) matches no tool. An
+ * argument filter goes in the handler's `if` (permission-rule syntax, tool
+ * events only; on any other event the hook never runs). Only exit 2 blocks.
+ */
+import { describe, it, expect } from "vitest";
+import { parse } from "../../parser/index.js";
+import { validate } from "../../parser/validator.js";
+import { serializeAST } from "../../import/serializer.js";
+import { claudeCodeBinding } from "../../bindings/claude-code.js";
+import { matcherMatches } from "../../conformance/claude-code.js";
+import { matcherGaps } from "../../inventory/index.js";
+const topology = (hooks, agentExtra = "") => `topology probe : [pipeline] {
+  meta {
+    version: "1.0.0"
+    description: "Matcher probe"
+  }
+
+  orchestrator {
+    model: sonnet
+  }
+
+  agent writer {
+    model: sonnet
+    description: "Writes the post"
+    tools: [Read, mcp.chrome.file_upload, mcp.chrome.upload_image, mcp.chrome.browser_batch]
+${agentExtra}    prompt {
+      Write the post.
+    }
+  }
+
+  flow {
+    writer -> writer [max 1]
+  }
+
+  hooks {
+${hooks}  }
+}
+`;
+const hook = (name, fields) => `    hook ${name} {\n${fields.split("\n").map((l) => `      ${l}`).join("\n")}\n    }\n`;
+const rules = (src, rule, level) => validate(parse(src)).filter((r) => r.rule === rule && (!level || r.level === level));
+const files = (src) => claudeCodeBinding.scaffold(parse(src));
+const settingsOf = (src) => JSON.parse(files(src).find((f) => f.path === ".claude/settings.json").content);
+describe("a matcher is read the way Claude Code reads it", () => {
+    it("[N36] exact names and lists, unanchored regexes, match-all", () => {
+        expect(matcherMatches("PreToolUse", "Bash", "Bash")).toBe(true);
+        expect(matcherMatches("PreToolUse", "Bash", "BashOutput")).toBe(false);
+        expect(matcherMatches("PreToolUse", "Edit|Write", "Write")).toBe(true);
+        expect(matcherMatches("PreToolUse", "Edit, Write", "Edit")).toBe(true);
+        expect(matcherMatches("SubagentStop", "code-reviewer", "code-reviewer")).toBe(true);
+        expect(matcherMatches("PreToolUse", "^Notebook", "NotebookEdit")).toBe(true);
+        expect(matcherMatches("PreToolUse", "Edit.*", "NotebookEdit")).toBe(true);
+        expect(matcherMatches("PreToolUse", "^Edit$", "NotebookEdit")).toBe(false);
+        expect(matcherMatches("PreToolUse", "*", "anything")).toBe(true);
+        expect(matcherMatches("PreToolUse", "", "anything")).toBe(true);
+    });
+    it("[N36] MCP: the server prefix alone matches no tool; with .* it matches every tool on it", () => {
+        expect(matcherMatches("PreToolUse", "mcp__memory", "mcp__memory__create_entities")).toBe(false);
+        expect(matcherMatches("PreToolUse", "mcp__memory__.*", "mcp__memory__create_entities")).toBe(true);
+    });
+    it("[N36] on FileChanged and StopFailure a hyphen keeps the matcher on the regex path", () => {
+        expect(matcherMatches("FileChanged", "a-b", "xa-by")).toBe(true);
+        expect(matcherMatches("PreToolUse", "a-b", "xa-by")).toBe(false);
+    });
+});
+describe("V107: a matcher that can never match is an error", () => {
+    it("[N30] permission-rule syntax in a matcher never matches a tool name; the filter belongs in if:", () => {
+        const e = rules(topology(hook("guard", 'on: PreToolUse\nmatcher: "Bash(rm -rf *)"\nrun: "scripts/guard.sh"')), "V107", "error");
+        expect(e).toHaveLength(1);
+        expect(e[0].message).toMatch(/matcher: "Bash".*if: "Bash\(rm -rf \*\)"/);
+    });
+    it("[N36] the .at's dotted mcp form is not a tool name; the server prefix alone matches nothing", () => {
+        const dotted = rules(topology(hook("lock", 'on: PreToolUse\nmatcher: "mcp.chrome.*"\nrun: "scripts/lock.sh"')), "V107", "error");
+        expect(dotted[0]?.message).toContain("mcp__chrome__.*");
+        const bare = rules(topology(hook("lock", 'on: PreToolUse\nmatcher: "mcp__chrome"\nrun: "scripts/lock.sh"')), "V107", "error");
+        expect(bare[0]?.message).toContain("mcp__chrome__.*");
+    });
+    it("[N36] a matcher that is not a valid regex is an error; agent-level hooks are checked too", () => {
+        expect(rules(topology(hook("bad", 'on: PreToolUse\nmatcher: "Edit|(Write"\nrun: "scripts/x.sh"')), "V107", "error")).toHaveLength(1);
+        const agentHook = `    hooks {\n      hook lint {\n        on: PostToolUse\n        matcher: "Write(*.md)"\n        run: "scripts/lint.sh"\n      }\n    }\n`;
+        expect(rules(topology(hook("ok", 'on: PreToolUse\nmatcher: "Bash"\nrun: "scripts/x.sh"'), agentHook), "V107", "error")).toHaveLength(1);
+    });
+    it("[N36] good matchers pass", () => {
+        const src = topology(hook("a", 'on: PreToolUse\nmatcher: "Bash"\nrun: "scripts/a.sh"') +
+            hook("b", 'on: PreToolUse\nmatcher: "mcp__chrome__.*"\nrun: "scripts/b.sh"') +
+            hook("c", 'on: PostToolUse\nmatcher: "Edit|Write"\nrun: "scripts/c.sh"'));
+        expect(rules(src, "V107")).toEqual([]);
+    });
+});
+describe("if: filters on the tool's arguments", () => {
+    const src = topology(hook("guard", 'on: PreToolUse\nmatcher: "Bash"\nif: "Bash(rm -rf *)"\nrun: "scripts/guard.sh"'));
+    it("[N30] if: is read, round-trips, and is written on the settings.json handler", () => {
+        expect(parse(src).hooks[0]).toMatchObject({ matcher: "Bash", if: "Bash(rm -rf *)" });
+        expect(parse(serializeAST(parse(src))).hooks).toEqual(parse(src).hooks);
+        const entry = settingsOf(src).hooks.PreToolUse.find((e) => e.matcher === "Bash");
+        expect(entry.hooks[0].if).toBe("Bash(rm -rf *)");
+        expect(validate(parse(src)).filter((r) => r.level === "error")).toEqual([]);
+    });
+    it("[N30] if: on an event that is not a tool event is an error: the hook would never run", () => {
+        const e = rules(topology(hook("g", 'on: Stop\nif: "Bash(rm *)"\nrun: "scripts/g.sh"')), "V107", "error");
+        expect(e[0]?.message).toMatch(/never runs/);
+    });
+});
+describe("a run: that is a shell command, not a script", () => {
+    it("[N29] run: \"exit 2\" is written as the command itself, with no stub script named after exit", () => {
+        const out = files(topology(hook("block", 'on: PreToolUse\nmatcher: "Bash"\nrun: "exit 2"')));
+        expect(out.some((f) => /\/exit$/.test(f.path))).toBe(false);
+        const s = JSON.parse(out.find((f) => f.path === ".claude/settings.json").content);
+        expect(s.hooks.PreToolUse[0].hooks[0].command).toBe("exit 2");
+    });
+    it("[N29] V108: exit 1 (or any code but 0 and 2) does not block; it is a warning", () => {
+        const w = rules(topology(hook("block", 'on: PreToolUse\nmatcher: "Bash"\nrun: "exit 1"')), "V108", "warning");
+        expect(w[0]?.message).toMatch(/only exit 2 blocks/);
+        expect(rules(topology(hook("block", 'on: PreToolUse\nmatcher: "Bash"\nrun: "exit 2"')), "V108")).toEqual([]);
+    });
+});
+describe("V109: a refuse hook that misses a tool its server offers", () => {
+    const lock = (matcher, strength = "strength: refuse\n") => topology(hook("lock-chrome", `on: PreToolUse\nmatcher: "${matcher}"\nrun: "scripts/lock.sh"\n${strength}`.trimEnd()));
+    it("[N36] lock-chrome covers file_upload and browser_batch but not upload_image: named as a gap", () => {
+        const src = lock("mcp__chrome__(file_upload|browser_batch)");
+        const w = rules(src, "V109", "warning");
+        expect(w).toHaveLength(1);
+        expect(w[0].message).toContain("mcp__chrome__upload_image");
+        expect(w[0].message).toContain("lock-chrome");
+        expect(matcherGaps(parse(src))).toEqual([{ hook: "lock-chrome", server: "chrome", tool: "mcp__chrome__upload_image" }]);
+    });
+    it("[N36] a matcher that covers the server has no gap; a hook that declares no refuse is not held to it", () => {
+        expect(rules(lock("mcp__chrome__.*"), "V109")).toEqual([]);
+        expect(rules(lock("mcp__chrome__(file_upload|browser_batch)", ""), "V109")).toEqual([]);
+    });
+    it("[N36] tool names the inventory lists count too", () => {
+        const ast = parse(lock("mcp__chrome__.*").replace("mcp.chrome.upload_image, ", ""));
+        const gaps = matcherGaps(parse(lock("mcp__chrome__file_upload")), ["mcp__chrome__navigate"]);
+        expect(gaps.map((g) => g.tool)).toEqual(expect.arrayContaining(["mcp__chrome__navigate", "mcp__chrome__upload_image", "mcp__chrome__browser_batch"]));
+        expect(matcherGaps(ast, ["mcp__chrome__navigate"])).toEqual([]);
+    });
+});
+//# sourceMappingURL=matcher.test.js.map