P28-01-RESTART: Track spec, worker instructions and Root 4-PID procedure
Finite acceptance RS1-RS8 from the preserved draft (byte-identical DRAFT.md),
pinned to the collector final Q and the integrated full9 receipt on db9d613.
Docs only, outside the product source map; nothing registered or run.
Original credit unchanged (22/88, 4/30).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Takeshi
co-authored by
Claude Opus 5.5
Claude Opus 5.5
parent
db9d6132a8
commit
2132bbe3d3
@@ -0,0 +1,88 @@
|
||||
# P28-01-RESTART 仕様（spec_ref）
|
||||
|
||||
- 状態: 登録用の確定版です。この文書を Git で追跡し、それを含む commit を base にします。
|
||||
- 元の草案: 同じディレクトリの `DRAFT.md`（SHA `a4a8261bcc14d38de8df8d9024321dd8fdb6c6356964ff43472d2bf84eff1334`。Control handoff の `RESTART_DRAFT.md` とバイト一致）。§番号は草案と同じです。この仕様は草案を契約の形にしたもので、規約を広げてはいません。
|
||||
|
||||
## 1. 原本との対応（変更しない）
|
||||
|
||||
- 対象は原 P28 の横断条件6件のうち、「途中保存・再起動で再現」です（`work_packages.json` P28.cross_cutting_acceptance[2]）。
|
||||
- 成果単位は P28-01「現HEADの性能基準」です。work と acceptance は collector の SPEC §1 と同じです。
|
||||
- 分母は原30/88で、部分点はありません。この task が完了しても、原本は加算0です。P28-01 の加算（22→23）には、次の4つがすべて必要です。
|
||||
1. collector の final（完了済み、Q `0f53a672…`）
|
||||
2. 統合版で全9 phase を実測すること（完了済み。実際の commit `db9d6132a8349928560dc4a4a99306d27a81e332`、`artifacts/original-completion-2026-10-02/p28-01-runner-preflight-r01/full-measurement-db9d613-r01/run/execution.json` SHA `a4d10e9b1a75a17b981792265338d64fac61178cb6f87dd646c5b486292db73c`、Root の結合 `ROOT_RAW_ACCEPTANCE_JOIN.json` SHA `a76082f767e0a0d52cb70e2f66fa371b62a88754e9be319da3c08d4b48e78ba0`）
|
||||
3. この RESTART の final と、Root の実測4 PID の pair の PASS
|
||||
4. 証拠ゲート
|
||||
- 次のものは、未達のまま残します。
|
||||
- 予算の未達
|
||||
- 200客での Operations ON（製品の上限100）
|
||||
- Windows
|
||||
- 予算値、製品の値、停止契約は変更しません。
|
||||
|
||||
## 2. 成果物（worker、allowed_paths `docs/plans/original-completion-2026-10-02/execution/p28-01/restart/probe/**`）
|
||||
|
||||
| ファイル | 役割 |
|
||||
|---|---|
|
||||
| `restart_pair.py` | Root が実行する driver です。統合済みの collector から、`no_live_engine`、`source_map`、`run_private_engine`、`run_engine` と、guard、private profile、owned phase の仕組みを、読取専用で import して使います。import してよい外部ファイルは `tools/run_all_tests.py`、`tools/regression/owned_outer.py`、統合済みの `execution/p28-01/collector/collect_p28_01.py` だけです。`--check` は計画だけを出力し、`--run` で4 PID を実行します。 |
|
||||
| `restart_probe.gd` | writer と reader の probe（extends SceneTree）です。草案 §1〜§5 を実装します。 |
|
||||
| `check_restart.py` | report と receipt の checker です。§4 の拒否をすべて実装します。 |
|
||||
| `test_restart.py` | engine を使わない unittest です。 |
|
||||
|
||||
## 3. 受入グループ（baseline。有限で、草案の各節に対応する）
|
||||
|
||||
- **RS1（草案§1〜2）保存・読込の成否**
|
||||
- 保存は main の `_save_manual_at_path`（bool）、読込は `_load_manual_at_path(path, true)`（void）で行います。
|
||||
- 成否は、`save_operation_completed` の signal、`latest_save_operation_result`、実際の状態の3つで判定します。
|
||||
- 保存の bool と signal の ok は一致しなければなりません。
|
||||
- **RS2（§3.2、3.3 a〜c）IO の厳密な対応**
|
||||
- a: P が保存直前の状態と完全一致すること。
|
||||
- b: 保存後の状態が X(P, ev_save) と完全一致すること。
|
||||
- c: 読込後の状態が X(P, ev_load) と完全一致すること。
|
||||
- X の構成は §3.2 のとおりで、counter+1、published_ids への E の sort 挿入、recent_events（上限256、溢れたら先頭を1件落として記録）です。
|
||||
- **RS3（§3.3 d、§4）継続の一致**
|
||||
- 実際に進んだ K（=30）分の各分で、writer と reader が全状態で完全一致すること。
|
||||
- 置き換えてよいのは、窓の中にある event_id E の要素1件だけです。
|
||||
- K は実際に進んだ分の数で数えます。
|
||||
- **RS4（§4）Operations の境界**
|
||||
- O は、実際の arrival（>0）が起きた後に保存します。
|
||||
- 120分までに arrival が無ければ、null と理由にします。
|
||||
- 境界に到達しただけで、arrival を処理したことにはしません。
|
||||
- **RS5（§5）異常と境界**
|
||||
- 改ざんした保存の原子的な拒否（reader の PID 内で、正しい保存の前に試します）。
|
||||
- R の止まった状態での保存と、読込後も止まっていること。
|
||||
- O の次の arrival の境界に、重複も欠落もないこと。
|
||||
- **RS6（§6）区間の静的検査**
|
||||
- UI 区間と決定性区間の、それぞれの禁止と許可を守ること。
|
||||
- 性能値を一切出さないこと。
|
||||
- **RS7（§7、collector C6/C7 と同じ）分離**
|
||||
- private user://、owned PID、guard、cleanup、通常 player の保全、全 raw と SHA の結合。
|
||||
- source map が1407件のまま前後で一致すること。
|
||||
- collector の4ファイルが Q と一致すること。
|
||||
- **RS8 横断条件の記録**
|
||||
- 6件の横断条件それぞれについて、適用するかどうかと理由を記録します。
|
||||
- 「途中保存・再起動で再現」は、RS1〜RS5 で適用します。
|
||||
- それ以外の5件は、collector 側の既存の受入を参照し、適用外の理由を記録します。
|
||||
|
||||
## 4. checker が必ず拒否するもの（すべて test_restart.py に拒否試験を置く）
|
||||
|
||||
1. 読込の void 戻り値、または保存の bool の true だけで、成功とすること。保存の bool と signal の ok の食い違いを見逃すこと。signal が無いのに成功とすること。
|
||||
2. X(P, ev) 以外の差を許すこと。たとえば次のものです。
|
||||
- 2件以上のイベントの差
|
||||
- E 以外の ID
|
||||
- counter が+1でない
|
||||
- published_ids の欠落や重複
|
||||
- recent の上限での先頭の落とし方の違い
|
||||
- 規約の外のパスの除外や置き換え
|
||||
- 「末尾1件の除外」として扱うこと
|
||||
3. 継続で、E 以外の要素を置き換えること。窓から落ちた後も置き換えること。digest の一致だけで比較の代わりにすること。
|
||||
4. advance の呼出し回数で K を数えること。writer と reader で実際の K が違うのに合格とすること。
|
||||
5. 境界に到達しただけで arrival を処理したとみなすこと。arrival が0なのに RS4 を合格とすること。
|
||||
6. 改ざんした読込のあとで状態が変わっているのに合格とすること。止まった状態での保存のあとに backlog を消費すること。
|
||||
7. 決定性区間の外での `advance_minutes`。決定性区間の中の `Time.get_ticks_usec` や `*_us`。UI 区間の禁止 token。
|
||||
8. PID、raw、source map、通常 player、guard の不一致。owned folder への書込み。
|
||||
|
||||
## 5. 依存と前提
|
||||
|
||||
- 登録済みの task への depends_on はありません。collector は別 project なので、前提は追跡済みの記録として SHA で固定します。
|
||||
- collector の final の receipt（Q）
|
||||
- 統合版の全9 phase の実測の receipt（上の §1 の2つの SHA）
|
||||
- collector の baseline C1〜C9 は凍結されているので、追加しません。RESTART は別 project として登録します。
|
||||
Reference in New Issue
Block a user