Skip to content

Commit c48e95b

Browse files
author
DavidQ
committed
Apply 3D debug surfaces
1 parent 5a67a06 commit c48e95b

13 files changed

Lines changed: 94 additions & 381 deletions

docs/dev/CODEX_COMMANDS.md

Lines changed: 1 addition & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,2 @@
11
MODEL: GPT-5.4-codex
2-
REASONING: high
3-
4-
COMMAND:
5-
Follow PLAN_PR + BUILD_PR + APPLY_PR
6-
7-
Create APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED
8-
9-
Requirements:
10-
- Docs-first before implementation
11-
- No engine core changes
12-
- One PR per purpose
13-
- Build zip automatically to <project folder>/tmp/
14-
- Implement advanced shared server dashboard under engine/debug/network/dashboard
15-
- Keep providers read-only
16-
- No console coupling
17-
- No overlay coupling
18-
- No persistence
19-
- Add:
20-
- serverDashboardViewModel.js
21-
- serverDashboardMetrics.js
22-
- serverDashboardRefreshModes.js
23-
- registerDashboardCommands.js
24-
- Extend host/registry/renderer through public APIs only
25-
- Validate imports, snapshot normalization, refresh modes, command outputs, and sample plugin parity
26-
- Update roadmap trackers with bracket-only edits only
27-
- Roadmaps live under docs/roadmaps/
2+
COMMAND: APPLY_PR_DEBUG_SURFACES_3D_SUPPORT

docs/dev/COMMIT_COMMENT.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Apply advanced shared server dashboard under engine/debug/network/dashboard with read-only providers, refresh modes, view-model metrics, dashboard command pack registration, targeted validation coverage, and bracket-only NETWORK_SAMPLES_PLAN tracker updates.
1+
Apply 3D debug surfaces

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_NETWORK_SERVER_CONTAINER
1+
BUILD_PR_DEBUG_SURFACES_3D_SUPPORT
Lines changed: 1 addition & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1 @@
1-
# Change Summary
2-
3-
## Bundle
4-
APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED_delta
5-
6-
## Scope Applied
7-
- Docs-first PLAN/BUILD/APPLY updates for server dashboard advanced work.
8-
- Added advanced shared dashboard modules under `engine/debug/network/dashboard`.
9-
- Extended host/registry/renderer through public APIs.
10-
- Added read-only `dashboard.*` command registration bridge.
11-
- Exported advanced dashboard modules from `engine/debug/network/index.js`.
12-
- Updated `docs/roadmaps/NETWORK_SAMPLES_PLAN.md` using bracket-only state edits.
13-
14-
## Validation
15-
- Import and syntax checks for updated dashboard modules.
16-
- Snapshot normalization and metrics/view-model smoke coverage.
17-
- Refresh mode validation (`manual`, `normal`, `fast`).
18-
- Command output validation for `dashboard.help/status/refresh/mode/snapshot`.
19-
- Sample A/B/C plugin parity and provider read-only checks.
20-
21-
## Constraints Kept
22-
- No engine core API changes.
23-
- No console coupling.
24-
- No overlay coupling.
25-
- No persistence.
1+
3D support bundle

docs/dev/reports/file_tree.txt

Lines changed: 1 addition & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1 @@
1-
HTML-JavaScript-Gaming/
2-
docs/
3-
pr/
4-
PLAN_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
5-
BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
6-
APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
7-
dev/
8-
CODEX_COMMANDS.md
9-
COMMIT_COMMENT.txt
10-
NEXT_COMMAND.txt
11-
reports/
12-
change_summary.txt
13-
validation_checklist.txt
14-
file_tree.txt
15-
roadmaps/
16-
NETWORK_SAMPLES_PLAN.md
17-
engine/
18-
debug/
19-
network/
20-
index.js
21-
dashboard/
22-
serverDashboardHost.js
23-
serverDashboardRegistry.js
24-
serverDashboardRenderer.js
25-
serverDashboardMetrics.js
26-
serverDashboardViewModel.js
27-
serverDashboardRefreshModes.js
28-
registerDashboardCommands.js
1+
docs/pr docs/dev
Lines changed: 1 addition & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1 @@
1-
# Validation Checklist
2-
3-
- [x] PLAN doc present
4-
- [x] BUILD doc present
5-
- [x] APPLY doc present
6-
- [x] Codex command present
7-
- [x] Commit comment present
8-
- [x] Next command present
9-
- [x] Dashboard modules scoped to engine/debug/network/dashboard
10-
- [x] No engine-core changes
11-
- [x] Providers remain read-only
12-
- [x] Commands use host public APIs only
13-
- [x] Refresh modes validated
14-
- [x] Snapshot normalization validated
15-
- [x] Sample A/B/C plugin parity checked
16-
- [x] Roadmap edits bracket-only only
17-
- [x] Zip built under <project folder>/tmp/
1+
Validate 3D debug surfaces
Lines changed: 1 addition & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,3 @@
11
# APPLY_PR_DEBUG_SURFACES_3D_SUPPORT
22

3-
## Purpose
4-
5-
Apply the approved 3D support plan by creating the first shared 3D panels, providers, and optional presets for the debug surfaces platform.
6-
7-
## Apply Scope
8-
9-
### Create Shared 3D Providers
10-
- `transformSummary`
11-
- `cameraSummary`
12-
- `renderStageSummary`
13-
- `collisionSummary`
14-
- `sceneGraphSummary`
15-
16-
### Create Shared 3D Panels
17-
- `3d.transform`
18-
- `3d.camera`
19-
- `3d.renderStages`
20-
- `3d.collision`
21-
- `3d.sceneGraph`
22-
23-
### Create Optional Shared 3D Presets
24-
- `preset.3d.inspect`
25-
- `preset.3d.render`
26-
- `preset.3d.camera`
27-
28-
### Keep Local
29-
- renderer-specific adapters
30-
- scene-specific extraction
31-
- project-specific debug visuals
32-
- engine-specific stage mappings
33-
34-
## Execution Order
35-
36-
1. Create summary-level 3D providers
37-
2. Create shared 3D panels consuming providers only
38-
3. Create optional shared 3D presets
39-
4. Add registration entry points
40-
5. Wire a sample adapter harness or 3D-capable sample integration
41-
6. Validate renderer-agnostic behavior and adapter boundaries
42-
43-
## Rules
44-
45-
- Keep adoption opt-in
46-
- Preserve existing provider/panel/preset conventions
47-
- Shared layer must stay renderer-agnostic
48-
- Panels must consume provider data only
49-
- No deep inspectors in this PR
50-
- No renderer-specific logic in shared layer
51-
- No network support in this PR
3+
3D debug surface apply.
Lines changed: 1 addition & 85 deletions
Original file line numberDiff line numberDiff line change
@@ -1,87 +1,3 @@
11
# BUILD_PR_DEBUG_SURFACES_3D_SUPPORT
22

3-
## Purpose
4-
Build a docs-only, implementation-ready bundle for the first reusable 3D support layer in the debug surfaces platform.
5-
6-
## Build Mode
7-
- Docs-only
8-
- One PR purpose only
9-
- No engine/runtime implementation files
10-
11-
## Scope
12-
In scope:
13-
- Shared 3D panel inventory (summary-level)
14-
- Shared 3D provider inventory (read-only snapshots)
15-
- Optional shared 3D presets
16-
- Adapter boundary contracts
17-
- Adoption models and naming conventions
18-
- Validation and rollout guidance
19-
20-
Out of scope:
21-
- Renderer-specific implementations
22-
- Deep inspectors
23-
- Network/multiplayer support
24-
- Project-specific adapters in shared layer
25-
26-
## Shared 3D Inventory
27-
Panels:
28-
- `panel.3d.transforms`
29-
- `panel.3d.camera`
30-
- `panel.3d.renderStages`
31-
- `panel.3d.collisions`
32-
- `panel.3d.sceneGraph`
33-
34-
Providers:
35-
- `provider.3d.transforms.snapshot`
36-
- `provider.3d.camera.snapshot`
37-
- `provider.3d.renderStages.snapshot`
38-
- `provider.3d.collisions.snapshot`
39-
- `provider.3d.sceneGraph.snapshot`
40-
41-
Optional presets:
42-
- `preset.3d.inspect`
43-
- `preset.3d.render`
44-
- `preset.3d.camera`
45-
46-
## Adapter Boundaries
47-
Shared layer responsibilities:
48-
- Define generic panel/provider/preset descriptors.
49-
- Provide registration seams and naming conventions.
50-
51-
Project/sample responsibilities:
52-
- Renderer-specific data extraction.
53-
- Scene-specific mapping.
54-
- Project-owned adapter implementations.
55-
56-
## Naming Conventions
57-
- Panels: `panel.3d.<domain>`
58-
- Providers: `provider.3d.<domain>.snapshot`
59-
- Presets: `preset.3d.<name>`
60-
61-
## Target Structure
62-
```text
63-
engine/
64-
debug/
65-
standard/
66-
threeD/
67-
panels/
68-
providers/
69-
presets/
70-
```
71-
72-
## Guardrails
73-
See `docs/pr/BUILD_PR_DEBUG_SURFACES_3D_SUPPORT_GUARDRAILS.md`.
74-
75-
## Validation Goals
76-
- Shared 3D inventory is explicit and reusable.
77-
- Shared layer remains renderer-agnostic.
78-
- Project-specific adapters stay outside shared layer.
79-
- Scope remains summary-level and opt-in.
80-
81-
## Rollout Notes
82-
1. Keep this BUILD docs-only.
83-
2. APPLY should implement in small slices:
84-
- provider contracts
85-
- panels
86-
- optional presets
87-
3. Preserve existing 2D debug behavior parity.
3+
3D debug surface build.

0 commit comments

Comments
 (0)