@cachly-dev/mcp-server 0.10.128 → 0.10.130

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

@@ -1,200 +1 @@
-/**
- * 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
+import{readFileSync as k,writeFileSync as O,existsSync as R}from"node:fs";import{Redis as L}from"ioredis";import{packe as E,entpacke as m}from"../bedeutung.js";async function p(n,r){const e=[];let s="0";do{const[l,t]=await n.scan(s,"MATCH",r,"COUNT",500);s=l,e.push(...t)}while(s!=="0");return e}function x(n){const r=Buffer.from(n,"base64");return r.byteLength>7&&r[0]===1&&r.byteLength%4===1}async function N(n,r){const e={schluessel:0,felder:0,vorher:0,nachher:0,uebersprungen:0};for(const s of["cachly:lesson:vec:*","cachly:lesson:vecname:*"])for(const l of await p(n,s)){const t=await n.get(l);if(!t)continue;if(e.schluessel++,x(t)){e.uebersprungen++,e.vorher+=t.length,e.nachher+=t.length;continue}const o=m(t);if(!o){e.uebersprungen++;continue}const c=E(o);e.vorher+=t.length,e.nachher+=c.length,e.felder++,r&&await n.set(l,c)}for(const s of await p(n,"cachly:lesson:eing:*")){const l=await n.hgetall(s),t=[];e.schluessel++;for(const[o,c]of Object.entries(l)){if(x(c)){e.uebersprungen++,e.vorher+=c.length,e.nachher+=c.length;continue}const h=m(c);if(!h){e.uebersprungen++;continue}const g=E(h);e.vorher+=c.length,e.nachher+=g.length,e.felder++,t.push(o,g)}r&&t.length>0&&await n.hset(s,...t)}return e}const y=n=>`${(n/1024/1024).toFixed(2)} MB`;async function C(){const n=process.argv.slice(2),r=c=>{const h=n.indexOf(`--${c}`);return h!==-1?n[h+1]:void 0},e=process.env.CACHLY_REDIS_URL??process.env.REDIS_URL;e||(console.error("NICHT GELAUFEN: REDIS_URL fehlt."),process.exit(2));const s=r("sicherung");s||(console.error("NICHT GELAUFEN: --sicherung <datei> fehlt."),process.exit(2));const l=n.includes("--schreiben"),t=n.includes("--zurueck"),o=new L(e,{maxRetriesPerRequest:2,connectTimeout:8e3});try{if(t){R(s)||(console.error(`NICHT GELAUFEN: Sicherung fehlt (${s}).`),process.exit(2));const a=JSON.parse(k(s,"utf8"));let f=0;for(const[u,w]of Object.entries(a.werte))await o.set(u,w),f++;for(const[u,w]of Object.entries(a.hashes)){const $=Object.entries(w).flat();$.length!==0&&(await o.del(u),await o.hset(u,...$),f++)}console.log(`ZURUECKGESPIELT: ${f} Schluessel aus ${s}`);return}const c={},h={};for(const a of["cachly:lesson:vec:*","cachly:lesson:vecname:*"])for(const f of await p(o,a)){const u=await o.get(f);u&&(c[f]=u)}for(const a of await p(o,"cachly:lesson:eing:*"))h[a]=await o.hgetall(a);O(s,JSON.stringify({werte:c,hashes:h}),{encoding:"utf8"});const g=JSON.parse(k(s,"utf8")),b=Object.keys(c).length,d=Object.keys(g.werte).length,S=Object.keys(h).length,v=Object.keys(g.hashes).length;(b!==d||S!==v||b===0)&&(console.error(`ABBRUCH: Sicherung unvollstaendig (${d}/${b} Werte, ${v}/${S} Hashes).`),process.exit(3)),console.log(`Sicherung geprueft: ${d} Werte + ${v} Hashes in ${s}`);const i=await N(o,l);console.log(""),console.log(`  Schluessel angesehen  : ${i.schluessel}`),console.log(`  Vektoren umgeschrieben: ${i.felder}`),console.log(`  uebersprungen         : ${i.uebersprungen} (schon int8 oder unlesbar)`),console.log(`  vorher                : ${y(i.vorher)}`),console.log(`  nachher               : ${y(i.nachher)}`),console.log(`  gespart               : ${y(i.vorher-i.nachher)}  (Faktor ${(i.vorher/Math.max(1,i.nachher)).toFixed(2)})`),console.log(""),console.log(l?"  GESCHRIEBEN.":"  TROCKENLAUF \u2014 nichts veraendert. Mit --schreiben ausfuehren.")}finally{o.disconnect()}}const I=process.argv[1]?.replace(/\\/g,"/").endsWith("/vektoren-verdichten.ts");I&&C().catch(n=>{console.error("FEHLER:",n),process.exit(1)});export{p as alleSchluessel,x as istInt8,N as verdichte};

package/dist/src/werkzeug-nutzung.js

@@ -1,72 +1 @@
-/**
- * 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 function nutzungsSchluessel(instanceId) {
-    return `cachly:stats:tool_calls:${instanceId}`;
-}
-/**
- * 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 function verdichte(roh, spitzeN = 15) {
-    const zeilen = [];
-    for (const [name, wert] of Object.entries(roh)) {
-        const n = typeof wert === 'number' ? wert : Number(wert);
-        if (!Number.isFinite(n) || n <= 0)
-            continue;
-        zeilen.push({ name, aufrufe: Math.floor(n) });
-    }
-    const gesamt = zeilen.reduce((s, z) => s + z.aufrufe, 0);
-    zeilen.sort((a, b) => b.aufrufe - a.aufrufe || a.name.localeCompare(b.name));
-    const spitze = zeilen.slice(0, Math.max(0, spitzeN)).map((z) => ({
-        ...z,
-        anteil: gesamt > 0 ? z.aufrufe / gesamt : 0,
-    }));
-    const summeSpitze = spitze.reduce((s, z) => s + z.aufrufe, 0);
-    return {
-        gesamt,
-        benutzte: zeilen.length,
-        spitze,
-        anteilSpitze: gesamt > 0 ? summeSpitze / gesamt : 0,
-    };
-}
-/**
- * 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 function nutzungInWorten(bild, werkzeugeGesamt) {
-    if (bild.gesamt === 0) {
-        return 'Noch keine Werkzeug-Aufrufe gezählt — die Messung beginnt mit dem nächsten Aufruf.';
-    }
-    const nie = Math.max(0, werkzeugeGesamt - bild.benutzte);
-    const prozent = Math.round(bild.anteilSpitze * 100);
-    return (`${bild.benutzte} von ${werkzeugeGesamt} Werkzeugen wurden hier je gerufen (${nie} nie). ` +
-        `Die ${bild.spitze.length} häufigsten tragen ${prozent} % aller ${bild.gesamt} Aufrufe.`);
-}
-//# sourceMappingURL=werkzeug-nutzung.js.map
+function i(t){return`cachly:stats:tool_calls:${t}`}function c(t,o=15){const u=[];for(const[e,n]of Object.entries(t)){const f=typeof n=="number"?n:Number(n);!Number.isFinite(f)||f<=0||u.push({name:e,aufrufe:Math.floor(f)})}const r=u.reduce((e,n)=>e+n.aufrufe,0);u.sort((e,n)=>n.aufrufe-e.aufrufe||e.name.localeCompare(n.name));const s=u.slice(0,Math.max(0,o)).map(e=>({...e,anteil:r>0?e.aufrufe/r:0})),a=s.reduce((e,n)=>e+n.aufrufe,0);return{gesamt:r,benutzte:u.length,spitze:s,anteilSpitze:r>0?a/r:0}}function m(t,o){if(t.gesamt===0)return"Noch keine Werkzeug-Aufrufe gez\xE4hlt \u2014 die Messung beginnt mit dem n\xE4chsten Aufruf.";const u=Math.max(0,o-t.benutzte),r=Math.round(t.anteilSpitze*100);return`${t.benutzte} von ${o} Werkzeugen wurden hier je gerufen (${u} nie). Die ${t.spitze.length} h\xE4ufigsten tragen ${r} % aller ${t.gesamt} Aufrufe.`}export{m as nutzungInWorten,i as nutzungsSchluessel,c as verdichte};

package/dist/src/wertbeitrag.js

@@ -1,73 +1 @@
-/**
- * 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.
- */
-/** 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));
-    if (gesamt < 60)
-        return `${gesamt} min`;
-    const stunden = Math.floor(gesamt / 60);
-    if (stunden < 24)
-        return `${stunden} h`;
-    const tage = Math.floor(stunden / 24);
-    const rest = stunden % 24;
-    return rest > 0 ? `${tage} d ${rest} h` : `${tage} d`;
-}
-/**
- * Stammt die Lektion aus dem mitgelieferten Startvorrat?
- *
- * 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.
- */
-export function istStarterLektion(lesson) {
-    return lesson?.source === 'starter';
-}
-/**
- * Minuten, die ein Abruf dieser Lektion einspart — 0 für den Startvorrat.
- *
- * 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 function ersparteMinuten(lesson, basis = 'recall') {
-    if (!lesson || istStarterLektion(lesson))
-        return 0;
-    const sev = lesson.severity;
-    if (sev === 'critical')
-        return 240;
-    if (sev === 'major')
-        return basis === 'trace' ? 120 : 60;
-    return basis === 'trace' ? 60 : 30;
-}
-//# sourceMappingURL=wertbeitrag.js.map
+import{STARTER_CORPUS as a}from"./starter-corpus.js";function p(t){const r=Math.max(0,Math.round(t));if(r<60)return`${r} min`;const e=Math.floor(r/60);if(e<24)return`${e} h`;const n=Math.floor(e/24),i=e%24;return i>0?`${n} d ${i} h`:`${n} d`}const c=new Map(a.map(t=>[t.topic,t.what_worked])),m=new Set(c.keys()),u=/^(starter|public_brain|marketplace:|syndicate:|import)/;function o(t){if(!t)return!1;if(typeof t.source=="string"&&t.source!=="")return u.test(t.source);if(typeof t.topic!="string")return!1;const r=c.get(t.topic);return r===void 0?!1:(typeof t.what_worked=="string"?t.what_worked:"").trim()===r.trim()}function h(t,r="recall"){if(!t||o(t))return 0;const e=t.severity;return e==="critical"?240:e==="major"?r==="trace"?120:60:r==="trace"?60:30}function s(t){return!t||o(t)?!1:(typeof t.recall_count=="number"?t.recall_count:0)<=0}export{m as STARTER_THEMEN,h as ersparteMinuten,p as fmtStunden,o as istStarterLektion,s as zaehltAlsErsparnis};

package/dist/src/wirkungsspur.js

@@ -0,0 +1 @@
+const d=500,m=500;function o(e,t){return typeof e=="string"?e.trim().slice(0,t):""}function p(e,t){const r=o(e.frage,500);if(!r)return{ok:!1,grund:"frage fehlt \u2014 ohne die Frage ist der Eintrag wertlos"};const n=o(e.thema,200);return n?typeof e.geholfen!="boolean"?{ok:!1,grund:'geholfen muss true oder false sein \u2014 "weiss nicht" ist keine Rueckmeldung'}:typeof e.platz!="number"||!Number.isInteger(e.platz)||e.platz<0?{ok:!1,grund:"platz muss eine ganze Zahl ab 0 sein (0 = die Lektion stand gar nicht in der Antwort)"}:{ok:!0,eintrag:{ts:t,quelle:"gemeldet",frage:r,thema:n,geholfen:e.geholfen,platz:e.platz,notiz:o(e.notiz,500),autor:o(e.autor,80)}}:{ok:!1,grund:"thema fehlt \u2014 welche Lektion ist gemeint?"}}function A(e,t,r){if(!e)return null;const n=o(e.frage,500),f=o(t,200);if(!n||!f||!Array.isArray(e.themen))return null;const l=e.themen.indexOf(f);return{ts:r,quelle:"abgeleitet",frage:n,thema:f,geholfen:!0,platz:l===-1?0:l+1,notiz:l===-1?"automatisch: geoeffnet, obwohl nicht in der Antwort":"automatisch: aus der Antwort geoeffnet",autor:""}}const a=3;function c(e){return e.geholfen&&e.platz===0?"fehlender-treffer":e.geholfen&&e.platz>a?"zu-weit-hinten":!e.geholfen&&e.platz>0&&e.platz<=a?"falsch-und-sicher":e.geholfen?"bestaetigung":"unauffaellig"}function z(e){const t={"fehlender-treffer":0,"zu-weit-hinten":0,"falsch-und-sicher":0,bestaetigung:0,unauffaellig:0};let r=0,n=0,f=0,l=0,s=0,u=0,h=0;for(const i of e){t[c(i)]++;const g=i.platz>0&&i.platz<=a;if(i.quelle==="abgeleitet"){n++,u++,g&&h++;continue}r++,i.geholfen&&(f++,l++,g&&s++)}return{gesamt:e.length,gemeldet:r,abgeleitet:n,geholfen:f,trefferquote:l===0?null:s/l,auswahlquote:u===0?null:h/u,nachLehrwert:t}}export{a as SICHTBARE_PLAETZE,c as lehrwert,A as leiteAb,p as pruefeWirkung,z as werteAus};

package/glama.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://glama.ai/mcp/schemas/server.json",
-  "version": "0.10.128",
+  "version": "0.10.130",
   "maintainers": [
     "HeinrichNebula"
   ],

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.10.128",
+  "version": "0.10.130",
   "mcpName": "io.github.cachly-dev/mcp-server",
-  "description": "Your AI forgets everything between sessions. cachly fixes that permanently: 122 MCP tools for Claude Code, Cursor, Copilot & Windsurf. Learns from every bug fix, commit and CI run. Arrives pre-briefed. Free tier forever, EU servers, GDPR.",
+  "description": "Your AI forgets everything between sessions. cachly fixes that permanently: 123 MCP tools for Claude Code, Cursor, Copilot & Windsurf. Learns from every bug fix, commit and CI run. Arrives pre-briefed. Free tier forever, EU servers, GDPR.",
   "type": "module",
   "files": [
-    "dist/index.*",
-    "dist/src/**/*",
-    "dist/packages/**/*",
+    "dist/index.js",
+    "dist/src/**/*.js",
+    "dist/packages/**/*.js",
     "scripts/postinstall.js",
     "server.json",
     "glama.json"
@@ -32,7 +32,7 @@
     "verify-tool-spec-snapshots": "node scripts/tool-spec-snapshots.mjs check",
     "verify-tool-counts": "node scripts/verify-tool-counts.mjs",
     "verify-capabilities": "node scripts/verify-capabilities.mjs",
-    "build": "tsc && node scripts/bauabdruck.mjs",
+    "build": "tsc && node scripts/paket-schliessen.mjs && node scripts/bauabdruck.mjs",
     "postinstall": "node scripts/postinstall.js",
     "dev": "tsx src/index.ts",
     "start": "node dist/src/index.js",
@@ -60,6 +60,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.4",
     "@types/node": "^22",
+    "esbuild": "^0.28.2",
     "eslint": "^9",
     "gpt-tokenizer": "^3.4.0",
     "tsx": "^4.23.12",
@@ -68,7 +69,7 @@
     "vitest": "^3.2.4"
   },
   "overrides": {
-    "esbuild": "^0.28.2"
+    "esbuild": "$esbuild"
   },
   "engines": {
     "node": ">=20"

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.cachly-dev/mcp-server",
-  "description": "Persistent memory + causal root-cause analysis for AI coding agents. 122 MCP tools. EU, GDPR.",
+  "description": "Persistent memory + causal root-cause analysis for AI coding agents. 123 MCP tools. EU, GDPR.",
   "repository": {
     "url": "https://github.com/cachly-dev/cachly-mcp",
     "source": "github"
   },
-  "version": "0.10.128",
+  "version": "0.10.130",
   "packages": [
     {
       "registryType": "npm",
       "name": "@cachly-dev/mcp-server",
       "identifier": "@cachly-dev/mcp-server",
-      "version": "0.10.128",
+      "version": "0.10.130",
       "transport": {
         "type": "stdio"
       }

package/dist/index.d.ts

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

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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/packages/telegram-notify/client.d.ts

@@ -1,19 +0,0 @@
-/**
- * telegram-notify — shared Telegram notification client.
- *
- * Used by cachly-mcp (TypeScript) and TCO backend (Python via client.py).
- * Single source of truth for: emoji map, message format, env var convention.
- *
- * Interface: notify(app, event, payload)
- *
- * Env vars:
- *   TELEGRAM_BOT_TOKEN          — bot token from @BotFather
- *   {APP_UPPER}_TELEGRAM_CHAT_ID — app-specific channel (e.g. CACHLY_TELEGRAM_CHAT_ID)
- *   TELEGRAM_CHAT_ID             — fallback for all apps
- *
- * No-op when unconfigured. Never throws.
- *
- * Note: emoji map is kept in sync with emojis.json (Python reads the JSON file at runtime).
- */
-export declare function formatMessage(app: string, event: string, payload: Record<string, unknown>): string;
-export declare function notify(app: string, event: string, payload?: Record<string, unknown>): Promise<void>;

package/dist/packages/telegram-notify/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../packages/telegram-notify/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,MAAM,KAAK,GAA2B;IACpC,SAAS,EAAW,IAAI;IACxB,UAAU,EAAU,IAAI;IACxB,SAAS,EAAW,GAAG;IACvB,UAAU,EAAU,IAAI;IACxB,OAAO,EAAa,IAAI;IACxB,SAAS,EAAW,IAAI;IACxB,OAAO,EAAa,IAAI;IACxB,eAAe,EAAK,IAAI;IACxB,UAAU,EAAU,IAAI;IACxB,UAAU,EAAU,IAAI;IACxB,SAAS,EAAW,IAAI;IACxB,YAAY,EAAQ,KAAK;IACzB,YAAY,EAAQ,KAAK;IACzB,KAAK,EAAe,IAAI;IACxB,cAAc,EAAM,IAAI;IACxB,eAAe,EAAK,IAAI;IACxB,QAAQ,EAAY,IAAI;IACxB,UAAU,EAAU,IAAI;IACxB,WAAW,EAAS,IAAI;IACxB,OAAO,EAAa,IAAI;CACzB,CAAC;AAEF,SAAS,QAAQ;IACf,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,mBAAmB,CAAC;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,KAAa,EACb,OAAgC;IAEhC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;IAChE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAW,EACX,KAAa,EACb,UAAmC,EAAE;IAErC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC,+BAA+B,KAAK,cAAc,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;YACvE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}

package/dist/src/ambient-cli.d.ts

@@ -1,101 +0,0 @@
-import { type RecallMemory, type LessonCandidate, type GateOptions } from './ambient-recall.js';
-/** The subset of the Claude Code hook payload we care about. */
-export interface HookPayload {
-    hook_event_name?: string;
-    /** Present on UserPromptSubmit — the text the user just typed. */
-    prompt?: string;
-    /** Present on SessionStart — 'startup' | 'resume' | 'clear' | 'compact'. */
-    source?: string;
-    /** Present on PreToolUse — the tool about to run and its input. */
-    tool_name?: string;
-    tool_input?: {
-        file_path?: string;
-        [k: string]: unknown;
-    };
-    /** Present on Stop — what the assistant just said (auto-learn signal). */
-    last_assistant_message?: string;
-    cwd?: string;
-}
-/** Parse the hook payload from stdin. Never throws — returns null on any problem. */
-export declare function parseHookPayload(raw: string): HookPayload | null;
-/**
- * The query to recall on for a payload, or null when recall should be skipped
- * before any brain call:
- *   • UserPromptSubmit → the prompt, unless it is trivial (§6.3 guardrail 2).
- *   • SessionStart     → a fixed briefing query (there is no user prompt yet);
- *     skipped on 'compact'/'clear' resumes where a mid-session briefing is noise.
- *   • PreToolUse       → a file-scoped query for Edit/Write-class tools only.
- *   • Stop             → never recalls (it learns instead — see stopObservation).
- */
-export declare function recallQueryFor(payload: HookPayload): string | null;
-export interface StopObservation {
-    action: string;
-    outcome: 'success';
-    details: string;
-    severity: 'minor';
-}
-/**
- * Derive an auto-learn observation from a Stop payload, or null when the turn
- * carries no clear fix signal. Pure — the caller feeds it to auto_learn_session.
- */
-export declare function stopObservation(payload: HookPayload): StopObservation | null;
-/** Truncate text to fit an estimated token budget (~4 chars/token), on a word edge. */
-export declare function truncateToTokens(text: string, maxTokens: number): string;
-/**
- * Tiny footer that closes the net-token loop (§6.2): the agent self-reports
- * prevented tokens via `ambient-credit` when a recalled lesson changed its path.
- * Kept to one short line — its own token cost is counted as injected.
- */
-export declare const CREDIT_FOOTER = "(If this memory just saved you from a wrong path, record it: `npx @cachly-dev/mcp-server@latest ambient-credit <tokens-saved>`)";
-/**
- * Der Beleg: WANN es gelernt wurde und WORAN.
- *
- * Ohne Beleg ist proaktive Erinnerung eine Behauptung — und Behauptungen einer
- * Maschine prueft niemand nach, man glaubt sie oder ignoriert sie. Mit Datum
- * und Datei wird daraus eine nachpruefbare Aussage: "am 24.07., in
- * infra/backup.sh — ging damals schief". Genau das macht den Unterschied
- * zwischen einem Hinweis, dem man folgt, und einem, den man wegklickt.
- *
- * Bewusst kurz gehalten (eine Zeile, hoechstens zwei Dateien): der Beleg wird
- * bei JEDER Erinnerung mitgezahlt und darf das Token-Budget nicht sprengen.
- */
-export declare function formatProvenance(l: LessonCandidate): string;
-/**
- * Render the gated lessons into a context block for the agent.
- *   • A single already-formatted briefing (multi-line summary — what smart_recall
- *     returns) is injected verbatim; it carries its own headings.
- *   • Multiple short lessons are rendered as a titled bullet list.
- * `withCreditFooter` appends the self-report line (per-prompt events only —
- * a SessionStart briefing is ambience, not a decision-changing recall).
- */
-export declare function formatContextBlock(lessons: LessonCandidate[], withCreditFooter?: boolean): string;
-/**
- * Build the JSON Claude Code expects from a hook. `additionalContext` is spliced
- * into the model's context for the turn. Empty context → empty string (no output),
- * which Claude Code treats as "hook contributed nothing".
- */
-export declare function buildHookOutput(event: string, additionalContext: string): string;
-export interface AmbientDeps {
-    /** Optionales Trigger-Gedaechtnis (Dedupe + Ruhe-Budget). Fehlt es, bleibt das Verhalten zustandslos. */
-    loadMemory?: () => RecallMemory | null | undefined;
-    saveMemory?: (m: RecallMemory) => void;
-    /** Fetch candidate lessons for a query. Should already be scoped to the brain. */
-    recall: (query: string, event: string) => Promise<LessonCandidate[]>;
-    /** Overrides for the relevance gate. */
-    gate?: Partial<GateOptions>;
-    /** Hard latency budget for the whole recall step (ms). Default 3000. */
-    timeoutMs?: number;
-    /**
-     * Auto-backoff probe (§6.3 guardrail 3): return true when the recent ledger
-     * window is net-negative — recall is then skipped BEFORE any brain call.
-     */
-    backoff?: () => boolean | Promise<boolean>;
-    /** Called with the estimated injected tokens whenever context is emitted. */
-    onInject?: (tokens: number, event: string) => void;
-}
-/**
- * The whole ambient-recall CLI flow, as a pure function of (stdin, deps).
- * Returns the string to print on stdout — either the hookSpecificOutput JSON or
- * '' (nothing to inject). Never throws.
- */
-export declare function runAmbient(raw: string, deps: AmbientDeps): Promise<string>;

package/dist/src/ambient-cli.js.map

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

package/dist/src/ambient-deps.d.ts

@@ -1,26 +0,0 @@
-import { type AmbientDeps } from './ambient-cli.js';
-import { type RecallMemory } from './ambient-recall.js';
-export interface BuildAmbientDepsOptions {
-    /** Brain instance to recall from. Missing/empty → recall is a no-op (never calls `smartRecall`). */
-    instanceId?: string;
-    /** The raw `smart_recall` call (already scoped to `instanceId` by the caller). */
-    smartRecall: (query: string) => Promise<string>;
-    /** Optional trigger memory (dedupe + quiet-budget). Stateless when omitted. */
-    loadMemory?: () => RecallMemory | null | undefined;
-    saveMemory?: (m: RecallMemory) => void;
-    /** Auto-backoff probe (§6.3 guardrail 3). */
-    backoff?: () => boolean | Promise<boolean>;
-    /** Called with the estimated injected tokens whenever context is emitted. */
-    onInject?: (tokens: number, event: string) => void;
-    /** Hard latency budget for the whole recall step (ms). Default 3000. */
-    timeoutMs?: number;
-}
-/**
- * Builds the ONE production `AmbientDeps` used by the `ambient-recall` CLI
- * entrypoint. This is the exact mapping that used to be inlined at the call
- * site: a miss-detection heuristic, a token-truncated summary, and a
- * content-derived candidate id — wrapped around whatever `smartRecall`
- * implementation the caller passes in (production: `handleTool('smart_recall', ...)`;
- * tests: a stub).
- */
-export declare function buildAmbientDeps(opts: BuildAmbientDepsOptions): AmbientDeps;

package/dist/src/ambient-deps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ambient-deps.js","sourceRoot":"","sources":["../../src/ambient-deps.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,sEAAsE;AACtE,yEAAyE;AACzE,8EAA8E;AAC9E,2EAA2E;AAC3E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,kBAAkB;AAElB,OAAO,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AAExE,kGAAkG;AAClG,MAAM,aAAa,GAAG,+CAA+C,CAAC;AAEtE,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,iFAAiF;AACjF,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAkB9B;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC/F,OAAO;QACL,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,2DAA2D;QACzF,wEAAwE;QACxE,0EAA0E;QAC1E,6EAA6E;QAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE;QAC/C,UAAU;QACV,UAAU;QACV,OAAO;QACP,QAAQ;QACR,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,IAAI,CAAC,UAAU;gBAAE,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,gBAAgB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxE,IAAI,IAAI;gBAAE,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAC1D,OAAO,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC"}