@bendyline/gilde 0.1.51 → 0.1.52

package/data/craftbook-templates/da/data-to-report/versions/1.0.3/test.json

@@ -0,0 +1,98 @@
+{
+  "schemaVersion": 1,
+  "title": "Executive report from seeded data",
+  "objective": "Measure whether the data-to-report craftbook analyzes seeded data first and produces a narrative report grounded in computed figures.",
+  "tags": [
+    "data"
+  ],
+  "prompt": "In the `Data to Report Eval` project, read `data/returns-summary.csv` and write `tasks/eval/report.md`: an executive report for support leadership. Include an executive summary, key metrics table, findings, segment trends, recommendations, and limitations. Ground every claim in the seeded figures.",
+  "setup": {
+    "projectName": "Data to Report Eval",
+    "about": "Self-contained eval project for the data-to-report craftbook. The dataset is workspace/data/returns-summary.csv.",
+    "missionObjectives": "Write an executive analytical report from seeded data with summary, metrics table, findings, recommendations, and limitations.",
+    "files": [
+      {
+        "path": "data/returns-summary.csv",
+        "content": "month,region,return_rate,refund_leakage,response_hours,escalations\nMarch,West,0.112,0.142,18,44\nApril,West,0.108,0.101,9,31\nMay,West,0.099,0.089,6,25\nMarch,East,0.087,0.096,15,21\nApril,East,0.091,0.094,13,24\nMay,East,0.088,0.092,12,22\n"
+      }
+    ],
+    "worker": {
+      "name": "Mats",
+      "role": "Data Analyst"
+    },
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "workspace/report.md is a narrative analytical report with metrics table, findings, recommendations, and limitations grounded in seeded data.",
+    "deliverables": [
+      {
+        "path": "tasks/eval/report.md",
+        "kind": "markdown-report",
+        "minBytes": 2200,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "Executive summary|Key metrics|Findings|Recommendations|Limitations",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "March|April|May|West|East"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "14\\.2%|8\\.9%|18|6|44|25",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "refund leakage|response hours|escalations|return rate",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "table|\\|",
+            "flags": "i"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "tasks/eval/report.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "accuracy",
+        "description": "Computed figures are correct against the seeded records."
+      },
+      {
+        "name": "grounding",
+        "description": "Every claim traces to the seeded data — nothing invented."
+      },
+      {
+        "name": "structure",
+        "description": "Tables and sections make the analysis checkable at a glance."
+      },
+      {
+        "name": "actionability",
+        "description": "Recommendations follow from the findings and are concretely doable."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "analysis before narrative",
+    "source-grounded figures",
+    "limitations"
+  ]
+}

package/data/craftbook-templates/da/data-viz-page/versions/1.0.3/craftbook.json

@@ -0,0 +1,281 @@
+{
+  "id": "data-viz-page",
+  "name": "Data Visualization Explorer",
+  "description": "Build a single interactive chart or data explorer page — bar, line, scatter, or pie — driven by sample or provided data, with controls to filter, switch series, or change the dimension and a tooltip on hover. Scopes the dataset and the question the chart answers first, then the chart type and encodings, then implements a canvas or SVG chart with real interactivity. A chart that does not map data to pixels correctly is worse than a table, so the data and chart-design phases lock the encoding and the axes before any rendering code.\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. Data scope (planner) — dataset shape + the question the chart answers → gated on artifact `{{workPath}}/data-scope.md` (markdown-notes)\n2. Chart design (designer) — chart type, encodings, axes, legend, tooltip → gated on artifact `{{workPath}}/chart-design.md` (markdown-notes)\n3. Build (developer) — implement index.html with the interactive chart → 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": "data-scope",
+  "triggers": [
+    "data visualization",
+    "interactive chart",
+    "data explorer",
+    "build a chart",
+    "visualize data",
+    "graph page"
+  ],
+  "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}}"
+      }
+    }
+  },
+  "steps": [
+    {
+      "id": "data-scope",
+      "name": "Data scope",
+      "description": "dataset shape + the question the chart answers",
+      "prompt": "Scope the data and the question. (1) Define the dataset shape (fields, types) and embed a realistic sample array if none is provided. (2) State the ONE question the chart answers (e.g. 'how do sales trend by month?'). (3) Identify the dimension(s) and measure(s) to plot and any aggregation. (4) Decide the interactive controls (filter, series toggle, dimension switch) and the hover tooltip content. (5) Write an acceptance-criteria checklist of 5-8 items, e.g. 'the chart renders from the data', 'axes are labeled with correct scales', 'a hover tooltip shows the underlying value', 'a control filters or switches the view and the chart updates', 'responsive', 'no console errors'. Write to {{workPath}}/data-scope.md and via write_task_note. No chart code yet.\n\nThe deliverable `{{workPath}}/data-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}}/data-scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/data-scope.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/data-scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "data-scope",
+        "maxAttempts": 3
+      },
+      "next": "chart-design",
+      "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"
+        ]
+      }
+    },
+    {
+      "id": "chart-design",
+      "name": "Chart design",
+      "description": "chart type, encodings, axes, legend, tooltip",
+      "prompt": "Design the chart precisely. (1) Choose the chart type that fits the question and justify it in one line. (2) Map each variable to a visual channel (x, y, color, size) and define the axis scales and ranges. (3) Specify the legend, gridlines, color palette (hex), and the tooltip layout. (4) Design the control affordances (dropdown/buttons) and the empty/loading state. (5) Self-contained — canvas or inline SVG, no chart-library CDN. Write the visual spec to {{workPath}}/chart-design.md and via write_task_note. No HTML yet.\n\nThe deliverable `{{workPath}}/chart-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}}/chart-design.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/chart-design.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/chart-design.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "chart-design",
+        "maxAttempts": 3
+      },
+      "next": "build",
+      "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"
+        ]
+      }
+    },
+    {
+      "id": "build",
+      "name": "Build",
+      "description": "implement index.html with the interactive chart",
+      "prompt": "Implement index.html with inline CSS/JS to the chart and data scope. (1) Embed the data and compute scales mapping data values to pixel coordinates correctly (mind the inverted y-axis). (2) Render the chart with labeled axes, gridlines, and a legend via canvas or SVG. (3) Implement the hover tooltip showing the underlying value at the cursor's data point. (4) Wire the controls so changing them recomputes and re-renders the chart. (5) Make it responsive; vanilla JS, no CDN. Verify a couple of plotted points sit at the right coordinates. On a loop-back, fix only the named gaps without regressing passing criteria. write_task_note the path and passing criteria.",
+      "suggestedRole": "developer",
+      "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",
+      "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"
+        ],
+        "outputMedium": "workspace",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      }
+    },
+    {
+      "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 explorer. Open/render index.html, hover for tooltips, and operate every control. Check EACH criterion from {{workPath}}/data-scope.md and write PASS/FAIL with a reason: does the chart render from the data, are axes labeled with correct scales, does the tooltip show the right underlying value, does a control update the chart, is it responsive, zero console errors? Verify one data point's screen position against its value by hand — a mis-scaled axis 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",
+      "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"
+      }
+    },
+    {
+      "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,
+      "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"
+      }
+    }
+  ],
+  "version": "1.0.3",
+  "releasedAt": "2026-09-01T20:00:00Z",
+  "minGezelVersion": "1.26233"
+}

package/data/craftbook-templates/da/data-viz-page/versions/1.0.3/test.json

@@ -0,0 +1,117 @@
+{
+  "schemaVersion": 1,
+  "title": "Source-grounded data visualization page",
+  "objective": "Measure whether the data-viz-page craftbook scopes a chart and builds a self-contained HTML visualization from seeded metrics.",
+  "tags": [
+    "html-page"
+  ],
+  "prompt": "In the `Data Viz Page Eval` project, read `source/metrics.csv` and build `index.html`: a responsive one-page visualization of weekly conversion rate by region. Include a chart using inline SVG or canvas, a legend for North/South/West, a short insight summary grounded in the data, and hover/click affordance text or tooltip behavior. Inline CSS/JS only, no external assets.",
+  "setup": {
+    "projectName": "Data Viz Page Eval",
+    "about": "Self-contained eval project for data-viz-page. Source metrics are in workspace/source/metrics.csv and the deliverable is workspace/index.html.",
+    "missionObjectives": "Build a self-contained chart page from the seeded conversion-rate data with grounded summary and visible chart/legend behavior.",
+    "files": [
+      {
+        "path": "source/metrics.csv",
+        "content": "week,region,conversion_rate\n2026-W01,North,0.41\n2026-W01,South,0.34\n2026-W01,West,0.29\n2026-W02,North,0.45\n2026-W02,South,0.36\n2026-W02,West,0.31\n2026-W03,North,0.53\n2026-W03,South,0.39\n2026-W03,West,0.35\n2026-W04,North,0.51\n2026-W04,South,0.47\n2026-W04,West,0.38\n"
+      }
+    ],
+    "worker": {
+      "name": "Daan",
+      "role": "Developer"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "index.html is a complete chart page grounded in the seeded regional conversion data.",
+    "deliverables": [
+      {
+        "path": "index.html",
+        "kind": "html-page",
+        "minBytes": 3400,
+        "checks": [
+          {
+            "kind": "cssMinBytes",
+            "bytes": 700,
+            "file": "index.html"
+          },
+          {
+            "kind": "jsParses",
+            "file": "index.html"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "svg|canvas",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "North",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "South",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "West",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "conversion",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "legend|tooltip|hover",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "0\\.53|53%|0\\.47|47%",
+            "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": [
+    "data grounding",
+    "chart semantics",
+    "interactive HTML"
+  ]
+}