Alex Newman
36b0929fae
* Add server beta runtime foundation * Address server beta review findings * Resolve server beta review comments * Tighten server beta review follow-ups * Harden server beta auth and search * Avoid unnecessary FTS rebuilds * Block scoped keys from creating projects * Release BullMQ claims best effort on close * Address server beta review blockers * Reset BullMQ claims best effort * Add Postgres observation storage foundation * feat(server-beta): add independent runtime service Introduce src/server/runtime/ as a self-contained server-beta runtime that owns its lifecycle, Postgres bootstrap, and HTTP boundary without depending on WorkerService. ServerBetaService wraps the existing Server class, exposes /healthz and /v1/info with runtime="server-beta", and persists state to dedicated paths (.server-beta.pid|.port|.runtime.json). The four boundary managers (queue, generation worker, provider registry, event broadcaster) are intentionally disabled in this phase and report their status through /v1/info; later phases activate them. Adds plans/2026-05-07-finish-bullmq-branch-ship-plan.md to track the remaining work for this branch. Phase 2 of plans/2026-05-07-server-beta-independent-bullmq-observation-runtime.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(server-beta): route CLI lifecycle and bundle separate runtime scripts/build-hooks.js now produces plugin/scripts/server-beta-service.cjs as a separate Node CJS bundle, alongside the existing worker-service bundle. The server-beta runtime is now installable independently. src/npx-cli/commands/server.ts routes start|stop|restart|status to the server-beta lifecycle instead of the legacy worker. The worker keeps its own start|stop|restart|status under the worker namespace; the two runtimes can be operated independently. src/services/worker-service.ts adds a server-* command parser branch that delegates to the sibling server-beta-service.cjs bundle so direct worker-service invocations still route to the right runtime. tests/npx-cli-server-namespace.test.ts updated to expect server-beta lifecycle routing. Includes rebuilt plugin/scripts/*.cjs bundles produced by build-and-sync. Phase 2 of plans/2026-05-07-server-beta-independent-bullmq-observation-runtime.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(server-beta): add BullMQ job queue primitives Introduce src/server/jobs/ as the queue-side primitives that Phase 3 of the server-beta runtime needs to operate. types.ts defines a discriminated union over the four job kinds (event, event-batch, summary, reindex) and maps each to a per-kind BullMQ queue name and deterministic-ID prefix. job-id.ts builds deterministic, colon-free BullMQ jobIds from (kind, team, project, source). The colon ban exists because BullMQ uses ':' as a Redis key separator internally; embedding ':' in jobIds breaks scan and state lookups. ServerJobQueue.ts is a thin wrapper over BullMQ Queue + Worker that enforces autorun:false, default concurrency 1, and an attached error listener — all per BullMQ docs requirements. Test seams accept queue and worker factories so unit tests do not need Redis. outbox.ts publishes through the Postgres ObservationGenerationJob repository as canonical history. enqueueOutbox writes the row first, then publishes to BullMQ; if BullMQ throws, the row is transitioned to failed and a failed event is appended. reconcileOnStartup re-enqueues queued + processing rows after a restart, replacing terminal BullMQ jobs that may still be holding the deterministic ID slot. markCompleted and markFailed wrap transitionStatus and append the matching event row. Includes 20 unit tests covering deterministic ID stability, colon-free output, queue lifecycle, error-listener attachment, double-start refusal, idempotent enqueue, BullMQ failure rollback, startup reconciliation, max-attempts skipping, and completion / failure / retry transitions. Phase 3 commit 1 of plans/2026-05-07-server-beta-independent-bullmq-observation-runtime.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(server-beta): activate queue boundary in runtime service Wire ActiveServerBetaQueueManager into the server-beta runtime graph. The active manager owns one ServerJobQueue per generation kind (event, event-batch, summary, reindex) and surfaces lane metadata through boundary health. Selection is opt-in and fail-fast: if CLAUDE_MEM_QUEUE_ENGINE is set to bullmq the active manager is constructed (and any Redis/config error throws — no silent fallback to SQLite, per Phase 3 anti-pattern guard). For any other engine the disabled boundary remains so worker-era and test setups stay compatible. Widens ServerBetaBoundaryHealth.status to a discriminated union ('disabled' | 'active' | 'errored') with optional details. The disabled adapter still emits status='disabled', which keeps the existing server-beta-service test green. ServerBetaService receives the manager through a new optional queueManager field on CreateServerBetaServiceOptions so test graphs and Phase 4 wiring can inject custom managers. Adds tests/server/runtime/active-queue-manager.test.ts covering bullmq guard, active health shape, per-kind queue access, close behavior, and post-close errored health. Phase 3 commit 2 of plans/2026-05-07-server-beta-independent-bullmq-observation-runtime.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * fix(server-beta): cap /v1/events/batch at 500 events Prevents unbounded array DoS surface flagged in PR review. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
13 KiB
🌐 Aceasta este o traducere automată. Corecțiile din partea comunității sunt binevenite!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Sistem persistent de compresie a memoriei construit pentru Claude Code.
Start Rapid • Cum Funcționează • Instrumente de Căutare • Documentație • Configurare • Depanare • Licență
Claude-Mem păstrează contextul fără întrerupere între sesiuni prin capturarea automată a observațiilor de utilizare a instrumentelor, generarea de rezumate semantice și punerea lor la dispoziție în sesiunile viitoare. Aceasta permite lui Claude să mențină continuitatea cunoștințelor despre proiecte chiar și după încheierea sau reconectarea sesiunilor.
Start Rapid
Porniți o nouă sesiune Claude Code în terminal și introduceți următoarele comenzi:
> /plugin marketplace add thedotmack/claude-mem
> /plugin install claude-mem
Reporniți Claude Code. Contextul din sesiunile anterioare va apărea automat în sesiunile noi.
Caracteristici Principale:
- 🧠 Memorie Persistentă - Contextul supraviețuiește între sesiuni
- 📊 Dezvăluire Progresivă - Recuperare stratificată a memoriei cu vizibilitatea costurilor în tokeni
- 🔍 Căutare Bazată pe Abilități - Interogați istoricul proiectului cu abilitatea mem-search
- 🖥️ Interfață Web Viewer - Flux de memorie în timp real la http://localhost:37777
- 💻 Abilitate Claude Desktop - Căutați în memorie din conversațiile Claude Desktop
- 🔒 Control al Confidențialității - Utilizați etichete
<private>pentru a exclude conținut sensibil de la stocare - ⚙️ Configurare Context - Control fin asupra contextului care este injectat
- 🤖 Operare Automată - Nu necesită intervenție manuală
- 🔗 Citări - Referință la observații anterioare cu ID-uri (accesați prin http://localhost:37777/api/observation/{id} sau vizualizați toate în web viewer la http://localhost:37777)
- 🧪 Canal Beta - Încercați funcții experimentale precum Endless Mode prin comutarea versiunii
Documentație
📚 Vizualizați Documentația Completă - Răsfoiți pe site-ul oficial
Introducere
- Ghid de Instalare - Start rapid și instalare avansată
- Ghid de Utilizare - Cum funcționează Claude-Mem automat
- Instrumente de Căutare - Interogați istoricul proiectului cu limbaj natural
- Funcții Beta - Încercați funcții experimentale precum Endless Mode
Practici Recomandate
- Inginerie Context - Principii de optimizare a contextului pentru agenți AI
- Dezvăluire Progresivă - Filosofia din spatele strategiei de pregătire a contextului Claude-Mem
Arhitectură
- Prezentare Generală - Componente de sistem și flux de date
- Evoluția Arhitecturii - Parcursul de la v3 la v5
- Arhitectura Hooks - Cum folosește Claude-Mem hook-urile de ciclu de viață
- Referință Hooks - 7 scripturi de hook explicate
- Serviciu Worker - HTTP API și gestionare Bun
- Baza de Date - Schemă SQLite și căutare FTS5
- Arhitectura Căutării - Căutare hibridă cu baza de date vectorială Chroma
Configurare și Dezvoltare
- Configurare - Variabile de mediu și setări
- Dezvoltare - Construire, testare, contribuție
- Depanare - Probleme comune și soluții
Cum Funcționează
Componente Principale:
- 5 Hook-uri de Ciclu de Viață - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripturi de hook)
- Instalare Inteligentă - Verificator de dependențe în cache (script pre-hook, nu un hook de ciclu de viață)
- Serviciu Worker - HTTP API pe portul 37777 cu interfață web viewer și 10 endpoint-uri de căutare, gestionat de Bun
- Bază de Date SQLite - Stochează sesiuni, observații, rezumate
- Abilitatea mem-search - Interogări în limbaj natural cu dezvăluire progresivă
- Bază de Date Vectorială Chroma - Căutare hibridă semantică + cuvinte cheie pentru recuperare inteligentă a contextului
Consultați Prezentarea Generală a Arhitecturii pentru detalii.
Abilitatea mem-search
Claude-Mem oferă căutare inteligentă prin abilitatea mem-search care se invocă automat când întrebați despre lucrul trecut:
Cum Funcționează:
- Întrebați natural: "Ce am făcut în sesiunea trecută?" sau "Am rezolvat acest bug înainte?"
- Claude invocă automat abilitatea mem-search pentru a găsi contextul relevant
Operații de Căutare Disponibile:
- Search Observations - Căutare full-text în observații
- Search Sessions - Căutare full-text în rezumatele sesiunilor
- Search Prompts - Căutare în cererile brute ale utilizatorilor
- By Concept - Găsire după etichete de concept (discovery, problem-solution, pattern, etc.)
- By File - Găsire de observații care fac referire la fișiere specifice
- By Type - Găsire după tip (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Obținere context recent al sesiunii pentru un proiect
- Timeline - Obținere cronologie unificată a contextului în jurul unui punct specific în timp
- Timeline by Query - Căutare observații și obținere context cronologic în jurul celei mai bune potriviri
- API Help - Obținere documentație API de căutare
Exemple de Interogări în Limbaj Natural:
"What bugs did we fix last session?"
"How did we implement authentication?"
"What changes were made to worker-service.ts?"
"Show me recent work on this project"
"What was happening when we added the viewer UI?"
Consultați Ghidul Instrumentelor de Căutare pentru exemple detaliate.
Funcții Beta
Claude-Mem oferă un canal beta cu funcții experimentale precum Endless Mode (arhitectură de memorie biomimetică pentru sesiuni extinse). Comutați între versiunile stabile și beta din interfața web viewer la http://localhost:37777 → Settings.
Consultați Documentația Funcțiilor Beta pentru detalii despre Endless Mode și cum să îl încercați.
Cerințe de Sistem
- Node.js: 18.0.0 sau superior
- Claude Code: Versiunea cea mai recentă cu suport pentru plugin-uri
- Bun: Runtime JavaScript și manager de procese (instalat automat dacă lipsește)
- uv: Manager de pachete Python pentru căutare vectorială (instalat automat dacă lipsește)
- SQLite 3: Pentru stocare persistentă (inclus)
Configurare
Setările sunt gestionate în ~/.claude-mem/settings.json (creat automat cu valori implicite la prima rulare). Configurați modelul AI, portul worker, directorul de date, nivelul de log și setările de injectare a contextului.
Consultați Ghidul de Configurare pentru toate setările disponibile și exemple.
Dezvoltare
Consultați Ghidul de Dezvoltare pentru instrucțiuni de construire, testare și flux de contribuție.
Depanare
Dacă întâmpinați probleme, descrieți problema lui Claude și abilitatea troubleshoot va diagnostica automat și va furniza soluții.
Consultați Ghidul de Depanare pentru probleme comune și soluții.
Rapoarte de Bug-uri
Creați rapoarte comprehensive de bug-uri cu generatorul automat:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Contribuție
Contribuțiile sunt binevenite! Vă rugăm:
- Faceți fork la repository
- Creați o ramură de funcție
- Faceți modificările cu teste
- Actualizați documentația
- Trimiteți un Pull Request
Consultați Ghidul de Dezvoltare pentru fluxul de contribuție.
License
This project is licensed under the Apache License 2.0 (Apache-2.0).
Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved.
See the LICENSE file for full details.
Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms.
Ragtime note: The ragtime/ directory is licensed under the Apache License 2.0. See ragtime/LICENSE for details.
Suport
- Documentație: docs/
- Probleme: GitHub Issues
- Repository: github.com/thedotmack/claude-mem
- Autor: Alex Newman (@thedotmack)
Construit cu Claude Agent SDK | Alimentat de Claude Code | Realizat cu TypeScript