Files
aetherbound-guild/docs/runtime/p9_8/IMPLEMENTATION_PLAN.md
T

164 lines
9.0 KiB
Markdown

# P9.8 First Contract Completion Implementation Plan
> Status: `ACTIVE`
> 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`
## Player-Visible Stopping Point
Starting from the exact P9.7 saved Market 8, complete Rounds 8-12, choose one
Artifact, promote one eligible Recruit, prepare for and fight The Many-Paned
Stag, recover from one viable boss defeat, and atomically close the Contract
into a persistent Windglass clear/Renown/Record result.
No Owner H5 review is requested before Step 7 closes. Internal steps are
verified, committed and pushed without pausing for routine authorization.
## Ordered Steps
| Step | Status | Player outcome | Commit boundary |
|---|---|---|---|
| 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 | `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. |
| P9.8-STEP-7 H5 and closure | `PENDING` | One fresh cached H5 exposes the complete Contract for Owner review. | Runtime-only export, Gallery delivery and docs closure pushed. |
## Step Contracts
### P9.8-STEP-1 CONTENT AUTHORITY
```text
PLAYER OUTCOME: Every new Market object, route, Artifact, promotion and boss
preview has a stable readable identity and deterministic consequence.
IN SCOPE: P9.8 content registry; Markets 8-12; fifteen route offers; bounded
Recruit/equipment offers; three Artifact rows; reachable promotion pairs;
Windglass enemy compositions; Stag definition; localization; validation.
OUT OF SCOPE: state mutation, UI, save, runtime and H5.
OWNED FILES: runtime/content/p9_8_content.gd plus UID;
runtime/tests/p9_8/content_authority_test.gd plus UID; durable status.
ACCEPTANCE: IDs/references/board shapes/rewards/capacities/locale/hash are exact;
malformed fixtures reject; P9.7 content and settlement regressions pass.
COMMIT: focused source/test/status push before Step 2.
```
### P9.8-STEP-2 CONTRACT STATE AND SAVE
```text
PLAYER OUTCOME: Existing progress resumes truthfully and every new choice is
interruption-safe, idempotent and inspectable.
IN SCOPE: isolated P9.8 state/service/save v3; v2 migration; Artifact/promotion/
Boss Muster/clear drafts and receipts; complete snapshot rejection boundaries.
OUT OF SCOPE: battle simulation and presentation.
ACCEPTANCE: successful operations increment once; rejected operations preserve
every field; v2 migration, corruption, backup, rollback, interruption,
duplicate claim and zero-offline checks pass with P9.7 regressions.
COMMIT: focused domain/persistence/status push.
```
### P9.8-STEP-3 ROUNDS 8-12
```text
PLAYER OUTCOME: Five escalating preparation/battle cycles reach a fixed Boss
Muster, with capacity 8/9/10 changing the legal Company plan.
IN SCOPE: content-fed compositions and mechanics; fifteen routes; reward/XP/
survival/capacity settlement; distinct counterfactuals; boss entry.
OUT OF SCOPE: Artifact/promotion rule application and presentation.
ACCEPTANCE: all routes terminate under 150 seconds; five exact state-dependent
choice boundaries hold; settlement/reload/duplicate checks and P9.7 pass.
COMMIT: focused battle/status push.
```
### P9.8-STEP-4 ARTIFACT AND PROMOTION
```text
PLAYER OUTCOME: The player makes two understandable build decisions that alter
shared and individual action grammar before the boss.
IN SCOPE: deterministic Artifact draft/commit; eligible promotion preview/
confirm; preserved identity/equipment/HP/order; battle effects and negatives.
OUT OF SCOPE: boss battle and final UI polish.
ACCEPTANCE: at least two rational Artifact states and two promotion directions;
ineligible/duplicate/cancel/reload paths exact; prior round paths pass.
COMMIT: focused systems/status push.
```
### P9.8-STEP-5 BOSS AND RUN CLOSE
```text
PLAYER OUTCOME: The Stag visibly screens, rotates and sweeps; rotate and brace
plans both work, defeat has a fair recovery, and victory permanently clears
the Contract once.
IN SCOPE: boss state/service; pane/sweep/phase events; plan commit; defeat/
recovery; pending clear; Renown/Record/discovery settlement; save retries.
OUT OF SCOPE: final broad presentation and H5.
ACCEPTANCE: both plans win in their intended state and lose in a counter-state;
timeout bounded; boss recovery preserves authority; clear retry is idempotent;
run-only state clears atomically; full P9.3-P9.7 regressions pass.
COMMIT: focused boss/status push.
```
### P9.8-STEP-6 COMPLETE RUNTIME EVIDENCE
```text
PLAYER OUTCOME: One uninterrupted landscape playthrough communicates every
Market, build, boss and persistent-result decision through the game world.
IN SCOPE: isolated P9.8 controller and main handoff; touch/drag; animation and
combat feedback; five profiles; layouts/locales/accessibility; recording.
OUT OF SCOPE: final production art/audio, packaging and release.
ACCEPTANCE: parsed touch/drag with fallback/direct zero; opening through clear
and defeat/recovery flows; <=30s decision gaps; required viewport matrix;
20-30s motion recording; strict diagnostics/process cleanup zero.
COMMIT: complete source-bound evidence/status push.
```
### P9.8-STEP-7 H5 AND CLOSURE
```text
PLAYER OUTCOME: The Owner can test the complete first Contract from one cached
private landscape H5.
IN SCOPE: fresh runtime-only Web export, stable cache, one Gallery item,
source hashes, delivery record and durable closure.
OUT OF SCOPE: gameplay edits, native packaging, devices, stores and release.
ACCEPTANCE: exact source binding; tests/docs/evidence absent from PCK; remote
bytes/MIME/cache/304 pass; clean upstream repository and owned processes zero.
COMMIT: docs-only closure after immutable delivery.
```
## Issue Register
| ID | Status | Finding |
|---|---|---|
| P98-I01 | `RESOLVED_IN_CONTRACT` | Five more ordinary fights alone would not complete the product loop; Artifact, promotion, Boss Muster, boss recovery and persistent close are mandatory. |
| P98-I02 | `RESOLVED_IN_PLAN` | P9.7 state clamps at Round 7/Market 8. P9.8 composes a new versioned layer instead of silently weakening accepted invariants. |
| P98-I03 | `OPEN_FINAL_ART_AUDIO` | Existing rigs, palette variants and synthesized feedback remain temporary. Final profession/enemy art and music/SFX are outside this gameplay milestone. |
| P98-I04 | `OPEN_HUMAN` | Agent evidence cannot prove understanding, fun, visual acceptance or willingness to continue. |
| P98-I05 | `RESOLVED_AUTHORITY_FORWARD` | The activation draft accidentally assigned new effects to existing Artifact IDs. Contract r1 now binds `AR-001`, `AR-002` and `AR-007` to their canonical catalog rules before product implementation. |
## Current Evidence
- Baseline `dc5a74e` is clean and upstream-equal.
- Accepted P9.7 product source is `a77400a`.
- P9.7 formal evidence and Gallery item `pv90lquELNh_` remain immutable.
- Step 1 source `3a26827` adds 5 Market boards, 15 routes, 20 Recruit
candidates, 8 equipment rows, 3 canonical Artifacts, 20 reachable promotion
branches, all 12 Windglass ordinary/elite enemies and `BO-R1-01`.
- Fresh Git-archive evidence at `/private/tmp/abg-p98-3a26827-step1-r1/`
passes import, P9.8 content, P9.7 content and P9.7 settlement strict-clean.
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.