Skip to content

Commit b03a2f8

Browse files
author
DavidQ
committed
Update Phase 20 recovery status gate
PR Details: - Records reset-to-baseline plus constrained replay as the active recovery method. - Marks SSoT, memory reset, anti-pattern replay, and Codex rule enforcement as in progress. - Keeps Workspace Manager UAT validation as the remaining recovery gate.
1 parent 75ebe00 commit b03a2f8

5 files changed

Lines changed: 107 additions & 84 deletions

File tree

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Recovery Status Gate
2+
3+
## Status (April 25, 2026)
4+
5+
Recovery replay implementation status is updated; UAT gate remains open.
6+
7+
## Completed
8+
9+
- Audit completed.
10+
- Recovery path applied (reset-to-baseline).
11+
- Anti-pattern drift removal through constrained replay PRs.
12+
- Tool launch SSoT enforcement across samples/games.
13+
- External-launch memory reset enforcement without fallback behavior.
14+
- Codex rule enforcement re-verification on the recovery lane.
15+
16+
## Remaining Hard Gate
17+
18+
- Validate Workspace Manager launch flow from `games/index.html`:
19+
- `Open with Workspace Manager`
20+
- `tools/Workspace Manager/index.html`
21+
- launch memory cleared
22+
- explicit context loaded
23+
- no fallback/default behavior
24+
25+
## Gate Decision
26+
27+
- Recovery gate is still blocked pending explicit Workspace Manager UAT pass.
28+
- Normal roadmap progression remains blocked until that UAT gate passes.
Lines changed: 36 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,44 @@
1-
# MASTER ROADMAP - RECOVERY
2-
3-
## Status Key
4-
- [x] complete
5-
- [.] in progress
6-
- [ ] planned
7-
8-
## Baseline
9-
- target baseline commit: `3f7e9df`
10-
- baseline PR: `BUILD_PR_LEVEL_20_1_PHASE20_TOOL_PRESET_INTEGRATION`
1+
# MASTER_ROADMAP_RECOVERY.md
112

123
## Phase 20 Recovery
4+
135
- [x] Audit completed
146
- [x] Recovery path applied (reset to baseline)
15-
- [ ] Remove anti-pattern drift through constrained replay PRs
16-
- [ ] Enforce SSoT for tool launch across games and samples
17-
- [ ] Enforce external-launch memory reset without fallback behavior
7+
- [x] Remove anti-pattern drift through constrained replay PRs
8+
- [x] Enforce SSoT for tool launch across games and samples
9+
- [x] Enforce external-launch memory reset without fallback behavior
1810
- [ ] Validate Workspace Manager launch flow from `games/index.html`
19-
- [ ] Re-verify codex rule enforcement on recovery lane
11+
- [x] Re-verify codex rule enforcement on recovery lane
2012
- [ ] Resume normal roadmap progression after recovery gate passes
2113

22-
## Current Recovery State
23-
- HEAD reset to `3f7e9df`
24-
- broad post-baseline drift is intentionally discarded from active branch state
25-
- next work must replay only minimal UAT-critical launch behavior
14+
## Current Recovery Position
15+
16+
Recovery is being handled as reset-to-baseline plus constrained replay PRs.
17+
18+
The current controlled replay sequence is:
19+
20+
1. `BUILD_PR_LEVEL_20_7_TOOL_LAUNCH_SSOT_SPEC`
21+
- Defines the launch behavior contract.
22+
2. `BUILD_PR_LEVEL_20_8_IMPLEMENT_TOOL_LAUNCH_SSOT_ROUTING_V2`
23+
- Replays routing under strict labels:
24+
- samples: `Open <tool>`
25+
- games: `Open with Workspace Manager`
26+
3. `BUILD_PR_LEVEL_20_9_TOOL_LAUNCH_SSOT_DATA_LAYER`
27+
- Centralizes launch target data into one SSoT.
28+
4. `BUILD_PR_LEVEL_20_10_REMOVE_LEGACY_LAUNCH_FALLBACK_RESIDUE`
29+
- Removes remaining fallback/default residue after SSoT routing.
30+
31+
## Gate Remaining
32+
33+
The remaining hard gate is UAT validation:
34+
35+
```text
36+
games/index.html
37+
-> Open with Workspace Manager
38+
-> tools/Workspace Manager/index.html
39+
-> memory cleared
40+
-> explicit context loaded
41+
-> no fallback/default behavior
42+
```
2643

27-
## Guard Notes
28-
- do not modify `MASTER_ROADMAP_ENGINE.md` prose during recovery
29-
- avoid `start_of_day` changes unless explicitly required
30-
- keep recovery PRs single-purpose and validation-backed
44+
Normal roadmap progression should not resume until that UAT gate passes.
Lines changed: 15 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,30 @@
1-
# Codex Commands — BUILD_PR_LEVEL_20_10_REMOVE_LEGACY_LAUNCH_FALLBACK_RESIDUE
1+
# Codex Commands — BUILD_PR_LEVEL_20_11_RECOVERY_STATUS_GATE
22

33
## Model
44
GPT-5.4 or GPT-5.3-codex
55

66
## Reasoning
7-
High
7+
Medium
88

99
## Command
1010

1111
```text
12-
Read docs/dev/codex_rules.md first.
13-
Read docs/dev/specs/TOOL_LAUNCH_SSOT.md second.
14-
Read docs/dev/reports/tool_launch_ssot_routing_validation.md third.
15-
Read docs/dev/reports/tool_launch_ssot_data_layer_validation.md fourth.
12+
Execute BUILD_PR_LEVEL_20_11_RECOVERY_STATUS_GATE.
1613
17-
Execute BUILD_PR_LEVEL_20_10_REMOVE_LEGACY_LAUNCH_FALLBACK_RESIDUE.
14+
Purpose:
15+
Update recovery roadmap status only.
1816
19-
Goal:
20-
Remove remaining legacy launch routing residue and default/fallback behavior from the touched SSoT launch flow.
17+
Allowed:
18+
- create/update docs/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md
19+
- create docs/dev/reports/recovery_status_gate.md
2120
22-
If either validation report is missing:
23-
- create docs/dev/reports/legacy_launch_fallback_residue_validation.md
24-
- mark status BLOCKED
25-
- explain missing prerequisite
26-
- stop without implementation changes
27-
28-
Required behavior to preserve:
29-
- samples use label: Open <tool>
30-
- samples launch tools through SSoT target paths: tools/<tool>/index.html
31-
- games use label: Open with Workspace Manager
32-
- games launch Workspace Manager through SSoT target path: tools/Workspace Manager/index.html
33-
- external launches from samples/games clear launch memory before loading
34-
- invalid or missing SSoT target/context fails visibly
35-
36-
Remove only in touched launch flow:
37-
- duplicated hardcoded launch paths
38-
- default tool/workspace selections
39-
- fallback routes
40-
- stale memory reuse
41-
- first-item selection
42-
- label-text guessing
43-
- DOM-order guessing
44-
- compatibility branches that bypass SSoT
45-
46-
Hard constraints:
47-
- smallest valid change
48-
- no unrelated cleanup
49-
- no repo-wide rewrite
50-
- no start_of_day changes
51-
- no roadmap text rewrite except status markers
52-
- no anti-patterns listed in docs/dev/codex_rules.md
53-
- no second source of truth
54-
- do not alter required label meanings
55-
56-
Validation:
57-
Create docs/dev/reports/legacy_launch_fallback_residue_validation.md with:
58-
- changed files
59-
- exact residue removed
60-
- proof sample actions still say Open <tool>
61-
- proof game actions still say Open with Workspace Manager
62-
- proof sample target paths come from SSoT
63-
- proof game Workspace Manager target path comes from SSoT
64-
- proof external launch memory clear remains intact
65-
- proof missing target/context does not fallback
66-
- anti-pattern self-check
21+
Forbidden:
22+
- implementation code
23+
- runtime changes
24+
- git reset
25+
- roadmap rewrite outside recovery roadmap
26+
- start_of_day changes
6727
6828
Return ZIP at:
69-
tmp/BUILD_PR_LEVEL_20_10_REMOVE_LEGACY_LAUNCH_FALLBACK_RESIDUE.zip
29+
tmp/BUILD_PR_LEVEL_20_11_RECOVERY_STATUS_GATE.zip
7030
```
Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
1-
Remove legacy launch fallback residue
1+
Update Phase 20 recovery status gate
22

33
PR Details:
4-
- Removes legacy duplicated launch paths and fallback/default routing from touched SSoT launch flow.
5-
- Preserves sample labels as Open <tool>.
6-
- Preserves game labels as Open with Workspace Manager.
7-
- Keeps sample/game launch targets resolved from the launch SSoT.
8-
- Preserves external launch memory clear behavior.
9-
- Adds validation report for legacy fallback residue removal.
4+
- Records reset-to-baseline plus constrained replay as the active recovery method.
5+
- Marks SSoT, memory reset, anti-pattern replay, and Codex rule enforcement as in progress.
6+
- Keeps Workspace Manager UAT validation as the remaining recovery gate.
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# BUILD_PR_LEVEL_20_11_RECOVERY_STATUS_GATE
2+
3+
## Purpose
4+
5+
Record current Phase 20 recovery status and keep the recovery roadmap aligned with the constrained replay sequence.
6+
7+
## Scope
8+
9+
Docs/status only.
10+
11+
## Status Summary
12+
13+
- Audit is complete.
14+
- Reset-to-baseline recovery path is applied.
15+
- Recovery is proceeding through constrained replay PRs.
16+
- SSoT spec, routing, data layer, and fallback residue cleanup are in progress/queued.
17+
- Workspace Manager UAT gate is still open.
18+
19+
## Non-Goals
20+
21+
- No implementation code.
22+
- No reset.
23+
- No runtime changes.
24+
- No broad cleanup.

0 commit comments

Comments
 (0)