@cachly-dev/mcp-server 0.10.65 → 0.10.67

package/LAUNCH_TEXTS.md

@@ -1,182 +0,0 @@
-# Launch Texts — cachly AI Brain
-
----
-
-## Product Hunt
-
-### Tagline (60 chars max)
-Persistent memory + causal AI for Claude, Cursor & Copilot
-
-### Description (260 chars)
-Your AI forgets everything between sessions. cachly fixes that permanently. One command sets it up: detects your editors, writes all configs, bootstraps lessons from your git history. Free forever. No credentials required.
-
-### Full Description
-
-**The problem:** Every morning you re-explain your architecture to your AI. Every bug gets re-researched. Every fix gets re-discovered. The average developer wastes 45 minutes/day on this.
-
-**The fix:** `npx @cachly-dev/mcp-server@latest setup`
-
-One command. It signs you in (one browser click), detects every editor you have (Claude Code, Cursor, Windsurf, VS Code, Copilot, Cline, Zed), writes the correct config for each, bootstraps your Brain from your git history, and installs a git hook that learns from every future commit automatically.
-
-**What your AI gets:**
-- A briefing at every session start: last session, open failures, relevant past fixes
-- Causal root cause analysis: `causal_trace("auth breaks after restart")` → Root cause → Chain → Exact fix from 3 months ago with the command that worked
-- Failure prediction before it happens: `brain_predict` reads your history before every deploy
-- A running "time saved" counter — so you can see the ROI
-
-**What makes it different from mem0, MemGPT, etc.:**
-The `causal_trace` tool. No other memory system builds a Causal Knowledge Graph. Most systems store facts. cachly stores WHY things broke and HOW they were fixed — with the full chain of cause and effect. 30 minutes of git blame in one call.
-
-**Free forever:** 25 MB, German servers, GDPR-compliant, no credit card.
-
-### First Comment (post immediately after launch)
-Hey PH! 👋
-
-I built cachly after watching my AI re-research the same deployment bug for the third time in a month. It had no memory. I did.
-
-The thing I'm most proud of: `causal_trace`. You describe a problem in plain English, and it walks your Brain's Causal Knowledge Graph to find: the root cause, the intermediate failure chain, and the exact fix that worked last time — including the date and the command. Nothing else does this.
-
-5000+ developers are already using the npm package. Would love your feedback on what's missing.
-
-**Commands to try after setup:**
-- `causal_trace(problem="[your last bug]")` — see if it already knows the answer
-- `brain_predict(context="about to deploy")` — what will go wrong?
-- `brain_doctor` — Brain health check
-
----
-
-## Hacker News — Show HN
-
-**Title:**
-Show HN: cachly – causal memory for AI coding assistants (MCP server, free)
-
-**Text:**
-I built cachly after noticing that my AI re-researched the same bug three times in a month. The context window empties, the memory vanishes.
-
-cachly is an MCP server that gives Claude Code, Cursor, Copilot, and Windsurf persistent memory with one command:
-
-  npx @cachly-dev/mcp-server@latest setup
-
-It detects your editors, writes all the MCP configs, bootstraps from your git history, and installs a git hook that learns from every future commit. No credentials needed in any config file — OAuth Device Flow handles auth inline on the first tool call.
-
-The part I think is technically interesting: `causal_trace`. Instead of just storing facts like most memory systems, cachly builds a Causal Knowledge Graph — typed edges: `fixes`, `requires`, `co-occurs`, `causes`, `contradicts`. When you describe a problem, it walks the graph to reconstruct the failure chain and surface the exact fix.
-
-  causal_trace(problem="auth breaks after restart")
-  → Root: k8s:namespace-terminating
-  → Via:  keycloak:jwks-race
-  → Fix:  PollUntilContextTimeout 3min ← worked March 12
-
-Sessions start and end automatically (no manual session_start/session_end). Everything runs in the background.
-
-Free tier: 25 MB, German servers, GDPR. Apache-2.0.
-
-GitHub: https://github.com/cachly-dev/cachly-mcp
-npm: https://www.npmjs.com/package/@cachly-dev/mcp-server
-
-Happy to answer questions about the architecture.
-
----
-
-## Reddit — r/ClaudeAI
-
-**Title:**
-I built persistent memory for Claude Code — no credentials, no config, one command
-
-**Text:**
-After the 10th time explaining my project architecture to Claude, I built cachly.
-
-**What it does:**
-Run `npx @cachly-dev/mcp-server@latest setup` once. It:
-1. Signs you in with one browser click (no credentials in config)
-2. Detects Claude Code, Cursor, Windsurf, VS Code, Cline — writes all configs automatically
-3. Bootstraps your Brain from your git history right away
-4. Installs a git hook so every future commit feeds the brain automatically
-
-From that point, your AI arrives pre-briefed every session. No `session_start` needed — it's automatic.
-
-**The feature I'm most excited about:**
-`causal_trace("auth breaks after restart")` — it doesn't just search for similar lessons, it walks a Causal Knowledge Graph to reconstruct the failure chain and return the exact fix you used before, with commands and file paths.
-
-**Free forever** — 25 MB, German servers, GDPR, no credit card.
-
-GitHub: https://github.com/cachly-dev/cachly-mcp
-
-Would love feedback from this community — what memory features would you most want?
-
----
-
-## Reddit — r/LocalLLaMA
-
-**Title:**
-MCP server that learns from your git history automatically — causal memory for AI coding
-
-**Text:**
-Built this for the problem of AI context loss between sessions. Technical highlights:
-
-- **Causal Knowledge Graph (CKG):** Typed edges (fixes, requires, co-occurs, causes, contradicts). `causal_trace` walks the graph instead of just doing text similarity.
-- **Continuous Learning Stream:** git post-commit hook + GitHub Actions step. Every commit → lessons extracted automatically. Zero `session_end` calls needed.
-- **brain_predict:** Before deploys, reads your CKG for patterns that match past failures and returns probability-weighted warnings.
-- **Memory Crystals:** Compresses 30-50 sessions into a dense snapshot injected at every session start.
-- **11-language BM25+ search:** EN, DE, FR, ES, IT, PT, ZH, JA, KO, AR, HE — cross-lingual retrieval (e.g. `smart_recall("deploy")` finds デプロイ, 部署, 배포).
-
-Works with any MCP host: Claude Code, Cursor, Windsurf, VS Code, Cline, Zed, Continue.dev.
-
-Free tier: 25 MB. Apache-2.0. German servers.
-
-GitHub: https://github.com/cachly-dev/cachly-mcp
-
----
-
-## Twitter/X Thread
-
-**Tweet 1:**
-Your AI forgets everything between sessions.
-I built the fix.
-
-`npx @cachly-dev/mcp-server@latest setup`
-
-One command → persistent AI memory across Claude, Cursor, Copilot, Windsurf.
-Free forever. 🧵
-
-**Tweet 2:**
-The part that took the longest to build: `causal_trace`
-
-You type: "auth breaks after restart"
-
-It returns:
-→ Root: k8s:namespace-terminating
-→ Via: keycloak:jwks-race
-→ Fix: PollUntilContextTimeout 3min ← you used this March 12, it worked
-
-30 minutes of git blame. One call.
-
-**Tweet 3:**
-How setup works:
-1. Run the command
-2. Browser opens → one click sign-in (no password)
-3. It detects every editor you have
-4. Writes MCP config for each automatically
-5. Bootstraps Brain from your git history
-6. Installs git hook for automatic future learning
-
-Restart editor. Done.
-
-**Tweet 4:**
-What your AI sees every morning:
-
-🧠 Session Briefing
-⏱️ Brain saved you ~4h 30m total
-✅ api:auth — Bearer in header, not cookie
-✅ docker:build — ARG changes bust cache
-⚠️ k8s:deploy — namespace terminating race condition
-
-🤝 Your team has 3 new lessons since yesterday
-
-**Tweet 5:**
-Free tier: 25 MB, German servers, GDPR-compliant, no credit card.
-Open source: Apache-2.0
-
-GitHub: github.com/cachly-dev/cachly-mcp
-npm: @cachly-dev/mcp-server
-
-If this saves you time, a ⭐ means a lot.

package/PROGRESS.md

@@ -1,141 +0,0 @@
-# cachly-mcp — Progress Tracker
-
-> Lebendiges Dokument. Hält fest **was implementiert ist** und **was offen steht**.
-> Komplementär zu [STRATEGY.md](./STRATEGY.md) (das *Warum*) und
-> [VISION_10X.md](./VISION_10X.md) (das *Wohin*).
->
-> **Stand:** v0.10.65 · 101 MCP-Tools · 425 Tests grün · 0 Lint-Warnings
-
----
-
-## 0. Schnellüberblick
-
-| Dimension | Status |
-|---|---|
-| Version | `0.10.65` (npm `latest`) |
-| MCP-Tools | **101** |
-| Tests | **425** passing, 8 Suites |
-| Lint | **0 errors, 0 warnings** |
-| Build | sauber (`tsc`, Entry `dist/src/index.js`) |
-| Bench | Precision@1 **+22.2 %**, MRR **+10.9 %**, nDCG@5 **+8.1 %** vs. BM25 |
-
----
-
-## 1. Erledigt ✅
-
-### Phase 2 — Beweisbar bessere Recall-Qualität (der Moat-Beweis)
-
-| Feature | Datei | Status |
-|---|---|---|
-| Quality-aware Reranking (5 Faktoren) | `src/rerank.ts` | ✅ live in `smart_recall` |
-| Cachly-Bench (IR-Metriken, CI-Wächter) | `src/bench/`, `src/__tests__/rerank.test.ts` | ✅ |
-| Hybrides Retrieval (BM25 + Semantik) | `src/handlers/brain.ts` | ✅ eine gerankte Liste |
-| CKG-Traversierung als 3. Signal (Layer 3) | `src/handlers/brain.ts` | ✅ 🕸️-Badge |
-| Contradiction-Resolution persistent | `cachly:contradictions:{topic}` | ✅ TTL'd, auditierbar |
-| "Brain saved you here"-Banner | `src/handlers/brain.ts` | ✅ Zeitersparnis inline |
-| Knowledge-Governance (`team_confirm`) | `src/handlers/team.ts` | ✅ 🛡️/✔️ Badges, 5. Rerank-Faktor |
-
-**5-Faktor-Rerank-Signal:** outcome × confidence × proven-ness × severity × governance
-(review-level × endorsements), geklammert auf [0.5, 2.5].
-
-### Phase 3 — Team-/Org-weiter Wissensgraph (der uneinholbare Moat)
-
-| Feature | Tool / Datei | Version | Status |
-|---|---|---|---|
-| Ambient Team-Propagation (author → team) | `learn_from_attempts` | 0.10.57 | ✅ default, nicht opt-in |
-| **Person-Nodes** im CKG | `ckgUpsertPersonNode`, `src/ckg.ts` | 0.10.59 | ✅ auto aus `author` |
-| **File-Nodes** im CKG | `ckgUpsertFileNode`, `src/ckg.ts` | 0.10.59 | ✅ auto aus `file_paths` |
-| `brain_who_knows(topic)` | `src/handlers/brain.ts` | 0.10.59 | ✅ Experten-Ranking 🥇🥈🥉 |
-| Author-Badge in `smart_recall` | `src/handlers/brain.ts` | 0.10.59 | ✅ 👤 inline |
-| `brain_file_map(file_paths)` | `src/handlers/brain.ts` | 0.10.60 | ✅ Experten + Lessons je Datei |
-| `team_expertise_map()` | `src/handlers/brain.ts` | 0.10.60 | ✅ Skills-Matrix als Tabelle |
-| **Visibility-Scopes** (`private`/`team`/`public`) | `learn_from_attempts` | 0.10.60 | ✅ private leakt nie in smart_recall |
-| `brain_from_git` → Person+File-Nodes | `src/handlers/fedbrain.ts` | 0.10.61 | ✅ Zero-Setup Graph retroaktiv |
-| `skill_gaps()` | `src/handlers/brain.ts` | 0.10.61 | ✅ 🔴/🟡/🔵 Blind-Spot-Report |
-| `brain_coverage()` | `src/handlers/brain.ts` | 0.10.61 | ✅ 0–100 Health-Score |
-
-### Stabilität & Hygiene
-
-| Thema | Status |
-|---|---|
-| Broken npm Entry-Point (0.10.50–52) | ✅ gefixt (`dist/src/index.js`) |
-| Version-Regression (52 < 56) | ✅ auf 0.10.57+ vorgezogen |
-| Lint: 70 Warnings → 0 | ✅ systematisch bereinigt |
-| Tool-Count-Konsistenz (80/89/95/96/98/100) | ✅ überall synchron |
-| Input-Guards für Phase-3-Tools | ✅ 0.10.62 (kein Crash bei leerem topic / non-array) |
-| `smart_recall` apiFetch null-guard | ✅ graceful degradation offline |
-| Scan-Timeout + Cap (`scanKeys`) überall | ✅ 0.10.63 — kein Hang bei großem Keyspace |
-| Git-Rename-Pfad-Normalisierung | ✅ 0.10.63 (`normalizeGitPath`) |
-| `withTimeout`-Utility (graceful degradation) | ✅ 0.10.63 |
-
-### Die drei Metriken — instrumentiert (0.10.64)
-
-| Metrik | Mechanismus | Status |
-|---|---|---|
-| **Time-to-first-recall** | `born_at` (erster Learn) → `first_recall_at` (erster proven Recall) | ✅ gemessen |
-| **Recall-Lift** | Cachly-Bench Headline, CI-verteidigt | ✅ +22.2 % P@1 |
-| **Team-Knowledge-Reuse** | Cross-Author-Recalls + distinct reuse-pairs | ✅ getrackt + inline sichtbar |
-| `brain_metrics()`-Tool | zeigt alle drei in einer Ansicht | ✅ 101. Tool |
-
----
-
-## 2. Offen 🔲
-
-### Beweis (Phase-2-Rest) — der Glaubwürdigkeits-Beweis
-
-- ✅ **Flat-File Head-to-Head im Bench** (0.10.65) — naiver, quality-blinder Ranker
-  als ehrlicher Stellvertreter für "LLM liest Memory-Files". Cachly gewinnt auf den
-  entscheidenden Metriken: **P@1 +10.0 %, MRR +4.4 % vs. flat-file** · CI-verteidigt.
-- ✅ BENCH.md "Limitations" offen + ehrlich (warum flat-file bei P@3/Recall@3 vorn liegt).
-- 🔲 **Extern gelabelter Korpus** statt selbstgebautem Bench-Set (Dritt-Labels)
-- 🔲 Head-to-head auf **realen Agent-Traces** (nicht nur Fixture-Korpus)
-
-### Team-Graph (Phase-3-Rest)
-
-- 🔲 **Rollen-Modell** (admin / reviewer / contributor / viewer)
-- 🔲 **Sichtbarkeits-Scopes auf Team-Ebene** (heute nur lesson-level `private`)
-- 🔲 Service-/System-Nodes im Graph (heute: Konzept, Person, File)
-- 🔲 `brain_who_knows` über CKG-Kanten *zwischen* Personen (Kollaborations-Graph)
-- 🔲 Recall, das *wer-was-wo* gewichtet (personalisiertes Ranking)
-
-### Onboarding / Null-Reibung (Phase-1-Eintrittskarte)
-
-- 🔲 `npx @cachly-dev/init` Ein-Befehl-Setup <60 s, idempotent
-- 🟡 Circuit-Breaker / Timeouts: Scan-Tools abgesichert (`scanKeys`/`withTimeout`,
-  0.10.63); verbleibende Netzwerk-Calls (apiFetch) noch nicht überall timeout-gewrappt
-- 🔲 Self-Healing-Auth (kein "0 Recalls weil RAM-only")
-- ✅ Time-to-first-recall **messen** (0.10.64); auf <2 min *drücken* bleibt Onboarding-Arbeit 🔲
-
-### Enterprise / Reichweite (Phase-3/4)
-
-- 🔲 Self-Hosted-Tier mit SOC-2/ISO, BYOK by default
-- 🔲 Öffentliche/teilbare Brains (Domänen-Wissensbasen als Marktplatz)
-- 🔲 First-class-Support-Matrix je MCP-Client dokumentiert
-
-### Bekannte kleine Schulden
-
-- ✅ `brain_from_git`: Git-Rename-Pfade normalisiert (`normalizeGitPath`, 0.10.63).
-- ✅ README Tool-Count-Drift behoben (jetzt 101, überall synchron).
-- ✅ Scan-basierte Tools gegen großen Keyspace gehärtet (`scanKeys`, 0.10.63).
-- 🔲 `team_expertise_map`: Tabellen-Rendering bei *sehr* vielen Domains noch
-  nicht mit großem Datensatz lasttestbar (MockRedis deckt Funktionalität ab).
-
----
-
-## 3. Die drei Metriken, die alles entscheiden (aus STRATEGY.md §6)
-
-| Metrik | Ziel | Heute |
-|---|---|---|
-| **Time-to-first-recall** | <2 min | ✅ gemessen via `brain_metrics` (born_at → first_recall_at) |
-| **Recall-Lift** (vs. BM25) | messbar >0, dann skalieren | ✅ +22.2 % P@1 (intern), in `brain_metrics` |
-| **Team-Knowledge-Reuse** | Lesson von A wird von B recallt | ✅ getrackt + inline + in `brain_metrics`; externes Dashboard 🔲 |
-
-> Alle drei sind jetzt in **einem Tool** sichtbar: `brain_metrics(instance_id)`.
-> Offen bleibt nur das *externe* Dashboard (server-side) und der *externe* Bench-Beweis (W1).
-
----
-
-## 4. Changelog-Verweis
-
-Vollständige Release-Notes pro Version: [CHANGELOG.md](./CHANGELOG.md).
-Letzte Releases: 0.10.59 (Phase 3A) · 0.10.60 (Phase 3B) · 0.10.61 (Phase 3C, 100 Tools) · 0.10.62 (Härtung).

package/STRATEGY.md

@@ -1,228 +0,0 @@
-# Cachly vs. Anthropic Memory — Ehrliche Standortbestimmung & 10x/100x-Roadmap
-
-> Stand: 29. Mai 2026 · Verfasst als interne, schonungslose Bestandsaufnahme.
-> Ziel: Wo stehen wir wirklich, was ist der Graben den Anthropic uns gräbt, und
-> was braucht es konkret, damit Cachly für die nächsten Jahre 10–100x besser,
-> stabiler, intelligenter und nutzerfreundlicher dasteht.
-
----
-
-## 0. TL;DR (für die Eiligen)
-
-- **Die Lücke, die wir füllen wollten, schließt Anthropic gerade selbst** — aber
-  nur für den Solo-Claude-Nutzer. Das Memory Tool, Managed-Agents-Memory,
-  Chat-Memory und "Dreaming" decken den **Single-User-, Single-Vendor-Fall**
-  zunehmend gut ab.
-- **Unser echter, verteidigbarer Graben liegt woanders**: *team-/org-weites,
-  strukturiertes, vendor- und tool-unabhängiges Wissen mit Governance.* Genau das
-  kann Anthropic strukturell **nicht** liefern, ohne ihr eigenes Lock-in-Modell zu
-  untergraben.
-- **Brutale Wahrheit**: Heute gewinnen wir diesen Graben *nicht* überzeugend.
-  Onboarding hat zu viel Reibung, die Recall-Qualität ist nicht nachweisbar besser
-  als "Claude liest seine eigenen Files", und wir hatten zuletzt zu viele Bugs für
-  ein Produkt, das gegen ein First-Party-Feature antritt.
-- **Der Weg zu 10x/100x** ist kein Feature-Wettrennen mit Anthropic. Es ist:
-  (1) **Recall-Qualität messbar überlegen machen**, (2) **Onboarding auf
-  Null-Reibung** bringen, (3) **Team-Wissensgraph zum Moat ausbauen**,
-  (4) **vendor-/tool-agnostisch** bleiben, (5) **Stabilität auf First-Party-Niveau**.
-
----
-
-## 1. Was Anthropic heute hat (der ehrliche Blick auf den Gegner)
-
-| Feature | Was es ist | Reichweite | Schwäche für uns nutzbar? |
-|---|---|---|---|
-| **Memory Tool** (`memory_20250818`) | Client-seitige Datei-Ops im `/memories`-Verzeichnis, 6 Commands (view/create/str_replace/insert/delete/rename) | Nur Anthropic-API, nur Claude-Modelle | **Ja** — unstrukturiert (flache Files), kein semantisches Retrieval, per-Agent |
-| **Managed Agents Memory** (Public Beta, Apr 2026) | Anthropic-gehostete Files, via API/Console exportierbar | Anthropic-Plattform | **Ja** — kein Team-Sharing-Modell, kein Wissensgraph |
-| **Chat Memory** (März 2026) | Auto-Destillation von Chats ~alle 24h in ein Memory-Profil | Consumer (Free/Pro/Max) | **Ja** — Consumer-only, nicht für Dev-Workflows/CI/Teams |
-| **Dreaming** (Research Preview) | Background-Prozess: Muster aus Sessions extrahieren, Memory kuratieren | Claude-intern | ⚠️ **Gefährlich** — das ist konzeptionell *unser* Crystallize/Belief-Update |
-| **Opus 4.8 Context** | 1M Token default, "infinite conversations" via Summarization, Suche über alte Chats | Claude | ⚠️ Reduziert den *Bedarf* an externem Memory für Solo-User |
-
-### Die unbequeme Erkenntnis
-Anthropics Memory ist **gratis, null Setup, first-party, und wird monatlich besser.**
-Für einen einzelnen Entwickler, der ausschließlich Claude nutzt, ist die Frage
-"Warum Cachly statt dem eingebauten Memory?" heute **nicht trivial zu beantworten.**
-
----
-
-## 2. Wo Cachly strukturell gewinnen kann (der echte Graben)
-
-Diese vier Punkte kann Anthropic nicht ohne Selbst-Sabotage angreifen:
-
-### 2.1 Vendor- & Tool-Unabhängigkeit
-- Anthropic-Memory lebt **in Anthropics Filesystem, gebunden an Claude über die
-  Anthropic-API.** Wechselst du zu GPT, Gemini, einem lokalen Modell oder nutzt
-  Cursor/Windsurf/Zed parallel — **dein Memory ist weg oder fragmentiert.**
-- Cachly spricht **MCP** → funktioniert mit *jedem* MCP-Client und ist
-  modell-agnostisch. **Dein Org-Wissen überlebt jeden Modellwechsel.**
-- *Das ist die Positionierung, die nie veraltet:* "Switzerland für AI-Memory."
-
-### 2.2 Team-/Org-weites Wissen
-- Anthropic-Memory ist **per-User / per-Agent.** Es gibt kein "Kollege A lernt
-  etwas, Kollege B profitiert beim nächsten `session_start`."
-- `team_learn` + geteilte Brain-Instanz ist **genau das** — und es ist der
-  Use-Case mit dem höchsten ökonomischen Wert (verhindert, dass 10 Entwickler
-  denselben Fehler 10x machen).
-
-### 2.3 Strukturiertes, kuratiertes Wissen statt flacher Files
-- Anthropic = Claude liest linear Textdateien.
-- Cachly = strukturierte Lessons (`topic`, `outcome`, `severity`, `tags`,
-  `depends_on`), Contradiction-Detection, Causal Knowledge Graph (CKG),
-  Belief-Update-Engine (BUE). **ABER:** dieser Vorteil ist heute *behauptet, nicht
-  bewiesen.* Siehe §3.
-
-### 2.4 Governance, Compliance, Self-Hosting
-- Self-hosted Valkey, BYOK, Audit-Trails, DSGVO-Löschung, SOC-2-Pfad.
-- Enterprises **dürfen** ihr Wissen oft nicht in Anthropics Managed Memory legen.
-  Das ist ein Verkaufsargument, das mit der Zeit *stärker* wird, nicht schwächer.
-
----
-
-## 3. Wo wir heute ehrlich schwach sind
-
-Kein Schönreden:
-
-1. **Recall-Qualität ist nicht gemessen.** Wir behaupten "strukturiert > flache
-   Files", haben aber **kein Benchmark**, das zeigt: Cachly-Recall führt zu
-   weniger Wiederholungsfehlern / besseren Antworten als das eingebaute Memory.
-   *Ohne diesen Beweis ist unser Hauptargument Marketing.*
-2. **Onboarding-Reibung.** Anthropic: 0 Setup. Cachly: Instanz provisionieren,
-   Device-Flow, MCP-Config, JWT-Persistenz, Instance-ID. Jede dieser Stufen ist
-   ein Drop-off-Punkt — und mehrere waren zuletzt **kaputt** (JWT nur im RAM,
-   Redis NOAUTH, Provisioning-Timeouts).
-3. **Stabilität.** Wir haben in den letzten Tagen viele kritische Bugs gefunden und
-   gefixt (Telemetrie-Zähler bei 0, NOAUTH, PKCE komplett kaputt, doppelte Drip-
-   Mails, Admin-Bypass). Ein Produkt, das gegen ein First-Party-Feature antritt,
-   **darf solche Bugs nicht haben.** Vertrauen ist hier asymmetrisch.
-4. **Wertnachweis fehlt dem User.** Der Nutzer sieht nicht, *dass* Cachly ihm
-   gerade einen Fehler erspart hat. Anthropics Memory ist unsichtbar-bequem;
-   unseres ist sichtbar-umständlich. Das muss sich umkehren.
-5. **"Dreaming" ist eine direkte Bedrohung** für unser Crystallize/BUE-
-   Alleinstellungsmerkmal. Wenn das Modell selbst Muster extrahiert, müssen wir
-   beim *Team-übergreifenden* und *strukturierten* Teil uneinholbar sein.
-
----
-
-## 4. Die 10x/100x-Roadmap (konkret, priorisiert)
-
-> Leitsatz: **Wir gewinnen nicht, indem wir Anthropics Memory kopieren. Wir
-> gewinnen, indem wir das werden, was Anthropic strukturell nicht sein darf:
-> der neutrale, team-weite, beweisbar-bessere Wissens-Layer über allen Modellen.**
-
-### Phase 1 — Stabilität & Null-Reibung (die Eintrittskarte) · *0–3 Monate*
-Ohne das ist alles andere wertlos.
-
-- **[10x Stabilität]** Vollständige Test-Suite für die Brain-Tools (Recall, Learn,
-  Dedup, Contradiction). Heute faktisch ungetestet. Ziel: jede Tool-Antwort hat
-  einen Vertragstest.
-- **[10x Onboarding]** "Ein-Befehl-Setup": `npx @cachly-dev/init` → Auto-Provision,
-  Device-Flow, MCP-Config-Write, erster `brain_from_git`-Seed, alles in <60s,
-  idempotent, mit klarem Fortschritt. Jeder bisherige Drop-off-Punkt eliminiert.
-- **[Reibung]** Graceful Degradation: Wenn Redis/Netz weg ist, darf das Tool
-  **nie** den ganzen Agent-Call blockieren. Timeouts + Circuit-Breaker überall.
-- **[Vertrauen]** Self-Healing-Auth: JWT/Instance-ID persistent, automatische
-  Re-Provisionierung bei verlorenem State, kein "0 Recalls weil RAM-only" mehr.
-
-### Phase 2 — Beweisbar bessere Recall-Qualität (der Moat-Beweis) · *3–9 Monate*
-Das ist der Punkt, an dem wir *verdienen*, gegen First-Party anzutreten.
-
-> **Status (begonnen):** Erste Bausteine sind live — `npm run bench`
-> (siehe [BENCH.md](./BENCH.md)) misst den Recall-Lift und ist CI-verteidigt.
-> Aktuelle Zahl: **Precision@1 +11.1 %, MRR +6.6 %, nDCG@5 +5.0 %** gegenüber
-> reinem BM25. Quality-Reranking (`src/rerank.ts`) ist in `smart_recall` verdrahtet,
-> Contradiction-Resolution wird jetzt persistiert. Nächster Schritt: größerer,
-> extern gelabelter Korpus + Head-to-head gegen ein echtes Flat-File-Memory.
-
-- **[✅ erledigt]** **Quality-aware Reranking**: proven success-Lessons ranken über
-  text-ähnlichen Fehlversuchen (`src/rerank.ts`, in `smart_recall` aktiv).
-- **[✅ erledigt]** **Cachly-Bench**: reproduzierbarer Benchmark mit IR-Metriken
-  (Precision@k, Recall@k, MRR, nDCG), als CI-Regressionswächter. Ohne Zahl keine
-  Story — jetzt gibt es eine Zahl, die jede Recall-Änderung verteidigen muss.
-- **[✅ erledigt]** **Contradiction-Resolution persistent**: Widersprüche werden in
-  `cachly:contradictions:{topic}` als auditierbarer Verlauf gespeichert (TTL'd).
-- **[✅ erledigt — 100x Intelligenz]** Hybrides Retrieval: BM25-Keyword + semantische
-  Embeddings werden in `smart_recall` zu *einer* gerankten Liste fusioniert
-  (`0.6×BM25-Qualität + 0.4×Semantik`), mit Match-Typ-Badges (🔍/🎯/🔀). CKG-
-  Traversierung als dritte Signalquelle ist der nächste Ausbau.
-- **[✅ erledigt — Wertsichtbarkeit]** "Brain saved you here"-Banner im
-  `smart_recall`-Output macht die Zeitersparnis pro proven Lesson inline sichtbar
-  (`cachly:stats:time_saved_mins` wird getrackt und jetzt auch angezeigt).
-- **[offen — Beweis]** Größerer, extern gelabelter Korpus + Head-to-head gegen ein
-  echtes Flat-File-Memory auf realen Agent-Traces (siehe BENCH.md "Limitations").
-
-### Phase 3 — Team-Wissensgraph als uneinholbarer Moat · *9–18 Monate*
-Hier ist Anthropic strukturell raus.
-
-> **Status (begonnen):** Knowledge-Governance ist live — `team_confirm` lässt
-> einen Reviewer eine Lesson bestätigen (🛡️ senior / ✔️ peer). Die Bestätigung
-> fließt direkt in das Recall-Ranking (`src/rerank.ts`, 5. Faktor) ein: bestätigtes,
-> menschlich geprüftes Wissen ranked über unreviewtem Auto-Learning. `team_recall`
-> zeigt Reviewer-Badges und sortiert bestätigte Lessons zuerst. Distinct-Endorser
-> werden in einem Set getrackt (kein Self-Inflation), mit Audit-Log pro Topic.
-
-- **[100x Team]** Org-weiter Wissensgraph: Lessons, Personen, Dateien, Services als
-  Knoten; Recall berücksichtigt *wer* was gelernt hat und *wo* es relevant ist.
-- **[Virality]** Jeder gelöste Fehler eines Entwicklers wird automatisch zur
-  Org-Lesson — mit Attribution. `team_learn` als Default, nicht als Opt-in.
-- **[✅ erledigt — Governance]** "Wissens-Reviews": ein Senior bestätigt eine Lesson
-  (`team_confirm`) → höheres Vertrauen im Recall-Ranking. Audit-Trail + distinct
-  Endorsements werden persistiert. Offen: Rollen-Modell und Sichtbarkeits-Scopes.
-- **[Enterprise]** Self-Hosted-Tier mit SOC-2/ISO, BYOK by default, Daten bleiben
-  im Kunden-VPC. Das ist der Umsatz, den Anthropic-Memory nicht abgreifen kann.
-
-### Phase 4 — Der neutrale Layer über allen Modellen · *18+ Monate*
-- **[100x Reichweite]** First-class-Support für jeden großen MCP-Client und jedes
-  Modell. Cachly = "bring your own model, keep your brain."
-- **[Ökosystem]** Öffentliche/teilbare Brains (kuratierte Domänen-Wissensbasen:
-  "React-Best-Practices-Brain", "Kubernetes-Incident-Brain"), als Marktplatz.
-- **[Moat-Vertiefung]** Je mehr Org-Wissen akkumuliert, desto höher die
-  Wechselkosten *weg* von Cachly — aber **null** Lock-in beim *Modell*. Das ist
-  die einzige gesunde Form von Lock-in.
-
----
-
-## 5. Was wir explizit NICHT tun sollten
-
-- **Nicht** versuchen, Anthropics Single-User-Memory zu schlagen. Das verlieren wir.
-  Unser Nutzer ist das **Team** und die **Org**, nicht der Solo-Hobbyist.
-- **Nicht** Feature-für-Feature mit "Dreaming" konkurrieren. Stattdessen den
-  *strukturierten, geteilten, beweisbar-besseren* Teil besitzen.
-- **Nicht** weiter Features stapeln (wir haben ~89 Tools), solange Recall-Qualität
-  und Stabilität nicht bewiesen sind. **Tiefe vor Breite.**
-- **Nicht** vendor-Lock-in beim Modell aufbauen — das ist unser einziger
-  glaubwürdiger Vorteil gegenüber First-Party.
-
----
-
-## 6. Die drei Metriken, die alles entscheiden
-
-Wenn wir nur drei Zahlen tracken dürften:
-
-1. **Time-to-first-recall** (Onboarding-Reibung): vom `npx`-Befehl bis zum ersten
-   erfolgreichen, wertvollen Recall. Ziel: <2 Minuten.
-2. **Recall-Lift** (Moat-Beweis): % weniger Wiederholungsfehler / schnellere
-   Lösung *mit* Cachly vs. ohne, gemessen über Cachly-Bench. Ziel: messbar >0,
-   dann skalieren.
-3. **Team-Knowledge-Reuse** (Virality/Moat): wie oft wird die Lesson eines
-   Entwicklers von *einem anderen* erfolgreich recallt. Das ist der Wert, den nur
-   wir liefern.
-
----
-
-## 7. Fazit (schonungslos)
-
-Anthropic hat die **Single-User-Memory-Lücke** weitgehend geschlossen. Hätten wir
-nur darauf gewettet, wären wir in Schwierigkeiten.
-
-Aber die **eigentlich wertvolle Lücke** — *team-weites, strukturiertes,
-vendor-neutrales, governance-fähiges Wissen mit beweisbarem Recall-Vorteil* — ist
-**offen, und Anthropic kann sie aus strukturellen Gründen nicht schließen.**
-
-Heute besetzen wir diese Lücke **noch nicht überzeugend**: zu viel Reibung, zu
-wenig Beweis, zu viele Bugs. Der Weg zu 10x/100x ist deshalb unspektakulär und
-unerbittlich:
-
-> **Erst stabil & reibungslos. Dann beweisbar schlauer. Dann team-weit
-> uneinholbar. Immer modell-neutral.**
-
-In dieser Reihenfolge. Nicht andersrum.