kemdicode-mcp 1.17.0 → 1.19.0

package/README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/kemdicode-mcp"><img src="https://img.shields.io/badge/npm-kemdicode--mcp-CB3837?style=flat-square&logo=npm&logoColor=white" alt="npm" /></a>
-  <a href="https://github.com/kemdi-pl/kemdicode-mcp/releases"><img src="https://img.shields.io/badge/version-1.17.0-blue?style=flat-square" alt="Version" /></a>
+  <a href="https://github.com/kemdi-pl/kemdicode-mcp/releases"><img src="https://img.shields.io/badge/version-1.19.0-blue?style=flat-square" alt="Version" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-green?style=flat-square" alt="License" /></a>
 </p>
 
@@ -28,7 +28,7 @@
 <details>
 <summary><strong>Table of Contents</strong></summary>
 
-- [What's New in 1.17.0](#whats-new-in-1170)
+- [What's New in 1.19.0](#whats-new-in-1190)
 - [Usage Examples](#usage-examples)
 - [Highlights](#highlights)
 - [Compatibility](#compatibility)
@@ -50,7 +50,20 @@
 
 ---
 
-## What's New in 1.17.0
+## What's New in 1.19.0
+
+- **Batch/Multi-Item Support for 14 Tools** &mdash; all single-item tools now accept arrays for parallel batch operations: `board-create` (1-10), `board-share` (1-10), `board-invite` (1-20), `board-members` (1-20 ops), `workspace-create` (1-5), `write-memory` (1-20), `read-memory` (1-20), `delete-memory` (1-20), `edit-memory` (1-10), `file-read` (1-20), `file-write` (1-20), `file-diff` (1-10 pairs), `session-create` (1-10), `session-delete` (1-10). All return per-item success/failure with structured results.
+- **Memory Tools: Redis Pipeline Optimization** &mdash; `read-memory` and `delete-memory` batch operations use Redis pipelines instead of sequential queries, eliminating N+1 performance issues.
+- **5 Critical Bug Fixes** &mdash; memory leak in `sessionHistory` Map (LRU eviction), recursion context restoration in `tool-invoker`, Pub/Sub handler leak in `agent-monitor`, Redis connection leak in kanban subscriber, race condition in `claimTask` blocker validation.
+- **5 Performance Improvements** &mdash; session write-back throttling (dirty flag + 5min threshold), kanban `listTasks` N+1 → Redis pipeline, context `queryContext` N+1 → pipeline, rate-limit map cleanup timer, shared Redis connection pooling.
+- **2 Security Fixes** &mdash; hardcoded salt fallback removed (now throws on missing `SECURE_STORAGE_SALT`), command injection risk in `projectContext.enhanced.ts` fixed (switched to `execFile`).
+- **Template Injection Prevention** &mdash; `consensus-prompt` fixed reversed `replaceAll` order to prevent user prompt from injecting `{board_responses}` placeholder. CEO `maxTokens` capped at 32K.
+- **ANSI Escape Injection Protection** &mdash; new `sanitizeTerminalOutput()` utility applied to `agent-alert` and `agent-inject` to prevent terminal escape sequence injection via user-controlled strings.
+- **Shared Memory Module** &mdash; extracted duplicated types, constants, and helpers from 7 memory tools into `src/tools/memory/shared.ts`, eliminating 6x duplication.
+- **Shared Format Helpers** &mdash; new `src/utils/format-helpers.ts` with `sanitizeTerminalOutput()`, `wrapText()`, `priorityIcon()`, `statusIcon()` shared across agent tools.
+- **Input Validation Hardening** &mdash; prototype pollution prevention in `agent-register` metadata keys, octal mode regex validation in `file-write`, ref flag injection prevention in `git-log`, content size limits (1MB) in `queue-message`.
+
+### What was in 1.18.0
 
 - **Checkpoint Save/Restore** &mdash; new tools `checkpoint-save` and `checkpoint-restore` for temporary state snapshots in Redis (7-day TTL). Save progress mid-task and restore later.
 - **Session Resume** &mdash; new `/resume` HTTP endpoint returns the last active session with tool history, enabling post-compaction recovery. SSE connections receive a `resume` event on reconnect.
@@ -369,192 +382,97 @@ ai-config --action test
 
 ### System Overview
 
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                        IDE / AI Agent Layer                             │
-│                                                                         │
-│   ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌───────────┐  │
-│   │  Claude Code  │  │    Cursor    │  │   KiroCode   │  │  RooCode  │  │
-│   └──────┬───────┘  └──────┬───────┘  └──────┬───────┘  └─────┬─────┘  │
-│          │                 │                 │                 │         │
-└──────────┼─────────────────┼─────────────────┼─────────────────┼─────────┘
-           │   SSE + JSON-RPC (MCP Protocol)   │                 │
-           └─────────────────┼─────────────────┘                 │
-                             ▼                                   │
-┌────────────────────────────────────────────────────────────────┐│
-│                kemdiCode MCP Server (HTTP :3100)               ││
-│  ┌───────────────────────────────────────────────────────────┐ ││
-│  │                    Session Manager                        │◄┘│
-│  │  • Per-client sessions with CWD isolation                 │  │
-│  │  • Activity tracking (last tool, args, timestamp)         │  │
-│  │  • /resume endpoint for post-compaction recovery          │  │
-│  │  • SSE keep-alive + resume events on reconnect            │  │
-│  └───────────────────────┬───────────────────────────────────┘  │
-│                          ▼                                      │
-│  ┌───────────────────────────────────────────────────────────┐  │
-│  │                   Tool Registry (103 tools)               │  │
-│  │                                                           │  │
-│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │  │
-│  │  │Code      │ │File &    │ │Git       │ │Multi-Agent   │ │  │
-│  │  │Analysis  │ │Editing   │ │Operations│ │Coordination  │ │  │
-│  │  │(8 tools) │ │(12 tools)│ │(5 tools) │ │(13 tools)    │ │  │
-│  │  └──────────┘ └──────────┘ └──────────┘ └──────────────┘ │  │
-│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │  │
-│  │  │AI Agents │ │Kanban    │ │Project   │ │Memory &      │ │  │
-│  │  │& LLM    │ │& Boards  │ │Management│ │Checkpoints   │ │  │
-│  │  │(6 tools) │ │(16 tools)│ │(5 tools) │ │(7 tools)     │ │  │
-│  │  └──────────┘ └──────────┘ └──────────┘ └──────────────┘ │  │
-│  │  • Runtime registration with tools/list_changed broadcast │  │
-│  │  • Zod schema validation + auto JSON Schema generation    │  │
-│  └───────────────────────┬───────────────────────────────────┘  │
-│                          ▼                                      │
-│  ┌───────────────────────────────────────────────────────────┐  │
-│  │               Provider Registry (7 providers)             │  │
-│  │                                                           │  │
-│  │  ┌─────────┐ ┌──────────┐ ┌────────┐ ┌────────────────┐  │  │
-│  │  │ OpenAI  │ │Anthropic │ │ Gemini │ │ OpenAI-compat  │  │  │
-│  │  │ (native)│ │ (native) │ │(native)│ │ Groq DeepSeek  │  │  │
-│  │  │         │ │          │ │        │ │ Ollama OpenRtr  │  │  │
-│  │  └─────────┘ └──────────┘ └────────┘ └────────────────┘  │  │
-│  │  • Lazy init on first use • Hot-reload without restart    │  │
-│  │  • Unified thinking tokens: effort / budget / budget      │  │
-│  │  • Model spec syntax: provider:model:thinking             │  │
-│  └───────────────────────────────────────────────────────────┘  │
-│                                                                 │
-│  ┌───────────────────────────────────────────────────────────┐  │
-│  │                  Tree-sitter AST Engine                    │  │
-│  │  • WASM parsers for 19 languages                          │  │
-│  │  • Symbol navigation, rename, insert before/after         │  │
-│  │  • Indentation detection + context-aware editing           │  │
-│  └───────────────────────────────────────────────────────────┘  │
-│                                                                 │
-│  ┌───────────────────────────────────────────────────────────┐  │
-│  │               Runtime Abstraction Layer                    │  │
-│  │  • Auto-detects Bun vs Node.js at startup                 │  │
-│  │  • Unified HTTP server (Bun.serve / node:http)            │  │
-│  │  • Unified process spawning (Bun.spawn / child_process)   │  │
-│  └───────────────────────────────────────────────────────────┘  │
-└────────────────────────────┬────────────────────────────────────┘
-                             │
-                             ▼
-┌────────────────────────────────────────────────────────────────┐
-│                      Redis (DB 2)                              │
-│                                                                │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐  │
-│  │ Context      │  │ Agents       │  │ Kanban               │  │
-│  │ mcp:context: │  │ mcp:agents:  │  │ mcp:kanban:          │  │
-│  │ mcp:memory:  │  │ mcp:queue:   │  │  workspace:<id>      │  │
-│  │ mcp:checkpoint│ │ mcp:messages:│  │  board:<id>           │  │
-│  └──────────────┘  └──────────────┘  │  task:<id>            │  │
-│                                      └──────────────────────┘  │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │ Pub/Sub Channels                                        │   │
-│  │ mcp:channel:broadcast  mcp:channel:inject:<agentId>     │   │
-│  │ mcp:channel:alerts     mcp:channel:thoughts             │   │
-│  └─────────────────────────────────────────────────────────┘   │
-└────────────────────────────────────────────────────────────────┘
-```
+| Layer | Component | Description |
+|:------|:----------|:------------|
+| **Clients** | Claude Code, Cursor, KiroCode, RooCode | Connect via SSE + JSON-RPC (MCP Protocol) |
+| **HTTP Server** | `:3100` (Bun or Node.js) | Routes: `/sse`, `/message`, `/resume`, `/stream` |
+| **Session Manager** | Per-client isolation | CWD injection, activity tracking, `/resume` for post-compaction recovery, SSE keep-alive |
+| **Tool Registry** | 103 tools, 20 categories | Zod schema validation, auto JSON Schema generation, runtime registration with `tools/list_changed` broadcast |
+| **Provider Registry** | 7 LLM providers | OpenAI, Anthropic, Gemini (native SDKs) + Groq, DeepSeek, Ollama, OpenRouter (OpenAI-compatible). Lazy init, hot-reload, unified thinking tokens |
+| **Tree-sitter AST** | 19 languages | WASM parsers, symbol navigation, rename, insert before/after, indentation detection |
+| **Runtime Abstraction** | Bun / Node.js | Auto-detection at startup. Unified HTTP (`Bun.serve` / `node:http`), process spawning (`Bun.spawn` / `child_process`) |
+| **Redis (DB 2)** | Shared state | `mcp:context:*` (tool outputs), `mcp:agents:*` (registry), `mcp:kanban:*` (tasks/boards/workspaces), `mcp:memory:*` (project memory), `mcp:checkpoint:*` (snapshots) |
+| **Redis Pub/Sub** | Real-time messaging | Channels: `broadcast`, `inject:<agentId>`, `alerts`, `thoughts` |
 
 ### Request Lifecycle
 
-```
-Client (IDE)                    kemdiCode MCP                     Redis / LLM
-     │                               │                                │
-     │── GET /sse ──────────────────►│                                │
-     │◄── SSE: endpoint + resume ───│  create session, track activity │
-     │                               │                                │
-     │── POST /message ────────────►│                                │
-     │   { tool: "code-review" }     │                                │
-     │                               │── validate (Zod) ────────────►│
-     │                               │── execute tool ──────────────►│
-     │                               │   ├─ share result to Redis    │
-     │                               │   └─ record session activity  │
-     │◄── SSE: result ─────────────│                                │
-     │                               │                                │
-     │── POST /message ────────────►│                                │
-     │   { tool: "ask-ai" }          │── route to provider ────────►│
-     │                               │◄── LLM response ────────────│
-     │◄── SSE: result ─────────────│                                │
-```
+| Step | Client (IDE) | kemdiCode MCP Server | External (Redis / LLM) |
+|:----:|:-------------|:---------------------|:-----------------------|
+| 1 | `GET /sse` &rarr; | Create session, assign CWD | |
+| 2 | | &larr; SSE: `endpoint` + `resume` event | |
+| 3 | `POST /message` `{ tool: "code-review" }` &rarr; | | |
+| 4 | | Validate args (Zod schema) | |
+| 5 | | Execute tool &rarr; | Share result to Redis, record activity |
+| 6 | | &larr; SSE: tool result | |
+| 7 | `POST /message` `{ tool: "ask-ai" }` &rarr; | | |
+| 8 | | Route to LLM provider &rarr; | Provider returns completion |
+| 9 | | &larr; SSE: AI response | |
 
 ### Source Tree
 
-```
-src/
-├── index.ts                 # Entry point, CLI args, server bootstrap
-├── constants.ts             # Error messages, timeouts, limits
-├── server/
-│   ├── http-server.ts       # HTTP routes: /sse, /message, /resume, /stream
-│   ├── session-server.ts    # MCP Server per session, CWD injection, activity tracking
-│   ├── types.ts             # ServerConfig, VERSION
-│   └── index.ts             # Public API exports
-├── ai/
-│   ├── client.ts            # Completion router (multi-provider + fallback)
-│   ├── execute.ts           # High-level AI execution with agent prompts
-│   ├── agents.ts            # Agent configs: plan, build, explore
-│   ├── model-spec.ts        # Parser for provider:model:thinking syntax
-│   ├── file-context.ts      # File attachment → prompt injection
-│   └── providers/
-│       ├── types.ts          # LLMProvider interface, ProviderId, ThinkingConfig
-│       ├── registry.ts       # Provider registry with lazy initialization
-│       ├── openai.provider.ts        # OpenAI (reasoning_effort)
-│       ├── anthropic.provider.ts     # Anthropic (thinking budget)
-│       ├── gemini.provider.ts        # Google GenAI (thinking budget)
-│       └── openai-compat.provider.ts # Groq, DeepSeek, Ollama, OpenRouter
-├── runtime/
-│   ├── index.ts             # isBun / isNode detection
-│   ├── http.ts              # Bun.serve ↔ node:http
-│   ├── process.ts           # Bun.spawn ↔ child_process
-│   └── crypto.ts            # Crypto utilities
-├── context/
-│   ├── agent-monitor.ts     # Redis Pub/Sub for agent lifecycle
-│   ├── storage.ts           # Redis-based shared context (DB 2)
-│   ├── feedback-loop.ts     # Learning from iteration results
-│   └── iteration-tracker.ts # Track fix attempts per issue
-├── kanban/
-│   ├── kanban-store.ts      # Task CRUD with Redis persistence
-│   ├── workspace-store.ts   # Workspace operations
-│   ├── board-store.ts       # Board management
-│   ├── membership-store.ts  # Role-based access (owner/admin/member/viewer)
-│   └── migration.ts         # Lazy migration to multi-board schema
-├── recursive/
-│   └── tool-invoker.ts      # Safe tool calls: max depth 2, rate-limited
-├── tree-sitter/
-│   ├── parser-manager.ts    # WASM parser lifecycle (19 languages)
-│   └── types.ts             # Language mappings, symbol types
-├── session/
-│   ├── manager.ts           # Session create/destroy lifecycle
-│   └── cwd-resolver.ts      # Project path resolution priority
-├── tools/                   # 20 categories, 103 tools
-│   ├── registry.ts          # UnifiedTool interface, Zod → JSON Schema, broadcast
-│   ├── index.ts             # Tool registration
-│   ├── agents/              # 9 tools: register, watch, alert, inject, monitor...
-│   ├── code/                # 8 tools: find-definition, rename-symbol, outline...
-│   ├── context/             # 4 tools: shared-thoughts, feedback, shared-context
-│   ├── edit/                # 4 tools: insert-at-line, delete/replace-lines
-│   ├── file/                # 5 tools: read, write, search, tree, diff
-│   ├── git/                 # 5 tools: status, diff, log, blame, branch
-│   ├── kanban/              # 16 tools: tasks, boards, workspaces
-│   ├── memory/              # 7 tools: CRUD + checkpoint-save/restore
-│   ├── multi-llm/           # 2 tools: multi-prompt, consensus-prompt
-│   ├── project/             # 5 tools: info, scripts, tests, lint, types
-│   ├── recursive/           # 3 tools: invoke-tool, invoke-batch, log
-│   ├── specialized/         # 8 tools: code-review, fix-bug, refactor, write-tests
-│   ├── session/             # 5 tools: CRUD + switch
-│   ├── system/              # 10 tools: shell, env, memory, ai-config, ping
-│   ├── loci/                # 4 tools: graph-query, find-path, recall, recommend
-│   ├── mpc/                 # 4 tools: split, distribute, reconstruct, status
-│   └── rl/                  # 2 tools: reward-stats, dopamine-log
-└── utils/
-    ├── commandExecutor.ts   # Process spawning with timeout + kill
-    ├── file-utils.ts        # Read/write with encoding detection
-    ├── edit-utils.ts        # Line-based editing helpers
-    ├── git-utils.ts         # Git command builders
-    ├── cache.ts             # In-memory TTL cache
-    ├── validation.ts        # Rate limiting, input sanitization
-    ├── errors.ts            # Typed error classes
-    └── logger.ts            # Structured logging
-```
+| Directory | File | Purpose |
+|:----------|:-----|:--------|
+| `src/` | `index.ts` | Entry point, CLI argument parsing, server bootstrap |
+| | `constants.ts` | Error messages, timeouts, limits |
+| `src/server/` | `http-server.ts` | HTTP routes: `/sse`, `/message`, `/resume`, `/stream` |
+| | `session-server.ts` | MCP Server per session, CWD injection, activity tracking |
+| | `types.ts` | `ServerConfig`, `VERSION` constants |
+| `src/ai/` | `client.ts` | Completion router (multi-provider + automatic fallback) |
+| | `execute.ts` | High-level AI execution with agent system prompts |
+| | `agents.ts` | Agent configurations: `plan`, `build`, `explore` |
+| | `model-spec.ts` | Parser for `provider:model:thinking` syntax |
+| | `file-context.ts` | File attachment &rarr; prompt injection |
+| `src/ai/providers/` | `types.ts` | `LLMProvider` interface, `ProviderId`, `ThinkingConfig` |
+| | `registry.ts` | Provider registry with lazy initialization |
+| | `openai.provider.ts` | OpenAI native SDK (`reasoning_effort`) |
+| | `anthropic.provider.ts` | Anthropic native SDK (`thinking` budget) |
+| | `gemini.provider.ts` | Google GenAI native SDK (`thinking` budget) |
+| | `openai-compat.provider.ts` | Groq, DeepSeek, Ollama, OpenRouter via OpenAI SDK |
+| `src/runtime/` | `index.ts` | `isBun` / `isNode` runtime detection |
+| | `http.ts` | Unified HTTP: `Bun.serve` &harr; `node:http` |
+| | `process.ts` | Unified spawn: `Bun.spawn` &harr; `child_process` |
+| | `crypto.ts` | Crypto utilities |
+| `src/context/` | `agent-monitor.ts` | Redis Pub/Sub for agent lifecycle and messaging |
+| | `storage.ts` | Redis-based shared context store (DB 2) |
+| | `feedback-loop.ts` | Learning from iteration results |
+| | `iteration-tracker.ts` | Track fix attempts per issue |
+| `src/kanban/` | `kanban-store.ts` | Task CRUD with Redis `hset`/`hgetall` persistence |
+| | `workspace-store.ts` | Workspace CRUD operations |
+| | `board-store.ts` | Board management and membership |
+| | `membership-store.ts` | Role-based access: owner / admin / member / viewer |
+| | `migration.ts` | Lazy migration to multi-board schema |
+| `src/recursive/` | `tool-invoker.ts` | Safe recursive tool calls: max depth 2, rate-limited, parallel isolation |
+| `src/tree-sitter/` | `parser-manager.ts` | WASM parser lifecycle for 19 languages |
+| | `types.ts` | Language &harr; extension mappings, symbol types |
+| `src/session/` | `manager.ts` | Session create / destroy / cleanup lifecycle |
+| | `cwd-resolver.ts` | Project path resolution priority chain |
+| `src/tools/` | `registry.ts` | `UnifiedTool` interface, Zod &rarr; JSON Schema, broadcast on register |
+| | `index.ts` | Central tool registration (103 tools) |
+| `src/tools/agents/` | 9 tools | `agent-register`, `agent-watch`, `agent-alert`, `agent-inject`, `monitor`, `agent-summary`, `queue-message`, `agent-list`, `agent-history` |
+| `src/tools/code/` | 8 tools | `find-definition`, `find-references`, `find-symbols`, `code-outline`, `insert-before-symbol`, `insert-after-symbol`, `rename-symbol`, `semantic-search` |
+| `src/tools/context/` | 4 tools | `shared-thoughts`, `get-shared-context`, `feedback`, `batch` |
+| `src/tools/edit/` | 4 tools | `insert-at-line`, `delete-lines`, `replace-lines`, `replace-content` |
+| `src/tools/file/` | 5 tools | `file-read`, `file-write`, `file-search`, `file-tree`, `file-diff` |
+| `src/tools/git/` | 5 tools | `git-status`, `git-diff`, `git-log`, `git-blame`, `git-branch` |
+| `src/tools/kanban/` | 16 tools | Tasks (7), boards (5), workspaces (4) |
+| `src/tools/memory/` | 7 tools | `write-memory`, `read-memory`, `list-memories`, `edit-memory`, `delete-memory`, `checkpoint-save`, `checkpoint-restore` |
+| `src/tools/multi-llm/` | 2 tools | `multi-prompt`, `consensus-prompt` |
+| `src/tools/project/` | 5 tools | `project-info`, `run-script`, `run-tests`, `run-lint`, `check-types` |
+| `src/tools/recursive/` | 3 tools | `invoke-tool`, `invoke-batch`, `invocation-log` |
+| `src/tools/specialized/` | 8 tools | `code-review`, `explain-code`, `analyze-deps`, `fix-bug`, `refactor`, `auto-fix`, `auto-fix-agent`, `write-tests` |
+| `src/tools/session/` | 5 tools | `session-list`, `session-info`, `session-create`, `session-switch`, `session-delete` |
+| `src/tools/system/` | 10 tools | `shell-exec`, `process-list`, `env-info`, `memory-usage`, `ai-config`, `ai-models`, `config`, `ping`, `help`, `timeout-test` |
+| `src/tools/loci/` | 4 tools | `graph-query`, `graph-find-path`, `loci-recall`, `sequence-recommend` |
+| `src/tools/mpc/` | 4 tools | `mpc-split`, `mpc-distribute`, `mpc-reconstruct`, `mpc-status` |
+| `src/tools/rl/` | 2 tools | `rl-reward-stats`, `rl-dopamine-log` |
+| `src/utils/` | `commandExecutor.ts` | Process spawning with timeout, SIGTERM &rarr; SIGKILL |
+| | `file-utils.ts` | Read/write with encoding detection (UTF-8, UTF-16, Latin1) |
+| | `edit-utils.ts` | Line-based editing helpers |
+| | `git-utils.ts` | Git command builders |
+| | `cache.ts` | In-memory TTL cache |
+| | `validation.ts` | Rate limiting, path validation, input sanitization |
+| | `errors.ts` | Typed error classes (`ValidationError`, `TimeoutError`, etc.) |
+| | `logger.ts` | Structured logging with levels |
 
 ---
 
@@ -678,25 +596,76 @@ bun dist/index.js [options]
 
 ## Development
 
+### Prerequisites
+
+| Requirement | Version | Notes |
+|:------------|:--------|:------|
+| **Bun** | &ge; 1.0 | Recommended runtime (faster builds, native TS) |
+| **Node.js** | &ge; 18 | Alternative runtime (requires `npm run build` first) |
+| **Redis** | &ge; 6.0 | Optional &mdash; needed for multi-agent, kanban, memory, context sharing |
+| **TypeScript** | 5.0+ | Strict mode enabled, bundled as dev dependency |
+
+### Build & Run
+
+| Command | Description |
+|:--------|:------------|
+| `bun install` | Install all dependencies |
+| `bun run build:bun` | Bundle for Bun runtime (`dist/`) |
+| `bun run start:bun` | Start server on `:3100` |
+| `bun run dev:bun` | Watch mode with hot-reload |
+| `npm run build` | TypeScript compilation (`tsc`) for Node.js |
+| `npm run start` | Start with Node.js |
+
+### Quality & Testing
+
+| Command | Description |
+|:--------|:------------|
+| `bun run typecheck` | Type-check without emitting (`tsc --noEmit`) |
+| `bun run lint` | ESLint with TypeScript rules |
+| `bun run format` | Prettier formatting |
+| `bun run prepare` | Run all checks (typecheck + lint + format) &mdash; use before committing |
+| `bun run add-license` | Add GPL-3.0 headers to all source files |
+| `bun test` | Run test suite (Vitest) |
+
+### Environment Variables
+
+| Variable | Default | Description |
+|:---------|:--------|:------------|
+| `OPENAI_API_KEY` | &mdash; | OpenAI API key (GPT-5, o3, Codex) |
+| `ANTHROPIC_API_KEY` | &mdash; | Anthropic API key (Claude 4.5) |
+| `GEMINI_API_KEY` | &mdash; | Google Gemini API key |
+| `GROQ_API_KEY` | &mdash; | Groq API key |
+| `DEEPSEEK_API_KEY` | &mdash; | DeepSeek API key |
+| `OPENROUTER_API_KEY` | &mdash; | OpenRouter API key |
+| `KEMDICODE_SHELL_EXEC_ENABLED` | `false` | Enable `shell-exec` tool (security opt-in) |
+| `MPC_MASTER_SECRET` | &mdash; | Master secret for MPC security tools |
+
+### Server Management
+
 ```bash
-bun install            # Install dependencies
-bun run build:bun      # Build
-bun run start:bun      # Start server
-bun run dev:bun        # Watch mode
-
-bun run lint           # ESLint
-bun run format         # Prettier
-bun run typecheck      # tsc --noEmit
-bun test               # Vitest
+# Start (auto-checks if already running)
+./start-server.sh
+
+# Manual start with custom options
+nohup bun dist/index.js --port 3100 -m claude-sonnet-4-5 >> /tmp/kemdicode-mcp.log 2>&1 &
+
+# Check status
+nc -z 127.0.0.1 3100 && echo "Running"
+
+# View logs
+tail -f /tmp/kemdicode-mcp.log
+
+# Restart after code changes
+npm run build && pkill -f "bun dist/index.js" && ./start-server.sh
 ```
 
-<details>
-<summary>Adding a new tool</summary>
+### Adding a New Tool
 
-1. Create a file in the appropriate `src/tools/` subdirectory.
-2. Define a Zod schema with `.describe()` for every field.
+1. Create a file in the appropriate `src/tools/<category>/` subdirectory.
+2. Define a Zod schema &mdash; every field **must** have `.describe()` (used for MCP JSON Schema).
 3. Implement the `UnifiedTool` interface.
-4. Register in `src/tools/index.ts`.
+4. Register the tool in `src/tools/index.ts`.
+5. Build and connected clients receive `notifications/tools/list_changed` automatically.
 
 ```typescript
 import { z } from 'zod';
@@ -704,20 +673,37 @@ import type { UnifiedTool } from '../registry.js';
 
 const schema = z.object({
   input: z.string().describe('Input value'),
+  format: z.enum(['json', 'text']).default('json').describe('Output format'),
 });
 
-export const myTool: UnifiedTool = {
+export const myTool: UnifiedTool<typeof schema> = {
   name: 'my-tool',
-  description: 'What this tool does',
+  description: 'Short description for MCP tool listing',
   zodSchema: schema,
-  execute: async (args) => {
-    const { input } = args as z.infer<typeof schema>;
-    return `Result: ${input}`;
+  // skipContextShare: true,  // Set to true if output is too large for Redis
+  execute: async (args, onProgress) => {
+    const { input, format } = args;
+
+    // Optional: stream progress to the client
+    onProgress?.('Processing...\n');
+
+    // Return JSON string
+    return JSON.stringify({ result: input, format });
   },
 };
 ```
 
-</details>
+### Project Structure Conventions
+
+| Convention | Details |
+|:-----------|:--------|
+| **Language** | TypeScript strict mode, ES modules (`.js` extensions in imports) |
+| **Schemas** | Zod with `.describe()` on every field &rarr; auto-generates JSON Schema for MCP |
+| **Error handling** | Typed errors from `utils/errors.ts` (`ValidationError`, `TimeoutError`, `CommandError`) |
+| **File paths** | `@path/file.ts` notation in tool arguments (resolved by session CWD) |
+| **Prompts** | Always English (for model consistency) |
+| **Code style** | Prettier (2-space indent, single quotes, trailing commas) + ESLint |
+| **Commit messages** | English, conventional style (`feat:`, `fix:`, `docs:`, `chore:`) |
 
 ---
 

package/dist/ai/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/ai/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,KAAK,EAAE,SAAS,CAAC;IAEjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6CD;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAS7F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKhE;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/ai/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,KAAK,EAAE,SAAS,CAAC;IAEjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8CD;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAS7F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKhE;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ai/execute.js

@@ -8,7 +8,8 @@ import { complete, getClientConfig } from './client.js';
 import { hasProviderPrefix } from './model-spec.js';
 import { buildAgentMessages, getAgentTemperature, getAgentMaxTokens, } from './agents.js';
 import { loadFileContexts, formatFileContextForPrompt } from './file-context.js';
-// Simple in-memory session storage for conversation history
+// Simple in-memory session storage for conversation history with LRU eviction
+const SESSION_HISTORY_MAX = 100;
 const sessionHistory = new Map();
 /**
  * Shared preparation logic for AI execution
@@ -58,6 +59,15 @@ export async function executeAI(options) {
         if (currentHistory.length > 20) {
             currentHistory.splice(0, currentHistory.length - 20);
         }
+        // LRU eviction: delete oldest entry when map exceeds limit
+        if (sessionHistory.size >= SESSION_HISTORY_MAX && !sessionHistory.has(historyKey)) {
+            const oldestKey = sessionHistory.keys().next().value;
+            if (oldestKey !== undefined) {
+                sessionHistory.delete(oldestKey);
+            }
+        }
+        // Re-insert to move to end of Map iteration order (LRU)
+        sessionHistory.delete(historyKey);
         sessionHistory.set(historyKey, currentHistory);
     }
     const duration = Date.now() - startTime;

package/dist/ai/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/ai/execute.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/ai/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAoDjF,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkE,CAAC;AAEjG;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAAyB;IACxD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,+EAA+E;IAC/E,6EAA6E;IAC7E,qBAAqB;IACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE7H,kCAAkC;IAClC,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACjF,WAAW,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAED,iDAAiD;IACjD,MAAM,UAAU,GAAG,SAAS,IAAI,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7E,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC;QAC9B,KAAK;QACL,QAAQ;QACR,MAAM,EAAE,CAAC,CAAC,UAAU;QACpB,WAAW,EAAE,WAAW,IAAI,mBAAmB,CAAC,KAAK,CAAC;QACtD,SAAS,EAAE,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC;QAChD,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,GAClF,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEnC,4CAA4C;IAC5C,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC5D,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtE,qDAAqD;QACrD,IAAI,cAAc,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC/B,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,2DAA2D;QAC3D,IAAI,cAAc,CAAC,IAAI,IAAI,mBAAmB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAClF,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACrD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,GAAG,CACT,QAAQ,KAAK,uBAAuB,QAAQ,IAAI;QAC9C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,KAAK,CAAC,WAAW,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CACpE,CAAC;IAEF,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAyB;IACjE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACjC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAkB;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAkB;IACtD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC;AAC7B,CAAC;AAED,6DAA6D;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/context/agent-monitor.d.ts

@@ -92,15 +92,15 @@ export declare class AgentMonitor {
     /**
      * Subscribe to real-time message updates
      */
-    subscribeToMessages(handler: MessageHandler): Promise<void>;
+    subscribeToMessages(handler: MessageHandler): Promise<() => void>;
     /**
      * Subscribe to alerts
      */
-    subscribeToAlerts(handler: AlertHandler): Promise<void>;
+    subscribeToAlerts(handler: AlertHandler): Promise<() => void>;
     /**
      * Subscribe to agent status changes
      */
-    subscribeToStatusUpdates(handler: StatusHandler): Promise<void>;
+    subscribeToStatusUpdates(handler: StatusHandler): Promise<() => void>;
     private publishStatusUpdate;
     /**
      * Update agent activity summary (agent reports what they're doing)

package/dist/context/agent-monitor.d.ts.map

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