PLOW-36 - trckr

← PLOW-36

feature

Created: 2025-12-21 • Updated: 2025-12-21

Relationships Loading...

## Feature Request

Enhance the `trckr-plow visualize` command to show:

1. **Step numbers** - Display step number prefix (e.g., "[1. Check Status]" instead of "[Check Status]")
2. **Type indicators** - Show whether each step is:
   - **(C)** - Code/deterministic (no agent)
   - **(A)** - Agent-based (spawns Claude agent)

## Step Types

Based on agents.yml comments:

| Step | Name | Type |
|------|------|------|
| 1 | Check Status | C |
| 2 | Pick Issue | A |
| 3 | Parse Issue ID | C |
| 4 | Check Issue Status | C |
| 5 | Triage Decision (Classify) | A |
| 6 | Run Triage | A |
| 7 | Check Triage Done | C |
| 8 | Create Worktree | A |
| 9 | Run Worker | A |
| 10 | QA Decision | C |
| 11 | Run QA | A |
| 12 | Check QA Result | C |

## Implementation

1. Add `step_type: code|agent` field to each step in `status_transitions.yml`
2. Update `build_workflow_graph()` to include step_type as node attribute
3. Update `render_workflow_ascii()` to format node labels as `[{step_number}. {name} ({type})]`
4. Update tests

## Example Output

```
[1. Check Status (C)] → [2. Pick Issue (A)] → [3. Parse Issue ID (C)] → ...
```

## Files to Modify

- `src/trckr_plow/config/status_transitions.yml`
- `src/trckr_plow/visualization.py`
- `tests/test_visualization.py`

Pull Requests (comma-separated URLs)

Attachments

Comments (2)

agent · 2025-12-21

## Implementation Complete ### Changes Made 1. **status_transitions.yml** (src/trckr_plow/config/status_transitions.yml:111-186) - Added step_type: code|agent field to all 12 workflow steps - Code steps: Check Status, Parse Issue ID, Check Issue Status, Check Triage Done, QA Decision, Check QA Result - Agent steps: Pick Issue, Triage Decision, Run Triage, Create Worktree, Run Worker, Run QA 2. **visualization.py** (src/trckr_plow/visualization.py:167-222) - Added _format_node_label() helper function to format labels as {step_number}. {name} ({type}) - Updated build_workflow_graph() to include step_type as a node attribute - Updated render_workflow_ascii() to use formatted labels - Updated render_workflow_ascii_with_highlight() to use formatted labels 3. **test_visualization.py** (tests/test_visualization.py) - Added tests for step_type attribute and validation - Added tests for _format_node_label() helper - Updated all render tests to check for new format 4. **test_cli.py** (tests/test_cli.py:733-776) - Updated visualize command tests for new output format ### Example Output [1. Check Status (C)] -> [2. Pick Issue (A)] -> [3. Parse Issue ID (C)] -> ... ### Verification - All 733 tests pass - Manual verification of visualization output confirms correct formatting - Type indicators: (C) = Code/deterministic, (A) = Agent-based

triage-agent · 2025-12-21

## Feature Triage Complete **Status:** NOT IMPLEMENTED **Summary:** The feature to add step numbers and type indicators (C/A) to visualization output does not currently exist. The codebase already stores `step_number` as a node attribute but doesn't display it. No `step_type` field exists yet. **Implementation Location:** - `status_transitions.yml` - Add `step_type: code|agent` to each workflow step - `visualization.py` - Update label formatting in `render_workflow_ascii()` and `render_workflow_ascii_with_highlight()` - `test_visualization.py` - Add tests for new format **Complexity:** Low - straightforward config additions and string formatting changes (~50 lines total across 3-4 files) See attached triage report (PLOW-36 Triage Report) for full details including implementation approach and testing strategy.