opencode-ultra 0.4.0 → 0.4.1

package/README.md

@@ -1,30 +1,52 @@
 # opencode-ultra
 
-[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) をベースにした OpenCode 1.2.x プラグイン。
-マルチエージェントオーケストレーション・キーワード駆動モード切替・ルール注入を軽量な単一プラグインで実現する。
-
-## oh-my-opencode との違い
-
-| | oh-my-opencode | opencode-ultra |
-|---|---|---|
-| 構成 | フルスタック (LSP, AST-Grep, MCP, Hook 25+, Ralph Loop, Comment Checker...) | **オーケストレーション特化** — 同等機能を軽量に再実装 |
-| エージェント表 | ハードコード | **設定から動的生成** — `oh-my-opencode.json` のオーバーライドが Sisyphus のプロンプトに自動反映 |
-| プラン承認 | なし (即実行) | **Plan-First Protocol** — spawn_agent 前に Phase 形式のプランを提示、ユーザー承認を待つ |
-| 並列制御 | バックグラウンドタスク API | **Semaphore ベース** — グローバル/プロバイダー/モデル単位で同時実行制限 |
-| Categories | ハードコード | **設定可能** — カテゴリでモデル/バリアントを一括切替 |
-| Ralph Loop | 外部ツール依存 | **ビルトインツール** — `<promise>DONE</promise>` マーカーで完了検知 |
-| Comment Checker | 外部バイナリ (AST-Grep) | **正規表現ベース** — AIスロップパターン検知 |
-| Todo Enforcer | `tool.execute.after` 方式 | **`session.idle` イベント方式** — セッション idle 時に未完了 TODO を検査 |
-| MCP | Exa, Context7, grep_app | **Context7 のみ** (API キー不要で動作、キーありでレートリミット緩和) |
-| 依存 | 多数 (Exa, tmux...) | **最小限** (`@opencode-ai/plugin`, `jsonc-parser`, `zod`) |
-| 設定形式 | JSON | **JSONC** (コメント・末尾カンマ対応) |
+[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) をベースに、micode / opencode-skillful の良い部分を取り込んだ OpenCode 1.2.x プラグイン。
+マルチエージェントオーケストレーション・キーワード駆動モード切替・ルール注入・セッション継続・AST検索を軽量な単一プラグインで実現する。
+
+## 機能一覧
+
+### ツール (7)
+
+| ツール | 説明 |
+|--------|------|
+| `spawn_agent` | 並列エージェント実行 (ConcurrencyPool 制御付き) |
+| `ralph_loop` | 自律ループ実行 (`<promise>DONE</promise>` で完了検知) |
+| `cancel_ralph` | 実行中の Ralph Loop をキャンセル |
+| `batch_read` | 複数ファイル並列読み込み (最大20) |
+| `ledger_save` | Continuity Ledger の保存 (.opencode/ledgers/) |
+| `ledger_load` | Continuity Ledger の読み込み (名前指定 or 最新) |
+| `ast_search` | AST-aware コード検索 (ast-grep/sg バイナリ使用、未インストール時は自動スキップ) |
+
+### フック (9)
+
+| フック | hook ポイント | 説明 |
+|--------|-------------|------|
+| `keyword-detector` | chat.message | ultrawork/search/analyze/think キーワード検知 |
+| `rules-injector` | system.transform | .opencode/rules.md を system prompt に注入 |
+| `context-injector` | system.transform | ARCHITECTURE.md / CODE_STYLE.md を自動注入 |
+| `fragment-injector` | system.transform | エージェント毎のカスタムプロンプト断片注入 |
+| `prompt-renderer` | system.transform | モデル別 system prompt フォーマット最適化 (markdown/xml/json) |
+| `comment-checker` | tool.execute.after | Write/Edit 後の AI スロップコメント検知 |
+| `token-truncation` | tool.execute.after | 30000文字超のツール出力を先頭40%+末尾40%に圧縮 |
+| `todo-enforcer` | event (session.idle) | 未完了 TODO を検知して強制継続 |
+| `session-compaction` | experimental.session.compacting | セッション圧縮時に structured summary 生成 |
+
+### その他
+
+| 機能 | 説明 |
+|------|------|
+| **Built-in Agent Demotion** | OpenCode 標準エージェント (build/plan/triage/docs) を subagent に降格 |
+| **MCP 自動登録** | Context7 を自動登録 (API キー任意) |
+| **Plan-First Protocol** | spawn_agent 前に Phase 形式のプランを提示、ユーザー承認を待つ |
+| **Categories** | spawn_agent の category パラメータでモデル/バリアントを一括切替 |
+| **Concurrency Pool** | Semaphore ベースの global/provider/model 三層並列制御 |
 
 ## アーキテクチャ
 
 ```
 User
   │
-  │  "ultrawork" / "ulw" キーワード
+  │  "ultrawork" / "ulw" / "think hard" キーワード
   │
   ▼
 ┌──────────────────────────────────────────────┐
@@ -32,27 +54,37 @@ User
 │                                              │
 │  chat.message hook                           │
 │  ├─ keyword-detector                         │
-│  │  └─ ultrawork / search / analyze          │
+│  │  └─ ultrawork / search / analyze / think  │
 │  └─ ultrawork → variant: "max"               │
 │                                              │
 │  system.transform hook                       │
 │  ├─ keyword message injection                │
-│  └─ rules-injector (.opencode/rules.md)      │
+│  ├─ rules-injector (.opencode/rules.md)      │
+│  ├─ context-injector (ARCHITECTURE/CODE_STYLE)│
+│  ├─ fragment-injector (per-agent fragments)  │
+│  └─ prompt-renderer (markdown/xml/json)      │
 │                                              │
 │  tool.execute.after hook                     │
-│  └─ comment-checker (Write/Edit 後に検査)     │
+│  ├─ comment-checker (Write/Edit 後に検査)     │
+│  └─ token-truncation (30000文字超を圧縮)     │
+│                                              │
+│  session.compacting hook                     │
+│  └─ session-compaction (structured summary)  │
 │                                              │
 │  event hook                                  │
 │  ├─ session cleanup                          │
 │  └─ todo-enforcer (session.idle 時に検査)     │
 │                                              │
 │  config hook                                 │
-│  └─ register agents to OpenCode              │
+│  ├─ register agents to OpenCode              │
+│  └─ demote built-in agents to subagent       │
 │                                              │
 │  tools                                       │
 │  ├─ spawn_agent (並列実行 + 並列制御)         │
-│  ├─ ralph_loop (自律ループ実行)               │
-│  └─ cancel_ralph (ループキャンセル)           │
+│  ├─ ralph_loop / cancel_ralph                │
+│  ├─ batch_read (複数ファイル並列読み込み)     │
+│  ├─ ledger_save / ledger_load (文脈継続)     │
+│  └─ ast_search (構文木検索, optional)        │
 │                                              │
 │  MCP registration                            │
 │  └─ context7 (自動登録)                       │
@@ -72,13 +104,13 @@ User
 
 ## エージェント構成
 
-Sisyphus (オーケストレーター) が直接ツールを使わず、全てを spawn_agent 経由でサブエージェントに委任する。
+Sisyphus (オーケストレーター) が直接コードを読み、実装はサブエージェントに委任する。
 
 ### ビルトインデフォルト
 
 | Agent | 役割 | デフォルトモデル | モード |
 |-------|------|-----------------|--------|
-| **sisyphus** | オーケストレーター — 分析・計画・委任 | anthropic/claude-opus-4-5 | primary |
+| **sisyphus** | オーケストレーター — 読み込み+分析+計画+委任 | openai-codex/gpt-5.3-codex | primary |
 | **oracle** | 設計・デバッグ・アーキテクチャ判断 | openai/gpt-5.2 | subagent |
 | **explore** | 高速コードベース偵察 | anthropic/claude-haiku-4-5 | subagent |
 | **librarian** | ドキュメント・ベストプラクティス調査 | anthropic/claude-sonnet-4-5 | subagent |
@@ -88,314 +120,175 @@ Sisyphus (オーケストレーター) が直接ツールを使わず、全て
 | **atlas** | タスク管理・進捗追跡 | anthropic/claude-sonnet-4-5 | subagent |
 | **multimodal-looker** | 画像・スクリーンショット解析 | anthropic/claude-sonnet-4-5 | subagent |
 
-**全てのモデルは `oh-my-opencode.json` でオーバーライド可能。** Sisyphus のプロンプト内エージェント表にはオーバーライド後の実際のモデル名が動的に埋め込まれる。
-
-### Sisyphus の制約
+全てのモデルは `oh-my-opencode.json` でオーバーライド可能。
 
-Sisyphus は以下のツールが**物理的に無効化**されている:
+### Sisyphus のツール権限
 
 ```
-Grep: false, Glob: false, Read: false,
-Write: false, Edit: false, Bash: false
+Grep: true, Glob: true, Read: true   ← 直接読み込み可能
+Write: false, Edit: false, Bash: false ← サブエージェントに委任
 ```
 
-使えるのは `spawn_agent`、`ralph_loop`、`cancel_ralph` と TODO 系ツールのみ。これにより高コストな Orchestrator トークンの浪費を防ぎ、適切なモデルへの委任を強制する。
-
-## Plan-First Protocol
+## Continuity Ledger
 
-Sisyphus は spawn_agent を呼ぶ前に、必ず以下の形式でプランを提示する:
-
-```
-## Execution Plan
-
-### Phase 1: 偵察 (parallel)
-- [ ] API ルート探索 → explore (gpt-5.3-codex-spark)
-- [ ] フレームワーク仕様調査 → librarian (glm-4.7)
-
-### Phase 2: 実装 (after Phase 1)
-- [ ] エンドポイント実装 → hephaestus (gpt-5.2)
-
-### Phase 3: Review
-- [ ] コードレビュー → momus (gpt-5.3-codex)
-
-Estimated agents: 4 | Phases: 3
-```
-
-- 独立タスクは同一 Phase にグループ化 (並列実行)
-- 依存関係があるタスクは別 Phase
-- エージェント名 + 実際のモデル名を表示
-- **「このプランで進めますか？」で承認待ち — OK するまで実行しない**
-
-## spawn_agent ツール
-
-Sisyphus が使う並列エージェント実行ツール。
+セッション間の文脈を引き継ぐマークダウンドキュメント。`.opencode/ledgers/` に保存される。
 
 ```typescript
-spawn_agent({
-  agents: [
-    { agent: "explore", prompt: "Find all API routes in src/", description: "Route discovery" },
-    { agent: "librarian", prompt: "Research Express middleware best practices", description: "Middleware docs" },
-    { agent: "hephaestus", prompt: "Implement the feature", description: "Implementation", category: "deep" }
-  ]
-})
-```
-
-- 複数エージェントは **Promise.all で並列実行**（ConcurrencyPool による同時実行制御付き）
-- 各エージェントは**エフェメラルセッション**で起動 — 完了後に自動削除
-- 内部セッションには `internalSessions` フラグを付与し、**フックの再帰を防止**
-- 進捗は `toolCtx.metadata({ title })` でステータスバーに表示
-- Toast 通知で個別エージェントの完了を通知
-- **`category` パラメータ**でモデル/バリアントをカテゴリから自動解決
+// 保存
+ledger_save({ name: "auth-refactor", content: "## Context\n..." })
+// → Saved to .opencode/ledgers/auth-refactor.md
 
-### 並列制御 (Concurrency)
+// 読み込み (名前指定)
+ledger_load({ name: "auth-refactor" })
 
-`background_task` が設定されていると、Semaphore ベースの並列制御が有効になる。
-
-```
-spawn_agent に 5 エージェント渡す
-  → defaultConcurrency: 3 なら同時 3 個まで
-  → 残りは空きを待って順次実行
+// 読み込み (最新)
+ledger_load({})
 ```
 
-| 設定フィールド | 目的 | 動作 |
-|---------------|------|------|
-| `defaultConcurrency` | 全体の同時実行上限 | 全エージェント合計で N 個まで同時実行 |
-| `providerConcurrency` | プロバイダー別上限 (例: openai: 8) | 同一プロバイダーのエージェントを N 個に制限 |
-| `modelConcurrency` | モデル別上限 (例: gpt-5.2: 2) | 同一モデルのエージェントを N 個に制限 |
+## Fragment Injection
 
-セマフォは model → provider → global の順で acquire し、global → provider → model の順で release する。エラー時も確実に release される。
-
-`background_task` 未設定の場合は制限なし（従来通り全エージェント同時発火）。
-
-## Categories
-
-spawn_agent の `category` パラメータでモデル/バリアントを一括切替できる。
-
-### ビルトインカテゴリ
-
-| カテゴリ | 用途 | デフォルトモデル | バリアント |
-|---------|------|-----------------|-----------|
-| `visual-engineering` | フロントエンド/UI実装 | google/gemini-3-pro | — |
-| `ultrabrain` | 最高精度タスク | openai/gpt-5.3-codex | xhigh |
-| `deep` | 深い分析・複雑ロジック | openai/gpt-5.3-codex | medium |
-| `quick` | 高速・低コストタスク | anthropic/claude-haiku-4-5 | — |
-| `writing` | ドキュメント・文章 | zai-coding-plan/glm-4.7 | — |
-
-設定ファイルでカスタムカテゴリの追加やビルトインの上書きが可能:
+エージェント毎にカスタムプロンプト断片を注入する。
 
 ```jsonc
 {
-  "categories": {
-    "quick": { "model": "openai/gpt-4o-mini" },
-    "my-custom": { "model": "custom/model", "variant": "high" }
+  "fragments": {
+    "hephaestus": [".opencode/fragments/strict-coding.md"],
+    "sisyphus": [".opencode/fragments/planning-rules.md"]
   }
 }
 ```
 
-## Ralph Loop
-
-自律ループ実行ツール。エージェントが `<promise>DONE</promise>` を出力するか、最大イテレーション数に達するまで繰り返し実行する。
-
-```typescript
-ralph_loop({
-  prompt: "Implement all unit tests for the auth module",
-  agent: "hephaestus",     // default
-  maxIterations: 10         // default
-})
-```
-
-- 各イテレーションで前回の進捗をレビューし、続きから再開するよう指示
-- ステータスバーに `Ralph Loop [3/10] — hephaestus` のように進捗表示
-- `cancel_ralph` ツールで実行中のループを全てキャンセル可能
-
-## Todo Enforcer
-
-セッションが idle になったとき、最後の assistant メッセージに未完了の TODO（`- [ ]`）がある場合、強制継続プロンプトを送信する。
-
-- **最大 5 回**（デフォルト）の強制で無限ループを防止
-- spawn_agent のサブセッションには適用されない
-- `disabled_hooks: ["todo-enforcer"]` で無効化可能
-- 設定で最大回数を変更可能: `"todo_enforcer": { "maxEnforcements": 3 }`
-
-## Comment Checker
-
-Write / Edit ツール実行後に、書き込まれたファイルのコメント品質を検査する。
+指定ファイルの内容が該当エージェントの system prompt に追加される。
 
-### 検出するパターン
+## Per-model Prompt Renderer
 
-- コメント比率が 30% を超えるファイル
-- 80 文字超の行コメント (`// This function does...`)
-- 説明的すぎる冒頭 (`// This`, `// The`, `// We`, `// Here`, `// Note:`)
-- AI プレースホルダー (`// TODO: implement`)
-- lint 回避コメント (`// eslint-disable`)
-- 300 文字超の巨大 JSDoc
-
-閾値超えの場合、ツール出力に `[Comment Checker]` 警告を追加する。
+モデルに応じて system prompt のフォーマットを最適化する。
 
 ```jsonc
 {
-  "comment_checker": {
-    "maxRatio": 0.3,       // コメント比率閾値 (default: 0.3)
-    "slopThreshold": 3     // AIスロップパターン数閾値 (default: 3)
-  }
-}
-```
-
-## MCP 自動登録
-
-プラグイン初期化時に以下の MCP サーバーを自動登録する:
-
-| MCP | パッケージ | API キー |
-|-----|-----------|----------|
-| **Context7** | `@upstash/context7-mcp` | オプション（あるとレートリミット緩和） |
-
-API キーの渡し方:
-
-```jsonc
-{
-  "mcp_api_keys": {
-    "context7": "ctx7sk-..."
+  "prompt_renderer": {
+    "default": "markdown",
+    "model_overrides": {
+      "anthropic/claude-sonnet-4-5": "xml",
+      "openai/gpt-5.2": "json"
+    }
   }
 }
 ```
 
-または環境変数 `CONTEXT7_API_KEY` を設定。
-
-`disabled_mcps: ["context7"]` で無効化可能。
+| フォーマット | 出力例 |
+|-------------|--------|
+| `markdown` | そのまま (デフォルト) |
+| `xml` | `<section name="Rules">...</section>` |
+| `json` | `{"section":"Rules","content":"..."}` |
 
 ## キーワード検知
 
-ユーザーのプロンプトからキーワードを検知し、system prompt に動作モード指示を注入する。
-コードブロック (`` ``` `` / `` ` ``) 内のキーワードは無視する。
-
 | キーワード | モード | 効果 |
 |-----------|--------|------|
-| `ultrawork` / `ulw` | ultrawork | variant を "max" に設定。全エージェント活用・並列実行・TODO 追跡を強制。ユーザーメッセージからキーワードを除去 |
-| `search` / `find` / `探して` / `検索` 等 | search | 複数 explore + librarian エージェントを並列起動。網羅的検索を強制 |
-| `analyze` / `調査` / `なぜ` / `debug` 等 | analyze | コンテキスト収集フェーズを実行。複雑な場合は Oracle に委任 |
+| `ultrawork` / `ulw` | ultrawork | variant "max"、全エージェント活用 |
+| `search` / `find` / `探して` 等 | search | 網羅的検索 |
+| `analyze` / `調査` / `debug` 等 | analyze | コンテキスト収集 |
+| `think hard` / `じっくり` / `熟考` 等 | think | Extended thinking 有効化 |
 
 日本語・中国語キーワードにも対応。
 
-## ルール注入
-
-`<project>/.opencode/rules.md` が存在する場合、その内容を system prompt に `## Project Rules` として自動注入する。ファイルの mtime でキャッシュし、変更時のみ再読み込み。
-
 ## 設定
 
-2 段階の設定マージ:
+2段階の設定マージ:
 
 1. **ユーザー設定**: `~/.config/opencode/oh-my-opencode.json[c]`
 2. **プロジェクト設定**: `<project>/.opencode/oh-my-opencode.json[c]`
 
-プロジェクト設定がユーザー設定をオーバーライドする。
-
 ### 設定スキーマ
 
 ```jsonc
 {
-  // エージェントごとのモデル・プロンプトオーバーライド
+  // エージェントオーバーライド
   "agents": {
     "sisyphus": { "model": "openai/gpt-5.2" },
-    "oracle": { "model": "zai-coding-plan/glm-5" },
-    "explore": { "model": "openai/gpt-5.3-codex-spark" }
+    "oracle": { "model": "zai-coding-plan/glm-5" }
   },
 
-  // カテゴリ (spawn_agent の category パラメータで使用)
+  // カテゴリ
   "categories": {
     "quick": { "model": "openai/gpt-4o-mini" }
   },
 
+  // Fragment Injection
+  "fragments": {
+    "hephaestus": [".opencode/fragments/strict.md"]
+  },
+
+  // Per-model Renderer
+  "prompt_renderer": {
+    "default": "markdown",
+    "model_overrides": {}
+  },
+
   // 無効化
   "disabled_agents": [],
-  "disabled_hooks": ["keyword-detector", "rules-injector", "todo-enforcer", "comment-checker"],
-  "disabled_tools": ["ralph_loop", "cancel_ralph", "spawn_agent"],
-  "disabled_mcps": ["context7"],
+  "disabled_hooks": [],   // keyword-detector, rules-injector, context-injector,
+                          // fragment-injector, prompt-renderer, comment-checker,
+                          // token-truncation, todo-enforcer, session-compaction
+  "disabled_tools": [],   // spawn_agent, ralph_loop, cancel_ralph,
+                          // batch_read, ledger_save, ledger_load, ast_search
+  "disabled_mcps": [],    // context7
+
+  // Built-in Agent Demotion (default: true)
+  "demote_builtin": true,
 
   // 並列制御
   "background_task": {
     "defaultConcurrency": 3,
-    "providerConcurrency": {
-      "openai": 8,
-      "zai-coding-plan": 10
-    },
-    "modelConcurrency": {
-      "openai/gpt-5.2": 2
-    }
+    "providerConcurrency": { "openai": 8 },
+    "modelConcurrency": { "openai/gpt-5.2": 2 }
   },
 
-  // Comment Checker 設定
-  "comment_checker": {
-    "maxRatio": 0.3,
-    "slopThreshold": 3
-  },
+  // Token Truncation
+  "token_truncation": { "maxChars": 30000 },
 
-  // Todo Enforcer 設定
-  "todo_enforcer": {
-    "maxEnforcements": 5
-  },
+  // Comment Checker
+  "comment_checker": { "maxRatio": 0.3, "slopThreshold": 3 },
+
+  // Todo Enforcer
+  "todo_enforcer": { "maxEnforcements": 5 },
 
   // MCP API キー
-  "mcp_api_keys": {
-    "context7": "ctx7sk-..."
-  }
+  "mcp_api_keys": { "context7": "ctx7sk-..." }
 }
 ```
 
-### エージェントオーバーライドで使えるフィールド
-
-| フィールド | 型 | 説明 |
-|-----------|---|------|
-| `model` | string | 使用モデル (provider/model 形式) |
-| `description` | string | エージェントの説明 |
-| `prompt` | string | システムプロンプト全体を差し替え |
-| `prompt_append` | string | プロンプト末尾に追記 |
-| `disable` | boolean | 個別に無効化 |
-| `mode` | `"subagent"` / `"primary"` / `"all"` | 実行モード |
-| `maxTokens` | number | 最大出力トークン |
-| `thinking` | `{ type, budgetTokens }` | 思考トークン設定 |
-| `reasoningEffort` | `"low"` / `"medium"` / `"high"` / `"xhigh"` | 推論レベル |
-| `temperature` | number (0-2) | サンプリング温度 |
-| `top_p` | number (0-1) | Top-p |
-| `category` | string | デフォルトカテゴリ |
-| `variant` | string | モデルバリアント |
-
-## フック再帰防止
-
-spawn_agent / ralph_loop で生成されたエフェメラルセッションは `internalSessions` Set で追跡される。`chat.message`、`system.transform`、`tool.execute.after`、`event` の各フックは内部セッションに対してスキップされ、キーワード検知・ルール注入・Comment Checker・Todo Enforcer がサブエージェントに二重適用されることを防ぐ。
-
 ## プロジェクト構成
 
 ```
 opencode-ultra/
 ├── src/
-│   ├── index.ts                  # プラグインエントリポイント (hook/tool/MCP 統合)
-│   ├── config.ts                 # 設定ロード・マージ・バリデーション (Zod)
+│   ├── index.ts                    # プラグインエントリポイント
+│   ├── config.ts                   # 設定ロード・マージ・バリデーション
 │   ├── agents/
-│   │   ├── types.ts              # AgentDef 型定義
-│   │   └── index.ts              # ビルトインエージェント定義 + 動的プロンプト生成
+│   │   ├── types.ts                # AgentDef 型定義
+│   │   └── index.ts                # ビルトインエージェント + 動的プロンプト生成
 │   ├── hooks/
-│   │   ├── keyword-detector.ts   # ultrawork/search/analyze キーワード検知
-│   │   ├── rules-injector.ts     # .opencode/rules.md 注入 (mtime キャッシュ)
-│   │   ├── todo-enforcer.ts      # session.idle 時の未完了 TODO 強制継続
-│   │   └── comment-checker.ts    # Write/Edit 後の AI スロップ検知
+│   │   ├── keyword-detector.ts     # ultrawork/search/analyze/think 検知
+│   │   ├── rules-injector.ts       # rules.md + ARCHITECTURE.md + CODE_STYLE.md 注入
+│   │   ├── fragment-injector.ts    # エージェント毎の断片注入
+│   │   ├── prompt-renderer.ts      # モデル別フォーマット変換
+│   │   ├── comment-checker.ts      # AI スロップコメント検知
+│   │   ├── token-truncation.ts     # ツール出力の賢い圧縮
+│   │   ├── todo-enforcer.ts        # 未完了 TODO 強制継続
+│   │   └── session-compaction.ts   # セッション圧縮サマリ生成
 │   ├── tools/
-│   │   ├── spawn-agent.ts        # spawn_agent ツール (並列実行 + 並列制御 + カテゴリ)
-│   │   └── ralph-loop.ts         # ralph_loop / cancel_ralph ツール (自律ループ)
-│   ├── concurrency/
-│   │   ├── semaphore.ts          # 汎用セマフォ
-│   │   ├── pool.ts               # ConcurrencyPool (global/provider/model 三層制御)
-│   │   └── index.ts              # バレルエクスポート
-│   ├── categories/
-│   │   └── index.ts              # ビルトインカテゴリ + resolveCategory
-│   ├── mcp/
-│   │   ├── servers.ts            # ビルトイン MCP サーバー定義
-│   │   └── index.ts              # MCP 登録ロジック
-│   └── shared/
-│       ├── paths.ts              # XDG パス解決
-│       ├── jsonc.ts              # JSONC パーサー
-│       ├── log.ts                # [opencode-ultra] プレフィックスログ
-│       └── index.ts              # バレルエクスポート
-├── __test__/                     # Bun テスト (70 tests)
+│   │   ├── spawn-agent.ts          # 並列エージェント実行
+│   │   ├── ralph-loop.ts           # 自律ループ実行
+│   │   ├── batch-read.ts           # 複数ファイル並列読み込み
+│   │   ├── continuity-ledger.ts    # セッション間文脈継続
+│   │   └── ast-search.ts           # AST-aware コード検索
+│   ├── concurrency/                # Semaphore + ConcurrencyPool
+│   ├── categories/                 # ビルトインカテゴリ
+│   ├── mcp/                        # MCP サーバー登録
+│   └── shared/                     # ユーティリティ
+├── __test__/                       # Bun テスト (92 tests, 20 files)
 ├── package.json
 ├── tsconfig.json
 └── .gitignore
@@ -404,13 +297,8 @@ opencode-ultra/
 ## ビルド・テスト
 
 ```bash
-# 依存インストール
 bun install
-
-# ビルド
-bun build src/index.ts --outdir dist --target bun --format esm
-
-# テスト
+bun run build
 bun test
 ```
 

package/dist/hooks/prompt-renderer.d.ts

@@ -1,13 +1,14 @@
+import type { ModelRef } from "../shared/types";
 export type PromptFormat = "markdown" | "xml" | "json";
 export type PromptRendererConfig = {
     default: PromptFormat;
     model_overrides: Record<string, PromptFormat>;
 };
-export declare function resolvePromptFormat(inputModel: any, config?: Partial<PromptRendererConfig>): PromptFormat;
+export declare function resolvePromptFormat(inputModel: ModelRef | undefined, config?: Partial<PromptRendererConfig>): PromptFormat;
 export declare function formatSystemSection(format: PromptFormat, content: string): string;
 export declare function createPromptRendererHook(internalSessions: Set<string>, config?: Partial<PromptRendererConfig>): (input: {
     sessionID?: string;
-    model?: unknown;
+    model?: ModelRef;
 }, output: {
     system: string[];
 }) => void;

package/dist/hooks/session-compaction.d.ts

@@ -11,7 +11,7 @@ type MessageLike = {
 };
 export declare function buildSessionSummary(messages: MessageLike[]): string;
 export declare function createSessionCompactionHook(ctx: {
-    client: any;
+    client: Pick<import("../shared/types").ExtendedClient, "session">;
 }, internalSessions: Set<string>): (input: {
     sessionID: string;
 }, output: {

package/dist/index.js

@@ -14369,6 +14369,49 @@ function log(message, data) {
     console.error(`${PREFIX} ${message}`);
   }
 }
+// src/shared/ttl-map.ts
+class TtlMap {
+  map = new Map;
+  maxSize;
+  ttlMs;
+  constructor(opts = {}) {
+    this.maxSize = opts.maxSize ?? 1000;
+    this.ttlMs = opts.ttlMs ?? 0;
+  }
+  get(key) {
+    const entry = this.map.get(key);
+    if (!entry)
+      return;
+    if (this.ttlMs > 0 && Date.now() - entry.createdAt > this.ttlMs) {
+      this.map.delete(key);
+      return;
+    }
+    return entry.value;
+  }
+  set(key, value) {
+    if (this.map.has(key)) {
+      this.map.delete(key);
+    }
+    if (this.map.size >= this.maxSize) {
+      const oldest = this.map.keys().next().value;
+      if (oldest !== undefined)
+        this.map.delete(oldest);
+    }
+    this.map.set(key, { value, createdAt: Date.now() });
+  }
+  has(key) {
+    return this.get(key) !== undefined;
+  }
+  delete(key) {
+    return this.map.delete(key);
+  }
+  get size() {
+    return this.map.size;
+  }
+  clear() {
+    this.map.clear();
+  }
+}
 // src/config.ts
 var AgentOverrideSchema = exports_external.object({
   model: exports_external.string().optional(),
@@ -14824,7 +14867,7 @@ var THINK_MESSAGE = `Extended thinking enabled. Take your time to reason thoroug
 // src/hooks/rules-injector.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
-var cache = new Map;
+var cache = new TtlMap({ maxSize: 50, ttlMs: 10 * 60 * 1000 });
 function loadCachedFile(filePath) {
   try {
     if (!fs2.existsSync(filePath))
@@ -14882,7 +14925,7 @@ function loadCodeStyle(projectDir) {
 // src/hooks/fragment-injector.ts
 import * as fs3 from "fs";
 import * as path3 from "path";
-var cache2 = new Map;
+var cache2 = new TtlMap({ maxSize: 100, ttlMs: 10 * 60 * 1000 });
 async function readCached(absPath) {
   try {
     const st = await fs3.promises.stat(absPath);
@@ -27322,7 +27365,8 @@ function resolveCategory(categoryName, configCategories) {
 
 // src/tools/spawn-agent.ts
 function showToast(ctx, title, message, variant = "info") {
-  ctx.client?.tui?.showToast?.({
+  const client = ctx.client;
+  client.tui?.showToast?.({
     body: { title, message, variant, duration: 2000 }
   })?.catch?.(() => {});
 }
@@ -27427,6 +27471,18 @@ spawn_agent({
       if (!agents || agents.length === 0) {
         return "No agents specified.";
       }
+      for (let i = 0;i < agents.length; i++) {
+        const t = agents[i];
+        if (!t.agent || typeof t.agent !== "string" || t.agent.trim().length === 0) {
+          return `Error: agents[${i}].agent is required (non-empty string)`;
+        }
+        if (!t.prompt || typeof t.prompt !== "string" || t.prompt.trim().length === 0) {
+          return `Error: agents[${i}].prompt is required (non-empty string)`;
+        }
+        if (!t.description || typeof t.description !== "string") {
+          return `Error: agents[${i}].description is required`;
+        }
+      }
       const agentNames = agents.map((a) => a.agent);
       log("spawn_agent", { count: agents.length, agents: agentNames });
       showToast(ctx, "spawn_agent", `${agents.length} agents: ${agentNames.join(", ")}`);
@@ -28190,6 +28246,8 @@ class Semaphore {
     });
   }
   release() {
+    if (this.active <= 0)
+      return;
     this.active--;
     const next = this.queue.shift();
     if (next)
@@ -28279,7 +28337,8 @@ async function registerMcps(ctx, disabled, apiKeys) {
       if (config3.env) {
         body.env = config3.env;
       }
-      await ctx.client.mcp?.add?.({ body });
+      const client = ctx.client;
+      await client.mcp?.add?.({ body });
       log(`MCP ${name} registered${apiKey ? " (with API key)" : ""}`);
     } catch (err) {
       log(`MCP ${name} registration failed: ${err}`);
@@ -28313,10 +28372,10 @@ var OpenCodeUltra = async (ctx) => {
   const todoEnforcer = createTodoEnforcer(ctx, internalSessions, pluginConfig.todo_enforcer?.maxEnforcements);
   const commentCheckerHook = createCommentCheckerHook(internalSessions, pluginConfig.comment_checker?.maxRatio, pluginConfig.comment_checker?.slopThreshold);
   const tokenTruncationHook = createTokenTruncationHook(internalSessions, pluginConfig.token_truncation?.maxChars);
-  const sessionCompactionHook = createSessionCompactionHook(ctx, internalSessions);
+  const sessionCompactionHook = createSessionCompactionHook({ client: ctx.client }, internalSessions);
   const fragmentInjector = createFragmentInjector(ctx, internalSessions, pluginConfig.fragments);
   const promptRendererHook = createPromptRendererHook(internalSessions, pluginConfig.prompt_renderer);
-  const pendingKeywords = new Map;
+  const pendingKeywords = new TtlMap({ maxSize: 200, ttlMs: 5 * 60 * 1000 });
   log("Config loaded", {
     agentCount: Object.keys(agents).length,
     disabledHooks: [...disabledHooks],
@@ -28397,7 +28456,8 @@ var OpenCodeUltra = async (ctx) => {
             if (output.message.variant === undefined) {
               output.message.variant = "max";
             }
-            ctx.client?.tui?.showToast?.({
+            const client = ctx.client;
+            client.tui?.showToast?.({
               body: {
                 title: "ULTRAWORK MODE",
                 message: "Maximum precision engaged. All agents at your disposal.",

package/dist/shared/index.d.ts

@@ -1,3 +1,5 @@
 export { getConfigDir, getCacheDir, getDataDir } from "./paths";
 export { parseJsonc } from "./jsonc";
 export { log } from "./log";
+export type { ExtendedClient, ModelRef, ToastOptions, SystemTransformInput } from "./types";
+export { TtlMap } from "./ttl-map";

package/dist/shared/ttl-map.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Simple Map with max size eviction (LRU-like: evicts oldest entry when full).
+ * Optionally supports TTL-based expiry.
+ */
+export declare class TtlMap<K, V> {
+    private map;
+    private maxSize;
+    private ttlMs;
+    constructor(opts?: {
+        maxSize?: number;
+        ttlMs?: number;
+    });
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    get size(): number;
+    clear(): void;
+}

package/dist/shared/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Extended type definitions for OpenCode client APIs that are not (yet) in @opencode-ai/sdk types.
+ * These describe the actual runtime shape observed in OpenCode 1.2.x.
+ */
+/** Model identifier as passed through hook input */
+export interface ModelRef {
+    providerID?: string;
+    modelID?: string;
+}
+/** Toast notification (TUI-only, non-standard) */
+export interface ToastOptions {
+    body: {
+        title: string;
+        message: string;
+        variant?: "info" | "success" | "warning" | "error";
+        duration?: number;
+    };
+}
+/** Extended OpenCode client with optional TUI and MCP methods */
+export interface ExtendedClient {
+    session: {
+        create: (opts: {
+            body: Record<string, unknown>;
+            query?: {
+                directory?: string;
+            };
+        }) => Promise<{
+            data?: {
+                id?: string;
+            };
+        }>;
+        prompt: (opts: {
+            path: {
+                id: string;
+            };
+            body: {
+                parts: Array<{
+                    type: string;
+                    text: string;
+                }>;
+                agent?: string;
+            };
+            query?: {
+                directory?: string;
+            };
+        }) => Promise<unknown>;
+        messages: (opts: {
+            path: {
+                id: string;
+            };
+            query?: {
+                directory?: string;
+            };
+        }) => Promise<{
+            data?: Array<{
+                info?: {
+                    role?: string;
+                };
+                parts?: Array<{
+                    type: string;
+                    text?: string;
+                }>;
+            }>;
+        }>;
+        delete: (opts: {
+            path: {
+                id: string;
+            };
+            query?: {
+                directory?: string;
+            };
+        }) => Promise<unknown>;
+        listMessages?: (opts: {
+            id: string;
+        }) => Promise<{
+            messages?: unknown[];
+        } | unknown[]>;
+    };
+    tui?: {
+        showToast?: (opts: ToastOptions) => Promise<void>;
+    };
+    mcp?: {
+        add?: (opts: {
+            body: Record<string, unknown>;
+        }) => Promise<void>;
+    };
+}
+/** System transform hook input */
+export interface SystemTransformInput {
+    sessionID?: string;
+    model?: ModelRef;
+    agent?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ultra",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Lightweight OpenCode 1.2.x plugin — ultrawork mode, multi-agent orchestration, rules injection",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",