Archive completed tasks, add cleanup commands, self-documenting dashboard UI
CI / build (push) Has been cancelled

- 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
This commit is contained in:
Lap Tran
2026-06-24 22:43:33 -04:00
parent e13513faaa
commit 4a2301b077
572 changed files with 856 additions and 101 deletions
-1
View File
@@ -1 +0,0 @@
complete
@@ -1,14 +0,0 @@
# Adversarial Bug Report — actionable-phase-guidance
## Attack Vectors
1. **Empty state**: What happens for an unknown/unexpected state value?
2. **HTML injection**: Could guidance text contain user-controlled content that escapes sanitization?
3. **Empty guidance**: Does the frontend handle missing/incomplete guidance gracefully?
## Findings
- Unknown states fall through to a generic return — safe, no crash
- Guidance text is static (no user content), so injection is not a concern
- Frontend checks `task.phase_guidance` truthiness before rendering the guidance section — safe
## Verdict
No vulnerabilities found. The implementation is defensive against all checked attack vectors.
@@ -1,16 +0,0 @@
# Bug Report — actionable-phase-guidance
## Review Scope
Phase guidance feature across task.py, app.py, dashboard.js, styles.css.
## Findings
### No Critical Bugs Found
The implementation is clean and well-structured. The phase guidance property covers all 12 states with actionable text. The frontend renders guidance conditionally. All three layers (model, API, UI) are properly wired.
### Minor Observations
- Some guidance messages reference `{self.name}` without `--project` flag, which may misbehave when run outside the framework project
- Guidance for BLOCKED state delegates to `unblock_instructions` which is populated only for specific block conditions
## Verdict
No blocking bugs. Ready for adversarial review.
@@ -1,13 +0,0 @@
# Doc Review — actionable-phase-guidance
## Documentation Reviewed
- IMPLEMENTATION.md (task folder)
- SPEC.md
- task.py docstrings and comments
- dashboard.js comments
## Findings
Documentation is accurate and complete. The IMPLEMENTATION.md correctly enumerates all changed files. The SPEC.md goal ("Add actionable next-step guidance to all dashboard phases") is fully met. No documentation gaps found.
## Verdict
Documentation is satisfactory. No changes needed.
@@ -1,22 +0,0 @@
# Phase Guidance Implementation
## Summary
Added actionable next-step guidance to all dashboard phases across the full stack.
## Changes
### automaton/dashboard/core/task.py
- Added `phase_guidance` property to `Task` dataclass providing per-phase actionable guidance text
- Added `blocker` property for identifying what blocks task progression
- Added `required_artifact_name` and `next_phase_name` helper properties
### automaton/dashboard/ui/app.py
- Exposed `phase_guidance`, `blocker`, `required_artifact_name`, `next_phase_name` in the `/api/tasks` JSON response
### automaton/dashboard/html/dashboard.js
- Added "What's Next" section in the detail modal rendering `phase_guidance`
- Added "What's Blocking" section rendering `blocker`
- Added status reason display on task cards
### automaton/dashboard/html/styles.css
- Added `.detail-guidance`, `.detail-blocker`, `.detail-status-reason` CSS classes
-1
View File
@@ -1 +0,0 @@
# Phase Guidance\n\nAdd actionable next-step guidance to all dashboard phases.
@@ -1,13 +0,0 @@
# Verdict — actionable-phase-guidance
## Status: PASS
## Summary
All phases completed successfully:
1. **Implement**: Phase guidance added across all dashboard layers (model, API, UI)
2. **Bug Find**: No critical bugs found
3. **Adversarial Bug Find**: No security vulnerabilities found
4. **Doc Review**: Documentation accurate and complete
## Final Assessment
Task satisfies all SPEC.md requirements. Marking complete.