@houtini/lm 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,273 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [4.1.0] - 2025-08-29
+
+### 🎉 MAJOR RELEASE - 3-Stage Architecture Complete
+
+### Added
+- **Complete 3-Stage Architecture Deployment** - All multifile plugins now use the proven 3-stage prompt architecture
+  - `ThreeStagePromptManager` integration across all 4 multifile plugins
+  - `getPromptStages()` method with structured prompt stages (System+Context, Data Payload, Output Instructions)
+  - `executeSinglePass()` and `executeWithChunking()` methods for intelligent operation sizing
+  - Dynamic context detection from LM Studio (23,832 tokens from Qwen 3 Coder 30B)
+
+### Changed  
+- **Architecture Consistency** - Eliminated dual chunking conflicts throughout codebase
+  - Context Window Manager is now the sole chunking authority
+  - Single, consistent 3-stage chunking system across all multifile operations
+  - Smart prompt staging for optimal LLM utilization
+  - Consistent error handling and response formatting
+
+### Fixed
+- **100% Success Rate** - All multifile functions tested and verified working:
+  - ✅ `compare_integration`: Perfect integration analysis with detailed findings
+  - ✅ `trace_execution_path`: Successful 4-chunk processing with execution traces  
+  - ✅ `diff_method_signatures`: Accurate signature compatibility analysis
+  - ✅ `find_pattern_usage`: Pattern detection across entire codebase
+
+### Performance
+- **Context Preservation** - Eliminated hardcoded limits in favor of dynamic detection
+- **Scalable Operations** - Support for any operation size through intelligent chunking
+- **Memory Efficiency** - Optimized prompt staging reduces token waste
+- **Reliability** - Robust error handling and fallback mechanisms
+
+## [4.0.1] - 2025-08-29
+
+### Fixed
+- **Cache Management Tools Registration** - Fixed plugin loader to properly register cache management functions
+  - `clear_analysis_cache` and `get_cache_statistics` now properly available as MCP tools
+  - Fixed file:// URL format issue in plugin loader for Windows paths
+  - Build process now correctly compiles and exposes all 17 functions
+
+### Added
+- **100% Function Completion** - All 17 functions from functional specification v4.0 now working:
+  - 4 Analysis functions: analyze_single_file, security_audit, analyze_project_structure, analyze_n8n_workflow
+  - 6 Generation functions: generate_unit_tests, generate_documentation, suggest_refactoring, generate_wordpress_plugin, convert_to_typescript, generate_responsive_component
+  - 4 Multi-file functions: compare_integration, trace_execution_path, find_pattern_usage, diff_method_signatures
+  - 3 System functions: health_check, clear_analysis_cache, get_cache_statistics
+
+### Changed
+- **Documentation Updates** - Comprehensive README.md updates to reflect 100% completion status
+  - Updated function counts and categorization
+  - Added completion badges and status indicators
+  - Improved tool organization and descriptions
+  - Token savings data refreshed
+
+## [4.0.0] - 2025-08-28
+
+### Changed
+- **BREAKING**: Renamed `analyze_code_structure` to `analyze_single_file` for clarity
+  - The function now explicitly indicates it analyses a single file, not a directory
+  - Use `analyze_project_structure` for multi-file/directory analysis
+  - All enum references updated from `CODE_STRUCTURE` to `ANALYZE_SINGLE_FILE`
+
+## [3.0.4] - 2025-08-27
+
+### Fixed
+- **Critical streaming issue** - Resolved `[object Object]` output when processing LLM responses
+- **LM Studio SDK compatibility** - Proper handling of object-based chunks with `content` property
+- **Qwen model support** - Fixed streaming for Qwen thinking models that output structured chunks
+
+### Added
+- **Stream handler integration** - Robust chunk processing for multiple streaming formats
+- **Test scripts**:
+  - `test-llm-streaming.mjs` - Direct LLM streaming validation
+  - `test-streaming-fix.mjs` - MCP protocol streaming test
+- **Comprehensive streaming support** for:
+  - LM Studio object chunks
+  - OpenAI-style responses
+  - Plain text strings
+  - Unknown object formats with JSON fallback
+
+### Changed
+- Replaced simple string concatenation with `handleLLMResponse` function
+- Improved error handling for malformed chunks
+
+## [3.0.3] - 2025-08-26
+
+### Fixed
+- Added missing `health_check` tool definition (handler existed but tool wasn't registered)
+- Added empty handlers for `resources/list` and `prompts/list` to prevent "Method not found" errors in Claude logs
+- These optional MCP protocol methods now return empty arrays as expected
+
+### Added
+- **Diagnostic Tools**:
+  - `diagnostics/run-diagnostics.mjs` - Comprehensive system diagnostic tool that checks:
+    - Node.js version compatibility
+    - LM Studio connection and loaded models
+    - Claude configuration validity
+    - Multiple Claude process detection
+    - MCP server startup capability
+    - Generates detailed `diagnostic-report.json`
+  - `diagnostics/check-claude-processes.mjs` - Windows-specific tool to detect multiple Claude.exe processes
+- **Documentation Updates**:
+  - Added "Known Issues" section to TROUBLESHOOTING.md
+  - Documented multiple Claude.exe processes issue and solution
+  - Documented "Method not found" errors and resolution
+  - Added diagnostic tool usage instructions
+
+### Changed
+- Enhanced troubleshooting guide with new debugging tools section
+- Improved error diagnostics and user guidance
+
+## [3.0.2] - 2025-08-23
+
+### Fixed
+- Added missing shebang (`#!/usr/bin/env node`) to dist/index.js for NPX execution
+- Fixed NPM package execution on Windows
+- Added post-build script to ensure shebang persists after TypeScript compilation
+
+## [3.0.1] - 2025-08-23
+
+### Changed
+- Cleaned up root directory by removing development and handover files
+- Updated .gitignore to prevent future development file commits
+- Repository now contains only essential files for npm package and GitHub
+
+### Removed
+- Development documentation files (handover, implementation notes)
+- Test files used during development (test-enhanced*.mjs)
+- Backup directories and migration scripts
+- 18 unnecessary files total
+
+## [3.0.0] - 2025-08-25
+
+### Added
+- **Context-aware prompts** for enhanced code analysis
+  - Support for 11 project types (WordPress, React, n8n, Node.js, etc.)
+  - Framework-specific best practices and suggestions
+  - Optional context parameter maintains backward compatibility
+- **5 new powerful tools**:
+  - `generate_wordpress_plugin` - Complete WordPress plugin generator with Brain Monkey test support
+  - `analyze_n8n_workflow` - n8n workflow optimization and analysis
+  - `generate_responsive_component` - Accessible, responsive component generator
+  - `convert_to_typescript` - Intelligent JavaScript to TypeScript converter
+  - `security_audit` - Project-specific security vulnerability scanner
+- **90% token savings** through intelligent task delegation
+- **Enhanced type system** with comprehensive TypeScript definitions
+- **Project-specific security checklists** for each supported framework
+
+### Changed
+- **RENAMED**: `analyze_code_structure` is now `analyze_single_file` for clarity
+  - `analyze_single_file` - Now provides framework-specific insights for a single file
+  - Note: Use `analyze_project_structure` for multi-file/directory analysis
+- Enhanced existing tools with optional context support:
+  - `generate_unit_tests` - Creates framework-aware test suites
+  - `generate_documentation` - Generates audience-appropriate documentation
+  - `suggest_refactoring` - Offers project-specific improvements
+- Improved prompt quality for better LLM responses
+- Better error messages with context-aware suggestions
+
+### Technical Improvements
+- Modular prompt system for easier maintenance
+- Comprehensive type definitions for all contexts
+- Enhanced prompt templates with domain knowledge
+- Improved code organization and separation of concerns
+
+## [2.2.2] - 2025-08-25
+
+### Fixed
+- Fixed NPX execution on Windows by normalizing file paths
+- Handle forward/backward slash differences between import.meta.url and process.argv
+- Fixed "server transport closed unexpectedly" error when using NPX
+
+## [2.2.1] - 2025-08-25
+
+### Fixed
+- Added missing bin field to enable NPX execution
+- Fixed "could not determine executable to run" error
+- Updated examples to show NPX usage
+
+### Added
+- Clean and rebuild scripts for easier development
+
+## [2.2.0] - 2025-08-25
+
+### Fixed
+- Restored all missing tool definitions in setupHandlers
+- Fixed issue where only health_check was being registered
+
+### Added
+- All 10 tools now properly available:
+  - analyze_single_file
+  - generate_unit_tests
+  - generate_documentation
+  - suggest_refactoring
+  - detect_patterns
+  - validate_syntax
+  - suggest_variable_names
+  - analyze_file
+  - analyze_csv_data
+  - health_check
+
+## [2.1.0] - 2025-08-24
+
+### Added
+- **Security Features**:
+  - Path validation to prevent unauthorized file access
+  - Configurable allowed directories via LLM_MCP_ALLOWED_DIRS
+  - Path traversal protection
+  - File size limits (configurable, default 10MB)
+- **Configuration options**:
+  - Environment variable support for security settings
+  - Configurable retry logic
+  - Adjustable timeout settings
+
+### Fixed
+- Thinking tag regex for better response parsing
+- TypeScript strict mode compliance
+- Better error handling for invalid paths
+
+### Changed
+- Improved security posture with opt-in directory access
+- Better error messages for permission issues
+
+## [2.0.0] - 2025-08-23
+
+### Added
+- **File attachment support** - Analyze files directly without reading content first
+- **LM Studio SDK integration** - Replaced axios with official @lmstudio/sdk
+- **New tools**:
+  - `analyze_file` - General file analysis with custom instructions
+  - `analyze_csv_data` - CSV filtering and analysis
+- **Streaming support** for better performance
+- **Enhanced error handling** with better LM Studio status detection
+
+### Changed
+- Complete rewrite using LM Studio SDK
+- Improved connection handling and retry logic
+- Better model detection and validation
+
+### Removed
+- Axios dependency (replaced with LM Studio SDK)
+- Manual HTTP request handling
+
+## [1.0.0] - 2025-08-22
+
+### Initial Release
+- Basic code analysis tools
+- Unit test generation
+- Documentation generation
+- Refactoring suggestions
+- Pattern detection
+- Bug finding
+- Variable naming suggestions
+- Basic LM Studio integration via HTTP
+
+## Migration Notes
+
+### Upgrading to v3.0.0
+- No breaking changes - all existing code continues to work
+- To use new context features, add optional `context` parameter
+- New tools available immediately after upgrade
+- See [Migration Guide](MIGRATION_GUIDE_V3.md) for detailed upgrade instructions
+
+### Upgrading to v2.0.0
+- Update LM Studio URL from http:// to ws:// protocol
+- File analysis now available through new tools
+- Check [Migration Guide](MIGRATION_GUIDE.md) for details

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Richard Baxter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# Houtini LM - Local AI Development Assistant
+
+**Version**: 1.0.0  
+**Your unlimited AI companion for code analysis, generation, and creativity**
+
+Transform your development workflow with expert-level code analysis, professional documentation generation, and creative project scaffolding - all running locally without API costs.
+
+## What This Does
+
+Houtini LM **saves your Claude context window** by handling detailed analysis tasks locally whilst Claude focuses on strategy and complex problem-solving. Think of it as your intelligent coding assistant that never runs out of tokens.
+
+**Perfect for:**
+- 🔍 **Code analysis** - Deep insights into quality, security, and architecture
+- 📝 **Documentation generation** - Professional docs from code analysis
+- 🏗️ **Project scaffolding** - Complete applications, themes, and components
+- 🎮 **Creative projects** - Games, CSS art, and interactive experiences
+- 🛡️ **Security audits** - OWASP compliance and vulnerability detection
+
+## Quick Start Prompt Guide
+
+Once installed, simply use natural language prompts with Claude:
+
+```
+Use houtini-lm to analyse the code quality in C:/my-project/src/UserAuth.js
+```
+
+```
+Generate comprehensive unit tests using houtini-lm for my React component at C:/components/Dashboard.jsx
+```
+
+```
+Use houtini-lm to create a WordPress plugin called "Event Manager" with custom post types and admin interface
+```
+
+```
+Audit the security of my WordPress theme using houtini-lm at C:/themes/my-theme
+```
+
+```
+Create a CSS art generator project using houtini-lm with space theme and neon colours
+```
+
+```
+Use houtini-lm to convert my JavaScript file to TypeScript with strict mode enabled
+```
+
+```
+Generate responsive HTML components using houtini-lm for a pricing card with dark mode support
+```
+
+## Prerequisites
+
+**Essential Requirements:**
+
+1. **LM Studio** - Download from [lmstudio.ai](https://lmstudio.ai)
+   - Must be running at `ws://127.0.0.1:1234`
+   - Model loaded and ready (13B+ parameters recommended)
+
+2. **Desktop Commander MCP** - Essential for file operations
+   - Repository: [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP)
+   - Required for reading files and writing generated code
+
+3. **Node.js 24.6.0 or later** - For MCP server functionality
+   - Download from [nodejs.org](https://nodejs.org)
+
+4. **Claude Desktop** - For the best experience
+   - Download from [claude.ai/download](https://claude.ai/download)
+
+## Installation
+
+### 1. Install Dependencies
+
+```bash
+# Clone the repository
+git clone https://github.com/houtini-ai/lm.git
+cd lm
+
+# Install Node.js dependencies
+npm install
+```
+
+### 2. Configure Claude Desktop
+
+Add to your Claude Desktop configuration file:
+
+**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`  
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "houtini-lm": {
+      "command": "node",
+      "args": ["path/to/houtini-lm/index.js"],
+      "env": {
+        "LLM_MCP_ALLOWED_DIRS": "C:/your-projects,C:/dev,C:/websites"
+      }
+    }
+  }
+}
+```
+
+### 3. Start LM Studio
+
+1. Launch LM Studio
+2. Load a model (13B+ parameters recommended for best results)
+3. Start the server at `ws://127.0.0.1:1234`
+4. Verify the model is ready and responding
+
+### 4. Verify Installation
+
+Restart Claude Desktop, then test with:
+
+```
+Use houtini-lm health check to verify everything is working
+```
+
+## Available Functions
+
+### 🔍 Analysis Functions (17 functions)
+- **`analyze_single_file`** - Deep code analysis and quality assessment
+- **`count_files`** - Project structure with beautiful markdown trees
+- **`find_unused_files`** - Dead code detection with risk assessment
+- **`security_audit`** - OWASP compliance and vulnerability scanning
+- **`analyze_dependencies`** - Circular dependencies and unused imports
+- And 12 more specialized analysis tools...
+
+### 🛠️ Generation Functions (10 functions)
+- **`generate_unit_tests`** - Comprehensive test suites with framework patterns
+- **`generate_documentation`** - Professional docs from code analysis
+- **`convert_to_typescript`** - JavaScript to TypeScript with type safety
+- **`generate_wordpress_plugin`** - Complete WordPress plugin creation
+- **`generate_responsive_component`** - Accessible HTML/CSS components
+- And 5 more generation tools...
+
+### 🎮 Creative Functions (3 functions)
+- **`css_art_generator`** - Pure CSS art and animations
+- **`arcade_game`** - Complete playable HTML5 games
+- **`create_text_adventure`** - Interactive fiction with branching stories
+
+### ⚙️ System Functions (5 functions)
+- **`health_check`** - Verify LM Studio connection
+- **`list_functions`** - Discover all available functions
+- **`resolve_path`** - Path analysis and suggestions
+- And 2 more system utilities...
+
+## Documentation
+
+**Complete guides available:**
+- [Analysis Functions Guide](docs/analysis-functions-md.md) - All 17 analysis tools
+- [Generation Functions Guide](docs/generation-functions-md.md) - All 10 creation tools  
+- [Creative Functions Guide](docs/creative-functions-md.md) - Games and art tools
+- [System Functions Guide](docs/system-functions-md.md) - Utilities and diagnostics
+- [Complete User Guide](docs/user-guide-md.md) - Comprehensive usage manual
+
+## Recommended Setup
+
+**For Professional Development:**
+- **CPU**: 8-core or better (for local LLM processing)
+- **RAM**: 32GB (24GB for model, 8GB for development)
+- **Storage**: SSD with 100GB+ free space
+- **Model**: Qwen2.5-Coder-14B-Instruct or similar
+
+**Performance Tips:**
+- Use 13B+ parameter models for professional-quality results
+- Configure `LLM_MCP_ALLOWED_DIRS` to include your project directories
+- Install Desktop Commander MCP for complete file operation support
+- Keep LM Studio running and model loaded for instant responses
+
+## Version History
+
+### Version 1.0.0 (Current)
+- ✅ Complete function library (35+ functions)
+- ✅ Professional documentation system
+- ✅ WordPress-specific tools and auditing
+- ✅ Creative project generators
+- ✅ Comprehensive security analysis
+- ✅ TypeScript conversion and test generation
+- ✅ Cross-file integration analysis
+
+## License
+
+**MIT License** - Use this project freely for personal and commercial projects. See [LICENSE](LICENSE) for details.
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on:
+- Code standards and patterns
+- Testing requirements
+- Documentation updates
+- Issue reporting
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/houtini-ai/lm/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/houtini-ai/lm/discussions)
+- **Documentation**: Complete guides in the `docs/` directory
+
+---
+
+**Ready to supercharge your development workflow?** Install Houtini LM and start building amazing things with unlimited local AI assistance.
+
+*Built for developers who think clearly but can't afford to think expensively.*

package/dist/cache/analysis-cache.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Analysis Result Cache
+ * Specialized caching for plugin analysis results
+ */
+import { BaseCacheManager, CacheConfig } from './cache-manager.js';
+export interface AnalysisResult {
+    summary: string;
+    findings?: any[];
+    data?: any;
+    metadata?: {
+        modelUsed: string;
+        executionTime: number;
+        timestamp: string;
+    };
+}
+export declare class AnalysisCache extends BaseCacheManager<AnalysisResult> {
+    private static instance;
+    constructor(config?: Partial<CacheConfig>);
+    static getInstance(config?: Partial<CacheConfig>): AnalysisCache;
+    /**
+     * Generate cache key for analysis results
+     */
+    generateKey(functionName: string, params: any, fileHashes?: string[]): string;
+    /**
+     * Cache analysis result with metadata
+     */
+    cacheAnalysis(key: string, result: AnalysisResult, metadata: AnalysisResult['metadata']): Promise<void>;
+    /**
+     * Simple hash function for cache keys
+     */
+    private hashObject;
+}
+//# sourceMappingURL=analysis-cache.d.ts.map

package/dist/cache/analysis-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-cache.d.ts","sourceRoot":"","sources":["../../src/cache/analysis-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,aAAc,SAAQ,gBAAgB,CAAC,cAAc,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;gBAE3B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IASzC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,aAAa;IAOhE;;OAEG;IACH,WAAW,CACT,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,GAAG,EACX,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,MAAM;IAOT;;OAEG;IACG,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACH,OAAO,CAAC,UAAU;CAUnB"}

package/dist/cache/analysis-cache.js

@@ -0,0 +1,56 @@
+/**
+ * Analysis Result Cache
+ * Specialized caching for plugin analysis results
+ */
+import { BaseCacheManager } from './cache-manager.js';
+export class AnalysisCache extends BaseCacheManager {
+    constructor(config) {
+        super({
+            maxEntries: 50, // Smaller cache for analysis results
+            ttlMs: 30 * 60 * 1000, // 30 minutes TTL
+            enableStats: true,
+            ...config
+        });
+    }
+    static getInstance(config) {
+        if (!this.instance) {
+            this.instance = new AnalysisCache(config);
+        }
+        return this.instance;
+    }
+    /**
+     * Generate cache key for analysis results
+     */
+    generateKey(functionName, params, fileHashes) {
+        const paramHash = this.hashObject(params);
+        const filesHash = fileHashes ? fileHashes.join('|') : '';
+        return `${functionName}:${paramHash}:${filesHash}`.substring(0, 128);
+    }
+    /**
+     * Cache analysis result with metadata
+     */
+    async cacheAnalysis(key, result, metadata) {
+        const enrichedResult = {
+            ...result,
+            metadata: {
+                ...metadata,
+                cachedAt: new Date().toISOString()
+            }
+        };
+        await this.set(key, enrichedResult);
+    }
+    /**
+     * Simple hash function for cache keys
+     */
+    hashObject(obj) {
+        const str = JSON.stringify(obj, Object.keys(obj).sort());
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return Math.abs(hash).toString(36);
+    }
+}
+//# sourceMappingURL=analysis-cache.js.map

package/dist/cache/analysis-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-cache.js","sourceRoot":"","sources":["../../src/cache/analysis-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAe,MAAM,oBAAoB,CAAC;AAanE,MAAM,OAAO,aAAc,SAAQ,gBAAgC;IAGjE,YAAY,MAA6B;QACvC,KAAK,CAAC;YACJ,UAAU,EAAE,EAAE,EAAG,qCAAqC;YACtD,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAG,iBAAiB;YACzC,WAAW,EAAE,IAAI;YACjB,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAA6B;QAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,WAAW,CACT,YAAoB,EACpB,MAAW,EACX,UAAqB;QAErB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzD,OAAO,GAAG,YAAY,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,MAAsB,EACtB,QAAoC;QAEpC,MAAM,cAAc,GAAG;YACrB,GAAG,MAAM;YACT,QAAQ,EAAE;gBACR,GAAG,QAAQ;gBACX,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACnC;SACF,CAAC;QAEF,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAQ;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACnC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,2BAA2B;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/cache/cache-manager.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Core Cache Manager
+ * Foundation for all caching functionality - analysis, prompts, memory, etc.
+ */
+export interface CacheEntry<T = any> {
+    value: T;
+    timestamp: number;
+    hits: number;
+    size?: number;
+}
+export interface CacheConfig {
+    maxEntries: number;
+    ttlMs?: number;
+    enableStats: boolean;
+}
+export declare abstract class BaseCacheManager<T = any> {
+    protected cache: Map<string, CacheEntry<T>>;
+    protected config: CacheConfig;
+    constructor(config?: Partial<CacheConfig>);
+    protected isExpired(entry: CacheEntry<T>): boolean;
+    protected evictIfNeeded(): void;
+    protected createEntry(value: T): CacheEntry<T>;
+    protected estimateSize(value: T): number;
+    get(key: string): Promise<T | null>;
+    set(key: string, value: T): Promise<void>;
+    clear(key?: string): void;
+    getStatistics(): any;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/cache/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/cache/cache-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IACjC,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,8BAAsB,gBAAgB,CAAC,CAAC,GAAG,GAAG;IAC5C,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAa;IACxD,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;gBAElB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAS7C,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO;IAKlD,SAAS,CAAC,aAAa,IAAI,IAAI;IAU/B,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAS9C,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM;IAQlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzB,aAAa,IAAI,GAAG;CAerB"}