Files
automaton/tasks/complete/rewrite-vram-detection-python/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

1.3 KiB

SPEC: Rewrite VRAM Detection as Python Script

Goal

Replace the fragile scripts/vram_detect.sh with a testable Python script that produces the same JSON output.

Requirements

  1. Create scripts/vram_detect.py with the same CLI interface:
    • --model / -m
    • --project / -p
    • Optional positional model name
  2. Preserve the human-readable output sections and the === JSON Output === block.
  3. Fix known bugs:
    • Undefined $headroom_pct in manual mode.
    • Hardcoded "headroom": 0.25 in JSON output.
    • GPU-counting/output ordering bug.
    • Enforce 10KB file-read limit for API config files.
  4. Delete scripts/vram_detect.sh.
  5. Update references in prompts/orchestrate.md, prompts/decompose.md, prompts/onboarding.md, README.md, and config.md to point to the Python script.

Acceptance Criteria

  • python scripts/vram_detect.py runs and emits valid JSON.
  • Manual-mode headroom is read from config.md, not hardcoded.
  • Large API config files are read with a 10KB limit.
  • scripts/vram_detect.sh no longer exists.
  • All prompts/docs reference the Python script.

Non-Goals

  • Changing the recommendation algorithm.
  • Adding GPU vendor detection beyond Linux nvidia-smi, lspci, and /proc/meminfo.

Stop Condition

When all acceptance criteria are met, output "CONTRACT_MET".