rlm-analyzer 1.1.0

package/dist/prompts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * RLM System Prompts
+ * Based on MIT CSAIL Recursive Language Models research
+ */
+import type { RLMConfig } from './types.js';
+/**
+ * Code Analysis System Prompt
+ * Enables deep codebase analysis with recursive sub-LLM calls
+ */
+export declare const CODE_ANALYSIS_PROMPT = "You are an expert code analyst using Recursive Language Models (RLMs).\nYour task is to analyze codebases by writing and executing Python code, delegating complex analysis to sub-LLMs.\n\n## Environment Variables\n- `file_index`: dict mapping file paths to their contents\n- `files`: list of all file paths\n\n## Available Functions\n- `print(x)`: Output text or data\n- `llm_query(prompt)`: **KEY FEATURE** - Delegate analysis to a sub-LLM. Use this to analyze individual files or answer specific questions about code.\n- `FINAL(\"answer\")`: **REQUIRED** - Call this with your complete answer when done\n\n## CRITICAL: You MUST call FINAL() within 5 turns with your complete answer!\n\n## The Power of Sub-LLM Calls\nThe `llm_query()` function is your most powerful tool. Use it to:\n- Analyze individual files: `analysis = llm_query(f\"Analyze this TypeScript file: {code}\")`\n- Answer specific questions: `answer = llm_query(f\"What design patterns are used here? {code}\")`\n- Summarize complex code: `summary = llm_query(f\"Summarize the main functionality: {code}\")`\n\n## Recommended Workflow\n1. **Explore**: `print(files)` to see available files\n2. **Identify key files**: Look for entry points (index, main, app), configs (package.json, tsconfig), and core modules\n3. **Delegate analysis**: Use `llm_query()` to analyze 3-5 key files - this gives much better results than just reading!\n4. **Synthesize**: Combine the sub-LLM analyses into your final answer\n5. **FINAL()**: Call with your comprehensive answer\n\n## Example - Good Use of Sub-LLMs\n```python\n# Explore the codebase\nprint(files[:20])\n\n# Analyze key files using sub-LLMs for deeper insight\nindex_analysis = llm_query(f\"Analyze this entry point file and identify main exports and purpose:\\n{file_index['src/index.ts'][:3000]}\")\nprint(\"Index analysis:\", index_analysis[:500])\n\nconfig_analysis = llm_query(f\"Analyze this config/package file for tech stack and dependencies:\\n{file_index['package.json']}\")\nprint(\"Config analysis:\", config_analysis[:500])\n\ncore_analysis = llm_query(f\"Analyze this core module for architecture patterns:\\n{file_index['src/core.ts'][:3000]}\")\nprint(\"Core analysis:\", core_analysis[:500])\n\n# Synthesize all analyses into final answer\nFINAL(f\"\"\"\n## Summary\nBased on analyzing key files in this codebase:\n\n{index_analysis}\n\n## Tech Stack & Dependencies\n{config_analysis}\n\n## Architecture\n{core_analysis}\n\n## Conclusion\n...\n\"\"\")\n```\n\n## MANDATORY Rules\n- **YOU MUST USE llm_query()** before calling FINAL() - this is enforced!\n- Minimum llm_query() calls required:\n  - 200+ files: 5 calls\n  - 100+ files: 4 calls  \n  - 50+ files: 3 calls\n  - 20+ files: 2 calls\n- FINAL() will be REJECTED if you don't make enough llm_query() calls\n- Use slicing for large content: `content[:3000]`\n- Combine sub-LLM results for comprehensive analysis\n\n## Scaling for Large Codebases\nFor codebases with many files:\n1. Analyze entry points (index, main, App)\n2. Analyze package.json/config for tech stack\n3. Analyze 2-3 core modules/services\n4. Analyze types/interfaces for data models\n5. Analyze at least one page/component for UI patterns\n\nMake MULTIPLE llm_query() calls - this is how you get quality analysis!";
+/**
+ * Architecture Analysis Prompt
+ */
+export declare const ARCHITECTURE_PROMPT = "Analyze the architecture of this codebase. Focus on:\n1. Directory structure and organization\n2. Key modules and their responsibilities\n3. Dependencies and data flow between components\n4. Design patterns used\n5. Entry points and main application flow\n\nProvide a structured analysis with clear sections.";
+/**
+ * Dependency Analysis Prompt
+ */
+export declare const DEPENDENCY_PROMPT = "Analyze the dependencies in this codebase:\n1. External packages/libraries used\n2. Internal module dependencies\n3. Circular dependency risks\n4. Tightly coupled components\n5. Suggestions for decoupling\n\nCreate a dependency map and highlight any concerns.";
+/**
+ * Security Analysis Prompt
+ */
+export declare const SECURITY_PROMPT = "Perform a security analysis of this codebase:\n1. Input validation patterns\n2. Authentication/authorization flows\n3. Data sanitization\n4. Sensitive data handling\n5. Common vulnerabilities (OWASP Top 10)\n6. API security patterns\n\nList findings by severity (Critical, High, Medium, Low).";
+/**
+ * Performance Analysis Prompt
+ */
+export declare const PERFORMANCE_PROMPT = "Analyze performance characteristics:\n1. Potential bottlenecks\n2. Memory usage patterns\n3. Async/await usage\n4. Caching strategies\n5. Database query patterns\n6. Bundle size considerations\n\nProvide specific recommendations for optimization.";
+/**
+ * Refactoring Analysis Prompt
+ */
+export declare const REFACTOR_PROMPT = "Identify refactoring opportunities:\n1. Code duplication\n2. Long methods/functions\n3. Complex conditionals\n4. God classes/modules\n5. Dead code\n6. Inconsistent patterns\n\nPrioritize suggestions by impact and effort.";
+/**
+ * Summary Prompt
+ */
+export declare const SUMMARY_PROMPT = "Provide a comprehensive summary of this codebase:\n1. Purpose and main functionality\n2. Tech stack and frameworks\n3. Key features\n4. Code organization\n5. Notable patterns or approaches\n6. Potential improvements\n\nKeep it concise but informative.";
+/**
+ * Get the appropriate system prompt for a query type
+ * @param _mode - Analysis mode (reserved for future mode-specific prompts)
+ */
+export declare function getSystemPrompt(_mode: RLMConfig['mode']): string;
+/**
+ * Get analysis-specific prompt
+ */
+export declare function getAnalysisPrompt(analysisType: string): string;
+/**
+ * Build initial context message
+ */
+export declare function buildContextMessage(fileCount: number, fileList: string[], query: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,2sGA+EuC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,mBAAmB,yTAOmB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,iBAAiB,wQAOsB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,eAAe,ySAQ6B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,kBAAkB,2PAQoB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,eAAe,iOAQiB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,cAAc,gQAQM,CAAC;AAElC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAIhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BhG"}

package/dist/prompts.js

@@ -0,0 +1,220 @@
+/**
+ * RLM System Prompts
+ * Based on MIT CSAIL Recursive Language Models research
+ */
+/**
+ * Code Analysis System Prompt
+ * Enables deep codebase analysis with recursive sub-LLM calls
+ */
+export const CODE_ANALYSIS_PROMPT = `You are an expert code analyst using Recursive Language Models (RLMs).
+Your task is to analyze codebases by writing and executing Python code, delegating complex analysis to sub-LLMs.
+
+## Environment Variables
+- \`file_index\`: dict mapping file paths to their contents
+- \`files\`: list of all file paths
+
+## Available Functions
+- \`print(x)\`: Output text or data
+- \`llm_query(prompt)\`: **KEY FEATURE** - Delegate analysis to a sub-LLM. Use this to analyze individual files or answer specific questions about code.
+- \`FINAL("answer")\`: **REQUIRED** - Call this with your complete answer when done
+
+## CRITICAL: You MUST call FINAL() within 5 turns with your complete answer!
+
+## The Power of Sub-LLM Calls
+The \`llm_query()\` function is your most powerful tool. Use it to:
+- Analyze individual files: \`analysis = llm_query(f"Analyze this TypeScript file: {code}")\`
+- Answer specific questions: \`answer = llm_query(f"What design patterns are used here? {code}")\`
+- Summarize complex code: \`summary = llm_query(f"Summarize the main functionality: {code}")\`
+
+## Recommended Workflow
+1. **Explore**: \`print(files)\` to see available files
+2. **Identify key files**: Look for entry points (index, main, app), configs (package.json, tsconfig), and core modules
+3. **Delegate analysis**: Use \`llm_query()\` to analyze 3-5 key files - this gives much better results than just reading!
+4. **Synthesize**: Combine the sub-LLM analyses into your final answer
+5. **FINAL()**: Call with your comprehensive answer
+
+## Example - Good Use of Sub-LLMs
+\`\`\`python
+# Explore the codebase
+print(files[:20])
+
+# Analyze key files using sub-LLMs for deeper insight
+index_analysis = llm_query(f"Analyze this entry point file and identify main exports and purpose:\\n{file_index['src/index.ts'][:3000]}")
+print("Index analysis:", index_analysis[:500])
+
+config_analysis = llm_query(f"Analyze this config/package file for tech stack and dependencies:\\n{file_index['package.json']}")
+print("Config analysis:", config_analysis[:500])
+
+core_analysis = llm_query(f"Analyze this core module for architecture patterns:\\n{file_index['src/core.ts'][:3000]}")
+print("Core analysis:", core_analysis[:500])
+
+# Synthesize all analyses into final answer
+FINAL(f"""
+## Summary
+Based on analyzing key files in this codebase:
+
+{index_analysis}
+
+## Tech Stack & Dependencies
+{config_analysis}
+
+## Architecture
+{core_analysis}
+
+## Conclusion
+...
+""")
+\`\`\`
+
+## MANDATORY Rules
+- **YOU MUST USE llm_query()** before calling FINAL() - this is enforced!
+- Minimum llm_query() calls required:
+  - 200+ files: 5 calls
+  - 100+ files: 4 calls  
+  - 50+ files: 3 calls
+  - 20+ files: 2 calls
+- FINAL() will be REJECTED if you don't make enough llm_query() calls
+- Use slicing for large content: \`content[:3000]\`
+- Combine sub-LLM results for comprehensive analysis
+
+## Scaling for Large Codebases
+For codebases with many files:
+1. Analyze entry points (index, main, App)
+2. Analyze package.json/config for tech stack
+3. Analyze 2-3 core modules/services
+4. Analyze types/interfaces for data models
+5. Analyze at least one page/component for UI patterns
+
+Make MULTIPLE llm_query() calls - this is how you get quality analysis!`;
+/**
+ * Architecture Analysis Prompt
+ */
+export const ARCHITECTURE_PROMPT = `Analyze the architecture of this codebase. Focus on:
+1. Directory structure and organization
+2. Key modules and their responsibilities
+3. Dependencies and data flow between components
+4. Design patterns used
+5. Entry points and main application flow
+
+Provide a structured analysis with clear sections.`;
+/**
+ * Dependency Analysis Prompt
+ */
+export const DEPENDENCY_PROMPT = `Analyze the dependencies in this codebase:
+1. External packages/libraries used
+2. Internal module dependencies
+3. Circular dependency risks
+4. Tightly coupled components
+5. Suggestions for decoupling
+
+Create a dependency map and highlight any concerns.`;
+/**
+ * Security Analysis Prompt
+ */
+export const SECURITY_PROMPT = `Perform a security analysis of this codebase:
+1. Input validation patterns
+2. Authentication/authorization flows
+3. Data sanitization
+4. Sensitive data handling
+5. Common vulnerabilities (OWASP Top 10)
+6. API security patterns
+
+List findings by severity (Critical, High, Medium, Low).`;
+/**
+ * Performance Analysis Prompt
+ */
+export const PERFORMANCE_PROMPT = `Analyze performance characteristics:
+1. Potential bottlenecks
+2. Memory usage patterns
+3. Async/await usage
+4. Caching strategies
+5. Database query patterns
+6. Bundle size considerations
+
+Provide specific recommendations for optimization.`;
+/**
+ * Refactoring Analysis Prompt
+ */
+export const REFACTOR_PROMPT = `Identify refactoring opportunities:
+1. Code duplication
+2. Long methods/functions
+3. Complex conditionals
+4. God classes/modules
+5. Dead code
+6. Inconsistent patterns
+
+Prioritize suggestions by impact and effort.`;
+/**
+ * Summary Prompt
+ */
+export const SUMMARY_PROMPT = `Provide a comprehensive summary of this codebase:
+1. Purpose and main functionality
+2. Tech stack and frameworks
+3. Key features
+4. Code organization
+5. Notable patterns or approaches
+6. Potential improvements
+
+Keep it concise but informative.`;
+/**
+ * Get the appropriate system prompt for a query type
+ * @param _mode - Analysis mode (reserved for future mode-specific prompts)
+ */
+export function getSystemPrompt(_mode) {
+    // Currently returns the same prompt for all modes
+    // Future: return different prompts based on mode (document-qa, education, etc.)
+    return CODE_ANALYSIS_PROMPT;
+}
+/**
+ * Get analysis-specific prompt
+ */
+export function getAnalysisPrompt(analysisType) {
+    switch (analysisType) {
+        case 'architecture':
+            return ARCHITECTURE_PROMPT;
+        case 'dependencies':
+            return DEPENDENCY_PROMPT;
+        case 'security':
+            return SECURITY_PROMPT;
+        case 'performance':
+            return PERFORMANCE_PROMPT;
+        case 'refactor':
+            return REFACTOR_PROMPT;
+        case 'summary':
+            return SUMMARY_PROMPT;
+        default:
+            return '';
+    }
+}
+/**
+ * Build initial context message
+ */
+export function buildContextMessage(fileCount, fileList, query) {
+    const preview = fileList.slice(0, 30).join('\n  ');
+    const truncated = fileList.length > 30 ? `\n  ... and ${fileList.length - 30} more` : '';
+    // Determine recommended sub-LLM calls based on codebase size
+    const recommendedCalls = fileCount > 100 ? '5-7' : fileCount > 50 ? '4-5' : '3-4';
+    return `## Codebase Context
+Files loaded: ${fileCount} ${fileCount > 100 ? '(LARGE CODEBASE - use many sub-LLM calls!)' : ''}
+
+File list:
+  ${preview}${truncated}
+
+## Your Task
+${query}
+
+## Instructions
+1. First, explore the file list to identify key files (entry points, configs, core modules)
+2. **Make ${recommendedCalls} llm_query() calls** to analyze different aspects:
+   - Entry point / main app file
+   - package.json / config files
+   - Core services or modules
+   - Types / interfaces
+   - Sample pages / components
+3. Synthesize the sub-LLM analyses into a comprehensive final answer
+4. Call FINAL("your answer") with your complete analysis
+
+🚫 WARNING: FINAL() will be REJECTED if you don't make at least ${recommendedCalls} llm_query() calls!
+This is enforced - you cannot skip sub-LLM analysis.`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEA+EoC,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;mDAOgB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;oDAOmB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;yDAQ0B,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;mDAQiB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;6CAQc,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;iCAQG,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,kDAAkD;IAClD,gFAAgF;IAChF,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,cAAc;YACjB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,cAAc;YACjB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,eAAe,CAAC;QACzB,KAAK,aAAa;YAChB,OAAO,kBAAkB,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,eAAe,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,QAAkB,EAAE,KAAa;IACtF,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzF,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAElF,OAAO;gBACO,SAAS,IAAI,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE;;;IAG5F,OAAO,GAAG,SAAS;;;EAGrB,KAAK;;;;YAIK,gBAAgB;;;;;;;;;kEASsC,gBAAgB;qDAC7B,CAAC;AACtD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * RLM Analyzer Type Definitions
+ * Based on MIT CSAIL Recursive Language Models research (arXiv:2512.24601v1)
+ */
+/** Analysis types supported by the analyzer */
+export type AnalysisType = 'architecture' | 'dependencies' | 'security' | 'performance' | 'refactor' | 'summary' | 'custom';
+export interface RLMConfig {
+    /** Root model for orchestration (default: gemini-3-flash-preview) */
+    rootModel: string;
+    /** Sub-model for recursive calls (default: gemini-3-flash-preview) */
+    subModel: string;
+    /** Maximum recursion depth for sub-LLM calls */
+    maxRecursionDepth: number;
+    /** Maximum conversation turns before forcing completion */
+    maxTurns: number;
+    /** Timeout in milliseconds for entire analysis */
+    timeoutMs: number;
+    /** Maximum sub-LLM calls per session */
+    maxSubCalls: number;
+    /** Analysis mode */
+    mode: 'code-analysis' | 'document-qa' | 'education';
+}
+export interface RLMContext {
+    /** Files loaded as environment variables */
+    files: Record<string, string>;
+    /** Additional context variables */
+    variables: Record<string, unknown>;
+    /** Analysis mode */
+    mode: RLMConfig['mode'];
+}
+export interface RLMTurn {
+    /** Turn number */
+    turn: number;
+    /** Model's response text */
+    response: string;
+    /** Code extracted from response */
+    code: string | null;
+    /** Execution result */
+    executionResult: string | null;
+    /** Error if any */
+    error: string | null;
+    /** Timestamp */
+    timestamp: number;
+}
+export interface RLMResult {
+    /** Whether analysis completed successfully */
+    success: boolean;
+    /** Final answer extracted via FINAL() marker */
+    answer: string | null;
+    /** All conversation turns */
+    turns: RLMTurn[];
+    /** Total execution time in ms */
+    executionTimeMs: number;
+    /** Number of sub-LLM calls made */
+    subCallCount: number;
+    /** Error message if failed */
+    error?: string;
+}
+export interface CodeAnalysisOptions {
+    /** Directory to analyze */
+    directory: string;
+    /** File patterns to include (glob) */
+    include?: string[];
+    /** File patterns to exclude (glob) */
+    exclude?: string[];
+    /** Custom query for analysis */
+    query?: string;
+    /** Analysis type */
+    analysisType?: AnalysisType;
+    /** Callback for turn updates */
+    onTurnComplete?: (turn: RLMTurn) => void;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Gemini model to use */
+    model?: string;
+}
+export interface CodeAnalysisResult extends RLMResult {
+    /** Files that were analyzed */
+    filesAnalyzed: string[];
+    /** Analysis type performed */
+    analysisType: AnalysisType;
+}
+export interface ExecutorResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output from execution */
+    output: string;
+    /** Error message if failed */
+    error?: string;
+}
+export interface SubLLMOptions {
+    /** Model to use */
+    model?: string;
+    /** Temperature for generation */
+    temperature?: number;
+    /** Maximum tokens in response */
+    maxTokens?: number;
+}
+/** Markers for extracting final answers */
+export declare const FINAL_MARKERS: {
+    readonly FINAL: "FINAL(";
+    readonly FINAL_VAR: "FINAL_VAR(";
+};
+/**
+ * Get default RLM configuration with dynamically resolved models
+ * This function respects the model priority chain:
+ * 1. Environment variables (RLM_DEFAULT_MODEL)
+ * 2. Config file (~/.rlm-analyzer/config.json)
+ * 3. Built-in defaults
+ *
+ * @param modelOverride - Optional model to use instead of resolved default
+ * @returns RLMConfig with resolved model settings
+ */
+export declare function getDefaultRLMConfig(modelOverride?: string): RLMConfig;
+/**
+ * @deprecated Use `getDefaultRLMConfig()` instead for dynamic model resolution.
+ * This static constant uses hardcoded model IDs and won't respect
+ * environment variables or config file settings.
+ */
+export declare const DEFAULT_CONFIG: RLMConfig;
+/** File extensions to analyze by default */
+export declare const CODE_EXTENSIONS: string[];
+/** Directories to ignore by default */
+export declare const IGNORE_DIRS: string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,87 @@
+/**
+ * RLM Analyzer Type Definitions
+ * Based on MIT CSAIL Recursive Language Models research (arXiv:2512.24601v1)
+ */
+import { getDefaultModel } from './models.js';
+/** Markers for extracting final answers */
+export const FINAL_MARKERS = {
+    FINAL: 'FINAL(',
+    FINAL_VAR: 'FINAL_VAR(',
+};
+/**
+ * Get default RLM configuration with dynamically resolved models
+ * This function respects the model priority chain:
+ * 1. Environment variables (RLM_DEFAULT_MODEL)
+ * 2. Config file (~/.rlm-analyzer/config.json)
+ * 3. Built-in defaults
+ *
+ * @param modelOverride - Optional model to use instead of resolved default
+ * @returns RLMConfig with resolved model settings
+ */
+export function getDefaultRLMConfig(modelOverride) {
+    const model = modelOverride || getDefaultModel();
+    return {
+        rootModel: model,
+        subModel: model,
+        maxRecursionDepth: 3,
+        maxTurns: 10,
+        timeoutMs: 300000, // 5 minutes
+        maxSubCalls: 15,
+        mode: 'code-analysis',
+    };
+}
+/**
+ * @deprecated Use `getDefaultRLMConfig()` instead for dynamic model resolution.
+ * This static constant uses hardcoded model IDs and won't respect
+ * environment variables or config file settings.
+ */
+export const DEFAULT_CONFIG = {
+    rootModel: 'gemini-3-flash-preview',
+    subModel: 'gemini-3-flash-preview',
+    maxRecursionDepth: 3,
+    maxTurns: 10,
+    timeoutMs: 300000, // 5 minutes
+    maxSubCalls: 15,
+    mode: 'code-analysis',
+};
+/** File extensions to analyze by default */
+export const CODE_EXTENSIONS = [
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.pyw',
+    '.java', '.kt', '.scala',
+    '.go',
+    '.rs',
+    '.c', '.cpp', '.cc', '.h', '.hpp',
+    '.cs',
+    '.rb',
+    '.php',
+    '.swift',
+    '.vue', '.svelte',
+    '.json', '.yaml', '.yml', '.toml',
+    '.md', '.mdx',
+    '.sql',
+    '.sh', '.bash', '.zsh',
+    '.dockerfile', '.docker-compose.yml',
+];
+/** Directories to ignore by default */
+export const IGNORE_DIRS = [
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    '.svn',
+    'coverage',
+    '__pycache__',
+    '.pytest_cache',
+    'venv',
+    '.venv',
+    'env',
+    '.env',
+    'vendor',
+    'target',
+    '.next',
+    '.nuxt',
+    '.output',
+    '.cache',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAyG9C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,YAAY;CACf,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,aAAsB;IACxD,MAAM,KAAK,GAAG,aAAa,IAAI,eAAe,EAAE,CAAC;IACjD,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,KAAK;QACf,iBAAiB,EAAE,CAAC;QACpB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,MAAM,EAAE,YAAY;QAC/B,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,eAAe;KACtB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,SAAS,EAAE,wBAAwB;IACnC,QAAQ,EAAE,wBAAwB;IAClC,iBAAiB,EAAE,CAAC;IACpB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,MAAM,EAAE,YAAY;IAC/B,WAAW,EAAE,EAAE;IACf,IAAI,EAAE,eAAe;CACtB,CAAC;AAEF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC5C,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,KAAK,EAAE,QAAQ;IACxB,KAAK;IACL,KAAK;IACL,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;IACjC,KAAK;IACL,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACjC,KAAK,EAAE,MAAM;IACb,MAAM;IACN,KAAK,EAAE,OAAO,EAAE,MAAM;IACtB,aAAa,EAAE,qBAAqB;CACrC,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,UAAU;IACV,aAAa;IACb,eAAe;IACf,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,SAAS;IACT,QAAQ;CACT,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "rlm-analyzer",
+  "version": "1.1.0",
+  "description": "Recursive Language Model (RLM) code analyzer - Analyze any codebase with AI that can process 100x beyond context limits",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./models": {
+      "types": "./dist/models.d.ts",
+      "import": "./dist/models.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "bin": {
+    "rlm": "dist/cli.js",
+    "rlm-analyzer": "dist/cli.js",
+    "rlm-mcp": "dist/mcp-server.js",
+    "rlm-analyzer-mcp": "dist/mcp-server.js"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc && chmod +x dist/cli.js dist/mcp-server.js",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "code-analysis",
+    "gemini",
+    "llm",
+    "recursive",
+    "static-analysis",
+    "architecture",
+    "refactoring",
+    "security",
+    "cli",
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "cursor"
+  ],
+  "author": "BzLabs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bzlabs/rlm-analyzer"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}