@cachly-dev/mcp-server 0.10.129 → 0.10.130

package/dist/src/werkzeug-nutzung.d.ts

@@ -1,62 +0,0 @@
-/**
- * Welche der 122 Werkzeuge werden wirklich benutzt?
- *
- * ANLASS 19.08.2026: Die Glama-Bewertung sagt, cachly habe zu viele Werkzeuge
- * und viele liessen sich zusammenlegen. Der Einwand ist plausibel — nur konnte
- * ihm niemand mit Zahlen begegnen, weil es KEINE Messung gab. Nirgends im
- * Server wurde festgehalten, welches Werkzeug wie oft gerufen wird.
- *
- * Ohne diese Zahl ist jedes Zusammenlegen geraten. Man streicht dann das, was
- * man selbst selten benutzt — und das ist selten dasselbe wie das, was die
- * Nutzer selten benutzen.
- *
- * Diese Datei ist die Rechnung dazu, ohne Datenzugriff und ohne neues
- * Werkzeug: gezaehlt wird an der EINEN Stelle, durch die jeder Aufruf geht
- * (handleTool), und gelesen wird in `brain_metrics`, das es schon gibt. Ein
- * 123. Werkzeug, um zu messen, dass es zu viele Werkzeuge gibt, waere die
- * Pointe, die niemand will.
- */
-/** Redis-Hash je Brain: Feld = Werkzeugname, Wert = Anzahl der Aufrufe. */
-export declare function nutzungsSchluessel(instanceId: string): string;
-export interface WerkzeugZeile {
-    name: string;
-    aufrufe: number;
-    /** Anteil an allen Aufrufen, 0..1. */
-    anteil: number;
-}
-export interface NutzungsBild {
-    /** Alle Aufrufe zusammen. */
-    gesamt: number;
-    /** Wie viele verschiedene Werkzeuge ueberhaupt je gerufen wurden. */
-    benutzte: number;
-    /** Absteigend sortiert, gekappt. */
-    spitze: WerkzeugZeile[];
-    /**
-     * Wie viele Aufrufe auf die Spitzengruppe entfallen, 0..1.
-     *
-     * Die eigentlich interessante Zahl: liegt sie bei 0,9, dann traegt eine
-     * Handvoll Werkzeuge die ganze Arbeit — und der Rest ist Erklaerungsbedarf,
-     * nicht Funktionsumfang.
-     */
-    anteilSpitze: number;
-}
-/**
- * Rohzaehler zu einem lesbaren Bild verdichten.
- *
- * Rein, damit sich die Verdichtung ohne Redis pruefen laesst. Ungueltige
- * Zaehler (kein Zahlwert, negativ) fallen heraus statt NaN zu erzeugen — eine
- * kaputte Zeile darf nicht die ganze Auswertung vergiften.
- */
-export declare function verdichte(roh: Record<string, string | number>, spitzeN?: number): NutzungsBild;
-/**
- * Der Satz, der die Glama-Frage beantwortet.
- *
- * Bewusst mit der Zahl der NIE gerufenen Werkzeuge: das ist die Angabe, an der
- * sich entscheidet, ob zusammengelegt werden sollte — und sie ist unbequem
- * genug, dass niemand sie schoenreden kann.
- *
- * Ohne einen einzigen Aufruf wird NICHT behauptet, alles sei ungenutzt: eine
- * frische Instanz hat noch nichts gemessen, und "0 von 122 benutzt" waere dann
- * eine Aussage ueber die Messung, nicht ueber das Produkt.
- */
-export declare function nutzungInWorten(bild: NutzungsBild, werkzeugeGesamt: number): string;

package/dist/src/werkzeug-nutzung.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"werkzeug-nutzung.js","sourceRoot":"","sources":["../../src/werkzeug-nutzung.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,2BAA2B,UAAU,EAAE,CAAC;AACjD,CAAC;AA0BD;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAoC,EAAE,OAAO,GAAG,EAAE;IAC1E,MAAM,MAAM,GAAwC,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,GAAG,CAAC;QACJ,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;KAC5C,CAAC,CAAC,CAAC;IACJ,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM;QACN,QAAQ,EAAE,MAAM,CAAC,MAAM;QACvB,MAAM;QACN,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;KACpD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB,EAAE,eAAuB;IACzE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,oFAAoF,CAAC;IAC9F,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;IACpD,OAAO,CACL,GAAG,IAAI,CAAC,QAAQ,QAAQ,eAAe,uCAAuC,GAAG,SAAS;QAC1F,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,sBAAsB,OAAO,YAAY,IAAI,CAAC,MAAM,WAAW,CACzF,CAAC;AACJ,CAAC"}

package/dist/src/wertbeitrag.d.ts

@@ -1,148 +0,0 @@
-/**
- * Wertbeitrag — was ein einzelner Abruf zur Zeitersparnis beiträgt.
- *
- * ─── DER ANLASS ────────────────────────────────────────────────────────────
- *
- * Am 17.08.2026 zeigte das Panel eines Brains mit 475 Lektionen eine
- * Zeitersparnis von 54 Tagen und einen Gegenwert von 97.237,50 €. Nachgerechnet
- * stammte praktisch die ganze Zahl aus dem STARTER-KORPUS: `docker:layer-cache`
- * stand bei 973 Abrufen, `cache:stampede` bei 971, dahinter neun weitere
- * Starter-Lektionen mit je rund 208. Die echten, projektbezogenen Lektionen
- * standen bei zwei bis fünf.
- *
- * Der Starter-Korpus ist genau das, wofür er gedacht ist: ein Startvorrat, der
- * dafür sorgt, dass die erste Frage an ein leeres Brain nicht ins Leere geht.
- * Er ist eingekauftes Allgemeinwissen — Docker-Cache, JWT-Uhrzeitversatz,
- * N+1-Abfragen. Er ist NICHT das, was jemand über sein Projekt gelernt hat.
- *
- * Ihn in die Wertschätzung einzurechnen macht die Zahl doppelt falsch:
- *   - Sie wächst, ohne dass jemand etwas gelernt hat.
- *   - Sie wächst am schnellsten in Brains, die am wenigsten eigenes Wissen
- *     haben — dort gibt es ja nichts anderes zu treffen.
- *
- * Eine Kennzahl, die dann am besten aussieht, wenn das Produkt am wenigsten
- * leistet, ist schlimmer als gar keine.
- *
- * ─── WARUM KEINE NAMENSLISTE ───────────────────────────────────────────────
- *
- * Naheliegend wäre gewesen, die sechs auffälligen Themen hart auszuschliessen.
- * Das wäre ein Wächter, der auf den Anlass genagelt ist: Beim nächsten
- * 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;
-/** Eine Lektion, soweit sie für die Bewertung gebraucht wird. */
-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 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).
- *
- * 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 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
- * Staffel von causal_trace (60 / 120 / 240) ihren eigenen Grundwert, ohne dass
- * 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.map

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