Files

T

CI / build (push) Has been cancelled

Details

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

1.4 KiB

Raw Blame History

Doc Review: fix-verdict-parsing

Summary

Documentation review of the code changes for verdict parsing and state machine alignment.

Documentation Plan Compliance

N/A — No DESIGN.md existed for this task (it went straight from SPEC to implementation).

Documentation Completeness

automaton/dashboard/core/task.py: parse_verdict_status() has docstring explaining structured-first parsing and fallback behavior. ✓
tests/test_task.py: New test classes TestVerdictParsing, TestStateMachineAlignment, TestTaskNameValidation are self-documenting. ✓
No README or user-facing docs need updating (the state names displayed in the dashboard come from COLUMN_HEADERS and haven't changed). ✓

Documentation Accuracy

CHANGELOG.md: Needs an entry under [unreleased]. ✓ (to be added)
automaton/dashboard/core/task.py docstring for parse_verdict_status accurately describes the structured-vs-fallback behavior. ✓

Issues Found

Issue 1: Verdict format not documented in referee prompt

Severity: Medium
Description: The referee prompt (prompts/referee.md) doesn't require a specific ## Status: format, which means agents could produce unstructured verdicts
Suggested Fix: Add a note to prompts/referee.md requiring the ## Status: PASS|FAIL|NEEDS_REVIEW format. This is R6 in the SPEC.

Score

+5 (documentation is complete and accurate; one medium issue in referee prompt noted)

1.4 KiB Raw Blame History