Skip to content

Commit 9a33905

Browse files
author
DavidQ
committed
docs: tighten low-token start_of_day workflow and move roadmaps to docs/dev/roadmaps
1 parent 64e1e63 commit 9a33905

25 files changed

Lines changed: 5226 additions & 81 deletions

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,15 @@ MODEL: GPT-5.4-codex
22
REASONING: high
33

44
COMMAND:
5-
Create BUILD_PR_DOCS_ARCHIVE_CLEANUP
5+
Create APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
66

77
Requirements:
8-
- Execute file moves only for docs archive cleanup
9-
- Use docs/dev/reports/docs_archive_pr_move_manifest.txt as the exact source of truth for move operations
10-
- Move each listed file from docs/pr/ to docs/archive/pr/legacy-pr-history/
11-
- Keep every file listed in docs/dev/reports/docs_archive_pr_keep_manifest.txt in docs/pr/
12-
- Preserve docs/pr/.keep
13-
- Do not modify file contents during move
14-
- Do not touch docs/dev/start_of_day/
15-
- Do not touch docs/roadmaps/
16-
- Do not broaden scope beyond the manifest
17-
- Package repo-structured delta zip to <project folder>/tmp/BUILD_PR_DOCS_ARCHIVE_CLEANUP_delta.zip
8+
- This is acceptance/finalization work after the BUILD step already wrote code
9+
- Do not broaden scope
10+
- Keep Sample A server containerization only
11+
- No engine core changes
12+
- Confirm code artifacts exist and validate them
13+
- Update docs/dev/roadmaps/NETWORK_SAMPLES_PLAN.md with bracket-only edits only
14+
- Do not overwrite BIG_PICTURE_ROADMAP.md
15+
- Do not overwrite PRODUCTIZATION_ROADMAP.md
16+
- Package repo-structured delta zip to <project folder>/tmp/APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION_delta.zip

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Archive legacy PR markdown files out of docs/pr while preserving active Level 11 work, .keep, roadmaps, and start_of_day protections.
1+
docs: tighten low-token start_of_day workflow and move roadmaps to docs/dev/roadmaps

‎docs/dev/reports/change_summary.txt‎

Lines changed: 6 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,6 @@
1-
# Change Summary
2-
3-
## Bundle
4-
APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION_delta
5-
6-
## Intent
7-
Docs-only APPLY bundle for accepting and finalizing the already-completed Codex server containerization build.
8-
9-
## Acceptance Validation
10-
- Confirmed artifact presence:
11-
- `games/network_sample_a/server/Dockerfile`
12-
- `games/network_sample_a/.dockerignore`
13-
- `games/network_sample_a/server/docker-compose.yml`
14-
- `games/network_sample_a/server/README.md`
15-
- `games/network_sample_a/server/networkSampleADashboardServer.mjs`
16-
- Required check passed:
17-
- `node --check games/network_sample_a/server/networkSampleADashboardServer.mjs`
18-
- Docker CLI is unavailable in this environment, so image build/compose runtime checks could not be executed here.
19-
20-
## Scope And Roadmap
21-
- Scope stayed on Sample A server containerization acceptance/finalization only.
22-
- No engine/core files were modified in this APPLY working delta.
23-
- `docs/roadmaps/NETWORK_SAMPLES_PLAN.md` Track U checklist states are complete (`[x]`) and remain bracket-only.
24-
- `docs/roadmaps/BIG_PICTURE_ROADMAP.md` was not overwritten.
25-
- `docs/roadmaps/PRODUCTIZATION_ROADMAP.md` was not overwritten.
1+
CHANGE SUMMARY
2+
- Tightened ChatGPT start_of_day workflow rules to reduce unnecessary Codex usage.
3+
- Tightened Codex start_of_day execution rules to reduce broad scans, vague BUILD retries, and opportunistic scope growth.
4+
- Refreshed helper startup files so low-token workflow mode is visible at session start.
5+
- Relocated roadmap tracker files from `docs/roadmaps/` to `docs/dev/roadmaps/` without rewriting roadmap content.
6+
- Updated direct references in bundled docs from `docs/roadmaps/` to `docs/dev/roadmaps/`.

‎docs/dev/reports/file_tree.txt‎

Lines changed: 31 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,33 @@
1-
HTML-JavaScript-Gaming/
2-
games/
3-
network_sample_a/
4-
.dockerignore
5-
server/
6-
Dockerfile
7-
docker-compose.yml
8-
README.md
9-
networkSampleADashboardServer.mjs
10-
docs/
11-
pr/
12-
BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
13-
APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
14-
dev/
15-
CODEX_COMMANDS.md
16-
COMMIT_COMMENT.txt
17-
NEXT_COMMAND.txt
18-
reports/
19-
change_summary.txt
20-
file_tree.txt
21-
validation_checklist.txt
1+
docs/
2+
dev/
3+
CODEX_COMMANDS.md
4+
commit_comment.txt
5+
reports/
6+
change_summary.txt
7+
file_tree.txt
8+
roadmap_move_manifest.txt
9+
validation_checklist.txt
2210
roadmaps/
11+
BIG_PICTURE_ROADMAP.md
2312
NETWORK_SAMPLES_PLAN.md
13+
PRODUCTIZATION_ROADMAP.md
14+
big_picture_roadmap_text.md
15+
start_of_day/
16+
CODEX_SESSION_PROMPT.md
17+
CURRENT_STATE.md
18+
NEXT_STEPS.md
19+
README.md
20+
SESSION_CONTEXT.md
21+
chatGPT/
22+
RULES.md
23+
SESSION_VALIDATION_GATE.md
24+
WORKFLOW.md
25+
codex/
26+
BUILD_EXECUTION_CHECKLIST.md
27+
RULES.md
28+
STOP_AND_REPORT.md
29+
WORKFLOW.md
30+
pr/
31+
APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
32+
APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
33+
APPLY_PR_LOW_TOKEN_START_OF_DAY_AND_ROADMAP_MOVE.md

‎docs/dev/reports/roadmap_move_manifest.txt‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
ROADMAP MOVE MANIFEST
2+
3+
New location:
4+
- docs/dev/roadmaps/BIG_PICTURE_ROADMAP.md
5+
- docs/dev/roadmaps/NETWORK_SAMPLES_PLAN.md
6+
- docs/dev/roadmaps/PRODUCTIZATION_ROADMAP.md
7+
- docs/dev/roadmaps/big_picture_roadmap_text.md
8+
9+
Remove old location after apply:
10+
- docs/roadmaps/BIG_PICTURE_ROADMAP.md
11+
- docs/roadmaps/NETWORK_SAMPLES_PLAN.md
12+
- docs/roadmaps/PRODUCTIZATION_ROADMAP.md
13+
- docs/roadmaps/big_picture_roadmap_text.md

‎docs/dev/reports/validation_checklist.txt‎

Lines changed: 8 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,8 @@
1-
# Validation Checklist
2-
3-
- [x] APPLY doc present
4-
- [x] Companion BUILD doc present
5-
- [x] Codex command present
6-
- [x] Commit comment present
7-
- [x] Next command present
8-
- [x] Dockerfile exists
9-
- [x] .dockerignore exists
10-
- [x] docker-compose.yml exists
11-
- [x] README exists
12-
- [x] `node --check games/network_sample_a/server/networkSampleADashboardServer.mjs` passes
13-
- [x] Docker validation documented as unavailable in this environment (`docker` CLI not installed)
14-
- [x] No engine-core changes in this APPLY working delta
15-
- [x] NETWORK_SAMPLES_PLAN Track U bracket states verified complete (`[x]`)
16-
- [x] BIG_PICTURE_ROADMAP preserved
17-
- [x] PRODUCTIZATION_ROADMAP preserved
1+
VALIDATION CHECKLIST
2+
[pass] Single PR purpose: low-token start_of_day update plus roadmap relocation
3+
[pass] Start_of_day updates were explicitly authorized by the user
4+
[pass] Roadmap files were moved without rewriting content
5+
[pass] Roadmap rule updated to new location: docs/dev/roadmaps/*
6+
[pass] No runtime code changed
7+
[pass] Repo-structured delta ZIP prepared
8+
[note] Old docs/roadmaps/* paths still need removal when applying the move in the repo

‎docs/dev/roadmaps/BIG_PICTURE_ROADMAP.md‎

Lines changed: 126 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
⚠️ RULE:
2+
This file is a status tracker only.
3+
ONLY modify bracket states [ ] [.] [x].
4+
Do NOT change structure or wording.
5+
6+
---
7+
8+
# 🧭 Debug Platform & Ecosystem Roadmap
9+
10+
## Status Legend
11+
- [ ] Todo
12+
- [.] In Progress
13+
- [x] Complete
14+
15+
---
16+
17+
# 🧱 TRACK A — DEBUG FOUNDATION (COMPLETE)
18+
19+
- [x] Dev Console (input + command execution)
20+
- [x] Debug Overlay (visual panels)
21+
- [x] Console ↔ Overlay Boundary
22+
- [x] Panel Registry
23+
- [x] Data Providers (read-only model)
24+
- [x] Operator Commands (control surface)
25+
- [x] Panel Persistence
26+
27+
---
28+
29+
# 🚀 TRACK B — PROMOTION TO ENGINE LAYER
30+
31+
- [x] PLAN_PR_DEBUG_SURFACES_PROMOTION
32+
- [x] BUILD_PR_DEBUG_SURFACES_PROMOTION
33+
- [x] APPLY_PR_DEBUG_SURFACES_PROMOTION
34+
35+
---
36+
37+
# 📦 TRACK C — STANDARD DEBUG LIBRARY
38+
39+
- [x] PLAN_PR_DEBUG_SURFACES_STANDARD_LIBRARY
40+
- [x] BUILD_PR_DEBUG_SURFACES_STANDARD_LIBRARY
41+
- [x] APPLY_PR_DEBUG_SURFACES_STANDARD_LIBRARY
42+
43+
---
44+
45+
# 🎛️ TRACK D — DEBUG PRESETS
46+
47+
- [x] PLAN_PR_DEBUG_SURFACES_PRESETS
48+
- [x] BUILD_PR_DEBUG_SURFACES_PRESETS
49+
- [x] APPLY_PR_DEBUG_SURFACES_PRESETS
50+
51+
---
52+
53+
# 🧰 TRACK E — ADVANCED DEBUG UX
54+
55+
- [x] PLAN_PR_DEBUG_SURFACES_ADVANCED_UX
56+
- [x] BUILD_PR_DEBUG_SURFACES_ADVANCED_UX
57+
- [x] APPLY_PR_DEBUG_SURFACES_ADVANCED_UX
58+
59+
---
60+
61+
# 🎮 TRACK F — GAME INTEGRATION
62+
63+
- [x] PLAN_PR_DEBUG_SURFACES_GAME_INTEGRATION
64+
- [x] BUILD_PR_DEBUG_SURFACES_GAME_INTEGRATION
65+
- [x] APPLY_PR_DEBUG_SURFACES_GAME_INTEGRATION
66+
- [x] Sample game uses full debug platform
67+
- [x] Toggle debug in production-safe mode
68+
- [x] Performance-safe overlays
69+
- [x] Build-time debug flags
70+
71+
---
72+
73+
# 🌐 TRACK G — NETWORK / MULTIPLAYER DEBUG
74+
75+
- [x] Connection status panel
76+
- [.] Latency / RTT panel
77+
- [ ] Replication state viewer
78+
- [ ] Client/server divergence inspector
79+
- [.] Event tracing
80+
- [.] PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT
81+
- [ ] BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT
82+
- [x] APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT
83+
84+
---
85+
86+
# 🧊 TRACK H — 3D DEBUG SUPPORT
87+
88+
- [.] Transform inspector
89+
- [x] BUILD_PR_DEBUG_SURFACES_3D_SUPPORT
90+
- [x] APPLY_PR_DEBUG_SURFACES_3D_SUPPORT
91+
- [ ] Camera debug panel
92+
- [ ] Render pipeline stages
93+
- [ ] Collision overlays
94+
- [ ] Scene graph inspector
95+
96+
---
97+
98+
# 🔬 TRACK I — INSPECTORS & TOOLING
99+
100+
- [x] Entity inspector
101+
- [x] Component inspector
102+
- [x] State diff viewer
103+
- [x] Timeline debugger
104+
- [x] Event stream viewer
105+
106+
---
107+
108+
# 🧠 TRACK J — ENGINE MATURITY
109+
110+
- [x] Stable debug API
111+
- [x] Plugin system
112+
- [x] External documentation
113+
- [x] Versioned contracts
114+
- [x] Performance benchmarks
115+
116+
---
117+
118+
# 🏁 END STATE
119+
120+
A complete system:
121+
122+
- Engine Core → minimal contracts
123+
- Engine Debug → reusable platform
124+
- Standard Library → shared baseline
125+
- Presets → usability layer
126+
- Extensions → 3D, network, inspectors

‎docs/dev/roadmaps/NETWORK_SAMPLES_PLAN.md‎

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
# NETWORK_SAMPLES_PLAN
2+
3+
## Purpose
4+
Track the staged network sample journey for debug surface support using a strict checklist process.
5+
6+
## Status Legend
7+
- [ ] Todo
8+
- [.] In Progress
9+
- [x] Complete
10+
11+
## Phase Alignment
12+
- Phase 13 - Network Concepts, Latency & Simulation (1301-1315)
13+
14+
---
15+
16+
# TRACK N — NETWORK SAMPLE FOUNDATION
17+
18+
- [x] Sample A — Local Loopback / Fake Network
19+
- [x] Synthetic connection lifecycle
20+
- [x] Synthetic RTT feed
21+
- [x] Synthetic replication feed
22+
- [x] Trace event feed
23+
24+
---
25+
26+
# TRACK O — HOST / CLIENT SAMPLE
27+
28+
- [x] Sample B — Host / Client Diagnostics
29+
- [x] Host status panel data
30+
- [x] Client status panel data
31+
- [x] Authority / ownership visibility
32+
- [x] Replication snapshot visibility
33+
- [x] Divergence warning surface
34+
35+
---
36+
37+
# TRACK P — DIVERGENCE / TRACE SAMPLE
38+
39+
- [x] Sample C — Divergence / Trace Validation
40+
- [x] Deterministic mismatch scenario
41+
- [x] Event sequencing timeline
42+
- [x] Divergence explanation notes
43+
- [x] Reproduction guide
44+
- [x] Validation checklist
45+
46+
---
47+
48+
# TRACK Q — NETWORK DEBUG PANELS
49+
50+
- [x] Connection status panel
51+
- [.] Latency / RTT panel
52+
- [ ] Replication state viewer
53+
- [x] Client/server divergence inspector
54+
- [.] Event tracing panel
55+
56+
---
57+
58+
# TRACK R — NETWORK DEBUG COMMANDS
59+
60+
- [ ] network.help
61+
- [x] network.status
62+
- [x] network.latency
63+
- [ ] network.replication
64+
- [x] network.divergence
65+
- [x] network.trace
66+
- [ ] network.sample.*
67+
68+
---
69+
70+
# TRACK S — READINESS TO PROMOTE
71+
72+
- [.] Sample-backed provider validation
73+
- [.] Sample-backed panel validation
74+
- [.] Operator command validation
75+
- [ ] Debug-only gating validation
76+
- [ ] Promotion recommendation
77+
78+
---
79+
80+
# TRACK T — SERVER DASHBOARD
81+
82+
- [ ] Server dashboard shell
83+
- [ ] Player statistics view
84+
- [ ] Latency view
85+
- [ ] RX bytes view
86+
- [ ] TX bytes view
87+
- [ ] Connection/session counts
88+
- [ ] Per-player status rows
89+
- [ ] Refresh/update strategy
90+
- [ ] Debug-only access rules
91+
92+
---
93+
94+
# TRACK U — SERVER CONTAINERIZATION
95+
96+
- [x] Dockerfile for server
97+
- [x] .dockerignore
98+
- [x] Environment variable contract
99+
- [x] Local run command
100+
- [x] Compose-ready service definition
101+
- [x] Port mapping rules
102+
- [x] Health/readiness check
103+
- [x] Logging/output expectations
104+
- [x] Container debug notes
105+
106+
## Recommended Execution Order
107+
1. Sample A
108+
2. Connection + RTT + tracing basics
109+
3. Sample B
110+
4. Replication + authority + divergence
111+
5. Sample C
112+
6. Server dashboard
113+
7. Server containerization
114+
8. Promotion review

0 commit comments

Comments
 (0)