Reservoirs Are Now Brains
Content Reservoirs were folded into brains. Where your reservoirs, keywords and captured items went, and which tools to use now.
BlackOps used to have two places for knowledge: reservoirs and brains. Now it has one. Every reservoir was moved onto a brain, its monitoring became a brain watch, and the Reservoirs pages are gone from the app. This page is the short version of what changed. Old reservoir links in the app and the docs bring you to the right brain or to this page.
What Happened to Your Reservoirs
Each reservoir was migrated once. Running the migration again changes nothing.
- It became a brain. Each reservoir was mapped to an existing brain, or to a new brain named after it with the same description.
- Its keywords became a watch. Monitored keywords, platforms and subreddits became a keyword watch on that brain. Keywords you had switched off came across as a watch that is turned off.
- Your curated items came with it. Items you bookmarked, or that fed a draft, became ordinary notes in the brain.
- Everything else was archived, not deleted. Unread discovery results were archived. They can be restored.
- Captures go to Triage. Inbound email, Idea Inbox routing, browser extension capture and "add to brain" from monitoring now land in the Triage lane of the mapped brain.
- The record of which brain each reservoir became is kept. That is what lets old reservoir links find their brain now that the reservoir data itself is gone.
Where Things Live Now
| You used to | Now you |
|---|---|
| Open Reservoirs in the sidebar | Open Brain in the sidebar and pick a brain |
| Set monitored keywords on a reservoir | Add a watch on the brain's Watch tab (Brain Watches) |
| Send email to a reservoir's address | Send it to the same address. It now belongs to the brain, on its Email tab (Email Addresses) |
| Review new reservoir items | Promote or dismiss them on the brain's Triage tab |
| Send a link or transcript into a reservoir | Send it to a brain with post_brain_ingest (Brain Ingest) |
| Extract a video transcript on a reservoir item | Transcribe it with transcribe_video, then send the text to a brain with post_brain_ingest |
| Call the reservoir API or the reservoir MCP tools | Use the brain tools below. Tables and tools removed: the reservoir API routes, six reservoir MCP tools and the reservoir tables are gone. Old /admin/reservoirs links still open the right brain |
For a full walkthrough, read Keep a Brain Current.
Chat and the Post Editor
Chat no longer reads from a reservoir linked to the post. It looks across all of your site's brains and picks the notes that match your question. Only approved notes are used. Items still waiting in Triage, and items you dismissed, never reach an answer. The notes chat drew on are counted under the answer as Context Sources. Click the count to see which notes they were.
The post editor's Reservoir card is gone. There is nothing to link: every post gets the same brain context.
In Operator Chat, ask "what brains do I have?" to list them.
Tool Replacements
Six reservoir MCP tools have been removed. post_reservoir_ingest is the only one left, and it is deprecated. Use the replacement for each.
| Old tool | Use instead |
|---|---|
post_reservoir_ingest (deprecated) | post_brain_ingest |
list_reservoirs (removed) | list_brains |
get_reservoir (removed) | get_brain |
list_reservoir_items (removed) | list_notes with brain_id, or list_triage for unreviewed items |
get_reservoir_item (removed) | get_note |
patch_reservoir_item (removed) | patch_notes |
delete_reservoir_item (removed) | delete_notes, or dismiss_triage_item for an unreviewed item |
post_reservoir_ingest is a thin layer over brain ingest. With a brain_id it writes to that brain. With a reservoir_id it writes to the brain that reservoir became. A reservoir that never became a brain is refused, because reservoirs no longer accept items. delete_notes has no times_referenced guard, so check a note's times_referenced before deleting it.
Related
- Keep a Brain Current: set up watches and work the Triage lane.
- Brain Watches: watch types, scoring and the MCP tools.
- Brain Triage Lane: promote, dismiss and expiry.