Repository navigation
[Epic] Hook System — Pre/Post Tool Execution Interceptors #38
Description
概要
ツール実行の前後にシェルスクリプトを挿入できるHookシステムを実装する。
背景
OpenCodeには報告前ファクトチェック強制、CI未通過マージブロック、レビューコメント読み込み強制等のガードレールがない。全てLLMの自律判断に依存し品質保証が不安定。
Claude Codeは47+hookをPreToolUse/PostToolUse/SessionStartイベントに登録し、exit code 2でツール実行をブロック、stderrでコンテキスト注入を実現している。
受入基準
- PreToolUse: ツール実行前にスクリプト実行、出力をコンテキスト注入
- PostToolUse: ツール実行後にスクリプト実行
- SessionStart: セッション開始時にスクリプト実行
- exit code 2でツール実行ブロック+フィードバック注入
- opencode.jsonでhookをmatcher付き登録可能
- hookタイムアウト設定
実装方針
tool/tool.ts のツール実行パスにインターセプター追加。permission/evaluate.ts 前後にhook実行を挟む。
Activity
feat(hook): add shell script hook system for tool lifecycle events
terisuke commentedon Apr 5, 2026
受入基準全項目確認済み。
受入基準照合
PreToolUse: ツール実行前にスクリプト実行、出力をコンテキスト注入
→
packages/opencode/src/session/prompt.ts:470PreToolUse hooks実行、stderr→message注入→ E2E確認:
/tmp/hook-fire-log.txtにPreToolUse fired: tool=read記録PostToolUse: ツール実行後にスクリプト実行
→
packages/opencode/src/session/prompt.ts:507PostToolUse hooks実行SessionStart: セッション開始時にスクリプト実行
→
packages/opencode/src/session/prompt.tsSessionStart hooks実行exit code 2でツール実行ブロック+フィードバック注入
→
packages/opencode/src/hook/execute.ts:30exit 2→block判定→ テスト:
test/hook/execute.test.ts21 passopencode.jsonでhookをmatcher付き登録可能
→
packages/opencode/src/config/config.tshooks field追加→
packages/opencode/src/hook/schema.tsHookConfig + matcher fieldhookタイムアウト設定
→
packages/opencode/src/hook/execute.ts:25AbortSignal.timeout(timeout)テスト: 35 pass, E2Eデプロイ検証: opencode run でhook発火確認済み
PR: #74 (実装), #76 (CRITICAL/HIGH fix)
follow-up: #73 (code-reviewer MEDIUM)