| [ |
| { |
| "rank": 1, |
| "title": "Add Codex SQLite schema-drift coverage and user-visible data errors", |
| "why": "The app currently converts FileNotFoundError/sqlite3.Error into empty lists or zero stats. That prevents crashes but can silently hide DB schema changes, permission failures, or corrupt data.", |
| "suggested_checks": [ |
| "test missing expected columns in threads/logs tables", |
| "test malformed timestamp/token fields", |
| "test UI/status layer can distinguish no data from data access error" |
| ], |
| "files_to_touch_later": [ |
| "src/codex_dashboard/codex_data.py", |
| "src/codex_dashboard/app.py", |
| "tests/test_codex_data.py", |
| "tests/test_crash_safety.py" |
| ] |
| }, |
| { |
| "rank": 2, |
| "title": "Introduce testable UI adapter seams for GTK actions and row rendering", |
| "why": "Headless tests cover startup/import safety but not most GUI behavior: buttons, dialogs, row contents, tray menu, refresh status updates, or xdg-open/resume command construction.", |
| "suggested_checks": [ |
| "unit-test command construction for resume/open-folder without launching processes", |
| "test stop action confirmation path with mocked terminate_process", |
| "test visible-child refresh routing and status text behavior" |
| ], |
| "files_to_touch_later": [ |
| "src/codex_dashboard/app.py", |
| "tests/" |
| ] |
| }, |
| { |
| "rank": 3, |
| "title": "Tighten and document process matching and termination scope", |
| "why": "The process scanner is used by a UI with stop buttons, but it matches broad keywords including claude, gemini, opencode, and MCP servers although the product is described as Codex-first.", |
| "suggested_checks": [ |
| "test false-positive commands such as filenames or arguments containing codex/claude substrings", |
| "add family filters or safer default for stoppable processes", |
| "document why non-Codex families are included if retained" |
| ], |
| "files_to_touch_later": [ |
| "src/codex_dashboard/processes.py", |
| "src/codex_dashboard/app.py", |
| "tests/test_processes.py" |
| ] |
| }, |
| { |
| "rank": 4, |
| "title": "Make service and desktop launch assets relocatable", |
| "why": "systemd and desktop files contain hard-coded absolute paths for this checkout. That is brittle for other users, relocated clones, or packaging.", |
| "suggested_checks": [ |
| "generate files from templates or document local-only nature", |
| "test ExecStart/Exec paths are not stale", |
| "consider console_scripts entry point for installed package launch" |
| ], |
| "files_to_touch_later": [ |
| "pyproject.toml", |
| "systemd/codex-dashboard.service", |
| "desktop/codex-dashboard.desktop", |
| "README.md" |
| ] |
| }, |
| { |
| "rank": 5, |
| "title": "Resolve Claude helper module status", |
| "why": "README and PLAN say unfinished Claude-specific views are not shipped, yet src/codex_dashboard/claude_data.py remains substantial and untested. This increases maintenance surface and ambiguity.", |
| "suggested_checks": [ |
| "decide keep/remove/feature-flag", |
| "if kept, add focused tests for malformed JSONL, bad task JSON, and large directories", |
| "make README explicitly state why Claude data helpers exist" |
| ], |
| "files_to_touch_later": [ |
| "src/codex_dashboard/claude_data.py", |
| "tests/", |
| "README.md", |
| "docs/PLAN.md" |
| ] |
| } |
| ] |
|
|
