code-auditor-mcp 4.1.0 → 5.0.1

package/dist/codeIndex/functionIndex.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Function-index access — the `functions` table CRUD, row marshalling, and
+ * per-file upsert/stale-removal. Extracted from `CodeIndexDB`; holds only the
+ * raw SQLite handle. Orchestration that spans concerns (dependency-graph
+ * rebuild after a sync, churn/hotspot/convention mining) stays on the facade.
+ */
+import type { SqliteDatabase } from '../sqlite/types.js';
+import type { FunctionMetadata, EnhancedFunctionMetadata } from '../types.js';
+/**
+ * Data access for the `functions` table: CRUD, row marshalling, and per-file
+ * upsert/stale-removal.
+ */
+export declare class FunctionIndex {
+    private db;
+    /**
+     * Wrap the shared SQLite handle for function-index access.
+     * @param db the SQLite database handle.
+     */
+    constructor(db: SqliteDatabase);
+    /** The single-function upsert statement, parsed once and reused across a
+     *  batch. Lazily prepared because the first caller may be either the
+     *  per-function `registerFunction` path or the per-file `syncFileIndexRow`
+     *  batch path. */
+    private upsertStmt?;
+    private functionUpsertStmt;
+    /**
+     * Marshal a DB row into the `EnhancedFunctionMetadata` shape consumers read.
+     * @param row the raw `functions` table row.
+     * @returns the function metadata with parsed parameters, jsDoc, and metadata fields.
+     */
+    rowToFunction(row: any): EnhancedFunctionMetadata;
+    /**
+     * Marshal function metadata into the row shape the `functions` table stores.
+     * @param func the function metadata to convert.
+     * @param lastModified optional last-modified timestamp to stamp on the row.
+     * @param fileHash optional file-level content hash stamped onto the row's
+     *   `file_hash` column for diff detection.
+     * @returns the row object keyed by the table's column names.
+     */
+    functionToRow(func: FunctionMetadata | EnhancedFunctionMetadata, lastModified?: string, fileHash?: string): Record<string, any>;
+    /**
+     * Insert or update a single function row (upsert keyed on name, file, line).
+     * @param func the function metadata to persist.
+     * @returns a promise that resolves once the row is upserted
+     */
+    registerFunction(func: FunctionMetadata | EnhancedFunctionMetadata): Promise<void>;
+    /**
+     * Register many functions in one transaction, reporting per-function errors.
+     * @param functions the function metadata records to persist.
+     * @returns a summary with a success flag, registered/failed counts, and per-function error details.
+     */
+    registerFunctions(functions: (FunctionMetadata | EnhancedFunctionMetadata)[]): Promise<{
+        success: boolean;
+        registered: number;
+        failed: number;
+        errors?: Array<{
+            function: string;
+            error: string;
+        }>;
+    }>;
+    /**
+     * Upsert/remove one file's function rows. Runs inside the caller's
+     * transaction (no nested `db.transaction` here) so a batch sync can wrap many
+     * files in a single write transaction.
+     *
+     * @param filePath the file whose function rows are being synced.
+     * @param currentFunctions the functions present in the file now.
+     * @param stats accumulator the add/update/remove counts are written into.
+     * @param lastModified optional last-modified timestamp to stamp on written rows.
+     * @param fileHash optional file-level content hash stamped onto each written row
+     *   for diff detection.
+     */
+    syncFileIndexRow(filePath: string, currentFunctions: (FunctionMetadata | EnhancedFunctionMetadata)[], stats: {
+        added: number;
+        updated: number;
+        removed: number;
+    }, lastModified?: string, fileHash?: string): void;
+    /**
+     * Resolve one indexed function by name, optionally scoped to a file.
+     * @param name the function name to look up.
+     * @param filePath when given, restrict the match to that file.
+     * @returns the matching function, or null when no row matches.
+     */
+    findDefinition(name: string, filePath?: string): Promise<EnhancedFunctionMetadata | null>;
+    /**
+     * Return all indexed functions.
+     * @returns every function row marshalled into metadata.
+     */
+    getAllFunctions(): Promise<EnhancedFunctionMetadata[]>;
+    /**
+     * Row count of the `functions` table — for callers that only need `.length`.
+     * @returns the number of indexed function rows.
+     */
+    getFunctionCount(): Promise<number>;
+    /**
+     * Compute aggregate index statistics (function count, languages, top
+     * dependencies, files indexed, and last-updated time).
+     * @returns the aggregate stats object.
+     */
+    getStats(): Promise<{
+        totalFunctions: number;
+        languages: Record<string, number>;
+        topDependencies: Array<{
+            name: string;
+            count: number;
+        }>;
+        filesIndexed: number;
+        lastUpdated: Date;
+    }>;
+}
+//# sourceMappingURL=functionIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"functionIndex.d.ts","sourceRoot":"","sources":["../../src/codeIndex/functionIndex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AAI1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAoE9E;;;GAGG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,EAAE;IAJtB;;;OAGG;gBACiB,EAAE,EAAE,cAAc;IAEtC;;;sBAGkB;IAClB,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,kBAAkB;IAI1B;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,wBAAwB;IA4BjD;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,wBAAwB,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAwC/H;;;;OAIG;IACG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxF;;;;OAIG;IACG,iBAAiB,CAAC,SAAS,EAAE,CAAC,gBAAgB,GAAG,wBAAwB,CAAC,EAAE,GAAG,OAAO,CAAC;QAC3F,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC;IA8BF;;;;;;;;;;;OAWG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,CAAC,gBAAgB,GAAG,wBAAwB,CAAC,EAAE,EACjE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAC1D,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IA8BP;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAY/F;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAK5D;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKzC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,eAAe,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,IAAI,CAAC;KACnB,CAAC;CAuBH"}

package/dist/codeIndex/functionIndex.js

@@ -0,0 +1,306 @@
+/**
+ * Function-index access — the `functions` table CRUD, row marshalling, and
+ * per-file upsert/stale-removal. Extracted from `CodeIndexDB`; holds only the
+ * raw SQLite handle. Orchestration that spans concerns (dependency-graph
+ * rebuild after a sync, churn/hotspot/convention mining) stays on the facade.
+ */
+import { tryParseJson } from './shared.js';
+import { computeContentHash } from '../utils/contentHash.js';
+import { errorMessage } from '../utils/errorMessage.js';
+/** Identity key for a function row: name, file path, and line number. */
+function functionRowKey(f) {
+    return `${f.name ?? f.name}:${f.filePath ?? f.file_path}:${f.lineNumber ?? f.line_number}`;
+}
+/** Single-statement upsert for one function row, keyed on
+ *  `(name, file_path, line_number)`. Prepared once and reused across a batch so
+ *  the per-function write path is a bound `.run`, not a re-parse — the
+ *  `ON CONFLICT DO UPDATE` carries both the insert and the update shape, which
+ *  removes the per-function `UPDATE`/`INSERT` decision (and its dynamic SET
+ *  list) that the previous `syncFileIndexRow` re-prepared on every iteration. */
+const SQL_UPSERT_FUNCTION = `
+  INSERT INTO functions (name, file_path, line_number, start_line, end_line, language,
+    entity_type, component_type, return_type, complexity, is_exported, has_jsdoc,
+    jsdoc_description, jsdoc_tags, parameters, type_info, hooks, props,
+    used_imports, unused_imports, import_usage, has_unused_imports, dependency_depth,
+    purpose, context, body, content_hash, file_hash, last_modified, metadata_json)
+  VALUES (@name, @file_path, @line_number, @start_line, @end_line, @language,
+    @entity_type, @component_type, @return_type, @complexity, @is_exported, @has_jsdoc,
+    @jsdoc_description, @jsdoc_tags, @parameters, @type_info, @hooks, @props,
+    @used_imports, @unused_imports, @import_usage, @has_unused_imports, @dependency_depth,
+    @purpose, @context, @body, @content_hash, @file_hash, @last_modified, @metadata_json)
+  ON CONFLICT(name, file_path, line_number) DO UPDATE SET
+    line_number=excluded.line_number, start_line=excluded.start_line, end_line=excluded.end_line,
+    language=excluded.language, entity_type=excluded.entity_type, component_type=excluded.component_type,
+    return_type=excluded.return_type, complexity=excluded.complexity,
+    is_exported=excluded.is_exported, has_jsdoc=excluded.has_jsdoc,
+    jsdoc_description=excluded.jsdoc_description, jsdoc_tags=excluded.jsdoc_tags,
+    parameters=excluded.parameters, type_info=excluded.type_info, hooks=excluded.hooks, props=excluded.props,
+    used_imports=excluded.used_imports, unused_imports=excluded.unused_imports,
+    import_usage=excluded.import_usage, has_unused_imports=excluded.has_unused_imports,
+    dependency_depth=excluded.dependency_depth,
+    purpose=excluded.purpose, context=excluded.context, body=excluded.body,
+    content_hash=excluded.content_hash, file_hash=excluded.file_hash, last_modified=excluded.last_modified,
+    metadata_json=excluded.metadata_json`;
+/** SQLite's bound-variable ceiling for a single statement. The historical
+ *  `SQLITE_MAX_VARIABLE_NUMBER` default is 999 (newer builds raise it to 32766);
+ *  chunking against the older floor keeps one statement valid on every backend. */
+const MAX_SQLITE_BIND_PARAMS = 999;
+/** Delete rows for functions that no longer exist in the current set. Batches
+ *  the stale ids into chunked `id IN (…)` statements — the per-row DELETE that
+ *  preceded this issued one round-trip per removed function, an N+1 on the
+ *  write path when a file loses many functions at once. */
+function removeStaleFunctionRows(db, existing, currentMap, stats) {
+    const staleIds = [];
+    for (const e of existing) {
+        if (!currentMap.has(functionRowKey(e)))
+            staleIds.push(e.id);
+    }
+    for (let i = 0; i < staleIds.length; i += MAX_SQLITE_BIND_PARAMS) {
+        const chunk = staleIds.slice(i, i + MAX_SQLITE_BIND_PARAMS);
+        const placeholders = chunk.map(() => '?').join(', ');
+        const result = db
+            .prepare(`DELETE FROM functions WHERE id IN (${placeholders})`)
+            .run(...chunk);
+        stats.removed += result.changes;
+    }
+}
+/**
+ * Data access for the `functions` table: CRUD, row marshalling, and per-file
+ * upsert/stale-removal.
+ */
+export class FunctionIndex {
+    db;
+    /**
+     * Wrap the shared SQLite handle for function-index access.
+     * @param db the SQLite database handle.
+     */
+    constructor(db) {
+        this.db = db;
+    }
+    /** The single-function upsert statement, parsed once and reused across a
+     *  batch. Lazily prepared because the first caller may be either the
+     *  per-function `registerFunction` path or the per-file `syncFileIndexRow`
+     *  batch path. */
+    upsertStmt;
+    functionUpsertStmt() {
+        return (this.upsertStmt ??= this.db.prepare(SQL_UPSERT_FUNCTION));
+    }
+    /**
+     * Marshal a DB row into the `EnhancedFunctionMetadata` shape consumers read.
+     * @param row the raw `functions` table row.
+     * @returns the function metadata with parsed parameters, jsDoc, and metadata fields.
+     */
+    rowToFunction(row) {
+        return {
+            name: row.name,
+            filePath: row.file_path,
+            lineNumber: row.line_number,
+            startLine: row.start_line,
+            endLine: row.end_line,
+            language: row.language,
+            dependencies: [],
+            purpose: row.purpose ?? '',
+            context: row.context ?? '',
+            parameters: tryParseJson(row.parameters) ?? [],
+            jsDoc: { description: row.jsdoc_description ?? '' },
+            imports: [],
+            body: row.body ?? '',
+            comments: [],
+            isAsync: false,
+            isGenerator: false,
+            returnType: row.return_type,
+            visibility: 'public',
+            complexity: row.complexity ?? 0,
+            content_hash: row.content_hash,
+            metadata: tryParseJson(row.metadata_json) ?? {},
+            hooks: tryParseJson(row.hooks),
+            props: tryParseJson(row.props),
+        };
+    }
+    /**
+     * Marshal function metadata into the row shape the `functions` table stores.
+     * @param func the function metadata to convert.
+     * @param lastModified optional last-modified timestamp to stamp on the row.
+     * @param fileHash optional file-level content hash stamped onto the row's
+     *   `file_hash` column for diff detection.
+     * @returns the row object keyed by the table's column names.
+     */
+    functionToRow(func, lastModified, fileHash) {
+        const enhanced = func;
+        const jsDoc = func.jsDoc;
+        return {
+            name: func.name,
+            file_path: func.filePath,
+            line_number: func.lineNumber ?? 0,
+            start_line: func.startLine ?? null,
+            end_line: func.endLine ?? null,
+            language: func.language ?? 'typescript',
+            entity_type: func.metadata?.entityType ?? 'function',
+            component_type: func.metadata?.componentType ?? null,
+            return_type: enhanced.returnType ?? null,
+            complexity: enhanced.complexity ?? func.metadata?.complexity ?? 0,
+            is_exported: func.metadata?.isExported ? 1 : 0,
+            has_jsdoc: (jsDoc && jsDoc.description) ? 1 : 0,
+            jsdoc_description: typeof jsDoc === 'string' ? jsDoc : (jsDoc?.description ?? ''),
+            jsdoc_tags: jsDoc?.tags ? JSON.stringify(jsDoc.tags) : null,
+            parameters: enhanced.parameters ? JSON.stringify(enhanced.parameters) : null,
+            type_info: func.metadata?.typeInfo ? JSON.stringify(func.metadata.typeInfo) : null,
+            hooks: enhanced.hooks ? JSON.stringify(enhanced.hooks) : null,
+            props: enhanced.props ? JSON.stringify(enhanced.props) : null,
+            used_imports: func.metadata?.usedImports ? JSON.stringify(func.metadata.usedImports) : null,
+            unused_imports: func.metadata?.unusedImports ? JSON.stringify(func.metadata.unusedImports) : null,
+            import_usage: func.metadata?.importUsage ? JSON.stringify(func.metadata.importUsage) : null,
+            has_unused_imports: func.metadata?.unusedImports?.length > 0 ? 1 : 0,
+            dependency_depth: func.metadata?.dependencyDepth ?? 0,
+            purpose: func.purpose ?? '',
+            context: func.context ?? '',
+            body: func.body ?? null,
+            content_hash: enhanced.content_hash ?? computeContentHash(func.body),
+            file_hash: fileHash ?? null,
+            last_modified: lastModified ?? new Date().toISOString(),
+            // body lives only in the dedicated `body` column, never in metadata_json
+            // (previously triple-stored). JSON.stringify omits the undefined value, so
+            // this strips any stray `body` key at the write boundary.
+            metadata_json: func.metadata ? JSON.stringify({ ...func.metadata, body: undefined }) : '{}',
+        };
+    }
+    /**
+     * Insert or update a single function row (upsert keyed on name, file, line).
+     * @param func the function metadata to persist.
+     * @returns a promise that resolves once the row is upserted
+     */
+    async registerFunction(func) {
+        const row = this.functionToRow(func);
+        try {
+            this.functionUpsertStmt().run(row);
+        }
+        catch (error) {
+            throw new Error(`Failed to register function: ${errorMessage(error)}`);
+        }
+    }
+    /**
+     * Register many functions in one transaction, reporting per-function errors.
+     * @param functions the function metadata records to persist.
+     * @returns a summary with a success flag, registered/failed counts, and per-function error details.
+     */
+    async registerFunctions(functions) {
+        let registered = 0;
+        let failed = 0;
+        const errors = [];
+        const insertAll = this.db.transaction((funcs) => {
+            for (const func of funcs) {
+                try {
+                    this.registerFunction(func);
+                    registered++;
+                }
+                catch (error) {
+                    failed++;
+                    errors.push({
+                        function: func.name || 'unknown',
+                        error: errorMessage(error)
+                    });
+                }
+            }
+        });
+        insertAll(functions);
+        return {
+            success: failed === 0,
+            registered,
+            failed,
+            errors: errors
+        };
+    }
+    /**
+     * Upsert/remove one file's function rows. Runs inside the caller's
+     * transaction (no nested `db.transaction` here) so a batch sync can wrap many
+     * files in a single write transaction.
+     *
+     * @param filePath the file whose function rows are being synced.
+     * @param currentFunctions the functions present in the file now.
+     * @param stats accumulator the add/update/remove counts are written into.
+     * @param lastModified optional last-modified timestamp to stamp on written rows.
+     * @param fileHash optional file-level content hash stamped onto each written row
+     *   for diff detection.
+     */
+    syncFileIndexRow(filePath, currentFunctions, stats, lastModified, fileHash) {
+        const existing = this.db.prepare('SELECT id, name, file_path, line_number FROM functions WHERE file_path = ?').all(filePath);
+        const currentMap = new Map(currentFunctions.map(f => [functionRowKey(f), f]));
+        // Existing rows keyed by (name, line_number) — file_path is already scoped by
+        // the SELECT above — so added-vs-updated is an O(1) map hit instead of the
+        // O(n²) `existing.find` scan this replaced.
+        const existingByKey = new Map(existing.map((e) => [`${e.name}:${e.line_number}`, e]));
+        // Single prepared upsert reused across the whole file batch: one parse, one
+        // bound `.run` per function. `ON CONFLICT DO UPDATE` collapses the previous
+        // per-function `UPDATE` vs `INSERT` branch (and its dynamic SET list) into a
+        // single statement, removing the prepare-per-iteration N+1 on this write path.
+        const upsert = this.functionUpsertStmt();
+        for (const func of currentFunctions) {
+            const key = `${func.name}:${func.lineNumber}`;
+            upsert.run(this.functionToRow(func, lastModified, fileHash));
+            if (existingByKey.has(key))
+                stats.updated++;
+            else
+                stats.added++;
+        }
+        // Remove stale functions
+        removeStaleFunctionRows(this.db, existing, currentMap, stats);
+    }
+    /**
+     * Resolve one indexed function by name, optionally scoped to a file.
+     * @param name the function name to look up.
+     * @param filePath when given, restrict the match to that file.
+     * @returns the matching function, or null when no row matches.
+     */
+    async findDefinition(name, filePath) {
+        let row;
+        if (filePath) {
+            row = this.db.prepare('SELECT * FROM functions WHERE name = ? AND file_path = ?').get(name, filePath);
+        }
+        else {
+            row = this.db.prepare('SELECT * FROM functions WHERE name = ?').get(name);
+        }
+        if (!row)
+            return null;
+        return this.rowToFunction(row);
+    }
+    /**
+     * Return all indexed functions.
+     * @returns every function row marshalled into metadata.
+     */
+    async getAllFunctions() {
+        const rows = this.db.prepare('SELECT * FROM functions').all();
+        return rows.map((r) => this.rowToFunction(r));
+    }
+    /**
+     * Row count of the `functions` table — for callers that only need `.length`.
+     * @returns the number of indexed function rows.
+     */
+    async getFunctionCount() {
+        const row = this.db.prepare('SELECT COUNT(*) AS n FROM functions').get();
+        return row?.n ?? 0;
+    }
+    /**
+     * Compute aggregate index statistics (function count, languages, top
+     * dependencies, files indexed, and last-updated time).
+     * @returns the aggregate stats object.
+     */
+    async getStats() {
+        const totalFunctions = this.db.prepare('SELECT COUNT(*) as cnt FROM functions').get().cnt;
+        const languages = {};
+        const langRows = this.db.prepare('SELECT language, COUNT(*) as cnt FROM functions GROUP BY language').all();
+        for (const r of langRows) {
+            languages[r.language] = r.cnt;
+        }
+        const depRows = this.db.prepare('SELECT dependency as name, COUNT(*) as cnt FROM function_dependencies GROUP BY dependency ORDER BY cnt DESC LIMIT 10').all();
+        const topDependencies = depRows.map((r) => ({ name: r.name, count: r.cnt }));
+        const filesIndexed = this.db.prepare('SELECT COUNT(DISTINCT file_path) as cnt FROM functions').get().cnt;
+        return {
+            totalFunctions,
+            languages,
+            topDependencies,
+            filesIndexed,
+            lastUpdated: new Date()
+        };
+    }
+}
+//# sourceMappingURL=functionIndex.js.map

package/dist/codeIndex/functionIndex.js.map

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

package/dist/codeIndex/inferredReceivers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Inferred-receiver storage. Extracted from `CodeIndexDB`; persists the
+ * inferred receiver set as a single meta record. Builds on `MetaStore`.
+ */
+import type { SqliteDatabase } from '../sqlite/types.js';
+export interface InferredReceiver {
+    identifier: string;
+    file: string;
+    reason: string;
+}
+/**
+ * Storage for the inferred receiver set, persisted as a single meta record on
+ * the shared SQLite handle through a MetaStore.
+ */
+export declare class InferredReceiversStore {
+    private readonly meta;
+    /**
+     * Create the store over the shared SQLite handle.
+     *
+     * @param db The SQLite database handle.
+     */
+    constructor(db: SqliteDatabase);
+    /** Store the inferred receiver set as a meta record. */
+    storeInferredReceivers(inferred: InferredReceiver[]): void;
+    /**
+     * Retrieve the inferred receiver set, or null if not stored.
+     *
+     * @returns The parsed receiver set, or null when absent or unparseable.
+     */
+    getInferredReceivers(): InferredReceiver[] | null;
+}
+//# sourceMappingURL=inferredReceivers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inferredReceivers.d.ts","sourceRoot":"","sources":["../../src/codeIndex/inferredReceivers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IAEjC;;;;OAIG;gBACS,EAAE,EAAE,cAAc;IAI9B,wDAAwD;IACxD,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAI1D;;;;OAIG;IACH,oBAAoB,IAAI,gBAAgB,EAAE,GAAG,IAAI;CASlD"}

package/dist/codeIndex/inferredReceivers.js

@@ -0,0 +1,41 @@
+/**
+ * Inferred-receiver storage. Extracted from `CodeIndexDB`; persists the
+ * inferred receiver set as a single meta record. Builds on `MetaStore`.
+ */
+import { MetaStore } from './meta.js';
+/**
+ * Storage for the inferred receiver set, persisted as a single meta record on
+ * the shared SQLite handle through a MetaStore.
+ */
+export class InferredReceiversStore {
+    meta;
+    /**
+     * Create the store over the shared SQLite handle.
+     *
+     * @param db The SQLite database handle.
+     */
+    constructor(db) {
+        this.meta = new MetaStore(db);
+    }
+    /** Store the inferred receiver set as a meta record. */
+    storeInferredReceivers(inferred) {
+        this.meta.setMeta('inferred_receivers', JSON.stringify(inferred));
+    }
+    /**
+     * Retrieve the inferred receiver set, or null if not stored.
+     *
+     * @returns The parsed receiver set, or null when absent or unparseable.
+     */
+    getInferredReceivers() {
+        const raw = this.meta.getMeta('inferred_receivers');
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=inferredReceivers.js.map

package/dist/codeIndex/inferredReceivers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferredReceivers.js","sourceRoot":"","sources":["../../src/codeIndex/inferredReceivers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAQtC;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAChB,IAAI,CAAY;IAEjC;;;;OAIG;IACH,YAAY,EAAkB;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,wDAAwD;IACxD,sBAAsB,CAAC,QAA4B;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/codeIndex/meta.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Key-value store over the `meta` table. Extracted from `CodeIndexDB`; holds
+ * only the raw SQLite handle. Provenance and inferred-receivers build on this
+ * store rather than reaching back into the facade.
+ */
+import type { SqliteDatabase } from '../sqlite/types.js';
+/**
+ * Key-value store over the `meta` table, holding string values keyed by name.
+ */
+export declare class MetaStore {
+    private db;
+    /**
+     * Wrap the shared SQLite handle for meta key-value access.
+     * @param db the SQLite database handle.
+     */
+    constructor(db: SqliteDatabase);
+    /**
+     * Upsert a key-value pair in the meta table.
+     * @param key the meta key to write.
+     * @param value the string value stored under that key.
+     */
+    setMeta(key: string, value: string): void;
+    /**
+     * Retrieve a value from the meta table, or null if absent.
+     * @param key the meta key to read.
+     * @returns the stored value, or null when the key is not present.
+     */
+    getMeta(key: string): string | null;
+}
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/codeIndex/meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,qBAAa,SAAS;IAKR,OAAO,CAAC,EAAE;IAJtB;;;OAGG;gBACiB,EAAE,EAAE,cAAc;IAEtC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAMpC"}

package/dist/codeIndex/meta.js

@@ -0,0 +1,37 @@
+/**
+ * Key-value store over the `meta` table. Extracted from `CodeIndexDB`; holds
+ * only the raw SQLite handle. Provenance and inferred-receivers build on this
+ * store rather than reaching back into the facade.
+ */
+/**
+ * Key-value store over the `meta` table, holding string values keyed by name.
+ */
+export class MetaStore {
+    db;
+    /**
+     * Wrap the shared SQLite handle for meta key-value access.
+     * @param db the SQLite database handle.
+     */
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Upsert a key-value pair in the meta table.
+     * @param key the meta key to write.
+     * @param value the string value stored under that key.
+     */
+    setMeta(key, value) {
+        this.db.prepare(`INSERT INTO meta (key, value) VALUES (?, ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(key, value);
+    }
+    /**
+     * Retrieve a value from the meta table, or null if absent.
+     * @param key the meta key to read.
+     * @returns the stored value, or null when the key is not present.
+     */
+    getMeta(key) {
+        const row = this.db.prepare('SELECT value FROM meta WHERE key = ?').get(key);
+        return row?.value ?? null;
+    }
+}
+//# sourceMappingURL=meta.js.map

package/dist/codeIndex/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/codeIndex/meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,OAAO,SAAS;IAKA;IAJpB;;;OAGG;IACH,YAAoB,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAE1C;;;;OAIG;IACH,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,IAAI,CAAC,EAAE,CAAC,OAAO,CACb;6DACuD,CACxD,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACzB,sCAAsC,CACvC,CAAC,GAAG,CAAC,GAAG,CAAkC,CAAC;QAC5C,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5B,CAAC;CACF"}