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

174 lines
9.2 KiB
Markdown

# P10.3 Siltwake Deep Channels Implementation Plan
> Status: `ACTIVE`
> Active step: `P10.3-STEP-2`
> 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
<!-- markdownlint-disable MD013 -->
| 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 | `IN_PROGRESS` | Artifact and promotion decisions survive interruption and reload exactly. | State, transactions, migration and persistence tests. |
| P10.3-STEP-3 Three-Round battle arc | `PENDING` | Artifact/promotion choices change which response is rational. | Battle, settlement and counterfactual tests. |
| P10.3-STEP-4 Continuous runtime | `PENDING` | 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. |
<!-- markdownlint-enable MD013 -->
## 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.
## Step Contracts
### P10.3-STEP-1 CONTENT AND BOARDS
```text
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
```text
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
```text
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: isolated P10.3 battle/settlement services 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.
```
### P10.3-STEP-4 CONTINUOUS RUNTIME
```text
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
```text
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
<!-- markdownlint-disable MD013 -->
| 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. |
<!-- markdownlint-enable MD013 -->