cents evidence

Manage research evidence.

Synopsis

cents evidence <subcommand> [OPTIONS] [ARGS]...

Subcommands

• cents evidence delete — Delete a specific evidence item.
• cents evidence link — Link orphan evidence for a symbol to a thesis.
• cents evidence list — List evidence, optionally filtered by symbol.
• cents evidence prune — Delete evidence for theses closed more than N days ago.
• cents evidence trace — Reconstruct the prompt + output that produced an evidence row.

cents evidence delete

Delete a specific evidence item.

Synopsis

cents evidence delete [OPTIONS] EVIDENCE_ID

Arguments

Argument	Type	Required
EVIDENCE_ID	text	yes

Options

Option	Type	Default	Description
--yes	boolean	false	Confirm the action without prompting.

Example

cents evidence delete [OPTIONS] EVIDENCE_ID

cents evidence link

Link orphan evidence for a symbol to a thesis.

Synopsis

cents evidence link [OPTIONS] SYMBOL

Arguments

Argument	Type	Required
SYMBOL	text	yes

Options

Option	Type	Default	Description
--thesis/-t TEXT	text		Thesis ID to link to

Example

cents evidence link [OPTIONS] SYMBOL

cents evidence list

List evidence, optionally filtered by symbol.

Synopsis

cents evidence list [OPTIONS] [SYMBOL]

Arguments

Argument	Type	Required
SYMBOL	text	no

Options

Option	Type	Default	Description
--orphans	boolean	false	Only show evidence without a thesis
`—output [text	json]`	[text | json]	text

Example

cents evidence list [OPTIONS] [SYMBOL]

cents evidence prune

Delete evidence for theses closed more than N days ago.

By default, removes evidence for theses closed more than 30 days ago. Use —retention-days to change the threshold.

Synopsis

cents evidence prune [OPTIONS]

Options

Option	Type	Default	Description
--retention-days/-d INTEGER	integer	30	Days to retain evidence after thesis closure (default: 30)
--dry-run	boolean	false	Show what would be deleted without deleting

Example

cents evidence prune [OPTIONS]

cents evidence trace

Reconstruct the prompt + output that produced an evidence row.

Reads the evidence’s provenance columns to find its llm_call_id, then loads the append-only blob from ~/.cents/data/llm_calls/. Returns an error when the evidence has no LLM provenance (e.g. it came from a deterministic agent).

Synopsis

cents evidence trace [OPTIONS] EVIDENCE_ID

Arguments

Argument	Type	Required
EVIDENCE_ID	text	yes

Options

Option	Type	Default	Description
`—output [text	json]`	[text | json]	text

Example

cents evidence trace [OPTIONS] EVIDENCE_ID