mem0ry4ai

Pe un Windows 11 curat, fara Python si fara git, instaleaza-le cu winget, apoi inchide si redeschide PowerShell (PATH-ul se actualizeaza doar in ferestre noi):

PS C:\WINDOWS\system32> winget install -e --id Python.Python.3.12
Found Python 3.12 [Python.Python.3.12] Version 3.12.10
Successfully installed
PS C:\WINDOWS\system32> winget install -e --id Git.Git
Found Git [Git.Git] Version 2.54.0
Successfully installed

PS C:\WINDOWS\system32> py --version
Python 3.12.10
PS C:\WINDOWS\system32> git --version
git version 2.54.0.windows.1

PS C:\WINDOWS\system32> cd $env:USERPROFILE
PS C:\Users\xxxxx> git clone https://github.com/cremenescu/mem0ry4ai.git
Cloning into 'mem0ry4ai'...
Receiving objects: 100% (368/368), 4.01 MiB | 6.30 MiB/s, done.
Resolving deltas: 100% (211/211), done.
PS C:\Users\xxxxx> cd mem0ry4ai
PS C:\Users\xxxxx\mem0ry4ai> py hooks\install.py --target user
installed in C:\Users\xxxxx/.claude/settings.json
Restart Claude Code (or /clear) so the hooks get loaded.

Daca nu ai winget (Windows mai vechi), instaleaza Python de pe python.org — bifeaza „Add python.exe to PATH” — si git de pe git-scm.com, apoi continua de la verificarea versiunilor.

Daca apoi Claude Code zice „Git is required for local sessions” — rula inainte sa instalezi git, deci nu stie unde e bash.exe. Indica-i git-bash-ul si reporneste complet:

# confirma calea (locatia default de instalare)
Test-Path "C:\Program Files\Git\bin\bash.exe"

# daca intoarce True:
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")

# daca git e in alta parte, rezolva bash.exe dinamic:
$bash = Join-Path (Split-Path (Split-Path (Get-Command git).Source)) "bin\bash.exe"
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", $bash, "User")

Apoi inchide Claude Code complet (verifica system tray-ul si Task Manager-ul — citeste variabila doar la pornire) si redeschide-l. Hook-urile se incarca la urmatoarea sesiune, iar web UI-ul apare la http://127.0.0.1:8841/.

Intarire — o memorie stocata nu mai poate falsifica o regula de incredere.

• Injectie prin memorie stocata, blocata — body-ul sau summary-ul unei memorii putea strecura pana acum chiar delimitatorii de record ai store-ului sau un titlu de sectiune fals, permitand unei scrieri cu incredere redusa (ex. memory_add al unui agent) sa forjeze un al doilea record, sau sa si-l escaladeze pe al sau, la priority: critical, injectat apoi in capul fiecarei sesiuni. Scrierile neutralizeaza acum acei delimitatori, iar un body injectat nu mai poate forja o sectiune ## Critical rules in contextul de SessionStart. Markdown-ul obisnuit din notele tale ramane neatins.

Cauta in conversatiile tale din trecut — si o garda impotriva memoriilor otravite.

• Cautare in sesiuni — o unealta noua session_search (si mem.py sessions) cauta in istoricul brut al conversatiilor, nu doar in store-ul distilat: „despre ce am discutat acum cateva saptamani?” peste un index FTS5 derivat al transcripturilor, cu zero cost LLM. Secretele sunt scoase inainte de indexare; indexul e doar-al-tau si gitignored. Aduce serverul MCP la opt unelte.
• Scanare de injection la scriere — o memorie e semnalata daca contine formulari de tip prompt-injection („ignora instructiunile si…”), fiindca o memorie stocata e reinjectata in contextul agentului la fiecare sesiune. Un ajutor la scriere non-blocking peste CLI, MCP si web, plus mem.py audit.

O pagina de setari pentru power-useri — si config care ajunge in sfarsit la fiecare proces.

• Pagina de setari in web UI — 20 de parametri reglabili (bugetul si pragurile de injectare, ranking-ul de cautare, garda de duplicate, embeddings, comutatoare de siguranta) grupati, validati si plafonati, fiecare cu o descriere clara, un badge „cand se aplica” si reset-la-implicit. Gata cu editatul codului ca sa schimbi o constanta.
• Config cross-proces — setarile se persista in .mem-local.env si sunt citite acum de hook, CLI si serverul MCP, nu doar de serverul web. Deci schimbarea bugetului de injectare chiar schimba ce se injecteaza; o valoare exportata in shell are in continuare prioritate la incarcare.

• Server MCP integrat (mem.py mcp) — store-ul e acum accesibil din orice client MCP (Gemini CLI, Cursor, OpenCode, …), nu doar Claude Code. Cinci unelte (memory_search / get / list / resume / add), scrise de mana pe Python stdlib (fara SDK, fara pip install), cu ghidajul pentru model livrat prin campul instructions al protocolului. Uneltele de citire mereu pornite; scrierea gardata de MEM_MCP_WRITE.
• File-locking intre scriitori — fiecare scriitor de store (CLI, web UI, MCP, mai multi agenti) se serializeaza acum printr-un lock reentrant cu furt de lock invechit pe baza vietii PID-ului, deci scrierile concurente nu se intrepatrund si nu pierd un append.

• Ranking-ul keyword (bm25 + recenta) si cel semantic se fuzioneaza acum prin Reciprocal Rank Fusion (k=60) in loc de un blend ad-hoc 0.5/0.5 — robust la nepotrivirea de scala bm25-vs-cosinus. Un rerank usor urca o potrivire exacta de fraza din summary spre varf. Reglabil prin MEM_RRF_K.

• Pagina Legaturi a primit un control Prag pentru „legaturi sugerate”, citit live (fara reload de server) si persistat in .mem-local.env ca sa supravietuiasca restartului. (v0.10.1–v0.10.2 i-au slefuit stilul.)

• Despre mine — un tip de memorie profile si o pagina web unde te descrii; e injectat primul la fiecare SessionStart ca asistentul sa-si adapteze ajutorul la tine.
• Redactare pe orice cale de scriere — update_memory redacteaza acum si el secretele (nu doar add), deci editarea unei memorii nu poate scapa un credential in store. (v0.9.1 a adaugat auto-reload al serverului web la schimbarea codului; v0.9.2 arata unde e stocat profilul.)

• Orice mutatie din web UI intorcea „CSRF” de la rescrierea v0.7.0: JS-ul trimitea corpul ca FormData (multipart), dar serverul parseaza doar urlencoded, deci tokenul nu era citit niciodata. Reparat trimitand URLSearchParams.
• Editor CLAUDE.md in web UI — editezi fisierele CLAUDE.md ale proiectelor cu scrieri atomice si backup.

Web UI-ul e acum Python pur — PHP scos, nativ pe macOS, Linux si Windows.

• Web UI rescris din PHP intr-un http.server stdlib (mem.py serve). Aceleasi pagini, byte-cu-byte, in browser — doar motorul s-a schimbat. Verificat pagina-cu-pagina vs UI-ul PHP vechi, paritate 1:1. Cerintele scad la doar Python 3.9+ si git: fara PHP, fara bash, fara Docker, fara pip install.
• Un singur cod, un singur parser — CLI-ul si web UI-ul folosesc acum un singur parser + strat de scriere Python in mem.py. Al doilea parser (lib.php) si testul de conformance care-i tinea sincronizati sunt sterse — clasa aia de bug-uri de drift a disparut.
• Windows nativ — fara WSL, fara PHP: clone, apoi py mem.py serve. Hook-urile se inregistreaza cu interpretorul tau, deci ruleaza fara python3 in PATH.

• Sugestii de legaturi grupate pe proiect — pagina Legaturi organizeaza sugestiile in benzi per proiect (doua nuante subtile alternate, nu un curcubeu), ca sa parcurgi suprapunerile unui proiect pe rand. Banda dispare cand legi sau respingi ultima sugestie din ea.
• mem.py resume — un briefing „unde am ramas?” pentru un scope (status curent + todo-uri ready/blocate + recente), sau un overview cu o linie per proiect fara --scope. Oglindeste ce injecteaza SessionStart, din terminal.
• Flush la granita de compactare — auto-commit + auto-embed care rulau la final de sesiune ruleaza acum si la PreCompact, deci o sesiune lunga care se compacteaza la mijloc nu pierde nimic, iar cautarea/sugestiile raman la zi — fara sa depinda de un preaviz inainte de compactare.

• Avertizare de duplicat la scriere — mem.py add cauta acum semantic inainte sa salveze si, daca exista deja un duplicat apropiat de acelasi tip, afiseaza o avertizare (nu blocheaza) cu cele mai apropiate + comanda supersede gata de rulat. Memoriile suprapuse se contopesc in loc sa se adune. Reglabil cu MEM_DUP_THRESHOLD; dezactivabil cu --no-dup-check.
• Auto-embed la final de sesiune — hook-ul SessionEnd reimprospateaza automat vectorii semantici (detasat, non-blocking, incremental), deci cautarea hibrida si sugestiile de pe pagina Legaturi reflecta memoriile scrise in sesiune fara sa rulezi mem.py embed manual.

• Beculet de status la cautare — fara bifa de tinut minte. Pagina Memorii auto-detecteaza embedder-ul local si arata ce a facut efectiv fiecare cautare: verde = Ollama e pornit, deci cautarea e keyword + semantic; gri = a revenit la cautare clasica keyword, cu motivul (Ollama oprit / fara vectori) la hover. Panoul de health din dashboard raporteaza si el embedder-ul.
• Fix: cautarea semantica porneste si cand nimic nu prinde keyword — inainte cautarea intorcea gol imediat ce interogarea keyword nu gasea randuri, sarind complet stratul semantic (exact scopul lui). Acum scoate la suprafata potriviri semantice pentru interogari ca 4090 → notitele tale despre GPU, la fel ca mem.py search.
• Robustete — etapele keyword si semantic sunt acum izolate, deci o eroare in stratul semantic nu mai poate eticheta gresit un rezultat keyword bun drept „substring”; iar un store de vectori absent e diferentiat de unul necitibil. mem.py search afiseaza modul folosit; --no-semantic forteaza keyword.

• Sugestii semantice de legaturi — pagina Legaturi propune acum cele mai apropiate perechi nelegate ca muchii related-to sugerate; tu confirmi sau respingi fiecare. Nimic nu se leaga automat.
• Cautare hibrida (optionala) — cu Ollama + un embedder mic (all-minilm, ~40 MB), cautarea fuzioneaza scorul keyword cu similaritate cosinus pe vectori locali, asa ca „auth token expiry” gaseste „JWT TTL”. Doar regasire — nu decide si nu scrie, deci nu atinge gate-ul de incredere; fara Ollama, fallback tacut la keyword.
• Supersedare bi-temporala — supersedarea retine acum cand un fapt a incetat sa fie valabil (invalidated) si de ce (invalid-reason), distinct de created. Istoric complet „ce-am crezut si cand”.
• Tip procedural pentru runbook-uri reutilizabile, un camp files care leaga o memorie de fisierele pe care le priveste (indexat + chips) si ranking pe recenta ca memoriile mai noi sa castige la egalitate.

• Pagina Legaturi — muchiile related-to / blocked-by se deseneaza acum ca graf force-directed: noduri colorate pe tip si dimensionate dupa numarul de legaturi, related = linie plina, blocked = intrerupta cu sageata. Trage ca sa rearanjezi, click pe nod → memoria lui, hover evidentiaza vecinii; lista detaliata dedesubt.
• Fara biblioteci externe — o mica simulare vanilla-JS + SVG, complet offline (fara CDN, fara D3), citind aceleasi date ca lista. Acces printr-un card Legaturi si o intrare in bara de sus.

• Relatii — legi memorii inrudite cu mem.py link (related-to): un gotcha ↔ decizia care l-a cauzat, un status ↔ todo-urile lui. Deliberat, nu automat.
• Ready work — blocked-by pe todo-uri + mem.py ready listeaza ce poti ataca acum; pagina de proiect separa ready de blocate.
• Web UI restructurat — index.php e dashboard, lista in memories.php, o pagina noua projects.php. Bara de sus partajata + breadcrumb peste tot.

• Reguli critice + buget de injectare — injectarea de la SessionStart se taie singura sub pragul harness-ului. Regulile priority: critical intra mereu primele; restul umple MEM_INJECT_BUDGET, iar orice taietura e anuntata.
• Redactare de secrete pe orice cale de scriere (8 pattern-uri) — redactate inainte sa ajunga la LLM-ul local. mem.py audit raporteaza ce e deja in store.
• Plugin Claude Code — claude plugin install mem0ry4ai@mem0ry4ai; datele in ~/.mem0ry4ai. Plus cautare pe data si pagina Istoric git live.

• Auto-checkpoint — hook-ul de SessionEnd comite singur store/; memoriile scrise in sesiune ajung in istoricul git fara nicio actiune manuala.
• Panoul Health: store-ul necomis e o stare gri informativa, nu o eroare rosie — e conditia normala mid-sesiune.
• Butonul de commit din pagina Istoric git ramane pentru checkpoint-uri manuale cu mesaj propriu.

• Pagina Istoric git — timeline-ul store-ului in web UI: fiecare commit care atinge store/, cu diff colorat incarcat lazy.
• Commit din UI — schimbarile necomise din store sunt listate, cu buton care comite doar fisierele de memorie (autor mem0ry4ai web, fara signing, nu atinge codul).
• README: sectiunea Measured impact (cifre reale before/after) + galerie de screenshots cu date demo.

• Markdown + git ca sursa de adevar — auditabil, supersedare-nu-stergere; indexul SQLite FTS5 e derivat si regenerabil.
• Hooks Claude Code: injectare la SessionStart (scoped per proiect, index plafonat multi-proiect din radacina unui monorepo), captura de pointeri la transcript la SessionEnd/PreCompact.
• Captura cu gate de incredere: agentul cu context scrie direct; extractia offline cu LLM local (Ollama) trece prin coada de review umana.
• Tipuri dedicate todo si status — primele la injectare si in UI.
• Web UI: dashboard cu health checks si live updates, pagini per proiect, cautare FTS5, operatii bulk, lant de supersedare, preview „Ce vede Claude", coada de review. Bilingv EN/RO.
• Server standalone (php -S cu PHP_CLI_SERVER_WORKERS), pornit automat de hook-ul de sesiune. Binarele se rezolva din PATH cu override-uri din env.