33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
|
# 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".
|