CLI reference¶
Every command takes --project PATH (default: current directory). The
library API in dedrift.* mirrors the CLI one-to-one.
dedrift init¶
Create a project: .dedrift/ with config.toml (thresholds, FDR level,
seeds, materiality gates — all documented inline), an append-only JSONL log,
and a SQLite index. Everything runs on a laptop; there are no servers.
dedrift log FILE¶
Ingest InteractionRecords from a JSONL file — the generic adapter for any
agent framework. Config fingerprints are computed per record and fingerprint
changes become config events for attribution.
dedrift canary run¶
dedrift canary run --suite canaries.yaml --agent mymodule:agent_fn \
--model 'provider/model@version' [--repetitions 7] [--cycles 1]
Runs every canary in the suite N times against your callable
(def agent_fn(input: dict) -> dict). Repetitions below 2 are rejected:
single runs cannot support distributional comparison.
dedrift baseline set¶
dedrift baseline set cycle-0000 cycle-0001 cycle-0002 # explicit
dedrift baseline set --last 3 # last N cycles
Freezes the golden baseline. It is never auto-updated; drifting baselines are how boiling frogs get cooked.
dedrift embedder pin NAME / dedrift embedder show¶
Pin the project's embedding model forever (hash or st:<model>).
Re-pinning to a different embedder is refused — it would invalidate all
history.
dedrift sim¶
dedrift sim --cycles 8 --change-cycle 7 [--canaries 30] [--repetitions 7] [--seed 1729]
Seeded synthetic agent with a scriptable mid-history config change. Powers the demo and the CI calibration/power suites.
dedrift check¶
Runs the full gated pipeline for the latest cycle against both baselines. Prints both verdicts and the alert list; exits 2 when drift is detected, so it drops straight into cron/CI. A current cycle with a high error rate yields DEGRADED DATA and suppresses drift conclusions rather than misattributing them.
dedrift report [--out FILE]¶
Renders the deterministic markdown report: verdicts, alert table in plain units, attribution, heuristic flags (clearly labeled), per-family sparklines, config timeline, and an appendix of every non-alerting result.
dedrift signatures [--by family|canary]¶
Prints the aggregated signature tables (mean / variance / P95 per signature per cycle) for eyeballing trajectories.