@cachly-dev/mcp-server 0.10.128 → 0.10.130

package/dist/src/ambient-recall.js

@@ -1,221 +1 @@
-// Ambient Recall (Phase 4) — the relevance gate + net-token accounting that make
-// push-based memory economically honest.
-//
-// Background (docs/make_cachly_great_again.md §6.2/§6.3): pushing recall into
-// every prompt COSTS tokens; it only pays off when the injected lesson prevents
-// a wrong path that would have cost far more. So the whole feature hinges on a
-// sharp relevance gate (only inject high-signal, few, small) plus honest net
-// accounting (injected vs prevented) with auto-backoff when it goes net-negative.
-//
-// This module is pure and dependency-free so it is exhaustively unit-tested; the
-// hook scripts + telemetry layer build on top of it.
-import { createHash } from 'node:crypto';
-// Deliberately conservative defaults: it is far cheaper to skip a marginal
-// lesson than to erode the "−60% tokens" credibility by injecting noise.
-export const DEFAULT_GATE = {
-    minConfidence: 0.6,
-    minScore: 0.72,
-    topK: 3,
-    maxTokens: 240,
-};
-/**
- * Derives a content-based candidate ID from a summary string. Enables
- * ID-based deduplication to suppress "the same advice" while allowing
- * "different advice" through. See PR #241.
- */
-export function candidateIdFor(summary) {
-    const hash = createHash('sha256').update(summary).digest('hex');
-    return hash.slice(0, 16);
-}
-/** Rough token estimate (~4 chars/token) — good enough for a per-turn budget. */
-export function estimateTokens(text) {
-    return Math.ceil(text.trim().length / 4);
-}
-// Pure conversational openers with no engineering payload.
-const TRIVIAL_RE = /^(hi|hello|hey|thanks|thank you|ok|okay|yes|no|yep|nope|ty|lol|danke|hallo|servus)\b/i;
-// Signals that a prompt is about code/ops, where a wrong path is expensive and a
-// relevant lesson can pay for itself. Calibrated against the golden vectors in
-// docs/spec/ambient-gate-vectors.json (ambient-gate-vectors.test.ts): the v1
-// list false-skipped short real requests like "curl returns 403 via the proxy"
-// or "rename the Settings page to Preferences" (substantive-recall 0.67), so
-// v2 adds engineering verbs, infra nouns, HTTP status codes and German
-// question words. Stems with \w* also match inflections ("migration",
-// "updated", "evicted"). Substantive-recall on the vector set: 1.0, with
-// trivial-precision unchanged at 1.0.
-const CODEY_RE = /[/\\._{}()<>;=]|\b\d{3}\b|\b(fix|bug|error|deploy|migrat\w*|test\w*|build|refactor|auth|api|db|schema|race|crash|fail\w*|revert|rollback|why|how|debug|config|hook|token|cache|add|creat\w*|implement\w*|updat\w*|remov\w*|delet\w*|renam\w*|install\w*|upgrad\w*|write|script|component|page|button|css|style\w*|log\w*|pod\w*|node\w*|docker|k8s|kubernetes|proxy|curl|http\w*|readme|lint\w*|latenc\w*|latenz|timeout\w*|evict\w*|warum|wieso|weshalb)\b/i;
-/**
- * A trivial prompt has ~zero expected wrong-path savings (§6.3 guardrail 2):
- * too short to carry risk, a pure greeting, or chit-chat with no code signal.
- * Injecting there is pure waste, so we skip recall entirely.
- */
-export function isTrivialPrompt(prompt) {
-    const p = prompt.trim();
-    if (p.length < 12)
-        return true;
-    if (TRIVIAL_RE.test(p) && p.length < 40)
-        return true;
-    if (!CODEY_RE.test(p) && p.length < 60)
-        return true;
-    return false;
-}
-/**
- * The §6.3 relevance gate: decide what (if anything) to push into context for a
- * given prompt. Applies trivial-skip, a confidence AND semantic-score floor,
- * a top-K cap, and a hard per-turn token budget — strongest candidates first.
- */
-export function selectInjectable(prompt, candidates, opts = {}) {
-    const o = { ...DEFAULT_GATE, ...opts };
-    if (isTrivialPrompt(prompt)) {
-        return { inject: false, reason: 'trivial-skip', selected: [], tokens: 0 };
-    }
-    const passed = candidates
-        .filter((c) => c.confidence >= o.minConfidence && c.score >= o.minScore)
-        .sort((a, b) => b.score - a.score || b.confidence - a.confidence);
-    const selected = [];
-    let tokens = 0;
-    for (const c of passed) {
-        if (selected.length >= o.topK)
-            break;
-        const t = estimateTokens(c.summary);
-        if (tokens + t > o.maxTokens)
-            break; // hard per-turn cap — never overshoot
-        selected.push(c);
-        tokens += t;
-    }
-    if (selected.length === 0) {
-        return { inject: false, reason: 'no-candidate-passed-gate', selected: [], tokens: 0 };
-    }
-    return { inject: true, reason: 'injected', selected, tokens };
-}
-export function netBalance(records) {
-    const injected = records.reduce((s, r) => s + r.injected, 0);
-    const prevented = records.reduce((s, r) => s + r.prevented, 0);
-    return { injected, prevented, net: prevented - injected };
-}
-/**
- * Auto-backoff (§6.3 guardrail 3): if, over the recent window, Ambient Recall is
- * net-negative, tell the caller to tighten the gate (or pause). Only fires once
- * there is enough signal (>= minTurns) so early noise doesn't trip it.
- */
-export function shouldBackoff(records, windowN = 20, minTurns = 8) {
-    const recent = records.slice(-windowN);
-    if (recent.length < minTurns)
-        return false;
-    return netBalance(recent).net < 0;
-}
-// Schritte, die man nicht zurücknehmen kann: hier ist eine verpasste Lektion
-// teuer, ein überflüssiger Hinweis dagegen billig.
-const RISKY_RE = /\b(deploy\w*|migrat\w*|rollback|revert|drop\s+(table|database|schema)|truncate|rm\s+-rf|force[- ]push|prune|restore|rotat\w*|secret\w*|credential\w*|production|prod|live|kunde\w*|customer\w*|delete|loesch\w*|lösch\w*)\b/i;
-// Reine Bestätigungen/Fortsetzungen: hier beginnt keine neue Arbeit.
-const CONTINUATION_RE = /^(ok(ay)?|ja|nein|weiter|passt|danke|thanks|go|los|mach|jup|yes|no|sure|next)\b[\s.!]*$/i;
-/**
- * Risikoeinschätzung des Auslösemoments. Sie verschiebt die Schwellen, statt
- * eine zweite, konkurrierende Entscheidung zu treffen — eine Stellschraube
- * weniger, und der Gate bleibt die einzige Wahrheit über Relevanz.
- */
-export function promptRisk(prompt) {
-    const p = prompt.trim();
-    if (CONTINUATION_RE.test(p))
-        return 'low';
-    if (RISKY_RE.test(p))
-        return 'high';
-    return 'normal';
-}
-/** Schwellen-Anpassung je Risiko (klein gehalten und bewusst begründet). */
-export function gateForRisk(risk, base = DEFAULT_GATE) {
-    if (risk === 'high') {
-        // Vor irreversiblen Schritten darf eine etwas schwächere Übereinstimmung
-        // reichen — die vermiedene Katastrophe ist jeden Token wert.
-        return { ...base, minScore: Math.max(0, base.minScore - 0.07), topK: base.topK, maxTokens: base.maxTokens + 120 };
-    }
-    if (risk === 'low') {
-        // Im Geplauder muss es sehr deutlich sein, sonst lieber schweigen.
-        return { ...base, minScore: Math.min(1, base.minScore + 0.1), topK: 1, maxTokens: Math.min(base.maxTokens, 120) };
-    }
-    return { ...base };
-}
-// Ein Einwurf pro ~3 Turns im Schnitt: oft genug, um zu helfen, selten genug,
-// dass er auffällt, wenn er kommt.
-export const DEFAULT_TIMING = {
-    repeatCooldownTurns: 12,
-    maxInjectionsPerWindow: 3,
-    windowTurns: 10,
-    minSilenceTurns: 1,
-};
-export function emptyMemory() {
-    return { turn: 0, lastInjectedTurn: {}, injectionTurns: [] };
-}
-/**
- * Die vollständige Entscheidung: Relevanz (Gate) UND Zeitpunkt (Timing).
- *
- * Reihenfolge ist Absicht: erst die billigen Ausschlüsse (Ruhe, Budget), dann
- * Dedupe, erst zuletzt der teure Relevanz-Gate — so kostet ein unterdrückter
- * Turn praktisch nichts.
- *
- * Die Funktion ist seiteneffektfrei; `commitInjection` schreibt das Gedächtnis
- * fort, damit Aufrufer selbst entscheiden, ob ein Vorschlag wirklich gezeigt
- * wurde (z. B. bei abgebrochenem Turn).
- */
-export function decideRecall(prompt, candidates, memory, gateOverrides = {}, timingOverrides = {}) {
-    const t = { ...DEFAULT_TIMING, ...timingOverrides };
-    const risk = promptRisk(prompt);
-    const none = (reason, timingReason) => ({
-        inject: false, reason, selected: [], tokens: 0, risk,
-        suppressedDuplicates: [], timingReason,
-    });
-    if (isTrivialPrompt(prompt))
-        return none('trivial-skip');
-    // Mindestruhe nach dem letzten Einwurf.
-    const last = memory.injectionTurns[memory.injectionTurns.length - 1];
-    if (last !== undefined && memory.turn - last <= t.minSilenceTurns) {
-        return none('no-candidate-passed-gate', 'silence-window');
-    }
-    // Ruhe-Budget im gleitenden Fenster.
-    const inWindow = memory.injectionTurns.filter((n) => memory.turn - n < t.windowTurns).length;
-    if (inWindow >= t.maxInjectionsPerWindow) {
-        return none('no-candidate-passed-gate', 'quiet-budget');
-    }
-    // Dedupe: was gerade erst gesagt wurde, wird nicht wiederholt.
-    const suppressedDuplicates = [];
-    const fresh = candidates.filter((c) => {
-        const seen = memory.lastInjectedTurn[c.id];
-        if (seen !== undefined && memory.turn - seen < t.repeatCooldownTurns) {
-            suppressedDuplicates.push(c.id);
-            return false;
-        }
-        return true;
-    });
-    if (candidates.length > 0 && fresh.length === 0) {
-        return { ...none('no-candidate-passed-gate', 'all-duplicates'), suppressedDuplicates };
-    }
-    const gate = selectInjectable(prompt, fresh, { ...gateForRisk(risk), ...gateOverrides });
-    return { ...gate, risk, suppressedDuplicates };
-}
-/**
- * Schreibt das Gedächtnis nach einem TATSÄCHLICH gezeigten Einwurf fort.
- * Der Turn-Zähler wird immer erhöht — auch ohne Einwurf, sonst laufen
- * Abklingzeit und Fenster nicht weiter.
- */
-export function commitInjection(memory, decision, timingOverrides = {}) {
-    const t = { ...DEFAULT_TIMING, ...timingOverrides };
-    const next = {
-        turn: memory.turn + 1,
-        lastInjectedTurn: { ...memory.lastInjectedTurn },
-        injectionTurns: [...memory.injectionTurns],
-    };
-    if (decision.inject) {
-        for (const c of decision.selected)
-            next.lastInjectedTurn[c.id] = memory.turn;
-        next.injectionTurns.push(memory.turn);
-    }
-    // Nach Ablauf der Fenster sind Eintraege bedeutungslos — sonst waechst das
-    // Gedaechtnis in langen Sitzungen unbegrenzt mit.
-    const horizon = memory.turn - Math.max(t.windowTurns, t.repeatCooldownTurns);
-    next.injectionTurns = next.injectionTurns.filter((n) => n >= horizon);
-    for (const [id, turn] of Object.entries(next.lastInjectedTurn)) {
-        if (turn < horizon)
-            delete next.lastInjectedTurn[id];
-    }
-    return next;
-}
-//# sourceMappingURL=ambient-recall.js.map
+import{createHash as T}from"node:crypto";const f={minConfidence:.6,minScore:.72,topK:3,maxTokens:240};function M(n){return T("sha256").update(n).digest("hex").slice(0,16)}function k(n){return Math.ceil(n.trim().length/4)}const g=/^(hi|hello|hey|thanks|thank you|ok|okay|yes|no|yep|nope|ty|lol|danke|hallo|servus)\b/i,j=/[/\\._{}()<>;=]|\b\d{3}\b|\b(fix|bug|error|deploy|migrat\w*|test\w*|build|refactor|auth|api|db|schema|race|crash|fail\w*|revert|rollback|why|how|debug|config|hook|token|cache|add|creat\w*|implement\w*|updat\w*|remov\w*|delet\w*|renam\w*|install\w*|upgrad\w*|write|script|component|page|button|css|style\w*|log\w*|pod\w*|node\w*|docker|k8s|kubernetes|proxy|curl|http\w*|readme|lint\w*|latenc\w*|latenz|timeout\w*|evict\w*|warum|wieso|weshalb)\b/i;function h(n){const e=n.trim();return!!(e.length<12||g.test(e)&&e.length<40||!j.test(e)&&e.length<60)}function m(n,e,t={}){const r={...f,...t};if(h(n))return{inject:!1,reason:"trivial-skip",selected:[],tokens:0};const o=e.filter(i=>i.confidence>=r.minConfidence&&i.score>=r.minScore).sort((i,u)=>u.score-i.score||u.confidence-i.confidence),c=[];let s=0;for(const i of o){if(c.length>=r.topK)break;const u=k(i.summary);if(s+u>r.maxTokens)break;c.push(i),s+=u}return c.length===0?{inject:!1,reason:"no-candidate-passed-gate",selected:[],tokens:0}:{inject:!0,reason:"injected",selected:c,tokens:s}}function x(n){const e=n.reduce((r,o)=>r+o.injected,0),t=n.reduce((r,o)=>r+o.prevented,0);return{injected:e,prevented:t,net:t-e}}function _(n,e=20,t=8){const r=n.slice(-e);return r.length<t?!1:x(r).net<0}const I=/\b(deploy\w*|migrat\w*|rollback|revert|drop\s+(table|database|schema)|truncate|rm\s+-rf|force[- ]push|prune|restore|rotat\w*|secret\w*|credential\w*|production|prod|live|kunde\w*|customer\w*|delete|loesch\w*|lösch\w*)\b/i,b=/^(ok(ay)?|ja|nein|weiter|passt|danke|thanks|go|los|mach|jup|yes|no|sure|next)\b[\s.!]*$/i;function v(n){const e=n.trim();return b.test(e)?"low":I.test(e)?"high":"normal"}function R(n,e=f){return n==="high"?{...e,minScore:Math.max(0,e.minScore-.07),topK:e.topK,maxTokens:e.maxTokens+120}:n==="low"?{...e,minScore:Math.min(1,e.minScore+.1),topK:1,maxTokens:Math.min(e.maxTokens,120)}:{...e}}const w={repeatCooldownTurns:12,maxInjectionsPerWindow:3,windowTurns:10,minSilenceTurns:1};function K(){return{turn:0,lastInjectedTurn:{},injectionTurns:[]}}function y(n,e,t,r={},o={}){const c={...w,...o},s=v(n),i=(a,l)=>({inject:!1,reason:a,selected:[],tokens:0,risk:s,suppressedDuplicates:[],timingReason:l});if(h(n))return i("trivial-skip");const u=t.injectionTurns[t.injectionTurns.length-1];if(u!==void 0&&t.turn-u<=c.minSilenceTurns)return i("no-candidate-passed-gate","silence-window");if(t.injectionTurns.filter(a=>t.turn-a<c.windowTurns).length>=c.maxInjectionsPerWindow)return i("no-candidate-passed-gate","quiet-budget");const d=[],p=e.filter(a=>{const l=t.lastInjectedTurn[a.id];return l!==void 0&&t.turn-l<c.repeatCooldownTurns?(d.push(a.id),!1):!0});return e.length>0&&p.length===0?{...i("no-candidate-passed-gate","all-duplicates"),suppressedDuplicates:d}:{...m(n,p,{...R(s),...r}),risk:s,suppressedDuplicates:d}}function A(n,e,t={}){const r={...w,...t},o={turn:n.turn+1,lastInjectedTurn:{...n.lastInjectedTurn},injectionTurns:[...n.injectionTurns]};if(e.inject){for(const s of e.selected)o.lastInjectedTurn[s.id]=n.turn;o.injectionTurns.push(n.turn)}const c=n.turn-Math.max(r.windowTurns,r.repeatCooldownTurns);o.injectionTurns=o.injectionTurns.filter(s=>s>=c);for(const[s,i]of Object.entries(o.lastInjectedTurn))i<c&&delete o.lastInjectedTurn[s];return o}export{f as DEFAULT_GATE,w as DEFAULT_TIMING,M as candidateIdFor,A as commitInjection,y as decideRecall,K as emptyMemory,k as estimateTokens,R as gateForRisk,h as isTrivialPrompt,x as netBalance,v as promptRisk,m as selectInjectable,_ as shouldBackoff};

package/dist/src/aussetzer.js

@@ -1,82 +1 @@
-/**
- * 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
+const u=new Set;function i(e){if(e instanceof Error)return(e.message||e.name||"Error").slice(0,200);if(typeof e=="string")return e.slice(0,200)||"leerer Text geworfen";if(e===void 0)return"undefined geworfen (kein Grund mitgegeben)";if(e===null)return"null geworfen (kein Grund mitgegeben)";try{const n=JSON.stringify(e);return n&&n!=="{}"?n.slice(0,200):`${typeof e} ohne Inhalt geworfen`}catch{return`${typeof e} geworfen, nicht darstellbar`}}function c(e,n){return u.has(e)?!1:(u.add(e),console.error(`[aussetzer] ${e}: ${n}`),!0)}function l(e){return u.has(e)}function f(){return[...u]}function h(){u.clear()}const g="bedeutung-ohne-vektoren",E="bedeutung-ohne-dienst",m="bedeutung-ohne-fragevektor",p="bedeutung-abbruch",x="einbettung-beim-schreiben",d="versuch-laeuft-leer",s="cachly:aussetzer:",a=720*60*60;async function z(e,n,o){const r=c(n,o);if(!e)return r;try{const t=`${s}${n}`;await e.hincrby(t,"anzahl",1),await e.hset(t,{zuletzt:new Date().toISOString(),text:o.slice(0,500)}),await e.expire(t,a)}catch(t){c(`${n}-vermerk`,`der Aussetzer liess sich nicht vermerken (${t instanceof Error?t.message:String(t)}) \u2014 er steht nur in diesem Protokoll und ist nach einem Neustart weg`)}return r}async function k(e){if(!e)return null;try{const n=await e.keys(`${s}*`),o=[];for(const r of n){const t=await e.hgetall(r);!t||!t.anzahl||o.push({grund:r.slice(s.length),anzahl:Number(t.anzahl)||0,zuletzt:t.zuletzt??"",text:t.text??""})}return o.sort((r,t)=>t.anzahl-r.anzahl||r.grund.localeCompare(t.grund)),o}catch{return null}}export{a as AUSSETZER_TTL_SEKUNDEN,s as AUSSETZER_VORSATZ,E as OHNE_DIENST,m as OHNE_FRAGEVEKTOR,x as OHNE_SCHREIBVEKTOR,g as OHNE_VEKTOREN,p as SINNPFAD_ABBRUCH,d as VERSUCH_LEER,i as fehlerText,f as gemeldeteGruende,k as leseVermerke,c as meldeEinmal,z as meldeUndVermerke,l as schonGemeldet,h as setzeAussetzerZurueck};

package/dist/src/auth.js

@@ -1,140 +1,9 @@
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { cachlyUrl } from './cachly-url.js';
-export function jwtExpiryMs(token) {
-    try {
-        const parts = token.split('.');
-        if (parts.length !== 3)
-            return null;
-        const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf-8'));
-        return payload.exp ? payload.exp * 1000 : null;
-    }
-    catch {
-        return null;
-    }
-}
-// ── Self-healing auth ─────────────────────────────────────────────────────────
-// The silent-failure mode we guard against: a token that is missing, expired, or
-// about to expire degrades the brain into "0 recalls" without the user ever being
-// told why. Instead of failing silently (or only at the moment a network call
-// finally 401s), we diagnose the credential up front and either heal it
-// automatically (mint a fresh long-lived key while the current one is still valid)
-// or surface a single, actionable instruction.
-/** Long-lived API keys cannot expire silently; raw access tokens can. */
-export const API_KEY_PREFIX = 'cky_';
-/** A long-lived API key (cky_live_… / cky_…) has no exp and never expires silently. */
-export function isLongLivedApiKey(token) {
-    return token.startsWith(API_KEY_PREFIX);
-}
-// Refresh a token this close to expiry (or already expired) the moment we touch it.
-export const NEAR_EXPIRY_MS = 10 * 60 * 1000; // 10 minutes
-const SETUP_URL = cachlyUrl('/setup-ai', 'auth-diagnosis');
-/**
- * Diagnose the current credential without making any network call. Pure +
- * deterministic (pass `now` in tests).
- */
-export function diagnoseAuth(jwt, now = Date.now()) {
-    if (!jwt) {
-        return {
-            state: 'no_jwt',
-            usable: false,
-            expiresInMs: null,
-            message: `No CACHLY_JWT set — the brain can't persist or recall anything (you'd silently get 0 recalls).\n\nGet your token at ${SETUP_URL} and add it to your MCP config, or just call any tool to start the one-time device-flow sign-in.`,
-        };
-    }
-    const expMs = jwtExpiryMs(jwt);
-    // No exp claim → long-lived API key. These are the healthy steady state.
-    if (expMs === null) {
-        return {
-            state: isLongLivedApiKey(jwt) ? 'long_lived' : 'healthy',
-            usable: true,
-            expiresInMs: null,
-            message: '',
-        };
-    }
-    const remaining = expMs - now;
-    if (remaining <= 0) {
-        return {
-            state: 'expired',
-            usable: false,
-            expiresInMs: remaining,
-            message: `CACHLY_JWT expired at ${new Date(expMs).toISOString()} — recalls will silently return nothing until you re-authenticate.\n\nGet a fresh token at ${SETUP_URL}, or call any tool to re-run the device-flow sign-in.`,
-        };
-    }
-    if (remaining <= NEAR_EXPIRY_MS) {
-        const mins = Math.max(1, Math.round(remaining / 60_000));
-        return {
-            state: 'near_expiry',
-            usable: true,
-            expiresInMs: remaining,
-            message: `CACHLY_JWT expires in ~${mins} min. cachly will refresh it automatically into a long-lived key while it's still valid.`,
-        };
-    }
-    return { state: 'healthy', usable: true, expiresInMs: remaining, message: '' };
-}
-/**
- * Decide what self-healing step (if any) to take for a diagnosis. Pure so the
- * decision is unit-testable independently of the network-bound executor.
- */
-export function planAuthHeal(d) {
-    switch (d.state) {
-        case 'no_jwt':
-        case 'expired':
-            return 'reauth';
-        case 'near_expiry':
-            return 'refresh';
-        case 'healthy':
-        case 'long_lived':
-            return 'none';
-    }
-}
-export function checkJwt(jwt) {
-    const d = diagnoseAuth(jwt);
-    if (!d.usable) {
-        throw new McpError(ErrorCode.InvalidRequest, d.message);
-    }
-}
-// ── M2M / headless auth (OAuth2 client_credentials) ──────────────────────────
-// For machine-to-machine callers — CI runners, agent orchestrators, AI-to-AI
-// pipelines — there is no human to complete a device flow. When CACHLY_CLIENT_ID
-// and CACHLY_CLIENT_SECRET are present we run the standard OAuth2
-// client_credentials grant against Keycloak and use the resulting access token
-// exactly like a CACHLY_JWT. Fully non-interactive.
-export const DEFAULT_AUTH_BASE = 'https://auth.cachly.dev/realms/cachly/protocol/openid-connect';
-/** Read M2M client credentials from the environment, if both are present. */
-export function readClientCredentialsFromEnv(env = process.env) {
-    const clientId = env.CACHLY_CLIENT_ID;
-    const clientSecret = env.CACHLY_CLIENT_SECRET;
-    if (!clientId || !clientSecret)
-        return null;
-    return {
-        clientId,
-        clientSecret,
-        scope: env.CACHLY_CLIENT_SCOPE || 'openid',
-        authBase: env.CACHLY_AUTH_URL || DEFAULT_AUTH_BASE,
-    };
-}
-/** Build the application/x-www-form-urlencoded body for a client_credentials grant. */
-export function buildClientCredentialsBody(c) {
-    const params = new URLSearchParams({
-        grant_type: 'client_credentials',
-        client_id: c.clientId,
-        client_secret: c.clientSecret,
-    });
-    if (c.scope)
-        params.set('scope', c.scope);
-    return params.toString();
-}
-/** Token endpoint URL for a given credentials/realm config. */
-export function clientCredentialsTokenUrl(c) {
-    return `${c.authBase ?? DEFAULT_AUTH_BASE}/token`;
-}
-export function handleApiError(status, detail) {
-    if (status === 401) {
-        throw new McpError(ErrorCode.InvalidRequest, `Authentication failed (401): ${detail}\n\nYour CACHLY_JWT may be expired or invalid. Get a fresh token at ${SETUP_URL}`);
-    }
-    if (status === 403) {
-        throw new McpError(ErrorCode.InvalidRequest, `Access denied (403): ${detail}\n\nCheck that your CACHLY_JWT belongs to an account with access to this resource.`);
-    }
-    throw new McpError(ErrorCode.InternalError, `cachly API error ${status}: ${detail}`);
-}
-//# sourceMappingURL=auth.js.map
+import{ErrorCode as o,McpError as s}from"@modelcontextprotocol/sdk/types.js";import{cachlyUrl as c}from"./cachly-url.js";function u(e){try{const t=e.split(".");if(t.length!==3)return null;const n=JSON.parse(Buffer.from(t[1],"base64url").toString("utf-8"));return n.exp?n.exp*1e3:null}catch{return null}}const p="cky_";function h(e){return e.startsWith(p)}const d=600*1e3,i=c("/setup-ai","auth-diagnosis");function f(e,t=Date.now()){if(!e)return{state:"no_jwt",usable:!1,expiresInMs:null,message:`No CACHLY_JWT set \u2014 the brain can't persist or recall anything (you'd silently get 0 recalls).
+
+Get your token at ${i} and add it to your MCP config, or just call any tool to start the one-time device-flow sign-in.`};const n=u(e);if(n===null)return{state:h(e)?"long_lived":"healthy",usable:!0,expiresInMs:null,message:""};const r=n-t;if(r<=0)return{state:"expired",usable:!1,expiresInMs:r,message:`CACHLY_JWT expired at ${new Date(n).toISOString()} \u2014 recalls will silently return nothing until you re-authenticate.
+
+Get a fresh token at ${i}, or call any tool to re-run the device-flow sign-in.`};if(r<=d){const l=Math.max(1,Math.round(r/6e4));return{state:"near_expiry",usable:!0,expiresInMs:r,message:`CACHLY_JWT expires in ~${l} min. cachly will refresh it automatically into a long-lived key while it's still valid.`}}return{state:"healthy",usable:!0,expiresInMs:r,message:""}}function y(e){switch(e.state){case"no_jwt":case"expired":return"reauth";case"near_expiry":return"refresh";case"healthy":case"long_lived":return"none"}}function x(e){const t=f(e);if(!t.usable)throw new s(o.InvalidRequest,t.message)}const a="https://auth.cachly.dev/realms/cachly/protocol/openid-connect";function g(e=process.env){const t=e.CACHLY_CLIENT_ID,n=e.CACHLY_CLIENT_SECRET;return!t||!n?null:{clientId:t,clientSecret:n,scope:e.CACHLY_CLIENT_SCOPE||"openid",authBase:e.CACHLY_AUTH_URL||a}}function m(e){const t=new URLSearchParams({grant_type:"client_credentials",client_id:e.clientId,client_secret:e.clientSecret});return e.scope&&t.set("scope",e.scope),t.toString()}function A(e){return`${e.authBase??a}/token`}function w(e,t){throw e===401?new s(o.InvalidRequest,`Authentication failed (401): ${t}
+
+Your CACHLY_JWT may be expired or invalid. Get a fresh token at ${i}`):e===403?new s(o.InvalidRequest,`Access denied (403): ${t}
+
+Check that your CACHLY_JWT belongs to an account with access to this resource.`):new s(o.InternalError,`cachly API error ${e}: ${t}`)}export{p as API_KEY_PREFIX,a as DEFAULT_AUTH_BASE,d as NEAR_EXPIRY_MS,m as buildClientCredentialsBody,x as checkJwt,A as clientCredentialsTokenUrl,f as diagnoseAuth,w as handleApiError,h as isLongLivedApiKey,u as jwtExpiryMs,y as planAuthHeal,g as readClientCredentialsFromEnv};

package/dist/src/autor-abzeichen.js

@@ -1,56 +1 @@
-/**
- * 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
+function o(n,e){const t=(n??"").trim();if(!t)return"";const r=(e??"").trim();return r&&t===r?"":` \xB7 \u{1F464} ${t}`}function u(n,e){const t=(e??"").trim();return t?n.filter(r=>{const i=(r.author??"").trim();return i.length>0&&i!==t}).length:0}export{o as autorAbzeichen,u as fremdanteil};

package/dist/src/autor.js

@@ -1,136 +1 @@
-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
+import{execSync as c}from"node:child_process";const f=e=>n=>{try{return c(`git config ${n}`,{cwd:e,encoding:"utf-8",stdio:"pipe",timeout:1500}).trim()}catch{return""}};function t(e){const n=(e??"").trim();return n?(n.split(/[\s.]+/)[0]??"").toLowerCase().replace(/[^a-z0-9_-]/g,"").slice(0,32):""}const a=new Set(["-","anonym","anonymous","none","kein","off"]);function g(e){const n=(e.uebergeben??"").trim().toLowerCase();if(a.has(n))return{autor:"",quelle:"anonym"};const r=(e.umgebung??"").trim().toLowerCase();if(a.has(r))return{autor:"",quelle:"anonym"};const o=t(e.uebergeben??"");if(o)return{autor:o,quelle:"uebergeben"};const u=t(e.umgebung??"");if(u)return{autor:u,quelle:"umgebung"};const i=t(e.git("user.name"));if(i)return{autor:i,quelle:"git-name"};const l=e.git("user.email"),s=t((l??"").split("@")[0]??"");return s?{autor:s,quelle:"git-mail"}:{autor:"",quelle:"unbekannt"}}const b="coauthor";function h(e){const n=(e??"").trim().toLowerCase();return!n||n==="off"||n==="false"||n==="0"||n==="none"?"":t(n)}function p(e,n){return e?!n||n===e?e:`${e}+${n}`:""}function w(e){return(e??"").split("+")[0]??""}function d(e){return e.autor||e.quelle==="anonym"?null:'\u{1F464} **Kein Autor ermittelt** \u2014 weder `author`, noch `CACHLY_AUTHOR`, noch `git config user.name`. Ohne Autor z\xE4hlt diese Lektion nicht als Team-Wissen: `brain_who_knows` findet niemanden und Wiederverwendung \xFCber Personengrenzen bleibt ungez\xE4hlt. Ein `git config user.name "Vorname"` im Projekt gen\xFCgt f\xFCr alle k\xFCnftigen Lektionen.'}export{b as COAUTHOR_PREF_KEY,d as autorHinweis,h as coautorAus,f as echterGitLeser,g as ermittleAutor,p as mitCoautor,t as normalisiere,w as nurMensch};