codesift-mcp 0.9.0 → 0.9.10

package/dist/search/tool-ranker.js

@@ -1,420 +1,6 @@
-/**
- * Tool-ranker — ranks MCP tool definitions against a natural-language query
- * using BM25 (lexical), exact-name (identity), embedding cosine (semantic),
- * usage frequency (structural), and framework-match (framework) signals.
- *
- * Used by the `plan_turn` / tool-recommendation meta tools to surface the
- * most relevant tools for an agent's current intent.
- *
- * All signals are optional — semantic and structural gracefully degrade to
- * zero when the corresponding input is unavailable (e.g. no embedding API
- * key, fresh session with no usage history).
- */
-import { createHash } from "node:crypto";
-import { readFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { buildBM25Index, searchBM25, tokenizeText } from "./bm25.js";
-import { batchEmbed } from "../storage/embedding-store.js";
-import { createEmbeddingProvider } from "./semantic.js";
-import { loadConfig } from "../config.js";
-import { atomicWriteFile } from "../storage/_shared.js";
-// ---------------------------------------------------------------------------
-// Signal weights
-// ---------------------------------------------------------------------------
-const W_LEXICAL = 1.0;
-const W_IDENTITY = 2.0;
-const W_SEMANTIC = 0.8;
-const W_STRUCTURAL = 0.1;
-const W_FRAMEWORK = 0.6;
-const BM25_TOP_K = 50;
-const MAX_RECOMMENDATIONS = 10;
-// Field weights for the synthetic tool BM25 index. We keep this separate from
-// the global code-symbol weights because for tools, `signature` holds the
-// description and `docstring` holds the searchHint — name is still king.
-const TOOL_FIELD_WEIGHTS = {
-    name: 5.0,
-    signature: 2.5,
-    docstring: 2.0,
-    body: 0.0,
-    comments: 0.0,
-};
-let bm25Cache = null;
-/**
- * Compute a stable fingerprint for a list of tool definitions. Used to
- * invalidate the BM25 cache when the tool catalog is modified (tests,
- * hot-reload, new deployments).
- *
- * Exported for tests that need to predict cache-hit behaviour.
- */
-export function toolDefsFingerprint(toolDefs) {
-    // Stable subset: name, description, searchHint, category. Schema handler
-    // is not stringifiable and not relevant to ranking.
-    const subset = toolDefs.map((d) => [
-        d.name,
-        d.description,
-        d.searchHint ?? "",
-        d.category ?? "",
-    ]);
-    return createHash("sha1")
-        .update(JSON.stringify(subset))
-        .digest("hex")
-        .slice(0, 16);
-}
-/**
- * Map a `ToolDefinition` to a synthetic `CodeSymbol` so we can reuse the
- * existing BM25 index and scoring pipeline.
- *
- * - id / name          → tool name
- * - signature          → description (BM25 will tokenise it)
- * - docstring          → searchHint keywords
- * - file               → "__tools__/{category}.tool"
- */
-function toolToSymbol(def) {
-    const category = def.category ?? "uncategorized";
-    return {
-        id: def.name,
-        repo: "__tools__",
-        name: def.name,
-        kind: "function",
-        file: `__tools__/${category}.tool`,
-        start_line: 1,
-        end_line: 1,
-        signature: def.description,
-        docstring: def.searchHint ?? "",
-    };
-}
-/**
- * Build (or return cached) BM25 index for a tool catalog. Cache is keyed
- * by fingerprint — subsequent calls with the same shape return instantly.
- */
-export function buildToolBM25Index(toolDefs) {
-    const fingerprint = toolDefsFingerprint(toolDefs);
-    if (bm25Cache && bm25Cache.fingerprint === fingerprint) {
-        return bm25Cache.index;
-    }
-    const symbols = toolDefs.map(toolToSymbol);
-    const index = buildBM25Index(symbols);
-    bm25Cache = { fingerprint, index };
-    return index;
-}
-/** Clear the BM25 cache — for tests and hot-reload. */
-export function clearToolBM25Cache() {
-    bm25Cache = null;
-}
-// ---------------------------------------------------------------------------
-// Helpers — signal computation
-// ---------------------------------------------------------------------------
-/**
- * Compute BM25 lexical score and matched tokens for each tool.
- * Returns a map from tool name → { score (normalised 0..1), matches }.
- */
-function computeLexical(query, index) {
-    const results = searchBM25(index, query, BM25_TOP_K, TOOL_FIELD_WEIGHTS);
-    const out = new Map();
-    if (results.length === 0)
-        return out;
-    const top = results[0]?.score ?? 0;
-    if (top <= 0)
-        return out;
-    for (const r of results) {
-        const normalised = r.score / top;
-        out.set(r.symbol.id, {
-            score: normalised,
-            matches: r.matches ?? [],
-        });
-    }
-    return out;
-}
-/**
- * Identity signal — tool name appears verbatim in the query (case-insensitive).
- * Returns 1.0 for an exact substring match, else 0.
- */
-function computeIdentity(query, toolName) {
-    const q = query.toLowerCase();
-    const n = toolName.toLowerCase();
-    if (!n)
-        return 0;
-    // Whole-name appearance
-    if (q.includes(n))
-        return 1;
-    // snake_case → space-separated variant (e.g. "find dead code" vs "find_dead_code")
-    const spaced = n.replace(/_/g, " ");
-    if (q.includes(spaced))
-        return 1;
-    return 0;
-}
-/**
- * Cosine similarity between two equal-length vectors.
- * Returns 0 when lengths differ (defensive — caller guarantees equality).
- */
-function cosine(a, b) {
-    if (a.length !== b.length || a.length === 0)
-        return 0;
-    let dot = 0;
-    let nA = 0;
-    let nB = 0;
-    for (let i = 0; i < a.length; i++) {
-        const ai = a[i] ?? 0;
-        const bi = b[i] ?? 0;
-        dot += ai * bi;
-        nA += ai * ai;
-        nB += bi * bi;
-    }
-    const denom = Math.sqrt(nA) * Math.sqrt(nB);
-    return denom > 0 ? dot / denom : 0;
-}
-/**
- * Structural signal — normalised usage frequency.
- * Returns value / max(values), clamped to [0..1].
- */
-function normaliseUsage(usage, toolName) {
-    if (usage.size === 0)
-        return 0;
-    const value = usage.get(toolName) ?? 0;
-    if (value <= 0)
-        return 0;
-    let max = 0;
-    for (const v of usage.values())
-        if (v > max)
-            max = v;
-    return max > 0 ? Math.min(1, value / max) : 0;
-}
-// ---------------------------------------------------------------------------
-// Task 4 — Reasoning template
-// ---------------------------------------------------------------------------
-/**
- * Render a one-line, human-readable reason explaining why this tool was
- * picked. Falls back to a generic "general match" when no signal dominates.
- */
-export function generateReasoning(id, query, signals) {
-    const reasons = [];
-    if (signals.identity > 0) {
-        reasons.push("exact name match");
-    }
-    if (signals.lexical > 0.01 && signals.lexicalTokens.length > 0) {
-        const top = signals.lexicalTokens.slice(0, 3).join(", ");
-        reasons.push(`keywords: ${top}`);
-    }
-    if (signals.semantic >= 0.55) {
-        reasons.push("semantic similarity");
-    }
-    if (signals.structural >= 0.5) {
-        reasons.push("high usage frequency");
-    }
-    if (signals.framework > 0) {
-        reasons.push("relevant to project stack");
-    }
-    if (reasons.length === 0) {
-        // Fall back — still mention what was attempted.
-        const stem = query.trim().slice(0, 30) || id;
-        return `general match for "${stem}"`;
-    }
-    return reasons.join("; ");
-}
-// ---------------------------------------------------------------------------
-// Confidence calibration
-// ---------------------------------------------------------------------------
-const VAGUE_WORDS = new Set([
-    "help", "code", "find", "search", "what", "how", "show", "look",
-]);
-/**
- * Apply calibration rules that cap confidence for vague or ambiguous queries.
- * Returns the (possibly reduced) confidence for the top recommendation and
- * by extension all downstream confidences (scaled proportionally).
- */
-function calibrationCap(query, tokens, topScore, secondScore) {
-    const trimmed = query.trim();
-    const wordCount = trimmed.split(/\s+/).filter(Boolean).length;
-    // Rule 1 — vague query (all tokens in VAGUE_WORDS, or very short)
-    const allVague = tokens.length > 0 && tokens.every((t) => VAGUE_WORDS.has(t));
-    if (trimmed.length < 10 || allVague) {
-        return 0.5;
-    }
-    // Rule 2 — single-keyword query
-    if (wordCount === 1 || tokens.length <= 1) {
-        return 0.6;
-    }
-    // Rule 3 — low discrimination: top and runner-up are indistinguishable
-    if (topScore > 0 && topScore - secondScore < 0.1) {
-        return 0.4;
-    }
-    return 1.0; // no cap
-}
-// ---------------------------------------------------------------------------
-// Task 2 + 3 — rankTools
-// ---------------------------------------------------------------------------
-/**
- * Rank tools against a natural-language query by combining lexical, identity,
- * semantic, structural, and framework signals. Returns up to 10 `ToolRecommendation`
- * entries sorted by raw weighted score, with calibrated confidence values.
- *
- * Gracefully handles missing inputs:
- *   - no embeddings           → semantic contribution is 0
- *   - empty usageFrequency    → structural contribution is 0
- *   - empty frameworkTools    → framework contribution is 0
- */
-export function rankTools(ctx) {
-    const { query, toolDefs, embeddings, queryEmbedding, usageFrequency, frameworkTools } = ctx;
-    const coreToolNames = ctx.coreToolNames ?? new Set();
-    if (toolDefs.length === 0 || !query.trim())
-        return [];
-    const queryTokens = tokenizeText(query);
-    const frameworkSet = new Set(frameworkTools);
-    // --- Lexical (BM25) -------------------------------------------------
-    const index = buildToolBM25Index(toolDefs);
-    const lexical = computeLexical(query, index);
-    // --- Semantic (iterate ALL tools, not just BM25 candidates) --------
-    const semantic = new Map();
-    if (embeddings && queryEmbedding && queryEmbedding.length > 0) {
-        for (const def of toolDefs) {
-            const vec = embeddings.get(def.name);
-            if (!vec || vec.length === 0)
-                continue;
-            const sim = cosine(queryEmbedding, vec);
-            if (sim > 0)
-                semantic.set(def.name, sim);
-        }
-    }
-    const scored = [];
-    for (const def of toolDefs) {
-        const lex = lexical.get(def.name);
-        const lexScore = lex?.score ?? 0;
-        const lexTokens = lex?.matches ?? [];
-        const idScore = computeIdentity(query, def.name);
-        const semScore = semantic.get(def.name) ?? 0;
-        const strScore = normaliseUsage(usageFrequency, def.name);
-        const frameworkScore = frameworkSet.has(def.name) ? 1 : 0;
-        const raw = W_LEXICAL * lexScore +
-            W_IDENTITY * idScore +
-            W_SEMANTIC * semScore +
-            W_STRUCTURAL * strScore +
-            W_FRAMEWORK * frameworkScore;
-        if (raw <= 0)
-            continue;
-        scored.push({
-            def,
-            raw,
-            signals: {
-                lexical: lexScore,
-                identity: idScore,
-                semantic: semScore,
-                structural: strScore,
-                framework: frameworkScore,
-                lexicalTokens: lexTokens,
-            },
-        });
-    }
-    scored.sort((a, b) => b.raw - a.raw);
-    const top = scored.slice(0, MAX_RECOMMENDATIONS);
-    if (top.length === 0)
-        return [];
-    // --- Confidence normalisation + calibration ------------------------
-    const topRaw = top[0]?.raw ?? 0;
-    const secondRaw = top[1]?.raw ?? 0;
-    const cap = calibrationCap(query, queryTokens, topRaw, secondRaw);
-    const recommendations = top.map((s) => {
-        // Normalise raw → 0..1 via division by topRaw, then apply cap.
-        const normalised = topRaw > 0 ? s.raw / topRaw : 0;
-        const confidence = Math.max(0, Math.min(cap, normalised * cap));
-        const reasoning = generateReasoning(s.def.name, query, s.signals);
-        const isHidden = !coreToolNames.has(s.def.name);
-        const rec = {
-            name: s.def.name,
-            confidence: Math.round(confidence * 1000) / 1000,
-            reasoning,
-            is_hidden: isHidden,
-        };
-        return rec;
-    });
-    return recommendations;
-}
-// ---------------------------------------------------------------------------
-// Task 5 — Tool-embedding cache
-// ---------------------------------------------------------------------------
-const TOOL_EMBEDDING_CACHE_KEY = "__tool_descriptions__";
-/** Absolute path to the on-disk tool-embedding cache. */
-export function getToolEmbeddingCachePath() {
-    return join(homedir(), ".codesift", "tool-embeddings.ndjson");
-}
-async function readToolEmbeddingCache(path) {
-    try {
-        const raw = await readFile(path, "utf-8");
-        const parsed = JSON.parse(raw);
-        if (typeof parsed === "object" &&
-            parsed !== null &&
-            typeof parsed["fingerprint"] === "string" &&
-            typeof parsed["embeddings"] === "object") {
-            return parsed;
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-async function writeToolEmbeddingCache(path, cache) {
-    try {
-        await atomicWriteFile(path, JSON.stringify(cache));
-    }
-    catch {
-        // Cache write failures are non-fatal — ranker still works, just slower next call.
-    }
-}
-/**
- * Fetch (or compute) embeddings for every tool in `defs`. Uses the on-disk
- * cache when the fingerprint matches; otherwise regenerates via the configured
- * embedding provider and persists the result.
- *
- * Returns:
- *   - `Map<toolName, number[]>` on success
- *   - `null` when no embedding provider is configured (no API key) or the
- *     provider call fails — callers should degrade to non-semantic ranking.
- */
-export async function getToolEmbeddings(defs) {
-    if (defs.length === 0)
-        return new Map();
-    const config = loadConfig();
-    if (!config.embeddingProvider)
-        return null;
-    const fingerprint = toolDefsFingerprint(defs);
-    const cachePath = getToolEmbeddingCachePath();
-    const cached = await readToolEmbeddingCache(cachePath);
-    if (cached && cached.fingerprint === fingerprint) {
-        const m = new Map();
-        for (const [k, v] of Object.entries(cached.embeddings)) {
-            if (Array.isArray(v))
-                m.set(k, v);
-        }
-        return m;
-    }
-    // Regenerate via provider
-    try {
-        const provider = createEmbeddingProvider(config.embeddingProvider, config);
-        const texts = new Map();
-        for (const d of defs) {
-            const text = [d.name, d.description, d.searchHint ?? ""]
-                .filter(Boolean)
-                .join("\n");
-            texts.set(d.name, text);
-        }
-        const existing = new Map();
-        const result = await batchEmbed(texts, existing, (batch) => provider.embed(batch, "document"), config.embeddingBatchSize, TOOL_EMBEDDING_CACHE_KEY);
-        const out = new Map();
-        const recordForDisk = {};
-        for (const [name, vec] of result) {
-            const asArray = Array.from(vec);
-            out.set(name, asArray);
-            recordForDisk[name] = asArray;
-        }
-        await writeToolEmbeddingCache(cachePath, {
-            fingerprint,
-            embeddings: recordForDisk,
-        });
-        return out;
-    }
-    catch {
-        return null;
-    }
-}
+/** Public facade for tool ranking and its caches. */
+export { rankTools } from "./tool-ranker-orchestrator.js";
+export { generateReasoning } from "./tool-ranker-reasoning.js";
+export { buildToolBM25Index, clearToolBM25Cache, toolDefsFingerprint, } from "./tool-ranker-bm25.js";
+export { getToolEmbeddingCachePath, getToolEmbeddings, } from "./tool-embedding-cache.js";
 //# sourceMappingURL=tool-ranker.js.map

package/dist/search/tool-ranker.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ranker.js","sourceRoot":"","sources":["../../src/search/tool-ranker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-ranker.js","sourceRoot":"","sources":["../../src/search/tool-ranker.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/server-helpers/repo-resolution.d.ts

@@ -0,0 +1,45 @@
+interface RegistryRepoMeta {
+    name: string;
+    root: string;
+    symbol_count: number;
+    file_count: number;
+}
+/** Read registry synchronously, cached by mtime to avoid disk hits in the hot path. */
+export declare function loadRegistrySync(registryPath?: string): RegistryRepoMeta[];
+/** True iff `descendant` is `ancestor` or sits underneath it on a path-segment boundary. */
+export declare function isAncestorOrEqual(ancestor: string, descendant: string): boolean;
+/**
+ * Resolve the repo name for a CWD by consulting the registry.
+ *
+ * Strategy:
+ *  1. Drop chat-history indexes (`~/.claude/projects/...`) — they shadow real
+ *     repos when the AI session's CWD matches them as a sibling/ancestor.
+ *  2. Drop empty entries (symbol_count=0) — they're stub registrations from
+ *     `index_folder` calls that found nothing or got auto-created on cd.
+ *  3. From remaining repos whose `root` is an ancestor of `cwd`, pick the
+ *     longest match. This handles monorepo subdirs and worktrees correctly:
+ *     cwd=/repo/apps/api with root=/repo registered → resolves to /repo's name.
+ *  4. If nothing matches, fall back to `local/<basename(cwd)>` so the tool
+ *     surfaces a clear NOT INDEXED error instead of silently using a stale value.
+ */
+export declare function resolveRepoFromCwd(cwd: string, registryPath?: string): string;
+/**
+ * Canonicalize a repo name to its registered casing via a case-insensitive
+ * exact-name match. Agents frequently pass the on-disk basename casing
+ * (`local/Rewards-API`) while the repo is registered under its canonical
+ * name (`local/rewards-api`). Case-sensitive index getters — getBM25Index /
+ * ensureIndexFresh, which look up the registry with exact `getRepo` — then miss
+ * and the tool errors. Telemetry (2026-07): find_and_show failed 73/74 calls
+ * whose repo had an uppercase letter, and 0/532 lowercase calls.
+ *
+ * Only rewrites on a case-insensitive *exact* name match. Absolute paths, bare
+ * names, and unmatched inputs pass through untouched so the async
+ * resolveRegisteredRepoMeta fallbacks (absolute-path / suffix / basename) still
+ * apply downstream.
+ */
+export declare function canonicalizeRepoName(repoName: string, registryPath?: string): string;
+export declare function resolveToolRepoArgs(toolName: string, args: Record<string, unknown>): void;
+/** Test-only: drop the registry cache. */
+export declare function _resetRegistryCacheForTests(): void;
+export {};
+//# sourceMappingURL=repo-resolution.d.ts.map

package/dist/server-helpers/repo-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolution.d.ts","sourceRoot":"","sources":["../../src/server-helpers/repo-resolution.ts"],"names":[],"mappings":"AAaA,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,YAAY,GAAE,MAAsB,GAAG,gBAAgB,EAAE,CAmBzF;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAI/E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAsB,GAAG,MAAM,CAa5F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAAsB,GACnC,MAAM,CAUR;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAYzF;AAED,0CAA0C;AAC1C,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/server-helpers/repo-resolution.js

@@ -0,0 +1,113 @@
+import { readFileSync, statSync } from "node:fs";
+import { join, basename, isAbsolute, resolve, sep } from "node:path";
+import { homedir } from "node:os";
+// ---------------------------------------------------------------------------
+// Auto-resolve repo from CWD — eliminates mandatory list_repos on session start
+// ---------------------------------------------------------------------------
+/** Tools that accept a `repo` param and should auto-resolve from CWD */
+const TOOLS_WITHOUT_REPO = new Set(["list_repos", "index_folder", "index_repo", "index_conversations", "discover_tools", "describe_tools", "search_conversations", "search_all_conversations", "get_session_snapshot", "get_session_context", "usage_stats", "usage_hotspots", "usage_trace_session", "retros_list", "retros_analyze", "memory_candidate_extract", "optimization_candidates", "pope_insights_push_candidates", "test_tool"]);
+const REGISTRY_PATH = join(homedir(), ".codesift", "registry.json");
+const CONVERSATIONS_PREFIX = join(homedir(), ".claude", "projects") + sep;
+const registryCache = new Map();
+/** Read registry synchronously, cached by mtime to avoid disk hits in the hot path. */
+export function loadRegistrySync(registryPath = REGISTRY_PATH) {
+    try {
+        // Key the cache on the resolved path. The default is already absolute, so
+        // this changes nothing for production callers — it stops a relative path
+        // ("registry.json") from keying two different physical files to one entry
+        // once the process chdir's, which would serve repo A's registry for repo B.
+        const key = resolve(registryPath);
+        const st = statSync(key);
+        const cached = registryCache.get(key);
+        if (cached?.mtimeMs === st.mtimeMs) {
+            return cached.entries;
+        }
+        const parsed = JSON.parse(readFileSync(key, "utf-8"));
+        const entries = Object.values(parsed.repos ?? {});
+        registryCache.set(key, { mtimeMs: st.mtimeMs, entries });
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/** True iff `descendant` is `ancestor` or sits underneath it on a path-segment boundary. */
+export function isAncestorOrEqual(ancestor, descendant) {
+    if (ancestor === descendant)
+        return true;
+    const a = ancestor.endsWith(sep) ? ancestor : ancestor + sep;
+    return descendant.startsWith(a);
+}
+/**
+ * Resolve the repo name for a CWD by consulting the registry.
+ *
+ * Strategy:
+ *  1. Drop chat-history indexes (`~/.claude/projects/...`) — they shadow real
+ *     repos when the AI session's CWD matches them as a sibling/ancestor.
+ *  2. Drop empty entries (symbol_count=0) — they're stub registrations from
+ *     `index_folder` calls that found nothing or got auto-created on cd.
+ *  3. From remaining repos whose `root` is an ancestor of `cwd`, pick the
+ *     longest match. This handles monorepo subdirs and worktrees correctly:
+ *     cwd=/repo/apps/api with root=/repo registered → resolves to /repo's name.
+ *  4. If nothing matches, fall back to `local/<basename(cwd)>` so the tool
+ *     surfaces a clear NOT INDEXED error instead of silently using a stale value.
+ */
+export function resolveRepoFromCwd(cwd, registryPath = REGISTRY_PATH) {
+    const candidates = loadRegistrySync(registryPath).filter((r) => typeof r.root === "string" &&
+        !r.root.startsWith(CONVERSATIONS_PREFIX) &&
+        r.symbol_count > 0 &&
+        isAncestorOrEqual(r.root, cwd));
+    if (candidates.length === 0) {
+        return `local/${basename(cwd)}`;
+    }
+    candidates.sort((a, b) => b.root.length - a.root.length);
+    return candidates[0].name;
+}
+/**
+ * Canonicalize a repo name to its registered casing via a case-insensitive
+ * exact-name match. Agents frequently pass the on-disk basename casing
+ * (`local/Rewards-API`) while the repo is registered under its canonical
+ * name (`local/rewards-api`). Case-sensitive index getters — getBM25Index /
+ * ensureIndexFresh, which look up the registry with exact `getRepo` — then miss
+ * and the tool errors. Telemetry (2026-07): find_and_show failed 73/74 calls
+ * whose repo had an uppercase letter, and 0/532 lowercase calls.
+ *
+ * Only rewrites on a case-insensitive *exact* name match. Absolute paths, bare
+ * names, and unmatched inputs pass through untouched so the async
+ * resolveRegisteredRepoMeta fallbacks (absolute-path / suffix / basename) still
+ * apply downstream.
+ */
+export function canonicalizeRepoName(repoName, registryPath = REGISTRY_PATH) {
+    if (isAbsolute(repoName))
+        return repoName; // resolved by path downstream
+    const lower = repoName.toLowerCase();
+    let ciMatch = null;
+    for (const r of loadRegistrySync(registryPath)) {
+        if (typeof r.name !== "string")
+            continue;
+        if (r.name === repoName)
+            return repoName; // already canonical — fast path
+        if (ciMatch === null && r.name.toLowerCase() === lower)
+            ciMatch = r.name;
+    }
+    return ciMatch ?? repoName;
+}
+export function resolveToolRepoArgs(toolName, args) {
+    if (TOOLS_WITHOUT_REPO.has(toolName))
+        return;
+    const provided = args["repo"];
+    if (typeof provided === "string" && provided.length > 0) {
+        // Normalize caller-supplied casing so downstream case-sensitive getters and
+        // the response cache key all agree on the canonical name.
+        args["repo"] = canonicalizeRepoName(provided);
+        return;
+    }
+    if (!provided) {
+        args["repo"] = resolveRepoFromCwd(process.cwd());
+    }
+}
+/** Test-only: drop the registry cache. */
+export function _resetRegistryCacheForTests() {
+    registryCache.clear();
+}
+//# sourceMappingURL=repo-resolution.js.map

package/dist/server-helpers/repo-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolution.js","sourceRoot":"","sources":["../../src/server-helpers/repo-resolution.ts"],"names":[],"mappings":"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"}

package/dist/server-helpers/response-hints.d.ts

@@ -0,0 +1,9 @@
+/** Track sequential calls + session-level state. Exported for testing. */
+export declare function trackSequentialCalls(toolName: string): void;
+/**
+ * Build optimization hints based on response data + call patterns.
+ * Returns compact hint codes (decoded in CLAUDE.md).
+ */
+export declare function buildResponseHint(toolName: string, args: Record<string, unknown>, data: unknown): string | null;
+export declare function resetHintState(): void;
+//# sourceMappingURL=response-hints.d.ts.map

package/dist/server-helpers/response-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-hints.d.ts","sourceRoot":"","sources":["../../src/server-helpers/response-hints.ts"],"names":[],"mappings":"AAaA,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkB3D;AAmDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkJ/G;AAED,wBAAgB,cAAc,IAAI,IAAI,CAQrC"}