@zbigniewsobiecki/squint 1.0.0

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

@@ -0,0 +1,78 @@
+import type Database from 'better-sqlite3';
+import type { CallsiteResult, DependencyInfo, DependencyWithMetadata, IncomingDependency, ReadySymbolInfo } from '../schema.js';
+export interface ImportGraphNode {
+    id: number;
+    name: string;
+    kind: string;
+}
+export interface ImportGraphLink {
+    source: number;
+    target: number;
+    type: string;
+}
+export declare class DependencyRepository {
+    private db;
+    constructor(db: Database.Database);
+    getCallsites(definitionId: number): CallsiteResult[];
+    getCallsitesForFile(fileId: number): CallsiteResult[];
+    getCallsiteCount(): number;
+    /**
+     * Get incoming dependencies - symbols that use this definition.
+     * This finds all definitions that have usages pointing to this definition.
+     */
+    getIncoming(definitionId: number, limit?: number): IncomingDependency[];
+    /**
+     * Get count of incoming dependencies - how many symbols use this definition.
+     */
+    getIncomingCount(definitionId: number): number;
+    /**
+     * Get all symbols that a definition depends on (uses within its line range).
+     * This finds usages within the definition's code that reference other definitions.
+     */
+    getForDefinition(definitionId: number): DependencyInfo[];
+    /**
+     * Get dependencies with their metadata status for a specific aspect.
+     * Combines dependency lookup with metadata check in a single efficient query.
+     */
+    getWithMetadata(definitionId: number, aspect?: string): DependencyWithMetadata[];
+    /**
+     * Get dependencies that don't have a specific aspect set.
+     * Orders by dependency count (leaf nodes first) for topological processing.
+     */
+    getUnmet(definitionId: number, aspect: string): DependencyInfo[];
+    /**
+     * Get the full prerequisite chain for understanding a symbol.
+     * Returns unmet dependencies in topological order (leaves first).
+     * Handles circular dependencies by tracking visited nodes.
+     */
+    getPrerequisiteChain(definitionId: number, aspect: string, getDefinitionById: (id: number) => {
+        name: string;
+        kind: string;
+        filePath: string;
+        line: number;
+    } | null): Array<DependencyInfo & {
+        unmetDepCount: number;
+    }>;
+    /**
+     * Find symbols that are "ready to understand" for a given aspect.
+     * A symbol is ready when all its dependencies already have the aspect set (or it has no dependencies).
+     * Excludes symbols that already have the aspect set.
+     */
+    getReadySymbols(aspect: string, options?: {
+        limit?: number;
+        kind?: string;
+        filePattern?: string;
+    }): {
+        symbols: ReadySymbolInfo[];
+        totalReady: number;
+        remaining: number;
+    };
+    /**
+     * Get import dependency graph data for D3 visualization
+     */
+    getImportGraph(): {
+        nodes: ImportGraphNode[];
+        links: ImportGraphLink[];
+    };
+}
+//# sourceMappingURL=dependency-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-repository.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/dependency-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE;IA6EpD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAsDrD,gBAAgB,IAAI,MAAM;IAU1B;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,kBAAkB,EAAE;IAwBlE;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAiB9C;;;OAGG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE;IA2BxD;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,sBAAsB,EAAE;IA8ChF;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IA6BhE;;;;OAIG;IACH,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GACvG,KAAK,CAAC,cAAc,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IA8CpD;;;;OAIG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAyHxE;;OAEG;IACH,cAAc,IAAI;QAChB,KAAK,EAAE,eAAe,EAAE,CAAC;QACzB,KAAK,EAAE,eAAe,EAAE,CAAC;KAC1B;CAkBF"}

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

@@ -0,0 +1,446 @@
+export class DependencyRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getCallsites(definitionId) {
+        // Query for both imported and internal call sites using UNION
+        const stmt = this.db.prepare(`
+      SELECT
+        u.id as usage_id,
+        u.symbol_id,
+        s.definition_id,
+        f.path as file_path,
+        u.line,
+        u.column,
+        s.name as symbol_name,
+        s.local_name,
+        u.argument_count,
+        u.is_method_call,
+        u.is_constructor_call,
+        u.receiver_name
+      FROM usages u
+      JOIN symbols s ON u.symbol_id = s.id
+      JOIN imports i ON s.reference_id = i.id
+      JOIN files f ON i.from_file_id = f.id
+      WHERE s.definition_id = ?
+        AND (u.context = 'call_expression' OR u.context = 'new_expression')
+        AND u.argument_count IS NOT NULL
+      UNION ALL
+      SELECT
+        u.id as usage_id,
+        u.symbol_id,
+        s.definition_id,
+        f.path as file_path,
+        u.line,
+        u.column,
+        s.name as symbol_name,
+        s.local_name,
+        u.argument_count,
+        u.is_method_call,
+        u.is_constructor_call,
+        u.receiver_name
+      FROM usages u
+      JOIN symbols s ON u.symbol_id = s.id
+      JOIN files f ON s.file_id = f.id
+      WHERE s.definition_id = ?
+        AND s.reference_id IS NULL
+        AND (u.context = 'call_expression' OR u.context = 'new_expression')
+        AND u.argument_count IS NOT NULL
+      ORDER BY file_path, line
+    `);
+        const rows = stmt.all(definitionId, definitionId);
+        return rows.map((row) => ({
+            usageId: row.usage_id,
+            symbolId: row.symbol_id,
+            definitionId: row.definition_id,
+            filePath: row.file_path,
+            line: row.line,
+            column: row.column,
+            symbolName: row.symbol_name,
+            localName: row.local_name,
+            argumentCount: row.argument_count,
+            isMethodCall: row.is_method_call === 1,
+            isConstructorCall: row.is_constructor_call === 1,
+            receiverName: row.receiver_name,
+        }));
+    }
+    getCallsitesForFile(fileId) {
+        const stmt = this.db.prepare(`
+      SELECT
+        u.id as usage_id,
+        u.symbol_id,
+        s.definition_id,
+        f.path as file_path,
+        u.line,
+        u.column,
+        s.name as symbol_name,
+        s.local_name,
+        u.argument_count,
+        u.is_method_call,
+        u.is_constructor_call,
+        u.receiver_name
+      FROM usages u
+      JOIN symbols s ON u.symbol_id = s.id
+      JOIN imports i ON s.reference_id = i.id
+      JOIN files f ON i.from_file_id = f.id
+      WHERE i.from_file_id = ?
+        AND (u.context = 'call_expression' OR u.context = 'new_expression')
+        AND u.argument_count IS NOT NULL
+    `);
+        const rows = stmt.all(fileId);
+        return rows.map((row) => ({
+            usageId: row.usage_id,
+            symbolId: row.symbol_id,
+            definitionId: row.definition_id,
+            filePath: row.file_path,
+            line: row.line,
+            column: row.column,
+            symbolName: row.symbol_name,
+            localName: row.local_name,
+            argumentCount: row.argument_count,
+            isMethodCall: row.is_method_call === 1,
+            isConstructorCall: row.is_constructor_call === 1,
+            receiverName: row.receiver_name,
+        }));
+    }
+    getCallsiteCount() {
+        const stmt = this.db.prepare(`
+      SELECT COUNT(*) as count FROM usages
+      WHERE (context = 'call_expression' OR context = 'new_expression')
+        AND argument_count IS NOT NULL
+    `);
+        const row = stmt.get();
+        return row.count;
+    }
+    /**
+     * Get incoming dependencies - symbols that use this definition.
+     * This finds all definitions that have usages pointing to this definition.
+     */
+    getIncoming(definitionId, limit = 5) {
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT
+        caller.id,
+        caller.name,
+        caller.kind,
+        f.path as filePath,
+        caller.line
+      FROM definitions caller
+      JOIN files f ON caller.file_id = f.id
+      JOIN usages u ON u.line >= caller.line AND u.line <= caller.end_line
+      JOIN symbols s ON u.symbol_id = s.id
+      WHERE s.definition_id = ?
+        AND caller.id != ?
+        AND (
+          s.reference_id IN (SELECT id FROM imports WHERE from_file_id = caller.file_id)
+          OR s.file_id = caller.file_id
+        )
+      ORDER BY f.path, caller.line
+      LIMIT ?
+    `);
+        return stmt.all(definitionId, definitionId, limit);
+    }
+    /**
+     * Get count of incoming dependencies - how many symbols use this definition.
+     */
+    getIncomingCount(definitionId) {
+        const stmt = this.db.prepare(`
+      SELECT COUNT(DISTINCT caller.id) as count
+      FROM definitions caller
+      JOIN usages u ON u.line >= caller.line AND u.line <= caller.end_line
+      JOIN symbols s ON u.symbol_id = s.id
+      WHERE s.definition_id = ?
+        AND caller.id != ?
+        AND (
+          s.reference_id IN (SELECT id FROM imports WHERE from_file_id = caller.file_id)
+          OR s.file_id = caller.file_id
+        )
+    `);
+        const row = stmt.get(definitionId, definitionId);
+        return row.count;
+    }
+    /**
+     * Get all symbols that a definition depends on (uses within its line range).
+     * This finds usages within the definition's code that reference other definitions.
+     */
+    getForDefinition(definitionId) {
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT
+        dep_def.id as dependencyId,
+        dep_def.name,
+        dep_def.kind,
+        dep_f.path as filePath,
+        dep_def.line
+      FROM definitions source
+      JOIN usages u ON u.line >= source.line AND u.line <= source.end_line
+      JOIN symbols s ON u.symbol_id = s.id
+      JOIN definitions dep_def ON s.definition_id = dep_def.id
+      JOIN files dep_f ON dep_def.file_id = dep_f.id
+      JOIN files source_f ON source.file_id = source_f.id
+      WHERE source.id = ?
+        AND dep_def.id != source.id
+        AND (
+          -- Symbol is from an import in the same file
+          s.reference_id IN (SELECT id FROM imports WHERE from_file_id = source.file_id)
+          -- Or symbol is internal to the same file
+          OR s.file_id = source.file_id
+        )
+      ORDER BY dep_f.path, dep_def.line
+    `);
+        return stmt.all(definitionId);
+    }
+    /**
+     * Get dependencies with their metadata status for a specific aspect.
+     * Combines dependency lookup with metadata check in a single efficient query.
+     */
+    getWithMetadata(definitionId, aspect) {
+        const sql = `
+      SELECT DISTINCT
+        dep_def.id,
+        dep_def.name,
+        dep_def.kind,
+        dep_f.path as filePath,
+        dep_def.line,
+        CASE WHEN dm.value IS NOT NULL THEN 1 ELSE 0 END as hasAspect,
+        dm.value as aspectValue
+      FROM definitions source
+      JOIN usages u ON u.line >= source.line AND u.line <= source.end_line
+      JOIN symbols s ON u.symbol_id = s.id
+      JOIN definitions dep_def ON s.definition_id = dep_def.id
+      JOIN files dep_f ON dep_def.file_id = dep_f.id
+      LEFT JOIN definition_metadata dm ON dm.definition_id = dep_def.id AND dm.key = ?
+      WHERE source.id = ?
+        AND dep_def.id != source.id
+        AND (
+          s.reference_id IN (SELECT id FROM imports WHERE from_file_id = source.file_id)
+          OR s.file_id = source.file_id
+        )
+      ORDER BY dep_f.path, dep_def.line
+    `;
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(aspect ?? '', definitionId);
+        return rows.map((row) => ({
+            id: row.id,
+            name: row.name,
+            kind: row.kind,
+            filePath: row.filePath,
+            line: row.line,
+            hasAspect: row.hasAspect === 1,
+            aspectValue: row.aspectValue,
+        }));
+    }
+    /**
+     * Get dependencies that don't have a specific aspect set.
+     * Orders by dependency count (leaf nodes first) for topological processing.
+     */
+    getUnmet(definitionId, aspect) {
+        const sql = `
+      WITH has_aspect AS (
+        SELECT definition_id FROM definition_metadata WHERE key = ?
+      )
+      SELECT DISTINCT
+        dep_def.id as dependencyId,
+        dep_def.name,
+        dep_def.kind,
+        dep_f.path as filePath,
+        dep_def.line
+      FROM definitions source
+      JOIN usages u ON u.line >= source.line AND u.line <= source.end_line
+      JOIN symbols s ON u.symbol_id = s.id
+      JOIN definitions dep_def ON s.definition_id = dep_def.id
+      JOIN files dep_f ON dep_def.file_id = dep_f.id
+      WHERE source.id = ?
+        AND dep_def.id != source.id
+        AND dep_def.id NOT IN (SELECT definition_id FROM has_aspect)
+        AND (
+          s.reference_id IN (SELECT id FROM imports WHERE from_file_id = source.file_id)
+          OR s.file_id = source.file_id
+        )
+      ORDER BY dep_f.path, dep_def.line
+    `;
+        const stmt = this.db.prepare(sql);
+        return stmt.all(aspect, definitionId);
+    }
+    /**
+     * Get the full prerequisite chain for understanding a symbol.
+     * Returns unmet dependencies in topological order (leaves first).
+     * Handles circular dependencies by tracking visited nodes.
+     */
+    getPrerequisiteChain(definitionId, aspect, getDefinitionById) {
+        const visited = new Set();
+        const result = [];
+        const processNode = (id) => {
+            if (visited.has(id))
+                return;
+            visited.add(id);
+            const unmetDeps = this.getUnmet(id, aspect);
+            // Process children first (depth-first)
+            for (const dep of unmetDeps) {
+                if (!visited.has(dep.dependencyId)) {
+                    processNode(dep.dependencyId);
+                }
+            }
+            // Add this node after its dependencies (unless it's the root)
+            if (id !== definitionId) {
+                const nodeUnmetDeps = this.getUnmet(id, aspect);
+                const def = getDefinitionById(id);
+                if (def) {
+                    result.push({
+                        dependencyId: id,
+                        name: def.name,
+                        kind: def.kind,
+                        filePath: def.filePath,
+                        line: def.line,
+                        unmetDepCount: nodeUnmetDeps.length,
+                    });
+                }
+            }
+        };
+        // Start from the target definition
+        const directUnmet = this.getUnmet(definitionId, aspect);
+        for (const dep of directUnmet) {
+            processNode(dep.dependencyId);
+        }
+        // Sort by unmet dependency count (leaves first)
+        result.sort((a, b) => a.unmetDepCount - b.unmetDepCount);
+        return result;
+    }
+    /**
+     * Find symbols that are "ready to understand" for a given aspect.
+     * A symbol is ready when all its dependencies already have the aspect set (or it has no dependencies).
+     * Excludes symbols that already have the aspect set.
+     */
+    getReadySymbols(aspect, options) {
+        const limit = options?.limit ?? 20;
+        // Build filter conditions and collect filter params
+        let filterConditions = '';
+        const filterParams = [];
+        if (options?.kind) {
+            filterConditions += ' AND d.kind = ?';
+            filterParams.push(options.kind);
+        }
+        if (options?.filePattern) {
+            filterConditions += ' AND f.path LIKE ?';
+            filterParams.push(`%${options.filePattern}%`);
+        }
+        // The main query uses CTEs:
+        // 1. understood: definitions that already have the aspect set
+        // 2. definition_deps: maps each definition to its dependencies
+        // 3. unmet: definitions that have at least one dependency without the aspect
+        const sql = `
+      WITH understood AS (
+        SELECT definition_id FROM definition_metadata WHERE key = ?
+      ),
+      definition_deps AS (
+        SELECT DISTINCT
+          source.id as definition_id,
+          dep_def.id as dependency_id
+        FROM definitions source
+        JOIN usages u ON u.line >= source.line AND u.line <= source.end_line
+        JOIN symbols s ON u.symbol_id = s.id
+        JOIN definitions dep_def ON s.definition_id = dep_def.id
+        JOIN files source_f ON source.file_id = source_f.id
+        WHERE dep_def.id != source.id
+          AND (
+            s.reference_id IN (SELECT id FROM imports WHERE from_file_id = source.file_id)
+            OR s.file_id = source.file_id
+          )
+      ),
+      unmet AS (
+        SELECT DISTINCT definition_id
+        FROM definition_deps
+        WHERE dependency_id NOT IN (SELECT definition_id FROM understood)
+      )
+      SELECT
+        d.id,
+        d.name,
+        d.kind,
+        f.path as filePath,
+        d.line,
+        d.end_line as endLine,
+        COALESCE(dep_count.cnt, 0) as dependencyCount
+      FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      LEFT JOIN (
+        SELECT definition_id, COUNT(*) as cnt
+        FROM definition_deps
+        GROUP BY definition_id
+      ) dep_count ON dep_count.definition_id = d.id
+      WHERE d.id NOT IN (SELECT definition_id FROM understood)
+        AND d.id NOT IN (SELECT definition_id FROM unmet)
+        ${filterConditions}
+      ORDER BY dependencyCount ASC, f.path, d.line
+      LIMIT ?
+    `;
+        const params = [aspect, ...filterParams, limit];
+        const stmt = this.db.prepare(sql);
+        const symbols = stmt.all(...params);
+        // Get counts for the summary
+        const countSql = `
+      WITH understood AS (
+        SELECT definition_id FROM definition_metadata WHERE key = ?
+      ),
+      definition_deps AS (
+        SELECT DISTINCT
+          source.id as definition_id,
+          dep_def.id as dependency_id
+        FROM definitions source
+        JOIN usages u ON u.line >= source.line AND u.line <= source.end_line
+        JOIN symbols s ON u.symbol_id = s.id
+        JOIN definitions dep_def ON s.definition_id = dep_def.id
+        JOIN files source_f ON source.file_id = source_f.id
+        WHERE dep_def.id != source.id
+          AND (
+            s.reference_id IN (SELECT id FROM imports WHERE from_file_id = source.file_id)
+            OR s.file_id = source.file_id
+          )
+      ),
+      unmet AS (
+        SELECT DISTINCT definition_id
+        FROM definition_deps
+        WHERE dependency_id NOT IN (SELECT definition_id FROM understood)
+      )
+      SELECT
+        COUNT(*) as totalReady,
+        (SELECT COUNT(*) FROM definitions d2
+         JOIN files f2 ON d2.file_id = f2.id
+         WHERE d2.id NOT IN (SELECT definition_id FROM understood)
+           ${filterConditions.replace(/d\./g, 'd2.').replace(/f\./g, 'f2.')}
+        ) as totalRemaining
+      FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      WHERE d.id NOT IN (SELECT definition_id FROM understood)
+        AND d.id NOT IN (SELECT definition_id FROM unmet)
+        ${filterConditions}
+    `;
+        // Params: aspect, then filterParams for subquery, then filterParams for main WHERE
+        const countParams = [aspect, ...filterParams, ...filterParams];
+        const countStmt = this.db.prepare(countSql);
+        const countResult = countStmt.get(...countParams);
+        return {
+            symbols,
+            totalReady: countResult.totalReady,
+            remaining: countResult.totalRemaining - countResult.totalReady,
+        };
+    }
+    /**
+     * Get import dependency graph data for D3 visualization
+     */
+    getImportGraph() {
+        // Get all files as nodes
+        const nodesStmt = this.db.prepare(`
+      SELECT id, path as name, 'file' as kind
+      FROM files
+    `);
+        const nodes = nodesStmt.all();
+        // Get all internal imports as links
+        const linksStmt = this.db.prepare(`
+      SELECT DISTINCT from_file_id as source, to_file_id as target, type
+      FROM imports
+      WHERE to_file_id IS NOT NULL
+    `);
+        const links = linksStmt.all();
+        return { nodes, links };
+    }
+}
+//# sourceMappingURL=dependency-repository.js.map

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

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

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

@@ -0,0 +1,97 @@
+import type Database from 'better-sqlite3';
+import type { Domain, DomainWithCount } from '../schema.js';
+/**
+ * Repository for domain registry operations.
+ * Handles CRUD operations for the domains table and domain-related queries.
+ */
+export declare class DomainRepository {
+    private db;
+    private metadata;
+    constructor(db: Database.Database);
+    /**
+     * Add a new domain to the registry.
+     * @returns The domain ID if created, or null if already exists.
+     */
+    add(name: string, description?: string): number | null;
+    /**
+     * Get a domain by name.
+     */
+    get(name: string): Domain | null;
+    /**
+     * Get all domains from the registry.
+     */
+    getAll(): Domain[];
+    /**
+     * Get all domains with their symbol counts.
+     */
+    getAllWithCounts(): DomainWithCount[];
+    /**
+     * Update a domain's description.
+     */
+    updateDescription(name: string, description: string): boolean;
+    /**
+     * Rename a domain in both the registry and all symbol metadata.
+     * @returns Number of symbols updated.
+     */
+    rename(oldName: string, newName: string): {
+        updated: boolean;
+        symbolsUpdated: number;
+    };
+    /**
+     * Merge one domain into another. The source domain is removed from all symbols
+     * and replaced with the target domain.
+     * @returns Number of symbols updated.
+     */
+    merge(fromName: string, intoName: string): {
+        symbolsUpdated: number;
+        registryRemoved: boolean;
+    };
+    /**
+     * Remove a domain from the registry.
+     * @param force If true, removes even if symbols still use this domain.
+     * @returns Object with removed status and count of symbols still using the domain.
+     */
+    remove(name: string, force?: boolean): {
+        removed: boolean;
+        symbolsUsingDomain: number;
+    };
+    /**
+     * Sync all domains currently in use to the registry.
+     * Registers any domain found in symbol metadata that isn't already registered.
+     * @returns Array of newly registered domain names.
+     */
+    syncFromMetadata(): string[];
+    /**
+     * Get all unregistered domains currently in use.
+     */
+    getUnregistered(): string[];
+    /**
+     * Check if a domain is registered.
+     */
+    isRegistered(name: string): boolean;
+    /**
+     * Get symbols that have a specific domain tag.
+     * Domain is stored as a JSON array in the 'domain' metadata key.
+     */
+    getSymbolsByDomain(domain: string): Array<{
+        id: number;
+        name: string;
+        kind: string;
+        filePath: string;
+        line: number;
+        domains: string[];
+        purpose: string | null;
+    }>;
+    /**
+     * Get symbols filtered by purity (pure = no side effects).
+     */
+    getSymbolsByPurity(isPure: boolean): Array<{
+        id: number;
+        name: string;
+        kind: string;
+        filePath: string;
+        line: number;
+        purpose: string | null;
+    }>;
+}
+//# sourceMappingURL=domain-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain-repository.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/domain-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG5D;;;GAGG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,EAAE;IAFtB,OAAO,CAAC,QAAQ,CAAqB;gBAEjB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIzC;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiBtD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUhC;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IASlB;;OAEG;IACH,gBAAgB,IAAI,eAAe,EAAE;IA+BrC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAS7D;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAwCtF;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;IA6C/F;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE;IAsBrF;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAuB5B;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAO3B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQnC;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QACxC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IAIF;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;QACzC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;CAGH"}