@cachly-dev/mcp-server 0.10.127 → 0.10.129

package/dist/src/versuch.d.ts

@@ -44,6 +44,13 @@
  * danach aus dem Text entfernt, bevor er den Nutzer erreicht.
  */
 import type { Redis } from 'ioredis';
+import { meldeUndVermerke } from './aussetzer.js';
+/**
+ * So viel Speicher, wie ein Vermerk braucht. Bewusst strukturell getippt und
+ * nicht als Redis-Typ: dieses Modul soll ohne Redis-Abhaengigkeit pruefbar
+ * bleiben.
+ */
+type VermerkSpeicherArt = Parameters<typeof meldeUndVermerke>[0];
 export declare const VERSUCH_ENV = "CACHLY_VERSUCH";
 export declare const VERSUCH_SALZ_ENV = "CACHLY_VERSUCH_SALZ";
 /** Grund fuer `meldeEinmal`: Versuch eingeschaltet, aber kein Salz gesetzt. */
@@ -57,7 +64,7 @@ export declare const OHNE_SALZ = "versuch-ohne-salz";
  * `meldeEinmal`) und verhaelt sich danach wie der erste — still weiterlaufen
  * waere die Fehlerklasse, gegen die `aussetzer.ts` gebaut wurde.
  */
-export declare function versuchStart(): string | null;
+export declare function versuchStart(speicher?: VermerkSpeicherArt | null): string | null;
 /**
  * Eine neue, stabile Kennung je Recall-Aufruf.
  *
@@ -177,3 +184,4 @@ export interface VersuchProtokollTeil {
  * forget) und gibt den bereinigten Text zurueck — den, den der Nutzer sieht.
  */
 export declare function schliesseVersuchAb(redis: Redis, kennung: string, teil: VersuchProtokollTeil, fertigeAntwort: string): string;
+export {};

package/dist/src/versuch.js

@@ -44,7 +44,7 @@
  * danach aus dem Text entfernt, bevor er den Nutzer erreicht.
  */
 import { randomBytes, createHash } from 'node:crypto';
-import { meldeEinmal } from './aussetzer.js';
+import { meldeEinmal, meldeUndVermerke, VERSUCH_LEER } from './aussetzer.js';
 // ── Der Schalter ─────────────────────────────────────────────────────────────
 export const VERSUCH_ENV = 'CACHLY_VERSUCH';
 export const VERSUCH_SALZ_ENV = 'CACHLY_VERSUCH_SALZ';
@@ -59,12 +59,26 @@ export const OHNE_SALZ = 'versuch-ohne-salz';
  * `meldeEinmal`) und verhaelt sich danach wie der erste — still weiterlaufen
  * waere die Fehlerklasse, gegen die `aussetzer.ts` gebaut wurde.
  */
-export function versuchStart() {
+export function versuchStart(speicher) {
     if (process.env[VERSUCH_ENV] !== 'an')
         return null;
     const salz = process.env[VERSUCH_SALZ_ENV];
     if (!salz) {
-        meldeEinmal(OHNE_SALZ, `${VERSUCH_ENV}=an, aber ${VERSUCH_SALZ_ENV} fehlt — der Versuch verhaelt sich wie "aus"`);
+        const text = `${VERSUCH_ENV}=an, aber ${VERSUCH_SALZ_ENV} fehlt — der Versuch verhaelt sich wie "aus"`;
+        if (speicher) {
+            // Ohne Speicher stand die Meldung nur im Arbeitsspeicher und war nach
+            // jedem Deploy weg (Karte opupbt3l9wcq, gefunden von der Gegenrede,
+            // Rolle: Der Betreiber). Der Versuch konnte damit WOCHENLANG leer
+            // laufen: "keine Daten" sah genauso aus wie "noch nicht genug Daten".
+            //
+            // meldeUndVermerke faengt jeden eigenen Fehler ab und gibt eine
+            // Zusage zurueck, die niemand einloesen muss — deshalb `void`. Diese
+            // Funktion bleibt synchron, weil ihre Aufrufer es sind.
+            void meldeUndVermerke(speicher, VERSUCH_LEER, text);
+        }
+        else {
+            meldeEinmal(OHNE_SALZ, text);
+        }
         return null;
     }
     return salz;

package/dist/src/versuch.js.map

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

package/dist/src/wartung/vektoren-verdichten.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Vektoren von float32 auf int8 umschreiben — der Umzug, den `packe` braucht.
+ *
+ * ── Warum es das gibt ───────────────────────────────────────────────────────
+ *
+ * Am 20.08.2026 belegte ein Bestand mit 524 Lektionen 23,6 MB von 25 MB
+ * Tarifgrenze — 94 %. Davon waren 11,2 MB Vektoren: 6,0 MB Volltext und Namen,
+ * 5,2 MB Eingänge. Die nächste Lektion wäre an einem Schreibfehler gescheitert.
+ *
+ * `packe` schreibt seither int8 statt float32 (Faktor 3,96). Neu geschriebene
+ * Lektionen sind damit klein. Die BESTEHENDEN bleiben groß, bis sie einmal neu
+ * gelernt werden — und die meisten werden nie neu gelernt. Dieses Werkzeug
+ * holt sie ein.
+ *
+ * ── Was es tut, und in welcher Reihenfolge ─────────────────────────────────
+ *
+ * 1. Sichern: jeder betroffene Schlüssel wird VORHER in eine Datei geschrieben.
+ * 2. Prüfen: die Sicherung wird zurückgelesen und muss vollständig sein.
+ * 3. Umschreiben: erst danach wird der Speicher angefasst.
+ *
+ * Ohne Schritt 2 wäre die Sicherung eine Behauptung. Eine Sicherung, die nie
+ * zurückgelesen wurde, ist keine.
+ *
+ * Aufruf:
+ *   REDIS_URL=... npx tsx src/wartung/vektoren-verdichten.ts --sicherung <datei>
+ *   REDIS_URL=... npx tsx src/wartung/vektoren-verdichten.ts --sicherung <datei> --schreiben
+ *   REDIS_URL=... npx tsx src/wartung/vektoren-verdichten.ts --sicherung <datei> --zurueck
+ *
+ * Ohne `--schreiben` wird nur gerechnet und gemeldet. Das ist Absicht: der
+ * Trockenlauf ist der Normalfall, das Schreiben ist der Sonderfall.
+ */
+import { Redis } from 'ioredis';
+/** Alle Schlüssel zu einem Muster, ohne KEYS (das blockiert den Server). */
+export declare function alleSchluessel(redis: Redis, muster: string): Promise<string[]>;
+/**
+ * Ist dieser Wert schon im neuen Format?
+ *
+ * Wird gebraucht, damit ein zweiter Lauf nichts kaputt macht und nichts doppelt
+ * zählt. Ein Umzug, der nur einmal laufen darf, ist ein Umzug mit einer Falle.
+ */
+export declare function istInt8(base64: string): boolean;
+export interface Bilanz {
+    schluessel: number;
+    felder: number;
+    vorher: number;
+    nachher: number;
+    uebersprungen: number;
+}
+/** Rechnet aus, was der Umzug bringt — und schreibt nur, wenn `schreiben` gesetzt ist. */
+export declare function verdichte(redis: Redis, schreiben: boolean): Promise<Bilanz>;

package/dist/src/wartung/vektoren-verdichten.js

@@ -0,0 +1,200 @@
+/**
+ * Vektoren von float32 auf int8 umschreiben — der Umzug, den `packe` braucht.
+ *
+ * ── Warum es das gibt ───────────────────────────────────────────────────────
+ *
+ * Am 20.08.2026 belegte ein Bestand mit 524 Lektionen 23,6 MB von 25 MB
+ * Tarifgrenze — 94 %. Davon waren 11,2 MB Vektoren: 6,0 MB Volltext und Namen,
+ * 5,2 MB Eingänge. Die nächste Lektion wäre an einem Schreibfehler gescheitert.
+ *
+ * `packe` schreibt seither int8 statt float32 (Faktor 3,96). Neu geschriebene
+ * Lektionen sind damit klein. Die BESTEHENDEN bleiben groß, bis sie einmal neu
+ * gelernt werden — und die meisten werden nie neu gelernt. Dieses Werkzeug
+ * holt sie ein.
+ *
+ * ── Was es tut, und in welcher Reihenfolge ─────────────────────────────────
+ *
+ * 1. Sichern: jeder betroffene Schlüssel wird VORHER in eine Datei geschrieben.
+ * 2. Prüfen: die Sicherung wird zurückgelesen und muss vollständig sein.
+ * 3. Umschreiben: erst danach wird der Speicher angefasst.
+ *
+ * Ohne Schritt 2 wäre die Sicherung eine Behauptung. Eine Sicherung, die nie
+ * zurückgelesen wurde, ist keine.
+ *
+ * Aufruf:
+ *   REDIS_URL=... npx tsx src/wartung/vektoren-verdichten.ts --sicherung <datei>
+ *   REDIS_URL=... npx tsx src/wartung/vektoren-verdichten.ts --sicherung <datei> --schreiben
+ *   REDIS_URL=... npx tsx src/wartung/vektoren-verdichten.ts --sicherung <datei> --zurueck
+ *
+ * Ohne `--schreiben` wird nur gerechnet und gemeldet. Das ist Absicht: der
+ * Trockenlauf ist der Normalfall, das Schreiben ist der Sonderfall.
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { Redis } from 'ioredis';
+import { packe, entpacke } from '../bedeutung.js';
+/** Alle Schlüssel zu einem Muster, ohne KEYS (das blockiert den Server). */
+export async function alleSchluessel(redis, muster) {
+    const aus = [];
+    let cursor = '0';
+    do {
+        const [next, gefunden] = await redis.scan(cursor, 'MATCH', muster, 'COUNT', 500);
+        cursor = next;
+        aus.push(...gefunden);
+    } while (cursor !== '0');
+    return aus;
+}
+/**
+ * Ist dieser Wert schon im neuen Format?
+ *
+ * Wird gebraucht, damit ein zweiter Lauf nichts kaputt macht und nichts doppelt
+ * zählt. Ein Umzug, der nur einmal laufen darf, ist ein Umzug mit einer Falle.
+ */
+export function istInt8(base64) {
+    const b = Buffer.from(base64, 'base64');
+    return b.byteLength > 7 && b[0] === 0x01 && b.byteLength % 4 === 1;
+}
+/** Rechnet aus, was der Umzug bringt — und schreibt nur, wenn `schreiben` gesetzt ist. */
+export async function verdichte(redis, schreiben) {
+    const b = { schluessel: 0, felder: 0, vorher: 0, nachher: 0, uebersprungen: 0 };
+    // Einfache Werte: Volltext- und Namensvektoren.
+    for (const muster of ['cachly:lesson:vec:*', 'cachly:lesson:vecname:*']) {
+        for (const k of await alleSchluessel(redis, muster)) {
+            const roh = await redis.get(k);
+            if (!roh)
+                continue;
+            b.schluessel++;
+            if (istInt8(roh)) {
+                b.uebersprungen++;
+                b.vorher += roh.length;
+                b.nachher += roh.length;
+                continue;
+            }
+            const v = entpacke(roh);
+            if (!v) {
+                b.uebersprungen++;
+                continue;
+            }
+            const neu = packe(v);
+            b.vorher += roh.length;
+            b.nachher += neu.length;
+            b.felder++;
+            if (schreiben)
+                await redis.set(k, neu);
+        }
+    }
+    // Eingänge: ein Hash je Lektion, ein Vektor je Feld.
+    for (const k of await alleSchluessel(redis, 'cachly:lesson:eing:*')) {
+        const h = await redis.hgetall(k);
+        const felder = [];
+        b.schluessel++;
+        for (const [feld, roh] of Object.entries(h)) {
+            if (istInt8(roh)) {
+                b.uebersprungen++;
+                b.vorher += roh.length;
+                b.nachher += roh.length;
+                continue;
+            }
+            const v = entpacke(roh);
+            if (!v) {
+                b.uebersprungen++;
+                continue;
+            }
+            const neu = packe(v);
+            b.vorher += roh.length;
+            b.nachher += neu.length;
+            b.felder++;
+            felder.push(feld, neu);
+        }
+        if (schreiben && felder.length > 0)
+            await redis.hset(k, ...felder);
+    }
+    return b;
+}
+const mb = (zeichen) => `${(zeichen / 1024 / 1024).toFixed(2)} MB`;
+async function main() {
+    const argv = process.argv.slice(2);
+    const flag = (n) => {
+        const i = argv.indexOf(`--${n}`);
+        return i !== -1 ? argv[i + 1] : undefined;
+    };
+    const url = process.env.CACHLY_REDIS_URL ?? process.env.REDIS_URL;
+    if (!url) {
+        console.error('NICHT GELAUFEN: REDIS_URL fehlt.');
+        process.exit(2);
+    }
+    const sicherungsPfad = flag('sicherung');
+    if (!sicherungsPfad) {
+        console.error('NICHT GELAUFEN: --sicherung <datei> fehlt.');
+        process.exit(2);
+    }
+    const schreiben = argv.includes('--schreiben');
+    const zurueck = argv.includes('--zurueck');
+    const redis = new Redis(url, { maxRetriesPerRequest: 2, connectTimeout: 8000 });
+    try {
+        if (zurueck) {
+            if (!existsSync(sicherungsPfad)) {
+                console.error(`NICHT GELAUFEN: Sicherung fehlt (${sicherungsPfad}).`);
+                process.exit(2);
+            }
+            const s = JSON.parse(readFileSync(sicherungsPfad, 'utf8'));
+            let n = 0;
+            for (const [k, v] of Object.entries(s.werte)) {
+                await redis.set(k, v);
+                n++;
+            }
+            for (const [k, h] of Object.entries(s.hashes)) {
+                const felder = Object.entries(h).flat();
+                if (felder.length === 0)
+                    continue;
+                await redis.del(k);
+                await redis.hset(k, ...felder);
+                n++;
+            }
+            console.log(`ZURUECKGESPIELT: ${n} Schluessel aus ${sicherungsPfad}`);
+            return;
+        }
+        // 1. Sichern — immer, auch im Trockenlauf.
+        const werte = {};
+        const hashes = {};
+        for (const muster of ['cachly:lesson:vec:*', 'cachly:lesson:vecname:*']) {
+            for (const k of await alleSchluessel(redis, muster)) {
+                const roh = await redis.get(k);
+                if (roh)
+                    werte[k] = roh;
+            }
+        }
+        for (const k of await alleSchluessel(redis, 'cachly:lesson:eing:*')) {
+            hashes[k] = await redis.hgetall(k);
+        }
+        writeFileSync(sicherungsPfad, JSON.stringify({ werte, hashes }), { encoding: 'utf8' });
+        // 2. Sicherung zurueckLESEN und pruefen. Ungeprueft ist sie keine.
+        const probe = JSON.parse(readFileSync(sicherungsPfad, 'utf8'));
+        const wSoll = Object.keys(werte).length;
+        const wIst = Object.keys(probe.werte).length;
+        const hSoll = Object.keys(hashes).length;
+        const hIst = Object.keys(probe.hashes).length;
+        if (wSoll !== wIst || hSoll !== hIst || wSoll === 0) {
+            console.error(`ABBRUCH: Sicherung unvollstaendig (${wIst}/${wSoll} Werte, ${hIst}/${hSoll} Hashes).`);
+            process.exit(3);
+        }
+        console.log(`Sicherung geprueft: ${wIst} Werte + ${hIst} Hashes in ${sicherungsPfad}`);
+        // 3. Erst jetzt rechnen bzw. schreiben.
+        const b = await verdichte(redis, schreiben);
+        console.log('');
+        console.log(`  Schluessel angesehen  : ${b.schluessel}`);
+        console.log(`  Vektoren umgeschrieben: ${b.felder}`);
+        console.log(`  uebersprungen         : ${b.uebersprungen} (schon int8 oder unlesbar)`);
+        console.log(`  vorher                : ${mb(b.vorher)}`);
+        console.log(`  nachher               : ${mb(b.nachher)}`);
+        console.log(`  gespart               : ${mb(b.vorher - b.nachher)}  (Faktor ${(b.vorher / Math.max(1, b.nachher)).toFixed(2)})`);
+        console.log('');
+        console.log(schreiben ? '  GESCHRIEBEN.' : '  TROCKENLAUF — nichts veraendert. Mit --schreiben ausfuehren.');
+    }
+    finally {
+        redis.disconnect();
+    }
+}
+const direktGestartet = process.argv[1]?.replace(/\\/g, '/').endsWith('/vektoren-verdichten.ts');
+if (direktGestartet)
+    main().catch((e) => { console.error('FEHLER:', e); process.exit(1); });
+//# sourceMappingURL=vektoren-verdichten.js.map

package/dist/src/wartung/vektoren-verdichten.js.map

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

package/dist/src/wertbeitrag.d.ts

@@ -30,6 +30,32 @@
  * Starter-Korpus mit anderen Namen wäre er blind. Die Starter-Lektionen tragen
  * seit ihrer Einführung `source: 'starter'` im Datensatz — genau dafür. Diese
  * Datei benutzt die Markierung, nicht die Namen.
+ *
+ * ─── NACHTRAG 22.08.2026: DIE MARKIERUNG GAB ES NICHT ──────────────────────
+ *
+ * Der Absatz darüber stand fünf Tage lang so da und war falsch. Gemessen in
+ * der Gegenrede über die Zahl „Brain saved you ~1664h":
+ *
+ *     brain_hygiene(dry_run) → "Startvorrat entwertet (Zähler auf 0): 0"
+ *     bei 543 gescannten Lektionen.
+ *
+ * NULL. Der Filter griff bei keiner einzigen. `docker:layer-cache` — der
+ * Anlass dieser ganzen Datei — zählte weiterhin voll mit inzwischen 974
+ * Abrufen.
+ *
+ * Der Grund: Die eingebauten Lektionen kommen über `import_public_brain`
+ * herein und tragen dabei gar kein `source`-Feld. Die Markierung, auf die
+ * sich der Absatz oben verlässt, wird beim Schreiben nie gesetzt.
+ *
+ * Das ist die eigentliche Lehre, und sie ist unbequemer als die erste: Der
+ * Fix war gebaut, beschrieben und begründet — und hat nie gewirkt. Niemand
+ * hat nachgemessen, ob er greift. Fünf Tage lang stand in dieser Datei ein
+ * Kommentar über einen Schutz, den es nicht gab.
+ *
+ * Deshalb prüft `istStarterLektion` jetzt drei Dinge (Herkunft, Thema,
+ * fremder Installationsweg) — und deshalb steht darunter eine Probe, die
+ * nicht den Code liest, sondern eine echte Lektion durch die Funktion
+ * schickt. Ein Kommentar ist kein Beweis.
  */
 /** fmtStunden macht aus Minuten eine lesbare Angabe ("21 h", "3 d 4 h"). */
 export declare function fmtStunden(minuten: number): string;
@@ -37,17 +63,48 @@ export declare function fmtStunden(minuten: number): string;
 export interface BewertbareLektion {
     severity?: string;
     source?: string;
+    topic?: string;
+    what_worked?: string;
+    recall_count?: number;
     [k: string]: unknown;
 }
+/** Die Themen des Startvorrats — fuer Aufrufer, die nur die Namen brauchen. */
+export declare const STARTER_THEMEN: ReadonlySet<string>;
 /**
- * Stammt die Lektion aus dem mitgelieferten Startvorrat?
+ * Stammt die Lektion aus fremdem Wissen statt aus eigener Arbeit?
+ *
+ * Solche Lektionen duerfen abgerufen werden und sind nuetzlich — sie zaehlen
+ * nur nicht als etwas, das dieser Mensch oder dieses Team gelernt hat.
+ *
+ * ── NACHTRAG 22.08.2026: der Filter kannte nur die Haelfte ──────────────────
+ *
+ * Der Schutz war seit dem 17.08. gebaut, beschrieben und begruendet — und hat
+ * die groesste Einzelquelle nie erwischt. Er pruefte:
+ *
+ *     return lesson?.source === 'starter';
+ *
+ * `import_public_brain` schreibt aber `source: 'public_brain'` (team.ts:1610),
+ * und dahinter steht eine EIGENE eingebaute Liste von rund 40 Lektionen ueber
+ * go, docker, kubernetes, react, typescript und python — darunter
+ * `docker:layer-cache`, die meistabgerufene Lektion dieses Brains ueberhaupt
+ * (980 Abrufe, gemessen am 22.08.2026).
  *
- * Solche Lektionen dürfen abgerufen werden und sind nützlich — sie zählen nur
- * nicht als etwas, das dieser Mensch oder dieses Team gelernt hat.
+ * Ein Vergleich auf genau eine Zeichenkette ist blind fuer den zweiten Weg.
+ * Und weil `brain_hygiene` (team.ts:1247) die Zeitersparnis aus derselben
+ * Funktion NEU rechnet, machte die Luecke die Zahl nicht nur zu gross, sondern
+ * beim Aufraeumen noch groesser: 1664 h → 6445 h.
+ *
+ * ── Warum trotzdem nicht nur ueber die Namen ────────────────────────────────
+ *
+ * Eine reine Namensliste wuerde eine echte Regel brechen: Wer selbst etwas
+ * ueber `docker:layer-cache` lernt, hat etwas gelernt. Deshalb entscheidet
+ * zuerst die Herkunft. Nur wenn gar keine dasteht — `learn_from_attempts`
+ * setzt das Feld nicht — wird das Thema geprueft, und dann muss auch der TEXT
+ * wortgleich der ausgelieferte sein. Ein eigener Satz zum selben Thema zaehlt.
  */
 export declare function istStarterLektion(lesson: BewertbareLektion | null | undefined): boolean;
 /**
- * Minuten, die ein Abruf dieser Lektion einspart — 0 für den Startvorrat.
+ * Minuten, die ein Abruf dieser Lektion einspart — 0 für fremdes Wissen.
  *
  * Die Staffel (30 / 60 / 240) ist unverändert; sie stand vorher an drei
  * Stellen im Code und steht jetzt hier. `basis` erlaubt der abweichenden
@@ -55,3 +112,37 @@ export declare function istStarterLektion(lesson: BewertbareLektion | null | und
  * die Starter-Regel ein zweites Mal geschrieben werden muss.
  */
 export declare function ersparteMinuten(lesson: BewertbareLektion | null | undefined, basis?: 'recall' | 'trace'): number;
+/**
+ * Zaehlt dieser Abruf ueberhaupt Zeit — oder ist es ein Wiedersehen?
+ *
+ * ── DER ZWEITE BEFUND VOM 22.08.2026 ────────────────────────────────────────
+ *
+ * Der Startvorrat-Filter war nur die halbe Ursache. Die andere Haelfte:
+ * Zeitersparnis wurde bei JEDEM Abruf erneut gutgeschrieben.
+ *
+ * `smart_recall` schreibt bis zu FUENF Lektionen pro Aufruf die volle
+ * Recherchezeit gut (brain.ts:1725 ff.). Die Anleitung des Servers verlangt
+ * einen Aufruf "BEFORE every task", und eingeblendete Lektionen kommen
+ * zusaetzlich bei jedem Prompt. Zehn Aufgaben in einer Sitzung konnten so
+ * rechnerisch zweihundert Stunden erzeugen.
+ *
+ * Gemessen: Dieses Brain ist am 01.06.2026 entstanden, 82 Tage alt, und meldete
+ * 1664,5 Stunden. Eine Person haette in 82 Tagen zu acht Stunden 656 Stunden
+ * gehabt. Die Zahl war nicht zu hoch — sie war unmoeglich.
+ *
+ * ── Die Regel, die haelt ────────────────────────────────────────────────────
+ *
+ * Die Zusage lautet "time not re-researching known fixes". Recherchiert wird
+ * EINMAL. Wer dieselbe Lektion zum neunhundertsten Mal sieht, spart nicht zum
+ * neunhundertsten Mal eine Recherche — er spart ein Nachschlagen.
+ *
+ * Also: jede Lektion zaehlt genau EINMAL, beim ersten Abruf. Damit ist die
+ * Zahl nach oben durch den Wissensstand begrenzt statt durch die Nutzung, sie
+ * kann nicht mehr schneller wachsen als gelernt wird — und das Einblenden
+ * treibt sie gar nicht mehr.
+ *
+ * Das ist dieselbe Fehlerklasse wie `cachly:metric-inflation-fixed` (PR #158,
+ * stuendliche Heartbeat-Pings blaehten die ROI-Zahlen auf). Damals wurde die
+ * eine Quelle abgestellt; die Bauart, die aus Wiederholung Wert macht, blieb.
+ */
+export declare function zaehltAlsErsparnis(lesson: BewertbareLektion | null | undefined): boolean;

package/dist/src/wertbeitrag.js

@@ -30,7 +30,34 @@
  * Starter-Korpus mit anderen Namen wäre er blind. Die Starter-Lektionen tragen
  * seit ihrer Einführung `source: 'starter'` im Datensatz — genau dafür. Diese
  * Datei benutzt die Markierung, nicht die Namen.
+ *
+ * ─── NACHTRAG 22.08.2026: DIE MARKIERUNG GAB ES NICHT ──────────────────────
+ *
+ * Der Absatz darüber stand fünf Tage lang so da und war falsch. Gemessen in
+ * der Gegenrede über die Zahl „Brain saved you ~1664h":
+ *
+ *     brain_hygiene(dry_run) → "Startvorrat entwertet (Zähler auf 0): 0"
+ *     bei 543 gescannten Lektionen.
+ *
+ * NULL. Der Filter griff bei keiner einzigen. `docker:layer-cache` — der
+ * Anlass dieser ganzen Datei — zählte weiterhin voll mit inzwischen 974
+ * Abrufen.
+ *
+ * Der Grund: Die eingebauten Lektionen kommen über `import_public_brain`
+ * herein und tragen dabei gar kein `source`-Feld. Die Markierung, auf die
+ * sich der Absatz oben verlässt, wird beim Schreiben nie gesetzt.
+ *
+ * Das ist die eigentliche Lehre, und sie ist unbequemer als die erste: Der
+ * Fix war gebaut, beschrieben und begründet — und hat nie gewirkt. Niemand
+ * hat nachgemessen, ob er greift. Fünf Tage lang stand in dieser Datei ein
+ * Kommentar über einen Schutz, den es nicht gab.
+ *
+ * Deshalb prüft `istStarterLektion` jetzt drei Dinge (Herkunft, Thema,
+ * fremder Installationsweg) — und deshalb steht darunter eine Probe, die
+ * nicht den Code liest, sondern eine echte Lektion durch die Funktion
+ * schickt. Ein Kommentar ist kein Beweis.
  */
+import { STARTER_CORPUS } from './starter-corpus.js';
 /** fmtStunden macht aus Minuten eine lesbare Angabe ("21 h", "3 d 4 h"). */
 export function fmtStunden(minuten) {
     const gesamt = Math.max(0, Math.round(minuten));
@@ -44,16 +71,79 @@ export function fmtStunden(minuten) {
     return rest > 0 ? `${tage} d ${rest} h` : `${tage} d`;
 }
 /**
- * Stammt die Lektion aus dem mitgelieferten Startvorrat?
+ * Der ausgelieferte Startvorrat, nach Thema aufgeschlagen — ABGELEITET.
+ *
+ * Erster Versuch am 22.08.2026 war eine von Hand gepflegte Namensliste. Sie war
+ * schon beim Schreiben falsch: sieben Themen fehlten, drei standen darin, die
+ * es gar nicht gibt. Eine zweite Liste derselben Wahrheit laeuft auseinander,
+ * bevor sie fertig ist.
+ */
+const STARTER_NACH_THEMA = new Map(STARTER_CORPUS.map((l) => [l.topic, l.what_worked]));
+/** Die Themen des Startvorrats — fuer Aufrufer, die nur die Namen brauchen. */
+export const STARTER_THEMEN = new Set(STARTER_NACH_THEMA.keys());
+/**
+ * Herkuenfte, die NICHT als eigene Lernleistung zaehlen.
+ *
+ * Es gibt zwei Wege, auf denen fremdes Wissen in ein Brain kommt, und sie
+ * schreiben ZWEI VERSCHIEDENE Werte:
+ *
+ *   brain_seed_starter   (share.ts)  → source: 'starter'
+ *   import_public_brain  (team.ts)   → source: 'public_brain'
+ *
+ * `marketplace:` und `syndicate:` sind vorgemerkt, damit der naechste
+ * Einbauweg nicht wieder still durchrutscht.
+ */
+const FREMDE_HERKUNFT = /^(starter|public_brain|marketplace:|syndicate:|import)/;
+/**
+ * Stammt die Lektion aus fremdem Wissen statt aus eigener Arbeit?
+ *
+ * Solche Lektionen duerfen abgerufen werden und sind nuetzlich — sie zaehlen
+ * nur nicht als etwas, das dieser Mensch oder dieses Team gelernt hat.
+ *
+ * ── NACHTRAG 22.08.2026: der Filter kannte nur die Haelfte ──────────────────
  *
- * Solche Lektionen dürfen abgerufen werden und sind nützlich — sie zählen nur
- * nicht als etwas, das dieser Mensch oder dieses Team gelernt hat.
+ * Der Schutz war seit dem 17.08. gebaut, beschrieben und begruendet — und hat
+ * die groesste Einzelquelle nie erwischt. Er pruefte:
+ *
+ *     return lesson?.source === 'starter';
+ *
+ * `import_public_brain` schreibt aber `source: 'public_brain'` (team.ts:1610),
+ * und dahinter steht eine EIGENE eingebaute Liste von rund 40 Lektionen ueber
+ * go, docker, kubernetes, react, typescript und python — darunter
+ * `docker:layer-cache`, die meistabgerufene Lektion dieses Brains ueberhaupt
+ * (980 Abrufe, gemessen am 22.08.2026).
+ *
+ * Ein Vergleich auf genau eine Zeichenkette ist blind fuer den zweiten Weg.
+ * Und weil `brain_hygiene` (team.ts:1247) die Zeitersparnis aus derselben
+ * Funktion NEU rechnet, machte die Luecke die Zahl nicht nur zu gross, sondern
+ * beim Aufraeumen noch groesser: 1664 h → 6445 h.
+ *
+ * ── Warum trotzdem nicht nur ueber die Namen ────────────────────────────────
+ *
+ * Eine reine Namensliste wuerde eine echte Regel brechen: Wer selbst etwas
+ * ueber `docker:layer-cache` lernt, hat etwas gelernt. Deshalb entscheidet
+ * zuerst die Herkunft. Nur wenn gar keine dasteht — `learn_from_attempts`
+ * setzt das Feld nicht — wird das Thema geprueft, und dann muss auch der TEXT
+ * wortgleich der ausgelieferte sein. Ein eigener Satz zum selben Thema zaehlt.
  */
 export function istStarterLektion(lesson) {
-    return lesson?.source === 'starter';
+    if (!lesson)
+        return false;
+    if (typeof lesson.source === 'string' && lesson.source !== '') {
+        // Herkunft steht da: sie entscheidet, in beide Richtungen.
+        return FREMDE_HERKUNFT.test(lesson.source);
+    }
+    // Keine Herkunft: nur ein WORTGLEICHER Treffer aus dem Vorrat zaehlt nicht.
+    if (typeof lesson.topic !== 'string')
+        return false;
+    const ausgeliefert = STARTER_NACH_THEMA.get(lesson.topic);
+    if (ausgeliefert === undefined)
+        return false;
+    const eigener = typeof lesson.what_worked === 'string' ? lesson.what_worked : '';
+    return eigener.trim() === ausgeliefert.trim();
 }
 /**
- * Minuten, die ein Abruf dieser Lektion einspart — 0 für den Startvorrat.
+ * Minuten, die ein Abruf dieser Lektion einspart — 0 für fremdes Wissen.
  *
  * Die Staffel (30 / 60 / 240) ist unverändert; sie stand vorher an drei
  * Stellen im Code und steht jetzt hier. `basis` erlaubt der abweichenden
@@ -70,4 +160,44 @@ export function ersparteMinuten(lesson, basis = 'recall') {
         return basis === 'trace' ? 120 : 60;
     return basis === 'trace' ? 60 : 30;
 }
+/**
+ * Zaehlt dieser Abruf ueberhaupt Zeit — oder ist es ein Wiedersehen?
+ *
+ * ── DER ZWEITE BEFUND VOM 22.08.2026 ────────────────────────────────────────
+ *
+ * Der Startvorrat-Filter war nur die halbe Ursache. Die andere Haelfte:
+ * Zeitersparnis wurde bei JEDEM Abruf erneut gutgeschrieben.
+ *
+ * `smart_recall` schreibt bis zu FUENF Lektionen pro Aufruf die volle
+ * Recherchezeit gut (brain.ts:1725 ff.). Die Anleitung des Servers verlangt
+ * einen Aufruf "BEFORE every task", und eingeblendete Lektionen kommen
+ * zusaetzlich bei jedem Prompt. Zehn Aufgaben in einer Sitzung konnten so
+ * rechnerisch zweihundert Stunden erzeugen.
+ *
+ * Gemessen: Dieses Brain ist am 01.06.2026 entstanden, 82 Tage alt, und meldete
+ * 1664,5 Stunden. Eine Person haette in 82 Tagen zu acht Stunden 656 Stunden
+ * gehabt. Die Zahl war nicht zu hoch — sie war unmoeglich.
+ *
+ * ── Die Regel, die haelt ────────────────────────────────────────────────────
+ *
+ * Die Zusage lautet "time not re-researching known fixes". Recherchiert wird
+ * EINMAL. Wer dieselbe Lektion zum neunhundertsten Mal sieht, spart nicht zum
+ * neunhundertsten Mal eine Recherche — er spart ein Nachschlagen.
+ *
+ * Also: jede Lektion zaehlt genau EINMAL, beim ersten Abruf. Damit ist die
+ * Zahl nach oben durch den Wissensstand begrenzt statt durch die Nutzung, sie
+ * kann nicht mehr schneller wachsen als gelernt wird — und das Einblenden
+ * treibt sie gar nicht mehr.
+ *
+ * Das ist dieselbe Fehlerklasse wie `cachly:metric-inflation-fixed` (PR #158,
+ * stuendliche Heartbeat-Pings blaehten die ROI-Zahlen auf). Damals wurde die
+ * eine Quelle abgestellt; die Bauart, die aus Wiederholung Wert macht, blieb.
+ */
+export function zaehltAlsErsparnis(lesson) {
+    if (!lesson || istStarterLektion(lesson))
+        return false;
+    // recall_count ist der Stand VOR diesem Abruf. 0 heisst: das erste Mal.
+    const bisher = typeof lesson.recall_count === 'number' ? lesson.recall_count : 0;
+    return bisher <= 0;
+}
 //# sourceMappingURL=wertbeitrag.js.map