@bendyline/gilde 0.1.55 → 0.1.56

package/data/craftbook-templates/ho/hotfix-flow/versions/2.0.2/test.json

@@ -0,0 +1,220 @@
+{
+  "schemaVersion": 1,
+  "title": "Hotfix with minimal blast radius and a rollback path",
+  "objective": "The craftbook drives an urgent fix of a seeded null-guard crash in a receipts formatter: reproduction with the least machinery, the smallest change at the real defect site, honest validation with a rollback path, and an enforced review — verified mechanically, including a mutant re-seed proving the patch engaged the real site.",
+  "tags": [
+    "code",
+    "bug-fix",
+    "hotfix",
+    "tactical-fleet"
+  ],
+  "prompt": "Use the Hotfix Flow craftbook for this emergency: the nightly receipts export is crashing in production on orders without a gift note. The incident report is in source/incident.md. Reproduce it with the least machinery that shows it, patch minimally at the real defect site, and leave a rollback path.",
+  "setup": {
+    "projectName": "Receiptline",
+    "about": "A tiny order-receipt formatting module behind a nightly export. No test suite - the export script is the only runnable surface.",
+    "files": [
+      {
+        "path": "package.json",
+        "content": "{\n  \"name\": \"receiptline\",\n  \"private\": true,\n  \"version\": \"1.0.0\",\n  \"type\": \"module\"\n}\n",
+        "modelInput": false
+      },
+      {
+        "path": "src/format-order.js",
+        "content": "export function formatOrder(order) {\n  const lines = [];\n  lines.push('Order ' + order.id + ' for ' + order.customer);\n  for (const item of order.items) {\n    lines.push('  ' + item.qty + ' x ' + item.name + ' @ ' + money(item.unitPrice));\n  }\n  lines.push('Total: ' + money(orderTotal(order)));\n  lines.push('Gift note: ' + order.giftNote.trim());\n  return lines.join('\\n');\n}\n\nexport function orderTotal(order) {\n  let total = 0;\n  for (const item of order.items) {\n    total += item.qty * item.unitPrice;\n  }\n  return Math.round(total * 100) / 100;\n}\n\nfunction money(value) {\n  return value.toFixed(2);\n}\n"
+      },
+      {
+        "path": "data/orders.json",
+        "content": "[\n  {\n    \"id\": \"A-1041\",\n    \"customer\": \"Ana Torres\",\n    \"items\": [{ \"qty\": 1, \"name\": \"Ceramic Vase\", \"unitPrice\": 30 }],\n    \"giftNote\": \"  Happy birthday, Ana!  \"\n  },\n  {\n    \"id\": \"A-1042\",\n    \"customer\": \"Ben Ito\",\n    \"items\": [{ \"qty\": 2, \"name\": \"Stone Mug\", \"unitPrice\": 9.5 }]\n  },\n  {\n    \"id\": \"A-1043\",\n    \"customer\": \"Priya Shah\",\n    \"items\": [\n      { \"qty\": 3, \"name\": \"Linen Napkin\", \"unitPrice\": 4 },\n      { \"qty\": 1, \"name\": \"Oak Tray\", \"unitPrice\": 18 }\n    ]\n  }\n]\n",
+        "modelInput": false
+      },
+      {
+        "path": "scripts/print-receipts.mjs",
+        "content": "import { readFileSync } from 'node:fs';\nimport { formatOrder } from '../src/format-order.js';\n\nconst orders = JSON.parse(\n  readFileSync(new URL('../data/orders.json', import.meta.url), 'utf8'),\n);\nfor (const order of orders) {\n  console.log(formatOrder(order));\n  console.log('---');\n}\n",
+        "modelInput": false
+      },
+      {
+        "path": "source/incident.md",
+        "content": "# Incident: receipts export crashing\n\n02:14 - the nightly receipts export died partway through and retail has no morning receipts. Support traced it to orders without a gift note:\n\n    TypeError: Cannot read properties of undefined (reading 'trim')\n        at formatOrder (src/format-order.js)\n\n`node scripts/print-receipts.mjs` reproduces it: the first order (which has a gift note) prints fine, then the export falls over on the second order in `data/orders.json`.\n\nWhat must hold once this is fixed:\n\n- Orders with a gift note keep printing the trimmed note line.\n- Orders without one print a normal receipt with NO gift-note line.\n- Item lines and totals unchanged.\n\nWe need the smallest safe patch now. The proper cleanup of the formatter can wait for daylight - write it down instead of doing it.\n"
+      },
+      {
+        "path": "tests/verify-hotfix.mjs",
+        "content": "import assert from 'node:assert/strict';\nimport { execFileSync } from 'node:child_process';\nimport { cpSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { formatOrder, orderTotal } from '../src/format-order.js';\n\nconst root = process.cwd();\n\n// 1) The crash case is fixed: an order without a gift note formats cleanly.\nconst plain = {\n  id: 'A-1042',\n  customer: 'Ben Ito',\n  items: [{ qty: 2, name: 'Stone Mug', unitPrice: 9.5 }],\n};\nconst plainReceipt = formatOrder(plain);\nassert.ok(!plainReceipt.includes('undefined'), 'a receipt must not leak \"undefined\"');\nassert.ok(!/Gift note:/.test(plainReceipt), 'an order without a gift note must not print a gift-note line');\nassert.ok(plainReceipt.includes('Total: 19.00'), 'totals must survive the patch');\nconsole.log('HOTFIX_ORACLE crash case fixed');\n\n// 2) Neighborhood intact: gift notes still print trimmed, totals still add up.\nconst gifted = {\n  id: 'A-1041',\n  customer: 'Ana Torres',\n  items: [{ qty: 1, name: 'Ceramic Vase', unitPrice: 30 }],\n  giftNote: '  Happy birthday, Ana!  ',\n};\nconst giftedReceipt = formatOrder(gifted);\nassert.ok(giftedReceipt.includes('Gift note: Happy birthday, Ana!'), 'gift notes must still print, trimmed');\nconst multi = {\n  id: 'A-1043',\n  customer: 'Priya Shah',\n  items: [\n    { qty: 3, name: 'Linen Napkin', unitPrice: 4 },\n    { qty: 1, name: 'Oak Tray', unitPrice: 18 },\n  ],\n};\nassert.equal(orderTotal(multi), 30, 'orderTotal must be untouched');\nconsole.log('HOTFIX_ORACLE neighborhood intact');\n\n// 3) The export the incident names runs clean end to end.\nconst exportOut = execFileSync(process.execPath, ['scripts/print-receipts.mjs'], {\n  cwd: root,\n  stdio: 'pipe',\n  timeout: 30000,\n}).toString();\nassert.ok(exportOut.includes('A-1043'), 'the export must reach the last order');\nconsole.log('HOTFIX_ORACLE export green');\n\n// 4) Re-seed the original defect into a mutant tree: the crash must come\n// back, proving the patch engaged the real site rather than the callers\n// or the data (both of which are pinned fixtures anyway).\nconst ORIGINAL = `export function formatOrder(order) {\n  const lines = [];\n  lines.push('Order ' + order.id + ' for ' + order.customer);\n  for (const item of order.items) {\n    lines.push('  ' + item.qty + ' x ' + item.name + ' @ ' + money(item.unitPrice));\n  }\n  lines.push('Total: ' + money(orderTotal(order)));\n  lines.push('Gift note: ' + order.giftNote.trim());\n  return lines.join('\\\\n');\n}\n\nexport function orderTotal(order) {\n  let total = 0;\n  for (const item of order.items) {\n    total += item.qty * item.unitPrice;\n  }\n  return Math.round(total * 100) / 100;\n}\n\nfunction money(value) {\n  return value.toFixed(2);\n}\n`;\nconst mutantRoot = join(root, '.oracle-mutant');\nrmSync(mutantRoot, { recursive: true, force: true });\nmkdirSync(join(mutantRoot, 'src'), { recursive: true });\ncpSync(join(root, 'scripts'), join(mutantRoot, 'scripts'), { recursive: true });\ncpSync(join(root, 'data'), join(mutantRoot, 'data'), { recursive: true });\ncpSync(join(root, 'package.json'), join(mutantRoot, 'package.json'));\nwriteFileSync(join(mutantRoot, 'src', 'format-order.js'), ORIGINAL);\nlet mutantStatus = 0;\ntry {\n  execFileSync(process.execPath, ['scripts/print-receipts.mjs'], {\n    cwd: mutantRoot,\n    stdio: 'pipe',\n    timeout: 30000,\n  });\n} catch (err) {\n  mutantStatus = typeof err.status === 'number' ? err.status : 1;\n}\nassert.notEqual(mutantStatus, 0, 're-seeding the original defect must restore the crash - the patch did not engage the real site');\nconsole.log('HOTFIX_ORACLE mutant caught');\nconsole.log('HOTFIX_ORACLE done');\n",
+        "surface": "harness"
+      }
+    ],
+    "craftbookParams": {
+      "scope": "The nightly receipts export crashes on orders without a gift note; see source/incident.md. Smallest safe patch now - the proper cleanup is deferred, not attempted."
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "The seeded null-guard crash is fixed at the real site with minimal blast radius, the export runs clean, a mutant re-seed restores the crash, and the fleet artifacts carry honest evidence, a Follow-up debt record, and a runnable rollback.",
+    "deliverables": [
+      {
+        "path": "{{task.dir}}/repro.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "{{task.dir}}/repro.md",
+            "pattern": "^##\\s+Symptom[\\s\\S]*^##\\s+Repro command[\\s\\S]*^##\\s+Expected[\\s\\S]*^##\\s+Actual[\\s\\S]*^##\\s+Evidence",
+            "flags": "im",
+            "label": "reproduction sections in order"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "{{task.dir}}/repro.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "{{task.dir}}/fix-notes.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 700,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "{{task.dir}}/fix-notes.md",
+            "pattern": "^##\\s+Problem[\\s\\S]*^##\\s+Change[\\s\\S]*^##\\s+Files touched[\\s\\S]*^##\\s+Risk[\\s\\S]*^##\\s+How to verify[\\s\\S]*^##\\s+Follow-up",
+            "flags": "im",
+            "label": "fix-notes sections in order, Follow-up included"
+          },
+          {
+            "kind": "contains",
+            "file": "{{task.dir}}/fix-notes.md",
+            "pattern": "src/format-order\\.js",
+            "label": "names the real defect site"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "{{task.dir}}/fix-notes.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "{{task.dir}}/validation.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 400,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "{{task.dir}}/validation.md",
+            "pattern": "^##\\s+Repro re-run[\\s\\S]*^##\\s+Result[\\s\\S]*^##\\s+Rollback",
+            "flags": "im",
+            "label": "validation sections in order, Rollback included"
+          }
+        ]
+      },
+      {
+        "path": "{{task.dir}}/review.md",
+        "kind": "markdown-report",
+        "artifact": true,
+        "minBytes": 400,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "{{task.dir}}/review.md",
+            "pattern": "Verdict:\\s*(?:PASS|REVISE)",
+            "flags": "i",
+            "label": "explicit reviewer verdict"
+          }
+        ]
+      }
+    ],
+    "checks": [
+      {
+        "kind": "notContains",
+        "file": "src/format-order.js",
+        "pattern": "\\btry\\s*\\{|\\bcatch\\s*\\(",
+        "label": "the crash is fixed at the site, not swallowed with try/catch"
+      },
+      {
+        "kind": "sourceParses",
+        "file": "src/format-order.js"
+      },
+      {
+        "kind": "nodeRuns",
+        "file": "scripts/print-receipts.mjs",
+        "timeoutMs": 30000
+      },
+      {
+        "kind": "nodeScriptPasses",
+        "script": "tests/verify-hotfix.mjs",
+        "timeoutMs": 60000,
+        "requiredOutput": [
+          {
+            "pattern": "HOTFIX_ORACLE crash case fixed",
+            "label": "the null-guard crash is gone"
+          },
+          {
+            "pattern": "HOTFIX_ORACLE neighborhood intact",
+            "label": "gift notes and totals still behave"
+          },
+          {
+            "pattern": "HOTFIX_ORACLE export green",
+            "label": "the incident's export runs end to end"
+          },
+          {
+            "pattern": "HOTFIX_ORACLE mutant caught",
+            "label": "re-seeding the defect restores the crash"
+          }
+        ]
+      }
+    ],
+    "taskNotes": {
+      "minBytes": 120,
+      "checks": [
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "\\bDONE\\b[\\s\\S]*validation\\.md",
+          "flags": "i",
+          "label": "DONE note names the validation deliverable"
+        }
+      ]
+    },
+    "taskGraph": {
+      "requireCraftbookTask": true,
+      "requireTerminalStep": true
+    },
+    "unchangedFixtures": [
+      "source/incident.md",
+      "package.json",
+      "data/orders.json",
+      "scripts/print-receipts.mjs"
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "{{task.dir}}/fix-notes.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "Minimal blast radius",
+        "description": "The change is the smallest that stops the failure at the real defect site - no refactor, rename, or cleanup rode along with the emergency patch."
+      },
+      {
+        "name": "Honest evidence under pressure",
+        "description": "Reproduction and validation quote real observed behavior, and anything that could not actually be run is labeled unverified rather than claimed."
+      },
+      {
+        "name": "Deferred debt discipline",
+        "description": "Follow-up records the proper fix and the debt the patch leaves (with a backport note where relevant) instead of attempting a deeper repair mid-incident, and Rollback is a concrete, runnable path."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "minimal-diff discipline",
+    "honest verification",
+    "runnable rollback"
+  ]
+}

package/data/craftbook-templates/ht/html-arcade-game/versions/1.2.3/craftbook.json

@@ -0,0 +1,343 @@
+{
+  "id": "html-arcade-game",
+  "name": "HTML Arcade Game",
+  "description": "Build a playable single-file HTML/canvas arcade game (shooter, runner, dodger, etc.). Splits design into game-mechanics and visual look, builds, then evaluates against a playability bar and loops until it is actually fun and bug-free.\n\nA gallery craftbook generated from an archetype spec. It runs\n`phase → (per-phase gate) → … → evaluate → (loop) → finish`. Each build\nphase that produces a checkable artifact is followed by a **runtime\ngate-checkpoint** — the runtime verifies the artifact and routes with no\nmodel turn, looping back to redo the phase on a miss. The final `evaluate`\nstep holds a static deliverable gate plus a reviewer QA pass. What it adds\nover the generic `build-loop`: a specialist role per phase, a\ndomain-correct ordering, and a concrete per-phase quality bar.\n\nDeliverables marked \"artifact\" land in the project's artifacts drawer (`write_artifact` / `read_artifact`), not the shipped workspace — review output is not product source.\n\nPhases:\n\n1. Game design (game-designer) — mechanics, controls, win/lose, difficulty → gated on artifact `design/game-design.md` (markdown-notes)\n2. Visual design (visual-designer) — palette, shapes/sprites, layout, juice → gated on artifact `design/visual-design.md` (markdown-notes)\n3. Build (developer) — implement the game in one index.html → gated on `index.html` (html-game)\n\nThe gates never advance with an unmet criterion, and loop back to the\nowning phase to fix named gaps.\n",
+  "entryStepId": "game-design",
+  "triggers": [
+    "arcade game",
+    "space shooter",
+    "html game",
+    "build a game"
+  ],
+  "steps": [
+    {
+      "id": "game-design",
+      "name": "Game design",
+      "description": "mechanics, controls, win/lose, difficulty",
+      "prompt": "Design the GAME, not the code. Decide: core mechanic (what the player does), controls (keys/mouse/touch), win and lose conditions, scoring, restart behavior, and the difficulty curve. Then write an **acceptance-criteria checklist** (4-8 concrete, checkable items, e.g. \"arrow keys move the ship\", \"colliding with an enemy ends the game\", \"score increments on hit\", \"restart resets the score\", \"game is playable for >30s without a JS error\"). Save the complete mechanics + checklist to artifact `design/game-design.md` with `write_artifact`, and summarize the path in task notes. No code, no visuals yet.",
+      "suggestedRole": "game-designer",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "audio",
+          "browser-automation",
+          "code-execution",
+          "craftbooks",
+          "data-tables",
+          "entity-intel",
+          "git",
+          "image-intel",
+          "images",
+          "role-delegation",
+          "role-delegation-escalation",
+          "security-intel",
+          "team-management",
+          "videos",
+          "web",
+          "workspace-fs-write"
+        ],
+        "outputMedium": "artifact",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      },
+      "advanceWhen": {
+        "file": "design/game-design.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "design/game-design.md",
+            "bytes": 600,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "design/game-design.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "design/game-design.md",
+            "pattern": "acceptance|criteria|checklist",
+            "flags": "i",
+            "label": "acceptance criteria",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "design/game-design.md",
+            "pattern": "control|input|keyboard|mouse|touch",
+            "flags": "i",
+            "label": "control scheme",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "design/game-design.md",
+            "pattern": "win|lose|game over|victory|defeat",
+            "flags": "i",
+            "label": "end-state rules",
+            "artifact": true
+          }
+        ],
+        "onReject": "game-design",
+        "maxAttempts": 3
+      },
+      "next": "visual-design"
+    },
+    {
+      "id": "visual-design",
+      "name": "Visual design",
+      "description": "palette, shapes/sprites, layout, juice",
+      "prompt": "Read artifact `design/game-design.md` with `read_artifact`, then decide how the game LOOKS. Pick a palette with exact color values, the canvas shapes or sprites for player/enemies/projectiles, the HUD layout (score, lives or timer), and at least one feedback effect (hit flash, screen shake, or particles). Keep it self-contained — canvas drawing or CSS, no external asset downloads. Save the concrete visual target to artifact `design/visual-design.md` with `write_artifact`, and summarize the path in task notes. Still no game code.",
+      "suggestedRole": "visual-designer",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "audio",
+          "browser-automation",
+          "code-execution",
+          "craftbooks",
+          "data-tables",
+          "entity-intel",
+          "git",
+          "image-intel",
+          "images",
+          "role-delegation",
+          "role-delegation-escalation",
+          "security-intel",
+          "team-management",
+          "videos",
+          "web",
+          "workspace-fs-write"
+        ],
+        "outputMedium": "artifact",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      },
+      "consumes": [
+        {
+          "file": "design/game-design.md",
+          "artifact": true
+        }
+      ],
+      "advanceWhen": {
+        "file": "design/visual-design.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "design/visual-design.md",
+            "bytes": 450,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "design/visual-design.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "design/visual-design.md",
+            "pattern": "#[0-9a-f]{3,8}|rgb\\(|hsl\\(",
+            "flags": "i",
+            "label": "concrete palette",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "design/visual-design.md",
+            "pattern": "HUD|score|lives|timer",
+            "flags": "i",
+            "label": "HUD design",
+            "artifact": true
+          }
+        ],
+        "onReject": "visual-design",
+        "maxAttempts": 3
+      },
+      "next": "build"
+    },
+    {
+      "id": "build",
+      "name": "Build",
+      "description": "implement the game in one index.html",
+      "prompt": "Read artifacts `design/game-design.md` and `design/visual-design.md` with `read_artifact`. Implement the game in workspace `index.html` with `write_file` (inline CSS + JS) so it satisfies the acceptance criteria and matches the visual spec. Include a real game loop, real input handling, score/state, a visible win or lose state, and an in-page restart path. Keep it self-contained with no network assets. On a loop-back, fix only the gaps the reviewer named — do not regress criteria that already passed. `write_task_note` the workspace path and which criteria now pass.",
+      "suggestedRole": "developer",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "audio",
+          "browser-automation",
+          "code-execution",
+          "craftbooks",
+          "data-tables",
+          "entity-intel",
+          "git",
+          "image-intel",
+          "images",
+          "role-delegation",
+          "role-delegation-escalation",
+          "security-intel",
+          "team-management",
+          "videos",
+          "web"
+        ],
+        "outputMedium": "workspace",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      },
+      "consumes": [
+        {
+          "file": "design/game-design.md",
+          "artifact": true
+        },
+        {
+          "file": "design/visual-design.md",
+          "artifact": true
+        }
+      ],
+      "advanceWhen": {
+        "file": "index.html",
+        "minBytes": 1,
+        "sniff": "html-complete"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "index.html",
+            "bytes": 3200
+          },
+          {
+            "kind": "htmlLint",
+            "file": "index.html"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "game\\s*-?\\s*over|you\\s+(?:win|won|lose|lost)|victory|defeat",
+            "flags": "i",
+            "label": "visible end state"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "restart|play\\s*again|new\\s*game|try\\s*again",
+            "flags": "i",
+            "label": "restart path"
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkHtmlGame",
+            "scope": "standard",
+            "inputs": {
+              "file": "index.html"
+            }
+          },
+          {
+            "name": "checkJsParses",
+            "scope": "standard",
+            "inputs": {
+              "file": "index.html"
+            }
+          }
+        ],
+        "onReject": "build",
+        "maxAttempts": 4
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "evaluate",
+      "name": "Evaluate",
+      "description": "Grade the deliverable against every acceptance criterion. All pass → finish; any fail → loop back and fix the gap.",
+      "prompt": "Read workspace `index.html` with `read_file` and actually exercise the game. If a browser/QA capability is available, load it, play it, test restart, and watch the console for errors; otherwise trace the game loop, input listeners, end-state transition, and reset path in source. Check every criterion from artifact `design/game-design.md` and write PASS/FAIL per criterion.\n\nThen route — this is the whole point of the loop:\n\n- **Every criterion PASSES →** call `advance_task_step({ ref, stepId: \"evaluate\", next: \"finish\" })`.\n- **Any criterion FAILS →** write the specific gaps to notes, then call `advance_task_step({ ref, stepId: \"evaluate\", next: \"build\" })` to loop back. The builder fixes exactly those gaps.\n\nNever route to `finish` while any criterion is unmet. The build phase's completion gate already blocked a grossly-incomplete deliverable; your job is the judgment an automated check cannot make (does it actually work, read well, look right). After ~3 unproductive loops, stop and report DONE_WITH_CONCERNS so the user can step in.",
+      "suggestedRole": "reviewer",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "artifacts",
+          "audio",
+          "browser-automation",
+          "code-execution",
+          "craftbooks",
+          "data-tables",
+          "entity-intel",
+          "git",
+          "image-intel",
+          "images",
+          "role-delegation",
+          "role-delegation-escalation",
+          "security-intel",
+          "team-management",
+          "videos",
+          "web",
+          "workspace-fs-write"
+        ],
+        "outputMedium": "task-note"
+      },
+      "consumes": [
+        {
+          "file": "index.html"
+        }
+      ],
+      "next": "build"
+    },
+    {
+      "id": "finish",
+      "name": "Finish",
+      "description": "All acceptance criteria met. Stamp a short summary and report DONE.",
+      "prompt": "Every acceptance criterion passed. Write a one-paragraph DONE summary to task notes via `write_task_note`: what was built, the deliverable path(s), and a one-line confirmation that each criterion is met. Then report DONE.",
+      "suggestedRole": "developer",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "artifacts",
+          "audio",
+          "browser-automation",
+          "code-execution",
+          "craftbooks",
+          "data-tables",
+          "entity-intel",
+          "git",
+          "image-intel",
+          "images",
+          "role-delegation",
+          "role-delegation-escalation",
+          "security-intel",
+          "team-management",
+          "videos",
+          "web",
+          "workspace-fs-write"
+        ],
+        "outputMedium": "task-note"
+      },
+      "terminal": true
+    }
+  ],
+  "version": "1.2.3",
+  "releasedAt": "2026-09-05T03:30:00Z"
+}