@zbigniewsobiecki/squint 1.0.0

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

@@ -0,0 +1,294 @@
+/**
+ * Repository for definition metadata operations.
+ * Handles CRUD operations for the definition_metadata table.
+ */
+export class MetadataRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Set metadata on a definition (insert or replace)
+     */
+    set(definitionId, key, value) {
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO definition_metadata (definition_id, key, value)
+      VALUES (?, ?, ?)
+    `);
+        stmt.run(definitionId, key, value);
+    }
+    /**
+     * Remove a metadata key from a definition
+     */
+    remove(definitionId, key) {
+        const stmt = this.db.prepare(`
+      DELETE FROM definition_metadata
+      WHERE definition_id = ? AND key = ?
+    `);
+        const result = stmt.run(definitionId, key);
+        return result.changes > 0;
+    }
+    /**
+     * Get all metadata for a definition
+     */
+    get(definitionId) {
+        const stmt = this.db.prepare(`
+      SELECT key, value FROM definition_metadata
+      WHERE definition_id = ?
+    `);
+        const rows = stmt.all(definitionId);
+        const result = {};
+        for (const row of rows) {
+            result[row.key] = row.value;
+        }
+        return result;
+    }
+    /**
+     * Get a single metadata value for a definition
+     */
+    getValue(definitionId, key) {
+        const stmt = this.db.prepare(`
+      SELECT value FROM definition_metadata
+      WHERE definition_id = ? AND key = ?
+    `);
+        const row = stmt.get(definitionId, key);
+        return row?.value ?? null;
+    }
+    /**
+     * Get definition IDs that have a specific metadata key set
+     */
+    getDefinitionsWith(key) {
+        const stmt = this.db.prepare(`
+      SELECT definition_id FROM definition_metadata
+      WHERE key = ?
+    `);
+        const rows = stmt.all(key);
+        return rows.map((row) => row.definition_id);
+    }
+    /**
+     * Get definition IDs that do NOT have a specific metadata key set
+     */
+    getDefinitionsWithout(key) {
+        const stmt = this.db.prepare(`
+      SELECT d.id FROM definitions d
+      WHERE NOT EXISTS (
+        SELECT 1 FROM definition_metadata dm
+        WHERE dm.definition_id = d.id AND dm.key = ?
+      )
+    `);
+        const rows = stmt.all(key);
+        return rows.map((row) => row.id);
+    }
+    /**
+     * Get all unique metadata keys (aspects) in use
+     */
+    getKeys() {
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT key FROM definition_metadata
+      ORDER BY key
+    `);
+        const rows = stmt.all();
+        return rows.map((row) => row.key);
+    }
+    /**
+     * Get count of definitions matching filters
+     */
+    getFilteredCount(filters) {
+        let sql = `
+      SELECT COUNT(*) as count FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      WHERE 1=1
+    `;
+        const params = [];
+        if (filters?.kind) {
+            sql += ' AND d.kind = ?';
+            params.push(filters.kind);
+        }
+        if (filters?.filePattern) {
+            sql += ' AND f.path LIKE ?';
+            params.push(`%${filters.filePattern}%`);
+        }
+        const stmt = this.db.prepare(sql);
+        const row = stmt.get(...params);
+        return row.count;
+    }
+    /**
+     * Get coverage stats for aspects (metadata keys).
+     * Returns the number of definitions that have each aspect defined.
+     */
+    getAspectCoverage(filters) {
+        // Build the base query for counting total definitions
+        let totalSql = `
+      SELECT COUNT(*) as count FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      WHERE 1=1
+    `;
+        const totalParams = [];
+        if (filters?.kind) {
+            totalSql += ' AND d.kind = ?';
+            totalParams.push(filters.kind);
+        }
+        if (filters?.filePattern) {
+            totalSql += ' AND f.path LIKE ?';
+            totalParams.push(`%${filters.filePattern}%`);
+        }
+        const totalStmt = this.db.prepare(totalSql);
+        const totalRow = totalStmt.get(...totalParams);
+        const total = totalRow.count;
+        if (total === 0) {
+            return [];
+        }
+        // Get all unique metadata keys
+        const keys = this.getKeys();
+        // For each key, count how many of the filtered definitions have it set
+        const results = [];
+        for (const key of keys) {
+            let coveredSql = `
+        SELECT COUNT(DISTINCT d.id) as count
+        FROM definitions d
+        JOIN files f ON d.file_id = f.id
+        JOIN definition_metadata dm ON dm.definition_id = d.id
+        WHERE dm.key = ?
+      `;
+            const coveredParams = [key];
+            if (filters?.kind) {
+                coveredSql += ' AND d.kind = ?';
+                coveredParams.push(filters.kind);
+            }
+            if (filters?.filePattern) {
+                coveredSql += ' AND f.path LIKE ?';
+                coveredParams.push(`%${filters.filePattern}%`);
+            }
+            const coveredStmt = this.db.prepare(coveredSql);
+            const coveredRow = coveredStmt.get(...coveredParams);
+            const covered = coveredRow.count;
+            results.push({
+                aspect: key,
+                covered,
+                total,
+                percentage: Math.round((covered / total) * 1000) / 10, // One decimal place
+            });
+        }
+        return results;
+    }
+    /**
+     * Get all unique domains used across all symbols.
+     * Domain is stored as a JSON array in the 'domain' metadata key.
+     */
+    getAllDomains() {
+        const stmt = this.db.prepare(`
+      SELECT value FROM definition_metadata WHERE key = 'domain'
+    `);
+        const rows = stmt.all();
+        const domains = new Set();
+        for (const row of rows) {
+            try {
+                const parsed = JSON.parse(row.value);
+                for (const d of parsed) {
+                    domains.add(d);
+                }
+            }
+            catch {
+                // Skip invalid JSON
+            }
+        }
+        return Array.from(domains).sort();
+    }
+    /**
+     * Get symbols that have a specific domain tag.
+     * Domain is stored as a JSON array in the 'domain' metadata key.
+     */
+    getSymbolsByDomain(domain) {
+        // Use LIKE with JSON pattern to find domain in the array
+        const pattern = `%"${domain}"%`;
+        const stmt = this.db.prepare(`
+      SELECT
+        d.id,
+        d.name,
+        d.kind,
+        f.path as filePath,
+        d.line,
+        dm_domain.value as domains,
+        dm_purpose.value as purpose
+      FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      JOIN definition_metadata dm_domain ON dm_domain.definition_id = d.id AND dm_domain.key = 'domain'
+      LEFT JOIN definition_metadata dm_purpose ON dm_purpose.definition_id = d.id AND dm_purpose.key = 'purpose'
+      WHERE dm_domain.value LIKE ?
+      ORDER BY f.path, d.line
+    `);
+        const rows = stmt.all(pattern);
+        return rows.map((row) => ({
+            id: row.id,
+            name: row.name,
+            kind: row.kind,
+            filePath: row.filePath,
+            line: row.line,
+            domains: JSON.parse(row.domains),
+            purpose: row.purpose,
+        }));
+    }
+    /**
+     * Get definitions that have no metadata at all (not in definition_metadata table).
+     */
+    getDefinitionsWithNoMetadata(options) {
+        const limit = options?.limit ?? 20;
+        let sql = `
+      SELECT d.id, d.name, d.kind, f.path as filePath, d.line
+      FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      WHERE d.id NOT IN (SELECT DISTINCT definition_id FROM definition_metadata)
+    `;
+        const params = [];
+        if (options?.kind) {
+            sql += ' AND d.kind = ?';
+            params.push(options.kind);
+        }
+        sql += ' ORDER BY f.path, d.line LIMIT ?';
+        params.push(limit);
+        const stmt = this.db.prepare(sql);
+        return stmt.all(...params);
+    }
+    /**
+     * Get count of definitions that have no metadata at all.
+     */
+    getDefinitionsWithNoMetadataCount(options) {
+        let sql = `
+      SELECT COUNT(*) as count
+      FROM definitions d
+      WHERE d.id NOT IN (SELECT DISTINCT definition_id FROM definition_metadata)
+    `;
+        const params = [];
+        if (options?.kind) {
+            sql += ' AND d.kind = ?';
+            params.push(options.kind);
+        }
+        const stmt = this.db.prepare(sql);
+        const row = stmt.get(...params);
+        return row.count;
+    }
+    /**
+     * Get symbols filtered by purity (pure = no side effects).
+     * Returns symbols where 'pure' metadata matches the specified value.
+     */
+    getSymbolsByPurity(isPure) {
+        const pureValue = isPure ? 'true' : 'false';
+        const stmt = this.db.prepare(`
+      SELECT
+        d.id,
+        d.name,
+        d.kind,
+        f.path as filePath,
+        d.line,
+        dm_purpose.value as purpose
+      FROM definitions d
+      JOIN files f ON d.file_id = f.id
+      JOIN definition_metadata dm_pure ON dm_pure.definition_id = d.id AND dm_pure.key = 'pure'
+      LEFT JOIN definition_metadata dm_purpose ON dm_purpose.definition_id = d.id AND dm_purpose.key = 'purpose'
+      WHERE dm_pure.value = ?
+      ORDER BY f.path, d.line
+    `);
+        return stmt.all(pureValue);
+    }
+}
+//# sourceMappingURL=metadata-repository.js.map

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

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

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

@@ -0,0 +1,162 @@
+import type Database from 'better-sqlite3';
+import type { AnnotatedSymbolInfo, CallGraphEdge, Module, ModuleTreeNode, ModuleWithMembers } from '../schema.js';
+export interface ModuleSymbol {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    isExported: boolean;
+}
+export interface ModuleMemberInfo {
+    definitionId: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    isExported: boolean;
+}
+export interface ModuleStats {
+    moduleCount: number;
+    assigned: number;
+    unassigned: number;
+}
+export interface IncomingEdge {
+    callerId: number;
+    callerName: string;
+    callerModuleId: number | null;
+    weight: number;
+}
+/**
+ * Repository for module tree operations.
+ */
+export declare class ModuleRepository {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Ensure the root "project" module exists and return its ID.
+     */
+    ensureRoot(): number;
+    /**
+     * Insert a new module in the tree.
+     */
+    insert(parentId: number | null, slug: string, name: string, description?: string, isTest?: boolean): number;
+    /**
+     * Get a module by its full path.
+     */
+    getByPath(fullPath: string): Module | null;
+    /**
+     * Get a module by ID.
+     */
+    getById(id: number): Module | null;
+    /**
+     * Get direct children of a module.
+     */
+    getChildren(moduleId: number): Module[];
+    /**
+     * Get all modules as a flat list.
+     */
+    getAll(): Module[];
+    /**
+     * Get the module tree as a recursive structure.
+     */
+    getTree(): ModuleTreeNode | null;
+    /**
+     * Delete all modules and their memberships.
+     */
+    clear(): void;
+    /**
+     * Assign a symbol (definition) to a module.
+     */
+    assignSymbol(definitionId: number, moduleId: number): void;
+    /**
+     * Get all symbols not yet assigned to any module.
+     */
+    getUnassigned(): AnnotatedSymbolInfo[];
+    /**
+     * Get symbols assigned to a specific module.
+     */
+    getSymbols(moduleId: number): ModuleSymbol[];
+    /**
+     * Get a module with all its members.
+     */
+    getWithMembers(moduleId: number): ModuleWithMembers | null;
+    /**
+     * Get all modules with their members.
+     */
+    getAllWithMembers(): ModuleWithMembers[];
+    /**
+     * Get module statistics.
+     */
+    getStats(): ModuleStats;
+    /**
+     * Get count of modules.
+     */
+    getCount(): number;
+    /**
+     * Get module membership for a definition.
+     */
+    getDefinitionModule(definitionId: number): {
+        module: Module;
+    } | null;
+    /**
+     * Get the symbol-level call graph.
+     * This is needed by getModuleCallGraph and getIncomingEdgesFor.
+     */
+    getCallGraph(): CallGraphEdge[];
+    /**
+     * Get modules that exceed a member threshold.
+     * Returns modules with member_count > threshold, including their member details.
+     */
+    getModulesExceedingThreshold(threshold: number): ModuleWithMembers[];
+    /**
+     * Get detailed member info for a module (used by deepen phase).
+     */
+    getMemberInfo(moduleId: number): ModuleMemberInfo[];
+    /**
+     * Assign color indices based on branch identity.
+     * Each depth-1 module gets a sequential index; descendants inherit their ancestor's index.
+     */
+    assignColorIndices(): void;
+    /**
+     * Get IDs of all test modules (is_test = 1).
+     */
+    getTestModuleIds(): Set<number>;
+    /**
+     * Prune empty leaf modules iteratively.
+     * A leaf is a module with no children and no members.
+     * Deleting a leaf may turn its parent into a new empty leaf, so we loop.
+     */
+    pruneEmptyLeaves(): number;
+    /**
+     * Update a module's name and/or description.
+     */
+    update(id: number, updates: {
+        name?: string;
+        description?: string;
+    }): boolean;
+    /**
+     * Delete a module.
+     * Throws an error if the module has members unless the caller handles that externally.
+     */
+    delete(id: number): boolean;
+    /**
+     * Remove a symbol from its module assignment.
+     */
+    unassignSymbol(definitionId: number): boolean;
+    /**
+     * Get leaf modules exceeding a member threshold.
+     * Leaf = not a parent of any other module. Ordered by member count DESC (largest first).
+     */
+    getLeafModulesExceedingThreshold(threshold: number): ModuleWithMembers[];
+    /**
+     * Get branch modules (has children) with direct members exceeding a threshold.
+     * These need rebalancing, not splitting.
+     */
+    getBranchModulesWithDirectMembers(threshold: number): ModuleWithMembers[];
+    /**
+     * Get all callers of a definition with their module assignments.
+     */
+    getIncomingEdgesFor(definitionId: number): IncomingEdge[];
+}
+//# sourceMappingURL=module-repository.d.ts.map

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

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