Scope#
This runbook supports the Bellona Format Registry workspace:
- Route map:
docs/releases/v1/specs/studio-bellona-format-registry-route-map.md - Workspace route:
/studio/bellona/format-registry
policy-denials#
Symptoms:
- Create/edit wizard, reconnect, import/export, or parity controls are disabled.
- Policy panel shows
role-tier mismatchorJustification: required.
Checks:
- Confirm role and tier alignment in policy context.
- Confirm justification text length is at least 12 characters for non-baseline tiers.
- Confirm approval actions are only attempted at restricted tier.
Recovery:
- Set role/tier to an allowed combination.
- Provide explicit rationale text in policy justification.
- Re-run blocked action and verify policy denial banner clears.
stream-reconnect-instability#
Symptoms:
- Stream state remains
laggingorofflineafter reconnect attempts. - Reconnect counts continue rising without stabilizing latency.
Checks:
- Verify stream is not paused.
- Validate selected records are in scope and reconnect is not already in-flight.
- Inspect observability panel for p95 latency and failure-rate spikes.
Recovery:
- Run row reconnect for targeted records.
- Run bulk reconnect for selected cohorts after scope narrowing.
- If instability persists, pause stream updates, capture audit + telemetry evidence, and escalate.
api-parity-drifts#
Symptoms:
- API parity report is
fail. - Report lists missing local IDs, missing baseline IDs, or field mismatches.
Checks:
- Export current payload for forensic snapshot.
- Inspect parity mismatch lines to identify direction/status/owner/version/handler drift.
- Confirm imported payload provenance and schema contract.
Recovery:
- Import a known-good exported payload from a healthy baseline.
- Re-run API parity validation and confirm
API parity: pass. - Capture change-history entry and telemetry trace before release decisions.