oh-my-opencode 0.1.13 → 0.1.15

package/README.ko.md

@@ -3,9 +3,14 @@
 ## 목차
 
 - [Oh My OpenCode](#oh-my-opencode)
-  - [설치](#설치)
   - [세 줄 요약](#세-줄-요약)
-  - [Why OpenCode \& Why Oh My OpenCode](#why-opencode--why-oh-my-opencode)
+  - [설치](#설치)
+  - [설정](#설정)
+    - [특정 MCP 비활성화](#특정-mcp-비활성화)
+    - [특정 Agent 비활성화](#특정-agent-비활성화)
+    - [Agent 설정](#agent-설정)
+  - [LLM Agent를 위한 안내](#llm-agent를-위한-안내)
+  - [Why OpenCode & Why Oh My OpenCode](#why-opencode--why-oh-my-opencode)
   - [기능](#기능)
     - [Hooks](#hooks)
     - [Agents](#agents)
@@ -33,6 +38,17 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
 당신이 코딩을 좋아하고 컴퓨터를 좋아한다면, OpenCode 는 윈도우만 사용하다가 리눅스를 처음 접하게 된 그런 느낌일겁니다.
 그렇지 않은 당신도 약간의 시간을 투자해서 당신의 실력과 생산성을 몇배로 부스트하세요.
 
+## 세 줄 요약
+
+- **모델 설정이 필요합니다**
+  - 이 플러그인은 [OpenCode Zen](https://opencode.ai/docs/zen/), Google, OpenAI, Anthropic 의 모델을 사용합니다.
+    - Anthropic 모델들을 사용하기 위해 [OpenCode 의 내장 Claude Code Max Plan 로그인 기능](https://opencode.ai/docs/providers/#anthropic)을 사용하세요. (Anthropic 플랜은 유료입니다)
+    - OpenAI 모델들을 사용하기 위해 이 [OpenCode-OpenAI-Codex-Auth 플러그인](https://github.com/numman-ali/opencode-openai-codex-auth)을 추천합니다. (OpenAI 플랜은 유료입니다)
+    - Gemini, GPT 를 위해 [VibeProxy (macOS Only)](https://github.com/automazeio/vibeproxy) 또는 [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)를 추천합니다. (Gemini 는 구독하지 않아도 사용 할 수 있습니다)
+- **사실 밑의 내용은 읽지 않아도 됩니다. 그냥 설치하시면 됩니다. 모델 설정하고나면 추가로 공부하거나 알 필요가 없고, 설치하고 나면 그냥 더 좋아집니다.**
+- **이 문서도 그냥 Claude Code, OpenCode, Cursor에 붙여넣고, 설치하고, 사용자의 개입이 필요할 때 알려달라고 프롬프팅하세요. 그럼 그냥 깔립니다.**
+  - 당신이 LLM Agent 라면, 필요한 플러그인과 의존성을 설치하고, tmux 를 통해 opencode auth login 을 실행하여 사용자의 구성을 도와주세요.
+
 ## 설치
 
 `~/.config/opencode/opencode.json`에 추가:
@@ -45,16 +61,162 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
 }
 ```
 
-## 세 줄 요약
+## 설정
 
-- **모델 설정이 필요합니다**
-  - 이 플러그인은 [OpenCode Zen](https://opencode.ai/docs/zen/), Google, OpenAI, Anthropic 의 모델을 사용합니다.
-    - Anthropic 모델들을 사용하기 위해 [OpenCode 의 내장 Claude Code Max Plan 로그인 기능](https://opencode.ai/docs/providers/#anthropic)을 사용하세요. (Anthropic 플랜은 유료입니다)
-    - OpenAI 모델들을 사용하기 위해 이 [OpenCode-OpenAI-Codex-Auth 플러그인](https://github.com/numman-ali/opencode-openai-codex-auth)을 추천합니다. (OpenAI 플랜은 유료입니다)
-    - Gemini, GPT 를 위해 [VibeProxy (macOS Only)](https://github.com/automazeio/vibeproxy) 또는 [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)를 추천합니다. (Gemini 는 구독하지 않아도 사용 할 수 있습니다)
-- **사실 밑의 내용은 읽지 않아도 됩니다. 그냥 설치하시면 됩니다. 모델 설정하고나면 추가로 공부하거나 알 필요가 없고, 설치하고 나면 그냥 더 좋아집니다.**
-- **이 문서도 그냥 Claude Code, OpenCode, Cursor에 붙여넣고, 설치하고, 사용자의 개입이 필요할 때 알려달라고 프롬프팅하세요. 그럼 그냥 깔립니다.**
-  - 당신이 LLM Agent 라면, 필요한 플러그인과 의존성을 설치하고, tmux 를 통해 opencode auth login 을 실행하여 사용자의 구성을 도와주세요.
+`oh-my-opencode.json` (또는 `.oh-my-opencode.json`) 파일을 프로젝트 루트에 생성해서 Oh My OpenCode를 입맛대로 설정할 수 있어.
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json"
+}
+```
+
+설정 파일은 스키마를 통해 자동완성을 지원합니다. 자세한 내용은 각 기능 섹션에서 설명합니다.
+
+### 특정 MCP 비활성화
+
+특정 MCP가 거슬린다면 끌 수 있어.
+
+```json
+{
+  "disabled_mcps": ["websearch_exa"]
+}
+```
+
+### 특정 Agent 비활성화
+
+특정 에이전트가 마음에 안 들거나, 토큰을 아끼고 싶다면 비활성화해.
+비활성화 가능한 목록: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`
+
+```json
+{
+  "disabled_agents": ["frontend-ui-ux-engineer"]
+}
+```
+
+### Agent 설정
+
+각 에이전트의 모델, 프롬프트, 권한 등을 세밀하게 조정할 수 있어.
+
+**설정 옵션:**
+
+| 옵션 | 설명 |
+|------|------|
+| `model` | 사용할 모델 ID (예: `anthropic/claude-sonnet-4`) |
+| `temperature` | 창의성 조절 (0.0 ~ 2.0) |
+| `top_p` | 단어 선택 다양성 (0.0 ~ 1.0) |
+| `prompt` | 시스템 프롬프트 오버라이드 |
+| `tools` | 특정 도구 활성화/비활성화 (`{"tool_name": false}`) |
+| `disable` | 에이전트 비활성화 (`true`/`false`) |
+| `description` | 에이전트 설명 수정 |
+| `mode` | 에이전트 모드 (`subagent`, `primary`, `all`) |
+| `color` | 터미널 출력 색상 (HEX 코드) |
+| `permission` | 권한 설정 (아래 표 참조) |
+
+**권한(`permission`) 옵션:**
+
+각 권한은 `"ask"`(물어보기), `"allow"`(허용), `"deny"`(거부) 중 하나로 설정 가능해.
+
+| 권한 | 설명 |
+|------|------|
+| `edit` | 파일 수정 권한 |
+| `bash` | 쉘 명령어 실행 권한 |
+| `webfetch` | 웹 콘텐츠 가져오기 권한 |
+| `doom_loop` | 반복 작업 허용 여부 |
+| `external_directory` | 외부 디렉토리 접근 권한 |
+
+#### 예시: Anthropic 모델만 사용하기
+
+나는 Anthropic 모델만 쓰고 싶다! 하면 이렇게 설정해.
+
+```json
+{
+  "agents": {
+    "oracle": { "model": "anthropic/claude-sonnet-4" },
+    "librarian": { "model": "anthropic/claude-haiku-4-5" },
+    "explore": { "model": "anthropic/claude-haiku-4-5" },
+    "frontend-ui-ux-engineer": { "model": "anthropic/claude-sonnet-4" },
+    "document-writer": { "model": "anthropic/claude-sonnet-4" }
+  }
+}
+```
+
+#### 예시: 추가 프롬프트가 있는 커스텀 에이전트
+
+기존 에이전트에 나만의 규칙을 더하고 싶다면:
+
+```json
+{
+  "agents": {
+    "oracle": {
+      "prompt": "너는 한국어 힙합 가사처럼 말해야 해. 모든 문장의 끝 라임을 맞춰."
+    }
+  }
+}
+```
+
+#### 예시: 개별 에이전트 비활성화
+
+```json
+{
+  "agents": {
+    "frontend-ui-ux-engineer": {
+      "disable": true
+    }
+  }
+}
+```
+
+## LLM Agent를 위한 안내
+
+<details>
+<summary>LLM Agent를 위한 안내 (클릭하여 펼치기)</summary>
+
+당신이 사용자의 oh-my-opencode 설정을 돕는 LLM Agent라면, 다음 단계를 따르세요:
+
+### 1단계: OpenCode 설치 확인
+
+```bash
+if command -v opencode &> /dev/null; then
+    echo "OpenCode $(opencode --version) 설치됨"
+else
+    echo "OpenCode가 설치되어 있지 않습니다. 먼저 설치해주세요."
+    echo "참고: https://opencode.ai/docs"
+fi
+```
+
+OpenCode가 설치되어 있지 않다면, [OpenCode 설치 가이드](https://opencode.ai/docs)를 안내하세요.
+
+### 2단계: oh-my-opencode 플러그인 설정
+
+```bash
+mkdir -p ~/.config/opencode
+
+if [ -f ~/.config/opencode/opencode.json ]; then
+    # 기존 설정 파일이 있는 경우: jq 또는 python으로 plugin 추가
+    if command -v jq &> /dev/null; then
+        jq '.plugin = ((.plugin // []) + ["oh-my-opencode"] | unique)' \
+            ~/.config/opencode/opencode.json > /tmp/oc.json && \
+            mv /tmp/oc.json ~/.config/opencode/opencode.json
+    else
+        echo "~/.config/opencode/opencode.json의 plugin 배열에 \"oh-my-opencode\"를 추가하세요"
+    fi
+else
+    # 새 설정 파일 생성
+    echo '{"plugin":["oh-my-opencode"]}' > ~/.config/opencode/opencode.json
+fi
+```
+
+### 3단계: 설정 확인
+
+```bash
+opencode --version  # 1.0.132 이상이어야 함
+cat ~/.config/opencode/opencode.json  # plugin 배열에 "oh-my-opencode"가 있어야 함
+```
+
+> **참고**: 모델 인증이 필요하면, `opencode` 실행 후 `/connect` 명령어를 사용하거나, tmux를 통해 `opencode auth login`을 안내하세요.
+
+</details>
 
 ## Why OpenCode & Why Oh My OpenCode
 
@@ -93,6 +255,23 @@ OpenCode 는 아주 확장가능하고 아주 커스터마이저블합니다.
 - **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): 개발자로 전향한 디자이너라는 설정을 갖고 있습니다. 멋진 UI를 만듭니다. 아름답고 창의적인 UI 코드를 생성하는 데 탁월한 Gemini를 사용합니다.
 - **document-writer** (`google/gemini-3-pro-preview`): 기술 문서 전문가라는 설정을 갖고 있습니다. Gemini 는 문학가입니다. 글을 기가막히게 씁니다.
 
+#### 모델 설정 오버라이드
+
+에이전트들은 [OpenCode의 모델 설정](https://opencode.ai/docs/models/#configure-models)과 완전히 동일한 스펙으로 오버라이드를 지원합니다. 권장하진 않지만, 예를 들어 Anthropic 모델만 사용하기로 결정했다면 이렇게 구성할 수 있습니다:
+
+```json
+{
+  "agents": {
+    "explore": {
+      "model": "anthropic/claude-haiku-4-5"
+    },
+    "frontend-ui-ux-engineer": {
+      "model": "anthropic/claude-opus-4"
+    }
+  }
+}
+```
+
 ### Tools
 
 #### 내장 LSP Tools
@@ -124,6 +303,7 @@ OpenCode 는 아주 확장가능하고 아주 커스터마이저블합니다.
 #### 내장 MCPs
 
 - **websearch_exa**: Exa AI 웹 검색. 실시간 웹 검색과 콘텐츠 스크래핑을 수행합니다. 관련 웹사이트에서 LLM에 최적화된 컨텍스트를 반환합니다.
+- **context7**: 라이브러리 문서 조회. 정확한 코딩을 위해 최신 라이브러리 문서를 가져옵니다.
 
 ### 기타 편의 기능
 - **Terminal Title**: 세션 상태에 따라 터미널 타이틀을 자동 업데이트합니다 (유휴 ○, 처리중 ◐, 도구 ⚡, 에러 ✖). tmux를 지원합니다.
@@ -153,5 +333,3 @@ OpenCode 를 사용하여 이 프로젝트의 99% 를 작성했습니다. 기능
 
 - [1.0.132](https://github.com/sst/opencode/releases/tag/v1.0.132) 혹은 이것보다 낮은 버전을 사용중이라면, OpenCode 의 버그로 인해 제대로 구성이 되지 않을 수 있습니다.
   - [이를 고치는 PR 이 1.0.132 배포 이후에 병합되었으므로](https://github.com/sst/opencode/pull/5040) 이 변경사항이 포함된 최신 버전을 사용해주세요.
-
-

package/README.md

@@ -3,11 +3,14 @@ English | [한국어](README.ko.md)
 ## Contents
 
 - [Oh My OpenCode](#oh-my-opencode)
+  - [TL;DR](#tldr)
   - [Installation](#installation)
+  - [For LLM Agents](#for-llm-agents)
   - [Configuration](#configuration)
     - [Disable specific MCPs](#disable-specific-mcps)
-  - [TL;DR](#tldr)
-  - [Why OpenCode \& Why Oh My OpenCode](#why-opencode--why-oh-my-opencode)
+    - [Disable specific Agents](#disable-specific-agents)
+    - [Agent Configuration](#agent-configuration)
+  - [Why OpenCode & Why Oh My OpenCode](#why-opencode--why-oh-my-opencode)
   - [Features](#features)
     - [Hooks](#hooks)
     - [Agents](#agents)
@@ -33,6 +36,17 @@ You don't write code just for a paycheck? You write because you genuinely love i
 
 To you, OpenCode will feel like the paradigm shift from Windows to Linux. Not you? It's still worth the investment. Give it 10 minutes. Your work and life will improve. I promise.
 
+## TL;DR
+
+- **Model Setup Required**
+  - This plugin utilizes models from [OpenCode Zen](https://opencode.ai/docs/zen/), Google, OpenAI, and Anthropic.
+    - For Anthropic models, use [OpenCode's built-in Claude Code Max Plan login](https://opencode.ai/docs/providers/#anthropic).
+    - For OpenAI models, I recommend the [OpenCode-OpenAI-Codex-Auth plugin](https://github.com/numman-ali/opencode-openai-codex-auth).
+    - For Gemini and GPT, use [VibeProxy (macOS Only)](https://github.com/automazeio/vibeproxy) or [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI).
+- **Truth be told, the rest is optional. Just install it. Once set up, no further learning is required. It simply evolves.**
+- **Paste this document into Claude Code, OpenCode, or Cursor, instruct it to install, and ask for assistance if needed. It works seamlessly.**
+  - If you are an LLM Agent, install the required plugins and dependencies, then run `opencode auth login` via tmux to assist the user with configuration.
+
 ## Installation
 
 Add to `~/.config/opencode/opencode.json`:
@@ -45,49 +59,176 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
+## For LLM Agents
+
+<details>
+<summary>For LLM Agents (Click to expand)</summary>
+
+If you are an LLM Agent helping a user set up oh-my-opencode, follow these steps:
+
+### Step 1: Verify OpenCode Installation
+
+```bash
+if command -v opencode &> /dev/null; then
+    echo "OpenCode $(opencode --version) is installed"
+else
+    echo "OpenCode is not installed. Please install it first."
+    echo "See: https://opencode.ai/docs"
+fi
+```
+
+If OpenCode is not installed, guide the user to [OpenCode Installation Guide](https://opencode.ai/docs).
+
+### Step 2: Configure oh-my-opencode Plugin
+
+```bash
+mkdir -p ~/.config/opencode
+
+if [ -f ~/.config/opencode/opencode.json ]; then
+    # Existing config: add plugin using jq or python
+    if command -v jq &> /dev/null; then
+        jq '.plugin = ((.plugin // []) + ["oh-my-opencode"] | unique)' \
+            ~/.config/opencode/opencode.json > /tmp/oc.json && \
+            mv /tmp/oc.json ~/.config/opencode/opencode.json
+    else
+        echo "Add \"oh-my-opencode\" to plugin array in ~/.config/opencode/opencode.json"
+    fi
+else
+    # New config
+    echo '{"plugin":["oh-my-opencode"]}' > ~/.config/opencode/opencode.json
+fi
+```
+
+### Step 3: Verify Setup
+
+```bash
+opencode --version  # Should be >= 1.0.132
+cat ~/.config/opencode/opencode.json  # Should contain "oh-my-opencode" in plugin array
+```
+
+> **Note**: If model authentication is needed, run `opencode` and use `/connect` command, or assist the user with `opencode auth login` via tmux.
+
+</details>
+
 ## Configuration
 
 You can configure Oh My OpenCode by creating a `oh-my-opencode.json` (or `.oh-my-opencode.json`) file in your project root.
 
-### JSON Schema Support
+Configuration supports autocomplete via schema. Details are covered in each feature section below.
 
-For autocompletion and validation in VS Code (or other editors), add the `$schema` property to your configuration file.
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json"
+}
+```
+
+### Disable specific MCPs
+
+If you want to disable specific built-in MCPs, you can use the `disabled_mcps` option.
 
-**Using Remote Schema (Recommended):**
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json",
-  "disabled_mcps": ["context7"]
+  "disabled_mcps": ["context7", "websearch_exa"]
 }
 ```
 
-**Using Local Schema:**
+### Disable specific Agents
+
+If you want to disable specific built-in agents, you can use the `disabled_agents` option.
+
 ```json
 {
-  "$schema": "./node_modules/oh-my-opencode/dist/oh-my-opencode.schema.json"
+  "disabled_agents": ["explore", "frontend-ui-ux-engineer"]
 }
 ```
 
-### Disable specific MCPs
+Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`
 
-If you want to disable specific built-in MCPs, you can use the `disabled_mcps` option.
+### Agent Configuration
+
+You can override the configuration of any built-in agent using the `agents` option. This allows you to change models, adjust creativity, modify permissions, or disable agents individually.
+
+#### Configuration Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `model` | string | Override the default model (e.g., "anthropic/claude-sonnet-4") |
+| `temperature` | number (0-2) | Controls randomness (0 = deterministic, 2 = creative) |
+| `top_p` | number (0-1) | Nucleus sampling parameter |
+| `prompt` | string | Additional system prompt to append |
+| `tools` | object | Enable/disable specific tools (e.g., `{"websearch_exa": false}`) |
+| `disable` | boolean | Completely disable the agent |
+| `description` | string | Override agent description |
+| `mode` | "subagent" | "primary" | "all" | When agent is available |
+| `color` | string | Hex color code for terminal output (e.g., "#FF0000") |
+| `permission` | object | Permission settings for sensitive operations |
+
+#### Permission Options
+
+| Option | Values | Description |
+|--------|--------|-------------|
+| `edit` | "ask" | "allow" | "deny" | File modification permissions |
+| `bash` | "ask" | "allow" | "deny" | object | Shell command execution permissions |
+| `webfetch` | "ask" | "allow" | "deny" | Web access permissions |
+| `doom_loop` | "ask" | "allow" | "deny" | Infinite loop prevention |
+| `external_directory` | "ask" | "allow" | "deny" | Access outside project root |
+
+#### Examples
+
+**Using Only Anthropic Models**
+
+This configuration forces all agents to use Anthropic models, suitable for users with only Anthropic API access.
 
 ```json
 {
-  "disabled_mcps": ["context7", "websearch_exa"]
+  "agents": {
+    "oracle": {
+      "model": "anthropic/claude-sonnet-4"
+    },
+    "librarian": {
+      "model": "anthropic/claude-haiku-4-5"
+    },
+    "explore": {
+      "model": "anthropic/claude-haiku-4-5"
+    },
+    "frontend-ui-ux-engineer": {
+      "model": "anthropic/claude-sonnet-4"
+    },
+    "document-writer": {
+      "model": "anthropic/claude-sonnet-4"
+    }
+  }
 }
 ```
 
-## TL;DR
+**Custom Agent with Additional Prompt**
 
-- **Model Setup Required**
-  - This plugin utilizes models from [OpenCode Zen](https://opencode.ai/docs/zen/), Google, OpenAI, and Anthropic.
-    - For Anthropic models, use [OpenCode's built-in Claude Code Max Plan login](https://opencode.ai/docs/providers/#anthropic).
-    - For OpenAI models, I recommend the [OpenCode-OpenAI-Codex-Auth plugin](https://github.com/numman-ali/opencode-openai-codex-auth).
-    - For Gemini and GPT, use [VibeProxy (macOS Only)](https://github.com/automazeio/vibeproxy) or [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI).
-- **Truth be told, the rest is optional. Just install it. Once set up, no further learning is required. It simply evolves.**
-- **Paste this document into Claude Code, OpenCode, or Cursor, instruct it to install, and ask for assistance if needed. It works seamlessly.**
-  - If you are an LLM Agent, install the required plugins and dependencies, then run `opencode auth login` via tmux to assist the user with configuration.
+Inject custom instructions into an agent's system prompt.
+
+```json
+{
+  "agents": {
+    "frontend-ui-ux-engineer": {
+      "prompt": "ALWAYS use Tailwind CSS. NEVER use inline styles. Prefer dark mode defaults.",
+      "temperature": 0.8
+    }
+  }
+}
+```
+
+**Disable Agents Individually**
+
+You can also disable agents using the `disable` property within the agent config.
+
+```json
+{
+  "agents": {
+    "explore": {
+      "disable": true
+    }
+  }
+}
+```
 
 ## Why OpenCode & Why Oh My OpenCode
 
@@ -124,6 +265,23 @@ I believe in the right tool for the job. For your wallet's sake, use CLIProxyAPI
 - **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): A designer turned developer. Creates stunning UIs. Uses Gemini because its creativity and UI code generation are superior.
 - **document-writer** (`google/gemini-3-pro-preview`): A technical writing expert. Gemini is a wordsmith; it writes prose that flows naturally.
 
+#### Model Configuration Override
+
+Agents follow the exact same model configuration spec as [OpenCode's model configuration](https://opencode.ai/docs/models/#configure-models). While not generally recommended, if you decide to use only Anthropic models, you could configure like this:
+
+```json
+{
+  "agents": {
+    "explore": {
+      "model": "anthropic/claude-haiku-4-5"
+    },
+    "frontend-ui-ux-engineer": {
+      "model": "anthropic/claude-opus-4"
+    }
+  }
+}
+```
+
 ### Tools
 
 #### Built-in LSP Tools

package/dist/hooks/comment-checker/cli.d.ts

@@ -1,3 +1,18 @@
+/**
+ * Asynchronously get comment-checker binary path.
+ * Will trigger lazy download if binary not found.
+ */
+export declare function getCommentCheckerPath(): Promise<string | null>;
+/**
+ * Synchronously get comment-checker path (no download).
+ * Returns cached path or searches known locations.
+ */
+export declare function getCommentCheckerPathSync(): string | null;
+/**
+ * Start background initialization.
+ * Call this early to trigger download while other init happens.
+ */
+export declare function startBackgroundInit(): void;
 export declare const COMMENT_CHECKER_CLI_PATH: string | null;
 export interface HookInput {
     session_id: string;
@@ -21,5 +36,17 @@ export interface CheckResult {
     hasComments: boolean;
     message: string;
 }
-export declare function runCommentChecker(input: HookInput): Promise<CheckResult>;
+/**
+ * Run comment-checker CLI with given input.
+ * @param input Hook input to check
+ * @param cliPath Optional explicit path to CLI binary
+ */
+export declare function runCommentChecker(input: HookInput, cliPath?: string): Promise<CheckResult>;
+/**
+ * Check if CLI is available (sync check, no download).
+ */
 export declare function isCliAvailable(): boolean;
+/**
+ * Check if CLI will be available (async, may trigger download).
+ */
+export declare function ensureCliAvailable(): Promise<boolean>;

package/dist/hooks/comment-checker/constants.d.ts

@@ -1,7 +1,3 @@
-export declare const EXTENSION_TO_LANGUAGE: Record<string, string>;
-export declare const QUERY_TEMPLATES: Record<string, string>;
-export declare const DOCSTRING_QUERIES: Record<string, string>;
 export declare const BDD_KEYWORDS: Set<string>;
 export declare const TYPE_CHECKER_PREFIXES: string[];
 export declare const HOOK_MESSAGE_HEADER = "COMMENT/DOCSTRING DETECTED - IMMEDIATE ACTION REQUIRED\n\nYour recent changes contain comments or docstrings, which triggered this hook.\nYou need to take immediate action. You must follow the conditions below.\n(Listed in priority order - you must always act according to this priority order)\n\nCRITICAL WARNING: This hook message MUST NEVER be ignored, even if you receive it multiple times.\nYou MUST provide corresponding explanation or action for EACH occurrence of this message.\nIgnoring this message or failing to respond appropriately is strictly prohibited.\n\nPRIORITY-BASED ACTION GUIDELINES:\n\n1. This is a comment/docstring that already existed before\n\t-> Explain to the user that this is an existing comment/docstring and proceed (justify it)\n\n2. This is a newly written comment: but it's in given, when, then format\n\t-> Tell the user it's a BDD comment and proceed (justify it)\n\t-> Note: This applies to comments only, not docstrings\n\n3. This is a newly written comment/docstring: but it's a necessary comment/docstring\n\t-> Tell the user why this comment/docstring is absolutely necessary and proceed (justify it)\n\t-> Examples of necessary comments: complex algorithms, security-related, performance optimization, regex, mathematical formulas\n\t-> Examples of necessary docstrings: public API documentation, complex module/class interfaces\n\t-> IMPORTANT: Most docstrings are unnecessary if the code is self-explanatory. Only keep truly essential ones.\n\n4. This is a newly written comment/docstring: but it's an unnecessary comment/docstring\n\t-> Apologize to the user and remove the comment/docstring.\n\t-> Make the code itself clearer so it can be understood without comments/docstrings.\n\t-> For verbose docstrings: refactor code to be self-documenting instead of adding lengthy explanations.\n\nMANDATORY REQUIREMENT: You must acknowledge this hook message and take one of the above actions.\nReview in the above priority order and take the corresponding action EVERY TIME this appears.\n\nDetected comments/docstrings:\n";
-export declare function getLanguageByExtension(filePath: string): string | null;

package/dist/hooks/comment-checker/downloader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Get the cache directory for oh-my-opencode binaries.
+ * Follows XDG Base Directory Specification.
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the binary name based on platform.
+ */
+export declare function getBinaryName(): string;
+/**
+ * Get the cached binary path if it exists.
+ */
+export declare function getCachedBinaryPath(): string | null;
+/**
+ * Download the comment-checker binary from GitHub Releases.
+ * Returns the path to the downloaded binary, or null on failure.
+ */
+export declare function downloadCommentChecker(): Promise<string | null>;
+/**
+ * Ensure the comment-checker binary is available.
+ * First checks cache, then downloads if needed.
+ * Returns the binary path or null if unavailable.
+ */
+export declare function ensureCommentCheckerBinary(): Promise<string | null>;

package/dist/hooks/comment-checker/types.d.ts

@@ -7,11 +7,6 @@ export interface CommentInfo {
     isDocstring: boolean;
     metadata?: Record<string, string>;
 }
-export interface LanguageConfig {
-    extensions: string[];
-    commentQuery: string;
-    docstringQuery?: string;
-}
 export interface PendingCall {
     filePath: string;
     content?: string;