Harness Starter: Report
A report generator that produces a markdown artifact as its single deliverable. Copy this crate when you want to build an app that ships a rendered document (weekly summary, research brief, status report, etc.).
What this starter demonstrates
primary = "reports/*.md"— glob-based artifact resolution.file_size_min:$primary:256— validator gates delivery on non-trivial content length.on_failure: ["notify_user:..."]— structured failure notification.
See docs/OCTOS_HARNESS_DEVELOPER_GUIDE.md for the full contract.
Tools
generate_report
Generate a markdown report for a topic.
{"topic": "Q1 Sales Review"}
Parameters:
topic(required): report topic; also used to derive the filename (reports/q1-sales-review.md).body(optional): markdown body. When absent, a stub body is written.
Artifact:
- writes
reports/<slug>.md - the workspace policy's
primaryglob (reports/*.md) resolves to this path. - the runtime refuses to mark the task
readyuntil the file exists and is at least 256 bytes (the starter writes padded stub bodies to keep the smoke test deterministic).