sdlc-agent-4-enterprise-server 1.0.0

package/dist/engine/database/graph-repository.js

@@ -0,0 +1,101 @@
+/**
+ * KSA-153: Graph Repository — CRUD operations for the code relationship graph.
+ * Provides prepared-statement-based access to the relationships table.
+ */
+export class GraphRepository {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.prepareStatements();
+    }
+    /** Insert a batch of relationships within a transaction. */
+    insertRelationships(relationships) {
+        const transaction = this.db.transaction((rels) => {
+            for (const rel of rels) {
+                this.stmts.insertRelationship.run(rel.sourceSymbolId, rel.targetSymbol, rel.targetSymbolId ?? null, rel.kind, rel.filePath, rel.line, rel.metadata ? JSON.stringify(rel.metadata) : null);
+            }
+        });
+        transaction(relationships);
+    }
+    /** Delete all relationships originating from a file. */
+    deleteFileRelationships(filePath) {
+        this.stmts.deleteFileRelationships.run(filePath);
+    }
+    /** Find direct callers of a symbol by name. */
+    findCallers(symbolName, kind = 'calls', limit = 20) {
+        return this.stmts.findCallers.all(symbolName, kind, limit);
+    }
+    /** Find direct callees of a symbol by ID. */
+    findCallees(symbolId, kind = 'calls', limit = 20) {
+        return this.stmts.findCallees.all(symbolId, kind, limit);
+    }
+    /** Resolve target_symbol_id for unresolved relationships (batch). */
+    resolveTargets(batchSize = 1000) {
+        const unresolved = this.db.prepare(`
+      SELECT r.id, r.target_symbol
+      FROM relationships r
+      WHERE r.target_symbol_id IS NULL
+      LIMIT ?
+    `).all(batchSize);
+        let resolved = 0;
+        const findTarget = this.db.prepare('SELECT id FROM symbols WHERE name = ? LIMIT 1');
+        const transaction = this.db.transaction(() => {
+            for (const row of unresolved) {
+                const target = findTarget.get(row.target_symbol);
+                if (target) {
+                    this.stmts.resolveTarget.run(target.id, row.id);
+                    resolved++;
+                }
+            }
+        });
+        transaction();
+        return resolved;
+    }
+    /** Get total relationship count. */
+    getRelationshipCount() {
+        const row = this.stmts.countRelationships.get();
+        return row.count;
+    }
+    /** Get relationship statistics by kind. */
+    getStats() {
+        return this.db.prepare(`
+      SELECT kind, COUNT(*) as count
+      FROM relationships
+      GROUP BY kind
+      ORDER BY count DESC
+    `).all();
+    }
+    prepareStatements() {
+        this.stmts = {
+            insertRelationship: this.db.prepare(`
+        INSERT INTO relationships (source_symbol_id, target_symbol, target_symbol_id, kind, file_path, line, metadata)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `),
+            deleteFileRelationships: this.db.prepare('DELETE FROM relationships WHERE file_path = ?'),
+            findCallers: this.db.prepare(`
+        SELECT s.name, s.kind, f.relative_path as file_path, s.start_line as def_line, r.line as call_line,
+               s.parent_symbol as parameters, s.visibility as is_async, s.id
+        FROM relationships r
+        JOIN symbols s ON s.id = r.source_symbol_id
+        JOIN files f ON f.id = s.file_id
+        WHERE r.target_symbol = ? AND r.kind = ?
+        ORDER BY f.relative_path, r.line
+        LIMIT ?
+      `),
+            findCallees: this.db.prepare(`
+        SELECT r.target_symbol as name, r.line as call_line, r.metadata,
+               ts.kind, tf.relative_path as file_path, ts.start_line as def_line
+        FROM relationships r
+        LEFT JOIN symbols ts ON ts.id = r.target_symbol_id
+        LEFT JOIN files tf ON tf.id = ts.file_id
+        WHERE r.source_symbol_id = ? AND r.kind = ?
+        ORDER BY r.line
+        LIMIT ?
+      `),
+            resolveTarget: this.db.prepare('UPDATE relationships SET target_symbol_id = ? WHERE id = ?'),
+            countRelationships: this.db.prepare('SELECT COUNT(*) as count FROM relationships'),
+        };
+    }
+}
+//# sourceMappingURL=graph-repository.js.map

package/dist/engine/database/graph-repository.js.map

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

package/dist/engine/database/incremental-updater.d.ts

@@ -0,0 +1,29 @@
+/**
+ * KSA-169: Incremental Updater — Detect file changes using FNV-1a content hashing.
+ * Compares disk state against stored file_index to determine what needs re-indexing.
+ */
+import Database from 'better-sqlite3';
+export interface ChangeSet {
+    added: string[];
+    modified: string[];
+    deleted: string[];
+    unchanged: number;
+}
+export declare class IncrementalUpdater {
+    private db;
+    constructor(db: Database.Database);
+    /** Scan workspace and compare against stored file index. */
+    scanChanges(files: {
+        relativePath: string;
+        absolutePath: string;
+    }[]): ChangeSet;
+    /** Update file index entry after successful indexing. */
+    updateFileIndex(relativePath: string, absolutePath: string, symbolCount: number): void;
+    /** Remove a file from the index. */
+    removeFromIndex(relativePath: string): void;
+    /** Get total indexed file count. */
+    getIndexedCount(): number;
+    private updateMtime;
+}
+/** FNV-1a 32-bit hash for fast content comparison. */
+export declare function fnv1aHash(data: Buffer): string;

package/dist/engine/database/incremental-updater.js

@@ -0,0 +1,92 @@
+/**
+ * KSA-169: Incremental Updater — Detect file changes using FNV-1a content hashing.
+ * Compares disk state against stored file_index to determine what needs re-indexing.
+ */
+import * as fs from 'fs';
+export class IncrementalUpdater {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Scan workspace and compare against stored file index. */
+    scanChanges(files) {
+        const result = { added: [], modified: [], deleted: [], unchanged: 0 };
+        const indexedPaths = new Set();
+        const rows = this.db.prepare('SELECT path, content_hash, mtime FROM file_index').all();
+        const indexMap = new Map(rows.map(r => [r.path, r]));
+        for (const r of rows)
+            indexedPaths.add(r.path);
+        for (const file of files) {
+            const indexed = indexMap.get(file.relativePath);
+            if (!indexed) {
+                result.added.push(file.relativePath);
+                continue;
+            }
+            indexedPaths.delete(file.relativePath);
+            try {
+                const stat = fs.statSync(file.absolutePath);
+                const mtime = Math.floor(stat.mtimeMs);
+                if (mtime !== indexed.mtime) {
+                    const content = fs.readFileSync(file.absolutePath);
+                    const hash = fnv1aHash(content);
+                    if (hash !== indexed.content_hash) {
+                        result.modified.push(file.relativePath);
+                    }
+                    else {
+                        this.updateMtime(file.relativePath, mtime);
+                        result.unchanged++;
+                    }
+                }
+                else {
+                    result.unchanged++;
+                }
+            }
+            catch {
+                result.deleted.push(file.relativePath);
+            }
+        }
+        for (const deletedPath of indexedPaths) {
+            result.deleted.push(deletedPath);
+        }
+        return result;
+    }
+    /** Update file index entry after successful indexing. */
+    updateFileIndex(relativePath, absolutePath, symbolCount) {
+        try {
+            const stat = fs.statSync(absolutePath);
+            const content = fs.readFileSync(absolutePath);
+            const hash = fnv1aHash(content);
+            this.db.prepare(`
+        INSERT OR REPLACE INTO file_index (path, mtime, content_hash, size_bytes, last_indexed, symbol_count)
+        VALUES (?, ?, ?, ?, datetime('now'), ?)
+      `).run(relativePath, Math.floor(stat.mtimeMs), hash, stat.size, symbolCount);
+        }
+        catch (err) {
+            console.error(`[incremental-updater] Failed to update index for ${relativePath}:`, err);
+        }
+    }
+    /** Remove a file from the index. */
+    removeFromIndex(relativePath) {
+        this.db.prepare('DELETE FROM file_index WHERE path = ?').run(relativePath);
+    }
+    /** Get total indexed file count. */
+    getIndexedCount() {
+        const row = this.db.prepare('SELECT COUNT(*) as count FROM file_index').get();
+        return row.count;
+    }
+    updateMtime(relativePath, mtime) {
+        this.db.prepare('UPDATE file_index SET mtime = ? WHERE path = ?').run(mtime, relativePath);
+    }
+}
+/** FNV-1a 32-bit hash for fast content comparison. */
+export function fnv1aHash(data) {
+    const FNV_OFFSET = 2166136261;
+    const FNV_PRIME = 16777619;
+    let hash = FNV_OFFSET;
+    for (let i = 0; i < data.length; i++) {
+        hash ^= data[i];
+        hash = Math.imul(hash, FNV_PRIME) >>> 0;
+    }
+    return hash.toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=incremental-updater.js.map

package/dist/engine/database/incremental-updater.js.map

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

package/dist/engine/database/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Database module barrel export.
+ * KSA-153: Graph storage
+ * KSA-169: Incremental updater + persistence
+ */
+export { GraphRepository } from './graph-repository.js';
+export type { CallerResult, CalleeResult, RelationshipInput } from './graph-repository.js';
+export { runGraphMigrations, isGraphSchemaReady } from './migrator.js';
+export { IncrementalUpdater, fnv1aHash } from './incremental-updater.js';
+export type { ChangeSet } from './incremental-updater.js';

package/dist/engine/database/index.js

@@ -0,0 +1,9 @@
+/**
+ * Database module barrel export.
+ * KSA-153: Graph storage
+ * KSA-169: Incremental updater + persistence
+ */
+export { GraphRepository } from './graph-repository.js';
+export { runGraphMigrations, isGraphSchemaReady } from './migrator.js';
+export { IncrementalUpdater, fnv1aHash } from './incremental-updater.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/engine/database/migrator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * KSA-153: Schema Migrator — Applies graph schema migrations.
+ * Extends the existing migration system with graph-specific tables and columns.
+ */
+import Database from 'better-sqlite3';
+/**
+ * Run graph-related migrations (KSA-153 + KSA-169).
+ * Safe to call multiple times — all operations are idempotent.
+ */
+export declare function runGraphMigrations(db: Database.Database): void;
+/** Check if graph migrations have been applied. */
+export declare function isGraphSchemaReady(db: Database.Database): boolean;

package/dist/engine/database/migrator.js

@@ -0,0 +1,132 @@
+/**
+ * KSA-153: Schema Migrator — Applies graph schema migrations.
+ * Extends the existing migration system with graph-specific tables and columns.
+ */
+/** Enhanced symbol columns added for tree-sitter (KSA-145/153). */
+const ENHANCED_SYMBOL_COLUMNS = [
+    { name: 'parameters', type: 'TEXT' },
+    { name: 'return_type', type: 'TEXT' },
+    { name: 'parent_symbol_id', type: 'INTEGER' },
+    { name: 'decorators', type: 'TEXT' },
+    { name: 'complexity', type: 'INTEGER' },
+    { name: 'is_async', type: 'INTEGER DEFAULT 0' },
+    { name: 'is_exported', type: 'INTEGER DEFAULT 0' },
+    { name: 'doc_comment_full', type: 'TEXT' },
+    { name: 'modifiers', type: 'TEXT' },
+];
+const GRAPH_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS relationships (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_symbol_id INTEGER NOT NULL,
+    target_symbol TEXT NOT NULL,
+    target_symbol_id INTEGER,
+    kind TEXT NOT NULL CHECK(kind IN ('calls','imports','inherits','implements','uses','decorates')),
+    file_path TEXT NOT NULL,
+    line INTEGER NOT NULL,
+    metadata TEXT,
+    FOREIGN KEY (source_symbol_id) REFERENCES symbols(id) ON DELETE CASCADE,
+    FOREIGN KEY (target_symbol_id) REFERENCES symbols(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_rel_source_kind ON relationships(source_symbol_id, kind);
+CREATE INDEX IF NOT EXISTS idx_rel_target_kind ON relationships(target_symbol, kind);
+CREATE INDEX IF NOT EXISTS idx_rel_target_id ON relationships(target_symbol_id) WHERE target_symbol_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_rel_file ON relationships(file_path);
+`;
+const FILE_INDEX_SQL = `
+CREATE TABLE IF NOT EXISTS file_index (
+    path TEXT PRIMARY KEY,
+    mtime INTEGER NOT NULL,
+    content_hash TEXT NOT NULL,
+    size_bytes INTEGER NOT NULL,
+    last_indexed TEXT NOT NULL DEFAULT (datetime('now')),
+    symbol_count INTEGER DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_file_index_hash ON file_index(content_hash);
+`;
+const GRAPH_META_SQL = `
+CREATE TABLE IF NOT EXISTS graph_meta (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+);
+
+INSERT OR IGNORE INTO graph_meta (key, value) VALUES
+    ('schema_version', '3'),
+    ('last_checkpoint', ''),
+    ('total_nodes', '0'),
+    ('total_edges', '0');
+`;
+const BODY_EMBEDDINGS_SQL = `
+CREATE TABLE IF NOT EXISTS body_embeddings (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    symbol_id INTEGER NOT NULL,
+    chunk_index INTEGER NOT NULL DEFAULT 0,
+    embedding BLOB NOT NULL,
+    token_count INTEGER NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(symbol_id, chunk_index),
+    FOREIGN KEY (symbol_id) REFERENCES symbols(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_body_embeddings_symbol ON body_embeddings(symbol_id);
+`;
+/**
+ * Run graph-related migrations (KSA-153 + KSA-169).
+ * Safe to call multiple times — all operations are idempotent.
+ */
+export function runGraphMigrations(db) {
+    console.error('[graph-migrator] Running graph schema migrations...');
+    addEnhancedSymbolColumns(db);
+    db.exec(GRAPH_SCHEMA_SQL);
+    console.error('[graph-migrator] Relationships table ready');
+    db.exec(FILE_INDEX_SQL);
+    console.error('[graph-migrator] File index table ready');
+    db.exec(GRAPH_META_SQL);
+    console.error('[graph-migrator] Graph metadata table ready');
+    db.exec(BODY_EMBEDDINGS_SQL);
+    console.error('[graph-migrator] Body embeddings table ready');
+    db.prepare('INSERT OR REPLACE INTO schema_version (version) VALUES (?)').run(3);
+    console.error('[graph-migrator] Schema version set to 3');
+}
+function addEnhancedSymbolColumns(db) {
+    const existing = getExistingColumns(db, 'symbols');
+    let added = 0;
+    for (const col of ENHANCED_SYMBOL_COLUMNS) {
+        if (!existing.has(col.name)) {
+            try {
+                db.exec(`ALTER TABLE symbols ADD COLUMN ${col.name} ${col.type}`);
+                added++;
+            }
+            catch {
+                // Column may already exist
+            }
+        }
+    }
+    if (added > 0) {
+        console.error(`[graph-migrator] Added ${added} enhanced symbol columns`);
+        try {
+            db.exec('CREATE INDEX IF NOT EXISTS idx_sym_parent ON symbols(parent_symbol_id) WHERE parent_symbol_id IS NOT NULL');
+            db.exec('CREATE INDEX IF NOT EXISTS idx_sym_exported ON symbols(is_exported) WHERE is_exported = 1');
+            db.exec('CREATE INDEX IF NOT EXISTS idx_sym_file_kind ON symbols(file_id, kind)');
+        }
+        catch {
+            // Indexes may already exist
+        }
+    }
+}
+function getExistingColumns(db, table) {
+    const rows = db.pragma(`table_info(${table})`);
+    return new Set(rows.map(r => r.name));
+}
+/** Check if graph migrations have been applied. */
+export function isGraphSchemaReady(db) {
+    try {
+        const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='relationships'").get();
+        return !!tables;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=migrator.js.map

package/dist/engine/database/migrator.js.map

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

package/dist/engine/db/database-manager.d.ts

@@ -0,0 +1,26 @@
+/**
+ * DatabaseManager — SQLite lifecycle management.
+ * Handles open, WAL mode, migrations, and graceful close.
+ */
+import Database from 'better-sqlite3';
+export declare class DatabaseManager {
+    private db;
+    private readonly dbPath;
+    private static resolvedBinding;
+    private static sharedDb;
+    private static initPromise;
+    constructor(dbPath: string);
+    /**
+     * Pre-resolve native binding (async). Call once at server startup before initialize().
+     * Downloads prebuilt binary if needed (standalone mode).
+     */
+    static preResolveBinding(): Promise<void>;
+    /** Open database, enable WAL, run migrations. */
+    initialize(): void;
+    /** Get the underlying database instance. */
+    getDb(): Database.Database;
+    /** Close database connection gracefully. */
+    close(): void;
+    private ensureDirectory;
+    private configureDatabase;
+}

package/dist/engine/db/database-manager.js

@@ -0,0 +1,80 @@
+/**
+ * DatabaseManager — SQLite lifecycle management.
+ * Handles open, WAL mode, migrations, and graceful close.
+ */
+import Database from 'better-sqlite3';
+import * as fs from 'fs';
+import * as path from 'path';
+import { runMigrations } from './migrations.js';
+import { resolveNativeBinding, resolveNativeBindingSync } from './native-addon-resolver.js';
+export class DatabaseManager {
+    db = null;
+    dbPath;
+    static resolvedBinding = null; // null = not yet resolved
+    static sharedDb = null;
+    static initPromise = null;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+    }
+    /**
+     * Pre-resolve native binding (async). Call once at server startup before initialize().
+     * Downloads prebuilt binary if needed (standalone mode).
+     */
+    static async preResolveBinding() {
+        DatabaseManager.resolvedBinding = await resolveNativeBinding();
+    }
+    /** Open database, enable WAL, run migrations. */
+    initialize() {
+        if (DatabaseManager.sharedDb) {
+            this.db = DatabaseManager.sharedDb;
+            return;
+        }
+        this.ensureDirectory();
+        // Use pre-resolved binding, or try sync resolve as fallback
+        const nativeBinding = DatabaseManager.resolvedBinding !== null
+            ? DatabaseManager.resolvedBinding
+            : resolveNativeBindingSync();
+        if (nativeBinding) {
+            console.error(`[db] Using native binding: ${nativeBinding}`);
+            this.db = new Database(this.dbPath, { nativeBinding });
+        }
+        else {
+            console.error('[db] Using npm-installed better-sqlite3');
+            this.db = new Database(this.dbPath);
+        }
+        this.configureDatabase();
+        runMigrations(this.db);
+        DatabaseManager.sharedDb = this.db;
+        console.error(`[db] Initialized at ${this.dbPath}`);
+    }
+    /** Get the underlying database instance. */
+    getDb() {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        return this.db;
+    }
+    /** Close database connection gracefully. */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            console.error('[db] Connection closed');
+        }
+    }
+    ensureDirectory() {
+        const dir = path.dirname(this.dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    configureDatabase() {
+        if (!this.db)
+            return;
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.pragma('cache_size = -64000');
+        this.db.pragma('foreign_keys = ON');
+        this.db.pragma('temp_store = MEMORY');
+    }
+}
+//# sourceMappingURL=database-manager.js.map

package/dist/engine/db/database-manager.js.map

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

package/dist/engine/db/migrations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration runner — sequential, versioned schema migrations.
+ * Each migration is applied once and tracked in schema_version table.
+ */
+import Database from 'better-sqlite3';
+/** Get current schema version from database. */
+export declare function getCurrentVersion(db: Database.Database): number;
+/** Run all pending migrations sequentially. */
+export declare function runMigrations(db: Database.Database): void;