lsp-intelligence 0.1.2 → 0.2.1

package/dist/search/query/compileEffectiveSearchSpec.js.map

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

package/dist/search/query/parseQuery.d.ts

@@ -0,0 +1,10 @@
+import type { QueryIR, SearchPlan } from '../types.js';
+/**
+ * Parse a raw query string into a structured QueryIR.
+ * Extracts three channels: NL tokens, exact identifiers, structural cues.
+ */
+export declare function parseQuery(raw: string, opts?: {
+    forcedMode?: SearchPlan['mode'] | 'auto';
+    forcedFamily?: string;
+    forcedFocus?: 'auto' | 'implementation' | 'usage' | 'pattern' | 'config';
+}): QueryIR;

package/dist/search/query/parseQuery.js

@@ -0,0 +1,284 @@
+import { scoreFamilies } from '../families/behaviorFamilies.js';
+import { applyPhraseRules } from './phraseRules.js';
+// Short family names (from find_code schema) → real family IDs
+const FAMILY_ALIASES = {
+    auth: 'auth_permission',
+    errors: 'error_handling',
+    state: 'state_management',
+    flags: 'feature_flags',
+    retry: 'retry_backoff',
+    validation: 'validation',
+    fetching: 'fetching',
+    caching: 'caching',
+};
+// Structural cue words — preserved, NOT removed as stop words
+const STRUCTURAL_CUES = new Set([
+    'conditional', 'conditionally', 'if', 'return', 'returns', 'cleanup',
+    'callback', 'without', 'inside', 'nested', 'loop', 'async', 'await',
+    'try', 'catch', 'switch', 'default', 'throw', 'promise',
+]);
+// NL stop words — only removed from the NL channel
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'can', 'shall', 'to', 'of', 'in', 'for',
+    'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
+    'where', 'how', 'what', 'which', 'who', 'when', 'why',
+    'all', 'each', 'every', 'both', 'few', 'more', 'most', 'other',
+    'some', 'such', 'no', 'not', 'only', 'own', 'same', 'so', 'than',
+    'too', 'very', 'just', 'we', 'they', 'i', 'my', 'our', 'that',
+    'this', 'these', 'those', 'me', 'him', 'her', 'it', 'its',
+]);
+// Identifier pattern: camelCase, PascalCase, dotted (Promise.all, React.useEffect)
+const IDENTIFIER_PATTERN = /\b([A-Z][a-zA-Z0-9]*(?:\.[a-zA-Z][a-zA-Z0-9]*)*|[a-z][a-zA-Z0-9]*(?:\.[a-zA-Z][a-zA-Z0-9]*)*)\b/g;
+// Hook name pattern
+const HOOK_PATTERN = /^use[A-Z]/;
+// Structural predicate mapping from cue words
+const PREDICATE_MAP = {
+    conditional: ['conditional'],
+    conditionally: ['conditional'],
+    if: ['conditional'],
+    return: [], // phrase-based: only fires in combination (returns + cleanup, etc.)
+    returns: [], // phrase-based: only fires in combination
+    cleanup: [], // phrase-based: returns + cleanup → returns-cleanup
+    callback: [], // phrase-based: callback + hook identifier → hook-callback
+    try: ['has-try-catch'],
+    catch: ['has-try-catch'],
+    without: [], // modifier — inverts next predicate
+    loop: ['await-in-loop'],
+    switch: ['switch-no-default'],
+    default: ['switch-no-default'],
+    hook: ['inside-hook'],
+    nested: [],
+    async: [],
+    await: ['await-in-loop'],
+    promise: [],
+    throw: [],
+};
+/**
+ * Parse a raw query string into a structured QueryIR.
+ * Extracts three channels: NL tokens, exact identifiers, structural cues.
+ */
+export function parseQuery(raw, opts) {
+    const words = raw.split(/\s+/).filter(Boolean);
+    // --- Channel 1: Exact identifiers ---
+    const exactIdentifiers = [];
+    const dottedIdentifiers = [];
+    for (const word of words) {
+        const clean = word.replace(/[^a-zA-Z0-9.]/g, '');
+        if (!clean)
+            continue;
+        // Dotted identifier: Promise.all, React.useEffect
+        if (clean.includes('.') && /^[A-Za-z]/.test(clean)) {
+            dottedIdentifiers.push(clean);
+            continue;
+        }
+        // CamelCase/PascalCase identifier (not a plain lowercase word)
+        if (/^[A-Z]/.test(clean) || (HOOK_PATTERN.test(clean)) || (/[a-z][A-Z]/.test(clean) && clean.length > 3)) {
+            exactIdentifiers.push(clean);
+        }
+    }
+    // --- Channel 2: Structural cues ---
+    const structuralPredicates = [];
+    const codeTokens = [];
+    const hasWithout = words.some((w) => w.toLowerCase() === 'without');
+    for (const word of words) {
+        const lower = word.toLowerCase().replace(/[^a-z]/g, '');
+        if (STRUCTURAL_CUES.has(lower)) {
+            codeTokens.push(lower);
+            const preds = PREDICATE_MAP[lower] ?? [];
+            for (const pred of preds) {
+                // Handle "without" modifier
+                if (hasWithout && pred === 'returns-cleanup') {
+                    if (!structuralPredicates.includes('no-cleanup'))
+                        structuralPredicates.push('no-cleanup');
+                }
+                else if (hasWithout && pred === 'has-try-catch') {
+                    if (!structuralPredicates.includes('no-try-catch'))
+                        structuralPredicates.push('no-try-catch');
+                }
+                else {
+                    if (!structuralPredicates.includes(pred))
+                        structuralPredicates.push(pred);
+                }
+            }
+        }
+    }
+    // Phrase-based structural inference — requires combinations, not isolated keywords.
+    // This prevents "returns" alone from implying returns-function.
+    const hasHookId = exactIdentifiers.some((id) => HOOK_PATTERN.test(id));
+    if (codeTokens.includes('cleanup')) {
+        if (codeTokens.includes('returns') || codeTokens.includes('return')) {
+            // "returns cleanup" or "return cleanup"
+            if (hasWithout) {
+                if (!structuralPredicates.includes('no-cleanup'))
+                    structuralPredicates.push('no-cleanup');
+            }
+            else {
+                if (!structuralPredicates.includes('returns-cleanup'))
+                    structuralPredicates.push('returns-cleanup');
+            }
+        }
+        else if (hasWithout) {
+            // "without cleanup" (no returns keyword needed)
+            if (!structuralPredicates.includes('no-cleanup'))
+                structuralPredicates.push('no-cleanup');
+        }
+    }
+    if (codeTokens.includes('returns') || codeTokens.includes('return')) {
+        if (codeTokens.includes('callback') || hasHookId) {
+            // "returns callback" or "useEffect ... returns"
+            if (!structuralPredicates.includes('returns-function'))
+                structuralPredicates.push('returns-function');
+        }
+    }
+    if (codeTokens.includes('callback') && hasHookId) {
+        // "useEffect callback" — hook + callback together
+        if (!structuralPredicates.includes('hook-callback'))
+            structuralPredicates.push('hook-callback');
+    }
+    // Hook identifier + any structural predicates → add hook-callback context
+    if (hasHookId && structuralPredicates.length > 0) {
+        if (!structuralPredicates.includes('hook-callback')) {
+            structuralPredicates.push('hook-callback');
+        }
+    }
+    // --- Channel 3: NL tokens ---
+    const nlTokens = [];
+    for (const word of words) {
+        const lower = word.toLowerCase().replace(/[^a-z]/g, '');
+        if (!lower || lower.length < 2)
+            continue;
+        if (STOP_WORDS.has(lower))
+            continue;
+        // Don't add exact identifiers to NL channel
+        if (exactIdentifiers.includes(word) || dottedIdentifiers.includes(word))
+            continue;
+        nlTokens.push(lower);
+    }
+    // --- Phrases ---
+    const phrases = extractPhrases(raw);
+    // --- Family scoring ---
+    const allTerms = [...nlTokens, ...codeTokens];
+    let familyScores = scoreFamilies(allTerms);
+    // Apply forced family (resolve short alias → real ID)
+    if (opts?.forcedFamily) {
+        const resolvedFamily = FAMILY_ALIASES[opts.forcedFamily] ?? opts.forcedFamily;
+        familyScores[resolvedFamily] = (familyScores[resolvedFamily] ?? 0) + 10;
+    }
+    // --- Focus → internal mode/trait mapping ---
+    // The public API uses 'focus' instead of 'mode'/'family'. Map it to internals.
+    if (opts?.forcedFocus && opts.forcedFocus !== 'auto') {
+        switch (opts.forcedFocus) {
+            case 'usage':
+                opts.forcedMode = 'identifier';
+                break;
+            case 'implementation':
+                opts.forcedMode = 'behavior';
+                break;
+            case 'pattern':
+                opts.forcedMode = 'structural';
+                break;
+            case 'config':
+                // Config focus doesn't map to a mode — it activates the config trait
+                // (handled in traits section below)
+                break;
+        }
+    }
+    // --- Mode routing ---
+    const identifierScore = exactIdentifiers.length * 3 + dottedIdentifiers.length * 3;
+    const structuralScore = structuralPredicates.length * 2 + codeTokens.length;
+    const behaviorScore = Object.values(familyScores).reduce((s, v) => s + v, 0);
+    let mode;
+    let modeConfidence;
+    const routingReasons = [];
+    if (opts?.forcedMode && opts.forcedMode !== 'auto') {
+        mode = opts.forcedMode;
+        modeConfidence = 'high';
+        routingReasons.push(`forced mode: ${mode}`);
+    }
+    else {
+        // Determine mode from scores
+        const hasIdentifiers = identifierScore > 0;
+        const hasStructural = structuralScore > 2;
+        const hasBehavior = behaviorScore > 2;
+        if (hasIdentifiers && hasStructural) {
+            mode = 'structural'; // identifier + structural = structural (use identifier to locate, predicates to filter)
+            modeConfidence = 'high';
+            routingReasons.push('exact identifier detected', 'structural cues detected');
+        }
+        else if (hasIdentifiers && !hasBehavior) {
+            mode = 'identifier';
+            modeConfidence = 'high';
+            routingReasons.push('exact identifier detected', 'no strong behavior-family evidence');
+        }
+        else if (hasBehavior && hasStructural) {
+            mode = 'mixed';
+            modeConfidence = 'medium';
+            routingReasons.push('behavior family matched', 'structural cues detected');
+        }
+        else if (hasBehavior) {
+            mode = 'behavior';
+            modeConfidence = behaviorScore > 5 ? 'high' : 'medium';
+            routingReasons.push('behavior family matched');
+        }
+        else if (hasStructural) {
+            mode = 'structural';
+            modeConfidence = 'medium';
+            routingReasons.push('structural cues detected');
+        }
+        else if (hasIdentifiers) {
+            mode = 'identifier';
+            modeConfidence = 'medium';
+            routingReasons.push('identifier detected');
+        }
+        else {
+            mode = 'behavior'; // fallback
+            modeConfidence = 'low';
+            routingReasons.push('no strong signals, defaulting to behavior');
+        }
+    }
+    // --- Traits ---
+    const allLower = raw.toLowerCase();
+    const isConfigFocus = opts?.forcedFocus === 'config';
+    const hasHookIdentifier = exactIdentifiers.some((id) => /^use[A-Z]/.test(id));
+    const traits = {
+        reactLike: hasHookIdentifier || /\b(react|component|jsx|hook|use[A-Z])\b/.test(allLower),
+        stateLike: /\b(state|set[A-Z]\w*|useState|reducer|dispatch)\b/.test(allLower),
+        previousStateLike: /\b(prev|previous|current|existing|old)\b.*\b(state)\b/.test(allLower)
+            || /\bbased on (prev|previous|current)\b/.test(allLower),
+        routeLike: isConfigFocus || /\b(route|endpoint|url|path|api|handler)\b/.test(allLower),
+        configLike: isConfigFocus || /\b(config|env|flag|toggle|setting|variable|secret)\b/.test(allLower),
+        implementationRoot: /\b(real|actual|root|implementation|where.*(handled|defined|implemented))\b/.test(allLower),
+        testIntent: /\b(test|spec|describe|it\s+should)\b/.test(allLower),
+    };
+    // --- Phrase rules: infer additional structural predicates from multi-word combinations ---
+    const { added: phrasePredicates, reasons: phraseReasons } = applyPhraseRules(structuralPredicates, [...nlTokens, ...codeTokens], phrases, traits);
+    structuralPredicates.push(...phrasePredicates);
+    routingReasons.push(...phraseReasons);
+    return {
+        raw,
+        nlTokens,
+        phrases,
+        exactIdentifiers,
+        dottedIdentifiers,
+        codeTokens,
+        familyScores,
+        structuralPredicates,
+        traits,
+        recipes: [], // Populated by adapters in planQuery
+        mode,
+        modeConfidence,
+        routingReasons,
+    };
+}
+function extractPhrases(raw) {
+    // Extract 2-3 word phrases that might be meaningful
+    const words = raw.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+    const phrases = [];
+    for (let i = 0; i < words.length - 1; i++) {
+        phrases.push(`${words[i]} ${words[i + 1]}`);
+    }
+    return phrases;
+}
+//# sourceMappingURL=parseQuery.js.map

package/dist/search/query/parseQuery.js.map

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

package/dist/search/query/phraseRules.d.ts

@@ -0,0 +1,10 @@
+import type { StructuralPredicate, QueryTraits } from '../types.js';
+/**
+ * Apply phrase-based rules to infer structural predicates.
+ * Called after token-level parsing to add predicates that require
+ * multi-word combinations, not isolated keywords.
+ */
+export declare function applyPhraseRules(existingPredicates: StructuralPredicate[], tokens: string[], phrases: string[], traits: QueryTraits): {
+    added: StructuralPredicate[];
+    reasons: string[];
+};

package/dist/search/query/phraseRules.js

@@ -0,0 +1,58 @@
+const PHRASE_RULES = [
+    {
+        match: (tok, phrases) => phrases.some((p) => p.includes('returns cleanup') || p.includes('return cleanup')),
+        predicates: ['returns-cleanup'],
+        reason: 'phrase: "returns cleanup"',
+    },
+    {
+        match: (tok, phrases) => phrases.some((p) => p.includes('without cleanup')),
+        predicates: ['no-cleanup'],
+        reason: 'phrase: "without cleanup"',
+    },
+    {
+        match: (tok, phrases) => phrases.some((p) => p.includes('without try') || p.includes('without catch') || p.includes('no try')),
+        predicates: ['no-try-catch'],
+        reason: 'phrase: "without try/catch"',
+    },
+    {
+        match: (tok, phrases) => phrases.some((p) => p.includes('switch without') || p.includes('without default')),
+        predicates: ['switch-no-default'],
+        reason: 'phrase: "switch without default"',
+    },
+    {
+        match: (tok, phrases) => phrases.some((p) => p.includes('await inside') || p.includes('await loop') || p.includes('loop await')),
+        predicates: ['await-in-loop'],
+        reason: 'phrase: "await inside loop"',
+    },
+    {
+        match: (_tok, _phrases, traits) => traits.previousStateLike,
+        predicates: ['functional-state-updater'],
+        reason: 'trait: previousStateLike → functional state updater pattern',
+    },
+    {
+        match: (tok, phrases) => phrases.some((p) => p.includes('conditional cleanup') || p.includes('conditionally return')),
+        predicates: ['conditional', 'returns-cleanup'],
+        reason: 'phrase: "conditional cleanup"',
+    },
+];
+/**
+ * Apply phrase-based rules to infer structural predicates.
+ * Called after token-level parsing to add predicates that require
+ * multi-word combinations, not isolated keywords.
+ */
+export function applyPhraseRules(existingPredicates, tokens, phrases, traits) {
+    const added = [];
+    const reasons = [];
+    for (const rule of PHRASE_RULES) {
+        if (rule.match(tokens, phrases, traits)) {
+            for (const pred of rule.predicates) {
+                if (!existingPredicates.includes(pred) && !added.includes(pred)) {
+                    added.push(pred);
+                }
+            }
+            reasons.push(rule.reason);
+        }
+    }
+    return { added, reasons };
+}
+//# sourceMappingURL=phraseRules.js.map

package/dist/search/query/phraseRules.js.map

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

package/dist/search/query/planQuery.d.ts

@@ -0,0 +1,10 @@
+import type { QueryIR, SearchPlan } from '../types.js';
+/**
+ * Plan which retrievers to use based on the parsed query IR.
+ *
+ * Steps:
+ * 1. Run adapters to generate recipes (mutates ir.recipes)
+ * 2. Merge recipe retriever requirements with mode-based defaults
+ * 3. Decide graph expansion from traits
+ */
+export declare function planQuery(ir: QueryIR): SearchPlan;

package/dist/search/query/planQuery.js

@@ -0,0 +1,91 @@
+import { runAdapters } from '../adapters/registry.js';
+/**
+ * Plan which retrievers to use based on the parsed query IR.
+ *
+ * Steps:
+ * 1. Run adapters to generate recipes (mutates ir.recipes)
+ * 2. Merge recipe retriever requirements with mode-based defaults
+ * 3. Decide graph expansion from traits
+ */
+export function planQuery(ir) {
+    // Step 1: Run adapters to populate recipes
+    const recipes = runAdapters(ir);
+    ir.recipes = recipes;
+    const retrievers = [];
+    const reasons = [];
+    let expandGraph = false;
+    // Step 2: Mode-based default retrievers
+    switch (ir.mode) {
+        case 'behavior':
+            retrievers.push('behavior');
+            reasons.push('behavior family matched — searching declarations by concept');
+            retrievers.push('doc');
+            reasons.push('doc retriever for narrative/comment bridge');
+            break;
+        case 'identifier':
+            retrievers.push('identifier');
+            reasons.push('exact identifier detected — searching usage sites');
+            if (ir.structuralPredicates.length > 0) {
+                retrievers.push('structural');
+                reasons.push('structural predicates found — will filter by code shape');
+            }
+            break;
+        case 'structural':
+            if (ir.exactIdentifiers.length > 0 || ir.dottedIdentifiers.length > 0) {
+                retrievers.push('identifier');
+                reasons.push('using identifier to locate candidate sites');
+            }
+            retrievers.push('structural');
+            reasons.push('structural predicates will filter/rank results');
+            break;
+        case 'mixed':
+            retrievers.push('behavior');
+            reasons.push('behavior retrieval for concept matching');
+            retrievers.push('doc');
+            reasons.push('doc retriever for narrative bridge');
+            if (ir.exactIdentifiers.length > 0 || ir.dottedIdentifiers.length > 0) {
+                retrievers.push('identifier');
+                reasons.push('identifier retrieval for exact API matches');
+            }
+            if (ir.structuralPredicates.length > 0) {
+                retrievers.push('structural');
+                reasons.push('structural predicates for shape filtering');
+            }
+            break;
+    }
+    // Step 3: Merge recipe retrievers
+    for (const recipe of recipes) {
+        for (const r of recipe.retrievers) {
+            if (!retrievers.includes(r)) {
+                retrievers.push(r);
+                reasons.push(`recipe ${recipe.id} → ${r} retriever`);
+            }
+        }
+        reasons.push(...recipe.reasons);
+    }
+    // Config retriever for route/config/flag/env queries
+    if (ir.traits.routeLike || ir.traits.configLike) {
+        if (!retrievers.includes('config')) {
+            retrievers.push('config');
+            reasons.push('config/route trait detected — searching config files');
+        }
+    }
+    // Graph expansion for implementation-root queries
+    if (ir.traits.implementationRoot) {
+        expandGraph = true;
+        reasons.push('implementation-root trait — will expand to real implementations');
+    }
+    // Ensure at least one retriever
+    if (retrievers.length === 0) {
+        retrievers.push('behavior');
+        retrievers.push('doc');
+        reasons.push('fallback: no specific signals, using behavior + doc search');
+    }
+    return {
+        mode: ir.mode,
+        retrievers,
+        reasons,
+        expandGraph,
+    };
+}
+//# sourceMappingURL=planQuery.js.map

package/dist/search/query/planQuery.js.map

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

package/dist/search/ranking/assessConfidence.d.ts

@@ -0,0 +1,6 @@
+import type { CodeCandidate, QueryIR, SearchPlan } from '../types.js';
+/**
+ * Assess overall confidence of the search results.
+ * High = strong signals from multiple sources. Low = weak/generic matches.
+ */
+export declare function assessConfidence(ranked: CodeCandidate[], ir: QueryIR, plan: SearchPlan): 'high' | 'medium' | 'low';

package/dist/search/ranking/assessConfidence.js

@@ -0,0 +1,31 @@
+/**
+ * Assess overall confidence of the search results.
+ * High = strong signals from multiple sources. Low = weak/generic matches.
+ */
+export function assessConfidence(ranked, ir, plan) {
+    if (ranked.length === 0)
+        return 'low';
+    const top = ranked[0];
+    const multiSource = top.sources.length > 1;
+    const hasStructural = top.sources.includes('structural');
+    const hasGraph = top.sources.includes('graph');
+    const hasDoc = top.sources.includes('doc');
+    const highScore = top.score >= 15;
+    const hasOverlap = top.evidence.some((e) => e.includes('overlap'));
+    if (multiSource && highScore)
+        return 'high';
+    if (hasStructural && top.score >= 10)
+        return 'high';
+    if (hasGraph && top.score >= 10)
+        return 'high';
+    if (hasOverlap)
+        return 'high';
+    if (highScore)
+        return 'medium';
+    if (hasDoc && top.score >= 8)
+        return 'medium';
+    if (ir.modeConfidence === 'low')
+        return 'low';
+    return 'medium';
+}
+//# sourceMappingURL=assessConfidence.js.map

package/dist/search/ranking/assessConfidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessConfidence.js","sourceRoot":"","sources":["../../../src/search/ranking/assessConfidence.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAuB,EACvB,EAAW,EACX,IAAgB;IAEhB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAEnE,IAAI,WAAW,IAAI,SAAS;QAAE,OAAO,MAAM,CAAC;IAC5C,IAAI,aAAa,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACpD,IAAI,QAAQ,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,UAAU;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/B,IAAI,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,EAAE,CAAC,cAAc,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAE9C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/search/ranking/candidateIdentity.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Canonical candidate identity key.
+ * Used consistently across merge, coalesce, graph expansion, and ranking.
+ *
+ * Format: filePath:line1based:symbol
+ * Both functions produce the same format so keys match across subsystems.
+ */
+export declare function absoluteCandidateKey(input: {
+    filePath: string;
+    line: number;
+    symbol?: string;
+    matchedIdentifier?: string;
+}): string;
+/**
+ * Convert an LSP URI + 0-based position to the candidate key format.
+ * Used by graph expansion to generate keys that match candidate keys.
+ *
+ * Produces workspace-relative paths to match candidates after ranking
+ * (which relativizes paths via relativePath()).
+ */
+export declare function lspLocationToKey(uri: string, line0: number, workspaceRoot: string, symbol?: string): string;

package/dist/search/ranking/candidateIdentity.js

@@ -0,0 +1,29 @@
+import * as path from 'path';
+/**
+ * Canonical candidate identity key.
+ * Used consistently across merge, coalesce, graph expansion, and ranking.
+ *
+ * Format: filePath:line1based:symbol
+ * Both functions produce the same format so keys match across subsystems.
+ */
+export function absoluteCandidateKey(input) {
+    const symbol = input.symbol ?? input.matchedIdentifier ?? '';
+    return `${input.filePath}:${input.line}:${symbol}`;
+}
+/**
+ * Convert an LSP URI + 0-based position to the candidate key format.
+ * Used by graph expansion to generate keys that match candidate keys.
+ *
+ * Produces workspace-relative paths to match candidates after ranking
+ * (which relativizes paths via relativePath()).
+ */
+export function lspLocationToKey(uri, line0, workspaceRoot, symbol) {
+    let absPath = uri;
+    if (uri.startsWith('file://')) {
+        absPath = decodeURIComponent(uri.replace(/^file:\/\//, ''));
+    }
+    const rel = path.relative(workspaceRoot, absPath);
+    const line1 = line0 + 1;
+    return `${rel}:${line1}:${symbol ?? ''}`;
+}
+//# sourceMappingURL=candidateIdentity.js.map

package/dist/search/ranking/candidateIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidateIdentity.js","sourceRoot":"","sources":["../../../src/search/ranking/candidateIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAKpC;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAC7D,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,KAAa,EACb,aAAqB,EACrB,MAAe;IAEf,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,GAAG,IAAI,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;AAC3C,CAAC"}

package/dist/search/ranking/coalesceCandidates.d.ts

@@ -0,0 +1,9 @@
+import type { CodeCandidate } from '../types.js';
+/**
+ * Coalesce candidates that represent the same logical match.
+ * Merges doc + declaration, usage + pattern, etc. at the same location/symbol.
+ *
+ * This runs after retriever merge and before ranking, preventing
+ * duplicate entries for the same symbol from different retriever types.
+ */
+export declare function coalesceCandidates(candidates: CodeCandidate[]): CodeCandidate[];