スプリント lfactory3-1 by takemi-ohama · Pull Request #2485 · devbasex/ai-plugins

takemi-ohama · 2026-11-04T10:52:44Z

スプリント lfactory3-1 の課題を develop へ取り込む。

利用者向けの変化

並列の実行（parallel.py）に --external があり、NDF の外のオーガナイザーへ切り替えられる（#2439 を実装する（スプリント lfactory3-1） #2483）
Factory のオーガナイザーは、配布の依頼をまとめて実行し、結果を待ち、途中から再開できる。配布の一覧と履歴も確認できる（#2439 を実装する（スプリント lfactory3-1） #2483）
Factory の説明文と画面の文言は「手元のマシン」と「料金プラン」の語で表示する（#2439 を実装する（スプリント lfactory3-1） #2483）
factory の README に、Factory のオーガナイザーの置き場と経路を載せている（#2439 を実装する（スプリント lfactory3-1） #2483）
スプリントの一覧で、各スプリントが今どのフェーズにあるかを確認できる。フェーズの名前は 5 つに揃えて表示する（#2172 を実装する（スプリント lfactory3-1） #2484）
スプリントの詳細画面の工程の詳細パネルで、その工程で触ったファイル・決めたこと・作業の報告を確認できる。これらの中身は伏せ字の処理を通してから表示する（#2172 を実装する（スプリント lfactory3-1） #2484）
バックログの画面で、スプリントのバックログを確認できる（#2172 を実装する（スプリント lfactory3-1） #2484）
スプリントの一覧・詳細・バックログの画面は、表示している内容を一定の間隔で読み直す（#2172 を実装する（スプリント lfactory3-1） #2484）
スプリントの一覧を返す経路は、保存に失敗したときに 503 を返す（#2172 を実装する（スプリント lfactory3-1） #2484）

移行の手順

無し（工程の中身は任意の項目として足すため、事象の形式の版（schema_version）は上げない。今のランナーが出す事象と、既に残っている事象はそのまま読める）（#2172 を実装する（スプリント lfactory3-1） #2484）

課題と設計

コミット

Add: Factory のオーガナイザーの契約（配布の依頼と結果の事象・配布の実行の指示・一覧と履歴の経路）（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Add: Factory のオーガナイザーの配布のまとめと実行の表の行（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Test: Factory のオーガナイザーの配布のまとめ・待ち・再開・一覧の振る舞い（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Add: NDF の外のオーガナイザーとの切り替え口（--external と置き場の契約・NDF_FACTORY_RUN の断り）（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Add: ランナーの置き場の翻訳（配布の依頼・提示・結果の事象と答えの書き出し）と配布の実行の手順（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Fix: NDF の切り替え口の契約と文書でサービスを名指ししない（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Update: Factory の説明文と画面の文言の語を「手元のマシン」と「料金プラン」へ改める（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Docs: factory の README に Factory のオーガナイザーの置き場と経路を書く（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Update: 宣言の整形を当てる（lint-fix）
Fix: script-structure の違反を解く（parallel.py を 496 行・外の副命令を parallel_external_cli.py へ・parallel_external.py の関数名を他と重ねない）（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Docs: 確定仕様の並列のオーガナイザーと Factory の実行の状態に、外のオーガナイザーの切り替え口と配布の実行の待ち方を書く（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Docs: 確定仕様の追加した行から課題番号の由来を外す（doc-lint）（NDF Factory: オーガナイザーを Factory の側で実装し、同じリポジトリで並行する実行の本番の配布を 1 本にまとめ、承認と問いを 1 か所に集める #2439）
Merge pull request #2439 を実装する（スプリント lfactory3-1） #2483 from devbasex/feat/issue-2439-lfactory3-1
Add: フェーズの名前の列挙と、step.recorded の工程の中身の任意の項目を契約に足す（NDF Factory: スプリントの一覧（フェーズ）と詳細（工程・PR・CI・承認ゲート） #2172）
Add: ランナーがフェーズの名前を 5 つへ写し、工程の中身（触ったファイル・決めたこと・作業の報告）を伏せて step.recorded に添える（NDF Factory: スプリントの一覧（フェーズ）と詳細（工程・PR・CI・承認ゲート） #2172）
Add: スプリントの一覧に今のフェーズを足し、詳細・工程の中身・バックログを読む経路と派生を作る（NDF Factory: スプリントの一覧（フェーズ）と詳細（工程・PR・CI・承認ゲート） #2172）
Add: スプリントの一覧・詳細（工程の詳細パネル）・バックログの画面と読み直しを作る（NDF Factory: スプリントの一覧（フェーズ）と詳細（工程・PR・CI・承認ゲート） #2172）
Docs: 確定仕様にフェーズの名前の 5 つ・step.recorded の工程の中身・一覧と詳細の読み出しの規則を書き、画面の地図と用語集を今の形にする（NDF Factory: スプリントの一覧（フェーズ）と詳細（工程・PR・CI・承認ゲート） #2172）
Docs: スプリントの一覧の経路に足した 4 項目と保存の失敗の 503 を確定仕様と OpenAPI に書く（NDF Factory: スプリントの一覧（フェーズ）と詳細（工程・PR・CI・承認ゲート） #2172）
Merge pull request #2172 を実装する（スプリント lfactory3-1） #2484 from devbasex/feat/issue-2172-lfactory3-1

変更の統計

 .../plugins__ndf__scripts__supervise.py.json       |   2 +
 plugins/ndf/contracts/env/NDF_FACTORY_RUN.json     |   5 +
 plugins/ndf/contracts/env/NDF_ORGANIZER_DIR.json   |   5 +
 plugins/ndf/contracts/env/NDF_ORGANIZER_LANE.json  |   5 +
 plugins/ndf/contracts/forms/parallel-external.json | 261 +++++++++
 plugins/ndf/contracts/index.md                     |   3 +
 plugins/ndf/scripts/lib/parallel_answer.py         |  29 +
 plugins/ndf/scripts/lib/parallel_external.py       | 372 ++++++++++++
 plugins/ndf/scripts/lib/parallel_external_cli.py   | 114 ++++
 plugins/ndf/scripts/lib/parallel_lane.py           |  60 +-
 plugins/ndf/scripts/parallel.py                    | 101 ++--
 .../ndf/scripts/tests/test_parallel_external.py    | 181 ++++++
 plugins/ndf/scripts/tests/test_parallel_run.py     |  17 +-
 .../development-workflow/references/parallel.md    |  34 ++
 113 files changed, 7971 insertions(+), 439 deletions(-)

テスト（supervise.py の run のステップ）

ステップ	exit	最後の行
collect	0

集めた実装の PR

#2439 を実装する（スプリント lfactory3-1） #2483: 変化あり
#2172 を実装する（スプリント lfactory3-1） #2484: 変化あり

閉じる課題

Closes #2172
Closes #2439