infiniloom-node 0.3.0 → 0.3.2

package/README.md

@@ -47,19 +47,25 @@ const context = pack('./my-repo', {
   format: 'xml',           // Output format: 'xml', 'markdown', 'json', 'yaml', 'toon', or 'plain'
   model: 'claude',         // Target model: 'gpt-5.2', 'gpt-5.1', 'gpt-5', 'o3', 'gpt-4o', 'claude', 'gemini', 'llama', etc.
   compression: 'balanced', // Compression: 'none', 'minimal', 'balanced', 'aggressive', 'extreme', 'focused', 'semantic'
-  mapBudget: 2000,        // Token budget for repository map
-  maxSymbols: 50,         // Maximum symbols to include in map
-  skipSecurity: false,    // Skip security scanning
-  redactSecrets: true,    // Redact detected secrets in output (default true)
-  skipSymbols: false      // Skip symbol extraction for faster scans
+  mapBudget: 2000,         // Token budget for repository map
+  maxSymbols: 50,          // Maximum symbols to include in map
+  skipSecurity: false,     // Skip security scanning
+  redactSecrets: true,     // Redact detected secrets in output (default true)
+  skipSymbols: false,      // Skip symbol extraction for faster scans
+  include: ['src/**/*.ts'],    // Glob patterns to include
+  exclude: ['**/*.test.ts'],   // Glob patterns to exclude
+  includeTests: false,     // Include test files (default: false)
+  securityThreshold: 'critical', // Minimum severity to block: 'critical', 'high', 'medium', 'low'
+  tokenBudget: 50000       // Limit total output tokens (0 = no limit)
 });
 ```
 
 ### Repository Scanning
 
 ```javascript
-const { scan } = require('infiniloom-node');
+const { scan, scanWithOptions } = require('infiniloom-node');
 
+// Simple scan with model
 const stats = scan('./my-repo', 'claude');
 console.log(`Repository: ${stats.name}`);
 console.log(`Total files: ${stats.totalFiles}`);
@@ -67,6 +73,15 @@ console.log(`Total lines: ${stats.totalLines}`);
 console.log(`Total tokens: ${stats.totalTokens}`);
 console.log(`Primary language: ${stats.primaryLanguage}`);
 console.log(`Languages:`, stats.languages);
+
+// Advanced scan with options
+const detailedStats = scanWithOptions('./my-repo', {
+  model: 'gpt-4o',
+  include: ['src/**/*.ts'],       // Include only TypeScript source files
+  exclude: ['**/*.test.ts'],      // Exclude test files
+  includeTests: false,            // Exclude test directories
+  applyDefaultIgnores: true       // Apply default ignores (node_modules, dist, etc.)
+});
 ```
 
 ### Token Counting
@@ -109,19 +124,28 @@ console.log(stats);
 const map = loom.generateMap(2000, 50);
 console.log(map);
 
-// Pack with options
+// Pack with options (including new features)
 const context = loom.pack({
   format: 'xml',
-  compression: 'balanced'
+  compression: 'balanced',
+  tokenBudget: 50000,       // Limit output size
+  include: ['src/**/*.ts'], // Filter files
+  exclude: ['**/*.test.ts']
 });
 console.log(context);
 
-// Security scan
+// Security scan - returns structured findings
 const findings = loom.securityScan();
 if (findings.length > 0) {
   console.warn('Security issues found:');
-  findings.forEach(finding => console.warn(finding));
+  for (const finding of findings) {
+    console.warn(`${finding.severity}: ${finding.kind} in ${finding.file}:${finding.line}`);
+  }
 }
+
+// Legacy formatted output (if needed)
+const formattedFindings = loom.securityScanFormatted();
+formattedFindings.forEach(f => console.log(f));
 ```
 
 ## API Reference
@@ -140,7 +164,7 @@ Pack a repository into optimized LLM context.
 
 #### `scan(path: string, model?: string): ScanStats`
 
-Scan a repository and return statistics.
+Scan a repository and return statistics. Applies default ignores automatically.
 
 **Parameters:**
 - `path` - Path to repository root
@@ -148,6 +172,16 @@ Scan a repository and return statistics.
 
 **Returns:** Repository statistics
 
+#### `scanWithOptions(path: string, options?: ScanOptions): ScanStats`
+
+Scan a repository with full configuration options.
+
+**Parameters:**
+- `path` - Path to repository root
+- `options` - Optional scan options
+
+**Returns:** Repository statistics
+
 #### `countTokens(text: string, model?: string): number`
 
 Count tokens in text for a specific model.
@@ -210,14 +244,31 @@ if (isGitRepo('./my-project')) {
 
 ```typescript
 interface PackOptions {
-  format?: string;        // "xml", "markdown", "json", "yaml", "toon", or "plain"
-  model?: string;         // "gpt-5.2", "gpt-5.1", "gpt-5", "o3", "gpt-4o", "claude", "gemini", "llama", etc.
-  compression?: string;   // "none", "minimal", "balanced", "aggressive", "extreme", "focused", "semantic"
-  mapBudget?: number;     // Token budget for repository map
-  maxSymbols?: number;    // Maximum number of symbols in map
-  skipSecurity?: boolean; // Skip security scanning
-  redactSecrets?: boolean;// Redact detected secrets
-  skipSymbols?: boolean;  // Skip symbol extraction
+  format?: string;           // "xml", "markdown", "json", "yaml", "toon", or "plain"
+  model?: string;            // "gpt-5.2", "gpt-5.1", "gpt-5", "o3", "gpt-4o", "claude", "gemini", "llama", etc.
+  compression?: string;      // "none", "minimal", "balanced", "aggressive", "extreme", "focused", "semantic"
+  mapBudget?: number;        // Token budget for repository map
+  maxSymbols?: number;       // Maximum number of symbols in map
+  skipSecurity?: boolean;    // Skip security scanning
+  redactSecrets?: boolean;   // Redact detected secrets (default: true)
+  skipSymbols?: boolean;     // Skip symbol extraction for faster scanning
+  include?: string[];        // Glob patterns to include (e.g., ["src/**/*.ts"])
+  exclude?: string[];        // Glob patterns to exclude (e.g., ["**/*.test.ts"])
+  includeTests?: boolean;    // Include test files (default: false)
+  securityThreshold?: string;// Minimum severity to block: "critical", "high", "medium", "low"
+  tokenBudget?: number;      // Limit total output tokens (0 = no limit)
+}
+```
+
+#### `ScanOptions`
+
+```typescript
+interface ScanOptions {
+  model?: string;              // Target model for token counting (default: "claude")
+  include?: string[];          // Glob patterns to include
+  exclude?: string[];          // Glob patterns to exclude
+  includeTests?: boolean;      // Include test files (default: false)
+  applyDefaultIgnores?: boolean; // Apply default ignores for dist/, node_modules/, etc. (default: true)
 }
 ```
 
@@ -322,9 +373,13 @@ Generate a repository map.
 
 Pack repository with specific options.
 
-#### `securityScan(): string[]`
+#### `securityScan(): SecurityFinding[]`
+
+Check for security issues and return structured findings.
+
+#### `securityScanFormatted(): string[]`
 
-Check for security issues and return findings.
+Check for security issues and return formatted strings (legacy format).
 
 ### GitRepo Class
 

package/index.d.ts

@@ -3,39 +3,6 @@
 
 /* auto-generated by NAPI-RS */
 
-/** Security finding information */
-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
-}
-/**
- * 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): Array<SecurityFinding>
 /** Options for packing a repository */
 export interface PackOptions {
   /** Output format: "xml", "markdown", "json", "yaml", "toon", or "plain" */
@@ -54,6 +21,16 @@ export interface PackOptions {
   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. */
+  tokenBudget?: number
 }
 /** Statistics from scanning a repository */
 export interface ScanStats {
@@ -83,6 +60,19 @@ export interface LanguageStat {
   /** 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
+}
 /**
  * Pack a repository into optimized LLM context
  *
@@ -95,7 +85,7 @@ export interface LanguageStat {
  *
  * # Example
  * ```javascript
- * const { pack } = require('@infiniloom/node');
+ * const { pack } = require('infiniloom-node');
  *
  * const context = pack('./my-repo', {
  *   format: 'xml',
@@ -111,14 +101,14 @@ export declare function pack(path: string, options?: PackOptions | undefined | n
  *
  * # Arguments
  * * `path` - Path to repository root
- * * `model` - Optional target model (default: "claude")
+ * * `model` - Optional target model (default: "claude") - for backwards compatibility
  *
  * # Returns
  * Repository statistics
  *
  * # Example
  * ```javascript
- * const { scan } = require('@infiniloom/node');
+ * const { scan } = require('infiniloom-node');
  *
  * const stats = scan('./my-repo', 'claude');
  * console.log(`Total files: ${stats.totalFiles}`);
@@ -126,6 +116,28 @@ export declare function pack(path: string, options?: PackOptions | undefined | n
  * ```
  */
 export declare function scan(path: string, 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
  *
@@ -138,7 +150,7 @@ export declare function scan(path: string, model?: string | undefined | null): S
  *
  * # Example
  * ```javascript
- * const { countTokens } = require('@infiniloom/node');
+ * const { countTokens } = require('infiniloom-node');
  *
  * const count = countTokens('Hello, world!', 'claude');
  * console.log(`Tokens: ${count}`);
@@ -161,7 +173,7 @@ export declare function countTokens(text: string, model?: string | undefined | n
  *
  * # Example
  * ```javascript
- * const { semanticCompress } = require('@infiniloom/node');
+ * const { semanticCompress } = require('infiniloom-node');
  *
  * const compressed = semanticCompress(longText, 0.7, 0.3);
  * ```
@@ -178,7 +190,7 @@ export declare function semanticCompress(text: string, similarityThreshold?: num
  *
  * # Example
  * ```javascript
- * const { isGitRepo } = require('@infiniloom/node');
+ * const { isGitRepo } = require('infiniloom-node');
  *
  * if (isGitRepo('./my-project')) {
  *   console.log('This is a git repository');
@@ -234,6 +246,39 @@ export interface GitBlameLine {
   /** Line number (1-indexed) */
   lineNumber: number
 }
+/** Security finding information */
+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
+}
+/**
+ * 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): Array<SecurityFinding>
 /** Infiniloom class for advanced usage */
 export declare class Infiniloom {
   /**
@@ -244,7 +289,7 @@ export declare class Infiniloom {
    * * `model` - Optional model name (default: "claude")
    */
   constructor(path: string, model?: string | undefined | null)
-  /** Get repository statistics */
+  /** Get repository statistics (Bug #4 fix - consistent with scan() function) */
   getStats(): ScanStats
   /**
    * Generate a repository map
@@ -256,8 +301,10 @@ export declare class Infiniloom {
   generateMap(budget?: number | undefined | null, maxSymbols?: number | undefined | null): string
   /** Pack repository with specific options */
   pack(options?: PackOptions | undefined | null): string
-  /** Check for security issues */
-  securityScan(): Array<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>
 }
 /**
  * Git repository wrapper for Node.js
@@ -266,7 +313,7 @@ export declare class Infiniloom {
  *
  * # Example
  * ```javascript
- * const { GitRepo } = require('@infiniloom/node');
+ * const { GitRepo } = require('infiniloom-node');
  *
  * const repo = new GitRepo('./my-project');
  * console.log(`Branch: ${repo.currentBranch()}`);

package/index.js

@@ -37,7 +37,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.android-arm64.node')
           } else {
-            nativeBinding = require('@infiniloom/node-android-arm64')
+            nativeBinding = require('infiniloom-node-android-arm64')
           }
         } catch (e) {
           loadError = e
@@ -49,7 +49,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.android-arm-eabi.node')
           } else {
-            nativeBinding = require('@infiniloom/node-android-arm-eabi')
+            nativeBinding = require('infiniloom-node-android-arm-eabi')
           }
         } catch (e) {
           loadError = e
@@ -69,7 +69,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.win32-x64-msvc.node')
           } else {
-            nativeBinding = require('@infiniloom/node-win32-x64-msvc')
+            nativeBinding = require('infiniloom-node-win32-x64-msvc')
           }
         } catch (e) {
           loadError = e
@@ -83,7 +83,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.win32-ia32-msvc.node')
           } else {
-            nativeBinding = require('@infiniloom/node-win32-ia32-msvc')
+            nativeBinding = require('infiniloom-node-win32-ia32-msvc')
           }
         } catch (e) {
           loadError = e
@@ -97,7 +97,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.win32-arm64-msvc.node')
           } else {
-            nativeBinding = require('@infiniloom/node-win32-arm64-msvc')
+            nativeBinding = require('infiniloom-node-win32-arm64-msvc')
           }
         } catch (e) {
           loadError = e
@@ -113,7 +113,7 @@ switch (platform) {
       if (localFileExisted) {
         nativeBinding = require('./infiniloom.darwin-universal.node')
       } else {
-        nativeBinding = require('@infiniloom/node-darwin-universal')
+        nativeBinding = require('infiniloom-node-darwin-universal')
       }
       break
     } catch {}
@@ -124,7 +124,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.darwin-x64.node')
           } else {
-            nativeBinding = require('@infiniloom/node-darwin-x64')
+            nativeBinding = require('infiniloom-node-darwin-x64')
           }
         } catch (e) {
           loadError = e
@@ -138,7 +138,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.darwin-arm64.node')
           } else {
-            nativeBinding = require('@infiniloom/node-darwin-arm64')
+            nativeBinding = require('infiniloom-node-darwin-arm64')
           }
         } catch (e) {
           loadError = e
@@ -157,7 +157,7 @@ switch (platform) {
       if (localFileExisted) {
         nativeBinding = require('./infiniloom.freebsd-x64.node')
       } else {
-        nativeBinding = require('@infiniloom/node-freebsd-x64')
+        nativeBinding = require('infiniloom-node-freebsd-x64')
       }
     } catch (e) {
       loadError = e
@@ -174,7 +174,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-x64-musl.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-x64-musl')
+              nativeBinding = require('infiniloom-node-linux-x64-musl')
             }
           } catch (e) {
             loadError = e
@@ -187,7 +187,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-x64-gnu.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-x64-gnu')
+              nativeBinding = require('infiniloom-node-linux-x64-gnu')
             }
           } catch (e) {
             loadError = e
@@ -203,7 +203,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-arm64-musl.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-arm64-musl')
+              nativeBinding = require('infiniloom-node-linux-arm64-musl')
             }
           } catch (e) {
             loadError = e
@@ -216,7 +216,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-arm64-gnu.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-arm64-gnu')
+              nativeBinding = require('infiniloom-node-linux-arm64-gnu')
             }
           } catch (e) {
             loadError = e
@@ -232,7 +232,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-arm-musleabihf.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-arm-musleabihf')
+              nativeBinding = require('infiniloom-node-linux-arm-musleabihf')
             }
           } catch (e) {
             loadError = e
@@ -245,7 +245,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-arm-gnueabihf.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-arm-gnueabihf')
+              nativeBinding = require('infiniloom-node-linux-arm-gnueabihf')
             }
           } catch (e) {
             loadError = e
@@ -261,7 +261,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-riscv64-musl.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-riscv64-musl')
+              nativeBinding = require('infiniloom-node-linux-riscv64-musl')
             }
           } catch (e) {
             loadError = e
@@ -274,7 +274,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./infiniloom.linux-riscv64-gnu.node')
             } else {
-              nativeBinding = require('@infiniloom/node-linux-riscv64-gnu')
+              nativeBinding = require('infiniloom-node-linux-riscv64-gnu')
             }
           } catch (e) {
             loadError = e
@@ -289,7 +289,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./infiniloom.linux-s390x-gnu.node')
           } else {
-            nativeBinding = require('@infiniloom/node-linux-s390x-gnu')
+            nativeBinding = require('infiniloom-node-linux-s390x-gnu')
           }
         } catch (e) {
           loadError = e
@@ -310,10 +310,11 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { pack, scan, countTokens, Infiniloom, semanticCompress, isGitRepo, GitRepo, scanSecurity } = nativeBinding
+const { pack, scan, scanWithOptions, countTokens, Infiniloom, semanticCompress, isGitRepo, GitRepo, scanSecurity } = nativeBinding
 
 module.exports.pack = pack
 module.exports.scan = scan
+module.exports.scanWithOptions = scanWithOptions
 module.exports.countTokens = countTokens
 module.exports.Infiniloom = Infiniloom
 module.exports.semanticCompress = semanticCompress

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infiniloom-node",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Node.js bindings for infiniloom - Repository context engine for LLMs",
   "main": "index.js",
   "types": "index.d.ts",