oh-my-opencode 2.8.1 → 2.8.3

package/README.ja.md

@@ -874,7 +874,7 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
 }
 ```
 
-利用可能なフック：`todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`
+利用可能なフック：`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-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`
 
 **`auto-update-checker`と`startup-toast`について**: `startup-toast` フックは `auto-update-checker` のサブ機能です。アップデートチェックは有効なまま起動トースト通知のみを無効化するには、`disabled_hooks` に `"startup-toast"` を追加してください。すべてのアップデートチェック機能（トーストを含む）を無効化するには、`"auto-update-checker"` を追加してください。
 
@@ -926,7 +926,6 @@ OpenCode でサポートされるすべての LSP 構成およびカスタム設
 ```json
 {
   "experimental": {
-    "tool_output_truncator": true,
     "preemptive_compaction": true,
     "truncate_all_tool_outputs": true,
     "aggressive_truncation": true,
@@ -937,10 +936,9 @@ OpenCode でサポートされるすべての LSP 構成およびカスタム設
 
 | オプション                        | デフォルト | 説明                                                                                                                                                                   |
 | --------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `tool_output_truncator`           | `false`    | コンテキストウィンドウの使用状況に基づいてツール出力（Grep、Glob、LSP、AST-grepなど）を動的に切り詰めます。プロンプトが長くなりすぎるのを防ぎます。                          |
 | `preemptive_compaction`           | `false`    | トークン制限に達する前にセッションを事前にコンパクションします。デフォルトでコンテキストウィンドウ使用率80%で実行されます。                                                   |
 | `preemptive_compaction_threshold` | `0.80`     | プリエンプティブコンパクションをトリガーする閾値（0.5-0.95）。`preemptive_compaction`が有効な場合のみ適用されます。                                                          |
-| `truncate_all_tool_outputs`       | `false`    | `tool_output_truncator`が有効な場合、ホワイトリストのツール（Grep、Glob、LSP、AST-grep）だけでなく、すべてのツール出力を切り詰めます。                                       |
+| `truncate_all_tool_outputs`       | `false`    | ホワイトリストのツール（Grep、Glob、LSP、AST-grep）だけでなく、すべてのツール出力を切り詰めます。Tool output truncator はデフォルトで有効です - `disabled_hooks`で無効化できます。 |
 | `aggressive_truncation`           | `false`    | トークン制限を超えた場合、ツール出力を積極的に切り詰めて制限内に収めます。デフォルトの切り詰めより積極的です。不十分な場合は要約/復元にフォールバックします。                 |
 | `auto_resume`                     | `false`    | thinking block エラーや thinking disabled violation からの回復成功後、自動的にセッションを再開します。最後のユーザーメッセージを抽出して続行します。                        |
 | `dcp_for_compaction`              | `false`    | コンパクション用DCP（動的コンテキスト整理）を有効化 - トークン制限超過時に最初に実行されます。コンパクション前に重複したツール呼び出しと古いツール出力を整理します。                |

package/README.ko.md

@@ -871,7 +871,7 @@ Schema 자동 완성이 지원됩니다:
 }
 ```
 
-사용 가능한 훅: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`
+사용 가능한 훅: `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-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`
 
 **`auto-update-checker`와 `startup-toast`에 대한 참고사항**: `startup-toast` 훅은 `auto-update-checker`의 하위 기능입니다. 업데이트 확인은 유지하면서 시작 토스트 알림만 비활성화하려면 `disabled_hooks`에 `"startup-toast"`를 추가하세요. 모든 업데이트 확인 기능(토스트 포함)을 비활성화하려면 `"auto-update-checker"`를 추가하세요.
 
@@ -923,7 +923,6 @@ OpenCode 에서 지원하는 모든 LSP 구성 및 커스텀 설정 (opencode.js
 ```json
 {
   "experimental": {
-    "tool_output_truncator": true,
     "preemptive_compaction": true,
     "truncate_all_tool_outputs": true,
     "aggressive_truncation": true,
@@ -934,10 +933,9 @@ OpenCode 에서 지원하는 모든 LSP 구성 및 커스텀 설정 (opencode.js
 
 | 옵션                              | 기본값  | 설명                                                                                                                                                              |
 | --------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `tool_output_truncator`           | `false` | 컨텍스트 윈도우 사용량에 따라 도구 출력(Grep, Glob, LSP, AST-grep 등)을 동적으로 잘라냅니다. 프롬프트가 너무 길어지는 것을 방지합니다.                                   |
 | `preemptive_compaction`           | `false` | 토큰 제한에 도달하기 전에 세션을 미리 컴팩션합니다. 기본적으로 컨텍스트 윈도우 사용량이 80%일 때 실행됩니다.                                                              |
 | `preemptive_compaction_threshold` | `0.80`  | 선제적 컴팩션을 트리거할 임계값 비율(0.5-0.95). `preemptive_compaction`이 활성화된 경우에만 적용됩니다.                                                                |
-| `truncate_all_tool_outputs`       | `false` | `tool_output_truncator`가 활성화된 경우, 화이트리스트 도구(Grep, Glob, LSP, AST-grep)만이 아닌 모든 도구 출력을 잘라냅니다.                                             |
+| `truncate_all_tool_outputs`       | `false` | 화이트리스트 도구(Grep, Glob, LSP, AST-grep)만이 아닌 모든 도구 출력을 잘라냅니다. Tool output truncator는 기본적으로 활성화됩니다 - `disabled_hooks`로 비활성화 가능합니다. |
 | `aggressive_truncation`           | `false` | 토큰 제한을 초과하면 도구 출력을 공격적으로 잘라내어 제한 내에 맞춥니다. 기본 truncation보다 더 공격적입니다. 부족하면 요약/복구로 fallback합니다.                      |
 | `auto_resume`                     | `false` | thinking block 에러나 thinking disabled violation으로부터 성공적으로 복구한 후 자동으로 세션을 재개합니다. 마지막 사용자 메시지를 추출하여 계속합니다.                |
 | `dcp_for_compaction`              | `false` | 컴팩션용 DCP(동적 컨텍스트 정리) 활성화 - 토큰 제한 초과 시 먼저 실행됩니다. 컴팩션 전에 중복 도구 호출과 오래된 도구 출력을 정리합니다.                                  |

package/README.md

@@ -910,7 +910,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`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`
+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-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `empty-message-sanitizer`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`
 
 **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`.
 
@@ -962,7 +962,6 @@ Opt-in experimental features that may change or be removed in future versions. U
 ```json
 {
   "experimental": {
-    "tool_output_truncator": true,
     "preemptive_compaction": true,
     "truncate_all_tool_outputs": true,
     "aggressive_truncation": true,
@@ -973,10 +972,9 @@ Opt-in experimental features that may change or be removed in future versions. U
 
 | Option                      | Default | Description                                                                                                                                                                                  |
 | --------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `tool_output_truncator`     | `false` | Enable dynamic truncation of tool outputs (Grep, Glob, LSP, AST-grep, etc.) based on context window usage. Prevents prompts from becoming too long.                                          |
 | `preemptive_compaction`     | `false` | Compacts session proactively before hitting hard token limits. Runs at 80% context window usage by default.                                                                                  |
 | `preemptive_compaction_threshold` | `0.80` | Threshold percentage (0.5-0.95) to trigger preemptive compaction. Only applies when `preemptive_compaction` is enabled.                                                                     |
-| `truncate_all_tool_outputs` | `false` | When `tool_output_truncator` is enabled, truncates ALL tool outputs instead of just whitelisted tools (Grep, Glob, LSP, AST-grep).                                                           |
+| `truncate_all_tool_outputs` | `false` | Truncates ALL tool outputs instead of just whitelisted tools (Grep, Glob, LSP, AST-grep). Tool output truncator is enabled by default - disable via `disabled_hooks`.                        |
 | `aggressive_truncation`     | `false` | When token limit is exceeded, aggressively truncates tool outputs to fit within limits. More aggressive than the default truncation behavior. Falls back to summarize/revert if insufficient. |
 | `auto_resume`               | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues.                            |
 | `dcp_for_compaction`        | `false` | Enable DCP (Dynamic Context Pruning) for compaction - runs first when token limit exceeded. Prunes duplicate tool calls and old tool outputs before running compaction.                      |

package/README.zh-cn.md

@@ -878,7 +878,7 @@ Sisyphus Agent 也能自定义：
 }
 ```
 
-可关的 hook：`todo-continuation-enforcer`、`context-window-monitor`、`session-recovery`、`session-notification`、`comment-checker`、`grep-output-truncator`、`directory-agents-injector`、`directory-readme-injector`、`empty-task-response-detector`、`think-mode`、`anthropic-context-window-limit-recovery`、`rules-injector`、`background-notification`、`auto-update-checker`、`startup-toast`、`keyword-detector`、`agent-usage-reminder`、`non-interactive-env`、`interactive-bash-session`、`empty-message-sanitizer`、`compaction-context-injector`、`thinking-block-validator`、`claude-code-hooks`、`ralph-loop`
+可关的 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-context-window-limit-recovery`、`rules-injector`、`background-notification`、`auto-update-checker`、`startup-toast`、`keyword-detector`、`agent-usage-reminder`、`non-interactive-env`、`interactive-bash-session`、`empty-message-sanitizer`、`compaction-context-injector`、`thinking-block-validator`、`claude-code-hooks`、`ralph-loop`
 
 **关于 `auto-update-checker` 和 `startup-toast`**: `startup-toast` hook 是 `auto-update-checker` 的子功能。若想保持更新检查但只禁用启动提示通知，在 `disabled_hooks` 中添加 `"startup-toast"`。若要禁用所有更新检查功能（包括提示），添加 `"auto-update-checker"`。
 
@@ -930,7 +930,6 @@ Oh My OpenCode 送你重构工具（重命名、代码操作）。
 ```json
 {
   "experimental": {
-    "tool_output_truncator": true,
     "preemptive_compaction": true,
     "truncate_all_tool_outputs": true,
     "aggressive_truncation": true,
@@ -941,10 +940,9 @@ Oh My OpenCode 送你重构工具（重命名、代码操作）。
 
 | 选项                              | 默认值  | 说明                                                                                                                                           |
 | --------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| `tool_output_truncator`           | `false` | 根据上下文窗口使用情况动态截断工具输出（Grep、Glob、LSP、AST-grep 等）。防止提示过长。                                                              |
 | `preemptive_compaction`           | `false` | 在达到 token 限制之前主动压缩会话。默认在上下文窗口使用率达到 80% 时运行。                                                                          |
 | `preemptive_compaction_threshold` | `0.80`  | 触发预先压缩的阈值比例（0.5-0.95）。仅在 `preemptive_compaction` 启用时生效。                                                                       |
-| `truncate_all_tool_outputs`       | `false` | 当 `tool_output_truncator` 启用时，截断所有工具输出，而不仅仅是白名单工具（Grep、Glob、LSP、AST-grep）。                                             |
+| `truncate_all_tool_outputs`       | `false` | 截断所有工具输出，而不仅仅是白名单工具（Grep、Glob、LSP、AST-grep）。Tool output truncator 默认启用 - 使用 `disabled_hooks` 禁用。                    |
 | `aggressive_truncation`           | `false` | 超出 token 限制时，激进地截断工具输出以适应限制。比默认截断更激进。不够的话会回退到摘要/恢复。                                                     |
 | `auto_resume`                     | `false` | 从 thinking block 错误或 thinking disabled violation 成功恢复后，自动恢复会话。提取最后一条用户消息继续执行。                                     |
 | `dcp_for_compaction`              | `false` | 启用压缩用 DCP（动态上下文剪枝）- 在超出 token 限制时首先执行。在压缩前清理重复的工具调用和旧的工具输出。                                            |

package/dist/cli/config-manager.d.ts

@@ -12,7 +12,13 @@ export declare function isOpenCodeInstalled(): Promise<boolean>;
 export declare function getOpenCodeVersion(): Promise<string | null>;
 export declare function addAuthPlugins(config: InstallConfig): Promise<ConfigMergeResult>;
 export declare function setupChatGPTHotfix(): ConfigMergeResult;
+export interface BunInstallResult {
+    success: boolean;
+    timedOut?: boolean;
+    error?: string;
+}
 export declare function runBunInstall(): Promise<boolean>;
+export declare function runBunInstallWithDetails(): Promise<BunInstallResult>;
 export declare const ANTIGRAVITY_PROVIDER_CONFIG: {
     google: {
         name: string;

package/dist/cli/index.js

@@ -2657,7 +2657,7 @@ var require_napi = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "oh-my-opencode",
-    version: "2.8.0",
+    version: "2.8.2",
     description: "OpenCode plugin - custom agents (oracle, librarian) and enhanced features",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -2680,7 +2680,7 @@ var require_package = __commonJS((exports, module) => {
       "./schema.json": "./dist/oh-my-opencode.schema.json"
     },
     scripts: {
-      build: "bun build src/index.ts src/google-auth.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && bun run build:schema",
+      build: "bun build src/index.ts src/google-auth.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external @ast-grep/napi && bun run build:schema",
       "build:schema": "bun run script/build-schema.ts",
       clean: "rm -rf dist",
       prepublishOnly: "bun run clean && bun run build",
@@ -3335,7 +3335,7 @@ var Y2 = ({ indicator: t = "dots" } = {}) => {
 var import_picocolors2 = __toESM(require_picocolors(), 1);
 
 // src/cli/config-manager.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync, statSync } from "fs";
 import { homedir } from "os";
 import { join as join2 } from "path";
 // src/shared/command-executor.ts
@@ -4233,6 +4233,35 @@ var OPENCODE_PACKAGE_JSON = join2(OPENCODE_CONFIG_DIR, "package.json");
 var OMO_CONFIG = join2(OPENCODE_CONFIG_DIR, "oh-my-opencode.json");
 var OPENCODE_BINARIES = ["opencode", "opencode-desktop"];
 var CHATGPT_HOTFIX_REPO = "code-yeongyu/opencode-openai-codex-auth#fix/orphaned-function-call-output-with-tools";
+var BUN_INSTALL_TIMEOUT_SECONDS = 60;
+var BUN_INSTALL_TIMEOUT_MS = BUN_INSTALL_TIMEOUT_SECONDS * 1000;
+function isPermissionError(err) {
+  const nodeErr = err;
+  return nodeErr?.code === "EACCES" || nodeErr?.code === "EPERM";
+}
+function isFileNotFoundError(err) {
+  const nodeErr = err;
+  return nodeErr?.code === "ENOENT";
+}
+function formatErrorWithSuggestion(err, context) {
+  if (isPermissionError(err)) {
+    return `Permission denied: Cannot ${context}. Try running with elevated permissions or check file ownership.`;
+  }
+  if (isFileNotFoundError(err)) {
+    return `File not found while trying to ${context}. The file may have been deleted or moved.`;
+  }
+  if (err instanceof SyntaxError) {
+    return `JSON syntax error while trying to ${context}: ${err.message}. Check for missing commas, brackets, or invalid characters.`;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  if (message.includes("ENOSPC")) {
+    return `Disk full: Cannot ${context}. Free up disk space and try again.`;
+  }
+  if (message.includes("EROFS")) {
+    return `Read-only filesystem: Cannot ${context}. Check if the filesystem is mounted read-only.`;
+  }
+  return `Failed to ${context}: ${message}`;
+}
 async function fetchLatestVersion(packageName) {
   try {
     const res = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
@@ -4253,12 +4282,29 @@ function detectConfigFormat() {
   }
   return { format: "none", path: OPENCODE_JSON };
 }
-function parseConfig(path2, isJsonc) {
+function isEmptyOrWhitespace(content) {
+  return content.trim().length === 0;
+}
+function parseConfigWithError(path2) {
   try {
+    const stat = statSync(path2);
+    if (stat.size === 0) {
+      return { config: null, error: `Config file is empty: ${path2}. Delete it or add valid JSON content.` };
+    }
     const content = readFileSync2(path2, "utf-8");
-    return parseJsonc(content);
-  } catch {
-    return null;
+    if (isEmptyOrWhitespace(content)) {
+      return { config: null, error: `Config file contains only whitespace: ${path2}. Delete it or add valid JSON content.` };
+    }
+    const config = parseJsonc(content);
+    if (config === null || config === undefined) {
+      return { config: null, error: `Config file parsed to null/undefined: ${path2}. Ensure it contains valid JSON.` };
+    }
+    if (typeof config !== "object" || Array.isArray(config)) {
+      return { config: null, error: `Config file must contain a JSON object, not ${Array.isArray(config) ? "an array" : typeof config}: ${path2}` };
+    }
+    return { config };
+  } catch (err) {
+    return { config: null, error: formatErrorWithSuggestion(err, `parse config file ${path2}`) };
   }
 }
 function ensureConfigDir() {
@@ -4267,7 +4313,11 @@ function ensureConfigDir() {
   }
 }
 function addPluginToOpenCodeConfig() {
-  ensureConfigDir();
+  try {
+    ensureConfigDir();
+  } catch (err) {
+    return { success: false, configPath: OPENCODE_CONFIG_DIR, error: formatErrorWithSuggestion(err, "create config directory") };
+  }
   const { format: format2, path: path2 } = detectConfigFormat();
   const pluginName = "oh-my-opencode";
   try {
@@ -4277,10 +4327,11 @@ function addPluginToOpenCodeConfig() {
 `);
       return { success: true, configPath: path2 };
     }
-    const config = parseConfig(path2, format2 === "jsonc");
-    if (!config) {
-      return { success: false, configPath: path2, error: "Failed to parse config" };
+    const parseResult = parseConfigWithError(path2);
+    if (!parseResult.config) {
+      return { success: false, configPath: path2, error: parseResult.error ?? "Failed to parse config file" };
     }
+    const config = parseResult.config;
     const plugins = config.plugin ?? [];
     if (plugins.some((p2) => p2.startsWith(pluginName))) {
       return { success: true, configPath: path2 };
@@ -4309,7 +4360,7 @@ function addPluginToOpenCodeConfig() {
     }
     return { success: true, configPath: path2 };
   } catch (err) {
-    return { success: false, configPath: path2, error: String(err) };
+    return { success: false, configPath: path2, error: formatErrorWithSuggestion(err, "update opencode config") };
   }
 }
 function deepMerge(target, source) {
@@ -4366,23 +4417,47 @@ function generateOmoConfig(installConfig) {
   return config;
 }
 function writeOmoConfig(installConfig) {
-  ensureConfigDir();
+  try {
+    ensureConfigDir();
+  } catch (err) {
+    return { success: false, configPath: OPENCODE_CONFIG_DIR, error: formatErrorWithSuggestion(err, "create config directory") };
+  }
   try {
     const newConfig = generateOmoConfig(installConfig);
     if (existsSync2(OMO_CONFIG)) {
-      const content = readFileSync2(OMO_CONFIG, "utf-8");
-      const existing = parseJsonc(content);
-      delete existing.agents;
-      const merged = deepMerge(existing, newConfig);
-      writeFileSync(OMO_CONFIG, JSON.stringify(merged, null, 2) + `
+      try {
+        const stat = statSync(OMO_CONFIG);
+        const content = readFileSync2(OMO_CONFIG, "utf-8");
+        if (stat.size === 0 || isEmptyOrWhitespace(content)) {
+          writeFileSync(OMO_CONFIG, JSON.stringify(newConfig, null, 2) + `
+`);
+          return { success: true, configPath: OMO_CONFIG };
+        }
+        const existing = parseJsonc(content);
+        if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+          writeFileSync(OMO_CONFIG, JSON.stringify(newConfig, null, 2) + `
+`);
+          return { success: true, configPath: OMO_CONFIG };
+        }
+        delete existing.agents;
+        const merged = deepMerge(existing, newConfig);
+        writeFileSync(OMO_CONFIG, JSON.stringify(merged, null, 2) + `
+`);
+      } catch (parseErr) {
+        if (parseErr instanceof SyntaxError) {
+          writeFileSync(OMO_CONFIG, JSON.stringify(newConfig, null, 2) + `
 `);
+          return { success: true, configPath: OMO_CONFIG };
+        }
+        throw parseErr;
+      }
     } else {
       writeFileSync(OMO_CONFIG, JSON.stringify(newConfig, null, 2) + `
 `);
     }
     return { success: true, configPath: OMO_CONFIG };
   } catch (err) {
-    return { success: false, configPath: OMO_CONFIG, error: String(err) };
+    return { success: false, configPath: OMO_CONFIG, error: formatErrorWithSuggestion(err, "write oh-my-opencode config") };
   }
 }
 async function findOpenCodeBinaryWithVersion() {
@@ -4412,10 +4487,22 @@ async function getOpenCodeVersion() {
   return result?.version ?? null;
 }
 async function addAuthPlugins(config) {
-  ensureConfigDir();
+  try {
+    ensureConfigDir();
+  } catch (err) {
+    return { success: false, configPath: OPENCODE_CONFIG_DIR, error: formatErrorWithSuggestion(err, "create config directory") };
+  }
   const { format: format2, path: path2 } = detectConfigFormat();
   try {
-    const existingConfig = format2 !== "none" ? parseConfig(path2, format2 === "jsonc") : null;
+    let existingConfig = null;
+    if (format2 !== "none") {
+      const parseResult = parseConfigWithError(path2);
+      if (parseResult.error && !parseResult.config) {
+        existingConfig = {};
+      } else {
+        existingConfig = parseResult.config;
+      }
+    }
     const plugins = existingConfig?.plugin ?? [];
     if (config.hasGemini) {
       const version = await fetchLatestVersion("opencode-antigravity-auth");
@@ -4434,16 +4521,34 @@ async function addAuthPlugins(config) {
 `);
     return { success: true, configPath: path2 };
   } catch (err) {
-    return { success: false, configPath: path2, error: String(err) };
+    return { success: false, configPath: path2, error: formatErrorWithSuggestion(err, "add auth plugins to config") };
   }
 }
 function setupChatGPTHotfix() {
-  ensureConfigDir();
+  try {
+    ensureConfigDir();
+  } catch (err) {
+    return { success: false, configPath: OPENCODE_CONFIG_DIR, error: formatErrorWithSuggestion(err, "create config directory") };
+  }
   try {
     let packageJson = {};
     if (existsSync2(OPENCODE_PACKAGE_JSON)) {
-      const content = readFileSync2(OPENCODE_PACKAGE_JSON, "utf-8");
-      packageJson = JSON.parse(content);
+      try {
+        const stat = statSync(OPENCODE_PACKAGE_JSON);
+        const content = readFileSync2(OPENCODE_PACKAGE_JSON, "utf-8");
+        if (stat.size > 0 && !isEmptyOrWhitespace(content)) {
+          packageJson = JSON.parse(content);
+          if (typeof packageJson !== "object" || packageJson === null || Array.isArray(packageJson)) {
+            packageJson = {};
+          }
+        }
+      } catch (parseErr) {
+        if (parseErr instanceof SyntaxError) {
+          packageJson = {};
+        } else {
+          throw parseErr;
+        }
+      }
     }
     const deps = packageJson.dependencies ?? {};
     deps["opencode-openai-codex-auth"] = CHATGPT_HOTFIX_REPO;
@@ -4452,20 +4557,47 @@ function setupChatGPTHotfix() {
 `);
     return { success: true, configPath: OPENCODE_PACKAGE_JSON };
   } catch (err) {
-    return { success: false, configPath: OPENCODE_PACKAGE_JSON, error: String(err) };
+    return { success: false, configPath: OPENCODE_PACKAGE_JSON, error: formatErrorWithSuggestion(err, "setup ChatGPT hotfix in package.json") };
   }
 }
 async function runBunInstall() {
+  const result = await runBunInstallWithDetails();
+  return result.success;
+}
+async function runBunInstallWithDetails() {
   try {
     const proc = Bun.spawn(["bun", "install"], {
       cwd: OPENCODE_CONFIG_DIR,
       stdout: "pipe",
       stderr: "pipe"
     });
-    await proc.exited;
-    return proc.exitCode === 0;
-  } catch {
-    return false;
+    const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve("timeout"), BUN_INSTALL_TIMEOUT_MS));
+    const exitPromise = proc.exited.then(() => "completed");
+    const result = await Promise.race([exitPromise, timeoutPromise]);
+    if (result === "timeout") {
+      try {
+        proc.kill();
+      } catch {}
+      return {
+        success: false,
+        timedOut: true,
+        error: `bun install timed out after ${BUN_INSTALL_TIMEOUT_SECONDS} seconds. Try running manually: cd ~/.config/opencode && bun i`
+      };
+    }
+    if (proc.exitCode !== 0) {
+      const stderr = await new Response(proc.stderr).text();
+      return {
+        success: false,
+        error: stderr.trim() || `bun install failed with exit code ${proc.exitCode}`
+      };
+    }
+    return { success: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      success: false,
+      error: `bun install failed: ${message}. Is bun installed? Try: curl -fsSL https://bun.sh/install | bash`
+    };
   }
 }
 var ANTIGRAVITY_PROVIDER_CONFIG = {
@@ -4521,10 +4653,22 @@ var CODEX_PROVIDER_CONFIG = {
   }
 };
 function addProviderConfig(config) {
-  ensureConfigDir();
+  try {
+    ensureConfigDir();
+  } catch (err) {
+    return { success: false, configPath: OPENCODE_CONFIG_DIR, error: formatErrorWithSuggestion(err, "create config directory") };
+  }
   const { format: format2, path: path2 } = detectConfigFormat();
   try {
-    const existingConfig = format2 !== "none" ? parseConfig(path2, format2 === "jsonc") : null;
+    let existingConfig = null;
+    if (format2 !== "none") {
+      const parseResult = parseConfigWithError(path2);
+      if (parseResult.error && !parseResult.config) {
+        existingConfig = {};
+      } else {
+        existingConfig = parseResult.config;
+      }
+    }
     const newConfig = { ...existingConfig ?? {} };
     const providers = newConfig.provider ?? {};
     if (config.hasGemini) {
@@ -4540,7 +4684,7 @@ function addProviderConfig(config) {
 `);
     return { success: true, configPath: path2 };
   } catch (err) {
-    return { success: false, configPath: path2, error: String(err) };
+    return { success: false, configPath: path2, error: formatErrorWithSuggestion(err, "add provider config") };
   }
 }
 function detectCurrentConfig() {
@@ -4555,10 +4699,11 @@ function detectCurrentConfig() {
   if (format2 === "none") {
     return result;
   }
-  const openCodeConfig = parseConfig(path2, format2 === "jsonc");
-  if (!openCodeConfig) {
+  const parseResult = parseConfigWithError(path2);
+  if (!parseResult.config) {
     return result;
   }
+  const openCodeConfig = parseResult.config;
   const plugins = openCodeConfig.plugin ?? [];
   result.isInstalled = plugins.some((p2) => p2.startsWith("oh-my-opencode"));
   if (!result.isInstalled) {
@@ -4570,8 +4715,18 @@ function detectCurrentConfig() {
     return result;
   }
   try {
+    const stat = statSync(OMO_CONFIG);
+    if (stat.size === 0) {
+      return result;
+    }
     const content = readFileSync2(OMO_CONFIG, "utf-8");
+    if (isEmptyOrWhitespace(content)) {
+      return result;
+    }
     const omoConfig = parseJsonc(content);
+    if (!omoConfig || typeof omoConfig !== "object") {
+      return result;
+    }
     const agents = omoConfig.agents ?? {};
     if (agents["Sisyphus"]?.model === "opencode/big-pickle") {
       result.hasClaude = false;
@@ -19704,6 +19859,7 @@ var HookNameSchema = exports_external.enum([
   "session-notification",
   "comment-checker",
   "grep-output-truncator",
+  "tool-output-truncator",
   "directory-agents-injector",
   "directory-readme-injector",
   "empty-task-response-detector",
@@ -19802,7 +19958,6 @@ var DynamicContextPruningConfigSchema = exports_external.object({
 var ExperimentalConfigSchema = exports_external.object({
   aggressive_truncation: exports_external.boolean().optional(),
   auto_resume: exports_external.boolean().optional(),
-  tool_output_truncator: exports_external.boolean().optional(),
   preemptive_compaction: exports_external.boolean().optional(),
   preemptive_compaction_threshold: exports_external.number().min(0.5).max(0.95).optional(),
   truncate_all_tool_outputs: exports_external.boolean().optional(),

package/dist/config/schema.d.ts

@@ -37,6 +37,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "session-notification": "session-notification";
     "comment-checker": "comment-checker";
     "grep-output-truncator": "grep-output-truncator";
+    "tool-output-truncator": "tool-output-truncator";
     "directory-agents-injector": "directory-agents-injector";
     "directory-readme-injector": "directory-readme-injector";
     "empty-task-response-detector": "empty-task-response-detector";
@@ -670,7 +671,6 @@ export declare const DynamicContextPruningConfigSchema: z.ZodObject<{
 export declare const ExperimentalConfigSchema: z.ZodObject<{
     aggressive_truncation: z.ZodOptional<z.ZodBoolean>;
     auto_resume: z.ZodOptional<z.ZodBoolean>;
-    tool_output_truncator: z.ZodOptional<z.ZodBoolean>;
     preemptive_compaction: z.ZodOptional<z.ZodBoolean>;
     preemptive_compaction_threshold: z.ZodOptional<z.ZodNumber>;
     truncate_all_tool_outputs: z.ZodOptional<z.ZodBoolean>;
@@ -785,6 +785,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         "session-notification": "session-notification";
         "comment-checker": "comment-checker";
         "grep-output-truncator": "grep-output-truncator";
+        "tool-output-truncator": "tool-output-truncator";
         "directory-agents-injector": "directory-agents-injector";
         "directory-readme-injector": "directory-readme-injector";
         "empty-task-response-detector": "empty-task-response-detector";
@@ -1346,7 +1347,6 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
     experimental: z.ZodOptional<z.ZodObject<{
         aggressive_truncation: z.ZodOptional<z.ZodBoolean>;
         auto_resume: z.ZodOptional<z.ZodBoolean>;
-        tool_output_truncator: z.ZodOptional<z.ZodBoolean>;
         preemptive_compaction: z.ZodOptional<z.ZodBoolean>;
         preemptive_compaction_threshold: z.ZodOptional<z.ZodNumber>;
         truncate_all_tool_outputs: z.ZodOptional<z.ZodBoolean>;

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

@@ -1,6 +1,7 @@
 /**
  * Get the cache directory for oh-my-opencode binaries.
- * Follows XDG Base Directory Specification.
+ * On Windows: Uses %LOCALAPPDATA% or %APPDATA% (Windows conventions)
+ * On Unix: Follows XDG Base Directory Specification
  */
 export declare function getCacheDir(): string;
 /**

package/dist/hooks/ralph-loop/types.d.ts

@@ -10,4 +10,5 @@ export interface RalphLoopState {
 }
 export interface RalphLoopOptions {
     config?: RalphLoopConfig;
+    getTranscriptPath?: (sessionId: string) => string;
 }

package/dist/index.js

@@ -5659,6 +5659,11 @@ var PLATFORM_MAP = {
   "win32-x64": { os: "windows", arch: "amd64", ext: "zip" }
 };
 function getCacheDir() {
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
+    const base2 = localAppData || join11(homedir5(), "AppData", "Local");
+    return join11(base2, "oh-my-opencode", "bin");
+  }
   const xdgCache = process.env.XDG_CACHE_HOME;
   const base = xdgCache || join11(homedir5(), ".cache");
   return join11(base, "oh-my-opencode", "bin");
@@ -5783,6 +5788,15 @@ function getBinaryName2() {
 }
 function findCommentCheckerPathSync() {
   const binaryName = getBinaryName2();
+  const cachedPath = getCachedBinaryPath();
+  if (cachedPath) {
+    debugLog2("found binary in cache:", cachedPath);
+    return cachedPath;
+  }
+  if (!import.meta.url) {
+    debugLog2("import.meta.url is undefined, skipping package resolution");
+    return null;
+  }
   try {
     const require2 = createRequire2(import.meta.url);
     const cliPkgPath = require2.resolve("@code-yeongyu/comment-checker/package.json");
@@ -5792,13 +5806,8 @@ function findCommentCheckerPathSync() {
       debugLog2("found binary in main package:", binaryPath);
       return binaryPath;
     }
-  } catch {
-    debugLog2("main package not installed");
-  }
-  const cachedPath = getCachedBinaryPath();
-  if (cachedPath) {
-    debugLog2("found binary in cache:", cachedPath);
-    return cachedPath;
+  } catch (err) {
+    debugLog2("main package not installed or resolution failed:", err);
   }
   debugLog2("no binary found in known locations");
   return null;
@@ -11254,6 +11263,7 @@ function createRalphLoopHook(ctx, options) {
   const sessions = new Map;
   const config = options?.config;
   const stateDir = config?.state_dir;
+  const getTranscriptPath2 = options?.getTranscriptPath ?? getTranscriptPath;
   function getSessionState(sessionID) {
     let state2 = sessions.get(sessionID);
     if (!state2) {
@@ -11332,7 +11342,7 @@ function createRalphLoopHook(ctx, options) {
       if (state2.session_id && state2.session_id !== sessionID) {
         return;
       }
-      const transcriptPath = props?.transcriptPath;
+      const transcriptPath = getTranscriptPath2(sessionID);
       if (detectCompletionPromise(transcriptPath, state2.completion_promise)) {
         log(`[${HOOK_NAME3}] Completion detected!`, {
           sessionID,
@@ -31918,6 +31928,7 @@ var HookNameSchema = exports_external.enum([
   "session-notification",
   "comment-checker",
   "grep-output-truncator",
+  "tool-output-truncator",
   "directory-agents-injector",
   "directory-readme-injector",
   "empty-task-response-detector",
@@ -32016,7 +32027,6 @@ var DynamicContextPruningConfigSchema = exports_external.object({
 var ExperimentalConfigSchema = exports_external.object({
   aggressive_truncation: exports_external.boolean().optional(),
   auto_resume: exports_external.boolean().optional(),
-  tool_output_truncator: exports_external.boolean().optional(),
   preemptive_compaction: exports_external.boolean().optional(),
   preemptive_compaction_threshold: exports_external.number().min(0.5).max(0.95).optional(),
   truncate_all_tool_outputs: exports_external.boolean().optional(),
@@ -32300,7 +32310,7 @@ var OhMyOpenCodePlugin = async (ctx) => {
   const sessionRecovery = isHookEnabled("session-recovery") ? createSessionRecoveryHook(ctx, { experimental: pluginConfig.experimental }) : null;
   const sessionNotification = isHookEnabled("session-notification") ? createSessionNotification(ctx) : null;
   const commentChecker = isHookEnabled("comment-checker") ? createCommentCheckerHooks(pluginConfig.comment_checker) : null;
-  const toolOutputTruncator = pluginConfig.experimental?.tool_output_truncator === true ? createToolOutputTruncatorHook(ctx, { experimental: pluginConfig.experimental }) : null;
+  const toolOutputTruncator = isHookEnabled("tool-output-truncator") ? createToolOutputTruncatorHook(ctx, { experimental: pluginConfig.experimental }) : null;
   const directoryAgentsInjector = isHookEnabled("directory-agents-injector") ? createDirectoryAgentsInjectorHook(ctx) : null;
   const directoryReadmeInjector = isHookEnabled("directory-readme-injector") ? createDirectoryReadmeInjectorHook(ctx) : null;
   const emptyTaskResponseDetector = isHookEnabled("empty-task-response-detector") ? createEmptyTaskResponseDetectorHook(ctx) : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "2.8.1",
+  "version": "2.8.3",
   "description": "OpenCode plugin - custom agents (oracle, librarian) and enhanced features",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,7 +23,7 @@
     "./schema.json": "./dist/oh-my-opencode.schema.json"
   },
   "scripts": {
-    "build": "bun build src/index.ts src/google-auth.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && bun run build:schema",
+    "build": "bun build src/index.ts src/google-auth.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external @ast-grep/napi && bun run build:schema",
     "build:schema": "bun run script/build-schema.ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run clean && bun run build",