Skip to content

Commit 335fd0c

Browse files
author
DavidQ
committed
APPLY_PR_DEBUG_SURFACES_INSPECTORS
Applies the approved inspector layer: - Entity inspector - Component inspector - State diff viewer - Timeline debugger - Event stream viewer Preserves read-only behavior, bounded frame history, optional debug surfaces, and roadmap bracket-only updates for Track I.
1 parent a9dfb30 commit 335fd0c

File tree

11 files changed

+846
-40
lines changed

11 files changed

+846
-40
lines changed

‎docs/dev/BIG_PICTURE_ROADMAP.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -97,11 +97,11 @@ Do NOT change structure or wording.
9797

9898
# 🔬 TRACK I — INSPECTORS & TOOLING
9999

100-
- [.] Entity inspector
101-
- [ ] Component inspector
102-
- [ ] State diff viewer
103-
- [ ] Timeline debugger
104-
- [ ] Event stream viewer
100+
- [x] Entity inspector
101+
- [x] Component inspector
102+
- [x] State diff viewer
103+
- [x] Timeline debugger
104+
- [x] Event stream viewer
105105

106106
---
107107

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,31 @@ MODEL: GPT-5.3-codex
22
REASONING: high
33

44
COMMAND:
5-
Create BUILD_PR_DEBUG_SURFACES_INSPECTORS
5+
Apply BUILD_PR_DEBUG_SURFACES_INSPECTORS exactly as defined.
6+
7+
- Use docs/pr/BUILD_PR_DEBUG_SURFACES_INSPECTORS.md as implementation contract
8+
- Do not expand scope
9+
- Preserve engine/runtime separation
10+
- Do not modify unrelated files
11+
12+
VALIDATION:
13+
- Inspector surfaces are read-only
14+
- Entity inspector works
15+
- Component inspector works
16+
- State diff viewer works
17+
- Timeline debugger works
18+
- Event stream viewer works
19+
- No runtime regressions
20+
- Frame buffer remains bounded
21+
22+
ROADMAP UPDATE:
23+
Update docs/dev/BIG_PICTURE_ROADMAP.md using bracket-only edits:
24+
- Entity inspector -> [x]
25+
- Component inspector -> [x]
26+
- State diff viewer -> [x]
27+
- Timeline debugger -> [x]
28+
- Event stream viewer -> [x]
29+
30+
OUTPUT:
31+
Create APPLY_PR_DEBUG_SURFACES_INSPECTORS delta ZIP at:
32+
<project folder>/tmp/APPLY_PR_DEBUG_SURFACES_INSPECTORS_delta.zip

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,11 @@
1-
docs: build inspector surfaces bundle with read-only boundaries and apply-ready contracts
1+
APPLY_PR_DEBUG_SURFACES_INSPECTORS
2+
3+
Applies the approved inspector layer:
4+
- Entity inspector
5+
- Component inspector
6+
- State diff viewer
7+
- Timeline debugger
8+
- Event stream viewer
9+
10+
Preserves read-only behavior, bounded frame history, optional debug surfaces,
11+
and roadmap bracket-only updates for Track I.

‎docs/dev/NEXT_COMMAND.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
APPLY_PR_DEBUG_SURFACES_INSPECTORS
1+
Create PLAN_PR_ENGINE_MATURITY

‎docs/dev/reports/change_summary.txt‎

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,10 @@
1-
Created docs-only BUILD_PR_DEBUG_SURFACES_INSPECTORS bundle.
1+
Applies BUILD_PR_DEBUG_SURFACES_INSPECTORS exactly as approved.
22

3-
Updated:
4-
- BUILD_PR_DEBUG_SURFACES_INSPECTORS.md
5-
- active command/commit/next-command docs
6-
- reports and file tree
7-
- roadmap bracket-state transition under Track I
3+
Confirms:
4+
- inspector layer integrated
5+
- read-only inspection preserved
6+
- bounded frame history preserved
7+
- event stream remains passive
8+
- roadmap updated by bracket-only state changes in Track I
89

9-
Constraints preserved:
10-
- docs only
11-
- no runtime or engine-core API changes
12-
- inspector scope remains read-only
10+
No out-of-scope changes permitted.

‎docs/dev/reports/file_tree.txt‎

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,7 @@
1-
BUILD_PR_DEBUG_SURFACES_INSPECTORS_delta.zip
2-
- docs/pr/PLAN_PR_DEBUG_SURFACES_INSPECTORS.md
3-
- docs/pr/BUILD_PR_DEBUG_SURFACES_INSPECTORS.md
4-
- docs/dev/BIG_PICTURE_ROADMAP.md
5-
- docs/dev/ROADMAP_GUARDRAILS.md
6-
- docs/dev/codex_commands.md
7-
- docs/dev/commit_comment.txt
8-
- docs/dev/next_command.txt
9-
- docs/dev/reports/change_summary.txt
10-
- docs/dev/reports/validation_checklist.txt
11-
- docs/dev/reports/file_tree.txt
1+
docs/pr/APPLY_PR_DEBUG_SURFACES_INSPECTORS.md
2+
docs/dev/codex_commands.md
3+
docs/dev/commit_comment.txt
4+
docs/dev/next_command.txt
5+
docs/dev/reports/change_summary.txt
6+
docs/dev/reports/validation_checklist.txt
7+
docs/dev/reports/file_tree.txt

‎docs/dev/reports/validation_checklist.txt‎

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
1-
Validation Checklist
2-
3-
[x] PLAN_PR -> BUILD_PR -> APPLY_PR workflow preserved
4-
[x] BUILD_PR_DEBUG_SURFACES_INSPECTORS created
5-
[x] Bundle remains docs-only
6-
[x] No runtime code changes
7-
[x] No engine-core API changes
8-
[x] Inspector boundaries are read-only
9-
[x] Adapter ownership boundaries are explicit
10-
[x] BIG_PICTURE_ROADMAP.md changed by brackets only
1+
[ ] APPLY scope matches approved BUILD scope
2+
[ ] No runtime mutation APIs added
3+
[ ] Entity inspector works
4+
[ ] Component inspector works
5+
[ ] State diff viewer works
6+
[ ] Timeline debugger works
7+
[ ] Event stream viewer works
8+
[ ] Frame buffer bounded
9+
[ ] Existing samples still run
10+
[ ] No unrelated files changed
11+
[ ] BIG_PICTURE_ROADMAP updated with bracket-only edits

‎docs/pr/APPLY_PR_DEBUG_SURFACES_INSPECTORS.md‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# APPLY_PR_DEBUG_SURFACES_INSPECTORS
2+
3+
## Purpose
4+
Apply the approved inspector-layer build exactly as defined by:
5+
- PLAN_PR_DEBUG_SURFACES_INSPECTORS
6+
- BUILD_PR_DEBUG_SURFACES_INSPECTORS
7+
8+
## Apply Scope
9+
Promote the inspector layer into the repo in a controlled, non-invasive way.
10+
11+
Included inspector surfaces:
12+
- Entity inspector
13+
- Component inspector
14+
- State diff viewer
15+
- Timeline debugger
16+
- Event stream viewer
17+
18+
Included contracts:
19+
- InspectorRegistry
20+
- InspectorContext
21+
- FrameBufferProvider
22+
- EventStreamProvider
23+
24+
## Hard Rules
25+
- Apply only approved BUILD scope
26+
- No runtime mutation APIs
27+
- No unrelated engine changes
28+
- No breaking sample behavior
29+
- Preserve engine/runtime separation
30+
- Debug surfaces remain optional
31+
32+
## Validation Requirements
33+
- Inspector surfaces render through approved debug pathways
34+
- Read-only behavior is preserved
35+
- Frame buffer remains bounded
36+
- Event stream viewer is passive/read-only
37+
- Existing samples still run
38+
- No regressions outside inspector scope
39+
40+
## Roadmap Update
41+
Update only bracket states in docs/dev/BIG_PICTURE_ROADMAP.md
42+
43+
Track I:
44+
- Entity inspector -> [x]
45+
- Component inspector -> [x]
46+
- State diff viewer -> [x]
47+
- Timeline debugger -> [x]
48+
- Event stream viewer -> [x]
49+
50+
Do not modify roadmap wording, order, headings, or structure.
51+
52+
## Output
53+
Create:
54+
<project folder>/tmp/APPLY_PR_DEBUG_SURFACES_INSPECTORS_delta.zip

0 commit comments

Comments
 (0)