@bendyline/gilde 0.1.50 → 0.1.52

package/data/craftbook-templates/au/audiobook-master-pack/versions/1.0.5/craftbook.json

@@ -0,0 +1,370 @@
+{
+  "id": "audiobook-master-pack",
+  "name": "Master the Audiobook",
+  "description": "Assemble the finished chapters into a release: completeness swept against the manuscript first, the metadata manifest built and verified chapter by chapter, the master assembled through the project's media pipeline with a run log, and the listener-facing description written — the moment the folder of takes becomes a book. Locks the packaging rules FIRST (order, metadata fields, total duration), then the manifest, then the master, then the release copy. Use for mastering an audiobook, packaging the chapters, audiobook release prep, and 'all the chapters are rendered, now what'.\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. Sweep for completeness (producer) — chapters on disk checked against the manuscript, rules locked → gated on artifact `{{workPath}}/scope.md` (markdown-notes)\n2. Build the manifest (data-analyst) — master/manifest.json: chapter, file, duration, order → gated on `master/manifest.json` (json)\n3. Assemble the master (developer) — the chapters concatenated into the master with its log → gated on `master/book.m4b` (generic-file)\n4. Write the release copy (copywriter) — listener description and release notes for the finished book → gated on artifact `master/release-notes.md` (markdown-report)\n\nThe gates never advance with an unmet criterion, and loop back to the\nowning phase to fix named gaps.\n",
+  "entryStepId": "scope",
+  "triggers": [
+    "master the audiobook",
+    "package the chapters",
+    "assemble the book",
+    "audiobook release prep",
+    "finish the audiobook"
+  ],
+  "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": "scope",
+      "name": "Sweep for completeness",
+      "description": "chapters on disk checked against the manuscript, rules locked",
+      "prompt": "Establish that the book is actually finished before packaging it. Step 1: read the manuscript's table of contents under manuscript/ and list every chapter the book should have. Step 2: sweep the rendered audio under audio/ — each chapter's audio file and its run log — and check the two lists against each other; a missing or failed chapter stops the run here, reported plainly, because a master with a hole in it is not a master. Step 3: lock the packaging rules — the manifest at master/manifest.json records every chapter with its audio file, duration, and play order; order follows the manuscript; durations come from the chapters' run logs, never estimated; and the master is assembled through the project's pipeline script via the run_installed_script tool with a status-ok log. Step 4: write an acceptance-criteria checklist ('every manuscript chapter has rendered audio', 'manifest complete with file, duration, and order per chapter', 'no duplicate chapters', 'master assembled with a status-ok log', 'total duration equals the sum of the chapters', 'listener description written'). Call write_task_note with the chapter counts + checklist and write {{workPath}}/scope.md.\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": "producer",
+      "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": "manifest",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "audio",
+          "browser-automation",
+          "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": "manifest",
+      "name": "Build the manifest",
+      "description": "master/manifest.json: chapter, file, duration, order",
+      "prompt": "Build the metadata manifest the master run and every player will trust. Step 1: write master/manifest.json as a JSON array, one record per chapter — the chapter title as the manuscript names it, the audio file path exactly as it exists under audio/, the duration taken from that chapter's run log, and the play order as a number following the manuscript. Step 2: verify as you go — every file path must point at a file that exists, no chapter appears twice, and the orders run without gaps. Step 3: total the durations and note the book's full running time for the release copy. Call write_task_note with the record count and the total duration.",
+      "suggestedRole": "data-analyst",
+      "advanceWhen": {
+        "file": "master/manifest.json",
+        "minBytes": 1,
+        "sniff": "json-valid"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "master/manifest.json",
+            "bytes": 2
+          },
+          {
+            "kind": "recordSchema",
+            "file": "master/manifest.json",
+            "fields": [
+              {
+                "name": "chapter",
+                "type": "nonempty"
+              },
+              {
+                "name": "file",
+                "type": "nonempty"
+              },
+              {
+                "name": "duration"
+              },
+              {
+                "name": "order"
+              }
+            ],
+            "minRows": 3,
+            "uniqueBy": "chapter"
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkJsonValid",
+            "scope": "standard",
+            "inputs": {
+              "file": "master/manifest.json"
+            }
+          }
+        ],
+        "onReject": "manifest",
+        "maxAttempts": 3
+      },
+      "next": "assemble",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "artifacts",
+          "audio",
+          "browser-automation",
+          "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": "assemble",
+      "name": "Assemble the master",
+      "description": "the chapters concatenated into the master with its log",
+      "prompt": "Assemble the release master. Step 1: the mastering pipeline is a project script — call list_scripts to find it, then run it with run_installed_script({ name: \"<script name>\" }); never run it with run_nodejs_script and never reimplement it. It reads master/manifest.json, verifies every referenced audio file exists, joins the chapters in manifest order into master/book.m4b, and writes its run log to master/assembly-log.json with a status field, the chapter count, and the total duration it computed. Step 2: if run_installed_script reports an error, read the error text, fix what it names — usually a manifest path or order — and run it again; never write master/assembly-log.json yourself — the log is evidence the pipeline ran. Step 3: once it succeeds, read the log and confirm status ok, the chapter count matching the manifest, and the total duration matching the manifest's sum. Call write_task_note with the run outcome and the master's total duration.",
+      "suggestedRole": "developer",
+      "consumes": [
+        {
+          "file": "master/manifest.json"
+        }
+      ],
+      "advanceWhen": {
+        "file": "master/book.m4b",
+        "minBytes": 1,
+        "sniff": "nonempty"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "master/book.m4b",
+            "bytes": 200
+          },
+          {
+            "kind": "sniff",
+            "file": "master/book.m4b",
+            "sniff": "nonempty"
+          },
+          {
+            "kind": "sniff",
+            "file": "master/assembly-log.json",
+            "sniff": "json-valid"
+          },
+          {
+            "kind": "jsonPathEquals",
+            "file": "master/assembly-log.json",
+            "path": "status",
+            "value": "ok",
+            "label": "the assembly log reports status ok"
+          }
+        ],
+        "onReject": "assemble",
+        "maxAttempts": 3
+      },
+      "next": "package",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "artifacts",
+          "audio",
+          "browser-automation",
+          "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": "package",
+      "name": "Write the release copy",
+      "description": "listener description and release notes for the finished book",
+      "prompt": "Write the words that travel with the book. Step 1: write the listener-facing description — what the book is about and who it is for, in the voice a listener browsing a store would actually read, without spoiling it. Step 2: add the release facts — the total running time from the master log, the chapter count, and the chapter list with per-chapter durations from the manifest. Step 3: add the release notes for the owner — what was assembled, anything flagged during the sweep, and the one-line confirmation that the master's numbers match the manifest. Write master/release-notes.md and call write_task_note with the path and the total running time.\n\nThe deliverable `master/release-notes.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": "copywriter",
+      "advanceWhen": {
+        "file": "master/release-notes.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "master/release-notes.md",
+            "bytes": 600,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "master/release-notes.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i",
+            "label": "at least one markdown heading",
+            "artifact": true
+          }
+        ],
+        "onReject": "package",
+        "maxAttempts": 4
+      },
+      "next": "evaluate",
+      "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": "evaluate",
+      "name": "Evaluate",
+      "description": "Grade the deliverable against every acceptance criterion. All pass → finish; any fail → loop back and fix the gap.",
+      "prompt": "Open master/release-notes.md, master/manifest.json, and master/assembly-log.json and verify every criterion from {{workPath}}/scope.md: every manuscript chapter appears in the manifest exactly once with file, duration, and order, the referenced audio files exist, the log reports status ok with a chapter count and total duration matching the manifest, the release copy states the total running time, and the listener description reads like store copy rather than an internal note. Write PASS/FAIL per criterion; on any failure, name the gap and loop back to package — or to manifest if the metadata is the problem.\n\nThe deliverable lives in the project's artifacts drawer — open `master/release-notes.md` with `read_artifact`, not `read_file`.\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: \"package\" })` 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": "master/release-notes.md",
+          "artifact": true
+        }
+      ],
+      "next": "package",
+      "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": "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.5",
+  "releasedAt": "2026-09-01T20:00:00Z",
+  "minGezelVersion": "1.26233"
+}

package/data/craftbook-templates/au/audiobook-master-pack/versions/1.0.5/test.json

@@ -0,0 +1,221 @@
+{
+  "schemaVersion": 1,
+  "title": "Master the Audiobook smoke eval",
+  "objective": "Task-specific eval for the Master the Audiobook craftbook: six rendered chapters with run logs are swept against the table of contents, described in a verified manifest, concatenated through the fake mastering pipeline, and packaged with listener copy.",
+  "tags": [
+    "external"
+  ],
+  "prompt": "all six chapters are rendered — can you master the audiobok and get the metadata sorted? theres a fake concat pipeline wired up",
+  "setup": {
+    "projectName": "Audiobook Studio — Mastering Eval",
+    "about": "Self-contained eval project for audiobook-master-pack. The table of contents is manuscript/toc.md; the six rendered chapters sit under audio/ as chapter-XX.wav with a chapter-XX-log.json run log each (durations in durationSeconds). The manifest goes to master/manifest.json; the fake mastering pipeline is the ready-made mock-probe project script (writes master/book.m4b plus master/assembly-log.json, and cross-checks manifest durations against the chapter logs). The listener description and release notes go to master/release-notes.md.",
+    "missionObjectives": "Use the Master the Audiobook craftbook/template, sweep the chapters against the table of contents, build master/manifest.json with file, duration, and order per chapter taken from the run logs, assemble through the provided mock-probe script, and write master/release-notes.md. No real audio tools or services — only the wired fake pipeline.",
+    "files": [
+      {
+        "path": "manuscript/toc.md",
+        "content": "# A Field Guide to Vanishing - table of contents\n\n1. The Door in the Sea Wall\n2. The Ferry at Dusk\n3. The Handwriting House\n4. What the Buoy Knew\n5. The Smallest Lantern\n6. Come Anyway\n"
+      },
+      {
+        "path": "audio/chapter-01.wav",
+        "content": "MOCKWAV chapter-01 rendered audio stub (The Door in the Sea Wall)\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n"
+      },
+      {
+        "path": "audio/chapter-01-log.json",
+        "content": "{\n  \"status\": \"ok\",\n  \"engine\": \"mock-tts\",\n  \"chapter\": \"The Door in the Sea Wall\",\n  \"file\": \"audio/chapter-01.wav\",\n  \"durationSeconds\": 1712.4,\n  \"wordCount\": 4310\n}\n"
+      },
+      {
+        "path": "audio/chapter-02.wav",
+        "content": "MOCKWAV chapter-02 rendered audio stub (The Ferry at Dusk)\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n"
+      },
+      {
+        "path": "audio/chapter-02-log.json",
+        "content": "{\n  \"status\": \"ok\",\n  \"engine\": \"mock-tts\",\n  \"chapter\": \"The Ferry at Dusk\",\n  \"file\": \"audio/chapter-02.wav\",\n  \"durationSeconds\": 1544.8,\n  \"wordCount\": 3890\n}\n"
+      },
+      {
+        "path": "audio/chapter-03.wav",
+        "content": "MOCKWAV chapter-03 rendered audio stub (The Handwriting House)\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n"
+      },
+      {
+        "path": "audio/chapter-03-log.json",
+        "content": "{\n  \"status\": \"ok\",\n  \"engine\": \"mock-tts\",\n  \"chapter\": \"The Handwriting House\",\n  \"file\": \"audio/chapter-03.wav\",\n  \"durationSeconds\": 1836.2,\n  \"wordCount\": 4620\n}\n"
+      },
+      {
+        "path": "audio/chapter-04.wav",
+        "content": "MOCKWAV chapter-04 rendered audio stub (What the Buoy Knew)\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n"
+      },
+      {
+        "path": "audio/chapter-04-log.json",
+        "content": "{\n  \"status\": \"ok\",\n  \"engine\": \"mock-tts\",\n  \"chapter\": \"What the Buoy Knew\",\n  \"file\": \"audio/chapter-04.wav\",\n  \"durationSeconds\": 1490.5,\n  \"wordCount\": 3750\n}\n"
+      },
+      {
+        "path": "audio/chapter-05.wav",
+        "content": "MOCKWAV chapter-05 rendered audio stub (The Smallest Lantern)\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n"
+      },
+      {
+        "path": "audio/chapter-05-log.json",
+        "content": "{\n  \"status\": \"ok\",\n  \"engine\": \"mock-tts\",\n  \"chapter\": \"The Smallest Lantern\",\n  \"file\": \"audio/chapter-05.wav\",\n  \"durationSeconds\": 1671.9,\n  \"wordCount\": 4205\n}\n"
+      },
+      {
+        "path": "audio/chapter-06.wav",
+        "content": "MOCKWAV chapter-06 rendered audio stub (Come Anyway)\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n"
+      },
+      {
+        "path": "audio/chapter-06-log.json",
+        "content": "{\n  \"status\": \"ok\",\n  \"engine\": \"mock-tts\",\n  \"chapter\": \"Come Anyway\",\n  \"file\": \"audio/chapter-06.wav\",\n  \"durationSeconds\": 1922.7,\n  \"wordCount\": 4840\n}\n"
+      }
+    ],
+    "worker": {
+      "name": "Ruben",
+      "role": "Producer"
+    }
+  },
+  "mocks": [
+    {
+      "kind": "cli",
+      "id": "probe",
+      "description": "Provenance-trusted project script `mock-probe` that runs the fake mastering pipeline: verifies master/manifest.json against the audio files and their run logs, then writes the stub master and its run log.",
+      "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    'Fake mastering pipeline for this eval: reads master/manifest.json, verifies every referenced audio file exists with a sane duration and order, cross-checks durations against the per-chapter run logs, then writes the stub master to master/book.m4b and its run log to master/assembly-log.json.',\n  inputs: {},\n  outputs: {\n    log: { type: 'string', description: 'The mastering run log JSON written to master/assembly-log.json.' },\n  },\n  requires: ['workspace.read', 'workspace.write'],\n});\n\nconst manifest = JSON.parse(await gezel.fs.read('master/manifest.json'));\nif (!Array.isArray(manifest) || manifest.length === 0) {\n  throw new Error('master/manifest.json must be a non-empty JSON array');\n}\nconst entries = await gezel.fs.list('audio');\nconst present = new Set(entries.filter((entry) => !entry.isDirectory).map((entry) => entry.name));\nlet total = 0;\nconst orders = new Set();\nfor (const row of manifest) {\n  const base = String(row.file ?? '').split('/').pop();\n  if (!base || !present.has(base)) {\n    throw new Error(`manifest references a missing audio file: ${row.file}`);\n  }\n  if (typeof row.duration !== 'number' || row.duration <= 0) {\n    throw new Error(`bad duration for chapter ${row.chapter}: ${row.duration}`);\n  }\n  if (typeof row.order !== 'number' || orders.has(row.order)) {\n    throw new Error(`bad or duplicate order for chapter ${row.chapter}: ${row.order}`);\n  }\n  orders.add(row.order);\n  const logName = base.replace(/\\.wav$/, '-log.json');\n  if (present.has(logName)) {\n    const chapterLog = JSON.parse(await gezel.fs.read(`audio/${logName}`));\n    if (\n      typeof chapterLog.durationSeconds === 'number' &&\n      Math.abs(chapterLog.durationSeconds - row.duration) > 0.01\n    ) {\n      throw new Error(`manifest duration for chapter ${row.chapter} does not match its run log`);\n    }\n  }\n  total += row.duration;\n}\nconst log = {\n  status: 'ok',\n  engine: 'mock-concat',\n  chapters: manifest.length,\n  totalDurationSeconds: Math.round(total * 100) / 100,\n};\nawait gezel.fs.write('master/book.m4b', `MOCKM4B audiobook master stub\\n${'0'.repeat(2048)}\\n`);\nawait gezel.fs.write('master/assembly-log.json', `${JSON.stringify(log, null, 2)}\\n`);\ngezel.output({ log: JSON.stringify(log) });\n"
+      }
+    }
+  ],
+  "success": {
+    "summary": "master/manifest.json describes all six chapters exactly once with log-true durations, the fake pipeline produced the master and a status-ok log counting six chapters, and the release notes carry the total running time plus listener copy.",
+    "deliverables": [
+      {
+        "path": "master/manifest.json",
+        "kind": "json",
+        "checks": [
+          {
+            "kind": "recordSchema",
+            "file": "master/manifest.json",
+            "fields": [
+              {
+                "name": "chapter",
+                "type": "nonempty"
+              },
+              {
+                "name": "file",
+                "type": "nonempty"
+              },
+              {
+                "name": "duration"
+              },
+              {
+                "name": "order"
+              }
+            ],
+            "minRows": 6,
+            "uniqueBy": "chapter"
+          },
+          {
+            "kind": "valuesSubsetOf",
+            "file": "master/manifest.json",
+            "sourceFiles": [
+              "audio/chapter-01-log.json",
+              "audio/chapter-02-log.json",
+              "audio/chapter-03-log.json",
+              "audio/chapter-04-log.json",
+              "audio/chapter-05-log.json",
+              "audio/chapter-06-log.json"
+            ],
+            "pattern": "\"file\"\\s*:\\s*\"([^\"]+)\"",
+            "label": "every manifest file reference matches a rendered chapter from the run logs"
+          }
+        ]
+      },
+      {
+        "path": "master/book.m4b",
+        "kind": "generic-file",
+        "minBytes": 200
+      },
+      {
+        "path": "master/assembly-log.json",
+        "kind": "json",
+        "checks": [
+          {
+            "kind": "jsonPathEquals",
+            "file": "master/assembly-log.json",
+            "path": "status",
+            "value": "ok",
+            "label": "the mastering log reports status ok"
+          },
+          {
+            "kind": "jsonPathEquals",
+            "file": "master/assembly-log.json",
+            "path": "chapters",
+            "value": 6,
+            "label": "all six chapters were assembled"
+          }
+        ]
+      },
+      {
+        "path": "master/release-notes.md",
+        "kind": "markdown-report",
+        "minBytes": 500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "master/release-notes.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "master/release-notes.md",
+            "pattern": "duration|running time",
+            "flags": "i",
+            "label": "the total running time is stated"
+          },
+          {
+            "kind": "contains",
+            "file": "master/release-notes.md",
+            "pattern": "chapter",
+            "flags": "i",
+            "label": "the chapter list is present"
+          },
+          {
+            "kind": "judge",
+            "file": "master/release-notes.md",
+            "rubric": "The listener-facing description reads like store copy for the book (warm, no spoilers, aimed at a browsing listener), and the stated total running time matches the mastering log rather than being invented.",
+            "sourceFiles": [
+              "master/assembly-log.json",
+              "manuscript/toc.md"
+            ],
+            "label": "store-copy quality and log-true numbers"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "master/release-notes.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "completeness",
+        "description": "All six chapters swept, present, and in manuscript order — no holes."
+      },
+      {
+        "name": "metadata-quality",
+        "description": "Manifest durations and orders come from the run logs, never estimated."
+      },
+      {
+        "name": "listener-copy",
+        "description": "The description sells the book to a browsing listener without spoiling it."
+      },
+      {
+        "name": "release-readiness",
+        "description": "The notes confirm the master's numbers match the manifest."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "completeness sweep",
+    "log-true metadata",
+    "listener-facing copy"
+  ]
+}