Build Sample A server containerization artifacts and update Track U roadmap states without engine-core changes.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -6,10 +6,18 @@ Create BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
 
 Requirements:
 - Follow PLAN_PR + BUILD_PR + APPLY_PR
-- Docs-first
+- This is code/runtime work, not documentation-only work
+- Use the BUILD doc as the exact blueprint
 - One PR per purpose
 - No engine core changes
-- Keep scope to server containerization only
-- Produce repo-structured delta zip to <project folder>/tmp/
-- Update docs/roadmaps/* with bracket-only edits only
-- Keep dashboard/network debug architecture intact
+- Keep scope to Sample A server containerization only
+- Create/update:
+  - games/network_sample_a/server/Dockerfile
+  - games/network_sample_a/.dockerignore
+  - games/network_sample_a/server/docker-compose.yml
+  - games/network_sample_a/server/README.md
+  - games/network_sample_a/server/networkSampleADashboardServer.mjs only if required for env-safe host/access compatibility
+- Update docs/roadmaps/NETWORK_SAMPLES_PLAN.md with bracket-only edits only
+- Do not overwrite BIG_PICTURE_ROADMAP.md
+- Do not overwrite PRODUCTIZATION_ROADMAP.md
+- Package repo-structured delta zip to <project folder>/tmp/BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Build BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION docs bundle with containerization-only scope, bracket-only Track U roadmap updates, no engine-core changes, and packaged delta zip output.
+Build Sample A server containerization artifacts and update Track U roadmap states without engine-core changes.

docs/dev/reports/change_summary.txt

@@ -3,18 +3,33 @@
 ## Bundle
 BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION_delta
 
-## Included
-- BUILD PR doc refinement for minimal server containerization
-- Docs-first command/control/report updates under `docs/dev`
-- Roadmap tracker update in `docs/roadmaps/NETWORK_SAMPLES_PLAN.md` using bracket-only edits
-- No engine-core or runtime implementation changes
+## Runtime Work Applied
+- Updated `games/network_sample_a/.dockerignore` to a strict allowlist pattern aligned with Dockerfile copy paths.
+- Updated `games/network_sample_a/server/README.md` with explicit stdout/stderr-only logging expectation.
+- Kept existing Sample A server runtime/container files aligned to the BUILD blueprint without broad refactors.
 
-## Roadmap Delta (Bracket-Only)
-- Track U `Compose-ready service definition`: `[ ]` -> `[.]`
-- Track U `Port mapping rules`: `[ ]` -> `[.]`
-- Track U `Health/readiness check`: `[ ]` -> `[.]`
-- Track U `Logging/output expectations`: `[ ]` -> `[.]`
-- Track U `Container debug notes`: `[ ]` -> `[.]`
+## Roadmap Update (Bracket-Only)
+- `docs/roadmaps/NETWORK_SAMPLES_PLAN.md` Track U items set to `[x]`:
+  - Dockerfile for server
+  - .dockerignore
+  - Environment variable contract
+  - Local run command
+  - Compose-ready service definition
+  - Port mapping rules
+  - Health/readiness check
+  - Logging/output expectations
+  - Container debug notes
 
-## Intent
-Deliver a docs-first BUILD handoff for server containerization while preserving dashboard/network debug architecture boundaries.
+## Guardrails Confirmed
+- No engine core changes
+- Scope limited to Sample A server containerization
+- No overwrite of `BIG_PICTURE_ROADMAP.md`
+- No overwrite of `PRODUCTIZATION_ROADMAP.md`
+
+## Validation Highlights
+- `node --check games/network_sample_a/server/networkSampleADashboardServer.mjs` passed.
+- Local smoke run passed:
+  - `/admin/network-sample-a/health` returned 200
+  - `/admin/network-sample-a/api/metrics?key=sample-a-admin` returned 200
+  - unauthenticated `/admin/network-sample-a/api/metrics` returned 403
+- Docker CLI is unavailable in this environment, so image build validation could not be executed here.

docs/dev/reports/file_tree.txt

@@ -1,7 +1,14 @@
 HTML-JavaScript-Gaming/
+  games/
+    network_sample_a/
+      .dockerignore
+      server/
+        Dockerfile
+        docker-compose.yml
+        README.md
+        networkSampleADashboardServer.mjs
   docs/
     pr/
-      PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
       BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
       APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
     dev/

docs/dev/reports/validation_checklist.txt

@@ -1,9 +1,21 @@
 # Validation Checklist
 
-- [x] PLAN / BUILD / APPLY docs present
-- [x] BUILD doc is docs-first and containerization-scoped
-- [x] No engine-core changes requested
-- [x] Dashboard/network debug architecture preservation documented
-- [x] Roadmap edits performed via bracket-only updates
-- [x] NEXT command points to APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
-- [x] Repo-structured delta zip built under `<project folder>/tmp/`
+- [x] BUILD doc present
+- [x] APPLY doc present
+- [x] Codex command present
+- [x] Commit comment present
+- [x] Next command present
+- [x] BUILD doc provides exact Dockerfile blueprint
+- [x] BUILD doc provides exact compose blueprint
+- [x] BUILD doc provides exact env contract
+- [x] BUILD doc limits scope to Sample A server containerization
+- [x] `node --check games/network_sample_a/server/networkSampleADashboardServer.mjs` passed
+- [x] Local smoke run passed (`/health` 200, `/api/metrics?key=...` 200, unauthenticated metrics 403)
+- [x] Dockerfile contract verified (Node 22 Alpine, port 4310, healthcheck path)
+- [x] Compose contract verified (port map, env vars, healthcheck, restart policy)
+- [x] `.dockerignore` constrains context to required files
+- [x] README includes build/run/compose/health/env/logging guidance
+- [x] `NETWORK_SAMPLES_PLAN.md` Track U updated with bracket-only edits
+- [x] `BIG_PICTURE_ROADMAP.md` not overwritten in this pass
+- [x] `PRODUCTIZATION_ROADMAP.md` not overwritten in this pass
+- [ ] Docker image build validation (Docker CLI unavailable in this environment)

docs/pr/APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md

@@ -6,21 +6,38 @@ APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
 # APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
 
 ## Apply Intent
-Implement the planned minimal server containerization artifacts with docs-first discipline and architecture preservation.
+Apply the minimal Sample A server containerization defined by the BUILD doc.
+This APPLY step is code/runtime work for Codex, not documentation work for ChatGPT.
 
-## Apply Rules
-- no engine core changes
-- no network/dashboard architecture changes
-- no dashboard mutation/admin additions
-- minimal local/dev containerization only
-- roadmap edits must be bracket-only
+## In Scope Files
+- `games/network_sample_a/server/Dockerfile`
+- `games/network_sample_a/.dockerignore`
+- `games/network_sample_a/server/docker-compose.yml`
+- `games/network_sample_a/server/README.md`
+- `games/network_sample_a/server/networkSampleADashboardServer.mjs` only if required for env-safe host/access compatibility
+- `docs/pr/BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md`
+- `docs/pr/APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md`
+- `docs/dev/codex_commands.md`
+- `docs/dev/commit_comment.txt`
+- `docs/dev/next_command.txt`
+- `docs/dev/reports/change_summary.txt`
+- `docs/dev/reports/file_tree.txt`
+- `docs/dev/reports/validation_checklist.txt`
+- `docs/roadmaps/NETWORK_SAMPLES_PLAN.md` with bracket-only edits only
 
-## Required Validation
-- Dockerfile validity
-- .dockerignore validity
-- compose-ready service validity
-- env contract documented
-- local run command documented
-- health/readiness check documented
-- logging/output expectations documented
-- no unrelated runtime or engine changes
+## Hard Rules
+- no engine-core changes
+- no dashboard mutation features
+- no auth redesign
+- no orchestration stack
+- no unrelated runtime refactors
+- no placeholder docs
+- no roadmap structure changes
+
+## Acceptance
+- Dockerfile builds Sample A dashboard server image
+- compose file runs the same service contract
+- env vars are documented and honored
+- health route works
+- README is actionable
+- roadmap Track U items update by bracket-only edits