@grafema/util 0.3.0-beta

package/dist/utils/startRfdbServer.js

@@ -0,0 +1,142 @@
+/**
+ * Shared utility for starting rfdb-server
+ *
+ * Single authoritative function for spawning rfdb-server. All spawn sites
+ * (RFDBServerBackend, CLI server command, ParallelAnalysisRunner) delegate here.
+ *
+ * If pidPath is provided, checks for an existing server via PID file before
+ * spawning. Returns null when an existing server is detected (caller should
+ * not kill it).
+ */
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+import { spawn } from 'child_process';
+import { setTimeout as sleep } from 'timers/promises';
+import { findRfdbBinary } from './findRfdbBinary.js';
+/**
+ * Check if an existing server is running based on PID file.
+ *
+ * Returns:
+ * - 'alive' — PID file exists, process is alive, socket is present
+ * - 'stale' — PID file exists but process is dead or PID is invalid
+ * - 'none'  — no PID file
+ */
+export function checkExistingServer(pidPath, socketPath, deps) {
+    if (!deps.existsSync(pidPath))
+        return 'none';
+    let pidStr;
+    try {
+        pidStr = deps.readFileSync(pidPath, 'utf8').trim();
+    }
+    catch {
+        return 'stale';
+    }
+    const pid = parseInt(pidStr, 10);
+    if (isNaN(pid) || pid <= 0)
+        return 'stale';
+    try {
+        deps.killProcess(pid, 0);
+        // Process is alive — check socket too
+        if (deps.existsSync(socketPath)) {
+            return 'alive';
+        }
+        // PID alive but socket gone (server crashed partially)
+        return 'stale';
+    }
+    catch (err) {
+        if (err && typeof err === 'object' && 'code' in err && err.code === 'ESRCH') {
+            return 'stale';
+        }
+        // Unexpected error — re-throw rather than silently treating as stale
+        throw err;
+    }
+}
+/**
+ * Start an rfdb-server process (or detect existing one via PID file).
+ *
+ * 0. Check PID file for existing server (if pidPath provided)
+ * 1. Resolve binary (explicit or via findRfdbBinary)
+ * 2. Remove stale socket
+ * 3. Spawn detached process
+ * 4. Write PID file (if pidPath provided)
+ * 5. Poll for socket file up to waitTimeoutMs
+ * 6. Return ChildProcess (caller decides whether to kill later)
+ *
+ * Returns null if an existing server is already running (pidPath + alive PID).
+ */
+export async function startRfdbServer(options) {
+    const { dbPath, socketPath, pidPath, waitTimeoutMs = 5000, logger, _deps, } = options;
+    const _spawn = _deps?.spawn ?? spawn;
+    const _findRfdbBinary = _deps?.findRfdbBinary ?? findRfdbBinary;
+    const _existsSync = _deps?.existsSync ?? existsSync;
+    const _unlinkSync = _deps?.unlinkSync ?? unlinkSync;
+    const _writeFileSync = _deps?.writeFileSync ?? writeFileSync;
+    const _readFileSync = _deps?.readFileSync ?? readFileSync;
+    const _killProcess = _deps?.killProcess ?? ((pid, signal) => process.kill(pid, signal));
+    // 0. Check for existing server via PID file
+    if (pidPath) {
+        const status = checkExistingServer(pidPath, socketPath, {
+            existsSync: _existsSync,
+            readFileSync: _readFileSync,
+            killProcess: _killProcess,
+        });
+        if (status === 'alive') {
+            logger?.debug(`rfdb-server already running (PID file: ${pidPath}), reusing`);
+            return null;
+        }
+        if (status === 'stale') {
+            logger?.debug(`Stale PID file found at ${pidPath}, removing`);
+            try {
+                _unlinkSync(pidPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // 1. Resolve binary
+    const binaryPath = options.binaryPath || _findRfdbBinary();
+    if (!binaryPath) {
+        throw new Error('RFDB server binary not found.\n' +
+            'Install @grafema/rfdb: npm install @grafema/rfdb\n' +
+            'Or build from source: cargo build --release --bin rfdb-server');
+    }
+    // 2. Remove stale socket
+    if (_existsSync(socketPath)) {
+        _unlinkSync(socketPath);
+    }
+    const dataDir = dirname(socketPath);
+    logger?.debug(`Starting rfdb-server: ${binaryPath} ${dbPath} --socket ${socketPath} --data-dir ${dataDir}`);
+    // 3. Spawn server (detached, survives parent exit)
+    // Mutable container to capture async spawn errors (Dijkstra amendment B)
+    const state = { spawnError: null };
+    const serverProcess = _spawn(binaryPath, [dbPath, '--socket', socketPath, '--data-dir', dataDir], {
+        stdio: ['ignore', 'ignore', process.stderr.isTTY ? 'inherit' : 'ignore'],
+        detached: true,
+    });
+    serverProcess.unref();
+    // Wire error handler to capture ENOENT and other spawn failures
+    serverProcess.on('error', (err) => {
+        state.spawnError = err;
+    });
+    // 4. Write PID file if requested and pid is available
+    if (pidPath && serverProcess.pid) {
+        _writeFileSync(pidPath, String(serverProcess.pid));
+    }
+    // 5. Poll for socket file
+    const maxAttempts = Math.ceil(waitTimeoutMs / 100);
+    let attempts = 0;
+    while (!_existsSync(socketPath) && attempts < maxAttempts) {
+        if (state.spawnError) {
+            throw new Error(`RFDB server failed to start: ${state.spawnError.message} — check binary: ${binaryPath}`);
+        }
+        await sleep(100);
+        attempts++;
+    }
+    // 6. Final check
+    if (!_existsSync(socketPath)) {
+        const detail = state.spawnError ? `: ${state.spawnError.message}` : '';
+        throw new Error(`RFDB server failed to start after ${waitTimeoutMs}ms${detail} — check binary: ${binaryPath}`);
+    }
+    logger?.debug(`rfdb-server started on ${socketPath}`);
+    return serverProcess;
+}
+//# sourceMappingURL=startRfdbServer.js.map

package/dist/utils/startRfdbServer.js.map

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

package/dist/validation/PathValidator.d.ts

@@ -0,0 +1,80 @@
+/**
+ * PathValidator - проверяет безопасность рефакторинга через path equivalence
+ *
+ * КОНЦЕПЦИЯ:
+ * 1. Трассируем пути от main версии функции до endpoints (DATABASE, HTTP, EXTERNAL)
+ * 2. Трассируем пути от __local версии до тех же endpoints
+ * 3. Сравниваем: если все пути сохранились → safe, если нет → breaking change
+ *
+ * ENDPOINTS (критические точки):
+ * - DATABASE_QUERY: запросы к БД
+ * - HTTP_REQUEST: HTTP запросы
+ * - EXTERNAL: внешние сервисы
+ * - FILESYSTEM: операции с файлами
+ * - MODULE_BOUNDARY: exported functions
+ * - SIDE_EFFECTS: console.log, process.exit и т.д.
+ */
+import type { GraphBackend } from '@grafema/types';
+/**
+ * Validation result
+ */
+export interface PathValidationResult {
+    safe: boolean;
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    deleted?: boolean;
+    missing?: EndpointDiff[];
+    added?: EndpointDiff[];
+    endpointsChecked: number;
+}
+/**
+ * Endpoint diff info
+ */
+export interface EndpointDiff {
+    type: string;
+    name: string;
+    reason: string;
+}
+export declare class PathValidator {
+    private backend;
+    constructor(backend: GraphBackend);
+    /**
+     * Проверить эквивалентность путей между main и __local версиями функции
+     *
+     * @param functionName - Имя функции
+     * @param file - Путь к файлу
+     * @returns Результат валидации
+     */
+    checkPathEquivalence(functionName: string, file: string): Promise<PathValidationResult>;
+    /**
+     * Получить все достижимые endpoints из данной ноды
+     *
+     * @param nodeId - ID начальной ноды
+     * @returns Массив endpoint нод
+     */
+    private _getReachableEndpoints;
+    /**
+     * Сравнить два набора endpoints
+     *
+     * @param mainEndpoints - Endpoints из main версии
+     * @param localEndpoints - Endpoints из __local версии
+     * @returns { missing: [], added: [] }
+     */
+    private _compareEndpoints;
+    /**
+     * Получить уникальный ключ для endpoint
+     *
+     * @param endpoint - Endpoint нода
+     * @returns Уникальный ключ
+     */
+    private _getEndpointKey;
+    /**
+     * Получить reason для missing endpoint
+     */
+    private _getMissingReason;
+    /**
+     * Получить reason для added endpoint
+     */
+    private _getAddedReason;
+}
+//# sourceMappingURL=PathValidator.d.ts.map

package/dist/validation/PathValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathValidator.d.ts","sourceRoot":"","sources":["../../src/validation/PathValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAWnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IAIjC;;;;;;OAMG;IACG,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsF7F;;;;;OAKG;YACW,sBAAsB;IAwDpC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB"}

package/dist/validation/PathValidator.js

@@ -0,0 +1,252 @@
+/**
+ * PathValidator - проверяет безопасность рефакторинга через path equivalence
+ *
+ * КОНЦЕПЦИЯ:
+ * 1. Трассируем пути от main версии функции до endpoints (DATABASE, HTTP, EXTERNAL)
+ * 2. Трассируем пути от __local версии до тех же endpoints
+ * 3. Сравниваем: если все пути сохранились → safe, если нет → breaking change
+ *
+ * ENDPOINTS (критические точки):
+ * - DATABASE_QUERY: запросы к БД
+ * - HTTP_REQUEST: HTTP запросы
+ * - EXTERNAL: внешние сервисы
+ * - FILESYSTEM: операции с файлами
+ * - MODULE_BOUNDARY: exported functions
+ * - SIDE_EFFECTS: console.log, process.exit и т.д.
+ */
+export class PathValidator {
+    backend;
+    constructor(backend) {
+        this.backend = backend;
+    }
+    /**
+     * Проверить эквивалентность путей между main и __local версиями функции
+     *
+     * @param functionName - Имя функции
+     * @param file - Путь к файлу
+     * @returns Результат валидации
+     */
+    async checkPathEquivalence(functionName, file) {
+        // 1. Найти все версии функции (main и __local) по имени
+        const allVersions = [];
+        for await (const node of this.backend.queryNodes({ type: 'FUNCTION', name: functionName })) {
+            // Дополнительно фильтруем по file если он указан
+            if (node.file === file || node.file === undefined) {
+                allVersions.push(node);
+            }
+        }
+        const mainFunction = allVersions.find(n => n.version === 'main');
+        const localFunction = allVersions.find(n => n.version === '__local');
+        // 3. Обработать случаи: deleted, added, exists
+        if (!mainFunction && localFunction) {
+            // Новая функция
+            return {
+                safe: true,
+                severity: 'info',
+                message: `New function added: ${functionName}`,
+                endpointsChecked: 0
+            };
+        }
+        if (mainFunction && !localFunction) {
+            // Функция удалена
+            return {
+                safe: false,
+                severity: 'error',
+                deleted: true,
+                message: `Function deleted: ${functionName}`,
+                endpointsChecked: 0
+            };
+        }
+        if (!mainFunction && !localFunction) {
+            // Функция не найдена вообще
+            return {
+                safe: false,
+                severity: 'error',
+                message: `Function not found: ${functionName}`,
+                endpointsChecked: 0
+            };
+        }
+        // 4. Получить все endpoints для main версии
+        const mainEndpoints = await this._getReachableEndpoints(mainFunction.id);
+        // 5. Получить все endpoints для local версии
+        const localEndpoints = await this._getReachableEndpoints(localFunction.id);
+        // 6. Сравнить endpoints
+        const comparison = this._compareEndpoints(mainEndpoints, localEndpoints);
+        // 7. Определить результат
+        if (comparison.missing.length > 0) {
+            // Breaking change - критические endpoints удалены
+            return {
+                safe: false,
+                severity: 'error',
+                message: `Breaking change detected: ${comparison.missing.length} endpoint(s) no longer reachable`,
+                missing: comparison.missing,
+                endpointsChecked: mainEndpoints.length
+            };
+        }
+        if (comparison.added.length > 0) {
+            // Warning - новые endpoints добавлены
+            return {
+                safe: true,
+                severity: 'warning',
+                message: `New behavior added: ${comparison.added.length} new endpoint(s) reachable`,
+                added: comparison.added,
+                endpointsChecked: mainEndpoints.length
+            };
+        }
+        // Safe refactoring - все endpoints сохранены
+        return {
+            safe: true,
+            severity: 'info',
+            message: `Safe refactoring: all endpoints preserved`,
+            endpointsChecked: mainEndpoints.length
+        };
+    }
+    /**
+     * Получить все достижимые endpoints из данной ноды
+     *
+     * @param nodeId - ID начальной ноды
+     * @returns Массив endpoint нод
+     */
+    async _getReachableEndpoints(nodeId) {
+        // Трассируем пути через CALLS рёбра (BFS до глубины 10)
+        // Endpoints - это ноды типа: DATABASE_QUERY, HTTP_REQUEST, EXTERNAL, FILESYSTEM, SIDE_EFFECT
+        // Или exported FUNCTION (MODULE_BOUNDARY)
+        const CALLS_EDGE_TYPE = 'CALLS';
+        const MAX_DEPTH = 10;
+        // BFS для поиска всех достижимых нод
+        const visited = new Set();
+        const queue = [{ id: nodeId, depth: 0 }];
+        const endpoints = [];
+        while (queue.length > 0) {
+            const { id, depth } = queue.shift();
+            if (visited.has(id) || depth > MAX_DEPTH) {
+                continue;
+            }
+            visited.add(id);
+            // Получить ноду и проверить является ли она endpoint
+            const node = await this.backend.getNode(id);
+            if (node && id !== nodeId) {
+                // Check for endpoint types (new namespaced types + legacy names for backward compat)
+                const endpointTypes = [
+                    'db:query', 'DATABASE_QUERY',
+                    'http:request', 'HTTP_REQUEST',
+                    'EXTERNAL',
+                    'fs:operation', 'FILESYSTEM',
+                    'SIDE_EFFECT',
+                    'net:request', 'EXTERNAL_NETWORK',
+                    'net:stdio', 'EXTERNAL_STDIO'
+                ];
+                const isEndpoint = endpointTypes.includes(node.type) ||
+                    (node.type === 'FUNCTION' && node.exported === true);
+                if (isEndpoint) {
+                    endpoints.push(node);
+                }
+            }
+            // Получить исходящие CALLS рёбра
+            const outgoingEdges = await this.backend.getOutgoingEdges(id, [CALLS_EDGE_TYPE]);
+            for (const edge of outgoingEdges) {
+                const dstId = typeof edge.dst === 'string' ? edge.dst : String(edge.dst);
+                if (!visited.has(dstId)) {
+                    queue.push({ id: dstId, depth: depth + 1 });
+                }
+            }
+        }
+        return endpoints;
+    }
+    /**
+     * Сравнить два набора endpoints
+     *
+     * @param mainEndpoints - Endpoints из main версии
+     * @param localEndpoints - Endpoints из __local версии
+     * @returns { missing: [], added: [] }
+     */
+    _compareEndpoints(mainEndpoints, localEndpoints) {
+        const missing = [];
+        const added = [];
+        // Создаём Map для быстрого поиска
+        const localMap = new Map();
+        localEndpoints.forEach(ep => {
+            const key = this._getEndpointKey(ep);
+            localMap.set(key, ep);
+        });
+        const mainMap = new Map();
+        mainEndpoints.forEach(ep => {
+            const key = this._getEndpointKey(ep);
+            mainMap.set(key, ep);
+        });
+        // Находим missing endpoints (есть в main, но нет в local)
+        for (const [key, endpoint] of mainMap.entries()) {
+            if (!localMap.has(key)) {
+                missing.push({
+                    type: endpoint.type,
+                    name: endpoint.name || endpoint.query || 'unknown',
+                    reason: this._getMissingReason(endpoint)
+                });
+            }
+        }
+        // Находим added endpoints (есть в local, но нет в main)
+        for (const [key, endpoint] of localMap.entries()) {
+            if (!mainMap.has(key)) {
+                added.push({
+                    type: endpoint.type,
+                    name: endpoint.name || endpoint.query || 'unknown',
+                    reason: this._getAddedReason(endpoint)
+                });
+            }
+        }
+        return { missing, added };
+    }
+    /**
+     * Получить уникальный ключ для endpoint
+     *
+     * @param endpoint - Endpoint нода
+     * @returns Уникальный ключ
+     */
+    _getEndpointKey(endpoint) {
+        if (endpoint.type === 'DATABASE_QUERY' || endpoint.type === 'db:query') {
+            // Для DB query используем query text
+            return `db:query:${endpoint.query || endpoint.name}`;
+        }
+        if (endpoint.type === 'FUNCTION' && endpoint.exported) {
+            // Для exported functions используем stable ID
+            return `${endpoint.type}:${endpoint.name}:${endpoint.file}`;
+        }
+        if (endpoint.type === 'EXTERNAL') {
+            // Для external используем service + name
+            return `${endpoint.type}:${endpoint.service}:${endpoint.name}`;
+        }
+        // Для остальных используем type + name
+        return `${endpoint.type}:${endpoint.name}`;
+    }
+    /**
+     * Получить reason для missing endpoint
+     */
+    _getMissingReason(endpoint) {
+        if (endpoint.type === 'DATABASE_QUERY') {
+            return `Database query no longer executed: ${endpoint.query}`;
+        }
+        if (endpoint.type === 'FUNCTION' && endpoint.exported) {
+            return `Exported function no longer called: ${endpoint.name}`;
+        }
+        if (endpoint.type === 'EXTERNAL') {
+            return `External service no longer called: ${endpoint.service}/${endpoint.name}`;
+        }
+        return `Endpoint no longer reachable: ${endpoint.name}`;
+    }
+    /**
+     * Получить reason для added endpoint
+     */
+    _getAddedReason(endpoint) {
+        if (endpoint.type === 'DATABASE_QUERY') {
+            return `New database query added: ${endpoint.query}`;
+        }
+        if (endpoint.type === 'FUNCTION' && endpoint.exported) {
+            return `New call to exported function: ${endpoint.name}`;
+        }
+        if (endpoint.type === 'EXTERNAL') {
+            return `New external service call: ${endpoint.service}/${endpoint.name}`;
+        }
+        return `New endpoint reachable: ${endpoint.name}`;
+    }
+}
+//# sourceMappingURL=PathValidator.js.map

package/dist/validation/PathValidator.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/** Full Grafema version string (e.g., "0.2.5-beta") */
+export declare const GRAFEMA_VERSION: string;
+/**
+ * Extract major.minor.patch from a version string, stripping pre-release tags.
+ *
+ * "0.2.5-beta" → "0.2.5"
+ * "0.2.5" → "0.2.5"
+ * "1.0.0-alpha.1" → "1.0.0"
+ */
+export declare function getSchemaVersion(version: string): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAaA,uDAAuD;AACvD,eAAO,MAAM,eAAe,EAAE,MAAoB,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxD"}

package/dist/version.js

@@ -0,0 +1,26 @@
+/**
+ * Grafema version constants.
+ *
+ * Reads version from @grafema/util package.json at module load time.
+ * This is the single source of truth for runtime version checks.
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+/** Full Grafema version string (e.g., "0.2.5-beta") */
+export const GRAFEMA_VERSION = pkg.version;
+/**
+ * Extract major.minor.patch from a version string, stripping pre-release tags.
+ *
+ * "0.2.5-beta" → "0.2.5"
+ * "0.2.5" → "0.2.5"
+ * "1.0.0-alpha.1" → "1.0.0"
+ */
+export function getSchemaVersion(version) {
+    // Strip pre-release tag (everything after first hyphen)
+    const base = version.split('-')[0];
+    return base;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAErF,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAW,GAAG,CAAC,OAAO,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,wDAAwD;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@grafema/util",
+  "version": "0.3.0-beta",
+  "description": "Query, config, and guarantee utilities for Grafema",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "grafema",
+    "code-analysis",
+    "utilities"
+  ],
+  "license": "Apache-2.0",
+  "author": "Vadim Reshetnikov",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Disentinel/grafema.git",
+    "directory": "packages/util"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "minimatch": "^10.1.1",
+    "yaml": "^2.8.2",
+    "@grafema/rfdb-client": "0.3.0-beta",
+    "@grafema/types": "0.3.0-beta"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.8",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "cp -r src/instructions/*.md dist/instructions/",
+    "clean": "rm -rf dist"
+  }
+}