Files
atm/scripts/AGENTS.md
2026-06-13 11:51:36 +03:00

43 lines
1.3 KiB
Markdown

# scripts — Diagnostic Scripts
## Purpose
Scripturi ad-hoc de diagnostic/repro rulate manual. Nu fac parte din suita de
teste și nu sunt importate de aplicație.
## Ownership
`diag_strip_detection.py`, `diag_strip_fixes.py`, `inspect_image_pixels.py`,
`repro_ss_resume.py`.
## Local Contracts
- **`inspect_image_pixels.py`** — citește RGB la coordonate dintr-o imagine.
Util pentru a verifica saturația pixelilor (vezi palette gotcha în
`calibration/AGENTS.md`).
- **`repro_ss_resume.py`** — repro pentru fluxul `/ss` + `/resume`.
## Work Guidance — Sandbox/tooling (Windows checkout)
Nu presupune că `rg` sau `python`-ul global au dependențele proiectului.
Pentru diagnostic care cere Pillow/OpenCV folosește venv-ul repo:
```powershell
.\.venv\Scripts\python.exe scripts\inspect_image_pixels.py 6033117943853423831.jpg
.\.venv\Scripts\python.exe scripts\inspect_image_pixels.py 6033117943853423831.jpg --point 1780 725
```
Dacă `rg` lipsește, fallback PowerShell:
`Get-ChildItem -Recurse -File src,tests,scripts | Select-String -Pattern "needle"`.
Dacă o comandă pică din permisiuni sandbox și e necesară, rerulează cu escalare
în loc să oprești investigația fără verdict.
## Verification
Rulează scriptul vizat manual și inspectează output-ul; nu există teste automate
pentru `scripts/`.
## Child DOX Index
(none — leaf)