code-auditor-mcp 4.1.0 → 5.0.1

package/dist/codeIndex/schema.js

@@ -0,0 +1,174 @@
+/**
+ * Schema management + usage — the `schema_definitions` and `schema_usage`
+ * tables. Extracted from `CodeIndexDB`; holds only the raw SQLite handle.
+ */
+import { tryParseJson } from './shared.js';
+/**
+ * Schema management for the `schema_definitions` and `schema_usage` tables.
+ * Stores whole-schema snapshots, records per-file/table/function usage rows
+ * (upserting on table/file/location identity), and answers usage and aggregate
+ * statistics queries for the schema analyzer.
+ */
+export class SchemaIndex {
+    db;
+    /**
+     * Hold the SQLite handle used by all schema management methods.
+     * @param db The SQLite database handle to store schemas and usage rows in.
+     */
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Store a schema definition and return its generated schema ID.
+     * @param schema The schema snapshot to persist, including its databases and tables.
+     * @returns The generated schema ID the snapshot was stored under.
+     */
+    async storeSchema(schema) {
+        const schemaId = `schema_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        const metadata = {
+            schemaId,
+            schemaName: schema.name,
+            indexedAt: new Date(),
+            tableCount: schema.databases.reduce((acc, db) => acc + db.tables.length, 0),
+            relationshipCount: schema.databases.reduce((acc, db) => acc + (db.relationships?.length || 0), 0),
+            usagePatterns: [],
+            discoveredPatterns: [],
+            violations: []
+        };
+        this.db.prepare('INSERT INTO schema_definitions (schema_id, schema_name, schema_json, metadata_json, indexed_at) VALUES (?, ?, ?, ?, ?)').run(schemaId, schema.name, JSON.stringify(schema), JSON.stringify(metadata), new Date().toISOString());
+        return schemaId;
+    }
+    /**
+     * Retrieve a stored schema by ID.
+     * @param schemaId The schema ID to look up.
+     * @returns The parsed schema definition, or null when no row matches.
+     */
+    async getSchema(schemaId) {
+        const row = this.db.prepare('SELECT schema_json FROM schema_definitions WHERE schema_id = ?').get(schemaId);
+        return row ? tryParseJson(row.schema_json) : null;
+    }
+    /**
+     * Return all stored schemas with their indexing metadata.
+     * @returns Each stored schema with its parsed metadata and definition.
+     */
+    async getAllSchemas() {
+        const rows = this.db.prepare('SELECT schema_id, schema_json, metadata_json FROM schema_definitions').all();
+        return rows.map((r) => ({
+            schemaId: r.schema_id,
+            metadata: tryParseJson(r.metadata_json) ?? {},
+            schema: tryParseJson(r.schema_json),
+        }));
+    }
+    /**
+     * Delete a schema and its usage rows.
+     * @param schemaId The schema ID whose definition and usage rows should be removed.
+     * @returns True when a schema definition row was deleted.
+     */
+    async deleteSchema(schemaId) {
+        this.db.prepare('DELETE FROM schema_usage WHERE schema_id = ?').run(schemaId);
+        const result = this.db.prepare('DELETE FROM schema_definitions WHERE schema_id = ?').run(schemaId);
+        return result.changes > 0;
+    }
+    /**
+     * Record one schema usage, upserting on table/file/location identity.
+     * @param usage The usage observation to record (table, file, function, location).
+     * @param schemaId The schema to attribute the usage to; defaults to 'default'.
+     * @returns a promise that resolves once the usage row is recorded
+     */
+    async recordSchemaUsage(usage, schemaId) {
+        const existing = this.db.prepare('SELECT id FROM schema_usage WHERE table_name = ? AND file_path = ? AND function_start_line IS ? AND function_start_column IS ? AND line = ?').get(usage.tableName, usage.filePath, usage.functionStartLine ?? null, usage.functionStartColumn ?? null, usage.line);
+        if (existing) {
+            this.db.prepare('UPDATE schema_usage SET schema_id = ?, function_name = ?, usage_type = ?, "column" = ?, raw_query = ?, parameters = ?, origin = ?, recorded_at = ? WHERE id = ?').run(schemaId ?? 'default', usage.functionName ?? null, usage.usageType, usage.column ?? null, usage.rawQuery ?? null, JSON.stringify(usage.parameters ?? []), usage.origin ?? null, new Date().toISOString(), existing.id);
+        }
+        else {
+            this.db.prepare('INSERT INTO schema_usage (schema_id, table_name, file_path, function_name, function_start_line, function_start_column, usage_type, line, "column", raw_query, parameters, origin, recorded_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(schemaId ?? 'default', usage.tableName, usage.filePath, usage.functionName ?? null, usage.functionStartLine ?? null, usage.functionStartColumn ?? null, usage.usageType, usage.line ?? null, usage.column ?? null, usage.rawQuery ?? null, JSON.stringify(usage.parameters ?? []), usage.origin ?? null, new Date().toISOString());
+        }
+    }
+    /**
+     * Clear all schema_usage entries for a given file path.
+     * Used for idempotent per-file writes during indexing — stale entries
+     * from a previous scan are removed before fresh references are inserted.
+     * @param filePath The file whose previous usage rows should be removed.
+     */
+    clearSchemaUsageForFile(filePath) {
+        this.db.prepare('DELETE FROM schema_usage WHERE file_path = ?').run(filePath);
+    }
+    /**
+     * Query schema usage entries, filtered by the optional options.
+     * @param options Optional filters (schemaId, tableName, filePath, functionName, usageType); empty returns all rows.
+     * @returns The matching usage rows in their public SchemaUsage shape.
+     */
+    async getSchemaUsage(options = {}) {
+        const clauses = [];
+        const params = [];
+        if (options.schemaId) {
+            clauses.push('schema_id = ?');
+            params.push(options.schemaId);
+        }
+        if (options.tableName) {
+            clauses.push('table_name = ?');
+            params.push(options.tableName);
+        }
+        if (options.filePath) {
+            clauses.push('file_path = ?');
+            params.push(options.filePath);
+        }
+        if (options.functionName) {
+            clauses.push('function_name = ?');
+            params.push(options.functionName);
+        }
+        if (options.usageType) {
+            clauses.push('usage_type = ?');
+            params.push(options.usageType);
+        }
+        const sql = 'SELECT * FROM schema_usage' + (clauses.length ? ' WHERE ' + clauses.join(' AND ') : '');
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => ({
+            tableName: r.table_name,
+            filePath: r.file_path,
+            functionName: r.function_name,
+            functionStartLine: r.function_start_line,
+            functionStartColumn: r.function_start_column,
+            usageType: r.usage_type,
+            line: r.line,
+            column: r.column,
+            rawQuery: r.raw_query,
+            parameters: tryParseJson(r.parameters) ?? [],
+        }));
+    }
+    /**
+     * Find functions that reference the given table.
+     * @param tableName The table whose referencing functions to list.
+     * @returns The functions that reference the table, with file and usage type.
+     */
+    async findFunctionsUsingTable(tableName) {
+        const rows = this.db.prepare('SELECT function_name, file_path, usage_type, line FROM schema_usage WHERE table_name = ?').all(tableName);
+        return rows.map((r) => ({
+            functionName: r.function_name,
+            filePath: r.file_path,
+            usageType: r.usage_type,
+            line: r.line,
+        }));
+    }
+    /**
+     * Compute aggregate schema statistics.
+     * @returns Totals plus the most-used tables and per-usage-type counts.
+     */
+    async getSchemaStats() {
+        const totalSchemas = this.db.prepare('SELECT COUNT(*) as cnt FROM schema_definitions').get().cnt;
+        const totalUsagePatterns = this.db.prepare('SELECT COUNT(*) as cnt FROM schema_usage').get().cnt;
+        const schemas = this.db.prepare('SELECT schema_json FROM schema_definitions').all();
+        const totalTables = schemas.reduce((acc, s) => {
+            const schema = tryParseJson(s.schema_json);
+            return acc + (schema?.databases?.reduce((dbAcc, db) => dbAcc + (db.tables?.length ?? 0), 0) ?? 0);
+        }, 0);
+        const mostUsedTables = this.db.prepare('SELECT table_name as tableName, COUNT(*) as usageCount FROM schema_usage GROUP BY table_name ORDER BY usageCount DESC LIMIT 10').all();
+        const usageByType = {};
+        const typeRows = this.db.prepare('SELECT usage_type, COUNT(*) as cnt FROM schema_usage GROUP BY usage_type').all();
+        for (const r of typeRows) {
+            usageByType[r.usage_type] = r.cnt;
+        }
+        return { totalSchemas, totalTables, totalUsagePatterns, mostUsedTables, usageByType };
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/codeIndex/schema.js.map

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

package/dist/codeIndex/search.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Search access — FTS5 + operator query compilation and the in-memory filter
+ * fallback. Extracted from `CodeIndexDB`; holds the SQLite handle plus the
+ * `FunctionIndex` it marshals result rows through (row → function document).
+ * The cross-concern `searchWithSchemaContext` (search + schema usage) stays on
+ * the facade because it composes two modules.
+ */
+import type { SqliteDatabase } from '../sqlite/types.js';
+import { FunctionIndex } from './functionIndex.js';
+import type { SearchResult, SearchOptions } from '../types.js';
+/**
+ * Full-text and operator search over the functions table. Compiles parsed
+ * queries to SQL (FTS5 when a match term exists) and falls back to in-memory
+ * filtering otherwise, marshalling rows through FunctionIndex into documents.
+ */
+export declare class SearchIndex {
+    private db;
+    private functionIndex;
+    /**
+     * Create the search index over the shared handle.
+     *
+     * @param db The SQLite database handle.
+     * @param functionIndex The function index used to map rows to documents.
+     */
+    constructor(db: SqliteDatabase, functionIndex: FunctionIndex);
+    /**
+     * Search indexed functions via the query parser, using the FTS5 SQL path when
+     * a parsed query is available and falling back to in-memory filtering otherwise.
+     *
+     * @param options - Search options including query, filters, limit, and offset.
+     * @returns The search result with matching functions and total count.
+     */
+    searchFunctions(options: SearchOptions): Promise<SearchResult>;
+    private executeCompiledSearch;
+    private rowToFunctionDoc;
+    private mergeFilters;
+    private applyFilters;
+    private excludeTermsFromResults;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/codeIndex/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EAEd,MAAM,aAAa,CAAC;AAgErB;;;;GAIG;AACH,qBAAa,WAAW;IAOV,OAAO,CAAC,EAAE;IAAkB,OAAO,CAAC,aAAa;IAN7D;;;;;OAKG;gBACiB,EAAE,EAAE,cAAc,EAAU,aAAa,EAAE,aAAa;IAE5E;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA6CpE,OAAO,CAAC,qBAAqB;IA8F7B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAwDpB,OAAO,CAAC,uBAAuB;CAchC"}

package/dist/codeIndex/search.js

@@ -0,0 +1,316 @@
+/**
+ * Search access — FTS5 + operator query compilation and the in-memory filter
+ * fallback. Extracted from `CodeIndexDB`; holds the SQLite handle plus the
+ * `FunctionIndex` it marshals result rows through (row → function document).
+ * The cross-concern `searchWithSchemaContext` (search + schema usage) stays on
+ * the facade because it composes two modules.
+ */
+import { QueryParser, compileToSQL } from '../search/QueryParser.js';
+import { tryParseJson, escapeRegExpLiteral } from './shared.js';
+/**
+ * Apply the metadata facet of a search filter to a single function document.
+ * Returns true when the document satisfies every populated metadata facet
+ * (entity/component type, hook/prop substring, dependency/caller/callee/module
+ * substrings, unused-import presence). Extracted from `applyFilters` to keep
+ * that method's cyclomatic complexity under the method-complexity ceiling.
+ */
+function matchesMetadataFilter(doc, m) {
+    if (!doc.metadata)
+        return false;
+    if (m.entityType && doc.metadata.entityType !== m.entityType)
+        return false;
+    if (m.componentType && doc.metadata.componentType !== m.componentType)
+        return false;
+    if (m.hasHook) {
+        if (!doc.metadata.hooks)
+            return false;
+        const found = doc.metadata.hooks.some((h) => h.name?.toLowerCase().includes(m.hasHook.toLowerCase()));
+        if (!found)
+            return false;
+    }
+    if (m.hasProp) {
+        if (!doc.metadata.props)
+            return false;
+        const found = doc.metadata.props.some((p) => p.name?.toLowerCase().includes(m.hasProp.toLowerCase()));
+        if (!found)
+            return false;
+    }
+    if (m.usesDependency) {
+        const dep = m.usesDependency.toLowerCase();
+        const inFile = doc.dependencies.some(d => d.toLowerCase().includes(dep));
+        const inFunc = doc.metadata.usedImports?.some(i => i.toLowerCase().includes(dep)) ?? false;
+        if (!inFile && !inFunc)
+            return false;
+    }
+    if (m.callsFunction) {
+        const target = m.callsFunction.toLowerCase();
+        const calls = doc.metadata.functionCalls;
+        if (!calls || !calls.some(c => c.toLowerCase().includes(target)))
+            return false;
+    }
+    if (m.calledByFunction) {
+        const caller = m.calledByFunction.toLowerCase();
+        const calledBy = doc.metadata.calledBy;
+        if (!calledBy || !calledBy.some(c => c.toLowerCase().includes(caller)))
+            return false;
+    }
+    if (m.dependsOnModule) {
+        const mod = m.dependsOnModule.toLowerCase();
+        const inFile2 = doc.filePath.toLowerCase().includes(mod);
+        const inDep = doc.dependencies.some(d => d.toLowerCase().includes(mod));
+        const inCall = doc.metadata.functionCalls?.some(c => c.toLowerCase().includes(mod)) ?? false;
+        if (!inFile2 && !inDep && !inCall)
+            return false;
+    }
+    if (m.hasUnusedImports) {
+        const unused = doc.metadata.unusedImports;
+        if (!unused || unused.length === 0)
+            return false;
+    }
+    return true;
+}
+/**
+ * Full-text and operator search over the functions table. Compiles parsed
+ * queries to SQL (FTS5 when a match term exists) and falls back to in-memory
+ * filtering otherwise, marshalling rows through FunctionIndex into documents.
+ */
+export class SearchIndex {
+    db;
+    functionIndex;
+    /**
+     * Create the search index over the shared handle.
+     *
+     * @param db The SQLite database handle.
+     * @param functionIndex The function index used to map rows to documents.
+     */
+    constructor(db, functionIndex) {
+        this.db = db;
+        this.functionIndex = functionIndex;
+    }
+    /**
+     * Search indexed functions via the query parser, using the FTS5 SQL path when
+     * a parsed query is available and falling back to in-memory filtering otherwise.
+     *
+     * @param options - Search options including query, filters, limit, and offset.
+     * @returns The search result with matching functions and total count.
+     */
+    async searchFunctions(options) {
+        const startTime = Date.now();
+        const queryParser = new QueryParser();
+        let parsedQuery;
+        if (options.query) {
+            parsedQuery = options.parsedQuery || queryParser.parse(options.query);
+        }
+        else if (options.parsedQuery) {
+            parsedQuery = options.parsedQuery;
+        }
+        // If there's a parsed query, use the SQL path (handles both FTS5 and operator-only queries)
+        if (parsedQuery) {
+            const compiled = compileToSQL(parsedQuery, { defaultLimit: options.limit || 50, offset: options.offset || 0 });
+            return this.executeCompiledSearch(compiled, parsedQuery, options, startTime);
+        }
+        // Otherwise, get all functions and apply filters in-memory (backward compatible)
+        const rows = this.db.prepare('SELECT *, rowid as "$loki" FROM functions').all();
+        let results = rows.map((r) => this.rowToFunctionDoc(r));
+        // Apply filters (parsedQuery is undefined here — the if-parsedQuery branch returned early)
+        const combinedFilters = this.mergeFilters(options.filters, undefined);
+        results = this.applyFilters(results, combinedFilters);
+        const totalCount = results.length;
+        const limit = options.limit || 50;
+        const offset = options.offset || 0;
+        results = results.slice(offset, offset + limit);
+        const functions = results.map(doc => ({
+            ...doc,
+            score: 50
+        }));
+        return {
+            functions,
+            totalCount,
+            query: options.query,
+            parsedQuery,
+            executionTime: Date.now() - startTime
+        };
+    }
+    executeCompiledSearch(compiled, parsedQuery, options, startTime) {
+        let sql;
+        const params = { ...compiled.params };
+        let afterFrom = '';
+        // Collect JOINs first — they must precede WHERE in SQL
+        for (const join of compiled.joinClauses) {
+            afterFrom += ` ${join}`;
+        }
+        if (compiled.ftsMatch) {
+            // FTS5 path
+            sql = `SELECT f.*, f.rowid as "$loki", bm25(functions_fts) as score
+        FROM functions f
+        JOIN functions_fts ON functions_fts.rowid = f.id${afterFrom}
+        WHERE functions_fts MATCH @_ftsMatch`;
+            params['_ftsMatch'] = compiled.ftsMatch;
+        }
+        else {
+            sql = `SELECT f.*, f.rowid as "$loki", 0 as score FROM functions f${afterFrom} WHERE 1=1`;
+        }
+        // Add WHERE clauses
+        for (const clause of compiled.whereClauses) {
+            sql += ` AND (${clause})`;
+        }
+        // Ordering
+        sql += ` ORDER BY ${compiled.orderBy}`;
+        // Limit/offset
+        sql += ` LIMIT ${compiled.limit} OFFSET ${compiled.offset}`;
+        const rows = this.db.prepare(sql).all(params);
+        // Get total count (without limit)
+        let totalCount = rows.length;
+        try {
+            let countSql;
+            let countAfterFrom = '';
+            for (const join of compiled.joinClauses) {
+                countAfterFrom += ` ${join}`;
+            }
+            if (compiled.ftsMatch) {
+                countSql = `SELECT COUNT(*) as cnt FROM functions f
+          JOIN functions_fts ON functions_fts.rowid = f.id${countAfterFrom}
+          WHERE functions_fts MATCH @_ftsMatch`;
+            }
+            else {
+                countSql = `SELECT COUNT(*) as cnt FROM functions f${countAfterFrom} WHERE 1=1`;
+            }
+            for (const clause of compiled.whereClauses) {
+                countSql += ` AND (${clause})`;
+            }
+            const countParams = { ...params };
+            delete countParams['_ftsMatch'];
+            if (compiled.ftsMatch) {
+                countParams['_ftsMatch'] = compiled.ftsMatch;
+            }
+            const countResult = this.db.prepare(countSql).get(countParams);
+            totalCount = countResult?.cnt ?? rows.length;
+        }
+        catch {
+            // Fall back to results length
+        }
+        // Convert rows to FunctionDocument, applying excluded terms
+        let docs = rows.map((r) => this.rowToFunctionDoc(r));
+        if (parsedQuery.excludedTerms.length > 0) {
+            docs = this.excludeTermsFromResults(docs, parsedQuery.excludedTerms);
+        }
+        // Apply in-memory filters (for filters not handled by compileToSQL)
+        const combinedFilters = this.mergeFilters(options.filters, parsedQuery.filters);
+        docs = this.applyFilters(docs, combinedFilters);
+        const functions = docs.map(doc => ({
+            ...doc,
+            score: doc.score ?? 0
+        }));
+        return {
+            functions,
+            totalCount,
+            query: options.query,
+            parsedQuery,
+            executionTime: Date.now() - startTime
+        };
+    }
+    rowToFunctionDoc(row) {
+        const func = this.functionIndex.rowToFunction(row);
+        const doc = {
+            ...func,
+            $loki: row['$loki'] ?? row.id,
+            dependencies: [],
+        };
+        // Populate dependencies from metadata
+        const meta = tryParseJson(row.metadata_json);
+        if (meta) {
+            // Include both specifier-level (usedImports) and module-level (dependencies)
+            const usedImports = meta.usedImports ?? [];
+            const moduleDeps = meta.dependencies ?? [];
+            doc.dependencies = [...new Set([...usedImports, ...moduleDeps])];
+        }
+        return doc;
+    }
+    mergeFilters(optionsFilters, queryFilters) {
+        const merged = {};
+        if (optionsFilters)
+            Object.assign(merged, optionsFilters);
+        if (queryFilters) {
+            if (queryFilters.language)
+                merged.language = queryFilters.language;
+            if (queryFilters.filePath)
+                merged.filePath = queryFilters.filePath;
+            if (queryFilters.fileType)
+                merged.fileType = queryFilters.fileType;
+            if (queryFilters.hasJsDoc !== undefined)
+                merged.hasJsDoc = queryFilters.hasJsDoc;
+            if (queryFilters.complexity)
+                merged.complexity = queryFilters.complexity;
+            if (queryFilters.dateRange)
+                merged.dateRange = queryFilters.dateRange;
+            if (queryFilters.metadata)
+                merged.metadata = queryFilters.metadata;
+        }
+        return merged;
+    }
+    applyFilters(results, filters) {
+        if (!filters)
+            return results;
+        let filtered = results;
+        if (filters.language) {
+            filtered = filtered.filter(doc => doc.language === filters.language);
+        }
+        if (filters.filePath) {
+            if (filters.filePath.includes('*') || filters.filePath.includes('?')) {
+                // `*` and `?` are the only glob wildcards; every other character is
+                // escaped so it matches literally. A path like `foo[0-9].ts` no longer
+                // becomes an accidental regex character class.
+                const pattern = filters.filePath
+                    .split(/([*?])/)
+                    .map((seg) => (seg === '*' ? '.*' : seg === '?' ? '.' : escapeRegExpLiteral(seg)))
+                    .join('');
+                const regex = new RegExp(pattern);
+                filtered = filtered.filter(doc => regex.test(doc.filePath));
+            }
+            else if (filters.filePath.endsWith('.ts') || filters.filePath.endsWith('.tsx') ||
+                filters.filePath.endsWith('.js') || filters.filePath.endsWith('.jsx')) {
+                filtered = filtered.filter(doc => doc.filePath.endsWith(filters.filePath));
+            }
+            else {
+                filtered = filtered.filter(doc => doc.filePath.includes(filters.filePath));
+            }
+        }
+        if (filters.fileType) {
+            filtered = filtered.filter(doc => doc.filePath.endsWith(filters.fileType));
+        }
+        if (filters.hasJsDoc !== undefined) {
+            filtered = filtered.filter(doc => {
+                const hasJsDoc = doc.jsDoc && doc.jsDoc.description && doc.jsDoc.description.length > 0;
+                return filters.hasJsDoc ? hasJsDoc : !hasJsDoc;
+            });
+        }
+        if (filters.complexity) {
+            filtered = filtered.filter(doc => {
+                if (!doc.complexity)
+                    return false;
+                const min = filters.complexity.min || 0;
+                const max = filters.complexity.max || Infinity;
+                return doc.complexity >= min && doc.complexity <= max;
+            });
+        }
+        if (filters.hasAnyDependency && filters.hasAnyDependency.length > 0) {
+            filtered = filtered.filter(doc => filters.hasAnyDependency.some(dep => doc.dependencies.includes(dep)));
+        }
+        if (filters.metadata) {
+            filtered = filtered.filter(doc => matchesMetadataFilter(doc, filters.metadata));
+        }
+        return filtered;
+    }
+    excludeTermsFromResults(results, excludedTerms) {
+        return results.filter(doc => {
+            const searchText = [
+                doc.name, doc.purpose, doc.context,
+                doc.jsDoc?.description, doc.returnType,
+                ...(doc.parameters || []).map((p) => `${p.name} ${p.description || ''}`),
+                ...doc.dependencies
+            ].filter(Boolean).join(' ').toLowerCase();
+            return !excludedTerms.some(term => searchText.includes(term.toLowerCase()));
+        });
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/codeIndex/search.js.map

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

package/dist/codeIndex/shared.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared helpers for the `codeIndex` modules. Kept dependency-free (imports
+ * nothing from `codeIndexDB.ts`) so every extracted concern can depend on it
+ * without forming an import cycle back into the facade.
+ */
+export declare const SQL_IDENTIFIER_RE: RegExp;
+export declare const ASSERT_TABLE_NAME = "table name";
+export declare const ASSERT_COLUMN_NAME = "column name";
+/** Reject a value that is not a plain SQL identifier. Table and column names are
+ *  interpolated into SQL (SQLite cannot parameterize identifiers), so a value that
+ *  fails this check is a would-be injection surface and is refused, never run.
+ *  @param name - The identifier value to validate.
+ *  @param context - The SQL context (e.g. "table name") used in the error message. */
+export declare function assertSqlIdentifier(name: string, context: string): void;
+/**
+ * Escape regex metacharacters so a string matches itself literally.
+ * @param s The string to escape for safe use inside a regular expression.
+ * @returns The string with every regex metacharacter backslash-escaped.
+ */
+export declare function escapeRegExpLiteral(s: string): string;
+/**
+ * Parse a JSON value if it is a string; pass through objects and non-strings.
+ * @param val The value to normalize, typically a JSON-serialized column read back from SQLite.
+ * @returns The parsed object/array/primitive, or the original value when it is not JSON.
+ */
+export declare function tryParseJson(val: any): any;
+//# sourceMappingURL=shared.d.ts.map

package/dist/codeIndex/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/codeIndex/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD;;;;sFAIsF;AACtF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAS1C"}

package/dist/codeIndex/shared.js

@@ -0,0 +1,46 @@
+/**
+ * Shared helpers for the `codeIndex` modules. Kept dependency-free (imports
+ * nothing from `codeIndexDB.ts`) so every extracted concern can depend on it
+ * without forming an import cycle back into the facade.
+ */
+export const SQL_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export const ASSERT_TABLE_NAME = 'table name';
+export const ASSERT_COLUMN_NAME = 'column name';
+/** Reject a value that is not a plain SQL identifier. Table and column names are
+ *  interpolated into SQL (SQLite cannot parameterize identifiers), so a value that
+ *  fails this check is a would-be injection surface and is refused, never run.
+ *  @param name - The identifier value to validate.
+ *  @param context - The SQL context (e.g. "table name") used in the error message. */
+export function assertSqlIdentifier(name, context) {
+    if (!SQL_IDENTIFIER_RE.test(name)) {
+        throw new Error(`invalid SQL identifier in ${context}: ${JSON.stringify(name)}`);
+    }
+}
+/**
+ * Escape regex metacharacters so a string matches itself literally.
+ * @param s The string to escape for safe use inside a regular expression.
+ * @returns The string with every regex metacharacter backslash-escaped.
+ */
+export function escapeRegExpLiteral(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Parse a JSON value if it is a string; pass through objects and non-strings.
+ * @param val The value to normalize, typically a JSON-serialized column read back from SQLite.
+ * @returns The parsed object/array/primitive, or the original value when it is not JSON.
+ */
+export function tryParseJson(val) {
+    if (val === null || val === undefined)
+        return null;
+    if (typeof val === 'object')
+        return val;
+    if (typeof val !== 'string')
+        return val;
+    try {
+        return JSON.parse(val);
+    }
+    catch {
+        return val;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/codeIndex/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/codeIndex/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;;;sFAIsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAe;IAC/D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC3C,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}