@bendyline/gilde 0.1.37 → 0.1.39

package/data/craftbook-templates/re/rest-api/versions/1.0.3/test.json

@@ -0,0 +1,390 @@
+{
+  "schemaVersion": 1,
+  "title": "REST API contract and implementation",
+  "objective": "Measure the REST API craftbook shape with a deterministic bookstore API brief requiring OpenAPI, a dependency-free Node server, contract tests, pagination, auth, and error handling.",
+  "tags": [
+    "code"
+  ],
+  "prompt": "In the `REST API Eval` project, read `source/api-brief.md` and write `openapi.yaml`, `server.mjs`, `contract-test.mjs`, and `README.md`. Keep the implementation offline and dependency-free using Node ESM and `node:http` in the server only; do not use `require`, `node-fetch`, Express, Fastify, `/api/v1` prefixes, or package installs. Implement the exact paths GET /books, GET /books/{id}, and POST /books. `openapi.yaml` must use OpenAPI `3.1.0`, define `components.securitySchemes.bearerAuth`, apply that bearer auth to POST /books, define an `ErrorEnvelope` schema, and mention error codes `VALIDATION_ERROR` and `BOOK_NOT_FOUND`. `server.mjs` must export `createBookstoreServer()` without starting the listener itself, must enforce exact `Authorization: Bearer eval-token` on POST /books with 401 for missing/wrong tokens, must not import from `./server` or `./server.mjs`, and must not replace the native `server.close` method. In `server.mjs`, import the HTTP module normally at top level with `import http from 'node:http'` or `import { createServer } from 'node:http'`; do not use `await import('node:http')`. The ban on `node:http` imports applies only to `contract-test.mjs`. In every `server.mjs` route branch, send exactly one response per request: after any `sendResponse`, `sendJson`, `res.writeHead`, or `res.end` for auth, validation, not-found, or success, immediately `return` so the code never falls through into another response. `contract-test.mjs` must be a complete runnable file with no placeholder elisions like `... rest of file`. It must import `createBookstoreServer` from exactly `./server.mjs`, import assertions from `node:assert/strict`, must not import `node:http`, must call `createBookstoreServer()` and run the tests at top level when invoked with `node contract-test.mjs`, call `server.listen(0)` itself, resolve the assigned port inside the `listen(0)` callback using `server.address().port`, build every request URL from that resolved `baseUrl` including the assigned port, and never use `new URL(path, 'http://localhost')` because it drops the port. Use Node's built-in global `fetch()` directly or through a helper that calls `globalThis.fetch(url, options)`, declare any helper that awaits `fetch()` as `async`, pass POST `method`, `headers`, and `body` options through to `fetch`, and make the helper return status plus parsed JSON for all HTTP statuses instead of throwing on expected 400/401/404 responses. Run and log pagination/not-found/auth failure/validation failure/create success checks, include an explicit pagination request using `/books?limit=2` or equivalent URLSearchParams limit=2, run non-mutating checks before the create-success mutation or otherwise isolate state, and close the server cleanly. Do not wait for a `listening` event after `listen()` has already fired. Do not define or export tests that are never called. If you catch a test failure, log `error.stack ?? error` before rethrowing or setting a non-zero exit code; do not print only a generic failure banner. `README.md` must include a Usage section with these exact command lines: `node server.mjs` and `node contract-test.mjs`. It must also list GET /books, GET /books/{id}, POST /books, and show `Authorization: Bearer eval-token` for POST.",
+  "setup": {
+    "projectName": "REST API Eval",
+    "about": "Self-contained eval project for REST API craftbook behavior. The API brief is in workspace/source/api-brief.md and no live service or package install is needed.",
+    "missionObjectives": "Build a dependency-free API contract, server stub, tests, and run notes from the seeded brief. Do not use external services or credentials.",
+    "files": [
+      {
+        "path": "source/api-brief.md",
+        "content": "# Bookstore API brief\n\nResource: books for a small local bookstore.\nOpenAPI version: 3.1.0.\nSeed books: bk-1 The Left Hand of Darkness by au-1; bk-2 Parable of the Sower by au-2; bk-3 A Wizard of Earthsea by au-1.\nEndpoints:\n- GET /books?limit=&offset= returns `{ items, pagination: { limit, offset, total, hasMore } }`.\n- GET /books/{id} returns one book or 404 `{ error: { code: \"BOOK_NOT_FOUND\", message } }`.\n- POST /books creates a book and requires `Authorization: Bearer eval-token`.\n- POST body requires title and authorId. Missing fields return 400 `{ error: { code: \"VALIDATION_ERROR\", message } }`.\nOpenAPI auth requirement: define `components.securitySchemes.bearerAuth` with HTTP bearer auth and add `security: [{ bearerAuth: [] }]` to POST /books.\nOpenAPI must define an `ErrorEnvelope` schema shaped like `{ error: { code, message } }` and must mention `VALIDATION_ERROR` and `BOOK_NOT_FOUND` as concrete error codes.\nImplementation constraints: Node ESM, built-in modules only, no Express/Fastify/package install, server exports a `createBookstoreServer()` helper for tests and does not call listen() inside that helper. `server.mjs` must import the HTTP module normally at top level, such as `import http from \"node:http\"` or `import { createServer } from \"node:http\"`; do not use `await import(\"node:http\")`. `server.mjs` must enforce exact `Authorization: Bearer eval-token` on POST /books and return 401 for missing or wrong tokens. Every route branch in `server.mjs` must send exactly one response per request; after an auth, validation, not-found, or success response, immediately `return` so later code cannot write headers again. `server.mjs` must not import itself or import from `./server` or `./server.mjs`, and must not assign or replace `server.close`.\nTests must be complete runnable files with no placeholder elisions. They must import from exactly ./server.mjs, use node:assert/strict, call createBookstoreServer(), and run the tests at top level when `node contract-test.mjs` executes. Use the built-in global fetch() directly or through a helper that calls globalThis.fetch(url, options), call server.listen(0), resolve the assigned port inside the listen callback with server.address().port, and build request URLs from that resolved baseUrl before making requests. Do not use `new URL(path, \"http://localhost\")` in contract-test.mjs because it drops the assigned port. Do not wait for a `listening` event after `listen()` has already fired. Do not import node:http, node-fetch, or replace the global fetch function. If a helper uses `await fetch(...)`, declare that helper with `async function` or as an async arrow function, and pass POST method/headers/body options through to fetch. The helper must not throw on expected 400/401/404 HTTP responses; return status plus parsed JSON so negative tests can assert error codes. Do not catch assertion failures unless you log `error.stack ?? error` and then rethrow them or set a non-zero exit code. Run and log pagination, not-found, auth failure, validation failure, and create-success checks; the pagination check must explicitly request limit=2. Do not define or export tests that are never called. Run non-mutating checks before create success, or isolate/reset server state so pagination totals do not assume the seeded count after a create. Close the server cleanly.\nREADME must include a Usage section that shows these exact command lines: `node server.mjs` and `node contract-test.mjs`. It must also list GET /books, GET /books/{id}, POST /books, and the POST header `Authorization: Bearer eval-token`."
+      }
+    ],
+    "worker": {
+      "name": "Ravi",
+      "role": "Developer"
+    },
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "The run writes a contract, dependency-free server, contract tests, and run notes covering pagination, auth, validation, and error semantics.",
+    "deliverables": [
+      {
+        "path": "openapi.yaml",
+        "kind": "yaml-spec",
+        "minBytes": 1600,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "openapi:\\s*3\\.1"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "/books:"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "/books/\\{id\\}:"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "post:|POST",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "bearerAuth|Authorization",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "hasMore|pagination"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "ErrorEnvelope"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "VALIDATION_ERROR",
+            "label": "document VALIDATION_ERROR as a concrete error code"
+          },
+          {
+            "kind": "contains",
+            "file": "openapi.yaml",
+            "pattern": "BOOK_NOT_FOUND",
+            "label": "document BOOK_NOT_FOUND as a concrete error code"
+          },
+          {
+            "kind": "notContains",
+            "file": "openapi.yaml",
+            "pattern": "/api/v1",
+            "label": "use the exact bare paths /books and /books/{id}; do not add /api/v1"
+          }
+        ]
+      },
+      {
+        "path": "server.mjs",
+        "kind": "code-module",
+        "minBytes": 2200,
+        "checks": [
+          {
+            "kind": "esmImports",
+            "file": "server.mjs"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "node:http|createServer"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "GET.*\\/books|\\/books",
+            "flags": "is"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "POST.*\\/books|method.*POST",
+            "flags": "is"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "(?:authorization|authHeader)[\\s\\S]{0,1200}(?:Bearer\\s+eval-token|AUTH_TOKEN|BEARER_TOKEN|eval-token)|(?:Bearer\\s+eval-token|AUTH_TOKEN|BEARER_TOKEN|eval-token)[\\s\\S]{0,1200}(?:authorization|authHeader)",
+            "flags": "i",
+            "label": "enforce POST auth by comparing the authorization header to `Bearer eval-token`; if using a token constant, declare it once"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "401|UNAUTHORIZED"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "limit|offset|hasMore"
+          },
+          {
+            "kind": "contains",
+            "file": "server.mjs",
+            "pattern": "BOOK_NOT_FOUND|VALIDATION_ERROR"
+          },
+          {
+            "kind": "notContains",
+            "file": "server.mjs",
+            "pattern": "from ['\"](express|fastify)['\"]|require\\(['\"](express|fastify)['\"]",
+            "flags": "i"
+          },
+          {
+            "kind": "notContains",
+            "file": "server.mjs",
+            "pattern": "from ['\"]\\./server(?:\\.mjs)?['\"]",
+            "label": "server.mjs must not import itself; remove imports from ./server or ./server.mjs and export createBookstoreServer exactly once"
+          },
+          {
+            "kind": "notContains",
+            "file": "server.mjs",
+            "pattern": "await\\s+import\\(['\"]node:http['\"]\\)",
+            "label": "server.mjs may import node:http at top level; do not use await import(\"node:http\") inside createBookstoreServer"
+          },
+          {
+            "kind": "notContains",
+            "file": "server.mjs",
+            "pattern": "server\\.close\\s*=",
+            "label": "do not replace the native HTTP server close method; close the server from contract-test.mjs"
+          },
+          {
+            "kind": "notContains",
+            "file": "server.mjs",
+            "pattern": "/api/v1",
+            "label": "route exact bare paths /books and /books/{id}; do not add /api/v1"
+          }
+        ]
+      },
+      {
+        "path": "contract-test.mjs",
+        "kind": "code-with-tests",
+        "minBytes": 1500,
+        "checks": [
+          {
+            "kind": "esmImports",
+            "file": "contract-test.mjs"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "import\\s+(?:assert|\\*\\s+as\\s+assert)\\s+from\\s*['\"]node:assert/strict['\"]|import\\s*\\{\\s*strict\\s+as\\s+assert\\s*\\}\\s*from\\s*['\"]node:assert(?:/strict)?['\"]",
+            "label": "import assertions from node:assert/strict before using assert"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "import\\s*\\{[^}]*\\bcreateBookstoreServer\\b[^}]*\\}\\s*from\\s*['\"]\\./server\\.mjs['\"]",
+            "label": "import createBookstoreServer with `import { createBookstoreServer } from \"./server.mjs\"`"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "from ['\"]\\./server['\"]|require\\("
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "\\.\\.\\.\\s*\\(rest of the file content\\)|rest of the file content",
+            "flags": "i",
+            "label": "contract-test.mjs must be a complete runnable file; do not include placeholder elisions"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "createBookstoreServer\\s*\\(",
+            "label": "execute the imported server factory from contract-test.mjs; do not only export test helpers"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "export\\s+\\{\\s*runTests\\s*\\}|export\\s+(?:async\\s+)?function\\s+runTests\\b",
+            "label": "contract-test.mjs must run tests when invoked with node, not only export runTests"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "limit=2|limit\\s*=\\s*2|limit\\s*:\\s*['\"]?2|limit['\"],\\s*['\"]2['\"]|limit[\"],\\s*[\"]2[\"]",
+            "label": "exercise GET /books pagination with an explicit limit=2 request"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "Bearer eval-token|Authorization"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "listen\\(0"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "globalThis\\.fetch|fetch\\(",
+            "label": "use Node built-in global fetch in contract requests"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "(?:globalThis\\.)?fetch\\s*\\([^\\n,]+,\\s*(?:\\{|[A-Za-z_$])",
+            "label": "pass fetch options for POST requests so method, headers, and body reach the server"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "from\\s+['\"](?:node:)?http['\"]|import\\s+[^;]*['\"](?:node:)?http['\"]|require\\(['\"](?:node:)?http['\"]\\)|from\\s+['\"]node-fetch['\"]|import\\s*\\(['\"]node-fetch['\"]\\)|require\\(['\"]node-fetch['\"]\\)",
+            "label": "contract tests must not import node:http or node-fetch; remove those imports and use globalThis.fetch"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "new\\s+URL\\([^,\\n]+,\\s*['\"]http://localhost['\"]\\s*\\)",
+            "label": "contract request helpers must include the assigned listen(0) port; build URLs from the resolved baseUrl, not plain http://localhost"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "http\\.request|http\\.get",
+            "label": "contract tests must not use node:http request helpers; use globalThis.fetch"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "\\bfunction\\s+fetch\\s*\\(|\\b(?:const|let|var)\\s+fetch\\s*=",
+            "label": "contract tests must not replace the global fetch function; use globalThis.fetch or a differently named helper"
+          },
+          {
+            "kind": "notContains",
+            "file": "contract-test.mjs",
+            "pattern": "/api/v1",
+            "label": "call the generated server with exact bare paths /books and /books/{id}; remove any /api/v1 prefix"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "401|403|400|404"
+          },
+          {
+            "kind": "contains",
+            "file": "contract-test.mjs",
+            "pattern": "close\\(|server\\.close"
+          },
+          {
+            "kind": "nodeScriptPasses",
+            "script": "contract-test.mjs",
+            "timeoutMs": 20000,
+            "requiredOutput": [
+              {
+                "pattern": "Pagination|GET /books|List Books",
+                "flags": "i",
+                "label": "pagination test ran"
+              },
+              {
+                "pattern": "Auth|Authentication|401|403",
+                "flags": "i",
+                "label": "auth failure test ran"
+              },
+              {
+                "pattern": "Validation|VALIDATION_ERROR|400",
+                "flags": "i",
+                "label": "validation test ran"
+              },
+              {
+                "pattern": "GET\\s+/books/\\{id\\}|Not Found|BOOK_NOT_FOUND|404",
+                "flags": "i",
+                "label": "not-found test ran"
+              },
+              {
+                "pattern": "Create|201|POST",
+                "flags": "i",
+                "label": "create-success test ran"
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "path": "README.md",
+        "kind": "markdown-doc",
+        "minBytes": 500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "README.md",
+            "pattern": "node server\\.mjs",
+            "label": "include the exact server command `node server.mjs`"
+          },
+          {
+            "kind": "contains",
+            "file": "README.md",
+            "pattern": "node contract-test\\.mjs",
+            "label": "include the exact contract-test command `node contract-test.mjs`"
+          },
+          {
+            "kind": "contains",
+            "file": "README.md",
+            "pattern": "GET /books"
+          },
+          {
+            "kind": "contains",
+            "file": "README.md",
+            "pattern": "GET /books/\\{id\\}|GET /books/:id|GET /books/<id>"
+          },
+          {
+            "kind": "contains",
+            "file": "README.md",
+            "pattern": "POST /books"
+          },
+          {
+            "kind": "contains",
+            "file": "README.md",
+            "pattern": "eval-token|Authorization"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "openapi.yaml",
+      "kind": "yaml"
+    },
+    "axes": [
+      {
+        "name": "correctness",
+        "description": "The module does what the requirements ask, with sensible edge handling."
+      },
+      {
+        "name": "verification",
+        "description": "Self-tests exercise real behavior, not trivial truths."
+      },
+      {
+        "name": "clarity",
+        "description": "Exports, naming, and structure make the module usable without reading every line."
+      },
+      {
+        "name": "robustness",
+        "description": "Invalid input and boundary cases fail loudly rather than silently."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "contract-first API design",
+    "server implementation",
+    "integration tests"
+  ]
+}

package/data/craftbook-templates/re/resume-cv/versions/1.0.2/craftbook.json

@@ -0,0 +1,155 @@
+{
+  "id": "resume-cv",
+  "name": "Résumé / CV",
+  "description": "Build a clean, ATS-friendly résumé or CV from a person's background, tailored to a target role. Scopes the target role and the highlight reel of achievements FIRST (so the résumé is targeted, not a life history), then designs a single-column, parser-safe layout, then writes impact-led bullets with metrics that fit one to two pages. Use for job applications, LinkedIn-to-résumé conversions, and role-targeted CV rewrites.\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 résumé (planner) — target role, must-hit keywords, and the achievement highlight reel → gated on artifact `{{workPath}}/scope.md` (markdown-notes)\n2. Design the layout (designer) — single-column ATS-safe template with clean hierarchy → gated on artifact `{{workPath}}/design.md` (markdown-notes)\n3. Write the résumé (copywriter) — write impact bullets into index.html, tailored and within the cap → 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": [
+    "write my resume",
+    "build a cv",
+    "make a resume",
+    "tailor my resume to a job",
+    "curriculum vitae",
+    "ats friendly resume"
+  ],
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope the résumé",
+      "description": "target role, must-hit keywords, and the achievement highlight reel",
+      "prompt": "Target before drafting. Step 1: identify the target role/title and, if a job description is provided, extract the must-hit skills and keywords. Step 2: from the person's background, select the experiences that matter for THIS role and set aside the rest — a résumé is a targeted highlight reel, not a complete history. Step 3: choose the section set and order (summary, experience, skills, education, plus optional projects/certs) and decide the length cap (1 page for <10 yrs experience, 2 max). Step 4: for each kept role, note the 2-4 strongest achievements and where a metric exists (numbers, %, scale). Step 5: write an acceptance-criteria checklist ('targeted to the stated role', 'reverse-chronological experience', 'every role has impact bullets, most with a metric', 'must-hit keywords appear naturally', 'fits within the page cap', 'no objective-statement filler'). Write the scope + highlight reel + checklist via write_task_note AND to {{workPath}}/scope.md. No layout or final bullets 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": "design"
+    },
+    {
+      "id": "design",
+      "name": "Design the layout",
+      "description": "single-column ATS-safe template with clean hierarchy",
+      "prompt": "Design a layout that BOTH a recruiter and an ATS parser can read. Step 1: choose a single-column layout (multi-column and tables confuse parsers) with a clear header (name, title, contact line) and standard section headings (Experience, Skills, Education) in plain text. Step 2: pick a conservative type scale and a restrained palette (mostly ink-on-white, at most one subtle accent) with strong contrast; no graphics, no icons that carry meaning, web-safe fonts only. Step 3: define the entry format for experience (Company | Title | Dates on one line, bullets beneath) and a compact skills format. Step 4: set print rules (@page, Letter/A4) and a height constraint matching the page cap. Step 5: write a visual-criteria checklist ('single column, no tables for layout', 'standard parser-friendly section headings', 'consistent date alignment', 'fits the page cap in print'). Write the layout spec + checklist via write_task_note AND to {{workPath}}/design.md. No copy yet.\n\nThe deliverable `{{workPath}}/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}}/design.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/design.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/design.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "design",
+        "maxAttempts": 3
+      },
+      "next": "write"
+    },
+    {
+      "id": "write",
+      "name": "Write the résumé",
+      "description": "write impact bullets into index.html, tailored and within the cap",
+      "prompt": "Write the résumé and assemble it into the layout as a single self-contained index.html (inline CSS with print rules). Step 1: write a 1-2 line professional summary tailored to the target role, weaving in must-hit keywords naturally. Step 2: write experience entries in reverse-chronological order with impact-led bullets — each starts with a strong verb and, wherever the highlight reel supplied one, includes a metric (scale, %, $, time saved). Step 3: write a scannable skills section using the role's keywords, and a compact education section. Step 4: cut ruthlessly to fit the page cap; remove dated or irrelevant roles before adding pages. Step 5: ensure no objective-statement filler and no first-person pronouns in bullets. On a loop-back, fix ONLY the named gaps. Write the path + a note confirming page count and that keywords are covered via write_task_note.",
+      "suggestedRole": "copywriter",
+      "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": "write",
+        "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": "QA the résumé. Step 1: open/render index.html and, if print-preview is available, confirm it is within the page cap. Step 2: check EACH acceptance criterion: targeted to the stated role, single-column parser-safe layout with standard section headings, reverse-chronological experience, every role has impact bullets and most carry a metric, must-hit keywords appear naturally, no objective-statement filler, dates aligned consistently. Step 3: read it as a recruiter for the target role and confirm the fit is obvious in the top third. Write PASS/FAIL per criterion; if it exceeds the page cap, FAIL and loop back to trim.\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: \"write\" })` 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": "write"
+    },
+    {
+      "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/re/resume-cv/versions/1.0.2/test.json

@@ -0,0 +1,100 @@
+{
+  "schemaVersion": 1,
+  "title": "Résumé / CV smoke eval",
+  "objective": "Self-contained smoke eval for the Résumé / CV craftbook using the html-page generic harness.",
+  "tags": [
+    "html-page"
+  ],
+  "prompt": "Can you biuld us a little page for this? The content notes are in source/page-content.md. Save it as index.html — one file, nothing fancy needed on our end.",
+  "setup": {
+    "projectName": "Résumé / CV Eval",
+    "about": "Self-contained eval project for resume-cv. Seeded inputs are under workspace/source or workspace/fixtures; final deliverable is workspace/index.html.",
+    "missionObjectives": "Use the Résumé / CV craftbook/template, read the seeded local fixtures, and write index.html without network calls, real credentials, or live services.",
+    "files": [
+      {
+        "path": "source/brief.md",
+        "content": "# Résumé / CV 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: resume-cv - Résumé / CV.\n"
+      },
+      {
+        "path": "source/page-content.md",
+        "content": "# Boreal Desk Support Board\n\nBuild content around a support operations board. Required labels: Open issues, Status silence, Response time, Refund leakage, Next action. Required metric text: 18 hours to 6 hours and 14.2% to 8.9%.\n"
+      }
+    ],
+    "worker": {
+      "name": "Jules",
+      "role": "Developer"
+    },
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "index.html is a source-grounded self-contained HTML page/tool.",
+    "deliverables": [
+      {
+        "path": "index.html",
+        "kind": "html-page",
+        "minBytes": 3000,
+        "checks": [
+          {
+            "kind": "cssMinBytes",
+            "bytes": 650,
+            "file": "index.html"
+          },
+          {
+            "kind": "jsParses",
+            "file": "index.html"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "Boreal|Support Board|returns",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "18\\s*hours|6\\s*hours|14\\.2%|8\\.9%",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "index.html",
+            "pattern": "button|input|filter|tab|card|section|nav",
+            "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": [
+    "self-contained UI",
+    "source grounding",
+    "responsive structure"
+  ]
+}