X_CLI_FLAG_UNREAD

a command declares a flag no code reads

the CLI's own declarations held to each other: a FlagSpec the parser accepts and no file under packages/cli/src reads is a promise x help makes with nothing behind it. x deploy --critical said "forces clients to reload" and reached no reader outside the plan JSON. The four global flags are excluded — the parser owns them — and any bare 'name' literal outside a name:/short: spec field counts as a read, so a flag echoed into --json still counts

bun test packages/cli/src/flag-reads.test.ts — the finding names the flag and the file to read it in