cents event
Manage policy/macro events.
Synopsis
Section titled “Synopsis”cents event <subcommand> [OPTIONS] [ARGS]...Subcommands
Section titled “Subcommands”cents event backfill— Bulk-ingest historical Federal Register events.cents event list— List recently ingested events.cents event refresh— Fetch new events and fire premise-invalidation alerts.cents event retag— LLM-tag events left as ‘tagger_skipped’ by an earlier —no-tag backfill.cents event show— Show full detail of a single event.
cents event backfill
Section titled “cents event backfill”Bulk-ingest historical Federal Register events.
Used to populate the events table for historical agent backtests. Walks the date range in month-sized windows, paginating per_page=50 within each window.
Examples:
cents event backfill —start 2022-01-01 —end 2024-12-31 # tagged (slower, LLM cost) cents event backfill —start 2022-01-01 —no-tag # untagged (fast, free)
Synopsis
cents event backfill [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--start TEXT | text | Start date YYYY-MM-DD | |
--end TEXT | text | End date YYYY-MM-DD (default: today) | |
--no-tag | boolean | false | Skip LLM tagging (much faster + free; events stored with tagger_skipped status). |
--window-days INTEGER | integer | 30 | Date-window size per paginated request. |
Example
cents event backfill [OPTIONS]cents event list
Section titled “cents event list”List recently ingested events.
Synopsis
cents event list [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--tag TEXT | text | Filter by tag (repeatable). | |
--since-days INTEGER | integer | 30 | Window in days (default: 30). |
--limit INTEGER | integer | 20 |
Example
cents event list [OPTIONS]cents event refresh
Section titled “cents event refresh”Fetch new events and fire premise-invalidation alerts.
Synopsis
cents event refresh [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--lookback-days INTEGER | integer | Force a fixed lookback window (default: incremental since last fetch). |
Example
cents event refresh [OPTIONS]cents event retag
Section titled “cents event retag”LLM-tag events left as ‘tagger_skipped’ by an earlier —no-tag backfill.
Examples:
cents event retag —since 2026-02-20 # last 3 months cents event retag —since 2026-02-20 —limit 50 # smoke test
Synopsis
cents event retag [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--since TEXT | text | Only retag events on/after YYYY-MM-DD | |
--until TEXT | text | Only retag events on/before YYYY-MM-DD | |
--limit INTEGER | integer | Cap how many to retag |
Example
cents event retag [OPTIONS]cents event show
Section titled “cents event show”Show full detail of a single event.
Synopsis
cents event show EVENT_IDArguments
| Argument | Type | Required |
|---|---|---|
EVENT_ID | text | yes |
Example
cents event show EVENT_ID