@saluzi/codegraph 0.1.0 → 0.2.0

package/dist/extraction/vue-extractor.d.ts

@@ -1,36 +0,0 @@
-import { ExtractionResult } from '../types'
-/**
- * VueExtractor - Extracts code relationships from Vue Single-File Component files
- *
- * Vue SFCs are multi-language (script + template + style). Rather than
- * parsing the full Vue grammar, we extract the <script> block content
- * and delegate it to the TypeScript/JavaScript TreeSitterExtractor.
- *
- * Every .vue file produces a component node (Vue components are always importable).
- */
-export declare class VueExtractor {
-  private filePath
-  private source
-  private nodes
-  private edges
-  private unresolvedReferences
-  private errors
-  constructor(filePath: string, source: string)
-  /**
-   * Extract from Vue source
-   */
-  extract(): ExtractionResult
-  /**
-   * Create a component node for the .vue file
-   */
-  private createComponentNode
-  /**
-   * Extract <script> and <script setup> blocks from the Vue source
-   */
-  private extractScriptBlocks
-  /**
-   * Process a script block by delegating to TreeSitterExtractor
-   */
-  private processScriptBlock
-}
-//# sourceMappingURL=vue-extractor.d.ts.map

package/dist/extraction/vue-extractor.js

@@ -1,163 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VueExtractor = void 0;
-const tree_sitter_helpers_1 = require("./tree-sitter-helpers");
-const tree_sitter_1 = require("./tree-sitter");
-const grammars_1 = require("./grammars");
-/**
- * VueExtractor - Extracts code relationships from Vue Single-File Component files
- *
- * Vue SFCs are multi-language (script + template + style). Rather than
- * parsing the full Vue grammar, we extract the <script> block content
- * and delegate it to the TypeScript/JavaScript TreeSitterExtractor.
- *
- * Every .vue file produces a component node (Vue components are always importable).
- */
-class VueExtractor {
-    filePath;
-    source;
-    nodes = [];
-    edges = [];
-    unresolvedReferences = [];
-    errors = [];
-    constructor(filePath, source) {
-        this.filePath = filePath;
-        this.source = source;
-    }
-    /**
-     * Extract from Vue source
-     */
-    extract() {
-        const startTime = Date.now();
-        try {
-            // Create component node for the .vue file itself
-            const componentNode = this.createComponentNode();
-            // Extract and process script blocks
-            const scriptBlocks = this.extractScriptBlocks();
-            for (const block of scriptBlocks) {
-                this.processScriptBlock(block, componentNode.id);
-            }
-        }
-        catch (error) {
-            this.errors.push({
-                message: `Vue extraction error: ${error instanceof Error ? error.message : String(error)}`,
-                severity: 'error',
-            });
-        }
-        return {
-            nodes: this.nodes,
-            edges: this.edges,
-            unresolvedReferences: this.unresolvedReferences,
-            errors: this.errors,
-            durationMs: Date.now() - startTime,
-        };
-    }
-    /**
-     * Create a component node for the .vue file
-     */
-    createComponentNode() {
-        const lines = this.source.split('\n');
-        const fileName = this.filePath.split(/[/\\]/).pop() || this.filePath;
-        const componentName = fileName.replace(/\.vue$/, '');
-        const id = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'component', componentName, 1);
-        const node = {
-            id,
-            kind: 'component',
-            name: componentName,
-            qualifiedName: `${this.filePath}::${componentName}`,
-            filePath: this.filePath,
-            language: 'vue',
-            startLine: 1,
-            endLine: lines.length,
-            startColumn: 0,
-            endColumn: lines[lines.length - 1]?.length || 0,
-            isExported: true, // Vue components are always importable
-            updatedAt: Date.now(),
-        };
-        this.nodes.push(node);
-        return node;
-    }
-    /**
-     * Extract <script> and <script setup> blocks from the Vue source
-     */
-    extractScriptBlocks() {
-        const blocks = [];
-        const scriptRegex = /<script(\s[^>]*)?>(?<content>[\s\S]*?)<\/script>/g;
-        let match;
-        while ((match = scriptRegex.exec(this.source)) !== null) {
-            const attrs = match[1] || '';
-            const content = match.groups?.content || match[2] || '';
-            // Detect TypeScript from lang attribute
-            const isTypeScript = /lang\s*=\s*["'](ts|typescript)["']/.test(attrs);
-            // Detect <script setup>
-            const isSetup = /\bsetup\b/.test(attrs);
-            // Calculate start line of the script content (line after <script>)
-            const beforeScript = this.source.substring(0, match.index);
-            const scriptTagLine = (beforeScript.match(/\n/g) || []).length;
-            // The content starts on the line after the opening <script> tag
-            const openingTag = match[0].substring(0, match[0].indexOf('>') + 1);
-            const openingTagLines = (openingTag.match(/\n/g) || []).length;
-            const contentStartLine = scriptTagLine + openingTagLines + 1; // 0-indexed line
-            blocks.push({
-                content,
-                startLine: contentStartLine,
-                isSetup,
-                isTypeScript,
-            });
-        }
-        return blocks;
-    }
-    /**
-     * Process a script block by delegating to TreeSitterExtractor
-     */
-    processScriptBlock(block, componentNodeId) {
-        const scriptLanguage = block.isTypeScript ? 'typescript' : 'javascript';
-        // Check if the script language parser is available
-        if (!(0, grammars_1.isLanguageSupported)(scriptLanguage)) {
-            this.errors.push({
-                message: `Parser for ${scriptLanguage} not available, cannot parse Vue script block`,
-                severity: 'warning',
-            });
-            return;
-        }
-        // Delegate to TreeSitterExtractor
-        const extractor = new tree_sitter_1.TreeSitterExtractor(this.filePath, block.content, scriptLanguage);
-        const result = extractor.extract();
-        // Offset line numbers from script block back to .vue file positions
-        for (const node of result.nodes) {
-            node.startLine += block.startLine;
-            node.endLine += block.startLine;
-            node.language = 'vue'; // Mark as vue, not TS/JS
-            this.nodes.push(node);
-            // Add containment edge from component to this node
-            this.edges.push({
-                source: componentNodeId,
-                target: node.id,
-                kind: 'contains',
-            });
-        }
-        // Offset edges (they reference line numbers)
-        for (const edge of result.edges) {
-            if (edge.line) {
-                edge.line += block.startLine;
-            }
-            this.edges.push(edge);
-        }
-        // Offset unresolved references
-        for (const ref of result.unresolvedReferences) {
-            ref.line += block.startLine;
-            ref.filePath = this.filePath;
-            ref.language = 'vue';
-            this.unresolvedReferences.push(ref);
-        }
-        // Carry over errors
-        for (const error of result.errors) {
-            if (error.line) {
-                error.line += block.startLine;
-            }
-            this.errors.push(error);
-        }
-    }
-}
-exports.VueExtractor = VueExtractor;
-//# sourceMappingURL=vue-extractor.js.map

package/dist/extraction/wasm-runtime-flags.d.ts

@@ -1,46 +0,0 @@
-/**
- * The V8 flag(s) that keep tree-sitter grammar compilation off the turboshaft
- * optimizing tier. Single source of truth: the relaunch guard and the test
- * suite both read this (a test asserts each is a real flag on the running
- * runtime, so a rename can't silently regress the fix).
- */
-export declare const WASM_RUNTIME_FLAGS: readonly string[]
-/**
- * Env var carrying the *host* PID (the relauncher's own parent) across the
- * re-exec. Without `--liftoff-only` the CLI re-execs itself once, inserting an
- * intermediate process between the MCP host and the server. That intermediate
- * stays alive (blocked in spawnSync) even after the host is killed, so the
- * server's PPID watchdog can't detect the host's death by watching its own
- * `process.ppid`. Passing the host PID through lets the watchdog poll it
- * directly. Unset on the no-re-exec path (bundled launcher / flag already
- * present), where the server is already a direct child of the host. See
- * src/mcp/index.ts (#277).
- */
-export declare const HOST_PPID_ENV = 'CODEGRAPH_HOST_PPID'
-/** True when every required WASM runtime flag is already present in `execArgv`. */
-export declare function processHasWasmRuntimeFlags(
-  execArgv?: readonly string[],
-): boolean
-/**
- * Build the argv for re-execing node with the WASM runtime flags: our flags
- * first, then any node flags already in `execArgv` (deduped), then the script
- * and its args. Pure — exported for unit testing.
- */
-export declare function buildRelaunchArgv(
-  scriptPath: string,
-  scriptArgs: readonly string[],
-  execArgv?: readonly string[],
-): string[]
-/**
- * If the current process is missing the WASM runtime flags, re-exec it once
- * with them and exit with the child's status. No-op when the flags are already
- * present (the normal bundled-launcher path), when already relaunched, or when
- * disabled via CODEGRAPH_NO_RELAUNCH.
- *
- * On spawn failure, returns so the caller runs in-process anyway — risking the
- * OOM is still better than refusing to start.
- */
-export declare function relaunchWithWasmRuntimeFlagsIfNeeded(
-  scriptPath: string,
-): void
-//# sourceMappingURL=wasm-runtime-flags.d.ts.map

package/dist/extraction/wasm-runtime-flags.js

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HOST_PPID_ENV = exports.WASM_RUNTIME_FLAGS = void 0;
-exports.processHasWasmRuntimeFlags = processHasWasmRuntimeFlags;
-exports.buildRelaunchArgv = buildRelaunchArgv;
-exports.relaunchWithWasmRuntimeFlagsIfNeeded = relaunchWithWasmRuntimeFlagsIfNeeded;
-/**
- * WASM runtime flags — workaround for the V8 turboshaft WASM Zone OOM.
- *
- * tree-sitter grammars are large WebAssembly modules. On Node >= 22 the V8
- * "turboshaft" optimizing WASM compiler can exhaust its per-compilation Zone
- * arena while compiling these grammars on a background thread, aborting the
- * whole process with `Fatal process out of memory: Zone` — even with tens of
- * GB of system memory free, because the Zone is a V8-internal arena, not the
- * JS heap. Reproduced on Node 22 and 24; Node 25 is already hard-blocked for
- * the same crash (see ../bin/node-version-check.ts). See issues #293 and #298.
- *
- * `--liftoff-only` forces every WASM module to the Liftoff baseline compiler
- * and never runs turboshaft, which eliminates the crash. Parsing stays fully
- * correct; we only forgo the (marginal, and for grammars rarely reached)
- * optimized-tier speedup.
- *
- * This flag MUST be on node's command line — it is read by V8 at engine init,
- * before any of our JS runs. Empirically (Node 24) none of these work:
- *   - `v8.setFlagsFromString('--liftoff-only')` at runtime — too late.
- *   - Worker `execArgv: ['--liftoff-only']` — rejected (ERR_WORKER_INVALID_EXEC_ARGV).
- *   - `NODE_OPTIONS=--liftoff-only` — not on Node's NODE_OPTIONS allowlist.
- * Also empirically, `--no-wasm-tier-up` / `--no-wasm-dynamic-tiering` do NOT
- * prevent the crash — only disabling the optimizing tier entirely does.
- *
- * Delivery: the bundled launcher passes the flag directly (see
- * scripts/build-bundle.sh and scripts/npm-shim.js); for any other launch path
- * (running dist directly, from source, etc.) the CLI re-execs itself once with
- * the flag via {@link relaunchWithWasmRuntimeFlagsIfNeeded}. V8 flags are
- * PROCESS-global, and the parse worker is created with default (inherited)
- * execArgv, so flagging the main process governs the worker's WASM compilation
- * too.
- */
-const child_process_1 = require("child_process");
-/**
- * The V8 flag(s) that keep tree-sitter grammar compilation off the turboshaft
- * optimizing tier. Single source of truth: the relaunch guard and the test
- * suite both read this (a test asserts each is a real flag on the running
- * runtime, so a rename can't silently regress the fix).
- */
-exports.WASM_RUNTIME_FLAGS = ['--liftoff-only'];
-/**
- * Env var set on the relaunched child so a detection slip can never cause an
- * infinite re-exec loop. Also lets users force-disable the relaunch.
- */
-const RELAUNCH_GUARD_ENV = 'CODEGRAPH_WASM_RELAUNCHED';
-/**
- * Env var carrying the *host* PID (the relauncher's own parent) across the
- * re-exec. Without `--liftoff-only` the CLI re-execs itself once, inserting an
- * intermediate process between the MCP host and the server. That intermediate
- * stays alive (blocked in spawnSync) even after the host is killed, so the
- * server's PPID watchdog can't detect the host's death by watching its own
- * `process.ppid`. Passing the host PID through lets the watchdog poll it
- * directly. Unset on the no-re-exec path (bundled launcher / flag already
- * present), where the server is already a direct child of the host. See
- * src/mcp/index.ts (#277).
- */
-exports.HOST_PPID_ENV = 'CODEGRAPH_HOST_PPID';
-/** True when every required WASM runtime flag is already present in `execArgv`. */
-function processHasWasmRuntimeFlags(execArgv = process.execArgv) {
-    return exports.WASM_RUNTIME_FLAGS.every((flag) => execArgv.includes(flag));
-}
-/**
- * Build the argv for re-execing node with the WASM runtime flags: our flags
- * first, then any node flags already in `execArgv` (deduped), then the script
- * and its args. Pure — exported for unit testing.
- */
-function buildRelaunchArgv(scriptPath, scriptArgs, execArgv = process.execArgv) {
-    const preserved = execArgv.filter((arg) => !exports.WASM_RUNTIME_FLAGS.includes(arg));
-    return [...exports.WASM_RUNTIME_FLAGS, ...preserved, scriptPath, ...scriptArgs];
-}
-/**
- * If the current process is missing the WASM runtime flags, re-exec it once
- * with them and exit with the child's status. No-op when the flags are already
- * present (the normal bundled-launcher path), when already relaunched, or when
- * disabled via CODEGRAPH_NO_RELAUNCH.
- *
- * On spawn failure, returns so the caller runs in-process anyway — risking the
- * OOM is still better than refusing to start.
- */
-function relaunchWithWasmRuntimeFlagsIfNeeded(scriptPath) {
-    if (processHasWasmRuntimeFlags())
-        return;
-    if (process.env[RELAUNCH_GUARD_ENV])
-        return;
-    if (process.env.CODEGRAPH_NO_RELAUNCH)
-        return;
-    const argv = buildRelaunchArgv(scriptPath, process.argv.slice(2));
-    const result = (0, child_process_1.spawnSync)(process.execPath, argv, {
-        stdio: 'inherit',
-        env: { ...process.env, [RELAUNCH_GUARD_ENV]: '1', [exports.HOST_PPID_ENV]: String(process.ppid) },
-    });
-    if (result.error) {
-        // Couldn't relaunch (e.g. execPath unavailable) — fall through and run in
-        // this process. Degraded (may OOM on huge repos) but not broken.
-        return;
-    }
-    process.exit(result.status ?? (result.signal ? 1 : 0));
-}
-//# sourceMappingURL=wasm-runtime-flags.js.map

package/dist/graph/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Graph Module
- *
- * Provides graph traversal and query functionality for the code knowledge graph.
- */
-export { GraphTraverser } from './traversal'
-export { GraphQueryManager } from './queries'
-//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.js

@@ -1,13 +0,0 @@
-"use strict";
-/**
- * Graph Module
- *
- * Provides graph traversal and query functionality for the code knowledge graph.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphQueryManager = exports.GraphTraverser = void 0;
-var traversal_1 = require("./traversal");
-Object.defineProperty(exports, "GraphTraverser", { enumerable: true, get: function () { return traversal_1.GraphTraverser; } });
-var queries_1 = require("./queries");
-Object.defineProperty(exports, "GraphQueryManager", { enumerable: true, get: function () { return queries_1.GraphQueryManager; } });
-//# sourceMappingURL=index.js.map

package/dist/graph/queries.d.ts

@@ -1,109 +0,0 @@
-/**
- * Graph Query Functions
- *
- * Higher-level query functions built on top of traversal algorithms.
- */
-import { Node, Context, Subgraph } from '../types'
-import { QueryBuilder } from '../db/queries'
-import { GraphTraverser } from './traversal'
-/**
- * Graph query manager for complex queries
- */
-export declare class GraphQueryManager {
-  private queries
-  private traverser
-  constructor(queries: QueryBuilder)
-  /**
-   * Get full context for a node
-   *
-   * Returns the focal node along with its ancestors, children,
-   * and both incoming and outgoing references.
-   *
-   * @param nodeId - ID of the focal node
-   * @returns Context object with all related information
-   */
-  getContext(nodeId: string): Context
-  /**
-   * Get dependencies of a file
-   *
-   * Returns all files that this file imports from.
-   *
-   * @param filePath - Path to the file
-   * @returns Array of file paths this file depends on
-   */
-  getFileDependencies(filePath: string): string[]
-  /**
-   * Get dependents of a file
-   *
-   * Returns all files that import from this file.
-   *
-   * @param filePath - Path to the file
-   * @returns Array of file paths that depend on this file
-   */
-  getFileDependents(filePath: string): string[]
-  /**
-   * Get all symbols exported by a file
-   *
-   * @param filePath - Path to the file
-   * @returns Array of exported nodes
-   */
-  getExportedSymbols(filePath: string): Node[]
-  /**
-   * Find symbols by qualified name pattern
-   *
-   * @param pattern - Pattern to match (supports * wildcard)
-   * @returns Array of matching nodes
-   */
-  findByQualifiedName(pattern: string): Node[]
-  /**
-   * Get the module/package structure
-   *
-   * Returns a tree structure of files organized by directory.
-   *
-   * @returns Map of directory paths to contained files
-   */
-  getModuleStructure(): Map<string, string[]>
-  /**
-   * Find circular dependencies in the graph
-   *
-   * @returns Array of cycles, each cycle is an array of node IDs
-   */
-  findCircularDependencies(): string[][]
-  /**
-   * Get complexity metrics for a node
-   *
-   * @param nodeId - ID of the node
-   * @returns Object containing various complexity metrics
-   */
-  getNodeMetrics(nodeId: string): {
-    incomingEdgeCount: number
-    outgoingEdgeCount: number
-    callCount: number
-    callerCount: number
-    childCount: number
-    depth: number
-  }
-  /**
-   * Find dead code (nodes with no incoming references)
-   *
-   * @param kinds - Node kinds to check (default: functions, methods, classes)
-   * @returns Array of unreferenced nodes
-   */
-  findDeadCode(kinds?: Node['kind'][]): Node[]
-  /**
-   * Get subgraph containing nodes matching a filter
-   *
-   * @param filter - Filter function to select nodes
-   * @param includeEdges - Whether to include edges between matching nodes
-   * @returns Subgraph containing matching nodes
-   */
-  getFilteredSubgraph(
-    filter: (node: Node) => boolean,
-    includeEdges?: boolean,
-  ): Subgraph
-  /**
-   * Access the underlying traverser for direct traversal operations
-   */
-  getTraverser(): GraphTraverser
-}
-//# sourceMappingURL=queries.d.ts.map