scout_report
Generate a markdown report with findings, page scores, role matrix, oracle rollup, and a gap ledger of untested items. Enforce coverage gates and return a bounded summary.
Instructions
Generate the final markdown report — findings, page quality scores (worst first), role capability matrix, oracle rollup, and the GAP LEDGER (an explicit list of what was NOT tested). Writes the full document to .scenescout/report.md and returns a bounded SUMMARY (full reports exceed client token limits). Gates by level: 'minimal' needs all routes visited + ≥1 design audit; 'medium' additionally needs several routes audited; 'extensive' REFUSES while the gap ledger is non-empty — that refusal is the completeness guarantee: an extensive report only generates when nothing known is left untested. force=true overrides (only when the user capped the budget).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Generate even though gates are unmet (only when the user capped the budget) | |
| level | No | Which completion contract to enforce — match the level the run was asked for | medium |
| session | No | Target this session directly instead of the active one — pass it explicitly when dispatching to MULTIPLE sessions in one turn (e.g. two scout_click calls with different `session`), which then run CONCURRENTLY rather than queueing. Omit for single-session sequential use. |