agentopology 0.8.0 → 0.9.1

package/README.md

@@ -96,7 +96,7 @@ who works, when they work, and what they know when they work. One file, two ways
                         ┌────────────┐
       ┌──────────────┐  │  Parser &  │   scaffold ──▶ Platform configs
       │   .at file   │─▶│  Validator │──┤                ├── .claude/agents/
-      │  (you write) │  │  101 rules  │  │                ├── <topology>.workflow.js
+      │  (you write) │  │  103 rules  │  │                ├── <topology>.workflow.js
       └──────────────┘  └────────────┘  │                ├── .codex/  .cursor/rules/
                                         │                ├── .openclaw/  .github/agents/
                                         │                └── .kiro/  …
@@ -234,7 +234,7 @@ In Claude Code, type `/agentopology` — or just ask naturally:
 Say **"I want a code review team with an analyzer, security scanner, and reviewer"** — the skill:
 
 1. Generates the `.at` file with the right syntax
-2. Validates it against 101 rules
+2. Validates it against 103 rules
 3. Scaffolds it to Claude Code, OpenClaw, Cursor, or any target
 
 **Full agent team in under 2 minutes.** No docs to read. No syntax to memorize. You describe what you want, the skill handles the rest.
@@ -566,7 +566,7 @@ import { parse, validate, bindings } from "agentopology";
 // Parse
 const ast = parse(atSource);
 
-// Validate (101 built-in rules, V1-V101)
+// Validate (103 built-in rules, V1-V103)
 const issues = validate(ast);
 
 // Scaffold — generate platform files
@@ -624,7 +624,7 @@ You can `agentopology visualize` it into an interactive graph. You can hand it t
 | **Switch platforms** | Rewrite everything | Change `--target` |
 | **Add an agent** | Update 5-12 files across 3 tools | Add 4 lines to `.at` file |
 | **See the architecture** | Read YAML, JSON, TOML, Markdown across 6 dirs | One `.at` file. Or `visualize` it. |
-| **Validate** | Hope for the best | 101 built-in rules catch errors before deploy |
+| **Validate** | Hope for the best | 103 built-in rules catch errors before deploy |
 | **Onboard someone** | "Read these 15 files and figure it out" | "Read this `.at` file" |
 | **Version control** | Diff 47 generated files | Diff one `.at` file |
 | **Move to a new tool** | Start over | `--target new-tool` |
@@ -646,7 +646,7 @@ You can `agentopology visualize` it into an interactive graph. You can hand it t
 ## CLI Reference
 
 ```
-agentopology validate <file>              Validate an .at file (101 rules)
+agentopology validate <file>              Validate an .at file (103 rules)
 agentopology plan <file>                  Resolve for interpreted execution — no files written
 agentopology scaffold <file> --target <t> Generate platform configs
 agentopology sync <file> --target <t> --dir <d>  Sync platform files back to .at

package/dist/__tests__/e2e/import-project.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Import on a real repo root: it reads only what it needs, and it recovers the
+ * flow where the project records one and says where it does not.
+ *
+ * Measured on a client repo with 31 agents: over two minutes in the walk, most
+ * of it `.claude/worktrees` (dozens of full checkouts), and `edges: []` although
+ * two .at files in the repo held 52 edges.
+ */
+export {};
+//# sourceMappingURL=import-project.test.d.ts.map

package/dist/__tests__/e2e/import-project.test.d.ts.map

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

package/dist/__tests__/e2e/import-project.test.js

@@ -0,0 +1,260 @@
+/**
+ * Import on a real repo root: it reads only what it needs, and it recovers the
+ * flow where the project records one and says where it does not.
+ *
+ * Measured on a client repo with 31 agents: over two minutes in the walk, most
+ * of it `.claude/worktrees` (dozens of full checkouts), and `edges: []` although
+ * two .at files in the repo held 52 edges.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { execFileSync, 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 { validate } from "../../parser/validator.js";
+import { importClaudeCodeWithReport, readClaudeProject, readProject } from "../../import/index.js";
+import { MAX_FILE_BYTES, MAX_TOTAL_BYTES } from "../../import/walk.js";
+const CLI = resolve(dirname(fileURLToPath(import.meta.url)), "../../../dist/cli/index.js");
+let root;
+const put = (rel, content = "x\n") => {
+    fs.mkdirSync(dirname(join(root, rel)), { recursive: true });
+    fs.writeFileSync(join(root, rel), content);
+};
+const agent = (id) => put(`.claude/agents/${id}.md`, `---\nname: ${id}\ndescription: "${id}"\n---\n\nDo the ${id} work.\n`);
+const paths = () => readClaudeProject(root).files.map((f) => f.path).sort();
+const imported = () => {
+    const { source, report } = importClaudeCodeWithReport(readClaudeProject(root).files, "shop");
+    return { source, report, ast: parse(source) };
+};
+const SHOP_AT = `topology shop : [pipeline, human-gate] {
+  meta {
+    version: "2.1.0"
+    description: "The shop pipeline"
+  }
+  orchestrator {
+    model: sonnet
+    handles: [intake]
+  }
+  action intake {
+    kind: inline
+    description: "Take the order"
+  }
+  agent writer {
+    model: sonnet
+    description: "Writes"
+    writes: ["out/draft.md"]
+  }
+  human approve {
+    description: "An editor approves"
+  }
+  agent reviewer {
+    model: sonnet
+    description: "Reviews"
+    reads: ["out/draft.md"]
+    outputs: {
+      verdict: pass | fail
+    }
+  }
+  agent ghost {
+    model: sonnet
+    description: "Declared, never written to disk"
+  }
+  gates {
+    gate lint {
+      after: writer
+      before: approve
+      run: "scripts/lint.sh"
+    }
+  }
+  flow {
+    intake -> writer
+    writer -> approve
+    approve -> reviewer
+    reviewer -> ghost [when reviewer.verdict == pass]
+    reviewer -> writer [when reviewer.verdict == fail, max 2]
+  }
+}
+`;
+beforeEach(() => {
+    root = fs.mkdtempSync(join(os.tmpdir(), "at-import-"));
+    agent("writer");
+    agent("reviewer");
+});
+afterEach(() => fs.rmSync(root, { recursive: true, force: true }));
+describe("import reads only what it needs", () => {
+    it("[I1] worktrees, build output and the rest of the tree are never read", () => {
+        for (const noise of [".worktrees/w1", ".claude/worktrees/agent-1", "dist", "build", "coverage", "node_modules/p"]) {
+            put(`${noise}/.claude/agents/stale.md`, "---\nname: stale\n---\n");
+            put(`${noise}/old.at`, "not a topology");
+        }
+        put("src/app.ts", "code");
+        const files = paths();
+        expect(files.filter((p) => /stale|old\.at|app\.ts/.test(p))).toEqual([]);
+        expect(files).toEqual([".claude/agents/reviewer.md", ".claude/agents/writer.md"]);
+    });
+    it("[I1] a skill or agent the author named build or dist is kept", () => {
+        put(".claude/skills/build/SKILL.md", "---\nname: build\ndescription: b\n---\n");
+        put(".claude/agents/dist/AGENT.md", "---\nname: dist\ndescription: d\n---\n");
+        expect(paths()).toEqual(expect.arrayContaining([".claude/skills/build/SKILL.md", ".claude/agents/dist/AGENT.md"]));
+        expect(imported().ast.nodes.map((n) => n.id)).toContain("dist");
+        // the generic walk used by sync and openclaw keeps them too
+        expect(readProject(root).files.map((f) => f.path)).toContain(".claude/skills/build/SKILL.md");
+    });
+    it("[I1] an agents/x.md in the source tree is not an agent, and a nested .claude is named, not read", () => {
+        put("docs/agents/guide.md", "# not an agent");
+        put("packages/app/.claude/agents/inner.md", "---\nname: inner\n---\n");
+        const project = readClaudeProject(root);
+        expect(imported().ast.nodes.map((n) => n.id).sort()).toEqual(["reviewer", "writer"]);
+        expect(project.nestedConfigs).toEqual([join("packages", "app", ".claude")]);
+    });
+    it("[I1] a symlink cycle ends, and a large or binary file in .claude is not read", () => {
+        fs.symlinkSync(root, join(root, ".claude/loop"));
+        put(".claude/skills/video/clip.mp4", "binary");
+        expect(paths().filter((p) => p.includes("loop") || p.endsWith(".mp4"))).toEqual([]);
+    });
+    it("[I1] a folder with no .claude is read as a config folder given directly", () => {
+        const direct = join(root, ".claude");
+        expect(readClaudeProject(direct).files.map((f) => f.path).sort()).toEqual([".claude/agents/reviewer.md", ".claude/agents/writer.md"]);
+        const bare = fs.mkdtempSync(join(os.tmpdir(), "at-bare-"));
+        expect(readClaudeProject(bare)).toBeNull();
+        fs.rmSync(bare, { recursive: true });
+    });
+});
+describe("import always ends, and says why", () => {
+    const run = (...extra) => {
+        const r = spawnSync(process.execPath, [CLI, "import", "--target", "claude-code", "--dir", root, "--name", "shop", "--output", join(root, "o"), ...extra], { encoding: "utf8" });
+        return { code: r.status, out: `${r.stdout}${r.stderr}` };
+    };
+    it("[I5] an unreadable file, an unreadable folder, a broken link and an oversized file do not stop the import, and each is named", () => {
+        put(".claude/agents/locked.md", "secret");
+        fs.chmodSync(join(root, ".claude/agents/locked.md"), 0o000);
+        put(".claude/locked/a.md");
+        fs.chmodSync(join(root, ".claude/locked"), 0o000);
+        fs.symlinkSync(join(root, "nowhere"), join(root, ".claude/agents/broken.md"));
+        put(".claude/skills/logs/run.md");
+        fs.truncateSync(join(root, ".claude/skills/logs/run.md"), MAX_FILE_BYTES + 1);
+        const { code, out } = run();
+        fs.chmodSync(join(root, ".claude/agents/locked.md"), 0o644);
+        fs.chmodSync(join(root, ".claude/locked"), 0o755);
+        expect(code).toBe(0);
+        expect(fs.existsSync(join(root, "o/shop.at"))).toBe(true);
+        expect(out).toContain("Not read: .claude/agents/locked.md (EACCES");
+        expect(out).toContain("Not read: .claude/locked (EACCES");
+        expect(out).toContain("Not read: .claude/skills/logs/run.md (5 MB, over the 5 MB limit)");
+    });
+    it("[I5] a link at the root is not followed out of the project; a linked skill inside .claude still is", () => {
+        const outside = fs.mkdtempSync(join(os.tmpdir(), "at-outside-"));
+        fs.writeFileSync(join(outside, "elsewhere.at"), "not read");
+        fs.mkdirSync(join(outside, "linked"));
+        fs.writeFileSync(join(outside, "linked/SKILL.md"), "---\nname: linked\ndescription: l\n---\n");
+        fs.symlinkSync(outside, join(root, "shots"));
+        fs.mkdirSync(join(root, ".claude/skills"), { recursive: true });
+        fs.symlinkSync(join(outside, "linked"), join(root, ".claude/skills/linked"));
+        const files = paths();
+        fs.rmSync(outside, { recursive: true });
+        expect(files.filter((p) => p.includes("elsewhere"))).toEqual([]);
+        expect(files).toContain(".claude/skills/linked/SKILL.md");
+    });
+    it("[I5] past the total budget the read stops with a message, exit 1, and no partial .at", () => {
+        for (let i = 0; i * MAX_FILE_BYTES <= MAX_TOTAL_BYTES; i++) {
+            put(`.claude/skills/s/f${i}.md`);
+            fs.truncateSync(join(root, `.claude/skills/s/f${i}.md`), MAX_FILE_BYTES);
+        }
+        const { code, out } = run();
+        expect(code).toBe(1);
+        expect(out).toContain("Importing from claude-code files");
+        expect(out).toMatch(/Import error: Stopped reading after 256 MB/);
+        expect(fs.existsSync(join(root, "o/shop.at"))).toBe(false);
+    });
+    it("[I5] what import holds does not grow with the source tree", () => {
+        for (let d = 0; d < 20; d++)
+            put(`src/d${d}/f.ts`, "x".repeat(1024));
+        const project = readClaudeProject(root);
+        expect(project.files.reduce((n, f) => n + f.content.length, 0)).toBeLessThan(1024);
+    });
+});
+describe("import recovers the flow a .at records", () => {
+    beforeEach(() => put(".claude/topologies/shop.at", SHOP_AT));
+    it("[I2] every edge comes back with its conditions, plus the actions, humans and gates on the way", () => {
+        const { ast } = imported();
+        expect(ast.edges.map((e) => `${e.from}>${e.to}`)).toEqual([
+            "intake>writer", "writer>approve", "approve>reviewer", "reviewer>ghost", "reviewer>writer",
+        ]);
+        expect(ast.edges.find((e) => e.to === "ghost")?.condition).toBe("reviewer.verdict == pass");
+        expect(ast.edges.find((e) => e.from === "reviewer" && e.to === "writer")?.maxIterations).toBe(2);
+        expect(ast.nodes.map((n) => `${n.type}:${n.id}`)).toEqual(expect.arrayContaining(["action:intake", "human:approve", "gate:lint", "orchestrator:orchestrator"]));
+        expect(ast.topology.version).toBe("2.1.0");
+        expect(ast.topology.patterns).toEqual(["pipeline", "human-gate"]);
+    });
+    it("[I2] the agent's file wins; the .at fills only what a file cannot say", () => {
+        put(".claude/agents/writer.md", '---\nname: writer\ndescription: "From the file"\nmodel: haiku\n---\n\nBody.\n');
+        const writer = imported().ast.nodes.find((n) => n.id === "writer");
+        expect(writer).toMatchObject({ description: "From the file", model: "haiku", writes: ["out/draft.md"], file: ".claude/agents/writer.md" });
+    });
+    it("[I2] the import validates, and the JSON export carries the edges", () => {
+        const { source, ast } = imported();
+        expect(validate(ast).filter((r) => r.level === "error")).toEqual([]);
+        fs.writeFileSync(join(root, "out.at"), source);
+        const dir = join(root, "export");
+        execFileSync(process.execPath, [CLI, "export", join(root, "out.at"), "--format", "json", "--output", dir], { stdio: "ignore" });
+        const json = JSON.parse(fs.readFileSync(join(dir, fs.readdirSync(dir)[0]), "utf-8"));
+        expect(json.edges).toHaveLength(5);
+    });
+    it("[I2] a gate a skill only describes gives way to the .at's, and a noted heading gives a clean id", () => {
+        put(".claude/skills/shop/SKILL.md", "---\nname: shop\ntopology: shop\n---\n\n## Gates\n\n### lint (after writer, before approve)\nRun: lint — every draft\n");
+        const gates = imported().ast.nodes.filter((n) => n.type === "gate");
+        expect(gates).toEqual([expect.objectContaining({ id: "lint", run: "scripts/lint.sh" })]);
+    });
+    it("[I3] an agent the .at declares without a file stays in the flow and is reported", () => {
+        const { report, ast } = imported();
+        expect(ast.nodes.map((n) => n.id)).toContain("ghost");
+        expect(report.noFile).toEqual([{ id: "ghost", source: ".claude/topologies/shop.at", workflow: false }]);
+        expect(report.dropped).toEqual([]);
+    });
+    it("[I3] another system's .at, a broken .at and a second copy give no flow, and each is named", () => {
+        put("examples/other.at", SHOP_AT.replaceAll("writer", "painter").replaceAll("reviewer", "framer").replace("topology shop", "topology other"));
+        put("broken.at", "topology {");
+        put("docs/backup/shop.at", SHOP_AT);
+        const { report, ast } = imported();
+        expect(ast.edges).toHaveLength(5);
+        expect(report.sources.map((s) => s.path)).toEqual([".claude/topologies/shop.at"]);
+        const reason = (p) => report.skipped.find((s) => s.path === p)?.reason;
+        expect(reason("examples/other.at")).toBe("0 of its 3 agents are here");
+        expect(reason("broken.at")).toMatch(/^does not parse/);
+        expect(reason("docs/backup/shop.at")).toBe('another copy of topology "shop"');
+    });
+    it("[I3] names that match only by suffix are said, not mapped", () => {
+        fs.rmSync(join(root, ".claude/agents"), { recursive: true });
+        agent("shop-writer");
+        agent("shop-reviewer");
+        const { report, ast } = imported();
+        expect(ast.edges).toEqual([]);
+        expect(report.skipped[0].reason).toContain("2 more match only by suffix");
+    });
+});
+describe("import says what it does not know", () => {
+    it("[I3] with no flow source: no edge is invented, every agent is on-demand and named, and the .at says so", () => {
+        const { report, source, ast } = imported();
+        expect(ast.edges).toEqual([]);
+        expect(report.unwired.sort()).toEqual(["reviewer", "writer"]);
+        expect(source).toContain("# Flow: none found. Nothing on disk records one, so none was invented.");
+        expect(source).toContain("# Flow: 0 of 2 agents wired");
+    });
+    it("[I3] an exact shared path is offered as a possible handoff, outside the flow; a shared folder is not", () => {
+        put(".claude/agents/writer.md", "---\nname: writer\ndescription: w\n---\n\n## Writes\n- out/draft.md\n- workspace/\n");
+        put(".claude/agents/reviewer.md", "---\nname: reviewer\ndescription: r\n---\n\n## Reads\n- out/draft.md\n- workspace/\n");
+        const { report, ast } = imported();
+        expect(ast.edges).toEqual([]);
+        expect(report.suggested).toEqual([{ from: "writer", to: "reviewer", via: "out/draft.md" }]);
+    });
+    it("[I3] the CLI prints the report and writes the same lines at the top of the .at", () => {
+        put(".claude/topologies/shop.at", SHOP_AT);
+        const out = execFileSync(process.execPath, [CLI, "import", "--target", "claude-code", "--dir", root, "--name", "shop", "--output", join(root, "o")], { encoding: "utf8" });
+        expect(out).toContain("Flow: 5 edges from .claude/topologies/shop.at (2 agents match)");
+        expect(out).toContain("Flow: 3 of 3 agents wired");
+        expect(fs.readFileSync(join(root, "o/shop.at"), "utf-8")).toMatch(/^# Flow: 5 edges from/);
+    });
+});
+//# sourceMappingURL=import-project.test.js.map

package/dist/__tests__/e2e/import-project.test.js.map

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

package/dist/__tests__/e2e/unknown-names.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Nothing written in a .at file vanishes in silence (N23, N24).
+ *
+ * Measured on 0.8.0 (harness-venture, lane B, 2026-11-08): in 15 of 17 probe
+ * cases an unknown field or block was gone from the AST while validate printed
+ * "All validation rules passed" and exited 0; scaffold dropped it too. Only an
+ * unknown `on-timeout` value was caught (V59). Each case below is the same
+ * small topology with one thing added. V102 now names every name the parser
+ * does not read; V103 checks `behavior`.
+ */
+export {};
+//# sourceMappingURL=unknown-names.test.d.ts.map

package/dist/__tests__/e2e/unknown-names.test.d.ts.map

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

package/dist/__tests__/e2e/unknown-names.test.js

@@ -0,0 +1,278 @@
+/**
+ * Nothing written in a .at file vanishes in silence (N23, N24).
+ *
+ * Measured on 0.8.0 (harness-venture, lane B, 2026-11-08): in 15 of 17 probe
+ * cases an unknown field or block was gone from the AST while validate printed
+ * "All validation rules passed" and exited 0; scaffold dropped it too. Only an
+ * unknown `on-timeout` value was caught (V59). Each case below is the same
+ * small topology with one thing added. V102 now names every name the parser
+ * does not read; V103 checks `behavior`.
+ */
+import { describe, it, expect } 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 { validate } from "../../parser/validator.js";
+import { topics } from "../../docs/content.js";
+import { serializeAST } from "../../import/serializer.js";
+const CLI = resolve(dirname(fileURLToPath(import.meta.url)), "../../../dist/cli/index.js");
+const BASELINE = `topology probe : [pipeline] {
+  meta {
+    version: "1.0.0"
+    description: "Probe baseline"
+  }
+
+  orchestrator {
+    model: sonnet
+    handles: [b]
+  }
+
+  agent a {
+    model: sonnet
+    description: "Writes the draft"
+    produces: [r]
+    prompt {
+      Write the draft.
+    }
+  }
+
+  action b {
+    kind: inline
+    description: "Collect the draft"
+  }
+
+  human h {
+    description: "Approves the draft"
+  }
+
+  gates {
+    gate g {
+      after: a
+      before: b
+      run: "scripts/check.sh"
+      on-fail: halt
+    }
+  }
+
+  hooks {
+    hook k {
+      on: Stop
+      run: "scripts/stop.sh"
+    }
+  }
+
+  schedule {
+    job j {
+      every: 1h
+      agent: a
+    }
+  }
+
+  artifacts {
+    artifact r {
+      type: markdown
+      path: "out/r.md"
+    }
+  }
+
+  flow {
+    a -> b -> h
+  }
+}
+`;
+/** Where each kind of addition goes: the line it is written after. */
+const ANCHOR = {
+    agent: `    description: "Writes the draft"\n`,
+    action: `    description: "Collect the draft"\n`,
+    human: `    description: "Approves the draft"\n`,
+    gate: `      on-fail: halt\n`,
+    hook: `      run: "scripts/stop.sh"\n`,
+    job: `      agent: a\n`,
+    artifact: `      path: "out/r.md"\n`,
+    meta: `    description: "Probe baseline"\n`,
+    top: `  flow {\n`,
+};
+function withLine(where, text) {
+    const anchor = ANCHOR[where];
+    if (!BASELINE.includes(anchor))
+        throw new Error(`anchor missing: ${where}`);
+    if (where === "top")
+        return BASELINE.replace(anchor, `${text}\n\n${anchor}`);
+    const indent = anchor.match(/^ */)[0];
+    return BASELINE.replace(anchor, anchor + text.split("\n").map((l) => indent + l).join("\n") + "\n");
+}
+const CASES = [
+    { id: "C01", what: "unknown field on an agent", source: withLine("agent", "zzmarker: zzAAA101"), name: "zzmarker", marker: "zzAAA101", block: `agent "a"` },
+    { id: "C02", what: "misspelled field on an agent", source: withLine("agent", "modle: opus"), name: "modle", marker: "zzNONE", block: `agent "a"` },
+    { id: "C03", what: "unknown field on an action", source: withLine("action", "zzfield: zzAAA103"), name: "zzfield", marker: "zzAAA103", block: `action "b"` },
+    { id: "C04", what: "unknown field on a human", source: withLine("human", "zzfield: zzAAA104"), name: "zzfield", marker: "zzAAA104", block: `human "h"` },
+    { id: "C05", what: "unknown field on a gate", source: withLine("gate", "zzfield: zzAAA105"), name: "zzfield", marker: "zzAAA105", block: `gate "g"` },
+    { id: "C06", what: "unknown field on a hook", source: withLine("hook", "zzfield: zzAAA106"), name: "zzfield", marker: "zzAAA106", block: `hook "k"` },
+    { id: "C07", what: "unknown field on a schedule job", source: withLine("job", "zzfield: zzAAA107"), name: "zzfield", marker: "zzAAA107", block: `job "j"` },
+    { id: "C08", what: "unknown field on an artifact", source: withLine("artifact", "zzfield: zzAAA108"), name: "zzfield", marker: "zzAAA108", block: `artifact "r"` },
+    { id: "C09", what: "unknown field in meta", source: withLine("meta", "zzfield: zzAAA109"), name: "zzfield", marker: "zzAAA109", block: `"meta"` },
+    { id: "C10", what: "unknown top-level block", source: withLine("top", "  zzblock {\n    x: zzAAA110\n  }"), name: "zzblock", marker: "zzAAA110", block: "the topology" },
+    { id: "C11", what: "unknown named top-level block", source: withLine("top", "  contract c1 {\n    clause q1 {\n      text: \"zzAAA111\"\n    }\n  }"), name: "contract", marker: "zzAAA111", block: "the topology" },
+    { id: "C12", what: "unknown block nested in an agent", source: withLine("agent", "zzblock {\n  x: zzAAA112\n}"), name: "zzblock", marker: "zzAAA112", block: `agent "a"` },
+    { id: "C13", what: "agent field written on an action", source: withLine("action", "produces: [zzAAA113]"), name: "produces", marker: "zzAAA113", block: `action "b"` },
+    { id: "C16a", what: "v8 field serves: on an action", source: withLine("action", "serves: zzAAA116"), name: "serves", marker: "zzAAA116", block: `action "b"` },
+    { id: "C16b", what: "v8 field strength: on an action", source: withLine("action", "strength: zzAAA117"), name: "strength", marker: "zzAAA117", block: `action "b"` },
+    { id: "C17", what: "v8 field state: at the top level", source: withLine("top", "  state: zzAAA118"), name: "state", marker: "zzAAA118", block: "" },
+    { id: "C17b", what: "v8 state block at the top level", source: withLine("top", "  state draft {\n    x: zzAAA119\n  }"), name: "state", marker: "zzAAA119", block: "the topology" },
+];
+const run = (source) => {
+    const ast = parse(source);
+    return { ast, results: validate(ast) };
+};
+const named = (results, ...words) => results.filter((r) => words.every((w) => r.message.includes(w)));
+function cli(source, ...args) {
+    const dir = fs.mkdtempSync(join(os.tmpdir(), "at-unknown-"));
+    const file = join(dir, "probe.at");
+    fs.writeFileSync(file, source);
+    try {
+        const r = spawnSync(process.execPath, [CLI, ...args.map((a) => (a === "FILE" ? file : a.replace("DIR", dir)))], { encoding: "utf8" });
+        return { code: r.status, out: r.stdout + r.stderr, dir };
+    }
+    finally {
+        // dir is removed by the caller when it reads output files
+    }
+}
+describe("a name the parser does not read is reported, never dropped", () => {
+    it("[N23] the baseline still passes", () => {
+        expect(run(BASELINE).results).toEqual([]);
+    });
+    it("[N23] an unknown field on an agent is reported, not dropped", () => {
+        const { results } = run(CASES[0].source);
+        const hit = named(results, "zzmarker", `agent "a"`);
+        expect(hit.length).toBeGreaterThan(0);
+        expect(hit[0]).toMatchObject({ rule: "V102", level: "error" });
+    });
+    it("[N23] a misspelled field is reported with the field it resembles", () => {
+        const hit = named(run(CASES[1].source).results, "modle");
+        expect(hit.length).toBeGreaterThan(0);
+        expect(hit[0].message).toContain("Did you mean `model`?");
+    });
+    for (const c of CASES.slice(2, 8)) {
+        it(`[N23] an unknown field is reported on every block that holds fields: ${c.what}`, () => {
+            expect(named(run(c.source).results, c.name, c.block).length).toBeGreaterThan(0);
+        });
+    }
+    it("[N23] an unknown field in meta is reported", () => {
+        expect(named(run(CASES[8].source).results, "zzfield", `"meta"`).length).toBeGreaterThan(0);
+    });
+    it("[N23] an unknown top-level block is reported, not dropped", () => {
+        expect(named(run(CASES[9].source).results, "zzblock", "not a topology section").length).toBeGreaterThan(0);
+        expect(named(run(CASES[10].source).results, "contract c1", "not a topology section").length).toBeGreaterThan(0);
+    });
+    it("[N23] an unknown block nested in a node is reported", () => {
+        expect(named(run(CASES[11].source).results, "zzblock", `agent "a"`).length).toBeGreaterThan(0);
+    });
+    it("[N23] a field valid on another node type is reported on the wrong one", () => {
+        const hit = named(run(CASES[12].source).results, "`produces` is not an action field", "agent");
+        expect(hit.length).toBeGreaterThan(0);
+    });
+    it("[N23] the v8 words serves, strength and state are reported until the language has them", () => {
+        for (const c of CASES.slice(13)) {
+            expect(named(run(c.source).results, c.name).length, c.id).toBeGreaterThan(0);
+        }
+    });
+    it("[N23] nothing written in the file vanishes between parse and validate", () => {
+        for (const c of CASES) {
+            const { ast, results } = run(c.source);
+            const kept = JSON.stringify(ast).includes(c.marker);
+            const reported = named(results, c.name).length > 0;
+            expect(kept || reported, `${c.id} ${c.what}`).toBe(true);
+        }
+    });
+    it("[N23] validate does not print \"All validation rules passed\" when anything was dropped, and exits 1", () => {
+        for (const c of [CASES[0], CASES[10], CASES[13]]) {
+            const r = cli(c.source, "validate", "FILE");
+            fs.rmSync(r.dir, { recursive: true, force: true });
+            expect(r.out, c.id).not.toContain("All validation rules passed");
+            expect(r.out, c.id).toContain("V102");
+            expect(r.code, c.id).toBe(1);
+        }
+    });
+    it("[N23] scaffold refuses a file with an unknown field instead of dropping it", () => {
+        const r = cli(CASES[0].source, "scaffold", "FILE", "--target", "claude-code", "--output", "DIR/out");
+        const wrote = fs.existsSync(join(r.dir, "out", ".claude"));
+        fs.rmSync(r.dir, { recursive: true, force: true });
+        expect(r.code).not.toBe(0);
+        expect(r.out).toContain("zzmarker");
+        expect(wrote).toBe(false);
+    });
+    it("[N23] a gate's description is kept, since V96 sends a gate's prose there", () => {
+        const source = withLine("gate", 'description: "zzAAA130 checks the draft"');
+        const { ast, results } = run(source);
+        expect(results).toEqual([]);
+        const gate = ast.nodes.find((n) => n.id === "g");
+        expect(gate.description).toBe("zzAAA130 checks the draft");
+        const again = parse(serializeAST(ast)).nodes.find((n) => n.id === "g");
+        expect(again.description).toBe("zzAAA130 checks the draft");
+    });
+    it("[N23] the on-timeout value is still caught by V59 (the case that already worked)", () => {
+        const { ast, results } = run(withLine("human", "on-timeout: zzAAA114"));
+        expect(JSON.stringify(ast)).toContain("zzAAA114");
+        expect(results.some((r) => r.rule === "V59")).toBe(true);
+    });
+});
+describe("an enum field rejects a value outside its documented set", () => {
+    it("[N24] an agent's behavior must be advisory or blocking", () => {
+        const hit = run(withLine("agent", "behavior: zzAAA125")).results.filter((r) => r.rule === "V103");
+        expect(hit).toHaveLength(1);
+        expect(hit[0].message).toContain("zzAAA125");
+        expect(hit[0].message).toContain("advisory or blocking");
+    });
+    it("[N24] a gate's behavior must be advisory or blocking", () => {
+        expect(run(withLine("gate", "behavior: loud")).results.some((r) => r.rule === "V103")).toBe(true);
+    });
+    it("[N24] advisory and blocking pass", () => {
+        for (const v of ["advisory", "blocking"]) {
+            expect(run(withLine("agent", `behavior: ${v}`)).results).toEqual([]);
+        }
+    });
+});
+/**
+ * Guard: every field the docs list passes without a V102. A rule that flags a
+ * documented field is worse than the bug it fixes. The docs used to list
+ * agent fields by their AST names (`maxTurns`), which the parser drops.
+ */
+describe("every field in the docs is a name the parser reads", () => {
+    const PAGES = [
+        { topic: "topology", section: "## Meta Block Fields", template: (f) => withLine("meta", f) },
+        { topic: "agent", section: "## All Fields", template: (f) => withLine("agent", f) },
+        { topic: "action", section: "## Fields", template: (f) => withLine("action", f) },
+        { topic: "human", section: "## Fields", template: (f) => withLine("human", f) },
+        { topic: "gate", section: "## Fields", template: (f) => withLine("gate", f) },
+        { topic: "hooks", section: "## Fields", template: (f) => withLine("hook", f) },
+        { topic: "schedule", section: "## Fields", template: (f) => withLine("job", f) },
+        { topic: "artifacts", section: "## Fields", template: (f) => withLine("artifact", f) },
+        { topic: "orchestrator", section: "## Fields", template: (f) => BASELINE.replace("    handles: [b]\n", `    handles: [b]\n    ${f}\n`) },
+        { topic: "group", section: "## Fields", template: (f) => withLine("top", `  group gc {\n    ${f}\n  }`) },
+        { topic: "tools", section: "## Fields", template: (f) => withLine("top", `  tools {\n    tool t {\n      ${f}\n    }\n  }`) },
+        { topic: "skills", section: "## Fields", template: (f) => withLine("top", `  skill s {\n    ${f}\n  }`) },
+    ];
+    /** First-column names of the tables under `section`, until the next `## `. */
+    function documented(topic, section) {
+        const page = topics[topic].content();
+        const start = page.indexOf(section);
+        expect(start, `${topic}: "${section}" not found`).toBeGreaterThan(-1);
+        const end = page.indexOf("\n## ", start + section.length);
+        const body = page.slice(start, end === -1 ? undefined : end);
+        return [...body.matchAll(/^\|\s*`?([a-zA-Z][\w-]*)`?\s*\|/gm)]
+            .map((m) => m[1])
+            .filter((n) => !["Field", "id", "name", "NAME"].includes(n));
+    }
+    for (const p of PAGES) {
+        it(`[N23] every field in docs ${p.topic} passes without a V102`, () => {
+            const fields = documented(p.topic, p.section);
+            expect(fields.length).toBeGreaterThan(0);
+            const flagged = fields.filter((f) => run(p.template(`${f}: x`)).results.some((r) => r.rule === "V102"));
+            expect(flagged, `${p.topic}: documented but reported as unknown`).toEqual([]);
+        });
+    }
+});
+//# sourceMappingURL=unknown-names.test.js.map