From 9e0ca361eb7fff1a201e73cd1776c76f589c7a2c Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Tue, 18 Aug 2026 10:02:12 -0700 Subject: [PATCH] docs: update project documentation for v1.68.0.0 BROWSER.md: fix the $B cdp example (positional JSON params, not --json; depth is the real CDP param) and add the new perf-throttling examples (Emulation.setCPUThrottlingRate, Network.emulateNetworkConditions) with their clear-override counterparts. USING_GBRAIN_WITH_GSTACK.md: the state-files table row for the sync queue now names the maildir-style spool dir .brain-queue.d/ that replaced .brain-queue.jsonl this release. Co-Authored-By: Claude Fable 5 --- BROWSER.md | 8 +++++++- USING_GBRAIN_WITH_GSTACK.md | 2 +- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/BROWSER.md b/BROWSER.md index dfd4774bf..cc489c904 100644 --- a/BROWSER.md +++ b/BROWSER.md @@ -1164,7 +1164,13 @@ untrusted). Untrusted methods (data-exfil-shaped, e.g. ```bash $B cdp Page.getLayoutMetrics $B cdp Network.enable -$B cdp Accessibility.getFullAXTree --json '{"max_depth":5}' +$B cdp Accessibility.getFullAXTree '{"depth":5}' + +# Perf measurement on a simulated low-end client (overrides persist on the +# tab until you clear them — callers own restoration): +$B cdp Emulation.setCPUThrottlingRate '{"rate":4}' # clear: '{"rate":1}' +$B cdp Network.emulateNetworkConditions '{"offline":false,"latency":150,"downloadThroughput":195000,"uploadThroughput":97500}' +# clear: '{"offline":false,"latency":0,"downloadThroughput":-1,"uploadThroughput":-1}' ``` To discover allowed methods: read `browse/src/cdp-allowlist.ts`. diff --git a/USING_GBRAIN_WITH_GSTACK.md b/USING_GBRAIN_WITH_GSTACK.md index 06e50faed..de54abeb3 100644 --- a/USING_GBRAIN_WITH_GSTACK.md +++ b/USING_GBRAIN_WITH_GSTACK.md @@ -241,7 +241,7 @@ Gbrain itself ships with these that gstack wraps: | `~/.gbrain/config.json` | Engine (pglite/postgres), database URL or path, API keys. Mode 0600. Written by `gbrain init`. | | `~/.gstack/gbrain-repo-policy.json` | Per-remote trust triad. Schema v2. Mode 0600. | | `~/.gstack/.setup-gbrain.lock.d` | Concurrent-run lock (atomic mkdir). Released on normal exit + SIGINT. | -| `~/.gstack/.brain-queue.jsonl` | Pending sync entries for gstack memory sync | +| `~/.gstack/.brain-queue.d/` | Pending sync records for gstack memory sync — maildir-style spool, one file per record. A legacy `.brain-queue.jsonl` from older releases migrates automatically on the next drain. | | `~/.gstack/.brain-last-push` | Timestamp of last sync push (for `/health` scoring) | | `~/.gstack-artifacts-remote.txt` | URL of your gstack memory sync remote (safe to copy between machines; legacy name `~/.gstack-brain-remote.txt` still read) | | `~/.gstack/.setup-gbrain-inflight.json` | Reserved for future `--resume-provision` persisted state |