@cachly-dev/mcp-server 0.10.65 → 0.10.67

package/VISION_10X.md

@@ -1,133 +0,0 @@
-# cachly-mcp — Wie wir 10x schärfer werden
-
-> Dieses Dokument baut auf [STRATEGY.md](./STRATEGY.md) (der ehrlichen
-> Standortbestimmung) auf und übersetzt sie in **konkrete, schärfende Hebel**.
-> STRATEGY.md sagt *warum* und *in welcher Reihenfolge*. Hier steht *wie genau* —
-> und welche zehn Wetten den größten Unterschied machen.
->
-> **Leitsatz (unverändert):** Erst stabil & reibungslos → dann beweisbar schlauer
-> → dann team-weit uneinholbar → immer modell-neutral.
-
----
-
-## 0. Der eine Satz
-
-> **Anthropic gibt jedem Claude ein Gedächtnis. Wir geben jedem _Team_ ein
-> gemeinsames, geprüftes, modell-neutrales Gehirn — und beweisen mit einer Zahl,
-> dass es den richtigen Rat schneller findet.**
-
-Alles unten dient diesem einen Satz. Was ihn nicht schärft, ist Ablenkung.
-
----
-
-## 1. Die Asymmetrie, die wir ausnutzen
-
-Anthropic kann strukturell **nicht**:
-1. **Team-weit teilen** ohne das Per-User-Lock-in zu untergraben.
-2. **Modell-neutral** sein — Memory in Anthropics Filesystem ist an Claude gebunden.
-3. **Governance** liefern (Reviews, Rollen, Audit, DSGVO-Löschung im Kunden-VPC).
-4. **Strukturiert kausal** denken statt flache Files linear zu lesen.
-
-Jeder dieser vier Punkte ist bereits in cachly angelegt (CKG, `team_confirm`,
-Visibility, Self-Hosting-Pfad). Die 10x-Arbeit ist **Tiefe, nicht Breite**.
-
----
-
-## 2. Die zehn schärfenden Wetten (priorisiert)
-
-### Wette 1 — Der unabhängige Beweis (höchste Priorität)
-**Problem:** Unser Hauptargument ("strukturiert > flat files") ist intern bewiesen
-(+22.2 % P@1), aber auf eigenem Korpus. Skeptiker glauben das nicht.
-**10x-Hebel:**
-- Externen, von Dritten gelabelten Korpus aus realen Agent-Traces bauen.
-- **Head-to-head** gegen Anthropics Memory-Tool (flat files) auf *denselben* Tasks.
-- Eine reproduzierbare Zahl, die jeder selbst nachfahren kann: `npx cachly bench --vs-flatfile`.
-**Erfolg sieht so aus:** "In 100 echten Debugging-Sessions fand cachly die hilfreiche
-Lesson 2.3x öfter im Top-1 als ein flat-file-Memory." — zitierbar, verteidigbar.
-
-### Wette 2 — Time-to-first-recall < 60 s
-**Problem:** Jede Onboarding-Stufe ist ein Drop-off. First-party hat 0 Setup.
-**10x-Hebel:** `npx @cachly-dev/init` — auto-provision + device-flow + MCP-config-write
-+ erster `brain_from_git`-Seed, idempotent, mit sichtbarem Fortschritt, <60 s.
-**Metrik:** vom `npx`-Befehl bis zum ersten wertvollen Recall. Ziel: <2 min, dann <60 s.
-
-### Wette 3 — Wert sichtbar machen (jede Session)
-**Problem:** Anthropic-Memory ist unsichtbar-bequem; unseres war sichtbar-umständlich.
-**10x-Hebel:** Das "Brain saved you ~Xm here"-Banner (bereits live) wird zur
-**laufenden Bilanz**: pro Woche/Monat aggregierte Zeitersparnis, geteilte
-Team-Reuse-Momente ("Bob's Lesson hat dir gerade 40 min erspart").
-**Erfolg:** Der User *fühlt* den Wert, bevor er über Kündigung nachdenkt.
-
-### Wette 4 — Personalisiertes, wer-was-wo-gewichtetes Recall
-**Problem:** Recall ignoriert heute, *wer* fragt und *woran* gerade gearbeitet wird.
-**10x-Hebel:** Die Phase-3-Graphen (Person/File/Konzept) ins Ranking ziehen:
-- Lessons aus dem aktuellen File-Kontext höher.
-- Lessons von Personen mit hoher Domain-Confidence höher.
-- "Du arbeitest an `payments/`, Carol hat hier 3x erfolgreich gefixt" — proaktiv.
-
-### Wette 5 — Kollaborations-Graph (Personen ↔ Personen)
-**Problem:** Wir kennen Person→Konzept und Person→File, aber nicht Person↔Person.
-**10x-Hebel:** Kanten zwischen Menschen, die an denselben Dateien/Konzepten arbeiten
-→ "Frag X *und* Y, die haben das zusammen gelöst." Onboarding-Gold, Bus-Faktor-Schutz.
-
-### Wette 6 — Rollen & Team-Scopes (Enterprise-Eintrittskarte)
-**Problem:** Heute nur lesson-level `private`. Enterprises brauchen Rollen.
-**10x-Hebel:** admin / reviewer / contributor / viewer; Scopes auf Team-Ebene;
-nur reviewer dürfen `team_confirm`. Macht den Self-Hosted-Tier verkaufbar.
-
-### Wette 7 — Stabilität auf First-Party-Niveau
-**Problem:** Gegen ein eingebautes Feature ist Vertrauen asymmetrisch — ein Crash kostet mehr.
-**10x-Hebel:** Circuit-Breaker + Timeouts überall (✅ erste Guards in 0.10.62);
-jede Tool-Antwort hat einen Vertragstest (405 Tests, weiter ausbauen);
-Graceful Degradation: Tool blockiert **nie** den Agent-Call.
-
-### Wette 8 — "Dreaming"-Konter: Team-Crystallize
-**Problem:** Anthropics "Dreaming" extrahiert Muster pro User — bedroht unser Crystallize.
-**10x-Hebel:** Wir crystallizen **team-weit** und **kausal**: nicht nur "was passierte",
-sondern "welche Fixes haben strukturell ähnliche Probleme über *mehrere Personen* gelöst".
-Das kann ein per-User-Background-Prozess nicht.
-
-### Wette 9 — Modell-Neutralität als Feature, nicht Fußnote
-**Hebel:** "Bring your own model, keep your brain." First-class über jeden MCP-Client.
-Ein sichtbarer Beweis: dasselbe Brain in Claude *und* einem anderen MCP-Client live zeigen.
-
-### Wette 10 — Teilbare Domänen-Brains (Ökosystem/Virality)
-**Hebel:** Kuratierte öffentliche Brains ("Kubernetes-Incident-Brain",
-"React-Best-Practices-Brain") als Marktplatz. Je mehr Org-Wissen, desto höher die
-Wechselkosten *weg* von cachly — aber **null** Lock-in beim Modell.
-
----
-
-## 3. Was 10x **nicht** ist (Anti-Roadmap)
-
-- ❌ Mehr Tools stapeln. Wir sind bei 100 — **Tiefe vor Breite**.
-- ❌ Anthropics Single-User-Memory feature-für-feature schlagen. Das verlieren wir.
-- ❌ Modell-Lock-in aufbauen. Das ist unser einziger glaubwürdiger Vorteil.
-- ❌ Beweis durch Marketing ersetzen. Ohne Zahl keine Story.
-
----
-
-## 4. Wie wir Fortschritt messen
-
-| Hebel | Leitmetrik | Schwelle für "10x erreicht" |
-|---|---|---|
-| Beweis (W1) | Recall-Lift vs. flat-file auf externem Korpus | reproduzierbar, Dritte bestätigen |
-| Onboarding (W2) | Time-to-first-recall | <60 s im Median |
-| Wertsichtbarkeit (W3) | Wöchentlich angezeigte Zeitersparnis | User nennt sie unaufgefordert |
-| Team-Reuse (W4/W5) | Recalls einer Lesson durch *andere* Person | >30 % der wertvollen Recalls |
-| Stabilität (W7) | Tool-Fehlerquote, die den Agent-Call bricht | ~0 |
-
----
-
-## 5. Die Reihenfolge (nicht verhandelbar)
-
-```
-1. STABIL & REIBUNGSLOS   → W2, W7        (sonst ist alles wertlos)
-2. BEWEISBAR SCHLAUER      → W1, W3, W4    (jetzt verdienen wir den Wettbewerb)
-3. TEAM-WEIT UNEINHOLBAR   → W5, W6, W8, W10 (hier ist Anthropic strukturell raus)
-4. NEUTRALER LAYER         → W9            (die Positionierung, die nie veraltet)
-```
-
-> Wir gewinnen nicht, indem wir Anthropic kopieren. Wir gewinnen, indem wir das
-> werden, was Anthropic strukturell **nicht sein darf**: der neutrale, team-weite,
-> beweisbar-bessere Wissens-Layer über allen Modellen.

package/apps/travel-chaos-organizer/.env.example

@@ -1,49 +0,0 @@
-# Travel Chaos Organizer — Environment Variables
-# Copy to .env and fill in your values
-
-# App
-DEBUG=false
-UPLOAD_DIR=/data/uploads
-
-# Database (overridden by docker-compose for containerized runs)
-DATABASE_URL=postgresql+asyncpg://tco:tco@localhost:5432/tco
-
-# Keycloak
-KEYCLOAK_URL=http://localhost:8080
-KEYCLOAK_REALM=travel-chaos
-KEYCLOAK_CLIENT_ID=tco-backend
-
-# Ollama — point to your self-hosted instance
-OLLAMA_URL=http://your-server:11434
-OLLAMA_MODEL=llama3.2-vision
-OLLAMA_TIMEOUT=120
-
-# Cachly Redis — caches Ollama parse results to avoid duplicate AI calls.
-# docker-compose sets this automatically (local Redis).
-# In production, replace with your Cachly instance URL:
-#   cachly.dev → Instances → Connection String
-# Same document uploaded twice? Instant response from cache, no second AI call.
-CACHLY_REDIS_URL=redis://localhost:6379/0
-# CACHLY_REDIS_URL=redis://:<password>@<host>.cachly.dev:6380/0
-
-# Telegram Notifier (optional) — get token from @BotFather
-# TELEGRAM_BOT_TOKEN=...
-# TCO_TELEGRAM_CHAT_ID=...   # chat or channel ID for TCO events
-
-# Email — Resend (optional, https://resend.com)
-# RESEND_API_KEY=re_...
-# RESEND_FROM=noreply@yourdomain.com
-
-# Admin dashboard (change before going live!)
-ADMIN_USER=admin
-ADMIN_PASSWORD=changeme
-
-# CORS — comma-separated origins, or * for all
-CORS_ORIGINS=*
-
-# Stripe
-# STRIPE_SECRET_KEY=sk_live_...
-# STRIPE_WEBHOOK_SECRET=whsec_...
-# STRIPE_PRO_PRICE_ID=price_...
-STRIPE_SUCCESS_URL=https://YOUR_DOMAIN/upgrade/success
-STRIPE_CANCEL_URL=https://YOUR_DOMAIN/upgrade/cancel

package/apps/travel-chaos-organizer/DEPLOY.md

@@ -1,328 +0,0 @@
-# Travel Chaos Organizer — Deployment & Test Checklist
-
-> Hand this file to any agent or developer to get the app running end-to-end.
-> Everything below assumes a fresh Ubuntu 22.04 VPS and an Android phone for testing.
-
----
-
-## Prerequisites
-
-| What | Where to get |
-|------|-------------|
-| VPS (min. 2 GB RAM) | Hetzner / DigitalOcean / any Ubuntu 22.04 |
-| Domain pointing to VPS | Your DNS provider → A record → VPS IP |
-| Stripe account | stripe.com — get secret key + webhook secret + price ID |
-| Resend account | resend.com — get API key, verify sender domain |
-| Telegram bot (optional) | @BotFather → create bot → get token + chat ID |
-| Expo account | expo.dev — needed for EAS builds |
-| Android phone | Expo Go from Play Store for quick testing |
-
----
-
-## Step 1 — Server Setup (run once)
-
-```bash
-# On the VPS as root:
-curl -o server-setup.sh https://raw.githubusercontent.com/cachly-dev/cachly-mcp/claude/plan-mvp-project-1ORlN/apps/travel-chaos-organizer/scripts/server-setup.sh
-chmod +x server-setup.sh
-bash server-setup.sh
-# → installs Docker, UFW, creates tco user, sets up backup cron
-```
-
----
-
-## Step 2 — Configure Environment
-
-```bash
-# As the tco user on the VPS:
-git clone https://github.com/cachly-dev/cachly-mcp.git /home/tco/app
-cd /home/tco/app/apps/travel-chaos-organizer
-bash scripts/configure-env.sh
-```
-
-**The script asks for these values — have them ready:**
-
-### Backend `.env` (created at `apps/travel-chaos-organizer/.env`)
-
-| Variable | Value / Where to find |
-|----------|-----------------------|
-| `DATABASE_URL` | `postgresql+asyncpg://tco:YOURPASSWORD@postgres:5432/tco` |
-| `KEYCLOAK_URL` | `https://auth.YOURDOMAIN.com` |
-| `KEYCLOAK_REALM` | `tco` |
-| `KEYCLOAK_CLIENT_ID` | `tco-app` |
-| `OLLAMA_URL` | `http://ollama:11434` |
-| `OLLAMA_MODEL` | `llama3.2-vision` |
-| `STRIPE_SECRET_KEY` | Stripe Dashboard → Developers → API keys |
-| `STRIPE_WEBHOOK_SECRET` | Stripe Dashboard → Webhooks → signing secret |
-| `STRIPE_PRO_PRICE_ID` | Stripe Dashboard → Products → your Pro price ID |
-| `RESEND_API_KEY` | Resend Dashboard → API Keys |
-| `RESEND_FROM` | `TCO <noreply@YOURDOMAIN.com>` |
-| `ADMIN_USER` | choose a username (not "admin") |
-| `ADMIN_PASSWORD` | strong password (min 20 chars) |
-| `TELEGRAM_BOT_TOKEN` | @BotFather → your bot token (optional) |
-| `TCO_TELEGRAM_CHAT_ID` | your personal/group chat ID (optional) |
-| `SENTRY_DSN` | sentry.io → project → DSN (optional) |
-| `CORS_ORIGINS` | `https://YOURDOMAIN.com` (lock down in production) |
-| `SECRET_KEY` | run: `openssl rand -hex 32` |
-| `APP_URL` | `https://YOURDOMAIN.com` |
-
-### Frontend `.env.production` (created at `apps/travel-chaos-organizer/frontend/.env.production`)
-
-| Variable | Value |
-|----------|-------|
-| `EXPO_PUBLIC_API_URL` | `https://YOURDOMAIN.com` |
-| `EXPO_PUBLIC_KEYCLOAK_URL` | `https://auth.YOURDOMAIN.com` |
-| `EXPO_PUBLIC_KEYCLOAK_REALM` | `tco` |
-| `EXPO_PUBLIC_KEYCLOAK_CLIENT_ID` | `tco-app` |
-| `EXPO_PUBLIC_UPGRADE_URL` | `https://YOURDOMAIN.com/upgrade` (or Stripe payment link) |
-| `EXPO_PUBLIC_PRIVACY_URL` | `https://YOURDOMAIN.com/privacy` |
-| `EXPO_PUBLIC_TERMS_URL` | `https://YOURDOMAIN.com/terms` |
-| `EXPO_PUBLIC_SUPPORT_EMAIL` | `support@YOURDOMAIN.com` |
-| `EXPO_PUBLIC_SENTRY_DSN` | same Sentry DSN as backend (optional) |
-
----
-
-## Step 3 — Deploy Backend
-
-```bash
-cd /home/tco/app/apps/travel-chaos-organizer
-bash scripts/deploy.sh
-# → pulls images, builds, starts containers, runs Alembic migrations
-```
-
-**Verify it's running:**
-```bash
-bash scripts/health-check.sh
-# Should print: ✓ API healthy, ✓ Keycloak reachable
-```
-
----
-
-## Step 4 — Pull Ollama Model
-
-```bash
-# On the VPS (this downloads ~2GB, takes a few minutes):
-docker exec tco-ollama ollama pull llama3.2-vision
-
-# Verify:
-docker exec tco-ollama ollama list
-# Should show: llama3.2-vision
-```
-
----
-
-## Step 5 — Configure Keycloak
-
-```bash
-# Open in browser:
-https://auth.YOURDOMAIN.com/admin
-
-# Login with: admin / (password set during server-setup.sh)
-```
-
-1. **Import realm**: Realm Settings → Import → upload `keycloak/realm-export.json`
-2. **Set SMTP** (for password reset emails):
-   - Realm Settings → Email → configure with your SMTP provider
-3. **Create first user** (optional — users can self-register):
-   - Users → Add user → set email + temp password
-4. **Verify redirect URIs**: Clients → tco-app → Settings → Valid redirect URIs should include:
-   - `tco://*`
-   - `exp://*`
-   - `https://auth.expo.io/@YOUR_EXPO_USERNAME/tco`
-
----
-
-## Step 6 — Configure Stripe Webhook
-
-1. Go to Stripe Dashboard → Developers → Webhooks
-2. Click "Add endpoint"
-3. Endpoint URL: `https://YOURDOMAIN.com/api/v1/payments/webhook`
-4. Events to listen for:
-   - `checkout.session.completed`
-   - `customer.subscription.deleted`
-   - `customer.subscription.paused`
-   - `invoice.payment_succeeded`
-   - `invoice.payment_failed`
-5. Copy the signing secret → put in `STRIPE_WEBHOOK_SECRET` env var
-6. Re-run `bash scripts/deploy.sh` to apply the new env var
-
----
-
-## Step 7 — Generate App Icons (local, on your machine)
-
-```bash
-# On your local machine in the repo:
-cd apps/travel-chaos-organizer/frontend
-npm install -g sharp-cli
-node ../../scripts/generate-icons.js
-# → creates icon.png, adaptive-icon.png, splash.png, favicon.png in assets/
-```
-
-> If sharp-cli fails: open `assets/icon.svg` in a browser, screenshot at 1024×1024, save as `assets/icon.png`. Repeat for splash at 1284×2778.
-
----
-
-## Step 8 — Test on Android with Expo Go (quickest)
-
-```bash
-# On your local machine:
-cd apps/travel-chaos-organizer/frontend
-cp .env.production .env.local   # use production config
-npx expo start --tunnel         # --tunnel makes it reachable over internet
-```
-
-1. Install **Expo Go** from Play Store on your Android phone
-2. Scan the QR code shown in the terminal
-3. App opens on your phone with live reload
-
-**Test these flows in order:**
-- [ ] Onboarding slides swipe correctly, "Start" navigates to login
-- [ ] Login via Keycloak opens browser, redirects back to app
-- [ ] `/api/v1/users/me` returns plan (check Network tab or backend logs)
-- [ ] Create a trip → check it appears in list
-- [ ] Upload a PDF/screenshot → Ollama parses it → item appears in timeline
-- [ ] Parse success triggers confetti ✨
-- [ ] Trip countdown shows correct days
-- [ ] Score ring updates after adding flight/hotel items
-- [ ] Tap "↗" share button → share sheet opens with formatted text
-- [ ] Inbox shows parsed items without trip_id
-- [ ] Assign inbox item to trip
-- [ ] Go offline (airplane mode) → create trip → back online → syncs
-- [ ] Settings → Plan shows Free/Pro correctly
-
----
-
-## Step 9 — Build Production APK with EAS
-
-```bash
-# On your local machine (one-time setup):
-npm install -g eas-cli
-eas login   # with your Expo account
-
-cd apps/travel-chaos-organizer/frontend
-
-# Preview build (sideloadable APK, no Play Store needed):
-eas build --profile preview --platform android
-# → ~10-15 min build time on EAS servers
-# → get download link by email + in Expo dashboard
-```
-
-**Install on phone:**
-1. Open the download link on your Android phone
-2. Tap Install (allow "Install unknown apps" for your browser)
-3. Done — this is the real app, no Expo Go needed
-
----
-
-## Step 10 — Smoke Test Production
-
-```bash
-bash scripts/smoke-test.sh
-# Tests: health, waitlist signup, event tracking, admin auth
-```
-
-```bash
-bash scripts/verify-tracking.sh
-# Checks: Sentry DSN, Telegram bot, Resend API, Stripe, Ollama, Cachly Redis
-```
-
----
-
-## Admin Dashboard
-
-```
-https://YOURDOMAIN.com/admin
-Username: (ADMIN_USER from .env)
-Password: (ADMIN_PASSWORD from .env)
-```
-
-Features:
-- See all users + their plan status
-- Manually upgrade/downgrade a user's plan
-- View telemetry events
-- View waitlist signups
-- Trigger drip email sequence (dry run first!)
-
----
-
-## Drip Emails
-
-```bash
-# Dry run first — see what would be sent:
-make drip-dry
-# or: curl -X POST https://YOURDOMAIN.com/admin/drip/run?dry_run=true -u admin:password
-
-# Actually send:
-make drip-run
-```
-
-Set up a cron job on the VPS to run daily:
-```bash
-# As tco user — add to crontab:
-0 9 * * * curl -s -X POST https://YOURDOMAIN.com/admin/drip/run -u ADMIN_USER:ADMIN_PASSWORD
-```
-
----
-
-## Backups
-
-```bash
-# Manual backup:
-bash scripts/backup.sh
-# → creates timestamped pg_dump in backups/
-
-# Docker backup profile (scheduled):
-docker compose --profile backup run backup
-```
-
-Backups are kept for 30 days, stored in `backups/` on the VPS.
-
----
-
-## Monitoring
-
-| What | Where |
-|------|-------|
-| App errors (mobile) | Sentry → your project |
-| Backend errors | `docker compose logs backend -f` |
-| Stripe payments | Stripe Dashboard → Events |
-| New users / signups | Telegram bot notifications |
-| Admin overview | `https://YOURDOMAIN.com/admin` |
-
----
-
-## Common Issues
-
-**Parse fails / Ollama error**
-```bash
-docker exec tco-ollama ollama list          # is model downloaded?
-docker logs tco-ollama --tail 50            # any errors?
-curl http://localhost:11434/api/tags        # is Ollama responding?
-```
-
-**Login fails / Keycloak error**
-```bash
-docker logs tco-keycloak --tail 50
-# Check redirect URIs in Keycloak client config
-# Check EXPO_PUBLIC_KEYCLOAK_URL matches exactly (no trailing slash)
-```
-
-**Stripe webhook returns 400**
-```bash
-docker logs tco-backend --tail 50
-# Check STRIPE_WEBHOOK_SECRET is the signing secret (not the API key)
-# In Stripe Dashboard: Webhooks → your endpoint → "Signing secret" (not "Secret key")
-```
-
-**Push notifications not arriving**
-- Expo Go: notifications don't work in Expo Go — use EAS Preview build
-- Check device has notifications enabled for the app
-- event_at must be in the future for reminders to schedule
-
----
-
-## Branch
-
-All code is on: `claude/plan-mvp-project-1ORlN`
-
-Merge to `main` when ready to ship.

package/apps/travel-chaos-organizer/Makefile

@@ -1,57 +0,0 @@
-.PHONY: up down build logs ps health smoke migrate migrate-history backup deploy setup-env drip-dry drip-run shell-backend shell-db restart-backend caddy-reload
-
-up:
-	docker compose up -d
-
-down:
-	docker compose down
-
-build:
-	docker compose build
-
-logs:
-	docker compose logs -f --tail=100
-
-ps:
-	docker compose ps
-
-health:
-	bash scripts/health-check.sh
-
-smoke:
-	bash scripts/smoke-test.sh
-
-migrate:
-	docker compose exec backend alembic upgrade head
-
-migrate-history:
-	docker compose exec backend alembic history
-
-backup:
-	docker compose --profile backup run --rm backup
-
-deploy:
-	bash scripts/deploy.sh
-
-setup-env:
-	bash scripts/configure-env.sh
-
-drip-dry:
-	curl -s -u "$$(grep ADMIN_USER .env | cut -d= -f2):$$(grep ADMIN_PASSWORD .env | cut -d= -f2)" \
-	  -X POST "http://localhost:8000/admin/drip/run?dry_run=true" | python3 -m json.tool
-
-drip-run:
-	curl -s -u "$$(grep ADMIN_USER .env | cut -d= -f2):$$(grep ADMIN_PASSWORD .env | cut -d= -f2)" \
-	  -X POST "http://localhost:8000/admin/drip/run" | python3 -m json.tool
-
-shell-backend:
-	docker compose exec backend bash
-
-shell-db:
-	docker compose exec postgres psql -U tco -d tco
-
-restart-backend:
-	docker compose restart backend
-
-caddy-reload:
-	docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile