# Issue実行（メインコマンド）
# デフォルトでpi終了後に自動クリーンアップ
scripts/run.sh <issue-number> [options]

Options:
  -w, --workflow <name>  ワークフロー名（省略時: workflows セクションがあれば auto、なければ default）
  --list-workflows       利用可能なワークフロー一覧を表示
  --no-attach            バックグラウンドで起動
  --no-cleanup           自動クリーンアップを無効化
  --reattach             既存セッションにアタッチ
  --force                強制再作成
  -b, --branch <name>    カスタムブランチ名
  --base <branch>        ベースブランチ
  --agent-args <args>    エージェントに渡す追加の引数
  --pi-args <args>       --agent-args のエイリアス（後方互換性）
  --ignore-blockers      依存関係チェックをスキップして強制実行
  --show-config          現在の設定を表示（デバッグ用）
  --list-agents          利用可能なエージェントプリセット一覧を表示
  --show-agent-config    エージェント設定を表示（デバッグ用）

# バッチ実行（依存関係順）
scripts/run-batch.sh <issue>... [options]
scripts/run-batch.sh 42 43 44 --dry-run     # 実行計画のみ表示
scripts/run-batch.sh 42 43 44 --sequential  # 順次実行

# タスク提案
scripts/next.sh                          # 次に実行すべきIssueを提案
scripts/next.sh -n 3                     # 次の3件を提案
scripts/next.sh -l feature               # featureラベル付きから提案
scripts/next.sh --json                   # JSON形式で出力
scripts/next.sh -v                       # 詳細な判断理由を表示

# セッション管理
scripts/list.sh                          # セッション一覧
scripts/mux-all.sh -w                    # 全セッションをタイル表示
scripts/dashboard.sh                     # プロジェクトダッシュボード
scripts/dashboard.sh --compact           # サマリーのみ表示
scripts/dashboard.sh --json              # JSON出力
scripts/dashboard.sh --watch             # 自動更新（5秒ごと）
scripts/attach.sh <session>              # セッションにアタッチ
scripts/status.sh <session>              # 状態確認
scripts/stop.sh <session>                # セッション停止
scripts/sweep.sh                         # 全セッションのマーカーチェック・cleanup
scripts/sweep.sh --dry-run               # 対象セッション表示のみ
scripts/sweep.sh --force                 # PRマージ確認をスキップ
scripts/sweep.sh --check-errors          # ERRORマーカーもチェック
scripts/cleanup.sh <session>             # 手動クリーンアップ
scripts/force-complete.sh <session>      # セッション強制完了
scripts/force-complete.sh 42 --error     # エラーとして完了

# メッセージ送信
scripts/nudge.sh <issue-number>          # セッションに続行を促すメッセージを送信
scripts/nudge.sh 42 --message "続けてください"

# ワークフロー選択
# .pi-runner.yaml に workflows セクションがある場合、-w 省略時は auto（AI自動選択）
scripts/run.sh 42                         # workflows あり → auto / なし → default
scripts/run.sh 42 -w frontend            # 明示的にフロントエンド用ワークフローを指定
scripts/run.sh 42 -w auto                # AIがIssue内容から自動選択（明示指定）
scripts/run.sh 42 --workflow ci-fix       # CI修正ワークフロー

# 継続的改善
scripts/improve.sh                    # レビュー→Issue作成→実行→待機のループ
scripts/improve.sh --dry-run          # レビューのみ（Issue作成しない）
scripts/improve.sh --review-only      # 問題表示のみ
scripts/improve.sh --max-iterations 2 # 最大2回繰り返す
scripts/improve.sh --auto-continue    # 自動継続（承認スキップ）
scripts/wait-for-sessions.sh 42 43    # 複数セッション完了待機

# 推奨: --no-attach でバックグラウンド起動
scripts/run.sh 42 --no-attach
# → 即座に制御が返る
# → 完了時に自動で通知が届く

# 進捗確認が必要な場合
scripts/status.sh 42
scripts/list.sh

# 自動クリーンアップを無効化
scripts/run.sh 42 --no-cleanup

# セッションにメッセージを送信（続行を促す）
scripts/nudge.sh <issue-number> [options]
scripts/nudge.sh 42 --message "続けてください"

scripts/run.sh --list-workflows