The layers
Brain object, so a search from the CLI, an MCP tool call and a request to /api/search return the same result.
Three kinds of content
Transcripts do not go into person pages. Store the transcript as a source and link to it.
The index
The index is a SQLite file at.brain/index.sqlite. It is rebuilt when files change and is never committed. The web app does not make a request wait for a rebuild: when files change outside the process, for example after a sync, it serves the previous index and rebuilds in the background.
Who can write what
Every write has an actor. The owner’s writes apply directly. For any other actor:
Proposals are JSON files in
proposals/ and appear in the web app under Review.