CLI reference

The forensics console script is a Typer app entered at src/forensics/cli/__init__.py — version 0.1.1. 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 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 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 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.