@cachly-dev/mcp-server 0.10.125 → 0.10.127

package/dist/src/bauabdruck-daten.generiert.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.10.125",
-  "commit": "07251ca",
-  "gebautAm": "2026-08-20T09:15:12.976Z"
+  "version": "0.10.127",
+  "commit": "88d2e57e",
+  "gebautAm": "2026-08-20T19:58:52.566Z"
 }

package/dist/src/handlers/brain.js

@@ -6,6 +6,7 @@ import { safeJsonParse, scanKeys } from '../utils.js';
 import { ersparteMinuten, istStarterLektion } from '../wertbeitrag.js';
 import { lessonPreviewLines, trimTo } from '../lesson-preview.js';
 import { meldeEinmal, OHNE_VEKTOREN, OHNE_DIENST, OHNE_FRAGEVEKTOR } from '../aussetzer.js';
+import { versuchStart, neueKennung, wendeZuteilungAn, schliesseVersuchAb } from '../versuch.js';
 /**
  * Preview for one smart_recall hit.
  *
@@ -1564,6 +1565,40 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 return true;
             })
                 .sort((a, b) => b.hybridScore - a.hybridScore);
+            // ── Versuch (Messtechnik, siehe versuch.ts) ───────────────────────────────
+            //
+            // Standardmaessig AUS: `versuchStart()` gibt dann `null` zurueck, und
+            // dieser ganze Block tut nichts — `hybridResults` bleibt unangetastet,
+            // nichts wird nach Redis geschrieben, kein Zeichen im Text aendert sich.
+            // Erst mit `CACHLY_VERSUCH=an` UND gesetztem Salz greift die Zuteilung.
+            const versuchSalz = versuchStart();
+            let versuchKennung = '';
+            let versuchTeil = null;
+            if (versuchSalz !== null) {
+                versuchKennung = neueKennung();
+                const hoechstePunktzahl = hybridResults[0]?.hybridScore ?? 0;
+                const ergebnis = wendeZuteilungAn(hybridResults.map((r) => ({ key: r.key, content: r.content, punktzahl: r.hybridScore })), versuchKennung, versuchSalz, hoechstePunktzahl);
+                if (ergebnis.weggelassenesThema !== undefined) {
+                    // HOLD: der bisher beste Treffer wird aus der ausgelieferten Liste
+                    // entfernt. Die uebrigen Treffer und ihre Reihenfolge bleiben gleich.
+                    hybridResults.splice(0, 1);
+                }
+                else if (ergebnis.markierungGesetzt && hybridResults[0] && ergebnis.treffer[0]) {
+                    // DELIVER: derselbe Treffer, aber sein Inhalt traegt jetzt die
+                    // Kanarien-Markierung am Ende von `what_worked`.
+                    hybridResults[0] = { ...hybridResults[0], content: ergebnis.treffer[0].content };
+                }
+                versuchTeil = {
+                    frage: query,
+                    hoechstePunktzahl,
+                    themen: [], // unten befuellt, sobald feststeht, was wirklich sichtbar ist
+                    zulassungsfaehig: ergebnis.zulassungsfaehig,
+                    zulassungsGrund: ergebnis.zulassungsGrund,
+                    zuteilung: ergebnis.zuteilung,
+                    weggelassenesThema: ergebnis.weggelassenesThema,
+                    markierungGesetzt: ergebnis.markierungGesetzt,
+                };
+            }
             // ── Teaser-Gate: free tier over its recall limit hides the long tail ──────
             const recallGate = await getRecallGate(instance_id, apiFetch);
             // Depth gate: once a free user is over their (monthly, goodwill-adjusted)
@@ -1742,6 +1777,15 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                     lines.push(`  • Use \`recall_best_solution("topic")\` for exact topic lookup`);
                 }
             }
+            // Versuch, Abschluss: Kanarienvogel gegen die WIRKLICH zusammengebaute
+            // Antwort pruefen, Markierung entfernen, Protokoll schreiben (schlaegt
+            // das fehl, bleibt die Antwort trotzdem stehen — siehe schreibeTurnProtokoll).
+            if (versuchSalz !== null && versuchTeil) {
+                const themen = hybridResults.slice(0, visibleCount)
+                    .filter((r) => r.key.startsWith('cachly:lesson:best:'))
+                    .map((r) => r.key.slice('cachly:lesson:best:'.length));
+                return schliesseVersuchAb(redis, versuchKennung, { ...versuchTeil, themen }, lines.join('\n'));
+            }
             return lines.join('\n');
         }
         // ── get_api_status ────────────────────────────────────────────────────────
@@ -3584,9 +3628,33 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             else {
                 ttfrLine = `⚪ Not enough data yet — store a lesson, then recall it`;
             }
-            // ── Metric 2: Recall-lift (the moat proof) ──────────────────────────────
-            // Published headline from Cachly-Bench (CI-defended in rerank.test.ts).
-            const recallLiftLine = `**+33.3 % Precision@1**, **+13.6 % MRR**, **+9.9 % nDCG@5** vs. raw BM25 · external-corpus Recall@3 **98.2%**`;
+            // ── Metric 2: Recall-lift ────────────────────────────────────────────────
+            //
+            // HIER STAND EINE FEST EINGEBAUTE ZAHL.
+            //
+            // "+33.3 % Precision@1 vs. raw BM25" war eine Zeichenkette, keine Messung.
+            // Der Kommentar darueber behauptete "CI-defended" und liess sie wie einen
+            // Messwert aussehen. Gefunden am 20.08.2026 beim ersten Lauf der Gegenrede.
+            //
+            // Die Zahl stammte ausserdem aus einer Formel, die am 19.08.2026
+            // ABGELOEST wurde: auf 498 echten Lektionen erreichte sie 15 Prozent, die
+            // Nachfolgerin 30. Der kleine Pruefstand (17 Lektionen, 13 Fragen) belohnte
+            // dabei die schlechtere Fassung mit 92,3 gegen 69,2 Prozent — seine Zahl
+            // bewegt sich ENTGEGENGESETZT zur Wirklichkeit. Belegt in src/bench/gate.ts.
+            //
+            // Eine Kennzahl, die der Server nicht selbst erhebt, gehoert nicht in seine
+            // Ausgabe. Sie kann nicht fallen, also misst sie nichts. Ein leeres Feld ist
+            // ehrlicher als eine Zahl, die immer gut aussieht.
+            //
+            // Dieselbe Entscheidung wurde am 19.08.2026 eine Kennzahl weiter unten schon
+            // einmal getroffen (die erfundenen "1.429,5 h"). Sie galt hier genauso und
+            // wurde nur nicht angewandt.
+            const recallLiftLine = [
+                '⚪ **Nicht gemessen** — diese Zahl erhebt der Server nicht selbst.',
+                '  Selbst messen: `npm run bench` in `sdk/mcp`.',
+                '  Achtung, der Pruefstand hat 17 Lektionen und 13 Fragen — ein Beispielsatz, kein Bestand.',
+                '  Auf 498 ECHTEN Lektionen gemessen am 19.08.2026: Precision@1 **30 %** (vorher 15 %).',
+            ].join('\n');
             // ── Metric 3: Team-knowledge-reuse ──────────────────────────────────────
             const recallsTotal = Number(recallsTotalRaw ?? 0);
             const crossAuthor = Number(crossAuthorRaw ?? 0);