@grafema/util 0.3.0-beta

package/dist/core/GuaranteeManager.js

@@ -0,0 +1,447 @@
+/**
+ * GuaranteeManager - управление гарантиями/инвариантами кода
+ *
+ * GUARANTEE ноды хранят Datalog правила, которые код должен соблюдать.
+ * GOVERNS edges связывают гарантии с модулями, к которым они применяются.
+ *
+ * Workflow:
+ * 1. Создать гарантию (create) → GUARANTEE нода + GOVERNS edges
+ * 2. Проверить (check) → выполнить Datalog rule, найти нарушения
+ * 3. Экспортировать (export) → сохранить в YAML для version control
+ * 4. Импортировать (import) → загрузить из YAML в граф
+ * 5. Drift detection → сравнить граф с файлом
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join, isAbsolute, relative } from 'path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { minimatch } from 'minimatch';
+import { brandNodeInternal } from './brandNodeInternal.js';
+export class GuaranteeManager {
+    graph;
+    projectPath;
+    guaranteesFile;
+    constructor(graph, projectPath) {
+        this.graph = graph;
+        this.projectPath = projectPath;
+        this.guaranteesFile = join(projectPath, '.grafema', 'guarantees.yaml');
+    }
+    /**
+     * Создать новую гарантию
+     */
+    async create(guarantee) {
+        const { id, name, rule, severity = 'warning', governs = ['**/*.js'] } = guarantee;
+        if (!id || !rule) {
+            throw new Error('Guarantee must have id and rule');
+        }
+        // Создаём GUARANTEE ноду
+        const guaranteeNode = brandNodeInternal({
+            id: `GUARANTEE:${id}`,
+            type: 'GUARANTEE',
+            name: name || id,
+            rule,
+            severity,
+            governs,
+            version: 'meta',
+            createdAt: Date.now(),
+        });
+        await this.graph.addNode(guaranteeNode);
+        // Создаём GOVERNS edges к matching модулям
+        await this._createGovernsEdges(guaranteeNode.id, governs);
+        return guaranteeNode;
+    }
+    /**
+     * Получить все гарантии из графа
+     */
+    async list() {
+        const guarantees = [];
+        for await (const node of this.graph.queryNodes({ type: 'GUARANTEE' })) {
+            const guaranteeNode = node;
+            // Получаем GOVERNS edges для этой гарантии
+            const governsEdges = await this.graph.getOutgoingEdges(guaranteeNode.id, ['GOVERNS']);
+            const governedModules = [];
+            for (const edge of governsEdges) {
+                const targetNode = await this.graph.getNode(edge.dst);
+                if (targetNode) {
+                    governedModules.push(targetNode.file || targetNode.id);
+                }
+            }
+            guarantees.push({
+                ...guaranteeNode,
+                governedModules
+            });
+        }
+        return guarantees;
+    }
+    /**
+     * Проверить гарантию
+     */
+    async check(guaranteeId) {
+        const fullId = guaranteeId.startsWith('GUARANTEE:') ? guaranteeId : `GUARANTEE:${guaranteeId}`;
+        const node = (await this.graph.getNode(fullId));
+        if (!node) {
+            throw new Error(`Guarantee not found: ${guaranteeId}`);
+        }
+        const startTime = Date.now();
+        let violations = [];
+        let error = null;
+        try {
+            violations = await this.graph.checkGuarantee(node.rule);
+        }
+        catch (e) {
+            error = e instanceof Error ? e.message : String(e);
+        }
+        // Обогащаем violations информацией о нодах
+        const enrichedViolations = [];
+        for (const v of violations) {
+            const nodeId = v.bindings?.find(b => b.name === 'X')?.value;
+            if (nodeId) {
+                const violatingNode = await this.graph.getNode(nodeId);
+                if (violatingNode) {
+                    enrichedViolations.push({
+                        nodeId,
+                        type: violatingNode.type,
+                        name: violatingNode.name,
+                        file: violatingNode.file,
+                        line: violatingNode.line
+                    });
+                }
+                else {
+                    // Non-node-ID binding (e.g. attr() string value) — return raw binding as violation
+                    enrichedViolations.push({ nodeId, type: 'raw_binding', name: nodeId });
+                }
+            }
+        }
+        return {
+            guaranteeId: guaranteeId,
+            name: node.name,
+            severity: node.severity,
+            passed: violations.length === 0 && !error,
+            violationCount: violations.length,
+            violations: enrichedViolations,
+            error,
+            checkDurationMs: Date.now() - startTime
+        };
+    }
+    /**
+     * Проверить все гарантии
+     */
+    async checkAll() {
+        const guarantees = await this.list();
+        const results = [];
+        let passedCount = 0;
+        let failedCount = 0;
+        let errorCount = 0;
+        for (const g of guarantees) {
+            const result = await this.check(g.id);
+            results.push(result);
+            if (result.error) {
+                errorCount++;
+            }
+            else if (result.passed) {
+                passedCount++;
+            }
+            else {
+                failedCount++;
+            }
+        }
+        return {
+            total: guarantees.length,
+            passed: passedCount,
+            failed: failedCount,
+            errors: errorCount,
+            results
+        };
+    }
+    /**
+     * Extract type references from a Datalog rule.
+     * Matches node(X, "TYPE") and edge(X, Y, "TYPE") patterns.
+     * Returns unique types array. If nothing parseable, returns empty array.
+     */
+    extractRelevantTypes(rule) {
+        const types = new Set();
+        // Match node(X, "TYPE") or type(X, "TYPE") patterns
+        const nodePattern = /(?:node|type)\(\s*\w+\s*,\s*"([^"]+)"\s*\)/g;
+        let match;
+        while ((match = nodePattern.exec(rule)) !== null) {
+            types.add(match[1]);
+        }
+        // Match edge(X, Y, "TYPE") patterns
+        const edgePattern = /edge\(\s*\w+\s*,\s*\w+\s*,\s*"([^"]+)"\s*\)/g;
+        while ((match = edgePattern.exec(rule)) !== null) {
+            types.add(match[1]);
+        }
+        return [...types];
+    }
+    /**
+     * Selectively check guarantees whose relevant types overlap with changedTypes.
+     * Guarantees with no parseable types are always checked (conservative).
+     * Returns CheckAllResult with total = all guarantees count,
+     * but results only for the checked subset.
+     */
+    async checkSelective(changedTypes) {
+        const guarantees = await this.list();
+        const results = [];
+        let passedCount = 0;
+        let failedCount = 0;
+        let errorCount = 0;
+        for (const g of guarantees) {
+            const relevantTypes = this.extractRelevantTypes(g.rule);
+            // If no types parseable, check conservatively; otherwise check only if overlap
+            const shouldCheck = relevantTypes.length === 0 ||
+                relevantTypes.some(t => changedTypes.has(t));
+            if (!shouldCheck)
+                continue;
+            const result = await this.check(g.id);
+            results.push(result);
+            if (result.error) {
+                errorCount++;
+            }
+            else if (result.passed) {
+                passedCount++;
+            }
+            else {
+                failedCount++;
+            }
+        }
+        return {
+            total: guarantees.length,
+            passed: passedCount,
+            failed: failedCount,
+            errors: errorCount,
+            results
+        };
+    }
+    /**
+     * Load guarantees from the project's YAML file (.grafema/guarantees.yaml).
+     *
+     * Reads the YAML file, skips non-datalog guarantees (e.g., integration-test),
+     * and creates GUARANTEE nodes in the graph for each datalog guarantee.
+     * Idempotent: skips guarantees that already exist in the graph.
+     * Gracefully handles missing file (no error, just returns).
+     *
+     * @returns ImportResult with counts of imported and skipped guarantees
+     */
+    async loadFromYaml() {
+        if (!existsSync(this.guaranteesFile)) {
+            return { imported: 0, skipped: 0, importedIds: [], skippedIds: [] };
+        }
+        return this.import(this.guaranteesFile);
+    }
+    /**
+     * Удалить гарантию
+     */
+    async delete(guaranteeId) {
+        const fullId = guaranteeId.startsWith('GUARANTEE:') ? guaranteeId : `GUARANTEE:${guaranteeId}`;
+        // Удаляем GOVERNS edges
+        const edges = await this.graph.getOutgoingEdges(fullId, ['GOVERNS']);
+        for (const edge of edges) {
+            await this.graph.deleteEdge(edge.src, edge.dst, 'GOVERNS');
+        }
+        // Удаляем ноду
+        await this.graph.deleteNode(fullId);
+    }
+    /**
+     * Экспортировать гарантии в YAML файл
+     */
+    async export(filePath = this.guaranteesFile) {
+        const guarantees = await this.list();
+        const exportData = {
+            version: 1,
+            exportedAt: new Date().toISOString(),
+            guarantees: guarantees.map(g => ({
+                id: g.id.replace('GUARANTEE:', ''),
+                name: g.name,
+                rule: g.rule,
+                severity: g.severity,
+                governs: g.governs || ['**/*.js']
+            }))
+        };
+        const yaml = stringifyYaml(exportData, { lineWidth: 0 });
+        writeFileSync(filePath, yaml, 'utf-8');
+        return filePath;
+    }
+    /**
+     * Импортировать гарантии из YAML файла
+     */
+    async import(filePath = this.guaranteesFile, options = {}) {
+        const { clearExisting = false } = options;
+        if (!existsSync(filePath)) {
+            throw new Error(`Guarantees file not found: ${filePath}`);
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        const data = parseYaml(content);
+        if (!data.guarantees || !Array.isArray(data.guarantees)) {
+            throw new Error('Invalid guarantees file format');
+        }
+        // Удаляем существующие если нужно
+        if (clearExisting) {
+            const existing = await this.list();
+            for (const g of existing) {
+                await this.delete(g.id);
+            }
+        }
+        // Импортируем
+        const imported = [];
+        const skipped = [];
+        for (const g of data.guarantees) {
+            // Normalize: YAML uses 'name', code expects 'id'
+            if (!g.id && g.name)
+                g.id = g.name;
+            // Skip non-Datalog guarantees (integration-test entries have no rule)
+            if (!g.rule) {
+                skipped.push(g.id || g.name || 'unknown');
+                continue;
+            }
+            const fullId = `GUARANTEE:${g.id}`;
+            const existing = await this.graph.getNode(fullId);
+            if (existing && !clearExisting) {
+                skipped.push(g.id);
+                continue;
+            }
+            // Default governs to all files if not specified in YAML
+            if (!g.governs) {
+                g.governs = ['**/*'];
+            }
+            await this.create(g);
+            imported.push(g.id);
+        }
+        return {
+            imported: imported.length,
+            skipped: skipped.length,
+            importedIds: imported,
+            skippedIds: skipped
+        };
+    }
+    /**
+     * Показать drift между графом и файлом
+     */
+    async drift(filePath = this.guaranteesFile) {
+        const graphGuarantees = await this.list();
+        const graphMap = new Map(graphGuarantees.map(g => [g.id.replace('GUARANTEE:', ''), g]));
+        let fileGuarantees = [];
+        if (existsSync(filePath)) {
+            const content = readFileSync(filePath, 'utf-8');
+            const data = parseYaml(content);
+            fileGuarantees = data.guarantees || [];
+        }
+        const fileMap = new Map(fileGuarantees.map(g => [g.id, g]));
+        const onlyInGraph = [];
+        const onlyInFile = [];
+        const modified = [];
+        const unchanged = [];
+        // Проверяем гарантии в графе
+        for (const [id, graphG] of graphMap) {
+            const fileG = fileMap.get(id);
+            if (!fileG) {
+                onlyInGraph.push(id);
+            }
+            else if (this._hasChanges(graphG, fileG)) {
+                modified.push({
+                    id,
+                    changes: this._describeChanges(graphG, fileG)
+                });
+            }
+            else {
+                unchanged.push(id);
+            }
+        }
+        // Проверяем гарантии только в файле
+        for (const [id] of fileMap) {
+            if (!graphMap.has(id)) {
+                onlyInFile.push(id);
+            }
+        }
+        return {
+            hasDrift: onlyInGraph.length > 0 || onlyInFile.length > 0 || modified.length > 0,
+            summary: {
+                onlyInGraph: onlyInGraph.length,
+                onlyInFile: onlyInFile.length,
+                modified: modified.length,
+                unchanged: unchanged.length
+            },
+            onlyInGraph,
+            onlyInFile,
+            modified,
+            unchanged
+        };
+    }
+    /**
+     * Найти гарантии затронутые изменением ноды
+     */
+    async findAffectedGuarantees(nodeId) {
+        const node = await this.graph.getNode(nodeId);
+        if (!node)
+            return [];
+        // Поднимаемся до MODULE
+        let moduleId = null;
+        if (node.type === 'MODULE') {
+            moduleId = node.id;
+        }
+        else if (node.file) {
+            // Ищем MODULE по file
+            for await (const m of this.graph.queryNodes({ type: 'MODULE' })) {
+                if (m.file === node.file) {
+                    moduleId = m.id;
+                    break;
+                }
+            }
+        }
+        if (!moduleId)
+            return [];
+        // Находим GOVERNS edges к этому модулю
+        const incomingEdges = await this.graph.getIncomingEdges(moduleId, ['GOVERNS']);
+        return incomingEdges.map(e => e.src);
+    }
+    // ============ Private methods ============
+    /**
+     * Создать GOVERNS edges к модулям по glob patterns
+     */
+    async _createGovernsEdges(guaranteeId, patterns) {
+        // Получаем все MODULE ноды
+        const modules = [];
+        for await (const node of this.graph.queryNodes({ type: 'MODULE' })) {
+            modules.push(node);
+        }
+        // Матчим patterns
+        for (const module of modules) {
+            const relativePath = module.file
+                ? (isAbsolute(module.file) ? relative(this.projectPath, module.file) : module.file)
+                : '';
+            for (const pattern of patterns) {
+                if (minimatch(relativePath, pattern) || minimatch(module.file || '', pattern)) {
+                    await this.graph.addEdge({
+                        type: 'GOVERNS',
+                        src: guaranteeId,
+                        dst: module.id
+                    });
+                    break; // Один edge на модуль
+                }
+            }
+        }
+    }
+    /**
+     * Проверить есть ли изменения между версиями гарантии
+     */
+    _hasChanges(graphG, fileG) {
+        return (graphG.rule !== fileG.rule ||
+            graphG.severity !== fileG.severity ||
+            graphG.name !== fileG.name ||
+            JSON.stringify(graphG.governs) !== JSON.stringify(fileG.governs));
+    }
+    /**
+     * Описать изменения между версиями
+     */
+    _describeChanges(graphG, fileG) {
+        const changes = [];
+        if (graphG.rule !== fileG.rule)
+            changes.push('rule');
+        if (graphG.severity !== fileG.severity)
+            changes.push('severity');
+        if (graphG.name !== fileG.name)
+            changes.push('name');
+        if (JSON.stringify(graphG.governs) !== JSON.stringify(fileG.governs))
+            changes.push('governs');
+        return changes;
+    }
+}
+//# sourceMappingURL=GuaranteeManager.js.map

package/dist/core/GuaranteeManager.js.map

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

package/dist/core/HashUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HashUtils - unified hash computation for Grafema
+ *
+ * WHY THIS EXISTS:
+ * - 6 copies of the same hash computation existed across the codebase
+ * - Single source of truth ensures consistent hashing everywhere
+ * - Makes future algorithm changes (e.g., SHA-256 -> BLAKE3) trivial
+ */
+/**
+ * Calculate hash from a file path (synchronous).
+ * Returns null if file doesn't exist or is unreadable.
+ */
+export declare function calculateFileHash(filePath: string): string | null;
+/**
+ * Calculate hash from a file path (asynchronous).
+ * Returns null if file doesn't exist or is unreadable.
+ */
+export declare function calculateFileHashAsync(filePath: string): Promise<string | null>;
+/**
+ * Calculate hash from content string.
+ * Always returns a hash (never null).
+ */
+export declare function calculateContentHash(content: string): string;
+//# sourceMappingURL=HashUtils.d.ts.map

package/dist/core/HashUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashUtils.d.ts","sourceRoot":"","sources":["../../src/core/HashUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOrF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/core/HashUtils.js

@@ -0,0 +1,46 @@
+/**
+ * HashUtils - unified hash computation for Grafema
+ *
+ * WHY THIS EXISTS:
+ * - 6 copies of the same hash computation existed across the codebase
+ * - Single source of truth ensures consistent hashing everywhere
+ * - Makes future algorithm changes (e.g., SHA-256 -> BLAKE3) trivial
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { readFile } from 'fs/promises';
+const HASH_ALGORITHM = 'sha256';
+/**
+ * Calculate hash from a file path (synchronous).
+ * Returns null if file doesn't exist or is unreadable.
+ */
+export function calculateFileHash(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        return createHash(HASH_ALGORITHM).update(content).digest('hex');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Calculate hash from a file path (asynchronous).
+ * Returns null if file doesn't exist or is unreadable.
+ */
+export async function calculateFileHashAsync(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return createHash(HASH_ALGORITHM).update(content).digest('hex');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Calculate hash from content string.
+ * Always returns a hash (never null).
+ */
+export function calculateContentHash(content) {
+    return createHash(HASH_ALGORITHM).update(content).digest('hex');
+}
+//# sourceMappingURL=HashUtils.js.map

package/dist/core/HashUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashUtils.js","sourceRoot":"","sources":["../../src/core/HashUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/IncrementalReanalyzer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * IncrementalReanalyzer - selective re-analysis of stale modules
+ *
+ * Shells out to grafema-orchestrator for reanalysis.
+ * The Rust orchestrator handles clearing, indexing, analysis, and enrichment.
+ */
+import type { GraphBackend } from '@grafema/types';
+import type { StaleModule } from './GraphFreshnessChecker.js';
+export interface ReanalysisOptions {
+    skipEnrichment?: boolean;
+    onProgress?: (info: ReanalysisProgress) => void;
+}
+export interface ReanalysisProgress {
+    phase: 'clearing' | 'indexing' | 'analysis' | 'enrichment';
+    processedFiles: number;
+    totalFiles: number;
+    currentService?: string;
+}
+export interface ReanalysisResult {
+    modulesReanalyzed: number;
+    modulesDeleted: number;
+    nodesCreated: number;
+    edgesCreated: number;
+    nodesCleared: number;
+    durationMs: number;
+}
+export declare class IncrementalReanalyzer {
+    private _graph;
+    private projectPath;
+    constructor(graph: GraphBackend, projectPath: string);
+    reanalyze(staleModules: StaleModule[], _options?: ReanalysisOptions): Promise<ReanalysisResult>;
+}
+//# sourceMappingURL=IncrementalReanalyzer.d.ts.map

package/dist/core/IncrementalReanalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IncrementalReanalyzer.d.ts","sourceRoot":"","sources":["../../src/core/IncrementalReanalyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM;IAK9C,SAAS,CACb,YAAY,EAAE,WAAW,EAAE,EAC3B,QAAQ,GAAE,iBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;CA2D7B"}

package/dist/core/IncrementalReanalyzer.js

@@ -0,0 +1,67 @@
+/**
+ * IncrementalReanalyzer - selective re-analysis of stale modules
+ *
+ * Shells out to grafema-orchestrator for reanalysis.
+ * The Rust orchestrator handles clearing, indexing, analysis, and enrichment.
+ */
+import { spawn } from 'child_process';
+import { join } from 'path';
+import { findOrchestratorBinary } from '../utils/findRfdbBinary.js';
+export class IncrementalReanalyzer {
+    _graph;
+    projectPath;
+    constructor(graph, projectPath) {
+        this._graph = graph;
+        this.projectPath = projectPath;
+    }
+    async reanalyze(staleModules, _options = {}) {
+        const startTime = Date.now();
+        if (staleModules.length === 0) {
+            return {
+                modulesReanalyzed: 0,
+                modulesDeleted: 0,
+                nodesCreated: 0,
+                edgesCreated: 0,
+                nodesCleared: 0,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        const binary = findOrchestratorBinary();
+        if (!binary) {
+            throw new Error('grafema-orchestrator binary not found. ' +
+                'Build it with: cd packages/grafema-orchestrator && cargo build --release');
+        }
+        const socketPath = join(this.projectPath, '.grafema', 'rfdb.sock');
+        return new Promise((resolve, reject) => {
+            const child = spawn(binary, [
+                'analyze',
+                '--project', this.projectPath,
+                '--socket', socketPath,
+            ], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderr = '';
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Failed to start grafema-orchestrator: ${err.message}`));
+            });
+            child.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`grafema-orchestrator exited with code ${code}: ${stderr}`));
+                    return;
+                }
+                resolve({
+                    modulesReanalyzed: staleModules.filter(m => m.currentHash !== null).length,
+                    modulesDeleted: staleModules.filter(m => m.currentHash === null).length,
+                    nodesCreated: 0,
+                    edgesCreated: 0,
+                    nodesCleared: 0,
+                    durationMs: Date.now() - startTime,
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=IncrementalReanalyzer.js.map

package/dist/core/IncrementalReanalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IncrementalReanalyzer.js","sourceRoot":"","sources":["../../src/core/IncrementalReanalyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAuBpE,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAe;IACrB,WAAW,CAAS;IAE5B,YAAY,KAAmB,EAAE,WAAmB;QAClD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,SAAS,CACb,YAA2B,EAC3B,WAA8B,EAAE;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,iBAAiB,EAAE,CAAC;gBACpB,cAAc,EAAE,CAAC;gBACjB,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,yCAAyC;gBACzC,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAEnE,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE;gBAC1B,SAAS;gBACT,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,UAAU;aACvB,EAAE;gBACD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;oBAC9E,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC;oBACN,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,MAAM;oBAC1E,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,MAAM;oBACvE,YAAY,EAAE,CAAC;oBACf,YAAY,EAAE,CAAC;oBACf,YAAY,EAAE,CAAC;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACnC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}