Light Reports

Reports

Reports is a lightweight operational reporting surface. It supports on-demand daily, weekly, and monthly jobs plus subscriptions, but it is not a general export center.

/reports

Overview#

Use Reports when you want a concise operational snapshot without building a second analytics workflow. The page is intentionally small: generate, subscribe, inspect status, and review anomalies or evidence-pack counts.

This page no longer promises PDF/CSV workflows, scheduled report builders, or a separate collector platform. It is the narrowed retained reporting surface described in the current product contract.

Prerequisites#

Prerequisites
  • A running organization context with enough synced operational data to generate summaries
  • Access to the Web console at `/reports`

Expected Results#

A normal reports workflow should give you:

  • -Three report types: daily, weekly, and monthly
  • -Generate and subscribe controls for each report type
  • -A job list with status, summary text, anomaly snippets, and evidence-pack count when present

Web Operations#

The page is built around a short operator loop: trigger, subscribe, review result, then move on.

Generate

Use the generate button on the daily, weekly, or monthly card to create a report job immediately. The resulting job appears in the report list below.

Subscribe

Subscriptions are intentionally simple. Toggle them per report type to keep the lightweight recurring summary flow without turning this page into a large scheduler UI.

Review Output

Inspect the report list for status, summary text, anomalies, and evidence-pack count. When evidence packs exist, the page links you into the Evidence surface instead of embedding a second evidence center here.

CLI Operations#

CLI exposes the same reporting surface plus subscription management:

Terminal
$ ap report list

Generate a report on demand:

Terminal
$ ap report generate --report-type weekly

Manage subscriptions:

Terminal
$ ap report subscription list

FAQ#

Q: Can I export reports as PDF or CSV from this page?
A: Not from the current retained reports surface. The page focuses on lightweight job generation and review rather than heavyweight export workflows.
Q: How do recurring reports work now?
A: Use subscriptions. They keep the report loop small: create or remove a subscription per report type instead of building a large scheduling product surface.
Q: Why do some reports show evidence-pack counts?
A: That count is a pointer back into the governance evidence chain. When present, use it as a handoff into the Evidence page for deeper inspection.
Reports — ClawButler User Manual