mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-04-23 04:26:54 +08:00

fix(hooks): avoid Claude Code v2.1.116 argv-dup bug in settings.local.json (#1524 )

* fix: resolve Claude Code Bash hook "cannot execute binary file" on Windows

Root cause in ~/.claude/settings.local.json (user-global):
1. UTF-8 BOM + CRLF line endings left by patch_settings_cl_v2_simple.ps1
2. Double-wrapped command "\"bash.exe\" \"wrapper.sh\"" broke Windows
   argument splitting on the space in "Program Files", making bash.exe
   try to execute itself as a script.

Fix:
- Rewrite settings.local.json as UTF-8 (no BOM), LF, with the hook command
  pointing directly at observe-wrapper.sh and passing "pre"/"post" as a
  positional arg so HOOK_PHASE is populated correctly in observe.sh.

Docs:
- docs/fixes/HOOK-FIX-20260421.md — full root-cause analysis.
- docs/fixes/apply-hook-fix.sh — idempotent applier script.

* docs: addendum for HOOK-FIX-20260421 (v2.1.116 argv duplication detail)

- Documents Claude Code v2.1.116 argv duplication bug as the underlying
  cause of the bash.exe:bash.exe:cannot execute binary file error
- Records night-session fix variant using explicit `bash <path>` prefix
  (matches hooks.json observer pattern, avoids EFTYPE on Node spawn)
- Keeps morning commit 527c18b intact; both variants are now documented

---------

Co-authored-by: suusuu0927 <sugi.go.go.gm@gmail.com>

2026-04-21 18:35:33 -04:00

4.0 KiB

Raw Blame History

HOOK-FIX-20260421 Addendum — v2.1.116 argv 重複バグ

朝セッションで commit 527c18b として修正済み。夜セッションで追加検証と、朝fix でカバーしきれない Claude Code 固有のバグを特定したので補遺を記録する。

朝fixの形式

"command": "C:/Users/sugig/.claude/skills/continuous-learning/hooks/observe-wrapper.sh pre"

.sh ファイルを直接 command にする形式。Git Bash が shebang 経由で実行する前提。

夜追加検証で判明したこと

Node.js の child_process.spawn で .sh ファイルを直接実行すると Windows では EFTYPE で失敗する：

spawn('C:/Users/sugig/.claude/skills/continuous-learning/hooks/observe-wrapper.sh', 
      ['post'], {stdio:['pipe','pipe','pipe']});
// → Error: spawn EFTYPE (errno -4028)

shell:true を付ければ cmd.exe 経由で実行できるが、Claude Code 側の実装依存のリスクが残る。

夜適用した追加 fix

第1トークンを bash（PATH 解決）に変えた明示的な呼び出しに更新：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "bash \"C:/Users/sugig/.claude/skills/continuous-learning/hooks/observe-wrapper.sh\" pre"
      }]
    }],
    "PostToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "bash \"C:/Users/sugig/.claude/skills/continuous-learning/hooks/observe-wrapper.sh\" post"
      }]
    }]
  }
}

この形式は ~/.claude/hooks/hooks.json 内の ECC 正規 observer 登録と同じパターンで、現実にエラーなく動作している実績あり。

Node spawn 検証

spawn('bash "C:/Users/sugig/.claude/skills/continuous-learning/hooks/observe-wrapper.sh" post',
      [], {shell:true});
// exit=0 → observations.jsonl に正常追記

Claude Code v2.1.116 の argv 重複バグ（詳細）

朝fix docの「Defect 2」として bash.exe: bash.exe: cannot execute binary file を記録しているが、その根本メカニズムが特定できたので記す。

再現

"C:\Program Files\Git\bin\bash.exe" "C:\Program Files\Git\bin\bash.exe"
# stderr: "C:\Program Files\Git\bin\bash.exe: C:\Program Files\Git\bin\bash.exe: cannot execute binary file"
# exit: 126

bash は argv[1] を script とみなし読み込もうとする。argv[1] が bash.exe 自身なら ELF/PE バイナリ検出で失敗 → exit 126。エラー文言は完全一致。

Claude Code 側の挙動

hook command が "C:\Program Files\Git\bin\bash.exe" "C:\Users\...\wrapper.sh" のとき、v2.1.116 は第1トークン（= bash.exe フルパス）を argv[0] と argv[1] の両方に渡すと推定される。結果 bash は argv[1] = bash.exe を script として読み込もうとして 126 で落ちる。

回避策

第1トークンを bash.exe のフルパス＋スペース付きパスにしないこと：

✅ bash （PATH 解決の単一トークン）— 夜fix / hooks.json パターン
✅ .sh 直接パス（Claude Code の .sh ハンドリングに依存）— 朝fix
❌ "C:\Program Files\Git\bin\bash.exe" "<path>" — 1トークン目が quoted で空白込み

結論

朝fix（直接 .sh 指定）と夜fix（明示的 bash prefix）のどちらも argv 重複バグを踏まないが、夜fixの方が Claude Code の実装依存が少ないため推奨。

ただし朝fix commit 527c18b は既に docs/fixes/ に入っているため、この Addendum を追記することで両論併記とする。次回 CLI 再起動時に夜fix の方が実運用に残る。

4.0 KiB Raw Blame History Unescape Escape