agentopology 0.9.1 → 0.10.0

package/dist/guard/check.js

@@ -0,0 +1,366 @@
+/**
+ * `agentopology guard <file> --check`: what a project enforces today, read
+ * from disk. It writes nothing.
+ *
+ * For each gate, approval step and permission rule the topology declares, it
+ * works out what the claude-code binding compiles it to, then looks in the
+ * project for that piece: the settings.json hook entry, the scripts it runs,
+ * the permission rule. Each item gets a strength:
+ *
+ * - `refuse`: a hook or a settings rule stops the step, and it is on disk.
+ * - `none`: the binding compiles it to a hook or rule, but the project is
+ *   missing it (or names it by a relative path, which is skipped once Claude
+ *   changes directory). Nothing stops the step.
+ * - `hope`: the binding has no hook for it (an advisory gate, inline
+ *   delegation, or a gate with no agent on either side); only the playbook's
+ *   prose asks for it.
+ *
+ * @module
+ */
+import * as fs from "node:fs";
+import { join } from "node:path";
+import { gateAnchors } from "../parser/ast.js";
+import { runParts, isProjectPath, scriptNameFromRun } from "../parser/run.js";
+import { approvalTargets, checkableActionGate, claudeEvent, convertMcpToolName, gateWiring, settingsHooksOf } from "../bindings/claude-code.js";
+import { isStubContent } from "../bindings/lib/stub.js";
+import { unanchoredScript, VERIFIED_ON } from "../conformance/claude-code.js";
+function readJson(path) {
+    try {
+        return JSON.parse(fs.readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function readText(path) {
+    try {
+        return fs.readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+/** The command hooks on disk for an event whose command names `file`, under a matcher test. */
+function findHooks(settings, event, file, matcher) {
+    const entries = (settings?.hooks?.[event] ?? []);
+    return entries.filter((e) => matcher(e.matcher)).flatMap((e) => (e.hooks ?? []).filter((h) => h.type === "command" && h.command?.includes(file)));
+}
+/** Notes on the check script a gate's `run:` names: unwritten or missing scripts block every run. */
+function checkScriptNotes(root, scriptsDir, run) {
+    const { script } = runParts(run);
+    const path = script.startsWith("/") ? script : isProjectPath(script) ? join(root, script.replace(/^\.\//, "")) : join(root, scriptsDir, script.replace(/^.*\//, ""));
+    const text = readText(path);
+    const shown = path.startsWith(root) ? path.slice(root.length + 1) : path;
+    if (text === null)
+        return [`its check script ${shown} is missing, so it blocks every run`];
+    if (isStubContent(text))
+        return [`its check script ${shown} is still a stub, so it blocks every run until it is written`];
+    return [];
+}
+/** How many lines either side of a cited line the match text may sit. */
+const MATCH_WINDOW = 5;
+/**
+ * Check an `at: "path[:line]"` citation on disk: the file exists, the line is
+ * in it, and `match` appears within 5 lines of it (anywhere, with no line).
+ * Null when it holds; otherwise why not.
+ */
+function citationProblem(root, at, match) {
+    const m = /^(.*?)(?::(\d+))?$/.exec(at);
+    const [file, lineText] = [m[1].replace(/^\.\//, ""), m[2]];
+    const text = readText(join(root, file));
+    if (text === null)
+        return `the cited file ${file} is missing`;
+    const all = text.split("\n");
+    if (text.endsWith("\n"))
+        all.pop();
+    const line = lineText ? parseInt(lineText, 10) : undefined;
+    if (line !== undefined && (line < 1 || line > all.length))
+        return `${file} has ${all.length} lines, so line ${line} is not in it`;
+    if (match === undefined)
+        return null;
+    const window = line === undefined ? all : all.slice(Math.max(0, line - 1 - MATCH_WINDOW), line + MATCH_WINDOW);
+    if (window.some((l) => l.includes(match)))
+        return null;
+    return line === undefined
+        ? `"${match}" is not in ${file}`
+        : `"${match}" is not within ${MATCH_WINDOW} lines of line ${line} in ${file}; the check may have moved or gone`;
+}
+/** Whether a declared hook is in settings.json: same event, same matcher, a command naming its script. */
+function hookOnDisk(settings, hook) {
+    const script = runParts(hook.run).script.replace(/^\.\//, "");
+    if (!script)
+        return false;
+    return findHooks(settings, claudeEvent(hook.on), script, (m) => !hook.matcher || m === hook.matcher).length > 0;
+}
+/** Notes on a hook's command: a relative path is skipped off the project root. */
+function commandProblem(command = "") {
+    const loose = unanchoredScript(command);
+    return loose ? `the hook names ${loose} by a relative path, so it is skipped once Claude changes directory` : null;
+}
+export function checkGuards(ast, root) {
+    const name = ast.topology.name;
+    const scriptsDir = `.claude/skills/${name}/scripts`;
+    const settings = readJson(join(root, ".claude/settings.json"));
+    const beforeAgent = readText(join(root, scriptsDir, "before-agent.sh"));
+    const items = [];
+    /** The before-agent PreToolUse entry: present and anchored, with onFailure noted. */
+    const guardEntry = () => {
+        const hooks = findHooks(settings, "PreToolUse", "before-agent.sh", (m) => !!m && /\b(Agent|Task)\b/.test(m));
+        if (hooks.length === 0)
+            return { ok: false, notes: ["no PreToolUse entry for before-agent.sh in .claude/settings.json"] };
+        const bad = commandProblem(hooks[0].command);
+        if (bad)
+            return { ok: false, notes: [bad] };
+        if (beforeAgent === null)
+            return { ok: false, notes: [`${scriptsDir}/before-agent.sh is missing`] };
+        const notes = hooks.some((h) => h.onFailure === "block") ? [] : ['the entry has no onFailure: "block", so the step goes through if the hook cannot start'];
+        return { ok: true, notes };
+    };
+    for (const node of ast.nodes) {
+        if (node.type !== "gate")
+            continue;
+        const gate = node;
+        const base = { kind: "gate", id: gate.id };
+        if (gate.behavior === "advisory") {
+            items.push({ ...base, strength: "hope", by: "prose", where: "advisory: it reports and never blocks", notes: [] });
+            continue;
+        }
+        // A gate before a script step: before-action.sh refuses its command. One
+        // with nothing to check (V110) compiles to no line, and falls through to
+        // the cases below (prose, or a citation).
+        if (checkableActionGate(ast, gate)) {
+            const where = `PreToolUse on Bash running ${gateAnchors(gate, "before").join(", ")} → before-action.sh`;
+            const problems = [];
+            const hooks = findHooks(settings, "PreToolUse", "before-action.sh", (m) => !!m && /\bBash\b/.test(m));
+            if (hooks.length === 0)
+                problems.push("no PreToolUse entry on Bash for before-action.sh in .claude/settings.json");
+            else {
+                const bad = commandProblem(hooks[0].command);
+                if (bad)
+                    problems.push(bad);
+            }
+            const script = readText(join(root, scriptsDir, "before-action.sh"));
+            if (script === null)
+                problems.push(`${scriptsDir}/before-action.sh is missing`);
+            else if (!script.includes(`# gate ${gate.id} (`))
+                problems.push(`before-action.sh has no line for gate ${gate.id}`);
+            if (gate.run && scriptNameFromRun(gate.run) && readText(join(root, scriptsDir, `gate-${gate.id}.sh`)) === null)
+                problems.push(`${scriptsDir}/gate-${gate.id}.sh is missing`);
+            const scope = "refuses in Claude Code sessions only; a step run outside Claude is covered by step check (by: code)";
+            const indirect = "a command that runs the step indirectly (bash -c, eval, a script that calls it) is not seen";
+            if (problems.length) {
+                items.push({ ...base, strength: "none", by: "hook", where, notes: [...problems, scope, indirect] });
+            }
+            else {
+                const entryNotes = hooks.some((h) => h.onFailure === "block") ? [] : ['the entry has no onFailure: "block", so the step goes through if the hook cannot start'];
+                items.push({ ...base, strength: "refuse", by: "hook", where, notes: [...entryNotes, ...(gate.run && scriptNameFromRun(gate.run) ? checkScriptNotes(root, scriptsDir, gate.run) : []), scope, indirect] });
+            }
+            continue;
+        }
+        if (!gate.run || !scriptNameFromRun(gate.run)) {
+            items.push({ ...base, strength: "hope", by: "prose", where: "its run: names no script", notes: [] });
+            continue;
+        }
+        const wiring = gateWiring(ast, gate);
+        if (wiring.kind === "none") {
+            const anchors = [...gateAnchors(gate, "after"), ...gateAnchors(gate, "before")].join(", ") || "nothing";
+            items.push({ ...base, strength: "hope", by: "prose", where: `no Claude Code event marks its moment (between ${anchors}); the playbook runs it`, notes: [] });
+            continue;
+        }
+        const scriptNotes = checkScriptNotes(root, scriptsDir, gate.run);
+        if (wiring.kind === "subagent-stop") {
+            const file = `gate-${gate.id}.sh`;
+            const problems = [];
+            for (const anchor of wiring.anchors) {
+                const hooks = findHooks(settings, "SubagentStop", file, (m) => m === anchor);
+                if (hooks.length === 0)
+                    problems.push(`no SubagentStop entry for ${anchor} running ${file} in .claude/settings.json`);
+                else {
+                    const bad = commandProblem(hooks[0].command);
+                    if (bad)
+                        problems.push(bad);
+                }
+            }
+            if (readText(join(root, scriptsDir, file)) === null)
+                problems.push(`${scriptsDir}/${file} is missing`);
+            const where = `SubagentStop on ${wiring.anchors.join(", ")} → ${file}`;
+            items.push(problems.length
+                ? { ...base, strength: "none", by: "hook", where, notes: problems }
+                : { ...base, strength: "refuse", by: "hook", where, notes: scriptNotes });
+            continue;
+        }
+        // before-agent
+        const where = `PreToolUse on launching ${wiring.agents.join(", ")} → before-agent.sh`;
+        const entry = guardEntry();
+        const problems = entry.ok ? [] : entry.notes;
+        if (entry.ok && !beforeAgent.includes(`gate-${gate.id}.sh`))
+            problems.push(`before-agent.sh does not run gate-${gate.id}.sh`);
+        if (readText(join(root, scriptsDir, `gate-${gate.id}.sh`)) === null)
+            problems.push(`${scriptsDir}/gate-${gate.id}.sh is missing`);
+        items.push(problems.length
+            ? { ...base, strength: "none", by: "hook", where, notes: problems }
+            : { ...base, strength: "refuse", by: "hook", where, notes: [...entry.notes, ...scriptNotes] });
+    }
+    for (const node of ast.nodes) {
+        if (node.type !== "human")
+            continue;
+        const human = node;
+        const base = { kind: "human", id: human.id };
+        const targets = approvalTargets(ast, human);
+        if (targets.length === 0) {
+            items.push({ ...base, strength: "hope", by: "prose", where: "no agent follows it, so no launch to ask before; the playbook asks", notes: [] });
+            continue;
+        }
+        const where = `PreToolUse on launching ${targets.join(", ")} → ask`;
+        const entry = guardEntry();
+        const problems = entry.ok ? [] : entry.notes;
+        if (entry.ok && !beforeAgent.includes(`# approval step ${human.id}`))
+            problems.push(`before-agent.sh does not ask for ${human.id}`);
+        items.push(problems.length
+            ? { ...base, strength: "none", by: "hook", where, notes: problems }
+            : { ...base, strength: "refuse", by: "hook", where, notes: [...entry.notes, "Claude Code asks the person in the session; in claude -p there is no one to ask, so it is denied"] });
+    }
+    for (const key of ["deny", "ask"]) {
+        for (const raw of ast.settings?.[key] ?? []) {
+            const rule = convertMcpToolName(raw);
+            const onDisk = (settings?.permissions?.[key] ?? []).includes(rule);
+            items.push({
+                kind: "permission",
+                id: `${key} ${rule}`,
+                strength: onDisk ? "refuse" : "none",
+                by: "settings",
+                where: `permissions.${key} in .claude/settings.json`,
+                notes: onDisk ? [] : [`.claude/settings.json has no ${key} rule ${rule}`],
+            });
+        }
+    }
+    // A hook is the topology's own when it runs a script from the skill's
+    // scripts folder, or when it is one the topology's hooks {} block compiles to.
+    const ours = `.claude/skills/${name}/scripts/`;
+    const declared = new Set();
+    for (const [event, entries] of Object.entries(settingsHooksOf(ast))) {
+        for (const e of entries)
+            for (const h of (e.hooks ?? []))
+                declared.add(`${event}|${h.command ?? h.prompt ?? h.url ?? ""}`);
+    }
+    const unattributed = [];
+    for (const [event, entries] of Object.entries((settings?.hooks ?? {}))) {
+        for (const e of entries ?? [])
+            for (const h of e.hooks ?? []) {
+                const handler = h;
+                if (h.command?.includes(ours) || declared.has(`${event}|${handler.command ?? handler.prompt ?? handler.url ?? ""}`))
+                    continue;
+                unattributed.push(`${event}${e.matcher ? ` ${e.matcher}` : ""}: ${h.type === "command" ? h.command : h.type}`);
+            }
+    }
+    // Citations. A gate that cites the code refusing it (by: code, at:) is
+    // checked on disk; a gate the binding gives no hook is credited by a guard
+    // its edge cites. A cited hook counts only when it is in settings.json and
+    // declares its strength: the file's own claim, cited, not proven.
+    const hooksByName = new Map((ast.hooks ?? []).map((h) => [h.name, h]));
+    const gateItem = (id) => items.find((i) => i.kind === "gate" && i.id === id);
+    for (const node of ast.nodes) {
+        if (node.type !== "gate")
+            continue;
+        const gate = node;
+        const item = gateItem(gate.id);
+        if (gate.at) {
+            const bad = citationProblem(root, gate.at, gate.match);
+            const by = (gate.by ?? "code");
+            const notes = bad ? [bad] : ["cited, not proven: the code is there, this check cannot run it", ...(gate.bypass ? [`bypass: ${gate.bypass}`] : [])];
+            if (item.strength !== "refuse" || bad) {
+                Object.assign(item, { strength: bad ? "none" : (gate.strength ?? "refuse"), by, where: `${by} at ${gate.at}`, notes });
+            }
+            else {
+                item.notes.push(...notes.map((n) => `also ${n}`));
+            }
+        }
+    }
+    for (const node of ast.nodes) {
+        if (node.type !== "gate")
+            continue;
+        const gate = node;
+        const item = gateItem(gate.id);
+        if (item.strength === "refuse" || item.strength === "none")
+            continue;
+        const afters = gateAnchors(gate, "after");
+        const befores = gateAnchors(gate, "before");
+        const edges = ast.edges.filter((e) => e.guard?.length && afters.includes(e.from) && befores.includes(e.to));
+        const why = [];
+        const credited = () => item.strength === "refuse";
+        for (const edge of edges) {
+            for (const g of edge.guard) {
+                const hook = hooksByName.get(g);
+                if (hook) {
+                    if (!hook.strength) {
+                        why.push(`its edge cites ${g}, but ${g} declares no strength`);
+                        continue;
+                    }
+                    if (!hookOnDisk(settings, hook)) {
+                        why.push(`its edge cites ${g}, but ${g} is not in .claude/settings.json`);
+                        continue;
+                    }
+                    if (hook.strength === "refuse" || hook.strength === "detect") {
+                        Object.assign(item, { strength: hook.strength, by: "hook", where: `${hook.on}${hook.matcher ? ` ${hook.matcher}` : ""} hook ${g}, cited on ${edge.from} -> ${edge.to}`, notes: ["cited, not proven", ...(hook.bypass ? [`bypass: ${hook.bypass}`] : [])] });
+                    }
+                }
+                else {
+                    const other = gateItem(g);
+                    if (other?.strength === "refuse")
+                        Object.assign(item, { strength: "refuse", by: "gate", where: `gate ${g}, cited on ${edge.from} -> ${edge.to}`, notes: [`as strong as gate ${g}`] });
+                }
+                if (credited())
+                    break;
+            }
+            if (credited())
+                break;
+        }
+        if (!credited() && why.length)
+            item.notes.push(...why);
+    }
+    for (const edge of ast.edges) {
+        if (!edge.strength)
+            continue;
+        items.push({
+            kind: "edge", id: `${edge.from} -> ${edge.to}`, strength: edge.strength, by: "prose", declared: true,
+            where: edge.at ? `as written, at ${edge.at}` : "as written in the flow",
+            notes: [`declared in the file${edge.strength === "none" ? ": nothing stops this step, and the file says so" : ""}`],
+        });
+    }
+    // A declared hook's settings entry is the topology's own, however its interpreter is spelled.
+    for (let i = unattributed.length - 1; i >= 0; i--) {
+        const u = unattributed[i];
+        if ((ast.hooks ?? []).some((h) => { const sc = runParts(h.run).script.replace(/^\.\//, ""); return !!sc && u.startsWith(claudeEvent(h.on)) && u.includes(sc); }))
+            unattributed.splice(i, 1);
+    }
+    const steps = items.filter((i) => i.kind === "gate" || i.kind === "human");
+    return {
+        items,
+        enforcement: { refuse: steps.filter((i) => i.strength === "refuse").length, of: steps.length },
+        missing: items.filter((i) => i.strength === "none" && !i.declared).length,
+        unattributed,
+        verifiedOn: VERIFIED_ON,
+    };
+}
+/** The report as terminal lines. */
+export function renderGuardReport(report) {
+    const label = (i) => `${i.kind === "permission" ? "" : i.kind + " "}${i.id}`;
+    const width = Math.max(10, ...report.items.map((i) => label(i).length));
+    const lines = [];
+    for (const i of report.items) {
+        lines.push(`  ${label(i).padEnd(width)}  ${i.strength.padEnd(6)}  by: ${i.by.padEnd(8)}  ${i.where}`);
+        for (const n of i.notes)
+            lines.push(`  ${"".padEnd(width)}  ${i.strength === "none" && !i.declared ? "✗" : "⚠"} ${n}`);
+    }
+    lines.push("");
+    lines.push(`enforcement: ${report.enforcement.refuse} of ${report.enforcement.of} steps refuse · checked against Claude Code ${report.verifiedOn}`);
+    if (report.unattributed.length) {
+        lines.push(`${report.unattributed.length} hook(s) in .claude/settings.json are not tied to any step here (hand-built guards?). They may refuse steps shown as hope or none. Declare them in hooks { } with a strength and cite them on the edge with [guard: name]:`);
+        for (const u of report.unattributed)
+            lines.push(`  ${u.length > 110 ? u.slice(0, 107) + "..." : u}`);
+    }
+    if (report.missing)
+        lines.push(`${report.missing} item(s) are missing or their citation no longer holds: rerun scaffold, fix the citation, or fix the project by hand`);
+    return lines;
+}
+//# sourceMappingURL=check.js.map

package/dist/guard/check.js.map

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

package/dist/guard/target.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `agentopology guard <file> --target claude-code`: write the guard part of
+ * what scaffold writes, and nothing else, into a project that may have been
+ * built by hand.
+ *
+ * Why it exists: scaffold owns a whole project; a hand-built one has its own
+ * agents, skills and settings, and only lacks the hooks that refuse. Running
+ * scaffold there meant either every generated file next to the user's or none.
+ * This writes the enforcement and leaves the rest.
+ *
+ * The set is discovered, not listed: the scripts settings.json hook commands
+ * run, then every generated file those scripts name by `$CLAUDE_PROJECT_DIR/…`
+ * (the gate wrappers, then the check scripts the gates run). A hard-coded
+ * list went stale the first time the binding added a hook script.
+ *
+ * @module
+ */
+import type { TopologyAST } from "../parser/ast.js";
+import type { GeneratedFile } from "../bindings/types.js";
+import { type ExecuteResult } from "../scaffold/incremental.js";
+import type { FileAction } from "../scaffold/types.js";
+/** The guard subset of a binding's output: hook scripts, gates, checks, and settings.json cut to hooks and permissions. */
+export declare function guardFiles(files: GeneratedFile[]): GeneratedFile[];
+export interface GuardTargetPlan {
+    /** What would be written, per file. */
+    actions: FileAction[];
+    /** Files left as they are, and why. */
+    skipped: Array<{
+        path: string;
+        why: string;
+    }>;
+    /** The files this run owns (the subset of scaffold's output). */
+    files: GeneratedFile[];
+    /** Check scripts, reached through a gate, among `files`. */
+    checks: Set<string>;
+}
+/** Plan the guard write for a project. Reads the disk; writes nothing. */
+export declare function planGuardTarget(ast: TopologyAST, root: string, source: string): GuardTargetPlan;
+/**
+ * Write a plan and record it in the scaffold manifest. The manifest keeps the
+ * entries of files this run did not touch (a full scaffold's agents, say), so
+ * a later scaffold still knows what it owns. Nothing is pruned.
+ */
+export declare function applyGuardTarget(plan: GuardTargetPlan, root: string, source: string, sourceText: string): ExecuteResult;
+//# sourceMappingURL=target.d.ts.map

package/dist/guard/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/guard/target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAA6D,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3H,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAC;AAwCzE,2HAA2H;AAC3H,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAElE;AAkCD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,iEAAiE;IACjE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,4DAA4D;IAC5D,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CA2B/F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAcvH"}

package/dist/guard/target.js

@@ -0,0 +1,168 @@
+/**
+ * `agentopology guard <file> --target claude-code`: write the guard part of
+ * what scaffold writes, and nothing else, into a project that may have been
+ * built by hand.
+ *
+ * Why it exists: scaffold owns a whole project; a hand-built one has its own
+ * agents, skills and settings, and only lacks the hooks that refuse. Running
+ * scaffold there meant either every generated file next to the user's or none.
+ * This writes the enforcement and leaves the rest.
+ *
+ * The set is discovered, not listed: the scripts settings.json hook commands
+ * run, then every generated file those scripts name by `$CLAUDE_PROJECT_DIR/…`
+ * (the gate wrappers, then the check scripts the gates run). A hard-coded
+ * list went stale the first time the binding added a hook script.
+ *
+ * @module
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { claudeCodeBinding } from "../bindings/claude-code.js";
+import { isStubContent } from "../bindings/lib/stub.js";
+import { readManifest, writeManifest, hashContent } from "../scaffold/manifest.js";
+import { computeIncrementalPlan, executeActions, nextManifestFiles } from "../scaffold/incremental.js";
+const SETTINGS = ".claude/settings.json";
+const VAR_PATH = /\$\{?([A-Za-z_]\w*)\}?\/([^\s"'`;|&)]+)/g;
+/**
+ * The generated paths a piece of text names: `$CLAUDE_PROJECT_DIR/<path>`, or
+ * `$VAR/<file>` where the text sets `VAR="<dir>"` itself. before-agent.sh calls
+ * its gates as `"$DIR/gate-x.sh"` with `DIR=".claude/skills/…/scripts"`; reading
+ * only the project-dir form missed every gate (the first run of N41).
+ */
+function refs(text, known) {
+    const vars = new Map([["CLAUDE_PROJECT_DIR", ""]]);
+    for (const m of text.matchAll(/^\s*(?:export\s+)?([A-Za-z_]\w*)=["']?([^"'\n]*?)["']?\s*$/gm))
+        vars.set(m[1], m[2].replace(/^\.\//, "").replace(/\/$/, ""));
+    const out = [];
+    for (const m of text.matchAll(VAR_PATH)) {
+        const dir = vars.get(m[1]);
+        if (dir === undefined)
+            continue;
+        const p = (dir ? `${dir}/` : "") + m[2].replace(/^\.\//, "");
+        if (known.has(p))
+            out.push(p);
+    }
+    return out;
+}
+/** `hooks` keeps only command groups (a prompt or http hook names no script and could not be told apart on a rerun); `permissions` whole. */
+function guardSettings(raw) {
+    const s = JSON.parse(raw);
+    const hooks = {};
+    for (const [event, groups] of Object.entries(s.hooks ?? {})) {
+        const kept = groups
+            .map((g) => ({ ...g, hooks: (g.hooks ?? []).filter((h) => typeof h.command === "string") }))
+            .filter((g) => g.hooks.length > 0);
+        if (kept.length > 0)
+            hooks[event] = kept;
+    }
+    const out = {};
+    if (Object.keys(hooks).length > 0)
+        out.hooks = hooks;
+    if (s.permissions !== undefined)
+        out.permissions = s.permissions;
+    return JSON.stringify(out, null, 2) + "\n";
+}
+/** The guard subset of a binding's output: hook scripts, gates, checks, and settings.json cut to hooks and permissions. */
+export function guardFiles(files) {
+    return discover(files).files;
+}
+/** `checks` are the files two calls from a hook (the checks the gates run), for the "no longer a stub" rule. */
+function discover(files) {
+    const byPath = new Map(files.map((f) => [f.path, f]));
+    const known = new Set(byPath.keys());
+    const settings = byPath.get(SETTINGS);
+    const picked = new Map();
+    const checks = new Set();
+    const queue = [];
+    if (settings) {
+        const hooks = JSON.parse(settings.content).hooks ?? {};
+        for (const groups of Object.values(hooks))
+            for (const g of groups)
+                for (const h of g.hooks ?? [])
+                    if (h.command)
+                        queue.push(...refs(h.command, known));
+    }
+    // depth 0: scripts hooks run; 1: gate wrappers they call; 2+: the checks the gates run
+    const depth = new Map(queue.map((p) => [p, 0]));
+    while (queue.length > 0) {
+        const p = queue.shift();
+        if (picked.has(p))
+            continue;
+        const f = byPath.get(p);
+        picked.set(p, f);
+        for (const r of refs(f.content, known)) {
+            if (r === p)
+                continue;
+            if (!depth.has(r))
+                depth.set(r, depth.get(p) + 1);
+            queue.push(r);
+        }
+    }
+    for (const [p, d] of depth)
+        if (d >= 2)
+            checks.add(p);
+    const out = [...picked.values()];
+    if (settings)
+        out.push({ ...settings, content: guardSettings(settings.content) });
+    return { files: out, checks };
+}
+/** Plan the guard write for a project. Reads the disk; writes nothing. */
+export function planGuardTarget(ast, root, source) {
+    const { files, checks } = discover(claudeCodeBinding.scaffold(ast));
+    const manifest = readManifest(root, "claude-code", source);
+    const owned = new Set(files.map((f) => f.path));
+    // The planner deletes manifest files the run no longer generates; this run
+    // generates a subset on purpose, so only its own paths are planned.
+    const actions = computeIncrementalPlan(root, "claude-code", files, manifest).filter((a) => owned.has(a.path));
+    const skipped = [];
+    const planned = [];
+    for (const a of actions) {
+        const abs = join(root, a.path);
+        const generated = files.find((f) => f.path === a.path);
+        // A check someone has implemented is theirs, even when scaffold recorded
+        // its stub: the hash then differs from the manifest only by their work.
+        if (checks.has(a.path) && existsSync(abs) && a.type !== "unchanged") {
+            const onDisk = readFileSync(abs, "utf-8");
+            if (onDisk !== generated.content && !isStubContent(onDisk)) {
+                skipped.push({ path: a.path, why: "skipped: no longer a stub" });
+                continue;
+            }
+        }
+        if (a.type === "conflict") {
+            skipped.push({ path: a.path, why: `kept: ${a.detail}` });
+            continue;
+        }
+        if (a.type === "kept") {
+            skipped.push({ path: a.path, why: `kept: ${a.detail}` });
+            continue;
+        }
+        if (a.type === "blocked" && !a.unsafe) {
+            skipped.push({ path: a.path, why: `blocked: ${a.detail}` });
+            continue;
+        }
+        planned.push(a);
+    }
+    return { actions: planned, skipped, files, checks };
+}
+/**
+ * Write a plan and record it in the scaffold manifest. The manifest keeps the
+ * entries of files this run did not touch (a full scaffold's agents, say), so
+ * a later scaffold still knows what it owns. Nothing is pruned.
+ */
+export function applyGuardTarget(plan, root, source, sourceText) {
+    const previous = readManifest(root, "claude-code", source);
+    const result = executeActions(root, plan.actions, { prune: false, force: false });
+    const manifest = {
+        source,
+        sourceHash: hashContent(sourceText),
+        target: "claude-code",
+        generatedAt: new Date().toISOString(),
+        files: { ...(previous?.files ?? {}), ...nextManifestFiles(root, plan.actions, plan.files, previous, result) },
+    };
+    // A timestamp alone is not a change: a rerun that did nothing writes nothing.
+    const same = previous && previous.sourceHash === manifest.sourceHash && JSON.stringify(previous.files) === JSON.stringify(manifest.files);
+    if (!same)
+        writeManifest(root, "claude-code", manifest);
+    return result;
+}
+//# sourceMappingURL=target.js.map

package/dist/guard/target.js.map

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