claude-agent/TODO.md

TODO — progresul funcționalităților

Registrul viu al lucrului cerut prin puntea Discord. Botul îl citește la începutul oricărei cereri de dezvoltare și îl actualizează la final — vezi docs/flux-dezvoltare.md.

Stări: 🔵 planificat · 🟡 în lucru · ⛔ blocat · ✅ gata · ❌ abandonat

---

🟡 În lucru

(nimic în acest moment)

---

⛔ Blocate

(nimic blocat)

---

🔵 Planificate

Maria — termenii distinctivi se judecă pe interogarea combinată, nu pe întrebare

• Unde: romfastsql/proxmox/lxc171-claude-agent/maria-whatsapp-bridge/ (rag/rank.py:168 rare_terms, rag/consumer.py:144, ops/calibrate-rank.py)
• Ce ar însemna: pe un fir, căutarea se face după ancoră + mesajul nou, iar acoperirea se judecă pe același text. Rezultatul: „buna", „luna", „august" din primul mesaj ajung „termeni distinctivi" și nu apar niciodată în documente, deci raportul cerut de assess() scade la fiecare replică → escaladare în plus pe discuțiile lungi. Regăsirea trebuie să rămână pe interogarea combinată; acoperirea să treacă pe mesajul nou.
• Întâi: cazuri de continuare fără cod de eroare în ops/calibrate-rank.py (azi are 26, toate continuările au cod, deci trec pe altă regulă). Fără ele nu se poate valida reparația — continuările scurte („da, mă blochează") n-au termeni distinctivi proprii și riscă să escaladeze, exact regresia pentru care există firul.
• De ce nu acum: direcția de eșec e sigură (escaladare, nu răspuns inventat) și nu există încă nicio dovadă că se produce în practică.
• Context complet: romfastsql/CONTEXT_HANDOVER_20260901_termeni_distinctivi.md
• Actualizat: 2026-09-01

Mesaje vocale din Discord

• Unde: romfastsql/proxmox/lxc171-claude-agent/discord-bridge/bot.py
• Ce ar însemna: atașamentele audio (mesajele vocale Discord) transcrise local înainte de a intra în prompt. Whisper rulează pe CPU pe LXC 171, deci trebuie măsurat întâi costul în timp per mesaj.
• De ce nu acum: nu a fost cerut; e singura limitare rămasă după atașamente.
• Actualizat: 2026-08-31

---

✅ Gata

Infrastructură în dashboard + /infra în Discord

• Unde: romfastsql/proxmox/lxc171-claude-agent/discord-bridge/ (infra_actions.py nou, dashboard/, bot.py, commands_slash.py), romfastsql/proxmox/cluster/scripts/, romfastsql/proxmox/cluster/ups/scripts/
• Ce: tab „Infrastructură” (stare cluster, oprire/pornire cluster, UPS doar simulare, DR VM 109, failover/failback backup-uri Oracle cu fișe de instrucțiuni), panouri colapsabile și compacte în tot dashboard-ul, /infra cu butoane de confirmare. Joburile rulează prin systemd-run pe noduri. Pornirea: JuiceSSH → 10.0.20.36 → C:\wolcluster.bat. Parola UPS mutată în /etc/nut/ups-shutdown.conf. Scripturile VM 201 se arhivează (VM 201 e în HA).
• Mockup aprobat: https://claude.ai/code/artifact/fa65619b-2310-4d65-9939-ffb1a3f7183b
• Verificat: simulări pe pvemini (oprire, pornire, oprire de urgență UPS ca nut), job real systemd-run prin API (oprire --dry-run, cod 0, fără efecte), stare live, 511 teste, /infra înregistrat (9 comenzi slash). tmux instalat pe noduri.
• Terminat: 2026-09-13

Maria — reset fire de discuție din dashboard

• De unde a pornit: un test manual în grupul „Maria Test" a rămas legat de un fir vechi (Maria trata mesajele ca „firul are eroare X", ancorat pe o discuție anterioară) și nu exista nicio cale să-l resetezi fără intervenție directă pe server — nici comandă de chat, nici buton.
• Ce s-a făcut: secțiune nouă „Fire de discuție active" în dashboard, între „Trimise la suport" și „Clienți cunoscuți": listă cu JID, subiect scurtat, ultima activitate, buton de ștergere cu confirmare. Rutele GET /api/maria/fire și POST /api/maria/fire/delete citesc/șterg direct fișierele din ~/.maria-bridge/conversations/, cu aceeași sanitizare de nume de fișier ca rag/fir.py (oglindă, nu import — coliziune de modul config între cele două proiecte).
• De ce listă și nu un buton fix pe grupul de test: nu există în cod nicio constantă pentru JID-ul grupului de test — apare doar în README. O listă acoperă orice fir activ, nu doar unul hardcodat.
• Verificat: 6 teste noi (test_maria_fire.py), 11/11 cu cele de clienți; fără regresii pe test_dashboard.py.
• Terminat: 2026-09-08

Maria — profil de client (firmă), asociat cu mai multe numere

• De unde a pornit: clienții contactează suportul cu întrebări generice ("am o problemă cu factura") fără context — Maria nu știa că un anumit client e, de exemplu, un service auto care lucrează în RoAuto, deci nu putea interpreta întrebarea în lumina programului lui.
• Ce s-a făcut: un fișier nou (rag/client.py + ~/.maria-bridge/clients.json) ține profiluri de client (nume, notiță text liberă, listă de numere de telefon). Un client poate avea mai mulți angajați care scriu de pe numere diferite — toți găsesc același profil. La fiecare mesaj, profilul se citește de pe disc (stateless, ca restul Mariei) și intră într-o secțiune DESPRE CLIENT în prompt, înaintea contextului RAG. Administrare prin dashboard (discord-bridge/dashboard, secțiunea „Clienți cunoscuți"), nu prin comandă în chat — canalul de scriere trebuie autentificat.
• De ce profilul nu intră în căutare: pragurile de acoperire din rag/rank.py sunt calibrate pe textul întrebării; a adăuga cuvinte fixe de profil la fiecare interogare ar strica raportul de termeni distincți și ar agrava firul deja deschis mai jos ("termenii distinctivi pe interogarea combinată"). Profilul filtrează interpretarea răspunsului, nu participă la decizia „am/nu am informația".
• Mesaje de grup: dacă cineva scrie într-un grup WhatsApp, se identifică persoana din participant, nu grupul — altfel grupul s-ar putea potrivi accidental cu primul client găsit.
• Granița infra: profilul e strict business (nume firmă, domeniu, program ROA folosit) — niciodată date tehnice de instalare (server, parole). Precizare adăugată în CLAUDE.md, secțiunea „Maria — GRANIȚĂ OBLIGATORIE".
• Verificat: 117 teste (110 existente + 7 noi) în maria-whatsapp-bridge, plus teste noi pentru rutele de dashboard (test_maria_clients.py).
• Terminat: 2026-09-08

Maria — rank hibrid, escaladare la suport, dicționar Oracle

• De unde a pornit: o captură cu o eroare Oracle a primit un răspuns generic — corect gramatical, dar despre altă eroare. Nu se putea nici măcar afla ce citise OCR-ul.
• Ce s-a făcut: (1) textul OCR se loghează integral, cu interogarea de căutare și sursele alese cu scoruri; (2) ordonare hibridă embeddings + BM25 cu fuziune RRF, și o decizie separată „avem acoperire?"; (3) când nu avem, modelul nu mai e întrebat deloc — întrebarea pleacă la suport pe WhatsApp, cu captura atașată și o referință; (4) dicționar de 29 de erori Oracle uzuale, scris pentru clienți, nu pentru administratori.
• De ce hibrid și nu doar embeddings: măsurat, intervalele se suprapun — întrebările bune dau 0,600–0,816 și cele străine 0,534–0,685. Codurile (ORA-01722, D406, CIF) sunt exact ce ratează căutarea semantică. Pragurile sunt măsurate cu ops/calibrate-rank.py, nu alese din burtă: 19/19 pe setul de cazuri.
• Două lucruri găsite în log pe drum: fiecare mesaj din self-chat sosea de două ori (pe @s.whatsapp.net și pe @lid), deci Maria răspundea dublu — dedup pe key.id. Și reindexarea refăcea toate embeddings-urile (~7 s fiecare): acum refolosește vectorii chunk-urilor nemodificate — 29 noi în loc de 169.
• Un bug vechi reparat pe parcurs: documentele adăugate din dashboard ajungeau în oglinda Drive și dispăreau la următorul rclone sync. Acum există documents-local/.
• Rămas de făcut: SUPPORT_JID e propriul număr, pentru testare — de schimbat cu numărul sau grupul echipei de suport. Dicționarul Oracle trăiește doar pe container; locul lui e document_store din Drive.
• Verificat: 73 de teste (de la 26 la începutul zilei); o escaladare reală cu captură a plecat pe WhatsApp și apare în dashboard.
• Terminat: 2026-08-31

Maria — asociere prin cod de telefon și citirea capturilor cu erori

• Ce s-a făcut: două lucruri cerute în aceeași frază. (1) Asocierea WhatsApp se poate face acum și cu un cod de 8 caractere, nu doar cu QR — util când nu ai un ecran de dus în fața telefonului. (2) Maria citește capturile de ecran trimise pe WhatsApp: puntea descarcă imaginea, rag/ocr.py o trece prin tesseract ron+eng, restul lanțului rămâne neschimbat.
• De ce OCR și nu un model vizual: modelul de răspuns (Qwen3.5-2B pe LXC 104) e strict text. Nu e o alegere de calitate, e singura cale fără a schimba modelul.
• Blocaje găsite pe drum: endpoint-ul /pair exista, dar după introducerea codului WhatsApp cere un restart (515) care consuma din bugetul de reîncercări și putea opri puntea la a cincea asociere. Separat, capturile trimise „efemer" ajungeau ca mesaje fără conținut și se aruncau tăcut — lipsea despachetarea ephemeralMessage.
• O decizie care nu se vede din cod: căutarea în index merge doar pe liniile care arată a eroare, nu pe toată captura; un ecran de meniuri și totaluri diluează embedding-ul. Modelul primește totuși fereastra întreagă, marcată ca text OCR.
• Verificat: 16 teste noi (suita Maria: 42 pass), OCR real pe o captură cu ORA-01722: invalid number — extras corect; ambele servicii repornite și conectate.
• Terminat: 2026-08-31

Echo re-legat la WhatsApp după delogare

• Ce s-a întâmplat: puntea WhatsApp a lui Echo (LXC 110) fusese delogată de pe telefon dimineața (401). Utilizatorul a eliberat un slot de dispozitiv; puntea a fost re-legată prin cod, nu prin QR — auth/ salvat în auth.bak-2026-08-31, serviciul repornit, POST /pair. Acum e dispozitivul :14 al aceluiași cont.
• Ce s-a lămurit: de ce nu răspund ambele punți în chatul „Eu". Amândouă primesc mesajele, dar Echo le aruncă pe toate cu fromMe && !isGroup, iar în self-chat tot ce scrii e fromMe. Echo folosește „Eu" doar ca destinație de notificări. Echilibrul e accidental — scris în romfastsql/docs/chatboti-si-punti.md.
• Terminat: 2026-08-31

Maria mutată pe LXC 171, cu tot ce s-a construit

• Ce s-a făcut: LXC 171 asociat la WhatsApp (+40723197939, dispozitiv nou al aceluiași cont); prototipul de pe LXC 104 oprit și dezactivat. llama-qwen35 rămâne pe 104 și e folosit de 171 prin rețea (LLM_URL=http://10.0.20.161:8091).
• Rezultat: Maria a trecut de la 24 de chunk-uri dintr-un singur fișier la 173 din 11 documente, plus sincronizare Drive automată.
• Un blocaj găsit pe drum: după asociere nu răspundea nimic. WhatsApp livrează self-chat-ul cu JID de tip LID (51947713372214@lid), iar filtrul compara doar cu <număr>@s.whatsapp.net — arunca tot, fără nicio urmă în log. Reparat în whatsapp/index.js; mesajele respinse se loghează acum cu motivul.
• Verificat: „token efactura expirat" → preluat, căutat în RAG, răspuns trimis.
• Terminat: 2026-08-31

Maria — sincronizare Google Drive

• Unde: maria-whatsapp-bridge/ops/setup-drive.sh, rag/sync.py, docs/rclone-google-drive-headless.md (în romfastsql)
• Ce face: rclone autorizat cu token obținut pe stația Windows (rclone authorize, fără cont de serviciu Google), dosarul fixat pe ID. maria-sync.timer trage la 10 min.
• Rezultat: depozitul a trecut de la 6 la 11 documente — au intrat SAF-T D406, e-Factura (.md + .xml), roaauto și roagest, care lipseau complet.
• Terminat: 2026-08-31

Maria indexează .xml, preferat peste .md

• Unde: maria-whatsapp-bridge/rag/store.py (DOC_EXTENSIONS, documents_for_index), rag/indexer.py (chunk_xml), rag/sync.py, discord-bridge/dashboard/api.py + index.html, tests/
• Ce face: .xml intră în depozit și, când același document există și ca .md, doar .xml se indexează (.xml > .md > .txt); cel umbrit rămâne pe disc și e marcat în dashboard. XML-ul se taie câte un chunk per problemă, cu mesajul de eroare și rezolvarea împreună.
• De ce: la d406_saft_knowledge, .xml e cu 3 luni mai nou și cu 50% mai mare decât .md. Tăierea pe linii goale ar fi separat eroarea de rezolvare.
• Verificat: 20 de teste noi (suita Maria, prima ei suită); puntea Discord 426 pass.
• Terminat: 2026-08-31

Atașamente Discord → Claude (imagini + fișiere text)

• Unde: romfastsql/proxmox/lxc171-claude-agent/discord-bridge/bot.py (build_user_content), runner.py (user_message), tests/test_attachments.py
• Ce face: imaginile png/jpeg/gif/webp ajung ca blocuri image (max 4, max 3,5 MB), fișierele text intră în prompt (max 4, trunchiate la 100 KB), restul sunt doar numite. Merge și mid-tur, ca steering. Un mesaj doar cu poză nu mai e respins ca gol.
• Verificat: 31 de teste noi, suita 426 pass; blocurile de imagine testate pe CLI-ul real (--input-format stream-json), Claude descrie corect imaginea.
• Terminat: 2026-08-31

Plan cu Opus, execuție cu Sonnet

• Unde: docs/flux-dezvoltare.md, referit din CLAUDE.md
• Ce face: orice cerere de dezvoltare trece întâi printr-un subagent Plan pe Opus; planul se postează în fir, apoi execuția merge pe Sonnet, în sesiunea firului.
• Terminat: 2026-08-31

Memorie comună claude-agent ↔ romfastsql

• Ce face: ~/.claude/projects/-workspace-claude-agent/memory e symlink către memoria proiectului romfastsql, deci firele Discord nu mai pornesc fără context.
• Terminat: 2026-08-31

Repo propriu pentru claude-agent + reparare Gitea

• Ce face: /workspace/claude-agent e repo separat (git@gitea.romfast.ro:romfast/claude-agent.git), scos din romfast/workspace. Gitlink-urile fără .gitmodules care dădeau 500 pe pagina repo-ului workspace au fost scoase din index.
• Terminat: 2026-08-31

---

Jurnal

Cea mai recentă intrare prima. O linie per schimbare de stare.

• 2026-09-13 — ✅ Infrastructură în dashboard + /infra în Discord (oprire/pornire cluster, UPS, DR, failover backup)
• 2026-09-08 — ✅ Maria: buton de reset pentru firele de discuție active, din dashboard
• 2026-09-08 — ✅ Maria: profil de client (firmă) asociat cu mai multe numere, injectat în prompt
• 2026-09-01 — ✅ Maria: mesajul și captura sunt același lucru; cosinusul singur nu mai e dovadă
• 2026-09-01 — ✅ Maria: „am trimis la suport" doar când puntea chiar a trimis
• 2026-09-01 — 🔵 Maria: termenii distinctivi pe interogarea combinată (planificat)
• 2026-08-31 — ✅ Maria: rank hibrid + escaladare la suport + dicționar de erori Oracle
• 2026-08-31 — ✅ Maria: asociere prin cod de telefon + citirea capturilor cu erori (OCR)
• 2026-08-31 — ✅ Echo re-legat la WhatsApp prin cod, ca dispozitiv :14
• 2026-08-31 — ✅ Maria mutată pe LXC 171; reparat filtrul care arunca mesajele LID
• 2026-08-31 — ✅ Maria — sincronizare Google Drive, 6 → 11 documente
• 2026-08-31 — ✅ Maria indexează .xml, preferat peste .md
• 2026-08-31 — ✅ Atașamente Discord → Claude (imagini + fișiere text)
• 2026-08-31 — ✅ Plan cu Opus, execuție cu Sonnet
• 2026-08-31 — ✅ Memorie comună claude-agent ↔ romfastsql
• 2026-08-31 — ✅ Repo propriu pentru claude-agent + reparare Gitea