CLI reference
The forensics console script is a Typer app entered at src/forensics/cli/__init__.py — version 0.1.4. Every command and subcommand below has its own page with usage, options, and subcommands (when present).
| Command | Description |
|---|---|
forensics | AI Writing Forensics Pipeline |
forensics all | Run full pipeline end-to-end: scrape → extract → analyze → report. |
forensics analyze | Run analysis pipeline (change-point, drift, convergence, comparison). |
forensics analyze compare-only | Re-run target/control comparisons only (--compare without other stages). |
forensics analyze run | Explicit entrypoint (same flags as forensics analyze with no subcommand). |
forensics analyze section-contrast | Phase 15 J6: per-author section-contrast tests (Welch + MW + per-family BH). |
forensics analyze section-profile | Phase 15 J3: newsroom-wide section descriptive report and J5 gate verdict. |
forensics calibrate | Validate detection accuracy against synthetic ground truth. |
forensics commands | Dump the full command catalog (for agent discovery). |
forensics config | Inspect and validate configuration. |
forensics config audit | Report non-default analysis fields (P2-CQ-001). |
forensics dashboard | Full-screen pipeline dashboard (tui extra). Incompatible with --no-progress. |
forensics dedup | Near-duplicate fingerprint utilities |
forensics dedup recompute-fingerprints | Recompute persisted simhashes for rows not stamped at the current NFKC (v2) version. |
forensics export | Export SQLite + features + analysis into a single .duckdb file. |
forensics extract | Run feature extraction pipeline. |
forensics features | Feature-store maintenance commands (schema migrations, etc). |
forensics features migrate | Upgrade every feature parquet to the current schema version. |
forensics lock-preregistration | Lock analysis thresholds for pre-registration (run before analyzing data). |
forensics migrate | Apply pending SQLite migrations (Phase 15 Step 0.2). |
forensics peer-setup | Print peer setup hints (uv extras, spaCy, Quarto, Ollama pulls from config). |
forensics preflight | Run preflight checks and report pass/warn/fail for each boundary. |
forensics report | Render Quarto forensic book. |
forensics scrape | Crawl and fetch articles for configured authors |
forensics setup | Launch the interactive setup wizard (requires the ‘tui’ extra). |
forensics survey | Blind newsroom-wide AI-adoption survey. |
forensics validate | Validate config.toml, run preflight, and optionally probe live endpoints. |
Built by Abstract Data