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