sync SVN r18174

docs/progres_qa_factura.md

@@ -0,0 +1,98 @@
+# Progres QA factura/aviz
+
+Plan: `docs/plan_qa_factura_aviz.md` (aprobat 17.09.2026, mandat de executie continua).
+Acest fisier spune **unde s-a ajuns**, nu ce e de facut. Se actualizeaza dupa FIECARE story.
+
+Harti de pornire (read-only, nu se refac):
+`docs/qa_factura_harta.md` - harta de cod a formularului
+`docs/qa_factura_unelte.md` - harness UI, headless, Oracle, hook-uri existente
+`docs/qa_factura_hooks_ref.md` - referinta oficiala de hook-uri
+
+## Stare pe story
+
+| Story | Stare | Unde |
+|---|---|---|
+| S0 prototip context/handoff | **TERMINAT** 17.09.2026 | `docs/s0_context_hook.md` |
+| S1 baseline QA cu capturi | de facut, **pe VM 304** | - |
+| S2 cautare articole | de facut | - |
+| S3 selector lista de preturi | blocat pana se citeste `pack_facturare.cursor_preturi` | - |
+| S4 zona totaluri+discount | de facut, mockup inainte | - |
+| S5 regresie | de facut | - |
+
+## S0 - terminat (doua runde)
+
+**Runda 2 (dupa ce prima s-a dovedit nedovedita).** Prima varianta a lui S0 a fost probata doar
+cu stdin sintetic; in ciclul real bucla a continuat. Am instalat logare temporara pe hook si am
+capturat inputul real al lui `SubagentStop`. Ce a iesit:
+
+- `stop_hook_active` EXISTA in input si trece pe `true` la a doua declansare - garda e corecta.
+  Bucla observata venea de la agenti porniti inainte de fix.
+- Mecanismul buclei: mesajul injectat trezeste agentul idle, el raspunde, redevine idle, hook-ul
+  se declanseaza iar.
+- **Inputul contine `agent_transcript_path`** - transcriptul separat al subagentului oprit.
+  Deci un hook POATE masura contextul fiecarui subagent, nu doar al sesiunii.
+
+Consecinta: `context_watch.ps1` are acum `-Subagent` (citeste `agent_transcript_path`, praguri
+150k/200k, mai joase decat la sesiunea principala) si `-Json` (ambaleaza in
+`hookSpecificOutput`). Garda `stop_hook_active` a intrat in script, deci comanda hook-ului e o
+singura linie. Logarea temporara e scoasa.
+
+Probe pe input real capturat: subagent peste prag -> mesaj cu numele agentului si 40k; sub prag
+-> tacere; `stop_hook_active=true` -> tacere. Comis: `9823f1e` pe `qa-factura-s0`.
+
+Compromis acceptat: mesajul vechi "verifica daca subagentul si-a scris starea pe disc" nu mai
+apare la fiecare oprire, ci doar in avertismentul de context.
+
+**Corectie de fond**, dupa ce Marius a contestat afirmatia: e fals ca "niciun hook nu poate afla
+contextul". Niciun hook nu primeste tokenii de-a gata (nici `command`, nici function hook din
+SDK), dar orice hook primeste `transcript_path` si poate citi singur `usage` din JSONL. Doar
+`statusLine` primeste `context_window.used_percentage` gata calculat, si nu e hook.
+Detalii: `docs/hooks_functii_context.md`.
+
+## S0 - runda 1
+
+Trei modificari, toate probate (detalii si rezultatele probelor in `docs/s0_context_hook.md`):
+
+1. `C:\Users\mmari\.claude\settings.json`, hook `SubagentStop`: garda `stop_hook_active`. Era un
+   `echo` static care reinjecta acelasi `additionalContext` la fiecare oprire de subagent - de
+   aici bucla observata azi (patru agenti invartindu-se in gol). Backup:
+   `settings.json.bak_20260917`.
+2. `D:\ROA\ROAGEST\COMUN\utile\context_watch.ps1`: parametru nou `-StareFile`. La atingerea
+   pragului scrie/inlocuieste un singur antet pe primul rand al fisierului de stare
+   (`<!-- context_watch: data ora | tokeni: N | nivel: ... -->`), fara sa atinga restul
+   continutului. Fara `-StareFile` comportamentul e neschimbat.
+3. `settings.json`, `env`: `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70`, ca auto-compactarea sa cada
+   dupa avertismentul lui `context_watch`, nu inaintea lui.
+
+Ce s-a stabilit si nu se mai rediscuta:
+- Compactarea **nu** poate fi declansata programatic dintr-un hook. Mecanismul ramas: hook
+  avertizeaza -> modelul scrie handoff-ul -> compactarea vine singura la pragul coborat.
+- Niciun hook nu primeste numarul de tokeni. Singura sursa e transcriptul JSONL
+  (`transcript_path`), pe care `context_watch.ps1` il citea deja.
+- `D:\ROA\ROAGEST\COMUN` si `D:\ROA\ROAFACTURARE\COMUN` sunt checkout-uri separate ale aceluiasi
+  repo `comun.git`. Scriptul e deci deja in biblioteca partajata; nu trebuie mutat.
+
+Ramas deschis din S0:
+- Proba pe un ciclu real cu subagent viu (garda a fost probata in izolare, cu stdin sintetic).
+  Se confirma implicit la prima rulare de subagent din sesiunea urmatoare.
+- `settings.json` trimite la `context_watch.ps1` prin calea din checkout-ul ROAGEST. Pe VM 304
+  trebuie verificat ca `D:\ROA\ROAGEST\COMUN\utile\context_watch.ps1` exista acolo, altfel
+  hook-ul tace fara sa dea eroare.
+
+## VM 304 - ce s-a aflat
+
+Din `docs/vm304_acces.md`: Proxmox VM ID 304 "Win11-Marius", nod `pvemini`, clona lui VM 303.
+Acces probat si functional: `ssh root@10.0.20.201 'qm agent 304 ping'` -> raspunde;
+comenzi in VM prin `qm guest exec 304 -- <cmd>`. **Nu exista share UNC** catre discul ei.
+Documentatia NU mentioneaza VFP sau client Oracle instalat - de verificat pe teren, planul le
+presupune. Credentialele sunt documentate in `E:\proiecte\ROMFASTSQL\docs\` (nu se copiaza).
+
+Marius a cerut explicit copierea directa si `roa_sync` rulat pe VM. Pachetul de pornire e
+pregatit in scratchpad (`pachet_vm304\` cu `PORNIRE.md` + cele 8 documente + `context_watch.ps1`);
+rezultatul copierii si al lui `roa_sync` ajunge in `docs/vm304_deploy.md`.
+
+## Urmatorul pas
+
+S1, **pe VM 304**: sesiune noua care porneste din `docs/plan_qa_factura_aviz.md` + acest fisier.
+Baseline vizual pentru FACTURA si AVIZ, capturi la 1366x768 si maximizat, dovada pentru
+constatarile C2, C4, C6 si C8 din plan. Nicio modificare de cod in S1.