@cachly-dev/mcp-server 0.10.128 → 0.10.130

package/dist/src/embeddings.js

@@ -1,223 +1,13 @@
-/**
- * ┌──────────────────────────────────────────────────────────────────────┐
- * │  EMBEDDING PROVIDER — pluggable, client-side first                  │
- * │                                                                      │
- * │  Auto-detects from env vars. To force a provider, set:              │
- * │    CACHLY_EMBED_PROVIDER=openai   (+ OPENAI_API_KEY)                │
- * │    CACHLY_EMBED_PROVIDER=gemini   (+ GEMINI_API_KEY)                │
- * │    CACHLY_EMBED_PROVIDER=mistral  (+ MISTRAL_API_KEY)               │
- * │    CACHLY_EMBED_PROVIDER=cohere   (+ COHERE_API_KEY)                │
- * │    CACHLY_EMBED_PROVIDER=ollama   (+ OLLAMA_BASE_URL, local)        │
- * │    CACHLY_EMBED_PROVIDER=cachly   (server-side fallback, no key)    │
- * │                                                                      │
- * │  Priority: openai > gemini > mistral > cohere > ollama > cachly     │
- * │  Brain works WITHOUT embedding (keyword search + exact key lookup). │
- * │  Embedding is an optional boost for semantic_search/index_project.  │
- * └──────────────────────────────────────────────────────────────────────┘
- *
- * Mutable config — call setEmbedJwt() when the JWT changes (device flow).
- */
-// ── Mutable config (synced with index.ts JWT on device-flow auth) ────────────
-export const embedConfig = {
-    apiUrl: process.env.CACHLY_API_URL ?? 'https://api.cachly.dev',
-    jwt: process.env.CACHLY_JWT ?? '',
-    model: process.env.CACHLY_EMBED_MODEL ?? '',
-};
-/** Call this when JWT is refreshed (e.g. after device flow). */
-export function setEmbedJwt(jwt) {
-    embedConfig.jwt = jwt;
-}
-// Hard timeout for any embedding-provider HTTP call. Embedding is an OPTIONAL boost
-// for semantic recall — a slow/unreachable provider must never hang the agent turn.
-// Callers already treat embedding failures as non-fatal (keyword search still works).
-const EMBED_TIMEOUT_MS = Number(process.env.CACHLY_EMBED_TIMEOUT_MS ?? 8_000);
-// ── Provider auto-detection ───────────────────────────────────────────────────
-function detectEmbedProvider() {
-    // Client-side keys first (direct, fast, no server roundtrip)
-    if (process.env.OPENAI_API_KEY)
-        return 'openai';
-    if (process.env.GEMINI_API_KEY)
-        return 'gemini';
-    if (process.env.MISTRAL_API_KEY)
-        return 'mistral';
-    if (process.env.COHERE_API_KEY)
-        return 'cohere';
-    if (process.env.OLLAMA_BASE_URL)
-        return 'ollama';
-    // Server-side fallback — no API key needed, but adds latency
-    if (process.env.CACHLY_JWT)
-        return 'cachly';
-    return 'none'; // no provider → embedding disabled, brain still works via exact keys
-}
-export const EMBED_PROVIDER = (process.env.CACHLY_EMBED_PROVIDER ?? detectEmbedProvider()).toLowerCase();
-// ── Multi-provider embedding ─────────────────────────────────────────────────
-/**
- * Compute an embedding vector for `text` using the configured provider.
- *
- * Client-side (recommended — set one API key in your .env):
- *   openai   – OPENAI_API_KEY  · text-embedding-3-small
- *   gemini   – GEMINI_API_KEY  · text-embedding-004
- *   mistral  – MISTRAL_API_KEY · mistral-embed
- *   cohere   – COHERE_API_KEY  · embed-english-v3.0
- *   ollama   – OLLAMA_BASE_URL · nomic-embed-text (local, free)
- *
- * Server-side fallback (no key needed on client):
- *   cachly   – POST /api/v1/embed (requires CACHLY_JWT)
- *
- * Note: Brain works fully WITHOUT embedding (keyword search + exact keys).
- *       Embedding is an OPTIONAL boost for semantic_search and index_project.
- */
-export async function computeEmbedding(text) {
-    switch (EMBED_PROVIDER) {
-        case 'cachly': {
-            // Server-side embedding — the Cachly API computes the embedding
-            // using whatever provider is configured on the server. No client-side API key needed.
-            if (!embedConfig.jwt)
-                throw new Error('CACHLY_JWT not set.\n\n' +
-                    'The "cachly" provider uses server-side embeddings via the Cachly API.\n' +
-                    'Set CACHLY_JWT, or use another provider via CACHLY_EMBED_PROVIDER:\n' +
-                    '  openai  → OPENAI_API_KEY\n' +
-                    '  gemini  → GEMINI_API_KEY\n' +
-                    '  ollama  → OLLAMA_BASE_URL (local, no key needed)');
-            const url = `${embedConfig.apiUrl}/api/v1/embed`;
-            const body = { text };
-            if (embedConfig.model)
-                body.model = embedConfig.model;
-            const res = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'Authorization': `Bearer ${embedConfig.jwt}`,
-                },
-                body: JSON.stringify(body),
-                signal: AbortSignal.timeout(EMBED_TIMEOUT_MS),
-            });
-            if (!res.ok) {
-                const errBody = await res.text();
-                throw new Error(`Cachly embed API error ${res.status}: ${errBody}`);
-            }
-            const json = (await res.json());
-            return json.embedding;
-        }
-        case 'mistral': {
-            const key = process.env.MISTRAL_API_KEY;
-            if (!key)
-                throw new Error('MISTRAL_API_KEY not set');
-            const model = embedConfig.model !== 'text-embedding-3-small' ? embedConfig.model : 'mistral-embed';
-            const res = await fetch('https://api.mistral.ai/v1/embeddings', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
-                body: JSON.stringify({ model, input: [text] }),
-                signal: AbortSignal.timeout(EMBED_TIMEOUT_MS),
-            });
-            if (!res.ok)
-                throw new Error(`Mistral embedding error: ${res.statusText}`);
-            const json = (await res.json());
-            if (!json.data?.[0]?.embedding)
-                throw new Error('Mistral returned empty embedding response');
-            return json.data[0].embedding;
-        }
-        case 'cohere': {
-            const key = process.env.COHERE_API_KEY;
-            if (!key)
-                throw new Error('COHERE_API_KEY not set');
-            const model = embedConfig.model !== 'text-embedding-3-small' ? embedConfig.model : 'embed-english-v3.0';
-            const res = await fetch('https://api.cohere.com/v2/embed', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
-                body: JSON.stringify({ model, texts: [text], input_type: 'search_query', embedding_types: ['float'] }),
-                signal: AbortSignal.timeout(EMBED_TIMEOUT_MS),
-            });
-            if (!res.ok)
-                throw new Error(`Cohere embedding error: ${res.statusText}`);
-            const json = (await res.json());
-            return json.embeddings.float[0];
-        }
-        case 'ollama': {
-            const base = process.env.OLLAMA_BASE_URL ?? 'http://localhost:11434';
-            const model = embedConfig.model !== 'text-embedding-3-small' ? embedConfig.model : 'nomic-embed-text';
-            const res = await fetch(`${base}/api/embeddings`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ model, prompt: text }),
-                signal: AbortSignal.timeout(EMBED_TIMEOUT_MS),
-            });
-            if (!res.ok)
-                throw new Error(`Ollama embedding error: ${res.statusText}`);
-            const json = (await res.json());
-            return json.embedding;
-        }
-        case 'gemini': {
-            const key = process.env.GEMINI_API_KEY;
-            if (!key)
-                throw new Error('GEMINI_API_KEY not set');
-            const model = embedConfig.model !== 'text-embedding-3-small' ? embedConfig.model : 'text-embedding-004';
-            const res = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/${model}:embedContent?key=${key}`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ model: `models/${model}`, content: { parts: [{ text }] } }),
-                signal: AbortSignal.timeout(EMBED_TIMEOUT_MS),
-            });
-            if (!res.ok)
-                throw new Error(`Gemini embedding error: ${res.statusText}`);
-            const json = (await res.json());
-            return json.embedding.values;
-        }
-        case 'openai': {
-            const key = process.env.OPENAI_API_KEY;
-            if (!key)
-                throw new Error('OPENAI_API_KEY not set.\n\n' +
-                    'Set OPENAI_API_KEY in your .env, or switch provider:\n' +
-                    '  CACHLY_EMBED_PROVIDER=gemini  (+ GEMINI_API_KEY)\n' +
-                    '  CACHLY_EMBED_PROVIDER=ollama  (local, free)\n' +
-                    '  CACHLY_EMBED_PROVIDER=cachly  (server-side, no key needed)');
-            const model = embedConfig.model || 'text-embedding-3-small';
-            const res = await fetch('https://api.openai.com/v1/embeddings', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
-                body: JSON.stringify({ model, input: text }),
-                signal: AbortSignal.timeout(EMBED_TIMEOUT_MS),
-            });
-            if (!res.ok)
-                throw new Error(`OpenAI embedding error: ${res.statusText}`);
-            const json = (await res.json());
-            if (!json.data?.[0]?.embedding)
-                throw new Error('OpenAI returned empty embedding response');
-            return json.data[0].embedding;
-        }
-        default: {
-            throw new Error(`Unknown CACHLY_EMBED_PROVIDER="${EMBED_PROVIDER}".\n` +
-                'Supported: cachly (default), openai, mistral, cohere, ollama, gemini');
-        }
-    }
-}
-/** Returns true if the configured embedding provider has its required key/URL set. */
-export function hasEmbedProvider() {
-    switch (EMBED_PROVIDER) {
-        case 'cachly': return !!embedConfig.jwt;
-        case 'mistral': return !!process.env.MISTRAL_API_KEY;
-        case 'cohere': return !!process.env.COHERE_API_KEY;
-        case 'ollama': return true; // OLLAMA_BASE_URL is optional (defaults to localhost)
-        case 'gemini': return !!process.env.GEMINI_API_KEY;
-        case 'openai': return !!process.env.OPENAI_API_KEY;
-        case 'none': return false;
-        default: return false;
-    }
-}
-/** Returns a human-readable description of the current embed provider/model for error messages. */
-export function embedProviderHint() {
-    const providerKeys = {
-        cachly: 'CACHLY_JWT (server-side, no extra key needed)',
-        openai: 'OPENAI_API_KEY',
-        mistral: 'MISTRAL_API_KEY',
-        cohere: 'COHERE_API_KEY',
-        ollama: 'OLLAMA_BASE_URL (optional, default: http://localhost:11434)',
-        gemini: 'GEMINI_API_KEY',
-    };
-    if (EMBED_PROVIDER === 'none') {
-        return 'No embedding provider configured. Set OPENAI_API_KEY, GEMINI_API_KEY, or another provider key in .env. Brain works without embedding.';
-    }
-    const key = providerKeys[EMBED_PROVIDER] ?? 'CACHLY_JWT';
-    return `CACHLY_EMBED_PROVIDER=${EMBED_PROVIDER} → requires ${key}`;
-}
-//# sourceMappingURL=embeddings.js.map
+const t={apiUrl:process.env.CACHLY_API_URL??"https://api.cachly.dev",jwt:process.env.CACHLY_JWT??"",model:process.env.CACHLY_EMBED_MODEL??""};function m(r){t.jwt=r}const i=Number(process.env.CACHLY_EMBED_TIMEOUT_MS??8e3);function c(){return process.env.CACHLY_JWT?"cachly":process.env.OLLAMA_BASE_URL?"ollama":"none"}const a=(process.env.CACHLY_EMBED_PROVIDER??c()).toLowerCase();async function l(r){switch(a){case"cachly":{if(!t.jwt)throw new Error(`CACHLY_JWT not set.
+
+The "cachly" provider uses server-side embeddings via the Cachly API.
+Set CACHLY_JWT, or use another provider via CACHLY_EMBED_PROVIDER:
+  openai  \u2192 OPENAI_API_KEY
+  gemini  \u2192 GEMINI_API_KEY
+  ollama  \u2192 OLLAMA_BASE_URL (local, no key needed)`);const o=`${t.apiUrl}/api/v1/embed`,n={text:r};t.model&&(n.model=t.model);const e=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t.jwt}`},body:JSON.stringify(n),signal:AbortSignal.timeout(i)});if(!e.ok){const d=await e.text();throw new Error(`Cachly embed API error ${e.status}: ${d}`)}return(await e.json()).embedding}case"mistral":{const o=process.env.MISTRAL_API_KEY;if(!o)throw new Error("MISTRAL_API_KEY not set");const n=t.model!=="text-embedding-3-small"?t.model:"mistral-embed",e=await fetch("https://api.mistral.ai/v1/embeddings",{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${o}`},body:JSON.stringify({model:n,input:[r]}),signal:AbortSignal.timeout(i)});if(!e.ok)throw new Error(`Mistral embedding error: ${e.statusText}`);const s=await e.json();if(!s.data?.[0]?.embedding)throw new Error("Mistral returned empty embedding response");return s.data[0].embedding}case"cohere":{const o=process.env.COHERE_API_KEY;if(!o)throw new Error("COHERE_API_KEY not set");const n=t.model!=="text-embedding-3-small"?t.model:"embed-english-v3.0",e=await fetch("https://api.cohere.com/v2/embed",{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${o}`},body:JSON.stringify({model:n,texts:[r],input_type:"search_query",embedding_types:["float"]}),signal:AbortSignal.timeout(i)});if(!e.ok)throw new Error(`Cohere embedding error: ${e.statusText}`);return(await e.json()).embeddings.float[0]}case"ollama":{const o=process.env.OLLAMA_BASE_URL??"http://localhost:11434",n=t.model!=="text-embedding-3-small"?t.model:"nomic-embed-text",e=await fetch(`${o}/api/embeddings`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({model:n,prompt:r}),signal:AbortSignal.timeout(i)});if(!e.ok)throw new Error(`Ollama embedding error: ${e.statusText}`);return(await e.json()).embedding}case"gemini":{const o=process.env.GEMINI_API_KEY;if(!o)throw new Error("GEMINI_API_KEY not set");const n=t.model!=="text-embedding-3-small"?t.model:"text-embedding-004",e=await fetch(`https://generativelanguage.googleapis.com/v1beta/models/${n}:embedContent?key=${o}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({model:`models/${n}`,content:{parts:[{text:r}]}}),signal:AbortSignal.timeout(i)});if(!e.ok)throw new Error(`Gemini embedding error: ${e.statusText}`);return(await e.json()).embedding.values}case"openai":{const o=process.env.OPENAI_API_KEY;if(!o)throw new Error(`OPENAI_API_KEY not set.
+
+Set OPENAI_API_KEY in your .env, or switch provider:
+  CACHLY_EMBED_PROVIDER=gemini  (+ GEMINI_API_KEY)
+  CACHLY_EMBED_PROVIDER=ollama  (local, free)
+  CACHLY_EMBED_PROVIDER=cachly  (server-side, no key needed)`);const n=t.model||"text-embedding-3-small",e=await fetch("https://api.openai.com/v1/embeddings",{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${o}`},body:JSON.stringify({model:n,input:r}),signal:AbortSignal.timeout(i)});if(!e.ok)throw new Error(`OpenAI embedding error: ${e.statusText}`);const s=await e.json();if(!s.data?.[0]?.embedding)throw new Error("OpenAI returned empty embedding response");return s.data[0].embedding}default:throw new Error(`Unknown CACHLY_EMBED_PROVIDER="${a}".
+Supported: cachly (default), openai, mistral, cohere, ollama, gemini`)}}function E(){switch(a){case"cachly":return!!t.jwt;case"mistral":return!!process.env.MISTRAL_API_KEY;case"cohere":return!!process.env.COHERE_API_KEY;case"ollama":return!0;case"gemini":return!!process.env.GEMINI_API_KEY;case"openai":return!!process.env.OPENAI_API_KEY;case"none":return!1;default:return!1}}function p(){const r={cachly:"CACHLY_JWT (server-side, no extra key needed)",openai:"OPENAI_API_KEY",mistral:"MISTRAL_API_KEY",cohere:"COHERE_API_KEY",ollama:"OLLAMA_BASE_URL (optional, default: http://localhost:11434)",gemini:"GEMINI_API_KEY"};if(a==="none")return"No embedding provider configured. Set OPENAI_API_KEY, GEMINI_API_KEY, or another provider key in .env. Brain works without embedding.";const o=r[a]??"CACHLY_JWT";return`CACHLY_EMBED_PROVIDER=${a} \u2192 requires ${o}`}export{a as EMBED_PROVIDER,l as computeEmbedding,t as embedConfig,p as embedProviderHint,E as hasEmbedProvider,m as setEmbedJwt};

package/dist/src/feldreparatur.js

@@ -0,0 +1,3 @@
+const d=["what_worked","what_failed","context"],a=new RegExp(String.raw`<\/?(?:parameter\s+name\s*=\s*["']?)?(${d.join("|")})["']?\s*\/?>`,"gi");function w(t){return t?(a.lastIndex=0,a.test(t)):!1}function x(t){if(!w(t.what_worked)&&!w(t.what_failed)&&!w(t.context))return t;const n={what_worked:"",what_failed:t.what_failed??"",context:t.context??""},o=t.what_worked??"",i=[];let s=0,l="what_worked";a.lastIndex=0;for(let e=a.exec(o);e!==null;e=a.exec(o)){i.push({ziel:l,text:o.slice(s,e.index)});const r=e[1].toLowerCase();l=e[0].startsWith("</")?l:r,s=e.index+e[0].length}i.push({ziel:l,text:o.slice(s)});for(const e of i){const r=e.text.trim();r&&(n[e.ziel]?n[e.ziel]=`${n[e.ziel]}
+
+${r}`:n[e.ziel]=r)}const c=e=>e.replace(a," ").replace(/[ \t]{2,}/g," ").trim();return{what_worked:c(n.what_worked),what_failed:n.what_failed?c(n.what_failed):t.what_failed,context:n.context?c(n.context):t.context}}export{w as hatFeldmarke,x as repariereFelder};

package/dist/src/first-contact.js

@@ -1,108 +1,4 @@
-/**
- * First-contact response builder for `brain_from_git` (roadmap P1-5:
- * "Onboarding-Magie messen & polieren").
- *
- * The very first `brain_from_git` run is a new user's first contact with the
- * Brain, and it decides whether they ever reach the "aha". The response must,
- * in one message:
- *   (a) summarize what was just learned (counts by category + severity),
- *   (b) prove recall already works — show the top hit of a real search that
- *       ran against a topic seeded seconds ago,
- *   (c) hand the user 2-3 copy-pasteable next queries, and
- *   (d) degrade gracefully for empty/small repos (clear guidance, not empty stats).
- *
- * Pure string building — no I/O, no schema/tool changes — so the onboarding
- * bench and its CI test can assert the exact first-contact response shape.
- */
-/** Below this many ingested lessons we treat the repo as "small" and add growth guidance. */
-export const SMALL_SEED_THRESHOLD = 5;
-export function formatSeedDuration(ms) {
-    if (ms < 1000)
-        return `${Math.max(ms, 1)}ms`;
-    if (ms < 60_000)
-        return `${(ms / 1000).toFixed(1)}s`;
-    return `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`;
-}
-/**
- * Turn seeded topics (`category:some-domain`) into up to `max` copy-pasteable
- * `smart_recall` calls a brand-new user can paste as their literal next message.
- * Deduplicates by domain so three "fix:*" topics don't yield three identical queries.
- */
-export function suggestRecallQueries(topics, instanceId, max = 3) {
-    const seen = new Set();
-    const out = [];
-    for (const topic of topics) {
-        const domain = (topic.includes(':') ? topic.slice(topic.indexOf(':') + 1) : topic)
-            .replace(/[-_]+/g, ' ')
-            .trim();
-        if (!domain || seen.has(domain))
-            continue;
-        seen.add(domain);
-        out.push(`smart_recall(instance_id="${instanceId}", query="${domain}")`);
-        if (out.length >= max)
-            break;
-    }
-    return out;
-}
-/** Steps that take an empty/tiny Brain to a first recall hit in under a minute. */
-function growthSteps(instanceId) {
-    return [
-        `  1. \`brain_seed_starter(instance_id="${instanceId}")\` — load 16 curated engineering lessons instantly`,
-        `  2. \`smart_recall(instance_id="${instanceId}", query="docker build slow")\` — see your first recall hit`,
-        `  3. \`learn_from_attempts(...)\` after your next fix — the Brain grows with every lesson from here on`,
-    ];
-}
-export function buildFirstContactReport(r) {
-    const lines = [];
-    lines.push(`🔁 **brain_from_git: ${r.repoDir}**`);
-    if (r.isIncremental && r.lastSha) {
-        lines.push(`🔄 Incremental mode — only new commits since \`${r.lastSha.slice(0, 8)}\` were processed`);
-    }
-    lines.push('');
-    lines.push(`📂 Branch: \`${r.revRange}\`  |  Processed: **${r.processed}** commits  |  ` +
-        `Ingested: **${r.ingested}** lessons  |  Skipped: ${r.skipped}  |  ` +
-        `⏱️ Seeding took ${formatSeedDuration(r.durationMs)}`);
-    lines.push('');
-    // ── Empty repo / nothing ingested — guidance instead of empty stats ─────────
-    if (r.ingested === 0) {
-        if (r.emptyReason)
-            lines.push(`⚠️ ${r.emptyReason}`);
-        lines.push(`🌱 **Nothing to learn from this git history yet** — normal for fresh, shallow, or squash-only repos.`);
-        lines.push(`Get to your first recall in under a minute:`);
-        lines.push(...growthSteps(r.instanceId));
-        return lines.join('\n');
-    }
-    // ── (a) Seeded summary — what the Brain just learned ────────────────────────
-    lines.push(`**What your Brain just learned (by category):**`);
-    lines.push(r.categories.map(([k, v]) => `  • **${k}** (${v})`).join('\n'));
-    if (r.severities && r.severities.length > 0) {
-        lines.push(`**By severity:** ${r.severities.map(([k, v]) => `${k} ${v}`).join(' · ')}`);
-    }
-    // ── (b) Proof of value — a real recall against a just-seeded topic ──────────
-    if (r.proof) {
-        lines.push('');
-        lines.push(`🎯 **Proof — your first recall already works.** We just searched your fresh Brain for:`);
-        lines.push(`   "${r.proof.query}"`);
-        lines.push(`   → Top hit: **${r.proof.topic}** — ${r.proof.snippet}`);
-    }
-    // ── (c) Suggested next queries — copy-pasteable ──────────────────────────────
-    if (r.suggestedQueries.length > 0) {
-        lines.push('');
-        lines.push(`**Try these next (copy-paste):**`);
-        for (const q of r.suggestedQueries)
-            lines.push(`  • \`${q}\``);
-    }
-    // ── (d) Small-repo guidance ──────────────────────────────────────────────────
-    if (r.ingested < SMALL_SEED_THRESHOLD) {
-        lines.push('');
-        lines.push(`🌱 **Small git history — only ${r.ingested} lesson${r.ingested === 1 ? '' : 's'} so far.** Top it up:`);
-        lines.push(...growthSteps(r.instanceId));
-    }
-    lines.push('');
-    lines.push(`💡 New lessons are stored with confidence 0.55 (auto-inferred).`);
-    lines.push(`💡 As you confirm them via \`learn_from_attempts\`, confidence rises automatically.`);
-    lines.push(`🔍 Explore: \`brain_search(query="fix")\`  |  \`ckg_inspect(concept="deploy")\``);
-    lines.push(`💾 Next run will automatically continue from the latest commit (incremental mode).`);
-    return lines.join('\n');
-}
-//# sourceMappingURL=first-contact.js.map
+const p=5;function u(e){return e<1e3?`${Math.max(e,1)}ms`:e<6e4?`${(e/1e3).toFixed(1)}s`:`${Math.floor(e/6e4)}m ${Math.round(e%6e4/1e3)}s`}function c(e,s,t=3){const o=new Set,r=[];for(const n of e){const i=(n.includes(":")?n.slice(n.indexOf(":")+1):n).replace(/[-_]+/g," ").trim();if(!(!i||o.has(i))&&(o.add(i),r.push(`smart_recall(instance_id="${s}", query="${i}")`),r.length>=t))break}return r}function a(e){return[`  1. \`brain_seed_starter(instance_id="${e}")\` \u2014 load 16 curated engineering lessons instantly`,`  2. \`smart_recall(instance_id="${e}", query="docker build slow")\` \u2014 see your first recall hit`,"  3. `learn_from_attempts(...)` after your next fix \u2014 the Brain grows with every lesson from here on"]}function h(e){const s=[];if(s.push(`\u{1F501} **brain_from_git: ${e.repoDir}**`),e.isIncremental&&e.lastSha&&s.push(`\u{1F504} Incremental mode \u2014 only new commits since \`${e.lastSha.slice(0,8)}\` were processed`),s.push(""),s.push(`\u{1F4C2} Branch: \`${e.revRange}\`  |  Processed: **${e.processed}** commits  |  Ingested: **${e.ingested}** lessons  |  Skipped: ${e.skipped}  |  \u23F1\uFE0F Seeding took ${u(e.durationMs)}`),s.push(""),e.ingested===0)return e.emptyReason&&s.push(`\u26A0\uFE0F ${e.emptyReason}`),s.push("\u{1F331} **Nothing to learn from this git history yet** \u2014 normal for fresh, shallow, or squash-only repos."),s.push("Get to your first recall in under a minute:"),s.push(...a(e.instanceId)),s.join(`
+`);if(s.push("**What your Brain just learned (by category):**"),s.push(e.categories.map(([t,o])=>`  \u2022 **${t}** (${o})`).join(`
+`)),e.severities&&e.severities.length>0&&s.push(`**By severity:** ${e.severities.map(([t,o])=>`${t} ${o}`).join(" \xB7 ")}`),e.proof&&(s.push(""),s.push("\u{1F3AF} **Proof \u2014 your first recall already works.** We just searched your fresh Brain for:"),s.push(`   "${e.proof.query}"`),s.push(`   \u2192 Top hit: **${e.proof.topic}** \u2014 ${e.proof.snippet}`)),e.suggestedQueries.length>0){s.push(""),s.push("**Try these next (copy-paste):**");for(const t of e.suggestedQueries)s.push(`  \u2022 \`${t}\``)}return e.ingested<5&&(s.push(""),s.push(`\u{1F331} **Small git history \u2014 only ${e.ingested} lesson${e.ingested===1?"":"s"} so far.** Top it up:`),s.push(...a(e.instanceId))),s.push(""),s.push("\u{1F4A1} New lessons are stored with confidence 0.55 (auto-inferred)."),s.push("\u{1F4A1} As you confirm them via `learn_from_attempts`, confidence rises automatically."),s.push('\u{1F50D} Explore: `brain_search(query="fix")`  |  `ckg_inspect(concept="deploy")`'),s.push("\u{1F4BE} Next run will automatically continue from the latest commit (incremental mode)."),s.join(`
+`)}export{p as SMALL_SEED_THRESHOLD,h as buildFirstContactReport,u as formatSeedDuration,c as suggestRecallQueries};

package/dist/src/first-recall-proof.js

@@ -1,41 +1,4 @@
-/**
- * The Aha-moment of the first minute (GROW-013): a new user must see the
- * Brain recall something real from their OWN repo, not just a lesson count.
- * Both functions are pure — no I/O, no network, no state — so setup/autopilot
- * can call them without risking the 3s onboarding budget.
- */
-/**
- * Finds the "Proof — your first recall already works" block inside a
- * `brain_from_git` result text and returns it verbatim (the block runs from
- * the matching line up to the next blank line). Returns `null` when the text
- * carries no such block — never invents a proof.
- */
-export function extractFirstRecallProof(text) {
-    if (!text)
-        return null;
-    const lines = text.split('\n');
-    const startIdx = lines.findIndex((line) => /first recall already works/i.test(line));
-    if (startIdx === -1)
-        return null;
-    const block = [];
-    for (let i = startIdx; i < lines.length; i++) {
-        if (i > startIdx && lines[i].trim() === '')
-            break;
-        block.push(lines[i]);
-    }
-    const joined = block.join('\n').trim();
-    return joined || null;
-}
-/**
- * Renders the first-recall proof for the seed path: a real recall hit
- * against the just-seeded starter corpus, shown as evidence instead of a
- * bare "seeded ✓".
- */
-export function renderFirstRecallProof(topic, what) {
-    const snippet = what.trim();
-    return [
-        '🎯 Proof — your first recall already works.',
-        `   Top hit: **${topic}** — ${snippet}`,
-    ].join('\n');
-}
-//# sourceMappingURL=first-recall-proof.js.map
+function l(o){if(!o)return null;const n=o.split(`
+`),t=n.findIndex(r=>/first recall already works/i.test(r));if(t===-1)return null;const e=[];for(let r=t;r<n.length&&!(r>t&&n[r].trim()==="");r++)e.push(n[r]);return e.join(`
+`).trim()||null}function s(o,n){const t=n.trim();return["\u{1F3AF} Proof \u2014 your first recall already works.",`   Top hit: **${o}** \u2014 ${t}`].join(`
+`)}export{l as extractFirstRecallProof,s as renderFirstRecallProof};

package/dist/src/funnel-milestones.js

@@ -1,48 +1,2 @@
-// Persistent once-per-machine funnel milestones.
-//
-// Milestones like first_call_success were guarded by an in-memory flag only —
-// but ambient hooks spawn a FRESH server process per prompt, so every hook
-// invocation re-sent "first call" and the backend saw 66 "first" calls from
-// one user (and Telegram pinged the founder on every one). Persisting the
-// marker in ~/.cachly/ makes "first" mean first-on-this-machine across
-// process restarts. Best-effort: any filesystem problem degrades to the old
-// in-memory behaviour (the backend now dedupes too), never throws.
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-export function defaultMilestonePath() {
-    return join(homedir(), '.cachly', 'funnel-milestones.json');
-}
-function readAll(path) {
-    try {
-        if (!existsSync(path))
-            return {};
-        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
-        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-            return parsed;
-        }
-        return {};
-    }
-    catch {
-        return {}; // corrupt file → treat as empty, next mark rewrites it
-    }
-}
-/** True when this milestone was already sent from this machine. */
-export function milestoneSent(name, path = defaultMilestonePath()) {
-    return name in readAll(path);
-}
-/** Record a milestone (idempotent). Never throws. */
-export function markMilestoneSent(name, path = defaultMilestonePath()) {
-    try {
-        const all = readAll(path);
-        if (name in all)
-            return;
-        all[name] = new Date().toISOString();
-        mkdirSync(dirname(path), { recursive: true });
-        writeFileSync(path, JSON.stringify(all, null, 2) + '\n', 'utf-8');
-    }
-    catch {
-        /* best-effort — the server-side dedup is the safety net */
-    }
-}
-//# sourceMappingURL=funnel-milestones.js.map
+import{existsSync as o,mkdirSync as c,readFileSync as u,writeFileSync as f}from"node:fs";import{homedir as l}from"node:os";import{dirname as s,join as a}from"node:path";function n(){return a(l(),".cachly","funnel-milestones.json")}function i(t){try{if(!o(t))return{};const r=JSON.parse(u(t,"utf-8"));return r&&typeof r=="object"&&!Array.isArray(r)?r:{}}catch{return{}}}function d(t,r=n()){return t in i(r)}function p(t,r=n()){try{const e=i(r);if(t in e)return;e[t]=new Date().toISOString(),c(s(r),{recursive:!0}),f(r,JSON.stringify(e,null,2)+`
+`,"utf-8")}catch{}}export{n as defaultMilestonePath,p as markMilestoneSent,d as milestoneSent};

package/dist/src/geliefert.js

@@ -1,114 +1 @@
-import { estimateTokens } from './ambient-recall.js';
-/**
- * Wie viel Text kam aus dem Gedaechtnis statt aus dem Modell?
- *
- * ANLASS 19.08.2026, Heinrich: "Bei der Schaetzung der Tokenersparnis sollten
- * wir schauen, dass wir nicht nur schaetzen, denn das nervt Leute sehr stark.
- * Vielleicht machen wir eine weitere Metrik rein? Sowas wie Token, die bei den
- * Calls aus dem Brain rausgenommen wurden und nicht aus der AI vom Vendor
- * kamen?"
- *
- * ── Warum das die bessere Zahl ist ──────────────────────────────────────────
- *
- * Die bisherige Zahl "583k Token gespart" ist eine RECHNUNG: 1.200 Token je
- * wiederverwendeter Lektion mal 486 Abrufe. Der Faktor 1.200 ist geraten, und
- * jeder darf ihn bestreiten. Die Zahl hier ist eine SUMME: die Laenge der
- * Antworten, die das Brain wirklich zurueckgegeben hat. Da gibt es nichts zu
- * bestreiten — hoechstens die Frage, was sie bedeutet.
- *
- * ── Was sie NICHT sagt ──────────────────────────────────────────────────────
- *
- * Sie ist KEIN Beweis, dass das Modell diese Token sonst selbst erzeugt haette.
- * Vielleicht haette es die Antwort gar nicht gefunden, vielleicht kuerzer
- * geantwortet. Sie sagt genau eines, und das laesst sich nachrechnen: so viel
- * Text kam als Antwort aus dem Gedaechtnis. Wer mehr behauptet, schaetzt
- * wieder.
- *
- * Deshalb steht die Schaetzung weiter daneben — aber klein, mit ihrer Annahme
- * im selben Satz, und neben einer Zahl, die keine braucht.
- */
-/**
- * Nur ABRUFE zaehlen, nicht jede Antwort.
- *
- * `learn_from_attempts` gibt eine Bestaetigung zurueck, `create_instance` eine
- * Kennung — das ist kein geliefertes Wissen. Gezaehlt wird, was Gespeichertes
- * herausgibt. Steht ein Werkzeug nicht auf dieser Liste, zaehlt es nicht mit;
- * die Zahl ist dadurch eher zu klein als zu gross, und das ist die richtige
- * Richtung fuer eine Zahl, mit der man wirbt.
- */
-export const LIEFERNDE_WERKZEUGE = new Set([
-    'smart_recall',
-    'recall_best_solution',
-    'recall_context',
-    'recall_at',
-    'causal_trace',
-    'semantic_search',
-    'brain_search',
-    'team_recall',
-    'global_recall',
-    'session_start',
-    'session_start_summary',
-    'brain_briefing',
-    'compact_recover',
-    'session_handoff',
-    'crystal_view',
-    'brain_graph',
-    'trace_dependency',
-    'brain_who_knows',
-    'fedbrain_search',
-    'syndicate_search',
-]);
-export function istLieferung(werkzeugName) {
-    return LIEFERNDE_WERKZEUGE.has(werkzeugName);
-}
-/** Redis-Schluessel je Brain: Summe der gelieferten Token. */
-export function lieferSchluessel(instanceId) {
-    return `cachly:stats:delivered_tokens:${instanceId}`;
-}
-/** Redis-Schluessel je Brain: Abrufe gesamt und davon mit Treffer. */
-export function trefferSchluessel(instanceId) {
-    return `cachly:stats:recall_hits:${instanceId}`;
-}
-/**
- * Hatte dieser Abruf einen Treffer?
- *
- * Erkannt an dem, was die Antwort SAGT, nicht an ihrer Laenge: eine hoefliche
- * Absage ("keine passende Lektion gefunden") ist laenger als mancher Treffer.
- * Die Muster stammen aus den Antworttexten der Abruf-Werkzeuge selbst.
- */
-const LEERE_ANTWORT = /(no (relevant |matching |cached )?(lessons?|results?|context|memory|match)|keine? (passende|relevante)|nothing (found|cached)|0 results|Results \(0\b|empty)/i;
-export function hatTreffer(antwort) {
-    if (!antwort || antwort.trim().length === 0)
-        return false;
-    return !LEERE_ANTWORT.test(antwort);
-}
-/** Die Token dieser Antwort — dieselbe Schaetzfunktion wie beim Einblende-Budget. */
-export function tokenDerAntwort(antwort) {
-    return estimateTokens(antwort);
-}
-export function lieferBild(roh) {
-    const zahl = (v) => {
-        const n = typeof v === 'number' ? v : Number(v ?? 0);
-        return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
-    };
-    const token = zahl(roh.token);
-    const abrufe = zahl(roh.abrufe);
-    const treffer = Math.min(zahl(roh.treffer), abrufe);
-    return { token, abrufe, treffer, quote: abrufe > 0 ? treffer / abrufe : 0 };
-}
-/** Grosse Zahlen so, wie ein Mensch sie liest. */
-export function inWorten(bild) {
-    if (bild.abrufe === 0) {
-        return 'Aus dem Brain geliefert: noch nichts — es gab bisher keinen Abruf.';
-    }
-    const t = bild.token >= 1_000_000
-        ? `${(bild.token / 1_000_000).toFixed(2)} Mio.`
-        : bild.token >= 1_000
-            ? `${Math.round(bild.token / 1_000)}k`
-            : `${bild.token}`;
-    const prozent = Math.round(bild.quote * 100);
-    return (`Aus dem Brain geliefert: ${t} Token in ${bild.abrufe} Abrufen. ` +
-        `${bild.treffer} davon fanden etwas (${prozent} %). ` +
-        `Gemessen, nicht gerechnet — es ist die Summe der Antwortlaengen, keine Annahme.`);
-}
-//# sourceMappingURL=geliefert.js.map
+import{estimateTokens as c}from"./ambient-recall.js";const i=new Set(["smart_recall","recall_best_solution","recall_context","recall_at","causal_trace","semantic_search","brain_search","team_recall","global_recall","session_start","session_start_summary","brain_briefing","compact_recover","session_handoff","crystal_view","brain_graph","trace_dependency","brain_who_knows","fedbrain_search","syndicate_search"]);function l(e){return i.has(e)}function _(e){return`cachly:stats:delivered_tokens:${e}`}function h(e){return`cachly:stats:recall_hits:${e}`}const u=/(no (relevant |matching |cached )?(lessons?|results?|context|memory|match)|keine? (passende|relevante)|nothing (found|cached)|0 results|Results \(0\b|empty)/i;function m(e){return!e||e.trim().length===0?!1:!u.test(e)}function k(e){return c(e)}function p(e){const t=s=>{const o=typeof s=="number"?s:Number(s??0);return Number.isFinite(o)&&o>0?Math.floor(o):0},r=t(e.token),n=t(e.abrufe),a=Math.min(t(e.treffer),n);return{token:r,abrufe:n,treffer:a,quote:n>0?a/n:0}}function d(e){if(e.abrufe===0)return"Aus dem Brain geliefert: noch nichts \u2014 es gab bisher keinen Abruf.";const t=e.token>=1e6?`${(e.token/1e6).toFixed(2)} Mio.`:e.token>=1e3?`${Math.round(e.token/1e3)}k`:`${e.token}`,r=Math.round(e.quote*100);return`Aus dem Brain geliefert: ${t} Token in ${e.abrufe} Abrufen. ${e.treffer} davon fanden etwas (${r} %). Gemessen, nicht gerechnet \u2014 es ist die Summe der Antwortlaengen, keine Annahme.`}export{i as LIEFERNDE_WERKZEUGE,m as hatTreffer,d as inWorten,l as istLieferung,p as lieferBild,_ as lieferSchluessel,k as tokenDerAntwort,h as trefferSchluessel};