diff --git a/docs/README.md b/docs/README.md index 9921b5e..4ac4164 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,6 +15,7 @@ atingi zona X, citeste fisierul Y"). Restul se deschid doar la declansator. | `stil_interactiune_cautare.md` | cum interactionezi, cum livrezi si cum cauti (valabil si pentru subagenti) | | `orchestrare-subagenti.md` | cand delegi, cand verifici ce intoarce un subagent, la predarea contextului | | `monitorizare-context.md` | instalarea hook-urilor de prag de context si de revizie a docs | +| `masini-dezvoltare-testare.md` | ai nevoie de o masina separata pentru probe UI/rulari lungi care nu trebuie sa blocheze statia principala | | `fluxul_svn_git.md` | orice commit / `svn update` / `roa_sync` -> skill `roa-git-svn-commit` | | `scripturi-uzuale.md` | exista deja un script pentru sarcina asta? (roa_sync, curatenie, livrare, diagnostice) | | **VFP** | | diff --git a/docs/masini-dezvoltare-testare.md b/docs/masini-dezvoltare-testare.md new file mode 100644 index 0000000..b2bb087 --- /dev/null +++ b/docs/masini-dezvoltare-testare.md @@ -0,0 +1,63 @@ +# Masini partajate pentru dezvoltare si testare + +Resurse disponibile pentru rulari care nu trebuie sa blocheze statia de lucru principala +(care e partajata cu Marius - vezi regula "masina partajata: fara input real" din memoria de +sesiune, orice input UI injectat pe statia principala ajunge in IDE-ul lui). + +## VM 304 (Win11-Marius) + +Masina virtuala Proxmox ID **304**, nume **Win11-Marius**, nod `pvemini`, clona lui VM 303 +(Win11-Adina). Nu e in HA (`noha`). + +### Acces - probat + +Headless, prin QEMU guest agent, de pe orice masina cu acces SSH la host-ul Proxmox +(`root@10.0.20.201`): + +```bash +# ping guest agent - confirma ca VM-ul raspunde: +ssh root@10.0.20.201 "qm agent 304 ping" + +# executie de comanda Windows in interiorul VM 304: +ssh root@10.0.20.201 "qm guest exec 304 -- " +``` + +**Nu prin RDP.** Nu exista mentiune de RDP catre VM 304 in documentatia gasita. + +### La ce foloseste + +- probe UI vizibile (harness `vfp_ui_harness.ps1`, screenshot-uri de designer) care altfel ar + fura focusul de pe statia principala partajata; +- rulari lungi de teste care nu trebuie sa blocheze statia de lucru; +- orice lucru in paralel cu sesiuni active pe masina principala. + +### Limitari reale + +- **Fara share UNC** catre discul ei - nu exista cale de retea documentata. Transferul de + fisiere se face prin `qm guest exec` (scriere de continut prin comenzi Windows), nu prin copiere + directa. +- Accesul documentat e **headless prin guest agent**, nu interactiv/RDP - nu te astepta la o + sesiune desktop vizibila. +- Nu am gasit mentiune de IP/hostname propriu - accesul trece prin host-ul Proxmox. + +### De verificat inainte de folosire (nu presupune ca exista) + +- **VFP 9 instalat** - nedocumentat explicit pentru VM 304 (spre deosebire de VM 302, + documentat separat ca `oracle-test`). +- **Client Oracle instalat** - nedocumentat explicit. +- **Copia de lucru ROA si calea ei reala** - documentatia veche zice generic `D:\roa\` + (litera mica), nu confirmata explicit ca `D:\ROA\ROAFACTURARE` sau alt produs anume. + +## Credentiale - unde sunt documentate + +Nu se copiaza nicio credentiala in acest fisier sau in oricare alt fisier din repo. + +- Cheia publica SSH pentru angajat pe VM 304 + amprenta: `E:\proiecte\ROMFASTSQL\docs\acces-ssh-chei-angajati.md` +- Profil Bitvise, cale de instalare, cheia globala folosita de `qm guest exec`: + `E:\proiecte\ROMFASTSQL\docs\drepturi-utilizatori-roa-firme.md` + +## Alte masini din cluster + +VM 302 e documentata separat ca `oracle-test` (`E:\proiecte\ROMFASTSQL\proxmox\vm302-oracle-test\`). +Acelasi tipar de acces (`qm agent`/`qm guest exec` de pe `root@10.0.20.201`) se aplica tuturor +VM-urilor Windows non-HA ale clusterului. diff --git a/docs/monitorizare-context.md b/docs/monitorizare-context.md index 94f92be..118e34c 100644 --- a/docs/monitorizare-context.md +++ b/docs/monitorizare-context.md @@ -25,6 +25,34 @@ toate proiectele): - Verificare manuala: `powershell -File ...\context_watch.ps1 -Prag 900000 -PragMax 950000 -Intotdeauna` (afiseaza `CONTEXT k` indiferent de prag). +### Monitorizare context per subagent + +Subagentii nu-si simt pragul de context (vezi memoria de sesiune "subagentii nu-si simt pragul de +context"). Hook-ul `SubagentStop` primeste `agent_transcript_path` - transcriptul SEPARAT al +subagentului care tocmai s-a oprit, distinct de transcriptul sesiunii principale - deci se poate +masura contextul fiecarui subagent, nu doar al orchestratorului. + +`context_watch.ps1 -Subagent` citeste acel transcript separat, cu praguri implicite mai joase +(150k/200k, fata de 250k/275k la sesiunea principala, tocmai fiindca subagentii nu se opresc +singuri la timp). Optiuni suplimentare: + +- `-Json` - ambaleaza mesajul in `hookSpecificOutput`/`additionalContext`, formatul cerut de + `SubagentStop`. +- `-StareFile ` - scrie un antet datat, reinlocuit de fiecare rulare, pe primul rand al + fisierului de progres al sarcinii. + +Garda `stop_hook_active` e in script: a doua declansare a aceluiasi ciclu de stop tace (nu se +reinjecteaza mesajul la infinit); plafonul documentat e 8 blocari consecutive inainte ca harness-ul +sa renunte oricum. + +**Corectie:** niciun hook nu primeste tokenii de-a gata calculati - nici hook-urile `command`, nici +function hooks din SDK. Orice hook primeste doar `transcript_path` si trebuie sa-si citeasca singur +`usage` din JSONL (cum face `context_watch.ps1`). Singurul canal cu procent gata calculat +(`context_window.used_percentage`) e `statusLine`, care nu e hook si nu poate declansa actiuni. + +Compactarea nu se poate declansa programatic dintr-un hook; singurul control indirect e coborarea +pragului de auto-compactare cu variabila de mediu `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`. + ## Revizuire periodica a docs (regula 12) `COMUN\utile\docs_revizie_check.ps1` compara data din markerul `COMUN\docs\.ultima_revizie` cu ziua