infiniloom-node 0.6.1 → 0.6.2

package/index.d.ts

@@ -3,20 +3,6 @@
 
 /* auto-generated by NAPI-RS */
 
-/**
- * Get the package version
- *
- * # Returns
- * The version string of the infiniloom-node package
- *
- * # Example
- * ```javascript
- * const { version } = require('infiniloom-node');
- *
- * console.log(`infiniloom-node v${version()}`);
- * ```
- */
-export declare function version(): string
 /** Options for packing a repository */
 export interface PackOptions {
   /** Output format: "xml", "markdown", "json", "yaml", "toon", or "plain" */
@@ -102,149 +88,6 @@ export interface ScanOptions {
   /** Apply default ignores for dist/, node_modules/, etc. (default: true) */
   applyDefaultIgnores?: boolean
 }
-/**
- * Pack a repository into optimized LLM context
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `options` - Optional packing options
- *
- * # Returns
- * Formatted repository context as a string
- *
- * # Example
- * ```javascript
- * const { pack } = require('infiniloom-node');
- *
- * const context = pack('./my-repo', {
- *   format: 'xml',
- *   model: 'claude',
- *   compression: 'balanced',
- *   mapBudget: 2000
- * });
- * ```
- */
-export declare function pack(path?: string | undefined | null, options?: PackOptions | undefined | null): string
-/**
- * Scan a repository and return statistics
- *
- * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `model` - Optional target model (default: "claude") - for backwards compatibility
- *
- * # Returns
- * Repository statistics
- *
- * # Example
- * ```javascript
- * const { scan } = require('infiniloom-node');
- *
- * const stats = scan('./my-repo', 'claude');
- * console.log(`Total files: ${stats.totalFiles}`);
- * console.log(`Total tokens: ${stats.totalTokens}`);
- * ```
- */
-export declare function scan(path?: string | undefined | null, model?: string | undefined | null): ScanStats
-/**
- * Scan a repository with full options
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `options` - Scan options
- *
- * # Returns
- * Repository statistics
- *
- * # Example
- * ```javascript
- * const { scanWithOptions } = require('infiniloom-node');
- *
- * const stats = scanWithOptions('./my-repo', {
- *   model: 'claude',
- *   exclude: ['dist/**', '**/*.test.ts'],
- *   applyDefaultIgnores: true
- * });
- * ```
- */
-export declare function scanWithOptions(path: string, options?: ScanOptions | undefined | null): ScanStats
-/**
- * Count tokens in text for a specific model
- *
- * # Arguments
- * * `text` - Text to tokenize (null/undefined returns 0)
- * * `model` - Optional model name (default: "claude")
- *
- * # Returns
- * Token count (exact for OpenAI models via tiktoken, calibrated estimates for others)
- *
- * # Example
- * ```javascript
- * const { countTokens } = require('infiniloom-node');
- *
- * const count = countTokens('Hello, world!', 'claude');
- * console.log(`Tokens: ${count}`);
- * ```
- */
-export declare function countTokens(text?: string | undefined | null, model?: string | undefined | null): number
-/**
- * Compress text using semantic compression
- *
- * Uses heuristic-based compression to reduce content while preserving meaning.
- * The compression works in three modes:
- *
- * 1. **Repetitive content**: Detects and collapses repeated patterns/lines
- * 2. **Chunk-based**: Splits content at paragraph/sentence boundaries and keeps a ratio
- * 3. **Character-based**: For content without boundaries, truncates to budget_ratio
- *
- * # Arguments
- * * `text` - Text to compress
- * * `similarity_threshold` - Threshold for grouping similar chunks (0.0-1.0, default: 0.7).
- *   Note: Only affects output when built with "embeddings" feature.
- * * `budget_ratio` - Target size as ratio of original (0.0-1.0, default: 0.5).
- *   Lower values = more aggressive compression. For example:
- *   - 0.5 = keep ~50% of content
- *   - 0.3 = keep ~30% of content
- *   - 1.0 = no compression
- *
- * # Returns
- * Compressed text with markers indicating what was removed
- *
- * # Example
- * ```javascript
- * const { semanticCompress } = require('infiniloom-node');
- *
- * // Using options object (recommended)
- * const compressed = semanticCompress(longText, { budgetRatio: 0.3 });
- *
- * // With all options
- * const custom = semanticCompress(longText, {
- *   similarityThreshold: 0.7,
- *   budgetRatio: 0.3,
- *   minChunkSize: 100,
- *   maxChunkSize: 2000
- * });
- * ```
- */
-export declare function semanticCompress(text?: string | undefined | null, options?: SemanticCompressOptions | undefined | null): string
-/**
- * Check if a path is a git repository
- *
- * # Arguments
- * * `path` - Path to check
- *
- * # Returns
- * True if path is a git repository, false otherwise
- *
- * # Example
- * ```javascript
- * const { isGitRepo } = require('infiniloom-node');
- *
- * if (isGitRepo('./my-project')) {
- *   console.log('This is a git repository');
- * }
- * ```
- */
-export declare function isGitRepo(path: string): boolean
 /** File status information */
 export interface GitFileStatus {
   /** File path */
@@ -319,7 +162,6 @@ export interface GitDiffHunk {
   /** Individual line changes within this hunk */
   lines: Array<GitDiffLine>
 }
-/** Security finding information */
 export interface SecurityFinding {
   /** File where the finding was detected */
   file: string
@@ -332,26 +174,6 @@ export interface SecurityFinding {
   /** Matched pattern */
   pattern: string
 }
-/**
- * Scan a repository for security issues
- *
- * # Arguments
- * * `path` - Path to repository root
- *
- * # Returns
- * Array of security findings
- *
- * # Example
- * ```javascript
- * const { scanSecurity } = require('infiniloom-node');
- *
- * const findings = scanSecurity('./my-repo');
- * for (const finding of findings) {
- *   console.log(`${finding.severity}: ${finding.kind} in ${finding.file}:${finding.line}`);
- * }
- * ```
- */
-export declare function scanSecurity(path?: string | undefined | null): Array<SecurityFinding>
 /** Options for building an index */
 export interface IndexOptions {
   /** Force full rebuild even if index exists */
@@ -385,52 +207,6 @@ export interface IndexStatus {
   /** Whether this was an incremental update */
   incremental?: boolean
 }
-/**
- * Build or update the symbol index for a repository
- *
- * The index enables fast diff-to-context lookups and impact analysis.
- *
- * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `options` - Optional index build options
- *
- * # Returns
- * Index status after building
- *
- * # Example
- * ```javascript
- * const { buildIndex } = require('infiniloom-node');
- *
- * const status = buildIndex('./my-repo');
- * console.log(`Indexed ${status.symbolCount} symbols`);
- *
- * // Force rebuild
- * const status2 = buildIndex('./my-repo', { force: true });
- * ```
- */
-export declare function buildIndex(path?: string | undefined | null, options?: IndexOptions | undefined | null): IndexStatus
-/**
- * Get the status of an existing index
- *
- * # Arguments
- * * `path` - Path to repository root
- *
- * # Returns
- * Index status information
- *
- * # Example
- * ```javascript
- * const { indexStatus } = require('infiniloom-node');
- *
- * const status = indexStatus('./my-repo');
- * if (status.exists) {
- *   console.log(`Index has ${status.symbolCount} symbols`);
- * } else {
- *   console.log('No index found, run buildIndex first');
- * }
- * ```
- */
-export declare function indexStatus(path: string): IndexStatus
 /** Information about a symbol in the call graph */
 export interface SymbolInfo {
   /** Symbol ID */
@@ -500,6 +276,15 @@ export interface CallGraph {
   /** Summary statistics */
   stats: CallGraphStats
 }
+/** A cycle in the dependency graph (circular import) */
+export interface DependencyCycle {
+  /** File paths in the cycle (e.g., ["a.ts", "b.ts", "c.ts"] means a->b->c->a) */
+  files: Array<string>
+  /** Internal file IDs corresponding to the files */
+  fileIds: Array<number>
+  /** Number of files in the cycle */
+  length: number
+}
 /** Options for call graph queries */
 export interface CallGraphOptions {
   /** Maximum number of nodes to return (default: unlimited) */
@@ -560,261 +345,6 @@ export interface QueryFilter {
   /** Exclude specific kinds (e.g., exclude "import" to skip import statements) */
   excludeKinds?: Array<string>
 }
-/**
- * Find a symbol by name
- *
- * Searches the index for all symbols matching the given name.
- * Requires an index to be built first (use `buildIndex`).
- *
- * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `name` - Symbol name to search for (null/undefined returns error)
- *
- * # Returns
- * Array of matching symbols
- *
- * # Example
- * ```javascript
- * const { findSymbol, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * const symbols = findSymbol('./my-repo', 'processRequest');
- * console.log(`Found ${symbols.length} symbols named processRequest`);
- * ```
- */
-export declare function findSymbol(path?: string | undefined | null, name?: string | undefined | null): Array<SymbolInfo>
-/**
- * Get all callers of a symbol
- *
- * Returns symbols that call any symbol with the given name.
- * Requires an index to be built first (use `buildIndex`).
- *
- * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `symbol_name` - Name of the symbol to find callers for (null/undefined returns error)
- *
- * # Returns
- * Array of symbols that call the target symbol
- *
- * # Example
- * ```javascript
- * const { getCallers, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * const callers = getCallers('./my-repo', 'authenticate');
- * console.log(`authenticate is called by ${callers.length} functions`);
- * for (const c of callers) {
- *   console.log(`  ${c.name} at ${c.file}:${c.line}`);
- * }
- * ```
- */
-export declare function getCallers(path?: string | undefined | null, symbolName?: string | undefined | null): Array<SymbolInfo>
-/**
- * Get all callees of a symbol
- *
- * Returns symbols that are called by any symbol with the given name.
- * Requires an index to be built first (use `buildIndex`).
- *
- * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `symbol_name` - Name of the symbol to find callees for (null/undefined returns error)
- *
- * # Returns
- * Array of symbols that the target symbol calls
- *
- * # Example
- * ```javascript
- * const { getCallees, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * const callees = getCallees('./my-repo', 'main');
- * console.log(`main calls ${callees.length} functions`);
- * for (const c of callees) {
- *   console.log(`  ${c.name} at ${c.file}:${c.line}`);
- * }
- * ```
- */
-export declare function getCallees(path?: string | undefined | null, symbolName?: string | undefined | null): Array<SymbolInfo>
-/**
- * Get all references to a symbol
- *
- * Returns all locations where a symbol is referenced (calls, imports, inheritance).
- * Requires an index to be built first (use `buildIndex`).
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `symbol_name` - Name of the symbol to find references for
- *
- * # Returns
- * Array of reference information including the referencing symbol and kind
- *
- * # Example
- * ```javascript
- * const { getReferences, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * const refs = getReferences('./my-repo', 'UserService');
- * console.log(`UserService is referenced ${refs.length} times`);
- * for (const r of refs) {
- *   console.log(`  ${r.kind}: ${r.symbol.name} at ${r.symbol.file}:${r.symbol.line}`);
- * }
- * ```
- */
-export declare function getReferences(path?: string | undefined | null, symbolName?: string | undefined | null): Array<ReferenceInfo>
-/**
- * Find symbols by name with filtering
- *
- * Like `findSymbol`, but allows filtering results by symbol kind.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `name` - Symbol name to search for
- * * `filter` - Optional filter for symbol kinds
- *
- * # Returns
- * Array of matching symbols that pass the filter
- *
- * # Example
- * ```javascript
- * const { findSymbolFiltered, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * // Find only functions named "process"
- * const funcs = findSymbolFiltered('./my-repo', 'process', {
- *   kinds: ['function', 'method']
- * });
- * // Find all symbols except imports
- * const noImports = findSymbolFiltered('./my-repo', 'User', {
- *   excludeKinds: ['import']
- * });
- * ```
- */
-export declare function findSymbolFiltered(path: string, name: string, filter?: QueryFilter | undefined | null): Array<SymbolInfo>
-/**
- * Get callers of a symbol with filtering
- *
- * Like `getCallers`, but allows filtering results by symbol kind.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `symbol_name` - Name of the symbol to find callers for
- * * `filter` - Optional filter for symbol kinds
- *
- * # Returns
- * Array of filtered calling symbols
- *
- * # Example
- * ```javascript
- * const { getCallersFiltered, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * // Get only function callers (not class methods)
- * const callers = getCallersFiltered('./my-repo', 'authenticate', {
- *   kinds: ['function']
- * });
- * ```
- */
-export declare function getCallersFiltered(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Array<SymbolInfo>
-/**
- * Get callees of a symbol with filtering
- *
- * Like `getCallees`, but allows filtering results by symbol kind.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `symbol_name` - Name of the symbol to find callees for
- * * `filter` - Optional filter for symbol kinds
- *
- * # Returns
- * Array of filtered called symbols
- *
- * # Example
- * ```javascript
- * const { getCalleesFiltered, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * // Get only function calls (not method calls)
- * const callees = getCalleesFiltered('./my-repo', 'main', {
- *   kinds: ['function']
- * });
- * ```
- */
-export declare function getCalleesFiltered(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Array<SymbolInfo>
-/**
- * Get references to a symbol with filtering
- *
- * Like `getReferences`, but allows filtering results by symbol kind.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `symbol_name` - Name of the symbol to find references for
- * * `filter` - Optional filter for referencing symbol kinds
- *
- * # Returns
- * Array of filtered reference information
- *
- * # Example
- * ```javascript
- * const { getReferencesFiltered, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * // Get only call references from functions
- * const refs = getReferencesFiltered('./my-repo', 'UserService', {
- *   kinds: ['function', 'method'],
- *   excludeKinds: ['import']
- * });
- * ```
- */
-export declare function getReferencesFiltered(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Array<ReferenceInfo>
-/** Async version of findSymbolFiltered */
-export declare function findSymbolFilteredAsync(path: string, name: string, filter?: QueryFilter | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getCallersFiltered */
-export declare function getCallersFilteredAsync(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getCalleesFiltered */
-export declare function getCalleesFilteredAsync(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getReferencesFiltered */
-export declare function getReferencesFilteredAsync(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Promise<Array<ReferenceInfo>>
-/**
- * Get the complete call graph
- *
- * Returns all symbols and their call relationships.
- * Requires an index to be built first (use `buildIndex`).
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `options` - Optional filtering options
- *
- * # Returns
- * Call graph with nodes (symbols), edges (calls), and statistics
- *
- * # Example
- * ```javascript
- * const { getCallGraph, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * const graph = getCallGraph('./my-repo');
- * console.log(`Call graph: ${graph.stats.totalSymbols} symbols, ${graph.stats.totalCalls} calls`);
- *
- * // Find most called functions
- * const callCounts = new Map();
- * for (const edge of graph.edges) {
- *   callCounts.set(edge.callee, (callCounts.get(edge.callee) || 0) + 1);
- * }
- * const sorted = [...callCounts.entries()].sort((a, b) => b[1] - a[1]);
- * console.log('Most called functions:', sorted.slice(0, 10));
- * ```
- */
-export declare function getCallGraph(path?: string | undefined | null, options?: CallGraphOptions | undefined | null): CallGraph
-/** Async version of findSymbol */
-export declare function findSymbolAsync(path?: string | undefined | null, name?: string | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getCallers */
-export declare function getCallersAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getCallees */
-export declare function getCalleesAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getReferences */
-export declare function getReferencesAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<ReferenceInfo>>
-/** Async version of getCallGraph */
-export declare function getCallGraphAsync(path?: string | undefined | null, options?: CallGraphOptions | undefined | null): Promise<CallGraph>
 /** Options for chunking a repository */
 export interface ChunkOptions {
   /** Chunking strategy: "fixed", "file", "module", "symbol", "semantic", "dependency" */
@@ -847,35 +377,6 @@ export interface RepoChunk {
   /** Formatted content of the chunk */
   content: string
 }
-/**
- * Split a repository into chunks for incremental processing
- *
- * Useful for processing large repositories that exceed LLM context limits.
- *
- * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `options` - Optional chunking options
- *
- * # Returns
- * Array of repository chunks
- *
- * # Example
- * ```javascript
- * const { chunk } = require('infiniloom-node');
- *
- * const chunks = chunk('./large-repo', {
- *   strategy: 'module',
- *   maxTokens: 50000,
- *   model: 'claude'
- * });
- *
- * for (const c of chunks) {
- *   console.log(`Chunk ${c.index}/${c.total}: ${c.focus} (${c.tokens} tokens)`);
- *   // Process c.content with LLM
- * }
- * ```
- */
-export declare function chunk(path?: string | undefined | null, options?: ChunkOptions | undefined | null): Array<RepoChunk>
 /** Options for impact analysis */
 export interface ImpactOptions {
   /** Depth of dependency traversal (1-3, default: 2) */
@@ -917,33 +418,6 @@ export interface ImpactResult {
   /** Summary of the impact */
   summary: string
 }
-/**
- * Analyze the impact of changes to files or symbols
- *
- * Requires an index to be built first (use buildIndex).
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `files` - Files to analyze (can be paths or globs)
- * * `options` - Optional analysis options
- *
- * # Returns
- * Impact analysis result
- *
- * # Example
- * ```javascript
- * const { buildIndex, analyzeImpact } = require('infiniloom-node');
- *
- * // Build index first
- * buildIndex('./my-repo');
- *
- * // Analyze impact of changes
- * const impact = analyzeImpact('./my-repo', ['src/auth.ts']);
- * console.log(`Impact level: ${impact.impactLevel}`);
- * console.log(`Affected files: ${impact.dependentFiles.length}`);
- * ```
- */
-export declare function analyzeImpact(path: string, files: Array<string>, options?: ImpactOptions | undefined | null): ImpactResult
 /** Options for diff context */
 export interface DiffContextOptions {
   /** Depth of context expansion (1-3, default: 2) */
@@ -1004,483 +478,1669 @@ export interface ContextSymbolInfo {
   /** Symbol signature/definition */
   signature?: string
 }
+/** Options for filtering symbols */
+export interface SymbolFilter {
+  /** Filter by symbol kind: "function", "class", "method", etc. */
+  kind?: string
+  /** Filter by visibility: "public", "private", "protected" */
+  visibility?: string
+}
+/** A call site where a symbol is called */
+export interface CallSite {
+  /** Name of the calling function/method */
+  caller: string
+  /** Name of the function/method being called */
+  callee: string
+  /** File containing the call */
+  file: string
+  /** Line number of the call (1-indexed) */
+  line: number
+  /** Column number of the call (0-indexed, if available) */
+  column?: number
+  /** Caller symbol ID */
+  callerId: number
+  /** Callee symbol ID */
+  calleeId: number
+}
+/** Call site with surrounding code context */
+export interface CallSiteWithContext {
+  /** Name of the calling function/method */
+  caller: string
+  /** Name of the function/method being called */
+  callee: string
+  /** File containing the call */
+  file: string
+  /** Line number of the call (1-indexed) */
+  line: number
+  /** Column number of the call (0-indexed, if available) */
+  column?: number
+  /** Caller symbol ID */
+  callerId: number
+  /** Callee symbol ID */
+  calleeId: number
+  /** Code context around the call site (configurable number of lines) */
+  context?: string
+  /** Start line of context */
+  contextStartLine?: number
+  /** End line of context */
+  contextEndLine?: number
+}
+/** Options for call sites with context */
+export interface CallSitesContextOptions {
+  /** Number of lines of context before the call (default: 3) */
+  linesBefore?: number
+  /** Number of lines of context after the call (default: 3) */
+  linesAfter?: number
+}
+/** Filter for changed symbols query */
+export interface ChangedSymbolsFilter {
+  /**
+   * Filter by symbol kinds: "function", "method", "class", etc.
+   * If specified, only symbols of these kinds are returned.
+   */
+  kinds?: Array<string>
+  /** Exclude specific kinds (e.g., exclude "import" to skip import statements) */
+  excludeKinds?: Array<string>
+}
+/** A symbol with change type information */
+export interface ChangedSymbolInfo {
+  /** Symbol ID */
+  id: number
+  /** Symbol name */
+  name: string
+  /** Symbol kind (function, class, method, etc.) */
+  kind: string
+  /** File path containing the symbol */
+  file: string
+  /** Start line number */
+  line: number
+  /** End line number */
+  endLine: number
+  /** Function/method signature */
+  signature?: string
+  /** Visibility (public, private, etc.) */
+  visibility: string
+  /** Change type: "added", "modified", or "deleted" */
+  changeType: string
+}
+/** Transitive caller information */
+export interface TransitiveCallerInfo {
+  /** Symbol name */
+  name: string
+  /** Symbol kind */
+  kind: string
+  /** File path */
+  file: string
+  /** Line number */
+  line: number
+  /** Depth from the target symbol (1 = direct caller, 2 = caller of caller, etc.) */
+  depth: number
+  /** Call path from this caller to the target (e.g., ["main", "process", "validate", "target"]) */
+  callPath: Array<string>
+}
+/** Options for transitive callers query */
+export interface TransitiveCallersOptions {
+  /** Maximum depth to traverse (default: 3) */
+  maxDepth?: number
+  /** Maximum number of results (default: 100) */
+  maxResults?: number
+}
+/** Options for embedding chunk generation */
+export interface EmbedOptions {
+  /** Maximum tokens per chunk (default: 1000) */
+  maxTokens?: number
+  /** Minimum tokens for a chunk (default: 50) */
+  minTokens?: number
+  /** Lines of context around symbols (default: 5) */
+  contextLines?: number
+  /** Include imports in chunks (default: true) */
+  includeImports?: boolean
+  /** Include top-level code (default: true) */
+  includeTopLevel?: boolean
+  /** Include test files (default: false) */
+  includeTests?: boolean
+  /** Enable secret scanning (default: true) */
+  securityScan?: boolean
+  /** Include patterns (glob) */
+  includePatterns?: Array<string>
+  /** Exclude patterns (glob) */
+  excludePatterns?: Array<string>
+  /** Path to manifest file (default: .infiniloom-embed.bin) */
+  manifestPath?: string
+  /** Only return changed chunks (diff mode) */
+  diffOnly?: boolean
+}
+/** Source information for a chunk */
+export interface EmbedChunkSource {
+  /** File path */
+  file: string
+  /** Line range (start, end) - 1-indexed */
+  linesStart: number
+  linesEnd: number
+  /** Symbol name */
+  symbol: string
+  /** Fully qualified name (if available) */
+  fqn?: string
+  /** Programming language */
+  language: string
+  /** Parent symbol (if any) */
+  parent?: string
+  /** Visibility: "public", "private", "protected", "internal" */
+  visibility: string
+  /** Whether this is test code */
+  isTest: boolean
+}
+/** Context information for a chunk */
+export interface EmbedChunkContext {
+  /** Extracted docstring for natural language retrieval */
+  docstring?: string
+  /** Extracted comments within the chunk */
+  comments: Array<string>
+  /** Function/class signature (always included, even in split parts) */
+  signature?: string
+  /** Symbols this chunk calls */
+  calls: Array<string>
+  /** Symbols that call this chunk */
+  calledBy: Array<string>
+  /** Imports in this chunk */
+  imports: Array<string>
+  /** Auto-generated semantic tags (async, security, database, etc.) */
+  tags: Array<string>
+  /** Lines of code (excluding blank lines and comments) */
+  linesOfCode: number
+  /** Maximum nesting depth (control flow, blocks) */
+  maxNestingDepth: number
+}
+/** Chunk part info for split chunks */
+export interface EmbedChunkPart {
+  /** Part number (1-indexed) */
+  part: number
+  /** Total number of parts */
+  of: number
+  /** ID of the logical parent (full symbol hash) */
+  parentId: string
+  /** Signature repeated for context */
+  parentSignature?: string
+}
+/** A single embedding chunk */
+export interface EmbedChunk {
+  /** Content-addressable chunk ID (ec_ prefix + 32 hex chars) */
+  id: string
+  /** Full content hash for collision detection */
+  fullHash: string
+  /** Chunk content (code) */
+  content: string
+  /** Token count */
+  tokens: number
+  /** Chunk kind: "function", "class", "struct", "method", etc. */
+  kind: string
+  /** Source information */
+  source: EmbedChunkSource
+  /** Context information */
+  context: EmbedChunkContext
+  /** Part info (for multi-part chunks) */
+  part?: EmbedChunkPart
+}
+/** Diff summary statistics */
+export interface EmbedDiffSummary {
+  /** Number of added chunks */
+  added: number
+  /** Number of modified chunks */
+  modified: number
+  /** Number of removed chunks */
+  removed: number
+  /** Number of unchanged chunks */
+  unchanged: number
+  /** Total chunks in current state */
+  totalChunks: number
+}
+/** Result from embedding operation */
+export interface EmbedResult {
+  /** Generated chunks */
+  chunks: Array<EmbedChunk>
+  /** Diff summary (if manifest existed) */
+  diff?: EmbedDiffSummary
+  /** Manifest version */
+  manifestVersion: number
+  /** Processing time in milliseconds */
+  elapsedMs: number
+}
+/** Manifest status information */
+export interface EmbedManifestStatus {
+  /** Whether manifest exists */
+  exists: boolean
+  /** Number of chunks in manifest */
+  chunkCount?: number
+  /** Repository path stored in manifest */
+  repoPath?: string
+  /** Last update timestamp (Unix seconds) */
+  updatedAt?: number
+  /** Manifest format version */
+  version?: number
+}
 /**
- * Get context-aware diff with surrounding symbols and dependencies
+ * Scan a repository for security issues
  *
- * Unlike basic diffFiles, this provides semantic context around changes.
- * Requires an index (will build on-the-fly if not present).
+ * # Arguments
+ * * `path` - Path to repository root
+ *
+ * # Returns
+ * Array of security findings
+ *
+ * # Example
+ * ```javascript
+ * const { scanSecurity } = require('infiniloom-node');
+ *
+ * const findings = scanSecurity('./my-repo');
+ * for (const finding of findings) {
+ *   console.log(`${finding.severity}: ${finding.kind} in ${finding.file}:${finding.line}`);
+ * }
+ * ```
+ */
+export declare function scanSecurity(path?: string | undefined | null): Array<SecurityFinding>
+/**
+ * Scan a repository and return statistics
+ *
+ * # Arguments
+ * * `path` - Path to repository root (null/undefined returns error)
+ * * `model` - Optional target model (default: "claude") - for backwards compatibility
+ *
+ * # Returns
+ * Repository statistics
+ *
+ * # Example
+ * ```javascript
+ * const { scan } = require('infiniloom-node');
+ *
+ * const stats = scan('./my-repo', 'claude');
+ * console.log(`Total files: ${stats.totalFiles}`);
+ * console.log(`Total tokens: ${stats.totalTokens}`);
+ * ```
+ */
+export declare function scan(path?: string | undefined | null, model?: string | undefined | null): ScanStats
+/**
+ * Scan a repository with full options
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `options` - Scan options
+ *
+ * # Returns
+ * Repository statistics
+ *
+ * # Example
+ * ```javascript
+ * const { scanWithOptions } = require('infiniloom-node');
+ *
+ * const stats = scanWithOptions('./my-repo', {
+ *   model: 'claude',
+ *   exclude: ['dist/**', '**/*.test.ts'],
+ *   applyDefaultIgnores: true
+ * });
+ * ```
+ */
+export declare function scanWithOptions(path: string, options?: ScanOptions | undefined | null): ScanStats
+/**
+ * Count tokens in text for a specific model
+ *
+ * # Arguments
+ * * `text` - Text to tokenize (null/undefined returns 0)
+ * * `model` - Optional model name (default: "claude")
+ *
+ * # Returns
+ * Token count (exact for OpenAI models via tiktoken, calibrated estimates for others)
+ *
+ * # Example
+ * ```javascript
+ * const { countTokens } = require('infiniloom-node');
+ *
+ * const count = countTokens('Hello, world!', 'claude');
+ * console.log(`Tokens: ${count}`);
+ * ```
+ */
+export declare function countTokens(text?: string | undefined | null, model?: string | undefined | null): number
+/**
+ * Split a repository into chunks for incremental processing
+ *
+ * Useful for processing large repositories that exceed LLM context limits.
+ *
+ * # Arguments
+ * * `path` - Path to repository root (null/undefined returns error)
+ * * `options` - Optional chunking options
+ *
+ * # Returns
+ * Array of repository chunks
+ *
+ * # Example
+ * ```javascript
+ * const { chunk } = require('infiniloom-node');
+ *
+ * const chunks = chunk('./large-repo', {
+ *   strategy: 'module',
+ *   maxTokens: 50000,
+ *   model: 'claude'
+ * });
+ *
+ * for (const c of chunks) {
+ *   console.log(`Chunk ${c.index}/${c.total}: ${c.focus} (${c.tokens} tokens)`);
+ *   // Process c.content with LLM
+ * }
+ * ```
+ */
+export declare function chunk(path?: string | undefined | null, options?: ChunkOptions | undefined | null): Array<RepoChunk>
+/**
+ * Pack a repository into optimized LLM context
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `options` - Optional packing options
+ *
+ * # Returns
+ * Formatted repository context as a string
+ *
+ * # Example
+ * ```javascript
+ * const { pack } = require('infiniloom-node');
+ *
+ * const context = pack('./my-repo', {
+ *   format: 'xml',
+ *   model: 'claude',
+ *   compression: 'balanced',
+ *   mapBudget: 2000
+ * });
+ * ```
+ */
+export declare function pack(path?: string | undefined | null, options?: PackOptions | undefined | null): string
+/**
+ * Check if a path is a git repository
+ *
+ * # Arguments
+ * * `path` - Path to check
+ *
+ * # Returns
+ * True if path is a git repository, false otherwise
+ *
+ * # Example
+ * ```javascript
+ * const { isGitRepo } = require('infiniloom-node');
+ *
+ * if (isGitRepo('./my-project')) {
+ *   console.log('This is a git repository');
+ * }
+ * ```
+ */
+export declare function isGitRepo(path: string): boolean
+/**
+ * Build or update the symbol index for a repository
+ *
+ * The index enables fast diff-to-context lookups and impact analysis.
+ *
+ * # Arguments
+ * * `path` - Path to repository root (null/undefined returns error)
+ * * `options` - Optional index build options
+ *
+ * # Returns
+ * Index status after building
+ *
+ * # Example
+ * ```javascript
+ * const { buildIndex } = require('infiniloom-node');
+ *
+ * const status = buildIndex('./my-repo');
+ * console.log(`Indexed ${status.symbolCount} symbols`);
+ *
+ * // Force rebuild
+ * const status2 = buildIndex('./my-repo', { force: true });
+ * ```
+ */
+export declare function buildIndex(path?: string | undefined | null, options?: IndexOptions | undefined | null): IndexStatus
+/**
+ * Get the status of an existing index
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ *
+ * # Returns
+ * Index status information
+ *
+ * # Example
+ * ```javascript
+ * const { indexStatus } = require('infiniloom-node');
+ *
+ * const status = indexStatus('./my-repo');
+ * if (status.exists) {
+ *   console.log(`Index has ${status.symbolCount} symbols`);
+ * } else {
+ *   console.log('No index found, run buildIndex first');
+ * }
+ * ```
+ */
+export declare function indexStatus(path: string): IndexStatus
+/**
+ * Find a symbol by name
+ *
+ * Searches the index for all symbols matching the given name.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root (null/undefined returns error)
+ * * `name` - Symbol name to search for (null/undefined returns error)
+ *
+ * # Returns
+ * Array of matching symbols
+ *
+ * # Example
+ * ```javascript
+ * const { findSymbol, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const symbols = findSymbol('./my-repo', 'processRequest');
+ * console.log(`Found ${symbols.length} symbols named processRequest`);
+ * ```
+ */
+export declare function findSymbol(path?: string | undefined | null, name?: string | undefined | null): Array<SymbolInfo>
+/**
+ * Get all callers of a symbol
+ *
+ * Returns symbols that call any symbol with the given name.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root (null/undefined returns error)
+ * * `symbol_name` - Name of the symbol to find callers for (null/undefined returns error)
+ *
+ * # Returns
+ * Array of symbols that call the target symbol
+ *
+ * # Example
+ * ```javascript
+ * const { getCallers, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const callers = getCallers('./my-repo', 'authenticate');
+ * console.log(`authenticate is called by ${callers.length} functions`);
+ * for (const c of callers) {
+ *   console.log(`  ${c.name} at ${c.file}:${c.line}`);
+ * }
+ * ```
+ */
+export declare function getCallers(path?: string | undefined | null, symbolName?: string | undefined | null): Array<SymbolInfo>
+/**
+ * Get all callees of a symbol
+ *
+ * Returns symbols that are called by any symbol with the given name.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root (null/undefined returns error)
+ * * `symbol_name` - Name of the symbol to find callees for (null/undefined returns error)
+ *
+ * # Returns
+ * Array of symbols that the target symbol calls
+ *
+ * # Example
+ * ```javascript
+ * const { getCallees, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const callees = getCallees('./my-repo', 'main');
+ * console.log(`main calls ${callees.length} functions`);
+ * for (const c of callees) {
+ *   console.log(`  ${c.name} at ${c.file}:${c.line}`);
+ * }
+ * ```
+ */
+export declare function getCallees(path?: string | undefined | null, symbolName?: string | undefined | null): Array<SymbolInfo>
+/**
+ * Get all references to a symbol
+ *
+ * Returns all locations where a symbol is referenced (calls, imports, inheritance).
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find references for
+ *
+ * # Returns
+ * Array of reference information including the referencing symbol and kind
+ *
+ * # Example
+ * ```javascript
+ * const { getReferences, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const refs = getReferences('./my-repo', 'UserService');
+ * console.log(`UserService is referenced ${refs.length} times`);
+ * for (const r of refs) {
+ *   console.log(`  ${r.kind}: ${r.symbol.name} at ${r.symbol.file}:${r.symbol.line}`);
+ * }
+ * ```
+ */
+export declare function getReferences(path?: string | undefined | null, symbolName?: string | undefined | null): Array<ReferenceInfo>
+/**
+ * Find symbols by name with filtering
+ *
+ * Like `findSymbol`, but allows filtering results by symbol kind.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `name` - Symbol name to search for
+ * * `filter` - Optional filter for symbol kinds
+ *
+ * # Returns
+ * Array of matching symbols that pass the filter
+ *
+ * # Example
+ * ```javascript
+ * const { findSymbolFiltered, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * // Find only functions named "process"
+ * const funcs = findSymbolFiltered('./my-repo', 'process', {
+ *   kinds: ['function', 'method']
+ * });
+ * // Find all symbols except imports
+ * const noImports = findSymbolFiltered('./my-repo', 'User', {
+ *   excludeKinds: ['import']
+ * });
+ * ```
+ */
+export declare function findSymbolFiltered(path: string, name: string, filter?: QueryFilter | undefined | null): Array<SymbolInfo>
+/**
+ * Get callers of a symbol with filtering
+ *
+ * Like `getCallers`, but allows filtering results by symbol kind.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find callers for
+ * * `filter` - Optional filter for symbol kinds
+ *
+ * # Returns
+ * Array of filtered calling symbols
+ *
+ * # Example
+ * ```javascript
+ * const { getCallersFiltered, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * // Get only function callers (not class methods)
+ * const callers = getCallersFiltered('./my-repo', 'authenticate', {
+ *   kinds: ['function']
+ * });
+ * ```
+ */
+export declare function getCallersFiltered(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Array<SymbolInfo>
+/**
+ * Get callees of a symbol with filtering
+ *
+ * Like `getCallees`, but allows filtering results by symbol kind.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find callees for
+ * * `filter` - Optional filter for symbol kinds
+ *
+ * # Returns
+ * Array of filtered called symbols
+ *
+ * # Example
+ * ```javascript
+ * const { getCalleesFiltered, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * // Get only function calls (not method calls)
+ * const callees = getCalleesFiltered('./my-repo', 'main', {
+ *   kinds: ['function']
+ * });
+ * ```
+ */
+export declare function getCalleesFiltered(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Array<SymbolInfo>
+/**
+ * Get references to a symbol with filtering
+ *
+ * Like `getReferences`, but allows filtering results by symbol kind.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find references for
+ * * `filter` - Optional filter for referencing symbol kinds
+ *
+ * # Returns
+ * Array of filtered reference information
+ *
+ * # Example
+ * ```javascript
+ * const { getReferencesFiltered, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * // Get only call references from functions
+ * const refs = getReferencesFiltered('./my-repo', 'UserService', {
+ *   kinds: ['function', 'method'],
+ *   excludeKinds: ['import']
+ * });
+ * ```
+ */
+export declare function getReferencesFiltered(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Array<ReferenceInfo>
+/** Async version of findSymbolFiltered */
+export declare function findSymbolFilteredAsync(path: string, name: string, filter?: QueryFilter | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getCallersFiltered */
+export declare function getCallersFilteredAsync(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getCalleesFiltered */
+export declare function getCalleesFilteredAsync(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getReferencesFiltered */
+export declare function getReferencesFilteredAsync(path: string, symbolName: string, filter?: QueryFilter | undefined | null): Promise<Array<ReferenceInfo>>
+/**
+ * Get the complete call graph
+ *
+ * Returns all symbols and their call relationships.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `options` - Optional filtering options
+ *
+ * # Returns
+ * Call graph with nodes (symbols), edges (calls), and statistics
+ *
+ * # Example
+ * ```javascript
+ * const { getCallGraph, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const graph = getCallGraph('./my-repo');
+ * console.log(`Call graph: ${graph.stats.totalSymbols} symbols, ${graph.stats.totalCalls} calls`);
+ *
+ * // Find most called functions
+ * const callCounts = new Map();
+ * for (const edge of graph.edges) {
+ *   callCounts.set(edge.callee, (callCounts.get(edge.callee) || 0) + 1);
+ * }
+ * const sorted = [...callCounts.entries()].sort((a, b) => b[1] - a[1]);
+ * console.log('Most called functions:', sorted.slice(0, 10));
+ * ```
+ */
+export declare function getCallGraph(path?: string | undefined | null, options?: CallGraphOptions | undefined | null): CallGraph
+/** Async version of findSymbol */
+export declare function findSymbolAsync(path?: string | undefined | null, name?: string | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getCallers */
+export declare function getCallersAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getCallees */
+export declare function getCalleesAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getReferences */
+export declare function getReferencesAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<ReferenceInfo>>
+/** Async version of getCallGraph */
+export declare function getCallGraphAsync(path?: string | undefined | null, options?: CallGraphOptions | undefined | null): Promise<CallGraph>
+/**
+ * Find circular dependencies in the codebase
+ *
+ * Detects cycles in file import relationships (e.g., A imports B imports C imports A).
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ *
+ * # Returns
+ * Array of cycles, where each cycle contains:
+ * - `files`: Array of file paths in the cycle
+ * - `fileIds`: Array of internal file IDs
+ * - `length`: Number of files in the cycle
+ *
+ * # Example
+ * ```javascript
+ * const { findCircularDependencies, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const cycles = findCircularDependencies('./my-repo');
+ * if (cycles.length > 0) {
+ *   console.log(`Found ${cycles.length} circular dependencies:`);
+ *   for (const cycle of cycles) {
+ *     console.log(`  ${cycle.files.join(' -> ')} -> ${cycle.files[0]}`);
+ *   }
+ * } else {
+ *   console.log('No circular dependencies found');
+ * }
+ * ```
+ */
+export declare function findCircularDependencies(path?: string | undefined | null): Array<DependencyCycle>
+/** Async version of findCircularDependencies */
+export declare function findCircularDependenciesAsync(path?: string | undefined | null): Promise<Array<DependencyCycle>>
+/**
+ * Get all exported/public symbols in the codebase
+ *
+ * Returns symbols that are either:
+ * - Explicitly exported (e.g., JavaScript/TypeScript exports)
+ * - Public functions, classes, structs, traits, enums, etc.
+ *
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `filePath` - Optional file path to filter results (relative to repo root)
+ *
+ * # Returns
+ * Array of symbols that are part of the public API
+ *
+ * # Example
+ * ```javascript
+ * const { getExportedSymbols, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ *
+ * // Get all exports in the codebase
+ * const exports = getExportedSymbols('./my-repo');
+ * console.log(`Found ${exports.length} public API symbols`);
+ *
+ * // Get exports from a specific file
+ * const fileExports = getExportedSymbols('./my-repo', 'src/auth.ts');
+ * for (const sym of fileExports) {
+ *   console.log(`  ${sym.kind} ${sym.name}`);
+ * }
+ * ```
+ */
+export declare function getExportedSymbols(path?: string | undefined | null, filePath?: string | undefined | null): Array<SymbolInfo>
+/** Async version of getExportedSymbols */
+export declare function getExportedSymbolsAsync(path?: string | undefined | null, filePath?: string | undefined | null): Promise<Array<SymbolInfo>>
+/**
+ * Get all symbols in a specific file
+ *
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `file_path` - Relative path to the file within the repository
+ * * `filter` - Optional filter for symbol kind/visibility
+ *
+ * # Returns
+ * Array of symbols defined in the file
+ *
+ * # Example
+ * ```javascript
+ * const { getSymbolsInFile, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const symbols = getSymbolsInFile('./my-repo', 'src/auth.ts');
+ * console.log(`Found ${symbols.length} symbols in auth.ts`);
+ * for (const s of symbols) {
+ *   console.log(`  ${s.kind}: ${s.name} at line ${s.line}`);
+ * }
+ * ```
+ */
+export declare function getSymbolsInFile(path: string, filePath: string, filter?: SymbolFilter | undefined | null): Array<SymbolInfo>
+/**
+ * Get the source code of a symbol
+ *
+ * Reads the file and extracts the source code for the specified symbol.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to get source for
+ * * `file_path` - Optional file path to disambiguate when multiple symbols have the same name
+ *
+ * # Returns
+ * Source code of the symbol (or the first matching symbol if multiple exist)
+ *
+ * # Example
+ * ```javascript
+ * const { getSymbolSource, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const result = getSymbolSource('./my-repo', 'authenticate', 'src/auth.ts');
+ * console.log(`Source at ${result.path}:${result.startLine}`);
+ * console.log(result.source);
+ * ```
+ */
+export declare function getSymbolSource(path?: string | undefined | null, symbolName?: string | undefined | null, filePath?: string | undefined | null): SymbolSourceResult
+/**
+ * Get symbols that were changed in a diff
+ *
+ * Parses the diff between two refs and identifies which symbols were modified.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `from_ref` - Starting commit/branch (e.g., "main", "HEAD~1")
+ * * `to_ref` - Ending commit/branch (e.g., "HEAD", "feature-branch")
+ *
+ * # Returns
+ * Array of symbols that were modified in the diff
+ *
+ * # Example
+ * ```javascript
+ * const { getChangedSymbols, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const changed = getChangedSymbols('./my-repo', 'main', 'HEAD');
+ * console.log(`${changed.length} symbols were modified`);
+ * for (const s of changed) {
+ *   console.log(`  ${s.kind}: ${s.name} in ${s.file}`);
+ * }
+ * ```
+ */
+export declare function getChangedSymbols(path: string, fromRef: string, toRef: string): Array<SymbolInfo>
+/**
+ * Get test files related to a source file
+ *
+ * Finds test files that:
+ * 1. Import the specified file
+ * 2. Match common test naming conventions
+ *
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `file_path` - Relative path to the source file
+ *
+ * # Returns
+ * Array of test file paths related to the source file
+ *
+ * # Example
+ * ```javascript
+ * const { getTestsForFile, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const tests = getTestsForFile('./my-repo', 'src/auth.ts');
+ * console.log(`Found ${tests.length} test files for auth.ts`);
+ * ```
+ */
+export declare function getTestsForFile(path: string, filePath: string): Array<string>
+/**
+ * Get call sites where a symbol is called
+ *
+ * Returns the locations where a function/method is called, with exact line numbers.
+ * Requires an index to be built first (use `buildIndex`).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find call sites for
+ *
+ * # Returns
+ * Array of call sites with caller information and line numbers
+ *
+ * # Example
+ * ```javascript
+ * const { getCallSites, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const callSites = getCallSites('./my-repo', 'authenticate');
+ * console.log(`authenticate is called from ${callSites.length} locations`);
+ * ```
+ */
+export declare function getCallSites(path?: string | undefined | null, symbolName?: string | undefined | null): Array<CallSite>
+/**
+ * Get symbols that were changed in a diff with filtering and change type
+ *
+ * Enhanced version with filtering by symbol kind and change type detection.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `from_ref` - Starting commit/branch
+ * * `to_ref` - Ending commit/branch
+ * * `filter` - Optional filter for symbol kinds
+ *
+ * # Returns
+ * Array of symbols with change type
+ *
+ * # Example
+ * ```javascript
+ * const { getChangedSymbolsFiltered, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const changed = getChangedSymbolsFiltered('./my-repo', 'main', 'HEAD', {
+ *   kinds: ['function', 'method']
+ * });
+ * ```
+ */
+export declare function getChangedSymbolsFiltered(path: string, fromRef: string, toRef: string, filter?: ChangedSymbolsFilter | undefined | null): Array<ChangedSymbolInfo>
+/**
+ * Get all functions that eventually call a symbol
+ *
+ * Traverses the call graph to find all direct and indirect callers.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find callers for
+ * * `options` - Optional query options
+ *
+ * # Returns
+ * Array of callers with their depth and call path
+ *
+ * # Example
+ * ```javascript
+ * const { getTransitiveCallers, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const callers = getTransitiveCallers('./my-repo', 'validateInput', { maxDepth: 3 });
+ * ```
+ */
+export declare function getTransitiveCallers(path?: string | undefined | null, symbolName?: string | undefined | null, options?: TransitiveCallersOptions | undefined | null): Array<TransitiveCallerInfo>
+/**
+ * Get call sites with surrounding code context
+ *
+ * Enhanced version that includes the surrounding code for each call site.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `symbol_name` - Name of the symbol to find call sites for
+ * * `options` - Optional context options
+ *
+ * # Returns
+ * Array of call sites with code context
+ *
+ * # Example
+ * ```javascript
+ * const { getCallSitesWithContext, buildIndex } = require('infiniloom-node');
+ *
+ * buildIndex('./my-repo');
+ * const sites = getCallSitesWithContext('./my-repo', 'authenticate', {
+ *   linesBefore: 5,
+ *   linesAfter: 5
+ * });
+ * ```
+ */
+export declare function getCallSitesWithContext(path?: string | undefined | null, symbolName?: string | undefined | null, options?: CallSitesContextOptions | undefined | null): Array<CallSiteWithContext>
+/** Async version of getSymbolsInFile */
+export declare function getSymbolsInFileAsync(path: string, filePath: string, filter?: SymbolFilter | undefined | null): Promise<Array<SymbolInfo>>
+/** Async version of getSymbolSource */
+export declare function getSymbolSourceAsync(path?: string | undefined | null, symbolName?: string | undefined | null, filePath?: string | undefined | null): Promise<SymbolSourceResult>
+/** Async version of getChangedSymbols */
+export declare function getChangedSymbolsAsync(path: string, fromRef: string, toRef: string): Promise<Array<SymbolInfo>>
+/** Async version of getTestsForFile */
+export declare function getTestsForFileAsync(path: string, filePath: string): Promise<Array<string>>
+/** Async version of getCallSites */
+export declare function getCallSitesAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<CallSite>>
+/** Async version of getChangedSymbolsFiltered */
+export declare function getChangedSymbolsFilteredAsync(path: string, fromRef: string, toRef: string, filter?: ChangedSymbolsFilter | undefined | null): Promise<Array<ChangedSymbolInfo>>
+/** Async version of getTransitiveCallers */
+export declare function getTransitiveCallersAsync(path?: string | undefined | null, symbolName?: string | undefined | null, options?: TransitiveCallersOptions | undefined | null): Promise<Array<TransitiveCallerInfo>>
+/** Async version of getCallSitesWithContext */
+export declare function getCallSitesWithContextAsync(path?: string | undefined | null, symbolName?: string | undefined | null, options?: CallSitesContextOptions | undefined | null): Promise<Array<CallSiteWithContext>>
+/**
+ * Get context-aware diff with surrounding symbols and dependencies
+ *
+ * Unlike basic diffFiles, this provides semantic context around changes.
+ * Requires an index (will build on-the-fly if not present).
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `from_ref` - Starting commit/branch (use "" for unstaged changes)
+ * * `to_ref` - Ending commit/branch (use "HEAD" for staged, "" for working tree)
+ * * `options` - Optional context options
+ *
+ * # Returns
+ * Context-aware diff result with related symbols
+ *
+ * # Example
+ * ```javascript
+ * const { getDiffContext } = require('infiniloom-node');
+ *
+ * // Get context for last commit
+ * const context = getDiffContext('./my-repo', 'HEAD~1', 'HEAD', {
+ *   depth: 2,
+ *   budget: 50000,
+ *   includeDiff: true
+ * });
+ *
+ * console.log(`Changed: ${context.changedFiles.length} files`);
+ * console.log(`Related symbols: ${context.contextSymbols.length}`);
+ * console.log(`Related tests: ${context.relatedTests.length}`);
+ * ```
+ */
+export declare function getDiffContext(path: string, fromRef: string, toRef: string, options?: DiffContextOptions | undefined | null): DiffContextResult
+/**
+ * Analyze the impact of changes to files or symbols
+ *
+ * Requires an index to be built first (use buildIndex).
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `from_ref` - Starting commit/branch (use "" for unstaged changes)
- * * `to_ref` - Ending commit/branch (use "HEAD" for staged, "" for working tree)
- * * `options` - Optional context options
+ * * `files` - Files to analyze (can be paths or globs)
+ * * `options` - Optional analysis options
  *
  * # Returns
- * Context-aware diff result with related symbols
+ * Impact analysis result
  *
  * # Example
  * ```javascript
- * const { getDiffContext } = require('infiniloom-node');
+ * const { buildIndex, analyzeImpact } = require('infiniloom-node');
  *
- * // Get context for last commit
- * const context = getDiffContext('./my-repo', 'HEAD~1', 'HEAD', {
- *   depth: 2,
- *   budget: 50000,
- *   includeDiff: true
- * });
+ * // Build index first
+ * buildIndex('./my-repo');
  *
- * console.log(`Changed: ${context.changedFiles.length} files`);
- * console.log(`Related symbols: ${context.contextSymbols.length}`);
- * console.log(`Related tests: ${context.relatedTests.length}`);
+ * // Analyze impact of changes
+ * const impact = analyzeImpact('./my-repo', ['src/auth.ts']);
+ * console.log(`Impact level: ${impact.impactLevel}`);
+ * console.log(`Affected files: ${impact.dependentFiles.length}`);
  * ```
  */
-export declare function getDiffContext(path: string, fromRef: string, toRef: string, options?: DiffContextOptions | undefined | null): DiffContextResult
+export declare function analyzeImpact(path: string, files: Array<string>, options?: ImpactOptions | undefined | null): ImpactResult
 /**
- * Async version of pack
+ * Generate embedding chunks for a repository
+ *
+ * Creates deterministic, content-addressable code chunks optimized for vector databases.
+ * Uses manifest-based diffing for incremental updates.
+ *
+ * # Arguments
+ * * `path` - Path to repository root (default: current directory)
+ * * `options` - Optional embedding options
+ *
+ * # Returns
+ * Embedding result with chunks and optional diff summary
  *
  * # Example
  * ```javascript
- * const { packAsync } = require('infiniloom-node');
+ * const { embed } = require('infiniloom-node');
+ *
+ * const result = embed('./my-repo', {
+ *   maxTokens: 1000,
+ *   securityScan: true,
+ *   diffOnly: false
+ * });
  *
- * const context = await packAsync('./my-repo', { format: 'xml' });
+ * console.log(`Generated ${result.chunks.length} chunks`);
+ * for (const chunk of result.chunks) {
+ *   console.log(`${chunk.id}: ${chunk.source.symbol} (${chunk.tokens} tokens)`);
+ * }
  * ```
  */
-export declare function packAsync(path?: string | undefined | null, options?: PackOptions | undefined | null): Promise<string>
+export declare function embed(path?: string | undefined | null, options?: EmbedOptions | undefined | null): EmbedResult
 /**
- * Async version of scan
+ * Async version of embed
+ *
+ * Generate embedding chunks asynchronously, useful for Node.js applications
+ * that want to avoid blocking the event loop.
  *
  * # Example
  * ```javascript
- * const { scanAsync } = require('infiniloom-node');
+ * const { embedAsync } = require('infiniloom-node');
  *
- * const stats = await scanAsync('./my-repo', 'claude');
+ * const result = await embedAsync('./my-repo', {
+ *   maxTokens: 1000,
+ *   diffOnly: true
+ * });
  * ```
  */
-export declare function scanAsync(path?: string | undefined | null, model?: string | undefined | null): Promise<ScanStats>
+export declare function embedAsync(path?: string | undefined | null, options?: EmbedOptions | undefined | null): Promise<EmbedResult>
 /**
- * Async version of buildIndex
+ * Load and inspect an embedding manifest
+ *
+ * Returns status information about an existing manifest file.
+ *
+ * # Arguments
+ * * `path` - Path to repository or manifest file
+ *
+ * # Returns
+ * Manifest status information
  *
  * # Example
  * ```javascript
- * const { buildIndexAsync } = require('infiniloom-node');
+ * const { loadEmbedManifest } = require('infiniloom-node');
  *
- * const status = await buildIndexAsync('./my-repo', { force: true });
+ * const status = loadEmbedManifest('./my-repo');
+ * if (status.exists) {
+ *   console.log(`Manifest has ${status.chunkCount} chunks`);
+ * }
  * ```
  */
-export declare function buildIndexAsync(path?: string | undefined | null, options?: IndexOptions | undefined | null): Promise<IndexStatus>
+export declare function loadEmbedManifest(path?: string | undefined | null): EmbedManifestStatus
+/** Async version of loadEmbedManifest */
+export declare function loadEmbedManifestAsync(path?: string | undefined | null): Promise<EmbedManifestStatus>
 /**
- * Async version of chunk
+ * Delete an embedding manifest
+ *
+ * Removes the manifest file to force a full rebuild on next embed.
+ *
+ * # Arguments
+ * * `path` - Path to repository or manifest file
+ *
+ * # Returns
+ * true if manifest was deleted, false if it didn't exist
  *
  * # Example
  * ```javascript
- * const { chunkAsync } = require('infiniloom-node');
+ * const { deleteEmbedManifest } = require('infiniloom-node');
  *
- * const chunks = await chunkAsync('./large-repo', { maxTokens: 50000 });
+ * const deleted = deleteEmbedManifest('./my-repo');
+ * console.log(deleted ? 'Manifest deleted' : 'No manifest found');
  * ```
  */
-export declare function chunkAsync(path?: string | undefined | null, options?: ChunkOptions | undefined | null): Promise<Array<RepoChunk>>
+export declare function deleteEmbedManifest(path?: string | undefined | null): boolean
+/** Async version of deleteEmbedManifest */
+export declare function deleteEmbedManifestAsync(path?: string | undefined | null): Promise<boolean>
+/** Type information for Node.js */
+export interface JsTypeInfo {
+  name: string
+  genericArgs: Array<JsTypeInfo>
+  isNullable: boolean
+  isReference: boolean
+  isMutable: boolean
+  arrayDimensions: number
+  unionTypes: Array<JsTypeInfo>
+}
+/** Parameter information for Node.js */
+export interface JsParameterInfo {
+  name: string
+  typeInfo?: JsTypeInfo
+  isOptional: boolean
+  defaultValue?: string
+  isVariadic: boolean
+  kind: string
+}
+/** Generic parameter for Node.js */
+export interface JsGenericParam {
+  name: string
+  constraints: Array<string>
+  defaultType?: string
+  variance: string
+}
+/** Full type signature for Node.js */
+export interface JsTypeSignature {
+  parameters: Array<JsParameterInfo>
+  returnType?: JsTypeInfo
+  generics: Array<JsGenericParam>
+  throws: Array<string>
+  isAsync: boolean
+  isGenerator: boolean
+  receiver?: string
+}
+/** Parameter documentation */
+export interface JsParamDoc {
+  name: string
+  typeInfo?: string
+  description?: string
+  isOptional: boolean
+  defaultValue?: string
+}
+/** Return documentation */
+export interface JsReturnDoc {
+  typeInfo?: string
+  description?: string
+}
+/** Exception documentation */
+export interface JsThrowsDoc {
+  exceptionType: string
+  description?: string
+}
+/** Code example */
+export interface JsExample {
+  title?: string
+  code: string
+  language?: string
+  expectedOutput?: string
+}
+/** Structured documentation */
+export interface JsDocumentation {
+  summary?: string
+  description?: string
+  params: Array<JsParamDoc>
+  returns?: JsReturnDoc
+  throws: Array<JsThrowsDoc>
+  examples: Array<JsExample>
+  tags: Record<string, Array<string>>
+  isDeprecated: boolean
+  deprecationMessage?: string
+  raw?: string
+}
+/** Ancestor information */
+export interface JsAncestorInfo {
+  name: string
+  kind: string
+  depth: number
+  filePath?: string
+}
+/** Type hierarchy */
+export interface JsTypeHierarchy {
+  symbolName: string
+  extends?: string
+  implements: Array<string>
+  ancestors: Array<JsAncestorInfo>
+  descendants: Array<string>
+  mixins: Array<string>
+}
+/** Halstead metrics */
+export interface JsHalsteadMetrics {
+  distinctOperators: number
+  distinctOperands: number
+  totalOperators: number
+  totalOperands: number
+  vocabulary: number
+  length: number
+  calculatedLength: number
+  volume: number
+  difficulty: number
+  effort: number
+  time: number
+  bugs: number
+}
+/** Lines of code metrics */
+export interface JsLocMetrics {
+  total: number
+  source: number
+  comments: number
+  blank: number
+}
+/** Code complexity metrics */
+export interface JsComplexityMetrics {
+  cyclomatic: number
+  cognitive: number
+  halstead?: JsHalsteadMetrics
+  loc: JsLocMetrics
+  maintainabilityIndex?: number
+  maxNestingDepth: number
+  parameterCount: number
+  returnCount: number
+}
+/** Unused export */
+export interface JsUnusedExport {
+  name: string
+  kind: string
+  filePath: string
+  line: number
+  confidence: number
+  reason: string
+}
+/** Unreachable code */
+export interface JsUnreachableCode {
+  filePath: string
+  startLine: number
+  endLine: number
+  snippet: string
+  reason: string
+}
+/** Unused symbol */
+export interface JsUnusedSymbol {
+  name: string
+  kind: string
+  filePath: string
+  line: number
+}
+/** Unused import */
+export interface JsUnusedImport {
+  name: string
+  importPath: string
+  filePath: string
+  line: number
+}
+/** Unused variable */
+export interface JsUnusedVariable {
+  name: string
+  filePath: string
+  line: number
+  scope?: string
+}
+/** Dead code detection result */
+export interface JsDeadCodeInfo {
+  unusedExports: Array<JsUnusedExport>
+  unreachableCode: Array<JsUnreachableCode>
+  unusedPrivate: Array<JsUnusedSymbol>
+  unusedImports: Array<JsUnusedImport>
+  unusedVariables: Array<JsUnusedVariable>
+}
+/** Breaking change */
+export interface JsBreakingChange {
+  changeType: string
+  symbolName: string
+  symbolKind: string
+  filePath: string
+  line?: number
+  oldSignature?: string
+  newSignature?: string
+  description: string
+  severity: string
+  migrationHint?: string
+}
+/** Breaking change summary */
+export interface JsBreakingChangeSummary {
+  total: number
+  critical: number
+  high: number
+  medium: number
+  low: number
+  filesAffected: number
+  symbolsAffected: number
+}
+/** Breaking change report */
+export interface JsBreakingChangeReport {
+  oldRef: string
+  newRef: string
+  changes: Array<JsBreakingChange>
+  summary: JsBreakingChangeSummary
+}
+/** Repository entry */
+export interface JsRepoEntry {
+  id: string
+  name: string
+  path: string
+  commit?: string
+  fileCount: number
+  symbolCount: number
+  indexedAt?: number
+}
+/** Cross-repo link */
+export interface JsCrossRepoLink {
+  sourceRepo: string
+  sourceFile: string
+  sourceSymbol?: string
+  sourceLine: number
+  targetRepo: string
+  targetSymbol: string
+  linkType: string
+}
+/** Unified symbol reference */
+export interface JsUnifiedSymbolRef {
+  repoId: string
+  filePath: string
+  line: number
+  kind: string
+  qualifiedName?: string
+}
+/** Multi-repo index stats */
+export interface JsMultiRepoStats {
+  totalRepos: number
+  totalSymbols: number
+  totalCrossRepoLinks: number
+  symbolsPerRepo: Record<string, number>
+}
+/** Options for documentation extraction */
+export interface ExtractDocOptions {
+  /** The programming language (e.g., "javascript", "python", "rust") */
+  language: string
+}
+/** Options for complexity calculation */
+export interface ComplexityOptions {
+  /** The programming language */
+  language: string
+}
+/** Options for dead code detection */
+export interface DeadCodeOptions {
+  /** Paths to analyze (default: current directory) */
+  paths?: Array<string>
+  /** Languages to include */
+  languages?: Array<string>
+}
+/** Options for breaking change detection */
+export interface BreakingChangeOptions {
+  /** Old version reference (git ref, tag, or branch) */
+  oldRef: string
+  /** New version reference */
+  newRef: string
+}
+/** Options for multi-repo indexing */
+export interface MultiRepoOptions {
+  /** Repository paths to index */
+  repositories: Array<MultiRepoEntry>
+}
+/** Repository entry for multi-repo indexing */
+export interface MultiRepoEntry {
+  id: string
+  name: string
+  path: string
+}
 /**
- * Async version of analyzeImpact
+ * Extract documentation from a docstring/comment
+ *
+ * Parses JSDoc, Python docstrings, Rust doc comments, etc. into structured format.
+ *
+ * # Arguments
+ * * `raw_doc` - The raw docstring or comment text
+ * * `options` - Options including the language
+ *
+ * # Returns
+ * Structured documentation object
  *
  * # Example
  * ```javascript
- * const { analyzeImpactAsync } = require('infiniloom-node');
+ * const { extractDocumentation } = require('infiniloom-node');
  *
- * const impact = await analyzeImpactAsync('./my-repo', ['src/auth.ts']);
+ * const doc = extractDocumentation(`/**
+ *  * Add two numbers together.
+ *  * @param {number} a - First number
+ *  * @param {number} b - Second number
+ *  * @returns {number} The sum
+ *  */`, { language: 'javascript' });
+ *
+ * console.log(doc.summary); // "Add two numbers together."
+ * console.log(doc.params); // [{name: 'a', ...}, {name: 'b', ...}]
  * ```
  */
-export declare function analyzeImpactAsync(path: string, files: Array<string>, options?: ImpactOptions | undefined | null): Promise<ImpactResult>
+export declare function extractDocumentation(rawDoc: string, options: ExtractDocOptions): JsDocumentation
+/** Async version of extractDocumentation */
+export declare function extractDocumentationAsync(rawDoc: string, options: ExtractDocOptions): Promise<JsDocumentation>
 /**
- * Async version of getDiffContext
+ * Detect dead code in a repository
+ *
+ * Analyzes the codebase to find unused exports, unreachable code,
+ * unused imports, and unused variables.
+ *
+ * # Arguments
+ * * `path` - Path to repository root
+ * * `options` - Dead code detection options
+ *
+ * # Returns
+ * Dead code analysis result
  *
  * # Example
  * ```javascript
- * const { getDiffContextAsync } = require('infiniloom-node');
+ * const { detectDeadCode } = require('infiniloom-node');
  *
- * const context = await getDiffContextAsync('./my-repo', 'HEAD~1', 'HEAD');
+ * const deadCode = detectDeadCode('./my-repo');
+ * console.log(`Found ${deadCode.unusedExports.length} unused exports`);
  * ```
  */
-export declare function getDiffContextAsync(path: string, fromRef: string, toRef: string, options?: DiffContextOptions | undefined | null): Promise<DiffContextResult>
-/** Options for filtering symbols */
-export interface SymbolFilter {
-  /** Filter by symbol kind: "function", "class", "method", etc. */
-  kind?: string
-  /** Filter by visibility: "public", "private", "protected" */
-  visibility?: string
-}
-/** A call site where a symbol is called */
-export interface CallSite {
-  /** Name of the calling function/method */
-  caller: string
-  /** Name of the function/method being called */
-  callee: string
-  /** File containing the call */
-  file: string
-  /** Line number of the call (1-indexed) */
-  line: number
-  /** Column number of the call (0-indexed, if available) */
-  column?: number
-  /** Caller symbol ID */
-  callerId: number
-  /** Callee symbol ID */
-  calleeId: number
-}
+export declare function detectDeadCode(path: string, options?: DeadCodeOptions | undefined | null): JsDeadCodeInfo
+/** Async version of detectDeadCode */
+export declare function detectDeadCodeAsync(path: string, options?: DeadCodeOptions | undefined | null): Promise<JsDeadCodeInfo>
 /**
- * Get all symbols in a specific file
+ * Detect breaking changes between two versions
  *
- * Requires an index to be built first (use `buildIndex`).
+ * Compares public API symbols between two git refs to identify
+ * breaking changes like removed functions, changed signatures, etc.
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `file_path` - Relative path to the file within the repository
- * * `filter` - Optional filter for symbol kind/visibility
+ * * `options` - Breaking change detection options
  *
  * # Returns
- * Array of symbols defined in the file
+ * Breaking change report
  *
  * # Example
  * ```javascript
- * const { getSymbolsInFile, buildIndex } = require('infiniloom-node');
+ * const { detectBreakingChanges } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const symbols = getSymbolsInFile('./my-repo', 'src/auth.ts');
- * console.log(`Found ${symbols.length} symbols in auth.ts`);
- * for (const s of symbols) {
- *   console.log(`  ${s.kind}: ${s.name} at line ${s.line}`);
+ * const report = detectBreakingChanges('./my-repo', {
+ *   oldRef: 'v1.0.0',
+ *   newRef: 'v2.0.0'
+ * });
+ *
+ * console.log(`Found ${report.summary.total} breaking changes`);
+ * for (const change of report.changes) {
+ *   console.log(`${change.severity}: ${change.description}`);
  * }
  * ```
  */
-export declare function getSymbolsInFile(path: string, filePath: string, filter?: SymbolFilter | undefined | null): Array<SymbolInfo>
+export declare function detectBreakingChanges(path: string, options: BreakingChangeOptions): JsBreakingChangeReport
+/** Async version of detectBreakingChanges */
+export declare function detectBreakingChangesAsync(path: string, options: BreakingChangeOptions): Promise<JsBreakingChangeReport>
 /**
- * Get the source code of a symbol
+ * Get the package version
  *
- * Reads the file and extracts the source code for the specified symbol.
- * Requires an index to be built first (use `buildIndex`).
+ * # Returns
+ * The version string of the infiniloom-node package
+ *
+ * # Example
+ * ```javascript
+ * const { version } = require('infiniloom-node');
+ *
+ * console.log(`infiniloom-node v${version()}`);
+ * ```
+ */
+export declare function version(): string
+/**
+ * Async version of pack
+ *
+ * Pack a repository into optimized LLM context asynchronously.
+ * This is useful for Node.js applications that want to avoid blocking
+ * the event loop during repository scanning.
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `symbol_name` - Name of the symbol to get source for
- * * `file_path` - Optional file path to disambiguate when multiple symbols have the same name
+ * * `options` - Optional packing options
  *
  * # Returns
- * Source code of the symbol (or the first matching symbol if multiple exist)
+ * Formatted repository context as a string
  *
  * # Example
  * ```javascript
- * const { getSymbolSource, buildIndex } = require('infiniloom-node');
+ * const { packAsync } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const result = getSymbolSource('./my-repo', 'authenticate', 'src/auth.ts');
- * console.log(`Source at ${result.path}:${result.startLine}`);
- * console.log(result.source);
+ * const context = await packAsync('./my-repo', {
+ *   format: 'xml',
+ *   model: 'claude',
+ *   compression: 'balanced'
+ * });
  * ```
  */
-export declare function getSymbolSource(path?: string | undefined | null, symbolName?: string | undefined | null, filePath?: string | undefined | null): SymbolSourceResult
+export declare function packAsync(path?: string | undefined | null, options?: PackOptions | undefined | null): Promise<string>
 /**
- * Get symbols that were changed in a diff
+ * Async version of scan
  *
- * Parses the diff between two refs and identifies which symbols were modified.
- * Requires an index to be built first (use `buildIndex`).
+ * Scan a repository and return statistics asynchronously.
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `from_ref` - Starting commit/branch (e.g., "main", "HEAD~1")
- * * `to_ref` - Ending commit/branch (e.g., "HEAD", "feature-branch")
+ * * `model` - Optional tokenizer model
  *
  * # Returns
- * Array of symbols that were modified in the diff
+ * Repository statistics
  *
  * # Example
  * ```javascript
- * const { getChangedSymbols, buildIndex } = require('infiniloom-node');
+ * const { scanAsync } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const changed = getChangedSymbols('./my-repo', 'main', 'HEAD');
- * console.log(`${changed.length} symbols were modified`);
- * for (const s of changed) {
- *   console.log(`  ${s.kind}: ${s.name} in ${s.file}`);
- * }
+ * const stats = await scanAsync('./my-repo', 'claude');
+ * console.log(`Total tokens: ${stats.totalTokens}`);
  * ```
  */
-export declare function getChangedSymbols(path: string, fromRef: string, toRef: string): Array<SymbolInfo>
+export declare function scanAsync(path?: string | undefined | null, model?: string | undefined | null): Promise<ScanStats>
 /**
- * Get test files related to a source file
- *
- * Finds test files that:
- * 1. Import the specified file
- * 2. Match common test naming conventions (e.g., foo.ts -> foo.test.ts, test_foo.py)
+ * Async version of buildIndex
  *
- * Requires an index to be built first (use `buildIndex`).
+ * Build a symbol index for fast diff context analysis asynchronously.
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `file_path` - Relative path to the source file
+ * * `options` - Optional index build options
  *
  * # Returns
- * Array of test file paths related to the source file
+ * Index status
  *
  * # Example
  * ```javascript
- * const { getTestsForFile, buildIndex } = require('infiniloom-node');
- *
- * buildIndex('./my-repo');
- * const tests = getTestsForFile('./my-repo', 'src/auth.ts');
- * console.log(`Found ${tests.length} test files for auth.ts`);
- * for (const t of tests) {
- *   console.log(`  ${t}`);
- * }
+ * const { buildIndexAsync } = require('infiniloom-node');
+ *
+ * const status = await buildIndexAsync('./my-repo', { force: false });
+ * console.log(`Indexed ${status.totalFiles} files`);
  * ```
  */
-export declare function getTestsForFile(path: string, filePath: string): Array<string>
+export declare function buildIndexAsync(path?: string | undefined | null, options?: IndexOptions | undefined | null): Promise<IndexStatus>
 /**
- * Get call sites where a symbol is called
- *
- * Returns the locations where a function/method is called, with exact line numbers.
- * This is useful for PR review tools that need to post inline comments.
- *
- * The function scans the caller's body to find the actual line where the callee is called,
- * rather than just returning the caller's definition line.
+ * Async version of chunk
  *
- * Requires an index to be built first (use `buildIndex`).
+ * Split a repository into semantic chunks asynchronously.
  *
  * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `symbol_name` - Name of the symbol to find call sites for (null/undefined returns error)
+ * * `path` - Path to repository root
+ * * `options` - Optional chunking options
  *
  * # Returns
- * Array of call sites with caller information and line numbers
+ * Array of repository chunks
  *
  * # Example
  * ```javascript
- * const { getCallSites, buildIndex } = require('infiniloom-node');
+ * const { chunkAsync } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const callSites = getCallSites('./my-repo', 'authenticate');
- * console.log(`authenticate is called from ${callSites.length} locations`);
- * for (const site of callSites) {
- *   console.log(`  ${site.caller} in ${site.file}:${site.line}`);
- * }
+ * const chunks = await chunkAsync('./my-repo', {
+ *   strategy: 'module',
+ *   maxTokens: 4000,
+ *   overlap: 500
+ * });
  * ```
  */
-export declare function getCallSites(path?: string | undefined | null, symbolName?: string | undefined | null): Array<CallSite>
-/** Async version of getSymbolsInFile */
-export declare function getSymbolsInFileAsync(path: string, filePath: string, filter?: SymbolFilter | undefined | null): Promise<Array<SymbolInfo>>
-/** Async version of getSymbolSource */
-export declare function getSymbolSourceAsync(path?: string | undefined | null, symbolName?: string | undefined | null, filePath?: string | undefined | null): Promise<SymbolSourceResult>
-/** Async version of getChangedSymbols */
-export declare function getChangedSymbolsAsync(path: string, fromRef: string, toRef: string): Promise<Array<SymbolInfo>>
-/** Async version of getTestsForFile */
-export declare function getTestsForFileAsync(path: string, filePath: string): Promise<Array<string>>
-/** Async version of getCallSites */
-export declare function getCallSitesAsync(path?: string | undefined | null, symbolName?: string | undefined | null): Promise<Array<CallSite>>
-/** Options for filtering changed symbols (Feature #6) */
-export interface ChangedSymbolsFilter {
-  /**
-   * Filter by symbol kinds: "function", "method", "class", etc.
-   * If specified, only symbols of these kinds are returned.
-   */
-  kinds?: Array<string>
-  /** Exclude specific kinds (e.g., exclude "import" to skip import statements) */
-  excludeKinds?: Array<string>
-}
-/** A symbol with change type information (Feature #7) */
-export interface ChangedSymbolInfo {
-  /** Symbol ID */
-  id: number
-  /** Symbol name */
-  name: string
-  /** Symbol kind (function, class, method, etc.) */
-  kind: string
-  /** File path containing the symbol */
-  file: string
-  /** Start line number */
-  line: number
-  /** End line number */
-  endLine: number
-  /** Function/method signature */
-  signature?: string
-  /** Visibility (public, private, etc.) */
-  visibility: string
-  /** Change type: "added", "modified", or "deleted" */
-  changeType: string
-}
+export declare function chunkAsync(path?: string | undefined | null, options?: ChunkOptions | undefined | null): Promise<Array<RepoChunk>>
 /**
- * Get symbols that were changed in a diff with filtering and change type (Features #6 & #7)
+ * Async version of analyzeImpact
  *
- * Enhanced version of getChangedSymbols that supports filtering by symbol kind
- * and returns change type (added, modified, deleted) for each symbol.
+ * Analyze the impact of file changes asynchronously.
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `from_ref` - Starting commit/branch (e.g., "main", "HEAD~1")
- * * `to_ref` - Ending commit/branch (e.g., "HEAD", "feature-branch")
- * * `filter` - Optional filter for symbol kinds
+ * * `files` - List of changed file paths
+ * * `options` - Optional impact analysis options
  *
  * # Returns
- * Array of symbols with change type that were modified in the diff
+ * Impact analysis result
  *
  * # Example
  * ```javascript
- * const { getChangedSymbolsFiltered, buildIndex } = require('infiniloom-node');
+ * const { analyzeImpactAsync } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const changed = getChangedSymbolsFiltered('./my-repo', 'main', 'HEAD', {
- *   kinds: ['function', 'method'],  // Only functions and methods
- *   excludeKinds: ['import']         // Skip import statements
+ * const impact = await analyzeImpactAsync('./my-repo', ['src/auth.rs'], {
+ *   depth: 2
  * });
- * for (const s of changed) {
- *   console.log(`${s.changeType}: ${s.kind} ${s.name} in ${s.file}`);
- * }
  * ```
  */
-export declare function getChangedSymbolsFiltered(path: string, fromRef: string, toRef: string, filter?: ChangedSymbolsFilter | undefined | null): Array<ChangedSymbolInfo>
-/** A caller in the transitive call chain (Feature #8) */
-export interface TransitiveCallerInfo {
-  /** Symbol name */
-  name: string
-  /** Symbol kind */
-  kind: string
-  /** File path */
-  file: string
-  /** Line number */
-  line: number
-  /** Depth from the target symbol (1 = direct caller, 2 = caller of caller, etc.) */
-  depth: number
-  /** Call path from this caller to the target (e.g., ["main", "process", "validate", "target"]) */
-  callPath: Array<string>
-}
-/** Options for transitive callers query */
-export interface TransitiveCallersOptions {
-  /** Maximum depth to traverse (default: 3) */
-  maxDepth?: number
-  /** Maximum number of results (default: 100) */
-  maxResults?: number
-}
+export declare function analyzeImpactAsync(path: string, files: Array<string>, options?: ImpactOptions | undefined | null): Promise<ImpactResult>
 /**
- * Get all functions that eventually call a symbol (Feature #8)
+ * Async version of getDiffContext
  *
- * Traverses the call graph to find all direct and indirect callers
- * of the specified symbol, up to a maximum depth.
+ * Get context-aware diff with surrounding symbols and dependencies asynchronously.
  *
  * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `symbol_name` - Name of the symbol to find callers for (null/undefined returns error)
- * * `options` - Optional query options
+ * * `path` - Path to repository root
+ * * `from_ref` - Starting commit/branch
+ * * `to_ref` - Ending commit/branch
+ * * `options` - Optional diff context options
  *
  * # Returns
- * Array of callers with their depth and call path
+ * Diff context result
  *
  * # Example
  * ```javascript
- * const { getTransitiveCallers, buildIndex } = require('infiniloom-node');
+ * const { getDiffContextAsync } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const callers = getTransitiveCallers('./my-repo', 'validateInput', { maxDepth: 3 });
- * for (const c of callers) {
- *   console.log(`Depth ${c.depth}: ${c.name} -> ${c.callPath.join(' -> ')}`);
- * }
+ * const context = await getDiffContextAsync('./my-repo', 'HEAD~1', 'HEAD', {
+ *   depth: 2,
+ *   budget: 50000
+ * });
  * ```
  */
-export declare function getTransitiveCallers(path?: string | undefined | null, symbolName?: string | undefined | null, options?: TransitiveCallersOptions | undefined | null): Array<TransitiveCallerInfo>
-/** A call site with surrounding context (Feature #9) */
-export interface CallSiteWithContext {
-  /** Name of the calling function/method */
-  caller: string
-  /** Name of the function/method being called */
-  callee: string
-  /** File containing the call */
-  file: string
-  /** Line number of the call (1-indexed) */
-  line: number
-  /** Column number of the call (0-indexed, if available) */
-  column?: number
-  /** Caller symbol ID */
-  callerId: number
-  /** Callee symbol ID */
-  calleeId: number
-  /** Code context around the call site (configurable number of lines) */
-  context?: string
-  /** Start line of context */
-  contextStartLine?: number
-  /** End line of context */
-  contextEndLine?: number
-}
-/** Options for call sites with context */
-export interface CallSitesContextOptions {
-  /** Number of lines of context before the call (default: 3) */
-  linesBefore?: number
-  /** Number of lines of context after the call (default: 3) */
-  linesAfter?: number
-}
+export declare function getDiffContextAsync(path: string, fromRef: string, toRef: string, options?: DiffContextOptions | undefined | null): Promise<DiffContextResult>
 /**
- * Get call sites with surrounding code context (Feature #9)
+ * Compress text using semantic compression
  *
- * Enhanced version of getCallSites that includes the surrounding code
- * for each call site, useful for AI-powered code review.
+ * Uses heuristic-based compression to reduce text size while preserving
+ * semantic meaning. This is a simplified version that doesn't require embeddings.
  *
  * # Arguments
- * * `path` - Path to repository root (null/undefined returns error)
- * * `symbol_name` - Name of the symbol to find call sites for (null/undefined returns error)
- * * `options` - Optional context options
+ * * `text` - Text to compress
+ * * `options` - Optional compression options
  *
  * # Returns
- * Array of call sites with code context
+ * Compressed text
  *
  * # Example
  * ```javascript
- * const { getCallSitesWithContext, buildIndex } = require('infiniloom-node');
+ * const { semanticCompress } = require('infiniloom-node');
  *
- * buildIndex('./my-repo');
- * const sites = getCallSitesWithContext('./my-repo', 'authenticate', {
- *   linesBefore: 5,
- *   linesAfter: 5
+ * const compressed = semanticCompress(longText, {
+ *   budgetRatio: 0.5,
+ *   minChunkSize: 100,
+ *   maxChunkSize: 2000
  * });
- * for (const site of sites) {
- *   console.log(`Call in ${site.file}:${site.line}`);
- *   console.log(site.context);
- * }
  * ```
  */
-export declare function getCallSitesWithContext(path?: string | undefined | null, symbolName?: string | undefined | null, options?: CallSitesContextOptions | undefined | null): Array<CallSiteWithContext>
-/** Async version of getChangedSymbolsFiltered */
-export declare function getChangedSymbolsFilteredAsync(path: string, fromRef: string, toRef: string, filter?: ChangedSymbolsFilter | undefined | null): Promise<Array<ChangedSymbolInfo>>
-/** Async version of getTransitiveCallers */
-export declare function getTransitiveCallersAsync(path?: string | undefined | null, symbolName?: string | undefined | null, options?: TransitiveCallersOptions | undefined | null): Promise<Array<TransitiveCallerInfo>>
-/** Async version of getCallSitesWithContext */
-export declare function getCallSitesWithContextAsync(path?: string | undefined | null, symbolName?: string | undefined | null, options?: CallSitesContextOptions | undefined | null): Promise<Array<CallSiteWithContext>>
-/** Infiniloom class for advanced usage */
-export declare class Infiniloom {
-  /**
-   * Create a new Infiniloom instance
-   *
-   * # Arguments
-   * * `path` - Path to repository root
-   * * `model` - Optional model name (default: "claude")
-   */
-  constructor(path: string, model?: string | undefined | null)
-  /** Get repository statistics (Bug #4 fix - consistent with scan() function) */
-  getStats(): ScanStats
-  /**
-   * Generate a repository map
-   *
-   * # Arguments
-   * * `options` - Options object with budget (default: 2000) and maxSymbols (default: 50)
-   *
-   * # Example
-   * ```javascript
-   * const loom = new Infiniloom('./my-repo');
-   * const map = loom.generateMap({ budget: 3000, maxSymbols: 100 });
-   * ```
-   */
-  generateMap(options?: GenerateMapOptions | undefined | null): string
-  /** Pack repository with specific options */
-  pack(options?: PackOptions | undefined | null): string
-  /** Check for security issues (Bug #8 fix - now returns structured findings) */
-  securityScan(): Array<SecurityFinding>
-  /** Check for security issues (legacy format, returns formatted strings) */
-  securityScanFormatted(): Array<string>
-}
+export declare function semanticCompress(text?: string | undefined | null, options?: SemanticCompressOptions | undefined | null): string
 /**
  * Git repository wrapper for Node.js
  *
@@ -1738,3 +2398,94 @@ export declare class GitRepo {
    */
   stagedHunks(path?: string | undefined | null): Array<GitDiffHunk>
 }
+/**
+ * Object-oriented API for Infiniloom
+ *
+ * Provides a stateful wrapper around the repository scanning and formatting functionality.
+ * Alternative to the functional API for users who prefer an object-oriented style.
+ *
+ * # Example
+ * ```javascript
+ * const { Infiniloom } = require('infiniloom-node');
+ *
+ * const loom = new Infiniloom('./my-repo', 'claude');
+ * const stats = loom.getStats();
+ * const map = loom.generateMap({ budget: 3000, maxSymbols: 100 });
+ * const output = loom.pack({ format: 'xml', compression: 'balanced' });
+ * ```
+ */
+export declare class Infiniloom {
+  /**
+   * Create a new Infiniloom instance
+   *
+   * # Arguments
+   * * `path` - Path to repository root
+   * * `model` - Optional model name (default: "claude")
+   *
+   * # Example
+   * ```javascript
+   * const loom = new Infiniloom('./my-repo', 'gpt4o');
+   * ```
+   */
+  constructor(path: string, model?: string | undefined | null)
+  /**
+   * Get repository statistics
+   *
+   * Returns the same statistics as the `scan()` function.
+   *
+   * # Example
+   * ```javascript
+   * const loom = new Infiniloom('./my-repo');
+   * const stats = loom.getStats();
+   * console.log(`${stats.totalFiles} files, ${stats.totalTokens} tokens`);
+   * ```
+   */
+  getStats(): ScanStats
+  /**
+   * Generate a repository map with ranked symbols
+   *
+   * # Arguments
+   * * `options` - Options object with budget (default: 2000) and maxSymbols (default: 50)
+   *
+   * # Example
+   * ```javascript
+   * const loom = new Infiniloom('./my-repo');
+   * const map = loom.generateMap({ budget: 3000, maxSymbols: 100 });
+   * ```
+   */
+  generateMap(options?: GenerateMapOptions | undefined | null): string
+  /**
+   * Pack repository with specific options
+   *
+   * Formats the repository using the same logic as the `pack()` function,
+   * but operates on the pre-scanned repository stored in this instance.
+   *
+   * # Arguments
+   * * `options` - Pack options (format, compression, etc.)
+   *
+   * # Example
+   * ```javascript
+   * const loom = new Infiniloom('./my-repo');
+   * const output = loom.pack({ format: 'xml', compression: 'balanced' });
+   * ```
+   */
+  pack(options?: PackOptions | undefined | null): string
+  /**
+   * Scan repository for security issues
+   *
+   * Scans the pre-loaded repository files for secrets and sensitive information.
+   *
+   * # Returns
+   * Array of security findings with file, line, severity, kind, and pattern
+   *
+   * # Example
+   * ```javascript
+   * const loom = new Infiniloom('./my-repo');
+   * const findings = loom.securityScan();
+   * for (const finding of findings) {
+   *   console.log(`${finding.severity}: ${finding.kind} in ${finding.file}:${finding.line}`);
+   * }
+   * ```
+   */
+  securityScan(): Array<SecurityFinding>
+}