rerunplan

rerunplan

チェックに失敗しました。再実行しますか、それとも修正しますか？rerunplan は、失敗したチェックの名前、エラーシグネチャ、同じチェックの過去の実行結果という証拠から失敗を分類し、分類結果、推奨事項、判断の根拠となった証拠の行を提示します。

• infra_flake → 再実行 — エラーシグネチャが既知のインフラストラクチャパターン（タイムアウト、接続リセット、DNS、レート制限、ランナーの消失、ゲートウェイエラー）と一致し、毎回そのように失敗しているわけではありません
• flaky → 再実行 — チェックは以前に成功しており、かつ同じエラーシグネチャで失敗したこともあります。失敗したりしなかったりします
• real_failure → 修正 — 使用可能な過去の実行結果のすべてでチェックが失敗しています（現在のシグネチャが指定されている場合は、そのシグネチャで失敗しています）。インフラストラクチャが原因に見えるシグネチャでも、毎回失敗するなら実際の失敗です
• insufficient_evidence → 調査 — 使用可能な履歴がないか、履歴が混在していて、どのルールにも該当しません

ルールは固定された順序で実行され、それぞれが証拠を追加します。 ステータスは正規化されます（success／pass／passed、 failure／fail／failed／error）。ほかのチェックの実行結果は 無視されます。完全にローカルで処理し、ネットワークも設定も不要です。

CLI

npx @reneturcios/rerunplan plan --check unit-tests --signature "Error: boom" --past past-runs.json
npx @reneturcios/rerunplan --version

past-runs.json は、次のようなオブジェクトを含む JSON 配列です。 {"check": "unit-tests", "status": "failure", "error_signature": "Error: boom"} （各実行で check と error_signature は省略可能です）。

終了コード：成功時は 0、実行時エラー時は 1（読み取り不能または無効な past-runs ファイルを含む）、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/rerunplan mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "rerunplan": {
      "command": "npx",
      "args": ["-y", "@reneturcios/rerunplan", "mcp"]
    }
  }
}

ツール

• plan_rerun — チェックの過去の実行履歴から失敗を分類し、再実行、修正、調査のいずれかを推奨します。
  • check （文字列、必須） — 失敗したチェックの名前
  • error_signature （文字列、省略可能） — 現在の失敗のエラーシグネチャ
  • past_runs （配列、必須） — {check?, status, error_signature?} オブジェクト形式の過去の実行結果

Docker

docker run -i ghcr.io/cloudcorprecords/rerunplan
docker run --rm -v "$PWD:/w" ghcr.io/cloudcorprecords/rerunplan plan --check unit-tests --past /w/past-runs.json

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (pure local, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios