@optave/codegraph 3.2.0 → 3.3.1

package/dist/graph/model.js

@@ -0,0 +1,210 @@
+/**
+ * Unified in-memory graph model.
+ *
+ * Stores directed (default) or undirected graphs with node/edge attributes.
+ * Node IDs are always strings. DB integer IDs should be stringified before use.
+ */
+import Graph from 'graphology';
+export class CodeGraph {
+    /**
+     * @param {{ directed?: boolean }} [opts]
+     */
+    constructor(opts = {}) {
+        this._directed = opts.directed !== false;
+        /** @type {Map<string, object>} */
+        this._nodes = new Map();
+        /** @type {Map<string, Map<string, object>>} node → (target → edgeAttrs) */
+        this._successors = new Map();
+        /** @type {Map<string, Map<string, object>>} node → (source → edgeAttrs) */
+        this._predecessors = new Map();
+    }
+    get directed() {
+        return this._directed;
+    }
+    get nodeCount() {
+        return this._nodes.size;
+    }
+    get edgeCount() {
+        let count = 0;
+        for (const targets of this._successors.values())
+            count += targets.size;
+        // Undirected graphs store each edge twice (a→b and b→a)
+        return this._directed ? count : count / 2;
+    }
+    // ─── Node operations ────────────────────────────────────────────
+    addNode(id, attrs = {}) {
+        const key = String(id);
+        this._nodes.set(key, attrs);
+        if (!this._successors.has(key))
+            this._successors.set(key, new Map());
+        if (!this._predecessors.has(key))
+            this._predecessors.set(key, new Map());
+        return this;
+    }
+    hasNode(id) {
+        return this._nodes.has(String(id));
+    }
+    getNodeAttrs(id) {
+        return this._nodes.get(String(id));
+    }
+    /** @returns {IterableIterator<[string, object]>} */
+    nodes() {
+        return this._nodes.entries();
+    }
+    /** @returns {string[]} */
+    nodeIds() {
+        return [...this._nodes.keys()];
+    }
+    // ─── Edge operations ────────────────────────────────────────────
+    addEdge(source, target, attrs = {}) {
+        const src = String(source);
+        const tgt = String(target);
+        // Auto-add nodes if missing
+        if (!this._nodes.has(src))
+            this.addNode(src);
+        if (!this._nodes.has(tgt))
+            this.addNode(tgt);
+        this._successors.get(src).set(tgt, attrs);
+        this._predecessors.get(tgt).set(src, attrs);
+        if (!this._directed) {
+            this._successors.get(tgt).set(src, attrs);
+            this._predecessors.get(src).set(tgt, attrs);
+        }
+        return this;
+    }
+    hasEdge(source, target) {
+        const src = String(source);
+        const tgt = String(target);
+        return this._successors.has(src) && this._successors.get(src).has(tgt);
+    }
+    getEdgeAttrs(source, target) {
+        const src = String(source);
+        const tgt = String(target);
+        return this._successors.get(src)?.get(tgt);
+    }
+    /** @yields {[string, string, object]} source, target, attrs */
+    *edges() {
+        const seen = this._directed ? null : new Set();
+        for (const [src, targets] of this._successors) {
+            for (const [tgt, attrs] of targets) {
+                if (!this._directed) {
+                    // \0 is safe as separator — node IDs are file paths/symbols, never contain null bytes
+                    const key = src < tgt ? `${src}\0${tgt}` : `${tgt}\0${src}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                }
+                yield [src, tgt, attrs];
+            }
+        }
+    }
+    // ─── Adjacency ──────────────────────────────────────────────────
+    /** Direct successors of a node (outgoing edges). */
+    successors(id) {
+        const key = String(id);
+        const map = this._successors.get(key);
+        return map ? [...map.keys()] : [];
+    }
+    /** Direct predecessors of a node (incoming edges). */
+    predecessors(id) {
+        const key = String(id);
+        const map = this._predecessors.get(key);
+        return map ? [...map.keys()] : [];
+    }
+    /** All neighbors (union of successors + predecessors). */
+    neighbors(id) {
+        const key = String(id);
+        const set = new Set();
+        const succ = this._successors.get(key);
+        if (succ)
+            for (const k of succ.keys())
+                set.add(k);
+        const pred = this._predecessors.get(key);
+        if (pred)
+            for (const k of pred.keys())
+                set.add(k);
+        return [...set];
+    }
+    outDegree(id) {
+        const map = this._successors.get(String(id));
+        return map ? map.size : 0;
+    }
+    inDegree(id) {
+        const map = this._predecessors.get(String(id));
+        return map ? map.size : 0;
+    }
+    // ─── Filtering ──────────────────────────────────────────────────
+    /** Return a new graph containing only nodes matching the predicate. */
+    subgraph(predicate) {
+        const g = new CodeGraph({ directed: this._directed });
+        for (const [id, attrs] of this._nodes) {
+            if (predicate(id, attrs))
+                g.addNode(id, { ...attrs });
+        }
+        for (const [src, tgt, attrs] of this.edges()) {
+            if (g.hasNode(src) && g.hasNode(tgt)) {
+                g.addEdge(src, tgt, { ...attrs });
+            }
+        }
+        return g;
+    }
+    /** Return a new graph containing only edges matching the predicate. */
+    filterEdges(predicate) {
+        const g = new CodeGraph({ directed: this._directed });
+        for (const [id, attrs] of this._nodes) {
+            g.addNode(id, { ...attrs });
+        }
+        for (const [src, tgt, attrs] of this.edges()) {
+            if (predicate(src, tgt, attrs)) {
+                g.addEdge(src, tgt, { ...attrs });
+            }
+        }
+        return g;
+    }
+    // ─── Conversion ─────────────────────────────────────────────────
+    /** Convert to flat edge array for native Rust interop. */
+    toEdgeArray() {
+        const result = [];
+        for (const [source, target] of this.edges()) {
+            result.push({ source, target });
+        }
+        return result;
+    }
+    /** Convert to graphology instance (for Louvain etc). */
+    toGraphology(opts = {}) {
+        const type = opts.type || (this._directed ? 'directed' : 'undirected');
+        const g = new Graph({ type });
+        for (const [id] of this._nodes) {
+            g.addNode(id);
+        }
+        for (const [src, tgt] of this.edges()) {
+            if (src === tgt)
+                continue;
+            if (!g.hasEdge(src, tgt))
+                g.addEdge(src, tgt);
+        }
+        return g;
+    }
+    // ─── Utilities ──────────────────────────────────────────────────
+    clone() {
+        const g = new CodeGraph({ directed: this._directed });
+        for (const [id, attrs] of this._nodes) {
+            g.addNode(id, { ...attrs });
+        }
+        for (const [src, tgt, attrs] of this.edges()) {
+            g.addEdge(src, tgt, { ...attrs });
+        }
+        return g;
+    }
+    /** Merge another graph into this one. Nodes/edges from other override on conflict. */
+    merge(other) {
+        for (const [id, attrs] of other.nodes()) {
+            this.addNode(id, attrs);
+        }
+        for (const [src, tgt, attrs] of other.edges()) {
+            this.addEdge(src, tgt, attrs);
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/graph/model.js.map

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

package/dist/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * CJS compatibility wrapper — delegates to ESM via dynamic import().
+ *
+ * This wrapper always returns a Promise on every Node version, because
+ * import() is unconditionally async. You must always await the result:
+ *
+ *   const codegraph = await require('@optave/codegraph');
+ *
+ * // Named destructuring at require-time does NOT work — always await the full result first.
+ * // BAD:  const { buildGraph } = require('@optave/codegraph');  // buildGraph is undefined
+ * // GOOD: const { buildGraph } = await require('@optave/codegraph');
+ */
+// Note: if import() rejects (e.g. missing dependency), the rejected Promise is cached
+// by the CJS module system and every subsequent require() call will re-surface the same
+// rejection without re-attempting the load.
+module.exports = import('./index.js');
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.cjs"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;AACH,sFAAsF;AACtF,wFAAwF;AACxF,4CAA4C;AAC5C,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC"}

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+declare const _exports: Promise<typeof import("./index.js", { with: { "resolution-mode": "import" } })>;
+export = _exports;
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.cjs"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { buildGraph } from "./domain/graph/builder.js";
+export { findCycles } from "./domain/graph/cycles.js";
+export { astQueryData } from "./features/ast.js";
+export { auditData } from "./features/audit.js";
+export { batchData } from "./features/batch.js";
+export { branchCompareData } from "./features/branch-compare.js";
+export { cfgData } from "./features/cfg.js";
+export { checkData } from "./features/check.js";
+export { coChangeData } from "./features/cochange.js";
+export { communitiesData } from "./features/communities.js";
+export { complexityData } from "./features/complexity.js";
+export { dataflowData } from "./features/dataflow.js";
+export { manifestoData } from "./features/manifesto.js";
+export { ownersData } from "./features/owners.js";
+export { sequenceData } from "./features/sequence.js";
+export { triageData } from "./features/triage.js";
+export { loadConfig } from "./infrastructure/config.js";
+export { briefData, childrenData, contextData, diffImpactData, explainData, exportsData, fileDepsData, fnDepsData, fnImpactData, impactAnalysisData, moduleMapData, pathData, queryNameData, rolesData, statsData, whereData } from "./domain/queries.js";
+export { buildEmbeddings, hybridSearchData, multiSearchData, searchData } from "./domain/search/index.js";
+export { exportDOT, exportJSON, exportMermaid } from "./features/export.js";
+export { flowData, listEntryPointsData } from "./features/flow.js";
+export { hotspotsData, moduleBoundariesData, structureData } from "./features/structure.js";
+export { EXTENSIONS, IGNORE_DIRS } from "./shared/constants.js";
+export { AnalysisError, BoundaryError, CodegraphError, ConfigError, DbError, EngineError, ParseError, ResolutionError } from "./shared/errors.js";
+export { EVERY_EDGE_KIND, EVERY_SYMBOL_KIND } from "./shared/kinds.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * codegraph — Programmatic API
+ *
+ * Curated public surface: *Data() query functions, graph building,
+ * export formats, and essential constants. CLI formatters and internal
+ * utilities are not exported — import them directly if needed.
+ *
+ * Usage:
+ *   import { buildGraph, queryNameData, findCycles, exportDOT } from '@optave/codegraph';
+ */
+export { buildGraph } from './domain/graph/builder.js';
+export { findCycles } from './domain/graph/cycles.js';
+export { briefData, childrenData, contextData, diffImpactData, explainData, exportsData, fileDepsData, fnDepsData, fnImpactData, impactAnalysisData, moduleMapData, pathData, queryNameData, rolesData, statsData, whereData, } from './domain/queries.js';
+export { buildEmbeddings, hybridSearchData, multiSearchData, searchData, } from './domain/search/index.js';
+export { astQueryData } from './features/ast.js';
+export { auditData } from './features/audit.js';
+export { batchData } from './features/batch.js';
+export { branchCompareData } from './features/branch-compare.js';
+export { cfgData } from './features/cfg.js';
+export { checkData } from './features/check.js';
+export { coChangeData } from './features/cochange.js';
+export { communitiesData } from './features/communities.js';
+export { complexityData } from './features/complexity.js';
+export { dataflowData } from './features/dataflow.js';
+export { exportDOT, exportJSON, exportMermaid } from './features/export.js';
+export { flowData, listEntryPointsData } from './features/flow.js';
+export { manifestoData } from './features/manifesto.js';
+export { ownersData } from './features/owners.js';
+export { sequenceData } from './features/sequence.js';
+export { hotspotsData, moduleBoundariesData, structureData } from './features/structure.js';
+export { triageData } from './features/triage.js';
+export { loadConfig } from './infrastructure/config.js';
+export { EXTENSIONS, IGNORE_DIRS } from './shared/constants.js';
+export { AnalysisError, BoundaryError, CodegraphError, ConfigError, DbError, EngineError, ParseError, ResolutionError, } from './shared/errors.js';
+export { EVERY_EDGE_KIND, EVERY_SYMBOL_KIND } from './shared/kinds.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,aAAa,EACb,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,OAAO,EACP,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/infrastructure/config.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Load project configuration from a .codegraphrc.json or similar file.
+ * Returns merged config with defaults. Results are cached per cwd.
+ */
+export function loadConfig(cwd: any): any;
+/**
+ * Clear the config cache. Intended for long-running processes that need to
+ * pick up on-disk config changes, and for test isolation when tests share
+ * the same cwd.
+ */
+export function clearConfigCache(): void;
+export function applyEnvOverrides(config: any): any;
+export function resolveSecrets(config: any): any;
+/**
+ * Detect monorepo workspace packages from workspace configuration files.
+ *
+ * Checks (in order):
+ *   1. pnpm-workspace.yaml — `packages:` array
+ *   2. package.json — `workspaces` field (npm/yarn)
+ *   3. lerna.json — `packages` array
+ *
+ * @param {string} rootDir - Project root directory
+ * @returns {Map<string, { dir: string, entry: string|null }>}
+ *   Map of package name → { absolute dir, resolved entry file }
+ */
+export function detectWorkspaces(rootDir: string): Map<string, {
+    dir: string;
+    entry: string | null;
+}>;
+export function mergeConfig(defaults: any, overrides: any): any;
+export const CONFIG_FILES: string[];
+export namespace DEFAULTS {
+    let include: never[];
+    let exclude: never[];
+    let ignoreDirs: never[];
+    let extensions: never[];
+    let aliases: {};
+    namespace build {
+        let incremental: boolean;
+        let dbPath: string;
+        let driftThreshold: number;
+    }
+    namespace query {
+        let defaultDepth: number;
+        let defaultLimit: number;
+        let excludeTests: boolean;
+    }
+    namespace embeddings {
+        let model: string;
+        let llmProvider: null;
+    }
+    namespace llm {
+        export let provider: null;
+        let model_1: null;
+        export { model_1 as model };
+        export let baseUrl: null;
+        export let apiKey: null;
+        export let apiKeyCommand: null;
+    }
+    namespace search {
+        let defaultMinScore: number;
+        let rrfK: number;
+        let topK: number;
+        let similarityWarnThreshold: number;
+    }
+    namespace ci {
+        let failOnCycles: boolean;
+        let impactThreshold: null;
+    }
+    namespace manifesto {
+        export namespace rules {
+            namespace cognitive {
+                let warn: number;
+            }
+            namespace cyclomatic {
+                let warn_1: number;
+                export { warn_1 as warn };
+            }
+            namespace maxNesting {
+                let warn_2: number;
+                export { warn_2 as warn };
+            }
+            namespace maintainabilityIndex {
+                let warn_3: number;
+                export { warn_3 as warn };
+                export let fail: null;
+            }
+            namespace importCount {
+                let warn_4: null;
+                export { warn_4 as warn };
+                let fail_1: null;
+                export { fail_1 as fail };
+            }
+            namespace exportCount {
+                let warn_5: null;
+                export { warn_5 as warn };
+                let fail_2: null;
+                export { fail_2 as fail };
+            }
+            namespace lineCount {
+                let warn_6: null;
+                export { warn_6 as warn };
+                let fail_3: null;
+                export { fail_3 as fail };
+            }
+            namespace fanIn {
+                let warn_7: null;
+                export { warn_7 as warn };
+                let fail_4: null;
+                export { fail_4 as fail };
+            }
+            namespace fanOut {
+                let warn_8: null;
+                export { warn_8 as warn };
+                let fail_5: null;
+                export { fail_5 as fail };
+            }
+            namespace noCycles {
+                let warn_9: null;
+                export { warn_9 as warn };
+                let fail_6: null;
+                export { fail_6 as fail };
+            }
+            namespace boundaries {
+                let warn_10: null;
+                export { warn_10 as warn };
+                let fail_7: null;
+                export { fail_7 as fail };
+            }
+        }
+        let boundaries_1: null;
+        export { boundaries_1 as boundaries };
+    }
+    namespace check {
+        export let cycles: boolean;
+        export let blastRadius: null;
+        export let signatures: boolean;
+        let boundaries_2: boolean;
+        export { boundaries_2 as boundaries };
+        export let depth: number;
+    }
+    namespace coChange {
+        let since: string;
+        let minSupport: number;
+        let minJaccard: number;
+        let maxFilesPerCommit: number;
+    }
+    namespace analysis {
+        let impactDepth: number;
+        let fnImpactDepth: number;
+        let auditDepth: number;
+        let sequenceDepth: number;
+        let falsePositiveCallers: number;
+        let briefCallerDepth: number;
+        let briefImporterDepth: number;
+        let briefHighRiskCallers: number;
+        let briefMediumRiskCallers: number;
+    }
+    namespace community {
+        let resolution: number;
+    }
+    namespace structure {
+        let cohesionThreshold: number;
+    }
+    namespace risk {
+        namespace weights {
+            let fanIn_1: number;
+            export { fanIn_1 as fanIn };
+            export let complexity: number;
+            export let churn: number;
+            export let role: number;
+            export let mi: number;
+        }
+        let roleWeights: {
+            core: number;
+            utility: number;
+            entry: number;
+            adapter: number;
+            leaf: number;
+            'test-only': number;
+            dead: number;
+            'dead-leaf': number;
+            'dead-entry': number;
+            'dead-ffi': number;
+            'dead-unresolved': number;
+        };
+        let defaultRoleWeight: number;
+    }
+    namespace display {
+        let maxColWidth: number;
+        let excerptLines: number;
+        let summaryMaxChars: number;
+        let jsdocEndScanLines: number;
+        let jsdocOpenScanLines: number;
+        let signatureGatherLines: number;
+    }
+    namespace mcp {
+        namespace defaults {
+            export let list_functions: number;
+            let query_1: number;
+            export { query_1 as query };
+            export let where: number;
+            export let node_roles: number;
+            export let export_graph: number;
+            export let fn_impact: number;
+            export let context: number;
+            export let explain: number;
+            export let file_deps: number;
+            export let file_exports: number;
+            export let diff_impact: number;
+            export let impact_analysis: number;
+            export let semantic_search: number;
+            export let execution_flow: number;
+            export let hotspots: number;
+            export let co_changes: number;
+            let complexity_1: number;
+            export { complexity_1 as complexity };
+            let manifesto_1: number;
+            export { manifesto_1 as manifesto };
+            export let communities: number;
+            let structure_1: number;
+            export { structure_1 as structure };
+            export let triage: number;
+            export let ast_query: number;
+        }
+    }
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/infrastructure/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/infrastructure/config.js"],"names":[],"mappings":"AAwIA;;;GAGG;AACH,0CA4BC;AAED;;;;GAIG;AACH,yCAEC;AAQD,oDAOC;AAED,iDAoBC;AA8ED;;;;;;;;;;;GAWG;AACH,0CAJW,MAAM,GACJ,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAC,IAAI,CAAA;CAAE,CAAC,CAyF5D;AAED,gEAiBC;AApZD,oCAA2F"}