Problem
Short-flag space is inconsistent across commands. Symptom: --plain shipped without a short flag in v1.9.1 because -p was already taken by --preview elsewhere, and -P felt awkward as a one-off. The codex entry context.shortFlagAudit flags this as pending tech debt with a clear directive: "Don't add new short flags piecemeal — wait for the audit so the whole namespace gets reorganized at once."
Goal
Single coherent reassignment of every short flag across every command and subcommand. Rip-and-replace, no deprecation cycle.
Proposed approach
- Inventory every existing short flag across all commands and subcommands
- Identify collisions, near-collisions, and orphans (
--plain and any others without shorts)
- Propose a coherent assignment that minimizes user-visible churn while resolving conflicts
- Land in one PR with a single CHANGELOG entry listing every flag that moved
Acceptance criteria
Problem
Short-flag space is inconsistent across commands. Symptom:
--plainshipped without a short flag in v1.9.1 because-pwas already taken by--previewelsewhere, and-Pfelt awkward as a one-off. The codex entrycontext.shortFlagAuditflags this as pending tech debt with a clear directive: "Don't add new short flags piecemeal — wait for the audit so the whole namespace gets reorganized at once."Goal
Single coherent reassignment of every short flag across every command and subcommand. Rip-and-replace, no deprecation cycle.
Proposed approach
--plainand any others without shorts)Acceptance criteria
--plainand any other orphans get short flags