optave-codegraph 3.13.0

package/dist/shared/constants.js

@@ -0,0 +1,54 @@
+import path from 'node:path';
+import { SUPPORTED_EXTENSIONS } from '../domain/parser.js';
+function withArrayCompat(s) {
+    return Object.assign(s, { toArray: () => [...s] });
+}
+export const IGNORE_DIRS = withArrayCompat(new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    '.nuxt',
+    '.svelte-kit',
+    'coverage',
+    '.codegraph',
+    '__pycache__',
+    '.tox',
+    'vendor',
+    '.venv',
+    'venv',
+    'env',
+    '.env',
+]));
+export const EXTENSIONS = withArrayCompat(new Set(SUPPORTED_EXTENSIONS));
+/**
+ * Minimum confidence assigned to resolved `ts-native` call edges.
+ *
+ * The native engine's proximity heuristic returns 0.3 for cross-module calls
+ * where no import-path evidence is available.  For ts-native edges the engine
+ * performed actual name-based symbol lookup, which is stronger evidence than
+ * pure file-proximity.  Clamping to 0.5 (same-parent-directory level) avoids
+ * unfairly dragging down the call-confidence metric.  Sink edges
+ * (confidence = 0.0) are intentionally excluded and must remain at 0.0 so
+ * they stay below DEFAULT_MIN_CONFIDENCE and never surface in normal queries.
+ *
+ * Used in `build-edges.ts` (in-memory + `applyEdgeTechniquesAfterNativeInsert`)
+ * and `native-orchestrator.ts` (`backfillEdgeTechniquesAfterNativeOrchestrator`).
+ * Centralised here so all three insertion paths apply the same value.
+ */
+export const TS_NATIVE_CONFIDENCE_FLOOR = 0.5;
+export function shouldIgnore(dirName) {
+    return IGNORE_DIRS.has(dirName) || dirName.startsWith('.');
+}
+export function isSupportedFile(filePath) {
+    return SUPPORTED_EXTENSIONS.has(path.extname(filePath));
+}
+/**
+ * Normalize a file path to always use forward slashes.
+ * Ensures cross-platform consistency in the SQLite database.
+ */
+export function normalizePath(filePath) {
+    return filePath.split(path.sep).join('/');
+}
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAU3D,SAAS,eAAe,CAAI,CAAS;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAA2B,eAAe,CAChE,IAAI,GAAG,CAAC;IACN,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,aAAa;IACb,UAAU;IACV,YAAY;IACZ,aAAa;IACb,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,KAAK;IACL,MAAM;CACP,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAA2B,eAAe,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAEjG;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/shared/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Domain error hierarchy for codegraph.
+ *
+ * Library code throws these instead of calling process.exit() or throwing
+ * bare Error instances. The CLI top-level catch formats them for humans;
+ * MCP returns structured { isError, code } responses.
+ */
+export interface CodegraphErrorOpts {
+    code?: string;
+    file?: string;
+    cause?: Error;
+}
+export declare class CodegraphError extends Error {
+    code: string;
+    file: string | undefined;
+    constructor(message: string, { code, file, cause }?: CodegraphErrorOpts);
+}
+export declare class ParseError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+export declare class DbError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+export declare class ConfigError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+export declare class ResolutionError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+export declare class EngineError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+export declare class AnalysisError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+export declare class BoundaryError extends CodegraphError {
+    constructor(message: string, opts?: CodegraphErrorOpts);
+}
+/** Safely extract a string message from an unknown thrown value. */
+export declare function toErrorMessage(e: unknown): string;
+/**
+ * Catch-suppression helpers (`suppressError`, `suppressErrorAsync`) live in
+ * `infrastructure/suppress.ts` to avoid a shared→infrastructure layer inversion.
+ * Import them from there instead of from this module.
+ */
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,EAAE,IAAwB,EAAE,IAAI,EAAE,KAAK,EAAE,GAAE,kBAAuB;CAMhG;AAED,qBAAa,UAAW,SAAQ,cAAc;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,qBAAa,OAAQ,SAAQ,cAAc;gBAC7B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB;CAI3D;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED;;;;GAIG"}

package/dist/shared/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Domain error hierarchy for codegraph.
+ *
+ * Library code throws these instead of calling process.exit() or throwing
+ * bare Error instances. The CLI top-level catch formats them for humans;
+ * MCP returns structured { isError, code } responses.
+ */
+export class CodegraphError extends Error {
+    code;
+    file;
+    constructor(message, { code = 'CODEGRAPH_ERROR', file, cause } = {}) {
+        super(message, { cause });
+        this.name = 'CodegraphError';
+        this.code = code;
+        this.file = file;
+    }
+}
+export class ParseError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'PARSE_FAILED', ...opts });
+        this.name = 'ParseError';
+    }
+}
+export class DbError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'DB_ERROR', ...opts });
+        this.name = 'DbError';
+    }
+}
+export class ConfigError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'CONFIG_INVALID', ...opts });
+        this.name = 'ConfigError';
+    }
+}
+export class ResolutionError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'RESOLUTION_FAILED', ...opts });
+        this.name = 'ResolutionError';
+    }
+}
+export class EngineError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'ENGINE_UNAVAILABLE', ...opts });
+        this.name = 'EngineError';
+    }
+}
+export class AnalysisError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'ANALYSIS_FAILED', ...opts });
+        this.name = 'AnalysisError';
+    }
+}
+export class BoundaryError extends CodegraphError {
+    constructor(message, opts = {}) {
+        super(message, { code: 'BOUNDARY_VIOLATION', ...opts });
+        this.name = 'BoundaryError';
+    }
+}
+/** Safely extract a string message from an unknown thrown value. */
+export function toErrorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/**
+ * Catch-suppression helpers (`suppressError`, `suppressErrorAsync`) live in
+ * `infrastructure/suppress.ts` to avoid a shared→infrastructure layer inversion.
+ * Import them from there instead of from this module.
+ */
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,IAAI,CAAS;IACb,IAAI,CAAqB;IAEzB,YAAY,OAAe,EAAE,EAAE,IAAI,GAAG,iBAAiB,EAAE,IAAI,EAAE,KAAK,KAAyB,EAAE;QAC7F,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,OAAQ,SAAQ,cAAc;IACzC,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe,EAAE,OAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG"}

package/dist/shared/file-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Resolve a file path relative to repoRoot, rejecting traversal outside the repo.
+ * Returns null if the resolved path escapes repoRoot.
+ */
+export declare function safePath(repoRoot: string, file: string): string | null;
+interface ReadSourceRangeOpts {
+    excerptLines?: number;
+}
+export declare function readSourceRange(repoRoot: string, file: string, startLine: number | undefined, endLine: number | undefined, opts?: ReadSourceRangeOpts): string | null;
+interface ExtractSummaryOpts {
+    jsdocEndScanLines?: number;
+    jsdocOpenScanLines?: number;
+    summaryMaxChars?: number;
+}
+export declare function extractSummary(fileLines: string[] | null, line: number | undefined, opts?: ExtractSummaryOpts): string | null;
+interface ExtractSignatureOpts {
+    signatureGatherLines?: number;
+}
+export interface Signature {
+    params: string | null;
+    returnType: string | null;
+}
+export declare function extractSignature(fileLines: string[] | null, line: number | undefined, opts?: ExtractSignatureOpts): Signature | null;
+export declare function createFileLinesReader(repoRoot: string): (file: string) => string[] | null;
+export declare function isFileLikeTarget(target: string): boolean;
+export {};
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/shared/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/shared/file-utils.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItE;AAED,UAAU,mBAAmB;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,GAAE,mBAAwB,GAC7B,MAAM,GAAG,IAAI,CAcf;AAED,UAAU,kBAAkB;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAqED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,GAAE,kBAAuB,GAC5B,MAAM,GAAG,IAAI,CAkBf;AAED,UAAU,oBAAoB;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAkCD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,GAAE,oBAAyB,GAC9B,SAAS,GAAG,IAAI,CAkBlB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,CAmBzF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAQxD"}

package/dist/shared/file-utils.js

@@ -0,0 +1,186 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { LANGUAGE_REGISTRY } from '../domain/parser.js';
+import { debug } from '../infrastructure/logger.js';
+/**
+ * Resolve a file path relative to repoRoot, rejecting traversal outside the repo.
+ * Returns null if the resolved path escapes repoRoot.
+ */
+export function safePath(repoRoot, file) {
+    const resolved = path.resolve(repoRoot, file);
+    if (!resolved.startsWith(repoRoot + path.sep) && resolved !== repoRoot)
+        return null;
+    return resolved;
+}
+export function readSourceRange(repoRoot, file, startLine, endLine, opts = {}) {
+    try {
+        const absPath = safePath(repoRoot, file);
+        if (!absPath)
+            return null;
+        const content = fs.readFileSync(absPath, 'utf-8');
+        const lines = content.split('\n');
+        const excerptLines = opts.excerptLines ?? 50;
+        const start = Math.max(0, (startLine || 1) - 1);
+        const end = Math.min(lines.length, endLine || (startLine || 1) + excerptLines);
+        return lines.slice(start, end).join('\n');
+    }
+    catch (e) {
+        debug(`readSourceRange failed for ${file}: ${e.message}`);
+        return null;
+    }
+}
+/** Truncate text to maxChars, appending "..." if truncated. */
+function truncate(text, maxChars) {
+    return text.length > maxChars ? `${text.slice(0, maxChars)}...` : text;
+}
+/** Try to extract a single-line comment (// or #) above the definition. */
+function extractSingleLineComment(fileLines, idx, scanLines, maxChars) {
+    for (let i = idx; i >= Math.max(0, idx - scanLines); i--) {
+        const trimmed = fileLines[i].trim();
+        if (trimmed.endsWith('*/'))
+            return null; // hit a block comment — defer to JSDoc extractor
+        if (trimmed.startsWith('//') || trimmed.startsWith('#')) {
+            const text = trimmed
+                .replace(/^\/\/\s*/, '')
+                .replace(/^#\s*/, '')
+                .trim();
+            return truncate(text, maxChars);
+        }
+        if (trimmed !== '' && !trimmed.startsWith('*') && !trimmed.startsWith('/*'))
+            return null;
+    }
+    return null;
+}
+/** Find the line index where a block comment (*​/) ends, scanning upward from idx. */
+function findJsdocEndLine(fileLines, idx, scanLines) {
+    for (let i = idx; i >= Math.max(0, idx - scanLines); i--) {
+        const trimmed = fileLines[i].trim();
+        if (trimmed.endsWith('*/'))
+            return i;
+        if (trimmed !== '' &&
+            !trimmed.startsWith('*') &&
+            !trimmed.startsWith('/*') &&
+            !trimmed.startsWith('//') &&
+            !trimmed.startsWith('#')) {
+            break;
+        }
+    }
+    return -1;
+}
+/** Extract the first description line from a JSDoc block ending at jsdocEnd. */
+function extractJsdocDescription(fileLines, jsdocEnd, openScanLines, maxChars) {
+    for (let i = jsdocEnd; i >= Math.max(0, jsdocEnd - openScanLines); i--) {
+        if (!fileLines[i].trim().startsWith('/**'))
+            continue;
+        for (let j = i + 1; j <= jsdocEnd; j++) {
+            const docLine = fileLines[j].trim()
+                .replace(/^\*\s?/, '')
+                .trim();
+            if (docLine && !docLine.startsWith('@') && docLine !== '/' && docLine !== '*/') {
+                return truncate(docLine, maxChars);
+            }
+        }
+        break;
+    }
+    return null;
+}
+export function extractSummary(fileLines, line, opts = {}) {
+    if (!fileLines || !line || line <= 1)
+        return null;
+    const idx = line - 2; // line above the definition (0-indexed)
+    const jsdocEndScanLines = opts.jsdocEndScanLines ?? 10;
+    const jsdocOpenScanLines = opts.jsdocOpenScanLines ?? 20;
+    const summaryMaxChars = opts.summaryMaxChars ?? 100;
+    // Try single-line comment first
+    const singleLine = extractSingleLineComment(fileLines, idx, jsdocEndScanLines, summaryMaxChars);
+    if (singleLine)
+        return singleLine;
+    // Try JSDoc block comment
+    const jsdocEnd = findJsdocEndLine(fileLines, idx, jsdocEndScanLines);
+    if (jsdocEnd >= 0) {
+        return extractJsdocDescription(fileLines, jsdocEnd, jsdocOpenScanLines, summaryMaxChars);
+    }
+    return null;
+}
+/** Per-language signature patterns. Each entry has a regex and an extractor for return type. */
+const SIGNATURE_PATTERNS = [
+    // JS/TS: function name(params) or async function
+    {
+        regex: /(?:export\s+)?(?:async\s+)?function\s*\*?\s*\w*\s*\(([^)]*)\)\s*(?::\s*([^\n{]+))?/,
+        returnType: (m) => (m[2] ? m[2].trim().replace(/\s*\{$/, '') : null),
+    },
+    // Arrow: const name = (params) => or (params):ReturnType =>
+    {
+        regex: /=\s*(?:async\s+)?\(([^)]*)\)\s*(?::\s*([^=>\n{]+))?\s*=>/,
+        returnType: (m) => (m[2] ? m[2].trim() : null),
+    },
+    // Python: def name(params) -> return:
+    {
+        regex: /def\s+\w+\s*\(([^)]*)\)\s*(?:->\s*([^:\n]+))?/,
+        returnType: (m) => (m[2] ? m[2].trim() : null),
+    },
+    // Go: func (recv) name(params) (returns)
+    {
+        regex: /func\s+(?:\([^)]*\)\s+)?\w+\s*\(([^)]*)\)\s*(?:\(([^)]+)\)|(\w[^\n{]*))?/,
+        returnType: (m) => (m[2] || m[3] || '').trim() || null,
+    },
+    // Rust: fn name(params) -> ReturnType
+    {
+        regex: /fn\s+\w+\s*\(([^)]*)\)\s*(?:->\s*([^\n{]+))?/,
+        returnType: (m) => (m[2] ? m[2].trim() : null),
+    },
+];
+export function extractSignature(fileLines, line, opts = {}) {
+    if (!fileLines || !line)
+        return null;
+    const idx = line - 1;
+    const signatureGatherLines = opts.signatureGatherLines ?? 5;
+    const chunk = fileLines
+        .slice(idx, Math.min(fileLines.length, idx + signatureGatherLines))
+        .join('\n');
+    for (const pattern of SIGNATURE_PATTERNS) {
+        const m = chunk.match(pattern.regex);
+        if (m) {
+            return {
+                params: m[1].trim() || null,
+                returnType: pattern.returnType(m),
+            };
+        }
+    }
+    return null;
+}
+export function createFileLinesReader(repoRoot) {
+    const cache = new Map();
+    return function getFileLines(file) {
+        if (cache.has(file))
+            return cache.get(file);
+        try {
+            const absPath = safePath(repoRoot, file);
+            if (!absPath) {
+                cache.set(file, null);
+                return null;
+            }
+            const lines = fs.readFileSync(absPath, 'utf-8').split('\n');
+            cache.set(file, lines);
+            return lines;
+        }
+        catch (e) {
+            debug(`getFileLines failed for ${file}: ${e.message}`);
+            cache.set(file, null);
+            return null;
+        }
+    };
+}
+export function isFileLikeTarget(target) {
+    if (target.includes('/') || target.includes('\\'))
+        return true;
+    const ext = path.extname(target).toLowerCase();
+    if (!ext)
+        return false;
+    for (const entry of LANGUAGE_REGISTRY) {
+        if (entry.extensions.includes(ext))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/shared/file-utils.js.map

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

package/dist/shared/generators.d.ts

@@ -0,0 +1,57 @@
+interface ListFunctionResult {
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    endLine: number | null;
+    role: string | null;
+}
+interface IterListOpts {
+    noTests?: boolean;
+    file?: string;
+    pattern?: string;
+}
+/**
+ * Generator: stream functions one-by-one using .iterate() for memory efficiency.
+ */
+export declare function iterListFunctions(customDbPath?: string, opts?: IterListOpts): Generator<ListFunctionResult>;
+interface RoleResult {
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    endLine: number | null;
+    role: string | null;
+}
+interface IterRolesOpts {
+    noTests?: boolean;
+    role?: string;
+    file?: string;
+}
+/**
+ * Generator: stream role-classified symbols one-by-one.
+ */
+export declare function iterRoles(customDbPath?: string, opts?: IterRolesOpts): Generator<RoleResult>;
+interface WhereUse {
+    name: string;
+    file: string;
+    line: number;
+}
+interface WhereResult {
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    role: string | null;
+    exported: boolean;
+    uses: WhereUse[];
+}
+interface IterWhereOpts {
+    noTests?: boolean;
+}
+/**
+ * Generator: stream symbol lookup results one-by-one.
+ */
+export declare function iterWhere(target: string, customDbPath?: string, opts?: IterWhereOpts): Generator<WhereResult>;
+export {};
+//# sourceMappingURL=generators.d.ts.map

package/dist/shared/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/shared/generators.ts"],"names":[],"mappings":"AAMA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAiB,iBAAiB,CAChC,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,GAAE,YAAiB,GACtB,SAAS,CAAC,kBAAkB,CAAC,CAsB/B;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAiB,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,SAAS,CAAC,UAAU,CAAC,CAoCjG;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAiB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,GAAE,aAAkB,GACvB,SAAS,CAAC,WAAW,CAAC,CAyCxB"}

package/dist/shared/generators.js

@@ -0,0 +1,106 @@
+import { iterateFunctionNodes, openReadonlyOrFail } from '../db/index.js';
+import { buildFileConditionSQL } from '../db/query-builder.js';
+import { isTestFile } from '../infrastructure/test-filter.js';
+import { ALL_SYMBOL_KINDS } from './kinds.js';
+/**
+ * Generator: stream functions one-by-one using .iterate() for memory efficiency.
+ */
+export function* iterListFunctions(customDbPath, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const noTests = opts.noTests || false;
+        for (const row of iterateFunctionNodes(db, {
+            file: opts.file,
+            pattern: opts.pattern,
+        })) {
+            if (noTests && isTestFile(row.file))
+                continue;
+            yield {
+                name: row.name,
+                kind: row.kind,
+                file: row.file,
+                line: row.line,
+                endLine: row.end_line ?? null,
+                role: row.role ?? null,
+            };
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Generator: stream role-classified symbols one-by-one.
+ */
+export function* iterRoles(customDbPath, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const noTests = opts.noTests || false;
+        const conditions = ['role IS NOT NULL'];
+        const params = [];
+        if (opts.role) {
+            conditions.push('role = ?');
+            params.push(opts.role);
+        }
+        {
+            const fc = buildFileConditionSQL(opts.file ?? '', 'file');
+            if (fc.sql) {
+                conditions.push(fc.sql.replace(/^ AND /, ''));
+                params.push(...fc.params);
+            }
+        }
+        const stmt = db.prepare(`SELECT name, kind, file, line, end_line, role FROM nodes WHERE ${conditions.join(' AND ')} ORDER BY role, file, line`);
+        for (const row of stmt.iterate(...params)) {
+            if (noTests && isTestFile(row.file))
+                continue;
+            yield {
+                name: row.name,
+                kind: row.kind,
+                file: row.file,
+                line: row.line,
+                endLine: row.end_line ?? null,
+                role: row.role ?? null,
+            };
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Generator: stream symbol lookup results one-by-one.
+ */
+export function* iterWhere(target, customDbPath, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const noTests = opts.noTests || false;
+        const placeholders = ALL_SYMBOL_KINDS.map(() => '?').join(', ');
+        const stmt = db.prepare(`SELECT * FROM nodes WHERE name LIKE ? AND kind IN (${placeholders}) ORDER BY file, line`);
+        const crossFileCallersStmt = db.prepare(`SELECT COUNT(*) as cnt FROM edges e JOIN nodes n ON e.source_id = n.id
+       WHERE e.target_id = ? AND e.kind = 'calls' AND n.file != ?`);
+        const usesStmt = db.prepare(`SELECT n.name, n.file, n.line FROM edges e JOIN nodes n ON e.source_id = n.id
+       WHERE e.target_id = ? AND e.kind = 'calls'`);
+        for (const node of stmt.iterate(`%${target}%`, ...ALL_SYMBOL_KINDS)) {
+            if (noTests && isTestFile(node.file))
+                continue;
+            const crossFileCallers = crossFileCallersStmt.get(node.id, node.file);
+            const exported = crossFileCallers.cnt > 0;
+            let uses = usesStmt.all(node.id);
+            if (noTests)
+                uses = uses.filter((u) => !isTestFile(u.file));
+            yield {
+                name: node.name,
+                kind: node.kind,
+                file: node.file,
+                line: node.line,
+                role: node.role || null,
+                exported,
+                uses: uses.map((u) => ({ name: u.name, file: u.file, line: u.line })),
+            };
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=generators.js.map

package/dist/shared/generators.js.map

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

package/dist/shared/globs.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Glob → RegExp conversion utilities.
+ *
+ * Shared by boundary rules (`features/boundaries.ts`) and the file-collection
+ * include/exclude filters (`domain/graph/builder/helpers.ts`). Keeping a single
+ * implementation ensures users get consistent glob semantics everywhere.
+ *
+ * Supported syntax:
+ *   - `**` matches any sequence of characters including `/`
+ *   - `*`  matches any sequence of characters except `/`
+ *   - `?`  matches a single non-slash character
+ *   - other regex metacharacters are escaped literally
+ *
+ * Paths must use forward slashes (callers normalize before testing).
+ */
+/**
+ * Compile a glob pattern into a `RegExp` anchored with `^…$`.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * Compile a list of glob patterns. Invalid / empty patterns are skipped.
+ *
+ * Results are memoized per pattern-content so repeated `buildGraph` calls
+ * with the same include/exclude lists reuse the compiled regexes. The
+ * returned array is shared across callers and must not be mutated.
+ */
+export declare function compileGlobs(patterns: readonly string[] | undefined): readonly RegExp[];
+/**
+ * Clear the compiled-glob cache. Intended for long-running hosts that
+ * need to reload config (e.g. watch mode after `.codegraphrc.json` edits)
+ * and for test isolation.
+ */
+export declare function clearGlobCache(): void;
+/**
+ * `true` when at least one compiled pattern matches the given path.
+ *
+ * The path must already be normalized to forward slashes.
+ */
+export declare function matchesAny(regexes: readonly RegExp[], path: string): boolean;
+//# sourceMappingURL=globs.d.ts.map

package/dist/shared/globs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globs.d.ts","sourceRoot":"","sources":["../../src/shared/globs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiCnD;AAiBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAuBvF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAK5E"}