@slowcook-ai/cli 0.16.0-alpha.3 → 0.17.0-alpha.0

package/README.md

@@ -2,12 +2,22 @@
 
 CLI for the slowcook brewing harness. Installs the `slowcook` binary.
 
+> ⚠️ **Active development — expect breaking changes.** Slowcook is pre-1.0 and the architecture itself is iterating in public. The 0.15 line was scrapped mid-cut and replaced by today's 0.16 mock-app architecture. CLI commands, file layouts, prompt contracts, and the package surface can and will change between alpha versions.
+>
+> If you're adopting slowcook today: pin exact versions in your consumer (`.brewing/slowcook-cli-version`), read each release entry in [the changelog](https://github.com/aminazar/slowcook/blob/main/CHANGELOG.md) before bumping, and treat it as a partnership — feedback from real consumers is what drives the next cut.
+
 ## Install
 
 ```bash
+# Stable line (0.13.x today; story-flow + bug-flow + chef orchestrator)
 npm i -D @slowcook-ai/cli
+
+# 0.16 alpha track (singular mock app + element-anchored review)
+npm i -D @slowcook-ai/cli@alpha @slowcook-ai/mock-runtime@latest
 ```
 
+The `latest` tag points at the most recent stable cut; the `alpha` tag points at the in-progress 0.16 architecture. The two are NOT installable together — pick one per consumer.
+
 ## Commands (v0.4)
 
 ### `slowcook refine` (first agent)

package/dist/cli.js

@@ -9,6 +9,7 @@ import { refine } from "./commands/refine/index.js";
 import { onSpecMerged } from "./commands/on-spec-merged/index.js";
 import { onTestsMerged } from "./commands/on-tests-merged/index.js";
 import { onBrewMerged } from "./commands/on-brew-merged/index.js";
+import { onMockupApproved } from "./commands/on-mockup-approved/index.js";
 import { testgen } from "./commands/testgen/index.js";
 import { investigate } from "./commands/investigate/index.js";
 import { recipeRegression } from "./commands/recipe-regression/index.js";
@@ -20,6 +21,11 @@ import { map } from "./commands/map/index.js";
 import { extract } from "./commands/extract/index.js";
 import { vibe } from "./commands/vibe/index.js";
 import { plate } from "./commands/plate/index.js";
+import { port } from "./commands/port/index.js";
+import { preview } from "./commands/preview/index.js";
+import { check } from "./commands/check/index.js";
+import { recon } from "./commands/recon/index.js";
+import { runMock } from "./commands/run-mock/index.js";
 import { dispatch } from "./commands/dispatch/index.js";
 import { fixtures } from "./commands/fixtures/index.js";
 // Read VERSION from package.json at runtime so the CLI's self-reported
@@ -57,6 +63,10 @@ Usage:
   slowcook extract [--schema] [--tokens] [--cwd <path>]
   slowcook vibe --spec <id> [--cwd <path>] [--owner <login>] [--repo <name>] [--dry-run]
   slowcook plate --pr <number> [--cwd <path>] [--owner <login>] [--repo <name>] [--review-comment-id <id>]
+  slowcook port --story <id> [--cwd <path>] [--dry-run] [--force]
+  slowcook preview (deploy|teardown) --pr <number> [--ssh-key <path>] [--cwd <path>]
+  slowcook check mock-isolation [--cwd <path>]
+  slowcook run-mock <story-id> [--no-poll] [--poll-seconds <n>] [--branch <ref>]
   slowcook dispatch <step> [inputs...]
   slowcook fixtures check [--max-age-days <n>] [--story <id>]
   slowcook version
@@ -80,6 +90,10 @@ Commands available in ${VERSION}:
   extract            Brownfield extracts (schema.mmd, tokens.md) for refine/investigate context. Fast, no node_modules.
   vibe               (0.15-α.1) Design-first mockup generator. Reads spec + brownfield + code-map; emits runnable React mockup to slowcook/mockup/story-N PR.
   plate              (0.15-α.3) Mockup amendment agent. Triggered by /plate PR comments on slowcook-mockup PRs; force-pushes amendments.
+  port               (0.16-α.8) Deterministic mock/ → src/ copy. Walks mock/src/, applies useScenarioFixture → useDataDomain rewrite, prepends provenance header. Pre-brew CI step.
+  preview            (0.16-α.5) SSH preview deploy. \`deploy --pr N\`: build + run the mock app on the consumer's box; post URL to PR. \`teardown --pr N\`: stop + remove.
+  check              (0.16-α.13) Static structural checks. \`check mock-isolation\` verifies every import in mock/ stays inside mock/ (catches vibe-prompt slippage that breaks the mock-vs-prod separation rule).
+  run-mock           (0.16-α.17) One-command mock launch + auto-pull. \`run-mock <story>\`: checkout mockup branch, npm install in mock/, run next dev with overlay env vars, poll origin every 15s + git pull --ff-only on plate amendments.
   dispatch           Trigger a slowcook GitHub Actions workflow remotely (brew / testgen / refine).
 
 Coming in later versions:
@@ -112,6 +126,12 @@ async function main() {
         case "on-brew-merged":
             await onBrewMerged(args.slice(1));
             return;
+        case "on-mockup-approved":
+            // 0.16.0-α.23 — fires from the slowcook-mockup-approved.yml
+            // workflow on label-add. Posts a cost-rollup audit comment on
+            // the source issue (looked up via spec.source_issue).
+            await onMockupApproved(args.slice(1));
+            return;
         case "testgen":
         case "recipe":
             // 0.13.0-alpha.1 — `recipe` is the canonical name (kitchen
@@ -174,6 +194,35 @@ async function main() {
             // amends mockup files; force-pushes the same branch.
             await plate(args.slice(1), VERSION);
             return;
+        case "port":
+            // 0.16.0-α.8 — deterministic copy of mock/src/* → src/*.
+            // No LLM; same input → same output; auditable diff. Runs as a
+            // CI step before brew so brew's allowed-paths can shrink.
+            await port(args.slice(1), VERSION);
+            return;
+        case "preview":
+            // 0.16.0-α.5 — SSH preview deploy. Reads .brewing/preview.yaml,
+            // builds the consumer's mock app on their box, runs the docker
+            // container, posts the URL to the PR. teardown undoes it.
+            await preview(args.slice(1), VERSION);
+            return;
+        case "check":
+            // 0.16.0-α.13 — static structural checks. mock-isolation
+            // verifies vibe + plate keep mock/ self-contained.
+            await check(args.slice(1), VERSION);
+            return;
+        case "recon":
+            // 0.17.6 — pre-brew structural divergence check. Runs after
+            // both mockup PR + tests PR are merged; catches residual
+            // vibe ⇄ testgen divergence before brew burns tokens.
+            await recon(args.slice(1), VERSION);
+            return;
+        case "run-mock":
+            // 0.16.0-α.17 — one-command mock launch + auto-pull on plate
+            // amendments. Wraps git fetch/checkout + npm install + next dev
+            // + a 15s poll loop that pulls when origin moves.
+            await runMock(args.slice(1), VERSION);
+            return;
         case "dispatch":
             await dispatch(args.slice(1));
             return;

package/dist/cli.js.map

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

package/dist/commands/brew/agent.d.ts

@@ -1,7 +1,7 @@
 import Anthropic from "@anthropic-ai/sdk";
 import type { ForgeAdapter, Spec } from "@slowcook-ai/core";
 import { type StackConfig } from "@slowcook-ai/stack-ts";
-import { type HaltReport } from "./halt.js";
+import { type HaltReason, type HaltReport } from "./halt.js";
 /** ------------------------- Context + options ------------------------- */
 export interface BrewContext {
     repoRoot: string;
@@ -98,8 +98,32 @@ export declare function findHandler(repoRoot: string, method: string, path: stri
  * look inside a function body, it uses `read_file` normally.
  */
 export declare function outlineFile(pathHint: string, source: string): string;
+/**
+ * 0.16.0-α.30 — halt-envelope parser.
+ *
+ * The plate-mode prompt instructs the agent to halt by emitting an
+ * XML envelope in its text output:
+ *
+ *   <halt class="MOCKUP_DESIGN_CONFLICT">
+ *     <test>tests/integration/story-N-ui.test.tsx > "owner sees Pin"</test>
+ *     <conflict>The test asserts X but the mock renders Y.</conflict>
+ *     <recommendation>PM should /plate or /refine.</recommendation>
+ *   </halt>
+ *
+ * Without this parser, brew never recognises its own agent's halt
+ * envelopes. The agent's perfect classification gets converted to a
+ * generic AGENT_STALLED_NO_EDITS halt because brew only counts tool
+ * calls. Returns null when no envelope is found OR when the class
+ * isn't in the recognised whitelist (defensive against typos).
+ */
+type HaltEnvelope = {
+    class: HaltReason;
+    summary: string;
+};
+export declare function parseHaltEnvelope(rationale: string): HaltEnvelope | null;
 /** ------------------------- Entry helpers ------------------------- */
 export declare function readFrozenPaths(repoRoot: string): FrozenPaths;
 export declare function readStackConfig(repoRoot: string): StackConfig;
 export declare function loadSpec(repoRoot: string, storyId: string): Spec;
+export {};
 //# sourceMappingURL=agent.d.ts.map

package/dist/commands/brew/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/commands/brew/agent.ts"],"names":[],"mappings":"AAaA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAKL,KAAK,WAAW,EAIjB,MAAM,uBAAuB,CAAC;AAkB/B,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,WAAW,CAAC;AAWnB,4EAA4E;AAE5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uEAAuE;IACvE,WAAW,EAAE,WAAW,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,iEAAiE;AAEjE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAoD3C,wBAAsB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CA60BpE;AAoUD,sFAAsF;AAEtF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,iBAAiB,CA2CnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmDpE;AA+wBD,wEAAwE;AAExE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAe7D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAI7D;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhE"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/commands/brew/agent.ts"],"names":[],"mappings":"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"}

package/dist/commands/brew/agent.js

@@ -125,15 +125,29 @@ export async function runBrew(ctx) {
         : new Set();
     appendRunLog(ctx, `BASELINE_FULL  total=${fullBaseline.tests.length} green=${fullBaselineGreen.size} red=${fullBaseline.tests.length - fullBaselineGreen.size}`);
     if (!baseline.ran) {
-        return haltFor(ctx, {
-            reason: "TEST_RUNNER_BROKEN",
-            iterations: 0,
-            checkpoints: 0,
-            greenCount: 0,
-            totalCount: expectedTestIds.size,
-            spendUsd: 0,
-            summary: `Test runner failed to produce usable output on the baseline run. Error: ${baseline.error ?? "(unknown)"}. Fix the runner before brewing.`,
-        });
+        // 0.16.0-α.28 — partial-degradation: if SOME suites produced tests
+        // (e.g. backend vitest passed) but others failed (e.g. playwright
+        // acceptance crashed because Next webServer couldn't boot without
+        // .env.acceptance), proceed with what we got + log the degradation
+        // instead of halting TEST_RUNNER_BROKEN. Halt only when nothing ran.
+        if (baseline.tests.length === 0) {
+            return haltFor(ctx, {
+                reason: "TEST_RUNNER_BROKEN",
+                iterations: 0,
+                checkpoints: 0,
+                greenCount: 0,
+                totalCount: expectedTestIds.size,
+                spendUsd: 0,
+                summary: `Test runner failed to produce usable output on the baseline run. Error: ${baseline.error ?? "(unknown)"}. Fix the runner before brewing.`,
+            });
+        }
+        const failedSuiteNames = baseline.suites
+            .filter((s) => s.exit_code !== 0)
+            .map((s) => s.suite)
+            .join(", ") || "(unknown)";
+        console.log(`⚠ baseline DEGRADED — suite(s) "${failedSuiteNames}" couldn't boot; proceeding with ${baseline.tests.length} test(s) from suite(s) that did run.`);
+        console.log(`   degradation reason: ${(baseline.error ?? "").slice(0, 300)}`);
+        appendRunLog(ctx, `BASELINE_DEGRADED  failed_suites=${failedSuiteNames}  surviving_tests=${baseline.tests.length}  reason="${(baseline.error ?? "").slice(0, 200).replace(/"/g, "'")}"`);
     }
     // Fix 1 (0.7.14): keep a lookup of failure messages per test id so
     // each iteration's turn prompt can include the target test's failure
@@ -313,6 +327,28 @@ export async function runBrew(ctx) {
                 // successful turn — only the spend-delta on the NEXT iter's
                 // START line reveals tokens were burned.
                 appendRunLog(ctx, `ITER ${iteration} NO-EDITS  (agent made no tool calls this turn)  spend_delta=$${turnResult.spendDelta.toFixed(2)}  consecutive_no_edits=${consecutiveNoEdits}  stagnation=${stagnation}/${STAGNATION_CAP}`);
+                // 0.16.0-α.30: halt-envelope parser. The plate-mode prompt tells
+                // the agent to halt by emitting `<halt class="X">...</halt>` in
+                // its text. Without this parser, brew never reads its own agent's
+                // halt envelopes and falls through to AGENT_STALLED_NO_EDITS — the
+                // agent's perfect MOCKUP_DESIGN_CONFLICT classification gets
+                // converted to a generic stall (rewo PR #147 brew run 25278580747:
+                // agent emitted MOCKUP_DESIGN_CONFLICT envelope, brew reported
+                // AGENT_STALLED_NO_EDITS, $0.91 wasted on the misclassification).
+                const haltEnvelope = parseHaltEnvelope(turnResult.rationale);
+                if (haltEnvelope) {
+                    appendRunLog(ctx, `ITER ${iteration} ${haltEnvelope.class} — agent emitted halt envelope in rationale`);
+                    return haltFor(ctx, {
+                        reason: haltEnvelope.class,
+                        iterations: iteration,
+                        checkpoints: iterationLogs.filter((l) => l.outcome === "checkpoint").length,
+                        greenCount: greenSet.size,
+                        totalCount: expectedTestIds.size,
+                        spendUsd,
+                        iterationLogs,
+                        summary: haltEnvelope.summary,
+                    });
+                }
                 // Fix 3 (0.7.14): voluntary-halt escape hatch. If the agent's
                 // rationale ends with "Considering halting voluntarily" the model
                 // has self-reported that it can't make progress — halt immediately
@@ -381,14 +417,54 @@ export async function runBrew(ctx) {
                 appendRunLog(ctx, `ITER ${iteration} REJECT frozen-path  ${frozenHit}  (also touched ${diff.changedPaths.length - 1} other file(s))  spend_delta=$${turnResult.spendDelta.toFixed(2)}`);
                 continue;
             }
-            // 0.15.0-α.4 — plate-mode protects the mockup files. Even though
-            // `src/lib/data/` is in allowed_paths so the agent can swap stubs,
-            // `*.mock.ts` files inside that directory are plate's territory
-            // and must NOT be edited. Same hard-signal logic as frozen-paths.
+            // 0.16.0-α.29 — plate-mode contract refinement.
+            //
+            // Old contract ("don't touch the UI") was too rigid — the
+            // data-wiring IS in the component (handlers POST, hooks fetch,
+            // forms submit). Forbidding all UI edits forced brew to find
+            // nonexistent escape hatches and stalled (rewo PR #147 brew run
+            // 25278045422 — AGENT_STALLED_NO_EDITS at $1.82, agent correctly
+            // diagnosed it needed to wire POST /api/pins but the click handler
+            // lives in the ported component).
+            //
+            // New contract: "preserve UI shape, swap mock data for real data."
+            //
+            //   - Port-marked files (@slowcook-port-from) are the ONLY UI-tree
+            //     files brew is allowed to write — to wire real data + handlers
+            //     into the shape that vibe defined. Brew should preserve JSX
+            //     structure, props signature, className, layout. Tier-2
+            //     acceptance + visual regression are the backstop for shape
+            //     drift.
+            //
+            //   - .mock.ts files: still rejected (those are pre-port mock
+            //     fixtures with no behavior to wire).
+            //
+            //   - src/components/* and src/*.tsx WITHOUT the port marker:
+            //     consumer's hand-written prod UI. Off-limits in plate mode
+            //     (brew shouldn't touch UI it didn't get from vibe).
             const platePathHit = ctx.mode === "plate"
-                ? diff.changedPaths.find((p) => /\.mock\.ts$/.test(p) ||
-                    /^src\/components\//.test(p) ||
-                    /^src\/.*\.tsx$/.test(p))
+                ? diff.changedPaths.find((p) => {
+                    if (/\.mock\.ts$/.test(p))
+                        return true;
+                    // Marker check first — port-owned files are ALLOWED writes
+                    // under the new contract. Reading the working-tree version
+                    // because the agent's edit IS the working tree.
+                    try {
+                        const fullPath = join(ctx.repoRoot, p);
+                        if (existsSync(fullPath)) {
+                            const head = readFileSync(fullPath, "utf8").slice(0, 2048);
+                            if (head.includes("@slowcook-port-from"))
+                                return false;
+                        }
+                    }
+                    catch { /* ignore — fall through to path checks */ }
+                    // Hand-written UI (no marker) stays frozen.
+                    if (/^src\/components\//.test(p))
+                        return true;
+                    if (/^src\/.*\.tsx$/.test(p))
+                        return true;
+                    return false;
+                })
                 : null;
             if (platePathHit) {
                 revertToSnapshot(ctx, snapshot);
@@ -396,7 +472,7 @@ export async function runBrew(ctx) {
                     iteration,
                     target_test_id: currentTarget,
                     outcome: "rejected-frozen-path",
-                    note: `plate-mode protects UI: ${platePathHit}. Mockup files are owned by plate.`,
+                    note: `plate-mode protects hand-written UI: ${platePathHit}. Brew can only wire data into port-marked files (@slowcook-port-from) or write to src/lib/data + src/app/api + supabase/migrations.`,
                     files_touched: diff.changedPaths,
                     lines_added: diff.linesAdded,
                     lines_removed: diff.linesRemoved,
@@ -406,11 +482,11 @@ export async function runBrew(ctx) {
                 priorAttempts.push({
                     iteration,
                     outcome: "reverted-no-progress",
-                    note: `rejected: plate-mode wrote to mockup path ${platePathHit}. If your test requires this edit, halt with MOCKUP_DESIGN_CONFLICT instead.`,
+                    note: `rejected: plate-mode wrote to hand-written UI path ${platePathHit} (no @slowcook-port-from marker). If the test target requires editing this exact file, the vibe/recipe pair is mismatched — halt with MOCKUP_DESIGN_CONFLICT.`,
                     files_touched: diff.changedPaths,
                 });
                 stagnation += 1;
-                appendRunLog(ctx, `ITER ${iteration} REJECT plate-mockup-path  ${platePathHit}  spend_delta=$${turnResult.spendDelta.toFixed(2)}`);
+                appendRunLog(ctx, `ITER ${iteration} REJECT plate-handwritten-ui  ${platePathHit}  spend_delta=$${turnResult.spendDelta.toFixed(2)}`);
                 continue;
             }
             const scopeHit = diff.changedPaths.find((p) => !isAllowedPath(p, ctx.allowedPaths) &&
@@ -467,7 +543,10 @@ export async function runBrew(ctx) {
             // story's manifest files (0.11.16+) for fast feedback. Full
             // suite runs at brew completion as the correctness gate.
             const result = runTestSuite(ctx, storyTestFiles);
-            if (!result.ran) {
+            if (!result.ran && result.tests.length === 0) {
+                // 0.16.0-α.28 — only halt when zero tests came back. Same
+                // degrade-on-partial policy as the baseline run: if SOME suite
+                // produced tests, proceed with what we got.
                 revertToSnapshot(ctx, snapshot);
                 iterationLogs.push({
                     iteration,
@@ -1702,6 +1781,30 @@ async function haltFor(ctx, args) {
     }
     return { kind: "halted", report };
 }
+const RECOGNISED_HALT_CLASSES = new Set([
+    "MOCKUP_DESIGN_CONFLICT",
+    "SPEC_AMBIGUITY_DETECTED",
+    "TEST_RUNNER_BROKEN",
+    "AGENT_SELF_REPORTED_STUCK",
+]);
+export function parseHaltEnvelope(rationale) {
+    if (!rationale)
+        return null;
+    const m = rationale.match(/<halt\s+class\s*=\s*["']([A-Z_]+)["']\s*>([\s\S]*?)<\/halt>/);
+    if (!m || !m[1] || !m[2])
+        return null;
+    const cls = m[1];
+    if (!RECOGNISED_HALT_CLASSES.has(cls))
+        return null;
+    const inner = m[2];
+    // Prefer <conflict>; fall back to all text inside the envelope.
+    const conflictMatch = inner.match(/<conflict>([\s\S]*?)<\/conflict>/);
+    const raw = conflictMatch && conflictMatch[1]
+        ? conflictMatch[1]
+        : inner.replace(/<[^>]+>/g, " ");
+    const summary = raw.replace(/\s+/g, " ").trim().slice(0, 800);
+    return { class: cls, summary };
+}
 function generateDiagnosis(iterationLogs, greenSet, expected) {
     const storyGreen = [...greenSet].filter((t) => expected.has(t)).length;
     if (iterationLogs.length === 0) {