@cachly-dev/mcp-server 0.10.129 → 0.10.130

package/dist/src/deutsch.js

@@ -1,223 +1 @@
-/**
- * Deutsch für die Suche: Umlaute, Wortformen, zusammengesetzte Wörter.
- *
- * ── Warum es dieses Modul gibt ───────────────────────────────────────────────
- *
- * Gemessen am 19.08.2026 an 498 echten Lektionen mit 20 Fragen in Alltags-
- * deutsch: 2 Treffer. Sechs Fragen teilten mit der richtigen Antwort NICHT EIN
- * EINZIGES Wort. Die Aufteilung nach Ursachen (src/bench/wortschatz-oder-
- * menge.ts) zeigte: schon bei 20 Lektionen und null Ablenkern scheitern 14 von
- * 20. Es ist also der Wortschatz, nicht die Menge.
- *
- * Die Suche hatte deutsche Stoppwörter und 35 deutsche Wortpaare. Was fehlte,
- * waren drei Dinge — und alle drei sind an echten Fragen belegt:
- *
- *   1. UMLAUTE. Die Wortliste stand mit echten Umlauten (`lösung`,
- *      `überwachung`), Lektionen und Fragen schreiben oft `ae/oe/ue`. Damit
- *      fand `ueberwachung` den Eintrag `überwachung` nie. Zwei Schreibweisen
- *      desselben Wortes, und die Suche hielt sie für verschieden.
- *
- *   2. WORTFORM. `abhaengigkeiten` gegen `abhaengigkeit`, `prozesse` gegen
- *      `prozess`. Für sieben Sprachen gab es einen Stemmer, für Deutsch nicht.
- *
- *   3. ZUSAMMENGESETZTE WÖRTER. Das ist die deutsche Besonderheit und war die
- *      größte Lücke. `Arbeitsspeicher` enthält `speicher`, und `speicher` steht
- *      längst in der Wortliste — nur kam niemand dort an. Genauso
- *      `Zugriffsprotokoll` → `protokoll` → `log`, `Browsertests` → `test`.
- *
- * ── Die Entscheidung, die dieses Modul klein hält ────────────────────────────
- *
- * Für die Zerlegung braucht es ein Wörterbuch der Grundwörter. Es wäre nahe-
- * liegend, dafür eine zweite Liste zu pflegen. Genau das ist die Fehlerklasse,
- * die uns in diesem Haus am häufigsten trifft: eine Wahrheit an zwei Orten.
- *
- * Deshalb: die Wortliste IST das Wörterbuch. Wer ein Wortpaar einträgt, macht
- * es damit automatisch als Grundwort für zusammengesetzte Wörter verfügbar.
- * Eine Liste, zwei Wirkungen.
- */
-/**
- * Schreibt Umlaute aus. Aus `ä` wird `ae`, aus `ß` wird `ss`.
- *
- * Beide Schreibweisen werden auf DIESELBE Form gebracht — nicht die eine in die
- * andere übersetzt. Nur so ist `Lösung` dasselbe Wort wie `Loesung`, egal in
- * welcher Richtung jemand tippt.
- */
-export function ohneUmlaute(wort) {
-    return wort
-        .replace(/ä/g, 'ae').replace(/ö/g, 'oe').replace(/ü/g, 'ue')
-        .replace(/Ä/g, 'ae').replace(/Ö/g, 'oe').replace(/Ü/g, 'ue')
-        .replace(/ß/g, 'ss');
-}
-/**
- * Endungen, die im Deutschen Fall und Zahl anzeigen — von der längsten zur
- * kürzesten, damit `-ungen` vor `-en` greift.
- *
- * Die Liste ist absichtlich kurz. Ein zu gieriger Stemmer verschmilzt Wörter,
- * die nichts miteinander zu tun haben, und das ist schlimmer als eine Endung
- * zu viel: falsche Treffer verdrängen richtige, fehlende Treffer nicht.
- */
-const ENDUNGEN = ['ungen', 'nisse', 'erne', 'ern', 'end', 'est', 'en', 'er', 'es', 'em', 'et', 'e', 'n', 's'];
-/** Ab hier hört das Stammen auf — kürzere Reste sind meist keine Wörter mehr. */
-const MINDESTLAENGE = 4;
-/**
- * Deutsche Wortform auf einen gemeinsamen Stamm bringen.
- *
- * Absichtlich zurückhaltend: eine Endung, nicht mehrere hintereinander. Bei
- * `Abhaengigkeiten` reicht `-en`, und `Abhaengigkeit` ist genau die Form, die
- * in den Lektionen steht.
- */
-export function deutscherStamm(wort) {
-    const w = ohneUmlaute(wort.toLowerCase());
-    if (w.length < MINDESTLAENGE + 1)
-        return w;
-    for (const endung of ENDUNGEN) {
-        if (w.endsWith(endung) && w.length - endung.length >= MINDESTLAENGE) {
-            return w.slice(0, -endung.length);
-        }
-    }
-    return w;
-}
-/**
- * Die Rückumlautung: `eintraeg` → `eintrag`, `laeuft` → `lauft`.
- *
- * Das Deutsche verändert im Plural und in gebeugten Formen den Stammvokal
- * (Eintrag → Einträge). Ohne diesen Schritt bleiben Einzahl und Mehrzahl zwei
- * verschiedene Wörter.
- *
- * Nur die letzte Umlautstelle wird zurückgenommen. `Ueberpruefung` soll nicht
- * zu `Uberprufung` werden — das Wort beginnt mit einem echten `ü`, das kein
- * Umlaut einer Mehrzahl ist.
- */
-export function ohneRueckumlaut(stamm) {
-    const stelle = Math.max(stamm.lastIndexOf('ae'), stamm.lastIndexOf('oe'), stamm.lastIndexOf('ue'));
-    if (stelle <= 0)
-        return null; // <= 0: am Wortanfang steht ein echter Umlaut
-    const paar = stamm.slice(stelle, stelle + 2);
-    const einzeln = paar === 'ae' ? 'a' : paar === 'oe' ? 'o' : 'u';
-    const neu = stamm.slice(0, stelle) + einzeln + stamm.slice(stelle + 2);
-    return neu === stamm ? null : neu;
-}
-/**
- * Zerlegt ein zusammengesetztes Wort in seine Bestandteile.
- *
- * `Arbeitsspeicher` → `speicher` (und `arbeit`)
- * `Zugriffsprotokoll` → `protokoll` (und `zugriff`)
- * `Browsertests` → `test` (und `browser`)
- *
- * Wie es arbeitet: Das Grundwort steht im Deutschen HINTEN. Also wird von
- * hinten nach einem bekannten Wort gesucht. Der Rest davor wird ebenfalls
- * zurückgegeben, wenn er lang genug ist — er trägt oft die eigentliche
- * Bedeutung (`Arbeit` in `Arbeitsspeicher`).
- *
- * Das `s` in `Arbeits|speicher` ist eine Fuge und gehört zu keinem der beiden
- * Teile. Es wird abgeschnitten.
- *
- * @param bekannt Grundwörter, gegen die geprüft wird. Das ist die Wortliste der
- *                Suche selbst — kein zweites Wörterbuch, das veralten kann.
- */
-export function zerlegeKompositum(wort, bekannt) {
-    const w = ohneUmlaute(wort.toLowerCase());
-    // Unter 10 Zeichen lohnt es nicht: `dienst` oder `fehler` sind schon Grund-
-    // wörter, und kurze Wörter zu zerlegen erzeugt vor allem Unsinn.
-    if (w.length < 10)
-        return [];
-    // Von hinten, längstes Grundwort zuerst — `zeitueberschreitung` soll nicht
-    // bei `zeit` stehenbleiben.
-    for (let schnitt = 4; schnitt <= w.length - 4; schnitt++) {
-        const hinten = w.slice(schnitt);
-        if (hinten.length < 4 || !bekannt.has(hinten))
-            continue;
-        const teile = [hinten];
-        let vorne = w.slice(0, schnitt);
-        if (vorne.endsWith('s') || vorne.endsWith('n'))
-            vorne = vorne.slice(0, -1); // Fugenlaut
-        if (vorne.length >= 4)
-            teile.push(vorne);
-        return teile;
-    }
-    return [];
-}
-/**
- * Deutsche Fachwörter, die in unseren Lektionen und Fragen vorkommen.
- *
- * ── Woher diese Liste kommt ──────────────────────────────────────────────────
- *
- * Nicht aus dem Kopf. Jeder Eintrag stammt aus der Messung vom 19.08.2026: es
- * sind die Wörter, die in echten Fragen standen und in der richtigen Antwort
- * keinen Anschluss fanden (src/bench/wo-bricht-die-frage.ts nennt sie).
- *
- * Deshalb ist die Liste kurz und wird es bleiben. Sie wächst aus Messungen,
- * nicht aus Vermutungen — wer etwas einträgt, soll die Frage nennen können, die
- * ohne den Eintrag danebengeht.
- */
-export const DEUTSCHE_FACHWOERTER = [
-    // Speicher und Platte
-    ['cache', ['cache', 'zwischenspeicher']],
-    ['zwischenspeicher', ['cache']],
-    ['arbeitsspeicher', ['memory', 'ram']],
-    ['platte', ['disk', 'storage']],
-    ['festplatte', ['disk', 'storage']],
-    ['plattenplatz', ['disk', 'space']],
-    // Datenbank
-    ['spalte', ['column']],
-    ['tabelle', ['table']],
-    ['zeile', ['row']],
-    ['abfrage', ['query']],
-    ['zeilenschutz', ['rls', 'row-level-security']],
-    ['mandant', ['tenant']],
-    ['mandanten', ['tenant', 'tenants']],
-    ['wanderung', ['migration']],
-    // Laufzeit und Fehler
-    ['prozess', ['process']],
-    ['zeitueberschreitung', ['timeout']],
-    ['ausfall', ['outage', 'down']],
-    ['abgewiesen', ['refused', 'rejected']],
-    ['abgelehnt', ['refused', 'rejected']],
-    ['verweigert', ['denied', 'refused']],
-    ['haengt', ['hang', 'hangs', 'stuck']],
-    ['haengen', ['hang', 'stuck']],
-    ['abhaengigkeit', ['dependency']],
-    ['abhaengigkeiten', ['dependency', 'dependencies']],
-    ['zugriff', ['access']],
-    ['freigeschaltet', ['allowlist', 'permission', 'access']],
-    ['freigabe', ['permission', 'access', 'approval']],
-    // Bauen und Ausliefern
-    ['ausrollen', ['deploy', 'deployment']],
-    ['ausgerollt', ['deploy', 'deployed']],
-    ['abnahme', ['acceptance', 'review']],
-    ['quelldatei', ['source', 'file']],
-    ['datei', ['file']],
-    ['dateien', ['file', 'files']],
-    ['ordner', ['directory', 'folder']],
-    ['pfad', ['path']],
-    ['endung', ['extension', 'suffix']],
-    ['schluessel', ['key', 'token', 'secret']],
-    ['geheimnis', ['secret']],
-    // Prüfen
-    ['test', ['test']],
-    ['tests', ['test', 'tests']],
-    ['browsertest', ['e2e', 'playwright', 'test']],
-    ['browsertests', ['e2e', 'playwright', 'test']],
-    ['pruefung', ['check', 'test', 'validation']],
-    ['gegenprobe', ['counter-check', 'verification']],
-    ['rauchtest', ['smoke', 'smoketest']],
-    // Netz
-    ['tunnel', ['tunnel', 'vpn', 'wireguard']],
-    ['anfrage', ['request']],
-    ['anfragen', ['request', 'requests']],
-    ['antwort', ['response']],
-    ['erreichbar', ['reachable', 'available']],
-    ['abgesichert', ['secured', 'protected']],
-    // Betrieb
-    ['sicherung', ['backup']],
-    ['sicherungen', ['backup', 'backups']],
-    ['naechtlich', ['nightly']],
-    ['naechtliche', ['nightly']],
-    ['aufraeumen', ['cleanup', 'prune']],
-    ['neustart', ['restart', 'reboot']],
-    ['angehalten', ['stopped', 'halted']],
-    ['ueberwachung', ['monitor', 'monitoring']],
-    ['warnung', ['warning', 'alert']],
-    ['alarm', ['alert']],
-];
-//# sourceMappingURL=deutsch.js.map
+function i(t){return t.replace(/ä/g,"ae").replace(/ö/g,"oe").replace(/ü/g,"ue").replace(/Ä/g,"ae").replace(/Ö/g,"oe").replace(/Ü/g,"ue").replace(/ß/g,"ss")}const o=["ungen","nisse","erne","ern","end","est","en","er","es","em","et","e","n","s"],l=4;function u(t){const e=i(t.toLowerCase());if(e.length<l+1)return e;for(const n of o)if(e.endsWith(n)&&e.length-n.length>=l)return e.slice(0,-n.length);return e}function g(t){const e=Math.max(t.lastIndexOf("ae"),t.lastIndexOf("oe"),t.lastIndexOf("ue"));if(e<=0)return null;const n=t.slice(e,e+2),r=n==="ae"?"a":n==="oe"?"o":"u",s=t.slice(0,e)+r+t.slice(e+2);return s===t?null:s}function h(t,e){const n=i(t.toLowerCase());if(n.length<10)return[];for(let r=4;r<=n.length-4;r++){const s=n.slice(r);if(s.length<4||!e.has(s))continue;const c=[s];let a=n.slice(0,r);return(a.endsWith("s")||a.endsWith("n"))&&(a=a.slice(0,-1)),a.length>=4&&c.push(a),c}return[]}const p=[["cache",["cache","zwischenspeicher"]],["zwischenspeicher",["cache"]],["arbeitsspeicher",["memory","ram"]],["platte",["disk","storage"]],["festplatte",["disk","storage"]],["plattenplatz",["disk","space"]],["spalte",["column"]],["tabelle",["table"]],["zeile",["row"]],["abfrage",["query"]],["zeilenschutz",["rls","row-level-security"]],["mandant",["tenant"]],["mandanten",["tenant","tenants"]],["wanderung",["migration"]],["prozess",["process"]],["zeitueberschreitung",["timeout"]],["ausfall",["outage","down"]],["abgewiesen",["refused","rejected"]],["abgelehnt",["refused","rejected"]],["verweigert",["denied","refused"]],["haengt",["hang","hangs","stuck"]],["haengen",["hang","stuck"]],["abhaengigkeit",["dependency"]],["abhaengigkeiten",["dependency","dependencies"]],["zugriff",["access"]],["freigeschaltet",["allowlist","permission","access"]],["freigabe",["permission","access","approval"]],["ausrollen",["deploy","deployment"]],["ausgerollt",["deploy","deployed"]],["abnahme",["acceptance","review"]],["quelldatei",["source","file"]],["datei",["file"]],["dateien",["file","files"]],["ordner",["directory","folder"]],["pfad",["path"]],["endung",["extension","suffix"]],["schluessel",["key","token","secret"]],["geheimnis",["secret"]],["test",["test"]],["tests",["test","tests"]],["browsertest",["e2e","playwright","test"]],["browsertests",["e2e","playwright","test"]],["pruefung",["check","test","validation"]],["gegenprobe",["counter-check","verification"]],["rauchtest",["smoke","smoketest"]],["tunnel",["tunnel","vpn","wireguard"]],["anfrage",["request"]],["anfragen",["request","requests"]],["antwort",["response"]],["erreichbar",["reachable","available"]],["abgesichert",["secured","protected"]],["sicherung",["backup"]],["sicherungen",["backup","backups"]],["naechtlich",["nightly"]],["naechtliche",["nightly"]],["aufraeumen",["cleanup","prune"]],["neustart",["restart","reboot"]],["angehalten",["stopped","halted"]],["ueberwachung",["monitor","monitoring"]],["warnung",["warning","alert"]],["alarm",["alert"]]];export{p as DEUTSCHE_FACHWOERTER,u as deutscherStamm,g as ohneRueckumlaut,i as ohneUmlaute,h as zerlegeKompositum};

package/dist/src/doctor.js

@@ -1,248 +1,2 @@
-// `cachly doctor` — one-command setup diagnosis.
-//
-// The activation funnel dies silently: a missing JWT, an unreachable API, a
-// half-installed hook set or a stale v1 shell hook all look identical from the
-// editor ("the brain just doesn't answer"). doctor makes every link of the
-// chain visible in one run: environment → credential → API → instance → hooks
-// → ledger. Pure check functions with injected effects so the whole module is
-// unit-testable; the CLI shell in index.ts only wires and prints.
-import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { AMBIENT_HOOK_VERSION } from './ambient-hooks.js';
-import { netBalance, shouldBackoff } from './ambient-recall.js';
-import { cachlyUrl } from './cachly-url.js';
-const MIN_NODE_MAJOR = 18;
-/** Node runtime new enough for fetch/AbortSignal (>= 18). */
-export function checkNodeVersion(version = process.version) {
-    const major = Number(version.replace(/^v/, '').split('.')[0]);
-    if (Number.isFinite(major) && major >= MIN_NODE_MAJOR) {
-        return { name: 'Node.js', status: 'ok', detail: `${version}` };
-    }
-    return {
-        name: 'Node.js',
-        status: 'fail',
-        detail: `${version} — too old`,
-        hint: `cachly needs Node ${MIN_NODE_MAJOR}+ (built-in fetch). Install a current LTS from nodejs.org.`,
-    };
-}
-/** Credential present and roughly the right shape (cky_… API key or JWT). */
-export function checkCredential(jwt) {
-    if (!jwt) {
-        return {
-            name: 'Credential',
-            status: 'fail',
-            detail: 'CACHLY_JWT is not set',
-            hint: 'Run `npx @cachly-dev/mcp-server@latest autopilot` (browser sign-in) or export CACHLY_JWT=<cky_…>.',
-        };
-    }
-    const looksApiKey = jwt.startsWith('cky_');
-    const looksJwt = jwt.split('.').length === 3;
-    if (!looksApiKey && !looksJwt) {
-        return {
-            name: 'Credential',
-            status: 'warn',
-            detail: 'CACHLY_JWT is set but looks neither like a cky_… key nor a JWT',
-            hint: 'Re-copy the key from the dashboard (API Keys) — it may be truncated.',
-        };
-    }
-    return { name: 'Credential', status: 'ok', detail: looksApiKey ? 'API key (cky_…)' : 'JWT' };
-}
-/** API reachable at all (public /health — no auth involved). */
-export async function checkApiReachable(apiUrl, fetchFn = fetch) {
-    try {
-        const res = await fetchFn(`${apiUrl}/health`, { signal: AbortSignal.timeout(5000) });
-        if (res.ok)
-            return { name: 'API', status: 'ok', detail: `${apiUrl} reachable` };
-        return {
-            name: 'API',
-            status: 'fail',
-            detail: `${apiUrl}/health returned HTTP ${res.status}`,
-            hint: `The API answered but is unhealthy — check ${cachlyUrl('/status', 'doctor')} or your CACHLY_API_URL.`,
-        };
-    }
-    catch {
-        return {
-            name: 'API',
-            status: 'fail',
-            detail: `${apiUrl} not reachable`,
-            hint: 'Check your network/proxy. Self-hosted: is CACHLY_API_URL correct and the API running?',
-        };
-    }
-}
-/** Credential actually accepted by the API (authenticated list call). */
-export async function checkAuthAccepted(apiUrl, jwt, fetchFn = fetch) {
-    if (!jwt) {
-        return { name: 'Auth', status: 'fail', detail: 'skipped — no credential', hint: 'Fix the Credential check first.' };
-    }
-    try {
-        const res = await fetchFn(`${apiUrl}/api/v1/instances`, {
-            headers: { Authorization: `Bearer ${jwt}` },
-            signal: AbortSignal.timeout(5000),
-        });
-        if (res.ok)
-            return { name: 'Auth', status: 'ok', detail: 'credential accepted' };
-        if (res.status === 401 || res.status === 403) {
-            return {
-                name: 'Auth',
-                status: 'fail',
-                detail: `API rejected the credential (HTTP ${res.status})`,
-                hint: 'The key is expired or revoked. Create a new one in the dashboard, or re-run autopilot.',
-            };
-        }
-        return { name: 'Auth', status: 'warn', detail: `unexpected HTTP ${res.status} from /api/v1/instances` };
-    }
-    catch {
-        return { name: 'Auth', status: 'warn', detail: 'could not verify (network error)' };
-    }
-}
-/** Brain instance configured (env or auto-provisioned default). */
-export function checkInstance(instanceId) {
-    if (!instanceId) {
-        return {
-            name: 'Instance',
-            status: 'warn',
-            detail: 'no CACHLY_BRAIN_INSTANCE_ID set and no default instance resolved',
-            hint: 'Run `npx @cachly-dev/mcp-server@latest init` in your project, or export CACHLY_BRAIN_INSTANCE_ID.',
-        };
-    }
-    const uuidish = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(instanceId);
-    return uuidish
-        ? { name: 'Instance', status: 'ok', detail: instanceId.slice(0, 8) + '…' }
-        : {
-            name: 'Instance',
-            status: 'warn',
-            detail: `"${instanceId.slice(0, 24)}" does not look like an instance UUID`,
-            hint: 'Copy the instance ID from the dashboard (Instances → your brain).',
-        };
-}
-/** Read-only look at .claude/ in projectDir — never throws. */
-export function inspectAmbientHooks(projectDir) {
-    const out = { settingsExists: false, wiredEvents: [], scriptFiles: [] };
-    try {
-        const settingsPath = resolve(projectDir, '.claude/settings.json');
-        out.settingsExists = existsSync(settingsPath);
-        if (out.settingsExists) {
-            const parsed = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-            for (const [event, groups] of Object.entries(parsed.hooks ?? {})) {
-                // Normalise Windows backslash paths so the marker match and the path
-                // extraction below work on every platform (node fs accepts / on Windows).
-                const norm = (c) => (c ?? '').replace(/\\/g, '/');
-                const ours = (groups ?? []).some((g) => (g.hooks ?? []).some((h) => norm(h.command).includes('.claude/hooks/cachly-ambient-')));
-                if (ours) {
-                    out.wiredEvents.push(event);
-                    for (const g of groups ?? []) {
-                        for (const h of g.hooks ?? []) {
-                            const cmd = norm(h.command);
-                            const m = cmd.match(/["']?([^"']*\.claude\/hooks\/cachly-ambient-[^"']+)["']?/);
-                            if (!m)
-                                continue;
-                            const scriptPath = m[1].replace('$CLAUDE_PROJECT_DIR', projectDir);
-                            const exists = existsSync(scriptPath);
-                            let version = 'unknown';
-                            if (exists) {
-                                try {
-                                    const body = readFileSync(scriptPath, 'utf-8');
-                                    version = body.includes(AMBIENT_HOOK_VERSION) ? 'current' : 'stale';
-                                }
-                                catch { /* keep unknown */ }
-                            }
-                            out.scriptFiles.push({ path: scriptPath, exists, version });
-                        }
-                    }
-                }
-            }
-        }
-    }
-    catch { /* corrupt settings → report as not wired */ }
-    return out;
-}
-const AMBIENT_EVENTS = ['SessionStart', 'UserPromptSubmit', 'PreToolUse', 'Stop'];
-/** Ambient hooks wired, scripts present, version current. */
-export function checkHooks(inspection) {
-    if (!inspection.settingsExists || inspection.wiredEvents.length === 0) {
-        return {
-            name: 'Hooks',
-            status: 'warn',
-            detail: 'Ambient Recall hooks are not installed in this project',
-            hint: 'Run `npx @cachly-dev/mcp-server@latest init` here — memory then injects itself (no hooks = pull-only).',
-        };
-    }
-    const missingEvents = AMBIENT_EVENTS.filter((e) => !inspection.wiredEvents.includes(e));
-    const missingFiles = inspection.scriptFiles.filter((f) => !f.exists);
-    const stale = inspection.scriptFiles.filter((f) => f.exists && f.version === 'stale');
-    if (missingFiles.length > 0) {
-        return {
-            name: 'Hooks',
-            status: 'fail',
-            detail: `settings.json wires hooks whose script files are missing (${missingFiles.length})`,
-            hint: 'Re-run `npx @cachly-dev/mcp-server@latest init` to rewrite the scripts.',
-        };
-    }
-    if (stale.length > 0) {
-        return {
-            name: 'Hooks',
-            status: 'warn',
-            detail: `installed hooks are an older version (current: ${AMBIENT_HOOK_VERSION}); v1/v2 shell hooks never ran on native Windows`,
-            hint: 'Re-run `npx @cachly-dev/mcp-server@latest init` to upgrade in place.',
-        };
-    }
-    if (missingEvents.length > 0) {
-        return {
-            name: 'Hooks',
-            status: 'warn',
-            detail: `partial install — missing events: ${missingEvents.join(', ')}`,
-            hint: 'Re-run `npx @cachly-dev/mcp-server@latest init` to add the missing hooks.',
-        };
-    }
-    return { name: 'Hooks', status: 'ok', detail: `all 4 events wired, scripts ${AMBIENT_HOOK_VERSION}` };
-}
-/** Net-token ledger readable + backoff state. */
-export function checkLedger(entries, ledgerPath) {
-    const bal = netBalance(entries);
-    const backing = shouldBackoff(entries);
-    if (entries.length === 0) {
-        return {
-            name: 'Ledger',
-            status: 'ok',
-            detail: `empty (${ledgerPath}) — fills up once ambient hooks inject`,
-        };
-    }
-    if (backing) {
-        return {
-            name: 'Ledger',
-            status: 'warn',
-            detail: `${entries.length} entries, net ${bal.net} tokens — auto-backoff ACTIVE, injection paused`,
-            hint: 'The agent has not reported prevented tokens lately. This self-heals; `ambient-stats` shows details.',
-        };
-    }
-    return {
-        name: 'Ledger',
-        status: 'ok',
-        detail: `${entries.length} entries, net ${bal.net >= 0 ? '+' : ''}${bal.net} tokens`,
-    };
-}
-const ICON = { ok: '✅', warn: '⚠️ ', fail: '❌' };
-/** Render the report; deterministic, no colors (CI-friendly). */
-export function renderDoctorReport(checks) {
-    const lines = ['', '🩺 cachly doctor', ''];
-    for (const c of checks) {
-        lines.push(`   ${ICON[c.status]} ${c.name.padEnd(11)} ${c.detail}`);
-        if (c.hint && c.status !== 'ok')
-            lines.push(`      ↳ ${c.hint}`);
-    }
-    const fails = checks.filter((c) => c.status === 'fail').length;
-    const warns = checks.filter((c) => c.status === 'warn').length;
-    lines.push('');
-    lines.push(fails > 0
-        ? `   ${fails} problem${fails > 1 ? 's' : ''} to fix${warns ? `, ${warns} warning${warns > 1 ? 's' : ''}` : ''}.`
-        : warns > 0
-            ? `   No blockers — ${warns} warning${warns > 1 ? 's' : ''}.`
-            : '   Everything looks healthy. Your brain is wired.');
-    lines.push('');
-    return lines.join('\n');
-}
-/** Exit code contract: 1 only on hard failures (warnings stay 0 for CI use). */
-export function doctorExitCode(checks) {
-    return checks.some((c) => c.status === 'fail') ? 1 : 0;
-}
-//# sourceMappingURL=doctor.js.map
+import{existsSync as m,readFileSync as p}from"node:fs";import{resolve as y}from"node:path";import{AMBIENT_HOOK_VERSION as c}from"./ambient-hooks.js";import{netBalance as g,shouldBackoff as A}from"./ambient-recall.js";import{cachlyUrl as $}from"./cachly-url.js";const k=18;function H(t=process.version){const e=Number(t.replace(/^v/,"").split(".")[0]);return Number.isFinite(e)&&e>=k?{name:"Node.js",status:"ok",detail:`${t}`}:{name:"Node.js",status:"fail",detail:`${t} \u2014 too old`,hint:`cachly needs Node ${k}+ (built-in fetch). Install a current LTS from nodejs.org.`}}function P(t){if(!t)return{name:"Credential",status:"fail",detail:"CACHLY_JWT is not set",hint:"Run `npx @cachly-dev/mcp-server@latest autopilot` (browser sign-in) or export CACHLY_JWT=<cky_\u2026>."};const e=t.startsWith("cky_"),s=t.split(".").length===3;return!e&&!s?{name:"Credential",status:"warn",detail:"CACHLY_JWT is set but looks neither like a cky_\u2026 key nor a JWT",hint:"Re-copy the key from the dashboard (API Keys) \u2014 it may be truncated."}:{name:"Credential",status:"ok",detail:e?"API key (cky_\u2026)":"JWT"}}async function R(t,e=fetch){try{const s=await e(`${t}/health`,{signal:AbortSignal.timeout(5e3)});return s.ok?{name:"API",status:"ok",detail:`${t} reachable`}:{name:"API",status:"fail",detail:`${t}/health returned HTTP ${s.status}`,hint:`The API answered but is unhealthy \u2014 check ${$("/status","doctor")} or your CACHLY_API_URL.`}}catch{return{name:"API",status:"fail",detail:`${t} not reachable`,hint:"Check your network/proxy. Self-hosted: is CACHLY_API_URL correct and the API running?"}}}async function L(t,e,s=fetch){if(!e)return{name:"Auth",status:"fail",detail:"skipped \u2014 no credential",hint:"Fix the Credential check first."};try{const a=await s(`${t}/api/v1/instances`,{headers:{Authorization:`Bearer ${e}`},signal:AbortSignal.timeout(5e3)});return a.ok?{name:"Auth",status:"ok",detail:"credential accepted"}:a.status===401||a.status===403?{name:"Auth",status:"fail",detail:`API rejected the credential (HTTP ${a.status})`,hint:"The key is expired or revoked. Create a new one in the dashboard, or re-run autopilot."}:{name:"Auth",status:"warn",detail:`unexpected HTTP ${a.status} from /api/v1/instances`}}catch{return{name:"Auth",status:"warn",detail:"could not verify (network error)"}}}function S(t){return t?/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(t)?{name:"Instance",status:"ok",detail:t.slice(0,8)+"\u2026"}:{name:"Instance",status:"warn",detail:`"${t.slice(0,24)}" does not look like an instance UUID`,hint:"Copy the instance ID from the dashboard (Instances \u2192 your brain)."}:{name:"Instance",status:"warn",detail:"no CACHLY_BRAIN_INSTANCE_ID set and no default instance resolved",hint:"Run `npx @cachly-dev/mcp-server@latest init` in your project, or export CACHLY_BRAIN_INSTANCE_ID."}}function j(t){const e={settingsExists:!1,wiredEvents:[],scriptFiles:[]};try{const s=y(t,".claude/settings.json");if(e.settingsExists=m(s),e.settingsExists){const a=JSON.parse(p(s,"utf-8"));for(const[n,l]of Object.entries(a.hooks??{})){const u=o=>(o??"").replace(/\\/g,"/");if((l??[]).some(o=>(o.hooks??[]).some(r=>u(r.command).includes(".claude/hooks/cachly-ambient-")))){e.wiredEvents.push(n);for(const o of l??[])for(const r of o.hooks??[]){const h=u(r.command).match(/["']?([^"']*\.claude\/hooks\/cachly-ambient-[^"']+)["']?/);if(!h)continue;const i=h[1].replace("$CLAUDE_PROJECT_DIR",t),d=m(i);let f="unknown";if(d)try{f=p(i,"utf-8").includes(c)?"current":"stale"}catch{}e.scriptFiles.push({path:i,exists:d,version:f})}}}}}catch{}return e}const v=["SessionStart","UserPromptSubmit","PreToolUse","Stop"];function J(t){if(!t.settingsExists||t.wiredEvents.length===0)return{name:"Hooks",status:"warn",detail:"Ambient Recall hooks are not installed in this project",hint:"Run `npx @cachly-dev/mcp-server@latest init` here \u2014 memory then injects itself (no hooks = pull-only)."};const e=v.filter(n=>!t.wiredEvents.includes(n)),s=t.scriptFiles.filter(n=>!n.exists),a=t.scriptFiles.filter(n=>n.exists&&n.version==="stale");return s.length>0?{name:"Hooks",status:"fail",detail:`settings.json wires hooks whose script files are missing (${s.length})`,hint:"Re-run `npx @cachly-dev/mcp-server@latest init` to rewrite the scripts."}:a.length>0?{name:"Hooks",status:"warn",detail:`installed hooks are an older version (current: ${c}); v1/v2 shell hooks never ran on native Windows`,hint:"Re-run `npx @cachly-dev/mcp-server@latest init` to upgrade in place."}:e.length>0?{name:"Hooks",status:"warn",detail:`partial install \u2014 missing events: ${e.join(", ")}`,hint:"Re-run `npx @cachly-dev/mcp-server@latest init` to add the missing hooks."}:{name:"Hooks",status:"ok",detail:`all 4 events wired, scripts ${c}`}}function O(t,e){const s=g(t),a=A(t);return t.length===0?{name:"Ledger",status:"ok",detail:`empty (${e}) \u2014 fills up once ambient hooks inject`}:a?{name:"Ledger",status:"warn",detail:`${t.length} entries, net ${s.net} tokens \u2014 auto-backoff ACTIVE, injection paused`,hint:"The agent has not reported prevented tokens lately. This self-heals; `ambient-stats` shows details."}:{name:"Ledger",status:"ok",detail:`${t.length} entries, net ${s.net>=0?"+":""}${s.net} tokens`}}const b={ok:"\u2705",warn:"\u26A0\uFE0F ",fail:"\u274C"};function F(t){const e=["","\u{1FA7A} cachly doctor",""];for(const n of t)e.push(`   ${b[n.status]} ${n.name.padEnd(11)} ${n.detail}`),n.hint&&n.status!=="ok"&&e.push(`      \u21B3 ${n.hint}`);const s=t.filter(n=>n.status==="fail").length,a=t.filter(n=>n.status==="warn").length;return e.push(""),e.push(s>0?`   ${s} problem${s>1?"s":""} to fix${a?`, ${a} warning${a>1?"s":""}`:""}.`:a>0?`   No blockers \u2014 ${a} warning${a>1?"s":""}.`:"   Everything looks healthy. Your brain is wired."),e.push(""),e.join(`
+`)}function Y(t){return t.some(e=>e.status==="fail")?1:0}export{R as checkApiReachable,L as checkAuthAccepted,P as checkCredential,J as checkHooks,S as checkInstance,O as checkLedger,H as checkNodeVersion,Y as doctorExitCode,j as inspectAmbientHooks,F as renderDoctorReport};

package/dist/src/editor.js

@@ -1,63 +1 @@
-// Editor / host detection for telemetry attribution.
-//
-// The evening funnel report showed `unknown: 345` vs `claude: 96` / `vscode: 25`
-// — the largest bucket was unattributed. The old detector only checked four
-// env vars (CURSOR_TRACE_ID, WINDSURF_SESSION_ID, GITHUB_COPILOT_WORKSPACE,
-// CLAUDE_CODE_ENTRYPOINT), so every other host — VS Code running the server as
-// a native MCP stdio child, JetBrains, Zed, plain terminals — fell through to
-// "unknown". This widens detection to the stable signals each host actually
-// sets, ordered most-specific first, and stays a pure function of the env so it
-// is exhaustively unit-testable.
-/**
- * Best-effort host detection. Order matters: forks of VS Code (Cursor,
- * Windsurf) also set TERM_PROGRAM=vscode, so their fork-specific signals are
- * checked BEFORE the generic vscode fallback.
- */
-export function detectEditor(env = process.env) {
-    const has = (k) => typeof env[k] === 'string' && env[k] !== '';
-    // ── Claude Code ─────────────────────────────────────────────────────────
-    // CLAUDE_CODE_ENTRYPOINT is the long-standing signal; CLAUDECODE=1 is set by
-    // newer builds. Either identifies the Claude Code host.
-    if (has('CLAUDE_CODE_ENTRYPOINT') || env.CLAUDECODE === '1')
-        return 'claude';
-    // ── VS Code forks (must precede the generic vscode check) ────────────────
-    if (has('CURSOR_TRACE_ID') || env.TERM_PROGRAM === 'cursor')
-        return 'cursor';
-    if (has('WINDSURF_SESSION_ID') || env.TERM_PROGRAM === 'windsurf')
-        return 'windsurf';
-    // ── GitHub Copilot (agent workspace) ─────────────────────────────────────
-    if (has('GITHUB_COPILOT_WORKSPACE') || has('COPILOT_AGENT_ID'))
-        return 'copilot';
-    // ── Zed ──────────────────────────────────────────────────────────────────
-    if (env.TERM_PROGRAM === 'zed' || has('ZED_TERM'))
-        return 'zed';
-    // ── JetBrains (IntelliJ/PyCharm/GoLand/… integrated terminal) ────────────
-    if (env.TERMINAL_EMULATOR === 'JetBrains-JediTerm' ||
-        has('__INTELLIJ_COMMAND_HISTFILE__') ||
-        has('IDEA_INITIAL_DIRECTORY')) {
-        return 'jetbrains';
-    }
-    // ── VS Code (generic — after the forks above) ────────────────────────────
-    // TERM_PROGRAM=vscode covers the integrated terminal; the macOS bundle id
-    // and VSCODE_* handshake vars cover the native MCP stdio child (no terminal).
-    if (env.TERM_PROGRAM === 'vscode' ||
-        has('VSCODE_PID') ||
-        has('VSCODE_CWD') ||
-        has('VSCODE_IPC_HOOK') ||
-        has('VSCODE_IPC_HOOK_CLI') ||
-        has('VSCODE_GIT_IPC_HANDLE') ||
-        isVSCodeBundle(env.__CFBundleIdentifier)) {
-        return 'vscode';
-    }
-    return 'unknown';
-}
-/** macOS sets __CFBundleIdentifier to the launching app's bundle id. */
-function isVSCodeBundle(bundle) {
-    if (!bundle)
-        return false;
-    return (bundle === 'com.microsoft.VSCode' ||
-        bundle === 'com.microsoft.VSCodeInsiders' ||
-        bundle === 'com.visualstudio.code.oss' ||
-        bundle.startsWith('com.microsoft.VSCode'));
-}
-//# sourceMappingURL=editor.js.map
+function i(r=process.env){const _=o=>typeof r[o]=="string"&&r[o]!=="";return _("CLAUDE_CODE_ENTRYPOINT")||r.CLAUDECODE==="1"?"claude":_("CURSOR_TRACE_ID")||r.TERM_PROGRAM==="cursor"?"cursor":_("WINDSURF_SESSION_ID")||r.TERM_PROGRAM==="windsurf"?"windsurf":_("GITHUB_COPILOT_WORKSPACE")||_("COPILOT_AGENT_ID")?"copilot":r.TERM_PROGRAM==="zed"||_("ZED_TERM")?"zed":r.TERMINAL_EMULATOR==="JetBrains-JediTerm"||_("__INTELLIJ_COMMAND_HISTFILE__")||_("IDEA_INITIAL_DIRECTORY")?"jetbrains":r.TERM_PROGRAM==="vscode"||_("VSCODE_PID")||_("VSCODE_CWD")||_("VSCODE_IPC_HOOK")||_("VSCODE_IPC_HOOK_CLI")||_("VSCODE_GIT_IPC_HANDLE")||t(r.__CFBundleIdentifier)?"vscode":"unknown"}function t(r){return r?r==="com.microsoft.VSCode"||r==="com.microsoft.VSCodeInsiders"||r==="com.visualstudio.code.oss"||r.startsWith("com.microsoft.VSCode"):!1}export{i as detectEditor};