Eve library

Studio Bellona Interchange Asset Cache Troubleshooting

Runbook

Revision 1

On this page

Status: Active
Owner: Bellona Domain Engineering + Studio Web
Last Updated: 2026-02-24
Related:

  • docs/releases/v1/specs/studio-bellona-interchange-asset-cache-route-map.md
  • apps/oshun/web/src/components/studio/StudioBellonaInterchangeAssetCacheWorkspace.tsx

policy-role-tier-mismatch#

Symptoms:

  • Policy state reports role-tier mismatch
  • Wizard, reconnect, or sensitive bulk controls are disabled

Actions:

  1. Set actor role and permission tier to a valid policy pair.
  2. Ensure policy justification has at least 12 characters for non-baseline tiers.
  3. Re-run blocked actions and verify denied-action summaries clear.

stream-reconnect-instability#

Symptoms:

  • Reconnect count rises repeatedly for the same cache cohort
  • Stream indicator stays lagging or oscillates during reconnect attempts

Actions:

  1. Pause stream updates for 5-10 seconds, then resume.
  2. Reconnect one cache first and validate stream lag recovery before bulk reconnect.
  3. Check observability latency/failure panels for sustained degradation.

import-parity-drifts#

Symptoms:

  • API parity report shows mismatches or missing IDs
  • Imported payload diverges on tier/state/owner/shard metadata

Actions:

  1. Export the current payload and keep the snapshot.
  2. Normalize cacheId, tier/state, owner, and shard count fields.
  3. Re-import corrected payload and re-run API parity validation.

release-gate-signoff-readiness#

Symptoms:

  • Release promotion blocked despite healthy cache metrics
  • Evidence chain for policy, diagnostics, and change history is incomplete

Actions:

  1. Resolve policy warnings and confirm justification readiness.
  2. Validate observability metrics and parity checks are passing.
  3. Attach audit trail evidence and retry owner signoff workflow.