# Studio Bellona Interchange Asset Cache Troubleshooting

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.
