M.I.M.I.R - Multi-agent Intelligent Memory & Insight Repository

--- applyTo: '**' --- # Coding Preferences - **TypeScript**: Strict mode enabled, ES2022 target - **Build System**: TypeScript compiler with ES modules - **Package Manager**: npm (package-lock.json committed) - **Code Style**: Consistent with existing codebase patterns - **Testing**: Vitest for unit testing, coverage reporting - **Linting**: TypeScript ESLint parser configured # Project Architecture - **Type**: TypeScript MCP Server with stdio/HTTP transports - **Core Dependencies**: @modelcontextprotocol/sdk, neo4j-driver, langchain 1.0.1 - **Database**: Neo4j graph database (persistent storage) - **Build**: TypeScript → build/ directory (ES modules) - **Entry Points**: - MCP Server: src/index.ts → build/index.js - HTTP Server: src/http-server.ts → build/http-server.js - Global CLIs: bin/mimir-chain, bin/mimir-execute - **Multi-Agent**: LangChain + LangGraph integration for agent orchestration - **File Indexing**: Automatic file watching with chokidar + .gitignore support # Solutions Repository - **Neo4j Connection**: Use GraphManager with connection pooling and retries - **MCP Tool Patterns**: Follow existing tool structure in src/tools/ - **Error Handling**: Always return success/error objects with structured responses - **Zod Validation**: Use z.record(z.string(), z.any()) for object schemas (Zod 4.x) - **Multi-Agent Locking**: Use optimistic locking patterns with timeouts - **Context Isolation**: Use get_task_context for filtered agent context delivery - **LangChain Migration**: Use @langchain/langgraph for agent creation (not langchain/agents) - **Docker Issues**: Remove version field from docker-compose.yml (deprecated) - **Global CLIs**: Use npm link for global command installation - **Factorial Implementation**: Recursive function with error handling for negative inputs - **Test Coverage**: Vitest tests for edge cases (n=0, n=1, n=5, negative input) - **MCP Tool Error "o.content is not iterable"**: This error has TWO root causes: (1) **JSON Schema Issue**: MCP tool input schemas with `default: undefined` - MCP SDK cannot serialize undefined values. Remove `default: undefined` from inputSchema properties. (2) **HTTP Server Issue**: Broken auto-initialization logic that converts ALL requests to 'initialize' and returns cached init response without calling transport. Fix: Add `isSessionInitialized` flag to track state and only auto-init on FIRST non-init request. Test with manual script (bypass IDE) to isolate server vs client issues. Check server logs for actual method received vs processed. - **Private Copilot-API Configuration**: Docker service `timothyswt/copilot-api:latest` runs on port 4141 (mapped from internal 4141). Added as service in docker-compose.yml (NO profile - starts by default). Both mcp-server and open-webui have depends_on with service_healthy condition. mcp-server uses `http://copilot-api:4141/v1` internally (via Docker network). open-webui also uses `http://copilot-api:4141/v1` (Docker network). IMPORTANT: Service must NOT have profiles field when used as a dependency, or it becomes "undefined" for non-profile runs. Copilot-api listens on 4141, not 3000.