# Events (https://docs.neuralisapp.com/brain-core/events)

brain-core declares its notification events in the manifest; each one is
delivered only to members who hold its feature, belongs to the Files dock
(every one but `source.deleted` opens Files when clicked), and can be switched on or off in the notification settings. A
*resolving* event closes the warning it names, so a recovered failure does not
linger. How events are declared and delivered is on
[package-system events](https://docs.neuralisapp.com/package-system/events.md).

## Sources [#sources]

Gated by `files.read`, and about a source the recipient can read.

| Event | Default | When |
| --- | --- | --- |
| `source.sync.failed` | on (warning) | A sync did not complete; the Sources panel names the source |
| `source.sync.recovered` | off | A failed source synced again — resolves `source.sync.failed` |
| `source.sync.completed` | off | A full sync completed |
| `source.sync.cancelled` | off | A sync was cancelled |
| `source.reindex.completed` | off | A forced re-embed completed |
| `source.embedding.degraded` | on (warning) | Files are indexed and text-searchable, but their semantic embedding is owed (the provider was unavailable) |
| `source.embedding.recovered` | off | No embedding is owed any more — resolves `source.embedding.degraded` |
| `source.deleted` | off | A source was removed — resolves every notification still open about it |

A watcher-driven update never resolves a failed full sync.

## Review [#review]

Gated by `files.read`.

| Event | Default | When |
| --- | --- | --- |
| `pending.review.required` | on | Files written in this project wait for review in [Changes](https://docs.neuralisapp.com/brain-core/app-surfaces.md#changes) — one notification per burst, never one per file, and without naming the files |
| `pending.review.resolved` | off | Pending changes were approved, dismissed, discarded or reverted |

## Vector maintenance [#vector-maintenance]

Gated by `platform.vector.maintain`, and about an action the recipient started.

| Event | Default | When |
| --- | --- | --- |
| `vector.rebuild.completed` | on | The embedding rebuild switched the index to the target model — resolves `vector.rebuild.paused` |
| `vector.rebuild.paused` | on (warning) | The rebuild paused; Vector Health shows why and can resume it |
| `vector.maintenance.completed` | off | A collection action completed — resolves `vector.maintenance.failed` |
| `vector.maintenance.failed` | on (error) | A collection action did not complete |
