Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

Add the changelog entry and name --no-open-pages in the access guide

garrytan0abec4bb4808
diff --git a/changelog.d/capy-open-shared-pages-gst2670.md b/changelog.d/capy-open-shared-pages-gst2670.md
new file mode 100644
index 0000000000..6f30dce702
--- /dev/null
+++ b/changelog.d/capy-open-shared-pages-gst2670.md
@@ -0,0 +1,5 @@
+**On a brain that serves several people, gbrain now counts the pages with no label, which every member's key can still read, and names the commands that close them; `--labelled-only` keeps members to the pages labelled for them.**
+
+### Added
+- **Open pages count (GST-2670).** A key bound to a member reads a page that has no label like any other key, so a chat export or mail import loaded before anyone named its readers is open to every member. gbrain now counts those pages, read-only, in the `gbrain access serves several` preview and receipt (also shown by `gbrain setup <harness> --serves several`), in `gbrain access serves`, in the new doctor check `open_shared_pages` and in `gbrain post-upgrade`. Each shows how many members' keys read them, the top folders, and the commands that label them, with the owner already in every reader list. A `visibility: private` page counts as open only when remote private pages are on for this brain or a reading member's grant opens its source. Doctor warns while DM, chat, conversation or mail pages are open and reports other open folders as information. The count changes nothing, never changes an exit code, and doesn't run on a one-person brain. `gbrain access serves --no-open-pages` skips it. See docs/guides/access-designations.md#pages-every-members-key-can-read.
+- **`--labelled-only` (GST-2670).** `gbrain access serves several --members <ids> --labelled-only` and `gbrain setup <harness> --serves several --labelled-only` keep each member's key to the pages labelled for that member. It is opt-in and never applies to the owner, so with the owner in the roster the run is BLOCKED before anything is written. Without the flag, no existing key reads anything different.
diff --git a/docs/guides/access-designations.md b/docs/guides/access-designations.md
index ad92037665..25e64a9ded 100644
--- a/docs/guides/access-designations.md
+++ b/docs/guides/access-designations.md
@@ -274,7 +274,8 @@ every reader list:
The count never depends on who runs it, changes nothing, and never changes an exit code. Doctor warns while DM, chat,
conversation or mail pages are open and reports other open folders as information, since a team may share them on
purpose. A count that fails prints "count unknown" with `gbrain doctor --only open_shared_pages --json` to retry, and
-setup carries on. A one-person brain, or one with `access.serves` set to `one`, runs no count. `--labelled-only` is
+setup carries on. A one-person brain, or one with `access.serves` set to `one`, runs no count, and
+`gbrain access serves --no-open-pages` skips it. `--labelled-only` is
opt-in and never applies to the owner: with the owner in the roster the run is BLOCKED before anything is written.
## Related