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

13 KiB

P10.0 Full Market And Company Core Implementation Plan

Status: ACTIVE Active step: P10.0-STEP-3 GROWTH, CASUALTY AND WAVE BATTLE Baseline: 2ea14f506ee730eab086963ee8ee0d7c4ccb419e Goal: docs/goals/PHASE10_0_FULL_MARKET_COMPANY_CORE_GOAL.md Contract: docs/runtime/PHASE10_0_FULL_MARKET_COMPANY_CORE_CONTRACT.md

Player-Visible Stopping Point

Replace phase-scripted Windglass play with one canonical engine that generates, prepares, fights, recovers and closes both Contracts through the complete Market/Company loop. RG-02 becomes visible but remains unplayable.

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

Ordered Steps

Step Status Player outcome Commit boundary
P10.0-STEP-0 Contract COMPLETE The full Market, Company, wave-battle and Region stopping point are frozen. Goal, contract, plan, checkpoint and ledger pushed.
P10.0-STEP-1 Catalog and board authority COMPLETE A reserved seed produces four provisional Recruits and every Market produces stable 3/4/3 offers from the real Windglass catalog. P10 registry/generator plus focused schema, seed and board tests.
P10.0-STEP-2 Market and Company transactions COMPLETE The player can hire, buy, sell, equip, lock, refresh, dismiss, deploy Reserve and reorder without partial state. Canonical state/service plus atomicity tests.
P10.0-STEP-3 Growth, casualty and wave battle IN_PROGRESS Levels, promotion, Artifacts, fixed waves and permanent Fallen outcomes create a changing Company. Growth/battle/casualty services plus counterfactual tests.
P10.0-STEP-4 Contracts, save and simulations PENDING Two Windglass Runs survive interruption and close to persistent RG-02 without a dominant policy. Save v6, bosses, close and five-profile simulation.
P10.0-STEP-5 Complete landscape runtime PENDING The canonical Region is playable from Title to RG-02 by direct world touch and drag. Controller/front-door integration, matrix, recording and regression evidence.
P10.0-STEP-6 H5 and closure PENDING One fresh cached H5 exposes the canonical full-Market Region. Runtime-only export, Gallery delivery and docs closure.

Step Contracts

P10.0-STEP-1 CATALOG AND BOARD AUTHORITY

ID: P10.0-STEP-1
PLAYER OUTCOME: A Run seed creates four stable provisional Recruits, and each
  Market exposes three Recruit, four equipment and three risk offers from the
  real catalog without reload rerolls.
IN SCOPE: P10 content registry; 12 base/24 advanced Professions; 36 Traits;
  EQ-001..040; AR-001..008; EN-R1-01..12; two Boss descriptors; deterministic
  Recruit generation; Contract descriptors; stable board generation; schemas.
OUT OF SCOPE: state mutation, prices, purchases, battle execution, saves,
  runtime UI, new media and later Regions.
OWNED FILES: runtime/p10_0/content_registry.gd plus UID;
  runtime/p10_0/offer_generator.gd plus UID; focused Step-1 tests plus UIDs;
  durable status after focused source commit.
ACCEPTANCE CHECKS: exact counts and unique IDs; descendant/trait/item/enemy/
  boss references resolve; no filler-equivalent signatures; four draft rows;
  every Market 3/4/3; risks 0/1/2; seed labels independent; same inputs byte
  identical; changed seed/Market/refresh changes only owned draws; malformed
  authority rejects; P9.10 regressions unchanged.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/test push, then docs-only step closure.
LEGAL TERMINAL: P10.0 Step 1 catalog and board authority complete.
NEXT STEP: P10.0-STEP-2.

P10.0-STEP-2 MARKET AND COMPANY TRANSACTIONS

ID: P10.0-STEP-2
PLAYER OUTCOME: One stable Market supports the full budget, roster, Reserve and
  order decisions without hidden or partial mutation.
IN SCOPE: canonical Run/Market state and service; draft commit; prices; Coin;
  Credit; lock/unlock/refresh; hire; buy/sell/equip; dismiss; deploy/Reserve;
  reorder; operation receipts and atomicity tests.
OUT OF SCOPE: XP/promotion, battle execution, persistence and runtime UI.
OWNED FILES: runtime/p10_0 state/service modules plus UIDs; focused tests plus
  UIDs; durable status.
ACCEPTANCE CHECKS: exact board counts and prices; capacity 4..10; one equipment
  slot; final dismissal rejected; automatic formation proposal; legal Reserve;
  every success +1 revision; every rejection preserves all fields; duplicate
  same intent returns receipt; mismatched intent rejects.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/test push, then docs-only step closure.
LEGAL TERMINAL: P10.0 Step 2 Market and Company transactions complete.
NEXT STEP: P10.0-STEP-3.

P10.0-STEP-3 GROWTH, CASUALTY AND WAVE BATTLE

ID: P10.0-STEP-3
PLAYER OUTCOME: The prepared Company visibly resolves fixed waves, grows,
  promotes and permanently changes when a Recruit falls.
IN SCOPE: XP/levels; two-branch promotion; Artifact choice; fixed-tick waves;
  Profession/Trait/item execution; casualties; equipment return; Credit;
  reward drafts; ordinary recovery; counterfactuals.
OUT OF SCOPE: bosses, full save, runtime presentation and H5.
OWNED FILES: runtime/p10_0 growth/battle/casualty modules plus UIDs; fixtures
  and focused tests plus UIDs; durable status.
ACCEPTANCE CHECKS: deterministic events; 2-4 waves; no battle >150s; Reserve
  never auto-enters; Fallen never returns; equipment returns; Credit bounded;
  level cap 10; exact descendants only; first decisive cause retained; no
  universal Profession/Trait/item/order policy across fixed fixtures.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/test push, then docs-only step closure.
LEGAL TERMINAL: P10.0 Step 3 growth, casualty and wave battle complete.
NEXT STEP: P10.0-STEP-4.

P10.0-STEP-4 CONTRACTS, SAVE AND SIMULATIONS

ID: P10.0-STEP-4
PLAYER OUTCOME: Both Windglass Contracts recover, close and persist without
  rerolls, duplicate rewards or permanent-stat grinding.
IN SCOPE: two Bosses; Muster/recovery; Contract/Region close; Guild handoff;
  Save v6; profile migration; five profiles; solvency and anti-dominance.
OUT OF SCOPE: runtime UI, final media, H5 and later Regions.
OWNED FILES: runtime/p10_0 boss/contract/save modules plus UIDs; simulations
  and focused tests plus UIDs; durable status.
ACCEPTANCE CHECKS: both bosses and recoveries; exact first-clear facts/Renown/
  Records once; corruption/backup/rollback/interruption; zero offline value;
  five profiles complete within bounds; every required operation and content
  family reachable; at least two rational policies per declared fork.
EVIDENCE LEVEL EXPECTED: simulation_verified.
COMMIT BOUNDARY: focused source/test push, then docs-only step closure.
LEGAL TERMINAL: P10.0 Step 4 Contracts, save and simulations complete.
NEXT STEP: P10.0-STEP-5.

P10.0-STEP-5 COMPLETE LANDSCAPE RUNTIME

ID: P10.0-STEP-5
PLAYER OUTCOME: Title through RG-02 is one game-like landscape flow where
  Market preparation and continuous-wave consequences are directly playable.
IN SCOPE: P10 controller; front-door route; direct world targets; drag/tap
  alternatives; Market/Reserve/line; wave battle feedback; profiles; required
  viewports/locales/accessibility; 25-30 second representative recording.
OUT OF SCOPE: gameplay rule changes, final production media, H5 and release.
OWNED FILES: runtime/p10_0 runtime controller plus UID; bounded main handoff;
  runtime tests plus UIDs; durable status.
ACCEPTANCE CHECKS: parsed Touch/Drag only; fallback/direct zero; full required
  runtime states; Market not a card wall; small actors and continuous waves;
  signed feedback/Fallen removal/causal result; required matrix; <=30s evidence
  gaps; 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: P10.0 Step 5 canonical Region runtime complete.
NEXT STEP: P10.0-STEP-6.

P10.0-STEP-6 H5 AND CLOSURE

ID: P10.0-STEP-6
PLAYER OUTCOME: The canonical full-Market Windglass Region is available 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.
OWNED FILES: docs/runtime/p10_0/H5_DELIVERY.md and durable status only.
ACCEPTANCE CHECKS: exact source binding; tests/docs/evidence absent from PCK;
  remote bytes/MIME/cache/304 pass; clean upstream repository; processes zero.
EVIDENCE LEVEL EXPECTED: delivery transport verified; human gates remain open.
COMMIT BOUNDARY: docs-only closure after immutable delivery.
LEGAL TERMINAL: Aetherbound Guild P10.0 full Market and Company core candidate ready.
NEXT STEP: production presentation or RG-02 only through a new approved plan.

Issue Register

ID Status Finding
P100-I01 RESOLVED_IN_SCOPE Adding RG-02 before the Market/Company core would duplicate a scripted loop; P10.0 migrates only existing Windglass content to the canonical engine.
P100-I02 RESOLVED_IN_CONTRACT Continuous battle does not mean infinite respawn. Enemy waves are fixed and previewed; Fallen Recruits never respawn and Reserve never auto-enters.
P100-I03 IN_PROGRESS_STEP_3 Existing P9 modules are phase-specific. P10.0 now has isolated catalog, generated offers and atomic Run/Market/Company transactions; battle/growth extraction continues without changing main.gd before Step 5.
P100-I04 OPEN_MEDIA The complete Profession catalog does not yet have final unique production animation families. P10.0 may use role-family presentation, but final bulk media remains a later gated milestone.
P100-I05 RESOLVED_STEP_2 Windglass EQ-001..040 maps deterministic price tiers by contiguous ten-row buckets: 001..010 tier 0 through 031..040 tier 3. This makes the existing four-tier formula executable without implying power superiority.

Completed Step Evidence

P10.0 Step 1 Catalog And Board Authority - 2026-08-15

  • Source a603f8242a61b3aa946d16da4bb5f42bd7490fb5 adds only the P10.0 runtime catalog, read-only registry, offer generator, focused tests and their tracked UID files. Accepted P9 source and front-door runtime are unchanged.
  • The registry binds source SHA-256 fb99bcd75ca6308091fa56b45f8da551276a496a1f96acbb44225efe491fdfef and exposes 137 localized, tagged and uniquely signed rows: 12 base plus 24 advanced Professions, 36 Traits, 40 equipment, eight Artifacts, 12 enemies, two Bosses, one Region and two ordered Contracts.
  • One applied seed reservation produces four complete provisional Recruit records. Both Contracts expose 12 deterministic Markets with exact 3/4/3 boards and risks 0/1/2. Refresh changes Recruit/equipment draws only; presentation revision cannot reroll combat fields.
  • Fresh fixed-source R2 evidence is /private/tmp/abg-p100-a603f82-step1-r2/. Both P10.0 tests and four P9.10 regression anchors pass with six exact markers and strict diagnostics zero. Its nine-row inventory SHA-256 is f03dc01d810eceafc9b8a293b58ab9f01cff1f28698f938fe591c2eda80099e1.
  • R1 remains append-only INVALID_EVIDENCE_METADATA; its tests are not reused for the Step 1 claim. Step 1 reaches automated_verified. Step 2 is active only for canonical Market/Company state and atomic transactions.

P10.0 Step 2 Market And Company Transactions - 2026-08-15

  • Source 506ca4b114450171e67dba04d23bcc925003eab4 adds only the isolated P10.0 Run state, Market service, three focused tests and five tracked UID files. Accepted P9 source, main.gd, battle, save and UI are unchanged.
  • Seed reservation, four-offer materialization, revisable unordered two-of-four selection and Run commit are distinct idempotent operations. Run creation transfers the exact two records into a 52-Coin, zero-Credit, capacity-four Market without a state containing both or neither draft and Run.
  • The Market supports formula-bound hire/Credit, buy/sell/equip/unequip, three paid locks, escalating refresh, Company/Reserve deployment, automatic order proposal, explicit reorder, legal dismissal and read-only battle preview plus immutable battle commit. Capacity is not a total roster cap.
  • All commits use operation ID, expected revision and exact price or prior identity. Applied operations add one revision; duplicate same intent returns its receipt; 25 rejection branches and two malformed restores preserve the complete public and internal snapshot.
  • Fresh fixed-source evidence is /private/tmp/abg-p100-506ca4b-step2-r1/. Five P10.0 and four P9.10 markers pass with strict diagnostics zero. Its 12-row inventory SHA-256 is a0eb158a847af838d6c44e12284ddcac19ca34f35a3c5154f8d0f149cdd432f3. Step 2 reaches automated_verified; Step 3 now owns growth, promotion, Artifacts, fixed waves and permanent casualty settlement only.