72 lines
3.8 KiB
Markdown
72 lines
3.8 KiB
Markdown
|
# Add Decomposition Content to Dashboard Data Model
|
||
|
|
|
||
|
|
## Goal
|
||
|
|
|
||
|
|
Add missing content fields to the `Task` model so the dashboard can display wave structure from `DECOMPOSITION.md`, parent task context from `PARENT_SPEC.md`, and VRAM constraints from `VRAM_CONFIG.md`.
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
### R1. Add `decomposition_content` to Task model
|
||
|
|
|
||
|
|
`automaton/dashboard/core/task.py`: The `Task` dataclass has six content fields (`spec_content`, `verdict_content`, `bug_report_content`, `adversarial_bug_report_content`, `doc_review_content`, `design_content`) but no `decomposition_content`. This is the root cause of the dashboard's inability to parse wave structure from `DECOMPOSITION.md`.
|
||
|
|
|
||
|
|
**Fix**:
|
||
|
|
- Add `decomposition_content: Optional[str] = None` field to the `Task` dataclass (`task.py:77-90`)
|
||
|
|
- In `discover_tasks()` (`task.py:243-286`), load `DECOMPOSITION.md` content similar to how other artifacts are loaded
|
||
|
|
- Add `"decomposition_content"` to the `/api/tasks` response in `ui/app.py` `_serve_tasks()` and `_serve_task()`
|
||
|
|
|
||
|
|
### R2. Parse wave structure from DECOMPOSITION.md content
|
||
|
|
|
||
|
|
Currently `dashboard.js:278-285` splits sub-tasks into waves using a 50/50 heuristic (`half = Math.ceil(task.sub_tasks.length / 2)`), completely ignoring the actual wave definitions in `DECOMPOSITION.md`.
|
||
|
|
|
||
|
|
**Fix**:
|
||
|
|
- Parse wave headers from `decomposition_content` (Python side): extract `### Wave 1:` and `### Wave 2:` sections and their sub-task lists
|
||
|
|
- Store parsed wave data as `waves: list[WaveGroup]` on the `Task` model or as structured data in the API response
|
||
|
|
- Each wave group contains: wave number, label, sub-task names
|
||
|
|
- In `dashboard.js`, use parsed wave data instead of 50/50 heuristic for wave statistics
|
||
|
|
- Fall back to 50/50 heuristic only when `decomposition_content` is unavailable
|
||
|
|
|
||
|
|
### R3. Add `parent_spec_content` and `vram_config_content` to Task model
|
||
|
|
|
||
|
|
Sub-tasks have `PARENT_SPEC.md` and `VRAM_CONFIG.md` but these are not in the `ARTIFACTS` dict and not visible in the API response or detail panel. The detail panel cannot show parent context or VRAM constraints.
|
||
|
|
|
||
|
|
**Fix**:
|
||
|
|
- Add `parent_spec_content: Optional[str] = None` and `vram_config_content: Optional[str] = None` to `Task`
|
||
|
|
- Load these in `discover_tasks()` if the files exist
|
||
|
|
- Include in the API response
|
||
|
|
- Display in the detail panel when present (e.g., "Parent Context" and "VRAM Configuration" sections)
|
||
|
|
|
||
|
|
### R4. Add `WaveGroup` dataclass
|
||
|
|
|
||
|
|
Add a simple dataclass for wave metadata:
|
||
|
|
```python
|
||
|
|
@dataclass
|
||
|
|
class WaveGroup:
|
||
|
|
wave_number: int
|
||
|
|
label: str
|
||
|
|
sub_task_names: list[str]
|
||
|
|
```
|
||
|
|
|
||
|
|
### R5. Parse DECOMPOSITION.md wave sections
|
||
|
|
|
||
|
|
Add a `parse_waves(content: str) -> list[WaveGroup]` function that extracts wave definitions from `DECOMPOSITION.md` content. Pattern: `### Wave N: label` followed by lines starting with `- subtask-name`.
|
||
|
|
|
||
|
|
## Acceptance Criteria
|
||
|
|
|
||
|
|
- [ ] `Task` model has `decomposition_content`, `parent_spec_content`, `vram_config_content` fields
|
||
|
|
- [ ] `/api/tasks` response includes `decomposition_content` when present
|
||
|
|
- [ ] `/api/tasks` response includes `parent_spec_content` and `vram_config_content` when present
|
||
|
|
- [ ] `parse_waves()` correctly extracts wave structure from the template `DECOMPOSITION.md` in `templates/tasks/subtask-parent/`
|
||
|
|
- [ ] Dashboard JS uses parsed wave data for Wave 1/Wave 2 statistics instead of 50/50 split
|
||
|
|
- [ ] Detail panel shows "Parent Context" section when `parent_spec_content` exists
|
||
|
|
- [ ] Detail panel shows "VRAM Configuration" section when `vram_config_content` exists
|
||
|
|
- [ ] Existing tests pass
|
||
|
|
- [ ] New test: `parse_waves` with real DECOMPOSITION.md content
|
||
|
|
- [ ] New test: task with PARENT_SPEC.md and VRAM_CONFIG.md has content fields populated
|
||
|
|
|
||
|
|
## Non-Goals
|
||
|
|
|
||
|
|
- Not changing the DECOMPOSITION.md format
|
||
|
|
- Not applying VRAM constraints — display only
|
||
|
|
- Not modifying how sub-tasks are created or executed
|