棚卸しで apply を 2 回打つと report の区分の内訳と承認待ちが 0 件になる #1849

何を見つけたか

棚卸しの同じ回（前の candidates 以降）で upkeep.py apply を 2 回打つと、upkeep.py report の区分の内訳（verdicts）が全部 0 になり、承認待ち（needs_approval）と返した課題（returned）も空になる。

• 入力: 1 回目の apply に本文の書き換え 29 件（やらない 1・要判断 1 を含む）、2 回目の apply に順位の表（rank）だけを載せた plan
• 観測: 1 回目の出力には verdicts（そのまま 8・追記が要る 15・書き直しが要る 5・やらない 1・要判断 1）と needs_approval: [1637]・returned: [873] がある。2 回目の後の report ではどれも 0 か空
• 原因: _apply_outcome（plugins/ndf/skills/backlog-refinement/scripts/upkeep.py:468）は applied・closed・waits を前回の round と足し合わせるが、verdicts・needs_approval・returned はその回の plan の値だけを書く。report は最後の apply.json を読む

どこで見つけたか

スプリント m845 の後の棚卸し（2026-10-08）。順位の表を本文の書き換えと別の plan で反映した。

なぜこの変更の範囲外なのか

この回の作業は確定仕様化と棚卸しの実行で、upkeep.py を直すことは受け入れ条件に含まれない。2 回の apply の区分をどう合算するか（課題の番号で後の値を採るか、和集合を取るか）は方針の判断で、即時修正の 4 条件の 3 つ目（既存の方針の範囲）に収まらない。根拠: MVV なし（判断はリポジトリの即時修正の条件だけに拠った）

直さないと何が起きるか

本文と順位の表を分けて反映した回の完了報告で、区分の内訳と承認待ち・返した課題が 0 件に見える。承認の要る課題（「やらない」・要判断）を報告から落とし、人へ戻し損ねる。

由来

issue #851

受け入れ条件

• 既存の fixture で、1 回目の apply（そのまま 1・やらない 1）の後に順位の表だけの plan で 2 回目の apply を打つと → upkeep.py report は verdicts でそのまま 1・やらない 1 を返し、1 回目の needs_approval・returned の番号を落とさない
• 2 回の apply の両方に同じ課題の番号が出るとき → needs_approval・returned にその番号が重複して出ない。区分の内訳での扱い（番号ごとに後の値を採るか、和集合を取るか）は設計で決め、その規則どおりの値をテストで固定する
• 退行しない: apply が 1 回だけの回では → report は今と同じ verdicts・needs_approval・returned を返す。新しい candidates で回が改まったら → 前の回の区分は持ち越さない
• 前の回の apply の結果が読めず累積できないとき → report は 0 件を ok で返さず、ok 以外で返す

修正レイヤー

親 #2227（全工程の結果を統一した JSON レポートにし、失敗・未収束・未記録を ok で返さない）（回をまたぐ累積の規則）。upkeep.py の _apply_outcome は round に applied・closed・waits だけを足し、verdicts・needs_approval・returned は最後の apply の値を upkeep_report.py が読む。既存の fixture で 1 回目の apply（そのまま 1・やらない 1）の後に 2 回目を打つと、report はやらない 0・needs_approval []・apply_runs 2 を返す。合算の方針（番号ごとに後の値か、和集合か）は未決。

進行

モード: — / 進め方: auto

• 要求と受け入れ条件
• 作業場所の用意 — 2026-10-31 03:59
• 設計
• 素材の収集と出典の確定
• ドキュメント再構成
• ドキュメントレビュー
• 計画 — 2026-10-31 03:59
• 実装 — 2026-10-31 06:04
• 構造改善 — 2026-10-31 07:37
• 実装レビュー — 2026-10-31 09:12
• 完了判定 — 2026-10-31 06:07
• Pull Request — 2026-10-31 06:21
• 確定仕様化 — 2026-10-31 11:00
• 後片付け — 2026-10-31 10:57
• 配布 — 2026-10-31 10:33
• 体裁レビュー
• リリース後テスト — 2026-10-31 10:56
• 振り返り — 2026-10-31 11:00
• 棚卸し — 2026-10-31 11:21

振り返り: #2282 (comment)