@mobrienv/autoloop 0.1.2

package/dist/topology.js.map

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

package/dist/usage.d.ts

@@ -0,0 +1,8 @@
+export declare function printUsage(): void;
+export declare function printRunUsage(): void;
+export declare function printEmitUsage(): void;
+export declare function printInspectUsage(): void;
+export declare function printMemoryUsage(): void;
+export declare function printMemoryAddUsage(): void;
+export declare function missingPresetError(): void;
+export declare function unknownPresetError(name: string): void;

package/dist/usage.js

@@ -0,0 +1,114 @@
+import { joinCsv } from "./utils.js";
+import * as chains from "./chains.js";
+export function printUsage() {
+    console.log("autoloop — autonomous LLM loop harness");
+    console.log("");
+    console.log("Usage:");
+    console.log("  autoloop run <preset-name|preset-dir> [prompt...] [flags]");
+    console.log("  autoloop emit <topic> [summary]");
+    console.log("  autoloop inspect <artifact> [selector] [project-dir] [--format <md|terminal|text|json|csv>]");
+    console.log("  autoloop memory <list|add|remove> [args]");
+    console.log("  autoloop list");
+    console.log("  autoloop loops [--all]");
+    console.log("  autoloop loops show <run-id>");
+    console.log("  autoloop loops artifacts <run-id>");
+    console.log("  autoloop loops watch <run-id>");
+    console.log("  autoloop loops health [--verbose]");
+    console.log("  autoloop chain <list|run> [args]");
+    console.log("");
+    console.log("The preset argument is required for `run`. It must be a bundled preset");
+    console.log("name (e.g. autocode, autoqa) or a path to a directory containing");
+    console.log("autoloops.toml. Use `.` to run from the current directory.");
+    console.log("");
+    console.log("Flags:");
+    console.log("  -h, --help       Show this help");
+    console.log("  -v, --verbose    Set log level to debug");
+    console.log("  -b, --backend    Override backend command");
+    console.log("  -p, --preset     Resolve a bundled preset name or custom preset dir");
+    console.log("  --chain          Run an inline chain (comma-separated presets)");
+}
+export function printRunUsage() {
+    console.log("Usage: autoloop run <preset-name|preset-dir> [prompt...] [flags]");
+    console.log("");
+    console.log("The preset argument is required. It must be a bundled preset name");
+    console.log("(e.g. autocode, autoqa) or a path to a directory containing");
+    console.log("autoloops.toml. Use `.` to run from the current directory.");
+    console.log("");
+    console.log("Flags:");
+    console.log("  -h, --help       Show this help");
+    console.log("  -v, --verbose    Set log level to debug");
+    console.log("  -b, --backend    Override backend command");
+    console.log("  -p, --preset     Resolve a bundled preset name or custom preset dir");
+    console.log("  --chain          Run an inline chain (comma-separated presets)");
+    console.log("");
+    console.log("Examples:");
+    console.log("  autoloop run autocode");
+    console.log('  autoloop run autocode "Fix the login bug"');
+    console.log('  autoloop run presets/autoqa "QA recent changes"');
+    console.log('  autoloop run . "Run from current directory"');
+    console.log("");
+    console.log("Run 'autoloop list' to see all available presets.");
+}
+export function printEmitUsage() {
+    console.log("Usage:");
+    console.log("  autoloop emit <topic> [summary]");
+}
+export function printInspectUsage() {
+    console.log("Usage:");
+    console.log("  autoloop inspect <artifact> [selector] [project-dir] [--format <md|terminal|text|json|csv>]");
+    console.log("");
+    console.log("Defaults when --format is omitted:");
+    console.log("  scratchpad, prompt, memory, coordination, chain, metrics -> terminal");
+    console.log("  output -> text");
+    console.log("  journal -> json");
+    console.log("");
+    console.log("Artifacts:");
+    console.log("  scratchpad, prompt, output, journal, memory, coordination, chain, metrics");
+}
+export function printMemoryUsage() {
+    console.log("Usage:");
+    console.log("  autoloop memory list [project-dir]");
+    console.log("  autoloop memory status [project-dir]");
+    console.log("  autoloop memory find <pattern...>");
+    console.log("  autoloop memory add learning <text...>");
+    console.log("  autoloop memory add preference <category> <text...>");
+    console.log("  autoloop memory add meta <key> <value...>");
+    console.log("  autoloop memory remove <id> [reason...]");
+}
+export function printMemoryAddUsage() {
+    console.log("Usage:");
+    console.log("  autoloop memory add learning <text...>");
+    console.log("  autoloop memory add preference <category> <text...>");
+    console.log("  autoloop memory add meta <key> <value...>");
+    console.log("");
+    console.log("Memory helpers:");
+    console.log("  autoloop memory status [project-dir]");
+    console.log("  autoloop memory find <pattern...>");
+    console.log("  autoloop memory remove <id> [reason...]");
+}
+export function missingPresetError() {
+    console.log("error: missing required preset argument");
+    console.log("");
+    console.log("Usage: autoloop run <preset-name|preset-dir> [prompt...] [flags]");
+    console.log("");
+    console.log("Examples:");
+    console.log("  autoloop run autocode");
+    console.log('  autoloop run autocode "Fix the login bug"');
+    console.log('  autoloop run presets/autoqa "QA recent changes"');
+    console.log('  autoloop run . "Run from current directory"');
+    console.log("");
+    console.log("Run 'autoloop list' to see all available presets.");
+}
+export function unknownPresetError(name) {
+    console.log("error: preset `" + name + "` not found");
+    console.log("");
+    console.log("The argument `" + name + "` is not a valid preset name or directory.");
+    console.log("A preset must be a directory containing autoloops.toml (or autoloops.conf),");
+    console.log("or a bundled preset name.");
+    console.log("");
+    console.log("Available presets: " + joinCsv(chains.listKnownPresets()));
+    console.log("Run 'autoloop list' to see all available presets.");
+    console.log("");
+    console.log("Usage: autoloop run <preset-name|preset-dir> [prompt...] [flags]");
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,15 @@
+export declare function listContains(list: string[], needle: string): boolean;
+export declare function listText(list: string[]): string;
+export declare function splitCsv(text: string): string[];
+export declare function parseStringList(value: string): string[];
+export declare function joinCsv(items: string[]): string;
+export declare function lineSep(): string;
+export declare function joinLines(lines: string[]): string;
+export declare function nonemptyOr(value: string, fallback: string): string;
+export declare function shellQuote(text: string): string;
+export declare function replaceAll(text: string, pattern: string, replacement: string): string;
+export declare function shellWords(parts: string[]): string;
+export declare function stripQuotes(value: string): string;
+export declare function isQuoted(value: string): boolean;
+export declare function sliceOuter(text: string): string;
+export declare function generateCompactId(prefix: string): string;

package/dist/utils.js

@@ -0,0 +1,79 @@
+import { randomBytes } from "node:crypto";
+export function listContains(list, needle) {
+    return list.includes(needle);
+}
+export function listText(list) {
+    if (list.length === 0)
+        return "(none)";
+    return list.join(", ");
+}
+export function splitCsv(text) {
+    return text
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s !== "");
+}
+export function parseStringList(value) {
+    return parseStringListCsv(value.trim());
+}
+function parseStringListCsv(value) {
+    if (value.startsWith("[") && value.endsWith("]")) {
+        return parseStringListCsv(sliceOuter(value).trim());
+    }
+    return value
+        .split(",")
+        .map((s) => stripQuotes(s.trim()))
+        .filter((s) => s !== "");
+}
+export function joinCsv(items) {
+    return items.join(",");
+}
+export function lineSep() {
+    return "\n";
+}
+export function joinLines(lines) {
+    return lines.join(lineSep());
+}
+export function nonemptyOr(value, fallback) {
+    return value === "" ? fallback : value;
+}
+export function shellQuote(text) {
+    return "'" + replaceAll(text, "'", "'\"'\"'") + "'";
+}
+export function replaceAll(text, pattern, replacement) {
+    return text.split(pattern).join(replacement);
+}
+export function shellWords(parts) {
+    return parts.map(shellQuote).join(" ");
+}
+export function stripQuotes(value) {
+    return isQuoted(value) ? sliceOuter(value) : value;
+}
+export function isQuoted(value) {
+    return (value.startsWith('"') && value.endsWith('"') && value.length >= 2);
+}
+export function sliceOuter(text) {
+    return text.slice(1, -1);
+}
+export function generateCompactId(prefix) {
+    const ts = Date.now();
+    const encoded = intToBase36(ts);
+    const suffix = randomSuffix();
+    return `${prefix}-${encoded}-${suffix}`;
+}
+function randomSuffix() {
+    return randomBytes(16).toString("hex").slice(0, 4).toLowerCase();
+}
+function intToBase36(n) {
+    if (n === 0)
+        return "0";
+    const chars = "0123456789abcdefghijklmnopqrstuvwxyz";
+    let result = "";
+    let val = n;
+    while (val > 0) {
+        result = chars[val % 36] + result;
+        val = Math.floor(val / 36);
+    }
+    return result;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@mobrienv/autoloop",
+  "version": "0.1.2",
+  "description": "Autonomous LLM loop harness and control plane for long-horizon autonomous work",
+  "type": "module",
+  "main": "dist/main.js",
+  "bin": {
+    "autoloop": "bin/autoloop"
+  },
+  "files": [
+    "bin/autoloop",
+    "dist",
+    "presets",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikeyobrien/autoloop.git"
+  },
+  "homepage": "https://github.com/mikeyobrien/autoloop#readme",
+  "bugs": {
+    "url": "https://github.com/mikeyobrien/autoloop/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "autonomous",
+    "cli",
+    "loops",
+    "orchestration"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/.bin/vitest run",
+    "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5"
+  }
+}

package/presets/autocode/README.md

@@ -0,0 +1,81 @@
+# Autocode miniloop
+
+An autoloop-native port of Ralph's code-assist/autocode loop.
+
+Shape:
+- planner
+- builder
+- critic
+- finalizer
+
+Shared state lives in project files plus the autoloops journal. One active step is tracked in `.autoloop/progress.md`.
+
+## Fail-closed contract
+
+Autocode is not an approval machine.
+
+- Planner decomposes work into the next smallest slice.
+- Builder implements and proves the slice.
+- Critic tries to break the slice, including independently running a manual smoke test that exercises the builder's changed code path whenever a practical manual surface is available, and rejects on missing evidence.
+- Finalizer tries to prove the whole task is still incomplete before allowing completion.
+
+Success is evidence-based, not prose-based. Only the finalizer may emit `task.complete`.
+
+## Files
+
+- `autoloops.toml` — loop + backend config
+- `topology.toml` — role deck + handoff graph
+- `harness.md` — shared harness rules loaded every iteration
+- `roles/planner.md`
+- `roles/build.md`
+- `roles/critic.md`
+- `roles/finalizer.md`
+
+## Shared working files created by the loop
+
+The planner is expected to create and maintain:
+- `.autoloop/context.md`
+- `.autoloop/plan.md`
+- `.autoloop/progress.md`
+- `.autoloop/logs/`
+
+## Backend
+
+This preset assumes the built-in Pi adapter:
+
+```toml
+backend.kind = "pi"
+backend.command = "pi"
+```
+
+Pi is the only supported real adapter path here.
+
+For deterministic local harness debugging only, switch to the repo mock backend:
+
+```toml
+backend.kind = "command"
+backend.command = "../../examples/mock-backend.sh"
+```
+
+## Run
+
+From this repo root:
+
+```bash
+autoloop run autocode "Add a --verbose flag to the CLI"
+```
+
+For a one-off Claude dogfood run without editing config:
+
+```bash
+autoloop -b claude -p autocode "Add a --verbose flag to the CLI"
+```
+
+## Intended input styles
+
+The planner prompt supports the same three broad entry modes as Ralph's code-assist preset:
+- a rough implementation request
+- a single `.code-task.md` file path
+- an existing implementation/spec directory
+
+The planner must normalize that into the shared working files and then hand off one concrete next slice.

package/presets/autocode/autoloops.toml

@@ -0,0 +1,22 @@
+event_loop.max_iterations = 100
+event_loop.completion_event = "task.complete"
+event_loop.completion_promise = "LOOP_COMPLETE"
+# Require the critic and finalizer gates before completion is considered valid.
+event_loop.required_events = ["review.passed"]
+
+backend.kind = "command"
+backend.command = "/Users/rook/.npm-global/bin/claude"
+backend.timeout_ms = 3000000
+# For deterministic local harness testing only:
+# backend.kind = "command"
+# backend.command = "../../examples/mock-backend.sh"
+
+review.enabled = true
+review.timeout_ms = 300000
+
+memory.prompt_budget_chars = 8000
+harness.instructions_file = "harness.md"
+
+core.state_dir = ".autoloop"
+core.journal_file = ".autoloop/journal.jsonl"
+core.memory_file = ".autoloop/memory.jsonl"

package/presets/autocode/harness.md

@@ -0,0 +1,19 @@
+This project is a autoloops-native port of Ralph's code-assist/autocode preset.
+
+Global rules:
+- Shared working files are the source of truth: `.autoloop/context.md`, `.autoloop/plan.md`, `.autoloop/progress.md`, and `.autoloop/logs/`.
+- Keep only one concrete slice active at a time.
+- Use the event tool instead of prose-only handoffs.
+- Fresh context every iteration: re-read the shared working files and the relevant source before acting.
+- Prefer small, verifiable changes.
+- Verification is mandatory before `review.ready`, `review.passed`, or `task.complete`.
+- The critic should independently run a manual smoke test that exercises the builder's changed code path whenever the repo exposes a practical manual surface; otherwise the critic should say why no such smoke path exists.
+- Missing evidence means no success. No role may treat another role's assertion as proof.
+- Every success handoff should cite exact files changed, exact verification command(s), and commit hash when applicable.
+- After a slice is implemented and verified, commit it before `review.ready` or any later handoff. Every completed slice should land as its own commit. Avoid carrying verified but uncommitted work into the next iteration.
+- Do not dismiss a relevant issue as merely pre-existing. If it matters to the current objective, touched surface, or verification path, you must fix it now, make it the next slice, explicitly defer it with rationale in `.autoloop/progress.md`, or prove it is out of scope.
+- Maintain a `Relevant Issues` section in `.autoloop/progress.md`. Every relevant issue must have an explicit disposition: `fix-now`, `fix-next`, `deferred`, or `out-of-scope`.
+- Use `./.autoloop/autoloops memory add learning ...` for durable repo/process learnings.
+- Do not invent extra phases. Stay inside planner → builder → critic → finalizer.
+- Only the finalizer may emit `task.complete`.
+- If the prompt is a path to a `.code-task.md` file or an existing implementation directory, use that as source material instead of treating it like plain prose.

package/presets/autocode/miniloops.toml

@@ -0,0 +1,22 @@
+event_loop.max_iterations = 100
+event_loop.completion_event = "task.complete"
+event_loop.completion_promise = "LOOP_COMPLETE"
+# Require the critic and finalizer gates before completion is considered valid.
+event_loop.required_events = ["review.passed"]
+
+backend.kind = "pi"
+backend.command = "pi"
+backend.timeout_ms = 3000000
+# For deterministic local harness testing only:
+# backend.kind = "command"
+# backend.command = "../../examples/mock-backend.sh"
+
+review.enabled = true
+review.timeout_ms = 300000
+
+memory.prompt_budget_chars = 8000
+harness.instructions_file = "harness.md"
+
+core.state_dir = ".miniloop"
+core.journal_file = ".miniloop/journal.jsonl"
+core.memory_file = ".miniloop/memory.jsonl"

package/presets/autocode/roles/build.md

@@ -0,0 +1,33 @@
+You are the builder.
+
+Implement exactly the active slice from the latest `tasks.ready` handoff.
+
+On every activation:
+- Re-read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md`.
+- Re-read the source files named in the current slice.
+- Update `.autoloop/progress.md` with what you are doing and how you will verify it.
+
+Process:
+1. Understand the active slice and its acceptance criteria.
+2. Prefer test-first work when the repo has a test harness for the area.
+3. Make the smallest code change that satisfies the slice.
+4. Run the strongest focused verification you can for that slice.
+5. Commit the completed slice before handoff. Each completed slice should land as its own commit.
+6. Record concise evidence in `.autoloop/progress.md` and longer output in `.autoloop/logs/` when useful, including the commit hash when available.
+7. Emit `review.ready` with:
+   - what changed
+   - what was verified
+   - the slice commit hash
+   - any known risk or uncertainty
+
+If blocked:
+- Record the reason in `.autoloop/progress.md`.
+- Emit `build.blocked` with a concrete blocker and the safest next planning move.
+
+Rules:
+- One slice per turn.
+- No opportunistic side quests.
+- No final completion decisions.
+- No fake verification.
+- Do not emit `review.ready` for an uncommitted completed slice.
+- If confidence is shaky, choose the narrower, more reversible change and document why.

package/presets/autocode/roles/critic.md

@@ -0,0 +1,40 @@
+You are the critic.
+
+You are not the builder. Fresh eyes matter.
+
+Your job is to challenge the latest increment and try to prove it is not ready.
+
+On activation:
+- Re-read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md`.
+- Inspect the changed files and the builder's stated verification.
+- Re-run the strongest relevant checks yourself when possible.
+- Run at least one manual smoke test that actually exercises the builder's changed code path whenever the repo exposes a practical manual surface (for example an existing smoke script, CLI invocation, dev server flow, or reproducible app path). Run it yourself instead of relying only on the builder's checks. If no practical manual smoke path exists, say that explicitly.
+- Treat the builder's summary as a hint, not proof.
+
+Review checklist:
+- Did the builder actually satisfy the active slice?
+- Did they silently skip an obvious edge case or acceptance criterion?
+- Is there needless complexity or speculative work?
+- Does the code fit the surrounding repo style?
+- Did the claimed verification really cover the change?
+- Did you run your own manual smoke test that exercised the builder's changed code path when a practical manual path existed?
+- Can you independently validate the claim from code plus evidence?
+- Is the verified slice committed, with `git status --short` clean except for intentional unrelated files?
+- Were all relevant issues discovered during the slice given an explicit disposition in `.autoloop/progress.md`?
+- Did anyone try to dismiss a relevant issue just because it was pre-existing?
+
+Emit (only these two events — never emit builder events like `review.ready` or `build.blocked`):
+- `review.rejected` when there is a concrete miss, bug, regression risk, failed verification, untested acceptance criterion, overbuilt solution worth fixing now, verified-but-uncommitted work that should be committed before handoff, or any relevant issue that was left unowned / untracked / ambiguously deferred.
+- `review.passed` only when the current slice survives skeptical review, the verified slice is committed, and all relevant issues have explicit ownership or disposition.
+
+Rules:
+- Default to rejection when evidence is incomplete.
+- Be concrete, not vague.
+- Prefer one strong objection over a pile of weak ones.
+- Do not rewrite the whole solution unless the current slice is fundamentally wrong.
+- Do not approve with "fix later" caveats.
+- If checks passed but the builder left the repo dirty, require a commit before `review.passed`.
+- Reject any slice that mentions or reveals a relevant issue without recording whether it is `fix-now`, `fix-next`, `deferred`, or `out-of-scope`.
+- `pre-existing` is never by itself a valid reason to ignore a relevant issue.
+- If you cannot independently validate the builder's claim from code plus evidence, reject.
+- If the changed code had a practical manual execution path and you did not run it yourself, treat the evidence as incomplete and reject. If no such path existed, say that explicitly.

package/presets/autocode/roles/finalizer.md

@@ -0,0 +1,43 @@
+You are the finalizer.
+
+You are the last gate before loop completion.
+
+Your job is not just to ask whether the latest diff is okay.
+Your job is to decide whether the whole requested outcome is complete or whether the loop should continue.
+
+On activation:
+- Re-read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md`.
+- Reconcile the latest reviewed slice against the whole request.
+- Check whether the numbered plan still has unfinished steps.
+- Check whether the current step is truly exhausted.
+- Run the strongest end-to-end verification you can for the whole visible outcome.
+- Build an explicit completion checklist before deciding.
+
+Emit (only these three events — never emit critic events like `review.passed` or `review.rejected`):
+- `queue.advance` if the latest slice passed review but more planned work remains or whole-task proof is still incomplete.
+- `finalization.failed` if the latest slice is not good enough or whole-task consistency is still broken.
+- `task.complete` only when:
+  - the requested outcome is satisfied,
+  - the numbered plan is complete,
+  - no obvious missing slice remains,
+  - the strongest available verification passed,
+  - the repo is in a clean committed state for the accepted work,
+  - and no relevant issue remains unowned, ambiguously deferred, or hand-waved as pre-existing.
+
+Required completion checklist:
+- requested outcome satisfied
+- numbered plan complete
+- end-to-end verification recorded
+- accepted work committed
+- repo clean
+- remaining issues all explicitly dispositioned
+
+Rules:
+- Be stricter than the critic about whole-task completeness.
+- Prefer one more loop over premature completion.
+- Do not invent new requirements.
+- Do not use `task.complete` just because one small slice passed review.
+- If the work is done but the accepted changes are still uncommitted, commit them before `task.complete`.
+- Do not allow `task.complete` while `.autoloop/progress.md` still contains a relevant issue with no clear disposition or owner.
+- `pre-existing` is not a valid completion rationale for a relevant issue.
+- Missing evidence means no completion.

package/presets/autocode/roles/planner.md

@@ -0,0 +1,40 @@
+You are the planner.
+
+Do not implement. Do not review.
+
+Your job:
+1. Normalize the user's request into shared working files.
+2. Decide the next smallest meaningful slice.
+3. Hand exactly one concrete slice to the builder.
+
+On every activation:
+- Read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md` if they exist.
+- If the objective text points at a `.code-task.md` file, read it.
+- If the objective text points at an existing implementation/spec directory, inspect that directory.
+- Re-read the latest scratchpad/journal context before deciding the next slice.
+
+On first activation:
+- Create or refresh:
+  - `.autoloop/context.md` — request summary, source type, constraints, repo patterns, acceptance criteria
+  - `.autoloop/plan.md` — numbered high-level steps, not a blob checklist
+  - `.autoloop/progress.md` — current step, active slice, verification notes, completed steps
+  - `.autoloop/logs/` directory if useful
+- Choose only Step 1's current slice.
+- Emit `tasks.ready` with a payload that includes:
+  - current step
+  - active slice
+  - files likely to change
+  - verification target
+
+On later activations (`queue.advance` or `build.blocked`):
+- Re-read the shared working files.
+- If the current step still has unfinished work, hand the next smallest slice in the same step.
+- If the current step is complete, mark it complete in `.autoloop/progress.md`, advance to the next numbered step, and emit the next `tasks.ready`.
+- Planner never emits completion. If the plan appears done, leave that proof to the critic/finalizer path instead of self-certifying success.
+
+Rules:
+- One active slice only.
+- Be specific enough that the builder can act without guessing.
+- Prefer vertical slices over broad refactors.
+- Do not create future-step work early just because you can imagine it.
+- Do not treat another role's summary as proof. The slice should be defined so later roles can reject it from concrete evidence.

package/presets/autocode/topology.toml

@@ -0,0 +1,32 @@
+name = "autocode"
+completion = "task.complete"
+
+[[role]]
+id = "planner"
+emits = ["tasks.ready"]
+prompt_file = "roles/planner.md"
+
+[[role]]
+id = "builder"
+emits = ["review.ready", "build.blocked"]
+prompt_file = "roles/build.md"
+
+[[role]]
+id = "critic"
+emits = ["review.passed", "review.rejected"]
+prompt_file = "roles/critic.md"
+
+[[role]]
+id = "finalizer"
+emits = ["queue.advance", "finalization.failed", "task.complete"]
+prompt_file = "roles/finalizer.md"
+
+[handoff]
+"loop.start" = ["planner"]
+"queue.advance" = ["planner"]
+"build.blocked" = ["planner"]
+"tasks.ready" = ["builder"]
+"review.ready" = ["critic"]
+"review.rejected" = ["builder"]
+"review.passed" = ["finalizer"]
+"finalization.failed" = ["builder"]