@bendyline/gilde 0.1.17 → 0.1.19

package/data/craftbook-templates/co/corpus-email-digest/versions/1.2.0/craftbook.json

@@ -0,0 +1,189 @@
+{
+  "id": "corpus-email-digest",
+  "name": "Daily Email Digest from a Corpus",
+  "description": "Produce an email-ready digest that summarizes a corpus of content (docs, feeds, notes) for a recurring send. Scopes what matters and the format first, drafts the digest in a consistent voice, then builds the email-ready output and evaluates for accuracy and scannability.\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 digest (planner) — what to include, sections, format, length → gated on artifact `digest/scope.md` (markdown-notes)\n2. Draft the digest (copywriter) — write the digest from the corpus, with citations → gated on artifact `digest/draft.md` (markdown-doc)\n3. Build the email output (developer) — render to an email-ready format → gated on `digest.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": [
+    "daily summary",
+    "email digest",
+    "summarize this corpus",
+    "briefing"
+  ],
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope the digest",
+      "description": "what to include, sections, format, length",
+      "prompt": "List and read every supplied corpus file with workspace tools before scoping. Decide the digest window, included sources, section structure (headline, top items, one line each), target length, tone, citation format, and subject-line convention. Write an **acceptance-criteria checklist** (\"≤ N items per section\", \"every item cites its source\", \"scannable in under a minute\", \"no item outside the window\", \"no invented facts\"). Save the scope + checklist to artifact `digest/scope.md` with `write_artifact`; note the path in task notes.",
+      "suggestedRole": "planner",
+      "advanceWhen": {
+        "file": "digest/scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "digest/scope.md",
+            "bytes": 500,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "digest/scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "digest/scope.md",
+            "pattern": "citation|source",
+            "flags": "i",
+            "label": "citation policy",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "digest/scope.md",
+            "pattern": "window|fresh|date",
+            "flags": "i",
+            "label": "freshness window",
+            "artifact": true
+          }
+        ],
+        "onReject": "scope",
+        "maxAttempts": 3
+      },
+      "next": "draft"
+    },
+    {
+      "id": "draft",
+      "name": "Draft the digest",
+      "description": "write the digest from the corpus, with citations",
+      "prompt": "Read artifact `digest/scope.md` with `read_artifact`, then re-read every included corpus source with workspace `read_file`. Write the digest to the scoped structure: a subject line, one tight line per item, and an adjacent source filename/citation for every item. Lead with what matters, keep a consistent voice, and do not invent or merge unsupported facts. Save the complete draft to artifact `digest/draft.md` with `write_artifact`; note the path in task notes.",
+      "suggestedRole": "copywriter",
+      "advanceWhen": {
+        "file": "digest/draft.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "digest/draft.md",
+            "bytes": 700,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "digest/draft.md",
+            "pattern": "subject\\s*:",
+            "flags": "i",
+            "label": "subject line",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "digest/draft.md",
+            "pattern": "\\.md\\b|source\\s*:",
+            "flags": "i",
+            "label": "source citations",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "digest/draft.md",
+            "pattern": "(?:^|\\n)#{1,3}\\s+\\S",
+            "flags": "i",
+            "label": "at least one markdown heading",
+            "artifact": true
+          }
+        ],
+        "onReject": "draft",
+        "maxAttempts": 3
+      },
+      "next": "build"
+    },
+    {
+      "id": "build",
+      "name": "Build the email output",
+      "description": "render to an email-ready format",
+      "prompt": "Read artifacts `digest/scope.md` and `digest/draft.md` with `read_artifact`. Render the approved draft to workspace `digest.html` with `write_file`. Include the subject line in visible/preheader content, preserve every adjacent source citation, use semantic email-safe tables or blocks, and keep styles inline or in a small embedded style block with no external CSS, scripts, or network assets. On a loop-back, fix only the named gaps. `write_task_note` the workspace output path and item/source counts.",
+      "suggestedRole": "developer",
+      "advanceWhen": {
+        "file": "digest.html",
+        "minBytes": 1,
+        "sniff": "html-complete"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "digest.html",
+            "bytes": 2200
+          },
+          {
+            "kind": "htmlLint",
+            "file": "digest.html"
+          },
+          {
+            "kind": "cssMinBytes",
+            "bytes": 350,
+            "file": "digest.html"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "subject\\s*:",
+            "flags": "i",
+            "label": "subject line"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "\\.md\\b|source\\s*:",
+            "flags": "i",
+            "label": "source citations"
+          }
+        ],
+        "scripts": [
+          {
+            "name": "checkHtmlComplete",
+            "scope": "standard",
+            "inputs": {
+              "file": "digest.html"
+            }
+          }
+        ],
+        "onReject": "build",
+        "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": "Read workspace `digest.html` with `read_file`, artifacts `digest/scope.md` and `digest/draft.md` with `read_artifact`, and the original corpus files with workspace tools. Check accuracy (every item traces to a corpus fact, nothing invented), citations (each item names its source), scannability, section/item limits, and freshness window. Confirm the HTML preserves the approved draft and has no external dependencies. 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: \"build\" })` 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",
+      "next": "build"
+    },
+    {
+      "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.2.0",
+  "releasedAt": "2026-08-10T00:00:00Z"
+}

package/data/craftbook-templates/co/corpus-email-digest/versions/1.2.0/test.json

@@ -0,0 +1,187 @@
+{
+  "schemaVersion": 1,
+  "title": "Corpus-grounded email-digest workflow",
+  "objective": "Run the Daily Email Digest from a Corpus craftbook and verify scoped citation rules and a source-grounded draft precede the final email-ready HTML.",
+  "tags": [
+    "html-page",
+    "corpus",
+    "workflow"
+  ],
+  "prompt": "Use the Daily Email Digest from a Corpus craftbook. Read every file under workspace `corpus/` and build workspace `digest.html` for a Friday leadership update. Include a visible subject line, three sections (Wins, Watchouts, Next Actions), one tight line per item, and an adjacent source filename for every item. Scope the digest and write a cited draft before rendering it. Use inline or embedded email-safe CSS only, with no scripts or external assets.",
+  "setup": {
+    "projectName": "Corpus Email Digest Eval",
+    "about": "Self-contained workflow eval for the Daily Email Digest from a Corpus craftbook. Source files are in the workspace, scope/draft deliverables belong in artifacts, and the final email belongs at workspace/digest.html.",
+    "missionObjectives": "Produce an accurate, scannable HTML email digest from all seeded corpus files with a subject line, three sections, adjacent source citations, and no invented items.",
+    "files": [
+      {
+        "path": "corpus/win-fulfillment.md",
+        "content": "# Fulfillment Note\nDate: 2026-06-24\nSource: win-fulfillment.md\n\nThe packing cell cleared a two-day backlog after introducing color-coded shelf labels. Error reships dropped from 19 last week to 7 this week.\n"
+      },
+      {
+        "path": "corpus/watchout-carrier.md",
+        "content": "# Carrier Watchout\nDate: 2026-06-25\nSource: watchout-carrier.md\n\nNorthline carrier scans are arriving up to 14 hours late for Zone 5 parcels. Customer support is seeing duplicate status tickets from premium subscribers.\n"
+      },
+      {
+        "path": "corpus/action-finance.md",
+        "content": "# Finance Action\nDate: 2026-06-26\nSource: action-finance.md\n\nFinance needs the exception export by Tuesday noon so it can approve the pilot automation budget before the July planning meeting.\n"
+      }
+    ],
+    "worker": {
+      "name": "Jules",
+      "role": "Developer"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "A craftbook task produces scoped citation rules, a source-grounded artifact draft, and a complete email-ready workspace/digest.html.",
+    "deliverables": [
+      {
+        "path": "digest.html",
+        "kind": "html-page",
+        "minBytes": 2200,
+        "checks": [
+          {
+            "kind": "cssMinBytes",
+            "bytes": 350,
+            "file": "digest.html"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "Subject:",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "Wins[\\s\\S]*Watchouts[\\s\\S]*(?:Next Actions|Actions)",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "win-fulfillment\\.md"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "watchout-carrier\\.md"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "action-finance\\.md"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "19[\\s\\S]*7|7[\\s\\S]*19"
+          },
+          {
+            "kind": "contains",
+            "file": "digest.html",
+            "pattern": "14 hours|Tuesday noon",
+            "flags": "i"
+          },
+          {
+            "kind": "notContains",
+            "file": "digest.html",
+            "pattern": "<script\\b|https?://",
+            "flags": "i"
+          }
+        ]
+      }
+    ],
+    "checks": [
+      {
+        "kind": "minBytes",
+        "file": "digest/scope.md",
+        "bytes": 500,
+        "artifact": true
+      },
+      {
+        "kind": "contains",
+        "file": "digest/scope.md",
+        "pattern": "(?:citation|source)[\\s\\S]*(?:window|fresh|date)",
+        "flags": "i",
+        "artifact": true
+      },
+      {
+        "kind": "minBytes",
+        "file": "digest/draft.md",
+        "bytes": 700,
+        "artifact": true
+      },
+      {
+        "kind": "contains",
+        "file": "digest/draft.md",
+        "pattern": "subject\\s*:[\\s\\S]*win-fulfillment\\.md[\\s\\S]*watchout-carrier\\.md[\\s\\S]*action-finance\\.md",
+        "flags": "i",
+        "artifact": true
+      }
+    ],
+    "taskNotes": {
+      "minBytes": 160,
+      "checks": [
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "scope\\.md",
+          "flags": "i"
+        },
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "draft\\.md",
+          "flags": "i"
+        },
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "digest\\.html",
+          "flags": "i"
+        }
+      ],
+      "requireCraftbookTask": true
+    },
+    "taskGraph": {
+      "requireCraftbookTask": true,
+      "requireTerminalStep": true
+    },
+    "unchangedFixtures": [
+      "corpus/win-fulfillment.md",
+      "corpus/watchout-carrier.md",
+      "corpus/action-finance.md"
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "digest.html",
+      "kind": "html"
+    },
+    "axes": [
+      {
+        "name": "grounding",
+        "description": "Every digest item preserves a source fact and names the adjacent source without invented operational detail."
+      },
+      {
+        "name": "scannability",
+        "description": "The subject, sections, hierarchy, and one-line items can be understood in under a minute."
+      },
+      {
+        "name": "email readiness",
+        "description": "The HTML is self-contained, conservatively styled, and readable in an email-client-shaped viewport."
+      },
+      {
+        "name": "workflow evidence",
+        "description": "Scope and draft artifacts are substantive and align with the final email."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "craftbook attribution",
+    "source-read enforcement",
+    "adjacent citations",
+    "artifact-to-workspace handoff"
+  ]
+}