codesift-mcp 0.9.0 → 0.9.10

package/dist/tools/plan-turn/recommendations.js

@@ -0,0 +1,93 @@
+import { CORE_TOOL_NAMES } from "../../register-tools.js";
+export const MAX_TOOLS = 10;
+export const MAX_SYMBOLS = 20;
+export const MAX_FILES = 10;
+export function buildUnindexedResult(query, startedAt, truncated = false) {
+    const indexFolderRecommendation = {
+        name: "index_folder",
+        confidence: 1.0,
+        reasoning: "Repo is not indexed — run index_folder before any query tools",
+        is_hidden: !CORE_TOOL_NAMES.has("index_folder"),
+    };
+    return {
+        query,
+        truncated,
+        confidence: 1.0,
+        tools: [indexFolderRecommendation],
+        symbols: [],
+        files: [],
+        reveal_required: indexFolderRecommendation.is_hidden ? [indexFolderRecommendation.name] : [],
+        already_used: [],
+        metadata: {
+            intents_detected: 0,
+            bm25_candidates: 0,
+            embedding_available: false,
+            session_queries_seen: 0,
+            duration_ms: Date.now() - startedAt,
+            unindexed: true,
+            cold_start: true,
+            ...(truncated ? { truncated: true } : {}),
+        },
+    };
+}
+export function mergeToolRecommendations(batches) {
+    const recommendationsByName = new Map();
+    for (const batch of batches) {
+        for (const recommendation of batch) {
+            const existing = recommendationsByName.get(recommendation.name);
+            if (!existing || recommendation.confidence > existing.confidence) {
+                recommendationsByName.set(recommendation.name, recommendation);
+            }
+        }
+    }
+    return [...recommendationsByName.values()].sort((a, b) => b.confidence - a.confidence);
+}
+export function collectSymbolRecommendations(parsed, index) {
+    if (parsed.symbol_refs.length === 0)
+        return [];
+    const recommendationsByName = new Map();
+    const wantedNames = new Set(parsed.symbol_refs);
+    for (const symbol of index.symbols) {
+        if (!wantedNames.has(symbol.name) || recommendationsByName.has(symbol.name))
+            continue;
+        recommendationsByName.set(symbol.name, {
+            name: symbol.name,
+            file: symbol.file,
+            line: symbol.start_line,
+            kind: symbol.kind,
+            score: 1.0,
+        });
+        if (recommendationsByName.size >= MAX_SYMBOLS)
+            break;
+    }
+    return [...recommendationsByName.values()];
+}
+export function collectFileRecommendations(parsed, index) {
+    if (parsed.file_refs.length === 0)
+        return [];
+    const recommendations = [];
+    const seen = new Set();
+    const wantedFiles = new Set(parsed.file_refs.slice(0, MAX_FILES));
+    const indexedFiles = new Set();
+    for (const file of index.files) {
+        if (wantedFiles.has(file.path))
+            indexedFiles.add(file.path);
+        if (indexedFiles.size === wantedFiles.size)
+            break;
+    }
+    for (const fileReference of parsed.file_refs) {
+        if (seen.has(fileReference))
+            continue;
+        seen.add(fileReference);
+        const isIndexed = indexedFiles.has(fileReference);
+        recommendations.push({
+            path: fileReference,
+            score: isIndexed ? 1.0 : 0.5,
+            reason: isIndexed ? "explicit file reference" : "referenced in query",
+        });
+        if (recommendations.length >= MAX_FILES)
+            break;
+    }
+    return recommendations;
+}
+//# sourceMappingURL=recommendations.js.map

package/dist/tools/plan-turn/recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../../src/tools/plan-turn/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK1D,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,SAAiB,EACjB,SAAS,GAAG,KAAK;IAEjB,MAAM,yBAAyB,GAAuB;QACpD,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,+DAA+D;QAC1E,SAAS,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC;KAChD,CAAC;IACF,OAAO;QACL,KAAK;QACL,SAAS;QACT,UAAU,EAAE,GAAG;QACf,KAAK,EAAE,CAAC,yBAAyB,CAAC;QAClC,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,eAAe,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QAC5F,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE;YACR,gBAAgB,EAAE,CAAC;YACnB,eAAe,EAAE,CAAC;YAClB,mBAAmB,EAAE,KAAK;YAC1B,oBAAoB,EAAE,CAAC;YACvB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,IAAI;YAChB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA+B;IAE/B,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAA8B,CAAC;IACpE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,MAAM,cAAc,IAAI,KAAK,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAChE,IAAI,CAAC,QAAQ,IAAI,cAAc,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACjE,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,MAAmB,EACnB,KAAgB;IAEhB,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,SAAS;QACtF,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;QACH,IAAI,qBAAqB,CAAC,IAAI,IAAI,WAAW;YAAE,MAAM;IACvD,CAAC;IACD,OAAO,CAAC,GAAG,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAmB,EACnB,KAAgB;IAEhB,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,eAAe,GAAyB,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,YAAY,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI;YAAE,MAAM;IACpD,CAAC;IACD,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;YAAE,SAAS;QACtC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxB,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClD,eAAe,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;YAC5B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,qBAAqB;SACtE,CAAC,CAAC;QACH,IAAI,eAAe,CAAC,MAAM,IAAI,SAAS;YAAE,MAAM;IACjD,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/tools/plan-turn/stale-index.d.ts

@@ -0,0 +1,4 @@
+import type { CodeIndex } from "../../types.js";
+export declare function safeReadGitHead(repoRoot: string): string | null;
+export declare function isStaleIndex(index: CodeIndex, lastGitCommit: string | undefined): boolean;
+//# sourceMappingURL=stale-index.d.ts.map

package/dist/tools/plan-turn/stale-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-index.d.ts","sourceRoot":"","sources":["../../../src/tools/plan-turn/stale-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOhD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAOT"}

package/dist/tools/plan-turn/stale-index.js

@@ -0,0 +1,17 @@
+import { getCurrentGitCommit } from "../../utils/git-head.js";
+const STALE_INDEX_TIME_FALLBACK_MS = 24 * 60 * 60 * 1000;
+const GIT_HEAD_TIMEOUT_MS = 1500;
+const FULL_GIT_SHA_RE = /^[0-9a-f]{40}$/;
+export function safeReadGitHead(repoRoot) {
+    const head = getCurrentGitCommit(repoRoot, GIT_HEAD_TIMEOUT_MS);
+    return head !== null && FULL_GIT_SHA_RE.test(head) ? head : null;
+}
+export function isStaleIndex(index, lastGitCommit) {
+    const headSha = safeReadGitHead(index.root);
+    if (headSha !== null && lastGitCommit !== undefined) {
+        return headSha !== lastGitCommit;
+    }
+    const indexAgeMs = Date.now() - (index.updated_at ?? index.created_at ?? 0);
+    return indexAgeMs > STALE_INDEX_TIME_FALLBACK_MS;
+}
+//# sourceMappingURL=stale-index.js.map

package/dist/tools/plan-turn/stale-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-index.js","sourceRoot":"","sources":["../../../src/tools/plan-turn/stale-index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,4BAA4B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACzD,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAChE,OAAO,IAAI,KAAK,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAgB,EAChB,aAAiC;IAEjC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO,OAAO,KAAK,aAAa,CAAC;IACnC,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAC5E,OAAO,UAAU,GAAG,4BAA4B,CAAC;AACnD,CAAC"}

package/dist/tools/plan-turn/types.d.ts

@@ -0,0 +1,61 @@
+import type { ToolRecommendation } from "../../search/tool-ranker.js";
+import type { SymbolKind } from "../../types.js";
+export interface ParsedQuery {
+    original: string;
+    normalized: string;
+    truncated: boolean;
+    intents: string[];
+    file_refs: string[];
+    symbol_refs: string[];
+    is_vague: boolean;
+}
+export interface SymbolRecommendation {
+    name: string;
+    file: string;
+    line: number;
+    kind: SymbolKind;
+    score: number;
+}
+export interface FileRecommendation {
+    path: string;
+    score: number;
+    reason: "explicit file reference" | "referenced in query";
+}
+export interface GapAnalysis {
+    action: "STOP_AND_REPORT_GAP";
+    prior_query: string;
+    prior_result_count: number;
+    suggestion: string;
+}
+export interface PlanTurnMetadata {
+    intents_detected: number;
+    bm25_candidates: number;
+    embedding_available: boolean;
+    session_queries_seen: number;
+    duration_ms: number;
+    truncated?: boolean;
+    vague_query?: boolean;
+    stale_index?: boolean;
+    low_discrimination?: boolean;
+    framework_mismatch?: boolean;
+    cold_start?: boolean;
+    unindexed?: boolean;
+}
+export interface PlanTurnResult {
+    query: string;
+    truncated: boolean;
+    confidence: number;
+    tools: ToolRecommendation[];
+    symbols: SymbolRecommendation[];
+    files: FileRecommendation[];
+    reveal_required: string[];
+    already_used: string[];
+    gap_analysis?: GapAnalysis;
+    framework_context?: string;
+    metadata: PlanTurnMetadata;
+}
+export interface PlanTurnOptions {
+    max_results?: number;
+    skip_session?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/plan-turn/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/plan-turn/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,yBAAyB,GAAG,qBAAqB,CAAC;CAC3D;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/tools/plan-turn/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/plan-turn/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/plan-turn/types.ts"],"names":[],"mappings":""}

package/dist/tools/plan-turn-tools.d.ts

@@ -1,113 +1,10 @@
 /**
- * plan-turn-tools.ts — Query parser + main handler for plan/turn routing.
- *
- * Parser (Task 6):
- *   - Normalisation (lowercase, trim, 1000-char cap)
- *   - Multi-intent split on "and / or / ; / &&" with surrounding whitespace
- *   - File ref extraction (extensions: ts/tsx/js/jsx/py/go/rs/php/kt/sql)
- *   - Symbol ref extraction (cross-referenced against index.symbols)
- *   - Vague detection (short query with no domain keywords)
- *
- * Handler (Task 7) — `planTurn`:
- *   1. Guards against missing index → returns structured error
- *   2. Parses query via parseQuery
- *   3. Checks negative evidence → returns STOP_AND_REPORT_GAP early
- *   4. Builds ranker context (usage freq, framework tools, embeddings)
- *   5. Runs rankTools per intent, merges results
- *   6. Dedups against session.queries (top-3 retained)
- *   7. Collects hidden tool names for reveal_required[]
- *   8. Populates metadata flags (stale_index, framework_mismatch, cold_start…)
- */
-import { type ToolRecommendation } from "../search/tool-ranker.js";
-import type { CodeIndex } from "../types.js";
-export interface ParsedQuery {
-    original: string;
-    normalized: string;
-    truncated: boolean;
-    intents: string[];
-    file_refs: string[];
-    symbol_refs: string[];
-    is_vague: boolean;
-}
-export declare function parseQuery(raw: string, index: CodeIndex): ParsedQuery;
-export interface SymbolRecommendation {
-    name: string;
-    file: string;
-    line: number;
-    kind: string;
-    score: number;
-}
-export interface FileRecommendation {
-    path: string;
-    score: number;
-    reason: string;
-}
-export interface GapAnalysis {
-    action: "STOP_AND_REPORT_GAP";
-    prior_query: string;
-    prior_result_count: number;
-    suggestion: string;
-}
-export interface PlanTurnMetadata {
-    intents_detected: number;
-    bm25_candidates: number;
-    embedding_available: boolean;
-    session_queries_seen: number;
-    duration_ms: number;
-    truncated?: boolean;
-    vague_query?: boolean;
-    stale_index?: boolean;
-    low_discrimination?: boolean;
-    framework_mismatch?: boolean;
-    cold_start?: boolean;
-    unindexed?: boolean;
-}
-export interface PlanTurnResult {
-    query: string;
-    truncated: boolean;
-    confidence: number;
-    tools: ToolRecommendation[];
-    symbols: SymbolRecommendation[];
-    files: FileRecommendation[];
-    reveal_required: string[];
-    already_used: string[];
-    gap_analysis?: GapAnalysis;
-    framework_context?: string;
-    metadata: PlanTurnMetadata;
-}
-/** Test-only reset of module caches. */
-export declare function _resetPlanTurnCaches(): void;
-/**
- * Return the current `git rev-parse HEAD` SHA for `repoRoot`, or `null` if the
- * directory isn't a git checkout / git isn't available / spawn times out.
- *
- * Synchronous + bounded (timeout 1500ms) because `plan_turn` is the front-door
- * routing tool — p99 budget is a few hundred ms. Real-world cost on warm git
- * caches is ~5–15 ms. Failures are silent on purpose; the caller falls back
- * to the time-based stale check.
- */
-export declare function safeReadGitHead(repoRoot: string): string | null;
-/**
- * Decide whether the in-memory index has drifted from the live repository.
- *
- * Source-of-truth priority:
- *   1. `git rev-parse HEAD` vs registry's `last_git_commit` — definitive when
- *      both are available; flips true iff the HEAD has moved.
- *   2. Time-based fallback (24 h) — only when git is unavailable, so we don't
- *      go fully silent on non-git repos or after `git` spawn failures.
- *
- * Notably we no longer flip true after 5 min of agent idle — that was the
- * historical behavior and produced false positives in read-mostly sessions
- * (audits, plans, explorations) where the index was perfectly in sync.
- */
-export declare function isStaleIndex(index: CodeIndex, lastGitCommit: string | undefined): boolean;
-export declare function planTurn(repo: string, query: string, options?: {
-    max_results?: number;
-    skip_session?: boolean;
-}): Promise<PlanTurnResult>;
-/**
- * Format a PlanTurnResult as a human-readable markdown-style string.
- * Edge-case: if no tools, injects a discover_tools fallback.
- */
-export declare function formatPlanTurnResult(result: PlanTurnResult): string;
+ * Stable public facade for plan-turn parsing, routing, and formatting.
+ * Keep this exact module path for lazy MCP registration and test mocks.
+ */
+export { parseQuery } from "./plan-turn/query-parser.js";
+export { _resetPlanTurnCaches, planTurn } from "./plan-turn/orchestrator.js";
+export { safeReadGitHead, isStaleIndex } from "./plan-turn/stale-index.js";
+export { formatPlanTurnResult } from "./plan-turn/formatter.js";
+export type { FileRecommendation, GapAnalysis, ParsedQuery, PlanTurnMetadata, PlanTurnResult, SymbolRecommendation, } from "./plan-turn/types.js";
 //# sourceMappingURL=plan-turn-tools.d.ts.map

package/dist/tools/plan-turn-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-turn-tools.d.ts","sourceRoot":"","sources":["../../src/tools/plan-turn-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-turn-tools.d.ts","sourceRoot":"","sources":["../../src/tools/plan-turn-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}