ProveDone

概要

• ProveDoneは、コマンドの終了コードではなく、ディスク上に実際の成果物が生成されたかを基準に処理結果を判定する検証ツールです。
• PASS、SILENT_FAILURE、FALSE_FAILURE、FAILUREの4種類の判定で、見かけ上成功・失敗している処理を正確に切り分けます。
• 依存関係なしで利用でき、Node.js 18以降に対応。MITライセンスで導入しやすい設計です。

主な特徴

• 成果物の存在、サイズ、ファイル数、新しさに加え、今回の実行で作成されたものかどうかまで検証し、古いファイルによる誤判定を防ぎます。
• 成果物が揃っている場合は、後片付け処理のクラッシュによるFALSE_FAILUREを再実行不要として扱えるため、不要な再処理を抑えられます。
• 4種類の判定を再現するセルフチェック、すぐ使える5つのゲート設定、典型的な失敗パターンをまとめたプレイブックが付属します。

こんな人におすすめ

• 公開、画像生成、ビルドなどを無人で実行するパイプラインを運用し、終了コードだけでは処理結果を信頼できないと感じている人に適しています。
• 古い成果物の残存、後処理の失敗、タイムアウトのない検証処理による停止など、見えにくい障害に悩む開発者向けです。
• 失敗時のアラートや再実行を適切に制御し、実際の成果物を根拠に自動ゲートの信頼性を高めたいチームに役立ちます。