@optave/codegraph 3.2.0 → 3.3.0

package/dist/features/shared/find-nodes.js

@@ -0,0 +1,27 @@
+import { buildFileConditionSQL } from '../../db/query-builder.js';
+import { isTestFile } from '../../infrastructure/test-filter.js';
+/**
+ * Look up node(s) by name with optional file/kind/noTests filtering.
+ *
+ * @param {object} db - open SQLite database handle
+ * @param {string} name - symbol name (partial LIKE match)
+ * @param {object} [opts] - { kind, file, noTests }
+ * @param {string[]} defaultKinds - fallback kinds when opts.kind is not set
+ * @returns {object[]} matching node rows
+ */
+export function findNodes(db, name, opts = {}, defaultKinds = []) {
+    const kinds = opts.kind ? [opts.kind] : defaultKinds;
+    if (kinds.length === 0)
+        throw new Error('findNodes: no kinds specified');
+    const placeholders = kinds.map(() => '?').join(', ');
+    const params = [`%${name}%`, ...kinds];
+    const fc = buildFileConditionSQL(opts.file, 'file');
+    params.push(...fc.params);
+    const rows = db
+        .prepare(`SELECT * FROM nodes
+       WHERE name LIKE ? AND kind IN (${placeholders})${fc.sql}
+       ORDER BY file, line`)
+        .all(...params);
+    return opts.noTests ? rows.filter((n) => !isTestFile(n.file)) : rows;
+}
+//# sourceMappingURL=find-nodes.js.map

package/dist/features/shared/find-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-nodes.js","sourceRoot":"","sources":["../../../src/features/shared/find-nodes.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,YAAY,GAAG,EAAE;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IAEvC,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IAE1B,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;wCACkC,YAAY,IAAI,EAAE,CAAC,GAAG;2BACnC,CACtB;SACA,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAElB,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC"}

package/dist/features/snapshot.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Validate a snapshot name (alphanumeric, hyphens, underscores only).
+ * Throws on invalid input.
+ */
+export function validateSnapshotName(name: any): void;
+/**
+ * Return the snapshots directory for a given DB path.
+ */
+export function snapshotsDir(dbPath: any): string;
+/**
+ * Save a snapshot of the current graph database.
+ * Uses VACUUM INTO for an atomic, WAL-free copy.
+ *
+ * @param {string} name - Snapshot name
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ * @param {boolean} [options.force] - Overwrite existing snapshot
+ * @returns {{ name: string, path: string, size: number }}
+ */
+export function snapshotSave(name: string, options?: {
+    dbPath?: string | undefined;
+    force?: boolean | undefined;
+}): {
+    name: string;
+    path: string;
+    size: number;
+};
+/**
+ * Restore a snapshot over the current graph database.
+ * Removes WAL/SHM sidecar files before overwriting.
+ *
+ * @param {string} name - Snapshot name
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ */
+export function snapshotRestore(name: string, options?: {
+    dbPath?: string | undefined;
+}): void;
+/**
+ * List all saved snapshots.
+ *
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ * @returns {Array<{ name: string, path: string, size: number, createdAt: Date }>}
+ */
+export function snapshotList(options?: {
+    dbPath?: string | undefined;
+}): Array<{
+    name: string;
+    path: string;
+    size: number;
+    createdAt: Date;
+}>;
+/**
+ * Delete a named snapshot.
+ *
+ * @param {string} name - Snapshot name
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ */
+export function snapshotDelete(name: string, options?: {
+    dbPath?: string | undefined;
+}): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/features/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/features/snapshot.js"],"names":[],"mappings":"AASA;;;GAGG;AACH,sDAMC;AAED;;GAEG;AACH,kDAEC;AAED;;;;;;;;;GASG;AACH,mCANW,MAAM,YAEd;IAAyB,MAAM;IACL,KAAK;CAC/B,GAAU;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgCxD;AAED;;;;;;;GAOG;AACH,sCAJW,MAAM,YAEd;IAAyB,MAAM;CACjC,QAsBA;AAED;;;;;;GAMG;AACH,uCAHG;IAAyB,MAAM;CAC/B,GAAU,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC,CAsBhF;AAED;;;;;;GAMG;AACH,qCAJW,MAAM,YAEd;IAAyB,MAAM;CACjC,QAaA"}

package/dist/features/snapshot.js

@@ -0,0 +1,132 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { findDbPath } from '../db/index.js';
+import { debug } from '../infrastructure/logger.js';
+import { ConfigError, DbError } from '../shared/errors.js';
+const NAME_RE = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Validate a snapshot name (alphanumeric, hyphens, underscores only).
+ * Throws on invalid input.
+ */
+export function validateSnapshotName(name) {
+    if (!name || !NAME_RE.test(name)) {
+        throw new ConfigError(`Invalid snapshot name "${name}". Use only letters, digits, hyphens, and underscores.`);
+    }
+}
+/**
+ * Return the snapshots directory for a given DB path.
+ */
+export function snapshotsDir(dbPath) {
+    return path.join(path.dirname(dbPath), 'snapshots');
+}
+/**
+ * Save a snapshot of the current graph database.
+ * Uses VACUUM INTO for an atomic, WAL-free copy.
+ *
+ * @param {string} name - Snapshot name
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ * @param {boolean} [options.force] - Overwrite existing snapshot
+ * @returns {{ name: string, path: string, size: number }}
+ */
+export function snapshotSave(name, options = {}) {
+    validateSnapshotName(name);
+    const dbPath = options.dbPath || findDbPath();
+    if (!fs.existsSync(dbPath)) {
+        throw new DbError(`Database not found: ${dbPath}`, { file: dbPath });
+    }
+    const dir = snapshotsDir(dbPath);
+    const dest = path.join(dir, `${name}.db`);
+    if (fs.existsSync(dest)) {
+        if (!options.force) {
+            throw new ConfigError(`Snapshot "${name}" already exists. Use --force to overwrite.`);
+        }
+        fs.unlinkSync(dest);
+        debug(`Deleted existing snapshot: ${dest}`);
+    }
+    fs.mkdirSync(dir, { recursive: true });
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        db.exec(`VACUUM INTO '${dest.replace(/'/g, "''")}'`);
+    }
+    finally {
+        db.close();
+    }
+    const stat = fs.statSync(dest);
+    debug(`Snapshot saved: ${dest} (${stat.size} bytes)`);
+    return { name, path: dest, size: stat.size };
+}
+/**
+ * Restore a snapshot over the current graph database.
+ * Removes WAL/SHM sidecar files before overwriting.
+ *
+ * @param {string} name - Snapshot name
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ */
+export function snapshotRestore(name, options = {}) {
+    validateSnapshotName(name);
+    const dbPath = options.dbPath || findDbPath();
+    const dir = snapshotsDir(dbPath);
+    const src = path.join(dir, `${name}.db`);
+    if (!fs.existsSync(src)) {
+        throw new DbError(`Snapshot "${name}" not found at ${src}`, { file: src });
+    }
+    // Remove WAL/SHM sidecar files for a clean restore
+    for (const suffix of ['-wal', '-shm']) {
+        const sidecar = dbPath + suffix;
+        if (fs.existsSync(sidecar)) {
+            fs.unlinkSync(sidecar);
+            debug(`Removed sidecar: ${sidecar}`);
+        }
+    }
+    fs.copyFileSync(src, dbPath);
+    debug(`Restored snapshot "${name}" → ${dbPath}`);
+}
+/**
+ * List all saved snapshots.
+ *
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ * @returns {Array<{ name: string, path: string, size: number, createdAt: Date }>}
+ */
+export function snapshotList(options = {}) {
+    const dbPath = options.dbPath || findDbPath();
+    const dir = snapshotsDir(dbPath);
+    if (!fs.existsSync(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith('.db'))
+        .map((f) => {
+        const filePath = path.join(dir, f);
+        const stat = fs.statSync(filePath);
+        return {
+            name: f.replace(/\.db$/, ''),
+            path: filePath,
+            size: stat.size,
+            createdAt: stat.birthtime,
+        };
+    })
+        .sort((a, b) => b.createdAt - a.createdAt);
+}
+/**
+ * Delete a named snapshot.
+ *
+ * @param {string} name - Snapshot name
+ * @param {object} [options]
+ * @param {string} [options.dbPath] - Explicit path to graph.db
+ */
+export function snapshotDelete(name, options = {}) {
+    validateSnapshotName(name);
+    const dbPath = options.dbPath || findDbPath();
+    const dir = snapshotsDir(dbPath);
+    const target = path.join(dir, `${name}.db`);
+    if (!fs.existsSync(target)) {
+        throw new DbError(`Snapshot "${name}" not found at ${target}`, { file: target });
+    }
+    fs.unlinkSync(target);
+    debug(`Deleted snapshot: ${target}`);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/features/snapshot.js.map

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

package/dist/features/structure.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Build directory structure nodes, containment edges, and compute metrics.
+ * Called from builder.js after edge building.
+ *
+ * @param {import('better-sqlite3').Database} db - Open read-write database
+ * @param {Map<string, object>} fileSymbols - Map of relPath → { definitions, imports, exports, calls }
+ * @param {string} rootDir - Absolute root directory
+ * @param {Map<string, number>} lineCountMap - Map of relPath → line count
+ * @param {Set<string>} directories - Set of relative directory paths
+ */
+export function buildStructure(db: any, fileSymbols: Map<string, object>, _rootDir: any, lineCountMap: Map<string, number>, directories: Set<string>, changedFiles: any): void;
+export function classifyNodeRoles(db: any): {
+    entry: number;
+    core: number;
+    utility: number;
+    adapter: number;
+    dead: number;
+    'dead-leaf': number;
+    'dead-entry': number;
+    'dead-ffi': number;
+    'dead-unresolved': number;
+    'test-only': number;
+    leaf: number;
+};
+/**
+ * Return hierarchical directory tree with metrics.
+ */
+export function structureData(customDbPath: any, opts?: {}): object;
+/**
+ * Return top N files or directories ranked by a chosen metric.
+ */
+export function hotspotsData(customDbPath: any, opts?: {}): object;
+/**
+ * Return directories with cohesion above threshold, with top exports/imports.
+ */
+export function moduleBoundariesData(customDbPath: any, opts?: {}): {
+    threshold: any;
+    modules: any;
+    count: any;
+};
+export { FRAMEWORK_ENTRY_PREFIXES } from "../graph/classifiers/roles.js";
+//# sourceMappingURL=structure.d.ts.map

package/dist/features/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/features/structure.js"],"names":[],"mappings":"AA2QA;;;;;;;;;GASG;AACH,qDALW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,+BAEnB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,eACnB,GAAG,CAAC,MAAM,CAAC,2BAkDrB;AASD;;;;;;;;;;;;EA6GC;AAID;;GAEG;AACH,oEAiHC;AAED;;GAEG;AACH,mEA+DC;AAED;;GAEG;AACH;;;;EA0CC"}