ai-cli-mcp 2.19.0 → 2.20.1

package/docs/concept.md

@@ -1,154 +0,0 @@
-# AI CLI MCP Server - Concept
-
-## What is this?
-
-AI CLI MCP Server (`ai-cli-mcp`) は、複数のAI CLIツール（Claude Code, Codex, Gemini）をMCPプロトコル経由でバックグラウンド実行するサーバーである。
-
-## 解決する課題
-
-### 1. 単一エージェントのボトルネック
-
-CursorなどのAI IDE は内部で1つのAIエージェントを逐次実行する。複雑なマルチステップ作業（リファクタリング + テスト作成 + ドキュメント更新など）では、1つずつ順番に処理するしかなく時間がかかる。
-
-### 2. モデル/プロバイダーのロックイン
-
-IDE が採用するAIモデルに依存し、タスクごとに最適なモデルを選択できない。コード生成には Claude Opus、高速な軽作業には Haiku、といった使い分けができない。
-
-### 3. AI CLI の非同期実行の欠如
-
-Claude Code や Codex CLI は対話的に使うことを前提としており、バックグラウンドでの非同期プロセス管理をネイティブにはサポートしていない。
-
-## Core Idea
-
-**MCP を「AIエージェントのプロセスマネージャー」として使う。**
-
-```
-MCP Client (Cursor, Claude Code, etc.)
-  │
-  ├─ run(prompt, model="opus")     → PID 1234 (即座に返却)
-  ├─ run(prompt, model="gpt-5.2-codex")  → PID 1235
-  ├─ run(prompt, model="gemini-2.5-pro") → PID 1236
-  │
-  ├─ list_processes()  → 実行状況一覧
-  ├─ get_result(pid)   → 個別結果取得
-  └─ wait(pids)        → 全完了待ち
-```
-
-- **Fire-and-forget**: `run` は即座にPIDを返し、呼び出し側はブロックされない
-- **Blocking wait**: `wait(pids)` は指定プロセスが全完了するまでブロックする。利用者がポーリングループを組む必要はない。`run` で複数タスクを投げ、自分の作業を進めた後、`wait` 一発で全結果を回収するのが基本フロー
-- **マルチモデル**: プロンプトごとに異なるAIモデルを選択可能
-- **プロセスライフサイクル管理**: 起動・監視・結果取得・強制終了を統一APIで提供
-
-### 基本フロー
-
-```
-run(task1) → PID 1
-run(task2) → PID 2
-run(task3) → PID 3
-  ↓
-(呼び出し側は自分の作業を続行)
-  ↓
-wait([PID 1, 2, 3]) → ブロック → 全完了後に結果をまとめて返却
-```
-
-## Core Responsibility
-
-このツールの責務は3つに集約される:
-
-### 1. どのAI CLIからでも同じプロンプトで使える
-
-このMCPサーバーは Claude Code / Gemini CLI / Codex CLI のいずれをホスト（呼び出し元）としても、同じツール名・同じ引数・同じプロンプトで動作する。ホスト側のAIがどのプロバイダーであっても、統一されたMCPインターフェースを通じて同一の体験を提供する。
-
-### 2. CLI差異の完全な隠蔽
-
-利用者（主にAIエージェント）は Claude Code / Codex / Gemini の個別仕様を一切知る必要がない。
-
-- パーミッションフラグの違い（`--dangerously-skip-permissions` / `--full-auto` / `-y`）
-- 出力形式の違い（Claude の JSON / Codex のログ / Gemini の出力）
-- セッション管理の違い（`--session-id` / `--session` / `-s`）
-- モデル名の指定方法の違い
-
-これらはすべて内部で吸収される。利用者は「モデル名とプロンプトを渡すだけ」でよい。
-
-### 3. AI-Friendly な返り値
-
-返り値は人間ではなく **AIエージェントが消費する** ことを前提に設計する。
-
-- 各CLIの生出力（JSON、ログ、テキスト）をパースし、構造化されたオブジェクトとして返す
-- `session_id` や `exitCode` などのメタデータを統一フォーマットで付与する
-- `verbose` フラグで必要に応じてツール使用履歴も提供する
-- AIが次のアクションを判断しやすい、一貫した構造を維持する
-
-## Design Principles
-
-### Thin Wrapper, Not a Framework
-
-各AI CLIの既存機能をそのまま活かし、MCPのインターフェースでラップするだけに留める。独自のプロンプト処理やフィルタリングは行わない。
-
-### Immediate Return
-
-`run` は常に即座にPIDを返す。重い処理のブロッキングを避け、呼び出し元が他の作業を並行して進められるようにする。
-
-### CLI Agnostic
-
-Claude / Codex / Gemini のCLI差異（フラグ、出力形式）を内部で吸収し、統一されたインターフェースを提供する。新しいCLIの追加も最小限の変更で可能な構造にする。
-
-## Architecture Overview
-
-```
-src/
-├── server.ts       # MCP Server 本体 (ツールハンドラ + プロセス管理)
-├── cli-builder.ts  # モデル名 → CLI コマンド構築 (パス解決・引数組み立て)
-├── cli-utils.ts    # CLI バイナリ検出・デバッグログ
-├── parsers.ts      # 各CLI出力のパース (Claude JSON / Codex logs / Gemini)
-├── cli.ts          # スタンドアロン CLI エントリポイント
-└── cli-parse.ts    # パース単体テスト用エントリポイント
-```
-
-## Session Stacking
-
-`session_id` を使ってコンテキストを積み重ね、効率的にタスクを実行する推奨パターン。初回の `run` で構築したコンテキストを後続タスクに引き継ぎ、再読み込みコストを削減する。
-
-詳細は [Session Stacking](./session-stacking.md) を参照。
-
-## Model Aliases (Ultra)
-
-`claude-ultra` / `codex-ultra` / `gemini-ultra` というエイリアスを提供している。
-
-```
-claude-ultra  → opus
-codex-ultra   → gpt-5.4 (+ reasoning_effort: high)
-gemini-ultra  → gemini-3.1-pro-preview
-```
-
-**設計意図**: AI プロバイダーのモデル名は頻繁に変わる。利用者（特にAIエージェント）が個々のモデル名の変遷を追う必要がないよう、「そのプロバイダーの最強モデル」を指す安定したエイリアスを提供する。マッピング先はサーバー側で更新するだけで、利用者のプロンプトを変更する必要がない。
-
-## Security Model
-
-このツールは **信頼された環境でのみ使用する** ことを前提としている。
-
-- Claude Code は `--dangerously-skip-permissions` で実行される（すべてのファイル操作・コマンド実行が無許可で行われる）
-- Codex は `--full-auto` で実行される
-- Gemini は `-y`（自動承認）で実行される
-
-つまり、このMCPサーバーに接続できるクライアントは、ローカルマシン上で **任意のコード実行が可能** である。ネットワーク越しの不特定多数への公開や、信頼できないクライアントからのアクセスは想定していない。
-
-## Constraints
-
-| 制約 | 詳細 |
-|---|---|
-| インメモリプロセス管理 | プロセス情報はサーバーのメモリ上にのみ保持される。サーバー再起動で全プロセス情報が消失する |
-| stdio トランスポートのみ | HTTP/WebSocket 等のリモートトランスポートは未サポート。ローカル実行が前提 |
-| 単一マシン | 分散実行やリモートマシンへのプロセス委譲はサポートしない |
-| CLI の事前セットアップ必須 | 各AI CLIのインストール・認証はユーザーが事前に完了させる必要がある |
-
-## Key Technical Decisions
-
-| 決定 | 理由 |
-|---|---|
-| `node:child_process.spawn` でプロセス管理 | 軽量で直接的。外部依存なしにPIDベースの管理が可能 |
-| `--dangerously-skip-permissions` (Claude) | MCP経由の自動実行には非対話モードが必須 |
-| `--full-auto` (Codex) / `-y` (Gemini) | 同上。各CLIの自動承認モード |
-| `session_id` サポート | コンテキストキャッシュにより、大規模コードベースの読み込みコストを複数タスクで共有 |
-| 出力パーサーの分離 | CLI出力形式の変更に対して個別に対応可能 |
-| npx 配布 | インストール不要でMCP設定に直接記述可能 |

package/docs/development.md

@@ -1,156 +0,0 @@
-# Development Guide
-
-## Local Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/mkXultra/ai-cli-mcp.git
-cd ai-cli-mcp
-
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Development mode with auto-reloading
-npm run dev
-```
-
-## Project Structure
-
-```
-src/
-├── server.ts          # MCP server — tool registration, process management, spawn
-├── cli-builder.ts     # Pure function: CLI command assembly (model alias, validation, args)
-├── cli.ts             # CLI entrypoint for foreground execution (npm run cli.run)
-├── parsers.ts         # Output parsers for Claude / Codex / Gemini
-└── __tests__/
-    ├── cli-builder.test.ts
-    ├── server.test.ts
-    ├── parsers.test.ts
-    ├── process-management.test.ts
-    ├── validation.test.ts
-    ├── wait.test.ts
-    ├── model-alias.test.ts
-    ├── version-print.test.ts
-    ├── error-cases.test.ts
-    └── e2e.test.ts
-```
-
-### Key modules
-
-| Module | Role |
-|--------|------|
-| `cli-builder.ts` | `buildCliCommand()` — validates inputs (prompt, workFolder, model) and returns `{ cliPath, args, cwd, agent, prompt, resolvedModel }`. No MCP dependency; throws plain `Error`. |
-| `server.ts` | MCP server. Calls `buildCliCommand()` inside `handleRun`, wraps errors in `McpError`, then spawns the process in the background. |
-| `cli.ts` | Standalone CLI. Parses `process.argv`, calls `buildCliCommand()`, spawns the process in the **foreground**, parses output, and prints JSON to stdout. |
-| `parsers.ts` | `parseClaudeOutput`, `parseCodexOutput`, `parseGeminiOutput` — parse CLI stdout into structured objects. |
-
-## Testing
-
-The project includes comprehensive test suites:
-
-```bash
-# Run all tests
-npm test
-
-# Run unit tests only
-npm run test:unit
-
-# Run e2e tests (with mocks)
-npm run test:e2e
-
-# Run e2e tests locally (requires Claude CLI)
-npm run test:e2e:local
-
-# Watch mode for development
-npm run test:watch
-
-# Coverage report
-npm run test:coverage
-```
-
-For detailed testing documentation, see our [E2E Testing Guide](./e2e-testing.md).
-
-## CLI Direct Execution (`cli.run` / `cli.run.parse`)
-
-MCP サーバーを経由せず、ターミナルから直接 AI CLI を実行できます。
-
-### `cli.run` — 実行 (生出力)
-
-CLI プロセスをフォアグラウンドで起動し、**生の stdout をそのまま出力**します。
-
-```bash
-# 基本
-npm run -s cli.run -- --model sonnet --workFolder /tmp --prompt "hello"
-
-# prompt file 指定
-npm run -s cli.run -- --model gpt-5.2-codex --workFolder /path/to/project --prompt_file prompt.txt
-
-# セッション再開
-npm run -s cli.run -- --model sonnet --workFolder /tmp --prompt "continue" --session_id <id>
-
-# Codex reasoning effort
-npm run -s cli.run -- --model gpt-5.2-codex --workFolder /tmp --prompt "test" --reasoning_effort high
-```
-
-> **Tip:** `-s` (silent) で npm のスクリプトバナーを抑制します。付けないとリダイレクト時にバナーが混入します。
-
-### `cli.run.parse` — 生出力のパース
-
-`cli.run` の生出力を stdin から受け取り、構造化 JSON に変換して stdout に出力します。
-
-```bash
-# ファイル経由
-npm run -s cli.run -- --model sonnet --workFolder /tmp --prompt "hi" > raw.txt
-npm run -s cli.run.parse -- --agent claude < raw.txt
-
-# パイプ
-npm run -s cli.run -- --model sonnet --workFolder /tmp --prompt "hi" \
-  | npm run -s cli.run.parse -- --agent claude
-```
-
-`--agent` は必須です: `claude`, `codex`, `gemini` のいずれかを指定してください。
-
-## Manual Testing with MCP Inspector
-
-You can manually test the MCP server using the Model Context Protocol Inspector:
-
-```bash
-# Build the project first
-npm run build
-
-# Start the MCP Inspector with the server
-npx @modelcontextprotocol/inspector node dist/server.js
-```
-
-This will open a web interface where you can:
-1. View all available tools (`run`, `list_processes`, `get_result`, `kill_process`)
-2. Test each tool with different parameters
-3. Test different AI models including:
-   - Claude models: `sonnet`, `sonnet[1m]`, `opus`, `opusplan`, `haiku`
-   - Codex models: `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.1-codex-mini`, `gpt-5.1-codex-max`, `gpt-5.2`, `gpt-5.1`, `gpt-5.1-codex`, `gpt-5-codex`, `gpt-5-codex-mini`, `gpt-5`
-   - Gemini models: `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`
-
-Example test: Select the `run` tool and provide:
-- `prompt`: "What is 2+2?"
-- `workFolder`: "/tmp"
-- `model`: "gemini-2.5-flash"
-
-## Configuration via Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `CLAUDE_CLI_NAME` | Claude CLI binary name or absolute path (default: `claude`) |
-| `CODEX_CLI_NAME` | Codex CLI binary name or absolute path (default: `codex`) |
-| `GEMINI_CLI_NAME` | Gemini CLI binary name or absolute path (default: `gemini`) |
-| `MCP_CLAUDE_DEBUG` | Enable debug logging — `true` / `false` (default: `false`) |
-
-These can be set in your shell environment or within the `env` block of your `mcp.json` server configuration.
-
-## Contributing
-
-Contributions are welcome!
-
-Submit issues and pull requests to the [GitHub repository](https://github.com/mkXultra/ai-cli-mcp).

package/docs/e2e-testing.md

@@ -1,148 +0,0 @@
-# End-to-End Testing for Claude Code MCP
-
-This document explains how to run and maintain the end-to-end tests for the Claude Code MCP server.
-
-## Overview
-
-The e2e tests are designed to validate the Claude Code MCP server's functionality in real-world scenarios. Since the Claude CLI requires authentication and isn't easily installable in automated environments, the tests use a mock Claude CLI for automated testing and provide optional integration tests for local development.
-
-## Test Structure
-
-The e2e tests are organized into several files:
-
-- `src/__tests__/e2e.test.ts` - Main e2e test suite with mock Claude CLI
-- `src/__tests__/edge-cases.test.ts` - Edge case and error handling tests
-- `src/__tests__/utils/mcp-client.ts` - Mock MCP client for testing
-- `src/__tests__/utils/claude-mock.ts` - Mock Claude CLI implementation
-
-## Running Tests
-
-### Quick Start
-
-```bash
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Run all tests (unit + e2e)
-npm test
-
-# Run only e2e tests with mocks
-npm run test:e2e
-
-# Run unit tests only
-npm run test:unit
-```
-
-### Local Integration Testing
-
-When Claude CLI is installed locally, you can run the full integration tests:
-
-```bash
-# Run all tests including integration tests
-npm run test:e2e:local
-```
-
-The integration tests are marked with `.skip()` by default and will only run when you have Claude CLI installed and authenticated.
-
-## Test Scenarios
-
-### Basic Operations
-- Tool registration and discovery
-- Simple prompt execution
-- Error handling
-- Default working directory behavior
-
-### Working Directory Handling
-- Custom working directory support
-- Non-existent directory handling
-- Permission errors
-
-### Edge Cases
-- Input validation (missing/invalid parameters)
-- Special characters in prompts
-- Concurrent request handling
-- Large prompt handling
-- Path traversal prevention
-
-### Integration Tests (Local Only)
-- File creation with real Claude CLI
-- Git operations
-- Complex multi-step workflows
-
-## Mock Claude CLI
-
-The tests use a mock Claude CLI that simulates basic Claude behavior. The mock:
-
-1. Creates a fake executable at `~/.claude/local/claude`
-2. Responds to basic commands based on prompt patterns
-3. Simulates errors for testing error handling
-
-The mock is automatically set up before tests run and cleaned up afterwards.
-
-## Writing New Tests
-
-When adding new e2e tests:
-
-1. Use the `MCPTestClient` for communicating with the server
-2. Set up test directories in `beforeEach` and clean up in `afterEach`
-3. Use descriptive test names that explain the scenario
-4. Add appropriate assertions for both success and failure cases
-
-Example:
-
-```typescript
-it('should handle complex file operations', async () => {
-  const response = await client.callTool('claude_code', {
-    prompt: 'Create multiple files and organize them',
-    workFolder: testDir,
-  });
-
-  expect(response).toBeTruthy();
-  // Add specific assertions about the result
-});
-```
-
-## Debugging Tests
-
-To debug e2e tests:
-
-1. Enable debug mode by setting `MCP_CLAUDE_DEBUG=true`
-2. Add console.log statements in test code
-3. Use the VSCode debugger with the test runner
-4. Check server stderr output for debug logs
-
-## CI/CD Considerations
-
-The e2e tests are designed to run in CI environments without Claude CLI:
-
-- Mock tests run automatically in CI
-- Integration tests are skipped unless explicitly enabled
-- Tests use temporary directories to avoid conflicts
-- All tests clean up after themselves
-
-## Common Issues
-
-### Tests Timing Out
-- Increase timeout in `vitest.config.e2e.ts`
-- Check if the mock Claude CLI is set up correctly
-- Verify the server is building properly
-
-### Mock Not Found
-- Ensure the mock setup runs in `beforeAll`
-- Check file permissions on the mock executable
-- Verify the mock path matches the server's expectations
-
-### Integration Tests Failing
-- Ensure Claude CLI is installed and authenticated
-- Check that you're running the local test command
-- Verify Claude CLI is accessible in your PATH
-
-## Future Improvements
-
-- Add performance benchmarking tests
-- Implement stress testing scenarios
-- Add tests for specific Claude Code features
-- Create visual regression tests for output formatting

package/docs/prd.md

@@ -1,146 +0,0 @@
-# AI CLI MCP Server - Product Requirements Document
-
-## Product Overview
-
-| 項目 | 内容 |
-|---|---|
-| プロダクト名 | AI CLI MCP Server (`ai-cli-mcp`) |
-| npm パッケージ | [ai-cli-mcp](https://www.npmjs.com/package/ai-cli-mcp) |
-| 現バージョン | 2.8.2 |
-| ライセンス | MIT |
-| ターゲットユーザー | MCP対応AI IDE / CLI を利用する開発者 |
-
-## Problem Statement
-
-AI支援開発において、以下の制約がユーザーの生産性を阻害している:
-
-1. **逐次処理の制約**: IDEのAIエージェントは1タスクずつしか処理できず、並行作業ができない
-2. **モデル選択の制約**: IDEが提供するモデルに限定され、タスクに最適なモデルを選べない
-3. **環境の制約**: AI CLIツールの豊富な機能（ファイル操作、Git操作、Web検索等）をIDE内から活用できない
-
-## Goals
-
-- **ホスト非依存**: Claude Code / Gemini CLI / Codex CLI のどれをホスト（呼び出し元）として使っても、同じプロンプト・同じインターフェースで動作すること
-- **CLI差異の隠蔽**: 利用者が呼び出し先の Claude Code / Codex / Gemini の個別仕様（フラグ、出力形式、セッション管理等）を意識せず、モデル名とプロンプトだけで使えること
-- **AI-Friendly な返り値**: 各CLIの生出力をパースし、AIエージェントが次のアクションを判断しやすい構造化データとして返すこと
-- **並行実行**: MCP対応の任意のクライアントから、複数のAI CLIエージェントを並行実行できること
-- **最小セットアップ**: npx 一行で起動可能であること
-
-## Non-Goals
-
-- AI CLI ツール自体の機能拡張
-- 独自のプロンプトエンジニアリングやチェーン処理
-- Web UI やダッシュボードの提供
-- AI CLI ツールのインストールや認証の自動化
-- 人間向けのリッチなフォーマット出力（返り値はAI消費が前提）
-
-## Functional Requirements
-
-### FR-1: プロセス実行 (`run`)
-
-- ユーザーがプロンプト（文字列 or ファイルパス）、作業ディレクトリ、モデル名を指定してAIエージェントを起動できる
-- プロセスはバックグラウンドで実行され、即座にPIDが返却される
-- モデル名から適切なCLI（Claude / Codex / Gemini）が自動選択される
-- Ultra エイリアス（`claude-ultra`, `codex-ultra`, `gemini-ultra`）による簡易モデル指定をサポート
-- `session_id` による前回セッションの継続をサポート（Claude, Gemini）
-- `reasoning_effort` による推論深度の指定をサポート（Codex）
-
-### FR-2: プロセス一覧 (`list_processes`)
-
-- 実行中・完了・失敗の全プロセスをPID・エージェント種別・ステータスとともに一覧表示できる
-
-### FR-3: 結果取得 (`get_result`)
-
-- PIDを指定して、プロセスの出力（パース済み）とメタデータを取得できる
-- `verbose` オプションでツール使用履歴等の詳細情報を取得できる
-- `session_id` がある場合は結果に含まれる
-
-### FR-4: 一括待機 (`wait`)
-
-- 複数PIDを指定して、全プロセスの完了を待機できる
-- 呼び出し側がポーリングする必要はなく、`wait` 自体がブロックして完了まで待つ設計
-- `run` → (自分の作業) → `wait` で結果回収、が基本フロー
-- タイムアウト指定が可能（デフォルト: 180秒）
-
-### FR-5: プロセス終了 (`kill_process`)
-
-- PIDを指定して実行中のプロセスをSIGTERMで終了できる
-
-### FR-6: クリーンアップ (`cleanup_processes`)
-
-- 完了・失敗したプロセスをプロセスリストから削除し、メモリを解放できる
-
-## Non-Functional Requirements
-
-### NFR-1: パフォーマンス
-
-- `run` のレスポンスタイムはプロセスの実行時間に依存せず、即座に返却すること
-- 複数プロセスの同時実行をサポートすること
-
-### NFR-2: 互換性
-
-- Node.js v20 以上で動作すること
-- MCP プロトコル仕様に準拠すること（`@modelcontextprotocol/sdk` 使用）
-- stdio トランスポートで動作すること
-
-### NFR-3: 信頼性
-
-- CLIプロセスのクラッシュを適切にハンドリングし、ステータスに反映すること
-- プロセスの stdout / stderr を確実に収集すること
-
-### NFR-4: 運用性
-
-- `npx ai-cli-mcp@latest` のみで起動可能であること
-- 環境変数によるCLIパスのカスタマイズが可能であること
-- `MCP_CLAUDE_DEBUG` によるデバッグログ出力をサポートすること
-
-## Supported Models
-
-| Provider | Models |
-|---|---|
-| Claude | `sonnet`, `sonnet[1m]`, `opus`, `opusplan`, `haiku` |
-| Codex | `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.1-codex-mini`, `gpt-5.1-codex-max`, `gpt-5.2`, `gpt-5.1`, `gpt-5` |
-| Gemini | `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-3.1-pro-preview`, `gemini-3-pro-preview`, `gemini-3-flash-preview` |
-| Ultra aliases | `claude-ultra`, `codex-ultra`, `gemini-ultra` |
-
-## User Scenarios
-
-### Scenario 1: 並列タスク実行
-
-1. ユーザーがMCPクライアント経由で3つの `run` を発行（リファクタリング / テスト作成 / ドキュメント更新）
-2. それぞれ異なるモデルで即座に起動、PIDが返却される
-3. ユーザーは別作業を進めつつ、`wait` で全完了を待機
-4. 各結果をまとめて確認
-
-### Scenario 2: Session Stacking（推奨パターン）
-
-`session_id` によるセッション再開を活用し、コンテキストを積み重ねて効率的にタスクを実行する。
-
-1. `opus` で大規模コードベースを読み込み、`session_id` を取得
-2. 同じ `session_id` を後続の `run` に渡して複数タスクを並行起動
-3. コンテキストの再読み込みコストなしに、共有コンテキスト上で実行される
-4. さらに後続タスクの `session_id` を使って追加の深掘りも可能（段階的スタッキング）
-
-ポーリング不要: 手順2の後は `wait` で全完了をブロッキング待機すればよい。
-
-**注意**: 多段スタッキング（手順4）に完全対応しているのは Claude のみ。Codex / Gemini は1回のセッション再開は可能だが、再開後に新しい `session_id` が返らないため、それ以上の連鎖はできない。詳細は [Session Stacking](./session-stacking.md) を参照。
-
-## Security Model
-
-本プロダクトは **信頼されたローカル環境** での使用を前提とする。
-
-- 各AI CLIは自動承認モード（`--dangerously-skip-permissions` / `--full-auto` / `-y`）で実行されるため、接続クライアントはローカルマシン上で任意のコード実行が可能になる
-- ネットワーク越しの不特定多数への公開は想定しない
-- セキュリティ境界は「MCPサーバーへの接続可否」で制御される
-
-## Constraints
-
-- プロセス情報はインメモリのみ。サーバー再起動で消失する（永続化なし）
-- stdio トランスポートのみ対応。リモート接続は未サポート
-- 単一マシンでの実行が前提。分散実行はサポートしない
-- 各AI CLIの事前インストール・認証はユーザー責任
-
-## Release History (Notable)
-
-- **v1.x**: Claude Code MCP として Claude CLI のみサポート
-- **v2.x**: `ai-cli-mcp` にリネーム、Codex / Gemini サポート追加、非同期実行モデルに移行

package/docs/session-stacking.md

@@ -1,67 +0,0 @@
-# Session Stacking
-
-## 概要
-
-Session Stacking は、`session_id` を使ってコンテキストを積み重ね、効率的にタスクを実行する推奨パターンである。
-
-最初の `run` で構築したコンテキスト（コードベースの理解等）を `session_id` 経由で後続タスクに引き継ぐことで、同じ情報の再読み込みを避ける。
-
-## 基本フロー
-
-```
-Step 1: コンテキスト構築
-run("src/を全部読んで構造を理解して", model="opus")
-  → 結果: { session_id: "abc-123", ... }
-
-Step 2: コンテキストを再利用して並行タスク実行
-run("utilsをリファクタして", session_id="abc-123", model="sonnet")  → PID 1
-run("READMEを更新して",       session_id="abc-123", model="haiku")   → PID 2
-
-Step 3: 結果回収
-wait([PID 1, PID 2])  → ブロッキング待機 → 全結果返却
-```
-
-## 利点
-
-- **コスト削減**: 大規模コードベースの再読み込みを避けられる
-- **コンテキスト共有**: 1回の理解をベースに複数の派生タスクを実行できる
-- **段階的な深掘り**: 概要把握 → 詳細分析 → 実装、とセッションを積み重ねられる
-
-## 多段スタッキング
-
-Session Stacking の真価は、セッションを2段、3段と重ねて深掘りしていける点にある。
-
-```
-Step 1: 全体理解
-run("src/を全部読んで構造を理解して", model="opus")
-  → session_id: "abc-123"
-
-Step 2: 詳細分析（Step 1 のコンテキストを継承）
-run("認証周りの問題点を洗い出して", session_id="abc-123", model="opus")
-  → session_id: "def-456"  ← 新しい session_id が返る
-
-Step 3: 実装（Step 1 + Step 2 のコンテキストを継承）
-run("洗い出した問題を修正して", session_id="def-456", model="sonnet")
-```
-
-各ステップのコンテキストが累積されるため、後段のタスクほど深い理解の上で実行される。
-
-## 各CLIの対応状況
-
-| CLI | 1回のセッション再開 | 多段スタッキング | 備考 |
-|---|---|---|---|
-| Claude | OK | **OK** | 再開後に新しい `session_id` が返る。`--fork-session` でセッションをフォークするため、元のセッションも保持される |
-| Codex | OK | **NG** | 再開後に新しい `session_id` が返らない。2段（初回 + 1回再開）まで |
-| Gemini | OK | **NG** | 再開後に新しい `session_id` が返らない。2段（初回 + 1回再開）まで |
-
-**完全な多段 Session Stacking ができるのは現時点では Claude のみ。** Codex / Gemini は1回のセッション再開には対応しているが、再開時に新しい `session_id` が発行されないため、それ以上の連鎖はできない。これは各CLIの制約であり、本ツール側の制限ではない。
-
-## 内部実装
-
-各CLIのセッション再開方法の違いは `cli-builder.ts` 内で吸収される。利用者は `session_id` パラメータを渡すだけでよい。
-
-| CLI | 内部で実行されるフラグ |
-|---|---|
-| Claude | `-r <session_id> --fork-session` |
-| Gemini | `-r <session_id>` |
-| Codex | `exec resume <session_id>` |