wushenghua/aetherbound-guild
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b45d6539cf685908196c5ec3cb4e389ce61c7e7f
aetherbound-guild/docs/runtime/p10_3/IMPLEMENTATION_PLAN.md
T

13 KiB
Raw Blame History

P10.3 Siltwake Deep Channels Implementation Plan

Status: ACTIVE Active step: P10.3-STEP-4 Planning baseline: ac3d511a2826d943322f03559a13801680ed3a92 Product predecessor: 96929580289504e8209b905132b3b40abc5a4c72 Goal: docs/goals/PHASE10_3_SILTWAKE_DEEP_CHANNELS_GOAL.md Contract: docs/runtime/PHASE10_3_SILTWAKE_DEEP_CHANNELS_CONTRACT.md

Player-Visible Stopping Point

Starting at the restored Market 5 ferry, the player clears Rounds 5-7, chooses one shared Artifact rule, may promote the first eligible Recruit and reloads at stable Market 8 with those decisions intact.

Ordered Steps

Step Status Player outcome Commit boundary
P10.3-STEP-0 Contract COMPLETE The three-Round growth scope and Market-8 stopping point are frozen. Goal, contract, plan, checkpoint and ledger.
P10.3-STEP-1 Content and boards COMPLETE Markets 5-7 disclose linked-position, safe-index and combined pressures. Source cf1e843; four fixed-source markers pass strict-clean.
P10.3-STEP-2 Save v9 and growth choices COMPLETE Artifact and promotion decisions survive interruption and reload exactly. Source 26ef043; eight fixed-source markers pass strict-clean.
P10.3-STEP-3 Three-Round battle arc COMPLETE Artifact/promotion choices change which response is rational. Source ffb813f; 12 fixed-source markers pass strict-clean.
P10.3-STEP-4 Continuous runtime IN_PROGRESS Parsed touch carries Market 5 through visible Market 8 transformation. Controller, touch, layout and recording evidence.
P10.3-STEP-5 Profiles and candidate PENDING Five policies prove pacing, anti-dominance, recovery and persistence. Simulations, matrix, regressions and immutable evidence.

Completed Step Evidence

P10.3 Step 1 Content And Boards - 2026-08-16

  • Source cf1e843b07006b9ba23e02de4fb2fbf1ff0bff61 adds only the isolated P10.3 catalog, validator, Market generator, two focused tests and their tracked UID files. P10.2 source remains byte-unchanged.
  • The registry exposes eight equipment, two new enemies, three Artifacts, nine routes and three Markets. All 24 bounded identities have zh_CN/en authority, previews, response tags, execution keys and deterministic signatures.
  • Markets 5-7 generate exact 3/4/3 boards with capacity 6/6/7, offer level 2/2/3, 15-Coin equipment and route rewards 30..48. Market 6 discloses the fixed three-Artifact draft; Market 7 discloses exact promotion eligibility.
  • Refresh changes Recruit/equipment rows only. Route, tide, Artifact and promotion facts never reroll, while a changed Run seed changes owned Market identities.
  • R1 at /private/tmp/abg-p103-cf1e843-step1-r1.c7k2hR/ is append-only INVALID_EVIDENCE_FINALIZATION because its postflight zero-process query stopped before inventory creation. No R1 execution result is reused.
  • Fresh fixed-source R2 is /private/tmp/abg-p103-cf1e843-step1-r2.hS70Pw/evidence/. Both P10.3 tests and both P10.2 regressions pass with strict diagnostics and owned Godot process counts zero. Source archive SHA-256 is 373e4e4b2a5c7e616dd6d3dd7a610ce41470217297498e90cb841439a90b50e1; the 12-row inventory SHA-256 is a4d46f3f1d0db3f7adcf868d8a1eddfdda713d26e20683f3d9d186c4c85b67cd.
  • Step 1 reaches automated_verified. Step 2 alone now owns Save v9 and the exact Artifact/promotion transaction boundary.

P10.3 Step 2 Save V9 And Growth Choices - 2026-08-16

  • Source 26ef043bfbcd2ddba103b985df5fcd124d91f6e1 adds 16 paths confined to isolated P10.3 Recruit/board/state/save/growth modules, two focused tests, one fixture and their tracked UID files.
  • Save v9 accepts only stable P10.2 Market 5, binds the real P10.3 board, advances sequence/previous-commit linkage and preserves Run, Company, Coin, HP, equipment, route history and legacy operation authority.
  • Active/backup selection, checksum, rollback, future schema, corrupt source, interrupted candidate and zero offline Coin/Credit/XP/Renown/healing/ticks are covered. Tampered Run binding, Market level and growth disclosure reject.
  • Artifact selection/defer/resume and promotion open/defer/confirm are revision-exact and idempotent. AR-011/012/015 expose effective capacities 6/8/7; the complete 12-by-2 regular Profession mapping is exact.
  • The canonical Kindhand draft is PF-A13/PF-A14. Confirming one branch preserves Recruit ID, origin, level/XP, exact HP, Trait, equipment, Company/Line/Reserve order and custom survival history.
  • Fresh fixed-source R1 is /private/tmp/abg-p103-26ef043-step2-r1.Fyc4Uy/evidence/. Four P10.3 tests and four P10.2 regressions pass with strict diagnostics and owned Godot process counts zero. Source archive SHA-256 is 69f148b3d0da78cd89ffe838237d84cc9350e26fa971256fc0b2ce66eb0e0e36; the 16-row inventory SHA-256 is 6d9f07e9cba52f3cb09a0ccf0c899272c5f3d4e4ef7ccbef6214794fe6e44e60.
  • Step 2 reaches automated_verified. Step 3 alone now owns the three-Round battle/settlement arc and opposed growth-choice consequences.

P10.3 Step 3 Three-Round Battle Arc - 2026-08-16

  • Source ffb813ff194e82eb19f773091cfbb5b6b9492329 adds exact-once P10.3 route preparation, deterministic battle and settlement services plus narrow prepared, recovery and market_8 Run-state invariants.
  • All nine routes have fixed preferred and wrong-plan outcomes across all four plans. Channel Widow and Sluice Elder expose linked-healing, adjacency, moving safe-index, Wet-threshold and direction-reversal events.
  • AR-011/012/015 each wins one fixed Round-7 comparison and loses another. PF-A14 is stronger on linked-care risk 1 while PF-A13 is stronger on moving-safe-index risk 2; neither branch is a flat universal upgrade.
  • Rounds 5-7 grant exact Coin 30/39/48 and XP 20/26/32, grow base capacity 6/7/7, create the Artifact draft after Round 6 and preserve the chosen Artifact plus promotion in a source-bound Save-v9 Market 8 handoff.
  • Defeat applies one permanent casualty, returns equipment, grants bounded Credit and supports exact-cost recovery without resurrection or automatic Reserve substitution. Battle snapshots are replay-validated before settle.
  • Fresh fixed-source R1 is /private/tmp/abg-p103-ffb813f-step3-r1.fPFMlH/evidence/. Six P10.3 tests and six P10.2 regressions pass with 12 exact markers, strict diagnostics zero and owned Godot process count zero. Source archive SHA-256 is f4bf6a00cb73ab88a3d58acb317a925fbbe5628817bd31b1f56f9f51b7a3919b; the 15-row inventory SHA-256 is d6b93495f0eb535c329aa3ef8f257d2a1a0df19f92708bf657c8608323b36b00.
  • Step 3 reaches automated_verified + simulation-ready domain. Step 4 alone now owns continuous runtime, touch, layout and recording presentation.

Step Contracts

P10.3-STEP-1 CONTENT AND BOARDS

ID: P10.3-STEP-1
PLAYER OUTCOME: Markets 5-7 truthfully preview linked-position, moving-safe-
  index and combined pressures before the player commits.
IN SCOPE: isolated P10.3 registry; EN-R2-11..12; EQ-057..064; AR-011/012/015;
  nine route rows; deterministic 3/4/3 boards; localized names/previews;
  formula, identity, reference, seed, hash and negative tests.
OUT OF SCOPE: state mutation, Save v9, Artifact/promotion transactions, battle,
  presentation, media, H5 and packaging.
OWNED FILES: runtime/p10_3 content/generator modules, focused tests and UIDs;
  durable closure after a pushed source commit.
ACCEPTANCE CHECKS: exact source IDs; same inputs byte-identical; Markets 5-7
  use levels 2/2/3, capacities 6/6/7 and Coin 30..48; refresh changes only
  Recruit/equipment rows; route/artifact facts never reroll; malformed source,
  IDs, counts, formulas and locale rows reject; P10.2 regressions pass.
EVIDENCE LEVEL EXPECTED: automated_verified for content authority.
COMMIT BOUNDARY: focused source/test push, fixed-source evidence, docs closure.
LEGAL TERMINAL: P10.3 Step 1 content and boards complete.
NEXT STEP: P10.3-STEP-2.

P10.3-STEP-2 SAVE V9 AND GROWTH CHOICES

ID: P10.3-STEP-2
PLAYER OUTCOME: The first shared run rule and Profession branch are explicit,
  reversible before confirm where allowed, and trustworthy after restart.
IN SCOPE: Save-v8-to-v9 migration; Markets 5-7 state; Artifact draft/select/
  defer; promotion eligibility/draft/confirm/defer; exact transaction receipts.
OUT OF SCOPE: battle execution, runtime presentation, media and H5.
OWNED FILES: isolated P10.3 state/Market/save/growth services and tests.
ACCEPTANCE CHECKS: exact migration; full success/negative atomicity; stable
  drafts; conflict and duplicate protection; all 12 base parent mappings;
  preservation of Recruit identity/condition/item/order; zero offline value.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/test push, fixed-source evidence, docs closure.
LEGAL TERMINAL: P10.3 Step 2 Save v9 and growth choices complete.
NEXT STEP: P10.3-STEP-3.

P10.3-STEP-3 THREE-ROUND BATTLE ARC

ID: P10.3-STEP-3
PLAYER OUTCOME: Artifact and promotion choices change how the Company answers
  deep-channel pressure rather than acting as flat upgrades.
IN SCOPE: Rounds 5-7; Widow/Sluice events; Artifact rules; promotion branch
  events; Coin/XP/casualty/recovery/capacity and stable Market-8 settlement.
OUT OF SCOPE: Round 8+, Bosses, hidden hybrids, presentation and H5.
OWNED FILES: narrow P10.3 Run-state phase/handoff invariants; isolated route
  preparation, battle and settlement services; P10.3 fixture and focused tests.
ACCEPTANCE CHECKS: nine bounded routes; fixed preferred/wrong outcomes;
  opposed Artifact/promotion comparisons; exact rewards/capacity/Market 8;
  permanent casualty and no-resurrection recovery; interruption-safe receipts.
EVIDENCE LEVEL EXPECTED: automated_verified plus simulation-ready domain.
COMMIT BOUNDARY: focused source/test push, fixed-source evidence, docs closure.
LEGAL TERMINAL: P10.3 Step 3 deep-channel battle arc complete.
NEXT STEP: P10.3-STEP-4.

Step-3 product ownership is limited to:

  • runtime/p10_3/run_state.gd for prepared, recovery and stable market_8 invariants only;
  • new P10.3 route-preparation, battle and settlement services plus tracked UID files;
  • runtime/tests/p10_3/deep_channels_fixture.gd and two focused Step-3 tests plus tracked UID files.

P10.2 source, P10.3 catalog/Market generation/Save-v9/growth transaction authority, controllers, scenes, presentation, media, H5 and delivery remain forbidden in Step 3.

P10.3-STEP-4 CONTINUOUS RUNTIME

ID: P10.3-STEP-4
PLAYER OUTCOME: The player sees the ferry become a rule-selection and promotion
  workspace, then sees those choices alter battle and Market 8.
IN SCOPE: world targets; Artifact shrine; promotion anvil; linked/safe-index
  events; capacity and Market-8 presentation; parsed touch/drag; normal renders.
OUT OF SCOPE: new paid media, H5, native package and release.
OWNED FILES: isolated P10.3 controller/presentation, narrow handoff and tests.
ACCEPTANCE CHECKS: controls >=48px; no card wall; parsed touch/drag only;
  causal event motion; visible rule/branch consequence; required layouts,
  locales, accessibility and fixed 15-30 second recording pass strict-clean.
EVIDENCE LEVEL EXPECTED: runtime_verified and agent_visual_reviewed.
COMMIT BOUNDARY: focused source/test push, immutable evidence, docs closure.
LEGAL TERMINAL: P10.3 Step 4 continuous runtime complete.
NEXT STEP: P10.3-STEP-5.

P10.3-STEP-5 PROFILES AND CANDIDATE

ID: P10.3-STEP-5
PLAYER OUTCOME: The new run rules remain strategically variable, recoverable
  and persistence-safe across profiles and mobile layouts.
IN SCOPE: five policies; timestamps; anti-dominance; recovery/starvation;
  Save-v9 phase matrix; layout/accessibility matrix; immutable evidence.
OUT OF SCOPE: product changes unless a declared gate finds a product failure;
  H5, devices, package, store and release.
OWNED FILES: bounded simulation/matrix tests and UIDs; evidence; closure docs.
ACCEPTANCE CHECKS: five distinct policies, maximum nonbattle gap <=12 seconds,
  all routes/rules/branches covered, stable Market 8, no negative Coin,
  resurrection/offline reward, strict diagnostics, clean/upstream and cleanup.
EVIDENCE LEVEL EXPECTED: simulation_verified plus runtime_verified.
COMMIT BOUNDARY: focused verification source, immutable evidence, docs closure.
LEGAL TERMINAL: Aetherbound Guild P10.3 Siltwake deep channels candidate ready.
NEXT STEP: Owner review or a separately activated milestone.

Issue Register

ID Status Finding
P103-I01 RESOLVED_IN_CONTRACT Product authority requires an Artifact by the end of Round 6; the fixed draft is AR-011/012/015 and applies from Market 7.
P103-I02 RESOLVED_IN_CONTRACT Market-5 baseline has no eligible promotion; Round-6 growth opens the first level-4 survivor draft at Market 7.
P103-I03 OPEN_STEP_3 Artifact and promotion effects must reverse at least two route valuations instead of adding universal score.
P103-I04 OPEN_FINAL_MEDIA Existing rigs remain temporary; new media is frozen until the complete rule-choice runtime proves composition and motion.
Reference in New Issue View Git Blame Copy Permalink