@cachly-dev/mcp-server 0.10.128 → 0.10.130

package/dist/src/rangfolge.d.ts

@@ -1,169 +0,0 @@
-/**
- * Der zusammengesetzte Sortierer.
- *
- * ── Was hier drinsteckt, und was NICHT ──────────────────────────────────────
- *
- * Am 19.08.2026 wurden an 499 echten Lektionen mit 100 Fragen ein Dutzend
- * Verfahren durchgemessen. Die meisten haben nichts gebracht. Sie stehen hier,
- * damit sie niemand ein zweites Mal baut:
- *
- *   Symptom-Sicht (what_failed als eigener Vektor)   17 % statt 40 % — das Feld
- *     beschreibt bei uns nicht das Symptom, sondern was vergeblich versucht wurde
- *   Schwerpunkt abziehen                             41 % — im Rauschen
- *   Hauptrichtungen entfernen (1, 3, 6 Stueck)       37–41 % — im Rauschen
- *   Nabenabzug (CSLS-artig)                          41 % — im Rauschen
- *   Text in Stuecke schneiden                        nicht gebaut: gemessen deckt
- *     das beste Stueck genauso viel ab wie der ganze Text (Verhaeltnis 1,00),
- *     und es liegt bei 86 von 96 Fragen ohnehin am Anfang
- *
- * Was BLEIBT, sind vier Bestandteile — kreuzweise geprueft, also auf der einen
- * Haelfte der Fragen eingestellt und auf der anderen gemessen, in beide
- * Richtungen:
- *
- *                        P@1     MRR
- *   nur Bedeutung        40 %   51,3 %
- *   zusammengesetzt      51 %   57,0 %
- *
- * ── Die vier Bestandteile ───────────────────────────────────────────────────
- *
- * 1. NAEHE ZUM GANZEN TEXT (Sicht A). Der Grundstock.
- *
- * 2. NAEHE ZUM THEMENNAMEN (Sicht C). Der Name ist kurz wie eine Frage — der
- *    Vergleich ist damit symmetrisch, waehrend eine 60-Zeichen-Frage gegen
- *    1376 Zeichen Text es nicht ist. Allein liefert diese Sicht nur 26 %, im
- *    Verbund traegt sie verlaesslich (Gewicht 0,6 in beiden Richtungen).
- *
- * 3. RUECKKOPPLUNG. Die ersten drei Treffer sind meistens ungefaehr richtig.
- *    Ihre Vektoren werden zu einem Viertel unter die Frage gemischt, dann wird
- *    erneut verglichen. Kostet nichts — keine neue Einbettung, nur eine
- *    Mittelung vorhandener Zahlen.
- *
- * 4. SELTENHEITS-UEBERLAPPUNG. Welcher Anteil der SELTENEN Fragewoerter kommt
- *    im Text vor. Ohne Laengennormierung, ohne unscharfe Treffer, ohne
- *    Bigramme.
- *
- *    Das ist der unbequeme Befund: dieses eine Verhaeltnis bekam beim Einstellen
- *    das Gewicht 1,0 bis 1,6 — unser ausgefeiltes BM25 mit Laengennormierung,
- *    Bigramm-Naehe, unscharfen Treffern und Frischebonus bekam NULL. Nicht weil
- *    Woerter nichts taugen, sondern weil das ganze Beiwerk beim Sortieren
- *    daneben misst.
- *
- * ── Warum innerhalb des Topfes normiert wird ────────────────────────────────
- *
- * Ueber den ganzen Bestand liegen alle Aehnlichkeiten zwischen 0,42 und 0,61 —
- * ein sehr schmales Band, weil alle Vektoren eine gemeinsame Grundrichtung
- * teilen (gemessen: 69,8 Prozent). Unter fuenfzig Kandidaten spreizt eine
- * Normierung auf 0 bis 1 genau die Unterschiede auf, um die es geht. Das ist
- * dasselbe Ziel wie beim Schwerpunkt-Abziehen — nur dort, wo es wirkt.
- */
-/** Wörter eines Textes, umlautfrei, ohne Kurzwörter. */
-export declare function inhaltsWoerter(text: string): Set<string>;
-/**
- * Es gibt hier KEINE Stammbildung — und das ist gemessen, nicht vergessen.
- *
- * Naheliegend wäre, `Abhaengigkeiten` und `Abhaengigkeit` auf einen Nenner zu
- * bringen. Drei Varianten wurden am 19.08.2026 an 499 Lektionen mit 100 Fragen
- * kreuzweise durchgemessen:
- *
- *   ohne Stammbildung          P@1 50 %   MRR 56,4 %
- *   erste 6 Zeichen            P@1 47 %   MRR 54,7 %
- *   erste 8 Zeichen            P@1 47 %   MRR 54,7 %
- *
- * Jede Form von Kürzen kostet drei Punkte. Der Grund liegt daran, was diese
- * Suche trägt: seltene Fachwörter. `fail2ban`, `stampede`, `timestamptz`,
- * `keycloak` entscheiden eine Frage praktisch allein — und jede Verschmelzung
- * verwischt genau sie. `container` und `contains` werden zu demselben Wort,
- * und aus zwei seltenen wird ein häufiges.
- *
- * Beugung einzufangen lohnt sich also nur, wo die häufigen Wörter zählen. Hier
- * zählen die seltenen.
- *
- * (Die Wortform-Behandlung in deutsch.ts bleibt davon unberührt — sie wirkt im
- * Wortabgleich, der die Vorauswahl macht, nicht in dieser Bewertung.)
- */
-export declare function grobStamm(w: string): string;
-/**
- * Die Seltenheit jedes Wortes im Bestand — einmal berechnet, oft benutzt.
- *
- * Trifft eine Frage das Wort "nicht", sagt das nichts. Trifft sie "fail2ban",
- * ist die Sache praktisch entschieden. Ohne diese Gewichtung sind beide gleich
- * viel wert.
- */
-export declare class Seltenheit {
-    private df;
-    private anzahl;
-    /** @param texte je ein Text pro Datensatz */
-    constructor(texte: string[]);
-    wert(wort: string): number;
-    /**
-     * Welcher Anteil der seltenen Fragewörter kommt im Text vor.
-     *
-     * Der Nenner ist die Summe über ALLE Fragewörter — ein fehlendes seltenes
-     * Wort zieht damit den Wert herunter. Fehlende Belege zählen also mit, nicht
-     * nur vorhandene.
-     */
-    deckung(frageWoerter: Set<string>, textWoerter: Set<string>): number;
-}
-/** Auf 0 bis 1 spreizen — innerhalb des Topfes, nicht über den Bestand. */
-export declare function spreizeImTopf(werte: number[]): number[];
-/**
- * Die Frage mit ihren besten Treffern anreichern.
- *
- * Die Frage benutzt Alltagsworte, die Lektionen Fachworte. Die ersten Treffer
- * schlagen diese Brücke: ihre Vektoren zeigen dorthin, wo die Antwort liegt.
- *
- * Das Risiko ist bekannt und begrenzt: sind die ersten Treffer falsch, zieht
- * die Anreicherung in die falsche Richtung. Deshalb bleibt die ursprüngliche
- * Frage mit drei Vierteln stehen — gemessen war das besser als jede stärkere
- * Beimischung.
- */
-export declare function reichereAn(frage: number[], besteTreffer: number[][], anteil?: number): number[];
-/**
- * Die Gewichte.
- *
- * Kreuzweise ermittelt: auf der einen Hälfte der Fragen eingestellt, auf der
- * anderen gemessen, in beide Richtungen. Die drei Werte hier waren in BEIDEN
- * Richtungen stabil. Zwei weitere Merkmale — Überlappung mit dem Themennamen
- * und Qualitätsmerkmale — schwankten zwischen den Richtungen und sind deshalb
- * NICHT dabei: was nur in einer Hälfte hilft, ist eine Eigenschaft dieser
- * Hälfte, keine des Verfahrens.
- */
-export declare const GEWICHTE: {
-    /** Nähe zum ganzen Text. Der Grundstock, deshalb 1. */
-    readonly text: 1;
-    /** Nähe zum Themennamen. In beiden Richtungen 0,6. */
-    readonly thema: 0.6;
-    /** Angereicherte Frage gegen den ganzen Text. In beiden Richtungen 0,3. */
-    readonly rueckkopplung: 0.3;
-    /** Anteil der seltenen Fragewörter im Text. 1,0 bis 1,6 — Mitte genommen. */
-    readonly seltenheit: 1.3;
-};
-export interface Bewertbar {
-    /** Kosinus zur Sicht über den ganzen Text, oder -2 wenn kein Vektor da ist. */
-    naeheText: number;
-    /** Kosinus zur Sicht über den Themennamen. */
-    naeheThema: number;
-    /** Kosinus der angereicherten Frage zum ganzen Text. */
-    naeheRueckkopplung: number;
-    /** Anteil der seltenen Fragewörter, die im Text vorkommen. */
-    seltenheitsDeckung: number;
-}
-/**
- * Punktzahl je Kandidat. Höher ist besser.
- *
- * Erwartet den GANZEN Topf auf einmal, weil die Normierung ihn braucht — eine
- * Punktzahl für einen einzelnen Kandidaten gibt es nicht und kann es nicht
- * geben.
- */
-export declare function bewerteTopf(topf: Bewertbar[], gewichte?: {
-    /** Nähe zum ganzen Text. Der Grundstock, deshalb 1. */
-    readonly text: 1;
-    /** Nähe zum Themennamen. In beiden Richtungen 0,6. */
-    readonly thema: 0.6;
-    /** Angereicherte Frage gegen den ganzen Text. In beiden Richtungen 0,3. */
-    readonly rueckkopplung: 0.3;
-    /** Anteil der seltenen Fragewörter im Text. 1,0 bis 1,6 — Mitte genommen. */
-    readonly seltenheit: 1.3;
-}): number[];
-/** Bequemlichkeit: Kosinus mit Lücken-Behandlung. */
-export declare function naeheOderLuecke(frage: number[] | null, vektor: number[] | null | undefined): number;

package/dist/src/rangfolge.js.map

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

package/dist/src/raumkorrektur.d.ts

@@ -1,100 +0,0 @@
-/**
- * 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.map

@@ -1 +0,0 @@
-{"version":3,"file":"raumkorrektur.js","sourceRoot":"","sources":["../../src/raumkorrektur.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,qBAAqB;AACrB,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,CAAW;IACnD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAW;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,CAAW;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AACrD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,SAAqB,EAAE,MAAc,EAAE,QAAQ,GAAG,EAAE;IAClF,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAe,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,yEAAyE;QACzE,qEAAqE;QACrE,eAAe;QACf,IAAI,CAAC,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;oBAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,GAAG,KAAK;gBAAE,MAAM;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,GAAG,GAAG,CAAC;QACV,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEZ,2EAA2E;QAC3E,iDAAiD;QACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,CAAW,EAAE,KAAe,EAAE,UAAsB;IAC5E,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,SAAqB,EAAE,CAAC,GAAG,EAAE;IACxD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,+DAA+D;QAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC;gBAAE,SAAS;YACtB,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACd,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAgBD,MAAM,UAAU,QAAQ,CACtB,GAA2B,EAC3B,WAAsE,EAAE;IAExE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC;IAElC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAe,CAAC;IAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,SAAS,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5F,yEAAyE;IACzE,2EAA2E;IAC3E,yCAAyC;IACzC,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;QAC/C,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,GAAG,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9C,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,KAAe;IACvD,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAChC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC"}

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

@@ -1,48 +0,0 @@
-/**
- * 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.map

@@ -1 +0,0 @@
-{"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

@@ -1,48 +0,0 @@
-/**
- * Quality-aware reranking for Brain recall.
- *
- * The raw BM25+ keyword search (src/search.ts) ranks purely by *textual* relevance.
- * That is necessary but not sufficient: when an agent asks "how do I fix the flaky
- * deploy?", a *failed* attempt with similar words can out-rank the *proven success*
- * lesson that actually solves it. Anthropic's flat-file memory has exactly this
- * problem — it reads files in order, with no notion of which lesson is trustworthy.
- *
- * This module is Cachly's structural advantage made concrete: we re-rank text
- * matches by the *quality* of the underlying lesson — outcome, confidence,
- * proven-ness (recall_count), severity and human review (endorsements) — so the
- * lesson most likely to help surfaces first. A flat-file memory has none of these
- * signals; a senior-confirmed, ten-times-recalled success reads identically to a
- * one-off failed attempt.
- *
- * It is intentionally pure (no I/O): the lesson JSON already travels inside each
- * KeywordMatch.content for `cachly:lesson:best:*` keys, so reranking needs no extra
- * Redis round-trips. This keeps it fast and trivially benchmarkable (see
- * src/bench/cachly-bench.ts).
- */
-import type { KeywordMatch } from './search.js';
-/** Subset of a stored lesson that influences ranking. */
-export interface LessonQuality {
-    outcome?: string;
-    confidence?: number;
-    recall_count?: number;
-    severity?: string;
-    ts?: string;
-    verified_at?: string;
-    reviewed_by?: string;
-    review_level?: string;
-    endorsements?: number;
-}
-export interface RerankedMatch extends KeywordMatch {
-    /** Final score after applying the quality multiplier. */
-    finalScore: number;
-    /** The multiplier that was applied to the BM25 score (1.0 = neutral). */
-    qualityBoost: number;
-}
-/**
- * Compute the quality multiplier for a single lesson.
- * Returns 1.0 (neutral) for documents that carry no quality signal (e.g. context).
- */
-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;
-export declare function rerankByQuality(matches: KeywordMatch[]): RerankedMatch[];

package/dist/src/rerank.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rerank.js","sourceRoot":"","sources":["../../src/rerank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuB3C,kFAAkF;AAClF,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,IAAI;CACd,CAAC;AACF,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC,yCAAyC;AAEvE,MAAM,eAAe,GAA2B;IAC9C,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,GAAG;CACX,CAAC;AACF,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,gFAAgF;AAChF,gFAAgF;AAChF,oDAAoD;AACpD,MAAM,mBAAmB,GAA2B;IAClD,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,iFAAiF;AACjF,0DAA0D;AAC1D,mFAAmF;AACnF,gFAAgF;AAChF,6EAA6E;AAC7E,iEAAiE;AACjE,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA4B;IAC5D,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;WACxE,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;WACrE,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,EAAE,CAAC;QAC1C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kEAAkE;IAClE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,eAAe,CAAC;IAExE,oEAAoE;IACpE,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvG,MAAM,gBAAgB,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IAE1C,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3D,kFAAkF;IAClF,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,gBAAgB,CAAC;IAE5E,uEAAuE;IACvE,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW;QACnC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC;QAClF,CAAC,CAAC,GAAG,CAAC;IACR,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEpF,MAAM,CAAC,GAAG,OAAO,GAAG,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,KAA4C;IAC/E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,aAAa,CAAuB,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,QAAQ,GAAoB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAChD,2EAA2E;QAC3E,EAAE;QACF,yEAAyE;QACzE,wEAAwE;QACxE,8DAA8D;QAC9D,oDAAoD;QACpD,EAAE;QACF,qEAAqE;QACrE,yEAAyE;QACzE,EAAE;QACF,wEAAwE;QACxE,EAAE;QACF,4CAA4C;QAC5C,2CAA2C;QAC3C,2CAA2C;QAC3C,2CAA2C;QAC3C,EAAE;QACF,uEAAuE;QACvE,wEAAwE;QACxE,sEAAsE;QACtE,mDAAmD;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACxC,yEAAyE;QACzE,6EAA6E;QAC7E,yEAAyE;QACzE,QAAQ;QACR,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,KAAK,CAAC,CAAC;QACtF,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/search.d.ts

@@ -1,153 +0,0 @@
-import { Redis } from 'ioredis';
-/**
- * Stopwords — filtered out during tokenization.
- * Covers: English, German, French, Spanish, Italian, Portuguese,
- *         Chinese (Simplified + Traditional), Japanese, Korean.
- * Keeps the index small and scores meaningful.
- */
-declare const STOPWORDS: Set<string>;
-/**
- * Convert a katakana string to Hepburn romaji.
- * Handles digraphs, geminate consonants (ッ), and long vowel marks (ー).
- */
-declare function katakanaToRomaji(kata: string): string;
-/**
- * Arabic light stemmer — strips definite article and common prefix particles.
- * Handles: ال (al-), و (wa-), ب (bi-), ل (li-), ف (fa-), ك (ka-).
- * Runs iteratively (max 3 passes) so compound prefixes like فال- are fully
- * resolved: فالخطأ → الخطأ → خطأ.
- * Only strips when the result is still ≥ 3 chars to avoid over-stemming.
- */
-declare function arabicLightStem(word: string): string;
-declare const CROSS_LINGUAL_MAP: Map<string, string[]>;
-declare function expandCrossLingual(token: string): string[];
-/**
- * Tokenize text into meaningful keywords.
- * Handles accented Latin, RTL (Arabic, Hebrew), and CJK (Chinese, Japanese, Korean).
- *
- * Features:
- *  • CJK → character bigrams
- *  • Katakana → additionally emits Hepburn romaji tokens (enables romaji queries)
- *  • Arabic  → word tokenization + iterative prefix stemming (ال/و/ب/ل/ف/ك)
- *  • Hebrew  → word tokenization + iterative prefix stemming (ה/ו/ב/ל/מ/כ)
- *  • Farsi   → word tokenization + suffix/prefix stemming (ها/های plural, می prefix)
- *  • Hindi   → Devanagari word tokenization + light suffix stemming
- *  • All scripts → cross-lingual synonym expansion (EN↔JA↔ZH↔KO↔AR↔HE↔FA↔HI↔DE↔FR↔ES↔IT↔PT)
- */
-/**
- * Tokenize text for BM25 indexing or query expansion.
- *
- * @param text - The text to tokenize
- * @param options.crossLingualExpand - When true (default), adds cross-lingual synonym
- *   tokens for every base token. Set to false when indexing DOCUMENTS so that
- *   English documents don't get indexed with all Arabic/Japanese/etc. synonyms of
- *   every word they contain — that inflates BM25 scores catastrophically when a query
- *   also expands the same term. Query tokenization keeps expansion enabled so a
- *   Japanese query still finds English documents (query "デプロイ" → expands to "deploy").
- */
-declare function tokenize(text: string, options?: {
-    crossLingualExpand?: boolean;
-}): string[];
-/**
- * Split a multi-topic query into sub-queries.
- * Detects numbered lists, semicolons, "and also", line breaks, etc.
- *
- * Example: "deploy API fix routing and also check auth" →
- *   ["deploy API fix routing", "check auth"]
- *
- * Example: "1. deploy 2. fix routing 3. auth" →
- *   ["deploy", "fix routing", "auth"]
- */
-declare function splitMultiQuery(query: string): string[];
-/**
- * Zero-results query log — in-memory FIFO ring (max 500 entries).
- * Exposed via /health for observability. Never persisted.
- */
-interface ZeroResultEntry {
-    query: string;
-    ts: number;
-}
-declare const ZERO_RESULTS_LOG: ZeroResultEntry[];
-declare let zeroResultsTotal: number;
-declare function logZeroResult(query: string): void;
-/** Global index vocabulary — rebuilt on each keywordSearch call from the doc set. */
-declare let _indexVocab: Set<string>;
-interface KeywordMatch {
-    key: string;
-    content: string;
-    score: number;
-    matchedWords: string[];
-    subQuery?: string;
-}
-/**
- * Levenshtein distance — edit distance between two strings.
- * Used for typo-tolerant fuzzy matching (distance ≤ 2 = match).
- * O(n*m) but strings are short (tokens), so this is fast.
- */
-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;
-/**
- * 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 };
-export { keywordSearch, ZERO_RESULTS_LOG, logZeroResult, _indexVocab as indexVocab, zeroResultsTotal };