agentopology 0.5.2 → 0.6.0

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) │  │  93 rules  │  │                ├── <topology>.workflow.js
+      │  (you write) │  │  97 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 93 rules
+2. Validates it against 97 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 (93 built-in rules, V1-V93)
+// Validate (97 built-in rules, V1-V97)
 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 | 93 built-in rules catch errors before deploy |
+| **Validate** | Hope for the best | 97 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 (93 rules)
+agentopology validate <file>              Validate an .at file (97 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/roundtrip.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * End to end: a system built by hand comes into .at without losing anything.
+ *
+ * The rule (Nadav, 2026-10-29): AgentTopology gives the structure; bringing a
+ * hand-built system into it must never delete its internals. Before this,
+ * import then scaffold on this repo's own .claude left 0 of 72 files
+ * identical, 37 missing and the rest cut down (a 404-line SKILL.md came back
+ * as 9 lines), and the imported .at had 22 validation errors.
+ *
+ * The fixture (fixtures/handbuilt) holds what was lost: a flat and a folder
+ * agent, frontmatter the language has no field for, a comma-string tools
+ * list, a skill with scripts and references, a command, real permissions and
+ * a hand-written hook.
+ */
+export {};
+//# sourceMappingURL=roundtrip.test.d.ts.map

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

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

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

@@ -0,0 +1,178 @@
+/**
+ * End to end: a system built by hand comes into .at without losing anything.
+ *
+ * The rule (Nadav, 2026-10-29): AgentTopology gives the structure; bringing a
+ * hand-built system into it must never delete its internals. Before this,
+ * import then scaffold on this repo's own .claude left 0 of 72 files
+ * identical, 37 missing and the rest cut down (a 404-line SKILL.md came back
+ * as 9 lines), and the imported .at had 22 validation errors.
+ *
+ * The fixture (fixtures/handbuilt) holds what was lost: a flat and a folder
+ * agent, frontmatter the language has no field for, a comma-string tools
+ * list, a skill with scripts and references, a command, real permissions and
+ * a hand-written hook.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { execFileSync } 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, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "../../parser/index.js";
+import { validate } from "../../parser/validator.js";
+import { claudeCodeBinding } from "../../bindings/claude-code.js";
+import { deepMergeSettingsJson } from "../../scaffold/merge.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const root = resolve(here, "../../..");
+const CLI = resolve(root, "dist/cli/index.js");
+const HANDBUILT = resolve(here, "fixtures/handbuilt");
+function cli(args) {
+    try {
+        const out = execFileSync(process.execPath, [CLI, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+        return { out, code: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return { out: `${e.stdout ?? ""}${e.stderr ?? ""}`, code: e.status ?? 1 };
+    }
+}
+/** path -> sha1 of every file under dir. */
+function snapshot(dir) {
+    const out = new Map();
+    const walk = (d) => {
+        for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+            const p = join(d, e.name);
+            if (e.isDirectory())
+                walk(p);
+            else
+                out.set(relative(dir, p), createHash("sha1").update(fs.readFileSync(p)).digest("hex"));
+        }
+    };
+    walk(dir);
+    return out;
+}
+let tmp;
+let project;
+let at;
+beforeEach(() => {
+    tmp = fs.mkdtempSync(join(os.tmpdir(), "at-roundtrip-"));
+    project = join(tmp, "project");
+    fs.cpSync(HANDBUILT, project, { recursive: true });
+    at = join(tmp, "handbuilt.at");
+    expect(cli(["import", "--target", "claude-code", "--dir", project, "--name", "handbuilt", "--output", tmp]).code).toBe(0);
+});
+afterEach(() => {
+    fs.rmSync(tmp, { recursive: true, force: true });
+});
+describe("import then scaffold loses nothing (e2e)", () => {
+    it("[R3] the imported .at validates with no errors", () => {
+        const errors = validate(parse(fs.readFileSync(at, "utf-8"))).filter((r) => r.level === "error");
+        expect(errors.map((e) => `[${e.rule}] ${e.message}`)).toEqual([]);
+    });
+    it("[R1] every hand-built file is still there after scaffolding the import back", () => {
+        const before = snapshot(project);
+        expect(cli(["scaffold", at, "--target", "claude-code", "--output", project]).code).toBe(0);
+        const after = snapshot(project);
+        const missing = [...before.keys()].filter((p) => !after.has(p));
+        expect(missing).toEqual([]);
+    });
+    it("[R2] every hand-built file is byte-identical, settings.json included", () => {
+        const before = snapshot(project);
+        cli(["scaffold", at, "--target", "claude-code", "--output", project]);
+        const after = snapshot(project);
+        const changed = [...before].filter(([p, h]) => after.get(p) !== h).map(([p]) => p);
+        expect(changed).toEqual([]);
+    });
+    it("[A4] even --force leaves every hand-written file byte-identical", () => {
+        // Two layers protect a hand-built file: scaffold keeps files it did not
+        // create (G1), and file: means the binding never generates them at all.
+        // --force removes the first layer, so this proves the second on its own.
+        const before = snapshot(project);
+        expect(cli(["scaffold", at, "--target", "claude-code", "--output", project, "--force"]).code).toBe(0);
+        const after = snapshot(project);
+        const changed = [...before].filter(([p, h]) => after.get(p) !== h).map(([p]) => p);
+        expect(changed).toEqual([]);
+    });
+    it("[G12] a second scaffold of the import changes nothing", () => {
+        cli(["scaffold", at, "--target", "claude-code", "--output", project]);
+        expect(cli(["scaffold", at, "--target", "claude-code", "--output", project]).out).toMatch(/ 0 created, 0 updated/);
+    });
+    it("[R4] import keeps what the language has no field for, and the real permissions", () => {
+        const ast = parse(fs.readFileSync(at, "utf-8"));
+        const reviewer = ast.nodes.find((n) => n.id === "reviewer");
+        expect(reviewer.file).toBe(".claude/agents/reviewer.md");
+        expect(reviewer.extensions?.["claude-code"]).toMatchObject({
+            effort: "high",
+            color: "purple",
+        });
+        expect(reviewer.tools).toEqual(["Read", "Grep", "Glob"]);
+        expect(ast.settings.allow).toContain("Read");
+        expect(ast.settings.ask).toEqual(["Bash(git push:*)"]);
+    });
+    it("[A4] skills, commands and agents found on disk are marked file: and never generated", () => {
+        const ast = parse(fs.readFileSync(at, "utf-8"));
+        expect(ast.skills.find((s) => s.id === "story")?.file).toBe(".claude/skills/story/SKILL.md");
+        expect(ast.triggers.find((t) => t.name === "ship")?.file).toBe(".claude/commands/ship.md");
+        const paths = claudeCodeBinding.scaffold(ast).map((f) => f.path);
+        expect(paths.filter((p) => p.startsWith(".claude/skills/story/"))).toEqual([]);
+        expect(paths).not.toContain(".claude/commands/ship.md");
+        expect(paths).not.toContain(".claude/agents/reviewer/AGENT.md");
+        expect(paths).not.toContain(".claude/agents/writer/AGENT.md");
+    });
+    it("[G13] an agent's extensions never leak into project-wide settings", () => {
+        cli(["scaffold", at, "--target", "claude-code", "--output", project]);
+        const settings = JSON.parse(fs.readFileSync(join(project, ".claude/settings.json"), "utf-8"));
+        expect(settings.effort).toBeUndefined();
+        expect(settings.color).toBeUndefined();
+    });
+    it("[G14] an imported hook and its compiled form are one hook, not two", () => {
+        const existing = JSON.stringify({
+            hooks: { PreToolUse: [{ matcher: "Bash", hooks: [{ type: "command", command: "bash .claude/hooks/guard.sh" }] }] },
+        });
+        const generated = JSON.stringify({
+            hooks: { PreToolUse: [{ matcher: "Bash", hooks: [{ type: "command", command: 'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/guard.sh"' }] }] },
+        });
+        const merged = JSON.parse(deepMergeSettingsJson(existing, generated));
+        expect(merged.hooks.PreToolUse).toHaveLength(1);
+    });
+});
+describe("an on-demand agent needs no flow path", () => {
+    it("[G17] V11 skips a reader or writer with invocation: manual", () => {
+        const src = fs.readFileSync(at, "utf-8")
+            .replace("agent reviewer {", 'agent reviewer {\n    reads: ["drafts/"]')
+            .replace("agent writer {", 'agent writer {\n    writes: ["drafts/"]');
+        expect(validate(parse(src)).filter((r) => r.rule === "V11")).toEqual([]);
+    });
+});
+describe("file: is checked, and scaffold's two overrides are separate", () => {
+    it("[G15] V97 refuses a file: outside the project", () => {
+        const src = fs.readFileSync(at, "utf-8").replace("file: .claude/agents/reviewer.md", 'file: "../elsewhere/reviewer.md"');
+        const errors = validate(parse(src)).filter((r) => r.rule === "V97");
+        expect(errors).toHaveLength(1);
+    });
+    it("[F3] --allow-invalid compiles despite errors; --force alone does not", () => {
+        fs.writeFileSync(at, fs.readFileSync(at, "utf-8").replace("file: .claude/agents/reviewer.md", 'file: "../x.md"'));
+        const forced = cli(["scaffold", at, "--target", "claude-code", "--output", project, "--force"]);
+        expect(forced.code).toBe(1);
+        expect(forced.out).toContain("Nothing was written");
+        const allowed = cli(["scaffold", at, "--target", "claude-code", "--output", project, "--allow-invalid"]);
+        expect(allowed.code).toBe(0);
+        // --allow-invalid does not overwrite what scaffold did not create.
+        expect(fs.readFileSync(join(project, ".claude/hooks/guard.sh"), "utf-8")).toContain("Blocks a push");
+    });
+    it("[C5] a hook's own script is never overwritten, even with --force, and not reported as a conflict", () => {
+        const { out } = cli(["scaffold", at, "--target", "claude-code", "--output", project, "--force"]);
+        expect(fs.readFileSync(join(project, ".claude/hooks/guard.sh"), "utf-8")).toContain("Blocks a push");
+        expect(out).not.toContain("guard.sh (exists");
+        const manifest = JSON.parse(fs.readFileSync(join(project, ".claude/.scaffold-manifest.json"), "utf-8"));
+        expect(manifest.files[".claude/hooks/guard.sh"]).toBeUndefined();
+    });
+    it("[G16] scaffold names a hand-written file the project lacks", () => {
+        fs.rmSync(join(project, ".claude/commands/ship.md"));
+        const { out } = cli(["scaffold", at, "--target", "claude-code", "--output", project, "--dry-run"]);
+        expect(out).toContain(".claude/commands/ship.md");
+        expect(out).toMatch(/hand-written file\(s\) named by file: are not in/);
+    });
+});
+//# sourceMappingURL=roundtrip.test.js.map

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

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

package/dist/__tests__/e2e/scaffold-owns.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * End to end: scaffold only changes what it owns.
+ *
+ * Each test runs the built CLI as a user would, against a temporary project
+ * that holds the hazards a real harness hit on 2026-10-28. Test names carry
+ * the guarantee id from spec/testing.md; spec-testing-sync.test.ts fails if a
+ * guarantee there has no test here or elsewhere.
+ */
+export {};
+//# sourceMappingURL=scaffold-owns.test.d.ts.map

package/dist/__tests__/e2e/scaffold-owns.test.d.ts.map

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

package/dist/__tests__/e2e/scaffold-owns.test.js

@@ -0,0 +1,154 @@
+/**
+ * End to end: scaffold only changes what it owns.
+ *
+ * Each test runs the built CLI as a user would, against a temporary project
+ * that holds the hazards a real harness hit on 2026-10-28. Test names carry
+ * the guarantee id from spec/testing.md; spec-testing-sync.test.ts fails if a
+ * guarantee there has no test here or elsewhere.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { execFileSync } 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";
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
+const CLI = resolve(root, "dist/cli/index.js");
+const FIXTURE = resolve(dirname(fileURLToPath(import.meta.url)), "fixtures/hazards.at");
+function cli(args) {
+    try {
+        const out = execFileSync(process.execPath, [CLI, ...args], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        return { out, code: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return { out: `${e.stdout ?? ""}${e.stderr ?? ""}`, code: e.status ?? 1 };
+    }
+}
+let tmp;
+let project;
+let otherRepo;
+let at;
+const file = (rel) => join(project, rel);
+const read = (rel) => fs.readFileSync(file(rel), "utf-8");
+const put = (rel, content) => {
+    fs.mkdirSync(dirname(file(rel)), { recursive: true });
+    fs.writeFileSync(file(rel), content);
+};
+const scaffold = (...extra) => cli(["scaffold", at, "--target", "claude-code", "--output", project, ...extra]);
+const USER_SETTINGS = {
+    permissions: { ask: ["Bash(git push:*)"], defaultMode: "acceptEdits" },
+    hooks: { PreToolUse: [{ matcher: "Bash", hooks: [{ type: "command", command: "bash ./my-guard.sh" }] }] },
+};
+beforeEach(() => {
+    tmp = fs.mkdtempSync(join(os.tmpdir(), "at-e2e-"));
+    project = join(tmp, "project");
+    otherRepo = join(tmp, "other-repo");
+    at = join(tmp, "hazards.at");
+    fs.copyFileSync(FIXTURE, at);
+    // A hand-written skill, a skill linked from another repository, and the
+    // user's own settings — what the content repo actually had.
+    put(".claude/skills/story/SKILL.md", "REAL STORY SKILL\n");
+    fs.mkdirSync(join(otherRepo, "the-book"), { recursive: true });
+    fs.writeFileSync(join(otherRepo, "the-book/SKILL.md"), "OTHER REPO BOOK\n");
+    fs.symlinkSync(join(otherRepo, "the-book"), file(".claude/skills/the-book"));
+    put(".claude/settings.json", JSON.stringify(USER_SETTINGS, null, 2));
+});
+afterEach(() => {
+    fs.rmSync(tmp, { recursive: true, force: true });
+});
+describe("scaffold only changes what it owns (e2e)", () => {
+    it("[G1] the first scaffold keeps a file it did not create", () => {
+        const { out, code } = scaffold();
+        expect(code).toBe(0);
+        expect(read(".claude/skills/story/SKILL.md")).toBe("REAL STORY SKILL\n");
+        expect(out).toContain("exists, not created by scaffold — kept");
+        expect(fs.existsSync(file(".claude/agents/writer/AGENT.md"))).toBe(true);
+    });
+    it("[G2] never writes through a symlink, even with --force", () => {
+        scaffold("--force");
+        expect(fs.readFileSync(join(otherRepo, "the-book/SKILL.md"), "utf-8")).toBe("OTHER REPO BOOK\n");
+    });
+    it("[G3] keeps the user's hooks, ask rules and defaultMode across runs", () => {
+        scaffold();
+        scaffold();
+        const settings = JSON.parse(read(".claude/settings.json"));
+        expect(settings.permissions.ask).toEqual(["Bash(git push:*)"]);
+        expect(settings.permissions.defaultMode).toBe("acceptEdits");
+        expect(JSON.stringify(settings.hooks)).toContain("my-guard.sh");
+        expect(settings.permissions.allow).toContain("Read");
+    });
+    it("[G4] a second run changes nothing", () => {
+        scaffold();
+        const { out } = scaffold();
+        expect(out).toMatch(/ 0 created, 0 updated, \d+ unchanged/);
+    });
+    it("[G5] --dry-run writes nothing", () => {
+        const before = fs.readdirSync(project, { recursive: true }).length;
+        expect(scaffold("--dry-run").code).toBe(0);
+        expect(fs.readdirSync(project, { recursive: true }).length).toBe(before);
+    });
+    it("[G6] prose in a gate's run fails validate and scaffold, and nothing is written", () => {
+        const prose = "pxframes gate mean >= 3.85, no frame < 3; frames 0.0 / 0.5 / 3.0 s differ";
+        fs.writeFileSync(at, fs.readFileSync(at, "utf-8").replace('run: "scripts/check-quality.sh"', `run: "${prose}"`));
+        const v = cli(["validate", at]);
+        expect(v.code).toBe(1);
+        expect(v.out).toContain("[V96]");
+        const s = scaffold();
+        expect(s.code).toBe(1);
+        expect(s.out).toContain("Nothing was written");
+        expect(fs.existsSync(file(".claude/agents"))).toBe(false);
+    });
+    it("[G7] an edited file scaffold owns is kept on the next run", () => {
+        scaffold();
+        put(".claude/CLAUDE.md", read(".claude/CLAUDE.md") + "my own note\n");
+        const { out } = scaffold();
+        expect(read(".claude/CLAUDE.md")).toContain("my own note");
+        expect(out).toContain(".claude/CLAUDE.md (user edited — kept)");
+    });
+    it("[G8] --prune removes untouched leftovers and keeps edited ones", () => {
+        scaffold();
+        const wrapper = ".claude/skills/hazards/scripts/gate-quality-check.sh";
+        const check = ".claude/skills/hazards/scripts/check-quality.sh";
+        expect(fs.existsSync(file(wrapper))).toBe(true);
+        put(check, "#!/bin/bash\n# my real check\n");
+        // Rename the gate and its script: both old files are now leftovers.
+        fs.writeFileSync(at, fs.readFileSync(at, "utf-8")
+            .replace("gate quality-check {", "gate quality-check-v2 {")
+            .replace('run: "scripts/check-quality.sh"', 'run: "scripts/check-v2.sh"'));
+        const { code, out } = scaffold("--prune");
+        expect(code, out).toBe(0);
+        expect(fs.existsSync(file(wrapper))).toBe(false);
+        expect(read(check)).toContain("my real check");
+        expect(out).toContain("no longer generated, but edited — kept");
+    });
+    it("[G9] a second topology in the same project keeps its own manifest", () => {
+        scaffold();
+        const other = join(tmp, "other.at");
+        fs.writeFileSync(other, fs.readFileSync(at, "utf-8").replace("topology hazards :", "topology other :"));
+        cli(["scaffold", other, "--target", "claude-code", "--output", project]);
+        expect(fs.existsSync(file(".claude/.scaffold-manifest.json"))).toBe(true);
+        expect(fs.existsSync(file(".claude/.scaffold-manifest.other.at.json"))).toBe(true);
+        // The first topology still owns its files: a rerun changes nothing.
+        expect(scaffold().out).toMatch(/ 0 created, 0 updated/);
+    });
+});
+describe("every example compiles to files Claude Code can load", () => {
+    const examples = fs.readdirSync(resolve(root, "examples")).filter((f) => f.endsWith(".at"));
+    it.each(examples)("[G10] %s: no ${…} reference reaches settings env", (name) => {
+        const out = join(tmp, name);
+        expect(cli(["scaffold", resolve(root, "examples", name), "--target", "claude-code", "--output", out]).code).toBe(0);
+        const settingsPath = join(out, ".claude/settings.json");
+        if (!fs.existsSync(settingsPath))
+            return;
+        const env = JSON.parse(fs.readFileSync(settingsPath, "utf-8")).env ?? {};
+        for (const [k, v] of Object.entries(env)) {
+            expect(String(v), `env.${k}`).not.toContain("${");
+            expect(k).not.toMatch(/^#/);
+        }
+    });
+});
+//# sourceMappingURL=scaffold-owns.test.js.map

package/dist/__tests__/e2e/scaffold-owns.test.js.map

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

package/dist/__tests__/global-setup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build once before any test runs, so tests that execute `dist/cli/index.js`
+ * always test the current source. They used to run whatever dist/ happened to
+ * be on disk — a change could pass against stale output.
+ */
+export default function setup(): void;
+//# sourceMappingURL=global-setup.d.ts.map

package/dist/__tests__/global-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/global-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,CAAC,OAAO,UAAU,KAAK,IAAI,IAAI,CAMpC"}

package/dist/__tests__/global-setup.js

@@ -0,0 +1,16 @@
+/**
+ * Build once before any test runs, so tests that execute `dist/cli/index.js`
+ * always test the current source. They used to run whatever dist/ happened to
+ * be on disk — a change could pass against stale output.
+ */
+import { execFileSync } from "node:child_process";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+export default function setup() {
+    const root = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+    execFileSync(process.execPath, [resolve(root, "node_modules/typescript/bin/tsc")], {
+        cwd: root,
+        stdio: "inherit",
+    });
+}
+//# sourceMappingURL=global-setup.js.map

package/dist/__tests__/global-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.js","sourceRoot":"","sources":["../../src/__tests__/global-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,OAAO,UAAU,KAAK;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC,EAAE;QACjF,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/__tests__/live/claude-code.live.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Live: real Claude Code loads what scaffold generates.
+ *
+ * Unit tests check the files we write; only Claude Code can say whether it
+ * reads them. This scaffolds every example (and the hazards fixture) into a
+ * temporary project, starts a headless `claude -p` session there, and checks
+ * the session's init report: every generated agent, skill and command is
+ * registered, and the session itself succeeds.
+ *
+ * It found the first bug the moment it ran: settings `env` carried the literal
+ * text "${ANTHROPIC_API_KEY}", which Claude Code applied as the key, so every
+ * session in 6 of the 10 example projects failed with "Invalid API key".
+ *
+ * Opt-in, because it needs the `claude` CLI and makes one small model call per
+ * project:  AT_LIVE=1 npx vitest run src/__tests__/live
+ * The session is isolated from the developer's own setup: user settings (and
+ * their hooks), MCP servers and session history are all left out.
+ */
+export {};
+//# sourceMappingURL=claude-code.live.test.d.ts.map

package/dist/__tests__/live/claude-code.live.test.d.ts.map

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