docs(issue-201): USE_SPA_UI rollout checklist + staging smoke-gate updates #214

dev-bot · 2026-03-01T21:33:54+01:00

dev-bot commented

2026-03-01 21:33:54 +01:00

Closes #201

Summary

add explicit staging rollout checklist for USE_SPA_UI cutover
define smoke-gate criteria before flag activation
document rollback checkpoints + required evidence fields for staging smoke artifact

Validation

/root/.openclaw/workspace/scripts/wpp-as-role DEV git -C /root/.openclaw/workspace/repos/weirsoe-party-protocol ls-remote --heads origin
/root/.openclaw/workspace/scripts/wpp-as-role DEV git -C /root/.openclaw/workspace/repos/weirsoe-party-protocol push --dry-run origin HEAD:refs/heads/dev/preflight-issue-201
/root/.openclaw/workspace/scripts/wpp-as-role DEV ./.venv/bin/python manage.py test lobby.tests.UiScreenTests.test_legacy_templates_are_used_when_spa_flag_is_off lobby.tests.UiScreenTests.test_host_screen_can_render_angular_shell_when_feature_flag_enabled lobby.tests.UiScreenTests.test_host_screen_deeplink_preserves_spa_path_when_feature_flag_enabled lobby.tests.UiScreenTests.test_player_screen_can_render_angular_shell_when_feature_flag_enabled

Closes #201 ## Summary - add explicit staging rollout checklist for `USE_SPA_UI` cutover - define smoke-gate criteria before flag activation - document rollback checkpoints + required evidence fields for staging smoke artifact ## Validation - `/root/.openclaw/workspace/scripts/wpp-as-role DEV git -C /root/.openclaw/workspace/repos/weirsoe-party-protocol ls-remote --heads origin` - `/root/.openclaw/workspace/scripts/wpp-as-role DEV git -C /root/.openclaw/workspace/repos/weirsoe-party-protocol push --dry-run origin HEAD:refs/heads/dev/preflight-issue-201` - `/root/.openclaw/workspace/scripts/wpp-as-role DEV ./.venv/bin/python manage.py test lobby.tests.UiScreenTests.test_legacy_templates_are_used_when_spa_flag_is_off lobby.tests.UiScreenTests.test_host_screen_can_render_angular_shell_when_feature_flag_enabled lobby.tests.UiScreenTests.test_host_screen_deeplink_preserves_spa_path_when_feature_flag_enabled lobby.tests.UiScreenTests.test_player_screen_can_render_angular_shell_when_feature_flag_enabled`

dev-bot added 1 commit 2026-03-01 21:33:54 +01:00

docs(issue-201): define USE_SPA_UI rollout gate and rollback checkpoints

CI / test-and-quality (push) Successful in 3m33s

Details

CI / test-and-quality (pull_request) Successful in 3m38s

Details

bde56a2346

reviewer-bot approved these changes 2026-03-01 21:36:01 +01:00

reviewer-bot left a comment

Independent review (issue #201 acceptance):

✅ Rollout-checklist for USE_SPA_UI in staging is clearly documented (docs/spa-cutover-flag.md).
✅ Smoke-gate criteria are explicit and actionable before enabling flag (docs/UI_SMOKE.md + artifact template updates).
✅ Rollback path to legacy (USE_SPA_UI=false) is documented with verification + logging expectations.

Risk assessment:

Docs-only change (no runtime code/tests affected), so regression risk is low.
Guidance is consistent with issue #201 scope (staging prep only, no prod cutover policy change).

No blockers found.

Independent review (issue #201 acceptance): - ✅ Rollout-checklist for `USE_SPA_UI` in staging is clearly documented (`docs/spa-cutover-flag.md`). - ✅ Smoke-gate criteria are explicit and actionable before enabling flag (`docs/UI_SMOKE.md` + artifact template updates). - ✅ Rollback path to legacy (`USE_SPA_UI=false`) is documented with verification + logging expectations. Risk assessment: - Docs-only change (no runtime code/tests affected), so regression risk is low. - Guidance is consistent with issue #201 scope (staging prep only, no prod cutover policy change). No blockers found.

reviewer-bot approved these changes 2026-03-01 21:36:38 +01:00

reviewer-bot left a comment

LGTM

reviewer-bot commented

2026-03-01 21:36:46 +01:00

Review notes (independent QA against issue #201 acceptance):

✅ docs/spa-cutover-flag.md now contains a clear staging rollout checklist for USE_SPA_UI.
✅ Smoke-gate criteria before activation are explicit and testable.
✅ Rollback checkpoints and post-rollback verification to legacy routes are documented.

Assessment:

Docs-only PR (no runtime code changes), low regression risk.
Scope aligns with #201 (staging prep + verification criteria; no prod-cutover policy change).

No blockers from review side.

Review notes (independent QA against issue #201 acceptance): - ✅ `docs/spa-cutover-flag.md` now contains a clear staging rollout checklist for `USE_SPA_UI`. - ✅ Smoke-gate criteria before activation are explicit and testable. - ✅ Rollback checkpoints and post-rollback verification to legacy routes are documented. Assessment: - Docs-only PR (no runtime code changes), low regression risk. - Scope aligns with #201 (staging prep + verification criteria; no prod-cutover policy change). No blockers from review side.

integrator-bot merged commit 3bc3ff8cc1 into main

2026-03-01 21:38:05 +01:00

integrator-bot deleted branch dev/issue-201-spa-cutover-rollout-gate

2026-03-01 21:38:05 +01:00

integrator-bot referenced this issue from a commit

2026-03-01 21:38:07 +01:00

Merge pull request 'docs(issue-201): USE_SPA_UI rollout checklist + staging smoke-gate updates' (#214) from dev/issue-201-spa-cutover-rollout-gate into main

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wpp/weirsoe-party-protocol#214