lsp-intelligence 0.1.2 → 0.2.1

package/dist/search/index/configIndex.js

@@ -0,0 +1,196 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { shouldSkipDir, isSecretEnvFile, isSafeEnvTemplateFile } from '../fileKinds.js';
+// Config file extensions to index. Does NOT include .env (handled separately).
+const CONFIG_EXTENSIONS = ['.json', '.yaml', '.yml', '.toml'];
+const CONFIG_FILENAMES = [
+    'package.json', 'tsconfig.json', 'next.config.js', 'next.config.ts',
+    'vite.config.ts', 'vite.config.js', 'jest.config.ts', 'jest.config.js',
+    'vitest.config.ts',
+    // Safe env templates (no secrets)
+    '.env.example', '.env.template', '.env.sample',
+];
+const ROUTE_KEYS = new Set(['routes', 'route', 'api', 'endpoint', 'endpoints', 'path', 'paths', 'handler', 'handlers', 'url', 'urls']);
+const FLAG_KEYS = new Set(['features', 'feature', 'flags', 'flag', 'toggles', 'toggle', 'experiments', 'gates']);
+/**
+ * Index configuration files in the workspace.
+ * Extracts key-value entries from JSON, YAML-like, and env files.
+ */
+export function indexConfigFiles(scope) {
+    const entries = [];
+    const maxFiles = 200;
+    const files = [];
+    for (const root of scope.roots) {
+        collectConfigFiles(root, files, maxFiles, 0);
+    }
+    for (const filePath of files) {
+        try {
+            const ext = path.extname(filePath);
+            const basename = path.basename(filePath);
+            if (basename === 'package.json') {
+                entries.push(...indexPackageJson(filePath));
+            }
+            else if (ext === '.json') {
+                entries.push(...indexJsonFile(filePath));
+            }
+            else if (basename.startsWith('.env')) {
+                entries.push(...indexEnvFile(filePath));
+            }
+            else if (ext === '.yaml' || ext === '.yml') {
+                entries.push(...indexYamlLikeFile(filePath));
+            }
+        }
+        catch {
+            // Skip files that can't be read/parsed
+        }
+    }
+    return entries;
+}
+function collectConfigFiles(dir, files, maxFiles, depth) {
+    if (depth > 4 || files.length >= maxFiles)
+        return;
+    try {
+        for (const entry of fs.readdirSync(dir)) {
+            const full = path.join(dir, entry);
+            const stat = fs.statSync(full);
+            if (stat.isDirectory()) {
+                if (shouldSkipDir(entry))
+                    continue;
+                collectConfigFiles(full, files, maxFiles, depth + 1);
+            }
+            else if (CONFIG_FILENAMES.includes(entry) ||
+                CONFIG_EXTENSIONS.some((e) => entry.endsWith(e)) ||
+                isSafeEnvTemplateFile(full)) {
+                // Exclude secret-bearing .env files
+                if (isSecretEnvFile(full))
+                    continue;
+                files.push(full);
+            }
+        }
+    }
+    catch { }
+}
+function indexPackageJson(filePath) {
+    const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    const entries = [];
+    // Scripts
+    if (content.scripts) {
+        for (const [key, value] of Object.entries(content.scripts)) {
+            entries.push({
+                filePath, line: 1, kind: 'package',
+                keyPath: ['scripts', key],
+                text: `${key}: ${value}`,
+                tokens: tokenize(`${key} ${value}`),
+            });
+        }
+    }
+    // Dependencies
+    for (const depKey of ['dependencies', 'devDependencies', 'peerDependencies']) {
+        if (content[depKey]) {
+            for (const pkg of Object.keys(content[depKey])) {
+                entries.push({
+                    filePath, line: 1, kind: 'package',
+                    keyPath: [depKey, pkg],
+                    text: `${depKey}: ${pkg}`,
+                    tokens: tokenize(pkg),
+                });
+            }
+        }
+    }
+    return entries;
+}
+function indexJsonFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const entries = [];
+    try {
+        const obj = JSON.parse(content);
+        flattenJson(obj, [], filePath, entries, 0);
+    }
+    catch { }
+    return entries;
+}
+function flattenJson(obj, keyPath, filePath, entries, depth) {
+    if (depth > 4 || entries.length > 100)
+        return;
+    if (typeof obj !== 'object' || obj === null)
+        return;
+    for (const [key, value] of Object.entries(obj)) {
+        const path = [...keyPath, key];
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            // Classify by key path
+            const kind = classifyConfigKind(path);
+            entries.push({
+                filePath, line: 1, kind,
+                keyPath: path,
+                text: `${path.join('.')}: ${value}`,
+                tokens: tokenize(`${key} ${value}`),
+            });
+        }
+        else if (typeof value === 'object' && value !== null) {
+            flattenJson(value, path, filePath, entries, depth + 1);
+        }
+    }
+}
+function indexEnvFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const entries = [];
+    for (const [i, rawLine] of content.split('\n').entries()) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const eqIdx = line.indexOf('=');
+        if (eqIdx < 1)
+            continue;
+        const key = line.substring(0, eqIdx).trim();
+        const value = line.substring(eqIdx + 1).trim();
+        entries.push({
+            filePath, line: i + 1, kind: 'env',
+            keyPath: [key],
+            text: `${key}=${value}`,
+            tokens: tokenize(`${key} ${value}`),
+        });
+    }
+    return entries;
+}
+function indexYamlLikeFile(filePath) {
+    // Simple line-based YAML indexing — not a full parser
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const entries = [];
+    for (const [i, rawLine] of content.split('\n').entries()) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const colonIdx = line.indexOf(':');
+        if (colonIdx < 1)
+            continue;
+        const key = line.substring(0, colonIdx).trim();
+        const value = line.substring(colonIdx + 1).trim();
+        if (value) {
+            entries.push({
+                filePath, line: i + 1, kind: 'config',
+                keyPath: [key],
+                text: `${key}: ${value}`,
+                tokens: tokenize(`${key} ${value}`),
+            });
+        }
+    }
+    return entries;
+}
+function classifyConfigKind(keyPath) {
+    for (const k of keyPath) {
+        const lower = k.toLowerCase();
+        if (ROUTE_KEYS.has(lower))
+            return 'route';
+        if (FLAG_KEYS.has(lower))
+            return 'config';
+    }
+    return 'config';
+}
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-_]/g, ' ')
+        .split(/[\s-_]+/)
+        .filter((t) => t.length > 1);
+}
+//# sourceMappingURL=configIndex.js.map

package/dist/search/index/configIndex.js.map

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

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

@@ -0,0 +1,6 @@
+import type { DeclarationIndexEntry } from '../types.js';
+/**
+ * Build declaration index entries for a single file.
+ * Uses TypeScript compiler AST, not regex.
+ */
+export declare function indexFileDeclarations(filePath: string): DeclarationIndexEntry[];

package/dist/search/index/declarationIndex.js

@@ -0,0 +1,13 @@
+import { parseSourceFile } from '../../analysis/ts/parseSourceFile.js';
+import { extractDeclarations } from '../../analysis/ts/extractDeclarations.js';
+/**
+ * Build declaration index entries for a single file.
+ * Uses TypeScript compiler AST, not regex.
+ */
+export function indexFileDeclarations(filePath) {
+    const sf = parseSourceFile(filePath);
+    if (!sf)
+        return [];
+    return extractDeclarations(sf);
+}
+//# sourceMappingURL=declarationIndex.js.map

package/dist/search/index/declarationIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarationIndex.js","sourceRoot":"","sources":["../../../src/search/index/declarationIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAG/E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,OAAO,mBAAmB,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,7 @@
+import ts from 'typescript';
+import type { DocIndexEntry } from '../types.js';
+/**
+ * Extract doc/narrative entries from a TypeScript source file.
+ * Indexes: JSDoc on exported declarations, leading comments, describe/it/test titles.
+ */
+export declare function indexFileDocs(sf: ts.SourceFile): DocIndexEntry[];

package/dist/search/index/docIndex.js

@@ -0,0 +1,116 @@
+import ts from 'typescript';
+/**
+ * Extract doc/narrative entries from a TypeScript source file.
+ * Indexes: JSDoc on exported declarations, leading comments, describe/it/test titles.
+ */
+export function indexFileDocs(sf) {
+    const entries = [];
+    const filePath = sf.fileName;
+    function visit(node) {
+        // JSDoc on exported declarations
+        if (isExportedDeclaration(node)) {
+            const name = getDeclarationName(node);
+            const jsdoc = getJSDocText(node, sf);
+            if (jsdoc) {
+                const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                entries.push({
+                    filePath,
+                    line,
+                    kind: 'jsdoc',
+                    text: jsdoc,
+                    tokens: tokenize(jsdoc),
+                    attachedSymbol: name,
+                });
+            }
+            // Leading comment (non-JSDoc) above exported declarations
+            const leadingComment = getLeadingComment(node, sf);
+            if (leadingComment && leadingComment !== jsdoc) {
+                const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                entries.push({
+                    filePath,
+                    line,
+                    kind: 'comment',
+                    text: leadingComment,
+                    tokens: tokenize(leadingComment),
+                    attachedSymbol: name,
+                });
+            }
+        }
+        // Test titles: describe('...'), it('...'), test('...')
+        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression)) {
+            const callee = node.expression.text;
+            if ((callee === 'describe' || callee === 'it' || callee === 'test') && node.arguments.length > 0) {
+                const firstArg = node.arguments[0];
+                if (ts.isStringLiteral(firstArg) || ts.isNoSubstitutionTemplateLiteral(firstArg)) {
+                    const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+                    entries.push({
+                        filePath,
+                        line,
+                        kind: 'test-title',
+                        text: firstArg.text,
+                        tokens: tokenize(firstArg.text),
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return entries;
+}
+function isExportedDeclaration(node) {
+    const mods = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+    if (!mods)
+        return false;
+    return mods.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+}
+function getDeclarationName(node) {
+    if (ts.isFunctionDeclaration(node) && node.name)
+        return node.name.text;
+    if (ts.isClassDeclaration(node) && node.name)
+        return node.name.text;
+    if (ts.isVariableStatement(node)) {
+        for (const decl of node.declarationList.declarations) {
+            if (ts.isIdentifier(decl.name))
+                return decl.name.text;
+        }
+    }
+    if (ts.isInterfaceDeclaration(node))
+        return node.name.text;
+    if (ts.isTypeAliasDeclaration(node))
+        return node.name.text;
+    if (ts.isEnumDeclaration(node))
+        return node.name.text;
+    return undefined;
+}
+function getJSDocText(node, sf) {
+    const jsdocs = node.jsDoc;
+    if (!jsdocs || jsdocs.length === 0)
+        return undefined;
+    const comment = jsdocs[0].comment;
+    if (typeof comment === 'string')
+        return comment;
+    if (Array.isArray(comment))
+        return comment.map((c) => c.text ?? '').join('');
+    return undefined;
+}
+function getLeadingComment(node, sf) {
+    const fullText = sf.getFullText();
+    const ranges = ts.getLeadingCommentRanges(fullText, node.getFullStart());
+    if (!ranges || ranges.length === 0)
+        return undefined;
+    // Take last comment before the node
+    const range = ranges[ranges.length - 1];
+    let text = fullText.substring(range.pos, range.end);
+    // Strip comment markers
+    text = text.replace(/^\/\*\*?\s*|\s*\*\/$/g, '').replace(/^\s*\/\/\s*/gm, '').replace(/^\s*\*\s?/gm, '').trim();
+    return text || undefined;
+}
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length > 2);
+}
+//# sourceMappingURL=docIndex.js.map

package/dist/search/index/docIndex.js.map

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

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

@@ -0,0 +1 @@
+export type { DeclarationIndexEntry, UsageIndexEntry, IndexedFile, WorkspaceIndex, } from '../types.js';

package/dist/search/index/types.js

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

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

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

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

@@ -0,0 +1,6 @@
+import type { UsageIndexEntry } from '../types.js';
+/**
+ * Build usage index entries for a single file.
+ * Indexes call expressions, member calls, imports, JSX tags using TS compiler AST.
+ */
+export declare function indexFileUsages(filePath: string): UsageIndexEntry[];

package/dist/search/index/usageIndex.js

@@ -0,0 +1,13 @@
+import { parseSourceFile } from '../../analysis/ts/parseSourceFile.js';
+import { extractUsages } from '../../analysis/ts/extractUsages.js';
+/**
+ * Build usage index entries for a single file.
+ * Indexes call expressions, member calls, imports, JSX tags using TS compiler AST.
+ */
+export function indexFileUsages(filePath) {
+    const sf = parseSourceFile(filePath);
+    if (!sf)
+        return [];
+    return extractUsages(sf);
+}
+//# sourceMappingURL=usageIndex.js.map

package/dist/search/index/usageIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageIndex.js","sourceRoot":"","sources":["../../../src/search/index/usageIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { SearchScope, WorkspaceIndex } from '../types.js';
+/** Force-clear the in-memory workspace index. Next query will rebuild from scratch. */
+export declare function clearWorkspaceIndex(): {
+    cleared: boolean;
+    hadEntries: number;
+};
+/**
+ * Get or build a workspace index for the given scope.
+ * Uses per-file mtime to invalidate stale entries — no TTL.
+ * Cache keys by normalized scope (sorted roots + includeTests) + INDEX_VERSION.
+ */
+export declare function getWorkspaceIndex(scope: SearchScope, opts?: {
+    forceRefresh?: boolean;
+}): WorkspaceIndex;

package/dist/search/index/workspaceIndex.js

@@ -0,0 +1,127 @@
+import * as fs from 'fs';
+import { collectScopeFiles, collectScopeFilesWithMeta } from '../../resolve/searchScope.js';
+import { indexFileDeclarations } from './declarationIndex.js';
+import { indexFileUsages } from './usageIndex.js';
+import { indexFileDocs } from './docIndex.js';
+import { indexConfigFiles } from './configIndex.js';
+import { parseSourceFile } from '../../analysis/ts/parseSourceFile.js';
+// Bump this when discovery/exclusion rules change to invalidate stale caches.
+const INDEX_VERSION = 2;
+let cachedEntry = null;
+function scopeCacheKey(scope) {
+    return JSON.stringify({
+        roots: [...scope.roots].sort(),
+        includeTests: scope.includeTests,
+    });
+}
+/** Force-clear the in-memory workspace index. Next query will rebuild from scratch. */
+export function clearWorkspaceIndex() {
+    const hadEntries = cachedEntry?.index.files.size ?? 0;
+    cachedEntry = null;
+    return { cleared: true, hadEntries };
+}
+/**
+ * Get or build a workspace index for the given scope.
+ * Uses per-file mtime to invalidate stale entries — no TTL.
+ * Cache keys by normalized scope (sorted roots + includeTests) + INDEX_VERSION.
+ */
+export function getWorkspaceIndex(scope, opts) {
+    const key = scopeCacheKey(scope);
+    // Full refresh if scope changed, forced, or index version changed
+    if (!cachedEntry || cachedEntry.scopeKey !== key || cachedEntry.version !== INDEX_VERSION || opts?.forceRefresh) {
+        const index = buildFreshIndex(scope);
+        cachedEntry = { index, version: INDEX_VERSION, scopeKey: key };
+        return index;
+    }
+    const cachedIndex = cachedEntry.index;
+    // Incremental: check mtime per file, re-index changed files
+    const scopeFiles = collectScopeFiles(scope);
+    let changed = false;
+    for (const filePath of scopeFiles) {
+        try {
+            const mtime = fs.statSync(filePath).mtimeMs;
+            const existing = cachedIndex.files.get(filePath);
+            if (!existing || existing.mtimeMs !== mtime) {
+                // File is new or changed — re-index
+                const declarations = indexFileDeclarations(filePath);
+                const usages = indexFileUsages(filePath);
+                const docs = indexFileDocsForFile(filePath);
+                cachedIndex.files.set(filePath, { filePath, mtimeMs: mtime, declarations, usages, docs });
+                changed = true;
+            }
+        }
+        catch {
+            // File may have been deleted
+            if (cachedIndex.files.has(filePath)) {
+                cachedIndex.files.delete(filePath);
+                changed = true;
+            }
+        }
+    }
+    // Remove files no longer in scope
+    const scopeSet = new Set(scopeFiles);
+    for (const key of cachedIndex.files.keys()) {
+        if (!scopeSet.has(key)) {
+            cachedIndex.files.delete(key);
+            changed = true;
+        }
+    }
+    // Rebuild flat arrays if anything changed
+    if (changed) {
+        rebuildFlatArrays(cachedIndex, scope);
+    }
+    return cachedIndex;
+}
+function buildFreshIndex(scope) {
+    const root = scope.roots[0] ?? '';
+    const files = new Map();
+    const scopeMeta = collectScopeFilesWithMeta(scope);
+    const scopeFiles = scopeMeta.files;
+    for (const filePath of scopeFiles) {
+        try {
+            const mtime = fs.statSync(filePath).mtimeMs;
+            const declarations = indexFileDeclarations(filePath);
+            const usages = indexFileUsages(filePath);
+            const docs = indexFileDocsForFile(filePath);
+            files.set(filePath, { filePath, mtimeMs: mtime, declarations, usages, docs });
+        }
+        catch {
+            // Skip files that can't be read/parsed
+        }
+    }
+    const index = {
+        root,
+        builtAt: Date.now(),
+        files,
+        declarations: [],
+        usages: [],
+        docs: [],
+        configs: [],
+        scopeCapped: scopeMeta.capped,
+        capReason: scopeMeta.capReason,
+    };
+    rebuildFlatArrays(index, scope);
+    return index;
+}
+function rebuildFlatArrays(index, scope) {
+    const declarations = [];
+    const usages = [];
+    const docs = [];
+    for (const file of index.files.values()) {
+        declarations.push(...file.declarations);
+        usages.push(...file.usages);
+        docs.push(...file.docs);
+    }
+    index.declarations = declarations;
+    index.usages = usages;
+    index.docs = docs;
+    index.configs = indexConfigFiles(scope);
+    index.builtAt = Date.now();
+}
+function indexFileDocsForFile(filePath) {
+    const sf = parseSourceFile(filePath);
+    if (!sf)
+        return [];
+    return indexFileDocs(sf);
+}
+//# sourceMappingURL=workspaceIndex.js.map

package/dist/search/index/workspaceIndex.js.map

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

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

@@ -0,0 +1,24 @@
+import type { QueryIR, SearchPlan, StructuralPredicate, RegExpSpec, QueryTraits } from '../types.js';
+/**
+ * Effective search spec — the single merged execution contract.
+ * All retrievers consume this instead of raw IR.
+ * Merges parser-derived signals with adapter recipe intent.
+ */
+export interface EffectiveSearchSpec {
+    exactIdentifiers: string[];
+    dottedIdentifiers: string[];
+    behaviorTerms: string[];
+    structuralPredicates: StructuralPredicate[];
+    regexes: RegExpSpec[];
+    routeTerms: string[];
+    configTerms: string[];
+    implementationRoot: boolean;
+    traits: QueryTraits;
+    /** Recipe IDs that contributed to this spec — for debug/evidence */
+    recipeIds: string[];
+}
+/**
+ * Compile an effective search spec by merging parser-derived signals with recipe intent.
+ * This is the ONLY place where parser output + recipe output are unified.
+ */
+export declare function compileEffectiveSearchSpec(ir: QueryIR, plan: SearchPlan): EffectiveSearchSpec;

package/dist/search/query/compileEffectiveSearchSpec.js

@@ -0,0 +1,67 @@
+/**
+ * Compile an effective search spec by merging parser-derived signals with recipe intent.
+ * This is the ONLY place where parser output + recipe output are unified.
+ */
+export function compileEffectiveSearchSpec(ir, plan) {
+    const exactIdentifiers = [...ir.exactIdentifiers];
+    const dottedIdentifiers = [...ir.dottedIdentifiers];
+    const structuralPredicates = [...ir.structuralPredicates];
+    const regexes = [];
+    const behaviorTerms = [...ir.nlTokens, ...ir.codeTokens];
+    const routeTerms = [];
+    const configTerms = [];
+    const recipeIds = [];
+    // Extract route/config terms from NL tokens
+    const ROUTE_WORDS = new Set(['route', 'endpoint', 'url', 'path', 'api', 'handler']);
+    const CONFIG_WORDS = new Set(['config', 'env', 'flag', 'toggle', 'setting', 'variable', 'secret', 'feature']);
+    for (const tok of ir.nlTokens) {
+        if (ROUTE_WORDS.has(tok))
+            routeTerms.push(tok);
+        if (CONFIG_WORDS.has(tok))
+            configTerms.push(tok);
+    }
+    // Merge recipe contributions
+    for (const recipe of ir.recipes) {
+        recipeIds.push(recipe.id);
+        if (recipe.exactIdentifiers) {
+            for (const id of recipe.exactIdentifiers) {
+                if (!exactIdentifiers.includes(id))
+                    exactIdentifiers.push(id);
+            }
+        }
+        if (recipe.structuralPredicates) {
+            for (const pred of recipe.structuralPredicates) {
+                if (!structuralPredicates.includes(pred))
+                    structuralPredicates.push(pred);
+            }
+        }
+        if (recipe.regexes) {
+            for (const r of recipe.regexes) {
+                if (!regexes.some((existing) => existing.id === r.id))
+                    regexes.push(r);
+            }
+        }
+        // Recipes from config/http adapters contribute route/config terms
+        if (recipe.adapter === 'config' || recipe.adapter === 'http') {
+            for (const reason of recipe.reasons) {
+                if (reason.includes('route') || reason.includes('endpoint'))
+                    routeTerms.push('route');
+                if (reason.includes('flag') || reason.includes('env') || reason.includes('config'))
+                    configTerms.push('config');
+            }
+        }
+    }
+    return {
+        exactIdentifiers,
+        dottedIdentifiers,
+        behaviorTerms,
+        structuralPredicates,
+        regexes,
+        routeTerms: [...new Set(routeTerms)],
+        configTerms: [...new Set(configTerms)],
+        implementationRoot: ir.traits.implementationRoot || plan.expandGraph,
+        traits: ir.traits,
+        recipeIds,
+    };
+}
+//# sourceMappingURL=compileEffectiveSearchSpec.js.map