Events
The source-sync, review and vector-maintenance notifications brain-core declares for the notification inbox.
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.
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
Gated by files.read.
| Event | Default | When |
|---|---|---|
pending.review.required | on | Files written in this project wait for review in 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
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 |
App surfaces
The Files widget and dock, and the filesystem-change card: browsing and searching sources, Git Control, the editor, Changes review, and the Sources and Vector Health panels.
Config settings
brain-core's platform settings — embedding, sync and watching, indexing limits, reading, search and listing, vector maintenance, review, discovery and git — and where to change them.