harness-starter-report

name	harness-starter-report
description	Harnessed report-generator starter. Writes a markdown artifact under reports/ and relies on the workspace contract to deliver it.
version	1.0.0
author	octos
always	false

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).