DOX sistem

scripts/AGENTS.md

@@ -0,0 +1,42 @@
+# 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)