tmux-devloop-matrix

条件マトリクスをpaneごとに並列実行し、結果を比較・分析する。

概要

<command> --matrix <conditions> → pane生成 → 並列実行 → 完了待ち → 結果比較テーブル

前提チェック

if [ -z "$TMUX" ]; then
  echo "Error: tmuxセッション内で実行してください"
  exit 1
fi

手順

1. 引数解析

# 使用例:
#   tmux-devloop-matrix "npm test" --matrix node=18,20,22
#   tmux-devloop-matrix "pytest" --matrix python=3.10,3.11,3.12 --matrix db=sqlite,postgres

COMMAND_ARGS=()
MATRIX_KEYS=()
MATRIX_VALUES=()

while [ $# -gt 0 ]; do
  case "$1" in
    --matrix)
      shift
      if [ -z "$1" ] || [ "${1#--}" != "$1" ]; then
        echo "Error: --matrix には key=val1,val2 形式の値が必要です"
        exit 1
      fi
      KEY=$(echo "$1" | cut -d= -f1)
      VALUES=$(echo "$1" | cut -d= -f2)
      if [ -z "$KEY" ] || [ -z "$VALUES" ]; then
        echo "Error: --matrix の形式が不正です: $1 (期待: key=val1,val2)"
        exit 1
      fi
      MATRIX_KEYS+=("$KEY")
      MATRIX_VALUES+=("$VALUES")
      shift
      ;;
    *)
      COMMAND_ARGS+=("$1")
      shift
      ;;
  esac
done

if [ ${#COMMAND_ARGS[@]} -eq 0 ]; then
  echo "Error: 実行コマンドを指定してください"
  exit 1
fi
if [ ${#MATRIX_KEYS[@]} -eq 0 ]; then
  echo "Error: --matrix で条件を1つ以上指定してください"
  exit 1
fi

2. マトリクスの展開

# 条件の組み合わせを生成
# 単一キーの場合: 値の数だけpane
# 複数キーの場合: 直積（最大12組み合わせに制限）
generate_combinations() {
  # キーと値をJSON配列としてstdin経由で安全に渡す
  python3 -c "
import itertools, json, re, sys

data = json.load(sys.stdin)
keys = data['keys']
values = [v.split(',') for v in data['values']]

combos = list(itertools.product(*values))
if len(combos) > 12:
    print('ERROR:TOO_MANY', file=sys.stderr)
    sys.exit(1)

for combo in combos:
    env_pairs = ' '.join(f'{k}={v}' for k, v in zip(keys, combo))
    # ラベルは安全な文字のみ（パストラバーサル防止）
    label = '_'.join(f'{k}-{v}' for k, v in zip(keys, combo))
    label = re.sub(r'[^A-Za-z0-9._-]', '_', label)
    print(f'{label}|{env_pairs}')
" <<< "$(python3 -c "
import json
keys = $(printf '%s\n' "${MATRIX_KEYS[@]}" | python3 -c "import sys,json; print(json.dumps([l.strip() for l in sys.stdin]))")
values = $(printf '%s\n' "${MATRIX_VALUES[@]}" | python3 -c "import sys,json; print(json.dumps([l.strip() for l in sys.stdin]))")
print(json.dumps({'keys': keys, 'values': values}))
")"
}

COMBINATIONS=$(generate_combinations)
if [ $? -ne 0 ]; then
  echo "Error: 組み合わせが12を超えています。条件を絞ってください。"
  exit 1
fi

COMBO_COUNT=$(echo "$COMBINATIONS" | wc -l | tr -d ' ')

3. tmux pane構成

WINDOW_NAME="matrix-$(date +%H%M%S)"
RESULTS_DIR=$(mktemp -d)
tmux new-window -n "${WINDOW_NAME}" -c "${PWD}"

# pane分割
INDEX=0
echo "$COMBINATIONS" | while IFS='|' read LABEL ENV_PAIRS; do
  if [ $INDEX -gt 0 ]; then
    if [ $((INDEX % 2)) -eq 1 ]; then
      tmux split-window -h -c "${PWD}" -t "${WINDOW_NAME}"
    else
      tmux split-window -v -c "${PWD}" -t "${WINDOW_NAME}"
    fi
  fi
  INDEX=$((INDEX + 1))
done

tmux select-layout -t "${WINDOW_NAME}" tiled

4. 各paneでコマンド実行

INDEX=0
echo "$COMBINATIONS" | while IFS='|' read LABEL ENV_PAIRS; do
  # ラベルを安全文字に正規化（パストラバーサル防止）
  SAFE_LABEL=$(echo "$LABEL" | tr -c 'A-Za-z0-9._-' '_')
  RESULT_FILE="${RESULTS_DIR}/${SAFE_LABEL}.result"

  # ENV_PAIRSをIFS分割し個別エスケープ
  # ENV_PAIRSを配列に変換して個別エスケープ
  ESCAPED_ENV=""
  IFS=' ' read -ra PAIRS <<< "$ENV_PAIRS"
  for PAIR in "${PAIRS[@]}"; do
    [ -z "$PAIR" ] && continue
    ESCAPED_ENV="${ESCAPED_ENV} $(printf '%q' "$PAIR")"
  done
  ESCAPED_CMD=""
  for ARG in "${COMMAND_ARGS[@]}"; do
    ESCAPED_CMD="${ESCAPED_CMD} $(printf '%q' "$ARG")"
  done
  ESCAPED_RESULT=$(printf '%q' "${RESULT_FILE}")
  tmux send-keys -t "${WINDOW_NAME}.${INDEX}" \
    "echo '=== ${SAFE_LABEL} ===' && env${ESCAPED_ENV}${ESCAPED_CMD}; echo \$? > ${ESCAPED_RESULT}" Enter

  INDEX=$((INDEX + 1))
done

echo "=== Matrix 実行開始 ==="
echo "Window: ${WINDOW_NAME}"
echo "Command: ${COMMAND_ARGS[*]}"
echo "Combinations: ${COMBO_COUNT}"
echo "Results dir: ${RESULTS_DIR}"

5. 結果収集と比較

全pane完了後にClaudeが実行する。

echo "=== Matrix 結果 ==="
echo ""
printf "%-30s %-10s\n" "CONDITION" "EXIT_CODE"
printf "%-30s %-10s\n" "------------------------------" "----------"

echo "$COMBINATIONS" | while IFS='|' read LABEL ENV_PAIRS; do
  SAFE_LABEL=$(echo "$LABEL" | tr -c 'A-Za-z0-9._-' '_')
  RESULT_FILE="${RESULTS_DIR}/${SAFE_LABEL}.result"
  if [ -f "$RESULT_FILE" ]; then
    EXIT_CODE=$(cat "$RESULT_FILE")
    if [ "$EXIT_CODE" = "0" ]; then
      STATUS="OK"
    else
      STATUS="FAIL(${EXIT_CODE})"
    fi
  else
    STATUS="PENDING"
  fi
  printf "%-30s %-10s\n" "$LABEL" "$STATUS"
done

# 各paneのログを取得
echo ""
echo "=== 詳細ログ ==="
INDEX=0
echo "$COMBINATIONS" | while IFS='|' read LABEL ENV_PAIRS; do
  echo "--- ${LABEL} ---"
  tmux capture-pane -t "${WINDOW_NAME}.${INDEX}" -p -S -20
  INDEX=$((INDEX + 1))
done

Claudeによる分析

結果収集後、Claudeが以下を提供する:

• 成功/失敗の比較テーブル
• 失敗した条件の原因分析
• ボトルネック推定（実行時間の差分があれば）
• 条件間の差分要約

エラーハンドリング

• tmux非実行時: エラーメッセージを出力して終了
• 組み合わせ過多: 12を超える場合は条件の絞り込みを要求
• pane作成失敗: 作成済みpaneをクリーンアップ
• 結果ファイル不在: PENDINGとして表示