@cachly-dev/mcp-server 0.10.124 → 0.10.126

package/dist/src/handlers/instances.d.ts

@@ -4,6 +4,30 @@ type GetConnection = (instanceId: string) => Promise<Redis>;
 type ApiFetch = <T>(path: string, options?: RequestInit) => Promise<T>;
 export declare const INSTANCE_TOOL_NAMES: Set<string>;
 declare function formatInstance(inst: Instance): string;
+/**
+ * Baut eine Adresse aus einem Instanz-Datensatz.
+ *
+ * ── Warum diese Funktion NICHT mehr fuer get_connection_string benutzt wird ──
+ *
+ * Am 19.08.2026 gemessen: `get_connection_string` gab
+ * `redis://49.13.38.27:30114` zurueck — ohne Passwort. Der mitgelieferte
+ * "Quick test" (`redis-cli -u ... PING`) scheiterte sofort an NOAUTH. Ein
+ * Werkzeug, das eine Verbindungsadresse verspricht und eine liefert, die nicht
+ * verbindet.
+ *
+ * Die Funktion war nicht falsch. Sie bekam nur nie ein Passwort: sie wurde mit
+ * dem Datensatz aus /api/v1/instances/:id gefuettert, und der fuehrt kein
+ * Passwort — voellig richtig, das ist der allgemeine Instanz-Datensatz. Die
+ * Zugangsdaten stehen unter /api/v1/instances/:id/connection, und dort baut der
+ * Server die Adresse laengst fertig zusammen.
+ *
+ * Also gab es zwei Stellen, die wussten, wie eine Adresse aussieht — und nur
+ * eine hatte alles, was dazugehoert. Dieselbe Fehlerklasse wie beim Export am
+ * selben Tag: eine Frage aus einer Quelle bedient, die fuer eine andere gebaut
+ * wurde.
+ *
+ * Sie bleibt fuer die Anzeige in Listen, wo bewusst kein Passwort hingehoert.
+ */
 declare function buildConnectionString(inst: Instance): string;
 export declare function handleInstanceTool(name: string, args: Record<string, unknown>, getConnection: GetConnection, apiFetch: ApiFetch): Promise<string | null>;
 export { formatInstance, buildConnectionString };

package/dist/src/handlers/instances.js

@@ -7,6 +7,30 @@ function formatInstance(inst) {
     const mb = inst.memory_mb >= 1024 ? `${inst.memory_mb / 1024}GB` : `${inst.memory_mb}MB`;
     return `${badge} **${inst.name}** (\`${inst.id}\`) · ${inst.tier} · ${mb} · ${inst.region}`;
 }
+/**
+ * Baut eine Adresse aus einem Instanz-Datensatz.
+ *
+ * ── Warum diese Funktion NICHT mehr fuer get_connection_string benutzt wird ──
+ *
+ * Am 19.08.2026 gemessen: `get_connection_string` gab
+ * `redis://49.13.38.27:30114` zurueck — ohne Passwort. Der mitgelieferte
+ * "Quick test" (`redis-cli -u ... PING`) scheiterte sofort an NOAUTH. Ein
+ * Werkzeug, das eine Verbindungsadresse verspricht und eine liefert, die nicht
+ * verbindet.
+ *
+ * Die Funktion war nicht falsch. Sie bekam nur nie ein Passwort: sie wurde mit
+ * dem Datensatz aus /api/v1/instances/:id gefuettert, und der fuehrt kein
+ * Passwort — voellig richtig, das ist der allgemeine Instanz-Datensatz. Die
+ * Zugangsdaten stehen unter /api/v1/instances/:id/connection, und dort baut der
+ * Server die Adresse laengst fertig zusammen.
+ *
+ * Also gab es zwei Stellen, die wussten, wie eine Adresse aussieht — und nur
+ * eine hatte alles, was dazugehoert. Dieselbe Fehlerklasse wie beim Export am
+ * selben Tag: eine Frage aus einer Quelle bedient, die fuer eine andere gebaut
+ * wurde.
+ *
+ * Sie bleibt fuer die Anzeige in Listen, wo bewusst kein Passwort hingehoert.
+ */
 function buildConnectionString(inst) {
     if (!inst.host)
         return '❌ Instance not ready yet.';
@@ -56,8 +80,32 @@ export async function handleInstanceTool(name, args, getConnection, apiFetch) {
             if (inst.status !== 'running') {
                 return `Instance is not running yet (status: ${inst.status}). Provisioning takes ~30 seconds after payment.`;
             }
-            const connStr = buildConnectionString(inst);
+            // Die Adresse kommt vom Server, nicht von hier. Er hat als einziger das
+            // Passwort (verschluesselt in der Datenbank, dort entschluesselt) und
+            // baut die Zeichenkette bereits vollstaendig zusammen.
+            let conn = {};
+            let konnteNichtFragen = false;
+            try {
+                conn = await apiFetch(`/api/v1/instances/${args.instance_id}/connection`);
+            }
+            catch {
+                // Aeltere oder eingeschraenkte Server. Dann bleibt nur der allgemeine
+                // Datensatz — der fuehrt kein Passwort. Das ist kein Grund
+                // abzubrechen, aber ein Grund, es dazuzuschreiben.
+                konnteNichtFragen = true;
+            }
+            const connStr = conn.connection_string || buildConnectionString(inst);
+            // Eine Adresse ohne Passwort ist gegen ein passwortgeschuetztes Valkey
+            // nutzlos — sie scheitert mit NOAUTH, und zwar erst beim Nutzer. Deshalb
+            // steht der Hinweis hier, ueber der Adresse, nicht in einer Fussnote.
+            const ohnePasswort = !connStr.includes('@');
+            const warnung = !ohnePasswort ? [] : konnteNichtFragen
+                ? ['⚠️  Could not read the credentials endpoint — this string has NO password and will fail with NOAUTH if the instance requires one.', '']
+                : conn.password
+                    ? ['⚠️  The server returned a password but this string carries none — please report this.', '']
+                    : [];
             return [
+                ...warnung,
                 `**Connection string for ${inst.name}:**`,
                 `\`\`\``,
                 connStr,

package/dist/src/handlers/instances.js.map

@@ -1 +1 @@
-{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../../src/handlers/instances.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../../src/handlers/instances.ts"],"names":[],"mappings":"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"}

package/dist/src/handlers/team.js

@@ -1,7 +1,10 @@
 import { readFileSync } from 'node:fs';
+import { bauabdruck, formatiereBauabdruck } from '../bauabdruck.js';
+import { beurteileDeckung } from '../eingaenge.js';
 import { join } from 'node:path';
 import { calculateConfidence, CONFIDENCE_STALE_VALUE, CONFIDENCE_WARN_VALUE, CONFIDENCE_WARN_DAYS, CONFIDENCE_STALE_DAYS } from '../confidence.js';
 import { safeJsonParse } from '../utils.js';
+import { ersparteMinuten, istStarterLektion, fmtStunden } from '../wertbeitrag.js';
 import { cachlyUrl } from '../cachly-url.js';
 export const TEAM_TOOL_NAMES = new Set([
     'sync_file_changes', 'team_learn', 'team_confirm', 'team_recall', 'team_synthesize', 'memory_crystalize', 'team_crystallize',
@@ -667,6 +670,60 @@ export async function handleTeamTool(name, args, getConnection, apiFetch) {
             // Effective IQ boost: total recalls / lessons (how much the brain actually helped)
             const totalRecalls = lessons.reduce((sum, l) => sum + (l.recall_count ?? 0), 0);
             const iqBoostPct = lessons.length > 0 ? Math.min(100, Math.round((totalRecalls / lessons.length) * 10)) : 0;
+            // ── Deckung des Bedeutungsabgleichs ─────────────────────────────────
+            //
+            // Gemessen am 20.08.2026 gegen die Produktion: `cachly:lesson:vec:*` war
+            // LEER — 0 Vektoren bei 506 Lektionen. Damit lief der Bedeutungsabgleich
+            // dort nie: `brain.ts` steigt bei `vektorbestand.groesse === 0` aus und
+            // faellt auf den reinen Wortabgleich zurueck.
+            //
+            // Von aussen war dieser Zustand von "alles in Ordnung" nicht zu
+            // unterscheiden — die Suche lieferte weiter Ergebnisse, nur schlechtere.
+            // Genau das ist die Fehlerklasse "Stille wird als gruen gebucht": es gab
+            // eine Zahl fuer alles Moegliche, aber keine fuer DAS.
+            const zaehleSchluessel = async (muster) => {
+                let n = 0;
+                const st = redis.scanStream({ match: muster, count: 200 });
+                await new Promise((resolve, reject) => {
+                    st.on('data', (batch) => { n += batch.length; });
+                    st.on('end', resolve);
+                    st.on('error', reject);
+                });
+                return n;
+            };
+            const vektorZahl = await zaehleSchluessel('cachly:lesson:vec:*');
+            const namensZahl = await zaehleSchluessel('cachly:lesson:vecname:*');
+            const eingangZahl = await zaehleSchluessel('cachly:lesson:eing:*');
+            const pfadZahl = await zaehleSchluessel('cachly:lesson:pfad:*');
+            const deckung = lessonKeys.length > 0
+                ? Math.round((vektorZahl / lessonKeys.length) * 100)
+                : 100;
+            const urteil = beurteileDeckung(lessonKeys.length, vektorZahl);
+            if (lessonKeys.length > 0) {
+                if (urteil === 'aus') {
+                    issues.push('semantic search is OFF: not a single lesson has an embedding '
+                        + `(0 of ${lessonKeys.length}). Recall falls back to keyword matching only. `
+                        + 'Fix: run the backfill (sdk/mcp/src/eingaenge-nachruesten.ts).');
+                    checks.push(`🔴 **Semantic search: OFF** — 0 of ${lessonKeys.length} lessons have an embedding`);
+                }
+                else if (urteil === 'luecke') {
+                    issues.push(`only ${deckung}% of lessons have an embedding (${vektorZahl} of ${lessonKeys.length}) — `
+                        + 'the rest can never be found by meaning.');
+                    checks.push(`🟡 **Semantic coverage: ${deckung}%** — ${lessonKeys.length - vektorZahl} lessons without an embedding`);
+                }
+                else {
+                    checks.push(`✅ **Semantic coverage: ${deckung}%** — ${vektorZahl} full-text, `
+                        + `${namensZahl} topic-name, ${eingangZahl} with error-text entries`
+                        + (pfadZahl > 0 ? `, ${pfadZahl} with learned question paths` : ''));
+                    // Die Trampelpfade sind das einzige, was MIT DER NUTZUNG waechst.
+                    // Steht die Zahl auf null, obwohl schon lange gesucht wird, lernt
+                    // das Gedaechtnis nichts dazu — das ist eine eigene Auskunft.
+                    if (pfadZahl === 0 && lessonKeys.length >= 20) {
+                        checks.push('💤 **No learned question paths yet** — a question that finds the same '
+                            + 'lesson twice becomes its own entry. Needs repeated real use.');
+                    }
+                }
+            }
             // Quality score (0-100)
             let score = 50;
             if (lessonKeys.length >= 5)
@@ -688,6 +745,11 @@ export async function handleTeamTool(name, args, getConnection, apiFetch) {
                 score += 5;
             if (uniqueAuthors.size >= 2)
                 score += 5; // team collaboration bonus
+            // Ohne Einbettungen laeuft die halbe Suche nicht — das darf keine
+            // Randnotiz sein, sondern muss die Zahl druecken, die oben steht.
+            if (urteil !== 'gut')
+                score -= 20;
+            score = Math.max(0, Math.min(100, score));
             const scoreEmoji = score >= 80 ? '🟢' : score >= 50 ? '🟡' : '🔴';
             const iqEmoji = iqBoostPct >= 50 ? '🚀' : iqBoostPct >= 20 ? '📈' : '💤';
             checks.push(`${scoreEmoji} **Brain Quality Score: ${score}/100**`);
@@ -696,6 +758,7 @@ export async function handleTeamTool(name, args, getConnection, apiFetch) {
             checks.push(`💾 **Context entries:** ${ctxCount}`);
             checks.push(`🎯 **Confidence:** ${lessons.length - staleLessons.length - warnLessons.length} fresh · ${warnLessons.length} warn · ${staleLessons.length} stale`);
             checks.push(`⏱️ **Decay config:** warn after ${CONFIDENCE_WARN_DAYS}d · stale after ${CONFIDENCE_STALE_DAYS}d`);
+            checks.push(formatiereBauabdruck(bauabdruck));
             if (uniqueAuthors.size >= 2) {
                 checks.push(`👥 **Team:** ${uniqueAuthors.size} contributors (${[...uniqueAuthors].join(', ')})`);
             }
@@ -932,6 +995,42 @@ export async function handleTeamTool(name, args, getConnection, apiFetch) {
                     updates.set(lesson._key, updated);
                 }
             }
+            // ── Regel 4: Startvorrat entwerten und Zeitersparnis neu rechnen ──────
+            //
+            // ANLASS (17.08.2026): Ein Brain mit 475 Lektionen zeigte 54 Tage
+            // eingesparte Entwicklerzeit und 97.237,50 € Gegenwert. Nachgerechnet kam
+            // praktisch alles aus dem mitgelieferten Startvorrat — `docker:layer-cache`
+            // bei 973 Abrufen, `cache:stampede` bei 971, dahinter neun weitere bei je
+            // rund 208. Die echten Lektionen standen bei zwei bis fünf.
+            //
+            // Ab jetzt zählen Starter-Abrufe nicht mehr mit (wertbeitrag.ts). Das
+            // stoppt aber nur das Weiterwachsen; die aufgelaufenen Zähler bleiben und
+            // tragen die Zahl weiter. Deshalb hier zweierlei:
+            //
+            //  1. Starter-Zähler auf 0. Sie sind keine Leistung dieses Teams.
+            //  2. time_saved_mins NEU BERECHNEN statt zu korrigieren. Die alte Summe
+            //     ist nicht rekonstruierbar (sie wurde im Juli schon einmal
+            //     zurückgesetzt und geht nicht mit der Summe der Einzelzähler auf).
+            //     Etwas davon abzuziehen ergäbe eine Zahl, die genauso erfunden wäre
+            //     wie die alte — nur unauffälliger. Neu gerechnet ist sie prüfbar:
+            //     Summe über alle NICHT-Starter-Lektionen aus Abrufzahl mal Staffel.
+            let starterZurueckgesetzt = 0;
+            let minutenNeu = 0;
+            const minutenAlt = parseFloat((await redis.get(`cachly:stats:time_saved_mins:${instance_id}`)) ?? '0') || 0;
+            for (const lesson of lessons) {
+                if (istStarterLektion(lesson)) {
+                    if ((lesson.recall_count ?? 0) > 0) {
+                        starterZurueckgesetzt++;
+                        const bisher = updates.get(lesson._key) ?? lesson;
+                        updates.set(lesson._key, { ...bisher, recall_count: 0 });
+                    }
+                    continue;
+                }
+                minutenNeu += (lesson.recall_count ?? 0) * ersparteMinuten(lesson);
+            }
+            if (!dry_run) {
+                await redis.set(`cachly:stats:time_saved_mins:${instance_id}`, String(minutenNeu)).catch(() => { });
+            }
             // ── Flush updates ─────────────────────────────────────────────────────
             if (!dry_run && updates.size > 0) {
                 const pipeline = redis.pipeline();
@@ -952,8 +1051,14 @@ export async function handleTeamTool(name, args, getConnection, apiFetch) {
                 `| Flagged provisional (confidence < ${provisional_threshold}) | ${provisionalKeys.length} |`,
                 `| Archived (stale + low-recall + age > ${archive_days}d) | ${archivedKeys.length} |`,
                 `| Contradictions auto-resolved | ${conflictResolutions.length} |`,
+                `| Startvorrat entwertet (Zähler auf 0) | ${starterZurueckgesetzt} |`,
                 '',
             ];
+            if (Math.round(minutenAlt) !== Math.round(minutenNeu)) {
+                // Die Zahl beim Namen nennen, nicht nur still korrigieren. Wer morgen
+                // eine kleinere Ersparnis im Panel sieht, soll hier lesen koennen warum.
+                lines.push(`**⏱️ Zeitersparnis neu gerechnet:** ${fmtStunden(minutenAlt)} → **${fmtStunden(minutenNeu)}**`, `_Nur noch eigene Lektionen. Der mitgelieferte Startvorrat zählt nicht mehr — er ist Allgemeinwissen, kein gelerntes._`, '');
+            }
             if (provisionalKeys.length > 0) {
                 lines.push(`**⚠️ Provisional (verify or re-learn):**`);
                 provisionalKeys.slice(0, 10).forEach(t => lines.push(`  - \`${t}\``));