W62 — Platform Static Host specification

[The-Running-Dev]

Recovers a stash taken on feature/w61-public-web-demo before a remote reconciliation, so the W62 spec work isn't lost. Branched at the stash's own base rather than main, because applying it to current main conflicts in all eight tracked files — that's a design reconciliation (/reconcile), not something to resolve inside a recovery PR.

Not ready to merge. Two id collisions block integration:

• design/14-platform-static-host.md (added here) collides with design/14-game-interface.md, already on main. Numbering is positional, so resolving this means renumbering everything after and rewriting cross-links.
• No W61 conflict on this branch, but the sibling recovery branch (slice/W61-landing-page-package) reuses the W61 id for a different slice than main's.

Verified

• Not run. This PR only recovers stashed content onto a branch; /verify has not been run against it, and it has not been reconciled against main.

---

Agent detail

• Source: stash W62 Platform Static Host docs — preserved before remote reconciliation, applied at base 86dbce7
• Blocking: design/14 numbering collision with main's 14-game-interface.md
• Next step: /reconcile (fresh session, deep reasoning) to resolve numbering, then /verify

PR Summary by Qodo

W61/W62 specs: playable web demo and platform static host

📝 Documentation ⚙️ Configuration changes 🕐 40+ Minutes

AI Description

• Specify W61 playable web demo boundaries, client contract obligations, and acceptance evidence.
• Specify W62 Platform static host container delivery, CI smoke gates, and GHCR publish rules.
• Wire new specs into slice tracking and Docusaurus navigation/generated docs.

Diagram

graph TD
  D10["design/10-design.md"] --> GEN["/make-human-docs"] --> ENG["docs/docs/engine/*.md"]
  D10 --> PTR["design/13-14 stubs"]
  D10 --> SL["design/30-slices.md"] --> NAV["docs nav (sidebar/index/guide)"]
  SL --> PLAN["plans/49-w62-platform-static-host.md"]

Loading

High-Level Assessment

The following are alternative approaches to this PR:

1. Rebase onto main and resolve conflicts now

• ➕ Produces a merge-ready PR sooner
• ➕ Avoids long-lived branch divergence and renumbering drift
• ➖ Turns a recovery PR into a deep design reconciliation with broad renumbering/link churn
• ➖ Higher risk of accidental semantic edits while resolving positional ID collisions

2. Split into two PRs (W61 spec vs W62 spec)

• ➕ Smaller review units; clearer ownership per slice
• ➕ Potentially reduces conflict surface area if only one spec collides
• ➖ Cross-links between W61/W62 and Clients/TODO/slices still need coordinated updates
• ➖ Doesn't eliminate the design/14 positional-ID collision on its own

3. Immediately renumber docs to avoid collisions in this PR

• ➕ Removes the known design/14 collision early
• ➕ Lets follow-on work target stable IDs
• ➖ Large mechanical churn across cross-links and indexes; hard to review in a stash-recovery context
• ➖ Risky without running a dedicated reconciliation flow and link validation

Recommendation: Keep this PR as a recovery/draft snapshot and perform a dedicated reconciliation step to resolve positional ID collisions (including renumbering and link rewrites) before attempting integration. That aligns with the stated intent: preserve stashed W61/W62 spec work without turning the recovery into a large semantic merge conflict resolution.

Files changed (14) +1471 / -49

Documentation (13) +1469 / -49

CLAUDE.mdAdd W61/W62 spec entries to design-doc index +3/-1

Add W61/W62 spec entries to design-doc index

• Updates the design document table to include the new Playable Web Demo (W61) and Platform Static Host (W62) specs, and adjusts the client checklist counts to include the browser demo column.

CLAUDE.md

10-design.mdEmbed W61/W62 specs and expand Clients contract to cover browser demo +436/-20

Embed W61/W62 specs and expand Clients contract to cover browser demo

• Updates the Clients contract to Revision 2, adds a browser-demo column to the API coverage checklist, and documents the evidence expectations for W61. Appends full canonical specifications for Playable Web Demo (W61) and Platform Static Host (W62) as human-doc sections.

design/10-design.md

13-playable-web-demo.mdAdd compatibility-pointer stub for Playable Web Demo +27/-0

Add compatibility-pointer stub for Playable Web Demo

• Introduces a generated stub file that points readers to canonical content in design/10-design.md while preserving pre-migration links/anchors.

design/13-playable-web-demo.md

14-platform-static-host.mdAdd compatibility-pointer stub for Platform Static Host +23/-0

Add compatibility-pointer stub for Platform Static Host

• Introduces a generated stub file that points readers to canonical content in design/10-design.md while preserving pre-migration links/anchors.

design/14-platform-static-host.md

30-slices.mdDefine W61 and W62 slices with detailed acceptance criteria +140/-3

Define W61 and W62 slices with detailed acceptance criteria

• Replaces the generic 'More clients' placeholder with fully specified W61 (public playable web demo) and W62 (Platform static host image) slices, including dependencies, touched areas, and definition-of-done checklists. Adds a forward-looking W63 hosted-engine edge placeholder.

design/30-slices.md

TODO.mdRegister W61/W62 (and W63 placeholder) in design TODO index +6/-0

Register W61/W62 (and W63 placeholder) in design TODO index

• Adds headings for W61 and W62 under the Platform breadth section and introduces a W63 placeholder entry.

design/TODO.md

09-clients.mdUpdate generated Clients doc for browser-demo obligations +26/-17

Update generated Clients doc for browser-demo obligations

• Bumps document status to Revision 2, adds a browser-demo column to the API coverage checklist, and explains why the browser evidence remains unchecked until W61 implementation lands.

docs/docs/engine/09-clients.md

13-playable-web-demo.mdAdd generated W61 Playable Web Demo spec page +228/-0

Add generated W61 Playable Web Demo spec page

• Adds the generated documentation page describing the W61 browser demo scope, composition boundaries, portability requirements, checkpoint behavior, delivery constraints, tests, and non-goals.

docs/docs/engine/13-playable-web-demo.md

14-platform-static-host.mdAdd generated W62 Platform Static Host spec page +174/-0

Add generated W62 Platform Static Host spec page

• Adds the generated documentation page defining W62 container delivery via a product-owned ASP.NET host composed with Platform.Hosting, including CI smoke requirements, publication boundaries, and explicit non-goals.

docs/docs/engine/14-platform-static-host.md

TODO.mdPropagate W61/W62 slice definitions into generated engine TODO +140/-3

Propagate W61/W62 slice definitions into generated engine TODO

• Mirrors the W61 and W62 slice definitions (and W63 placeholder) into the generated documentation version of the TODO/slices content.

docs/docs/engine/TODO.md

guide.mdUpdate developer guide to mention W61/W62 planned delivery surfaces +60/-5

Update developer guide to mention W61/W62 planned delivery surfaces

• Refreshes the guide overview to position the engine as TypeScript-first with Node currently proven, and adds guidance sections summarizing W61 browser demo build constraints and W62 Platform static hosting constraints.

docs/docs/guide.md

index.mdAdd W61/W62 pages to engine docs index table +2/-0

Add W61/W62 pages to engine docs index table

• Extends the docs index to include links and one-line summaries for the new Playable Web Demo and Platform Static Host spec pages.

docs/docs/index.md

49-w62-platform-static-host.mdAdd W62 implementation plan and evidence matrix +204/-0

Add W62 implementation plan and evidence matrix

• Introduces a detailed execution plan for W62 covering artifact contract verification, minimal ASP.NET host composition, Docker multi-stage build, secret handling for private NuGet restore, CI smoke tests (including negative fixtures), and path-filtered GHCR publishing without deployment.

plans/49-w62-platform-static-host.md

Other (1) +2 / -0

sidebar.tsExpose W61/W62 spec pages in Docusaurus sidebar +2/-0

Expose W61/W62 spec pages in Docusaurus sidebar

• Adds the playable-web-demo and platform-static-host pages to the engine documentation sidebar ordering.

docs/sidebar.ts

[qodo-code-review]

Qodo Fixer

🍒 Ready to be cherry-picked — ✅ Merged (0) · ☑ Fixed (1)

🔗 Fix PR: #198

This fix PR was closed automatically. Its branch is preserved so you can cherry pick the changes into the original PR.

Prompt for coding agent

This is an automated fix prepared on a separate branch (#198). It is NOT applied to this PR.
To use it: review Fix PR #198 (https://github.com/The-Running-Dev/SubZeroDev.GameEngine/pull/198), evaluate each change critically against your local context, and cherry-pick the changes that are correct into this branch. Do not accept them blindly.

Process — 1 fixed

• ☑ Fixed: Ready title unresolvable
• ⏭ Skipped (1)