doc-drift

Since: 0.93.0-alpha

Diagnostic that computes deterministic doc-vs-code drift findings for one symbol.

How to run it

Full flag list: doc-drift in the CLI reference.

Flags

Flag	Argument	Meaning	Default
`--qname`	`X`
`--db`	`PATH`
`--json`

Needs: index

Details

Diagnostic that computes deterministic doc-vs-code drift findings for one symbol. Reach for it to see exactly why document/autodoc considers a symbol's existing doc comment out of date.

Running it from the CLI

drag-lint doc-drift --qname X --db PATH [--json]

--qname X is the symbol to check. --json emits machine-readable output.

This is labeled a "diagnostic" in the CLI banner -- it is a troubleshooting tool, not a daily driver.

Reaching it in the IDE

No IDE surface -- this is a CLI-only feature.

What it needs

An index IS required. The project's DB lives at <project folder>\_D-RAG\<project file>.sqlite; run drag-lint resolve-dbs --project <X.dproj> if unsure.

Example

Illustrative only:

drag-lint doc-drift --qname CustomerOrder.TCustomerOrder.Total --db C:\Projects\MyApp\_D-RAG\MyApp.sqlite --json

This would report the specific drift findings between Total's current doc comment and its code.

All features | CLI reference | IDE menus