aetherbound-guild/docs/runtime/p9_10/IMPLEMENTATION_PLAN.md

P9.10 Gale Loom And Second Contract Implementation Plan

Status: ACTIVE Active step: P9.10-STEP-3 COMPLETE RUNTIME Baseline: 8b19c7133d57b85b695b0c9362259b69afffdb56 Goal: docs/goals/PHASE9_10_GALE_LOOM_SECOND_CONTRACT_GOAL.md Contract: docs/runtime/PHASE9_10_GALE_LOOM_SECOND_CONTRACT_CONTRACT.md

Player-Visible Stopping Point

Continue from exact P9.9 Market 4, grow the Company through Rounds 4-12, confront and recover against the Gale Loom, then persist the second Windglass clear, 18 Renown, one Company Record and visible RG-02 unlock.

Internal steps are verified, committed and pushed without pausing for routine authorization. No H5 is published before Step 4 closes.

Ordered Steps

Step	Status	Player outcome	Commit boundary
P9.10-STEP-0 Contract	COMPLETE	Second-Contract completion, Boss and persistent terminal are frozen.	Goal, contract, plan, checkpoint and ledger pushed.
P9.10-STEP-1 Continuation authority	COMPLETE	P9.9 Market 4 loads into nine authored Markets with Company/equipment growth and reaches one stable Boss Muster.	Source c79ae82; 27-route matrix, Save v5 and four P9.9 regressions pass.
P9.10-STEP-2 Gale Loom and close	COMPLETE	Both Boss plans, viable recovery and exactly-once persistent RG-02 unlock work.	Source df3e742; 12 focused/regression markers and strict diagnostics pass.
P9.10-STEP-3 Complete runtime	IN_PROGRESS	The full continuation is playable and readable by parsed touch.	Controller/main handoff, five profiles, layout, recording and regressions.
P9.10-STEP-4 Evidence, H5 and closure	PENDING	One source-bound cached H5 exposes the complete second Contract.	Formal evidence, runtime-only export, Gallery delivery and docs closure.

Step Contracts

P9.10-STEP-1 CONTINUATION AUTHORITY

ID: P9.10-STEP-1
PLAYER OUTCOME: The saved Market 4 truthfully continues through nine distinct
  route decisions, optional Company/equipment growth and one stable Boss Muster.
IN SCOPE: P9.10 content; exact P9.9 carry-in; Markets/Rounds 4-12; 27 routes;
  bounded Recruit/equipment offers; one-slot equipment; capacity curve; final
  reorder; ordinary defeat/recovery; save-v5 migration; focused tests.
OUT OF SCOPE: Boss execution, persistent close, runtime presentation and H5.
OWNED FILES: runtime/content/p9_10_content.gd plus UID; runtime/p9_10 contract,
  service and save modules plus UIDs; runtime/tests/p9_10 continuation tests
  plus UIDs; durable status.
ACCEPTANCE CHECKS: exact Market-4 migration; route/board/content validation;
  capacity 5->10 at exact clears; optional legal hires; one-slot replacement;
  formation and final reorder; 9 victories reach stable Gale Loom Muster;
  stale/duplicate/insufficient/interruption boundaries preserve snapshots;
  affected P9.9 regressions pass unchanged.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/test push, then docs-only step closure.
LEGAL TERMINAL: P9.10 Step 1 continuation authority complete.
NEXT STEP: P9.10-STEP-2.

P9.10-STEP-2 GALE LOOM AND CLOSE

ID: P9.10-STEP-2
PLAYER OUTCOME: The Company can read, fight, recover from and defeat the Gale
  Loom, then receive a persistent second-clear result.
IN SCOPE: Boss state/service; plans; spindle reversal; opposite gust phase;
  timeout/defeat; 16-Coin recovery; pending close; +18 Renown; Company Record;
  RG-02 unlock; persistence and focused tests.
OUT OF SCOPE: runtime UI, final art/audio, RG-02 gameplay and H5.
OWNED FILES: runtime/p9_10 Boss/close modules plus UIDs; P9.10 content additions;
  P9.10 Boss/close/persistence tests plus UIDs; durable status.
ACCEPTANCE CHECKS: both plans rational and deterministic; phase transition;
  same-Muster recovery; pre-Boss casualty preserved; insufficient/nonviable
  rejection; exact clear/Renown/Record once; interruption and duplicate safety;
  affected continuation/P9.9 regressions pass.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/test push, then docs-only step closure.
LEGAL TERMINAL: P9.10 Step 2 Gale Loom and close complete.
NEXT STEP: P9.10-STEP-3.

P9.10-STEP-3 COMPLETE RUNTIME

ID: P9.10-STEP-3
PLAYER OUTCOME: Market 4 through persistent RG-02 unlock is one readable,
  game-like landscape flow with visible automatic work and consequences.
IN SCOPE: P9.10 runtime controller/main handoff; direct world targets;
  battle/Boss feedback; parsed touch/drag; five profiles; viewport/localization/
  accessibility fixtures; one 25-30 second recording; affected regressions.
OUT OF SCOPE: gameplay rule changes, H5, final production art/audio and release.
OWNED FILES: runtime/p9_10/runtime_controller.gd plus UID; runtime/main.gd;
  focused P9.10 runtime/profile/layout/recording tests plus UIDs; durable status.
ACCEPTANCE CHECKS: exact carry-in; hires/equipment/routes/Boss/close by touch;
  Touch/Drag parsed, fallback/direct zero; five profiles and <=30s gaps; required
  matrix; visible gust/spindle/phase/damage/reward; strict diagnostics and owned
  cleanup zero.
EVIDENCE LEVEL EXPECTED: runtime_verified and agent_visual_reviewed.
COMMIT BOUNDARY: complete source-bound evidence/status push.
LEGAL TERMINAL: P9.10 Step 3 runtime complete.
NEXT STEP: P9.10-STEP-4.

P9.10-STEP-4 EVIDENCE, H5 AND CLOSURE

ID: P9.10-STEP-4
PLAYER OUTCOME: The Owner can play the complete second Contract from one cached
  private landscape H5.
IN SCOPE: formal source-bound evidence; 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.
OWNED FILES: docs/runtime/p9_10/H5_DELIVERY.md and durable status only after
  evidence source freezes.
ACCEPTANCE CHECKS: exact source binding; full declared markers and recording;
  tests/docs/evidence absent from PCK; remote bytes/MIME/cache/304 pass; clean
  upstream repository and owned processes zero.
EVIDENCE LEVEL EXPECTED: delivery transport verified; human gates remain open.
COMMIT BOUNDARY: docs-only closure after immutable delivery.
LEGAL TERMINAL: Aetherbound Guild P9.10 Gale Loom and second Contract candidate ready.
NEXT STEP: Owner play and ranked issue intake.

Issue Register

ID	Status	Finding
P910-I01	RESOLVED_IN_CONTRACT	P9.9 intentionally locks at Market 4; P9.10 converts only that exact state copy-first and never edits P9.9 authority.
P910-I02	RESOLVED_IN_CONTRACT	The commercial catalog already defines Gale Loom as BO-R1-02; P9.10 instantiates its gust/spindle grammar without copying reference expression.
P910-I03	OPEN_IMPLEMENTATION	Nine more Markets can become repetitive; each Round must add or synthesize a readable pressure and preserve a state-dependent Company/equipment response.
P910-I04	OPEN_HUMAN	Automation cannot prove that nine Rounds feel varied, the Boss is readable or the second clear motivates RG-02 continuation.

Step 1 Evidence

• Source c79ae82946b3df35e2e05b63a28542fc21834776 adds an isolated P9.10 continuation layer and leaves P9.9 source unchanged.
• Ten stable Recruit offers, six one-slot equipment offers, nine Markets and 27 route rows validate. Every route executes a settleable automatic battle; nine distinct mechanic IDs produce 164 authoritative gust events across the fixed matrix.
• Exact P9.9 Market 4 migrates copy-first. Optional hires grow the Company from four to nine while capacity follows 5/6/6/7/7/8/8/9/9/10; equipment replacement retains the prior instance and one equipped slot per Recruit.
• Final order proposal/confirmation and nine victories produce one stable capacity-ten Gale Loom Muster. Ordinary six-Coin defeat recovery is idempotent.
• Save v5 covers exact v4 migration, Market/Encounter round trips, interruption to the decision checkpoint, backup recovery, malformed/checksum rejection, rollback and zero offline value.
• Fresh source-bound evidence is /private/tmp/abg-p910-c79ae82-step1-r1/. Three P9.10 tests and four P9.9 regressions pass strict-clean; its 14-row inventory SHA-256 is 92b0dc9cb391147de2d0e23adcca3467d8ddbe2ac21af95c592642e3767a97d3.
• Step 1 is automated_verified. Step 2 now owns only Gale Loom execution, Boss recovery, persistent second close and affected persistence/regressions.

Step 2 Evidence

• Source df3e742f8d3a94f6c7638ae113afa83b960034a3 adds isolated Boss state/battle/close modules and extends Save v5 without modifying P9.3-P9.9.
• Both plans win deterministically with state-dependent value. A projectile Company clears in 130 ticks with break_spindle versus 151 with hold_line; a non-projectile Company clears in 131 with hold_line versus 202 with break_spindle.
• Muster preview, spindle reversal, both enemy footprints, short core window, order movement, rear pressure, half-vitality opposed gusts, timeout and same-Muster back/reload/recovery all have focused assertions.
• Boss recovery costs exactly 16 Coin, restores only the pre-Boss living HP checkpoint and rejects insufficient/nonviable cases without partial state.
• Pending close, atomic prior-or-result save recovery, checksum-valid authority drift, exactly-once 18 Renown, twelve-settlement Company Record and RG-02 unlock pass across reload and duplicate operations.
• Immutable R2 evidence is /private/tmp/abg-p910-df3e742-step2-r2/. Twelve P9.10/P9.9/P9.8/P9.7 markers pass once with strict diagnostics and owned-process cleanup zero. Inventory SHA-256 is 04ceb7e9abc2304981d32d2c0de331f7a88c9aa34513cdab0edd4a65434e5985.
• R1 remains INVALID_EVIDENCE_HARNESS and is not reused; its terminal hash is e54df4b46e446d480e4e685d5fd5a047675662cfd09c4a4652638f64916255e3.
• Step 2 is automated_verified. Step 3 now owns only runtime presentation, parsed mobile input, profiles, layouts, recording and affected regressions.