lsp-intelligence 0.1.2 → 0.2.1

package/dist/search/adapters/react.js

@@ -0,0 +1,92 @@
+const HOOK_PATTERN = /^use[A-Z]/;
+/**
+ * React adapter — emits search recipes for React hook/component queries.
+ *
+ * Recipes:
+ * - react.useeffect.conditional-cleanup
+ * - react.useeffect.functional-state-updater
+ * - react.usememo.computation
+ * - react.usecallback.memoized-handler
+ * - react.hook.general (fallback for any hook query)
+ */
+export const reactAdapter = {
+    id: 'react',
+    detect(ir) {
+        if (!ir.traits.reactLike)
+            return [];
+        const recipes = [];
+        const hookIds = ir.exactIdentifiers.filter((id) => HOOK_PATTERN.test(id));
+        const hasUseEffect = hookIds.includes('useEffect');
+        const hasUseMemo = hookIds.includes('useMemo');
+        const hasUseCallback = hookIds.includes('useCallback');
+        // useEffect + conditional cleanup
+        if (hasUseEffect && (ir.structuralPredicates.includes('conditional') ||
+            ir.structuralPredicates.includes('returns-cleanup') ||
+            ir.codeTokens.includes('cleanup'))) {
+            recipes.push({
+                id: 'react.useeffect.conditional-cleanup',
+                adapter: 'react',
+                retrievers: ['identifier', 'structural', 'regex'],
+                exactIdentifiers: ['useEffect'],
+                structuralPredicates: ['returns-cleanup', 'conditional'],
+                regexes: [
+                    { id: 'conditional-return', pattern: 'if\\s*\\([^)]*\\)\\s*\\{[^}]*return\\s*\\(\\)', flags: 'g' },
+                    { id: 'useeffect-cleanup', pattern: 'useEffect\\s*\\(\\s*\\(\\)\\s*=>\\s*\\{[\\s\\S]*?return\\s', flags: 'g' },
+                ],
+                scoreBoost: 3,
+                reasons: ['React adapter: useEffect + conditional cleanup pattern'],
+            });
+        }
+        // useEffect + functional state updater (based on previous state)
+        if (hasUseEffect && ir.traits.previousStateLike) {
+            recipes.push({
+                id: 'react.useeffect.functional-state-updater',
+                adapter: 'react',
+                retrievers: ['identifier', 'structural', 'regex'],
+                exactIdentifiers: ['useEffect'],
+                structuralPredicates: ['functional-state-updater'],
+                regexes: [
+                    { id: 'functional-updater', pattern: 'set\\w+\\s*\\(\\s*(?:prev|current|existing|old)\\w*\\s*=>', flags: 'g' },
+                    { id: 'updater-arrow', pattern: 'set\\w+\\s*\\(\\s*\\w+\\s*=>\\s*\\w+', flags: 'g' },
+                ],
+                scoreBoost: 4,
+                reasons: ['React adapter: useEffect + functional state updater'],
+            });
+        }
+        // useMemo computation
+        if (hasUseMemo) {
+            recipes.push({
+                id: 'react.usememo.computation',
+                adapter: 'react',
+                retrievers: ['identifier'],
+                exactIdentifiers: ['useMemo'],
+                scoreBoost: 1,
+                reasons: ['React adapter: useMemo computation'],
+            });
+        }
+        // useCallback memoized handler
+        if (hasUseCallback) {
+            recipes.push({
+                id: 'react.usecallback.memoized-handler',
+                adapter: 'react',
+                retrievers: ['identifier'],
+                exactIdentifiers: ['useCallback'],
+                scoreBoost: 1,
+                reasons: ['React adapter: useCallback memoized handler'],
+            });
+        }
+        // General hook query (fallback)
+        if (hookIds.length > 0 && recipes.length === 0) {
+            recipes.push({
+                id: 'react.hook.general',
+                adapter: 'react',
+                retrievers: ['identifier'],
+                exactIdentifiers: hookIds,
+                scoreBoost: 0,
+                reasons: [`React adapter: general hook query for ${hookIds.join(', ')}`],
+            });
+        }
+        return recipes;
+    },
+};
+//# sourceMappingURL=react.js.map

package/dist/search/adapters/react.js.map

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

package/dist/search/adapters/registry.d.ts

@@ -0,0 +1,6 @@
+import type { QueryIR, SearchRecipe } from '../types.js';
+/**
+ * Run all registered adapters against a parsed query IR.
+ * Returns all emitted recipes.
+ */
+export declare function runAdapters(ir: QueryIR): SearchRecipe[];

package/dist/search/adapters/registry.js

@@ -0,0 +1,20 @@
+import { reactAdapter } from './react.js';
+import { httpAdapter } from './http.js';
+import { configAdapter } from './config.js';
+const ADAPTERS = [
+    reactAdapter,
+    httpAdapter,
+    configAdapter,
+];
+/**
+ * Run all registered adapters against a parsed query IR.
+ * Returns all emitted recipes.
+ */
+export function runAdapters(ir) {
+    const recipes = [];
+    for (const adapter of ADAPTERS) {
+        recipes.push(...adapter.detect(ir));
+    }
+    return recipes;
+}
+//# sourceMappingURL=registry.js.map

package/dist/search/adapters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/search/adapters/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,QAAQ,GAAoB;IAChC,YAAY;IACZ,WAAW;IACX,aAAa;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAW;IACrC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/search/adapters/types.d.ts

@@ -0,0 +1,5 @@
+import type { QueryIR, SearchRecipe } from '../types.js';
+export interface SearchAdapter {
+    id: string;
+    detect(ir: QueryIR): SearchRecipe[];
+}

package/dist/search/adapters/types.js

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

package/dist/search/adapters/types.js.map

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

package/dist/search/debug/trace.d.ts

@@ -0,0 +1,6 @@
+import type { QueryIR, SearchPlan, CodeCandidate, FindCodeDebugInfo } from '../types.js';
+/**
+ * Build debug trace info for find_code results.
+ * Only called when debug=true — no overhead on normal queries.
+ */
+export declare function buildDebugTrace(ir: QueryIR, plan: SearchPlan, candidates: CodeCandidate[], retrieverCounts: Record<string, number>): FindCodeDebugInfo;

package/dist/search/debug/trace.js

@@ -0,0 +1,25 @@
+/**
+ * Build debug trace info for find_code results.
+ * Only called when debug=true — no overhead on normal queries.
+ */
+export function buildDebugTrace(ir, plan, candidates, retrieverCounts) {
+    return {
+        recipes: [
+            `mode: ${ir.mode} (confidence: ${ir.modeConfidence})`,
+            ...ir.routingReasons.map((r) => `routing: ${r}`),
+            ...plan.reasons.map((r) => `plan: ${r}`),
+            ...(ir.traits.routeLike ? ['trait: routeLike'] : []),
+            ...(ir.traits.configLike ? ['trait: configLike'] : []),
+            ...(ir.traits.implementationRoot ? ['trait: implementationRoot'] : []),
+            ...(ir.traits.testIntent ? ['trait: testIntent'] : []),
+            ...(plan.expandGraph ? ['graphExpansion: enabled'] : []),
+        ],
+        retrieverStats: retrieverCounts,
+        scoreBreakdown: candidates.slice(0, 15).map((c) => ({
+            candidateKey: `${c.filePath}:${c.line}:${c.symbol ?? c.matchedIdentifier ?? ''}`,
+            score: c.score,
+            evidence: c.evidence,
+        })),
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/search/debug/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/search/debug/trace.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAW,EACX,IAAgB,EAChB,UAA2B,EAC3B,eAAuC;IAEvC,OAAO;QACL,OAAO,EAAE;YACP,SAAS,EAAE,CAAC,IAAI,iBAAiB,EAAE,CAAC,cAAc,GAAG;YACrD,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;YAChD,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD;QACD,cAAc,EAAE,eAAe;QAC/B,cAAc,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,YAAY,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,iBAAiB,IAAI,EAAE,EAAE;YAChF,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/search/expand/graphExpansion.d.ts

@@ -0,0 +1,16 @@
+import type { CodeCandidate } from '../types.js';
+import type { LspEngine } from '../../engine/LspEngine.js';
+export interface GraphExpansionResult {
+    promoted: Map<string, {
+        scoreDelta: number;
+        evidence: string[];
+    }>;
+    derived: CodeCandidate[];
+    warnings: string[];
+}
+/**
+ * Expand top candidates toward implementation roots.
+ * Detects wrappers, follows definitions, and promotes likely real implementations.
+ * Derived candidates are returned for merging back into ranking.
+ */
+export declare function expandToImplementationRoots(candidates: CodeCandidate[], engine: LspEngine, maxSeeds?: number): Promise<GraphExpansionResult>;

package/dist/search/expand/graphExpansion.js

@@ -0,0 +1,168 @@
+import ts from 'typescript';
+import { parseSourceFile } from '../../analysis/ts/parseSourceFile.js';
+import { absoluteCandidateKey, lspLocationToKey } from '../ranking/candidateIdentity.js';
+import { buildSnippetFromFile } from '../../analysis/ts/snippets.js';
+/** Builtins and framework symbols that should never be promoted as implementation roots. */
+const BUILTIN_DENYLIST = new Set([
+    'useState', 'useEffect', 'useMemo', 'useCallback', 'useRef', 'useContext',
+    'useReducer', 'useLayoutEffect', 'useImperativeHandle', 'useDebugValue',
+    'fetch', 'console', 'setTimeout', 'setInterval', 'clearTimeout', 'clearInterval',
+    'Promise', 'JSON', 'Math', 'Object', 'Array', 'Map', 'Set', 'Date', 'Error',
+    'require', 'import', 'exports', 'module',
+    'document', 'window', 'process', 'global', 'globalThis',
+    'addEventListener', 'removeEventListener', 'dispatchEvent',
+    'createElement', 'createContext', 'createRef', 'forwardRef', 'memo', 'lazy',
+]);
+/**
+ * Expand top candidates toward implementation roots.
+ * Detects wrappers, follows definitions, and promotes likely real implementations.
+ * Derived candidates are returned for merging back into ranking.
+ */
+export async function expandToImplementationRoots(candidates, engine, maxSeeds = 5) {
+    const promoted = new Map();
+    const derived = [];
+    const warnings = [];
+    const seeds = candidates.slice(0, maxSeeds);
+    for (const candidate of seeds) {
+        try {
+            // Use absolute path for wrapper detection (candidates may be relative at this point)
+            const absPath = candidate.filePath.startsWith('/')
+                ? candidate.filePath
+                : `${engine.workspaceRoot}/${candidate.filePath}`;
+            const wrapperInfo = detectWrapper(absPath, candidate.line);
+            if (!wrapperInfo)
+                continue;
+            // Skip if the call target is a builtin/framework symbol — not a real root
+            const leafTarget = wrapperInfo.callTarget.split('.').pop() ?? wrapperInfo.callTarget;
+            if (BUILTIN_DENYLIST.has(leafTarget))
+                continue;
+            // Demote wrapper
+            const wrapperKey = absoluteCandidateKey(candidate);
+            promoted.set(wrapperKey, {
+                scoreDelta: -2,
+                evidence: [`wrapper-of: ${wrapperInfo.callTarget}`, `body-size: ${wrapperInfo.bodySize}`],
+            });
+            // Try to resolve the wrapped function via LSP and promote it
+            try {
+                const loc = await engine.resolveSymbol(wrapperInfo.callTarget);
+                if (loc) {
+                    // Only promote if the resolved location is inside the workspace (project-local)
+                    const resolvedPath = loc.uri.startsWith('file://')
+                        ? decodeURIComponent(loc.uri.replace(/^file:\/\//, ''))
+                        : loc.uri;
+                    if (!resolvedPath.startsWith(engine.workspaceRoot))
+                        continue;
+                    const derivedKey = lspLocationToKey(loc.uri, loc.position.line, engine.workspaceRoot, wrapperInfo.callTarget);
+                    if (!promoted.has(derivedKey)) {
+                        promoted.set(derivedKey, {
+                            scoreDelta: 4,
+                            evidence: ['implementation-root', `wrapped-by: ${candidate.symbol ?? 'unknown'}`],
+                        });
+                        // Create a derived candidate so it can be merged into results
+                        const derivedPath = loc.uri.startsWith('file://')
+                            ? decodeURIComponent(loc.uri.replace(/^file:\/\//, ''))
+                            : loc.uri;
+                        const derivedLine = loc.position.line + 1;
+                        const { snippet, context } = buildSnippetFromFile(derivedPath, derivedLine, 1);
+                        derived.push({
+                            candidateType: 'declaration',
+                            filePath: derivedPath,
+                            line: derivedLine,
+                            symbol: wrapperInfo.callTarget,
+                            kind: 'function',
+                            snippet,
+                            context,
+                            score: candidate.score + 4,
+                            evidence: ['implementation-root', `wrapped-by: ${candidate.symbol ?? 'unknown'}`, 'graph-derived'],
+                            sources: ['graph'],
+                        });
+                    }
+                }
+            }
+            catch {
+                // LSP resolution failed — skip
+            }
+        }
+        catch (err) {
+            warnings.push(`graph-expand failed for ${candidate.symbol}: ${err?.message ?? 'unknown'}`);
+        }
+    }
+    return { promoted, derived, warnings };
+}
+function detectWrapper(filePath, line) {
+    const sf = parseSourceFile(filePath);
+    if (!sf)
+        return null;
+    const targetLine = line - 1;
+    let foundNode = null;
+    function visit(node) {
+        if (foundNode)
+            return;
+        const nodeLine = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line;
+        if (nodeLine >= targetLine - 1 && nodeLine <= targetLine + 1) {
+            if (ts.isFunctionDeclaration(node) || ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
+                foundNode = node;
+                return;
+            }
+        }
+        if (ts.isVariableDeclaration(node) && node.initializer) {
+            const initLine = sf.getLineAndCharacterOfPosition(node.initializer.getStart(sf)).line;
+            if (initLine >= targetLine - 1 && initLine <= targetLine + 1) {
+                if (ts.isArrowFunction(node.initializer) || ts.isFunctionExpression(node.initializer)) {
+                    foundNode = node.initializer;
+                    return;
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    if (!foundNode)
+        return null;
+    const body = getBody(foundNode);
+    if (!body)
+        return null;
+    const statements = ts.isBlock(body) ? body.statements : [];
+    const bodySize = statements.length;
+    if (bodySize > 5 || bodySize === 0)
+        return null;
+    const callTargets = [];
+    for (const stmt of statements) {
+        findCallTargets(stmt, callTargets);
+    }
+    if (callTargets.length === 0 || callTargets.length > 3)
+        return null;
+    return { callTarget: callTargets[0], bodySize };
+}
+function getBody(node) {
+    if (ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node))
+        return node.body ?? null;
+    if (ts.isArrowFunction(node))
+        return node.body;
+    return null;
+}
+function findCallTargets(node, targets) {
+    if (ts.isCallExpression(node)) {
+        const expr = node.expression;
+        if (ts.isIdentifier(expr)) {
+            targets.push(expr.text);
+        }
+        else if (ts.isPropertyAccessExpression(expr)) {
+            const parts = [expr.name.text];
+            let current = expr.expression;
+            while (ts.isPropertyAccessExpression(current)) {
+                parts.unshift(current.name.text);
+                current = current.expression;
+            }
+            if (ts.isIdentifier(current))
+                parts.unshift(current.text);
+            targets.push(parts.join('.'));
+        }
+    }
+    if (ts.isReturnStatement(node) && node.expression) {
+        findCallTargets(node.expression, targets);
+        return;
+    }
+    ts.forEachChild(node, (child) => findCallTargets(child, targets));
+}
+//# sourceMappingURL=graphExpansion.js.map

package/dist/search/expand/graphExpansion.js.map

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

package/dist/search/families/behaviorFamilies.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Behavior families — redesigned with classifier/expansion split.
+ *
+ * classifierTerms: strong terms only. Weak words (use, get, set, call, run, make)
+ * must NEVER appear here. These drive mode routing.
+ *
+ * expansionTerms: broader lexical expansion for recall. May include weaker terms.
+ */
+export interface BehaviorFamily {
+    id: string;
+    classifierTerms: string[];
+    expansionTerms: string[];
+    fileHints: string[];
+    symbolHints: string[];
+}
+export declare const BEHAVIOR_FAMILIES: BehaviorFamily[];
+/**
+ * Score a set of tokens against all families.
+ * Uses only classifierTerms for strong matching.
+ * Returns per-family scores.
+ */
+export declare function scoreFamilies(tokens: string[]): Record<string, number>;

package/dist/search/families/behaviorFamilies.js

@@ -0,0 +1,90 @@
+/**
+ * Behavior families — redesigned with classifier/expansion split.
+ *
+ * classifierTerms: strong terms only. Weak words (use, get, set, call, run, make)
+ * must NEVER appear here. These drive mode routing.
+ *
+ * expansionTerms: broader lexical expansion for recall. May include weaker terms.
+ */
+export const BEHAVIOR_FAMILIES = [
+    {
+        id: 'auth_permission',
+        classifierTerms: ['permission', 'auth', 'authorize', 'guard', 'access', 'role', 'acl'],
+        expansionTerms: ['can', 'allow', 'deny', 'policy', 'privilege', 'protect', 'secure'],
+        fileHints: ['auth', 'permission', 'guard', 'access', 'policy', 'acl'],
+        symbolHints: ['permission', 'guard', 'authorize', 'protect', 'allow'],
+    },
+    {
+        id: 'validation',
+        classifierTerms: ['valid', 'validate', 'verify', 'assert', 'sanitize', 'schema'],
+        expansionTerms: ['parse', 'conform', 'ensure', 'require', 'constraint', 'check'],
+        fileHints: ['valid', 'verify', 'assert', 'sanitize', 'schema'],
+        symbolHints: ['valid', 'verify', 'assert', 'schema'],
+    },
+    {
+        id: 'error_handling',
+        classifierTerms: ['error', 'exception', 'boundary', 'recover', 'fallback'],
+        expansionTerms: ['fail', 'throw', 'sentinel', 'catch', 'handle'],
+        fileHints: ['error', 'handler', 'boundary', 'fallback', 'recovery'],
+        symbolHints: ['error', 'handle', 'recover', 'fallback', 'boundary'],
+    },
+    {
+        id: 'fetching',
+        classifierTerms: ['fetch', 'endpoint', 'api', 'request', 'http'],
+        expansionTerms: ['load', 'query', 'download', 'post', 'ajax', 'invoke'],
+        fileHints: ['api', 'fetch', 'service', 'client', 'endpoint', 'request'],
+        symbolHints: ['fetch', 'api', 'endpoint', 'request', 'service'],
+    },
+    {
+        id: 'state_management',
+        classifierTerms: ['redux', 'store', 'reducer', 'slice', 'dispatch'],
+        expansionTerms: ['action', 'thunk', 'selector', 'middleware', 'subscribe', 'state'],
+        fileHints: ['store', 'reducer', 'slice', 'duck', 'redux'],
+        symbolHints: ['reducer', 'slice', 'dispatch', 'selector', 'thunk'],
+    },
+    {
+        id: 'feature_flags',
+        classifierTerms: ['feature', 'flag', 'toggle', 'experiment', 'launch'],
+        expansionTerms: ['switch', 'variant', 'rollout', 'canary', 'gate', 'dark'],
+        fileHints: ['feature', 'flag', 'toggle', 'gate', 'experiment'],
+        symbolHints: ['feature', 'flag', 'toggle', 'gate', 'enabled'],
+    },
+    {
+        id: 'retry_backoff',
+        classifierTerms: ['retry', 'backoff', 'debounce', 'throttle', 'ratelimit'],
+        expansionTerms: ['exponential', 'delay', 'cooldown', 'timeout', 'interval', 'limit'],
+        fileHints: ['retry', 'backoff', 'throttle', 'debounce', 'rate'],
+        symbolHints: ['retry', 'backoff', 'debounce', 'throttle', 'delay'],
+    },
+    {
+        id: 'caching',
+        classifierTerms: ['cache', 'memoize', 'persist', 'ttl', 'lru'],
+        expansionTerms: ['memo', 'invalidate', 'expire', 'warm', 'preload', 'stale', 'store'],
+        fileHints: ['cache', 'memo', 'persist', 'storage'],
+        symbolHints: ['cache', 'memo', 'memoize', 'persist'],
+    },
+];
+/**
+ * Score a set of tokens against all families.
+ * Uses only classifierTerms for strong matching.
+ * Returns per-family scores.
+ */
+export function scoreFamilies(tokens) {
+    const scores = {};
+    for (const family of BEHAVIOR_FAMILIES) {
+        let score = 0;
+        for (const token of tokens) {
+            // Classifier terms: strong match
+            for (const ct of family.classifierTerms) {
+                if (ct === token)
+                    score += 3;
+                else if (ct.startsWith(token) || token.startsWith(ct))
+                    score += 1;
+            }
+        }
+        if (score > 0)
+            scores[family.id] = score;
+    }
+    return scores;
+}
+//# sourceMappingURL=behaviorFamilies.js.map

package/dist/search/families/behaviorFamilies.js.map

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

package/dist/search/fileKinds.d.ts

@@ -0,0 +1,13 @@
+import ts from 'typescript';
+export declare const CODE_EXTENSIONS: readonly [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+export declare const CONFIG_EXTENSIONS: readonly [".json", ".yaml", ".yml", ".toml"];
+export declare function shouldSkipDir(dirName: string): boolean;
+export declare function shouldSkipFile(filePath: string, sizeBytes?: number): boolean;
+/** Real .env files that may contain secrets. Excluded from indexing by default. */
+export declare function isSecretEnvFile(filePath: string): boolean;
+/** Non-secret env template/example files. Safe to index. */
+export declare function isSafeEnvTemplateFile(filePath: string): boolean;
+export declare function isCodeFile(filePath: string): boolean;
+export declare function isConfigFile(filePath: string): boolean;
+export declare function isTestFile(filePath: string): boolean;
+export declare function scriptKindForFile(filePath: string): ts.ScriptKind;

package/dist/search/fileKinds.js

@@ -0,0 +1,74 @@
+import * as path from 'path';
+import ts from 'typescript';
+export const CODE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+export const CONFIG_EXTENSIONS = ['.json', '.yaml', '.yml', '.toml'];
+const TEST_PATTERN = /\.(spec|test|stories)\.(ts|tsx|js|jsx|mjs|cjs)$/;
+// --- Directory exclusion ---
+const SKIP_DIR_NAMES = new Set([
+    'node_modules', 'dist', 'build', 'es', 'coverage',
+    '__pycache__', '__generated__', '__mocks__',
+]);
+export function shouldSkipDir(dirName) {
+    if (dirName.startsWith('.'))
+        return true;
+    return SKIP_DIR_NAMES.has(dirName);
+}
+// --- File exclusion ---
+const SKIP_FILE_PATTERNS = [
+    /\.min\.(js|cjs|mjs)$/,
+    /\.bundle\.(js|cjs|mjs)$/,
+    /\.map$/,
+    /\.lock$/,
+    /-lock\.json$/,
+];
+const MAX_FILE_SIZE = 500_000;
+export function shouldSkipFile(filePath, sizeBytes) {
+    const basename = path.basename(filePath);
+    if (basename.endsWith('.d.ts'))
+        return true;
+    if (SKIP_FILE_PATTERNS.some((p) => p.test(basename)))
+        return true;
+    if (sizeBytes !== undefined && sizeBytes > MAX_FILE_SIZE)
+        return true;
+    return false;
+}
+// --- Env file classification ---
+/** Real .env files that may contain secrets. Excluded from indexing by default. */
+export function isSecretEnvFile(filePath) {
+    const basename = path.basename(filePath);
+    if (!basename.startsWith('.env'))
+        return false;
+    // Allow safe templates/examples
+    if (isSafeEnvTemplateFile(filePath))
+        return false;
+    return true;
+}
+/** Non-secret env template/example files. Safe to index. */
+export function isSafeEnvTemplateFile(filePath) {
+    const basename = path.basename(filePath).toLowerCase();
+    return basename === '.env.example' ||
+        basename === '.env.template' ||
+        basename === '.env.sample';
+}
+// --- Code/config/test classification ---
+export function isCodeFile(filePath) {
+    if (shouldSkipFile(filePath))
+        return false;
+    return CODE_EXTENSIONS.some((ext) => filePath.endsWith(ext));
+}
+export function isConfigFile(filePath) {
+    return CONFIG_EXTENSIONS.some((ext) => filePath.endsWith(ext));
+}
+export function isTestFile(filePath) {
+    return TEST_PATTERN.test(path.basename(filePath));
+}
+export function scriptKindForFile(filePath) {
+    if (filePath.endsWith('.tsx'))
+        return ts.ScriptKind.TSX;
+    if (filePath.endsWith('.jsx'))
+        return ts.ScriptKind.JSX;
+    if (filePath.endsWith('.mjs') || filePath.endsWith('.cjs') || filePath.endsWith('.js'))
+        return ts.ScriptKind.JS;
+    return ts.ScriptKind.TS;
+}
+//# sourceMappingURL=fileKinds.js.map

package/dist/search/fileKinds.js.map

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

package/dist/search/index/configIndex.d.ts

@@ -0,0 +1,6 @@
+import type { ConfigIndexEntry, SearchScope } from '../types.js';
+/**
+ * Index configuration files in the workspace.
+ * Extracts key-value entries from JSON, YAML-like, and env files.
+ */
+export declare function indexConfigFiles(scope: SearchScope): ConfigIndexEntry[];