@bendyline/gilde 0.1.37 → 0.1.39

package/data/craftbook-templates/ch/character-turnaround/versions/1.0.2/test.json

@@ -0,0 +1,181 @@
+{
+  "schemaVersion": 1,
+  "title": "Character Turnaround — the knight from all sides, seeds kept",
+  "objective": "Measure whether the character-turnaround craftbook produces front, side, back, and three-quarter views of one consistent figure and records every view in the manifest with the seed and prompt that made it — paths real, ids unique.",
+  "tags": [
+    "data"
+  ],
+  "prompt": "can you do a full turnaround for the knight charcter? we'll need it for the sprite work later",
+  "setup": {
+    "projectName": "Foxglove Platformer Assets",
+    "about": "Asset foundry project. The library's records live at workspace/assets/manifest.json (a JSON array, one record per asset) and the style anchor at workspace/assets/style.md. The knight's turnaround lands in workspace/assets/characters/knight; the summary goes to workspace/report.md.",
+    "missionObjectives": "One figure, four angles, reproducible later: every view generated against the style anchor and recorded with its seed and prompt, and no manifest record pointing at a file that is not there. No live services, no real credentials.",
+    "files": [
+      {
+        "path": "assets/style.md",
+        "content": "# Asset library style anchor\n\n- Character art: 96x128 pixel figures, heroic proportion (5 heads tall).\n- Palette: iron gray #6e7681, brass trim #b08d3f, cloak red #7a2e2e,\n  highlight cream #e8dcb8, outline near-black #22201c.\n- Look: chunky 2px outlines, flat interior shading, one highlight edge\n  top-left. No gradients, no anti-aliased edges.\n- Turnarounds: assets/characters/<name>/<angle>.png — front, side, back,\n  three-quarter — same figure, same scale, same palette in every view.\n- Every shipped asset gets a manifest record: id, file, size, tags,\n  seed, prompt — the seed and prompt are how the next sprite stays in style.\n"
+      },
+      {
+        "path": "assets/manifest.json",
+        "content": "[\n  {\n    \"id\": \"tile-stone-01\",\n    \"file\": \"assets/tiles/tile-stone-01.png\",\n    \"size\": \"32x32\",\n    \"tags\": [\n      \"stone\",\n      \"ground\"\n    ]\n  },\n  {\n    \"id\": \"banner-keep\",\n    \"file\": \"assets/banners/banner-keep.png\",\n    \"size\": \"64x96\",\n    \"tags\": [\n      \"banner\",\n      \"keep\"\n    ]\n  }\n]\n"
+      },
+      {
+        "path": "assets/tiles/tile-stone-01.png",
+        "content": "placeholder tile image: stone ground\n"
+      },
+      {
+        "path": "assets/banners/banner-keep.png",
+        "content": "placeholder banner image: keep banner\n"
+      }
+    ],
+    "worker": {
+      "name": "Ellen",
+      "role": "Assetsmid"
+    },
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "assets/characters/knight holds the four turnaround views; the manifest records each with seed and prompt; tasks/eval/report.md hands the set to the sprite work.",
+    "checks": [
+      {
+        "kind": "fileCount",
+        "ext": [
+          "png"
+        ],
+        "min": 4,
+        "dir": "assets/characters/knight"
+      }
+    ],
+    "deliverables": [
+      {
+        "path": "assets/manifest.json",
+        "kind": "json",
+        "minBytes": 400,
+        "checks": [
+          {
+            "kind": "sniff",
+            "file": "assets/manifest.json",
+            "sniff": "json-valid"
+          },
+          {
+            "kind": "recordSchema",
+            "file": "assets/manifest.json",
+            "fields": [
+              {
+                "name": "id",
+                "type": "nonempty"
+              },
+              {
+                "name": "file",
+                "type": "nonempty"
+              },
+              {
+                "name": "size",
+                "required": false
+              },
+              {
+                "name": "tags",
+                "required": false
+              },
+              {
+                "name": "seed",
+                "required": false
+              },
+              {
+                "name": "prompt",
+                "required": false
+              }
+            ],
+            "minRows": 6,
+            "uniqueBy": "id"
+          },
+          {
+            "kind": "contains",
+            "file": "assets/manifest.json",
+            "pattern": "\"seed\"",
+            "label": "seeds persisted in the records"
+          },
+          {
+            "kind": "contains",
+            "file": "assets/manifest.json",
+            "pattern": "\"prompt\"",
+            "label": "prompts persisted in the records"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "assets/manifest.json",
+            "pattern": "\"file\"\\s*:\\s*\"([^\"]+)\"",
+            "minCitations": 6,
+            "label": "every recorded file exists on disk"
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/report.md",
+        "kind": "markdown-report",
+        "minBytes": 600,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "front",
+            "flags": "i",
+            "label": "front view named"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "side|profile",
+            "flags": "i",
+            "label": "side view named"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "back",
+            "flags": "i",
+            "label": "back view named"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "tasks/eval/report.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "angle coverage",
+        "description": "Front, side, back, and three-quarter are all present at the convention names — a usable model sheet, not a portrait set."
+      },
+      {
+        "name": "consistency",
+        "description": "The views read as one figure — same silhouette, proportions, palette, and scale in every view."
+      },
+      {
+        "name": "silhouette readability",
+        "description": "The knight reads clearly at sprite distance; the shape survives shrinking."
+      },
+      {
+        "name": "manifest quality",
+        "description": "Every view's record carries id, file, seed, and prompt; existing records untouched, ids unique, paths real."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "one consistent figure",
+    "seeds and prompts persisted",
+    "manifest honesty"
+  ]
+}

package/data/craftbook-templates/ch/chart-pack/versions/1.0.2/craftbook.json

@@ -0,0 +1,160 @@
+{
+  "id": "chart-pack",
+  "name": "Chart Pack from Data",
+  "description": "Build a single interactive HTML page of charts that answers a defined set of questions about a dataset. Scopes the questions and the right chart type per question FIRST (so you don't make a pretty chart that answers nothing), then analyzes the data into chart-ready series, then builds one self-contained HTML page rendering every chart with titles, axis labels, and a one-line takeaway caption each. Use this for a dashboard of charts, a visualization pack, a metrics page, or turning a CSV into graphs and plots.\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. Scope the questions (planner) — lock the questions and the chart type that answers each → gated on artifact `{{workPath}}/question-scope.md` (markdown-notes)\n2. Analyze into chart-ready series (data-analyst) — aggregate the data into the exact series each chart needs → gated on `data/series.json` (json)\n3. Build the chart page (developer) — render every chart in one self-contained index.html → gated on `index.html` (html-page)\n\nThe gates never advance with an unmet criterion, and loop back to the\nowning phase to fix named gaps.\n",
+  "entryStepId": "question-scope",
+  "triggers": [
+    "make charts from data",
+    "chart pack",
+    "visualize this dataset",
+    "graphs from a csv",
+    "build a charts page"
+  ],
+  "steps": [
+    {
+      "id": "question-scope",
+      "name": "Scope the questions",
+      "description": "lock the questions and the chart type that answers each",
+      "prompt": "Decide WHAT the chart pack must answer before any analysis. Step 1: list 4-8 specific questions a reader has about this data (e.g. 'how did revenue trend by month?', 'which 5 categories are largest?', 'how are values distributed?'). Step 2: for EACH question pick the chart type that answers it best and say why (trend over time -> line; part-to-whole -> bar/stacked, not pie unless <=5 slices; distribution -> histogram; comparison -> grouped bar; relationship -> scatter). Step 3: name the exact columns and aggregation each chart needs. Step 4: write an acceptance-criteria checklist ('one chart per question', 'every chart has a title + axis labels', 'every chart has a one-line takeaway caption', 'chart type matches the question'). Call write_task_note and write the question->chart mapping + checklist to {{workPath}}/question-scope.md.\n\nThe deliverable `{{workPath}}/question-scope.md` lands in the project's artifacts drawer — write it with `write_artifact` and read it back with `read_artifact`; the shipped workspace stays untouched.",
+      "suggestedRole": "planner",
+      "advanceWhen": {
+        "file": "{{workPath}}/question-scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/question-scope.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/question-scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "question-scope",
+        "maxAttempts": 3
+      },
+      "next": "analyze"
+    },
+    {
+      "id": "analyze",
+      "name": "Analyze into chart-ready series",
+      "description": "aggregate the data into the exact series each chart needs",
+      "prompt": "Transform the raw data into the precise series each scoped chart needs. Step 1: for each chart, group/aggregate the columns named in the scope (sum, count, average, bucketed histogram) and produce ordered (label, value) arrays. Step 2: sort sensibly (time ascending, categories by magnitude) and cap to a readable count (top-N + 'other' if needed). Step 3: write the computed takeaway caption for each chart from the numbers ('March was the peak at 4.2k, up 38% from Feb'). Step 4: emit the series as data/series.json keyed by chart id so the build phase reads it directly. Call write_task_note with the series summary and the captions.",
+      "suggestedRole": "data-analyst",
+      "advanceWhen": {
+        "file": "data/series.json",
+        "minBytes": 1,
+        "sniff": "json-valid"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "data/series.json",
+            "bytes": 2
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkJsonValid",
+            "scope": "standard",
+            "inputs": {
+              "file": "data/series.json"
+            }
+          }
+        ],
+        "onReject": "analyze",
+        "maxAttempts": 3
+      },
+      "next": "build"
+    },
+    {
+      "id": "build",
+      "name": "Build the chart page",
+      "description": "render every chart in one self-contained index.html",
+      "prompt": "Build a single self-contained index.html that renders every scoped chart from data/series.json. Step 1: use inline <canvas>/SVG drawing or a single inlined chart library — no external network asset that could fail offline; if you embed the series, keep it in sync with the JSON. Step 2: render each chart with its title, labeled axes, readable ticks, and a legend where needed. Step 3: place the one-line takeaway caption under each chart. Step 4: lay the charts out responsively in a grid that reads top-to-bottom in the scoped order. Step 5: ensure no console errors and that charts have real data, not placeholders. On a loop-back, fix only the named gaps. Call write_task_note with the path and chart count.",
+      "suggestedRole": "developer",
+      "consumes": [
+        {
+          "file": "data/series.json"
+        }
+      ],
+      "advanceWhen": {
+        "file": "index.html",
+        "minBytes": 1,
+        "sniff": "html-complete"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "index.html",
+            "bytes": 800
+          },
+          {
+            "kind": "htmlLint",
+            "file": "index.html"
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkHtmlComplete",
+            "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": "Open index.html (render it if a browser capability exists, else trace the source). Verify: there is one chart per scoped question; each chart has a title, labeled axes, and a takeaway caption; the chart type matches the question from the scope; charts render real values from the series, not placeholders; and there are no console errors. Spot-check two charts' values against data/series.json. Write PASS/FAIL per criterion; any FAIL loops back to build.\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",
+      "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",
+      "terminal": true
+    }
+  ],
+  "version": "1.0.2",
+  "releasedAt": "2026-08-21T00:00:00Z",
+  "paramSchema": {
+    "type": "object",
+    "properties": {
+      "workPath": {
+        "type": "string",
+        "title": "Working folder",
+        "description": "Per-task working folder in the artifacts drawer. Defaults to this task's own folder so runs never collide; override with a stable name when you deliberately want runs to share files.",
+        "default": "{{task.dir}}"
+      }
+    }
+  },
+  "minGezelVersion": "1.26233"
+}

package/data/craftbook-templates/ch/chart-pack/versions/1.0.2/test.json

@@ -0,0 +1,107 @@
+{
+  "schemaVersion": 1,
+  "title": "Interactive chart pack from seeded CSV",
+  "objective": "Measure whether the chart-pack craftbook scopes analytical questions, derives series from data, and builds a self-contained chart page.",
+  "tags": [
+    "html-page"
+  ],
+  "prompt": "In the `Chart Pack Eval` project, read `data/support-week.csv` and build `index.html`: an interactive chart pack answering ticket volume by day, SLA breaches by queue, and reopen rate by queue. Include chart titles, axis labels, one-line takeaway captions, and inline data/JS with no external libraries.",
+  "setup": {
+    "projectName": "Chart Pack Eval",
+    "about": "Self-contained eval project for the chart-pack craftbook. The dataset is workspace/data/support-week.csv.",
+    "missionObjectives": "Build a single-page chart pack from the seeded CSV with three question-driven charts, labels, captions, and inline JS/CSS.",
+    "files": [
+      {
+        "path": "data/support-week.csv",
+        "content": "day,queue,tickets,sla_breaches,reopen_rate\nMon,Returns,82,14,0.18\nMon,Shipping,61,9,0.11\nTue,Returns,64,8,0.14\nTue,Shipping,55,5,0.09\nWed,Returns,58,6,0.12\nWed,Shipping,49,4,0.08\nThu,Returns,71,10,0.16\nThu,Shipping,52,6,0.1\nFri,Returns,77,11,0.15\nFri,Shipping,57,7,0.1\n"
+      }
+    ],
+    "worker": {
+      "name": "Karel",
+      "role": "Developer"
+    },
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "workspace/index.html is a complete chart pack page with source-derived data, chart labels, captions, and inline rendering logic.",
+    "deliverables": [
+      {
+        "path": "index.html",
+        "kind": "html-page",
+        "minBytes": 3400,
+        "checks": [
+          {
+            "kind": "cssMinBytes",
+            "bytes": 600,
+            "file": "index.html"
+          },
+          {
+            "kind": "jsParses",
+            "file": "index.html"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "ticket volume|SLA breaches|reopen rate",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "Returns|Shipping|Mon|Fri"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "axis|label|caption|takeaway",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "82|14|0\\.18|57",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "canvas|svg|bar|line",
+            "flags": "i"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "index.html",
+      "kind": "html"
+    },
+    "axes": [
+      {
+        "name": "structure",
+        "description": "Layout and hierarchy fit the content; sections are scannable and coherent."
+      },
+      {
+        "name": "grounding",
+        "description": "Seeded source content is used faithfully — no invented facts or dropped requirements."
+      },
+      {
+        "name": "interactivity",
+        "description": "Controls and states the page claims to offer actually work."
+      },
+      {
+        "name": "polish",
+        "description": "Styling is intentional and responsive rather than unstyled or broken."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "question-first charts",
+    "data-derived series",
+    "self-contained visualization"
+  ]
+}

package/data/craftbook-templates/ch/chrome-extension/versions/1.0.2/craftbook.json

@@ -0,0 +1,160 @@
+{
+  "id": "chrome-extension",
+  "name": "Browser Extension",
+  "description": "Build a Manifest V3 browser extension scaffold — a popup, a content script, and the manifest — that does one concrete thing on the current page (highlight, count, extract, or toggle). Scopes the single capability and the required permissions first, designs the popup UI, then builds a valid manifest.json plus popup and content-script files wired by messaging. Extensions fail at the manifest and the popup↔content messaging boundary, so the scope phase pins the exact MV3 permissions and message contract before any code, keeping a small model from producing a manifest the browser rejects.\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. Scope (planner) — the one capability + MV3 permissions + message contract → gated on artifact `{{workPath}}/scope.md` (markdown-notes)\n2. Popup UI design (designer) — popup layout, button, result display → gated on artifact `{{workPath}}/ui-design.md` (markdown-notes)\n3. Build (developer) — manifest.json + popup + content script → gated on `index.html` (html-page)\n\nThe gates never advance with an unmet criterion, and loop back to the\nowning phase to fix named gaps.\n",
+  "entryStepId": "scope",
+  "triggers": [
+    "chrome extension",
+    "browser extension",
+    "build an extension",
+    "manifest v3 extension",
+    "firefox extension",
+    "browser plugin"
+  ],
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope",
+      "description": "the one capability + MV3 permissions + message contract",
+      "prompt": "Scope the extension to ONE capability. (1) State exactly what it does on the current page in one sentence (e.g. 'count and highlight all links'). (2) List the minimum MV3 permissions and host_permissions needed and why — no over-permissioning. (3) Define the components: popup (trigger + display), content script (acts on the page), and the message contract between them (message names and payloads). (4) Decide what the popup shows back to the user. (5) Write an acceptance-criteria checklist of 5-8 items, e.g. 'manifest is valid MV3 (manifest_version 3)', 'the popup has a working button', 'clicking it messages the content script', 'the content script performs the action on the page', 'a result is shown in the popup', 'only the listed permissions are requested'. Write to {{workPath}}/scope.md and via write_task_note. No code yet.\n\nThe deliverable `{{workPath}}/scope.md` lands in the project's artifacts drawer — write it with `write_artifact` and read it back with `read_artifact`; the shipped workspace stays untouched.",
+      "suggestedRole": "planner",
+      "advanceWhen": {
+        "file": "{{workPath}}/scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/scope.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "scope",
+        "maxAttempts": 3
+      },
+      "next": "ui-design"
+    },
+    {
+      "id": "ui-design",
+      "name": "Popup UI design",
+      "description": "popup layout, button, result display",
+      "prompt": "Design the popup UI. (1) Pick a small fixed popup size and a clean palette (hex). (2) Lay out the action button(s) and the result/status area. (3) Specify states: idle, running, result, and error. (4) Keep styles self-contained in the popup. (5) Note any icon needs. Write the popup spec to {{workPath}}/ui-design.md and via write_task_note. No code yet.\n\nThe deliverable `{{workPath}}/ui-design.md` lands in the project's artifacts drawer — write it with `write_artifact` and read it back with `read_artifact`; the shipped workspace stays untouched.",
+      "suggestedRole": "designer",
+      "advanceWhen": {
+        "file": "{{workPath}}/ui-design.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/ui-design.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/ui-design.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "ui-design",
+        "maxAttempts": 3
+      },
+      "next": "build"
+    },
+    {
+      "id": "build",
+      "name": "Build",
+      "description": "manifest.json + popup + content script",
+      "prompt": "Build the extension files to the scope and UI spec. (1) Write a valid manifest.json with manifest_version 3, name, version, description, the exact permissions/host_permissions from scope, an action.default_popup, and a content_scripts entry. (2) Write popup.html + popup.js to the UI spec; the button sends the contract message to the active tab via chrome.tabs.query + chrome.tabs.sendMessage. (3) Write content.js that listens with chrome.runtime.onMessage, performs the page action, and replies with the result. (4) Render the reply in the popup, handling the error state. Bundle everything; the deliverable is index.html acting as the popup plus the supporting files. On a loop-back, fix only the named gaps. write_task_note the file paths and passing criteria.",
+      "suggestedRole": "developer",
+      "advanceWhen": {
+        "file": "index.html",
+        "minBytes": 1,
+        "sniff": "html-complete"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "index.html",
+            "bytes": 600
+          },
+          {
+            "kind": "htmlLint",
+            "file": "index.html"
+          },
+          {
+            "kind": "sniff",
+            "file": "manifest.json",
+            "sniff": "json-valid"
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkHtmlComplete",
+            "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": "Evaluate the extension scaffold. Read manifest.json, popup (index.html) + its JS, and the content script. Check EACH criterion from {{workPath}}/scope.md and write PASS/FAIL with a reason: is manifest.json valid JSON with manifest_version 3 and an action popup and content_scripts entry, does the popup have a working button, does it message the content script via chrome.tabs.sendMessage, does the content script onMessage perform the action and reply, does the popup show the result, are only the listed permissions requested? A manifest the browser would reject (missing manifest_version 3 or malformed) is a FAIL — loop back to build.\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",
+      "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",
+      "terminal": true
+    }
+  ],
+  "version": "1.0.2",
+  "releasedAt": "2026-08-21T00:00:00Z",
+  "paramSchema": {
+    "type": "object",
+    "properties": {
+      "workPath": {
+        "type": "string",
+        "title": "Working folder",
+        "description": "Per-task working folder in the artifacts drawer. Defaults to this task's own folder so runs never collide; override with a stable name when you deliberately want runs to share files.",
+        "default": "{{task.dir}}"
+      }
+    }
+  },
+  "minGezelVersion": "1.26233"
+}