@bendyline/gilde 0.1.3 → 0.1.5

package/data/craftbook-templates/pr/pre-departure-countdown/manifest.json

@@ -16,6 +16,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pr/press-release/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "plan-coordinate",
+  "accents": [
+    "ochre",
+    "sage",
+    "muted indigo"
+  ],
+  "sourceSummary": "Write a professional, AP-style press release ready to send to journalists: it first locks the news angle, the five W's, the approved quote(s), and the boilerplate, then drafts the release in the standard format — dateline, inverted-pyramid lede, supporting body, quotes, boilerplate, and media contact — then a review…",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pr/press-release/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pr/price-tracker/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "analyze-measure",
+  "accents": [
+    "muted indigo",
+    "ochre",
+    "sage"
+  ],
+  "sourceSummary": "Build a price tracker that records the price of one or more products/SKUs each time it runs, appending a timestamped history so you can see trends, drops, and the lowest price seen.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pr/price-tracker/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pr/pricing-page/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "build-code",
+  "accents": [
+    "muted indigo",
+    "terracotta",
+    "sage"
+  ],
+  "sourceSummary": "Build a single pricing or plan-comparison page with tiered plan cards, a feature comparison, a highlighted recommended plan, and optionally a monthly/annual toggle that updates prices.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pr/pricing-page/manifest.json

@@ -16,6 +16,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pr/product-descriptions/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "communicate-market",
+  "accents": [
+    "muted terracotta",
+    "dusty rose",
+    "sage"
+  ],
+  "sourceSummary": "Generate consistent, on-brand product descriptions in bulk from a list of products and their attributes: it first locks the brand voice, the field schema (title, short blurb, long description, bullet features, SEO meta), and a worked exemplar, then drafts every product to that exact template so the whole catalog reads…",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pr/product-descriptions/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pr/proposal-sow/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "write-publish",
+  "accents": [
+    "muted terracotta",
+    "muted indigo",
+    "sage"
+  ],
+  "sourceSummary": "Draft a client proposal or statement of work that wins the deal and prevents scope creep — covering objectives, scope, deliverables, timeline/milestones, pricing, assumptions, and acceptance criteria.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pr/proposal-sow/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pu/pull-request-review/art.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "inspect-review",
+  "accents": [
+    "muted terracotta",
+    "sage"
+  ],
+  "sourceSummary": "Staff-engineer-style PR review.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pu/pull-request-review/manifest.json

@@ -12,6 +12,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "review"

package/data/craftbook-templates/pu/pull-request-review/versions/1.1.0/craftbook.json

@@ -0,0 +1,118 @@
+{
+  "id": "pull-request-review",
+  "name": "Pull Request Review",
+  "description": "Staff-engineer-style code review. Five steps:\n\n1. **Load PR context** — figure out which PR, fetch metadata + diff\n2. **Scan diff** — pattern-based first-pass + judgment-based second-pass\n3. **Raise findings** or **Approve** — branches on whether issues were found\n4. **Summary** — stamp a final verdict to task notes\n\nPorted from gstack's `/review`. The bash-driven preamble (gstack-config,\ngstack-learnings-search, gstack-telemetry-log) is replaced by:\n\n- The `pr-context.ts` script loads PR metadata via `github_pr_view`/`github_pr_diff`\n- `diff-scan.ts` applies the safety/quality patterns from gstack's\n  `review/checklist.md` (SQL, secrets, `any`, console.log, etc.)\n- Memory (via `save_memory` / `search_memory`) replaces gstack's\n  `learnings.jsonl` — search prior reviews for \"have we seen this\n  pattern before?\"\n\nThe branches behavior: `diff-scan` stamps `clean: boolean` into the\nrun output; the **Scan diff** step routes to **Approve** when clean and\nto **Raise findings** otherwise.\n\nThis craftbook needs the github toolset configured (PAT) — without it,\nthe PR-fetch tools error and the craftbook surfaces an actionable\nmessage to the user.\n",
+  "entryStepId": "load-pr",
+  "triggers": [
+    "review this pr",
+    "code review",
+    "check my diff",
+    "review the changes"
+  ],
+  "requirements": [
+    {
+      "kind": "github"
+    },
+    {
+      "kind": "non-main-branch"
+    }
+  ],
+  "toolsets": [
+    {
+      "toolsetId": "github",
+      "optional": true,
+      "autoAllow": true,
+      "reason": "read PR metadata and post review comments without a prompt per call"
+    }
+  ],
+  "paramSchema": {
+    "type": "object",
+    "properties": {
+      "focus": {
+        "type": "string",
+        "title": "Review focus",
+        "description": "Optional area to emphasize, e.g. security, performance, tests."
+      },
+      "intensity": {
+        "type": "string",
+        "title": "Intensity",
+        "enum": [
+          "low",
+          "medium",
+          "high"
+        ],
+        "default": "medium",
+        "squisq": {
+          "control": "segmented"
+        },
+        "description": "How deep to go on the diff walk."
+      }
+    }
+  },
+  "steps": [
+    {
+      "id": "load-pr",
+      "name": "Load PR context",
+      "description": "Resolve which PR to review (current branch's open PR by default) and fetch its metadata + the unified diff. Writes pr.number, pr.title, pr.head into the task notes.",
+      "prompt": "**For this task you are a reviewer, not an author.** Your job here is to read changes and post feedback — NOT to write new code. If your default persona is a developer/builder, set the ship-the-scaffold instinct aside for this task. You won't `write_file` for this craftbook; you'll read PRs and post comments.\n\n**Your first action this turn:** call `github_pr_list` (no args). The result tells you which PR to review.\n\n1. If the user's chat message names a PR number, skip the list and use that.\n2. Otherwise, take the first PR from `github_pr_list`. If multiple match the current branch, call `ask_user_question` to disambiguate.\n3. Once you have the number, call `run_script({ name: \"pr-context\", input: { number } })` — it stamps the PR metadata + diff into the run output.\n4. `write_task_note({ ref, content })` with the PR title + URL so the next step has the anchor.\n\nDo NOT call `read_task_notes` to find the procedure — it's right here in this prompt. The notes only carry user input + prior step output; the **what to do** is in this step.",
+      "suggestedRole": "reviewer",
+      "onExit": {
+        "name": "pr-context",
+        "autoAdvanceWhen": {
+          "op": "ok"
+        }
+      },
+      "next": "scan-diff"
+    },
+    {
+      "id": "scan-diff",
+      "name": "Scan diff",
+      "description": "Walk the diff applying the safety/quality checklist. The diff-scan script returns a structured findings array.",
+      "prompt": "Run the `diff-scan` script. It fetches the PR diff via `github_pr_diff` and applies a pattern-based first-pass — SQL safety, unguarded `any`, console.log left in, secrets-in-source-shaped strings, missing test coverage for new files. Read its output carefully.\n\nThen do your own pass: use `github_pr_files` to walk individual files and apply judgment for things the pattern scan can't catch — naming, abstraction quality, error handling, edge cases. Take notes via `write_task_note`.\n\nAt the end of this step, you should know: did you find issues worth surfacing? Set `findings: <number>` in your output.",
+      "suggestedRole": "reviewer",
+      "gate": {
+        "at": "completion",
+        "scripts": [
+          {
+            "name": "diff-gate",
+            "scope": "craftbook"
+          }
+        ],
+        "onReject": "scan-diff",
+        "maxAttempts": 3
+      },
+      "next": "raise-findings"
+    },
+    {
+      "id": "raise-findings",
+      "name": "Raise findings",
+      "description": "Surface concrete issues with file:line citations. Use `github_pr_comment` to post the structured summary to the PR.",
+      "prompt": "For each finding, write a short paragraph:\n\n- **What** (one sentence describing the issue)\n- **Where** (file:line — the model citation hyperlink form, file_path:line)\n- **Why it matters** (one sentence)\n- **Suggested fix** (one line or a small diff)\n\nGroup findings by severity: must-fix (correctness, security, data-loss risk), should-fix (clarity, edge cases, missing tests), nit (style, naming).\n\nPost the summary via `github_pr_comment` with the PR number from step 1. Then advance to summary.",
+      "suggestedRole": "reviewer",
+      "next": "summary"
+    },
+    {
+      "id": "approve",
+      "name": "Approve",
+      "description": "Clean PR — write a brief approval note. Don't gold-plate.",
+      "prompt": "The diff scan came up clean. Write a one-paragraph approval note: what the PR does, why it looks good, anything worth flagging as 'consider for a follow-up' (but not blocking). Post via `github_pr_comment`. Advance to summary.",
+      "suggestedRole": "reviewer",
+      "next": "summary"
+    },
+    {
+      "id": "summary",
+      "name": "Summary",
+      "description": "Stamp a final summary into the task notes for the user.",
+      "prompt": "Write a one-paragraph summary of the review to the task notes via `write_task_note`. Include:\n\n- The PR (#number — title)\n- The verdict (approved | needs changes)\n- The number of findings broken down by severity\n- A link to the posted PR comment\n\nThen report DONE.",
+      "suggestedRole": "reviewer",
+      "terminal": true
+    }
+  ],
+  "scripts": {
+    "pr-context": "import { defineScript, gezel } from '@bendyline/gezel-sdk';\n\nexport const meta = defineScript({\n  name: 'pr-context',\n  description:\n    'Resolve which PR to review and fetch its metadata + unified diff. Stamps {number, title, headRef, baseRef, diffChars} so the next step has the anchor.',\n  inputs: {\n    number: {\n      type: 'number',\n      description: 'PR number to review. Omit to pick the open PR matching the current branch.',\n      integer: true,\n    },\n  },\n  outputs: {\n    number: { type: 'number', description: 'Resolved PR number.' },\n    title: { type: 'string', description: 'PR title.' },\n    headRef: { type: 'string', description: 'PR head branch.' },\n    baseRef: { type: 'string', description: 'PR base branch.' },\n    url: { type: 'string', description: 'PR URL.' },\n    diffChars: { type: 'number', description: 'Length of the fetched diff body in chars.' },\n  },\n  requires: ['network'],\n});\n\ninterface PrSummary {\n  number: number;\n  title: string;\n  author: string;\n  headRef: string;\n  baseRef: string;\n  draft: boolean;\n  updatedAt: string;\n  url: string;\n}\n\nasync function resolvePr(input: { number?: number }): Promise<PrSummary> {\n  if (input.number) {\n    const view = await gezel.mcp.call('github_pr_view', { number: input.number });\n    if (typeof view !== 'string') throw new Error('github_pr_view returned an unexpected shape');\n    const headLine = view.split('\\n')[0] ?? '';\n    const titleMatch = /^#(\\d+) — (.+)$/.exec(headLine);\n    if (!titleMatch) throw new Error(`could not parse github_pr_view output: ${headLine}`);\n    return {\n      number: Number(titleMatch[1]),\n      title: titleMatch[2]!,\n      author: '?',\n      headRef: '',\n      baseRef: '',\n      draft: false,\n      updatedAt: '',\n      url: '',\n    };\n  }\n  const listing = await gezel.mcp.call('github_pr_list', {});\n  if (typeof listing !== 'string') throw new Error('github_pr_list returned an unexpected shape');\n  const firstLine = listing.split('\\n\\n')[0] ?? '';\n  const m = /^#(\\d+) — (.+?) \\((.+?), (.+?) → (.+?)(?:, draft)?\\)/.exec(firstLine);\n  if (!m) {\n    throw new Error(\n      `couldn't pick a PR — github_pr_list returned no open PRs or unexpected shape:\\n${listing.slice(0, 200)}`,\n    );\n  }\n  return {\n    number: Number(m[1]),\n    title: m[2]!,\n    author: m[3]!,\n    headRef: m[4]!,\n    baseRef: m[5]!,\n    draft: firstLine.includes('draft'),\n    updatedAt: '',\n    url: '',\n  };\n}\n\nasync function main(): Promise<void> {\n  const input = gezel.input as { number?: number };\n  const pr = await resolvePr(input);\n  gezel.log(`Resolved PR #${pr.number} — \"${pr.title}\"`);\n  const diff = await gezel.mcp.call('github_pr_diff', { number: pr.number });\n  const diffStr = typeof diff === 'string' ? diff : '';\n  gezel.output({\n    number: pr.number,\n    title: pr.title,\n    headRef: pr.headRef,\n    baseRef: pr.baseRef,\n    url: pr.url,\n    diffChars: diffStr.length,\n  });\n}\n\nawait main();\n",
+    "diff-scan": "import { defineScript, gezel } from '@bendyline/gezel-sdk';\n\nexport const meta = defineScript({\n  name: 'diff-scan',\n  description:\n    'Pattern-scan a PR diff for common safety/quality issues — SQL concat, unguarded any, console.log leftovers, secret-shaped strings, missing tests. Stamps {findings[], clean: boolean}.',\n  inputs: {\n    number: { type: 'number', description: 'PR number.', integer: true, required: true },\n  },\n  outputs: {\n    findings: {\n      type: 'array',\n      description: 'Issues found, each with file, line, severity, kind, snippet.',\n      itemType: 'object',\n    },\n    clean: { type: 'boolean', description: 'True iff no must-fix or should-fix findings.' },\n  },\n  requires: ['network'],\n});\n\ntype Severity = 'must-fix' | 'should-fix' | 'nit';\n\ninterface Finding {\n  file: string;\n  line: number;\n  severity: Severity;\n  kind: string;\n  snippet: string;\n}\n\nconst RULES: Array<{\n  kind: string;\n  severity: Severity;\n  regex: RegExp;\n  description: string;\n}> = [\n  {\n    kind: 'sql-concat',\n    severity: 'must-fix',\n    regex: /(query|sql|execute)\\s*\\(\\s*[\"'`][^\"'`]*\\$\\{|\\b\\+\\s*req\\.(query|body|params)\\./i,\n    description: 'String-concatenated SQL or user input flowing into a query.',\n  },\n  {\n    kind: 'console-leftover',\n    severity: 'nit',\n    regex: /^\\+.*\\bconsole\\.(log|warn|error|debug)\\b/,\n    description: 'console.* call left in production code.',\n  },\n  {\n    kind: 'secret-shape',\n    severity: 'must-fix',\n    regex: /(api[_-]?key|secret|token|password)\\s*[:=]\\s*[\"'][A-Za-z0-9+/=_-]{16,}[\"']/i,\n    description: 'String-literal that looks like a hard-coded credential.',\n  },\n  {\n    kind: 'unguarded-any',\n    severity: 'should-fix',\n    regex: /:\\s*any\\b(?!\\[)|<any>/,\n    description: \"Explicit `any` — confirm it's the minimum-friction choice, not a bypass.\",\n  },\n  {\n    kind: 'todo-marker',\n    severity: 'nit',\n    regex: /^\\+.*\\b(TODO|FIXME|XXX)\\b/,\n    description: 'TODO/FIXME left behind. Either resolve or open an issue.',\n  },\n  {\n    kind: 'force-unwrap',\n    severity: 'should-fix',\n    regex: /^\\+.*![.\\s]/,\n    description: 'Non-null assertion (`!`) — confirm the invariant or add a guard.',\n  },\n];\n\ninterface ParsedHunk {\n  file: string;\n  baseLine: number;\n  text: string;\n}\n\nfunction* iterHunks(diff: string): Generator<ParsedHunk> {\n  let currentFile = '';\n  let inHunk = false;\n  let baseLine = 0;\n  const lines = diff.split('\\n');\n  for (let i = 0; i < lines.length; i++) {\n    const ln = lines[i]!;\n    const fileMatch = /^\\+\\+\\+ b\\/(.+)$/.exec(ln);\n    if (fileMatch) {\n      currentFile = fileMatch[1]!;\n      inHunk = false;\n      continue;\n    }\n    const hunkMatch = /^@@ -\\d+(?:,\\d+)? \\+(\\d+)(?:,\\d+)? @@/.exec(ln);\n    if (hunkMatch) {\n      baseLine = Number(hunkMatch[1]);\n      inHunk = true;\n      continue;\n    }\n    if (!inHunk || !currentFile) continue;\n    if (ln.startsWith('+') && !ln.startsWith('+++')) {\n      yield { file: currentFile, baseLine, text: ln };\n      baseLine++;\n    } else if (!ln.startsWith('-')) {\n      baseLine++;\n    }\n  }\n}\n\nasync function main(): Promise<void> {\n  const input = gezel.input as { number: number };\n  const diff = await gezel.mcp.call('github_pr_diff', { number: input.number });\n  if (typeof diff !== 'string') {\n    throw new Error('github_pr_diff returned an unexpected shape');\n  }\n  const findings: Finding[] = [];\n  for (const hunk of iterHunks(diff)) {\n    for (const rule of RULES) {\n      if (rule.regex.test(hunk.text)) {\n        findings.push({\n          file: hunk.file,\n          line: hunk.baseLine,\n          severity: rule.severity,\n          kind: rule.kind,\n          snippet: hunk.text.slice(1, 140),\n        });\n      }\n    }\n  }\n  const blocking = findings.filter((f) => f.severity !== 'nit');\n  gezel.log(`Scanned diff: ${findings.length} finding(s), ${blocking.length} blocking`);\n  gezel.output({ findings, clean: blocking.length === 0 });\n}\n\nawait main();\n",
+    "diff-gate": "import { defineScript, gezel } from '@bendyline/gezel-sdk';\n\nexport const meta = defineScript({\n  name: 'diff-gate',\n  description:\n    'Gate for the scan-diff phase: runs diff-scan and routes the review — a clean diff approves straight to the approve step; findings approve to raise-findings with the findings carried in the handoff.',\n  kind: 'gate',\n  outputs: {\n    decision: { type: 'string', description: \"'approve' (the scan itself succeeding is the bar).\" },\n    message: { type: 'string', description: 'One-line scan summary.' },\n  },\n  // Nested script execution inherits diff-scan's needs; the scan itself\n  // declares 'network'.\n  requires: ['network'],\n});\n\ninterface ScanOutput {\n  clean: boolean;\n  findings?: Array<{ severity?: string; note?: string; file?: string }>;\n}\n\n// Gate-as-router: the step \"completing\" means the scan ran — the JUDGMENT\n// here is which branch the review takes next, expressed as approve+goto.\n// A scan failure rejects (fail-closed) so a broken scan never silently\n// approves a PR.\nconst result = await gezel.script.run<ScanOutput>('diff-scan');\nif (result.status !== 'ok' || !result.output) {\n  gezel.output({\n    decision: 'reject',\n    message: `diff-scan failed (${result.error ?? 'no output'}) — fix the scan inputs (is the PR context loaded?) and advance again.`,\n  });\n} else if (result.output.clean) {\n  gezel.output({\n    decision: 'approve',\n    goto: 'approve',\n    message: 'diff-scan found no must-fix or should-fix issues',\n    handoff: { message: 'Automated diff scan came back clean — proceed to approval.' },\n  });\n} else {\n  const findings = result.output.findings ?? [];\n  const top = findings\n    .slice(0, 5)\n    .map((f) => `- [${f.severity ?? 'note'}] ${f.file ?? ''} ${f.note ?? ''}`.trim())\n    .join('\\n');\n  gezel.output({\n    decision: 'approve',\n    goto: 'raise-findings',\n    message: `diff-scan flagged ${findings.length} finding(s)`,\n    handoff: {\n      message: `Automated diff scan flagged ${findings.length} finding(s) to raise on the PR:\\n${top}`,\n      params: { findingCount: findings.length },\n    },\n  });\n}\n"
+  },
+  "version": "1.1.0",
+  "releasedAt": "2026-07-28T00:00:00Z"
+}

package/data/craftbook-templates/pu/pull-request-review/versions/1.1.0/test.json

@@ -0,0 +1,160 @@
+{
+  "schemaVersion": 1,
+  "title": "Pull-request style code review with citations",
+  "objective": "Measure the PR-review task class with a seeded codebase review requiring concrete findings, severity, file citations, and no prose-as-deliverable failure.",
+  "tags": [
+    "external"
+  ],
+  "prompt": "Theres a fake ops service wired up for this so nothing real gets touched — the endpoints are in mocks/services.md, and the ready-made mock-probe script talks to them for you. Can you run the automation against it and write up how it went in automation.md?",
+  "setup": {
+    "projectName": "Pull Request Review Eval",
+    "files": [
+      {
+        "path": "source/brief.md",
+        "content": "# Pull Request Review Eval Brief\n\nClient: Boreal Desk, a home-office accessories company.\nAudience: operations leads who need an artifact they can use this week.\n\nFixed source facts for grounding:\n- The returns desk pilot covered 18 SKUs.\n- Median first response improved from 18 hours to 6 hours.\n- Preventable refund leakage fell from 14.2% to 8.9%.\n- The top unresolved complaint is status silence after photo submission.\n- Required next actions are automated status emails, barcode-exception training, and a weekly Finance exception export.\n\nUse these facts when the task asks for prose, analysis, copy, UI content, or test data. Do not use live web services, real credentials, or current outside data.\n\nCraftbook under test: pull-request-review - Pull Request Review.\n"
+      }
+    ],
+    "worker": {
+      "name": "Jules",
+      "role": "Developer"
+    }
+  },
+  "mocks": [
+    {
+      "kind": "http",
+      "id": "ops",
+      "description": "Fake operations service for this eval. GET /api/bookings/open lists the open work items; POST /api/bookings/dry-run records a simulated submission and returns DRY_RUN_OK.",
+      "credential": {
+        "name": "mock.ops"
+      },
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/bookings/open",
+          "body": {
+            "items": [
+              "BKG-1001",
+              "BKG-1002",
+              "BKG-1003"
+            ]
+          }
+        },
+        {
+          "method": "POST",
+          "path": "/api/bookings/dry-run",
+          "status": 201,
+          "body": {
+            "status": "DRY_RUN_OK",
+            "recorded": 3
+          }
+        }
+      ]
+    },
+    {
+      "kind": "webhook",
+      "id": "notify",
+      "description": "Notification receiver. POST a JSON completion notice here when the run finishes.",
+      "path": "/hooks/notify"
+    },
+    {
+      "kind": "cli",
+      "id": "probe",
+      "description": "Provenance-trusted project script `mock-probe` that exercises the fake ops service through http.authed and returns the raw responses.",
+      "shim": {
+        "path": "scripts/mock-probe.ts",
+        "content": "import { defineScript, gezel } from '@bendyline/gezel-sdk';\n\nexport const meta = defineScript({\n  name: 'mock-probe',\n  description:\n    'Probe the live fake ops service for this eval: lists the open work items and records a dry-run submission. Outputs the raw JSON responses as evidence for the write-up.',\n  inputs: {},\n  outputs: {\n    open: { type: 'string', description: 'Raw JSON body from the open-items listing.' },\n    dryRun: { type: 'string', description: 'Raw JSON body from the dry-run submission.' },\n  },\n  requires: ['workspace.read', 'network', 'credential:mock.ops'],\n});\n\nconst services = JSON.parse(await gezel.fs.read('mocks/services.json'));\nconst base = (id) => {\n  const service = services.find((entry) => entry.id === id);\n  if (!service) throw new Error(`mock service \"${id}\" is not listed in mocks/services.json`);\n  return service.baseUrl;\n};\n\nconst open = await gezel.http.authed(`${base('ops')}/api/bookings/open`, {\n  credential: 'mock.ops',\n});\nif (!open.ok) throw new Error(`open-items listing failed: ${open.status} ${open.body}`);\n\nconst dryRun = await gezel.http.authed(`${base('ops')}/api/bookings/dry-run`, {\n  credential: 'mock.ops',\n  method: 'POST',\n  body: JSON.stringify({ items: JSON.parse(open.body).items, mode: 'dry-run' }),\n});\nif (!dryRun.ok) throw new Error(`dry-run submission failed: ${dryRun.status} ${dryRun.body}`);\n\ngezel.output({ open: open.body, dryRun: dryRun.body });\n"
+      }
+    }
+  ],
+  "success": {
+    "summary": "automation.md is grounded in live fake-service responses: the open items were actually listed and a dry-run actually recorded (request-log assertions), with safety guards and signals described.",
+    "deliverables": [
+      {
+        "path": "automation.md",
+        "kind": "markdown-report",
+        "minBytes": 900,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "automation.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "automation.md",
+            "pattern": "DRY_RUN_OK|dry-run|dry run",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "automation.md",
+            "pattern": "fake-ci|fake-github|/api/bookings",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "automation.md",
+            "pattern": "no real|credentials|safety|guard",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "automation.md",
+            "pattern": "success|failure|retry|abort",
+            "flags": "i"
+          }
+        ]
+      }
+    ],
+    "mocks": [
+      {
+        "service": "ops",
+        "minRequests": 2,
+        "requiredPaths": [
+          "^/api/bookings/open$",
+          "^/api/bookings/dry-run$"
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "automation.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "safety",
+        "description": "Dry-run posture is explicit: no real credentials, clear stop-before-side-effect boundary."
+      },
+      {
+        "name": "mapping",
+        "description": "Fake endpoints/commands are mapped completely to the workflow steps."
+      },
+      {
+        "name": "signals",
+        "description": "Success, failure, retry, and abort conditions are all defined."
+      },
+      {
+        "name": "containment",
+        "description": "The plan cannot accidentally reach a real service from a mock context."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "evidence-grounded review",
+    "file citations",
+    "review deliverable persistence"
+  ],
+  "extensions": {
+    "legacySimulators": [
+      {
+        "id": "pull-request-review-fake-service-fixture",
+        "kind": "data-source",
+        "status": "implemented",
+        "description": "Seeded local fake service contract replacing live CLIs, HTTP APIs, credentials, and side effects."
+      }
+    ]
+  }
+}

package/data/craftbook-templates/pu/puzzle-pack-layout/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "write-publish",
+  "accents": [
+    "muted terracotta",
+    "muted indigo",
+    "sage"
+  ],
+  "sourceSummary": "Bind the month's puzzles into one print-ready pack: a cover, a page per puzzle, and the solutions gathered in the back where they belong — the thing that lands on the kitchen table and disappears into pencil marks.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pu/puzzle-pack-layout/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/pw/pwa-offline/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "build-code",
+  "accents": [
+    "muted indigo",
+    "terracotta",
+    "sage"
+  ],
+  "sourceSummary": "Build an installable Progressive Web App that works offline — an HTML app shell, a web app manifest, and a service worker that caches the shell so it loads with no network.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/pw/pwa-offline/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/qa/qa/art.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "inspect-review",
+  "accents": [
+    "muted terracotta",
+    "sage"
+  ],
+  "sourceSummary": "Live UI QA pass with a real browser.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/qa/qa/manifest.json

@@ -12,6 +12,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "qa"

package/data/craftbook-templates/qu/quarterly-summary/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "write-publish",
+  "accents": [
+    "muted terracotta",
+    "muted indigo",
+    "sage"
+  ],
+  "sourceSummary": "Close the quarter the way your accountant wishes everyone did: totals by category computed from the ledger entries themselves, the missing-documentation list naming each entry that lacks its paperwork, and the estimated-payment reminder in plain words.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/qu/quarterly-summary/manifest.json

@@ -16,6 +16,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/re/reading-list/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "research-learn",
+  "accents": [
+    "sage",
+    "muted indigo",
+    "terracotta"
+  ],
+  "sourceSummary": "Curate an annotated reading list on a topic for a defined reader: a planner sets the reader, their goal, and the selection and ordering criteria, then a researcher curates and annotates each pick with why it matters, what it covers, and a suggested reading order.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/re/reading-list/manifest.json

@@ -15,6 +15,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/re/receipt-intake/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "operate-maintain",
+  "accents": [
+    "sage",
+    "ochre",
+    "muted terracotta"
+  ],
+  "sourceSummary": "Empty the shoebox inbox properly: every waiting receipt becomes a dated, categorized ledger entry that names its source file, likely duplicates get flagged instead of double-counted, and the genuinely ambiguous ones become owner questions instead of guesses.",
+  "styleReference": "accessibility-audit-1910"
+}

package/data/craftbook-templates/re/receipt-intake/manifest.json

@@ -16,6 +16,7 @@
   "maintainer": {
     "name": "Gezel"
   },
+  "logo": "logo.webp",
   "license": "MIT",
   "yankedVersions": [],
   "workflow": "build-loop"

package/data/craftbook-templates/re/receipt-ocr-ledger/art.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "promptVersion": "workshop-mark-1910-v2",
+  "periodCue": "circa-1910-subtle",
+  "family": "design-media",
+  "accents": [
+    "muted terracotta",
+    "sage",
+    "muted indigo"
+  ],
+  "sourceSummary": "Turn a folder of receipt photos/PDFs into a clean expense ledger: OCR each receipt, extract vendor, date, line items, tax, and total, assign an expense category, and reconcile that each extracted total matches its line items.",
+  "styleReference": "accessibility-audit-1910"
+}