@cachly-dev/mcp-server 0.10.128 → 0.10.129

package/dist/src/aussetzer.d.ts

@@ -28,6 +28,18 @@
  * Ueber stdout laeuft das MCP-Protokoll. Eine Zeile Text dort ist kein
  * Hinweis, sondern ein Verbindungsabbruch.
  */
+/**
+ * Aus einem geworfenen Wert einen lesbaren Grund machen.
+ *
+ * JavaScript laesst zu, dass ALLES geworfen wird — ein Error, ein String, ein
+ * undefined. `String(e)` auf einem leeren Objekt ergibt "[object Object]", und
+ * das ist als Ursachenangabe wertlos.
+ *
+ * Gekuerzt auf 200 Zeichen: der Grund gehoert in EINE Protokollzeile. Manche
+ * Anbieter antworten mit einer ganzen HTML-Seite, und ein Protokoll, das
+ * niemand mehr liest, ist wieder Stille.
+ */
+export declare function fehlerText(e: unknown): string;
 /**
  * Meldet einen Aussetzer genau einmal je Grund und Prozess.
  *
@@ -65,3 +77,80 @@ export declare const OHNE_DIENST = "bedeutung-ohne-dienst";
  * Namen fuehrt, sucht spaeter an der falschen Stelle.
  */
 export declare const OHNE_FRAGEVEKTOR = "bedeutung-ohne-fragevektor";
+/**
+ * Der Auffang-catch am Ende des Bedeutungspfads.
+ *
+ * Eigener Grund, weil er etwas anderes bedeutet als die drei darueber: die
+ * sind BENANNTE Ausstiege ("kein Dienst", "keine Vektoren", "Frage nicht
+ * einbettbar") — hier ist etwas Unerwartetes passiert. Wer beides unter einem
+ * Namen fuehrt, sieht nicht, dass er einen Fehler hat statt einer Luecke.
+ */
+export declare const SINNPFAD_ABBRUCH = "bedeutung-abbruch";
+/**
+ * Die Einbettung BEIM SCHREIBEN einer Lektion ist fehlgeschlagen.
+ *
+ * ── Warum dieser Grund am 22.08.2026 dazukam ────────────────────────────────
+ *
+ * Alle Gruende darueber betreffen das SUCHEN. Das Schreiben hatte keinen: in
+ * handlers/brain.ts standen drei leere `catch { }` um die drei Einbettungen
+ * (Volltext, Themenname, Eingaenge). Sie sind mit Absicht fehlertolerant —
+ * eine Lektion muss auch ohne Netz gespeichert werden koennen — aber sie
+ * warfen den GRUND weg.
+ *
+ * Gemessen am 22.08.2026 ueber den Admin-Endpunkt: von 50 gezogenen Instanzen
+ * hatten drei Lektionen (10, 2 und 46) und NULL Vektoren. Warum, konnte
+ * niemand sagen — kein Protokoll, keine Zahl, nichts. Der Wachhund meldete
+ * seit zwei Tagen "Bedeutungsabgleich AUS", ohne dass eine Ursache
+ * feststellbar war.
+ *
+ * Die Fehlerklasse ist bekannt: "Stille wird als gruen gebucht". Der
+ * Unterschied hier ist, dass nicht einmal der Ausfall still war, sondern nur
+ * sein Grund. Ein Alarm ohne Ursache ist ein Alarm, den man abschaltet.
+ *
+ * Die Lektion wird weiterhin gespeichert. Es aendert sich NUR, dass der Grund
+ * einmal je Prozess im Protokoll steht.
+ */
+export declare const OHNE_SCHREIBVEKTOR = "einbettung-beim-schreiben";
+/** Der Versuch ist eingeschaltet, laeuft aber ohne Wirkung (siehe versuch.ts). */
+export declare const VERSUCH_LEER = "versuch-laeuft-leer";
+/** Schluessel-Vorsatz der Vermerke. */
+export declare const AUSSETZER_VORSATZ = "cachly:aussetzer:";
+/** 30 Tage. Wird bei jedem Vermerk erneuert. */
+export declare const AUSSETZER_TTL_SEKUNDEN: number;
+/** Was ein Vermerk enthaelt. */
+export interface Aussetzervermerk {
+    grund: string;
+    anzahl: number;
+    zuletzt: string;
+    text: string;
+}
+/** So viel wie ein Vermerk braucht, ohne den Speicher zu belasten. */
+interface VermerkSpeicher {
+    hincrby(key: string, field: string, increment: number): Promise<number>;
+    hset(key: string, values: Record<string, string>): Promise<unknown>;
+    expire(key: string, seconds: number): Promise<unknown>;
+    keys(pattern: string): Promise<string[]>;
+    hgetall(key: string): Promise<Record<string, string>>;
+}
+/**
+ * Meldet den Aussetzer (einmal je Prozess) UND vermerkt ihn dauerhaft.
+ *
+ * Der Vermerk darf die Anfrage NIE zum Scheitern bringen: wer eine Suche
+ * abbricht, weil er den Ausfall nicht aufschreiben konnte, hat aus einer
+ * Verschlechterung einen Ausfall gemacht. Scheitert das Schreiben, bleibt es
+ * bei der stderr-Zeile — gemeldet ueber meldeEinmal, damit auch dieser
+ * Rueckfall nicht still ist.
+ *
+ * @returns true, wenn die stderr-Meldung wirklich hinausging
+ */
+export declare function meldeUndVermerke(redis: VermerkSpeicher | null | undefined, grund: string, text: string): Promise<boolean>;
+/**
+ * Alle Vermerke der letzten 30 Tage, der haeufigste zuerst.
+ *
+ * Fuer `brain_doctor`. Ein Fehler beim Lesen liefert eine leere Liste — aber
+ * NICHT still: der Aufrufer bekommt `null` und kann "nicht gemessen" von
+ * "nichts gefunden" unterscheiden. Genau dieser Unterschied fehlte an allen
+ * Stellen, aus denen diese Datei entstanden ist.
+ */
+export declare function leseVermerke(redis: VermerkSpeicher | null | undefined): Promise<Aussetzervermerk[] | null>;
+export {};

package/dist/src/aussetzer.js

@@ -30,6 +30,34 @@
  */
 /** Welche Gruende schon gemeldet wurden. Je Prozess, nicht je Anfrage. */
 const gemeldet = new Set();
+/**
+ * Aus einem geworfenen Wert einen lesbaren Grund machen.
+ *
+ * JavaScript laesst zu, dass ALLES geworfen wird — ein Error, ein String, ein
+ * undefined. `String(e)` auf einem leeren Objekt ergibt "[object Object]", und
+ * das ist als Ursachenangabe wertlos.
+ *
+ * Gekuerzt auf 200 Zeichen: der Grund gehoert in EINE Protokollzeile. Manche
+ * Anbieter antworten mit einer ganzen HTML-Seite, und ein Protokoll, das
+ * niemand mehr liest, ist wieder Stille.
+ */
+export function fehlerText(e) {
+    if (e instanceof Error)
+        return (e.message || e.name || 'Error').slice(0, 200);
+    if (typeof e === 'string')
+        return e.slice(0, 200) || 'leerer Text geworfen';
+    if (e === undefined)
+        return 'undefined geworfen (kein Grund mitgegeben)';
+    if (e === null)
+        return 'null geworfen (kein Grund mitgegeben)';
+    try {
+        const j = JSON.stringify(e);
+        return j && j !== '{}' ? j.slice(0, 200) : `${typeof e} ohne Inhalt geworfen`;
+    }
+    catch {
+        return `${typeof e} geworfen, nicht darstellbar`;
+    }
+}
 /**
  * Meldet einen Aussetzer genau einmal je Grund und Prozess.
  *
@@ -79,4 +107,119 @@ export const OHNE_DIENST = 'bedeutung-ohne-dienst';
  * Namen fuehrt, sucht spaeter an der falschen Stelle.
  */
 export const OHNE_FRAGEVEKTOR = 'bedeutung-ohne-fragevektor';
+/**
+ * Der Auffang-catch am Ende des Bedeutungspfads.
+ *
+ * Eigener Grund, weil er etwas anderes bedeutet als die drei darueber: die
+ * sind BENANNTE Ausstiege ("kein Dienst", "keine Vektoren", "Frage nicht
+ * einbettbar") — hier ist etwas Unerwartetes passiert. Wer beides unter einem
+ * Namen fuehrt, sieht nicht, dass er einen Fehler hat statt einer Luecke.
+ */
+export const SINNPFAD_ABBRUCH = 'bedeutung-abbruch';
+/**
+ * Die Einbettung BEIM SCHREIBEN einer Lektion ist fehlgeschlagen.
+ *
+ * ── Warum dieser Grund am 22.08.2026 dazukam ────────────────────────────────
+ *
+ * Alle Gruende darueber betreffen das SUCHEN. Das Schreiben hatte keinen: in
+ * handlers/brain.ts standen drei leere `catch { }` um die drei Einbettungen
+ * (Volltext, Themenname, Eingaenge). Sie sind mit Absicht fehlertolerant —
+ * eine Lektion muss auch ohne Netz gespeichert werden koennen — aber sie
+ * warfen den GRUND weg.
+ *
+ * Gemessen am 22.08.2026 ueber den Admin-Endpunkt: von 50 gezogenen Instanzen
+ * hatten drei Lektionen (10, 2 und 46) und NULL Vektoren. Warum, konnte
+ * niemand sagen — kein Protokoll, keine Zahl, nichts. Der Wachhund meldete
+ * seit zwei Tagen "Bedeutungsabgleich AUS", ohne dass eine Ursache
+ * feststellbar war.
+ *
+ * Die Fehlerklasse ist bekannt: "Stille wird als gruen gebucht". Der
+ * Unterschied hier ist, dass nicht einmal der Ausfall still war, sondern nur
+ * sein Grund. Ein Alarm ohne Ursache ist ein Alarm, den man abschaltet.
+ *
+ * Die Lektion wird weiterhin gespeichert. Es aendert sich NUR, dass der Grund
+ * einmal je Prozess im Protokoll steht.
+ */
+export const OHNE_SCHREIBVEKTOR = 'einbettung-beim-schreiben';
+/** Der Versuch ist eingeschaltet, laeuft aber ohne Wirkung (siehe versuch.ts). */
+export const VERSUCH_LEER = 'versuch-laeuft-leer';
+// ── Der Vermerk, der einen Neustart ueberlebt ───────────────────────────────
+//
+// meldeEinmal schreibt nach stderr und merkt sich den Grund im
+// Arbeitsspeicher. Beides ist nach einem Neustart weg — bei jedem Deploy,
+// jedem Absturz, jeder Skalierung. Gemessen am 20.08.2026 (Karte
+// opupbt3l9wcq): eine Fehlkonfiguration konnte so WOCHENLANG bestehen, ohne
+// dass jemand sie sah, weil "keine Daten" und "noch nicht genug Daten" von
+// aussen gleich aussehen.
+//
+// Deshalb zusaetzlich ein Vermerk in Valkey: Zaehler, letzter Zeitpunkt,
+// letzter Text. `brain_doctor` liest ihn, also braucht niemand ein Protokoll
+// zu durchsuchen.
+//
+// Die Lebensdauer wird bei JEDEM Vermerk erneuert. Damit heisst "vorhanden"
+// immer "in den letzten 30 Tagen passiert" — ein Aussetzer von vor einem
+// halben Jahr steht nicht mehr im Weg, und ein laufender verschwindet nie.
+/** Schluessel-Vorsatz der Vermerke. */
+export const AUSSETZER_VORSATZ = 'cachly:aussetzer:';
+/** 30 Tage. Wird bei jedem Vermerk erneuert. */
+export const AUSSETZER_TTL_SEKUNDEN = 30 * 24 * 60 * 60;
+/**
+ * Meldet den Aussetzer (einmal je Prozess) UND vermerkt ihn dauerhaft.
+ *
+ * Der Vermerk darf die Anfrage NIE zum Scheitern bringen: wer eine Suche
+ * abbricht, weil er den Ausfall nicht aufschreiben konnte, hat aus einer
+ * Verschlechterung einen Ausfall gemacht. Scheitert das Schreiben, bleibt es
+ * bei der stderr-Zeile — gemeldet ueber meldeEinmal, damit auch dieser
+ * Rueckfall nicht still ist.
+ *
+ * @returns true, wenn die stderr-Meldung wirklich hinausging
+ */
+export async function meldeUndVermerke(redis, grund, text) {
+    const gemeldetJetzt = meldeEinmal(grund, text);
+    if (!redis)
+        return gemeldetJetzt;
+    try {
+        const key = `${AUSSETZER_VORSATZ}${grund}`;
+        await redis.hincrby(key, 'anzahl', 1);
+        await redis.hset(key, { zuletzt: new Date().toISOString(), text: text.slice(0, 500) });
+        await redis.expire(key, AUSSETZER_TTL_SEKUNDEN);
+    }
+    catch (e) {
+        meldeEinmal(`${grund}-vermerk`, `der Aussetzer liess sich nicht vermerken (${e instanceof Error ? e.message : String(e)}) `
+            + '— er steht nur in diesem Protokoll und ist nach einem Neustart weg');
+    }
+    return gemeldetJetzt;
+}
+/**
+ * Alle Vermerke der letzten 30 Tage, der haeufigste zuerst.
+ *
+ * Fuer `brain_doctor`. Ein Fehler beim Lesen liefert eine leere Liste — aber
+ * NICHT still: der Aufrufer bekommt `null` und kann "nicht gemessen" von
+ * "nichts gefunden" unterscheiden. Genau dieser Unterschied fehlte an allen
+ * Stellen, aus denen diese Datei entstanden ist.
+ */
+export async function leseVermerke(redis) {
+    if (!redis)
+        return null;
+    try {
+        const keys = await redis.keys(`${AUSSETZER_VORSATZ}*`);
+        const vermerke = [];
+        for (const key of keys) {
+            const h = await redis.hgetall(key);
+            if (!h || !h.anzahl)
+                continue;
+            vermerke.push({
+                grund: key.slice(AUSSETZER_VORSATZ.length),
+                anzahl: Number(h.anzahl) || 0,
+                zuletzt: h.zuletzt ?? '',
+                text: h.text ?? '',
+            });
+        }
+        vermerke.sort((a, b) => b.anzahl - a.anzahl || a.grund.localeCompare(b.grund));
+        return vermerke;
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=aussetzer.js.map

package/dist/src/aussetzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"aussetzer.js","sourceRoot":"","sources":["../../src/aussetzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAY;IACrD,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,eAAe,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEvD,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC"}
+{"version":3,"file":"aussetzer.js","sourceRoot":"","sources":["../../src/aussetzer.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,5 @@
 {
-  "version": "0.10.128",
-  "commit": "0646aac",
-  "gebautAm": "2026-08-20T21:20:33.284Z"
+  "version": "0.10.129",
+  "commit": "2df4e88",
+  "gebautAm": "2026-08-22T10:34:37.954Z"
 }

package/dist/src/eingaenge.d.ts

@@ -105,6 +105,30 @@ export declare class Eingangsbestand {
      * Lektionen mit vielen Türen bestrafen — gemessen und belegt am 20.08.
      */
     besteNaehe(frage: number[], topic: string): number;
+    /**
+     * Die MITTLERE Nähe über alle Eingänge einer Lektion. -2, wenn sie keine hat.
+     *
+     * Sie ersetzt `besteNaehe` nicht, sie steht daneben. Am 21.08.2026 wurde
+     * "Mittelwert STATT Maximum" gemessen und verworfen — er verlor auf der
+     * Findequote@3 (55 und 62 Prozent gegen 58 und 63).
+     *
+     * Dieselbe Messung zeigte aber, dass die beiden ENTGEGENGESETZT ziehen: das
+     * Maximum gewinnt auf @3, der Mittelwert auf Platz 1, gleichgerichtet auf
+     * zwei unabhängigen Fragensätzen. Sie messen Verschiedenes.
+     *
+     *   Maximum      "gibt es EINE Tür, die genau auf diese Frage passt?"
+     *   Mittelwert   "passt die Lektion als GANZE zu dieser Frage?"
+     *
+     * Das Maximum allein belohnt eine Lektion, die zufällig eine gut passende
+     * Tür trägt und sonst am Thema vorbeigeht. Der Mittelwert allein bestraft
+     * eine breit aufgestellte Lektion, die nur mit einer Tür trifft. Nebeneinander
+     * heben sich die beiden Fehler teilweise auf.
+     *
+     * Ohne Schwelle, anders als das Maximum: ein Mittelwert liegt naturgemäß
+     * niedriger, und die für das Maximum abgetastete 0,5 würde ihn fast überall
+     * auf "kein Wert" drücken — das Merkmal wäre still abgeschaltet.
+     */
+    mittelNaehe(frage: number[], topic: string): number;
     /** Die ähnlichsten Lektionen, je Lektion ihr bester Eingang. */
     aehnlichste(frage: number[], anzahl: number): Array<{
         topic: string;

package/dist/src/eingaenge.js

@@ -200,6 +200,38 @@ export class Eingangsbestand {
         }
         return best;
     }
+    /**
+     * Die MITTLERE Nähe über alle Eingänge einer Lektion. -2, wenn sie keine hat.
+     *
+     * Sie ersetzt `besteNaehe` nicht, sie steht daneben. Am 21.08.2026 wurde
+     * "Mittelwert STATT Maximum" gemessen und verworfen — er verlor auf der
+     * Findequote@3 (55 und 62 Prozent gegen 58 und 63).
+     *
+     * Dieselbe Messung zeigte aber, dass die beiden ENTGEGENGESETZT ziehen: das
+     * Maximum gewinnt auf @3, der Mittelwert auf Platz 1, gleichgerichtet auf
+     * zwei unabhängigen Fragensätzen. Sie messen Verschiedenes.
+     *
+     *   Maximum      "gibt es EINE Tür, die genau auf diese Frage passt?"
+     *   Mittelwert   "passt die Lektion als GANZE zu dieser Frage?"
+     *
+     * Das Maximum allein belohnt eine Lektion, die zufällig eine gut passende
+     * Tür trägt und sonst am Thema vorbeigeht. Der Mittelwert allein bestraft
+     * eine breit aufgestellte Lektion, die nur mit einer Tür trifft. Nebeneinander
+     * heben sich die beiden Fehler teilweise auf.
+     *
+     * Ohne Schwelle, anders als das Maximum: ein Mittelwert liegt naturgemäß
+     * niedriger, und die für das Maximum abgetastete 0,5 würde ihn fast überall
+     * auf "kein Wert" drücken — das Merkmal wäre still abgeschaltet.
+     */
+    mittelNaehe(frage, topic) {
+        const vs = this.eingaenge.get(topic);
+        if (!vs?.length)
+            return -2;
+        let summe = 0;
+        for (const v of vs)
+            summe += kosinus(frage, v);
+        return summe / vs.length;
+    }
     /** Die ähnlichsten Lektionen, je Lektion ihr bester Eingang. */
     aehnlichste(frage, anzahl) {
         const aus = [];

package/dist/src/eingaenge.js.map

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

package/dist/src/feldreparatur.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Verklebte Felder trennen, BEVOR eine Lektion geschrieben wird.
+ *
+ * ── Der Anlass, gemessen am 22.08.2026 ──────────────────────────────────────
+ *
+ * `ohneMarkierungen()` in eingaenge.ts filtert beim Einbetten die Zeichenkette
+ * `</what_worked>\n<what_failed>` aus dem Text. Der Kommentar dort sagt, viele
+ * Lektionen enthielten das "woertlich". Was er NICHT sagt: wo es herkommt.
+ *
+ * Es kommt beim SCHREIBEN herein. Wer `learn_from_attempts` aufruft und ein
+ * Feld mit dem falschen Tag schliesst, uebergibt den gesamten Rest — inklusive
+ * der Marke des naechsten Feldes — als Inhalt von `what_worked`. Das Ergebnis
+ * sieht aus wie eine gefuellte Lektion, hat aber ein leeres `what_failed` und
+ * einen Fliesstext mit Steuerzeichen darin.
+ *
+ * Belegt an derselben Lektion zweimal hintereinander, beide Male unbemerkt:
+ * die Rueckmeldung des Werkzeugs zeigte den verklebten Text an, ohne dass
+ * irgendetwas rot wurde.
+ *
+ * ── Warum hier und nicht beim Lesen ─────────────────────────────────────────
+ *
+ * Beim Lesen wird gefiltert, damit der Vektor nicht auf Feldnamen zeigt. Das
+ * ist richtig und bleibt. Es heilt aber nur die Einbettung — im Bestand steht
+ * der Text weiter falsch, `what_failed` bleibt leer, und das Briefing zeigt
+ * Steuerzeichen. Zwei Stellen fuer dasselbe Problem waeren die uebliche
+ * Fehlerklasse dieses Hauses: eine Information an zwei Orten gepflegt.
+ *
+ * Deshalb wird HIER repariert, an der einzigen Stelle, an der der Fehler
+ * entsteht.
+ *
+ * ── Was es ausdruecklich NICHT tut ──────────────────────────────────────────
+ *
+ * Es fasst Text NICHT an, der die Feldnamen bloss ERWAEHNT. "der what_failed-
+ * Text stand in what_worked" ist ein voellig normaler Satz in einer Lektion
+ * ueber genau diesen Fehler. Getrennt wird nur an einer echten Marke, also an
+ * spitzen Klammern.
+ *
+ * Und es wirft nie Text weg. Findet es keinen Platz fuer ein Stueck, bleibt
+ * es stehen, wo es war — nur ohne die Marke.
+ */
+/** Die Felder einer Lektion, die verkleben koennen. */
+export interface Lektionsfelder {
+    what_worked: string;
+    what_failed?: string;
+    context?: string;
+}
+/** Ist in diesem Text ueberhaupt eine Marke? Billig, fuer den Normalfall. */
+export declare function hatFeldmarke(text: string | undefined): boolean;
+/**
+ * Trennt verklebte Felder auf und gibt sie einzeln zurueck.
+ *
+ * Der Text VOR der ersten Marke bleibt in dem Feld, in dem er stand. Jedes
+ * Stueck dahinter geht in das Feld, dessen Marke davorstand — aber nur, wenn
+ * dieses Feld noch leer ist. Ein bereits gefuelltes Feld wird nie
+ * ueberschrieben; das Stueck haengt sich dann hinten an, damit nichts
+ * verlorengeht.
+ */
+export declare function repariereFelder(f: Lektionsfelder): Lektionsfelder;

package/dist/src/feldreparatur.js

@@ -0,0 +1,113 @@
+/**
+ * Verklebte Felder trennen, BEVOR eine Lektion geschrieben wird.
+ *
+ * ── Der Anlass, gemessen am 22.08.2026 ──────────────────────────────────────
+ *
+ * `ohneMarkierungen()` in eingaenge.ts filtert beim Einbetten die Zeichenkette
+ * `</what_worked>\n<what_failed>` aus dem Text. Der Kommentar dort sagt, viele
+ * Lektionen enthielten das "woertlich". Was er NICHT sagt: wo es herkommt.
+ *
+ * Es kommt beim SCHREIBEN herein. Wer `learn_from_attempts` aufruft und ein
+ * Feld mit dem falschen Tag schliesst, uebergibt den gesamten Rest — inklusive
+ * der Marke des naechsten Feldes — als Inhalt von `what_worked`. Das Ergebnis
+ * sieht aus wie eine gefuellte Lektion, hat aber ein leeres `what_failed` und
+ * einen Fliesstext mit Steuerzeichen darin.
+ *
+ * Belegt an derselben Lektion zweimal hintereinander, beide Male unbemerkt:
+ * die Rueckmeldung des Werkzeugs zeigte den verklebten Text an, ohne dass
+ * irgendetwas rot wurde.
+ *
+ * ── Warum hier und nicht beim Lesen ─────────────────────────────────────────
+ *
+ * Beim Lesen wird gefiltert, damit der Vektor nicht auf Feldnamen zeigt. Das
+ * ist richtig und bleibt. Es heilt aber nur die Einbettung — im Bestand steht
+ * der Text weiter falsch, `what_failed` bleibt leer, und das Briefing zeigt
+ * Steuerzeichen. Zwei Stellen fuer dasselbe Problem waeren die uebliche
+ * Fehlerklasse dieses Hauses: eine Information an zwei Orten gepflegt.
+ *
+ * Deshalb wird HIER repariert, an der einzigen Stelle, an der der Fehler
+ * entsteht.
+ *
+ * ── Was es ausdruecklich NICHT tut ──────────────────────────────────────────
+ *
+ * Es fasst Text NICHT an, der die Feldnamen bloss ERWAEHNT. "der what_failed-
+ * Text stand in what_worked" ist ein voellig normaler Satz in einer Lektion
+ * ueber genau diesen Fehler. Getrennt wird nur an einer echten Marke, also an
+ * spitzen Klammern.
+ *
+ * Und es wirft nie Text weg. Findet es keinen Platz fuer ein Stueck, bleibt
+ * es stehen, wo es war — nur ohne die Marke.
+ */
+/** Nur diese drei. `topic` und `outcome` sind kurz und kleben nicht. */
+const FELDNAMEN = ['what_worked', 'what_failed', 'context'];
+/**
+ * Eine Marke ist ein Feldname in spitzen Klammern — in allen Formen, die
+ * tatsaechlich vorkommen:
+ *
+ *   </what_worked>                       schliessend
+ *   <what_failed>                        oeffnend
+ *   <parameter name="what_failed">       die Form, die den Fehler ausloest
+ *
+ * Ohne spitze Klammern ist es Fliesstext und bleibt unberuehrt.
+ */
+const MARKE = new RegExp(String.raw `<\/?(?:parameter\s+name\s*=\s*["']?)?(${FELDNAMEN.join('|')})["']?\s*\/?>`, 'gi');
+/** Ist in diesem Text ueberhaupt eine Marke? Billig, fuer den Normalfall. */
+export function hatFeldmarke(text) {
+    if (!text)
+        return false;
+    MARKE.lastIndex = 0;
+    return MARKE.test(text);
+}
+/**
+ * Trennt verklebte Felder auf und gibt sie einzeln zurueck.
+ *
+ * Der Text VOR der ersten Marke bleibt in dem Feld, in dem er stand. Jedes
+ * Stueck dahinter geht in das Feld, dessen Marke davorstand — aber nur, wenn
+ * dieses Feld noch leer ist. Ein bereits gefuelltes Feld wird nie
+ * ueberschrieben; das Stueck haengt sich dann hinten an, damit nichts
+ * verlorengeht.
+ */
+export function repariereFelder(f) {
+    if (!hatFeldmarke(f.what_worked) && !hatFeldmarke(f.what_failed) && !hatFeldmarke(f.context)) {
+        return f;
+    }
+    const aus = {
+        what_worked: '',
+        what_failed: f.what_failed ?? '',
+        context: f.context ?? '',
+    };
+    // Nur what_worked wird zerlegt — dort landet der Rest, weil es das erste
+    // lange Feld ist. Die anderen beiden werden nur von Marken befreit.
+    const text = f.what_worked ?? '';
+    const stuecke = [];
+    let letzterIndex = 0;
+    let aktuellesZiel = 'what_worked';
+    MARKE.lastIndex = 0;
+    for (let m = MARKE.exec(text); m !== null; m = MARKE.exec(text)) {
+        stuecke.push({ ziel: aktuellesZiel, text: text.slice(letzterIndex, m.index) });
+        const genannt = m[1].toLowerCase();
+        // Eine SCHLIESSENDE Marke sagt nur "hier endet etwas" und nennt kein
+        // neues Ziel. Der Text danach gehoert dem naechsten genannten Feld —
+        // bis dahin bleibt er beim bisherigen.
+        aktuellesZiel = m[0].startsWith('</') ? aktuellesZiel : genannt;
+        letzterIndex = m.index + m[0].length;
+    }
+    stuecke.push({ ziel: aktuellesZiel, text: text.slice(letzterIndex) });
+    for (const s of stuecke) {
+        const t = s.text.trim();
+        if (!t)
+            continue;
+        if (aus[s.ziel])
+            aus[s.ziel] = `${aus[s.ziel]}\n\n${t}`;
+        else
+            aus[s.ziel] = t;
+    }
+    // Reste in den anderen beiden Feldern: Marke raus, Text behalten.
+    const entmarken = (s) => s.replace(MARKE, ' ').replace(/[ \t]{2,}/g, ' ').trim();
+    return {
+        what_worked: entmarken(aus.what_worked),
+        what_failed: aus.what_failed ? entmarken(aus.what_failed) : f.what_failed,
+        context: aus.context ? entmarken(aus.context) : f.context,
+    };
+}
+//# sourceMappingURL=feldreparatur.js.map

package/dist/src/feldreparatur.js.map

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

package/dist/src/handlers/advanced.js

@@ -1,6 +1,6 @@
 import { ckgSlug } from '../ckg.js';
 import { safeJsonParse } from '../utils.js';
-import { ersparteMinuten } from '../wertbeitrag.js';
+import { ersparteMinuten, zaehltAlsErsparnis } from '../wertbeitrag.js';
 export const ADVANCED_TOOL_NAMES = new Set([
     'memory_consolidate', 'brain_diff', 'causal_trace', 'knowledge_decay', 'autopilot',
 ]);
@@ -379,8 +379,8 @@ export async function handleAdvancedTool(name, args, getConnection, _apiFetch) {
                     lines.push(`\`\`\``);
                     lines.push('');
                     // Track estimated time saved — causal_trace finding a known fix is worth 1-4h.
-                    // Starter-Lektionen zaehlen 0 — siehe wertbeitrag.ts.
-                    const savedMins = ersparteMinuten(topSolution, 'trace');
+                    // Nur beim ERSTEN Mal, und nie fuer den Startvorrat — wertbeitrag.ts.
+                    const savedMins = zaehltAlsErsparnis(topSolution) ? ersparteMinuten(topSolution, 'trace') : 0;
                     if (savedMins > 0) {
                         redis.incrbyfloat(`cachly:stats:time_saved_mins:${instance_id}`, savedMins).catch(() => { });
                     }