@cachly-dev/mcp-server 0.10.129 → 0.10.130

package/dist/src/resonanz.js

@@ -1,140 +1 @@
-/**
- * Resonanz — eine Lektion wird durch die Fragen adressiert, die zu ihr fuehrten.
- *
- * ── Das Vorbild ─────────────────────────────────────────────────────────────
- *
- * Das Hologramm speichert nicht das Bild, sondern das Interferenzmuster des
- * Lichts, das es beleuchtet hat. Beleuchtet man es spaeter wieder, entsteht
- * das Bild aus dem Muster — und jeder Splitter traegt das Ganze, nur unschaerfer.
- *
- * ── Das Problem, gegen das es antritt ───────────────────────────────────────
- *
- * Jeder Index in diesem Haus beschreibt, was eine Lektion SAGT: ihr Volltext,
- * ihr Themenname. Gesucht wird aber mit dem, was jemand FRAGT — und die beiden
- * Sprachen fallen auseinander. Gemessen am 21.08.2026: von 100 Fragen liegen
- * 11 auf Platz 100+ der Bedeutungsrangfolge. Fuer die ist die richtige Lektion
- * semantisch nicht "in der Naehe" — keine Vektorrechnung ueber ihren Text holt
- * sie naeher heran.
- *
- * Diese Datei fuehrt deshalb eine dritte Sicht: je Lektion die laufende
- * Ueberlagerung aller Fragevektoren, die nachweislich zu ihr gefuehrt haben.
- * Der Vergleich laeuft dann Frage-gegen-Frage statt Frage-gegen-Text.
- *
- * ── Warum wir das koennen und andere nicht ──────────────────────────────────
- *
- * Es braucht die geschlossene Schleife: von der Frage ueber den Treffer bis zu
- * der Bestaetigung, dass der Treffer richtig war. Ein Suchindex, der nur
- * Dokumente kennt, hat diese Daten nicht.
- *
- * ── Die ehrliche Grenze ─────────────────────────────────────────────────────
- *
- * Der Index ist am Anfang leer. Eine Lektion, die noch nie gefunden wurde, hat
- * keine Resonanz — und ausgerechnet die braeuchte sie am dringendsten. Das ist
- * kein Fehler der Idee, sondern ihre Bauart: sie wird mit der Zeit besser und
- * am ersten Tag gar nicht. Deshalb ist sie ein ZUSATZ und ersetzt keine Sicht.
- */
-import { packe, entpacke, kosinus } from './bedeutung.js';
-/** Schluessel-Vorsatz der Resonanzvektoren. */
-export const RESONANZ_PRAEFIX = 'cachly:lesson:res:';
-/**
- * Fuegt einen Fragevektor zur Resonanz einer Lektion.
- *
- * Die Ueberlagerung ist eine gleitende Summe mit Normierung: der neue Vektor
- * zieht die Resonanz um `anteil` in seine Richtung. Ohne Normierung waeren
- * haeufig gefundene Lektionen einfach laenger und wuerden jeden Kosinus
- * gewinnen — die Naehe misst dann Beliebtheit statt Passung.
- *
- * `anteil` bewusst klein: eine einzelne Frage darf die Adresse einer Lektion
- * nicht umschreiben. Zehn aehnliche Fragen sollen sie praegen, eine schraege
- * nicht.
- *
- * @param bisher die bisherige Resonanz oder null
- * @param frage der Fragevektor, der zu einem bestaetigten Treffer fuehrte
- * @param anteil wie stark die neue Frage zieht
- */
-export function ueberlagere(bisher, frage, anteil = 0.3) {
-    if (!bisher || bisher.length !== frage.length)
-        return normiere(frage);
-    const neu = bisher.map((x, i) => (1 - anteil) * x + anteil * frage[i]);
-    return normiere(neu);
-}
-/** Auf Laenge 1. Ein Nullvektor bleibt ein Nullvektor. */
-export function normiere(v) {
-    let q = 0;
-    for (const x of v)
-        q += x * x;
-    const l = Math.sqrt(q);
-    return l > 0 ? v.map((x) => x / l) : v;
-}
-/**
- * Der Resonanzbestand — dieselbe Mechanik wie Vektorbestand, andere Sicht.
- *
- * Bewusst eine eigene kleine Klasse statt eines vierten Vektorbestand-Praefix:
- * dieser Bestand wird auch GESCHRIEBEN (im Recall-Pfad, nach einem Treffer),
- * und Schreiben gehoert nicht in eine Klasse, die sonst nur laedt.
- */
-export class Resonanzbestand {
-    frischeMs;
-    vektoren = new Map();
-    geladen = 0;
-    constructor(frischeMs = 60_000) {
-        this.frischeMs = frischeMs;
-    }
-    /** Die Naehe einer Frage zur Resonanz EINER Lektion. -2, wenn keine da ist. */
-    naehe(frage, topic) {
-        const v = this.vektoren.get(topic);
-        return v ? kosinus(frage, v) : -2;
-    }
-    get groesse() { return this.vektoren.size; }
-    /** Nur fuer Messungen: Resonanz ohne Speicher setzen. */
-    setzeDirekt(topic, v) {
-        this.vektoren.set(topic, v);
-    }
-    /** Laedt fehlende Resonanzvektoren nach. */
-    async aktualisiere(redis, jetzt = Date.now()) {
-        if (this.vektoren.size > 0 && jetzt - this.geladen < this.frischeMs)
-            return;
-        const schluessel = [];
-        let cursor = '0';
-        do {
-            const [next, gefunden] = await redis.scan(cursor, 'MATCH', `${RESONANZ_PRAEFIX}*`, 'COUNT', 500);
-            cursor = next;
-            schluessel.push(...gefunden);
-        } while (cursor !== '0');
-        if (schluessel.length === 0) {
-            this.geladen = jetzt;
-            return;
-        }
-        const werte = await redis.mget(...schluessel);
-        const frisch = new Map();
-        for (const [i, s] of schluessel.entries()) {
-            const roh = werte[i];
-            if (!roh)
-                continue;
-            const v = entpacke(roh);
-            if (v)
-                frisch.set(s.slice(RESONANZ_PRAEFIX.length), v);
-        }
-        this.vektoren = frisch;
-        this.geladen = jetzt;
-    }
-    /**
-     * Schreibt die neue Resonanz einer Lektion.
-     *
-     * Faengt jeden Fehler ab: eine Suche darf nie daran scheitern, dass sie sich
-     * nicht merken konnte, was sie gefunden hat. Der Aufrufer bekommt `false`
-     * und kann es melden.
-     */
-    async schreibe(redis, topic, frage, anteil = 0.3) {
-        try {
-            const neu = ueberlagere(this.vektoren.get(topic) ?? null, frage, anteil);
-            this.vektoren.set(topic, neu);
-            await redis.set(`${RESONANZ_PRAEFIX}${topic}`, packe(neu));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-}
-//# sourceMappingURL=resonanz.js.map
+import{packe as g,entpacke as k,kosinus as p}from"./bedeutung.js";const a="cachly:lesson:res:";function v(s,e,t=.3){if(!s||s.length!==e.length)return f(e);const n=s.map((r,o)=>(1-t)*r+t*e[o]);return f(n)}function f(s){let e=0;for(const n of s)e+=n*n;const t=Math.sqrt(e);return t>0?s.map(n=>n/t):s}class M{frischeMs;vektoren=new Map;geladen=0;constructor(e=6e4){this.frischeMs=e}naehe(e,t){const n=this.vektoren.get(t);return n?p(e,n):-2}get groesse(){return this.vektoren.size}setzeDirekt(e,t){this.vektoren.set(e,t)}async aktualisiere(e,t=Date.now()){if(this.vektoren.size>0&&t-this.geladen<this.frischeMs)return;const n=[];let r="0";do{const[c,i]=await e.scan(r,"MATCH",`${a}*`,"COUNT",500);r=c,n.push(...i)}while(r!=="0");if(n.length===0){this.geladen=t;return}const o=await e.mget(...n),h=new Map;for(const[c,i]of n.entries()){const u=o[c];if(!u)continue;const l=k(u);l&&h.set(i.slice(a.length),l)}this.vektoren=h,this.geladen=t}async schreibe(e,t,n,r=.3){try{const o=v(this.vektoren.get(t)??null,n,r);return this.vektoren.set(t,o),await e.set(`${a}${t}`,g(o)),!0}catch{return!1}}}export{a as RESONANZ_PRAEFIX,M as Resonanzbestand,f as normiere,v as ueberlagere};