pending_radu_neo_decision · deschisă de 60 de zile

Care CLI e „cel oficial” pentru agenți?

Voost Control are două unelte prin care agenții AI citesc și scriu în sistem. Pe 4 iunie s-a pus întrebarea care dintre ele e cea oficială. Răspunsul n-a venit niciodată — iar între timp realitatea din cod a mers mai departe fără el.

Actul 1 · piesele

Cele două unelte, pe scurt

Ambele fac același lucru de bază: răspund la întrebări despre clienți, proiecte, apeluri și facturi. Diferența e cum sunt făcute și cât de mult text îți toarnă în față.

CLI-ul scris de mână

node bin/voost.mjs
  • Scris direct în proiect, în JavaScript
  • Cunoaște tot ce știe aplicația
  • Se schimbă odată cu aplicația, automat
  • Răspunsuri lungi — așa a fost gândit

CLI-ul generat + serverul MCP

voost-control-pp-cli · voost-control-pp-mcp
  • Generat automat dintr-o listă de operații, în Go
  • Cunoaște doar ce e trecut în acea listă
  • Rămâne în urmă dacă nu e regenerat
  • Răspunsuri scurte — e făcut pentru agenți

Aceeași întrebare, două răspunsuri

Cifrele sunt măsurate pe 31 iulie, pe producție. Apasă ca să compari.

Un răspuns de 2,4 MB nu încape în memoria de lucru a unui agent. De asta contează diferența.

Actul 2 · regula

De ce e blocată decizia

Există o regulă scrisă, în docs/operations/PP-CLI-SOURCE-OF-TRUTH.md:

Regula de acceptanță: CLI-ul scris de mână rămâne cel oficial până când pachetul de acceptanță e aprobat de Radu. Până atunci, cel generat poate fi folosit pentru testare internă, nu ca implicit.

Pachetul de acceptanță conține un scor de calitate. Pragul e 92. Scorul e 88, și n-a mișcat deloc de la măsurătoarea de referință.

Unde pierde punctele

Cele mai slabe 11 dimensiuni, din 4 iunie. Apasă pe oricare.

Alege o dimensiune ca să vezi ce înseamnă — și dacă valul de acum a atins-o.
Aici e miezul: patru dimensiuni au scor zero, iar trei dintre cele mai slabe sunt exact ce a reparat valul de PR-uri din 31 iulie – 2 august. Scorul de 88 descrie o unealtă care nu mai există în forma aia.
Actul 3 · deriva

Ce s-a întâmplat în cele două luni de așteptare

Decizia n-a stat pe loc așteptând. Sistemul a mers mai departe și a răspuns singur, prin fapte.

Actul 4 · harta reală

Cât de departe sunt de fapt una de alta

Există o matrice de comparare, refacută pe 24 iulie: 16 capabilități de citire, fiecare cu un verdict. Filtrează:

Cel generat nu e „mai slab”. E mai bun pe 5 capabilități și egal pe 7. Are exact două goluri reale. Asta nu e imaginea unui înlocuitor imatur — e imaginea a două unelte cu roluri diferite.
Actul 5 · opțiunile

Ce poți decide, de fapt

Apasă pe fiecare opțiune ca să vezi ce obții, ce pierzi, ce se schimbă structural și cât ține.

Actul 6 · testul tău

Trecut prin propria ta regulă

VISION.md spune: înainte de orice schimbare, răspunde care pilon îl întărește — context, încredere sau vizibilitate? Dacă răspunsul e „niciunul”, nu-și are locul în Voost Control.

Testul tău elimină singur două opțiuni: una nu întărește niciun pilon, alta slăbește vizibilitatea.

recomandarea mea

Întrebarea din iunie e pusă greșit

Întrebarea era „care dintre ele înlocuiește pe cealaltă”. Răspunsul din cod, dat în iulie fără să fie declarat, e că niciuna. ADR-0074 le numește deja pe amândouă suprafețe de citire pentru agenți; matricea arată două goluri, nu o înapoiere; iar Hermes rulează suprafața MCP de două luni indiferent ce scrie în pachet.

Opțiunea D nu e un compromis — e recunoașterea a ceea ce ai construit deja. Iar pașii sunt mici:

  1. Re-scorează după val. Scorul de 88 e din 4 iunie și descrie o unealtă care nu mai există. Nu decizi pe o măsurătoare moartă.
  2. Înlocuiește întrebarea binară din pachet cu regula de rutare: cine citește compact, cine citește complet, cine scrie.
  3. Scrie ADR-ul care declară împărțirea. Azi ea există în practică dar nu în scris — de-aia a putut un PR s-o rescrie din greșeală.
  4. Închide cele două goluri sau acceptă-le explicit ca Node-only. Sunt două, nu douăzeci.
  5. Închide PRD #92 ca „înlocuit de împărțirea documentată”. Stă deschis din 9 mai.