# X_DOC_COMMAND_PIN_STALE

## Means

a pinned unresolved `x` citation (a page + invocation site in `DOC_COMMAND_PINS`) is no longer there, or a page holds one its pins do not name

## Typical cause

the ratchet in `DOC_COMMAND_PINS`. Widening the globs to `packages/*/*.md` found 23 citations that no rule had ever read, so they are pinned per site (page + invocation) and may only shrink — a pin above the real count is slack a new broken line would spend

## Fix

`bun run scripts/doc-commands.ts --json` names the file and both numbers; set the pin to the first one, or delete the entry at 0

[CLI and verify](/error-codes#cli-and-verify)