Date: 2026-02-27
Scope: index.ts, lib/**, test/**, docs/** (excluding dist/**)
Capture a comprehensive map of implemented CLI/UI behavior, highlight useful advanced capabilities, and identify actionable gaps while refactoring settings UX.
- Searched command and feature surfaces across
index.ts,lib/codex-manager.ts, andlib/codex-manager/settings-hub.ts. - Cross-checked with test coverage in
test/codex-manager-cli.test.tsand related suites. - Scanned for unresolved implementation markers (
TODO,FIXME,HACK,XXX) in source paths.
- Unified interactive settings hub covering:
- account list rendering and sort/layout behavior
- summary row field ordering and visibility
- return timing + quota refresh behavior
- theme palette/accent preview and persistence
- advanced backend controls (sync, retry, quota thresholds, timeouts, recovery)
- Per-project account storage toggle (
perProjectAccounts) with scoped path routing. - Session resilience controls (
sessionRecovery,autoResume) integrated with runtime recovery hooks. - Quota-aware behavior:
- cached quota snapshots
- live quota probing
- quota-based forecast/report/fix flows
- preemptive quota scheduler and deferral support
- Account health safeguards:
- circuit breaker support
- rate-limit reason handling
- hybrid account selection using health + token buckets.
Qin settings sub-panels now consistently cancels/backs out without saving draft changes.- Draft-saving side effects on each toggle were removed from settings loops.
- Theme preview keeps live feedback while restoring baseline theme on cancel.
- Help copy and command reference were updated to match the new
Qsemantics.
- User-visible change:
Qin settings sub-panels is nowcancel/backand does not save draft changes. - Migration/update action: users who previously relied on
Qto save must useSto save before exiting each settings panel. - Regression reference: the no-save-on-cancel contract is covered in
test/codex-manager-cli.test.ts(cancel-path regression test).
- None. No new npm scripts were added, removed, or renamed.
- Existing validation flow remains unchanged:
npm run typecheck,npm run lint,npm test,npm run build.
- Existing integration-style CLI settings test already validates multi-section persistence paths.
- Added regression coverage proving
Qcancel discards modified drafts across account-list, summary-fields, behavior, theme, and backend flows without persisting dashboard/backend settings.
- No unresolved
TODO/FIXMEmarkers were found in primary runtime source paths (index.ts,lib/**,test/**). - Non-runtime benchmark artifacts contain
TODOtext as fixture content (bench/**,scripts/bench-format/**), not production debt.
- Split additional settings-specific helpers from
lib/codex-manager.tsto continue reducing file size and ownership overlap. - Add focused unit tests for
settings-hub.tsactions (onInputmappings, category transitions, numeric clamping) to reduce reliance on broad CLI integration tests. - Add a short architecture note linking
codex-manager.tstosettings-hub.tsfor future contributors.