@bendyline/gilde 0.1.58 → 0.1.59

package/data/craftbook-templates/re/report-pdf/versions/1.1.4/test.json

@@ -0,0 +1,101 @@
+{
+  "schemaVersion": 1,
+  "title": "Formatted PDF Report Markdown-source smoke eval",
+  "objective": "Verify that the report workflow produces a complete, source-grounded Markdown report before DocBlocks conversion; catalog contract tests cover the PDF toolset, artifact gate, and no-HTML routing.",
+  "tags": [
+    "corpus"
+  ],
+  "prompt": "Read source/brief.md and write the complete report source to pdf/eval/report.md. Use Markdown headings and a compact metrics table. Include an executive summary and explicit recommendations. Do not create HTML.",
+  "setup": {
+    "projectName": "Formatted PDF Report Eval",
+    "about": "The report source is Markdown and will be converted to PDF by the DocBlocks production step.",
+    "missionObjectives": "Create a source-grounded pdf/eval/report.md that is ready for direct PDF conversion without HTML or CSS.",
+    "files": [
+      {
+        "path": "source/brief.md",
+        "content": "# Boreal Desk Returns Pilot\n\nAudience: operations leaders.\n\nFacts:\n- The 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: automated status emails, barcode-exception training, and a weekly Finance exception export.\n\nDo not invent other metrics."
+      }
+    ],
+    "worker": {
+      "name": "Jules",
+      "role": "Copywriter"
+    },
+    "craftbookParams": {
+      "sourceOutputPath": "pdf/eval/report.md"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "pdf/eval/report.md is a complete Markdown source grounded in every supplied fact and ready for DocBlocks PDF conversion.",
+    "deliverables": [
+      {
+        "path": "pdf/eval/report.md",
+        "kind": "markdown-report",
+        "minBytes": 1000,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "pdf/eval/report.md",
+            "pattern": "(?:^|\\n)#\\s+.+",
+            "flags": "m"
+          },
+          {
+            "kind": "contains",
+            "file": "pdf/eval/report.md",
+            "pattern": "executive summary",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "pdf/eval/report.md",
+            "pattern": "18\\s+SKUs|18\\s+hours|6\\s+hours|14\\.2%|8\\.9%",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "pdf/eval/report.md",
+            "pattern": "automated status emails|barcode-exception training|weekly Finance exception export",
+            "flags": "i"
+          },
+          {
+            "kind": "contains",
+            "file": "pdf/eval/report.md",
+            "pattern": "recommend",
+            "flags": "i"
+          },
+          {
+            "kind": "notContains",
+            "file": "pdf/eval/report.md",
+            "pattern": "<html|<style|@page",
+            "flags": "i"
+          }
+        ]
+      }
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "pdf/eval/report.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "grounding",
+        "description": "Every metric and required action comes from the seeded brief."
+      },
+      {
+        "name": "structure",
+        "description": "The Markdown has a clear title, executive summary, body sections, and recommendations."
+      },
+      {
+        "name": "readiness",
+        "description": "The source is complete enough for direct DocBlocks conversion without an HTML intermediary."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "Markdown source quality",
+    "source grounding",
+    "no HTML intermediary"
+  ]
+}

package/data/craftbook-templates/re/research-to-document/versions/1.2.4/craftbook.json

@@ -0,0 +1,386 @@
+{
+  "id": "research-to-document",
+  "name": "Word Document from Content or Research",
+  "description": "Produce a real Word document from supplied notes, existing workspace content, or a research question. The workflow locks the audience and document structure, inventories the provided evidence (and researches only when the user actually asked for new research), writes the complete source as {{sourceOutputPath}}, then uses the pre-authorized DocBlocks toolset to convert directly to DOCX, preview the pages, and save {{workPath}}/report.docx in the artifacts drawer. PDF can be emitted in the same conversion call when requested.\n\nPlain Markdown is the source of truth. DocBlocks needs no validation preflight: convert_document reports diagnostics and preview_document supplies visual evidence. Never call the removed validate_document tool, hand-assemble OOXML, or substitute HTML for a requested DOCX.\n\nWorking files under {{workPath}}/, reviews/, and reports/ live in the project artifacts drawer and must be read and written with the artifact tools. User-facing source files remain in the workspace.\n\nPreview review checks content and available rendered evidence. Reconstructed Office/PDF views do not prove native layout; a media thumbnail does not prove full playback. The final handoff states these review limits.",
+  "entryStepId": "scope",
+  "triggers": [
+    "create a word document",
+    "make a docx",
+    "export this as docx",
+    "turn this content into a word document",
+    "research and write a document",
+    "research this and put it in word",
+    "write a cited briefing document"
+  ],
+  "toolsets": [
+    {
+      "toolsetId": "docblocks",
+      "sourceId": "bundled",
+      "autoAllow": true,
+      "reason": "convert {{sourceOutputPath}} directly to DOCX or PDF, preview pages, and save the finished document without a prompt per call"
+    }
+  ],
+  "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}}"
+      },
+      "sourceOutputPath": {
+        "type": "string",
+        "title": "Editable source path",
+        "description": "Workspace-relative Markdown source path. The default keeps each task separate; choose an existing path only when intentionally revising it.",
+        "default": "documents/task-{{task.num}}/report.md"
+      }
+    }
+  },
+  "steps": [
+    {
+      "id": "scope",
+      "name": "Scope the document",
+      "description": "Lock audience, source boundary, structure, requested formats, and acceptance criteria.",
+      "prompt": "Scope the document before writing. 1. State the audience, purpose, and decision/takeaway. 2. Inventory the supplied content and named workspace files. Decide whether the user asked for new research; if not, explicitly prohibit adding outside facts. 3. Lock the section order, citation style when relevant, and whether the durable output is DOCX only or DOCX plus PDF. 4. Identify tables, figures, and existing media assets that must survive conversion. 5. Write acceptance criteria covering source fidelity, section coverage, citations when needed, readable page layout, and real saved binary files in artifacts. Write {{workPath}}/scope.md and call write_task_note with the source boundary, section count, and target formats.\n\nStore `{{workPath}}/scope.md` in the artifacts drawer with `write_artifact`, then verify it with `read_artifact`; do not write this working file to the workspace.\n\nRead an exact workspace DOCX, PPTX, PDF, or XLSX source with `read_doc_as_markdown`; use `read_file` for text or Markdown. Keep the original file path in citations. Never interpret binary bytes as text or substitute a similarly named file.",
+      "suggestedRole": "planner",
+      "advanceWhen": {
+        "file": "{{workPath}}/scope.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/scope.md",
+            "bytes": 180,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/scope.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "scope",
+        "maxAttempts": 3
+      },
+      "next": "sources",
+      "toolPolicy": {
+        "disallowToolsets": [
+          "docblocks"
+        ],
+        "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": "sources",
+      "name": "Prepare the source log",
+      "description": "Record supplied sources and gather new evidence only when research was requested.",
+      "prompt": "Prepare {{workPath}}/sources.md to the boundary in {{workPath}}/scope.md. If the user supplied the content and did not ask for research, list each supplied file or message section and the facts it contributes; do not browse or add outside claims. If new research was requested, gather credible sources, record title/publisher/date/URL or workspace path, extract only the facts relevant to the outline, and cross-check consequential claims. Assign stable citation keys when citations are required. Mark unsupported gaps rather than guessing. Call write_task_note with the source count and unresolved gaps.\n\nOpen `{{workPath}}/scope.md`, `{{workPath}}/sources.md` from the artifacts drawer with `read_artifact` before working.\n\nRead an exact workspace DOCX, PPTX, PDF, or XLSX source with `read_doc_as_markdown`; use `read_file` for text or Markdown. Keep the original file path in citations. Never interpret binary bytes as text or substitute a similarly named file.\n\nStore `{{workPath}}/sources.md` with `write_artifact` and verify it with `read_artifact` before advancing.",
+      "suggestedRole": "researcher",
+      "consumes": [
+        {
+          "file": "{{workPath}}/scope.md",
+          "artifact": true
+        }
+      ],
+      "advanceWhen": {
+        "file": "{{workPath}}/sources.md",
+        "minBytes": 1,
+        "sniff": "nonempty",
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/sources.md",
+            "bytes": 160,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/sources.md",
+            "sniff": "nonempty",
+            "artifact": true
+          }
+        ],
+        "onReject": "sources",
+        "maxAttempts": 3
+      },
+      "next": "write",
+      "toolPolicy": {
+        "disallowToolsets": [
+          "docblocks"
+        ],
+        "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",
+          "workspace-fs-write"
+        ],
+        "outputMedium": "artifact",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      }
+    },
+    {
+      "id": "write",
+      "name": "Write the Markdown document",
+      "description": "Write the complete {{sourceOutputPath}} source from the locked outline and source log.",
+      "prompt": "Write {{sourceOutputPath}} as the complete document source. 1. Follow {{workPath}}/scope.md section order exactly, starting with one H1 title and a concise opening summary. 2. Use clear H2/H3 sections and real prose grounded only in {{workPath}}/sources.md. 3. Use Markdown tables for structured comparisons and existing workspace images only when the scope calls for them; add meaningful alt text, captions, and in-prose references. 4. Cite claims with the locked style and include references when research was requested. 5. End with the requested conclusion, recommendation, or next steps. 6. Check every content criterion before advancing. Do not create DOCX XML, HTML, or base64. Call write_task_note with the path, word count, and section count.\n\nOpen `{{workPath}}/scope.md`, `{{workPath}}/sources.md` from the artifacts drawer with `read_artifact` before working.",
+      "suggestedRole": "copywriter",
+      "consumes": [
+        {
+          "file": "{{workPath}}/scope.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/sources.md",
+          "artifact": true
+        }
+      ],
+      "advanceWhen": {
+        "file": "{{sourceOutputPath}}",
+        "minBytes": 1,
+        "sniff": "nonempty"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{sourceOutputPath}}",
+            "bytes": 1000
+          },
+          {
+            "kind": "contains",
+            "file": "{{sourceOutputPath}}",
+            "pattern": "(?:^|\\n)#\\s+\\S",
+            "label": "an H1 document title"
+          },
+          {
+            "kind": "contains",
+            "file": "{{sourceOutputPath}}",
+            "pattern": "(?:^|\\n)##\\s+\\S",
+            "label": "at least one document section"
+          }
+        ],
+        "onReject": "write",
+        "maxAttempts": 4
+      },
+      "next": "publish",
+      "toolPolicy": {
+        "disallowToolsets": [
+          "docblocks"
+        ],
+        "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"
+        ],
+        "outputMedium": "workspace",
+        "additionalOutputMedia": [
+          "task-note"
+        ]
+      }
+    },
+    {
+      "id": "publish",
+      "name": "Publish the Word document",
+      "description": "Convert the approved source, inspect and preview it, and save the real binary deliverables with review evidence.",
+      "prompt": "Publish the approved Markdown as real binary files. 1. Call `list_roots` to identify the read-enabled workspace root and write-enabled artifacts root. If no write root exists, record the blocker. Read `{{workPath}}/scope.md` from the artifacts drawer with `read_artifact` and the approved `{{sourceOutputPath}}` from the workspace with `read_file`. 2. Call `convert_document` with source `{ \"kind\": \"file\", \"rootId\": <workspace root id>, \"path\": \"{{sourceOutputPath}}\" }` and `autoTemplates: true`. Use a DOCX target with `fidelity: \"editable-native\"` and the document title. Include a PDF target in the same call only when scope.md requests it, then preview and save that PDF too at `{{workPath}}/report.pdf`. Ordinary Markdown works with defaults; use discovery only to answer a specific style requirement. 3. Use each returned artifact URI with `inspect_document` and `preview_document`, passing source `{ \"kind\": \"artifact\", \"uri\": <returned URI> }`. Review content, tables, and any reported diagnostics; request at most four preview items at a time and paginate. Interpret `previewBasis` accurately. Office/PDF `reconstructed-import` previews show normalized content sections, not native pagination, fonts, clipping, or page breaks. Review all available sections with pagination and record this native-layout limit. Do not call these native page images or invent a native page count. An accurately disclosed preview limit alone does not fail content and saved-file checks. If content or source structure fails, write precise gaps to task notes and call `advance_task_step` with next `\"write\"`; do not edit the source during this publishing step. 4. Call `save_artifact` for `{{workPath}}/report.docx` using the artifacts root and `ifExists: \"error\"`. For an existing output, inspect that saved file and use its `sourceSha256` as `expectedSha256` with `ifExists: \"replace\"`. Use only URIs returned by this session; reopen earlier saved binaries through file sources. Finally, write a task note with saved paths, hashes, available counts, diagnostics, preview basis, and review limits, then advance to evaluate. Never substitute HTML, renamed Markdown, or hand-written XML for the requested binary files.",
+      "suggestedRole": "copywriter",
+      "consumes": [
+        {
+          "file": "{{workPath}}/scope.md",
+          "artifact": true
+        },
+        {
+          "file": "{{sourceOutputPath}}"
+        }
+      ],
+      "advanceWhen": {
+        "file": "{{workPath}}/report.docx",
+        "minBytes": 1,
+        "artifact": true
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/report.docx",
+            "bytes": 1000,
+            "artifact": true
+          }
+        ],
+        "onReject": "publish",
+        "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": "Review saved-file integrity and content fidelity; document the limits of reconstructed or first-frame previews.",
+      "prompt": "Read `{{workPath}}/scope.md` from the artifacts drawer with `read_artifact` and the approved `{{sourceOutputPath}}` from the workspace with `read_file`. Read prior review/publishing evidence with `read_task_notes`. Call `list_roots` and reopen each saved binary in `{{workPath}}/report.docx` with `inspect_document` and `preview_document`, using source `{ \"kind\": \"file\", \"rootId\": <artifacts root id>, \"path\": <saved path> }`. Artifact URIs from another session are not reusable. Confirm the binary opens, the supplied facts and requested content are preserved, section order and tables follow the approved source, and citations/next actions remain present. Check `{{workPath}}/report.pdf` too when scope.md requests PDF. Interpret `previewBasis` accurately. Office/PDF `reconstructed-import` previews show normalized content sections, not native pagination, fonts, clipping, or page breaks. Review all available sections with pagination and record this native-layout limit. Do not call these native page images or invent a native page count. An accurately disclosed preview limit alone does not fail content and saved-file checks. Write PASS/FAIL per verifiable content and saved-file criterion, name exact gaps, and state any native-layout or playback property that remains unverified. If these checks pass, route to `finish`; for content/structure failures route to `write`; for conversion/save/copy failures with the source still approved route to `publish`. Never claim an unmet criterion passed. After three unproductive loops, record DONE_WITH_CONCERNS and the remaining gaps. On PASS, call `advance_task_step` with next: \"finish\". Use next: \"write\" only for an identified source-content failure, or next: \"publish\" for an identified conversion/save failure.",
+      "suggestedRole": "reviewer",
+      "consumes": [
+        {
+          "file": "{{workPath}}/scope.md",
+          "artifact": true
+        }
+      ],
+      "next": "finish",
+      "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": "Deliver the saved files with the recorded review evidence and limits.",
+      "prompt": "Read the review evidence with `read_task_notes`. Write a concise DONE summary naming the editable Markdown source `{{sourceOutputPath}}` and the saved deliverables `{{workPath}}/report.docx`. Include available native counts and the preview basis, and carry forward any native-layout or playback properties that remain unverified. Do not open binary files with `read_artifact` or claim an unavailable check passed.",
+      "suggestedRole": "copywriter",
+      "consumes": [
+        {
+          "file": "{{sourceOutputPath}}"
+        }
+      ],
+      "terminal": true,
+      "toolPolicy": {
+        "disallowToolsets": [
+          "docblocks"
+        ],
+        "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"
+      }
+    }
+  ],
+  "version": "1.2.4",
+  "releasedAt": "2026-09-07T01:00:00Z",
+  "minGezelVersion": "1.26233"
+}