# Studio Bellona Asset Interchange Formats Troubleshooting

## reconnect-instability

Symptoms:

- Reconnect actions remain in progress and stream links stay `lagging` or
  `offline`.
- Stream indicator reports repeated reconnect attempts without recovery.

Resolution:

1. Confirm policy role/tier alignment so reconnect controls are not denied.
2. Run single-row reconnect first, then bulk reconnect for remaining degraded
   formats.
3. Review stream event history for specific format IDs with repeated failures.
4. Use audit undo to revert recent risky mutations before retrying reconnect.
5. Escalate with format ID, stream timestamps, and reconnect counts when
   recovery fails.

## policy-denials

Symptoms:

- Wizard, bulk, import/export, or approval actions show denied states.
- Policy permission state lists blocked actions.

Resolution:

1. Set actor role and permission tier to an allowed combination.
2. Provide policy justification with sufficient operational context.
3. Use `release_admin` + `restricted` for restricted approval paths.
4. Retry the blocked action and verify telemetry outcome transitions to
   `success`.

## import-parity-drifts

Symptoms:

- API parity report returns `fail`.
- Mismatch list includes owner, schema, state, or family drift.

Resolution:

1. Export a known-good payload before edits and keep it as rollback baseline.
2. Import vetted payload content and rerun API parity validation.
3. Resolve each mismatch field directly in wizard or source payload.
4. Confirm parity report `pass` and zero missing IDs before production signoff.
