# Bellona C++ SDK Workspace Troubleshooting

## Stream Reconnect Failures

- Confirm the active record is still present in the list view.
- Validate policy role and tier allow `streamWrite` mutations.
- Trigger `Reconnect active record` and verify stream notice/audit entries.

## API Parity Validation Failures

- Run `Run API parity checks` and inspect each failed check card.
- Export current state and compare package namespaces with `@oshun/*` policy.
- Re-import a known-good payload to restore stream/collaboration coverage
  parity.

## Policy Permission Blocks

- Inspect policy panel gates for `readRecords`, `listWrite`, `wizardWrite`,
  `collaborationWrite`, and `streamWrite`.
- For restricted tier mutations, enter justification before retrying.
- Switch to `admin` role when restricted-tier wizard mutations are required.
