# summary

Render structured AgentReportData JSON to an HTML or Markdown report.

# description

Reads an AgentReportData JSON document and renders it with the plugin's deterministic report renderer. Use this instead of hand-rolling a one-off report script. The AgentReportData shape is: `{ title, generatedAt, taskId?, author?, sections: [{ title, findings?, metrics?, recommendations?, prose? }] }`. Output goes to a file with `--out`, or to stdout when `--out` is omitted.

# examples

- `sf setup-agents report generate --input data.json --format markdown`
- `sf setup-agents report generate --input data.json --format html --out report.html`
- `sf setup-agents report generate -i data.json -f html -o docs/report.html`

# flags.input.summary

Path to an AgentReportData JSON file.

# flags.format.summary

Output format: html or markdown.

# flags.out.summary

Path to write the rendered output. When omitted, the result is printed to stdout.

# info.wrote

Wrote %s (%s).

# error.invalidJson

Could not parse %s as JSON: %s

# error.invalidData

%s is not valid AgentReportData: expected an object with a "sections" array.