TenantAtlas/specs/293-post-cutover-suite-stabilization/data-model.md
Ahmed Darrazi 1d28ffcca7
Some checks failed
PR Fast Feedback / fast-feedback (pull_request) Failing after 7m10s
fix: stabilize post-cutover suite baseline
2026-05-11 08:33:32 +02:00

3.5 KiB

Data Model: Post-Cutover Suite Stabilization & Baseline Reconciliation

Overview

293 introduces no new application entity, table, or persisted runtime artifact. Its only modeled data is spec-local preparation truth for later implementation: one failure-classification artifact, one bounded failure-category inventory, and one bounded stabilization-seam inventory.

Pinned Failure-Classification Categories

Category Meaning Default Treatment in 293
cutover-baseline-debt stale test or baseline expectation caused directly by the 287 and 288 cutover truth fix in 293
cutover-runtime-regression current workspace-first primary path is actually broken allow minimal targeted fix in 293 if proven
unrelated-existing-debt existing failure outside the cutover stabilization scope document, do not silently absorb
flaky-or-environment nondeterministic or environment-specific failure isolate, rerun, and document
resolved-or-not-needed initially suspected cutover debt that no longer needs work after classification or adjacent repair record and stop

Pinned Stabilization Seams

Seam Key Meaning Primary Targets
tenant_panel_baseline tests still assuming TenantPanel or panel: 'tenant' as current runtime truth panel navigation and adjacent helper expectations
legacy_admin_t_routes tests still expecting /admin/t/... management paths to behave as canonical runtime routes panel navigation, required-permissions, provider routes
workspace_aware_operations_routes tests or helpers generating operations routes without workspace context OpsUx helpers, action-surface links, operations route tests
legacy_required_permissions_provider_connections tests still expecting tenant-scoped required-permissions or provider-connection URLs to be canonical provider-connection and verification-adjacent surfaces
action_surface_rebaseline stale action expectations caused only by workspace-first, environment-scope, or TenantPanel removal action-surface, RBAC, and adjacent Filament expectations

Spec-Local Artifact: failure-classification.md

Field Meaning
Group failing test, test family, or lane-visible group
Seam one or more pinned stabilization seams, or N/A when the failure is unrelated
Category one pinned failure category
Reason short explanation for why the group belongs to that category
Fix In 293? yes, no, or only-if-proven-runtime-regression
Follow-up next action if the group remains open
Status current implementation-tracking note

Invariants

  • The same five failure-classification categories must appear in spec.md, plan.md, tasks.md, research.md, quickstart.md, checklists/requirements.md, and failure-classification.md.
  • The same five stabilization seams must appear in spec.md, plan.md, tasks.md, research.md, and failure-classification.md.
  • 293 introduces no new runtime product state and no new runtime persistence.
  • 293 must not reactivate TenantPanel, /admin/t/..., or tenant-scoped provider fallback routes.
  • 293 must keep the Spec 288 proof pack and browser anchors green.

Out-of-Scope Data Changes

  • no database migrations by default
  • no new provider registry or provider execution contract
  • no new RBAC role family or persisted access overlay
  • no new browser fixture family
  • no new runtime ledger or stabilization table