infiniloom-node 0.6.2 → 0.7.0

package/index.d.ts

@@ -1,2491 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-
-/* auto-generated by NAPI-RS */
-
-/** Options for packing a repository */
-export interface PackOptions {
-  /** Output format: "xml", "markdown", "json", "yaml", "toon", or "plain" */
-  format?: string
-  /** Target model: "claude", "gpt-5.2", "gpt-5.1", "gpt-5", "o4-mini", "o3", "o1", "gpt-4o", "gpt-4", "gemini", "llama", "mistral", "deepseek", "qwen", "cohere", "grok" */
-  model?: string
-  /** Compression level: "none", "minimal", "balanced", "aggressive", "extreme", "focused", "semantic" */
-  compression?: string
-  /** Token budget for repository map */
-  mapBudget?: number
-  /** Maximum number of symbols in map */
-  maxSymbols?: number
-  /** Skip security scanning (fail on critical findings) */
-  skipSecurity?: boolean
-  /** Redact detected secrets in output (default: true) */
-  redactSecrets?: boolean
-  /** Skip symbol extraction for faster scanning */
-  skipSymbols?: boolean
-  /** Glob patterns to include (e.g., ["src/**/*.ts", "lib/**/*.js"]) */
-  include?: Array<string>
-  /** Glob patterns to exclude (e.g., ["**/*.test.ts", "dist/**"]) */
-  exclude?: Array<string>
-  /** Include test files (default: false) */
-  includeTests?: boolean
-  /** Minimum security severity to block on: "critical", "high", "medium", "low" (default: "critical") */
-  securityThreshold?: string
-  /**
-   * Token budget for total output (0 = no limit). Files are included by importance until budget is reached.
-   * Negative values are invalid and will throw an error.
-   */
-  tokenBudget?: number
-  /** Only include files changed in git (requires baseSha or uses uncommitted changes) */
-  changedOnly?: boolean
-  /** Base SHA/ref for diff comparison (e.g., "main", "HEAD~5", commit hash) */
-  baseSha?: string
-  /** Head SHA/ref for diff comparison (default: working tree or HEAD) */
-  headSha?: string
-  /** Include staged changes only (if changedOnly is true and no refs specified) */
-  stagedOnly?: boolean
-  /** Include related files (importers/dependencies of changed files) */
-  includeRelated?: boolean
-  /** Depth for related file traversal (1-3, default: 1) */
-  relatedDepth?: number
-}
-/** Statistics from scanning a repository */
-export interface ScanStats {
-  /** Repository name */
-  name: string
-  /** Total number of files */
-  totalFiles: number
-  /** Total lines of code */
-  totalLines: number
-  /** Total tokens for target model */
-  totalTokens: number
-  /** Primary language */
-  primaryLanguage?: string
-  /** Language breakdown */
-  languages: Array<LanguageStat>
-  /** Number of security findings */
-  securityFindings: number
-}
-/** Statistics for a single language */
-export interface LanguageStat {
-  /** Language name */
-  language: string
-  /** Number of files */
-  files: number
-  /** Total lines */
-  lines: number
-  /** Percentage of codebase */
-  percentage: number
-}
-/** Options for scanning a repository */
-export interface ScanOptions {
-  /** Target model for token counting (default: "claude") */
-  model?: string
-  /** Glob patterns to include (e.g., ["src/**/*.ts", "lib/**/*.js"]) */
-  include?: Array<string>
-  /** Glob patterns to exclude (e.g., ["**/*.test.ts", "dist/**"]) */
-  exclude?: Array<string>
-  /** Include test files (default: false) */
-  includeTests?: boolean
-  /** Apply default ignores for dist/, node_modules/, etc. (default: true) */
-  applyDefaultIgnores?: boolean
-}
-/** File status information */
-export interface GitFileStatus {
-  /** File path */
-  path: string
-  /** Old path (for renames) */
-  oldPath?: string
-  /** Status: "Added", "Modified", "Deleted", "Renamed", "Copied", "Unknown" */
-  status: string
-}
-/** Changed file with diff stats */
-export interface GitChangedFile {
-  /** File path */
-  path: string
-  /** Old path (for renames) */
-  oldPath?: string
-  /** Status: "Added", "Modified", "Deleted", "Renamed", "Copied", "Unknown" */
-  status: string
-  /** Number of lines added */
-  additions: number
-  /** Number of lines deleted */
-  deletions: number
-}
-/** Commit information */
-export interface GitCommit {
-  /** Full commit hash */
-  hash: string
-  /** Short commit hash (7 characters) */
-  shortHash: string
-  /** Author name */
-  author: string
-  /** Author email */
-  email: string
-  /** Commit date (ISO 8601 format) */
-  date: string
-  /** Commit message (first line) */
-  message: string
-}
-/** Blame line information */
-export interface GitBlameLine {
-  /** Commit hash that introduced the line */
-  commit: string
-  /** Author who wrote the line */
-  author: string
-  /** Date when line was written */
-  date: string
-  /** Line number (1-indexed) */
-  lineNumber: number
-}
-/** A single line change within a diff hunk */
-export interface GitDiffLine {
-  /** Type of change: "add", "remove", or "context" */
-  changeType: string
-  /** Line number in the old file (null for additions) */
-  oldLine?: number
-  /** Line number in the new file (null for deletions) */
-  newLine?: number
-  /** The actual line content (without +/- prefix) */
-  content: string
-}
-/** A diff hunk representing a contiguous block of changes */
-export interface GitDiffHunk {
-  /** Starting line in the old file */
-  oldStart: number
-  /** Number of lines in the old file section */
-  oldCount: number
-  /** Starting line in the new file */
-  newStart: number
-  /** Number of lines in the new file section */
-  newCount: number
-  /** Header line (e.g., "@@ -1,5 +1,7 @@ function name") */
-  header: string
-  /** Individual line changes within this hunk */
-  lines: Array<GitDiffLine>
-}
-export interface SecurityFinding {
-  /** File where the finding was detected */
-  file: string
-  /** Line number (1-indexed) */
-  line: number
-  /** Severity level: "Critical", "High", "Medium", "Low", "Info" */
-  severity: string
-  /** Type of finding */
-  kind: string
-  /** Matched pattern */
-  pattern: string
-}
-/** Options for building an index */
-export interface IndexOptions {
-  /** Force full rebuild even if index exists */
-  force?: boolean
-  /** Include test files in index */
-  includeTests?: boolean
-  /** Maximum file size to index (bytes) */
-  maxFileSize?: number
-  /** Directories/patterns to exclude (e.g., ["node_modules", "dist", "vendor", "*.generated.*"]) */
-  exclude?: Array<string>
-  /**
-   * Incremental update - only re-index changed files (default: false)
-   * When true, compares file hashes with existing index and only rebuilds changed files
-   */
-  incremental?: boolean
-}
-/** Index status information */
-export interface IndexStatus {
-  /** Whether an index exists */
-  exists: boolean
-  /** Number of files indexed */
-  fileCount: number
-  /** Number of symbols indexed */
-  symbolCount: number
-  /** Last build timestamp (ISO 8601) */
-  lastBuilt?: string
-  /** Index version */
-  version?: string
-  /** Number of files updated in incremental build (only set for incremental builds) */
-  filesUpdated?: number
-  /** Whether this was an incremental update */
-  incremental?: boolean
-}
-/** Information about a symbol in the call graph */
-export interface SymbolInfo {
-  /** 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 (1-indexed, consistent with editors/IDEs) */
-  line: number
-  /** End line number (1-indexed, consistent with editors/IDEs) */
-  endLine: number
-  /** Function/method signature */
-  signature?: string
-  /** Visibility (public, private, etc.) */
-  visibility: string
-}
-/** A reference to a symbol with context */
-export interface ReferenceInfo {
-  /** Symbol making the reference */
-  symbol: SymbolInfo
-  /** Reference kind (call, import, inherit, implement) */
-  kind: string
-  /** File path containing the reference (convenience field, same as symbol.file) */
-  file: string
-  /**
-   * Line number of the reference (1-indexed, convenience field, same as symbol.line)
-   * Note: This is the line where the referencing symbol is defined, not where the
-   * actual reference occurs. For call site line numbers, use getCallSites() instead.
-   */
-  line: number
-}
-/** An edge in the call graph */
-export interface CallGraphEdge {
-  /** Caller symbol ID */
-  callerId: number
-  /** Callee symbol ID */
-  calleeId: number
-  /** Caller symbol name */
-  caller: string
-  /** Callee symbol name */
-  callee: string
-  /** File containing the call site */
-  file: string
-  /** Line number of the call */
-  line: number
-}
-/** Call graph statistics */
-export interface CallGraphStats {
-  /** Total number of symbols */
-  totalSymbols: number
-  /** Total number of call edges */
-  totalCalls: number
-  /** Number of functions/methods */
-  functions: number
-  /** Number of classes/structs */
-  classes: number
-}
-/** Complete call graph with nodes and edges */
-export interface CallGraph {
-  /** All symbols (nodes) */
-  nodes: Array<SymbolInfo>
-  /** Call relationships (edges) */
-  edges: Array<CallGraphEdge>
-  /** 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) */
-  maxNodes?: number
-  /** Maximum number of edges to return (default: unlimited) */
-  maxEdges?: number
-}
-/** Result from getSymbolSource containing source code and metadata */
-export interface SymbolSourceResult {
-  /** The source code of the symbol */
-  source: string
-  /** Path to the file containing the symbol (relative to repo root) */
-  path: string
-  /** Start line number (1-indexed) */
-  startLine: number
-  /** End line number (1-indexed) */
-  endLine: number
-  /** Symbol name */
-  name: string
-  /** Symbol kind (function, method, class, etc.) */
-  kind: string
-}
-/** Options for generateMap */
-export interface GenerateMapOptions {
-  /** Token budget for the map (default: 2000) */
-  budget?: number
-  /** Maximum number of symbols to include (default: 50) */
-  maxSymbols?: number
-}
-/** Options for semanticCompress */
-export interface SemanticCompressOptions {
-  /**
-   * Threshold for grouping similar chunks (0.0-1.0, default: 0.7)
-   * Note: Only affects output when built with "embeddings" feature.
-   */
-  similarityThreshold?: number
-  /**
-   * Target size as ratio of original (0.0-1.0, default: 0.5)
-   * Lower values = more aggressive compression
-   */
-  budgetRatio?: number
-  /** Minimum chunk size in characters (default: 100) */
-  minChunkSize?: number
-  /** Maximum chunk size in characters (default: 2000) */
-  maxChunkSize?: number
-}
-/**
- * Feature #2: Filter options for symbol queries
- *
- * Allows filtering query results by symbol kind.
- */
-export interface QueryFilter {
-  /**
-   * Filter by symbol kinds: "function", "method", "class", "struct", "interface", "trait", "enum", 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>
-}
-/** Options for chunking a repository */
-export interface ChunkOptions {
-  /** Chunking strategy: "fixed", "file", "module", "symbol", "semantic", "dependency" */
-  strategy?: string
-  /** Maximum tokens per chunk (default: 8000) */
-  maxTokens?: number
-  /** Token overlap between chunks (default: 0) */
-  overlap?: number
-  /** Target model for token counting (default: "claude") */
-  model?: string
-  /** Output format: "xml", "markdown", "json" (default: "xml") */
-  format?: string
-  /** Sort chunks by priority (core modules first) */
-  priorityFirst?: boolean
-  /** Directories/patterns to exclude (e.g., ["vendor", "generated", "*.test.*"]) */
-  exclude?: Array<string>
-}
-/** A chunk of repository content */
-export interface RepoChunk {
-  /** Chunk index (0-based) */
-  index: number
-  /** Total number of chunks */
-  total: number
-  /** Primary focus/topic of this chunk */
-  focus: string
-  /** Estimated token count */
-  tokens: number
-  /** Files included in this chunk */
-  files: Array<string>
-  /** Formatted content of the chunk */
-  content: string
-}
-/** Options for impact analysis */
-export interface ImpactOptions {
-  /** Depth of dependency traversal (1-3, default: 2) */
-  depth?: number
-  /** Include test files in analysis */
-  includeTests?: boolean
-  /** Target model for token counting (default: "claude") */
-  model?: string
-  /** Glob patterns to exclude (e.g., ["**/*.test.ts", "dist/**"]) */
-  exclude?: Array<string>
-  /** Glob patterns to include (e.g., ["src/**/*.ts"]) */
-  include?: Array<string>
-}
-/** Symbol affected by a change */
-export interface AffectedSymbol {
-  /** Symbol name */
-  name: string
-  /** Symbol kind (function, class, etc.) */
-  kind: string
-  /** File containing the symbol */
-  file: string
-  /** Line number */
-  line: number
-  /** How the symbol is affected: "direct", "caller", "callee", "dependent" */
-  impactType: string
-}
-/** Impact analysis result */
-export interface ImpactResult {
-  /** Files directly changed */
-  changedFiles: Array<string>
-  /** Files that depend on changed files */
-  dependentFiles: Array<string>
-  /** Related test files */
-  testFiles: Array<string>
-  /** Symbols affected by the changes */
-  affectedSymbols: Array<AffectedSymbol>
-  /** Overall impact level: "low", "medium", "high", "critical" */
-  impactLevel: string
-  /** Summary of the impact */
-  summary: string
-}
-/** Options for diff context */
-export interface DiffContextOptions {
-  /** Depth of context expansion (1-3, default: 2) */
-  depth?: number
-  /** Token budget for context (default: 50000) */
-  budget?: number
-  /** Include the actual diff content (default: false) */
-  includeDiff?: boolean
-  /** Output format: "xml", "markdown", "json" (default: "xml") */
-  format?: string
-  /** Target model for token counting (default: "claude") */
-  model?: string
-  /** Glob patterns to exclude (e.g., ["**/*.test.ts", "dist/**"]) */
-  exclude?: Array<string>
-  /** Glob patterns to include (e.g., ["src/**/*.ts"]) */
-  include?: Array<string>
-}
-/** Context-aware diff result */
-export interface DiffContextResult {
-  /** Changed files with context */
-  changedFiles: Array<DiffFileContext>
-  /** Related symbols and their context */
-  contextSymbols: Array<ContextSymbolInfo>
-  /** Related test files */
-  relatedTests: Array<string>
-  /** Formatted output (if format specified) */
-  formattedOutput?: string
-  /** Total token count */
-  totalTokens: number
-}
-/** A changed file with surrounding context */
-export interface DiffFileContext {
-  /** File path */
-  path: string
-  /** Change type: "Added", "Modified", "Deleted", "Renamed" */
-  changeType: string
-  /** Lines added */
-  additions: number
-  /** Lines deleted */
-  deletions: number
-  /** Unified diff content (if include_diff is true) */
-  diff?: string
-  /** Relevant code context around changes */
-  contextSnippets: Array<string>
-}
-/** Symbol context information */
-export interface ContextSymbolInfo {
-  /** Symbol name */
-  name: string
-  /** Symbol kind */
-  kind: string
-  /** File containing symbol */
-  file: string
-  /** Line number */
-  line: number
-  /** Why this symbol is included: "changed", "caller", "callee", "dependent" */
-  reason: string
-  /** 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
-}
-/**
- * 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>
-/**
- * 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
- * * `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
-/**
- * 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 { embed } = require('infiniloom-node');
- *
- * const result = embed('./my-repo', {
- *   maxTokens: 1000,
- *   securityScan: true,
- *   diffOnly: false
- * });
- *
- * 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 embed(path?: string | undefined | null, options?: EmbedOptions | undefined | null): EmbedResult
-/**
- * Async version of embed
- *
- * Generate embedding chunks asynchronously, useful for Node.js applications
- * that want to avoid blocking the event loop.
- *
- * # Example
- * ```javascript
- * const { embedAsync } = require('infiniloom-node');
- *
- * const result = await embedAsync('./my-repo', {
- *   maxTokens: 1000,
- *   diffOnly: true
- * });
- * ```
- */
-export declare function embedAsync(path?: string | undefined | null, options?: EmbedOptions | undefined | null): Promise<EmbedResult>
-/**
- * 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 { loadEmbedManifest } = require('infiniloom-node');
- *
- * const status = loadEmbedManifest('./my-repo');
- * if (status.exists) {
- *   console.log(`Manifest has ${status.chunkCount} chunks`);
- * }
- * ```
- */
-export declare function loadEmbedManifest(path?: string | undefined | null): EmbedManifestStatus
-/** Async version of loadEmbedManifest */
-export declare function loadEmbedManifestAsync(path?: string | undefined | null): Promise<EmbedManifestStatus>
-/**
- * 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 { deleteEmbedManifest } = require('infiniloom-node');
- *
- * const deleted = deleteEmbedManifest('./my-repo');
- * console.log(deleted ? 'Manifest deleted' : 'No manifest found');
- * ```
- */
-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
-}
-/**
- * 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 { extractDocumentation } = require('infiniloom-node');
- *
- * 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 extractDocumentation(rawDoc: string, options: ExtractDocOptions): JsDocumentation
-/** Async version of extractDocumentation */
-export declare function extractDocumentationAsync(rawDoc: string, options: ExtractDocOptions): Promise<JsDocumentation>
-/**
- * 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 { detectDeadCode } = require('infiniloom-node');
- *
- * const deadCode = detectDeadCode('./my-repo');
- * console.log(`Found ${deadCode.unusedExports.length} unused exports`);
- * ```
- */
-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>
-/**
- * Detect breaking changes between two versions
- *
- * Compares public API symbols between two git refs to identify
- * breaking changes like removed functions, changed signatures, etc.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `options` - Breaking change detection options
- *
- * # Returns
- * Breaking change report
- *
- * # Example
- * ```javascript
- * const { detectBreakingChanges } = require('infiniloom-node');
- *
- * 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 detectBreakingChanges(path: string, options: BreakingChangeOptions): JsBreakingChangeReport
-/** Async version of detectBreakingChanges */
-export declare function detectBreakingChangesAsync(path: string, options: BreakingChangeOptions): Promise<JsBreakingChangeReport>
-/**
- * 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
-/**
- * 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
- * * `options` - Optional packing options
- *
- * # Returns
- * Formatted repository context as a string
- *
- * # Example
- * ```javascript
- * const { packAsync } = require('infiniloom-node');
- *
- * const context = await packAsync('./my-repo', {
- *   format: 'xml',
- *   model: 'claude',
- *   compression: 'balanced'
- * });
- * ```
- */
-export declare function packAsync(path?: string | undefined | null, options?: PackOptions | undefined | null): Promise<string>
-/**
- * Async version of scan
- *
- * Scan a repository and return statistics asynchronously.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `model` - Optional tokenizer model
- *
- * # Returns
- * Repository statistics
- *
- * # Example
- * ```javascript
- * const { scanAsync } = require('infiniloom-node');
- *
- * const stats = await scanAsync('./my-repo', 'claude');
- * console.log(`Total tokens: ${stats.totalTokens}`);
- * ```
- */
-export declare function scanAsync(path?: string | undefined | null, model?: string | undefined | null): Promise<ScanStats>
-/**
- * Async version of buildIndex
- *
- * Build a symbol index for fast diff context analysis asynchronously.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `options` - Optional index build options
- *
- * # Returns
- * Index status
- *
- * # Example
- * ```javascript
- * const { buildIndexAsync } = require('infiniloom-node');
- *
- * const status = await buildIndexAsync('./my-repo', { force: false });
- * console.log(`Indexed ${status.totalFiles} files`);
- * ```
- */
-export declare function buildIndexAsync(path?: string | undefined | null, options?: IndexOptions | undefined | null): Promise<IndexStatus>
-/**
- * Async version of chunk
- *
- * Split a repository into semantic chunks asynchronously.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `options` - Optional chunking options
- *
- * # Returns
- * Array of repository chunks
- *
- * # Example
- * ```javascript
- * const { chunkAsync } = require('infiniloom-node');
- *
- * const chunks = await chunkAsync('./my-repo', {
- *   strategy: 'module',
- *   maxTokens: 4000,
- *   overlap: 500
- * });
- * ```
- */
-export declare function chunkAsync(path?: string | undefined | null, options?: ChunkOptions | undefined | null): Promise<Array<RepoChunk>>
-/**
- * Async version of analyzeImpact
- *
- * Analyze the impact of file changes asynchronously.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `files` - List of changed file paths
- * * `options` - Optional impact analysis options
- *
- * # Returns
- * Impact analysis result
- *
- * # Example
- * ```javascript
- * const { analyzeImpactAsync } = require('infiniloom-node');
- *
- * const impact = await analyzeImpactAsync('./my-repo', ['src/auth.rs'], {
- *   depth: 2
- * });
- * ```
- */
-export declare function analyzeImpactAsync(path: string, files: Array<string>, options?: ImpactOptions | undefined | null): Promise<ImpactResult>
-/**
- * Async version of getDiffContext
- *
- * Get context-aware diff with surrounding symbols and dependencies asynchronously.
- *
- * # Arguments
- * * `path` - Path to repository root
- * * `from_ref` - Starting commit/branch
- * * `to_ref` - Ending commit/branch
- * * `options` - Optional diff context options
- *
- * # Returns
- * Diff context result
- *
- * # Example
- * ```javascript
- * const { getDiffContextAsync } = require('infiniloom-node');
- *
- * const context = await getDiffContextAsync('./my-repo', 'HEAD~1', 'HEAD', {
- *   depth: 2,
- *   budget: 50000
- * });
- * ```
- */
-export declare function getDiffContextAsync(path: string, fromRef: string, toRef: string, options?: DiffContextOptions | undefined | null): Promise<DiffContextResult>
-/**
- * Compress text using semantic compression
- *
- * Uses heuristic-based compression to reduce text size while preserving
- * semantic meaning. This is a simplified version that doesn't require embeddings.
- *
- * # Arguments
- * * `text` - Text to compress
- * * `options` - Optional compression options
- *
- * # Returns
- * Compressed text
- *
- * # Example
- * ```javascript
- * const { semanticCompress } = require('infiniloom-node');
- *
- * const compressed = semanticCompress(longText, {
- *   budgetRatio: 0.5,
- *   minChunkSize: 100,
- *   maxChunkSize: 2000
- * });
- * ```
- */
-export declare function semanticCompress(text?: string | undefined | null, options?: SemanticCompressOptions | undefined | null): string
-/**
- * Git repository wrapper for Node.js
- *
- * Provides access to git operations like status, diff, log, and blame.
- *
- * # Example
- * ```javascript
- * const { GitRepo } = require('infiniloom-node');
- *
- * const repo = new GitRepo('./my-project');
- * console.log(`Branch: ${repo.currentBranch()}`);
- * console.log(`Commit: ${repo.currentCommit()}`);
- *
- * for (const file of repo.status()) {
- *   console.log(`${file.status}: ${file.path}`);
- * }
- * ```
- */
-export declare class GitRepo {
-  /**
-   * Open a git repository
-   *
-   * # Arguments
-   * * `path` - Path to the repository
-   *
-   * # Throws
-   * Error if path is null/undefined or not a git repository
-   */
-  constructor(path?: string | undefined | null)
-  /**
-   * Get the current branch name
-   *
-   * # Returns
-   * Current branch name (e.g., "main", "feature/xyz")
-   */
-  currentBranch(): string
-  /**
-   * Get the current commit hash
-   *
-   * # Returns
-   * Full SHA-1 hash of HEAD commit
-   */
-  currentCommit(): string
-  /**
-   * Get working tree status
-   *
-   * Returns both staged and unstaged changes.
-   *
-   * # Returns
-   * Array of file status objects
-   */
-  status(): Array<GitFileStatus>
-  /**
-   * Get files changed between two commits
-   *
-   * # Arguments
-   * * `from_ref` - Starting commit/branch/tag
-   * * `to_ref` - Ending commit/branch/tag
-   *
-   * # Returns
-   * Array of changed files with diff stats
-   */
-  diffFiles(fromRef: string, toRef: string): Array<GitChangedFile>
-  /**
-   * Get recent commits
-   *
-   * # Arguments
-   * * `count` - Maximum number of commits to return (default: 10)
-   *
-   * # Returns
-   * Array of commit objects
-   */
-  log(count?: number | undefined | null): Array<GitCommit>
-  /**
-   * Get commits that modified a specific file
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   * * `count` - Maximum number of commits to return (default: 10)
-   *
-   * # Returns
-   * Array of commits that modified the file
-   */
-  fileLog(path: string, count?: number | undefined | null): Array<GitCommit>
-  /**
-   * Get blame information for a file
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   *
-   * # Returns
-   * Array of blame line objects
-   */
-  blame(path: string): Array<GitBlameLine>
-  /**
-   * Get list of files tracked by git
-   *
-   * # Returns
-   * Array of file paths tracked by git
-   */
-  lsFiles(): Array<string>
-  /**
-   * Get diff content between two commits for a file
-   *
-   * # Arguments
-   * * `from_ref` - Starting commit/branch/tag
-   * * `to_ref` - Ending commit/branch/tag
-   * * `path` - File path (relative to repo root)
-   *
-   * # Returns
-   * Unified diff content as string
-   */
-  diffContent(fromRef: string, toRef: string, path: string): string
-  /**
-   * Get diff content for uncommitted changes in a file
-   *
-   * Includes both staged and unstaged changes compared to HEAD.
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   *
-   * # Returns
-   * Unified diff content as string
-   */
-  uncommittedDiff(path: string): string
-  /**
-   * Get diff for all uncommitted changes
-   *
-   * Returns combined diff for all changed files.
-   *
-   * # Returns
-   * Unified diff content as string
-   */
-  allUncommittedDiffs(): string
-  /**
-   * Check if a file has uncommitted changes
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   *
-   * # Returns
-   * True if file has changes, false otherwise
-   */
-  hasChanges(path: string): boolean
-  /**
-   * Get the last commit that modified a file
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   *
-   * # Returns
-   * Commit information object
-   */
-  lastModifiedCommit(path: string): GitCommit
-  /**
-   * Get file change frequency in recent days
-   *
-   * Useful for determining file importance based on recent activity.
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   * * `days` - Number of days to look back (default: 30)
-   *
-   * # Returns
-   * Number of commits that modified the file in the period
-   */
-  fileChangeFrequency(path: string, days?: number | undefined | null): number
-  /**
-   * Get file content at a specific git ref (commit, branch, tag)
-   *
-   * Uses `git show <ref>:<path>` to retrieve file content at that revision.
-   *
-   * # Arguments
-   * * `path` - File path (relative to repo root)
-   * * `git_ref` - Git ref (commit hash, branch name, tag, HEAD~n, etc.)
-   *
-   * # Returns
-   * File content as string
-   *
-   * # Example
-   * ```javascript
-   * const { GitRepo } = require('infiniloom-node');
-   *
-   * const repo = new GitRepo('./my-project');
-   * const oldVersion = repo.fileAtRef('src/main.ts', 'HEAD~5');
-   * const mainVersion = repo.fileAtRef('src/main.ts', 'main');
-   * ```
-   */
-  fileAtRef(path: string, gitRef: string): string
-  /**
-   * Parse diff between two refs into structured hunks
-   *
-   * Returns detailed hunk information including line numbers for each change.
-   * Useful for PR review tools that need to post comments at specific lines.
-   *
-   * # Arguments
-   * * `from_ref` - Starting ref (e.g., "main", "HEAD~5", commit hash)
-   * * `to_ref` - Ending ref (e.g., "HEAD", "feature-branch")
-   * * `path` - Optional file path to filter to a single file
-   *
-   * # Returns
-   * Array of diff hunks with line-level information
-   *
-   * # Example
-   * ```javascript
-   * const { GitRepo } = require('infiniloom-node');
-   *
-   * const repo = new GitRepo('./my-project');
-   * const hunks = repo.diffHunks('main', 'HEAD', 'src/index.ts');
-   * for (const hunk of hunks) {
-   *   console.log(`Hunk at old:${hunk.oldStart} new:${hunk.newStart}`);
-   *   for (const line of hunk.lines) {
-   *     console.log(`${line.changeType}: ${line.content}`);
-   *   }
-   * }
-   * ```
-   */
-  diffHunks(fromRef: string, toRef: string, path?: string | undefined | null): Array<GitDiffHunk>
-  /**
-   * Parse uncommitted changes (working tree vs HEAD) into structured hunks
-   *
-   * # Arguments
-   * * `path` - Optional file path to filter to a single file
-   *
-   * # Returns
-   * Array of diff hunks for uncommitted changes
-   *
-   * # Example
-   * ```javascript
-   * const { GitRepo } = require('infiniloom-node');
-   *
-   * const repo = new GitRepo('./my-project');
-   * const hunks = repo.uncommittedHunks('src/index.ts');
-   * console.log(`${hunks.length} hunks with uncommitted changes`);
-   * ```
-   */
-  uncommittedHunks(path?: string | undefined | null): Array<GitDiffHunk>
-  /**
-   * Parse staged changes into structured hunks
-   *
-   * # Arguments
-   * * `path` - Optional file path to filter to a single file
-   *
-   * # Returns
-   * Array of diff hunks for staged changes only
-   *
-   * # Example
-   * ```javascript
-   * const { GitRepo } = require('infiniloom-node');
-   *
-   * const repo = new GitRepo('./my-project');
-   * const hunks = repo.stagedHunks('src/index.ts');
-   * console.log(`${hunks.length} hunks staged for commit`);
-   * ```
-   */
-  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>
-}