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

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

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

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

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

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

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

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.

9.0 KiB Raw Blame History