agentopology 0.9.1 → 0.10.0

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

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

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

package/dist/__tests__/e2e/step-check.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agentopology step check <file.at> <step-id> [--unit U] [--dir D]` (N39).
+ * A hook guards a Claude Code session only: a script run from a terminal or a
+ * scheduler never sees it. The step calls step check at its start (by: code)
+ * and stops on exit 1. It reads ledgers and runs check scripts; it never
+ * writes.
+ */
+export {};
+//# sourceMappingURL=step-check.test.d.ts.map

package/dist/__tests__/e2e/step-check.test.d.ts.map

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

package/dist/__tests__/e2e/step-check.test.js

@@ -0,0 +1,158 @@
+/**
+ * `agentopology step check <file.at> <step-id> [--unit U] [--dir D]` (N39).
+ * A hook guards a Claude Code session only: a script run from a terminal or a
+ * scheduler never sees it. The step calls step check at its start (by: code)
+ * and stops on exit 1. It reads ledgers and runs check scripts; it never
+ * writes.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { spawnSync } from "node:child_process";
+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 { checkStep, renderStepReport } from "../../step/check.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const CLI = resolve(here, "../../../dist/cli/index.js");
+const SRC = `topology ship : [pipeline] {
+  meta { version: "1.0.0" description: "Render, then publish" }
+  orchestrator { model: sonnet handles: [render, publish, notify, tidy] }
+  action render { kind: external commands: ["./tool render"] }
+  action publish { kind: external commands: ["./tool publish"] unit-from: "./tool publish (\\S+)" }
+  action notify { kind: external commands: ["./tool notify"] }
+  action tidy { kind: external commands: ["./tool tidy"] }
+  action archive { kind: external commands: ["./tool archive"] }
+  records {
+    record trace { path: "logs/{unit}/trace.jsonl" }
+  }
+  gates {
+    gate publish-ready {
+      after: render
+      before: publish
+      ledger: trace
+    }
+    gate notify-ready {
+      before: notify
+      run: "./check-notify.sh"
+    }
+    gate both {
+      after: render
+      before: archive
+      ledger: trace
+      run: "./check-notify.sh"
+    }
+    gate empty-gate {
+      before: tidy
+    }
+  }
+  flow { render -> publish -> notify -> tidy -> archive }
+}
+`;
+const ast = parse(SRC);
+// With one record declared, a gate with no ledger: reads it. Case (c) needs a topology with none.
+const bare = parse(SRC.replace(/  records \{[\s\S]*?\n  \}\n/, "").replace(/ledger: trace\n/g, ""));
+let dir;
+const at = (p) => join(dir, p);
+const rec = (step, ok, unit) => ({ step, ...(unit ? { unit } : {}), ok, at: "2026-01-01T00:00:00Z" });
+const ledger = (unit, lines) => {
+    fs.mkdirSync(at(`logs/${unit}`), { recursive: true });
+    fs.writeFileSync(at(`logs/${unit}/trace.jsonl`), lines.map((l) => JSON.stringify(l)).join("\n") + "\n");
+};
+const script = (code, name = "check-notify.sh") => fs.writeFileSync(at(name), `#!/bin/sh\necho "checked from $(pwd)" > ran.txt\necho "script said no" >&2\nexit ${code}\n`, { mode: 0o755 });
+beforeEach(() => { dir = fs.mkdtempSync(join(os.tmpdir(), "at-step-check-")); });
+afterEach(() => fs.rmSync(dir, { recursive: true, force: true }));
+describe("[N39] step check: the three ways a gate is satisfied", () => {
+    it("[N39] SC1 (a) a ledger whose last record for the after: step is ok satisfies the gate", () => {
+        ledger("ep42", [rec("render", true, "ep42")]);
+        const r = checkStep(ast, "publish", { unit: "ep42", dir });
+        expect(r.ok).toBe(true);
+        expect(r.gates).toEqual([expect.objectContaining({ gate: "publish-ready", ok: true })]);
+    });
+    it("[N39] SC2 (a) no record, a later ok:false, or no ledger file fails and says why", () => {
+        let r = checkStep(ast, "publish", { unit: "ep42", dir });
+        expect(r.ok).toBe(false);
+        expect(r.gates[0].reasons.join(" ")).toContain("logs/ep42/trace.jsonl");
+        ledger("ep42", [rec("render", true, "ep42"), rec("render", false, "ep42")]);
+        r = checkStep(ast, "publish", { unit: "ep42", dir });
+        expect(r.ok).toBe(false);
+        expect(r.gates[0].reasons.join(" ")).toMatch(/not ok/);
+    });
+    it("[N39] SC3 (a) the unit filter: another unit's ok record does not count, and a path with {unit} needs --unit", () => {
+        ledger("ep41", [rec("render", true, "ep41")]);
+        ledger("ep42", [rec("render", true, "ep41")]);
+        expect(checkStep(ast, "publish", { unit: "ep42", dir }).ok).toBe(false);
+        const none = checkStep(ast, "publish", { dir });
+        expect(none.ok).toBe(false);
+        expect(none.gates[0].reasons.join(" ")).toMatch(/--unit/);
+    });
+    it("[N39] SC4 a unit that would climb out of the project fails instead of reading a path", () => {
+        expect(checkStep(ast, "publish", { unit: "../../etc", dir }).ok).toBe(false);
+    });
+    it("[N39] SC5 (b) a run: that exits 0 from D satisfies the gate; non-zero fails, with its output", () => {
+        script(0);
+        let r = checkStep(ast, "notify", { dir });
+        expect(r.ok).toBe(true);
+        expect(fs.readFileSync(at("ran.txt"), "utf8")).toContain(fs.realpathSync(dir));
+        script(1);
+        r = checkStep(ast, "notify", { dir });
+        expect(r.ok).toBe(false);
+        expect(r.gates[0].reasons.join(" ")).toContain("script said no");
+    });
+    it("[N39] SC6 (c) a gate with neither ledger nor run: is unsatisfiable: nothing to check", () => {
+        const r = checkStep(bare, "tidy", { dir });
+        expect(r.ok).toBe(false);
+        expect(r.gates[0].reasons.join(" ")).toContain("nothing to check");
+        // a ledger answers "did the after: step finish ok?": with no after: there is nothing to look up, even with one record declared
+        expect(checkStep(ast, "tidy", { unit: "ep42", dir }).gates[0].reasons.join(" ")).toContain("nothing to check");
+    });
+    it("[N39] SC7 a gate with a ledger and a run: needs both", () => {
+        script(0);
+        expect(checkStep(ast, "archive", { unit: "ep42", dir }).ok).toBe(false);
+        ledger("ep42", [rec("render", true, "ep42")]);
+        expect(checkStep(ast, "archive", { unit: "ep42", dir }).ok).toBe(true);
+        script(3);
+        expect(checkStep(ast, "archive", { unit: "ep42", dir }).ok).toBe(false);
+    });
+    it("[N39] SC8 a step no gate guards passes with the line \"no gate guards <step>\"", () => {
+        const r = checkStep(ast, "render", { dir });
+        expect(r).toMatchObject({ ok: true, gates: [] });
+        expect(renderStepReport(r)).toEqual(["no gate guards render"]);
+    });
+    it("[N39] SC9 it never writes: the ledger is left as it was", () => {
+        ledger("ep42", [rec("render", true, "ep42")]);
+        const before = fs.readFileSync(at("logs/ep42/trace.jsonl"), "utf8");
+        checkStep(ast, "publish", { unit: "ep42", dir });
+        expect(fs.readFileSync(at("logs/ep42/trace.jsonl"), "utf8")).toBe(before);
+        expect(fs.readdirSync(dir).sort()).toEqual(["logs"]);
+    });
+    it("[N39] SC10 the rendering names each failing gate and why", () => {
+        const text = renderStepReport(checkStep(ast, "publish", { unit: "ep42", dir })).join("\n");
+        expect(text).toContain("publish-ready");
+        expect(text).toMatch(/fail/i);
+    });
+});
+describe("[N39] step check: the CLI", () => {
+    const run = (...args) => spawnSync("node", [CLI, "step", "check", ...args], { encoding: "utf8" });
+    let file;
+    beforeEach(() => { file = at("ship.at"); fs.writeFileSync(file, SRC); });
+    it("[N39] SC11 exits 0 when satisfied, 1 when not, naming the gate", () => {
+        ledger("ep42", [rec("render", true, "ep42")]);
+        const ok = run(file, "publish", "--unit", "ep42", "--dir", dir);
+        expect(ok.status).toBe(0);
+        const bad = run(file, "publish", "--unit", "ep43", "--dir", dir);
+        expect(bad.status).toBe(1);
+        expect(bad.stdout + bad.stderr).toContain("publish-ready");
+    });
+    it("[N39] SC12 an unguarded step exits 0 and says so; --dir defaults to .", () => {
+        const r = spawnSync("node", [CLI, "step", "check", file, "render"], { encoding: "utf8", cwd: dir });
+        expect(r.status).toBe(0);
+        expect(r.stdout).toContain("no gate guards render");
+    });
+    it("[N39] SC13 a step that is no node, or missing arguments, exits 1", () => {
+        expect(run(file, "nope", "--dir", dir).status).toBe(1);
+        expect(run(file).status).toBe(1);
+        expect(run().status).toBe(1);
+    });
+});
+//# sourceMappingURL=step-check.test.js.map

package/dist/__tests__/e2e/step-check.test.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * How strongly a step is enforced, written in the file (N32).
+ *
+ * `strength: refuse | detect | hope | none` says what stops a step: code or a
+ * hook refuses it, a critic detects it after the fact, prose hopes, or
+ * nothing. `by: code | hook | settings | gate` says which mechanism. A gate or
+ * hook can cite the code that refuses (`at: "file:line"`, `match:` the text
+ * expected there) and name its way around (`bypass:`). A flow edge can cite
+ * its guard (`[guard: lock-bash]`) or write its strength down
+ * (`[strength: none]`), so an absence is declared rather than implied.
+ *
+ * The validator checks the words and the references (V104 to V106). Whether
+ * the cited code is there and says what `match:` claims is read from disk by
+ * `guard --check`, not here: validate never reads the project.
+ */
+export {};
+//# sourceMappingURL=strength.test.d.ts.map

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

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