@cachly-dev/mcp-server 0.10.123 → 0.10.125

package/dist/src/bauabdruck.js.map

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

package/dist/src/bedeutung.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Bedeutungsabgleich: die Frage findet die Lektion auch ohne gemeinsame Wörter.
+ *
+ * ── Warum es das gibt ────────────────────────────────────────────────────────
+ *
+ * Gemessen am 19.08.2026 an 499 echten Lektionen mit 100 Fragen in Alltags-
+ * sprache:
+ *
+ *   Verfahren            Platz 1   Top 3   MRR
+ *   Wörter (bisher)        21 %    33 %   29,3 %
+ *   Bedeutung (bge-m3)     40 %    60 %   51,4 %
+ *
+ * Der Wortabgleich war ausgereizt: nach drei Reparaturen brachten weitere
+ * Eingriffe je eine Frage. Der Grund liegt in der Aufgabe, nicht in der
+ * Umsetzung. Eine Frage beschreibt ein SYMPTOM, die Lektion eine URSACHE.
+ * "Der Deploy hängt beim Bauen" und "No space left on device" teilen kein Wort
+ * und meinen dasselbe. Kein Wörterbuch schließt diese Lücke.
+ *
+ * ── Und es ist SCHNELLER, nicht langsamer ───────────────────────────────────
+ *
+ * Das war die Überraschung. Am selben Tag gemessen:
+ *
+ *   Wortabgleich (heute, 499 Lektionen)   788 ms   (Mitte)
+ *   Einbettung der Frage (Netzaufruf)     282 ms
+ *   Vergleich gegen 494 Vektoren            0 ms   (14 ms im schlechtesten Fall)
+ *
+ * Der Wortabgleich baut seinen Index bei JEDER Frage neu: alle Datensätze
+ * holen, zerlegen, Worthäufigkeiten und Bigramme rechnen. Das wächst linear
+ * mit dem Bestand — gemessen 1,6 ms je Lektion und Frage:
+ *
+ *   Lektionen     50    100    250    499    998   1996
+ *   Wartezeit   75ms  156ms  408ms  792ms 1601ms 3185ms
+ *
+ * Bei 2000 Lektionen sind das 3,2 Sekunden. Die automatische Einblendung hat
+ * ein 3-Sekunden-Budget — das erklärt, warum sie nichts liefert
+ * (cachly:ambient-recall-blendet-nichts-ein).
+ *
+ * Der Bedeutungsabgleich kostet dagegen konstant einen Netzaufruf. Er wird
+ * nicht langsamer, wenn der Bestand wächst.
+ *
+ * ── Was das Modul NICHT tut ─────────────────────────────────────────────────
+ *
+ * Es ersetzt den Wortabgleich nicht. Zwei Gründe:
+ *
+ *   1. Ohne Netz gibt es keine Einbettung. Der Wortabgleich läuft immer.
+ *   2. Gemischt sind die ersten zehn Treffer besser als bei beiden einzeln
+ *      (71 % gegen 68 und 47). Wörter finden das wörtlich Genannte, Bedeutung
+ *      das sinngemäß Gemeinte.
+ */
+import type { Redis } from 'ioredis';
+/** Wo ein Lektionsvektor liegt. Ein Schlüssel je Lektion, neben der Lektion. */
+export declare const VEKTOR_PRAEFIX = "cachly:lesson:vec:";
+/**
+ * Wo der Vektor des THEMENNAMENS liegt.
+ *
+ * Warum getrennt vom Volltextvektor: der Name ist kurz und frageähnlich, der
+ * Volltext ist 1376 Zeichen lang. Eine 60-Zeichen-Frage gegen 60 Zeichen zu
+ * halten ist symmetrisch, gegen 1376 nicht — der Sortierer bewertet beide
+ * deshalb als eigene Merkmale (`naeheText` 1,0 und `naeheThema` 0,6).
+ *
+ * Gemessen am 19.08.2026: der Name allein findet nur 26 %, im Verbund trägt er
+ * verlässlich. Bis zum 20.08. gab es diese Vektoren nur im Messstand
+ * (korpus-gross.sicht-c.json), im Produkt nicht — der Sortierer aus
+ * rangfolge.ts war deshalb auch gar nicht verdrahtet.
+ */
+export declare const NAME_VEKTOR_PRAEFIX = "cachly:lesson:vecname:";
+/** Der Text, aus dem der Namensvektor gebildet wird: Trennzeichen zu Wörtern. */
+export declare function textFuerNamensVektor(topic: string): string;
+/**
+ * Vektoren werden als base64 gespeichert, nicht als JSON-Zahlenliste.
+ *
+ * 1024 Zahlen als JSON sind rund 20 KB je Lektion, als Float32 sind es 4 KB.
+ * Bei 500 Lektionen ist das der Unterschied zwischen 10 MB und 2 MB, die bei
+ * jedem kalten Start über die Leitung gehen.
+ */
+export declare function packe(vektor: number[]): string;
+export declare function entpacke(s: string): number[] | null;
+/**
+ * Kosinus-Ähnlichkeit zweier Vektoren.
+ *
+ * Die Länge wird bei JEDEM Aufruf neu gerechnet statt einmal vorher. Das ist
+ * absichtlich: gemessen liegt der gesamte Vergleich gegen 494 Vektoren bei
+ * 0 ms. Eine Vorberechnung wäre eine zweite Wahrheit über denselben Vektor —
+ * und der Gewinn wäre nicht messbar.
+ */
+export declare function kosinus(a: number[], b: number[]): number;
+/**
+ * Der Text, aus dem der Vektor einer Lektion gebildet wird.
+ *
+ * Bewusst NICHT das rohe JSON: Feldnamen, Zeitstempel und Prüfspuren tragen
+ * keine Bedeutung, verbrauchen aber vom Fenster des Einbettungsmodells. Der
+ * Dienst kürzt bei rund 2000 Zeichen — gemessen liefern 2000, 4000 und 6000
+ * Zeichen denselben Vektor. Was hinten steht, existiert für ihn nicht.
+ */
+export declare function textFuerVektor(lektion: Record<string, unknown>): string;
+/**
+ * Ein Vektorbestand, der im Arbeitsspeicher bleibt.
+ *
+ * Warum: 494 Vektoren sind rund 2 MB. Die bei jeder Frage aus dem Speicher zu
+ * holen wäre langsamer als der Wortabgleich, den wir gerade ersetzen — der
+ * Gewinn wäre weg, bevor er anfängt.
+ *
+ * Der MCP-Server läuft lange, also wird einmal geladen und danach nur
+ * nachgetragen. Die Prüfung "hat sich etwas geändert" läuft über die ANZAHL
+ * der Schlüssel, nicht über ihren Inhalt: eine geänderte Lektion bekommt beim
+ * Lernen sofort ihren neuen Vektor geschrieben, und dieser Bestand holt ihn
+ * beim nächsten Nachladen.
+ */
+export declare class Vektorbestand {
+    private readonly frischeMs;
+    private readonly praefix;
+    private vektoren;
+    private geladen;
+    /**
+     * @param frischeMs wie lange ein geladener Bestand als frisch gilt
+     * @param praefix   welche Sicht — Volltext (Standard) oder Themenname
+     *
+     * Der Präfix ist ein Parameter und keine zweite Klasse: die Mechanik ist
+     * identisch (scannen, in Blöcken holen, entpacken, Gelöschtes vergessen).
+     * Zwei Klassen dafür wären zwei Orte, an denen dieselbe Änderung nachgezogen
+     * werden müsste.
+     */
+    constructor(frischeMs?: number, praefix?: string);
+    /** Die Nähe einer Frage zu EINER Lektion. -2, wenn sie keinen Vektor hat. */
+    naehe(frage: number[], topic: string): number;
+    /**
+     * Der Vektor selbst — für die Rückkopplung, die aus den besten Treffern
+     * einen angereicherten Fragevektor baut (`reichereAn`). `null`, wenn die
+     * Lektion keinen hat; der Aufrufer filtert das weg.
+     */
+    rohvektor(topic: string): number[] | null;
+    get groesse(): number;
+    /** Lädt fehlende Vektoren nach. Tut nichts, wenn kürzlich geladen wurde. */
+    aktualisiere(redis: Redis, jetzt?: number): Promise<void>;
+    /**
+     * Die ähnlichsten Lektionen zu einem Fragevektor.
+     *
+     * Zurück kommen die THEMEN, nicht die Schlüssel — der Aufrufer arbeitet mit
+     * Themen und soll das Schlüsselformat nicht kennen müssen.
+     */
+    aehnlichste(frage: number[], anzahl: number): Array<{
+        topic: string;
+        naehe: number;
+    }>;
+}
+/**
+ * Mischt zwei Rangfolgen über die PLATZIERUNG, nicht über die Punktzahl.
+ *
+ * Punktzahlen aus BM25 und aus einem Kosinus sind nicht vergleichbar: die eine
+ * ist nach oben offen, die andere liegt zwischen -1 und 1. Wer sie addiert oder
+ * skaliert, wählt unbeabsichtigt einen Gewinner und merkt es nie.
+ *
+ * Reciprocal Rank Fusion braucht keine gemeinsame Einheit.
+ *
+ * ── Wie viel Wortabgleich? ──────────────────────────────────────────────────
+ *
+ * Gemessen am 19.08.2026 an 499 Lektionen mit 100 Fragen:
+ *
+ *   Wortgewicht   Platz 1   Top 3   Top 10   MRR
+ *   0,0 (nur Sinn)   40 %    60 %     68 %   51,4 %
+ *   0,1              41 %    63 %     71 %   53,5 %
+ *   0,2              42 %    57 %     70 %   52,0 %
+ *   0,3              39 %    55 %     71 %   49,0 %
+ *   0,4              38 %    51 %     69 %   47,7 %
+ *   1,0 (nur Wörter) 21 %    33 %     47 %   29,3 %
+ *
+ * 0,1 ist auf drei von vier Maßen vorn und überall besser als reine Bedeutung.
+ * Wenig Wortabgleich hilft, viel schadet: die Wörter fangen den Fall, in dem
+ * jemand eine Fehlermeldung wörtlich einfügt, und stören sonst.
+ *
+ * Zu 0,2 ist der Abstand bei Platz 1 EINE Frage. Das ist kein Beleg, sondern
+ * eine Richtung — wer hier dreht, misst nach.
+ */
+export declare const WORT_GEWICHT = 0.1;
+export declare function mischeRangfolgen(woerter: string[], bedeutung: string[], wortGewicht?: number, k?: number): string[];

package/dist/src/bedeutung.js

@@ -0,0 +1,254 @@
+/**
+ * Bedeutungsabgleich: die Frage findet die Lektion auch ohne gemeinsame Wörter.
+ *
+ * ── Warum es das gibt ────────────────────────────────────────────────────────
+ *
+ * Gemessen am 19.08.2026 an 499 echten Lektionen mit 100 Fragen in Alltags-
+ * sprache:
+ *
+ *   Verfahren            Platz 1   Top 3   MRR
+ *   Wörter (bisher)        21 %    33 %   29,3 %
+ *   Bedeutung (bge-m3)     40 %    60 %   51,4 %
+ *
+ * Der Wortabgleich war ausgereizt: nach drei Reparaturen brachten weitere
+ * Eingriffe je eine Frage. Der Grund liegt in der Aufgabe, nicht in der
+ * Umsetzung. Eine Frage beschreibt ein SYMPTOM, die Lektion eine URSACHE.
+ * "Der Deploy hängt beim Bauen" und "No space left on device" teilen kein Wort
+ * und meinen dasselbe. Kein Wörterbuch schließt diese Lücke.
+ *
+ * ── Und es ist SCHNELLER, nicht langsamer ───────────────────────────────────
+ *
+ * Das war die Überraschung. Am selben Tag gemessen:
+ *
+ *   Wortabgleich (heute, 499 Lektionen)   788 ms   (Mitte)
+ *   Einbettung der Frage (Netzaufruf)     282 ms
+ *   Vergleich gegen 494 Vektoren            0 ms   (14 ms im schlechtesten Fall)
+ *
+ * Der Wortabgleich baut seinen Index bei JEDER Frage neu: alle Datensätze
+ * holen, zerlegen, Worthäufigkeiten und Bigramme rechnen. Das wächst linear
+ * mit dem Bestand — gemessen 1,6 ms je Lektion und Frage:
+ *
+ *   Lektionen     50    100    250    499    998   1996
+ *   Wartezeit   75ms  156ms  408ms  792ms 1601ms 3185ms
+ *
+ * Bei 2000 Lektionen sind das 3,2 Sekunden. Die automatische Einblendung hat
+ * ein 3-Sekunden-Budget — das erklärt, warum sie nichts liefert
+ * (cachly:ambient-recall-blendet-nichts-ein).
+ *
+ * Der Bedeutungsabgleich kostet dagegen konstant einen Netzaufruf. Er wird
+ * nicht langsamer, wenn der Bestand wächst.
+ *
+ * ── Was das Modul NICHT tut ─────────────────────────────────────────────────
+ *
+ * Es ersetzt den Wortabgleich nicht. Zwei Gründe:
+ *
+ *   1. Ohne Netz gibt es keine Einbettung. Der Wortabgleich läuft immer.
+ *   2. Gemischt sind die ersten zehn Treffer besser als bei beiden einzeln
+ *      (71 % gegen 68 und 47). Wörter finden das wörtlich Genannte, Bedeutung
+ *      das sinngemäß Gemeinte.
+ */
+/** Wo ein Lektionsvektor liegt. Ein Schlüssel je Lektion, neben der Lektion. */
+export const VEKTOR_PRAEFIX = 'cachly:lesson:vec:';
+/**
+ * Wo der Vektor des THEMENNAMENS liegt.
+ *
+ * Warum getrennt vom Volltextvektor: der Name ist kurz und frageähnlich, der
+ * Volltext ist 1376 Zeichen lang. Eine 60-Zeichen-Frage gegen 60 Zeichen zu
+ * halten ist symmetrisch, gegen 1376 nicht — der Sortierer bewertet beide
+ * deshalb als eigene Merkmale (`naeheText` 1,0 und `naeheThema` 0,6).
+ *
+ * Gemessen am 19.08.2026: der Name allein findet nur 26 %, im Verbund trägt er
+ * verlässlich. Bis zum 20.08. gab es diese Vektoren nur im Messstand
+ * (korpus-gross.sicht-c.json), im Produkt nicht — der Sortierer aus
+ * rangfolge.ts war deshalb auch gar nicht verdrahtet.
+ */
+export const NAME_VEKTOR_PRAEFIX = 'cachly:lesson:vecname:';
+/** Der Text, aus dem der Namensvektor gebildet wird: Trennzeichen zu Wörtern. */
+export function textFuerNamensVektor(topic) {
+    return topic.replace(/[:_-]+/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/**
+ * Vektoren werden als base64 gespeichert, nicht als JSON-Zahlenliste.
+ *
+ * 1024 Zahlen als JSON sind rund 20 KB je Lektion, als Float32 sind es 4 KB.
+ * Bei 500 Lektionen ist das der Unterschied zwischen 10 MB und 2 MB, die bei
+ * jedem kalten Start über die Leitung gehen.
+ */
+export function packe(vektor) {
+    const f = new Float32Array(vektor);
+    return Buffer.from(f.buffer, f.byteOffset, f.byteLength).toString('base64');
+}
+export function entpacke(s) {
+    try {
+        const b = Buffer.from(s, 'base64');
+        if (b.byteLength === 0 || b.byteLength % 4 !== 0)
+            return null;
+        const f = new Float32Array(b.buffer, b.byteOffset, b.byteLength / 4);
+        return Array.from(f);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Kosinus-Ähnlichkeit zweier Vektoren.
+ *
+ * Die Länge wird bei JEDEM Aufruf neu gerechnet statt einmal vorher. Das ist
+ * absichtlich: gemessen liegt der gesamte Vergleich gegen 494 Vektoren bei
+ * 0 ms. Eine Vorberechnung wäre eine zweite Wahrheit über denselben Vektor —
+ * und der Gewinn wäre nicht messbar.
+ */
+export function kosinus(a, b) {
+    if (a.length !== b.length)
+        return -1;
+    let p = 0;
+    let qa = 0;
+    let qb = 0;
+    for (let i = 0; i < a.length; i++) {
+        p += a[i] * b[i];
+        qa += a[i] * a[i];
+        qb += b[i] * b[i];
+    }
+    return qa && qb ? p / Math.sqrt(qa * qb) : 0;
+}
+/**
+ * Der Text, aus dem der Vektor einer Lektion gebildet wird.
+ *
+ * Bewusst NICHT das rohe JSON: Feldnamen, Zeitstempel und Prüfspuren tragen
+ * keine Bedeutung, verbrauchen aber vom Fenster des Einbettungsmodells. Der
+ * Dienst kürzt bei rund 2000 Zeichen — gemessen liefern 2000, 4000 und 6000
+ * Zeichen denselben Vektor. Was hinten steht, existiert für ihn nicht.
+ */
+export function textFuerVektor(lektion) {
+    const s = (v) => (typeof v === 'string' ? v : '');
+    return [s(lektion.topic), s(lektion.what_worked), s(lektion.what_failed)]
+        .filter(Boolean).join('\n').slice(0, 2000);
+}
+/**
+ * Ein Vektorbestand, der im Arbeitsspeicher bleibt.
+ *
+ * Warum: 494 Vektoren sind rund 2 MB. Die bei jeder Frage aus dem Speicher zu
+ * holen wäre langsamer als der Wortabgleich, den wir gerade ersetzen — der
+ * Gewinn wäre weg, bevor er anfängt.
+ *
+ * Der MCP-Server läuft lange, also wird einmal geladen und danach nur
+ * nachgetragen. Die Prüfung "hat sich etwas geändert" läuft über die ANZAHL
+ * der Schlüssel, nicht über ihren Inhalt: eine geänderte Lektion bekommt beim
+ * Lernen sofort ihren neuen Vektor geschrieben, und dieser Bestand holt ihn
+ * beim nächsten Nachladen.
+ */
+export class Vektorbestand {
+    frischeMs;
+    praefix;
+    vektoren = new Map();
+    geladen = 0;
+    /**
+     * @param frischeMs wie lange ein geladener Bestand als frisch gilt
+     * @param praefix   welche Sicht — Volltext (Standard) oder Themenname
+     *
+     * Der Präfix ist ein Parameter und keine zweite Klasse: die Mechanik ist
+     * identisch (scannen, in Blöcken holen, entpacken, Gelöschtes vergessen).
+     * Zwei Klassen dafür wären zwei Orte, an denen dieselbe Änderung nachgezogen
+     * werden müsste.
+     */
+    constructor(frischeMs = 60_000, praefix = VEKTOR_PRAEFIX) {
+        this.frischeMs = frischeMs;
+        this.praefix = praefix;
+    }
+    /** Die Nähe einer Frage zu EINER Lektion. -2, wenn sie keinen Vektor hat. */
+    naehe(frage, topic) {
+        const v = this.vektoren.get(`${this.praefix}${topic}`);
+        return v ? kosinus(frage, v) : -2;
+    }
+    /**
+     * Der Vektor selbst — für die Rückkopplung, die aus den besten Treffern
+     * einen angereicherten Fragevektor baut (`reichereAn`). `null`, wenn die
+     * Lektion keinen hat; der Aufrufer filtert das weg.
+     */
+    rohvektor(topic) {
+        return this.vektoren.get(`${this.praefix}${topic}`) ?? null;
+    }
+    get groesse() { return this.vektoren.size; }
+    /** Lädt fehlende Vektoren nach. Tut nichts, wenn kürzlich geladen wurde. */
+    async aktualisiere(redis, jetzt = Date.now()) {
+        if (this.vektoren.size > 0 && jetzt - this.geladen < this.frischeMs)
+            return;
+        const schluessel = [];
+        let cursor = '0';
+        do {
+            const [next, gefunden] = await redis.scan(cursor, 'MATCH', `${this.praefix}*`, 'COUNT', 500);
+            cursor = next;
+            schluessel.push(...gefunden);
+        } while (cursor !== '0');
+        const fehlend = schluessel.filter((k) => !this.vektoren.has(k));
+        for (let i = 0; i < fehlend.length; i += 100) {
+            const block = fehlend.slice(i, i + 100);
+            const werte = await redis.mget(...block);
+            for (const [j, roh] of werte.entries()) {
+                if (!roh)
+                    continue;
+                const v = entpacke(roh);
+                if (v)
+                    this.vektoren.set(block[j], v);
+            }
+        }
+        // Gelöschte Lektionen wieder loswerden.
+        if (schluessel.length < this.vektoren.size) {
+            const da = new Set(schluessel);
+            for (const k of [...this.vektoren.keys()])
+                if (!da.has(k))
+                    this.vektoren.delete(k);
+        }
+        this.geladen = jetzt;
+    }
+    /**
+     * Die ähnlichsten Lektionen zu einem Fragevektor.
+     *
+     * Zurück kommen die THEMEN, nicht die Schlüssel — der Aufrufer arbeitet mit
+     * Themen und soll das Schlüsselformat nicht kennen müssen.
+     */
+    aehnlichste(frage, anzahl) {
+        const aus = [];
+        for (const [k, v] of this.vektoren) {
+            aus.push({ topic: k.slice(this.praefix.length), naehe: kosinus(frage, v) });
+        }
+        aus.sort((a, b) => b.naehe - a.naehe);
+        return aus.slice(0, anzahl);
+    }
+}
+/**
+ * Mischt zwei Rangfolgen über die PLATZIERUNG, nicht über die Punktzahl.
+ *
+ * Punktzahlen aus BM25 und aus einem Kosinus sind nicht vergleichbar: die eine
+ * ist nach oben offen, die andere liegt zwischen -1 und 1. Wer sie addiert oder
+ * skaliert, wählt unbeabsichtigt einen Gewinner und merkt es nie.
+ *
+ * Reciprocal Rank Fusion braucht keine gemeinsame Einheit.
+ *
+ * ── Wie viel Wortabgleich? ──────────────────────────────────────────────────
+ *
+ * Gemessen am 19.08.2026 an 499 Lektionen mit 100 Fragen:
+ *
+ *   Wortgewicht   Platz 1   Top 3   Top 10   MRR
+ *   0,0 (nur Sinn)   40 %    60 %     68 %   51,4 %
+ *   0,1              41 %    63 %     71 %   53,5 %
+ *   0,2              42 %    57 %     70 %   52,0 %
+ *   0,3              39 %    55 %     71 %   49,0 %
+ *   0,4              38 %    51 %     69 %   47,7 %
+ *   1,0 (nur Wörter) 21 %    33 %     47 %   29,3 %
+ *
+ * 0,1 ist auf drei von vier Maßen vorn und überall besser als reine Bedeutung.
+ * Wenig Wortabgleich hilft, viel schadet: die Wörter fangen den Fall, in dem
+ * jemand eine Fehlermeldung wörtlich einfügt, und stören sonst.
+ *
+ * Zu 0,2 ist der Abstand bei Platz 1 EINE Frage. Das ist kein Beleg, sondern
+ * eine Richtung — wer hier dreht, misst nach.
+ */
+export const WORT_GEWICHT = 0.1;
+export function mischeRangfolgen(woerter, bedeutung, wortGewicht = WORT_GEWICHT, k = 60) {
+    const punkte = new Map();
+    woerter.forEach((t, i) => punkte.set(t, (punkte.get(t) ?? 0) + wortGewicht / (k + i + 1)));
+    bedeutung.forEach((t, i) => punkte.set(t, (punkte.get(t) ?? 0) + (1 - wortGewicht) / (k + i + 1)));
+    return [...punkte.entries()].sort((a, b) => b[1] - a[1]).map(([t]) => t);
+}
+//# sourceMappingURL=bedeutung.js.map

package/dist/src/bedeutung.js.map

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

package/dist/src/brain-export.d.ts

@@ -20,7 +20,31 @@ export interface ExportLesson {
     ts?: string;
     author?: string;
     recallCount?: number;
+    /**
+     * Der GESPEICHERTE Datensatz, unveraendert.
+     *
+     * Warum es das Feld gibt: bis zum 19.08.2026 zog `cachly export` seine Daten
+     * aus /memory, einer Dashboard-Zusammenfassung. Ergebnis: 50 Lektionen von
+     * 493, what_worked auf 120 Zeichen abgeschnitten. Das Format war nie das
+     * Problem — dieses Modul kann what_failed und file_paths seit jeher — die
+     * QUELLE war es.
+     *
+     * Damit sich das nicht wiederholt, traegt die JSONL-Zeile jetzt den rohen
+     * Datensatz, wenn er da ist. Wer morgen ein Feld an die Lektion haengt, muss
+     * dieses Modul nicht anfassen: es steht automatisch im Export. Ein Export,
+     * der wissen muss, welche Felder es gibt, verliert genau die, an die niemand
+     * gedacht hat.
+     */
+    raw?: Record<string, unknown>;
 }
+/**
+ * Macht aus einem gespeicherten Lektions-Datensatz eine ExportLesson.
+ *
+ * Die bekannten Felder werden benannt, damit das Markdown sie rendern kann.
+ * Der ganze Datensatz bleibt zusaetzlich unter `raw` erhalten, damit die
+ * JSONL-Zeile nichts verliert.
+ */
+export declare function vonRohLektion(roh: unknown): ExportLesson | null;
 /**
  * Builds the human-readable Markdown dump: one `##` section per topic
  * category (the part of `topic` before the first `:`, or "Ungrouped" when

package/dist/src/brain-export.js

@@ -4,6 +4,36 @@
  * design — no network, no filesystem. The `export` CLI command in index.ts
  * fetches the lessons and writes the files these functions build.
  */
+/**
+ * Macht aus einem gespeicherten Lektions-Datensatz eine ExportLesson.
+ *
+ * Die bekannten Felder werden benannt, damit das Markdown sie rendern kann.
+ * Der ganze Datensatz bleibt zusaetzlich unter `raw` erhalten, damit die
+ * JSONL-Zeile nichts verliert.
+ */
+export function vonRohLektion(roh) {
+    if (typeof roh !== 'object' || roh === null)
+        return null;
+    const r = roh;
+    const topic = typeof r.topic === 'string' ? r.topic : '';
+    if (!topic)
+        return null;
+    const text = (v) => (typeof v === 'string' && v ? v : undefined);
+    const liste = (v) => Array.isArray(v) && v.length > 0 ? v.filter((x) => typeof x === 'string') : undefined;
+    return {
+        topic,
+        outcome: text(r.outcome),
+        severity: text(r.severity),
+        whatWorked: text(r.what_worked),
+        whatFailed: text(r.what_failed),
+        filePaths: liste(r.file_paths),
+        tags: liste(r.tags),
+        ts: text(r.ts),
+        author: text(r.author),
+        recallCount: typeof r.recall_count === 'number' ? r.recall_count : undefined,
+        raw: r,
+    };
+}
 const UNGROUPED_HEADING = 'Ungrouped';
 function groupByCategory(lessons) {
     const groups = new Map();
@@ -73,7 +103,7 @@ export function buildLessonsMarkdown(lessons) {
 export function buildLessonsJsonl(lessons) {
     if (lessons.length === 0)
         return '';
-    return lessons.map((lesson) => JSON.stringify({
+    return lessons.map((lesson) => JSON.stringify(lesson.raw ?? {
         topic: lesson.topic,
         outcome: lesson.outcome,
         severity: lesson.severity,

package/dist/src/brain-export.js.map

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

package/dist/src/deutsch.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Deutsch für die Suche: Umlaute, Wortformen, zusammengesetzte Wörter.
+ *
+ * ── Warum es dieses Modul gibt ───────────────────────────────────────────────
+ *
+ * Gemessen am 19.08.2026 an 498 echten Lektionen mit 20 Fragen in Alltags-
+ * deutsch: 2 Treffer. Sechs Fragen teilten mit der richtigen Antwort NICHT EIN
+ * EINZIGES Wort. Die Aufteilung nach Ursachen (src/bench/wortschatz-oder-
+ * menge.ts) zeigte: schon bei 20 Lektionen und null Ablenkern scheitern 14 von
+ * 20. Es ist also der Wortschatz, nicht die Menge.
+ *
+ * Die Suche hatte deutsche Stoppwörter und 35 deutsche Wortpaare. Was fehlte,
+ * waren drei Dinge — und alle drei sind an echten Fragen belegt:
+ *
+ *   1. UMLAUTE. Die Wortliste stand mit echten Umlauten (`lösung`,
+ *      `überwachung`), Lektionen und Fragen schreiben oft `ae/oe/ue`. Damit
+ *      fand `ueberwachung` den Eintrag `überwachung` nie. Zwei Schreibweisen
+ *      desselben Wortes, und die Suche hielt sie für verschieden.
+ *
+ *   2. WORTFORM. `abhaengigkeiten` gegen `abhaengigkeit`, `prozesse` gegen
+ *      `prozess`. Für sieben Sprachen gab es einen Stemmer, für Deutsch nicht.
+ *
+ *   3. ZUSAMMENGESETZTE WÖRTER. Das ist die deutsche Besonderheit und war die
+ *      größte Lücke. `Arbeitsspeicher` enthält `speicher`, und `speicher` steht
+ *      längst in der Wortliste — nur kam niemand dort an. Genauso
+ *      `Zugriffsprotokoll` → `protokoll` → `log`, `Browsertests` → `test`.
+ *
+ * ── Die Entscheidung, die dieses Modul klein hält ────────────────────────────
+ *
+ * Für die Zerlegung braucht es ein Wörterbuch der Grundwörter. Es wäre nahe-
+ * liegend, dafür eine zweite Liste zu pflegen. Genau das ist die Fehlerklasse,
+ * die uns in diesem Haus am häufigsten trifft: eine Wahrheit an zwei Orten.
+ *
+ * Deshalb: die Wortliste IST das Wörterbuch. Wer ein Wortpaar einträgt, macht
+ * es damit automatisch als Grundwort für zusammengesetzte Wörter verfügbar.
+ * Eine Liste, zwei Wirkungen.
+ */
+/**
+ * Schreibt Umlaute aus. Aus `ä` wird `ae`, aus `ß` wird `ss`.
+ *
+ * Beide Schreibweisen werden auf DIESELBE Form gebracht — nicht die eine in die
+ * andere übersetzt. Nur so ist `Lösung` dasselbe Wort wie `Loesung`, egal in
+ * welcher Richtung jemand tippt.
+ */
+export declare function ohneUmlaute(wort: string): string;
+/**
+ * Deutsche Wortform auf einen gemeinsamen Stamm bringen.
+ *
+ * Absichtlich zurückhaltend: eine Endung, nicht mehrere hintereinander. Bei
+ * `Abhaengigkeiten` reicht `-en`, und `Abhaengigkeit` ist genau die Form, die
+ * in den Lektionen steht.
+ */
+export declare function deutscherStamm(wort: string): string;
+/**
+ * Die Rückumlautung: `eintraeg` → `eintrag`, `laeuft` → `lauft`.
+ *
+ * Das Deutsche verändert im Plural und in gebeugten Formen den Stammvokal
+ * (Eintrag → Einträge). Ohne diesen Schritt bleiben Einzahl und Mehrzahl zwei
+ * verschiedene Wörter.
+ *
+ * Nur die letzte Umlautstelle wird zurückgenommen. `Ueberpruefung` soll nicht
+ * zu `Uberprufung` werden — das Wort beginnt mit einem echten `ü`, das kein
+ * Umlaut einer Mehrzahl ist.
+ */
+export declare function ohneRueckumlaut(stamm: string): string | null;
+/**
+ * Zerlegt ein zusammengesetztes Wort in seine Bestandteile.
+ *
+ * `Arbeitsspeicher` → `speicher` (und `arbeit`)
+ * `Zugriffsprotokoll` → `protokoll` (und `zugriff`)
+ * `Browsertests` → `test` (und `browser`)
+ *
+ * Wie es arbeitet: Das Grundwort steht im Deutschen HINTEN. Also wird von
+ * hinten nach einem bekannten Wort gesucht. Der Rest davor wird ebenfalls
+ * zurückgegeben, wenn er lang genug ist — er trägt oft die eigentliche
+ * Bedeutung (`Arbeit` in `Arbeitsspeicher`).
+ *
+ * Das `s` in `Arbeits|speicher` ist eine Fuge und gehört zu keinem der beiden
+ * Teile. Es wird abgeschnitten.
+ *
+ * @param bekannt Grundwörter, gegen die geprüft wird. Das ist die Wortliste der
+ *                Suche selbst — kein zweites Wörterbuch, das veralten kann.
+ */
+export declare function zerlegeKompositum(wort: string, bekannt: Set<string>): string[];
+/**
+ * Deutsche Fachwörter, die in unseren Lektionen und Fragen vorkommen.
+ *
+ * ── Woher diese Liste kommt ──────────────────────────────────────────────────
+ *
+ * Nicht aus dem Kopf. Jeder Eintrag stammt aus der Messung vom 19.08.2026: es
+ * sind die Wörter, die in echten Fragen standen und in der richtigen Antwort
+ * keinen Anschluss fanden (src/bench/wo-bricht-die-frage.ts nennt sie).
+ *
+ * Deshalb ist die Liste kurz und wird es bleiben. Sie wächst aus Messungen,
+ * nicht aus Vermutungen — wer etwas einträgt, soll die Frage nennen können, die
+ * ohne den Eintrag danebengeht.
+ */
+export declare const DEUTSCHE_FACHWOERTER: ReadonlyArray<readonly [string, string[]]>;