Relationships
#621 Add a way to list registered report definitions (report search only lists results)
Opened by jentz · 6/11/2026· Shipped 6/11/2026
Problem
swamp report search [query] lists stored report results (artifacts from past
runs), not the report definitions currently registered/loaded from
extensions/reports/. After authoring a new report (for example a
workflow-scope report), there is no direct command to confirm it loaded and is
selectable before running anything — report search returns an empty result set
until the report has executed at least once and produced a stored artifact.
Steps to reproduce
- Add a new report under
extensions/reports/(e.g. a workflow-scope report with a fresh name). swamp report search <name> --json->{ "issues"/"results": [] }because the report has never run, even though it is correctly registered (it does run and produce output once the workflow executes).- There is no
swamp report list/--definitionsequivalent.swamp doctor extensionsconfirms extensions load but does not enumerate report definitions, andswamp model get <model> --jsonshows the resolved report set only for reports attached to a specific model.
Proposed solution
Add a way to list registered report definitions — name, scope, and source
file/extension — distinct from stored results. For example a swamp report list
command, or a reports section in swamp doctor extensions --verbose. This lets
authors verify a report registered before its first run.
Alternatives considered
Run the workflow/method once, then swamp report search — but that conflates
"is it registered" with "has it produced output", and gives no signal if the
report failed to load.
Environment
swamp 20260608.234005.0-sha.ed5f78a4.
Shipped
Click a lifecycle step above to view its details.