@zbigniewsobiecki/squint 1.0.0

package/dist/db/repositories/interaction-repository.js

@@ -0,0 +1,395 @@
+import { ensureInteractionsTables, ensureModulesTables } from '../schema-manager.js';
+import { queryCallGraphEdges } from './_shared/call-graph-query.js';
+const INTERACTION_COLS = `
+  id,
+  from_module_id as fromModuleId,
+  to_module_id as toModuleId,
+  direction,
+  weight,
+  pattern,
+  symbols,
+  semantic,
+  source,
+  confidence,
+  created_at as createdAt`;
+const INTERACTION_WITH_PATHS_SELECT = `
+  SELECT
+    i.id,
+    i.from_module_id as fromModuleId,
+    i.to_module_id as toModuleId,
+    i.direction,
+    i.weight,
+    i.pattern,
+    i.symbols,
+    i.semantic,
+    i.source,
+    i.confidence,
+    i.created_at as createdAt,
+    from_m.full_path as fromModulePath,
+    to_m.full_path as toModulePath
+  FROM interactions i
+  JOIN modules from_m ON i.from_module_id = from_m.id
+  JOIN modules to_m ON i.to_module_id = to_m.id`;
+function parseSymbols(row) {
+    if (row.symbols) {
+        row.symbols = JSON.parse(row.symbols);
+    }
+    return row;
+}
+/**
+ * Repository for interaction (module-to-module edge) operations.
+ */
+export class InteractionRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Insert a new interaction.
+     * Throws if an interaction between these modules already exists.
+     */
+    insert(fromModuleId, toModuleId, options) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare(`
+      INSERT INTO interactions (from_module_id, to_module_id, direction, weight, pattern, symbols, semantic, source, confidence)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const result = stmt.run(fromModuleId, toModuleId, options?.direction ?? 'uni', options?.weight ?? 1, options?.pattern ?? null, options?.symbols ? JSON.stringify(options.symbols) : null, options?.semantic ?? null, options?.source ?? 'ast', options?.confidence ?? null);
+        return result.lastInsertRowid;
+    }
+    /**
+     * Upsert an interaction (insert or update on conflict).
+     */
+    upsert(fromModuleId, toModuleId, options) {
+        ensureInteractionsTables(this.db);
+        const existing = this.getByModules(fromModuleId, toModuleId);
+        if (existing) {
+            this.update(existing.id, {
+                direction: options?.direction,
+                pattern: options?.pattern,
+                symbols: options?.symbols,
+                semantic: options?.semantic,
+            });
+            // Update weight separately if provided
+            if (options?.weight !== undefined) {
+                this.db.prepare('UPDATE interactions SET weight = ? WHERE id = ?').run(options.weight, existing.id);
+            }
+            // Update confidence if provided
+            if (options?.confidence !== undefined) {
+                this.db.prepare('UPDATE interactions SET confidence = ? WHERE id = ?').run(options.confidence, existing.id);
+            }
+            return existing.id;
+        }
+        return this.insert(fromModuleId, toModuleId, options);
+    }
+    /**
+     * Get interaction by ID.
+     */
+    getById(id) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare(`SELECT ${INTERACTION_COLS} FROM interactions WHERE id = ?`);
+        const row = stmt.get(id);
+        if (!row)
+            return null;
+        return parseSymbols(row);
+    }
+    /**
+     * Get interaction by module pair.
+     */
+    getByModules(fromModuleId, toModuleId) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare(`SELECT ${INTERACTION_COLS} FROM interactions WHERE from_module_id = ? AND to_module_id = ?`);
+        const row = stmt.get(fromModuleId, toModuleId);
+        if (!row)
+            return null;
+        return parseSymbols(row);
+    }
+    /**
+     * Get all interactions with module paths.
+     */
+    getAll() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        return this.db.prepare(`${INTERACTION_WITH_PATHS_SELECT} ORDER BY i.weight DESC`).all();
+    }
+    /**
+     * Get interactions by pattern.
+     */
+    getByPattern(pattern) {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        return this.db
+            .prepare(`${INTERACTION_WITH_PATHS_SELECT} WHERE i.pattern = ? ORDER BY i.weight DESC`)
+            .all(pattern);
+    }
+    /**
+     * Get interactions from a specific module.
+     */
+    getFromModule(moduleId) {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        return this.db
+            .prepare(`${INTERACTION_WITH_PATHS_SELECT} WHERE i.from_module_id = ? ORDER BY i.weight DESC`)
+            .all(moduleId);
+    }
+    /**
+     * Get interactions to a specific module.
+     */
+    getToModule(moduleId) {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        return this.db
+            .prepare(`${INTERACTION_WITH_PATHS_SELECT} WHERE i.to_module_id = ? ORDER BY i.weight DESC`)
+            .all(moduleId);
+    }
+    /**
+     * Update an interaction.
+     */
+    update(id, updates) {
+        ensureInteractionsTables(this.db);
+        const sets = [];
+        const params = [];
+        if (updates.direction !== undefined) {
+            sets.push('direction = ?');
+            params.push(updates.direction);
+        }
+        if (updates.pattern !== undefined) {
+            sets.push('pattern = ?');
+            params.push(updates.pattern);
+        }
+        if (updates.symbols !== undefined) {
+            sets.push('symbols = ?');
+            params.push(JSON.stringify(updates.symbols));
+        }
+        if (updates.semantic !== undefined) {
+            sets.push('semantic = ?');
+            params.push(updates.semantic);
+        }
+        if (sets.length === 0)
+            return false;
+        params.push(String(id));
+        const stmt = this.db.prepare(`UPDATE interactions SET ${sets.join(', ')} WHERE id = ?`);
+        const result = stmt.run(...params);
+        return result.changes > 0;
+    }
+    /**
+     * Delete an interaction.
+     */
+    delete(id) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare('DELETE FROM interactions WHERE id = ?');
+        const result = stmt.run(id);
+        return result.changes > 0;
+    }
+    /**
+     * Delete all interactions.
+     */
+    clear() {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare('DELETE FROM interactions');
+        const result = stmt.run();
+        return result.changes;
+    }
+    /**
+     * Get count of interactions.
+     */
+    getCount() {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare('SELECT COUNT(*) as count FROM interactions');
+        const row = stmt.get();
+        return row.count;
+    }
+    /**
+     * Get interaction statistics.
+     */
+    getStats() {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT
+        COUNT(*) as totalCount,
+        SUM(CASE WHEN pattern = 'business' THEN 1 ELSE 0 END) as businessCount,
+        SUM(CASE WHEN pattern = 'utility' THEN 1 ELSE 0 END) as utilityCount,
+        SUM(CASE WHEN direction = 'bi' THEN 1 ELSE 0 END) as biDirectionalCount
+      FROM interactions
+    `);
+        return stmt.get();
+    }
+    /**
+     * Get interactions by source type.
+     */
+    getBySource(source) {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        return this.db
+            .prepare(`${INTERACTION_WITH_PATHS_SELECT} WHERE i.source = ? ORDER BY i.weight DESC`)
+            .all(source);
+    }
+    /**
+     * Get count of interactions by source type.
+     */
+    getCountBySource(source) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare('SELECT COUNT(*) as count FROM interactions WHERE source = ?');
+        const row = stmt.get(source);
+        return row.count;
+    }
+    /**
+     * Remove all llm-inferred interactions targeting a specific module.
+     * Used by fan-in anomaly detection to bulk-remove hallucinated connections.
+     */
+    removeInferredToModule(targetModuleId) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare("DELETE FROM interactions WHERE to_module_id = ? AND source = 'llm-inferred'");
+        const result = stmt.run(targetModuleId);
+        return result.changes;
+    }
+    // ============================================================
+    // Definition-Level Call Graph (for flow tracing)
+    // ============================================================
+    /**
+     * Get the definition-level call graph (not aggregated to modules).
+     * Returns edges from caller definition to called definition.
+     */
+    getDefinitionCallGraph() {
+        return this.getCallGraphInternal();
+    }
+    /**
+     * Get the definition-level call graph as a Map for efficient lookups.
+     * Maps from_definition_id to array of to_definition_ids.
+     */
+    getDefinitionCallGraphMap() {
+        const edges = this.getCallGraphInternal();
+        const result = new Map();
+        for (const edge of edges) {
+            const existing = result.get(edge.fromId) ?? [];
+            existing.push(edge.toId);
+            result.set(edge.fromId, existing);
+        }
+        return result;
+    }
+    // ============================================================
+    // Process Group Detection Methods
+    // ============================================================
+    /**
+     * Get all non-type-only, internal file import edges.
+     * Used to build the import graph for process group detection.
+     */
+    getRuntimeImportEdges() {
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT from_file_id as fromFileId, to_file_id as toFileId
+      FROM imports
+      WHERE to_file_id IS NOT NULL AND is_type_only = 0
+    `);
+        return stmt.all();
+    }
+    /**
+     * Get file-to-module mapping via module_members → definitions → files.
+     * Returns a Map from fileId to moduleId.
+     */
+    getFileToModuleMap() {
+        ensureModulesTables(this.db);
+        const rows = this.db
+            .prepare(`
+        SELECT DISTINCT d.file_id, mm.module_id
+        FROM module_members mm
+        JOIN definitions d ON mm.definition_id = d.id
+      `)
+            .all();
+        const result = new Map();
+        for (const row of rows) {
+            result.set(row.file_id, row.module_id);
+        }
+        return result;
+    }
+    // ============================================================
+    // Import-Based Module Pair Detection
+    // ============================================================
+    /**
+     * Get module pairs connected by imports but with no existing interaction.
+     * Fills the gap between call-graph detection (calls only) and the full import graph.
+     */
+    getImportOnlyModulePairs() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT
+        from_mm.module_id as fromModuleId,
+        to_mm.module_id as toModuleId,
+        GROUP_CONCAT(DISTINCT to_d.name) as symbolNames,
+        COUNT(DISTINCT s.id) as weight,
+        MIN(i.is_type_only) as isTypeOnly
+      FROM module_members from_mm
+      JOIN definitions from_d ON from_mm.definition_id = from_d.id
+      JOIN imports i ON i.from_file_id = from_d.file_id
+      JOIN symbols s ON s.reference_id = i.id AND s.definition_id IS NOT NULL
+      JOIN definitions to_d ON s.definition_id = to_d.id
+      JOIN module_members to_mm ON to_mm.definition_id = to_d.id
+      WHERE from_mm.module_id != to_mm.module_id
+        AND NOT EXISTS (
+          SELECT 1 FROM interactions
+          WHERE from_module_id = from_mm.module_id
+            AND to_module_id = to_mm.module_id
+        )
+      GROUP BY from_mm.module_id, to_mm.module_id
+    `);
+        return stmt.all().map((row) => ({
+            fromModuleId: row.fromModuleId,
+            toModuleId: row.toModuleId,
+            symbols: row.symbolNames ? row.symbolNames.split(',') : [],
+            weight: row.weight,
+            isTypeOnly: row.isTypeOnly === 1,
+        }));
+    }
+    // ============================================================
+    // Import Path & Validation Methods
+    // ============================================================
+    /**
+     * Check if any file in fromModule imports from any file in toModule.
+     * Join: module_members → definitions → files → imports → files → definitions → module_members
+     */
+    hasModuleImportPath(fromModuleId, toModuleId) {
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT EXISTS (
+        SELECT 1
+        FROM module_members from_mm
+        JOIN definitions from_d ON from_mm.definition_id = from_d.id
+        JOIN files from_f ON from_d.file_id = from_f.id
+        JOIN imports i ON i.from_file_id = from_f.id
+        JOIN files to_f ON i.to_file_id = to_f.id
+        JOIN definitions to_d ON to_d.file_id = to_f.id
+        JOIN module_members to_mm ON to_mm.definition_id = to_d.id
+        WHERE from_mm.module_id = ? AND to_mm.module_id = ?
+      ) as has_path
+    `);
+        const row = stmt.get(fromModuleId, toModuleId);
+        return row.has_path === 1;
+    }
+    /**
+     * Get actual symbols that fromModule imports from toModule.
+     * Returns symbol names and kinds for enriching prompts and deriving `symbols` field.
+     */
+    getModuleImportedSymbols(fromModuleId, toModuleId) {
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT to_d.name, to_d.kind
+      FROM module_members from_mm
+      JOIN definitions from_d ON from_mm.definition_id = from_d.id
+      JOIN files from_f ON from_d.file_id = from_f.id
+      JOIN imports imp ON imp.from_file_id = from_f.id
+      JOIN symbols s ON s.reference_id = imp.id AND s.definition_id IS NOT NULL
+      JOIN definitions to_d ON s.definition_id = to_d.id
+      JOIN module_members to_mm ON to_mm.definition_id = to_d.id
+      WHERE from_mm.module_id = ? AND to_mm.module_id = ?
+      ORDER BY to_d.name
+    `);
+        return stmt.all(fromModuleId, toModuleId);
+    }
+    // ============================================================
+    // Private helpers
+    // ============================================================
+    getCallGraphInternal() {
+        return queryCallGraphEdges(this.db, { includeJsx: true });
+    }
+}
+//# sourceMappingURL=interaction-repository.js.map

package/dist/db/repositories/interaction-repository.js.map

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

package/dist/db/repositories/metadata-repository.d.ts

@@ -0,0 +1,110 @@
+import type Database from 'better-sqlite3';
+export interface AspectCoverage {
+    aspect: string;
+    covered: number;
+    total: number;
+    percentage: number;
+}
+export interface SymbolWithDomain {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    domains: string[];
+    purpose: string | null;
+}
+export interface SymbolWithPurity {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    purpose: string | null;
+}
+/**
+ * Repository for definition metadata operations.
+ * Handles CRUD operations for the definition_metadata table.
+ */
+export declare class MetadataRepository {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Set metadata on a definition (insert or replace)
+     */
+    set(definitionId: number, key: string, value: string): void;
+    /**
+     * Remove a metadata key from a definition
+     */
+    remove(definitionId: number, key: string): boolean;
+    /**
+     * Get all metadata for a definition
+     */
+    get(definitionId: number): Record<string, string>;
+    /**
+     * Get a single metadata value for a definition
+     */
+    getValue(definitionId: number, key: string): string | null;
+    /**
+     * Get definition IDs that have a specific metadata key set
+     */
+    getDefinitionsWith(key: string): number[];
+    /**
+     * Get definition IDs that do NOT have a specific metadata key set
+     */
+    getDefinitionsWithout(key: string): number[];
+    /**
+     * Get all unique metadata keys (aspects) in use
+     */
+    getKeys(): string[];
+    /**
+     * Get count of definitions matching filters
+     */
+    getFilteredCount(filters?: {
+        kind?: string;
+        filePattern?: string;
+    }): number;
+    /**
+     * Get coverage stats for aspects (metadata keys).
+     * Returns the number of definitions that have each aspect defined.
+     */
+    getAspectCoverage(filters?: {
+        kind?: string;
+        filePattern?: string;
+    }): AspectCoverage[];
+    /**
+     * Get all unique domains used across all symbols.
+     * Domain is stored as a JSON array in the 'domain' metadata key.
+     */
+    getAllDomains(): string[];
+    /**
+     * Get symbols that have a specific domain tag.
+     * Domain is stored as a JSON array in the 'domain' metadata key.
+     */
+    getSymbolsByDomain(domain: string): SymbolWithDomain[];
+    /**
+     * Get definitions that have no metadata at all (not in definition_metadata table).
+     */
+    getDefinitionsWithNoMetadata(options?: {
+        kind?: string;
+        limit?: number;
+    }): Array<{
+        id: number;
+        name: string;
+        kind: string;
+        filePath: string;
+        line: number;
+    }>;
+    /**
+     * Get count of definitions that have no metadata at all.
+     */
+    getDefinitionsWithNoMetadataCount(options?: {
+        kind?: string;
+    }): number;
+    /**
+     * Get symbols filtered by purity (pure = no side effects).
+     * Returns symbols where 'pure' metadata matches the specified value.
+     */
+    getSymbolsByPurity(isPure: boolean): SymbolWithPurity[];
+}
+//# sourceMappingURL=metadata-repository.d.ts.map

package/dist/db/repositories/metadata-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-repository.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/metadata-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3D;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IASlD;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAajD;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAS1D;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IASzC;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAY5C;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IASnB;;OAEG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAsB3E;;;OAGG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,EAAE;IAkEtF;;;OAGG;IACH,aAAa,IAAI,MAAM,EAAE;IAoBzB;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAwCtD;;OAEG;IACH,4BAA4B,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAC/E,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IA4BF;;OAEG;IACH,iCAAiC,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAkBtE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE;CAmBxD"}