@cachly-dev/mcp-server 0.10.128 → 0.10.130

package/dist/src/interferenz.js

@@ -0,0 +1 @@
+function p(e,r=5,i=.5){if(r<=1||e.length===0)return[e];const t=[e],n=r-1,c=Math.max(1,Math.floor(e.length/n));for(let s=0;s<n;s++){const o=s*c,a=s===n-1?e.length:o+c,h=e.slice();for(let l=o;l<a;l++)h[l]*=1-i;t.push(h)}return t}function u(e,r){const i=new Map;for(const[t,n]of e.entries()){const c=t===0?2:1;for(const[s,o]of n.entries()){if(o.naehe<=0)continue;const a=c*(o.naehe/(s+1));i.set(o.topic,(i.get(o.topic)??0)+a)}}return[...i.entries()].sort((t,n)=>n[1]-t[1]||t[0].localeCompare(n[0])).slice(0,r).map(([t])=>t)}export{u as ueberlagere,p as varianten};

package/dist/src/kostprobe.js

@@ -1,125 +1,7 @@
-// Kostprobe — gesperrte Werkzeuge dürfen ein paar Mal echt laufen.
-//
-// ─── DER ANLASS ──────────────────────────────────────────────────────────────
-//
-// Gemessen am 11.08.2026 in mcp_events: `premium_gate_hit` ist 36-mal gefeuert,
-// von genau EINER Person — dem Entwickler des Produkts selbst, zwischen dem
-// 30.06. und dem 08.08. Er hat nicht aufgerüstet. Bei seinem eigenen Produkt,
-// wo Geld nicht das Hindernis ist.
-//
-// Das ist die härteste Zahl, die es zur Preisfrage gibt: Der intensivste
-// Nutzer, den cachly je hatte, stand 36-mal vor der Schranke und ging jedes
-// Mal weiter. Nicht weil die Funktionen schlecht wären — sondern weil er nie
-// gesehen hat, was sie an SEINEN Daten tun.
-//
-// Die Schranke gab eine Verkaufsansage. Nie eine Kostprobe.
-// Man vermisst nicht, was man nie hatte.
-//
-// ─── DIE REGEL ───────────────────────────────────────────────────────────────
-//
-// Jedes gesperrte Werkzeug darf auf der Gratis-Stufe KOSTPROBEN_JE_WERKZEUG-mal
-// vollständig laufen. Echtes Ergebnis, keine gekürzte Fassung. Erst danach
-// kommt die Schranke — und dann mit einer Zahl statt einem Versprechen:
-// "Das hat dir schon 3-mal geholfen."
-//
-// Je Werkzeug einzeln gezählt, nicht als Gesamtbudget. Wer causal_trace
-// dreimal nutzt, soll trotzdem brain_predict noch kennenlernen dürfen; ein
-// gemeinsamer Topf würde beim ersten Werkzeug aufgebraucht.
-//
-// ─── WAS DIESE ZÄHLUNG NICHT KANN ────────────────────────────────────────────
-//
-// Sie liegt lokal in ~/.cachly/ und gilt damit je Rechner. Wer neu installiert
-// oder auf einem zweiten Rechner arbeitet, bekommt neue Kostproben. Das ist
-// bewusst in Kauf genommen: Eine serverseitige Zählung wäre genauer, bräuchte
-// aber eine Migration und einen neuen Endpunkt — und für eine Kostprobe ist
-// großzügig der richtige Fehler. Wer sie mehrfach aufbraucht, hat das Werkzeug
-// mehrfach erlebt; das ist kein Verlust, das ist der Zweck.
-//
-// Zu messen ist der Erfolg an einer Zahl: heute 36 Ansagen, 0 Aufrüstungen.
-// Danach müsste das Verhältnis von `premium_taste_used` zu `premium_gate_hit`
-// zeigen, ob aus Erleben Interesse wird.
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-/** So oft darf jedes gesperrte Werkzeug auf der Gratis-Stufe echt laufen. */
-export const KOSTPROBEN_JE_WERKZEUG = 3;
-export function defaultKostprobePath() {
-    return join(homedir(), '.cachly', 'kostproben.json');
-}
-function lesen(path) {
-    try {
-        if (!existsSync(path))
-            return {};
-        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
-        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-            // Nur Zahlen übernehmen — eine beschädigte Datei darf nicht dazu führen,
-            // dass jemand dauerhaft freien Zugang bekommt oder dauerhaft keinen.
-            const out = {};
-            for (const [k, v] of Object.entries(parsed)) {
-                if (typeof v === 'number' && Number.isFinite(v) && v >= 0)
-                    out[k] = v;
-            }
-            return out;
-        }
-        return {};
-    }
-    catch {
-        return {}; // beschädigt → wie leer behandeln
-    }
-}
-/** Wie oft wurde dieses Werkzeug auf diesem Rechner schon gekostet? */
-export function kostprobenVerbraucht(werkzeug, path = defaultKostprobePath()) {
-    return lesen(path)[werkzeug] ?? 0;
-}
-/** Sind noch Kostproben übrig? */
-export function kostprobeUebrig(werkzeug, path = defaultKostprobePath()) {
-    return kostprobenVerbraucht(werkzeug, path) < KOSTPROBEN_JE_WERKZEUG;
-}
-/**
- * Verbraucht eine Kostprobe und liefert die neue Anzahl.
- * Schlägt das Schreiben fehl, wird trotzdem hochgezählt zurückgegeben — der
- * Aufruf darf nie an einem Dateisystemproblem scheitern. Im schlimmsten Fall
- * bekommt jemand eine Kostprobe mehr; das ist der harmlosere Fehler.
- */
-export function kostprobeVerbrauchen(werkzeug, path = defaultKostprobePath()) {
-    const alle = lesen(path);
-    const neu = (alle[werkzeug] ?? 0) + 1;
-    try {
-        alle[werkzeug] = neu;
-        mkdirSync(dirname(path), { recursive: true });
-        writeFileSync(path, JSON.stringify(alle, null, 2) + '\n', 'utf-8');
-    }
-    catch {
-        /* nie werfen */
-    }
-    return neu;
-}
-/**
- * Der Hinweis NACH einer Kostprobe. Bewusst kurz und ohne Druck — das Ergebnis
- * steht darüber und soll wirken, nicht der Text.
- */
-export function kostprobeHinweis(werkzeug, verbraucht, upgradeUrl) {
-    const uebrig = Math.max(0, KOSTPROBEN_JE_WERKZEUG - verbraucht);
-    if (uebrig > 0) {
-        return `\n\n_Kostprobe: \`${werkzeug}\` ist eine Premium-Funktion. ` +
-            `Noch ${uebrig} ${uebrig === 1 ? 'freier Lauf' : 'freie Läufe'} auf diesem Rechner._`;
-    }
-    return `\n\n_Das war deine letzte Kostprobe von \`${werkzeug}\`. ` +
-        `Weiter geht es hier: ${upgradeUrl}_`;
-}
-/**
- * Die Schranke, wenn die Kostproben aufgebraucht sind. Sie nennt eine ZAHL
- * statt eines Versprechens — "so oft hat es dir schon geholfen" ist ein
- * Argument, "eine Premium-Funktion" ist keines.
- */
-export function schrankeNachKostproben(werkzeug, pitch, upgradeUrl) {
-    return [
-        `🔒 **\`${werkzeug}\`** — deine ${KOSTPROBEN_JE_WERKZEUG} Kostproben sind aufgebraucht.`,
-        ``,
-        `Es hat dir hier schon ${KOSTPROBEN_JE_WERKZEUG}-mal geantwortet: ${pitch}`,
-        ``,
-        `Dein Gratis-Gedächtnis behält alles andere — Abruf, Lernen, Sitzungen, Kausalgraph. Für immer.`,
-        `Weiter mit der tieferen Schicht → ${upgradeUrl}`,
-    ].join('\n');
-}
-//# sourceMappingURL=kostprobe.js.map
+import{existsSync as c,mkdirSync as a,readFileSync as f,writeFileSync as p}from"node:fs";import{homedir as b}from"node:os";import{dirname as h,join as m}from"node:path";const i=3;function s(){return m(b(),".cachly","kostproben.json")}function u(r){try{if(!c(r))return{};const e=JSON.parse(f(r,"utf-8"));if(e&&typeof e=="object"&&!Array.isArray(e)){const t={};for(const[n,o]of Object.entries(e))typeof o=="number"&&Number.isFinite(o)&&o>=0&&(t[n]=o);return t}return{}}catch{return{}}}function l(r,e=s()){return u(e)[r]??0}function x(r,e=s()){return l(r,e)<i}function S(r,e=s()){const t=u(e),n=(t[r]??0)+1;try{t[r]=n,a(h(e),{recursive:!0}),p(e,JSON.stringify(t,null,2)+`
+`,"utf-8")}catch{}return n}function K(r,e,t){const n=Math.max(0,i-e);return n>0?`
+
+_Kostprobe: \`${r}\` ist eine Premium-Funktion. Noch ${n} ${n===1?"freier Lauf":"freie L\xE4ufe"} auf diesem Rechner._`:`
+
+_Das war deine letzte Kostprobe von \`${r}\`. Weiter geht es hier: ${t}_`}function k(r,e,t){return[`\u{1F512} **\`${r}\`** \u2014 deine ${i} Kostproben sind aufgebraucht.`,"",`Es hat dir hier schon ${i}-mal geantwortet: ${e}`,"","Dein Gratis-Ged\xE4chtnis beh\xE4lt alles andere \u2014 Abruf, Lernen, Sitzungen, Kausalgraph. F\xFCr immer.",`Weiter mit der tieferen Schicht \u2192 ${t}`].join(`
+`)}export{i as KOSTPROBEN_JE_WERKZEUG,s as defaultKostprobePath,K as kostprobeHinweis,x as kostprobeUebrig,S as kostprobeVerbrauchen,l as kostprobenVerbraucht,k as schrankeNachKostproben};

package/dist/src/lesson-preview.js

@@ -1,133 +1,2 @@
-/**
- * lesson-preview — one place that decides how a lesson is shown in a briefing.
- *
- * WHY THIS EXISTS (measured 2026-08-16, real incident):
- * A session briefing showed this lesson line:
- *
- *   ✅🔴 `node4:einrichtung-contabo-und-fallen` — node-4 (Contabo, 169.58.175.157,
- *   Lauterbourg FR, 12 Kerne / 48 GB / 400 GB, 25,29 EUR/Monat) eingeri
- *
- * The reader needed one thing from that lesson: the WireGuard address of the
- * machine. It sits at character 323 of `what_worked`. The preview cut at 100.
- * Worse, the lesson's `what_failed` field held the literal sentence "always read
- * `wg show wg0 allowed-ips`" — and no briefing surface renders `what_failed` for
- * a lesson whose outcome is "success". The lesson was displayed, at the right
- * moment, and the exact mistake it warns about happened anyway.
- *
- * The fix is not "show more prose". The two most actionable fields of that
- * lesson were already short and structured:
- *
- *   commands:   ["wg show wg0 allowed-ips", "ssh -i ~/.ssh/... -p 2222 root@..."]
- *   file_paths: ["/etc/wireguard/wg0.conf", ...]
- *
- * ~15 tokens that answer the question, thrown away in favour of 100 characters
- * of preamble. So a preview renders three things now: trimmed prose, a facts
- * tail drawn from the structured fields, and — for critical lessons — the
- * warning, regardless of outcome.
- *
- * This helps the EXISTING corpus. A writing rule ("put the fact first") only
- * improves lessons written after it; reading structured fields improves every
- * lesson ever stored.
- */
-const DEFAULTS = {
-    maxChars: 100,
-    facts: true,
-    warning: true,
-    maxFacts: 2,
-    factChars: 64,
-    warningChars: 110,
-    indent: '     ',
-};
-/** Collapse whitespace so a multi-line field cannot break list layout. */
-function flat(s) {
-    return String(s ?? '').replace(/\s+/g, ' ').trim();
-}
-/**
- * Cut to `max` characters, preferring a word boundary, and mark the cut.
- * The marker matters: without it a truncated line reads like a complete one,
- * and the reader never learns there is more to fetch.
- */
-export function trimTo(text, max) {
-    const s = flat(text);
-    if (max <= 0)
-        return '';
-    if (s.length <= max)
-        return s;
-    const hard = s.slice(0, max);
-    const space = hard.lastIndexOf(' ');
-    // Only honour the word boundary if it does not throw away most of the budget.
-    const body = space > max * 0.6 ? hard.slice(0, space) : hard;
-    return `${body.replace(/[\s,;:.-]+$/, '')}…`;
-}
-/**
- * Facts worth showing even when the prose is cut: commands first (they are
- * directly runnable), then file paths. Deduplicated, order preserved.
- */
-export function factsOf(l, maxFacts, factChars) {
-    const out = [];
-    const seen = new Set();
-    const take = (raw, prefix, limit) => {
-        let n = 0;
-        for (const item of Array.isArray(raw) ? raw : []) {
-            if (n >= limit)
-                break;
-            const v = flat(item);
-            if (!v)
-                continue;
-            const key = `${prefix}${v}`;
-            if (seen.has(key))
-                continue;
-            seen.add(key);
-            out.push(`${prefix}${trimTo(v, factChars)}`);
-            n++;
-        }
-    };
-    take(l.commands, '⌘ ', maxFacts);
-    take(l.file_paths, '▸ ', maxFacts);
-    return out;
-}
-/**
- * The warning is the single most fear-inducing, mistake-preventing part of a
- * lesson — and it was invisible whenever `outcome` was "success". Show it for
- * critical lessons no matter how the lesson ended.
- */
-export function warningOf(l, max) {
-    const w = flat(l.what_failed);
-    if (!w)
-        return null;
-    const isCritical = String(l.severity ?? '').toLowerCase() === 'critical';
-    const failed = l.outcome === 'failure' || l.outcome === 'partial';
-    if (!isCritical && !failed)
-        return null;
-    return trimTo(w, max);
-}
-/**
- * Render the body of one briefing entry: prose, then facts, then warning.
- * Returns lines WITHOUT the caller's bullet/emoji prefix — the caller owns the
- * first line's prefix, this owns everything after the em dash.
- */
-export function lessonPreviewLines(l, opts = {}) {
-    const o = { ...DEFAULTS, ...opts };
-    const lines = [];
-    const prose = trimTo(l.what_worked ?? '', o.maxChars);
-    if (prose)
-        lines.push(prose);
-    if (o.warning) {
-        const w = warningOf(l, o.warningChars);
-        if (w)
-            lines.push(`${o.indent}⚠️ ${w}`);
-    }
-    if (o.facts) {
-        const f = factsOf(l, o.maxFacts, o.factChars);
-        // One line, not one per fact: a briefing lists many lessons, and a
-        // four-line block per lesson would push the interesting ones off screen.
-        if (f.length)
-            lines.push(`${o.indent}${f.join('  ')}`);
-    }
-    return lines;
-}
-/** Convenience: the same content as a single newline-joined string. */
-export function lessonPreview(l, opts = {}) {
-    return lessonPreviewLines(l, opts).join('\n');
-}
-//# sourceMappingURL=lesson-preview.js.map
+const w={maxChars:100,facts:!0,warning:!0,maxFacts:2,factChars:64,warningChars:110,indent:"     "};function c(n){return String(n??"").replace(/\s+/g," ").trim()}function a(n,e){const t=c(n);if(e<=0)return"";if(t.length<=e)return t;const r=t.slice(0,e),s=r.lastIndexOf(" ");return`${(s>e*.6?r.slice(0,s):r).replace(/[\s,;:.-]+$/,"")}\u2026`}function g(n,e,t){const r=[],s=new Set,i=(f,u,p)=>{let h=0;for(const d of Array.isArray(f)?f:[]){if(h>=p)break;const o=c(d);if(!o)continue;const l=`${u}${o}`;s.has(l)||(s.add(l),r.push(`${u}${a(o,t)}`),h++)}};return i(n.commands,"\u2318 ",e),i(n.file_paths,"\u25B8 ",e),r}function $(n,e){const t=c(n.what_failed);if(!t)return null;const r=String(n.severity??"").toLowerCase()==="critical",s=n.outcome==="failure"||n.outcome==="partial";return!r&&!s?null:a(t,e)}function C(n,e={}){const t={...w,...e},r=[],s=a(n.what_worked??"",t.maxChars);if(s&&r.push(s),t.warning){const i=$(n,t.warningChars);i&&r.push(`${t.indent}\u26A0\uFE0F ${i}`)}if(t.facts){const i=g(n,t.maxFacts,t.factChars);i.length&&r.push(`${t.indent}${i.join("  ")}`)}return r}function m(n,e={}){return C(n,e).join(`
+`)}export{g as factsOf,m as lessonPreview,C as lessonPreviewLines,a as trimTo,$ as warningOf};

package/dist/src/namespace.js

@@ -1,128 +1 @@
-/**
- * Namespace Auto-Detection
- *
- * Classify a prompt into one of 5 semantic namespaces using text heuristics.
- * Overhead: <0.1 ms. No embedding required.
- *
- * Covers: EN · DE · FR · ES · IT · PT · NL
- * Source of truth for keyword lists: sdk/shared/filler-words.ts
- */
-const CODE_KW = [
-    'function ', 'def ', 'class ', 'import ', 'const ', 'let ', 'var ',
-    'return ', ' => ', 'void ', 'public class', 'func ', '#include', 'package ',
-    'struct ', 'interface ', 'async def', 'lambda ', '#!/',
-];
-// Translation – EN · DE · FR · ES · IT · PT · NL
-const TRANSL_KW = [
-    // EN
-    'translate', 'in english', 'in german', 'in french', 'in spanish', 'in italian', 'in portuguese',
-    // DE
-    'übersetze', 'übersetz', 'auf deutsch', 'auf englisch', 'ins deutsche', 'ins englische',
-    // FR
-    'traduis', 'traduire', 'en français', 'en anglais', 'en allemand', 'en espagnol',
-    // ES
-    'traduce', 'traducir', 'al español', 'al inglés', 'al alemán',
-    // IT
-    'traduci', 'in italiano', 'in inglese', 'in tedesco',
-    // PT
-    'traduz', 'traduzir', 'em português', 'em inglês', 'em alemão',
-    // NL
-    'vertaal',
-];
-// Summary – EN · DE · FR · ES · IT · PT
-const SUMMARY_KW = [
-    // EN
-    'summarize', 'summarise', 'summary', 'tl;dr', 'tldr',
-    'key points', 'give me a brief', 'in a nutshell', 'in short', 'overview of',
-    // DE
-    'zusammenfass', 'stichpunkte', 'fasse zusammen', 'kurze zusammenfassung', 'überblick',
-    // FR
-    'résume', 'résumé', 'résumer', 'points clés', 'en bref', "vue d'ensemble",
-    // ES
-    'resumir', 'en resumen', 'puntos clave', 'en breve', 'resumen de',
-    // IT
-    'riassumi', 'riassunto', 'punti chiave', 'in breve', 'panoramica',
-    // PT
-    'resumir', 'em resumo', 'pontos principais', 'resumo de',
-];
-// Q&A prefixes – EN · DE · FR · ES · IT · PT
-const QA_PREFIXES = [
-    // EN
-    'what ', 'who ', 'where ', 'when ', 'why ', 'how ', 'which ',
-    'is ', 'are ', 'was ', 'were ', 'does ', 'do ', 'did ',
-    'can ', 'could ', 'would ', 'should ', 'will ',
-    // DE
-    'wer ', 'wie ', 'wo ', 'wann ', 'warum ', 'welche', 'wieso ', 'was ist',
-    // FR
-    "qu'est-ce que", 'comment ', 'pourquoi ', 'quel ', 'quelle ', 'quels ',
-    'est-ce que', 'qui est', 'où est', 'quand ',
-    // ES
-    'qué ', 'cómo ', 'quién ', 'dónde ', 'cuándo ', 'por qué ',
-    // IT
-    'come ', 'perché ', "cos'è", "com'è", 'dove ', 'quando ', 'chi è',
-    // PT
-    'o que ', 'como ', 'quem ', 'onde ', 'quando ', 'por que ',
-];
-/**
- * Classify a prompt into one of 5 semantic namespaces.
- * Returns one of: `cachly:sem:code` | `:translation` | `:summary` | `:qa` | `:creative`
- */
-export function detectNamespace(prompt) {
-    const s = prompt.trim().toLowerCase();
-    if (CODE_KW.some((kw) => s.includes(kw)))
-        return 'cachly:sem:code';
-    if (TRANSL_KW.some((kw) => s.includes(kw)))
-        return 'cachly:sem:translation';
-    if (SUMMARY_KW.some((kw) => s.includes(kw)))
-        return 'cachly:sem:summary';
-    if (QA_PREFIXES.some((p) => s.startsWith(p)))
-        return 'cachly:sem:qa';
-    if (s.trimEnd().endsWith('?'))
-        return 'cachly:sem:qa';
-    return 'cachly:sem:creative';
-}
-/**
- * Filler words used by prompt normalisation in MCP context.
- * Source of truth: sdk/shared/filler-words.ts
- * Covers: EN · DE · FR · ES · IT · PT
- */
-export const FILLER_WORDS = [
-    // EN
-    'please', 'hey', 'hi', 'hello',
-    'could you', 'can you', 'would you', 'will you',
-    'just', 'quickly', 'briefly', 'simply',
-    'tell me', 'show me', 'give me', 'help me', 'assist me',
-    'explain to me', 'describe to me',
-    'i need', 'i want', 'i would like', "i'd like", "i'm looking for",
-    // DE
-    'bitte', 'mal eben', 'schnell', 'kurz', 'einfach',
-    'kannst du', 'könntest du', 'könnten sie', 'würden sie', 'würdest du',
-    'hallo', 'hi', 'hey',
-    'sag mir', 'zeig mir', 'gib mir', 'hilf mir', 'erkläre mir', 'erklär mir',
-    'ich brauche', 'ich möchte', 'ich hätte gerne', 'ich suche',
-    // FR
-    "s'il vous plaît", 'svp', 'stp', 'bonjour', 'salut', 'allô',
-    'pouvez-vous', 'pourriez-vous', 'peux-tu', 'pourrais-tu',
-    'dis-moi', 'dites-moi', 'montre-moi', 'montrez-moi',
-    "j'ai besoin de", 'je voudrais', 'je cherche', 'je souhaite',
-    'expliquez-moi', 'explique-moi', 'aidez-moi', 'aide-moi',
-    // ES
-    'por favor', 'hola', 'oye',
-    'puedes', 'podrías', 'podría usted', 'me puedes', 'me podrías',
-    'dime', 'dígame', 'muéstrame', 'muéstreme', 'dame', 'deme',
-    'necesito', 'quisiera', 'me gustaría', 'quiero saber',
-    'ayúdame', 'ayúdeme', 'explícame', 'explíqueme',
-    // IT
-    'per favore', 'perfavore', 'ciao', 'salve', 'ehi',
-    'potresti', 'mi potresti', 'potrebbe', 'mi potrebbe',
-    'dimmi', 'mi dica', 'mostrami', 'dammi', 'mi dia',
-    'ho bisogno di', 'vorrei', 'mi piacerebbe',
-    'aiutami', 'mi aiuti', 'spiegami', 'mi spieghi',
-    // PT
-    'por favor', 'olá', 'oi', 'ei',
-    'pode', 'poderia', 'você poderia', 'você pode', 'podes',
-    'me diga', 'diga-me', 'me mostre', 'mostre-me', 'me dê', 'dê-me',
-    'preciso de', 'gostaria de', 'quero saber', 'estou procurando',
-    'me ajude', 'ajude-me', 'explique-me', 'me explique',
-];
-//# sourceMappingURL=namespace.js.map
+const a=["function ","def ","class ","import ","const ","let ","var ","return "," => ","void ","public class","func ","#include","package ","struct ","interface ","async def","lambda ","#!/"],r=["translate","in english","in german","in french","in spanish","in italian","in portuguese","\xFCbersetze","\xFCbersetz","auf deutsch","auf englisch","ins deutsche","ins englische","traduis","traduire","en fran\xE7ais","en anglais","en allemand","en espagnol","traduce","traducir","al espa\xF1ol","al ingl\xE9s","al alem\xE1n","traduci","in italiano","in inglese","in tedesco","traduz","traduzir","em portugu\xEAs","em ingl\xEAs","em alem\xE3o","vertaal"],o=["summarize","summarise","summary","tl;dr","tldr","key points","give me a brief","in a nutshell","in short","overview of","zusammenfass","stichpunkte","fasse zusammen","kurze zusammenfassung","\xFCberblick","r\xE9sume","r\xE9sum\xE9","r\xE9sumer","points cl\xE9s","en bref","vue d'ensemble","resumir","en resumen","puntos clave","en breve","resumen de","riassumi","riassunto","punti chiave","in breve","panoramica","resumir","em resumo","pontos principais","resumo de"],m=["what ","who ","where ","when ","why ","how ","which ","is ","are ","was ","were ","does ","do ","did ","can ","could ","would ","should ","will ","wer ","wie ","wo ","wann ","warum ","welche","wieso ","was ist","qu'est-ce que","comment ","pourquoi ","quel ","quelle ","quels ","est-ce que","qui est","o\xF9 est","quand ","qu\xE9 ","c\xF3mo ","qui\xE9n ","d\xF3nde ","cu\xE1ndo ","por qu\xE9 ","come ","perch\xE9 ","cos'\xE8","com'\xE8","dove ","quando ","chi \xE8","o que ","como ","quem ","onde ","quando ","por que "];function u(s){const i=s.trim().toLowerCase();return a.some(e=>i.includes(e))?"cachly:sem:code":r.some(e=>i.includes(e))?"cachly:sem:translation":o.some(e=>i.includes(e))?"cachly:sem:summary":m.some(e=>i.startsWith(e))||i.trimEnd().endsWith("?")?"cachly:sem:qa":"cachly:sem:creative"}const n=["please","hey","hi","hello","could you","can you","would you","will you","just","quickly","briefly","simply","tell me","show me","give me","help me","assist me","explain to me","describe to me","i need","i want","i would like","i'd like","i'm looking for","bitte","mal eben","schnell","kurz","einfach","kannst du","k\xF6nntest du","k\xF6nnten sie","w\xFCrden sie","w\xFCrdest du","hallo","hi","hey","sag mir","zeig mir","gib mir","hilf mir","erkl\xE4re mir","erkl\xE4r mir","ich brauche","ich m\xF6chte","ich h\xE4tte gerne","ich suche","s'il vous pla\xEEt","svp","stp","bonjour","salut","all\xF4","pouvez-vous","pourriez-vous","peux-tu","pourrais-tu","dis-moi","dites-moi","montre-moi","montrez-moi","j'ai besoin de","je voudrais","je cherche","je souhaite","expliquez-moi","explique-moi","aidez-moi","aide-moi","por favor","hola","oye","puedes","podr\xEDas","podr\xEDa usted","me puedes","me podr\xEDas","dime","d\xEDgame","mu\xE9strame","mu\xE9streme","dame","deme","necesito","quisiera","me gustar\xEDa","quiero saber","ay\xFAdame","ay\xFAdeme","expl\xEDcame","expl\xEDqueme","per favore","perfavore","ciao","salve","ehi","potresti","mi potresti","potrebbe","mi potrebbe","dimmi","mi dica","mostrami","dammi","mi dia","ho bisogno di","vorrei","mi piacerebbe","aiutami","mi aiuti","spiegami","mi spieghi","por favor","ol\xE1","oi","ei","pode","poderia","voc\xEA poderia","voc\xEA pode","podes","me diga","diga-me","me mostre","mostre-me","me d\xEA","d\xEA-me","preciso de","gostaria de","quero saber","estou procurando","me ajude","ajude-me","explique-me","me explique"];export{n as FILLER_WORDS,u as detectNamespace};

package/dist/src/notifier.js

@@ -1,6 +1 @@
-/**
- * Re-exports from the shared telegram-notify package.
- * Canonical implementation: packages/telegram-notify/client.ts
- */
-export { notify, formatMessage } from '../packages/telegram-notify/client.js';
-//# sourceMappingURL=notifier.js.map
+import{notify as f,formatMessage as r}from"../packages/telegram-notify/client.js";export{r as formatMessage,f as notify};

package/dist/src/rangfolge-stellschrauben.js

@@ -0,0 +1 @@
+const o=75,t=.5,E=.7;export{t as EINGANG_SCHWELLE,E as EINGANG_SORTIER_GEWICHT,o as SINN_TOPF};

package/dist/src/rangfolge.js

@@ -1,214 +1 @@
-/**
- * Der zusammengesetzte Sortierer.
- *
- * ── Was hier drinsteckt, und was NICHT ──────────────────────────────────────
- *
- * Am 19.08.2026 wurden an 499 echten Lektionen mit 100 Fragen ein Dutzend
- * Verfahren durchgemessen. Die meisten haben nichts gebracht. Sie stehen hier,
- * damit sie niemand ein zweites Mal baut:
- *
- *   Symptom-Sicht (what_failed als eigener Vektor)   17 % statt 40 % — das Feld
- *     beschreibt bei uns nicht das Symptom, sondern was vergeblich versucht wurde
- *   Schwerpunkt abziehen                             41 % — im Rauschen
- *   Hauptrichtungen entfernen (1, 3, 6 Stueck)       37–41 % — im Rauschen
- *   Nabenabzug (CSLS-artig)                          41 % — im Rauschen
- *   Text in Stuecke schneiden                        nicht gebaut: gemessen deckt
- *     das beste Stueck genauso viel ab wie der ganze Text (Verhaeltnis 1,00),
- *     und es liegt bei 86 von 96 Fragen ohnehin am Anfang
- *
- * Was BLEIBT, sind vier Bestandteile — kreuzweise geprueft, also auf der einen
- * Haelfte der Fragen eingestellt und auf der anderen gemessen, in beide
- * Richtungen:
- *
- *                        P@1     MRR
- *   nur Bedeutung        40 %   51,3 %
- *   zusammengesetzt      51 %   57,0 %
- *
- * ── Die vier Bestandteile ───────────────────────────────────────────────────
- *
- * 1. NAEHE ZUM GANZEN TEXT (Sicht A). Der Grundstock.
- *
- * 2. NAEHE ZUM THEMENNAMEN (Sicht C). Der Name ist kurz wie eine Frage — der
- *    Vergleich ist damit symmetrisch, waehrend eine 60-Zeichen-Frage gegen
- *    1376 Zeichen Text es nicht ist. Allein liefert diese Sicht nur 26 %, im
- *    Verbund traegt sie verlaesslich (Gewicht 0,6 in beiden Richtungen).
- *
- * 3. RUECKKOPPLUNG. Die ersten drei Treffer sind meistens ungefaehr richtig.
- *    Ihre Vektoren werden zu einem Viertel unter die Frage gemischt, dann wird
- *    erneut verglichen. Kostet nichts — keine neue Einbettung, nur eine
- *    Mittelung vorhandener Zahlen.
- *
- * 4. SELTENHEITS-UEBERLAPPUNG. Welcher Anteil der SELTENEN Fragewoerter kommt
- *    im Text vor. Ohne Laengennormierung, ohne unscharfe Treffer, ohne
- *    Bigramme.
- *
- *    Das ist der unbequeme Befund: dieses eine Verhaeltnis bekam beim Einstellen
- *    das Gewicht 1,0 bis 1,6 — unser ausgefeiltes BM25 mit Laengennormierung,
- *    Bigramm-Naehe, unscharfen Treffern und Frischebonus bekam NULL. Nicht weil
- *    Woerter nichts taugen, sondern weil das ganze Beiwerk beim Sortieren
- *    daneben misst.
- *
- * ── Warum innerhalb des Topfes normiert wird ────────────────────────────────
- *
- * Ueber den ganzen Bestand liegen alle Aehnlichkeiten zwischen 0,42 und 0,61 —
- * ein sehr schmales Band, weil alle Vektoren eine gemeinsame Grundrichtung
- * teilen (gemessen: 69,8 Prozent). Unter fuenfzig Kandidaten spreizt eine
- * Normierung auf 0 bis 1 genau die Unterschiede auf, um die es geht. Das ist
- * dasselbe Ziel wie beim Schwerpunkt-Abziehen — nur dort, wo es wirkt.
- */
-import { kosinus } from './bedeutung.js';
-/** Wörter eines Textes, umlautfrei, ohne Kurzwörter. */
-export function inhaltsWoerter(text) {
-    return new Set(text.toLowerCase()
-        .replace(/ä/g, 'ae').replace(/ö/g, 'oe').replace(/ü/g, 'ue').replace(/ß/g, 'ss')
-        .split(/[^a-z0-9]+/)
-        .filter((w) => w.length > 3));
-}
-/**
- * Es gibt hier KEINE Stammbildung — und das ist gemessen, nicht vergessen.
- *
- * Naheliegend wäre, `Abhaengigkeiten` und `Abhaengigkeit` auf einen Nenner zu
- * bringen. Drei Varianten wurden am 19.08.2026 an 499 Lektionen mit 100 Fragen
- * kreuzweise durchgemessen:
- *
- *   ohne Stammbildung          P@1 50 %   MRR 56,4 %
- *   erste 6 Zeichen            P@1 47 %   MRR 54,7 %
- *   erste 8 Zeichen            P@1 47 %   MRR 54,7 %
- *
- * Jede Form von Kürzen kostet drei Punkte. Der Grund liegt daran, was diese
- * Suche trägt: seltene Fachwörter. `fail2ban`, `stampede`, `timestamptz`,
- * `keycloak` entscheiden eine Frage praktisch allein — und jede Verschmelzung
- * verwischt genau sie. `container` und `contains` werden zu demselben Wort,
- * und aus zwei seltenen wird ein häufiges.
- *
- * Beugung einzufangen lohnt sich also nur, wo die häufigen Wörter zählen. Hier
- * zählen die seltenen.
- *
- * (Die Wortform-Behandlung in deutsch.ts bleibt davon unberührt — sie wirkt im
- * Wortabgleich, der die Vorauswahl macht, nicht in dieser Bewertung.)
- */
-export function grobStamm(w) {
-    return w;
-}
-/**
- * Die Seltenheit jedes Wortes im Bestand — einmal berechnet, oft benutzt.
- *
- * Trifft eine Frage das Wort "nicht", sagt das nichts. Trifft sie "fail2ban",
- * ist die Sache praktisch entschieden. Ohne diese Gewichtung sind beide gleich
- * viel wert.
- */
-export class Seltenheit {
-    df = new Map();
-    anzahl = 0;
-    /** @param texte je ein Text pro Datensatz */
-    constructor(texte) {
-        this.anzahl = texte.length;
-        for (const t of texte) {
-            for (const w of inhaltsWoerter(t))
-                this.df.set(grobStamm(w), (this.df.get(grobStamm(w)) ?? 0) + 1);
-        }
-    }
-    wert(wort) {
-        return Math.log((this.anzahl + 1) / ((this.df.get(grobStamm(wort)) ?? 0) + 1));
-    }
-    /**
-     * Welcher Anteil der seltenen Fragewörter kommt im Text vor.
-     *
-     * Der Nenner ist die Summe über ALLE Fragewörter — ein fehlendes seltenes
-     * Wort zieht damit den Wert herunter. Fehlende Belege zählen also mit, nicht
-     * nur vorhandene.
-     */
-    deckung(frageWoerter, textWoerter) {
-        let gesamt = 0;
-        let getroffen = 0;
-        for (const w of frageWoerter) {
-            const g = this.wert(w);
-            gesamt += g;
-            if (textWoerter.has(grobStamm(w)))
-                getroffen += g;
-        }
-        return gesamt > 0 ? getroffen / gesamt : 0;
-    }
-}
-/** Auf 0 bis 1 spreizen — innerhalb des Topfes, nicht über den Bestand. */
-export function spreizeImTopf(werte) {
-    const gueltig = werte.filter((x) => Number.isFinite(x) && x > -2);
-    if (gueltig.length === 0)
-        return werte.map(() => 0);
-    let min = Infinity;
-    let max = -Infinity;
-    for (const x of gueltig) {
-        if (x < min)
-            min = x;
-        if (x > max)
-            max = x;
-    }
-    if (max === min)
-        return werte.map(() => 0.5);
-    return werte.map((x) => (x > -2 ? (x - min) / (max - min) : 0));
-}
-/**
- * Die Frage mit ihren besten Treffern anreichern.
- *
- * Die Frage benutzt Alltagsworte, die Lektionen Fachworte. Die ersten Treffer
- * schlagen diese Brücke: ihre Vektoren zeigen dorthin, wo die Antwort liegt.
- *
- * Das Risiko ist bekannt und begrenzt: sind die ersten Treffer falsch, zieht
- * die Anreicherung in die falsche Richtung. Deshalb bleibt die ursprüngliche
- * Frage mit drei Vierteln stehen — gemessen war das besser als jede stärkere
- * Beimischung.
- */
-export function reichereAn(frage, besteTreffer, anteil = 0.25) {
-    if (besteTreffer.length === 0)
-        return frage;
-    const d = frage.length;
-    const m = new Array(d).fill(0);
-    for (const v of besteTreffer) {
-        if (v.length !== d)
-            continue;
-        for (let i = 0; i < d; i++)
-            m[i] += v[i] / besteTreffer.length;
-    }
-    return frage.map((x, i) => (1 - anteil) * x + anteil * m[i]);
-}
-/**
- * Die Gewichte.
- *
- * Kreuzweise ermittelt: auf der einen Hälfte der Fragen eingestellt, auf der
- * anderen gemessen, in beide Richtungen. Die drei Werte hier waren in BEIDEN
- * Richtungen stabil. Zwei weitere Merkmale — Überlappung mit dem Themennamen
- * und Qualitätsmerkmale — schwankten zwischen den Richtungen und sind deshalb
- * NICHT dabei: was nur in einer Hälfte hilft, ist eine Eigenschaft dieser
- * Hälfte, keine des Verfahrens.
- */
-export const GEWICHTE = {
-    /** Nähe zum ganzen Text. Der Grundstock, deshalb 1. */
-    text: 1,
-    /** Nähe zum Themennamen. In beiden Richtungen 0,6. */
-    thema: 0.6,
-    /** Angereicherte Frage gegen den ganzen Text. In beiden Richtungen 0,3. */
-    rueckkopplung: 0.3,
-    /** Anteil der seltenen Fragewörter im Text. 1,0 bis 1,6 — Mitte genommen. */
-    seltenheit: 1.3,
-};
-/**
- * Punktzahl je Kandidat. Höher ist besser.
- *
- * Erwartet den GANZEN Topf auf einmal, weil die Normierung ihn braucht — eine
- * Punktzahl für einen einzelnen Kandidaten gibt es nicht und kann es nicht
- * geben.
- */
-export function bewerteTopf(topf, gewichte = GEWICHTE) {
-    const t = spreizeImTopf(topf.map((k) => k.naeheText));
-    const th = spreizeImTopf(topf.map((k) => k.naeheThema));
-    const r = spreizeImTopf(topf.map((k) => k.naeheRueckkopplung));
-    return topf.map((k, i) => gewichte.text * t[i]
-        + gewichte.thema * th[i]
-        + gewichte.rueckkopplung * r[i]
-        + gewichte.seltenheit * k.seltenheitsDeckung);
-}
-/** Bequemlichkeit: Kosinus mit Lücken-Behandlung. */
-export function naeheOderLuecke(frage, vektor) {
-    return frage && vektor && vektor.length > 0 ? kosinus(frage, vektor) : -2;
-}
-//# sourceMappingURL=rangfolge.js.map
+import{kosinus as c}from"./bedeutung.js";function i(e){return new Set(e.toLowerCase().replace(/ä/g,"ae").replace(/ö/g,"oe").replace(/ü/g,"ue").replace(/ß/g,"ss").split(/[^a-z0-9]+/).filter(t=>t.length>3))}function m(e){return e}class f{df=new Map;anzahl=0;constructor(t){this.anzahl=t.length;for(const l of t)for(const a of i(l))this.df.set(a,(this.df.get(a)??0)+1)}wert(t){return Math.log((this.anzahl+1)/((this.df.get(t)??0)+1))}deckung(t,l){let a=0,s=0;for(const r of t){const n=this.wert(r);a+=n,l.has(r)&&(s+=n)}return a>0?s/a:0}}function u(e){const t=e.filter(o=>Number.isFinite(o)&&o>-2);if(t.length===0)return e.map(()=>0);let l=1/0,a=-1/0;for(const o of t)o<l&&(l=o),o>a&&(a=o);if(a===l)return e.map(()=>.5);const s=e.map(o=>Number.isFinite(o)&&o>-2?(o-l)/(a-l):-1);let r=0;for(const o of s)o>=0&&(r+=o);const n=r/t.length;return s.map(o=>o>=0?o:n)}function g(e,t,l=.25){if(t.length===0)return e;const a=e.length,s=new Array(a).fill(0);for(const r of t)if(r.length===a)for(let n=0;n<a;n++)s[n]+=r[n]/t.length;return e.map((r,n)=>(1-l)*r+l*s[n])}const h={text:1,thema:0,rueckkopplung:.3,seltenheit:1.3};function k(e,t=h){const l=u(e.map(r=>r.naeheText)),a=u(e.map(r=>r.naeheThema)),s=u(e.map(r=>r.naeheRueckkopplung));return e.map((r,n)=>t.text*l[n]+t.thema*a[n]+t.rueckkopplung*s[n]+t.seltenheit*r.seltenheitsDeckung)}function x(e,t=h,l=.3){const a=u(e.map(n=>n.naeheText)),s=u(e.map(n=>n.naeheThema)),r=u(e.map(n=>n.naeheRueckkopplung));return e.map((n,o)=>t.text*Math.log(l+a[o])+t.thema*Math.log(l+s[o])+t.rueckkopplung*Math.log(l+r[o])+t.seltenheit*Math.log(l+n.seltenheitsDeckung))}function d(e,t){return e&&t&&t.length>0?c(e,t):-2}export{h as GEWICHTE,f as Seltenheit,k as bewerteTopf,x as bewerteTopfStreng,m as grobStamm,i as inhaltsWoerter,d as naeheOderLuecke,g as reichereAn,u as spreizeImTopf};