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

P10.0R1 Web Touch Activation Implementation Plan

Status: COMPLETE Active step: NONE - OWNER PHONE TOUCH REVIEW Baseline: 4507ad5dfe791528209a1a7a4edade1cc67fd383 Goal: docs/goals/PHASE10_0R1_WEB_TOUCH_ACTIVATION_GOAL.md Contract: docs/runtime/PHASE10_0R1_WEB_TOUCH_ACTIVATION_CONTRACT.md

Ordered Steps

Step	Status	Player outcome	Commit boundary
P10.0R1-STEP-0 Contract	COMPLETE	The Owner's inert start action is isolated from transport and gameplay.	Goal, contract, plan, checkpoint and ledger.
P10.0R1-STEP-1 Raw touch routing	COMPLETE	A phone touch activates the same visible Button once without mouse emulation.	P10 controller plus focused raw-touch test.
P10.0R1-STEP-2 Regression and runtime proof	COMPLETE	Start, draft, Company and drag work without duplicate commands.	Focused P10/P9 tests and normal-render proof.
P10.0R1-STEP-3 Replacement H5	COMPLETE	One new private H5 carries the repair and is ready for Owner phone review.	Runtime-only export, new Gallery item and closure docs.

Step 1 Contract

ID: P10.0R1-STEP-1
PLAYER OUTCOME: Tapping New Expedition once opens the four-Recruit draft.
IN SCOPE: P10 raw ScreenTouch/Button routing; drag exclusion; persistence status;
  focused raw-touch and first-save tests.
OUT OF SCOPE: gameplay, content, balance, presentation redesign and delivery.
OWNED FILES: runtime/p10_0/runtime_controller.gd; bounded P10.0 tests and UIDs;
  durable repair status.
ACCEPTANCE CHECKS: emulation-off raw touch; exact once; disabled/outside no-op;
  drag no tap; mouse remains functional; persistence-on transition/reload.
EVIDENCE LEVEL EXPECTED: automated_verified.
COMMIT BOUNDARY: focused source/tests pushed before Web export.
LEGAL TERMINAL: P10.0R1 Step 1 raw touch routing complete.
NEXT STEP: P10.0R1-STEP-2.

Frozen Scope

P10 gameplay authority, save version, art/audio, P9 source, later Regions, native packaging, devices, stores and release remain frozen.

Step 1 Result

• Source 16bad76767d93bc52b94c5a47eeac3d936526c03 is pushed and upstream-equal. Its five owned paths are the P10 runtime controller, raw-touch and MouseButton tests, and their tracked UID files.
• Raw ScreenTouch owns the topmost live enabled Button, emits its existing pressed signal once on a same-target release, and rejects disabled, canceled, outside, covered and dragged releases. Owned touch temporarily blocks the paired synthesized mouse event; ordinary MouseButton remains functional without touch emulation.
• The start transition persists its four-offer draft through a configurable test save path. A write failure retains the visible Opening transition and exposes p100_opening_save_failed instead of appearing inert.
• Fresh Git-archive evidence is /private/tmp/abg-p100r1-16bad76-step1-r1/. Startup-disabled raw touch and direct mouse, default emulation mouse, the P10 front door and the full Market/battle touch path pass with strict diagnostics zero. The ten-row inventory SHA-256 is cac35e36b4a515f7f257ffe5b6e3896c025814ac496d1857d01e724e92235b82.

Step 2 Contract

ID: P10.0R1-STEP-2
PLAYER OUTCOME: Start, draft, Company, Settings and line drag remain visibly
  responsive with no duplicate command under the production input settings.
IN SCOPE: all 18 P10.0 test programs; all 10 P9.10 regression programs; one
  fresh normal-GPU 13-state landscape/layout capture run; strict diagnostics.
OUT OF SCOPE: gameplay/content/economy/save schema/media changes, new motion
  production, H5 export, Gallery publication and native delivery.
OWNED FILES: no product files unless the fixed source exposes a regression;
  bounded P10 input tests and durable repair status only.
ACCEPTANCE CHECKS: 28/28 exact functional markers; Touch/Drag counts unchanged;
  fallback/direct zero where declared; 13/13 normal frames; no script, parse,
  resource, import, ObjectDB or cleanup diagnostics; clean/upstream Git.
EVIDENCE LEVEL EXPECTED: runtime_verified supporting evidence; physical phone
  touch remains Owner-only.
COMMIT BOUNDARY: source-bound evidence recorded and status pushed before Web
  export.
LEGAL TERMINAL: P10.0R1 Step 2 regression and runtime proof complete.
NEXT STEP: P10.0R1-STEP-3.

Step 2 Result

• Product source remains exact pushed 16bad76767d93bc52b94c5a47eeac3d936526c03; no repair was required after Step 1.
• Fresh Git-archive evidence is /private/tmp/abg-p100r1-16bad76-step2-r1/. All 18 P10.0 programs and all 10 frozen P9.10 regressions pass with 28 exact markers and strict diagnostics zero.
• A quiet-window normal-GPU run generated 13/13 frames across four viewports, both locales, 130% text and accessibility variants. Agent review confirms the Title, Opening, Market, battle, recovery, Settings and terminal states remain populated and bounded.
• The 52-row evidence inventory SHA-256 is 019776f8a756aa0d5a7892b54858da51f27a6734aed03fb1a8e24f9907ef9ef5.

Step 3 Contract

ID: P10.0R1-STEP-3
PLAYER OUTCOME: One new private H5 carries the raw-touch repair and is ready for
  the Owner to confirm that New Expedition shows the four-Recruit draft.
IN SCOPE: fresh runtime-only Web export from source 16bad76; exclusion of tests,
  docs and evidence; one new private Gallery item; bytes/MIME/cache/ETag/304
  checks; durable delivery closure.
OUT OF SCOPE: product changes, old-item overwrite, native packaging, device
  install, TestFlight, stores, publishing and any other game.
OWNED FILES: P10.0R1 delivery record, Goal/checkpoint/plan/ledger closure only.
ACCEPTANCE CHECKS: fresh import/export strict-clean; runtime PCK contains the
  P10 controller and excludes tests/docs/evidence; new Gallery preserves every
  exported byte and serves the signed entry plus deterministic cache behavior.
EVIDENCE LEVEL EXPECTED: delivery transport verified; real phone touch remains
  Owner acceptance.
COMMIT BOUNDARY: delivery facts and final legal terminal pushed after remote
  verification.
LEGAL TERMINAL: Aetherbound Guild P10.0R1 Web touch activation candidate ready.
NEXT STEP: Owner phone tap review.

Step 3 Result

• Web R1 is retained INVALID_ENVIRONMENT: the isolated HOME did not expose the installed Godot 4.6.1 Web templates, so it produced no export judgment.
• Fresh Web R2 at /private/tmp/abg-p100r1-16bad76-web-r2/ uses a read-only installed-template link and exact product source 16bad76. All 249 test files were inventoried then removed only from the archive copy.
• The nine-file export contains 360 PCK paths, all 11 required P10 modules and zero test/docs/evidence/build paths. Import, export and PCK diagnostics are zero. Export manifest SHA-256 is 7e34345a256db67fb1b9b2b430bf61046ab1ce6e3cc425ea66931f533b239164; 19-row Web evidence inventory SHA-256 is ad0eb6fa7961dedb1868c4564828d525bf829d65c03586891bba524888f3a5eb.
• New private Gallery item N3jW9rjO3CUb preserves 9/9 bytes, serves health and signed entry with HTTP 200, provides four deterministic gzip forms and returns nine bodyless conditional 304 responses. Gallery evidence at /private/tmp/abg-p100r1-16bad76-gallery-r1/ has inventory SHA-256 3bbd3a027d22733a5bb518d0a6dfe3a3c65a61778ee9cf014b744133c167ee00.
• P10.0R1 reaches runtime_verified + agent_visual_reviewed + delivery transport verified. Physical phone touch, comprehension, fun, listening, native devices, stores and release remain open.