docs: documenteaza VM 304 ca masina partajata dezvoltare/testare

Adauga masini-dezvoltare-testare.md (acces qm guest exec, ce ofera,
limitari reale, de verificat inainte de folosire) si extinde
monitorizare-context.md cu monitorizarea de context per subagent
prin SubagentStop (context_watch.ps1 -Subagent).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015ZwtBDjGbAWvy7TmcNVxDC
This commit is contained in:
2026-09-17 22:14:56 +03:00
parent 4898f8bd68
commit 87cc3a7976
3 changed files with 92 additions and 0 deletions

View File

@@ -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** | |

View File

@@ -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 -- <comanda Windows>"
```
**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\<produs>`
(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.

View File

@@ -25,6 +25,34 @@ toate proiectele):
- Verificare manuala: `powershell -File ...\context_watch.ps1 -Prag 900000 -PragMax 950000 -Intotdeauna`
(afiseaza `CONTEXT <n>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 <cale>` - 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