roagest/docs/CLAUDE.md

Mod de lucru Claude ↔ Marius pe ROAGEST

Modificare cod VFP binar (.vcx/.scx) — flux write-back pe text

Din 07.2026 Claude aplică singur modificările pe .vcx/.scx prin fluxul text→bin (txt2vcx.ps1, detalii în CLAUDE.md rădăcină și docs/flux-editare-vfp-text.md):

1. Claude investighează pe cache-ul text (D:\ROA\_vfp_textcache\roagest), propune modificarea și așteaptă acordul lui Marius pe abordare înainte să editeze.
2. Refresh cache (vcx2txt.ps1), editare .vc2/.sc2 byte-safe (PowerShell, encoding 1252, conținut nou doar ASCII — nu Edit tool pe .vc2), apoi write-back cu txt2vcx.ps1 (fidelity-check obligatoriu; țintele din COMUN\ cer -AllowComun + aprobare explicită, și VFP IDE / roagest.exe complet închise — procesele reziduale țin lock pe binar).
3. Diff lizibil pentru review: text vechi regenerat din HEAD git (vcx2txt.ps1 -Source) vs. cache-ul editat, git diff --no-index → fișier .patch. Commit doar după ce Marius confirmă pe diff și testează în IDE. Editările de volum se deleagă la subagenți Sonnet în background; sesiunea principală orchestrează și verifică.
4. După implementare: changelog, ștergerea fișierului de propunere/patch-ului, iar insight-urile durabile se mută în notițe docs/flux-*.md / docs/pachet-*.md.

Excepții rămase pe VFP IDE: .mnx (GENMENU) și .frx (fragile la round-trip) — pentru ele rămâne valabil fluxul vechi cu fișier de propunere docs/propuneri_<subiect>.md aplicat de Marius în IDE. Când Marius a început deja o implementare, Claude compară codul lui cu originalul și listează explicit diferențele/cazurile netratate (nu rescrie orbește).

Acces direct la baza de date Oracle

Claude are acces read la baza de date de dezvoltare și își face singur exporturile de surse PL/SQL (pachete, view-uri) — nu se mai cer exporturi manuale. Detalii de conexiune și comanda de export: COMUN\docs\oracle_export.md. Parola: docs/local/oracle.md (neversionat). Exportul de referință PACK_CONTAFIN.pck stă în COMUN\docs\ și se reîmprospătează la nevoie.