william-zwy/octos-p/harness-starter-report

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 primary glob (reports/*.md) resolves to this

path.

• the runtime refuses to mark the task ready until the file exists and

is at least 256 bytes (the starter writes padded stub bodies to keep the smoke test deterministic).