@cachly-dev/mcp-server 0.10.123 → 0.10.125

package/dist/src/raumkorrektur.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Raumkorrektur: den Einbettungsraum brauchbar machen, bevor man darin sucht.
+ *
+ * ── Drei Übel, drei Gegenmittel ─────────────────────────────────────────────
+ *
+ * Ein Einbettungsraum ist nicht neutral. Er hat Eigenschaften, die das Sortieren
+ * verderben — alle drei am 19.08.2026 an 499 echten Lektionen gemessen:
+ *
+ * 1. GEMEINSAME GRUNDRICHTUNG (Anisotropie). Ein durchschnittlicher Vektor
+ *    zeigt zu 69,8 Prozent in Richtung des Schwerpunkts aller Vektoren. Dieser
+ *    Anteil ist in JEDEM Vergleich derselbe und sagt daher nichts — er hebt nur
+ *    alle Werte an und drückt die Unterschiede zusammen. Gemessen liegen alle
+ *    Ähnlichkeiten zwischen 0,42 und 0,61.
+ *
+ * 2. RICHTUNGEN, DIE NUR SCHREIBSTIL SIND. Nach dem Schwerpunkt bleiben ein
+ *    paar Hauptrichtungen übrig, die keine Bedeutung tragen, sondern Textsorte:
+ *    "ist eine Fehlermeldung", "enthält Codeschnipsel", "ist auf Deutsch".
+ *    Sie sind stark und lenken die Rangfolge.
+ *
+ * 3. NABEN. Manche Vektoren liegen einfach nahe an vielem. Sie erscheinen als
+ *    Treffer für Fragen, mit denen sie nichts zu tun haben. Belegt: die Lektion
+ *    `forge:arbeitskopie-nach-dem-merge-sofort-abraeumen` stand bei "Ich beende
+ *    den Prozess, kurz darauf ist er neu da" UND bei "Wenn der Zwischenspeicher
+ *    abläuft, schlagen alle Anfragen durch" auf Platz 1. Zwei Fragen ohne
+ *    Berührungspunkt, dieselbe falsche Antwort.
+ *
+ * ── Die Gegenmittel ─────────────────────────────────────────────────────────
+ *
+ * Zu 1 und 2: Schwerpunkt abziehen und die stärksten verbleibenden
+ * Hauptrichtungen entfernen. Was danach übrig bleibt, ist das, worin sich die
+ * Texte inhaltlich unterscheiden.
+ *
+ * Zu 3: jedem Vektor seine eigene "Geselligkeit" ausrechnen — wie nah liegt er
+ * im Mittel an seinen nächsten Nachbarn. Wer überall nah dran ist, bekommt
+ * einen Abzug. Das ist die Idee hinter CSLS aus der Wortübersetzung, hier auf
+ * den Fall übertragen, dass zur Bauzeit keine Fragen vorliegen: die Nachbarn
+ * sind die anderen Lektionen.
+ *
+ * Entscheidend für den Betrieb: ALLES DAVON WIRD EINMAL AUSGERECHNET. Zur
+ * Fragezeit bleibt ein Skalarprodukt und eine Subtraktion. Die Rangfolge wird
+ * besser, ohne dass jemand länger wartet.
+ */
+/** Skalarprodukt. */
+export declare function punktprodukt(a: number[], b: number[]): number;
+export declare function laenge(v: number[]): number;
+/** Auf Länge 1 bringen. Ein Nullvektor bleibt, was er ist. */
+export declare function normiere(v: number[]): number[];
+/** Der Schwerpunkt — die gemeinsame Grundrichtung aller Vektoren. */
+export declare function schwerpunkt(vs: number[][]): number[];
+/**
+ * Die stärksten Hauptrichtungen, über Potenziteration mit Deflation.
+ *
+ * Warum von Hand statt einer Bibliothek: es sind rund zwanzig Zeilen, läuft
+ * einmal, und eine Abhängigkeit für zwanzig Zeilen ist eine Abhängigkeit, die
+ * jemand pflegen muss.
+ *
+ * Die Vektoren müssen bereits zentriert sein — sonst ist die erste
+ * Hauptrichtung nur der Schwerpunkt, den wir gerade abgezogen haben.
+ */
+export declare function hauptrichtungen(zentriert: number[][], anzahl: number, schritte?: number): number[][];
+/** Was von einem Vektor bleibt, wenn Schwerpunkt und Hauptrichtungen weg sind. */
+export declare function bereinige(v: number[], mitte: number[], richtungen: number[][]): number[];
+/**
+ * Die "Geselligkeit" jedes Vektors: mittlere Ähnlichkeit zu seinen k nächsten
+ * Nachbarn im selben Bestand.
+ *
+ * Ein hoher Wert heißt: dieser Vektor liegt in einer dichten Gegend und ist
+ * vielem nah. Solche Naben erscheinen als Treffer für Fragen, mit denen sie
+ * nichts zu tun haben — nicht weil sie passen, sondern weil sie überall
+ * passen.
+ *
+ * Der Wert wird EINMAL berechnet und beim Suchen abgezogen. Kosten zur
+ * Fragezeit: eine Subtraktion.
+ */
+export declare function geselligkeit(normierte: number[][], k?: number): number[];
+/**
+ * Ein fertig vorbereiteter Raum: bereinigte Vektoren plus Nabenabzug.
+ *
+ * Alles hier ist Bauzeit. Zur Fragezeit ruft man `bewerte` — ein Skalarprodukt
+ * je Lektion und eine Subtraktion.
+ */
+export interface Raum {
+    mitte: number[];
+    richtungen: number[][];
+    vektoren: number[][];
+    abzug: number[];
+    beta: number;
+}
+export declare function baueRaum(roh: Array<number[] | null>, optionen?: {
+    richtungen?: number;
+    nachbarn?: number;
+    beta?: number;
+}): Raum;
+/**
+ * Bewertet eine Frage gegen alle Lektionen des Raums.
+ *
+ * `2 * cos - abzug` ist die Form aus CSLS. Der Faktor 2 sorgt dafür, dass der
+ * Abzug die Ähnlichkeit dämpft und nicht überstimmt.
+ */
+export declare function bewerteImRaum(raum: Raum, frage: number[]): number[];

package/dist/src/raumkorrektur.js

@@ -0,0 +1,197 @@
+/**
+ * Raumkorrektur: den Einbettungsraum brauchbar machen, bevor man darin sucht.
+ *
+ * ── Drei Übel, drei Gegenmittel ─────────────────────────────────────────────
+ *
+ * Ein Einbettungsraum ist nicht neutral. Er hat Eigenschaften, die das Sortieren
+ * verderben — alle drei am 19.08.2026 an 499 echten Lektionen gemessen:
+ *
+ * 1. GEMEINSAME GRUNDRICHTUNG (Anisotropie). Ein durchschnittlicher Vektor
+ *    zeigt zu 69,8 Prozent in Richtung des Schwerpunkts aller Vektoren. Dieser
+ *    Anteil ist in JEDEM Vergleich derselbe und sagt daher nichts — er hebt nur
+ *    alle Werte an und drückt die Unterschiede zusammen. Gemessen liegen alle
+ *    Ähnlichkeiten zwischen 0,42 und 0,61.
+ *
+ * 2. RICHTUNGEN, DIE NUR SCHREIBSTIL SIND. Nach dem Schwerpunkt bleiben ein
+ *    paar Hauptrichtungen übrig, die keine Bedeutung tragen, sondern Textsorte:
+ *    "ist eine Fehlermeldung", "enthält Codeschnipsel", "ist auf Deutsch".
+ *    Sie sind stark und lenken die Rangfolge.
+ *
+ * 3. NABEN. Manche Vektoren liegen einfach nahe an vielem. Sie erscheinen als
+ *    Treffer für Fragen, mit denen sie nichts zu tun haben. Belegt: die Lektion
+ *    `forge:arbeitskopie-nach-dem-merge-sofort-abraeumen` stand bei "Ich beende
+ *    den Prozess, kurz darauf ist er neu da" UND bei "Wenn der Zwischenspeicher
+ *    abläuft, schlagen alle Anfragen durch" auf Platz 1. Zwei Fragen ohne
+ *    Berührungspunkt, dieselbe falsche Antwort.
+ *
+ * ── Die Gegenmittel ─────────────────────────────────────────────────────────
+ *
+ * Zu 1 und 2: Schwerpunkt abziehen und die stärksten verbleibenden
+ * Hauptrichtungen entfernen. Was danach übrig bleibt, ist das, worin sich die
+ * Texte inhaltlich unterscheiden.
+ *
+ * Zu 3: jedem Vektor seine eigene "Geselligkeit" ausrechnen — wie nah liegt er
+ * im Mittel an seinen nächsten Nachbarn. Wer überall nah dran ist, bekommt
+ * einen Abzug. Das ist die Idee hinter CSLS aus der Wortübersetzung, hier auf
+ * den Fall übertragen, dass zur Bauzeit keine Fragen vorliegen: die Nachbarn
+ * sind die anderen Lektionen.
+ *
+ * Entscheidend für den Betrieb: ALLES DAVON WIRD EINMAL AUSGERECHNET. Zur
+ * Fragezeit bleibt ein Skalarprodukt und eine Subtraktion. Die Rangfolge wird
+ * besser, ohne dass jemand länger wartet.
+ */
+/** Skalarprodukt. */
+export function punktprodukt(a, b) {
+    let s = 0;
+    for (let i = 0; i < a.length; i++)
+        s += a[i] * b[i];
+    return s;
+}
+export function laenge(v) {
+    return Math.sqrt(punktprodukt(v, v));
+}
+/** Auf Länge 1 bringen. Ein Nullvektor bleibt, was er ist. */
+export function normiere(v) {
+    const l = laenge(v);
+    return l > 1e-12 ? v.map((x) => x / l) : v.slice();
+}
+/** Der Schwerpunkt — die gemeinsame Grundrichtung aller Vektoren. */
+export function schwerpunkt(vs) {
+    const d = vs[0]?.length ?? 0;
+    const m = new Array(d).fill(0);
+    for (const v of vs)
+        for (let i = 0; i < d; i++)
+            m[i] += v[i];
+    for (let i = 0; i < d; i++)
+        m[i] /= Math.max(1, vs.length);
+    return m;
+}
+/**
+ * Die stärksten Hauptrichtungen, über Potenziteration mit Deflation.
+ *
+ * Warum von Hand statt einer Bibliothek: es sind rund zwanzig Zeilen, läuft
+ * einmal, und eine Abhängigkeit für zwanzig Zeilen ist eine Abhängigkeit, die
+ * jemand pflegen muss.
+ *
+ * Die Vektoren müssen bereits zentriert sein — sonst ist die erste
+ * Hauptrichtung nur der Schwerpunkt, den wir gerade abgezogen haben.
+ */
+export function hauptrichtungen(zentriert, anzahl, schritte = 30) {
+    const d = zentriert[0]?.length ?? 0;
+    const rest = zentriert.map((v) => v.slice());
+    const aus = [];
+    for (let k = 0; k < anzahl; k++) {
+        // Startvektor: fest, nicht zufällig — sonst liefert derselbe Bestand bei
+        // jedem Lauf leicht andere Richtungen, und niemand kann eine Messung
+        // wiederholen.
+        let u = new Array(d).fill(0).map((_, i) => Math.sin(i * (k + 1) * 0.7));
+        u = normiere(u);
+        for (let s = 0; s < schritte; s++) {
+            const neu = new Array(d).fill(0);
+            for (const v of rest) {
+                const p = punktprodukt(v, u);
+                for (let i = 0; i < d; i++)
+                    neu[i] += p * v[i];
+            }
+            const l = laenge(neu);
+            if (l < 1e-12)
+                break;
+            for (let i = 0; i < d; i++)
+                neu[i] /= l;
+            u = neu;
+        }
+        aus.push(u);
+        // Deflation: den gefundenen Anteil aus allen Vektoren entfernen, damit die
+        // nächste Iteration eine ANDERE Richtung findet.
+        for (const v of rest) {
+            const p = punktprodukt(v, u);
+            for (let i = 0; i < d; i++)
+                v[i] -= p * u[i];
+        }
+    }
+    return aus;
+}
+/** Was von einem Vektor bleibt, wenn Schwerpunkt und Hauptrichtungen weg sind. */
+export function bereinige(v, mitte, richtungen) {
+    const w = v.map((x, i) => x - mitte[i]);
+    for (const u of richtungen) {
+        const p = punktprodukt(w, u);
+        for (let i = 0; i < w.length; i++)
+            w[i] -= p * u[i];
+    }
+    return normiere(w);
+}
+/**
+ * Die "Geselligkeit" jedes Vektors: mittlere Ähnlichkeit zu seinen k nächsten
+ * Nachbarn im selben Bestand.
+ *
+ * Ein hoher Wert heißt: dieser Vektor liegt in einer dichten Gegend und ist
+ * vielem nah. Solche Naben erscheinen als Treffer für Fragen, mit denen sie
+ * nichts zu tun haben — nicht weil sie passen, sondern weil sie überall
+ * passen.
+ *
+ * Der Wert wird EINMAL berechnet und beim Suchen abgezogen. Kosten zur
+ * Fragezeit: eine Subtraktion.
+ */
+export function geselligkeit(normierte, k = 10) {
+    const n = normierte.length;
+    const aus = new Array(n).fill(0);
+    for (let i = 0; i < n; i++) {
+        // Die k besten Ähnlichkeiten sammeln, ohne alles zu sortieren.
+        const beste = [];
+        for (let j = 0; j < n; j++) {
+            if (i === j)
+                continue;
+            const s = punktprodukt(normierte[i], normierte[j]);
+            if (beste.length < k) {
+                beste.push(s);
+                if (beste.length === k)
+                    beste.sort((a, b) => a - b);
+            }
+            else if (s > beste[0]) {
+                beste[0] = s;
+                beste.sort((a, b) => a - b);
+            }
+        }
+        aus[i] = beste.length ? beste.reduce((a, b) => a + b, 0) / beste.length : 0;
+    }
+    return aus;
+}
+export function baueRaum(roh, optionen = {}) {
+    const anzahlRichtungen = optionen.richtungen ?? 3;
+    const nachbarn = optionen.nachbarn ?? 10;
+    const beta = optionen.beta ?? 0.5;
+    const da = roh.filter(Boolean);
+    const mitte = schwerpunkt(da);
+    const zentriert = da.map((v) => v.map((x, i) => x - mitte[i]));
+    const richtungen = anzahlRichtungen > 0 ? hauptrichtungen(zentriert, anzahlRichtungen) : [];
+    // Bereinigte Vektoren in der ursprünglichen Reihenfolge — Lücken bleiben
+    // Lücken, damit ein fehlender Vektor nicht still zu einem Nullvektor wird,
+    // der zu allem gleich weit entfernt ist.
+    const vektoren = [];
+    const gueltigeIndizes = [];
+    for (const [i, v] of roh.entries()) {
+        if (!v) {
+            vektoren.push([]);
+            continue;
+        }
+        vektoren.push(bereinige(v, mitte, richtungen));
+        gueltigeIndizes.push(i);
+    }
+    const abzug = new Array(roh.length).fill(0);
+    const nurGueltige = gueltigeIndizes.map((i) => vektoren[i]);
+    const g = geselligkeit(nurGueltige, nachbarn);
+    gueltigeIndizes.forEach((idx, k) => { abzug[idx] = g[k]; });
+    return { mitte, richtungen, vektoren, abzug, beta };
+}
+/**
+ * Bewertet eine Frage gegen alle Lektionen des Raums.
+ *
+ * `2 * cos - abzug` ist die Form aus CSLS. Der Faktor 2 sorgt dafür, dass der
+ * Abzug die Ähnlichkeit dämpft und nicht überstimmt.
+ */
+export function bewerteImRaum(raum, frage) {
+    const f = bereinige(frage, raum.mitte, raum.richtungen);
+    return raum.vektoren.map((v, i) => v.length === 0 ? -2 : 2 * punktprodukt(f, v) - raum.beta * raum.abzug[i]);
+}
+//# sourceMappingURL=raumkorrektur.js.map

package/dist/src/raumkorrektur.js.map

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

package/dist/src/recall-tiefe.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Wie viele Treffer zeigt `smart_recall` — und wie viele haelt es zurueck?
+ *
+ * Eigenes Modul, weil hier ein Versprechen eingeloest wird, das vorher nur im
+ * Kommentar stand. Der Kommentar am Teaser-Gate sagte seit jeher:
+ *
+ *   "the magic moment is sacred ... never an access wall: the #1 result is
+ *    always returned"
+ *
+ * Der Code sagte `visibleCount = gateActive ? 0 : 8` — also NULL Treffer,
+ * sobald ein Frei-Konto sein Monatskontingent ueberschritten hat. Der Nutzer
+ * las die Ueberschrift "Results (23 — hybrid)", darunter keine einzige Zeile
+ * und dann eine Kaufaufforderung. Das sieht nicht aus wie eine Rechnung,
+ * sondern wie ein kaputtes Werkzeug — besonders bei Ambient Recall, das bei
+ * jedem Prompt feuert und das Kontingent in Tagen aufbraucht.
+ *
+ * Fehlerklasse: eine Zusage an zwei Orten gepflegt (Kommentar und Zweig).
+ * Deshalb ist die Regel jetzt eine Funktion mit Tests, nicht ein Satz Prosa.
+ */
+/** Der eine Treffer, den auch ein ueberzogenes Frei-Konto immer sieht. */
+export declare const TIEFE_UEBER_LIMIT = 1;
+/** Volle Tiefe bei einer einzelnen Frage. */
+export declare const TIEFE_VOLL = 8;
+/** Volle Tiefe, wenn die Frage in Unterfragen zerfaellt (mehr Themen, mehr Platz). */
+export declare const TIEFE_VOLL_MEHRTHEMIG = 12;
+export interface RecallTiefeEingabe {
+    /** Frei-Konto ueber seinem Monatskontingent? */
+    ueberLimit: boolean;
+    /** Wie viele Treffer stehen ueberhaupt zur Verfuegung. */
+    gesamt: number;
+    /** Tiefe ohne Limit — TIEFE_VOLL oder TIEFE_VOLL_MEHRTHEMIG. */
+    volleTiefe?: number;
+}
+export interface RecallTiefe {
+    /** So viele Treffer werden ausgegeben. */
+    sichtbar: number;
+    /** So viele bleiben hinter dem Kontingent — 0, solange niemand ueber dem Limit ist. */
+    zurueckgehalten: number;
+}
+/**
+ * Nie eine Mauer, immer eine Bremse: ueber dem Limit bleibt genau der beste
+ * Treffer sichtbar, der Rest wird gezaehlt und benannt.
+ *
+ * Bei null Treffern gibt es nichts zu zeigen und nichts zurueckzuhalten — ein
+ * leeres Ergebnis darf nie als "hinter der Bezahlschranke" erscheinen, sonst
+ * verkauft die Meldung etwas, das gar nicht existiert.
+ */
+export declare function recallTiefe({ ueberLimit, gesamt, volleTiefe }: RecallTiefeEingabe): RecallTiefe;

package/dist/src/recall-tiefe.js

@@ -0,0 +1,42 @@
+/**
+ * Wie viele Treffer zeigt `smart_recall` — und wie viele haelt es zurueck?
+ *
+ * Eigenes Modul, weil hier ein Versprechen eingeloest wird, das vorher nur im
+ * Kommentar stand. Der Kommentar am Teaser-Gate sagte seit jeher:
+ *
+ *   "the magic moment is sacred ... never an access wall: the #1 result is
+ *    always returned"
+ *
+ * Der Code sagte `visibleCount = gateActive ? 0 : 8` — also NULL Treffer,
+ * sobald ein Frei-Konto sein Monatskontingent ueberschritten hat. Der Nutzer
+ * las die Ueberschrift "Results (23 — hybrid)", darunter keine einzige Zeile
+ * und dann eine Kaufaufforderung. Das sieht nicht aus wie eine Rechnung,
+ * sondern wie ein kaputtes Werkzeug — besonders bei Ambient Recall, das bei
+ * jedem Prompt feuert und das Kontingent in Tagen aufbraucht.
+ *
+ * Fehlerklasse: eine Zusage an zwei Orten gepflegt (Kommentar und Zweig).
+ * Deshalb ist die Regel jetzt eine Funktion mit Tests, nicht ein Satz Prosa.
+ */
+/** Der eine Treffer, den auch ein ueberzogenes Frei-Konto immer sieht. */
+export const TIEFE_UEBER_LIMIT = 1;
+/** Volle Tiefe bei einer einzelnen Frage. */
+export const TIEFE_VOLL = 8;
+/** Volle Tiefe, wenn die Frage in Unterfragen zerfaellt (mehr Themen, mehr Platz). */
+export const TIEFE_VOLL_MEHRTHEMIG = 12;
+/**
+ * Nie eine Mauer, immer eine Bremse: ueber dem Limit bleibt genau der beste
+ * Treffer sichtbar, der Rest wird gezaehlt und benannt.
+ *
+ * Bei null Treffern gibt es nichts zu zeigen und nichts zurueckzuhalten — ein
+ * leeres Ergebnis darf nie als "hinter der Bezahlschranke" erscheinen, sonst
+ * verkauft die Meldung etwas, das gar nicht existiert.
+ */
+export function recallTiefe({ ueberLimit, gesamt, volleTiefe = TIEFE_VOLL }) {
+    const vorhanden = Number.isFinite(gesamt) && gesamt > 0 ? Math.floor(gesamt) : 0;
+    if (vorhanden === 0)
+        return { sichtbar: 0, zurueckgehalten: 0 };
+    const obergrenze = ueberLimit ? TIEFE_UEBER_LIMIT : Math.max(0, Math.floor(volleTiefe));
+    const sichtbar = Math.min(vorhanden, obergrenze);
+    return { sichtbar, zurueckgehalten: ueberLimit ? vorhanden - sichtbar : 0 };
+}
+//# sourceMappingURL=recall-tiefe.js.map

package/dist/src/recall-tiefe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-tiefe.js","sourceRoot":"","sources":["../../src/recall-tiefe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAkBxC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,EAAsB;IAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAEhE,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACjD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/src/rerank.d.ts

@@ -45,18 +45,4 @@ export interface RerankedMatch extends KeywordMatch {
 export declare function qualityMultiplier(lesson: LessonQuality | null): number;
 /** Extract the quality signal from a match, if its content is a stored lesson. */
 export declare function extractLessonQuality(match: Pick<KeywordMatch, 'key' | 'content'>): LessonQuality | null;
-/**
- * Rerank BM25 keyword matches by lesson quality.
- *
- * BM25 scores are compressed with a 0.3-power root before quality is applied.
- * Compression is the key: a distractor lesson whose `what_failed` contains the
- * exact query phrase can score 5–6× higher in BM25 than the correct success lesson.
- * A linear quality multiplier of ±40% cannot overcome that gap; after ^0.3
- * compression the ratio shrinks to ~1.5×, well within the quality range.
- *
- * The formula  compressed_score * (0.4 + 0.6 * boost)  gives quality 60% weight
- * on the compressed axis. A failure lesson (boost ≈ 0.5) retains 70% of its
- * compressed score; a senior-confirmed success (boost ≈ 1.8) gets 148%.
- * Ties are broken by the raw BM25 score (stable, deterministic).
- */
 export declare function rerankByQuality(matches: KeywordMatch[]): RerankedMatch[];

package/dist/src/rerank.js

@@ -101,14 +101,51 @@ export function extractLessonQuality(match) {
  * compressed score; a senior-confirmed success (boost ≈ 1.8) gets 148%.
  * Ties are broken by the raw BM25 score (stable, deterministic).
  */
+/**
+ * Wie stark Qualitaetsmerkmale die Rangfolge bewegen duerfen.
+ *
+ * Bleibt bei 0.6 — dem Wert von vorher. Die Messreihe vom 19.08.2026 zeigt,
+ * dass dieser Wert auf echten Daten NICHTS kostet: bei ungestauchter Relevanz
+ * liefern 0.6, 0.3 und 0.15 dasselbe Ergebnis (30 Prozent auf Platz 1).
+ *
+ * Das ist der Grund, hier nichts zu aendern. Der Schaden kam allein von der
+ * Stauchung darunter. Wer zwei Dinge gleichzeitig verstellt, weiss hinterher
+ * nicht, welches gewirkt hat.
+ */
+const QUALITAETS_GEWICHT = 0.6;
 export function rerankByQuality(matches) {
     if (matches.length === 0)
         return [];
     const reranked = matches.map(m => {
-        const compressed = Math.pow(Math.max(0, m.score), 0.3);
+        // ── Die Relevanz wird NICHT mehr plattgedrueckt ─────────────────────────
+        //
+        // Hier stand `Math.pow(score, 0.3)`. Das war Absicht: die Relevanz wurde
+        // zusammengestaucht, damit die Qualitaetsmerkmale (Zuversicht, Abnahme,
+        // Zustimmungen) die Rangfolge mitbestimmen koennen. Aus einem
+        // zehnfachen Relevanzvorsprung wurde ein doppelter.
+        //
+        // Auf dem Pruefstand mit 17 Lektionen war das ein Gewinn: 92,3 statt
+        // 69,2 Prozent. Genau diese Zahl steht seit Monaten auf der Landingpage.
+        //
+        // Auf 498 echten Lektionen, am 19.08.2026 gemessen, ist es der Verlust:
+        //
+        //   Stauchung   echter Bestand   Pruefstand
+        //   ^0.3            15 %            92,3 %
+        //   ^0.6            25 %            76,9 %
+        //   ^1.0 (keine)    30 %            69,2 %
+        //
+        // Der gesamte gemessene Vorteil auf dem Pruefstand IST der Schaden auf
+        // echten Daten. Bei 17 Lektionen ist der richtige Treffer so eindeutig,
+        // dass er auch gestaucht gewinnt. Bei 498 ist die Relevanz das knappe
+        // Gut, und wer sie staucht, wirft weg, was er hat.
+        const compressed = Math.max(0, m.score);
         const lesson = extractLessonQuality(m);
         const boost = qualityMultiplier(lesson);
-        const finalScore = compressed * (0.4 + 0.6 * boost);
+        // Qualitaet wirkt unveraendert auf die UNGESTAUCHTE Relevanz. Damit kann
+        // sie einen knappen Textvorsprung noch drehen (eine belegte Loesung schlaegt
+        // einen etwas besser passenden Fehlversuch), einen deutlichen aber nicht
+        // mehr.
+        const finalScore = compressed * (1 - QUALITAETS_GEWICHT + QUALITAETS_GEWICHT * boost);
         return { ...m, finalScore, qualityBoost: boost };
     });
     reranked.sort((a, b) => (b.finalScore - a.finalScore) || (b.score - a.score));

package/dist/src/rerank.js.map

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

package/dist/src/search.d.ts

@@ -20,11 +20,6 @@ declare function katakanaToRomaji(kata: string): string;
  */
 declare function arabicLightStem(word: string): string;
 declare const CROSS_LINGUAL_MAP: Map<string, string[]>;
-/**
- * Expand a token to its cross-lingual synonyms.
- * Returns synonyms to be added to the token stream (pre-tokenized).
- * CJK synonyms are NOT pre-bigram'd here — caller handles that.
- */
 declare function expandCrossLingual(token: string): string[];
 /**
  * Tokenize text into meaningful keywords.
@@ -93,21 +88,65 @@ declare function levenshtein(a: string, b: string): number;
 /** Extract a timestamp from JSON content (looks for "ts" or "created" fields). */
 declare function extractTimestamp(content: string): number | undefined;
 /** Recency multiplier: 1.0 for now, 0.5 after half-life days, exponential decay. */
+/**
+ * Frische als STICHENTSCHEID, nicht als Treiber.
+ *
+ * ── Was hier schiefging, und wie lange ──────────────────────────────────────
+ *
+ * Bis zum 19.08.2026 lag der Bereich bei [0.5, 1.5]. Eine ganz frische Lektion
+ * bekam damit das DREIFACHE einer 79 Tage alten — unabhaengig davon, wie gut
+ * sie zur Frage passt. Bei einem Bestand, in dem viele Datensaetze aehnlich
+ * mittelmaessig passen, entscheidet ein solcher Faktor die Rangfolge allein.
+ *
+ * Gemessen an 498 echten Lektionen mit 20 Fragen. Nur diesen Bereich zu
+ * verschmaelern, sonst nichts:
+ *
+ *   Bereich       auf Platz 1     Median-Platz
+ *   [0.5, 1.5]        1/20            101
+ *   [0.75, 1.25]      2/20             53
+ *   [0.9, 1.1]        3/20             39
+ *   [0.95, 1.05]      5/20             36
+ *   ohne Frische      6/20             29
+ *
+ * ── Warum trotzdem nicht ganz weg ───────────────────────────────────────────
+ *
+ * Weil Lektionen einander korrigieren. kanzlei:coach-timeout-root-cause traegt
+ * woertlich "korrigiert eine frueher falsch gespeicherte Lesson". Ohne jede
+ * Frische gewinnt bei gleichwertigem Text die falsche alte Fassung, und zwar
+ * fuer immer.
+ *
+ * ±5 Prozent heisst in der Praxis: die Reihenfolge aendert sich nur zwischen
+ * Datensaetzen, die ohnehin fast gleich gut passen. Genau das soll ein
+ * Stichentscheid tun.
+ *
+ * Ohne Frische mass sich um EINE Frage besser. Bei 20 Fragen ist das kein
+ * Unterschied, auf den man eine Entscheidung stuetzt.
+ *
+ * ── Warum es Monate unentdeckt blieb ────────────────────────────────────────
+ *
+ * Der Fixture-Bench hat 17 Lektionen, mit Zeitstempeln und fast derselben
+ * Altersspanne (2,7x gegen 3,0x). Am fehlenden Zeitstempel lag es also NICHT.
+ * Es lag an der Menge: bei 16 Mitbewerbern gewinnt der Textabgleich auch gegen
+ * den Faktor 3, weil ein seltenes Wort rund zehnmal so schwer wiegt wie ein
+ * haeufiges. Bei 497 Mitbewerbern gibt es genug Datensaetze mit aehnlichem
+ * Textwert — und dann entscheidet der Faktor.
+ *
+ * Ein Fehler, der erst ab einer gewissen Menge auftritt, ist auf einem kleinen
+ * Pruefstand unsichtbar. Nicht schwer zu finden. Unsichtbar.
+ */
 declare function recencyBoost(timestampMs: number | undefined): number;
 /**
- * BM25+ with Bigram Proximity, Recency Boost, and Fuzzy Matching.
- *
- * Architecture:
- * ┌─────────────────────────────────────────────────────────────────┐
- * │  Query: "deploy API fix routing; check auth"                    │
- * │    ↓ splitMultiQuery                                            │
- * │  Sub-queries: ["deploy API fix routing", "check auth"]          │
- * │    ↓ for each sub-query                                         │
- * │  Tokenize → BM25+ score per doc → Bigram boost → Fuzzy match   │
- * │    ↓ merge & deduplicate                                        │
- * │  Recency boost → Sort → Top-K                                  │
- * └─────────────────────────────────────────────────────────────────┘
+ * Wirft alle Bestaende weg. Ruft der Schreibpfad auf, wenn eine Lektion neu
+ * geschrieben wurde — ohne das waere sie bis zu eine Minute unsichtbar.
+ *
+ * Absichtlich ALLE und nicht nur die betroffene Verbindung: der Aufrufer
+ * kennt die Verbindung an dieser Stelle nicht immer, und ein Bestand zu viel
+ * neu zu bauen kostet eine Sekunde. Einen zu wenig zu entwerten kostet eine
+ * Minute Unsichtbarkeit.
  */
+export declare function wortindexEntwerten(): void;
+/** Nur fuer Tests: wie viele Bestaende seit dem letzten Entwerten stehen. */
+export declare function wortindexStand(): number;
 declare function keywordSearch(redis: Redis, patterns: string[], query: string, topK?: number): Promise<KeywordMatch[]>;
 export { tokenize, splitMultiQuery, levenshtein, recencyBoost, extractTimestamp, STOPWORDS, katakanaToRomaji, arabicLightStem, expandCrossLingual, CROSS_LINGUAL_MAP };
 export type { KeywordMatch };