oh-my-opencode 2.7.0 → 2.7.1

package/README.ja.md

@@ -390,6 +390,39 @@ gh repo star code-yeongyu/oh-my-opencode
 </details>
 
 
+## アンインストール
+
+oh-my-opencode を削除するには：
+
+1. **OpenCode 設定からプラグインを削除**
+
+   `~/.config/opencode/opencode.json` (または `opencode.jsonc`) を編集し、`plugin` 配列から `"oh-my-opencode"` を削除します：
+
+   ```bash
+   # jq を使用する例
+   jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
+       ~/.config/opencode/opencode.json > /tmp/oc.json && \
+       mv /tmp/oc.json ~/.config/opencode/opencode.json
+   ```
+
+2. **設定ファイルの削除 (オプション)**
+
+   ```bash
+   # ユーザー設定を削除
+   rm -f ~/.config/opencode/oh-my-opencode.json
+
+   # プロジェクト設定を削除 (存在する場合)
+   rm -f .opencode/oh-my-opencode.json
+   ```
+
+3. **削除の確認**
+
+   ```bash
+   opencode --version
+   # プラグインがロードされなくなっているはずです
+   ```
+
+
 ## 機能
 
 ### Agents: あなたの新しいチームメイト
@@ -457,6 +490,19 @@ Ask @explore for the policy on this feature
 - **ast_grep_search**: AST 認識コードパターン検索 (25言語対応)
 - **ast_grep_replace**: AST 認識コード置換
 
+#### セッション管理
+
+OpenCode セッション履歴をナビゲートおよび検索するためのツール：
+
+- **session_list**: 日付およびリミットでフィルタリングしながらすべての OpenCode セッションを一覧表示
+- **session_read**: 特定のセッションからメッセージと履歴を読み取る
+- **session_search**: セッションメッセージ全体を全文検索
+- **session_info**: セッションに関するメタデータと統計情報を取得
+
+これらのツールにより、エージェントは以前の会話を参照し、セッション間の継続性を維持できます。
+
+- **call_omo_agent**: 専門的な explore/librarian エージェントを起動。非同期実行のための `run_in_background` パラメータをサポート。
+
 #### Context Is All You Need
 - **Directory AGENTS.md / README.md Injector**: ファイルを読み込む際、`AGENTS.md` と `README.md` の内容を自動的に注入します。ファイルディレクトリからプロジェクトルートまで遡り、パス上の **すべて** の `AGENTS.md` ファイルを収集します。ネストされたディレクトリごとの指示をサポートします：
   ```
@@ -619,7 +665,7 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
 
 | プラットフォーム | ユーザー設定パス |
 |------------------|------------------|
-| **Windows** | `~/.config/opencode/oh-my-opencode.json` (優先) または `%APPDATA%\opencode\oh-my-opencode.json` (フォールバック) |
+| **Windows** | `~/.config/opencode/oh-my-opencode.json` (推奨) または `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
 | **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
 
 スキーマ自動補完がサポートされています：
@@ -630,6 +676,36 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
 }
 ```
 
+### JSONC のサポート
+
+`oh-my-opencode` 設定ファイルは JSONC (コメント付き JSON) をサポートしています：
+- 行コメント: `// コメント`
+- ブロックコメント: `/* コメント */`
+- 末尾のカンマ: `{ "key": "value", }`
+
+`oh-my-opencode.jsonc` と `oh-my-opencode.json` の両方が存在する場合、`.jsonc` が優先されます。
+
+**コメント付きの例：**
+
+```jsonc
+{
+  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
+  
+  // Antigravity OAuth 経由で Google Gemini を有効にする
+  "google_auth": false,
+  
+  /* エージェントのオーバーライド - 特定のタスクに合わせてモデルをカスタマイズ */
+  "agents": {
+    "oracle": {
+      "model": "openai/gpt-5.2"  // 戦略的な推論のための GPT
+    },
+    "explore": {
+      "model": "opencode/grok-code"  // 探索のための高速かつ無料のモデル
+    },
+  },
+}
+```
+
 ### Google Auth
 
 **推奨**: 外部の [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) プラグインを使用してください。マルチアカウントロードバランシング、より多くのモデル（Antigravity 経由の Claude を含む）、活発なメンテナンスを提供します。[インストール > Google Gemini](#42-google-gemini-antigravity-oauth) を参照。
@@ -792,7 +868,7 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
 }
 ```
 
-利用可能なフック：`todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`
+利用可能なフック：`todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `preemptive-compaction`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`
 
 **`auto-update-checker`と`startup-toast`について**: `startup-toast` フックは `auto-update-checker` のサブ機能です。アップデートチェックは有効なまま起動トースト通知のみを無効化するには、`disabled_hooks` に `"startup-toast"` を追加してください。すべてのアップデートチェック機能（トーストを含む）を無効化するには、`"auto-update-checker"` を追加してください。
 

package/README.ko.md

@@ -387,6 +387,39 @@ gh repo star code-yeongyu/oh-my-opencode
 </details>
 
 
+## 언인스톨
+
+oh-my-opencode를 제거하려면:
+
+1. **OpenCode 설정에서 플러그인 제거**
+
+   `~/.config/opencode/opencode.json` (또는 `opencode.jsonc`)를 편집하여 `plugin` 배열에서 `"oh-my-opencode"`를 제거합니다:
+
+   ```bash
+   # jq 사용 예시
+   jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
+       ~/.config/opencode/opencode.json > /tmp/oc.json && \
+       mv /tmp/oc.json ~/.config/opencode/opencode.json
+   ```
+
+2. **설정 파일 삭제 (선택 사항)**
+
+   ```bash
+   # 사용자 설정 삭제
+   rm -f ~/.config/opencode/oh-my-opencode.json
+
+   # 프로젝트 설정 삭제 (존재하는 경우)
+   rm -f .opencode/oh-my-opencode.json
+   ```
+
+3. **제거 확인**
+
+   ```bash
+   opencode --version
+   # 플러그인이 더 이상 로드되지 않아야 합니다
+   ```
+
+
 ## 기능
 
 ### Agents: 당신의 새로운 팀원들
@@ -450,6 +483,18 @@ Syntax Highlighting, Autocomplete, Refactoring, Navigation, Analysis, 그리고
 - **lsp_code_action_resolve**: 코드 액션 적용
 - **ast_grep_search**: AST 인식 코드 패턴 검색 (25개 언어)
 - **ast_grep_replace**: AST 인식 코드 교체
+- **call_omo_agent**: 전문 explore/librarian 에이전트를 생성합니다. 비동기 실행을 위한 `run_in_background` 파라미터를 지원합니다.
+
+#### 세션 관리 (Session Management)
+
+OpenCode 세션 히스토리를 탐색하고 검색하기 위한 도구들입니다:
+
+- **session_list**: 날짜 및 개수 제한 필터링을 포함한 모든 OpenCode 세션 목록 조회
+- **session_read**: 특정 세션의 메시지 및 히스토리 읽기
+- **session_search**: 세션 메시지 전체 텍스트 검색
+- **session_info**: 세션에 대한 메타데이터 및 통계 정보 조회
+
+이 도구들을 통해 에이전트는 이전 대화를 참조하고 세션 간의 연속성을 유지할 수 있습니다.
 
 #### Context is all you need.
 - **Directory AGENTS.md / README.md Injector**: 파일을 읽을 때 `AGENTS.md`, `README.md` 내용을 자동으로 주입합니다. 파일 디렉토리부터 프로젝트 루트까지 탐색하며, 경로 상의 **모든** `AGENTS.md` 파일을 수집합니다. 중첩된 디렉토리별 지침을 지원합니다:
@@ -602,6 +647,10 @@ Oh My OpenCode는 다음 위치의 훅을 읽고 실행합니다:
 - **Empty Message Sanitizer**: 빈 채팅 메시지로 인한 API 오류를 방지합니다. 전송 전 메시지 내용을 자동으로 정리합니다.
 - **Grep Output Truncator**: grep은 산더미 같은 텍스트를 반환할 수 있습니다. 남은 컨텍스트 윈도우에 따라 동적으로 출력을 축소합니다—50% 여유 공간 유지, 최대 50k 토큰.
 - **Tool Output Truncator**: 같은 아이디어, 더 넓은 범위. Grep, Glob, LSP 도구, AST-grep의 출력을 축소합니다. 한 번의 장황한 검색이 전체 컨텍스트를 잡아먹는 것을 방지합니다.
+- **선제적 압축 (Preemptive Compaction)**: 세션 토큰 한계에 도달하기 전에 선제적으로 세션을 압축합니다. 문제가 발생하기 전에 미리 실행됩니다.
+- **압축 컨텍스트 주입기 (Compaction Context Injector)**: 세션 압축 중에 중요한 컨텍스트(AGENTS.md, 현재 디렉토리 정보 등)를 유지하여 중요한 상태를 잃지 않도록 합니다.
+- **사고 블록 검증기 (Thinking Block Validator)**: 사고(thinking) 블록의 형식이 올바른지 검증하여 잘못된 형식으로 인한 API 오류를 방지합니다.
+- **Claude Code 훅 (Claude Code Hooks)**: Claude Code의 settings.json에 설정된 훅을 실행합니다. PreToolUse/PostToolUse/UserPromptSubmit/Stop 이벤트를 지원하는 호환성 레이어입니다.
 
 ## 설정
 
@@ -613,7 +662,7 @@ Oh My OpenCode는 다음 위치의 훅을 읽고 실행합니다:
 
 | 플랫폼 | 사용자 설정 경로 |
 |--------|------------------|
-| **Windows** | `~/.config/opencode/oh-my-opencode.json` (우선) 또는 `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
+| **Windows** | `~/.config/opencode/oh-my-opencode.json` (권장) 또는 `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
 | **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
 
 Schema 자동 완성이 지원됩니다:
@@ -624,6 +673,36 @@ Schema 자동 완성이 지원됩니다:
 }
 ```
 
+### JSONC 지원
+
+`oh-my-opencode` 설정 파일은 JSONC(주석이 포함된 JSON)를 지원합니다:
+- 한 줄 주석: `// 주석`
+- 블록 주석: `/* 주석 */`
+- 후행 콤마(Trailing commas): `{ "key": "value", }`
+
+`oh-my-opencode.jsonc`와 `oh-my-opencode.json` 파일이 모두 존재할 경우, `.jsonc` 파일이 우선순위를 갖습니다.
+
+**주석이 포함된 예시:**
+
+```jsonc
+{
+  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
+  
+  // Antigravity OAuth를 통해 Google Gemini 활성화
+  "google_auth": false,
+  
+  /* 에이전트 오버라이드 - 특정 작업에 대한 모델 커스터마이징 */
+  "agents": {
+    "oracle": {
+      "model": "openai/gpt-5.2"  // 전략적 추론을 위한 GPT
+    },
+    "explore": {
+      "model": "opencode/grok-code"  // 탐색을 위한 빠르고 무료인 모델
+    },
+  },
+}
+```
+
 ### Google Auth
 
 **권장**: 외부 [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) 플러그인을 사용하세요. 멀티 계정 로드밸런싱, 더 많은 모델(Antigravity를 통한 Claude 포함), 활발한 유지보수를 제공합니다. [설치 > Google Gemini](#42-google-gemini-antigravity-oauth) 참조.
@@ -786,7 +865,7 @@ Schema 자동 완성이 지원됩니다:
 }
 ```
 
-사용 가능한 훅: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`
+사용 가능한 훅: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `preemptive-compaction`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`
 
 **`auto-update-checker`와 `startup-toast`에 대한 참고사항**: `startup-toast` 훅은 `auto-update-checker`의 하위 기능입니다. 업데이트 확인은 유지하면서 시작 토스트 알림만 비활성화하려면 `disabled_hooks`에 `"startup-toast"`를 추가하세요. 모든 업데이트 확인 기능(토스트 포함)을 비활성화하려면 `"auto-update-checker"`를 추가하세요.
 

package/README.md

@@ -522,6 +522,18 @@ Hand your best tools to your best colleagues. Now they can properly refactor, na
 - **lsp_code_action_resolve**: Apply code action
 - **ast_grep_search**: AST-aware code pattern search (25 languages)
 - **ast_grep_replace**: AST-aware code replacement
+- **call_omo_agent**: Spawn specialized explore/librarian agents. Supports `run_in_background` parameter for async execution.
+
+#### Session Management
+
+Tools to navigate and search your OpenCode session history:
+
+- **session_list**: List all OpenCode sessions with filtering by date and limit
+- **session_read**: Read messages and history from a specific session
+- **session_search**: Full-text search across session messages
+- **session_info**: Get metadata and statistics about a session
+
+These tools enable agents to reference previous conversations and maintain continuity across sessions.
 
 #### Context Is All You Need
 - **Directory AGENTS.md / README.md Injector**: Auto-injects `AGENTS.md` and `README.md` when reading files. Walks from file directory to project root, collecting **all** `AGENTS.md` files along the path. Supports nested directory-specific instructions:
@@ -674,6 +686,10 @@ When agents thrive, you thrive. But I want to help you directly too.
 - **Empty Message Sanitizer**: Prevents API errors from empty chat messages by automatically sanitizing message content before sending.
 - **Grep Output Truncator**: Grep can return mountains of text. This dynamically truncates output based on your remaining context window—keeps 50% headroom, caps at 50k tokens.
 - **Tool Output Truncator**: Same idea, broader scope. Truncates output from Grep, Glob, LSP tools, and AST-grep. Prevents one verbose search from eating your entire context.
+- **Preemptive Compaction**: Compacts session proactively before hitting hard token limits. Runs before you get into trouble.
+- **Compaction Context Injector**: Preserves critical context (AGENTS.md, current directory info) during session compaction so you don't lose important state.
+- **Thinking Block Validator**: Validates thinking blocks to ensure proper formatting and prevent API errors from malformed thinking content.
+- **Claude Code Hooks**: Executes hooks from Claude Code's settings.json - this is the compatibility layer that runs PreToolUse/PostToolUse/UserPromptSubmit/Stop hooks.
 
 ## Configuration
 
@@ -888,7 +904,7 @@ Disable specific built-in hooks via `disabled_hooks` in `~/.config/opencode/oh-m
 }
 ```
 
-Available hooks: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`
+Available hooks: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `preemptive-compaction`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`
 
 **Note on `auto-update-checker` and `startup-toast`**: The `startup-toast` hook is a sub-feature of `auto-update-checker`. To disable only the startup toast notification while keeping update checking enabled, add `"startup-toast"` to `disabled_hooks`. To disable all update checking features (including the toast), add `"auto-update-checker"` to `disabled_hooks`.
 

package/README.zh-cn.md

@@ -398,6 +398,39 @@ gh repo star code-yeongyu/oh-my-opencode
 </details>
 
 
+## 卸载
+
+要移除 oh-my-opencode：
+
+1. **从 OpenCode 配置中移除插件**
+
+   编辑 `~/.config/opencode/opencode.json` (或 `opencode.jsonc`)，从 `plugin` 数组中移除 `"oh-my-opencode"`：
+
+   ```bash
+   # 使用 jq 的示例
+   jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
+       ~/.config/opencode/opencode.json > /tmp/oc.json && \
+       mv /tmp/oc.json ~/.config/opencode/opencode.json
+   ```
+
+2. **删除配置文件 (可选)**
+
+   ```bash
+   # 删除用户配置
+   rm -f ~/.config/opencode/oh-my-opencode.json
+
+   # 删除项目配置 (如果存在)
+   rm -f .opencode/oh-my-opencode.json
+   ```
+
+3. **确认移除**
+
+   ```bash
+   opencode --version
+   # 插件不应再被加载
+   ```
+
+
 ## 功能
 
 ### Agents：你的神队友
@@ -461,6 +494,18 @@ OhMyOpenCode 让这些成为可能。
 - **lsp_code_action_resolve**：应用代码操作
 - **ast_grep_search**：AST 感知代码搜索（支持 25 种语言）
 - **ast_grep_replace**：AST 感知代码替换
+- **call_omo_agent**: 产生专门的 explore/librarian Agent。支持用于异步执行的 `run_in_background` 参数。
+
+#### 会话管理 (Session Management)
+
+用于导航和搜索 OpenCode 会话历史的工具：
+
+- **session_list**: 列出所有 OpenCode 会话，支持按日期和数量限制进行过滤
+- **session_read**: 读取特定会话的消息和历史记录
+- **session_search**: 在会话消息中进行全文搜索
+- **session_info**: 获取有关会话的元数据和统计信息
+
+这些工具使 Agent 能够引用之前的对话并保持跨会话的连续性。
 
 #### 上下文就是一切 (Context is all you need)
 - **Directory AGENTS.md / README.md 注入器**：读文件时自动把 `AGENTS.md` 和 `README.md` 塞进去。从当前目录一路往上找，路径上**所有** `AGENTS.md` 全都带上。支持嵌套指令：
@@ -620,7 +665,12 @@ Agent 爽了，你自然也爽。但我还想直接让你爽。
 
 配置文件（优先级从高到低）：
 1. `.opencode/oh-my-opencode.json`（项目级）
-2. `~/.config/opencode/oh-my-opencode.json`（用户级）
+2. 用户配置（按平台）：
+
+| 平台 | 用户配置路径 |
+|----------|------------------|
+| **Windows** | `~/.config/opencode/oh-my-opencode.json` (首选) 或 `%APPDATA%\opencode\oh-my-opencode.json` (备选) |
+| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
 
 支持 Schema 自动补全：
 
@@ -630,6 +680,36 @@ Agent 爽了，你自然也爽。但我还想直接让你爽。
 }
 ```
 
+### JSONC 支持
+
+`oh-my-opencode` 配置文件支持 JSONC（带注释的 JSON）：
+- 行注释：`// 注释`
+- 块注释：`/* 注释 */`
+- 尾随逗号：`{ "key": "value", }`
+
+当 `oh-my-opencode.jsonc` 和 `oh-my-opencode.json` 文件同时存在时，`.jsonc` 优先。
+
+**带注释的示例：**
+
+```jsonc
+{
+  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
+  
+  // 通过 Antigravity OAuth 启用 Google Gemini
+  "google_auth": false,
+  
+  /* Agent 覆盖 - 为特定任务自定义模型 */
+  "agents": {
+    "oracle": {
+      "model": "openai/gpt-5.2"  // 用于战略推理的 GPT
+    },
+    "explore": {
+      "model": "opencode/grok-code"  // 快速且免费的搜索模型
+    },
+  },
+}
+```
+
 ### Google Auth
 
 **强推**：用外部 [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) 插件。多账号负载均衡、更多模型（包括 Antigravity 版 Claude）、有人维护。看 [安装 > Google Gemini](#42-google-gemini-antigravity-oauth)。
@@ -792,7 +872,7 @@ Sisyphus Agent 也能自定义：
 }
 ```
 
-可关的 hook：`todo-continuation-enforcer`、`context-window-monitor`、`session-recovery`、`session-notification`、`comment-checker`、`grep-output-truncator`、`tool-output-truncator`、`directory-agents-injector`、`directory-readme-injector`、`empty-task-response-detector`、`think-mode`、`anthropic-auto-compact`、`rules-injector`、`background-notification`、`auto-update-checker`、`startup-toast`、`keyword-detector`、`agent-usage-reminder`、`non-interactive-env`、`interactive-bash-session`、`empty-message-sanitizer`
+可关的 hook：`todo-continuation-enforcer`、`context-window-monitor`、`session-recovery`、`session-notification`、`comment-checker`、`grep-output-truncator`、`tool-output-truncator`、`directory-agents-injector`、`directory-readme-injector`、`empty-task-response-detector`、`think-mode`、`anthropic-auto-compact`、`rules-injector`、`background-notification`、`auto-update-checker`、`startup-toast`、`keyword-detector`、`agent-usage-reminder`、`non-interactive-env`、`interactive-bash-session`、`empty-message-sanitizer`、`preemptive-compaction`、`compaction-context-injector`、`thinking-block-validator`、`claude-code-hooks`
 
 **关于 `auto-update-checker` 和 `startup-toast`**: `startup-toast` hook 是 `auto-update-checker` 的子功能。若想保持更新检查但只禁用启动提示通知，在 `disabled_hooks` 中添加 `"startup-toast"`。若要禁用所有更新检查功能（包括提示），添加 `"auto-update-checker"`。
 

package/dist/cli/index.js

@@ -2244,7 +2244,7 @@ var require_picocolors = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "oh-my-opencode",
-    version: "2.6.2",
+    version: "2.7.0",
     description: "OpenCode plugin - custom agents (oracle, librarian) and enhanced features",
     main: "dist/index.js",
     types: "dist/index.d.ts",

package/dist/features/builtin-commands/templates/init-deep.d.ts

@@ -1 +1 @@
-export declare const INIT_DEEP_TEMPLATE = "# Initialize Deep Knowledge Base\n\nGenerate comprehensive AGENTS.md files across project hierarchy. Combines root-level project knowledge (gen-knowledge) with complexity-based subdirectory documentation (gen-knowledge-deep).\n\n## Usage\n\n```\n/init-deep                      # Analyze and generate hierarchical AGENTS.md\n/init-deep --create-new         # Force create from scratch (ignore existing)\n/init-deep --max-depth=2        # Limit to N directory levels (default: 3)\n```\n\n---\n\n## Core Principles\n\n- **Telegraphic Style**: Sacrifice grammar for concision (\"Project uses React\" \u2192 \"React 18\")\n- **Predict-then-Compare**: Predict standard \u2192 find actual \u2192 document ONLY deviations\n- **Hierarchy Aware**: Parent covers general, children cover specific\n- **No Redundancy**: Child AGENTS.md NEVER repeats parent content\n\n---\n\n## Process\n\n<critical>\n**MANDATORY: TodoWrite for ALL phases. Mark in_progress \u2192 completed in real-time.**\n</critical>\n\n### Phase 0: Initialize\n\n```\nTodoWrite([\n  { id: \"p1-analysis\", content: \"Parallel project structure & complexity analysis\", status: \"pending\", priority: \"high\" },\n  { id: \"p2-scoring\", content: \"Score directories, determine AGENTS.md locations\", status: \"pending\", priority: \"high\" },\n  { id: \"p3-root\", content: \"Generate root AGENTS.md with Predict-then-Compare\", status: \"pending\", priority: \"high\" },\n  { id: \"p4-subdirs\", content: \"Generate subdirectory AGENTS.md files in parallel\", status: \"pending\", priority: \"high\" },\n  { id: \"p5-review\", content: \"Review, deduplicate, validate all files\", status: \"pending\", priority: \"medium\" }\n])\n```\n\n---\n\n## Phase 1: Parallel Project Analysis\n\n**Mark \"p1-analysis\" as in_progress.**\n\nLaunch **ALL tasks simultaneously**:\n\n<parallel-tasks>\n\n### Structural Analysis (bash - run in parallel)\n```bash\n# Task A: Directory depth analysis\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/__pycache__/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# Task B: File count per directory  \nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/__pycache__/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# Task C: Code concentration\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.jsx\" -o -name \"*.go\" -o -name \"*.rs\" -o -name \"*.java\" \\) -not -path '*/node_modules/*' -not -path '*/venv/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# Task D: Existing knowledge files\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n### Context Gathering (Explore agents - background_task in parallel)\n\n```\nbackground_task(agent=\"explore\", prompt=\"Project structure: PREDICT standard {lang} patterns \u2192 FIND package.json/pyproject.toml/go.mod \u2192 REPORT deviations only\")\n\nbackground_task(agent=\"explore\", prompt=\"Entry points: PREDICT typical (main.py, index.ts) \u2192 FIND actual \u2192 REPORT non-standard organization\")\n\nbackground_task(agent=\"explore\", prompt=\"Conventions: FIND .cursor/rules, .cursorrules, eslintrc, pyproject.toml \u2192 REPORT project-specific rules DIFFERENT from defaults\")\n\nbackground_task(agent=\"explore\", prompt=\"Anti-patterns: FIND comments with 'DO NOT', 'NEVER', 'ALWAYS', 'LEGACY', 'DEPRECATED' \u2192 REPORT forbidden patterns\")\n\nbackground_task(agent=\"explore\", prompt=\"Build/CI: FIND .github/workflows, Makefile, justfile \u2192 REPORT non-standard build/deploy patterns\")\n\nbackground_task(agent=\"explore\", prompt=\"Test patterns: FIND pytest.ini, jest.config, test structure \u2192 REPORT unique testing conventions\")\n```\n\n</parallel-tasks>\n\n**Collect all results. Mark \"p1-analysis\" as completed.**\n\n---\n\n## Phase 2: Complexity Scoring & Location Decision\n\n**Mark \"p2-scoring\" as in_progress.**\n\n### Scoring Matrix\n\n| Factor | Weight | Threshold |\n|--------|--------|-----------|\n| File count | 3x | >20 files = high |\n| Subdirectory count | 2x | >5 subdirs = high |\n| Code file ratio | 2x | >70% code = high |\n| Unique patterns | 1x | Has own config |\n| Module boundary | 2x | Has __init__.py/index.ts |\n\n### Decision Rules\n\n| Score | Action |\n|-------|--------|\n| **Root (.)** | ALWAYS create AGENTS.md |\n| **High (>15)** | Create dedicated AGENTS.md |\n| **Medium (8-15)** | Create if distinct domain |\n| **Low (<8)** | Skip, parent sufficient |\n\n### Output Format\n\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/api\", score: 18, reason: \"high complexity, 45 files\" },\n  { path: \"src/hooks\", score: 12, reason: \"distinct domain, unique patterns\" },\n]\n```\n\n**Mark \"p2-scoring\" as completed.**\n\n---\n\n## Phase 3: Generate Root AGENTS.md\n\n**Mark \"p3-root\" as in_progress.**\n\nRoot AGENTS.md gets **full treatment** with Predict-then-Compare synthesis.\n\n### Required Sections\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**Generated:** {TIMESTAMP}\n**Commit:** {SHORT_SHA}\n**Branch:** {BRANCH}\n\n## OVERVIEW\n\n{1-2 sentences: what project does, core tech stack}\n\n## STRUCTURE\n\n\\`\\`\\`\n{project-root}/\n\u251C\u2500\u2500 {dir}/      # {non-obvious purpose only}\n\u2514\u2500\u2500 {entry}     # entry point\n\\`\\`\\`\n\n## WHERE TO LOOK\n\n| Task | Location | Notes |\n|------|----------|-------|\n| Add feature X | \\`src/x/\\` | {pattern hint} |\n\n## CONVENTIONS\n\n{ONLY deviations from standard - skip generic advice}\n\n- **{rule}**: {specific detail}\n\n## ANTI-PATTERNS (THIS PROJECT)\n\n{Things explicitly forbidden HERE}\n\n- **{pattern}**: {why} \u2192 {alternative}\n\n## UNIQUE STYLES\n\n{Project-specific coding styles}\n\n- **{style}**: {how different}\n\n## COMMANDS\n\n\\`\\`\\`bash\n{dev-command}\n{test-command}\n{build-command}\n\\`\\`\\`\n\n## NOTES\n\n{Gotchas, non-obvious info}\n```\n\n### Quality Gates\n\n- [ ] Size: 50-150 lines\n- [ ] No generic advice (\"write clean code\")\n- [ ] No obvious info (\"tests/ has tests\")\n- [ ] Every item is project-specific\n\n**Mark \"p3-root\" as completed.**\n\n---\n\n## Phase 4: Generate Subdirectory AGENTS.md\n\n**Mark \"p4-subdirs\" as in_progress.**\n\nFor each location in AGENTS_LOCATIONS (except root), launch **parallel document-writer agents**:\n\n```typescript\nfor (const loc of AGENTS_LOCATIONS.filter(l => l.path !== \".\")) {\n  background_task({\n    agent: \"document-writer\",\n    prompt: \\`\n      Generate AGENTS.md for: ${loc.path}\n      \n      CONTEXT:\n      - Complexity reason: ${loc.reason}\n      - Parent AGENTS.md: ./AGENTS.md (already covers project overview)\n      \n      CRITICAL RULES:\n      1. Focus ONLY on this directory's specific context\n      2. NEVER repeat parent AGENTS.md content\n      3. Shorter is better - 30-80 lines max\n      4. Telegraphic style - sacrifice grammar\n      \n      REQUIRED SECTIONS:\n      - OVERVIEW (1 line: what this directory does)\n      - STRUCTURE (only if >5 subdirs)\n      - WHERE TO LOOK (directory-specific tasks)\n      - CONVENTIONS (only if DIFFERENT from root)\n      - ANTI-PATTERNS (directory-specific only)\n      \n      OUTPUT: Write to ${loc.path}/AGENTS.md\n    \\`\n  })\n}\n```\n\n**Wait for all agents. Mark \"p4-subdirs\" as completed.**\n\n---\n\n## Phase 5: Review & Deduplicate\n\n**Mark \"p5-review\" as in_progress.**\n\n### Validation Checklist\n\nFor EACH generated AGENTS.md:\n\n| Check | Action if Fail |\n|-------|----------------|\n| Contains generic advice | REMOVE the line |\n| Repeats parent content | REMOVE the line |\n| Missing required section | ADD it |\n| Over 150 lines (root) / 80 lines (subdir) | TRIM |\n| Verbose explanations | REWRITE telegraphic |\n\n### Cross-Reference Validation\n\n```\nFor each child AGENTS.md:\n  For each line in child:\n    If similar line exists in parent:\n      REMOVE from child (parent already covers)\n```\n\n**Mark \"p5-review\" as completed.**\n\n---\n\n## Final Report\n\n```\n=== init-deep Complete ===\n\nFiles Generated:\n  \u2713 ./AGENTS.md (root, {N} lines)\n  \u2713 ./src/hooks/AGENTS.md ({N} lines)\n  \u2713 ./src/tools/AGENTS.md ({N} lines)\n\nDirectories Analyzed: {N}\nAGENTS.md Created: {N}\nTotal Lines: {N}\n\nHierarchy:\n  ./AGENTS.md\n  \u251C\u2500\u2500 src/hooks/AGENTS.md\n  \u2514\u2500\u2500 src/tools/AGENTS.md\n```\n\n---\n\n## Anti-Patterns for THIS Command\n\n- **Over-documenting**: Not every directory needs AGENTS.md\n- **Redundancy**: Child must NOT repeat parent\n- **Generic content**: Remove anything that applies to ALL projects\n- **Sequential execution**: MUST use parallel agents\n- **Deep nesting**: Rarely need AGENTS.md at depth 4+\n- **Verbose style**: \"This directory contains...\" \u2192 just list it";
+export declare const INIT_DEEP_TEMPLATE = "# Initialize Deep Knowledge Base\n\nGenerate comprehensive AGENTS.md files across project hierarchy. Combines root-level project knowledge (gen-knowledge) with complexity-based subdirectory documentation (gen-knowledge-deep).\n\n## Usage\n\n```\n/init-deep                      # Analyze and generate hierarchical AGENTS.md\n/init-deep --create-new         # Force create from scratch (ignore existing)\n/init-deep --max-depth=2        # Limit to N directory levels (default: 3)\n```\n\n---\n\n## Core Principles\n\n- **Telegraphic Style**: Sacrifice grammar for concision (\"Project uses React\" \u2192 \"React 18\")\n- **Predict-then-Compare**: Predict standard \u2192 find actual \u2192 document ONLY deviations\n- **Hierarchy Aware**: Parent covers general, children cover specific\n- **No Redundancy**: Child AGENTS.md NEVER repeats parent content\n- **LSP-First**: Use LSP tools for accurate code intelligence when available (semantic > text search)\n\n---\n\n## Process\n\n<critical>\n**MANDATORY: TodoWrite for ALL phases. Mark in_progress \u2192 completed in real-time.**\n</critical>\n\n### Phase 0: Initialize\n\n```\nTodoWrite([\n  { id: \"p1-analysis\", content: \"Parallel project structure & complexity analysis\", status: \"pending\", priority: \"high\" },\n  { id: \"p2-scoring\", content: \"Score directories, determine AGENTS.md locations\", status: \"pending\", priority: \"high\" },\n  { id: \"p3-root\", content: \"Generate root AGENTS.md with Predict-then-Compare\", status: \"pending\", priority: \"high\" },\n  { id: \"p4-subdirs\", content: \"Generate subdirectory AGENTS.md files in parallel\", status: \"pending\", priority: \"high\" },\n  { id: \"p5-review\", content: \"Review, deduplicate, validate all files\", status: \"pending\", priority: \"medium\" }\n])\n```\n\n---\n\n## Phase 1: Parallel Project Analysis\n\n**Mark \"p1-analysis\" as in_progress.**\n\nLaunch **ALL tasks simultaneously**:\n\n<parallel-tasks>\n\n### Structural Analysis (bash - run in parallel)\n```bash\n# Task A: Directory depth analysis\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/__pycache__/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# Task B: File count per directory  \nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/__pycache__/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# Task C: Code concentration\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.jsx\" -o -name \"*.go\" -o -name \"*.rs\" -o -name \"*.java\" \\) -not -path '*/node_modules/*' -not -path '*/venv/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# Task D: Existing knowledge files\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n### Context Gathering (Explore agents - background_task in parallel)\n\n```\nbackground_task(agent=\"explore\", prompt=\"Project structure: PREDICT standard {lang} patterns \u2192 FIND package.json/pyproject.toml/go.mod \u2192 REPORT deviations only\")\n\nbackground_task(agent=\"explore\", prompt=\"Entry points: PREDICT typical (main.py, index.ts) \u2192 FIND actual \u2192 REPORT non-standard organization\")\n\nbackground_task(agent=\"explore\", prompt=\"Conventions: FIND .cursor/rules, .cursorrules, eslintrc, pyproject.toml \u2192 REPORT project-specific rules DIFFERENT from defaults\")\n\nbackground_task(agent=\"explore\", prompt=\"Anti-patterns: FIND comments with 'DO NOT', 'NEVER', 'ALWAYS', 'LEGACY', 'DEPRECATED' \u2192 REPORT forbidden patterns\")\n\nbackground_task(agent=\"explore\", prompt=\"Build/CI: FIND .github/workflows, Makefile, justfile \u2192 REPORT non-standard build/deploy patterns\")\n\nbackground_task(agent=\"explore\", prompt=\"Test patterns: FIND pytest.ini, jest.config, test structure \u2192 REPORT unique testing conventions\")\n```\n\n### Code Intelligence Analysis (LSP tools - run in parallel)\n\nLSP provides semantic understanding beyond text search. Use for accurate code mapping.\n\n```\n# Step 1: Check LSP availability\nlsp_servers()  # Verify language server is available\n\n# Step 2: Analyze entry point files (run in parallel)\n# Find entry points first, then analyze each with lsp_document_symbols\nlsp_document_symbols(filePath=\"src/index.ts\")      # Main entry\nlsp_document_symbols(filePath=\"src/main.py\")       # Python entry\nlsp_document_symbols(filePath=\"cmd/main.go\")       # Go entry\n\n# Step 3: Discover key symbols across workspace (run in parallel)\nlsp_workspace_symbols(filePath=\".\", query=\"class\")      # All classes\nlsp_workspace_symbols(filePath=\".\", query=\"interface\")  # All interfaces\nlsp_workspace_symbols(filePath=\".\", query=\"function\")   # Top-level functions\nlsp_workspace_symbols(filePath=\".\", query=\"type\")       # Type definitions\n\n# Step 4: Analyze symbol centrality (for top 5-10 key symbols)\n# High reference count = central/important concept\nlsp_find_references(filePath=\"src/index.ts\", line=X, character=Y)  # Main export\n```\n\n#### LSP Analysis Output Format\n\n```\nCODE_INTELLIGENCE = {\n  entry_points: [\n    { file: \"src/index.ts\", exports: [\"Plugin\", \"createHook\"], symbol_count: 12 }\n  ],\n  key_symbols: [\n    { name: \"Plugin\", type: \"class\", file: \"src/index.ts\", refs: 45, role: \"Central orchestrator\" },\n    { name: \"createHook\", type: \"function\", file: \"src/utils.ts\", refs: 23, role: \"Hook factory\" }\n  ],\n  module_boundaries: [\n    { dir: \"src/hooks\", exports: 21, imports_from: [\"shared/\"] },\n    { dir: \"src/tools\", exports: 15, imports_from: [\"shared/\", \"hooks/\"] }\n  ]\n}\n```\n\n<critical>\n**LSP Fallback**: If LSP unavailable (no server installed), skip this section and rely on explore agents + AST-grep patterns.\n</critical>\n\n</parallel-tasks>\n\n**Collect all results. Mark \"p1-analysis\" as completed.**\n\n---\n\n## Phase 2: Complexity Scoring & Location Decision\n\n**Mark \"p2-scoring\" as in_progress.**\n\n### Scoring Matrix\n\n| Factor | Weight | Threshold | Source |\n|--------|--------|-----------|--------|\n| File count | 3x | >20 files = high | bash |\n| Subdirectory count | 2x | >5 subdirs = high | bash |\n| Code file ratio | 2x | >70% code = high | bash |\n| Unique patterns | 1x | Has own config | explore |\n| Module boundary | 2x | Has __init__.py/index.ts | bash |\n| **Symbol density** | 2x | >30 symbols = high | LSP |\n| **Export count** | 2x | >10 exports = high | LSP |\n| **Reference centrality** | 3x | Symbols with >20 refs | LSP |\n\n<lsp-scoring>\n**LSP-Enhanced Scoring** (if available):\n\n```\nFor each directory in candidates:\n  symbols = lsp_document_symbols(dir/index.ts or dir/__init__.py)\n  \n  symbol_score = len(symbols) > 30 ? 6 : len(symbols) > 15 ? 3 : 0\n  export_score = count(exported symbols) > 10 ? 4 : 0\n  \n  # Check if this module is central (many things depend on it)\n  for each exported symbol:\n    refs = lsp_find_references(symbol)\n    if refs > 20: centrality_score += 3\n  \n  total_score += symbol_score + export_score + centrality_score\n```\n</lsp-scoring>\n\n### Decision Rules\n\n| Score | Action |\n|-------|--------|\n| **Root (.)** | ALWAYS create AGENTS.md |\n| **High (>15)** | Create dedicated AGENTS.md |\n| **Medium (8-15)** | Create if distinct domain |\n| **Low (<8)** | Skip, parent sufficient |\n\n### Output Format\n\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/api\", score: 18, reason: \"high complexity, 45 files\" },\n  { path: \"src/hooks\", score: 12, reason: \"distinct domain, unique patterns\" },\n]\n```\n\n**Mark \"p2-scoring\" as completed.**\n\n---\n\n## Phase 3: Generate Root AGENTS.md\n\n**Mark \"p3-root\" as in_progress.**\n\nRoot AGENTS.md gets **full treatment** with Predict-then-Compare synthesis.\n\n### Required Sections\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**Generated:** {TIMESTAMP}\n**Commit:** {SHORT_SHA}\n**Branch:** {BRANCH}\n\n## OVERVIEW\n\n{1-2 sentences: what project does, core tech stack}\n\n## STRUCTURE\n\n\\`\\`\\`\n{project-root}/\n\u251C\u2500\u2500 {dir}/      # {non-obvious purpose only}\n\u2514\u2500\u2500 {entry}     # entry point\n\\`\\`\\`\n\n## WHERE TO LOOK\n\n| Task | Location | Notes |\n|------|----------|-------|\n| Add feature X | \\`src/x/\\` | {pattern hint} |\n\n## CODE MAP\n\n{Generated from LSP analysis - shows key symbols and their relationships}\n\n| Symbol | Type | Location | Refs | Role |\n|--------|------|----------|------|------|\n| {MainClass} | Class | \\`src/index.ts\\` | {N} | {Central orchestrator} |\n| {createX} | Function | \\`src/utils.ts\\` | {N} | {Factory pattern} |\n| {Config} | Interface | \\`src/types.ts\\` | {N} | {Configuration contract} |\n\n### Module Dependencies\n\n\\`\\`\\`\n{entry} \u2500\u2500imports\u2500\u2500> {core/}\n   \u2502                    \u2502\n   \u2514\u2500\u2500imports\u2500\u2500> {utils/} <\u2500\u2500imports\u2500\u2500 {features/}\n\\`\\`\\`\n\n<code-map-note>\n**Skip CODE MAP if**: LSP unavailable OR project too small (<10 files) OR no clear module boundaries.\n</code-map-note>\n\n## CONVENTIONS\n\n{ONLY deviations from standard - skip generic advice}\n\n- **{rule}**: {specific detail}\n\n## ANTI-PATTERNS (THIS PROJECT)\n\n{Things explicitly forbidden HERE}\n\n- **{pattern}**: {why} \u2192 {alternative}\n\n## UNIQUE STYLES\n\n{Project-specific coding styles}\n\n- **{style}**: {how different}\n\n## COMMANDS\n\n\\`\\`\\`bash\n{dev-command}\n{test-command}\n{build-command}\n\\`\\`\\`\n\n## NOTES\n\n{Gotchas, non-obvious info}\n```\n\n### Quality Gates\n\n- [ ] Size: 50-150 lines\n- [ ] No generic advice (\"write clean code\")\n- [ ] No obvious info (\"tests/ has tests\")\n- [ ] Every item is project-specific\n\n**Mark \"p3-root\" as completed.**\n\n---\n\n## Phase 4: Generate Subdirectory AGENTS.md\n\n**Mark \"p4-subdirs\" as in_progress.**\n\nFor each location in AGENTS_LOCATIONS (except root), launch **parallel document-writer agents**:\n\n```typescript\nfor (const loc of AGENTS_LOCATIONS.filter(l => l.path !== \".\")) {\n  background_task({\n    agent: \"document-writer\",\n    prompt: \\`\n      Generate AGENTS.md for: ${loc.path}\n      \n      CONTEXT:\n      - Complexity reason: ${loc.reason}\n      - Parent AGENTS.md: ./AGENTS.md (already covers project overview)\n      \n      CRITICAL RULES:\n      1. Focus ONLY on this directory's specific context\n      2. NEVER repeat parent AGENTS.md content\n      3. Shorter is better - 30-80 lines max\n      4. Telegraphic style - sacrifice grammar\n      \n      REQUIRED SECTIONS:\n      - OVERVIEW (1 line: what this directory does)\n      - STRUCTURE (only if >5 subdirs)\n      - WHERE TO LOOK (directory-specific tasks)\n      - CONVENTIONS (only if DIFFERENT from root)\n      - ANTI-PATTERNS (directory-specific only)\n      \n      OUTPUT: Write to ${loc.path}/AGENTS.md\n    \\`\n  })\n}\n```\n\n**Wait for all agents. Mark \"p4-subdirs\" as completed.**\n\n---\n\n## Phase 5: Review & Deduplicate\n\n**Mark \"p5-review\" as in_progress.**\n\n### Validation Checklist\n\nFor EACH generated AGENTS.md:\n\n| Check | Action if Fail |\n|-------|----------------|\n| Contains generic advice | REMOVE the line |\n| Repeats parent content | REMOVE the line |\n| Missing required section | ADD it |\n| Over 150 lines (root) / 80 lines (subdir) | TRIM |\n| Verbose explanations | REWRITE telegraphic |\n\n### Cross-Reference Validation\n\n```\nFor each child AGENTS.md:\n  For each line in child:\n    If similar line exists in parent:\n      REMOVE from child (parent already covers)\n```\n\n**Mark \"p5-review\" as completed.**\n\n---\n\n## Final Report\n\n```\n=== init-deep Complete ===\n\nFiles Generated:\n  \u2713 ./AGENTS.md (root, {N} lines)\n  \u2713 ./src/hooks/AGENTS.md ({N} lines)\n  \u2713 ./src/tools/AGENTS.md ({N} lines)\n\nDirectories Analyzed: {N}\nAGENTS.md Created: {N}\nTotal Lines: {N}\n\nHierarchy:\n  ./AGENTS.md\n  \u251C\u2500\u2500 src/hooks/AGENTS.md\n  \u2514\u2500\u2500 src/tools/AGENTS.md\n```\n\n---\n\n## Anti-Patterns for THIS Command\n\n- **Over-documenting**: Not every directory needs AGENTS.md\n- **Redundancy**: Child must NOT repeat parent\n- **Generic content**: Remove anything that applies to ALL projects\n- **Sequential execution**: MUST use parallel agents\n- **Deep nesting**: Rarely need AGENTS.md at depth 4+\n- **Verbose style**: \"This directory contains...\" \u2192 just list it\n- **Ignoring LSP**: If LSP available, USE IT - semantic analysis > text grep\n- **LSP without fallback**: Always have explore agent backup if LSP unavailable\n- **Over-referencing**: Don't trace refs for EVERY symbol - focus on exports only";

package/dist/hooks/todo-continuation-enforcer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -4382,7 +4382,7 @@ Incomplete tasks remain in your todo list. Continue working on the next pending
 - Do not stop until all tasks are done`;
 var COUNTDOWN_SECONDS = 2;
 var TOAST_DURATION_MS = 900;
-var MIN_INJECTION_INTERVAL_MS = 1e4;
+var ERROR_COOLDOWN_MS = 3000;
 function getMessageDir(sessionID) {
   if (!existsSync6(MESSAGE_STORAGE))
     return null;
@@ -4396,7 +4396,7 @@ function getMessageDir(sessionID) {
   }
   return null;
 }
-function detectInterrupt(error) {
+function isAbortError(error) {
   if (!error)
     return false;
   if (typeof error === "object") {
@@ -4422,47 +4422,41 @@ function getIncompleteCount(todos) {
 function createTodoContinuationEnforcer(ctx, options = {}) {
   const { backgroundManager } = options;
   const sessions = new Map;
-  function getOrCreateState(sessionID) {
+  function getState(sessionID) {
     let state2 = sessions.get(sessionID);
     if (!state2) {
-      state2 = { version: 0, mode: "idle" };
+      state2 = {};
       sessions.set(sessionID, state2);
     }
     return state2;
   }
-  function clearTimer(state2) {
-    if (state2.timer) {
-      clearTimeout(state2.timer);
-      state2.timer = undefined;
-    }
-  }
-  function invalidate(sessionID, reason) {
+  function cancelCountdown(sessionID) {
     const state2 = sessions.get(sessionID);
     if (!state2)
       return;
-    if (state2.mode === "recovering")
-      return;
-    state2.version++;
-    clearTimer(state2);
-    if (state2.mode !== "idle" && state2.mode !== "errorBypass") {
-      log(`[${HOOK_NAME}] Invalidated`, { sessionID, reason, prevMode: state2.mode, newVersion: state2.version });
-      state2.mode = "idle";
+    if (state2.countdownTimer) {
+      clearTimeout(state2.countdownTimer);
+      state2.countdownTimer = undefined;
+    }
+    if (state2.countdownInterval) {
+      clearInterval(state2.countdownInterval);
+      state2.countdownInterval = undefined;
     }
   }
-  function isMainSession(sessionID) {
-    const mainSessionID2 = getMainSessionID();
-    return !mainSessionID2 || sessionID === mainSessionID2;
+  function cleanup(sessionID) {
+    cancelCountdown(sessionID);
+    sessions.delete(sessionID);
   }
   const markRecovering = (sessionID) => {
-    const state2 = getOrCreateState(sessionID);
-    invalidate(sessionID, "entering recovery mode");
-    state2.mode = "recovering";
+    const state2 = getState(sessionID);
+    state2.isRecovering = true;
+    cancelCountdown(sessionID);
     log(`[${HOOK_NAME}] Session marked as recovering`, { sessionID });
   };
   const markRecoveryComplete = (sessionID) => {
     const state2 = sessions.get(sessionID);
-    if (state2 && state2.mode === "recovering") {
-      state2.mode = "idle";
+    if (state2) {
+      state2.isRecovering = false;
       log(`[${HOOK_NAME}] Session recovery complete`, { sessionID });
     }
   };
@@ -4476,101 +4470,51 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
       }
     }).catch(() => {});
   }
-  async function executeInjection(sessionID, capturedVersion) {
+  async function injectContinuation(sessionID, incompleteCount, total) {
     const state2 = sessions.get(sessionID);
-    if (!state2)
-      return;
-    if (state2.version !== capturedVersion) {
-      log(`[${HOOK_NAME}] Injection aborted: version mismatch`, {
-        sessionID,
-        capturedVersion,
-        currentVersion: state2.version
-      });
+    if (state2?.isRecovering) {
+      log(`[${HOOK_NAME}] Skipped injection: in recovery`, { sessionID });
       return;
     }
-    if (state2.mode !== "countingDown") {
-      log(`[${HOOK_NAME}] Injection aborted: mode changed`, {
-        sessionID,
-        mode: state2.mode
-      });
+    if (state2?.lastErrorAt && Date.now() - state2.lastErrorAt < ERROR_COOLDOWN_MS) {
+      log(`[${HOOK_NAME}] Skipped injection: recent error`, { sessionID });
       return;
     }
-    if (state2.lastAttemptedAt) {
-      const elapsed = Date.now() - state2.lastAttemptedAt;
-      if (elapsed < MIN_INJECTION_INTERVAL_MS) {
-        log(`[${HOOK_NAME}] Injection throttled: too soon since last injection`, {
-          sessionID,
-          elapsedMs: elapsed,
-          minIntervalMs: MIN_INJECTION_INTERVAL_MS
-        });
-        state2.mode = "idle";
-        return;
-      }
+    const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((t) => t.status === "running") : false;
+    if (hasRunningBgTasks) {
+      log(`[${HOOK_NAME}] Skipped injection: background tasks running`, { sessionID });
+      return;
     }
-    state2.mode = "injecting";
     let todos = [];
     try {
       const response = await ctx.client.session.todo({ path: { id: sessionID } });
       todos = response.data ?? response;
     } catch (err) {
-      log(`[${HOOK_NAME}] Failed to fetch todos for injection`, { sessionID, error: String(err) });
-      state2.mode = "idle";
-      return;
-    }
-    if (state2.version !== capturedVersion) {
-      log(`[${HOOK_NAME}] Injection aborted after todo fetch: version mismatch`, { sessionID });
-      state2.mode = "idle";
+      log(`[${HOOK_NAME}] Failed to fetch todos`, { sessionID, error: String(err) });
       return;
     }
-    const incompleteCount = getIncompleteCount(todos);
-    if (incompleteCount === 0) {
-      log(`[${HOOK_NAME}] No incomplete todos at injection time`, { sessionID, total: todos.length });
-      state2.mode = "idle";
-      return;
-    }
-    const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((t) => t.status === "running") : false;
-    if (hasRunningBgTasks) {
-      log(`[${HOOK_NAME}] Skipped: background tasks still running`, { sessionID });
-      state2.mode = "idle";
+    const freshIncompleteCount = getIncompleteCount(todos);
+    if (freshIncompleteCount === 0) {
+      log(`[${HOOK_NAME}] Skipped injection: no incomplete todos`, { sessionID });
       return;
     }
     const messageDir = getMessageDir(sessionID);
     const prevMessage = messageDir ? findNearestMessageWithFields(messageDir) : null;
-    const agentHasWritePermission = !prevMessage?.tools || prevMessage.tools.write !== false && prevMessage.tools.edit !== false;
-    if (!agentHasWritePermission) {
-      log(`[${HOOK_NAME}] Skipped: agent lacks write permission`, {
-        sessionID,
-        agent: prevMessage?.agent,
-        tools: prevMessage?.tools
-      });
-      state2.mode = "idle";
+    const hasWritePermission = !prevMessage?.tools || prevMessage.tools.write !== false && prevMessage.tools.edit !== false;
+    if (!hasWritePermission) {
+      log(`[${HOOK_NAME}] Skipped: agent lacks write permission`, { sessionID, agent: prevMessage?.agent });
       return;
     }
     const agentName = prevMessage?.agent?.toLowerCase() ?? "";
-    const isPlanModeAgent = agentName === "plan" || agentName === "planner-sisyphus";
-    if (isPlanModeAgent) {
-      log(`[${HOOK_NAME}] Skipped: plan mode agent detected`, {
-        sessionID,
-        agent: prevMessage?.agent
-      });
-      state2.mode = "idle";
+    if (agentName === "plan" || agentName === "planner-sisyphus") {
+      log(`[${HOOK_NAME}] Skipped: plan mode agent`, { sessionID, agent: prevMessage?.agent });
       return;
     }
     const prompt = `${CONTINUATION_PROMPT}
 
-[Status: ${todos.length - incompleteCount}/${todos.length} completed, ${incompleteCount} remaining]`;
-    if (state2.version !== capturedVersion) {
-      log(`[${HOOK_NAME}] Injection aborted: version changed before API call`, { sessionID });
-      state2.mode = "idle";
-      return;
-    }
-    state2.lastAttemptedAt = Date.now();
+[Status: ${todos.length - freshIncompleteCount}/${todos.length} completed, ${freshIncompleteCount} remaining]`;
     try {
-      log(`[${HOOK_NAME}] Injecting continuation prompt`, {
-        sessionID,
-        agent: prevMessage?.agent,
-        incompleteCount
-      });
+      log(`[${HOOK_NAME}] Injecting continuation`, { sessionID, agent: prevMessage?.agent, incompleteCount: freshIncompleteCount });
       await ctx.client.session.prompt({
         path: { id: sessionID },
         body: {
@@ -4579,41 +4523,27 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
         },
         query: { directory: ctx.directory }
       });
-      log(`[${HOOK_NAME}] Continuation prompt injected successfully`, { sessionID });
+      log(`[${HOOK_NAME}] Injection successful`, { sessionID });
     } catch (err) {
-      log(`[${HOOK_NAME}] Prompt injection failed`, { sessionID, error: String(err) });
+      log(`[${HOOK_NAME}] Injection failed`, { sessionID, error: String(err) });
     }
-    state2.mode = "idle";
   }
-  function startCountdown(sessionID, incompleteCount) {
-    const state2 = getOrCreateState(sessionID);
-    invalidate(sessionID, "starting new countdown");
-    state2.version++;
-    state2.mode = "countingDown";
-    const capturedVersion = state2.version;
-    log(`[${HOOK_NAME}] Starting countdown`, {
-      sessionID,
-      seconds: COUNTDOWN_SECONDS,
-      version: capturedVersion,
-      incompleteCount
-    });
-    showCountdownToast(COUNTDOWN_SECONDS, incompleteCount);
+  function startCountdown(sessionID, incompleteCount, total) {
+    const state2 = getState(sessionID);
+    cancelCountdown(sessionID);
     let secondsRemaining = COUNTDOWN_SECONDS;
-    const toastInterval = setInterval(() => {
-      if (state2.version !== capturedVersion) {
-        clearInterval(toastInterval);
-        return;
-      }
+    showCountdownToast(secondsRemaining, incompleteCount);
+    state2.countdownInterval = setInterval(() => {
       secondsRemaining--;
       if (secondsRemaining > 0) {
         showCountdownToast(secondsRemaining, incompleteCount);
       }
     }, 1000);
-    state2.timer = setTimeout(() => {
-      clearInterval(toastInterval);
-      clearTimer(state2);
-      executeInjection(sessionID, capturedVersion);
+    state2.countdownTimer = setTimeout(() => {
+      cancelCountdown(sessionID);
+      injectContinuation(sessionID, incompleteCount, total);
     }, COUNTDOWN_SECONDS * 1000);
+    log(`[${HOOK_NAME}] Countdown started`, { sessionID, seconds: COUNTDOWN_SECONDS, incompleteCount });
   }
   const handler = async ({ event }) => {
     const props = event.properties;
@@ -4621,33 +4551,34 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
       const sessionID = props?.sessionID;
       if (!sessionID)
         return;
-      const isInterrupt = detectInterrupt(props?.error);
-      const state2 = getOrCreateState(sessionID);
-      invalidate(sessionID, isInterrupt ? "user interrupt" : "session error");
-      state2.mode = "errorBypass";
-      log(`[${HOOK_NAME}] session.error received`, { sessionID, isInterrupt, error: props?.error });
+      const state2 = getState(sessionID);
+      state2.lastErrorAt = Date.now();
+      cancelCountdown(sessionID);
+      log(`[${HOOK_NAME}] session.error`, { sessionID, isAbort: isAbortError(props?.error) });
       return;
     }
     if (event.type === "session.idle") {
       const sessionID = props?.sessionID;
       if (!sessionID)
         return;
-      log(`[${HOOK_NAME}] session.idle received`, { sessionID });
-      if (!isMainSession(sessionID)) {
+      log(`[${HOOK_NAME}] session.idle`, { sessionID });
+      const mainSessionID2 = getMainSessionID();
+      if (mainSessionID2 && sessionID !== mainSessionID2) {
         log(`[${HOOK_NAME}] Skipped: not main session`, { sessionID });
         return;
       }
-      const state2 = getOrCreateState(sessionID);
-      if (state2.mode === "recovering") {
-        log(`[${HOOK_NAME}] Skipped: session in recovery mode`, { sessionID });
+      const state2 = getState(sessionID);
+      if (state2.isRecovering) {
+        log(`[${HOOK_NAME}] Skipped: in recovery`, { sessionID });
         return;
       }
-      if (state2.mode === "errorBypass") {
-        log(`[${HOOK_NAME}] Skipped: error bypass (awaiting user message to resume)`, { sessionID });
+      if (state2.lastErrorAt && Date.now() - state2.lastErrorAt < ERROR_COOLDOWN_MS) {
+        log(`[${HOOK_NAME}] Skipped: recent error (cooldown)`, { sessionID });
         return;
       }
-      if (state2.mode === "countingDown" || state2.mode === "injecting") {
-        log(`[${HOOK_NAME}] Skipped: already ${state2.mode}`, { sessionID });
+      const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((t) => t.status === "running") : false;
+      if (hasRunningBgTasks) {
+        log(`[${HOOK_NAME}] Skipped: background tasks running`, { sessionID });
         return;
       }
       let todos = [];
@@ -4655,54 +4586,37 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
         const response = await ctx.client.session.todo({ path: { id: sessionID } });
         todos = response.data ?? response;
       } catch (err) {
-        log(`[${HOOK_NAME}] Todo API error`, { sessionID, error: String(err) });
+        log(`[${HOOK_NAME}] Todo fetch failed`, { sessionID, error: String(err) });
         return;
       }
       if (!todos || todos.length === 0) {
-        log(`[${HOOK_NAME}] No todos found`, { sessionID });
+        log(`[${HOOK_NAME}] No todos`, { sessionID });
         return;
       }
       const incompleteCount = getIncompleteCount(todos);
       if (incompleteCount === 0) {
-        log(`[${HOOK_NAME}] All todos completed`, { sessionID, total: todos.length });
+        log(`[${HOOK_NAME}] All todos complete`, { sessionID, total: todos.length });
         return;
       }
-      const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((t) => t.status === "running") : false;
-      if (hasRunningBgTasks) {
-        log(`[${HOOK_NAME}] Skipped: background tasks still running`, { sessionID });
-        return;
-      }
-      log(`[${HOOK_NAME}] Found incomplete todos`, {
-        sessionID,
-        incomplete: incompleteCount,
-        total: todos.length
-      });
-      startCountdown(sessionID, incompleteCount);
+      startCountdown(sessionID, incompleteCount, todos.length);
       return;
     }
     if (event.type === "message.updated") {
       const info = props?.info;
       const sessionID = info?.sessionID;
       const role = info?.role;
-      const finish = info?.finish;
       if (!sessionID)
         return;
       if (role === "user") {
         const state2 = sessions.get(sessionID);
-        if (state2?.mode === "errorBypass") {
-          state2.mode = "idle";
-          log(`[${HOOK_NAME}] User message cleared errorBypass mode`, { sessionID });
+        if (state2) {
+          state2.lastErrorAt = undefined;
         }
-        invalidate(sessionID, "user message received");
-        return;
+        cancelCountdown(sessionID);
+        log(`[${HOOK_NAME}] User message: cleared error state`, { sessionID });
       }
-      if (role === "assistant" && !finish) {
-        invalidate(sessionID, "assistant is working (streaming)");
-        return;
-      }
-      if (role === "assistant" && finish) {
-        log(`[${HOOK_NAME}] Assistant turn finished`, { sessionID, finish });
-        return;
+      if (role === "assistant") {
+        cancelCountdown(sessionID);
       }
       return;
     }
@@ -4711,26 +4625,22 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
       const sessionID = info?.sessionID;
       const role = info?.role;
       if (sessionID && role === "assistant") {
-        invalidate(sessionID, "assistant streaming");
+        cancelCountdown(sessionID);
       }
       return;
     }
     if (event.type === "tool.execute.before" || event.type === "tool.execute.after") {
       const sessionID = props?.sessionID;
       if (sessionID) {
-        invalidate(sessionID, `tool execution (${event.type})`);
+        cancelCountdown(sessionID);
       }
       return;
     }
     if (event.type === "session.deleted") {
       const sessionInfo = props?.info;
       if (sessionInfo?.id) {
-        const state2 = sessions.get(sessionInfo.id);
-        if (state2) {
-          clearTimer(state2);
-        }
-        sessions.delete(sessionInfo.id);
-        log(`[${HOOK_NAME}] Session deleted, state cleaned up`, { sessionID: sessionInfo.id });
+        cleanup(sessionInfo.id);
+        log(`[${HOOK_NAME}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
       }
       return;
     }
@@ -11080,8 +10990,11 @@ function createEmptyMessageSanitizerHook() {
   return {
     "experimental.chat.messages.transform": async (_input, output) => {
       const { messages } = output;
-      for (const message of messages) {
-        if (message.info.role === "user")
+      for (let i = 0;i < messages.length; i++) {
+        const message = messages[i];
+        const isLastMessage = i === messages.length - 1;
+        const isAssistant = message.info.role === "assistant";
+        if (isLastMessage && isAssistant)
           continue;
         const parts = message.parts;
         if (!hasValidContent(parts)) {
@@ -13135,6 +13048,7 @@ Generate comprehensive AGENTS.md files across project hierarchy. Combines root-l
 - **Predict-then-Compare**: Predict standard \u2192 find actual \u2192 document ONLY deviations
 - **Hierarchy Aware**: Parent covers general, children cover specific
 - **No Redundancy**: Child AGENTS.md NEVER repeats parent content
+- **LSP-First**: Use LSP tools for accurate code intelligence when available (semantic > text search)
 
 ---
 
@@ -13197,6 +13111,53 @@ background_task(agent="explore", prompt="Build/CI: FIND .github/workflows, Makef
 background_task(agent="explore", prompt="Test patterns: FIND pytest.ini, jest.config, test structure \u2192 REPORT unique testing conventions")
 \`\`\`
 
+### Code Intelligence Analysis (LSP tools - run in parallel)
+
+LSP provides semantic understanding beyond text search. Use for accurate code mapping.
+
+\`\`\`
+# Step 1: Check LSP availability
+lsp_servers()  # Verify language server is available
+
+# Step 2: Analyze entry point files (run in parallel)
+# Find entry points first, then analyze each with lsp_document_symbols
+lsp_document_symbols(filePath="src/index.ts")      # Main entry
+lsp_document_symbols(filePath="src/main.py")       # Python entry
+lsp_document_symbols(filePath="cmd/main.go")       # Go entry
+
+# Step 3: Discover key symbols across workspace (run in parallel)
+lsp_workspace_symbols(filePath=".", query="class")      # All classes
+lsp_workspace_symbols(filePath=".", query="interface")  # All interfaces
+lsp_workspace_symbols(filePath=".", query="function")   # Top-level functions
+lsp_workspace_symbols(filePath=".", query="type")       # Type definitions
+
+# Step 4: Analyze symbol centrality (for top 5-10 key symbols)
+# High reference count = central/important concept
+lsp_find_references(filePath="src/index.ts", line=X, character=Y)  # Main export
+\`\`\`
+
+#### LSP Analysis Output Format
+
+\`\`\`
+CODE_INTELLIGENCE = {
+  entry_points: [
+    { file: "src/index.ts", exports: ["Plugin", "createHook"], symbol_count: 12 }
+  ],
+  key_symbols: [
+    { name: "Plugin", type: "class", file: "src/index.ts", refs: 45, role: "Central orchestrator" },
+    { name: "createHook", type: "function", file: "src/utils.ts", refs: 23, role: "Hook factory" }
+  ],
+  module_boundaries: [
+    { dir: "src/hooks", exports: 21, imports_from: ["shared/"] },
+    { dir: "src/tools", exports: 15, imports_from: ["shared/", "hooks/"] }
+  ]
+}
+\`\`\`
+
+<critical>
+**LSP Fallback**: If LSP unavailable (no server installed), skip this section and rely on explore agents + AST-grep patterns.
+</critical>
+
 </parallel-tasks>
 
 **Collect all results. Mark "p1-analysis" as completed.**
@@ -13209,13 +13170,35 @@ background_task(agent="explore", prompt="Test patterns: FIND pytest.ini, jest.co
 
 ### Scoring Matrix
 
-| Factor | Weight | Threshold |
-|--------|--------|-----------|
-| File count | 3x | >20 files = high |
-| Subdirectory count | 2x | >5 subdirs = high |
-| Code file ratio | 2x | >70% code = high |
-| Unique patterns | 1x | Has own config |
-| Module boundary | 2x | Has __init__.py/index.ts |
+| Factor | Weight | Threshold | Source |
+|--------|--------|-----------|--------|
+| File count | 3x | >20 files = high | bash |
+| Subdirectory count | 2x | >5 subdirs = high | bash |
+| Code file ratio | 2x | >70% code = high | bash |
+| Unique patterns | 1x | Has own config | explore |
+| Module boundary | 2x | Has __init__.py/index.ts | bash |
+| **Symbol density** | 2x | >30 symbols = high | LSP |
+| **Export count** | 2x | >10 exports = high | LSP |
+| **Reference centrality** | 3x | Symbols with >20 refs | LSP |
+
+<lsp-scoring>
+**LSP-Enhanced Scoring** (if available):
+
+\`\`\`
+For each directory in candidates:
+  symbols = lsp_document_symbols(dir/index.ts or dir/__init__.py)
+  
+  symbol_score = len(symbols) > 30 ? 6 : len(symbols) > 15 ? 3 : 0
+  export_score = count(exported symbols) > 10 ? 4 : 0
+  
+  # Check if this module is central (many things depend on it)
+  for each exported symbol:
+    refs = lsp_find_references(symbol)
+    if refs > 20: centrality_score += 3
+  
+  total_score += symbol_score + export_score + centrality_score
+\`\`\`
+</lsp-scoring>
 
 ### Decision Rules
 
@@ -13273,6 +13256,28 @@ Root AGENTS.md gets **full treatment** with Predict-then-Compare synthesis.
 |------|----------|-------|
 | Add feature X | \\\`src/x/\\\` | {pattern hint} |
 
+## CODE MAP
+
+{Generated from LSP analysis - shows key symbols and their relationships}
+
+| Symbol | Type | Location | Refs | Role |
+|--------|------|----------|------|------|
+| {MainClass} | Class | \\\`src/index.ts\\\` | {N} | {Central orchestrator} |
+| {createX} | Function | \\\`src/utils.ts\\\` | {N} | {Factory pattern} |
+| {Config} | Interface | \\\`src/types.ts\\\` | {N} | {Configuration contract} |
+
+### Module Dependencies
+
+\\\`\\\`\\\`
+{entry} \u2500\u2500imports\u2500\u2500> {core/}
+   \u2502                    \u2502
+   \u2514\u2500\u2500imports\u2500\u2500> {utils/} <\u2500\u2500imports\u2500\u2500 {features/}
+\\\`\\\`\\\`
+
+<code-map-note>
+**Skip CODE MAP if**: LSP unavailable OR project too small (<10 files) OR no clear module boundaries.
+</code-map-note>
+
 ## CONVENTIONS
 
 {ONLY deviations from standard - skip generic advice}
@@ -13413,7 +13418,10 @@ Hierarchy:
 - **Generic content**: Remove anything that applies to ALL projects
 - **Sequential execution**: MUST use parallel agents
 - **Deep nesting**: Rarely need AGENTS.md at depth 4+
-- **Verbose style**: "This directory contains..." \u2192 just list it`;
+- **Verbose style**: "This directory contains..." \u2192 just list it
+- **Ignoring LSP**: If LSP available, USE IT - semantic analysis > text grep
+- **LSP without fallback**: Always have explore agent backup if LSP unavailable
+- **Over-referencing**: Don't trace refs for EVERY symbol - focus on exports only`;
 
 // src/features/builtin-commands/commands.ts
 var BUILTIN_COMMAND_DEFINITIONS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "OpenCode plugin - custom agents (oracle, librarian) and enhanced features",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",