release-archivist

リリースアーキビスト

バンドルされたランタイム

以下の CLI コマンドを実行する前に、先頭の SSF を node "<plugin-root>/scripts/spec-superflow.mjs" に置き換えてください。<plugin-root> は、このファイルから 2 階層上にあるディレクトリの絶対パスです。SSF をそのまま実行したり、PATH 上の ssf を呼び出したりしないでください。

SSF resume <change-dir> --json を読み取ってください。executing では、検証と論理的なクローズを完了します。closing では、マージが許可されている場合に限り、記録済みの未完了な物理的処理のみを実施します。abandoned または処理が完了している場合は、作業は不要です。それ以外の状態では、ワークフロー開始の手順に進みます。

新規の直接実行／計画済み変更

SSF workflow complete <dir> --verification-command "<required check command>" を使用してください。最終検証は一度だけ実行されます。このコマンドを呼び出す直前に、同一のフルスイートを実行しないでください。計画済みの実行では、完了済みタスク、現在の全範囲／ウェーブレビュー、および差分仕様の公開も確認されます。直接実行では、計画もレビューレシートも必要ありません。通常の失敗は executing のままにして、対象を絞って修正してください。承認済みのコード提供に、DP-6／DP-7 や別の承認を追加しないでください。

ユーザーが未完了の作業または検証の失敗を明示的に受け入れた場合は、SSF workflow complete <dir> --accept-risk --confirm --reason "<decision and remaining issues>" を使用してください。すべての失敗を保持し、検証済みの成功ではなく、リスク受容として報告してください。これによりコード提供は終了しますが、ブランチのマージや削除は行われません。単に closing へ遷移しても、失敗したチェックを回避することはできません。検証済みの作業でも、物理的な統合は別途承認を受けて実施します。残りのクローズ手順は、レガシー互換のためのものです。

範囲限定のパス

Quick／direct Hotfix／Tweak では、変更ファイル、対象を絞ったコマンドと結果を記録し、test_result: pass を保存してから closing に遷移します。Hotfix では、元の症状が解消されたことを証明する必要があります。Lightweight では、レシートに記載された対象を絞ったレビューと、検証合格の証拠も必要です。これらのパスでは、契約、実行計画、ウェーブレビュー、監査、DP-6／DP-7、SSF finish は不要です。

フル／レガシー Hotfix

1. 必須のビルド／テスト／検証コマンドを使用して、最終的なコードスナップショットを検証します。コード、環境、コマンドが同一の場合に限り、新しい検証結果を再利用してください。スキルが変更されたという理由だけで、同じフルスイートを再実行しないでください。
2. 実際の差分に対して、契約の網羅性、設計の一貫性、範囲、未解決の指摘事項を確認します。コマンドと結果を示してください。編集したことや未検証の主張から、成功を推測してはいけません。
3. 現在の計画で定められたレビューポリシーに従います。Native の final では全範囲の最終レビューを 1 回、wave／レガシー計画では必須のウェーブレシートを使用します。変更されていない証拠に対する重複レビューを要求しないでください。
4. executing の間に spec-merger を使用して、実際の差分仕様を同期します。仕様が明示的に省略され、差分も存在しない場合は、仕様を再作成しないでください。
5. SSF audit <dir> を実行し、検証結果（dp_6_result、タイムスタンプ、test_result）を記録します。ユーザーのアーカイブ承認をすでに取得している場合、または明示的に求められた場合に限り、DP-7 を記録します。不足している決定を捏造しないでください。
6. ブロッカーが解消されたら、SSF state transition <dir> closing を実行します。これは論理的なクローズであり、マージやクリーンアップの成功を意味するものではありません。

結果、主要な検証内容、未解決のリスク、次のアクションのみを報告してください。承認済みの契約と実装の証拠を保持し、計画ファイル一式を別のサマリーにコピーしないでください。

物理的な完了処理

承認済みの Full／legacy Hotfix 統合では、SSF finish <dir> [--test-cmd <command>] を実行します。記録された対象チェックアウト／ブランチを使用し、必要に応じてマージし、対象を検証してから安全に隔離状態を解除します。クリーンアップ前に、無視対象の変更アーティファクトのアーカイブを検証し、対象の以前の状態を保持します。未コミットの作業を強制的に削除することはありません。ブランチのみの隔離では、チェックアウトを削除しません。

検証に失敗した場合は、隔離状態を保持します。記録された verify-pending については、復旧時に保護された closing -> debugging 遷移が提示されます。原因を調査し、承認済みの範囲内で修正して再検証し、レビューを受けてから、再度クローズしてください。完了済みの finish と破棄された変更は、再開できません。クリーンアップに失敗した場合は、cleanup-pending のままになります。再開すると残りの手順が実行されます。未完了の finish を再試行するたびに、検証がもう一度実行されます。同じ HEAD のままでも、無視対象の依存関係、ローカル設定、外部サービスが変更されている可能性があるためです。完了済みの finish では、検証は再実行されません。完了済みの finish は冪等です。対象が見つからない、または対象が曖昧な場合は、実際のブロッカーです。マージする前に来歴を復元し、現在のディレクトリから対象を推測してはいけません。

ユーザーがマージせずにブランチを渡すよう求めた場合は、ブランチ／worktree をそのまま残し、その状態を報告してください。論理的にクローズしたことを、マージ、プッシュ、リリースの許可と見なしてはいけません。

これらの判断を記録する際は、SSF state set <change-dir> dp_6_timestamp now と SSF state set <change-dir> dp_7_timestamp now を使用してください。