sync SVN r18041

docs/reguli_lucru.md

@@ -18,9 +18,7 @@
    comentariu se scrie acolo unde explica o **ramura** sau un **filtru** care nu se citeste singur,
    ca sa se inteleaga codul; unde codul e limpede, nu se comenteaza. O linie de regula, 2-3 doar
    pentru metode cu contract nebanal (parametri, cursor asteptat/lasat deschis, pozitionare la
-   iesire), 4-5 in antetul unui script de migrare (ce e obiectul si ce contract are). Istoricul
-   modificarilor sta DOAR in ANTETUL fisierului (niciodata inline) — la fel in `.prg`, in `.sql`
-   si in PL/SQL Oracle.
+   iesire), 4-5 in antetul unui script de migrare (ce e obiectul si ce contract are).
    INTERZIS in comentariu: nume de agent ("claude"), referinte la planuri, stories, propuneri,
    decizii, etape sau erori (`docs/plan_*.md`, `docs/propuneri_*.md`, "#6", "S4", "M2", "T3",
    "dec.6", "runda27", "E7", "D-H2"), trimiteri la rapoartele din `docs/` ("vezi raportul,
@@ -29,10 +27,11 @@
    date si autori pe cod nou.
    Comentarii vechi in stil jurnal nu se rescriu din oficiu — doar cand blocul e oricum atins
    sau la cerere explicita.
-   Antet: o singura intrare CUMULATIVA per functionalitate (`*!* DD.MM.YYYY` / `*!* autor` /
-   `*!* ce face, 1-2 fraze`) — la revenire se rescrie intrarea, nu se adauga alta; autorul e cine
-   semneaza livrarea (ex. `marius.mutu`), niciodata agent. Doar comportamentul final — fara
-   revizii/runde/patch-uri/corectii. La rezolvari de erori: fara comentarii.
+   Istoricul modificarilor sta DOAR in antetul fisierului (niciodata inline, la fel in `.prg`,
+   `.sql` si PL/SQL Oracle): o singura intrare CUMULATIVA per functionalitate (`*!* DD.MM.YYYY` /
+   `*!* autor` / `*!* ce face, 1-2 fraze`) — la revenire se rescrie intrarea, nu se adauga alta;
+   autorul e cine semneaza livrarea (ex. `marius.mutu`), niciodata agent. Doar comportamentul
+   final — fara revizii/runde/patch-uri/corectii. La rezolvari de erori: fara comentarii.
    Explicatiile merg in docs/ sau in mesajul de commit, nu in cod.
    Changelog (`changelog_<aplicatie>.txt`): strictul necesar, pe limba utilizatorului, non-tehnic
    — 1-3 fraze/intrare, fara detalii de implementare, fara enumerarea locurilor atinse. Cat timp
@@ -59,54 +58,25 @@
 6. Delegare: implementarile, testele, verificarile si cercetarile se dau unor subagenti Sonnet in
    background (lane-uri paralele); sesiunea principala doar orchestreaza si verifica, ca sa nu i
    se umple contextul. Misiuni lungi: subagenti proaspeti per sarcina (max ~200-250k
-   tokens/subagent), nu unul singur cu context acumulat; handoff compact pe disc:
-   `orchestrare-subagenti.md`.
-   **Verificarea a ce se intoarce** — pentru executie delegarea merge, pentru concluzii nu:
-   - **citeste contractul functiei apelate, nu-l presupune.** Un raport care descrie corect
-     structura codului poate gresi sensul: ex. `goExecutor.oExecute` intoarce succes/insucces
-     (`CT_SUCCES`/`CT_INSUCCES`), NU numarul de randuri — o garda `If lnSucces > 0` citita ca
-     "are randuri" a produs un bug inexistent, raportat ca blocant. Deschide functia.
-   - **fix ingust, nu supra-constructie.** Cand premisa se corecteaza, corectia se restrange:
-     mecanismele noi introduse "ca sa fie sigur" diverg de la codul-sablon si blocheaza
-     refolosirea lui in alta parte.
-   - **"zero cazuri in date" nu dovedeste nimic** pe scheme cu date de test; raspunsul vine din
-     cod. Si invers: o potrivire de cifre pe 1-2 documente nu e o regula.
-   - **cere raportul sa separe "testat" de "analizat static"**, si ce n-a putut fi acoperit. Un
-     agent care nu e intrebat explicit va prezenta amandoua la fel.
-   - **spune-i ca poate infirma briefingul.** Altfel implementeaza corectia ceruta chiar cand a
-     descoperit ca nu e nevoie de ea.
+   tokens/subagent), nu unul singur cu context acumulat; handoff compact pe disc. Verificarea a
+   ce se intoarce si modelul de lucru (backlog de story-uri mici): `orchestrare-subagenti.md`.
 7. Conventii obligatorii, de citit cand atingi zona respectiva:
-   - editezi fisiere `.vc2`/`.sc2`, dar si `.prg` (ex. `programe\ocautare.prg`, unde `s`-urile cu
-     virgula din `masina`/`si contul`/`transa` sunt octetul `0xBA`) -> `conventie_encoding_cp1252.md`.
-     Antetul FoxBin2Prg declara `CPID="1252"`, dar octetii diacriticelor sunt de fapt **cp1250**
-     (`0xE3`=a cu caciula, `0xFE`=t cu virgula, `0xAA`=S majuscul cu virgula, `0xBA`=s minuscul cu
-     virgula) - nu trata eticheta din antet ca adevarul despre encoding. Orice write cu un tool ce
-     nu pastreaza octetii nativ (Edit/Write) corupe caracterele >= 0x80 din TOT fisierul (`0xBA` ->
-     `EF BF BD`), chiar la o singura linie schimbata, si o repeta la FIECARE scriere - **nu
-     re-encoda niciodata fisierul: lucreaza pe octeti (`byte[]`) sau scrie strict ASCII in
-     continutul nou**; editeaza tot ce ai de editat, verifica byte-level si repara o singura data
-     DUPA ultima scriere.
-     Cens obligatoriu **inainte SI dupa** fiecare editare, care trebuie sa ramana identic:
-     `od -An -tx1 <fisier> | tr ' ' '\n' | grep -v '^$' | awk '$1>"7f"' | sort | uniq -c`. Atentie
-     la sens: la stricare censul **CRESTE**, nu scade - un octet cp1250 devine 3 octeti `EF BF BD`
-     (U+FFFD) la o re-encodare UTF-8 gresita; cauta explicit secventa `EF BF BD`, nu doar tiparul
-     generic de mojibake `C3`/`C4`/`C5`/`C8` + octet de continuare (acela da fals-pozitiv pe text
-     UTF-8 legitim sau pe comentarii intr-o alta limba, deja intalnite in cod). Verificare veche
-     (orice octet >=0x80, utila cand cauti pozitia exacta): `perl -ne 'print "$.\n" if
-     /[\x80-\xFF]/' <fisier>`; reparare (pt. `0xBA`): `perl -e
-     'binmode(STDIN);binmode(STDOUT);local $/;$_=<STDIN>;s/\xEF\xBF\xBD/\xBA/g;print' < f > f.tmp`.
-     `EF BF BD` nu spune ce caracter s-a pierdut - toate diacriticele devin la fel; ia octetul corect
-     per pozitie din `svn cat <fisier>` (necorupt) sau din git history (`git cat-file blob
-     <commit>:<cale>`, **din Bash, niciodata cu `>` din PowerShell 5.1** - adauga BOM si
-     re-encodeaza) inainte sa inlocuiesti - o inlocuire oarba cu `0xBA` strica `a`/`t` cu caciula
-     (`0xE3`, `0xFE`) din alte fisiere;
+   - editezi `.vc2`/`.sc2` sau `.prg` cu diacritice (ex. `programe\ocautare.prg`) -> fisierele
+     sunt **cp1250** desi antetul FoxBin2Prg declara `CPID="1252"`; Edit/Write corup TOT fisierul
+     (nu doar linia atinsa) la fiecare scriere - scrie continut nou strict ASCII. Cens obligatoriu
+     **inainte SI dupa** fiecare editare (la stricare CRESTE, nu scade):
+     `od -An -tx1 <fisier> | tr ' ' '\n' | grep -v '^$' | awk '$1>"7f"' | sort | uniq -c`. Tabel
+     de octeti si reparare -> `conventie_encoding_cp1252.md`;
+   - adaugi o PROPRIETATE sau o METODA noua intr-o clasa `.vc2`/`.sc2` -> `flux-editare-vfp-text.md`,
+     sectiunea "Membri noi de clasa": fara intrarea `*p:`/`*m:` in `*<DefinedPropArrayMethod>`
+     membrul trece fidelity-check-ul, dar VFP nu-l vede si prima salvare din IDE il sterge tacut;
    - adaugi/rearanjezi controale pe formulare sau coloane in grid -> `conventie_ux_formulare.md`;
    - grid needitabil pe formular cu 2+ grid-uri -> `capcana_grid_controlsource.md`;
    - adaugi o coloana intr-un grid deja livrat (ordinea din clasa e neutralizata de
      preferintele salvate per utilizator) -> `capcana_grid_preferinte_utilizator.md`;
    - `GO` pe un `Recno()` capturat/primit ca parametru -> `conventie_go_recno.md`;
    - `ALTER TABLE` pe cursorul intors de `goExecutor.oExecute()` -> `conventie_goexecutor_alter_table.md`;
-   - testare UI / prin MCP -> `testare-ui-vfp.md`, `testare-vfp-mcp.md`;
+   - testare UI -> `testare-ui-vfp.md`;
    - te conectezi la Oracle pe dev/test, alegi schema sau rulezi un script de pachet ->
      `conventie_mediu_oracle.md`;
    - garzi pe valori NULL din Oracle -> `conventie_null_vfp.md`;