Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
docs: search-modes and multi-source-brains match the shipped cap and warning (GBRA-156 /ship Step 14.5)
garrytan4addb5dca75c
diff --git a/docs/guides/multi-source-brains.md b/docs/guides/multi-source-brains.mdindex 4d9e708020..fa18c8d8fa 100644--- a/docs/guides/multi-source-brains.md+++ b/docs/guides/multi-source-brains.md@@ -139,7 +139,7 @@ sources, an OAuth client, a bound connection and a read that namescall, never widens what it reads. Federating a source never shows its`visibility: private` pages to a remote connection.-On a brain that is not managed, `gbrain sources add` warns on stderr when a new source is not federated, and+On a brain that is not managed, `gbrain sources add` without `--federated` or `--no-federated` warns on stderr that the new source is not federated, andwhen the sources an unscoped connection reads hold no page it also prints thenext step on stdout (`next: gbrain sources federate <id>`), and as `next`(`command`, `argv`, `why`) under `--json`. A managed brain's `sources add`diff --git a/docs/guides/search-modes.md b/docs/guides/search-modes.mdindex a29bd744d7..52c45bf523 100644--- a/docs/guides/search-modes.md+++ b/docs/guides/search-modes.md@@ -419,7 +419,7 @@ on user_asks_about(topic):4. **Token budget awareness.** A full page via `gbrain get` can be large. Read the search chunks first to confirm relevance before pulling the full page. "Did anyone mention the Series A?" -- search results (chunks) are probably enough. "Tell me everything about Alice" -- get the full page.5. **Full hybrid needs embeddings to have been run.** If `gbrain query` returns nothing but `gbrain search` finds results, the embeddings haven't been generated yet. Run the embedding pipeline first.6. **A populated `gbrain search` result set is not proof you found everything.** Neither verb expands by default, so synonym- and outcome-phrased matches can be missed even when a search returns plenty of hits. For "find every / all / the landscape of" questions, use `gbrain query`, adding `--expand` (one call to the configured expansion model, which needs an expansion provider) when the wording is likely to differ from the notes; expanded results are still a ranked top-K; for literal exhaustive enumeration ("list every page of type X"), use `list_pages` pagination. A nonzero count is not a completeness signal.-7. **A remote `search` or `query` with no `limit` returns at most a few pages that matched only by meaning.** Over MCP (HTTP or stdio), every page that matched the query's words, a name, an alias or an exact identity comes back, but pages that only the vector arm found fill the result only up to `search.remote_page_cap` distinct pages in total (default 3). Without the cap, an embedding-backed search on a small brain returned most of the brain on every call, pages the asking person may not be allowed to read included. When the cap leaves pages out, a line after the results says how many (`_meta.retrieval.page_cap` counts them); pass `limit` for the full ranked list, which landscape and "find every" questions usually want. Local CLI calls, an explicit `limit`, paged calls, image queries and host-run subagent tool calls are never capped; a thin-client CLI call is remote, so it is capped and prints the line on stderr (pass `--limit`). Set the cap with `gbrain config set search.remote_page_cap <n>`; `0` turns it off.+7. **A remote `search` or `query` with no `limit` returns at most a few pages that matched only by meaning.** Over MCP (HTTP or stdio), every page that matched the query's words, a name, an alias or an exact identity comes back, but pages that only the vector arm found fill the result only up to `search.remote_page_cap` distinct pages in total (default 3). Without the cap, an embedding-backed search on a small brain returned most of the brain on every call, pages from other members' sources included. When the cap leaves pages out, a line after the results says how many (`_meta.retrieval.page_cap` counts them); pass `limit` for the full ranked list, which landscape and "find every" questions usually want. Local CLI calls, an explicit `limit`, paged calls, image queries and host-run subagent tool calls are never capped; a thin-client CLI call is remote, so it is capped and prints the line on stderr (pass `--limit`). Set the cap with `gbrain config set search.remote_page_cap <n>`; `0` turns it off.### How to Verify