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:
@@ -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** | |
|
||||
|
||||
63
docs/masini-dezvoltare-testare.md
Normal file
63
docs/masini-dezvoltare-testare.md
Normal 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.
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user