@takuma-hirai/hirai-method 0.1.0

package/.claude/hooks/lib/next-actions-parser.sh

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+# .claude/hooks/lib/next-actions-parser.sh
+# Shared parser for docs/tasks/next-actions.md — extracts unprocessed entry counts
+# by urgency (🔴 / 🟡 / 🟢) from the markdown table.
+#
+# 役割:
+#   next-actions-surface.sh と byproduct-discharge-guard.sh の両方で使う
+#   table 行 parse を共通化する。
+#
+# 設計:
+#   - set -e は使わない (mode-loader.sh の CB-verify 教訓 - 5846925)
+#   - awk で構造化 parse (grep の脆い regex chain を避ける)
+#   - 未処理判定: 「処理結果」列 (= 7 列目, table の末尾 `|` を除く) が `—` (em dash)
+#   - 列分割: `|` 区切り、各 cell の前後 whitespace trim
+#   - 「## エントリ一覧」セクションのみ scope (履歴セクションは除外)
+#
+# 公開関数:
+#   parse_next_actions <next_actions_md_path>
+#     副作用: グローバル変数を設定する
+#       NA_RED_COUNT      — 🔴 未処理 entry 数
+#       NA_YELLOW_COUNT   — 🟡 未処理 entry 数
+#       NA_GREEN_COUNT    — 🟢 未処理 entry 数
+#       NA_RED_TITLES     — 🔴 未処理 entry のタイトル (改行区切り、最大 5 件)
+#     返り値:
+#       0 = parse 成功 (file 存在 / table 検出 OK)
+#       1 = file 不在
+#       2 = table セクション不在 (counts は全 0)
+
+set -uo pipefail   # set -e 禁止 (mode-loader.sh 教訓)
+
+# parse_next_actions <file>
+parse_next_actions() {
+  local md_file="${1:-}"
+
+  # reset globals
+  NA_RED_COUNT=0
+  NA_YELLOW_COUNT=0
+  NA_GREEN_COUNT=0
+  NA_RED_TITLES=""
+
+  if [ -z "$md_file" ] || [ ! -f "$md_file" ]; then
+    return 1
+  fi
+
+  # awk: 「## エントリ一覧」〜「## 」(次の見出し) の間で
+  #   - `| <num> | <date> | <title> | <source> | <urgency> | <action> | <result> |`
+  #     形式の行を検出
+  #   - 1 列目が数字、最終列 (処理結果) が「—」のものを未処理として集計
+  #   - urgency に絵文字 🔴 🟡 🟢 を含むかで分類
+  #
+  # AWK 出力 (3 行):
+  #   RED=<n>
+  #   YELLOW=<n>
+  #   GREEN=<n>
+  # 続けて RED タイトルを最大 5 件、`RED_TITLE=<title>` 形式で出力
+  local awk_output
+  awk_output=$(awk '
+    BEGIN {
+      in_section = 0
+      red = 0
+      yellow = 0
+      green = 0
+      red_titles_count = 0
+    }
+    # セクション境界判定: 「## エントリ一覧」で開始、次の `## ` 見出しで終了
+    /^## エントリ一覧[[:space:]]*$/ {
+      in_section = 1
+      next
+    }
+    /^## / {
+      if (in_section == 1) {
+        in_section = 0
+      }
+      next
+    }
+    in_section == 1 && /^\|/ {
+      # split by `|`
+      n = split($0, cells, "|")
+      # cells[1] は先頭 `|` の前 (空文字)
+      # 期待: | <num> | <date> | <title> | <source> | <urgency> | <action> | <result> |
+      #       → n = 9 (両端の空 cell 込み)、index 2..8 が実 cell
+      if (n < 8) next
+
+      # trim helper (前後 whitespace 除去)
+      for (i = 1; i <= n; i++) {
+        gsub(/^[[:space:]]+|[[:space:]]+$/, "", cells[i])
+      }
+
+      num     = cells[2]
+      title   = cells[4]
+      urgency = cells[6]
+      result  = cells[8]
+
+      # ヘッダ行 / 区切り行を除外: num が数字でない or `---:` 等
+      if (num !~ /^[0-9]+$/) next
+
+      # 未処理判定: 処理結果が `—` (em dash U+2014)
+      if (result != "—") next
+
+      if (index(urgency, "🔴") > 0) {
+        red++
+        if (red_titles_count < 5) {
+          print "RED_TITLE=" title
+          red_titles_count++
+        }
+      } else if (index(urgency, "🟡") > 0) {
+        yellow++
+      } else if (index(urgency, "🟢") > 0) {
+        green++
+      }
+    }
+    END {
+      print "RED=" red
+      print "YELLOW=" yellow
+      print "GREEN=" green
+    }
+  ' "$md_file" 2>/dev/null)
+
+  if [ -z "$awk_output" ]; then
+    return 2
+  fi
+
+  # parse awk output into shell vars
+  local line
+  while IFS= read -r line; do
+    case "$line" in
+      RED=*)
+        NA_RED_COUNT="${line#RED=}"
+        ;;
+      YELLOW=*)
+        NA_YELLOW_COUNT="${line#YELLOW=}"
+        ;;
+      GREEN=*)
+        NA_GREEN_COUNT="${line#GREEN=}"
+        ;;
+      RED_TITLE=*)
+        local t="${line#RED_TITLE=}"
+        if [ -z "$NA_RED_TITLES" ]; then
+          NA_RED_TITLES="$t"
+        else
+          NA_RED_TITLES="${NA_RED_TITLES}"$'\n'"$t"
+        fi
+        ;;
+    esac
+  done <<< "$awk_output"
+
+  # 全て数字でないと壊れるので safety
+  case "$NA_RED_COUNT" in ''|*[!0-9]*) NA_RED_COUNT=0 ;; esac
+  case "$NA_YELLOW_COUNT" in ''|*[!0-9]*) NA_YELLOW_COUNT=0 ;; esac
+  case "$NA_GREEN_COUNT" in ''|*[!0-9]*) NA_GREEN_COUNT=0 ;; esac
+
+  return 0
+}

package/.claude/hooks/lib/project-root.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# project-root.sh — Unified project root resolver
+#
+# 役割: hook script が project root を確実に取得するための helper。
+#       hook の物理位置 (project-level / user-level) に関わらず
+#       同じ logic で project root を resolve できる。
+#
+# 使用例:
+#   SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+#   # shellcheck source=lib/project-root.sh
+#   source "$SCRIPT_DIR/lib/project-root.sh"
+#   PROJECT_ROOT=$(resolve_project_root)
+#
+# 優先順位:
+#   1. ${HC_PROJECT_ROOT}              ... env override (CI / test 用)
+#   2. git rev-parse --show-toplevel   ... 標準的な project root 解決
+#   3. ${CLAUDE_PROJECT_DIR}           ... Claude Code hook 標準注入 (git 管理外でも有効)
+#   4. pwd                             ... fallback (上記全て不在時)
+#
+# bash flags の方針 (重要):
+#   本ファイルを source する caller の shell options を汚染しないため、
+#   ファイルトップでは `set -euo pipefail` を **使用しない**。
+#   関数本体は subshell `( ... )` で囲み、その内側だけで strict mode を有効化する。
+#   過去に context-budget.sh で `set -e` が source 経由で漏れ、後段の pipeline
+#   が SIGPIPE で 141 終了し本体ロジックが実行されない事故があった
+#   (feedback_set_e_in_sourced_libs 規範)。
+
+resolve_project_root() (
+  set -uo pipefail
+
+  # 1. env override (HIRAI 固有、CI / test 用)
+  if [ -n "${HC_PROJECT_ROOT:-}" ]; then
+    printf '%s' "$HC_PROJECT_ROOT"
+    return 0
+  fi
+
+  # 2. git rev-parse (標準的な project root 解決)
+  if command -v git >/dev/null 2>&1; then
+    local root
+    root=$(git rev-parse --show-toplevel 2>/dev/null)
+    if [ -n "$root" ] && [ -d "$root" ]; then
+      printf '%s' "$root"
+      return 0
+    fi
+  fi
+
+  # 3. CLAUDE_PROJECT_DIR (Claude Code hook 標準注入、git 管理外 / submodule 内でも有効)
+  if [ -n "${CLAUDE_PROJECT_DIR:-}" ] && [ -d "${CLAUDE_PROJECT_DIR}" ]; then
+    printf '%s' "$CLAUDE_PROJECT_DIR"
+    return 0
+  fi
+
+  # 4. pwd fallback (git 不在 / git 管理外 / CLAUDE_PROJECT_DIR 不在)
+  pwd
+)
+
+# スクリプトとして直接呼ばれた場合 (manual smoke check 用)
+if [ "${BASH_SOURCE[0]}" = "${0}" ]; then
+  resolve_project_root
+fi

package/.claude/hooks/list-md-plan-first-reminder.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+# list-md-plan-first-reminder.sh — SessionStart hook (task #35)
+#
+# 役割:
+#   `docs/draft/*.md` ≥ 3 件 ∧ `docs/tasks/list.md` task エントリ行 == 0 を検出した時、
+#   `<system-reminder>` で「list.md plan-first」keyword を含む warning を stderr に出力する。
+#   batch planning 経路 B (task-management.md §plan-first) 不在事案を AI に強制注意し、
+#   AI の判断ミス回避を hook 経由で構造的に補完する。
+#
+# 失敗時の挙動: 常に exit 0 (fail-open — セッションをブロックしない)。
+#
+# 検出ロジック:
+#   - task エントリ行: `grep -cE '^\| [0-9]' <list.md>`
+#   - draft 件数:      `find <draft_dir> -maxdepth 1 -name "*.md" -not -name "_*" | wc -l`
+#   - 条件:            task_count == 0 && draft_count >= 3
+#
+# fail-open guard:
+#   - `docs/tasks/list.md` 不在環境 (新規採用 project / /init-tasks 未実行) → 何もせず exit 0
+#   - `docs/draft/` 不在 → 同上
+#
+# 環境変数 (env override > YAML > defaults):
+#   HC_LIST_PLAN_FIRST_REMINDER_ENABLED=false  ... reminder 全停止 (bypass)
+#   HC_TASK_DIR                                  ... default docs/tasks
+#   HC_DRAFT_DIR                                 ... default docs/draft
+#   CLAUDE_PROJECT_DIR                           ... Claude Code 注入の project root
+#
+# YAML 設定 (harness-config.yml):
+#   list_plan_first_reminder_enabled: false      ... reminder 全停止 (env と同等動作)
+#   config-loader.sh 経由で env として export される。
+#   env override が優先 (env > YAML > defaults)。
+#
+# Stdin:  SessionStart hook JSON (使わない、念のため消費)
+# Stdout: 未使用
+# Stderr: 条件成立時に <system-reminder> ブロックを出力
+# Exit:   常に 0 (fail-open)
+#
+# 制約:
+#   file-top に `set -euo pipefail` を書かない (CLAUDE.md Critical Lesson HIGH
+#   feedback_set_e_in_sourced_libs 規範遵守)。実装本体は subshell 関数化で局所化する。
+#
+# 起源:
+#   - task #33 (list-md-plan-first-normative) 採用 6 条 supersede による分割で task #35 へ
+#   - 設計起源: docs/draft/list-md-plan-first-normative.md §3 P3
+#   - 規範:     .claude/rules/task-management.md §plan-first 経路 B
+#
+# 共有 feature toggle group:
+#   - グループ制御 toggle: `feature_task_rule_guard_enabled` (default: true)
+#   - OFF にすると本 hook を含む同 group の全 hook が no-op
+#   - 編集: `bash .claude/scripts/hc-config.sh --feature task_rule_guard=false`
+#   - 同 group の他 hook: task-rule-guard.sh
+#   - Step 5 refactor: harness-optimizer M-1 finding (YAML→hook 受渡し欠如) を解消
+#     context-budget.sh L59-62 パターンを踏襲し、config-loader.sh source で
+#     harness-config.yml の list_plan_first_reminder_enabled: false が hook に届くようにする。
+
+set -u
+
+# stdin 消費 (SessionStart hook JSON は使わない)
+cat >/dev/null 2>&1 || true
+
+# --- config 読み込み ---
+# harness-config.yml の list_plan_first_reminder_enabled を HC_LIST_PLAN_FIRST_REMINDER_ENABLED
+# として export する。env override が優先される (config-loader.sh 仕様)。
+# source 失敗時は || true で fail-open (caller への set flags leak を防止)。
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 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 task_rule_guard; then
+    exit 0
+fi
+
+_lpfr_main() (
+    set -uo pipefail
+
+    # bypass check (env override 経由 or YAML 経由、config-loader.sh で統一済)
+    if [ "${HC_LIST_PLAN_FIRST_REMINDER_ENABLED:-true}" = "false" ]; then
+        exit 0
+    fi
+
+    # project root 解決
+    # 優先順: CLAUDE_PROJECT_DIR > git toplevel > pwd
+    local repo_root
+    if [ -n "${CLAUDE_PROJECT_DIR:-}" ] && [ -d "$CLAUDE_PROJECT_DIR" ]; then
+        repo_root="$CLAUDE_PROJECT_DIR"
+    elif repo_root=$(git rev-parse --show-toplevel 2>/dev/null); then
+        :
+    else
+        repo_root="$(pwd)"
+    fi
+
+    local task_dir="${HC_TASK_DIR:-docs/tasks}"
+    local draft_dir_rel="${HC_DRAFT_DIR:-docs/draft}"
+    local list_md="${repo_root}/${task_dir}/list.md"
+    local draft_dir="${repo_root}/${draft_dir_rel}"
+
+    # fail-open guard: 必須 path 不在で誤発火しない
+    [ -f "$list_md" ] || exit 0
+    [ -d "$draft_dir" ] || exit 0
+
+    # task エントリ行カウント (`^| <number>` パターン)
+    local task_count
+    task_count=$(grep -cE '^\| [0-9]' "$list_md" 2>/dev/null || true)
+    # grep -c 失敗時 (file 空 / 全行非 match) → 空文字 or 0 になる、空時は 0 に正規化
+    task_count="${task_count:-0}"
+    # 数値以外を弾く (defensive)
+    case "$task_count" in
+      ''|*[!0-9]*) task_count=0 ;;
+    esac
+
+    # 0 件以外なら何もしない
+    [ "$task_count" -eq 0 ] || exit 0
+
+    # draft 件数 (`_*` template 除外、深さ 1 のみ)
+    local draft_count
+    draft_count=$(find "$draft_dir" -maxdepth 1 -type f -name "*.md" -not -name "_*" 2>/dev/null | wc -l | tr -d ' ')
+    draft_count="${draft_count:-0}"
+    case "$draft_count" in
+      ''|*[!0-9]*) draft_count=0 ;;
+    esac
+
+    # 3 件未満なら不発火 (N=2 が境界、N=3 から発火)
+    [ "$draft_count" -ge 3 ] || exit 0
+
+    # 条件成立 → stderr に <system-reminder> 出力
+    cat >&2 <<EOF
+
+<system-reminder>
+[list.md plan-first] batch planning 経路 B 不在を検出しました:
+- \`${draft_dir_rel}/*.md\` が ${draft_count} 件存在し、かつ \`${task_dir}/list.md\` に task エントリ行 (📝/🔲/🔄/✅) が 0 件です。
+- master roadmap で N ≥ 3 task を一括計画する場合、\`.claude/rules/task-management.md\` §plan-first 経路 B に従い list.md に N 行 **📝 設計（未承認）** で先置きしてください (main 直接 Edit、task-rule-guard.sh 既存 exempt 通過)。
+- 規範: \`.claude/rules/task-management.md\` §「plan-first 行先置きフロー (batch planning) — 2 経路分岐」
+- bypass: \`HC_LIST_PLAN_FIRST_REMINDER_ENABLED=false\` または harness-config.yml \`list_plan_first_reminder_enabled: false\`
+</system-reminder>
+EOF
+    exit 0
+)
+
+_lpfr_main "$@"
+exit 0

package/.claude/hooks/loop-auto-progress-reminder.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+# loop-auto-progress-reminder.sh — SubagentStop + Stop hook
+#
+# 役割:
+#   Loop モード稼働中、subagent 完了直後 (SubagentStop) と ターン終了時 (Stop)
+#   に発火し、「subagent 完了通知後の自動次タスク起動 を default 動作とする」を
+#   <system-reminder> で再注入する。
+#   Normal モードでは no-op。
+#
+# 設計の根本変更 (task-21 W0.1, 2026-05-23):
+#   旧: UserPromptSubmit (= user 次入力時) で「待ち中報告」キーワード検出 → fail-late
+#   新: SubagentStop (subagent 完了直後) + Stop (ターン終了時) → fail-early
+#       - SubagentStop: subagent 完了直後にメインへ「即次タスク継続」hint
+#       - Stop: ターン終了時の最終検出 (メインが受動待ちで停止しようとした際)
+#
+# 簡略実装 (初期版):
+#   event 受信時、Loop モードなら常に `<system-reminder>` を出力する。
+#   過去 N ターン transcript の「待ち中キーワード grep」は将来精度向上の余地。
+#   fail-early 設計を優先し、誤注入 (Loop モード稼働中の全 SubagentStop / Stop)
+#   は under-warn より許容可能と判断。
+#
+# 環境変数:
+#   HC_LOOP_AUTO_PROGRESS_ENABLED=false   ... 無効化 (Normal モードと等価)
+#
+# 失敗時の挙動:
+#   - exit 0 のみ。失敗してもメインターンをブロックしない (fail-open)。
+#
+# 設計起源:
+#   docs/draft/system-reminder-attention-fix.md §2 W0.1
+#   docs/tasks/task-21-system-reminder-attention-fix.md W0.1
+#
+# 共有 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, mode-enforce.sh
+
+set -u
+
+# stdin を必ず消費して保持
+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
+
+# --- 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
+
+# --- 早期 bypass ---
+if [ "${HC_LOOP_AUTO_PROGRESS_ENABLED:-true}" = "false" ]; then
+  exit 0
+fi
+
+# --- event 種別判定 (SubagentStop / Stop) ---
+# stdin JSON の hook_event_name を抽出 (jq 不在時は "unknown")
+EVENT_NAME="unknown"
+if command -v jq >/dev/null 2>&1; then
+  EVENT_NAME=$(printf '%s' "$input" | jq -r '.hook_event_name // "unknown"' 2>/dev/null || echo "unknown")
+fi
+
+# --- system-reminder 注入 ---
+cat <<EOF
+<system-reminder>
+**Loop モード自律進行 — ${EVENT_NAME} event 検出 (loop-auto-progress-reminder)**
+
+Loop モード稼働中、以下を default 動作として遵守すること
+(\`.claude/rules/modes.md\` 遵守事項 7、設計起源 \`docs/draft/system-reminder-attention-fix.md\` W0.1):
+
+**メインへの指示**:
+
+1. **subagent 完了通知後の次タスク自動起動は default 動作**。user 指示を待たない。
+2. subagent 完了を待つ間、以下のいずれかを **必ず並行進行** すること:
+   - 別の独立 task (\`docs/tasks/list.md\` の \`🔲 未着手\` 行) を着手
+   - メイン専任作業 (タスク管理 / list.md sync / draft 起こし / next-actions 整理)
+   - 規範文書化 (\`.claude/rules/\` / CLAUDE.md 編集)
+   - memory 整理 / 進捗 commit
+3. 並行作業が物理的に無い場合 (依存関係 / 全 task 着手済) のみ、その旨を明示報告
+   して停止可。「完了通知を待つだけ」「次セッションで対応」では停止しない。
+
+**bypass**:
+- \`HC_LOOP_AUTO_PROGRESS_ENABLED=false\` でセッション全体 OFF
+- Loop モード自体の解除: \`/mode normal\`
+</system-reminder>
+EOF
+
+exit 0