Implement phased modernization infrastructure for transitioning from multi-page legacy routing to SPA portal-shell architecture, plus post-delivery hardening fixes for policy loading, fallback consistency, and governance drift detection. Key changes: - Add route contract enrichment with scope/visibility/compatibility policies - Canonical 302 redirects from legacy direct-entry to /portal-shell/ routes - Asset readiness enforcement and runtime fallback retirement for in-scope routes - Shared feature-flag helpers (env > config > default) replacing duplicated _to_bool - Defensive copy for lru_cached policy payloads preventing mutation corruption - Unified retired-fallback response helper across app and blueprint routes - Frontend/backend route-contract cross-validation in governance gates - Shell CSS token fallback values for routes rendered outside shell scope - Local-safe .env.example defaults with production recommendation comments - Legacy contract fallback warning logging and single-hop redirect optimization Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.0 KiB
1.0 KiB
MODIFIED Requirements
Requirement: Deferred-route assets SHALL be release-ready before promotion
Deferred routes SHALL adopt release-time asset-readiness checks and SHALL fail promotion when required assets are missing.
Scenario: Deferred-route readiness validation
- WHEN release artifacts are prepared for follow-up phase promotion
- THEN required assets for
/tables,/excel-query,/query-tool, and/mid-section-defectSHALL be validated - THEN missing required assets SHALL fail release gating
Requirement: Deferred-route runtime fallback SHALL be retired by governed policy
Deferred routes SHALL not remain on runtime fallback posture after follow-up modernization completion criteria are met.
Scenario: Deferred-route fallback retirement
- WHEN a deferred route passes readiness + parity + manual acceptance gates
- THEN runtime fallback posture for that route SHALL be retired according to milestone policy
- THEN rollback control SHALL remain available via explicit route-level governance switch