codebase-context 1.4.1 → 1.6.0

package/dist/core/reranker.js

@@ -0,0 +1,120 @@
+/**
+ * Stage-2 cross-encoder reranker for search results.
+ *
+ * Triggered by score ambiguity (clustered top scores), not by intent.
+ * Uses a lightweight cross-encoder to re-score (query, passage) pairs,
+ * converting high top-3 recall into better top-1 accuracy.
+ *
+ * Default model: Xenova/ms-marco-MiniLM-L-6-v2 (~22M params, ~80MB, CPU-safe).
+ */
+const DEFAULT_RERANKER_MODEL = 'Xenova/ms-marco-MiniLM-L-6-v2';
+/** How many top results to rerank (keeps latency bounded) */
+const RERANK_TOP_K = 10;
+/** Trigger reranking when the score gap between #1 and #3 is below this threshold */
+const AMBIGUITY_THRESHOLD = 0.08;
+let cachedTokenizer = null;
+let cachedModel = null;
+let initPromise = null;
+async function ensureModelLoaded() {
+    if (cachedModel && cachedTokenizer)
+        return;
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        const { AutoTokenizer, AutoModelForSequenceClassification } = await import('@huggingface/transformers');
+        console.error(`[reranker] Loading cross-encoder: ${DEFAULT_RERANKER_MODEL}`);
+        console.error('[reranker] (First run will download the model — this may take a moment)');
+        cachedTokenizer = await AutoTokenizer.from_pretrained(DEFAULT_RERANKER_MODEL);
+        cachedModel = await AutoModelForSequenceClassification.from_pretrained(DEFAULT_RERANKER_MODEL, {
+            dtype: 'q8'
+        });
+        console.error('[reranker] Cross-encoder loaded successfully');
+    })();
+    return initPromise;
+}
+/**
+ * Build a compact passage from a search result for cross-encoder scoring.
+ * Keeps it short — cross-encoders are slow on long inputs.
+ */
+function buildPassage(result) {
+    const parts = [];
+    // File path is critical signal
+    parts.push(`path: ${result.filePath.replace(/\\/g, '/')}`);
+    // Component type / layer if available
+    if (result.componentType && result.componentType !== 'unknown') {
+        parts.push(`type: ${result.componentType}`);
+    }
+    if (result.layer && result.layer !== 'unknown') {
+        parts.push(`layer: ${result.layer}`);
+    }
+    // Summary is the most information-dense field
+    if (result.summary) {
+        parts.push(result.summary);
+    }
+    // Snippet: first ~500 chars (cross-encoder has 512-token context)
+    if (result.snippet) {
+        const trimmed = result.snippet.slice(0, 500);
+        parts.push(trimmed);
+    }
+    return parts.join('\n');
+}
+/**
+ * Score a single (query, passage) pair using the cross-encoder.
+ * Returns a relevance score (higher = more relevant).
+ */
+async function scorePair(query, passage) {
+    const inputs = cachedTokenizer(query, passage, {
+        padding: true,
+        truncation: true,
+        max_length: 512
+    });
+    const output = await cachedModel(inputs);
+    // Cross-encoder outputs a single logit for relevance
+    const score = output.logits.data[0];
+    return score;
+}
+/**
+ * Detect whether the result set has ambiguous ordering.
+ * Returns true when the top scores are clustered, meaning
+ * the embedding model isn't confident about the ranking.
+ */
+export function isAmbiguous(results) {
+    if (results.length < 3)
+        return false;
+    const topScore = results[0].score;
+    const thirdScore = results[Math.min(2, results.length - 1)].score;
+    const gap = topScore - thirdScore;
+    return gap < AMBIGUITY_THRESHOLD;
+}
+/**
+ * Rerank the top-K results using a cross-encoder.
+ * Only reranks when scores are ambiguous (clustered).
+ * Returns the full result array with the top-K portion re-ordered.
+ */
+export async function rerank(query, results) {
+    if (results.length <= 1)
+        return results;
+    if (!isAmbiguous(results))
+        return results;
+    await ensureModelLoaded();
+    const toRerank = results.slice(0, Math.min(RERANK_TOP_K, results.length));
+    const rest = results.slice(toRerank.length);
+    // Score each result against the query using the cross-encoder
+    const scored = [];
+    for (const result of toRerank) {
+        const passage = buildPassage(result);
+        const crossScore = await scorePair(query, passage);
+        scored.push({ result, crossScore });
+    }
+    // Sort by cross-encoder score (descending)
+    scored.sort((a, b) => b.crossScore - a.crossScore);
+    // Rebuild the result array: reranked top-K + unchanged rest
+    // Sigmoid normalizes raw logits to [0,1] so downstream quality gating works
+    const sigmoid = (x) => 1 / (1 + Math.exp(-x));
+    const reranked = scored.map(({ result, crossScore }) => ({
+        ...result,
+        score: sigmoid(crossScore)
+    }));
+    return [...reranked, ...rest];
+}
+//# sourceMappingURL=reranker.js.map

package/dist/core/reranker.js.map

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

package/dist/core/search-quality.d.ts

@@ -0,0 +1,10 @@
+import type { SearchResult } from '../types/index.js';
+export interface SearchQualityAssessment {
+    status: 'ok' | 'low_confidence';
+    confidence: number;
+    signals: string[];
+    nextSteps?: string[];
+}
+export declare function isTestArtifactPath(filePath: string): boolean;
+export declare function assessSearchQuality(query: string, results: SearchResult[]): SearchQualityAssessment;
+//# sourceMappingURL=search-quality.d.ts.map

package/dist/core/search-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-quality.d.ts","sourceRoot":"","sources":["../../src/core/search-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,IAAI,GAAG,gBAAgB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ5D;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,EAAE,GACtB,uBAAuB,CA2DzB"}

package/dist/core/search-quality.js

@@ -0,0 +1,64 @@
+import { isTestingRelatedQuery } from '../preflight/query-scope.js';
+export function isTestArtifactPath(filePath) {
+    const normalized = filePath.toLowerCase().replace(/\\/g, '/');
+    return (normalized.includes('.spec.') ||
+        normalized.includes('.test.') ||
+        normalized.includes('/e2e/') ||
+        normalized.includes('/__tests__/'));
+}
+export function assessSearchQuality(query, results) {
+    if (results.length === 0) {
+        return {
+            status: 'low_confidence',
+            confidence: 0,
+            signals: ['no results returned'],
+            nextSteps: [
+                'Try a narrower query with one concrete symbol, route, or file hint.',
+                'Apply search filters (framework/language/componentType/layer).',
+                'Use get_component_usage for dependency or wiring lookups.'
+            ]
+        };
+    }
+    const topSlice = results.slice(0, Math.min(3, results.length));
+    const topScore = results[0].score;
+    const secondScore = results[1]?.score ?? topScore;
+    const topAverage = topSlice.reduce((sum, result) => sum + result.score, 0) / topSlice.length;
+    const topSeparation = Math.max(0, topScore - secondScore);
+    const testRatio = topSlice.filter((result) => isTestArtifactPath(result.filePath)).length / topSlice.length;
+    const queryIsTesting = isTestingRelatedQuery(query);
+    const signals = [];
+    if (topScore < 0.3) {
+        signals.push(`low top score (${topScore.toFixed(2)})`);
+    }
+    if (topAverage < 0.32) {
+        signals.push(`weak top-${topSlice.length} average (${topAverage.toFixed(2)})`);
+    }
+    if (topSlice.length > 1 && topSeparation < 0.03) {
+        signals.push(`tight top spread (${topSeparation.toFixed(2)})`);
+    }
+    if (!queryIsTesting && testRatio >= 0.67) {
+        signals.push(`test artifacts dominate top-${topSlice.length} (${Math.round(testRatio * 100)}%)`);
+    }
+    let confidence = topScore;
+    if (topAverage < 0.32)
+        confidence -= 0.08;
+    if (topSlice.length > 1 && topSeparation < 0.03)
+        confidence -= 0.05;
+    if (!queryIsTesting && testRatio >= 0.67)
+        confidence -= 0.15;
+    confidence = Math.max(0, Math.min(1, Number(confidence.toFixed(2))));
+    const lowConfidence = signals.length >= 2 || confidence < 0.35;
+    return {
+        status: lowConfidence ? 'low_confidence' : 'ok',
+        confidence,
+        signals,
+        ...(lowConfidence && {
+            nextSteps: [
+                'Add one or two concrete symbols, routes, or file hints to the query.',
+                'Apply filters (framework/language/componentType/layer) to narrow candidates.',
+                'Use get_component_usage when the question is about wiring or usages.'
+            ]
+        })
+    };
+}
+//# sourceMappingURL=search-quality.js.map

package/dist/core/search-quality.js.map

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

package/dist/core/search.d.ts

@@ -7,7 +7,14 @@ export interface SearchOptions {
     useKeywordSearch?: boolean;
     semanticWeight?: number;
     keywordWeight?: number;
+    profile?: SearchIntentProfile;
+    enableQueryExpansion?: boolean;
+    enableLowConfidenceRescue?: boolean;
+    candidateFloor?: number;
+    /** Enable stage-2 cross-encoder reranking when top scores are ambiguous. Default: true. */
+    enableReranker?: boolean;
 }
+export type SearchIntentProfile = 'explore' | 'edit' | 'refactor' | 'migrate';
 export declare class CodebaseSearcher {
     private rootPath;
     private storagePath;
@@ -17,17 +24,34 @@ export declare class CodebaseSearcher {
     private storageProvider;
     private initialized;
     private patternIntelligence;
+    private importCentrality;
     constructor(rootPath: string);
     initialize(): Promise<void>;
     private loadKeywordIndex;
     /**
-     * v1.2: Load pattern intelligence for trend detection and warnings
+     * Load pattern intelligence for trend detection and warnings
      */
     private loadPatternIntelligence;
     /**
-     * v1.2: Detect pattern trend from chunk content
+     * Detect pattern trend from chunk content
      */
     private detectChunkTrend;
+    private isTestFile;
+    private normalizeQueryTerms;
+    /**
+     * Classify query intent based on heuristic patterns
+     */
+    private classifyQueryIntent;
+    private buildQueryVariants;
+    private isTemplateOrStyleFile;
+    private isCompositionRootFile;
+    private queryPathTokenOverlap;
+    private isLikelyWiringOrFlowQuery;
+    private isActionOrHowQuery;
+    private isDefinitionHeavyResult;
+    private scoreAndSortResults;
+    private pickBetterResultSet;
+    private collectHybridMatches;
     search(query: string, limit?: number, filters?: SearchFilters, options?: SearchOptions): Promise<SearchResult[]>;
     private generateSummary;
     private generateSnippet;

package/dist/core/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAa,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAY3E,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AASD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,eAAe,CAAsC;IAE7D,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,mBAAmB,CAIX;gBAEJ,QAAQ,EAAE,MAAM;IAKtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAsBnB,gBAAgB;IA4B9B;;OAEG;YACW,uBAAuB;IAsDrC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BlB,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,EACjB,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,GAAE,aAAsC,GAC9C,OAAO,CAAC,YAAY,EAAE,CAAC;IAiH1B,OAAO,CAAC,eAAe;IAiDvB,OAAO,CAAC,eAAe;YAWT,cAAc;YAmBd,aAAa;IA4E3B,OAAO,CAAC,uBAAuB;IAoBzB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAOtC,OAAO,IAAI,OAAO;CAGnB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAa,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAe3E,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AA0E9E,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,eAAe,CAAsC;IAE7D,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,mBAAmB,CAIX;IAEhB,OAAO,CAAC,gBAAgB,CAAoC;gBAEhD,QAAQ,EAAE,MAAM;IAKtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAsBnB,gBAAgB;IA4B9B;;OAEG;YACW,uBAAuB;IA8ErC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqE3B,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,mBAAmB;IAwP3B,OAAO,CAAC,mBAAmB;YAuBb,oBAAoB;IAkF5B,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,EACjB,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,GAAE,aAAsC,GAC9C,OAAO,CAAC,YAAY,EAAE,CAAC;IAoG1B,OAAO,CAAC,eAAe;IAiDvB,OAAO,CAAC,eAAe;YAWT,cAAc;YAmBd,aAAa;IA4E3B,OAAO,CAAC,uBAAuB;IAoBzB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAOtC,OAAO,IAAI,OAAO;CAGnB"}