Files
automaton/tasks/complete/dashboard-toggle/SPEC.md
T
Lap Tran 4a2301b077
CI / build (push) Has been cancelled
Archive completed tasks, add cleanup commands, self-documenting dashboard UI
- Archive 79 completed framework-dev tasks from tasks/ -> tasks/complete/
- status.py: add --cleanup-done and --install-cleanup-schedule commands
- Add scripts/automaton-cleanup.sh for periodic task archiving
- Dashboard: rename 'Background' tab -> 'Agent', 'Cleanup' agent -> 'Completed Task Archiver', remove redundant group headers and pill badges, dim inactive agent placeholders
- .rules.md: add Self-Documenting UI Names rule
- New tests: test_cleanup_done.py, expanded test_app.py and test_task.py
2026-06-24 22:43:33 -04:00

3.0 KiB

Contract: Dashboard Phase Grouping

Goal

Group the 12 Kanban columns into 5 logical phase groups, with individual task states shown as sub-labels on cards. Also fix the header to show the project name instead of a scope indicator.

Header Fix

The scope badge currently shows "🏗 Framework" or "📁 Project" — this should be replaced with the actual project name.

  • Show the project name (from README.md first heading, or .automaton/project-name.md if it exists)
  • If no project name is found, show the project directory name
  • No need for scope indicators (Framework/Project mode is internal)

Column Grouping

Group Columns Rationale
Planning Backlog, Research, Decomposition Early stage — defining the problem and scope
Design Design, Test Design Designing the solution
Implementation Implement Building the solution
Verification Bug Find, Adversarial Bug Find, Doc Review, Referee Quality assurance and validation
Resolution Done, Blocked Final states

Card Display

Each card shows its specific state as a small sub-label beneath the task name:

┌──────────────────────┐
│ Implement Task       │
│ 🔄 implement         │
└──────────────────────┘

┌──────────────────────┐
│ Bad Impl             │
│ ❌ blocked           │
└──────────────────────┘

┌──────────────────────┐
│ Research Task        │
│ 🔄 research          │
└──────────────────────┘

Acceptance Criteria

  • Board renders 5 grouped columns instead of 12 individual columns
  • Cards in a column display a sub-label with their specific state (e.g., "research", "implement", "bug_find", "blocked")
  • Empty columns are hidden (no empty groups shown)
  • Column headers show the group name and total count
  • Column headers show a colored indicator bar for each group:
    • Planning: blue (#42a5f5)
    • Design: cyan (#26c6da)
    • Implementation: green (#66bb6a)
    • Verification: amber (#ffa726)
    • Resolution: green/red (#66bb6a / #ef5350)
  • Grouped columns are sortable by total count (same as current board behavior)
  • Clicking a card still opens the detail panel with the same information
  • Filter bar still works with the grouped view (filter by specific state)
  • Statistics view shows group-level breakdowns in addition to individual states
  • Timeline view shows grouped phases (Planning, Design, Implementation, Verification, Resolution) instead of 12 individual states
  • Header shows the project name (from README.md or directory name) instead of scope indicator
  • Scope label no longer shows "🏗 Framework" or "📁 Project"

Stop Condition

CONTRACT_MET