@bendyline/gilde 0.1.26 → 0.1.28

package/data/craftbook-templates/tr/transcribe-and-shownotes/versions/1.0.1/craftbook.json

@@ -0,0 +1,115 @@
+{
+  "id": "transcribe-and-shownotes",
+  "name": "Transcript to Shownotes",
+  "description": "Take a finished recording from raw transcript to publishable shownotes: a clean transcript on file, timestamped chapters, a summary listeners actually read, and the links mentioned — the per-episode ritual that turns audio into an archive. Locks the shownotes checklist FIRST (chapters timestamped, every link captured, names spelled right), then gets the transcript on file, then writes the shownotes from it. Use for episode shownotes, transcribing an episode, chapter timestamps, and 'turn this recording into shownotes'.\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 shownotes (planner) — locate the recording or transcript, lock the shownotes checklist → gated on artifact `notes/scope.md` (markdown-notes)\n2. Get the transcript on file (transcriber) — clean, speaker-labeled, timestamped transcript under transcripts/\n3. Write the shownotes (copywriter) — summary, timestamped chapters, links and mentions, pull quotes → gated on artifact `report.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": [
+    "turn the recording into shownotes",
+    "shownotes for the episode",
+    "transcribe the episode",
+    "episode chapters and shownotes",
+    "write the shownotes"
+  ],
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope the shownotes",
+      "description": "locate the recording or transcript, lock the shownotes checklist",
+      "prompt": "Define the job before touching the audio. Step 1: find the episode's recording or transcript — check the recordings folder and episodes.json for which episode is being shipped and what already exists on file. Step 2: confirm with the owner anything the transcript alone won't give you — guest name spellings, links they promised listeners, and where the shownotes get published. Step 3: write an acceptance-criteria checklist ('a clean, complete transcript is on file under transcripts/', 'every chapter has a timestamp that exists in the transcript', 'every link mentioned in the episode is captured', 'names spelled right throughout', 'the summary reads like the episode, not a form'). Call write_task_note with the episode + checklist and write notes/scope.md.\n\nThe deliverable `notes/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": "notes/scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "notes/scope.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "notes/scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "scope",
+        "maxAttempts": 3
+      },
+      "next": "transcript"
+    },
+    {
+      "id": "transcript",
+      "name": "Get the transcript on file",
+      "description": "clean, speaker-labeled, timestamped transcript under transcripts/",
+      "prompt": "Get the transcript on file. Step 1: if a transcript already exists (a provided file in the recordings folder), start from that; otherwise produce one from the recording through the project's transcription capabilities. Step 2: clean it — fix obvious mis-hearings, label the speakers, keep the timestamps. Step 3: save the cleaned transcript in the transcripts/ folder named for the episode (for example transcripts/ep12.md). A real transcript is substantial — never a stub or a summary. Step 4: call write_task_note with the transcript path and an approximate word count.",
+      "suggestedRole": "transcriber",
+      "next": "shownotes"
+    },
+    {
+      "id": "shownotes",
+      "name": "Write the shownotes",
+      "description": "summary, timestamped chapters, links and mentions, pull quotes",
+      "prompt": "Write the shownotes from the transcript. Step 1: a short summary a listener actually reads — what the episode is about and why it's worth their hour, in the show's voice. Step 2: the chapter list — timestamped, one line per chapter, every timestamp taken from the transcript, never invented. Step 3: links and mentions — everything referenced in the episode, with where each one points. Step 4: two or three pull quotes worth sharing, verbatim from the transcript with their speaker. Step 5: write report.md and call write_task_note with the chapter count and the link count.\n\nThe deliverable `report.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": "report.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "report.md",
+            "bytes": 1500,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "report.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i",
+            "label": "at least one markdown heading",
+            "artifact": true
+          }
+        ],
+        "onReject": "shownotes",
+        "maxAttempts": 4
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "evaluate",
+      "name": "Evaluate",
+      "description": "Grade the deliverable against every acceptance criterion. All pass → finish; any fail → loop back and fix the gap.",
+      "prompt": "Open report.md and the transcript under transcripts/ and verify every criterion from notes/scope.md: the transcript on file is complete and speaker-labeled, every chapter timestamp appears in the transcript (spot-check each one — a chapter that points at nothing is fabrication), every link mentioned in the episode is captured, names are spelled the way the owner confirmed, and the pull quotes are verbatim. Write PASS/FAIL per criterion; on any failure, name the gap and loop back to shownotes.\n\nThe deliverable lives in the project's artifacts drawer — open `report.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: \"shownotes\" })` 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": "report.md",
+          "artifact": true
+        }
+      ],
+      "next": "shownotes"
+    },
+    {
+      "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.1",
+  "releasedAt": "2026-08-14T00:00:00Z"
+}

package/data/craftbook-templates/tr/transcribe-and-shownotes/versions/1.0.1/test.json

@@ -0,0 +1,98 @@
+{
+  "schemaVersion": 1,
+  "title": "Transcript to Shownotes — episode 12",
+  "objective": "Measure whether the transcribe-and-shownotes craftbook files a clean transcript and produces shownotes whose chapter timestamps, links, and quotes all trace to the transcript.",
+  "tags": [
+    "corpus"
+  ],
+  "prompt": "weve got the raw transcript for episode 12 in recordings/ep12-transcript.txt — can you turn it into shownotes with chapters? report.md is fine",
+  "setup": {
+    "projectName": "Shelf Life Podcast",
+    "about": "Podcast studio project for Shelf Life, a weekly show about books and the people who make them. Raw recordings and transcripts land under workspace/recordings; the episode store is workspace/episodes.json.",
+    "missionObjectives": "Turn shipped episodes into a publishable archive: clean transcript on file, timestamped chapters, links captured. Grounded in the seeded transcript — no live services, no real credentials.",
+    "files": [
+      {
+        "path": "recordings/ep12-transcript.txt",
+        "content": "Shelf Life — Episode 12 raw transcript (auto-generated, unedited)\nRecorded 2026-07-09. Host: Noor. Guests: Marta Velde (bookbinder), Daan Pols (apprentice).\n\n[00:00] NOOR: Welcome back to Shelf Life. Today we are in an actual bindery, which smells like glue and paper dust and, honestly, like heaven.\n[00:42] NOOR: Marta Velde has been binding books by hand for thirty-one years. Marta, welcome.\n[01:15] MARTA: Thank you. You are the first person to bring a microphone in here. Usually they bring broken books.\n[02:30] NOOR: Let's start there. What arrives on your bench in an average week?\n[03:48] MARTA: Family bibles, mostly. And cookbooks. People cry over cookbooks more than bibles, if you want the truth. The stains are the memories.\n[05:10] NOOR: How did you learn the trade?\n[06:55] MARTA: My teacher took me on in 1995. Four years sweeping floors before he let me sew a spine. I tell people that and they think it is cruelty. It was patience.\n[08:20] NOOR: And now you have an apprentice of your own. Daan, you are twenty-three. Why this trade?\n[09:45] DAAN: I was studying logistics and I hated every minute of it. I saw Marta repair a 1911 atlas on a video and I emailed her that night.\n[11:02] MARTA: He emailed me eleven times.\n[12:30] NOOR: Persistence is the trade, from what I am hearing. Marta, walk me through the atlas repair. What does a book like that need?\n[14:05] MARTA: First you take it apart completely. People are shocked by that. To save a book you must be willing to reduce it to sheets and thread.\n[15:40] MARTA: The spine linings come off with wheat starch paste and a bone folder. Slow. If you rush the paste you tear the paper and then you are not a binder, you are a butcher.\n[17:12] NOOR: How long does a full rebind take?\n[18:50] MARTA: Twenty hours for a simple case binding. The atlas took ninety. We charge less than the hours, always. Nobody pays what the hours cost. You do it because the book deserves it.\n[20:15] NOOR: Daan, what is the hardest skill so far?\n[21:48] DAAN: Sewing headbands. Marta makes it look like knitting. Mine look like a fishing accident.\n[23:30] NOOR: For listeners who want to try this — where do they start?\n[25:05] MARTA: We teach beginner classes at the bindery, first Saturday of every month. The schedule is at bindery-lane.example.com/classes.\n[26:40] NOOR: I will put that in the shownotes. What about materials? People always ask where to buy proper paper.\n[28:15] DAAN: Paper Road. It is a small mill shop, they ship everywhere. paperroad.example.org. Their 90-gram laid paper is what we sew practice blocks with.\n[29:50] NOOR: And if someone has a family book that needs repair but you are booked out?\n[31:20] MARTA: The guild keeps a directory of certified binders by region — guild-of-binders.example.net/directory. Anyone listed there will treat your book honestly.\n[33:00] NOOR: What is a book you refused to repair?\n[34:35] MARTA: A first edition someone wanted rebound in neon leather. I sent them away. Restoration is listening to the book, not shouting over it.\n[36:10] NOOR: Daan, where do you want to be in ten years?\n[37:45] DAAN: Running my own bench. Maybe here. Marta says the bindery outlives the binder, and I want that to be true.\n[39:20] MARTA: It is true. This bench was my teacher's bench. The scars in the wood are his.\n[40:55] NOOR: That gave me chills. Before we close — the mailbag question. A listener asks: are e-readers killing your trade?\n[42:30] MARTA: The opposite. The rarer the physical book becomes, the more the surviving ones matter. My waiting list has never been longer.\n[44:05] NOOR: Marta Velde, Daan Pols, thank you both. Come back with the apprentice's first solo binding.\n[45:40] DAAN: Deal. Give me a year.\n[46:52] NOOR: Shelf Life is back Monday. Bring us your broken cookbooks.\n[47:30] END OF RECORDING\n"
+      },
+      {
+        "path": "episodes.json",
+        "content": "{\n  \"show\": \"Shelf Life\",\n  \"cadence\": \"weekly — records Thursday, publishes Monday\",\n  \"targetMinutes\": 45,\n  \"episodes\": [\n    {\n      \"number\": 10,\n      \"title\": \"The Library Cart Economy\",\n      \"publishedAt\": \"2026-06-29\"\n    },\n    {\n      \"number\": 11,\n      \"title\": \"Why Paperbacks Survive\",\n      \"publishedAt\": \"2026-07-06\"\n    },\n    {\n      \"number\": 12,\n      \"title\": \"Interview: The Last Bookbinder\",\n      \"publishedAt\": \"2026-07-13\",\n      \"guests\": [\"Marta Velde\", \"Daan Pols\"]\n    }\n  ]\n}\n"
+      }
+    ],
+    "worker": {
+      "name": "Sanne",
+      "role": "Copywriter"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "report.md is publishable shownotes — summary, timestamped chapters, links, pull quotes — and every timestamp in it exists in the seeded transcript (no fabricated chapters).",
+    "deliverables": [
+      {
+        "path": "report.md",
+        "kind": "markdown-report",
+        "minBytes": 1500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "report.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "report.md",
+            "pattern": "\\d{1,2}:\\d{2}",
+            "label": "timestamped chapters"
+          },
+          {
+            "kind": "contains",
+            "file": "report.md",
+            "pattern": "chapter",
+            "flags": "i"
+          },
+          {
+            "kind": "valuesSubsetOf",
+            "file": "report.md",
+            "sourceFiles": [
+              "recordings/*.txt"
+            ],
+            "pattern": "(\\d{1,2}:\\d{2})",
+            "minMatches": 4,
+            "label": "every timestamp traces to the transcript"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "report.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "fidelity",
+        "description": "Chapters, links, names, and quotes come from the transcript — nothing invented, names spelled as recorded."
+      },
+      {
+        "name": "chapter quality",
+        "description": "Chapter breaks land where the conversation actually turns, with titles that tell a listener what they will hear."
+      },
+      {
+        "name": "scannability",
+        "description": "A listener can skim the summary, chapters, and links in under a minute and decide to hit play."
+      },
+      {
+        "name": "tone",
+        "description": "The summary reads like the show's voice, not a form letter."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "timestamp fidelity",
+    "link capture",
+    "chapter craft"
+  ]
+}

package/data/craftbook-templates/tr/transcribe-audio/versions/1.0.1/craftbook.json

@@ -0,0 +1,107 @@
+{
+  "id": "transcribe-audio",
+  "name": "Transcribe Audio or Video",
+  "description": "Convert an audio or video recording into an accurate, readable transcript using speech-to-text, with speaker labels and timestamps. Scopes the output format, speaker-labeling, and timestamp granularity FIRST so the transcript is usable downstream (search, subtitles, minutes), then transcribes the full recording end-to-end, then verifies coverage against the recording's duration and checks for dropped segments. The scope-first ordering matters because deciding timestamp cadence and speaker handling up front is what separates a clean, searchable transcript from a wall of unattributed text.\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 transcript (planner) — format, speaker labels, timestamp cadence, glossary → gated on artifact `notes/scope.md` (markdown-notes)\n2. Transcribe the recording (developer) — run STT over the full file, label speakers, timestamp → gated on `transcript.md` (markdown-doc)\n\nThe gates never advance with an unmet criterion, and loop back to the\nowning phase to fix named gaps.\n",
+  "entryStepId": "scope",
+  "triggers": [
+    "transcribe this audio",
+    "transcribe a video",
+    "speech to text",
+    "get a transcript",
+    "convert recording to text"
+  ],
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope the transcript",
+      "description": "format, speaker labels, timestamp cadence, glossary",
+      "prompt": "Define what a good transcript looks like BEFORE transcribing. Step 1: record the source file (path, format, duration in seconds). Step 2: pick the output format (plain markdown, or timestamped blocks like `[00:01:23] Speaker 1: ...`) and the timestamp cadence (per-utterance, every N seconds, or per-paragraph). Step 3: decide speaker handling (diarize into Speaker 1/2…, or single-speaker) and how to label them. Step 4: build a small glossary of names/terms/acronyms likely in the audio so they transcribe correctly. Step 5: decide cleanup level (verbatim with ums, or lightly edited for readability). Write an acceptance-criteria checklist (transcript spans the full duration with a final timestamp near the end, every block is timestamped, speakers are labeled consistently, glossary terms spelled correctly, output parses as the chosen format) and decisions to `notes/scope.md` via write_task_note AND to the produces path.\n\nThe deliverable `notes/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": "notes/scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "notes/scope.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "notes/scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "scope",
+        "maxAttempts": 3
+      },
+      "next": "transcribe"
+    },
+    {
+      "id": "transcribe",
+      "name": "Transcribe the recording",
+      "description": "run STT over the full file, label speakers, timestamp",
+      "prompt": "Produce the transcript to the locked format. Step 1: run the speech-to-text capability over the WHOLE file (chunk long files on silence boundaries and stitch, keeping running timestamps so they stay monotonic across chunks). Step 2: apply speaker labels and the chosen timestamp cadence. Step 3: apply the glossary — correct names/terms the recognizer got wrong. Step 4: apply the chosen cleanup level. Step 5: write the result to `transcript.md` in the locked format and confirm it parses. write_task_note the transcript path, its final timestamp, and the recording duration so coverage is checkable. On a loop-back, fix only the flagged gaps (missing tail, mislabeled speakers, glossary misspellings).",
+      "suggestedRole": "developer",
+      "advanceWhen": {
+        "file": "transcript.md",
+        "minBytes": 1,
+        "sniff": "nonempty"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "transcript.md",
+            "bytes": 500
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkContains",
+            "scope": "standard",
+            "inputs": {
+              "file": "transcript.md",
+              "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+              "flags": "i"
+            }
+          }
+        ],
+        "onReject": "transcribe",
+        "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": "Check accuracy and coverage. Step 1: confirm the LAST timestamp is within a small margin of the recording's duration (no dropped tail) — PASS/FAIL coverage. Step 2: confirm every block is timestamped and speakers are labeled consistently throughout. Step 3: spot-check 3 timestamps against the audio (if an audio capability exists) — does the text match what is said there? Step 4: confirm glossary terms/names are spelled correctly. Step 5: confirm the file parses as the chosen format. Write PASS/FAIL per criterion.\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: \"transcribe\" })` 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": "transcript.md"
+        }
+      ],
+      "next": "transcribe"
+    },
+    {
+      "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.1",
+  "releasedAt": "2026-08-14T00:00:00Z"
+}

package/data/craftbook-templates/tr/transcribe-audio/versions/1.0.1/test.json

@@ -0,0 +1,103 @@
+{
+  "schemaVersion": 1,
+  "title": "Transcribe Audio or Video smoke eval",
+  "objective": "Self-contained smoke eval for the Transcribe Audio or Video craftbook using the media generic harness.",
+  "tags": [
+    "media"
+  ],
+  "prompt": "Our media files are all listd in source/media-index.csv. Can you put together the production plan for them as media-plan.json?",
+  "setup": {
+    "projectName": "Transcribe Audio or Video Eval",
+    "about": "Self-contained eval project for transcribe-audio. Seeded inputs are under workspace/source or workspace/fixtures; final deliverable is workspace/media-plan.json.",
+    "missionObjectives": "Use the Transcribe Audio or Video craftbook/template, read the seeded local fixtures, and write media-plan.json without network calls, real credentials, or live services.",
+    "files": [
+      {
+        "path": "source/brief.md",
+        "content": "# Transcribe Audio or Video 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: transcribe-audio - Transcribe Audio or Video.\n"
+      },
+      {
+        "path": "source/media-index.csv",
+        "content": "filename,type,duration_or_size,notes\npilot-interview.wav,audio,00:02:15,mentions response time and status silence\nreturns-desk.png,image,1600x900,shows intake form and photo evidence step\nlaunch-clip.mp4,video,00:01:05,shows barcode exception handling\n"
+      }
+    ],
+    "worker": {
+      "name": "Jules",
+      "role": "Producer"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "media-plan.json is a valid JSON media-production manifest grounded in seeded fixture metadata.",
+    "deliverables": [
+      {
+        "path": "media-plan.json",
+        "kind": "json",
+        "minBytes": 700,
+        "checks": [
+          {
+            "kind": "sniff",
+            "file": "media-plan.json",
+            "sniff": "json-valid"
+          },
+          {
+            "kind": "contains",
+            "file": "media-plan.json",
+            "pattern": "pilot-interview\\.wav|returns-desk\\.png|launch-clip\\.mp4",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "media-plan.json",
+            "pattern": "outputs|assets|steps|cues|verification",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "media-plan.json",
+            "pattern": "accessibility|alt|caption|transcript|metadata",
+            "flags": "i"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "media-plan.json",
+      "kind": "json"
+    },
+    "axes": [
+      {
+        "name": "completeness",
+        "description": "The manifest covers sources, outputs, and processing steps end to end."
+      },
+      {
+        "name": "grounding",
+        "description": "Only seeded media fixtures are referenced, with faithful metadata."
+      },
+      {
+        "name": "accessibility",
+        "description": "Alt text, captions, or transcripts are planned wherever the class requires."
+      },
+      {
+        "name": "precision",
+        "description": "Timestamps, crops, and cues are specific enough to execute."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "media fixture handling",
+    "structured manifest",
+    "verification metadata"
+  ],
+  "extensions": {
+    "legacySimulators": [
+      {
+        "id": "transcribe-audio-media-fixtures",
+        "kind": "data-source",
+        "status": "implemented",
+        "description": "Seeded local media index replacing real audio, video, image generation, and external media metadata services."
+      }
+    ]
+  }
+}

package/data/craftbook-templates/tr/transcribe-index/versions/1.0.1/craftbook.json

@@ -0,0 +1,171 @@
+{
+  "id": "transcribe-index",
+  "name": "Transcribe and Index a Tape",
+  "description": "Give one tape the ten-second-findability treatment: transcript on file, then every moment worth finding indexed with its timecode and people tags — so 'the clip of Opa's 80th toast' becomes a query, not an afternoon of scrubbing. Locks the tape's metadata and the indexing rules FIRST (timecoded moments, people tags drawn from the family roster, searchable descriptions), then lands the transcript, then the clip records, then a tape summary with the highlights. Use for indexing a digitized tape, making home videos searchable, cataloging family footage, and 'what is on this tape'.\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 tape (filmarchivaris) — tape metadata, the family roster, indexing rules locked → gated on artifact `notes/scope.md` (markdown-notes)\n2. Land the transcript (transcriber) — the tape's transcript on file, timestamped and speaker-marked\n3. Index the moments (archivist) — clip records appended: tape, timecode, people, description → gated on `clips.json` (json)\n4. Write the tape summary (copywriter) — what is on the tape, the highlights, who appears → gated on artifact `report.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": [
+    "index the tape",
+    "transcribe the tape",
+    "what is on this tape",
+    "make the tape searchable",
+    "catalog the footage"
+  ],
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope the tape",
+      "description": "tape metadata, the family roster, indexing rules locked",
+      "prompt": "Define the indexing job before touching the tape. Step 1: identify the tape being indexed — its label or number, roughly when it was shot, and where its transcript lands under transcripts/ (when a transcript is already on file there, this run verifies and indexes it rather than re-transcribing). Step 2: read family.md from the workspace — the roster of names is the controlled vocabulary for people tags; a tag that is not on the roster is a typo waiting to break search. Step 3: read clips.json to see how prior tapes were indexed, and lock the indexing rules — every moment worth finding gets a record with the tape, the timecode where it starts, the people in it tagged from the roster, and a description written the way someone would actually search for it ('Opa's toast at the 80th', not 'man speaking'). Step 4: write an acceptance-criteria checklist ('transcript on file under transcripts/', 'every notable moment indexed with its timecode', 'every people tag matches the roster', 'descriptions are searchable phrases', 'existing clip records untouched'). Call write_task_note with the tape id + roster size + checklist and write notes/scope.md.\n\nThe deliverable `notes/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": "filmarchivaris",
+      "advanceWhen": {
+        "file": "notes/scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "notes/scope.md",
+            "bytes": 120,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "notes/scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "scope",
+        "maxAttempts": 3
+      },
+      "next": "transcript"
+    },
+    {
+      "id": "transcript",
+      "name": "Land the transcript",
+      "description": "the tape's transcript on file, timestamped and speaker-marked",
+      "prompt": "Get the tape's transcript on file. Step 1: produce the transcript through the project's transcription capabilities — or, when a transcript for this tape is already provided under transcripts/, read it end to end and treat it as the source. Step 2: make sure it carries what indexing needs — timestamps through the recording and speaker names where voices are identifiable from the family roster; normalize obvious mis-hearings of family names against family.md. Step 3: save the result under transcripts/ named for the tape, and skim once for the moments that will matter — celebrations, first words, arrivals, the stories people tell — noting rough timecodes as you go. Call write_task_note with the transcript path, its rough duration, and the count of candidate moments spotted.",
+      "suggestedRole": "transcriber",
+      "next": "index"
+    },
+    {
+      "id": "index",
+      "name": "Index the moments",
+      "description": "clip records appended: tape, timecode, people, description",
+      "prompt": "Index every moment worth finding. Step 1: walk the transcript and pick the moments someone will one day search for — the toast, the song, the argument about the recipe, the baby's first steps in the background. Aim for completeness over polish: a missed moment is invisible forever. Step 2: for each moment, append a record to clips.json through the project's archive capabilities — the tape id, the timecode where the moment starts (matching a timestamp in the transcript), the people in it as an array of roster names from family.md, and a searchable description. Step 3: never edit or drop the existing records from prior tapes — this is an append, and the archive's history is the point. Step 4: re-read clips.json once — valid JSON, new records complete, timecodes real. Call write_task_note with the count of new records and the single best moment found.",
+      "suggestedRole": "archivist",
+      "advanceWhen": {
+        "file": "clips.json",
+        "minBytes": 1,
+        "sniff": "json-valid"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "clips.json",
+            "bytes": 2
+          },
+          {
+            "kind": "recordSchema",
+            "file": "clips.json",
+            "fields": [
+              {
+                "name": "tape",
+                "type": "nonempty"
+              },
+              {
+                "name": "timecode",
+                "type": "nonempty"
+              },
+              {
+                "name": "people"
+              },
+              {
+                "name": "description",
+                "type": "nonempty"
+              }
+            ],
+            "minRows": 5
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkJsonValid",
+            "scope": "standard",
+            "inputs": {
+              "file": "clips.json"
+            }
+          }
+        ],
+        "onReject": "index",
+        "maxAttempts": 3
+      },
+      "next": "report"
+    },
+    {
+      "id": "report",
+      "name": "Write the tape summary",
+      "description": "what is on the tape, the highlights, who appears",
+      "prompt": "Write the tape summary the family actually reads. Step 1: open with what the tape is — when it was shot, the occasions it covers, roughly how long it runs. Step 2: give the highlights — the five or so best moments with their timecodes, written warmly enough that someone wants to go watch them. Step 3: list who appears on the tape, drawn from the people tags just indexed. Step 4: close with how to find things — a line noting that every indexed moment is searchable in the archive by person or description. Keep it to a page; this is a family document, not a catalog printout. Write report.md and call write_task_note with the report path and the indexed-moment count.\n\nThe deliverable `report.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": "report.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "report.md",
+            "bytes": 800,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "report.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i",
+            "label": "at least one markdown heading",
+            "artifact": true
+          }
+        ],
+        "onReject": "report",
+        "maxAttempts": 4
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "evaluate",
+      "name": "Evaluate",
+      "description": "Grade the deliverable against every acceptance criterion. All pass → finish; any fail → loop back and fix the gap.",
+      "prompt": "Open report.md, clips.json, the transcript under transcripts/, and family.md and verify every criterion from notes/scope.md: the transcript is on file and timestamped, every new clip record carries a timecode that appears in the transcript, every people tag matches a roster name exactly, descriptions read as searchable phrases rather than shrugs, prior tapes' records are untouched, and the summary's highlights point at real indexed moments. Write PASS/FAIL per criterion; on any failure, name the offending record and loop back to index.\n\nThe deliverable lives in the project's artifacts drawer — open `report.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: \"index\" })` 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": "report.md",
+          "artifact": true
+        }
+      ],
+      "next": "index"
+    },
+    {
+      "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.1",
+  "releasedAt": "2026-08-14T00:00:00Z"
+}