CLI side-effect inventory¶
Checked against the Click command registry by scripts/dev/sync_docs.py. “When run” means when the command body executes; --help executes nothing. For source selection and limits, see Fetching and source protection.
| Command | Third-party fetching | Local effects |
|---|---|---|
cne audit |
conditional | Reads the lake and prints the audit; accesses sources when external comparison is enabled |
cne backfill |
when run | Backfills history, writing staging and published data; --plan only reads config and state |
cne check |
none | Reads status, freshness, audit results and stats; recomputes stale stats, --full reruns the full-lake audit |
cne config |
none | create writes the personal config; upgrade backs up, then adds schedule steps; validate/diff only read |
cne contract diff |
none | Reads contracts and prints the diff |
cne contract show |
none | Reads the contract; writes a file when an output path is given |
cne contract validate |
none | Validates the contract |
cne decision-data cash-rights |
none | Reads the lake and prints decision data |
cne decision-data payment-gaps |
none | Reads the lake and prints decision data |
cne decision-data stock-terms |
none | Reads the lake and prints decision data |
cne delisted status |
none | Reads delisting status |
cne derive |
conditional | Writes derived data; modes such as adj_factors may access sources |
cne doctor |
none | Checks config and environment offline |
cne init |
conditional | sample is offline; demo/quick/full fetch data; layout-only creates directories |
cne mcp |
conditional | Reads the lake by default; --live may fetch source data; --http listens on a local port |
cne profile list |
none | Lists built-in scopes |
cne profile show |
none | Shows a built-in scope |
cne query |
conditional | SQL reads the lake; fetches data on an on-demand cache miss or refresh |
cne repair adj-factors |
--refresh-sources only | Offline preview with a saved plan by default; --apply publishes supported corrections, retains old revisions and unresolved diagnostics, and saves bounded historical progress |
cne repair corporate-action-gaps |
with --apply | Offline preview by default; --apply queries Baostock and CNINFO per gap, publishes a new version after verification and keeps the old one |
cne repair daily-bar-coverage |
none | Read-only preview by default; --apply retires BSE session debts and proven pre-listing debts using committed data and refreshes coverage watermarks, retaining evidence receipts without changing bars |
cne repair financial-announcements |
none | Read-only preview by default; --apply appends financial reconstructions with LICO original-disclosure evidence, publishes through the repair gate and retains existing vintages |
cne repair financial-originals |
--refresh-sources only | Replays original periodic reports offline by default; --apply appends identifiable current-period consolidated figures, publishes through the repair gate and retains existing vintages and honest observation times |
cne repair fund-factors |
none | Read-only preview by default; --apply overlays recorded fund splits and transfers on the original vendor series, publishes through the repair gate and retains the old revision |
cne repair fund-listing-dates |
Requests current official ETF/LOF directories | Preview by default; --apply archives source responses and fills unknown listing dates through the repair gate, retaining known dates and old revisions |
cne repair fund-no-print |
--refresh-sources only | Offline preview by default; source refresh archives reports and updates caches; --apply approves explicit official fund auction-bar coverage evidence, retires corresponding debts and refreshes watermarks without creating bars or halt rows |
cne repair fund-volume |
only with --refresh-sources | Offline preview by default; online refresh archives historical K-lines from the SSE quote service and reuses or collects EastMoney evidence when turnover conflicts; --apply repairs verified Shanghai and Shenzhen fund volume, passes publication checks and retains old revisions |
cne repair index-history |
--refresh-sources only | Replays the reviewed official attachment catalog for the selected SZSE Component or STAR 50 index offline by default; --apply replaces whole books on effective dates, retaining official dated weights and old revisions; unknown historical weights remain null |
cne repair index-snapshots |
--refresh-sources only | Replays official files offline by default; --apply replaces complete dated constituent snapshots and real weights, publishes through the repair gate and retains old revisions |
cne repair layout |
none | Preview only by default; --apply publishes a new version, keeping the old version and duplicate-observation evidence |
cne repair misdated-valuation |
with --apply | Offline preview by default; --apply fetches valuation for the replaced sessions from the EastMoney datacenter, publishes a new version after verification and keeps the old one |
cne repair missing-values |
none | Read-only preview by default; --apply replaces valuation zero placeholders and unavailable EastMoney/CNI weights with nulls, publishes through the repair gate and retains the old revision |
cne repair orphan-symbols |
none | Preview by default, may register an old-lake baseline version; --apply removes factor and corporate-action rows of securities without daily bars, publishes a new version and keeps the old one |
cne repair stale-suspensions |
none | Preview by default, may register an old-lake baseline version; --apply removes inferred suspensions contradicted by traded daily bars, publishes a new version and keeps the old one |
cne repair status-listing-window |
none | Preview by default, may register an old-lake baseline version; --apply deletes status rows before a security's listing date or without a delisting on record, publishes a new version and keeps the old one |
cne repair status-outages |
none | Preview by default, may register an old-lake baseline version; --apply rebuilds the EastMoney-outage carried rows in the window under the current rule, publishes a new version and keeps the old one |
cne repair status-traded |
none | Read-only preview by default; --apply fills missing status keys from committed positive-volume bars, leaves ST unknown, publishes a new version and keeps the old one |
cne repair stock-listing-dates |
--refresh-sources only | Replays IPO calendars offline by default; --apply fills stock listing dates confirmed by official listed events, publishes through the repair gate and retains old revisions |
cne repair valuation-basis |
none | Preview only by default; --apply publishes a new version and keeps the old one |
cne run clean |
none | Only previews expired files; an explicit --reconcile-runs may modify run state |
cne run compact |
none | Publishes finished, unpublished staging data to the lake |
cne run daily |
when run | Fetches incrementally and writes the lake; includes all schedule groups and event streams by default |
cne run events |
when run | Fetches events and writes the lake |
cne run retry |
when run | Retries failed scopes and writes the lake |
cne serve |
conditional | Starts the lake dashboard. On a loopback address the operations page can start allowlisted fetches and daily updates; --read-only disables write endpoints; remote fetches require --allow-remote-ops; storage cleanup still needs web confirmation; fetch toggles are written back to the config, with a backup, after preview confirmation and do not start a fetch |
cne snapshot create |
none | Creates a local snapshot |
cne snapshot delta apply |
none | Applies a local delta package; --dry-run only validates |
cne snapshot delta create |
none | Creates a local delta package |
cne snapshot delta verify |
none | Verifies a local delta package |
cne snapshot export |
none | Exports a local snapshot |
cne snapshot import |
none | Imports a local snapshot |
cne snapshot restore |
none | Restores a local snapshot to the target directory |
cne snapshot verify |
none | Verifies a local snapshot |
cne sources limits |
none | Reads egress budgets, cooldowns and local debt; does not probe sources |
cne sources policy |
none | Reads source policies |
cne sources probe |
conditional | --list is offline; probing accesses sources and writes a report |
cne sources resilience |
none | Reads registered sources and probe evidence; may write a report |
cne sources slo |
none | Reads probe history and writes stats |
cne sources substitutes |
conditional | Reads reports by default; --probe accesses sources |
cne stats rebuild |
none | Rebuilds local stats |
cne stats show |
none | Reads local stats; recomputes automatically when stale or when a detail view needs it |
cne status |
none | Reads run state and dataset coverage |
cne storage apply |
none | Rechecks the version plan and marks; CLI purge is disabled, deletion must be confirmed in the serve web UI |
cne storage archive |
none | Copies a registered experiment, verifies it file by file and registers the sealed artifact; keeps the source directory |
cne storage artifact-verify |
none | Reads and verifies the full contents of a sealed artifact |
cne storage experiment-apply |
none | Only marks the experiment in place; CLI purge is disabled, deletion must be confirmed in the serve web UI |
cne storage experiment-create |
none | Creates an empty experiment directory with its own instance identity and registers it as active |
cne storage experiment-plan |
none | Validates references, the original directory and the archive, and saves an exit plan for the redundant original location |
cne storage experiment-seal |
none | Explicitly ends an experiment and binds a verified archive; once source content changes it cannot be cleaned up under the old seal |
cne storage explain |
none | Reads the retention reasons for versions |
cne storage hold |
none | Adds object protection and clears pending-deletion marks |
cne storage import |
none | Validates and registers a reference manifest; only adds protection |
cne storage inspect |
none | Reads versions, retention reasons and registered experiments |
cne storage plan |
none | Validates retention dependencies and saves a version plan; deletes no data |
cne storage resolve |
none | Validates the archive location for an old path; does not rewrite reports |
cne ths-official backfill |
when run | Calls the credentialed source and fills gaps |
cne ths-official capture |
when run | Calls the credentialed source and writes comparison evidence |
cne ths-official repair-bars |
when run | Fetches even in a dry run; --apply writes repairs |
cne ths-official resource-sectors |
when run | Fetches even in a dry run; --apply writes staging |
cne verify |
conditional | Local validation by default; --repair accesses sources and repairs |