@takuma-hirai/hirai-method 0.1.0

package/.claude/hooks/loop-confirmation-detector.sh

@@ -0,0 +1,241 @@
+#!/usr/bin/env bash
+# loop-confirmation-detector.sh — Stop hook
+#
+# 役割:
+#   Loop モード稼働中、AI 最終 assistant message に「確認質問パターン」
+#   (例: 「進めてよいですか?」「OK ですか?」「お待ちします」) または
+#   「予防的自主ターン区切りパターン」(例: 「本 turn 完遂」「ターン区切り」
+#   「次 turn で <X> 着手」「次回 fresh prompt」「context budget 警戒」
+#   「ここで一旦」) が含まれていた場合、
+#   top-level `{"decision":"block","reason":"..."}` を出力して AI を停止させず
+#   次 turn に warn context を注入する。
+#   「Loop モード遵守事項 2 (中間確認の停止) / 遵守事項 9 (list.md 全 task 連続自律実行)
+#   違反 → 自律実行に切替えよ」と是正を促す。
+#   Normal モードでは no-op。
+#
+# 設計起源:
+#   docs/draft/loop-confirmation-detector-hook.md (frontmatter retroactive: true,
+#   approved_by: user, 2026-05-26)
+#   task-41 Step 2
+#   2026-05-27 拡張: 自主ターン区切り keyword 6 件追加 + warn_message に遵守事項 9 言及
+#     (user 直接指示「続行可能なのに勝手に止まらないようにハーネス側で修正」)
+#   2026-05-27 hot fix: Stop hook JSON output schema 違反修正
+#     (hookSpecificOutput.additionalContext → top-level decision/reason)
+#
+# 発火 timing:
+#   Stop hook (AI 最終 assistant message 完了時、PostToolUse の後段)
+#
+# 動作概要:
+#   1. mode-loader.sh で current mode 取得、Loop モード以外は早期 exit 0
+#   2. bypass env 判定 (ECC_LOOP_CONFIRMATION_OFF=1 / HC_LOOP_CONFIRMATION_DETECTION_ENABLED=false)
+#   3. stdin JSON から transcript_path を抽出 (jq 不在で fail-open)
+#   4. transcript 末尾から最後の assistant text を抽出
+#   5. 確認質問 regex + 自主ターン区切り regex
+#      (default 19 パターン or HC_LOOP_CONFIRMATION_PATTERNS で override)
+#      に対し grep -E で照合
+#   6. 検出時:
+#      - bypass.log に VIOLATION 記録
+#      - stdout に JSON `{"decision":"block","reason":"..."}` を出力
+#   7. 検出なしなら silent exit 0
+#
+# 環境変数:
+#   ECC_LOOP_CONFIRMATION_OFF=1                       ... 一時 OFF (1 セッション)
+#   HC_LOOP_CONFIRMATION_DETECTION_ENABLED=false      ... config レベル無効化
+#   HC_LOOP_CONFIRMATION_PATTERNS=<改行区切り>        ... regex 上書き
+#                                                       (空 / whitespace のみは無視し default に戻す)
+#
+# 失敗時の挙動:
+#   - exit 0 のみ (fail-open)。block しない (decision:block で AI を停止させず reason 注入)。
+#     Stop hook の `decision:"block"` は「停止させない (AI が続行)」意味、通常の
+#     PreToolUse block と意味反転している点に注意。
+#   - jq 不在 / transcript 不在 / parse 失敗 → silent skip。
+#
+# bash flags の方針 (重要、CLAUDE.md Critical Lessons HIGH 準拠):
+#   file-top に `set -euo pipefail` を **書かない**。
+#   caller の shell flags への leak と SIGPIPE → exit 141 サイレント死を防ぐ。
+#   strict mode が必要な箇所は subshell `( set -euo pipefail; ... )` で局所化する。
+
+set -uo pipefail  # errexit は外し、unset + pipefail のみ
+
+# stdin を必ず保持 (pipeline 詰まり防止)
+input=$(cat 2>/dev/null || true)
+
+# --- モード解決 ---
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/mode-loader.sh
+if [ -f "$SCRIPT_DIR/lib/mode-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/mode-loader.sh"
+  MODE=$(load_mode)
+else
+  MODE="normal"
+fi
+
+# Loop モード以外は no-op
+if [ "$MODE" != "loop" ]; then
+  exit 0
+fi
+
+# --- bypass-logger.sh (best-effort) ---
+# shellcheck source=lib/bypass-logger.sh
+if [ -f "$SCRIPT_DIR/lib/bypass-logger.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/bypass-logger.sh" 2>/dev/null || true
+fi
+
+# --- config-loader.sh (best-effort、HC_* env 解決) ---
+# shellcheck source=lib/config-loader.sh
+if [ -f "$SCRIPT_DIR/lib/config-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+fi
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled loop_mode_enforcement; then
+  exit 0
+fi
+
+# --- bypass 判定 ---
+# ECC_LOOP_CONFIRMATION_OFF=1 — 1 セッション一時 OFF
+if [ "${ECC_LOOP_CONFIRMATION_OFF:-0}" = "1" ]; then
+  if command -v log_bypass >/dev/null 2>&1; then
+    log_bypass "loop-confirmation-detector" "ECC_LOOP_CONFIRMATION_OFF" "${ECC_BYPASS_REASON:-(not provided)}"
+  fi
+  exit 0
+fi
+
+# HC_LOOP_CONFIRMATION_DETECTION_ENABLED=false — config レベル無効化
+if [ "${HC_LOOP_CONFIRMATION_DETECTION_ENABLED:-true}" = "false" ]; then
+  if command -v log_bypass >/dev/null 2>&1; then
+    log_bypass "loop-confirmation-detector" "HC_LOOP_CONFIRMATION_DETECTION_ENABLED" "config-disabled"
+  fi
+  exit 0
+fi
+
+# --- 依存チェック (jq 不在で fail-open) ---
+if ! command -v jq >/dev/null 2>&1; then
+  exit 0
+fi
+
+# --- transcript_path 抽出 ---
+transcript_path=$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
+
+if [ -z "$transcript_path" ] || [ ! -f "$transcript_path" ]; then
+  exit 0
+fi
+
+# システム機密 path への traversal を拒否 (security-M1 + sec-H2 拡張)
+# writable system path (/dev/*) も追加して traversal を構造的に防止
+case "$transcript_path" in
+  /etc/*|/usr/*|/bin/*|/sbin/*|/sys/*|/proc/*|/var/log/*|/dev/*)
+    exit 0 ;;
+esac
+
+# --- 直前 assistant text 抽出 (末尾 50 行) ---
+# why-x5-violation-detect.sh と同じ抽出戦略 (transcript 形式変動への耐性確保)
+last_assistant=$(tail -n 50 "$transcript_path" 2>/dev/null | jq -rs '
+  [
+    .[]
+    | select(
+        ((.type // "") == "assistant")
+        or ((.role // "") == "assistant")
+        or (((.message // {}).role // "") == "assistant")
+      )
+    | (
+        ((.message // .).content)
+        | if type == "array" then
+            [ .[] | (.text // "") ] | join("\n")
+          elif type == "string" then .
+          else "" end
+      )
+  ]
+  | last // ""
+' 2>/dev/null)
+
+if [ -z "$last_assistant" ]; then
+  exit 0
+fi
+
+# --- 検出 regex (default 19 パターン、env override 可) ---
+# 改行区切り。Bash 連想配列等は使わず、while read で 1 行ずつ照合する。
+# Pattern 1 (進めて...): 「進めて」「進めてよ」「進めても」「進めてもよ」
+#   「進めてもよろ」「進めてよろ」「進めてもよろし」全パターンを cover (tdd-H2 fix)
+# Pattern 7 (お待ちし...): BSD grep で empty alternation (て|) 不可、(て)? に修正 (tdd-H1 fix)
+# Pattern 2 (OK...): \s は POSIX 非 portable、[[:space:]] に修正 (architect-M2 fix)
+# Pattern 14-19 (2026-05-27 拡張): 予防的自主ターン区切りパターン
+#   遵守事項 9 (list.md 全 task 連続自律実行) 違反検出のため追加
+DEFAULT_PATTERNS='進めて((も)?よろ|よ|も)?(し)?い(い)?(ですか|でしょうか)
+OK[[:space:]]?(ですか|でしょうか)
+どちら(に|を)?します?か?
+どうします?か?
+実行(し|して)も(よろし|よ)い?(ですか|でしょうか)
+次の指示をお待ちします
+お待ちし(て)?(い|お)?ます
+user 判断待ち
+user 確認待ち
+進めますか
+続行しますか
+停止しますか
+よろしいですか
+本[[:space:]]?turn[[:space:]]?完遂
+ターン区切り
+次[[:space:]]?turn[[:space:]]+で.*着手
+次回[[:space:]]+fresh[[:space:]]+prompt
+context[[:space:]]+budget[[:space:]]+警戒
+ここで一旦'
+
+# PATTERNS env override は空 / whitespace のみなら default に戻す (sec-H1 fix)
+PATTERNS="${HC_LOOP_CONFIRMATION_PATTERNS:-}"
+if ! printf '%s' "$PATTERNS" | grep -qE '[^[:space:]]'; then
+  PATTERNS="$DEFAULT_PATTERNS"
+fi
+
+matched=""
+while IFS= read -r pat; do
+  [ -z "$pat" ] && continue
+  if printf '%s' "$last_assistant" | grep -Eq "$pat" 2>/dev/null; then
+    matched="$pat"
+    break
+  fi
+done <<< "$PATTERNS"
+
+if [ -z "$matched" ]; then
+  # 違反なし → silent exit 0
+  exit 0
+fi
+
+# matched 制御文字 + regex metachar escape (security-M2 fix + sec-M4 拡張)
+# 改行 / CR / null + single quote / backslash / dollar / backtick を除去 — warn_message 埋め込み前
+matched_safe=$(printf '%s' "$matched" | tr -d '\n\r\0\\`$' | tr -d "'")
+
+# --- 検出: bypass.log 記録 + reason 注入 ---
+# env_var label を VIOLATION に変更し filter で bypass と区別可能化 (security-M3 fix)
+if command -v log_bypass >/dev/null 2>&1; then
+  log_bypass "loop-confirmation-detector" "VIOLATION" "pattern=${matched_safe}"
+fi
+
+# reason を jq で安全に JSON エンコード (改行 / 引用符 / 特殊文字を escape)
+# 2026-05-27 拡張: 遵守事項 9 (list.md 全 task 連続自律実行) 言及追加、
+# context tier 警告 (60/80/95) 未発火下での予防的自主ターン区切り禁止を明示
+warn_message=$(cat <<EOF
+[loop-confirmation-detector] Loop モード違反検出: パターン '${matched_safe}' を検出。 Loop モード遵守事項 2 (中間確認の停止) / 遵守事項 9 (list.md 全 task 連続自律実行) 違反の可能性。 context tier 警告 (60/80/95) 未発火下での予防的自主ターン区切りは禁止。 context tier 80 到達まで自律実行を継続し、tier 80 以上で自動 /save-state してください。 詳細: \`.claude/rules/modes.md\` 遵守事項 2 + 遵守事項 9 + \`.claude/commands/resume-state.md\` Phase 6 step 6/7。
+EOF
+)
+
+# JSON 出力 (top-level decision:"block" + reason)
+# Stop hook の decision:"block" は「AI を停止させず reason を次 turn に注入」の意味。
+# 通常の PreToolUse block (実行阻止) とは semantics が反転している。
+# jq でエンコードし control 文字等を安全に embed する。
+if printf '%s' "$warn_message" | jq -Rsc '{
+  decision: "block",
+  reason: .
+}' 2>/dev/null; then
+  :
+else
+  # jq fail 時は top-level JSON fallback (fail-open)
+  cat <<'FALLBACK'
+{"decision":"block","reason":"[loop-confirmation-detector] Loop モード違反検出: 確認質問 / 予防的自主ターン区切りパターンを検出。Loop モード遵守事項 2 (中間確認の停止) / 遵守事項 9 (list.md 全 task 連続自律実行) 違反の可能性。次 turn で確認質問せず自律実行に切替えてください。詳細: .claude/rules/modes.md 遵守事項 2 + 遵守事項 9。"}
+FALLBACK
+fi
+
+exit 0

package/.claude/hooks/mode-asana-prompt.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# mode-asana-prompt.sh — SessionStart hook
+#
+# 役割:
+#   .claude/mode.yml の asana_enabled が未設定 (unset) の場合、user に 1 度だけ
+#   「Asana 連携を利用しますか?」を <system-reminder> でヒアリングする。
+#   true/false が既に設定されていれば no-op。
+#
+# 仕組み:
+#   1. mode-loader.sh の load_asana_enabled で現値を取得
+#   2. "true" / "false" なら何もせず exit 0
+#   3. "unset" なら system-reminder を注入し user に /mode asana on|off を提案
+#
+# 失敗時の挙動: exit 0 のみ。セッション起動をブロックしない。
+
+set -u
+
+# stdin を消費 (SessionStart 入力 JSON があれば破棄)
+cat > /dev/null 2>&1 || true
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# mode-loader 読み込み
+if [ -f "$SCRIPT_DIR/lib/mode-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/mode-loader.sh"
+  ASANA=$(load_asana_enabled)
+else
+  ASANA="unset"
+fi
+
+# 設定済みなら何もしない
+if [ "$ASANA" != "unset" ]; then
+  exit 0
+fi
+
+cat <<'EOF'
+<system-reminder>
+**HIRAI メソッド: Asana 連携モード 未決定**
+
+このプロジェクトの `.claude/mode.yml` で `asana_enabled` が未設定です。
+Asana 連携 (Asana タスク文脈取得 / `docs/work.md` 自動生成 / Slack スレ取込) を利用するかを user に決定してもらう必要があります。
+
+このセッションの最初の応答で、ユーザに **以下を必ず 1 度だけ提案** してください:
+
+> 「このプロジェクトで Asana 連携を利用しますか?
+>   - **利用する**: `/mode asana on` を実行 → 以降 `/work-init` 等の Asana 関連機能が有効化
+>   - **利用しない**: `/mode asana off` を実行 → Asana 関連機能は OFF、それ以外の HIRAI メソッド機能はすべて利用可能
+>   - 後で決める: `.claude/mode.yml` を直接編集してください」
+
+ユーザの応答に従い `/mode asana <on|off>` を実行してください。
+ユーザが「後で」と回答した場合、本セッションでは Asana 関連機能 (W6) は呼び出さないこと。
+
+切替方法:
+- `/mode asana on` / `/mode asana off` slash command
+- `.claude/mode.yml` の `asana_enabled:` 行を直接編集 (`true` / `false`)
+- 一時切替: `HC_ASANA_ENABLED=true` または `=false` 環境変数
+</system-reminder>
+EOF
+
+exit 0

package/.claude/hooks/mode-enforce.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# mode-enforce.sh — SessionStart wrapper child (session-start-wrapper.sh DEFAULT_HOOKS)
+#
+# 役割: Loop モード稼働中、session 開始時に「停止指示まで AI 推奨で続行」ルールを
+#       1 行 pointer の <system-reminder> として再宣言する。Normal モードでは no-op。
+#       full 遵守事項は frontmatter-less 常時参照 rule (.claude/rules/modes.md) に委譲。
+#       task-73 案 B: 4 項目箇条書きを 1 行 pointer へ短縮。
+#
+# 失敗時の挙動: exit 0 のみ。失敗してもユーザターンをブロックしない。
+#
+# 共有 feature toggle group:
+#   - グループ制御 toggle: `feature_loop_mode_enforcement_enabled` (default: true)
+#   - OFF にすると本 hook を含む同 group の全 hook が no-op
+#   - 編集: `bash .claude/scripts/hc-config.sh --feature loop_mode_enforcement=false`
+#   - 同 group の他 hook: loop-confirmation-detector.sh, loop-auto-progress-reminder.sh
+
+set -uo pipefail  # task-22 W1: errexit 外し SIGPIPE 141 サイレント死を防止 (CLAUDE.md Critical Lessons HIGH)
+
+# stdin を消費（pipeline block を避ける）
+cat > /dev/null 2>&1 || true
+
+# モードローダーを読み込み
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/mode-loader.sh
+if [ -f "$SCRIPT_DIR/lib/mode-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/mode-loader.sh"
+  MODE=$(load_mode)
+else
+  MODE="normal"
+fi
+
+if [ "$MODE" != "loop" ]; then
+  # Normal モード: 何もしない
+  exit 0
+fi
+
+# --- config-loader.sh (best-effort、HC_* env 解決 + is_feature_enabled) ---
+# shellcheck source=lib/config-loader.sh
+if [ -f "$SCRIPT_DIR/lib/config-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+fi
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled loop_mode_enforcement; then
+  exit 0
+fi
+
+# task-73 案 B: 1 行 pointer (full 遵守事項は modes.md in-context)
+cat <<'EOF'
+<system-reminder>
+Loop mode 稼働中: AI推奨を即採用 / 確認質問禁止 / 論理単位で commit / 停止=「stop」|完了|致命的error。詳細 .claude/rules/modes.md
+</system-reminder>
+EOF
+
+exit 0

package/.claude/hooks/mode-session-start.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+# mode-session-start.sh — SessionStart hook
+#
+# 役割 (task-73 案 B で短文化):
+#   - セッション開始時に harness の compact status 1 行を出力 (mode / preset / guards / resume / next)
+#   - resume 検出時は 1 行で /resume-state 案内
+#   - Loop / Normal モードの詳細は in-context rule (.claude/rules/modes.md) に委譲し、
+#     mode-enforce.sh の 1 行 pointer で再宣言する (full reminder の二重出力を廃止)
+#
+# behavior-preserving: mode 判定 / context.md 検出 / feature gate / Normal モード挙動は保持、
+#   出力テキストのみ短縮。
+#
+# 失敗時の挙動: exit 0 のみ。失敗してもセッションをブロックしない (全 status 取得は best-effort)。
+
+set -uo pipefail  # task-22 W1: errexit 外し SIGPIPE 141 サイレント死を防止 (CLAUDE.md Critical Lessons HIGH)
+
+# stdin は SessionStart hook では使わないが、念のため消費
+cat > /dev/null 2>&1 || true
+
+# モードローダーを読み込み
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/mode-loader.sh
+if [ -f "$SCRIPT_DIR/lib/mode-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/mode-loader.sh"
+  MODE=$(load_mode)
+else
+  MODE="normal"
+fi
+
+# --- config-loader.sh (best-effort、HC_* env 解決 + is_feature_enabled) ---
+# shellcheck source=lib/config-loader.sh
+if [ -f "$SCRIPT_DIR/lib/config-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+fi
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled mode_session_start; then
+  exit 0
+fi
+
+# project root 解決 (status 取得用、best-effort)
+ROOT="${HC_PROJECT_ROOT:-}"
+if [ -z "$ROOT" ]; then
+  ROOT="$(cd "$SCRIPT_DIR/../.." 2>/dev/null && pwd || true)"
+fi
+
+# --- compact status 各項目 (best-effort、取得失敗は省略して fail-open) ---
+HC_SCRIPT="$SCRIPT_DIR/../scripts/hc-config.sh"
+PRESET=""
+GUARDS=""
+if [ -f "$HC_SCRIPT" ]; then
+  SUMMARY="$(bash "$HC_SCRIPT" --summary 2>/dev/null || true)"
+  # 失敗時: hc-config --summary 取得不可なら guards=/preset= フィールドを省略 (fail-open)
+  PRESET="$(printf '%s\n' "$SUMMARY" | awk '/^preset:/{print $2; exit}')"
+  GUARDS="$(printf '%s\n' "$SUMMARY" | awk '/^totals:/{print $2"on/"$4"off"; exit}')"
+fi
+
+SESSION_CONTEXT_FILE="${ROOT:-.}/.serena/memories/session/context.md"
+if [ -f "$SESSION_CONTEXT_FILE" ]; then
+  RESUME="available"
+else
+  RESUME="none"
+fi
+
+NEXT=""
+LIST_MD="${ROOT:-.}/docs/tasks/list.md"
+if [ -f "$LIST_MD" ]; then
+  NEXT="$(grep -cE '^\|[[:space:]]*[0-9]+[[:space:]]*\|.*(🔲|🔄)' "$LIST_MD" 2>/dev/null || true)"
+fi
+
+# compact status 1 行を組み立て (取得できた項目のみ)
+STATUS="harness: mode=${MODE}"
+[ -n "$PRESET" ] && STATUS="$STATUS preset=${PRESET}"
+[ -n "$GUARDS" ] && STATUS="$STATUS guards=${GUARDS}"
+STATUS="$STATUS resume=${RESUME}"
+[ -n "$NEXT" ] && STATUS="$STATUS next=${NEXT}"
+STATUS="$STATUS help=/resume-state /hc-config /mode"
+
+{
+  printf '<system-reminder>\n'
+  printf '%s\n' "$STATUS"
+  if [ "$RESUME" = "available" ]; then
+    printf '前回 session state あり: /resume-state [loop] で継続、または新規 prompt で開始\n'
+  fi
+  if [ "$MODE" != "loop" ]; then
+    printf 'Normal モード稼働中。長い実装は /mode loop で Loop モードへ切替可 (詳細 .claude/rules/modes.md)。\n'
+  fi
+  printf '</system-reminder>\n'
+}
+
+exit 0

package/.claude/hooks/next-actions-surface.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# .claude/hooks/next-actions-surface.sh
+# SessionStart hook — docs/tasks/next-actions.md の未処理副産物 entry を強制 surface
+#
+# 役割:
+#   セッション開始時に未処理 entry を <system-reminder> で stderr に出力し、
+#   メインが見落とすことを構造的に防ぐ。
+#
+# 設計:
+#   - 不在なら exit 0 silent (fail-open、新規 repo を block しない)
+#   - 未処理 entry 0 件なら silent (noise 削減)
+#   - 🔴 entry がある時のみ注入 (Wave 1.5、🟡 / 🟢 のみは silent)
+#     起源: docs/draft/system-reminder-attention-fix.md W1.5
+#     env override で旧挙動に戻せる: HC_NEXT_ACTIONS_SURFACE_RED_ONLY=false
+#   - 🔴 entry のタイトルを最大 5 件まで stderr に列挙
+#   - 必ず exit 0 (SessionStart は block しない設計)
+#
+# Bypass:
+#   ECC_NEXT_ACTIONS_SURFACE_OFF=1   # silent skip + bypass.log 記録
+#
+# 重要制約:
+#   - set -e 禁止 (mode-loader.sh の CB-verify 教訓 - 5846925)
+#   - source 系は set -uo pipefail のみ
+#
+# 共有 feature toggle group:
+#   - グループ制御 toggle: `feature_byproduct_discharge_enabled` (default: true)
+#   - OFF にすると本 hook を含む同 group の全 hook が no-op
+#   - 編集: `bash .claude/scripts/hc-config.sh --feature byproduct_discharge=false`
+#   - 同 group の他 hook: byproduct-discharge-guard.sh
+
+set -uo pipefail   # set -e は使わない (mode-loader.sh 教訓)
+
+# project root 解決 (dual-mode portability: HC_PROJECT_ROOT > git > pwd)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/project-root.sh
+source "$SCRIPT_DIR/lib/project-root.sh"
+# 後方互換: CLAUDE_PROJECT_DIR が明示設定されている場合はそれを優先
+_project_dir="${CLAUDE_PROJECT_DIR:-$(resolve_project_root)}"
+
+# config-loader.sh source (is_feature_enabled 関数取得用、task-45 Phase 2)
+if [ -f "${_project_dir}/.claude/hooks/lib/config-loader.sh" ]; then
+  # shellcheck source=lib/config-loader.sh
+  source "${_project_dir}/.claude/hooks/lib/config-loader.sh" 2>/dev/null || true
+fi
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled byproduct_discharge; then
+  exit 0   # feature OFF で no-op
+fi
+
+# stdin を消費 (SessionStart hook は使わないが、消費しないと caller 側で残ることがある)
+cat > /dev/null 2>&1 || true
+
+# === Bypass ===
+if [ "${ECC_NEXT_ACTIONS_SURFACE_OFF:-0}" = "1" ] || [ "${ECC_NEXT_ACTIONS_SURFACE_OFF:-}" = "true" ]; then
+  # bypass-logger 読み込み
+  if [ -f "${_project_dir}/.claude/hooks/lib/bypass-logger.sh" ]; then
+    # shellcheck source=lib/bypass-logger.sh
+    source "${_project_dir}/.claude/hooks/lib/bypass-logger.sh"
+    log_bypass "next-actions-surface" "ECC_NEXT_ACTIONS_SURFACE_OFF" "${ECC_BYPASS_REASON:-(not provided)}"
+  fi
+  exit 0
+fi
+
+# === parser library 読み込み ===
+_parser_lib="${_project_dir}/.claude/hooks/lib/next-actions-parser.sh"
+if [ ! -f "$_parser_lib" ]; then
+  # parser 不在: fail-open
+  exit 0
+fi
+# shellcheck source=lib/next-actions-parser.sh
+source "$_parser_lib"
+
+# === next-actions.md 解析 ===
+_md_file="${_project_dir}/docs/tasks/next-actions.md"
+
+# parser 関数呼び出し (file 不在 / table 不在は silent skip)
+parse_next_actions "$_md_file"
+_parse_rc=$?
+
+if [ "$_parse_rc" != "0" ]; then
+  # file 不在 or table 不在 → silent exit 0
+  exit 0
+fi
+
+# === 未処理 0 件なら silent ===
+if [ "${NA_RED_COUNT:-0}" = "0" ] && [ "${NA_YELLOW_COUNT:-0}" = "0" ] && [ "${NA_GREEN_COUNT:-0}" = "0" ]; then
+  exit 0
+fi
+
+# === Wave 1.5 frequency filter: 🔴 entry がある時のみ注入 ===
+# 🟡 / 🟢 のみは attention dilution 削減のため completely silent (env で revert 可)
+# 起源: docs/draft/system-reminder-attention-fix.md W1.5
+# env override:
+#   HC_NEXT_ACTIONS_SURFACE_RED_ONLY=false  ... 旧挙動 (🟡 / 🟢 でも発火) に戻す
+if [ "${HC_NEXT_ACTIONS_SURFACE_RED_ONLY:-true}" != "false" ]; then
+  if [ "${NA_RED_COUNT:-0}" = "0" ]; then
+    exit 0
+  fi
+fi
+
+# === <system-reminder> 構築 ===
+# 🔴 タイトル列を「, 」区切りで join (最大 5 件、parser 側で truncate 済)
+_red_titles_joined=""
+if [ -n "${NA_RED_TITLES:-}" ]; then
+  # 改行→「, 」変換
+  _red_titles_joined=$(printf '%s' "$NA_RED_TITLES" | awk 'BEGIN{first=1} {if(first){printf "%s",$0;first=0}else{printf ", %s",$0}}')
+fi
+
+# 推奨処理メッセージ (🔴 件数で内容を切替)
+if [ "${NA_RED_COUNT:-0}" -gt 0 ]; then
+  _action_msg="推奨処理: \`/new-draft <slug>\` で draft 起こし → user 承認 → \`/new-task\` で list.md 移行"
+else
+  _action_msg="推奨処理: 緊急度 🟡 / 🟢 は近日 / 任意対応。詳細は docs/tasks/next-actions.md を確認"
+fi
+
+# 🔴 タイトル行 (存在する場合のみ)
+_red_line=""
+if [ -n "$_red_titles_joined" ]; then
+  _red_line="優先対応 (🔴): ${_red_titles_joined}"$'\n'
+fi
+
+# stderr に出力 (SessionStart の <system-reminder> 規約に沿う)
+{
+  printf '<system-reminder>\n'
+  printf '[next-actions-surface] 未処理副産物 entry: 🔴 %s 件 / 🟡 %s 件 / 🟢 %s 件\n' \
+    "${NA_RED_COUNT}" "${NA_YELLOW_COUNT}" "${NA_GREEN_COUNT}"
+  if [ -n "$_red_line" ]; then
+    printf '%s' "$_red_line"
+  fi
+  printf '%s\n' "$_action_msg"
+  printf '詳細: docs/tasks/next-actions.md\n'
+  printf '</system-reminder>\n'
+} >&2
+
+exit 0

package/.claude/hooks/notification-dispatcher.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# notification-dispatcher.sh — task-71 Step 4-6 dispatcher (thin wrapper)
+# 実行 script (sourced lib ではない) → set -uo pipefail は OK (errexit 外す)。
+# event 名は固定 literal で run_dispatch に渡す。matcher は $1 (matcher 無し event は空)。
+set -uo pipefail
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/dispatcher-core.sh
+source "$DIR/lib/dispatcher-core.sh"
+run_dispatch "Notification" "${1:-}"

package/.claude/hooks/notify.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Notification: 操作待ち通知 (macOS)
+#
+# Config keys consumed (.claude/harness-config.yml):
+#   notify_sound               # afplay 対象 (macOS のみ。非 macOS / 不在ファイルなら静音)
+set -u
+
+# config 読み込み (HC_NOTIFY_SOUND)
+# shellcheck source=lib/config-loader.sh
+source "$(dirname "$0")/lib/config-loader.sh"
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled notify; then
+  exit 0   # feature OFF で no-op
+fi
+
+input=$(cat)
+
+# task-22 W2: jq 不在環境では fail-open (msg = default、通知音のみ鳴らす)
+if command -v jq >/dev/null 2>&1; then
+  msg=$(echo "$input" | jq -r '.message // "承認/入力が必要です"')
+else
+  msg="承認/入力が必要です"
+fi
+project=$(basename "$(pwd)")
+afplay "$HC_NOTIFY_SOUND" >/dev/null 2>&1 &
+osascript -e "display notification \"$msg\" with title \"Claude Code: $project\" subtitle \"操作が必要です\"" >/dev/null 2>&1