@cachly-dev/mcp-server 0.10.123 → 0.10.125

package/dist/index.d.ts

@@ -0,0 +1 @@
+import './src/index.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+// Kompatibilitäts-Einstieg: Plattformen wie Glama erzeugen ihre Build-Specs
+// automatisch und starten mit `node dist/index.js`. tsc (rootDir ".") legt den
+// echten Einstieg aber unter dist/src/index.js ab. Diese Datei kompiliert nach
+// dist/index.js und startet dort denselben Server — der Import genügt, weil
+// src/index.ts auf Modul-Ebene startet.
+import './src/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,wCAAwC;AACxC,OAAO,gBAAgB,CAAC"}

package/dist/src/aussetzer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Meldestelle fuer stille Aussetzer.
+ *
+ * ── Warum es das gibt ───────────────────────────────────────────────────────
+ *
+ * Am 20.08.2026 wurde am Produktionsspeicher gemessen: `cachly:lesson:vec:*`
+ * war LEER — 0 Vektoren bei 506 Lektionen. Der Recall-Pfad steigt bei
+ * `vektorbestand.groesse === 0` aus und faellt auf den reinen Wortabgleich
+ * zurueck. Er tut das STUMM.
+ *
+ * Von aussen ist dieser Zustand von "alles in Ordnung" nicht zu
+ * unterscheiden: die Suche liefert weiter Ergebnisse, nur schlechtere. Die am
+ * 19.08. gemessene Verbesserung von 21 auf 40 Prozent existierte in
+ * Produktion nie, und nichts hat es gesagt.
+ *
+ * Das ist die Fehlerklasse "Stille wird als gruen gebucht". Diese Datei ist
+ * die Gegenmassnahme an der billigsten Stelle: eine Zeile im Protokoll.
+ *
+ * ── Warum nur EINMAL je Grund ───────────────────────────────────────────────
+ *
+ * Der Recall-Pfad laeuft bei jeder Anfrage. Eine Zeile je Anfrage waere nach
+ * einer Stunde ein Protokoll, das niemand mehr liest — und ein Protokoll, das
+ * niemand liest, ist wieder Stille. Einmal je Grund und Prozess ist die
+ * Menge, die auffaellt, ohne zu ermueden.
+ *
+ * ── Warum stderr und nicht stdout ───────────────────────────────────────────
+ *
+ * Ueber stdout laeuft das MCP-Protokoll. Eine Zeile Text dort ist kein
+ * Hinweis, sondern ein Verbindungsabbruch.
+ */
+/**
+ * Meldet einen Aussetzer genau einmal je Grund und Prozess.
+ *
+ * @param grund kurzer Schluessel, z. B. 'bedeutung-ohne-vektoren'
+ * @param text  was ausgefallen ist und was das fuer das Ergebnis heisst
+ * @returns true, wenn diese Meldung wirklich hinausging
+ */
+export declare function meldeEinmal(grund: string, text: string): boolean;
+/**
+ * Wurde dieser Grund in diesem Prozess schon gemeldet?
+ *
+ * Fuer `brain_doctor`: dort soll stehen, was hier passiert ist, ohne dass
+ * jemand ein Protokoll durchsuchen muss.
+ */
+export declare function schonGemeldet(grund: string): boolean;
+/** Alle bisher gemeldeten Gruende, in der Reihenfolge des Auftretens. */
+export declare function gemeldeteGruende(): string[];
+/**
+ * Setzt die Merkliste zurueck.
+ *
+ * Nur fuer Tests. Ohne das wuerde die erste Testdatei alle weiteren blind
+ * machen — genau der Fehler, gegen den diese Datei antritt.
+ */
+export declare function setzeAussetzerZurueck(): void;
+/** Der Grund, um den es beim Anlass ging: Bedeutungsabgleich ohne Vektoren. */
+export declare const OHNE_VEKTOREN = "bedeutung-ohne-vektoren";
+/** Der Nachbarfall: es gibt gar keinen Dienst zum Einbetten. */
+export declare const OHNE_DIENST = "bedeutung-ohne-dienst";
+/**
+ * Der Bestand ist da, aber die FRAGE liess sich nicht einbetten.
+ *
+ * Eigener Grund und nicht mit OHNE_VEKTOREN zusammengelegt: hier ist der
+ * Bestand gesund und der fremde Dienst hat gerade nicht geantwortet. Das ist
+ * ein Netzproblem und keine fehlende Nachruestung — wer beides unter einem
+ * Namen fuehrt, sucht spaeter an der falschen Stelle.
+ */
+export declare const OHNE_FRAGEVEKTOR = "bedeutung-ohne-fragevektor";

package/dist/src/aussetzer.js

@@ -0,0 +1,82 @@
+/**
+ * Meldestelle fuer stille Aussetzer.
+ *
+ * ── Warum es das gibt ───────────────────────────────────────────────────────
+ *
+ * Am 20.08.2026 wurde am Produktionsspeicher gemessen: `cachly:lesson:vec:*`
+ * war LEER — 0 Vektoren bei 506 Lektionen. Der Recall-Pfad steigt bei
+ * `vektorbestand.groesse === 0` aus und faellt auf den reinen Wortabgleich
+ * zurueck. Er tut das STUMM.
+ *
+ * Von aussen ist dieser Zustand von "alles in Ordnung" nicht zu
+ * unterscheiden: die Suche liefert weiter Ergebnisse, nur schlechtere. Die am
+ * 19.08. gemessene Verbesserung von 21 auf 40 Prozent existierte in
+ * Produktion nie, und nichts hat es gesagt.
+ *
+ * Das ist die Fehlerklasse "Stille wird als gruen gebucht". Diese Datei ist
+ * die Gegenmassnahme an der billigsten Stelle: eine Zeile im Protokoll.
+ *
+ * ── Warum nur EINMAL je Grund ───────────────────────────────────────────────
+ *
+ * Der Recall-Pfad laeuft bei jeder Anfrage. Eine Zeile je Anfrage waere nach
+ * einer Stunde ein Protokoll, das niemand mehr liest — und ein Protokoll, das
+ * niemand liest, ist wieder Stille. Einmal je Grund und Prozess ist die
+ * Menge, die auffaellt, ohne zu ermueden.
+ *
+ * ── Warum stderr und nicht stdout ───────────────────────────────────────────
+ *
+ * Ueber stdout laeuft das MCP-Protokoll. Eine Zeile Text dort ist kein
+ * Hinweis, sondern ein Verbindungsabbruch.
+ */
+/** Welche Gruende schon gemeldet wurden. Je Prozess, nicht je Anfrage. */
+const gemeldet = new Set();
+/**
+ * Meldet einen Aussetzer genau einmal je Grund und Prozess.
+ *
+ * @param grund kurzer Schluessel, z. B. 'bedeutung-ohne-vektoren'
+ * @param text  was ausgefallen ist und was das fuer das Ergebnis heisst
+ * @returns true, wenn diese Meldung wirklich hinausging
+ */
+export function meldeEinmal(grund, text) {
+    if (gemeldet.has(grund))
+        return false;
+    gemeldet.add(grund);
+    console.error(`[aussetzer] ${grund}: ${text}`);
+    return true;
+}
+/**
+ * Wurde dieser Grund in diesem Prozess schon gemeldet?
+ *
+ * Fuer `brain_doctor`: dort soll stehen, was hier passiert ist, ohne dass
+ * jemand ein Protokoll durchsuchen muss.
+ */
+export function schonGemeldet(grund) {
+    return gemeldet.has(grund);
+}
+/** Alle bisher gemeldeten Gruende, in der Reihenfolge des Auftretens. */
+export function gemeldeteGruende() {
+    return [...gemeldet];
+}
+/**
+ * Setzt die Merkliste zurueck.
+ *
+ * Nur fuer Tests. Ohne das wuerde die erste Testdatei alle weiteren blind
+ * machen — genau der Fehler, gegen den diese Datei antritt.
+ */
+export function setzeAussetzerZurueck() {
+    gemeldet.clear();
+}
+/** Der Grund, um den es beim Anlass ging: Bedeutungsabgleich ohne Vektoren. */
+export const OHNE_VEKTOREN = 'bedeutung-ohne-vektoren';
+/** Der Nachbarfall: es gibt gar keinen Dienst zum Einbetten. */
+export const OHNE_DIENST = 'bedeutung-ohne-dienst';
+/**
+ * Der Bestand ist da, aber die FRAGE liess sich nicht einbetten.
+ *
+ * Eigener Grund und nicht mit OHNE_VEKTOREN zusammengelegt: hier ist der
+ * Bestand gesund und der fremde Dienst hat gerade nicht geantwortet. Das ist
+ * ein Netzproblem und keine fehlende Nachruestung — wer beides unter einem
+ * Namen fuehrt, sucht spaeter an der falschen Stelle.
+ */
+export const OHNE_FRAGEVEKTOR = 'bedeutung-ohne-fragevektor';
+//# sourceMappingURL=aussetzer.js.map

package/dist/src/aussetzer.js.map

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

package/dist/src/autor-abzeichen.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Wer hat diese Lektion geschrieben — ich oder jemand anderes?
+ *
+ * `session_start_summary` nimmt seit jeher einen Parameter `author` entgegen
+ * und beschreibt ihn in der Werkzeug-Spezifikation so:
+ *
+ *   "Your name or handle (optional). Same as session_start — used for team
+ *    lesson filtering."
+ *
+ * Die Zusage wurde nie eingeloest. Der Handler holte den Wert aus den
+ * Argumenten und benutzte ihn danach nirgends; eslint meldete ihn seit
+ * Monaten als ungenutzte Variable. Wer den Parameter setzte, bekam exakt
+ * dieselbe Ausgabe wie ohne ihn.
+ *
+ * Fehlerklasse: eine Zusage an zwei Orten — hier in der Spezifikation, dort
+ * im Code — und nur einer wurde gepflegt. Dieselbe Form wie die Kommentarzeile
+ * am Frei-Limit, die "the #1 result is always returned" versprach, waehrend
+ * der Zweig darunter null lieferte.
+ *
+ * Reines Modul, weil die Entscheidung eine Rechnung ist: dieselbe Regel, die
+ * `smart_recall` schon anwendet, an EINER Stelle statt zweimal abgeschrieben.
+ */
+/**
+ * Das Abzeichen hinter einer Lektion — leer, wenn sie von mir selbst stammt
+ * oder niemand als Autor eingetragen ist.
+ *
+ * Bewusst KEIN Abzeichen fuer die eigenen Lektionen: in einem Brain, das
+ * ueberwiegend einer Person gehoert, stuende sonst hinter jeder Zeile derselbe
+ * Name, und das Abzeichen verlöre genau die Aussage, für die es da ist.
+ */
+export declare function autorAbzeichen(lektionsAutor: string | null | undefined, anfragender: string | null | undefined): string;
+/**
+ * Wie viele der gezeigten Lektionen von jemand anderem stammen.
+ *
+ * Das ist der Wert, den nur ein GETEILTES Gedaechtnis liefert — und deshalb
+ * die Zahl, die es zu nennen lohnt. Ist sie null, wird auch nichts gesagt:
+ * "0 von Teamkollegen" ist keine Nachricht, sondern Rauschen.
+ */
+export declare function fremdanteil(lektionen: readonly {
+    author?: string | null;
+}[], anfragender: string | null | undefined): number;

package/dist/src/autor-abzeichen.js

@@ -0,0 +1,56 @@
+/**
+ * Wer hat diese Lektion geschrieben — ich oder jemand anderes?
+ *
+ * `session_start_summary` nimmt seit jeher einen Parameter `author` entgegen
+ * und beschreibt ihn in der Werkzeug-Spezifikation so:
+ *
+ *   "Your name or handle (optional). Same as session_start — used for team
+ *    lesson filtering."
+ *
+ * Die Zusage wurde nie eingeloest. Der Handler holte den Wert aus den
+ * Argumenten und benutzte ihn danach nirgends; eslint meldete ihn seit
+ * Monaten als ungenutzte Variable. Wer den Parameter setzte, bekam exakt
+ * dieselbe Ausgabe wie ohne ihn.
+ *
+ * Fehlerklasse: eine Zusage an zwei Orten — hier in der Spezifikation, dort
+ * im Code — und nur einer wurde gepflegt. Dieselbe Form wie die Kommentarzeile
+ * am Frei-Limit, die "the #1 result is always returned" versprach, waehrend
+ * der Zweig darunter null lieferte.
+ *
+ * Reines Modul, weil die Entscheidung eine Rechnung ist: dieselbe Regel, die
+ * `smart_recall` schon anwendet, an EINER Stelle statt zweimal abgeschrieben.
+ */
+/**
+ * Das Abzeichen hinter einer Lektion — leer, wenn sie von mir selbst stammt
+ * oder niemand als Autor eingetragen ist.
+ *
+ * Bewusst KEIN Abzeichen fuer die eigenen Lektionen: in einem Brain, das
+ * ueberwiegend einer Person gehoert, stuende sonst hinter jeder Zeile derselbe
+ * Name, und das Abzeichen verlöre genau die Aussage, für die es da ist.
+ */
+export function autorAbzeichen(lektionsAutor, anfragender) {
+    const autor = (lektionsAutor ?? '').trim();
+    if (!autor)
+        return '';
+    const ich = (anfragender ?? '').trim();
+    if (ich && autor === ich)
+        return '';
+    return ` · 👤 ${autor}`;
+}
+/**
+ * Wie viele der gezeigten Lektionen von jemand anderem stammen.
+ *
+ * Das ist der Wert, den nur ein GETEILTES Gedaechtnis liefert — und deshalb
+ * die Zahl, die es zu nennen lohnt. Ist sie null, wird auch nichts gesagt:
+ * "0 von Teamkollegen" ist keine Nachricht, sondern Rauschen.
+ */
+export function fremdanteil(lektionen, anfragender) {
+    const ich = (anfragender ?? '').trim();
+    if (!ich)
+        return 0;
+    return lektionen.filter(l => {
+        const autor = (l.author ?? '').trim();
+        return autor.length > 0 && autor !== ich;
+    }).length;
+}
+//# sourceMappingURL=autor-abzeichen.js.map

package/dist/src/autor-abzeichen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autor-abzeichen.js","sourceRoot":"","sources":["../../src/autor-abzeichen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,aAAwC,EAAE,WAAsC;IAC7G,MAAM,KAAK,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,GAAG,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,SAAS,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,SAAgD,EAChD,WAAsC;IAEtC,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC;IACnB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC;IAC3C,CAAC,CAAC,CAAC,MAAM,CAAC;AACZ,CAAC"}

package/dist/src/autor.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Wer hat diese Lektion geschrieben?
+ *
+ * ── Der Befund, gemessen am 19.08.2026 ──────────────────────────────────────
+ *
+ * 195 von 493 Lektionen tragen keinen Autor — zwei Fuenftel. Ohne Autor zaehlt
+ * keine Team-Wiederverwendung, brain_who_knows findet niemanden, und das
+ * Versprechen "geteiltes Gedaechtnis" ist von einer Notizdatei nicht zu
+ * unterscheiden.
+ *
+ * ── Und es war unser Fehler, nicht der der Nutzer ───────────────────────────
+ *
+ * Heinrich, 19.08.2026: "das mit dem Autor war doch eher ein Fehler von uns
+ * bzw. wie cachly die Anweisungen fuer das Brain geschrieben hat, denn der
+ * Autor steht doch in den Git-Zugangsdaten."
+ *
+ * Genau so ist es. `author` war ein OPTIONALES Feld, das ein Agent bei jedem
+ * Aufruf mitschicken sollte — und natuerlich vergisst. Dabei steht der Name
+ * seit jeher zwei Zeilen entfernt in `git config user.name`. Der Code holte
+ * ihn sogar schon, aber nur an einer anderen Stelle (index.ts, fuer die
+ * Demo-Ausgabe) und nie fuer die Lektion selbst.
+ *
+ * Ein Pflichtfeld, das man vergessen kann, ist kein Pflichtfeld. Ein Wert, der
+ * sich herleiten laesst, gehoert hergeleitet.
+ *
+ * ── Reihenfolge, absichtlich in dieser Richtung ─────────────────────────────
+ *
+ *   1. was ausdruecklich uebergeben wurde  — der Aufrufer weiss es besser
+ *   2. CACHLY_AUTHOR                        — bewusst gesetzt, etwa in der CI
+ *   3. git config user.name                 — der angemeldete Mensch
+ *   4. git config user.email (Teil vor dem @)
+ *   5. leer — dann steht dort ehrlich nichts statt eines geratenen Namens
+ *
+ * Schritt 5 ist wichtig: lieber kein Autor als ein falscher. Ein erfundener
+ * Name macht aus einer fehlenden Zuordnung eine falsche, und die faellt
+ * niemandem mehr auf.
+ */
+/** Ein Git-Wert, oder leer. Wirft nie — Git kann fehlen, das ist kein Fehler. */
+export type GitLeser = (schluessel: string) => string;
+export declare const echterGitLeser: (cwd?: string) => GitLeser;
+/**
+ * Einen Namen auf die Form bringen, in der Autoren gespeichert werden.
+ *
+ * Klein geschrieben und ohne Leerzeichen: "Heinrich Neb" wird zu "heinrich".
+ * Das ist keine Kosmetik — brain_who_knows, team_recall und die
+ * Wiederverwendungs-Zaehlung vergleichen Autoren als Zeichenketten. "Heinrich"
+ * und "heinrich" waeren zwei Menschen.
+ */
+export declare function normalisiere(roh: string): string;
+export interface AutorHerkunft {
+    /** Der ermittelte Name, oder leer. */
+    autor: string;
+    /** Woher er kam — steht im Hinweis an den Aufrufer. */
+    quelle: 'uebergeben' | 'umgebung' | 'git-name' | 'git-mail' | 'anonym' | 'unbekannt';
+}
+export declare function ermittleAutor(input: {
+    uebergeben?: string;
+    umgebung?: string;
+    git: GitLeser;
+}): AutorHerkunft;
+/**
+ * Der Mitautor — standardmaessig AUS.
+ *
+ * Heinrich: "Wir koennen im gleichen Zuge ja auch zum Beispiel claude als
+ * Co-Author nehmen, wenn der User das moechte? Einstellungssache,
+ * standardmaessig aber aus."
+ *
+ * Aus zwei Gruenden aus: erstens gehoert die Entscheidung dem Menschen, und
+ * zweitens wuerde ein automatisch gesetzter Mitautor die Zahl, um die es hier
+ * geht — wie viele Lektionen einen MENSCHEN als Autor haben — sofort wieder
+ * unbrauchbar machen.
+ *
+ * Eingeschaltet wird er mit
+ *   brain_set_pref(key="coauthor", value="claude")
+ * und wieder aus mit value="" oder "off".
+ */
+export declare const COAUTHOR_PREF_KEY = "coauthor";
+/** Aus dem gespeicherten Wert den Mitautor lesen — leer heisst aus. */
+export declare function coautorAus(prefWert: string | null | undefined): string;
+/**
+ * Wie der Autor gespeichert wird, wenn ein Mitautor eingeschaltet ist.
+ *
+ * "heinrich+claude" — ein Feld, kein zweites. Ein zweites Feld haette jede
+ * Abfrage im ganzen Haus anfassen muessen (who_knows, team_recall,
+ * reuse_pairs, das Briefing), und die Zahl "wie viele Lektionen haben einen
+ * Autor" waere dabei zweideutig geworden.
+ *
+ * Der Mensch steht VORN. Wer die Zeichenkette an "+" trennt, bekommt zuerst
+ * den, der die Entscheidung getroffen hat.
+ */
+export declare function mitCoautor(autor: string, coautor: string): string;
+/** Nur der Mensch, ohne Mitautor — fuer Zaehlungen und Vergleiche. */
+export declare function nurMensch(autorFeld: string): string;
+/**
+ * Ein Satz an den Aufrufer, wenn kein Autor ermittelt werden konnte.
+ *
+ * Wieder ein HINWEIS und keine Ablehnung: eine abgelehnte Lektion ist immer
+ * schlechter als eine ohne Autor. Aber schweigen waere falsch — genau das
+ * Schweigen hat die 195 erzeugt.
+ */
+export declare function autorHinweis(h: AutorHerkunft): string | null;

package/dist/src/autor.js

@@ -0,0 +1,136 @@
+import { execSync } from 'node:child_process';
+export const echterGitLeser = (cwd) => (schluessel) => {
+    try {
+        return execSync(`git config ${schluessel}`, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+            timeout: 1500,
+        }).trim();
+    }
+    catch {
+        return '';
+    }
+};
+/**
+ * Einen Namen auf die Form bringen, in der Autoren gespeichert werden.
+ *
+ * Klein geschrieben und ohne Leerzeichen: "Heinrich Neb" wird zu "heinrich".
+ * Das ist keine Kosmetik — brain_who_knows, team_recall und die
+ * Wiederverwendungs-Zaehlung vergleichen Autoren als Zeichenketten. "Heinrich"
+ * und "heinrich" waeren zwei Menschen.
+ */
+export function normalisiere(roh) {
+    const t = (roh ?? '').trim();
+    if (!t)
+        return '';
+    // Nur der Rufname: Nachnamen aendern sich (Heirat), Rufnamen selten. Und
+    // ein Nachname im Autorenfeld ist eine Personendatei mehr, die niemand
+    // gebeten hat anzulegen.
+    const erster = t.split(/[\s.]+/)[0] ?? '';
+    return erster
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, '')
+        .slice(0, 32);
+}
+/**
+ * Ausdrueckliche Wortmeldung "ohne meinen Namen".
+ *
+ * Ohne diesen Weg gaebe es keinen mehr: seit der Name aus git hergeleitet
+ * wird, bekaeme JEDE Lektion einen Autor, auch die, bei der der Mensch das
+ * nicht will. Eine private Notiz ueber einen Kunden, ein Fund, den man nicht
+ * an sich haengen will — das muss weiterhin gehen, und zwar sichtbar statt
+ * durch Weglassen.
+ *
+ * Der Test, der beim Umbau rot wurde, hat genau diese Luecke gezeigt: er
+ * speicherte eine Lektion ohne Autor und erwartete, dass skill_gaps sie
+ * anmeckert. Das ging vorher versehentlich, jetzt geht es absichtlich.
+ */
+const ANONYM = new Set(['-', 'anonym', 'anonymous', 'none', 'kein', 'off']);
+export function ermittleAutor(input) {
+    const rohUeb = (input.uebergeben ?? '').trim().toLowerCase();
+    if (ANONYM.has(rohUeb))
+        return { autor: '', quelle: 'anonym' };
+    const rohEnv = (input.umgebung ?? '').trim().toLowerCase();
+    if (ANONYM.has(rohEnv))
+        return { autor: '', quelle: 'anonym' };
+    const ueb = normalisiere(input.uebergeben ?? '');
+    if (ueb)
+        return { autor: ueb, quelle: 'uebergeben' };
+    const env = normalisiere(input.umgebung ?? '');
+    if (env)
+        return { autor: env, quelle: 'umgebung' };
+    const name = normalisiere(input.git('user.name'));
+    if (name)
+        return { autor: name, quelle: 'git-name' };
+    const mail = input.git('user.email');
+    const vorDemAt = normalisiere((mail ?? '').split('@')[0] ?? '');
+    if (vorDemAt)
+        return { autor: vorDemAt, quelle: 'git-mail' };
+    return { autor: '', quelle: 'unbekannt' };
+}
+/**
+ * Der Mitautor — standardmaessig AUS.
+ *
+ * Heinrich: "Wir koennen im gleichen Zuge ja auch zum Beispiel claude als
+ * Co-Author nehmen, wenn der User das moechte? Einstellungssache,
+ * standardmaessig aber aus."
+ *
+ * Aus zwei Gruenden aus: erstens gehoert die Entscheidung dem Menschen, und
+ * zweitens wuerde ein automatisch gesetzter Mitautor die Zahl, um die es hier
+ * geht — wie viele Lektionen einen MENSCHEN als Autor haben — sofort wieder
+ * unbrauchbar machen.
+ *
+ * Eingeschaltet wird er mit
+ *   brain_set_pref(key="coauthor", value="claude")
+ * und wieder aus mit value="" oder "off".
+ */
+export const COAUTHOR_PREF_KEY = 'coauthor';
+/** Aus dem gespeicherten Wert den Mitautor lesen — leer heisst aus. */
+export function coautorAus(prefWert) {
+    const t = (prefWert ?? '').trim().toLowerCase();
+    if (!t || t === 'off' || t === 'false' || t === '0' || t === 'none')
+        return '';
+    return normalisiere(t);
+}
+/**
+ * Wie der Autor gespeichert wird, wenn ein Mitautor eingeschaltet ist.
+ *
+ * "heinrich+claude" — ein Feld, kein zweites. Ein zweites Feld haette jede
+ * Abfrage im ganzen Haus anfassen muessen (who_knows, team_recall,
+ * reuse_pairs, das Briefing), und die Zahl "wie viele Lektionen haben einen
+ * Autor" waere dabei zweideutig geworden.
+ *
+ * Der Mensch steht VORN. Wer die Zeichenkette an "+" trennt, bekommt zuerst
+ * den, der die Entscheidung getroffen hat.
+ */
+export function mitCoautor(autor, coautor) {
+    if (!autor)
+        return '';
+    if (!coautor || coautor === autor)
+        return autor;
+    return `${autor}+${coautor}`;
+}
+/** Nur der Mensch, ohne Mitautor — fuer Zaehlungen und Vergleiche. */
+export function nurMensch(autorFeld) {
+    return (autorFeld ?? '').split('+')[0] ?? '';
+}
+/**
+ * Ein Satz an den Aufrufer, wenn kein Autor ermittelt werden konnte.
+ *
+ * Wieder ein HINWEIS und keine Ablehnung: eine abgelehnte Lektion ist immer
+ * schlechter als eine ohne Autor. Aber schweigen waere falsch — genau das
+ * Schweigen hat die 195 erzeugt.
+ */
+export function autorHinweis(h) {
+    if (h.autor)
+        return null;
+    // Wer ausdruecklich anonym speichert, bekommt keine Belehrung.
+    if (h.quelle === 'anonym')
+        return null;
+    return (`👤 **Kein Autor ermittelt** — weder \`author\`, noch \`CACHLY_AUTHOR\`, noch \`git config user.name\`. ` +
+        `Ohne Autor zählt diese Lektion nicht als Team-Wissen: \`brain_who_knows\` findet niemanden und ` +
+        `Wiederverwendung über Personengrenzen bleibt ungezählt. Ein \`git config user.name "Vorname"\` ` +
+        `im Projekt genügt für alle künftigen Lektionen.`);
+}
+//# sourceMappingURL=autor.js.map

package/dist/src/autor.js.map

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

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

@@ -0,0 +1,5 @@
+{
+  "version": "0.10.125",
+  "commit": "07251ca",
+  "gebautAm": "2026-08-20T09:15:12.976Z"
+}

package/dist/src/bauabdruck.d.ts

@@ -0,0 +1,38 @@
+export interface Bauabdruck {
+    version: string;
+    commit: string;
+    /** ISO-Zeitstempel, oder "unbekannt" solange nie gebaut wurde. */
+    gebautAm: string;
+}
+/** Rueckfall, solange kein Bauabdruck generiert wurde (kein Absturz, keine Erfindung). */
+export declare const RUECKFALL_BAUABDRUCK: Bauabdruck;
+/**
+ * Laedt den generierten Bauabdruck aus dem eigenen Verzeichnis.
+ *
+ * Faellt auf RUECKFALL_BAUABDRUCK zurueck, wenn die Datei fehlt, kein gueltiges
+ * JSON enthaelt oder die falsche Form hat — ein fehlender Bauabdruck ist kein
+ * Grund, den Server gar nicht erst zu starten.
+ */
+export declare function ladeBauabdruck(verzeichnis?: string): Bauabdruck;
+/** Der Bauabdruck dieses laufenden Prozesses — einmal beim Start geladen. */
+export declare const bauabdruck: Bauabdruck;
+/** Ab wie vielen Tagen der Bauabdruck in brain_doctor als alt gilt (🟡). */
+export declare const ALTER_SCHWELLE_TAGE = 14;
+/**
+ * Der Waechter: ist der Bauabdruck aelter als die Schwelle?
+ *
+ * Eigene Funktion, damit sie einzeln aufrufbar und pruefbar ist — aus
+ * demselben Grund wie beurteileDeckung in eingaenge.ts: ein Wächter, den man
+ * nicht einzeln aufrufen kann, ist ein Wächter, dessen Nein niemand je sieht.
+ * "unbekannt" gilt NICHT als alt — ein Server, der nie gebaut wurde, ist ein
+ * anderer Zustand als einer, der seit Wochen laeuft.
+ */
+export declare function istAlt(gebautAm: string, jetzt?: Date): boolean;
+/**
+ * Baut die Zeile fuer brain_doctor — Form und Ton wie die Zeile
+ * "Semantic coverage" dort: Emoji, Fettdruck-Label, Zahlen statt Adjektive.
+ *
+ * Ein Server, der seit Wochen laeuft, ist kein Fehler — aber man muss es
+ * sehen koennen. Darum 🟡 statt ❌ fuer den Altersfall.
+ */
+export declare function formatiereBauabdruck(a: Bauabdruck, jetzt?: Date): string;

package/dist/src/bauabdruck.js

@@ -0,0 +1,93 @@
+// Bauabdruck: zeigt, welcher Stand des Servers gerade laeuft.
+//
+// Zwei Bauten koennen dieselbe Versionsnummer tragen und trotzdem
+// verschiedenen Code ausfuehren. Gemessen am 20.08.2026: package.json sagte
+// beim installierten UND beim aktuellen Server 0.10.124 — der installierte
+// dist/ hatte den Code aus instances.ts (get_connection_string) trotzdem
+// nicht. Von aussen war das nicht zu unterscheiden. Der Bauabdruck macht den
+// Commit sichtbar, nicht nur die Versionsnummer.
+//
+// Die echten Werte kommen aus scripts/bauabdruck.mjs, das beim Bauen
+// (`npm run build`) eine JSON-Datei daneben schreibt. Diese Datei ist
+// generiert und steht darum in .gitignore. DIESE Datei (bauabdruck.ts) ist
+// eingecheckt und bleibt es — sie ist die Rueckfall-Fassung, die einspringt,
+// wenn noch nie gebaut wurde. Genau das prueft CI im Schritt "Type check":
+// `tsc --noEmit` laeuft dort OHNE vorherigen `npm run build`.
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Rueckfall, solange kein Bauabdruck generiert wurde (kein Absturz, keine Erfindung). */
+export const RUECKFALL_BAUABDRUCK = {
+    version: 'unbekannt',
+    commit: 'unbekannt',
+    gebautAm: 'unbekannt',
+};
+function istBauabdruck(wert) {
+    if (typeof wert !== 'object' || wert === null)
+        return false;
+    const w = wert;
+    return typeof w.version === 'string' && typeof w.commit === 'string' && typeof w.gebautAm === 'string';
+}
+/**
+ * Laedt den generierten Bauabdruck aus dem eigenen Verzeichnis.
+ *
+ * Faellt auf RUECKFALL_BAUABDRUCK zurueck, wenn die Datei fehlt, kein gueltiges
+ * JSON enthaelt oder die falsche Form hat — ein fehlender Bauabdruck ist kein
+ * Grund, den Server gar nicht erst zu starten.
+ */
+export function ladeBauabdruck(verzeichnis = dirname(fileURLToPath(import.meta.url))) {
+    const pfad = join(verzeichnis, 'bauabdruck-daten.generiert.json');
+    if (!existsSync(pfad))
+        return RUECKFALL_BAUABDRUCK;
+    try {
+        const wert = JSON.parse(readFileSync(pfad, 'utf-8'));
+        return istBauabdruck(wert) ? wert : RUECKFALL_BAUABDRUCK;
+    }
+    catch {
+        return RUECKFALL_BAUABDRUCK;
+    }
+}
+/** Der Bauabdruck dieses laufenden Prozesses — einmal beim Start geladen. */
+export const bauabdruck = ladeBauabdruck();
+/** Ab wie vielen Tagen der Bauabdruck in brain_doctor als alt gilt (🟡). */
+export const ALTER_SCHWELLE_TAGE = 14;
+/**
+ * Der Waechter: ist der Bauabdruck aelter als die Schwelle?
+ *
+ * Eigene Funktion, damit sie einzeln aufrufbar und pruefbar ist — aus
+ * demselben Grund wie beurteileDeckung in eingaenge.ts: ein Wächter, den man
+ * nicht einzeln aufrufen kann, ist ein Wächter, dessen Nein niemand je sieht.
+ * "unbekannt" gilt NICHT als alt — ein Server, der nie gebaut wurde, ist ein
+ * anderer Zustand als einer, der seit Wochen laeuft.
+ */
+export function istAlt(gebautAm, jetzt = new Date()) {
+    const datum = new Date(gebautAm);
+    if (Number.isNaN(datum.getTime()))
+        return false;
+    const tage = (jetzt.getTime() - datum.getTime()) / 86_400_000;
+    return tage > ALTER_SCHWELLE_TAGE;
+}
+/**
+ * Baut die Zeile fuer brain_doctor — Form und Ton wie die Zeile
+ * "Semantic coverage" dort: Emoji, Fettdruck-Label, Zahlen statt Adjektive.
+ *
+ * Ein Server, der seit Wochen laeuft, ist kein Fehler — aber man muss es
+ * sehen koennen. Darum 🟡 statt ❌ fuer den Altersfall.
+ */
+export function formatiereBauabdruck(a, jetzt = new Date()) {
+    if (a.gebautAm === 'unbekannt') {
+        return `❔ **Bauabdruck: unbekannt** — noch kein \`npm run build\` gelaufen, Version/Commit nicht feststellbar`;
+    }
+    const datum = new Date(a.gebautAm);
+    const gueltigesDatum = !Number.isNaN(datum.getTime());
+    const alt = gueltigesDatum && istAlt(a.gebautAm, jetzt);
+    const tage = gueltigesDatum ? Math.floor((jetzt.getTime() - datum.getTime()) / 86_400_000) : null;
+    const alterText = tage === null ? '' : ` (vor ${tage} Tag${tage === 1 ? '' : 'en'})`;
+    const emoji = alt ? '🟡' : '✅';
+    const hinweis = alt
+        ? ` — laeuft laenger als ${ALTER_SCHWELLE_TAGE} Tage. Kein Fehler, aber sichtbar.`
+        : '';
+    const datumsText = gueltigesDatum ? a.gebautAm.slice(0, 10) : a.gebautAm;
+    return `${emoji} **Bauabdruck:** v${a.version} · commit \`${a.commit}\` · gebaut am ${datumsText}${alterText}${hinweis}`;
+}
+//# sourceMappingURL=bauabdruck.js.map