Skip to content

Commit 2740a85

Browse files
author
DavidQ
committed
Plan minimal server containerization after advanced inspectors apply.
1 parent bbb9c84 commit 2740a85

10 files changed

Lines changed: 201 additions & 15 deletions

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,17 @@
11
MODEL: GPT-5.4-codex
2-
COMMAND: APPLY_PR_DEBUG_SURFACES_ADVANCED_INSPECTORS
2+
REASONING: high
3+
4+
COMMAND:
5+
Follow PLAN_PR + BUILD_PR + APPLY_PR
6+
7+
Create PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
8+
9+
Requirements:
10+
- Docs-first
11+
- No engine core changes
12+
- One PR per purpose
13+
- Build zip automatically to <project folder>/tmp/
14+
- Plan minimal server containerization only
15+
- Keep dashboard/network debug architecture intact
16+
- Update roadmap trackers with bracket-only edits only
17+
- Roadmaps live under docs/roadmaps/

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Add advanced inspector debug surfaces (opt-in architecture).
1+
Plan minimal server containerization as a docs-first PLAN bundle with no engine-core changes, preserved dashboard/network debug architecture, bracket-only roadmap tracker edits, and packaged delta zip output.

‎docs/dev/NEXT_COMMAND.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
1+
BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION

‎docs/dev/reports/change_summary.txt‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,13 @@
1-
Advanced inspectors build bundle created.
1+
# Change Summary
2+
3+
## Bundle
4+
PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION_delta
5+
6+
## Included
7+
- PLAN / BUILD / APPLY docs for server containerization
8+
- Codex command, commit comment, next command
9+
- Reports (change summary, file tree, validation checklist)
10+
- Roadmap tracker bracket-only updates under docs/roadmaps
11+
12+
## Intent
13+
Plan a minimal server containerization slice for local debug/dashboard workflows while keeping network/dashboard architecture intact and avoiding engine-core changes.

‎docs/dev/reports/file_tree.txt‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
HTML-JavaScript-Gaming/
22
docs/
33
pr/
4-
PLAN_PR_DEBUG_SURFACES_ADVANCED_INSPECTORS.md
5-
BUILD_PR_DEBUG_SURFACES_ADVANCED_INSPECTORS.md
6-
APPLY_PR_DEBUG_SURFACES_ADVANCED_INSPECTORS.md
4+
PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
5+
BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
6+
APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
77
dev/
88
CODEX_COMMANDS.md
99
COMMIT_COMMENT.txt
@@ -13,4 +13,4 @@ HTML-JavaScript-Gaming/
1313
validation_checklist.txt
1414
file_tree.txt
1515
roadmaps/
16-
BIG_PICTURE_ROADMAP.md
16+
NETWORK_SAMPLES_PLAN.md

‎docs/dev/reports/validation_checklist.txt‎

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
1-
Inspectors load
2-
No auto-injection
3-
Commands work
1+
# Validation Checklist
2+
3+
- [x] PLAN doc present
4+
- [x] BUILD doc present
5+
- [x] APPLY doc present
6+
- [x] Docs-first scope preserved
7+
- [x] No engine-core changes
8+
- [x] Scope is minimal server containerization
9+
- [x] Dashboard/network architecture preservation documented
10+
- [x] Roadmap edits are bracket-only
11+
- [x] Zip built under <project folder>/tmp/

‎docs/pr/APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
5+
6+
# APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
7+
8+
## Apply Intent
9+
Implement the planned minimal server containerization artifacts with docs-first discipline and architecture preservation.
10+
11+
## Apply Rules
12+
- no engine core changes
13+
- no network/dashboard architecture changes
14+
- no dashboard mutation/admin additions
15+
- minimal local/dev containerization only
16+
- roadmap edits must be bracket-only
17+
18+
## Required Validation
19+
- Dockerfile validity
20+
- .dockerignore validity
21+
- compose-ready service validity
22+
- env contract documented
23+
- local run command documented
24+
- health/readiness check documented
25+
- logging/output expectations documented
26+
- no unrelated runtime or engine changes

‎docs/pr/BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
5+
6+
# BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
7+
8+
## Build Intent
9+
Translate the approved PLAN into an implementation-ready minimal containerization bundle for debug server workflows.
10+
11+
## Authoritative Target Artifacts
12+
```text
13+
<project>/server/
14+
Dockerfile
15+
.dockerignore
16+
docker-compose.debug.yml (or compose-ready equivalent)
17+
18+
docs/
19+
pr/
20+
dev/reports/
21+
```
22+
23+
## Build Rules
24+
- no engine-core changes
25+
- preserve network/dashboard debug architecture
26+
- no dashboard write controls
27+
- no server architecture redesign
28+
- local/dev-focused minimal containerization only
29+
30+
## Ordered APPLY Steps
31+
1. Confirm server entrypoint assumptions.
32+
2. Add Dockerfile.
33+
3. Add .dockerignore.
34+
4. Add compose-ready service definition.
35+
5. Define environment variable contract.
36+
6. Define local run command.
37+
7. Define port mapping rules.
38+
8. Define health/readiness check behavior.
39+
9. Define logging/output expectations and debug notes.
40+
10. Update roadmap trackers via bracket-only edits.
41+
42+
## Validation Targets
43+
- container artifact syntax validity
44+
- local run path clarity
45+
- architecture boundaries unchanged
46+
- no engine-core changes
47+
- no hidden coupling to dashboard internals
48+
49+
## Packaging
50+
`<project folder>/tmp/PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION_delta.zip`

‎docs/pr/PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
5+
6+
# PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION
7+
8+
## Workflow Discipline
9+
PLAN_PR -> BUILD_PR -> APPLY_PR
10+
11+
## Purpose
12+
Plan minimal server containerization for debug server/dashboard workflows while preserving existing network/dashboard architecture.
13+
14+
## Requirements Alignment
15+
- docs-first
16+
- no engine core changes
17+
- one PR per purpose
18+
- minimal server containerization only
19+
- keep dashboard/network debug architecture intact
20+
- roadmap updates by bracket-only edits only
21+
22+
## In Scope
23+
- minimal Dockerfile strategy
24+
- minimal .dockerignore strategy
25+
- environment variable contract
26+
- local run command contract
27+
- compose-ready service contract for local debug use
28+
- port mapping guidance
29+
- health/readiness check guidance
30+
- logging/output expectations
31+
- container debug notes
32+
33+
## Out Of Scope
34+
- engine core APIs
35+
- server runtime redesign
36+
- dashboard feature redesign
37+
- production hardening/security program
38+
- orchestrator/Kubernetes deployment
39+
- transport architecture rewrites
40+
41+
## Ownership
42+
### Project/Server Layer
43+
- container artifacts and server runtime wiring
44+
- env contract realization
45+
- local compose/runtime setup
46+
47+
### Engine Debug Network/Dashboard Layer
48+
- existing read-only diagnostics and dashboard architecture remains unchanged
49+
- no container-specific coupling required in shared network/dashboard modules
50+
51+
### Engine Core
52+
- no changes in this PLAN PR
53+
54+
## Guardrails
55+
- minimal slice only
56+
- no mutation/admin feature additions
57+
- no coupling to console/overlay internals
58+
- no hidden assumptions about 3D/inspectors/network sample internals
59+
60+
## Validation Goals
61+
- planned artifacts are minimal and runnable
62+
- architecture boundaries remain intact
63+
- no engine-core edits required
64+
- roadmap tracker edits remain bracket-only
65+
66+
## Deliverables
67+
- docs/pr/PLAN_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
68+
- docs/pr/BUILD_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
69+
- docs/pr/APPLY_PR_DEBUG_SURFACES_SERVER_CONTAINERIZATION.md
70+
- docs/dev/CODEX_COMMANDS.md
71+
- docs/dev/COMMIT_COMMENT.txt
72+
- docs/dev/NEXT_COMMAND.txt
73+
- docs/dev/reports/change_summary.txt
74+
- docs/dev/reports/file_tree.txt
75+
- docs/dev/reports/validation_checklist.txt

‎docs/roadmaps/NETWORK_SAMPLES_PLAN.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -93,10 +93,10 @@ Track the staged network sample journey for debug surface support using a strict
9393

9494
# TRACK U — SERVER CONTAINERIZATION
9595

96-
- [ ] Dockerfile for server
97-
- [ ] .dockerignore
98-
- [ ] Environment variable contract
99-
- [ ] Local run command
96+
- [.] Dockerfile for server
97+
- [.] .dockerignore
98+
- [.] Environment variable contract
99+
- [.] Local run command
100100
- [ ] Compose-ready service definition
101101
- [ ] Port mapping rules
102102
- [ ] Health/readiness check

0 commit comments

Comments
 (0)