@bendyline/gilde 0.1.51 → 0.1.53

package/data/craftbook-templates/th/thank-you-sweep/versions/1.0.3/craftbook.json

@@ -0,0 +1,280 @@
+{
+  "id": "thank-you-sweep",
+  "name": "Post-Event Thank-You Sweep",
+  "description": "Close the event the way it deserves: every gift-giver and every helper matched to a personal note, drafted in one sitting and tracked to sent — so 'the thank-yous actually go out' becomes a checklist instead of a lingering guilt. Locks the coverage rule FIRST — every giver, every helper, one personal detail each — then drafts the batch, then records each note to sent in the event's books. Use for post-event thank-yous, thanking the helpers after a party, gift thank-you notes, and 'the party's done, sweep the thank yous'.\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 sweep (ceremoniemeester) — gift and helper roster, coverage rule, tracking rule → gated on artifact `{{workPath}}/scope.md` (markdown-notes)\n2. Draft the notes (copywriter) — one personal note per giver and helper → gated on `letters/thank-you.md` (markdown-doc)\n3. Record and report (archivist) — track each note in the books, write the coverage summary → gated on artifact `{{workPath}}/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": [
+    "sweep the thank yous",
+    "post event thank yous",
+    "thank the helpers",
+    "gift thank you notes",
+    "thank you sweep after the party"
+  ],
+  "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": "Scope the sweep",
+      "description": "gift and helper roster, coverage rule, tracking rule",
+      "prompt": "Define the sweep before drafting. Step 1: read gifts.json from the workspace — who gave what — and guests.json for the people who helped without a gift attached: setup, kitchen, driving, cleanup. Step 2: lock the coverage rule with the owner: every giver AND every helper gets a note, one personal detail each — the actual gift for givers, the actual deed for helpers — and helpers never get a gift-shaped form note. Step 3: settle how notes go out and what 'tracked to sent' means in the event's books. Step 4: write an acceptance-criteria checklist ('every giver and every helper covered or explicitly deferred with a reason', 'each note names the specific gift or deed from the record', 'no two notes interchangeable', 'every note recorded drafted and tracked to sent'). Call write_task_note with the giver + helper counts and the 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": "ceremoniemeester",
+      "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": "draft",
+      "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": "draft",
+      "name": "Draft the notes",
+      "description": "one personal note per giver and helper",
+      "prompt": "Draft the whole batch against the locked coverage rule. Step 1: one section per person in letters/thank-you.md — a heading with their name, then the note. Step 2: givers get the gift named in the first two sentences and a line about how it will be used or where it now lives. Step 3: helpers get the actual deed named — the grill run all afternoon, the chairs stacked at midnight — never a generic 'thanks for your help'. Step 4: vary the shape so no two notes could swap recipients. Step 5: call write_task_note with the note count split by givers and helpers.",
+      "suggestedRole": "copywriter",
+      "advanceWhen": {
+        "file": "letters/thank-you.md",
+        "minBytes": 1,
+        "sniff": "nonempty"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "letters/thank-you.md",
+            "bytes": 1200
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkContains",
+            "scope": "standard",
+            "inputs": {
+              "file": "letters/thank-you.md",
+              "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+              "flags": "i"
+            }
+          }
+        ],
+        "onReject": "draft",
+        "maxAttempts": 3
+      },
+      "next": "record",
+      "toolPolicy": {
+        "disallowBuiltinToolsets": [
+          "ai-apps",
+          "archives",
+          "artifacts",
+          "audio",
+          "browser-automation",
+          "code-execution",
+          "craftbooks",
+          "data-tables",
+          "entity-intel",
+          "git",
+          "image-intel",
+          "images",
+          "role-delegation",
+          "role-delegation-escalation",
+          "security-intel",
+          "team-management",
+          "videos",
+          "web"
+        ],
+        "outputMedium": "workspace",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      }
+    },
+    {
+      "id": "record",
+      "name": "Record and report",
+      "description": "track each note in the books, write the coverage summary",
+      "prompt": "Close the sweep. Step 1: record each note against the person's entry through the project's event books so every one is tracked drafted and then sent. Step 2: write the run summary — the coverage count stated plainly ('X of Y covered'), who was deferred and why, and what still has to physically happen for the notes to actually go out. Step 3: keep it short and honest. Write {{workPath}}/report.md and call write_task_note with the coverage count.\n\nThe deliverable `{{workPath}}/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": "archivist",
+      "advanceWhen": {
+        "file": "{{workPath}}/report.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/report.md",
+            "bytes": 600,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/report.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i",
+            "label": "at least one markdown heading",
+            "artifact": true
+          }
+        ],
+        "onReject": "record",
+        "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 letters/thank-you.md and {{workPath}}/report.md and verify every criterion from {{workPath}}/scope.md: every giver in gifts.json and every helper in guests.json is covered or explicitly deferred with a reason — count them, the forgotten setup crew is the classic failure — each note names the specific gift or deed from the record (spot-check each against the stores), no two notes are interchangeable, and the report states the coverage count with each note tracked. Write PASS/FAIL per criterion; on any failure, name the person and the gap and loop back to draft.\n\nThe deliverable lives in the project's artifacts drawer — open `{{workPath}}/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: \"draft\" })` 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": "{{workPath}}/report.md",
+          "artifact": true
+        }
+      ],
+      "next": "draft",
+      "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.3",
+  "releasedAt": "2026-09-01T20:00:00Z",
+  "minGezelVersion": "1.26233"
+}

package/data/craftbook-templates/th/thank-you-sweep/versions/1.0.3/test.json

@@ -0,0 +1,142 @@
+{
+  "schemaVersion": 1,
+  "title": "Post-Event Thank-You Sweep — givers and helpers to tracked notes",
+  "objective": "Measure whether the thank-you-sweep craftbook covers every gift-giver AND every helper from the seeded event stores with a personal note each, tracked in a coverage report — the forgotten setup crew is the classic failure.",
+  "tags": [
+    "corpus"
+  ],
+  "prompt": "party's done, gift list is logged — can you sweep the thank yous? dont miss the setup crew eiter",
+  "setup": {
+    "projectName": "Harvest Party Wrap-Up",
+    "about": "Event planner project closing out the Okafor harvest party. Gifts are logged at workspace/gifts.json and the guest and helper roster is workspace/guests.json; notes go under workspace/letters.",
+    "missionObjectives": "Every giver and every helper gets a personal note, tracked to sent. Notes are grounded in the stores — no live services, no real credentials.",
+    "files": [
+      {
+        "path": "gifts.json",
+        "content": "{\n  \"event\": \"harvest party\",\n  \"gifts\": [\n    { \"from\": \"Ines Duarte\", \"gift\": \"a crate of quinces from her own tree\" },\n    { \"from\": \"Bram Visser\", \"gift\": \"a hand-carved serving spoon\" },\n    { \"from\": \"Ruthie Campbell\", \"gift\": \"two jars of hot pepper jelly\" },\n    { \"from\": \"Felix Andrade\", \"gift\": \"a braided garlic string\" },\n    { \"from\": \"Nora Whitfield\", \"gift\": \"a watercolor card and a bag of tulip bulbs\" },\n    { \"from\": \"Sam Iverson\", \"gift\": \"a growler of cider from the mill\" },\n    { \"from\": \"Petra Molnar\", \"gift\": \"a loaf of seeded rye still warm\" }\n  ]\n}\n"
+      },
+      {
+        "path": "guests.json",
+        "content": "{\n  \"event\": \"harvest party\",\n  \"guests\": [\n    { \"name\": \"Ines Duarte\" },\n    { \"name\": \"Bram Visser\" },\n    { \"name\": \"Ruthie Campbell\" },\n    { \"name\": \"Felix Andrade\" },\n    { \"name\": \"Nora Whitfield\" },\n    { \"name\": \"Sam Iverson\" },\n    { \"name\": \"Petra Molnar\" },\n    { \"name\": \"Dev Chauhan\", \"helped\": \"ran the grill the whole afternoon and never once sat down\" },\n    { \"name\": \"Marisol Vega\", \"helped\": \"set up the tables and strung the lights, then stacked every chair at midnight\" }\n  ]\n}\n"
+      }
+    ],
+    "worker": {
+      "name": "Coby",
+      "role": "Event assistant"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "letters/thank-you.md covers all seven givers and both helpers with personal detail each; tasks/eval/report.md states the coverage count with notes tracked.",
+    "deliverables": [
+      {
+        "path": "letters/thank-you.md",
+        "kind": "markdown-doc",
+        "minBytes": 1200,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "letters/thank-you.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S"
+          },
+          {
+            "kind": "valuesSubsetOf",
+            "file": "letters/thank-you.md",
+            "sourceFiles": [
+              "gifts.json",
+              "guests.json"
+            ],
+            "pattern": "Dear\\s+([A-Z][A-Za-z'-]+)",
+            "minMatches": 9,
+            "label": "a salutation per giver and helper, names from the stores"
+          },
+          {
+            "kind": "contains",
+            "file": "letters/thank-you.md",
+            "pattern": "quince|spoon|jelly|garlic",
+            "flags": "i",
+            "label": "gifts named, first half"
+          },
+          {
+            "kind": "contains",
+            "file": "letters/thank-you.md",
+            "pattern": "tulip|cider|rye",
+            "flags": "i",
+            "label": "gifts named, second half"
+          },
+          {
+            "kind": "contains",
+            "file": "letters/thank-you.md",
+            "pattern": "grill|tables|lights|chairs",
+            "flags": "i",
+            "label": "helpers' actual deeds named"
+          },
+          {
+            "kind": "judge",
+            "file": "letters/thank-you.md",
+            "rubric": "Every giver's note names the actual gift and every helper's note names the actual deed from the stores; helpers do not get a gift-shaped form note; no two notes are interchangeable.",
+            "sourceFiles": [
+              "gifts.json",
+              "guests.json"
+            ]
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/report.md",
+        "kind": "markdown-report",
+        "minBytes": 600,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "sent|tracked",
+            "flags": "i",
+            "label": "tracking state recorded"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/report.md",
+            "pattern": "9|nine",
+            "flags": "i",
+            "label": "coverage count stated"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "letters/thank-you.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "coverage",
+        "description": "All seven givers and both helpers are covered — the setup crew is not forgotten."
+      },
+      {
+        "name": "specificity",
+        "description": "Each note names the specific gift or deed from the record, not a generic thanks."
+      },
+      {
+        "name": "warmth",
+        "description": "The notes sound like a grateful host, personal and unhurried."
+      },
+      {
+        "name": "tracking discipline",
+        "description": "Every note is recorded and the report states the coverage plainly."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "giver and helper coverage",
+    "per-note specificity",
+    "tracked to sent"
+  ]
+}