docs(p9.8): close contract state step

This commit is contained in:
2026-08-15 09:07:03 +08:00
parent e8b5817767
commit 5f428de04b
3 changed files with 42 additions and 8 deletions
+11 -5
View File
@@ -6,9 +6,9 @@ Active implementation plan: `docs/runtime/p9_8/IMPLEMENTATION_PLAN.md`
Project process protocol: `docs/runtime/PLAN_DRIVEN_DEVELOPMENT_PROTOCOL.md`
Post-P9.1 roadmap: `docs/runtime/p9_1/POST_P9_1_ROADMAP.md`
Active ledger: `docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md`
Current implementation step: `P9.8-STEP-2 CONTRACT STATE AND SAVE`
Current pushed runtime baseline: `3a26827`
Current pushed test/evidence source: `3a26827`
Current implementation step: `P9.8-STEP-3 ROUNDS 8-12`
Current pushed runtime baseline: `e8b5817`
Current pushed test/evidence source: `e8b5817`
P9.1 TaskGraph batch: `abg-p9-1-continuous-development-01`
P9.0R5 baseline: `6ae33971451912b3cc87c8ffe3b8831fa67c967c`
P9.0R5 product preview source: `073ff690ea5a27cb47ee1b563c3eebd6cde9e788`
@@ -57,8 +57,14 @@ twelve Windglass enemies and one Stag boss. Fresh Git-archive evidence at
`/private/tmp/abg-p98-3a26827-step1-r1/` passes import plus P9.8 content and P9.7
content/settlement regressions with strict diagnostics zero; inventory SHA-256
is `891818839515fff0b1a75540e7eaea024dfcb8e288758f72a8dff34a0ab329a6`.
Step 2 now owns isolated version-3 state, transactions and P9.7 save migration;
battle integration and presentation remain later steps.
Step 2 source `e8b5817` now owns isolated version-3 state, Artifact/promotion
transactions and exact P9.7 save migration. Fresh Git-archive evidence at
`/private/tmp/abg-p98-e8b5817-step2-r1/` passes P9.8 state/persistence/content
plus P9.7 Market/persistence/settlement regressions with strict diagnostics
zero; inventory SHA-256 is
`f76903db141a6e11d69cfa6b1999912c6e28207105abfb05e25d856c024fea9c`.
Step 3 now owns Rounds 8-12 battle and atomic settlement through capacity 10
and fixed Boss Muster; presentation remains later.
P9.7 begins from clean/upstream planning baseline `583fb1e`. The Owner requests
one larger coherent playable batch before the next H5 review, so the active
@@ -321,3 +321,22 @@ separate.
`891818839515fff0b1a75540e7eaea024dfcb8e288758f72a8dff34a0ab329a6`.
- Step 1 is `automated_verified` for content authority only. State/save is now
active; battle, runtime, human, device and release gates remain open/frozen.
## P9.8 Step 2 Contract State And Save - 2026-08-15
- Source `e8b5817` adds isolated P9.8 state, transaction and save-v3 modules;
P9.7 state/service/save source remains unchanged.
- Exact P9.7 Market 8 migrates with Company, line/Reserve, inventory, HP, Coin,
route and operation histories intact. Version 0/1 follows preserved P9.7
authority; version 2 activates deterministic P9.8 Market 8.
- Canonical `AR-001`/`AR-002` selection applies from Market 9 as exact `4×3`
or `2×5` Recruit/equipment shapes. Eligible promotion requires level 4 and
three survivals and preserves identity, HP, equipment and order.
- Save-v3 round trip, checksum, malformed/unknown/invalid state, backup,
rollback, 24-hour cap, encounter interruption and zero offline rewards pass.
- Fresh Git-archive root `/private/tmp/abg-p98-e8b5817-step2-r1/` retains six
exact P9.8/P9.7 markers, strict diagnostics zero and an 8-row inventory with
SHA-256
`f76903db141a6e11d69cfa6b1999912c6e28207105abfb05e25d856c024fea9c`.
- Step 2 is `automated_verified`. Rounds 8-12 are active; boss mechanics,
runtime presentation, human, device and release gates remain open/frozen.
+12 -3
View File
@@ -1,7 +1,7 @@
# P9.8 First Contract Completion Implementation Plan
> Status: `ACTIVE`
> Active step: `P9.8-STEP-2 CONTRACT STATE AND SAVE`
> Active step: `P9.8-STEP-3 ROUNDS 8-12`
> Baseline: `dc5a74ebb4b59d944fe303c80fb3410ba79fd9b6`
> Goal: `docs/goals/PHASE9_8_FIRST_CONTRACT_COMPLETION_GOAL.md`
> Contract: `docs/runtime/PHASE9_8_FIRST_CONTRACT_COMPLETION_CONTRACT.md`
@@ -22,8 +22,8 @@ verified, committed and pushed without pausing for routine authorization.
|---|---|---|---|
| P9.8-STEP-0 Contract | `COMPLETE` | Exact first-Contract scope and terminal are frozen. | Goal, contract, plan, checkpoint and ledger pushed. |
| P9.8-STEP-1 Content authority | `COMPLETE` | Markets 8-12, Artifact, promotion and boss objects resolve from deterministic validated data. | Source `3a26827`; content/schema tests and P9.7 regressions pass strict-clean. |
| P9.8-STEP-2 Contract state and save | `IN_PROGRESS` | P9.7 save migrates to v3 and all new decisions commit atomically. | Domain/persistence tests pass. |
| P9.8-STEP-3 Rounds 8-12 | `PENDING` | Five escalating Rounds reach capacity 10 and fixed Boss Muster. | Round counterfactual/settlement tests pass. |
| P9.8-STEP-2 Contract state and save | `COMPLETE` | P9.7 save migrates to v3 and all new decisions commit atomically. | Source `e8b5817`; domain/persistence and P9.7 regressions pass strict-clean. |
| P9.8-STEP-3 Rounds 8-12 | `IN_PROGRESS` | Five escalating Rounds reach capacity 10 and fixed Boss Muster. | Round counterfactual/settlement tests pass. |
| P9.8-STEP-4 Artifact and promotion | `PENDING` | One shared Artifact and one Recruit promotion visibly change battle grammar. | Choice/counterfactual tests pass. |
| P9.8-STEP-5 Boss and run close | `PENDING` | Both boss plans, defeat/recovery and exactly-once persistent clear work. | Boss/save/run-close tests pass. |
| P9.8-STEP-6 Complete runtime evidence | `PENDING` | The entire Contract is playable by touch with readable motion and results. | Full flow, five profiles, layouts, recording and regression pass. |
@@ -152,3 +152,12 @@ COMMIT: docs-only closure after immutable delivery.
Inventory SHA-256 is
`891818839515fff0b1a75540e7eaea024dfcb8e288758f72a8dff34a0ab329a6`
and covers 5/5 entries.
- Step 2 source `e8b5817` adds isolated P9.8 state/service/save-v3 modules.
Exact P9.7 Market 8 migrates with Company, inventory, HP and histories intact;
v0/v1 remain on preserved P9.7 authority, Artifact and promotion transactions
are idempotent, and interrupted v3 encounters restore the exact pre-battle
Market with zero offline rewards.
- Fresh Git-archive evidence at `/private/tmp/abg-p98-e8b5817-step2-r1/`
passes six P9.8/P9.7 markers with strict diagnostics zero. Inventory SHA-256
is `f76903db141a6e11d69cfa6b1999912c6e28207105abfb05e25d856c024fea9c`
and covers 8/8 entries.