pi-bro 0.22.0 → 0.22.2

package/bro.ts

@@ -1567,7 +1567,7 @@ export function helpText(settings?: BroSettings, settingsError?: string, prefere
 		: `Bro could not read its settings: ${settingsError}\n\nRun \`/bro doctor\` for setup help.`;
 	return `# Bro
 
-Quick reference. The README is the full user guide: https://github.com/tranhoangnguyen03/pi-bro#readme
+Quick reference. Full user guide: https://github.com/tranhoangnguyen03/pi-bro/blob/main/docs/user-guide.md
 
 ## Explain and show
 
@@ -1633,7 +1633,7 @@ The mode decides how much of the source to keep; your preferences decide who it'
 
 ## Privacy
 
-Bro sends the captured source (or, for the advisor, the executor's instructions, tools, and conversation) to the selected backend and its model provider, which may retain it under their own policies. Your preferences go with every explain, show, btw, and Guided Review request. Guided Review sends PR data/diff and relevant private questions; records/source remain locally under getAgentDir()/bro-reviews. Copy finding goes to the system clipboard, not GitHub. Nothing is added to Pi's conversation unless you insert it. Access controls differ by backend; see the README.`;
+Bro sends the captured source (or, for the advisor, the executor's instructions, tools, and conversation) to the selected backend and its model provider, which may retain it under their own policies. Your preferences go with every explain, show, btw, and Guided Review request. Guided Review sends PR data/diff and relevant private questions; records/source remain locally under getAgentDir()/bro-reviews. Copy finding goes to the system clipboard, not GitHub. Nothing is added to Pi's conversation unless you insert it, except advisor answers, which return to the agent as tool results. Access controls differ by backend; see the user guide.`;
 }
 
 // The overlay framing pattern is adapted from pi-btw (MIT); see THIRD_PARTY_NOTICES.md.

package/docs/README.md

@@ -1,10 +1,14 @@
 # pi-bro docs
 
-- [README](../README.md) — the user guide (authoritative for behavior).
+- [README](../README.md) — the short overview: install, try it, requirements, data flow.
+- [user-guide.md](user-guide.md) — the full user guide (authoritative for behavior).
 - [guided-review.md](guided-review.md) — current Guided Review behavior, optional controls, access/storage and limits.
+- [pig-compatibility.md](pig-compatibility.md) — experimental PiG support and its limits.
 - [DEVELOPMENT.md](DEVELOPMENT.md) — code map, settings and BTW continuation model, invariants, test commands.
 - [TESTING.md](TESTING.md) — the manual end-to-end checklist across backends.
+- [test-consolidation.md](test-consolidation.md) — the #74 test coverage ledger.
+- [PUBLIC-PRESENTATION.md](PUBLIC-PRESENTATION.md) — how pi-* repos present themselves publicly; sister repos follow it too.
 - [dev/README.md](../dev/README.md) — manual review launcher and profile/call precautions (not shipped).
 - [plans/](plans/README.md) — historical design notes and plans; not the current spec.
-- [images/](images/) — screenshots used by the README.
+- [images/](images/) — screenshots used by the README and user guide.
 - [benchmark/README.md](../benchmark/README.md) — the manual, live prompt benchmark.

package/docs/pig-compatibility.md

@@ -31,7 +31,7 @@ Bro follows the host's `getAgentDir()`: normally `~/.pi/agent` on Pi and `~/.pig
 
 ```sh
 npm test
-PIG_BIN=/absolute/path/to/pig sh pig-test.sh
+PIG_BIN=/absolute/path/to/pig sh test/pig-test.sh
 ```
 
 The PiG lane checks the exact binary version, real host settings isolation, advisor snapshot compaction/branch projection, and the existing fake-backend RPC smoke suite. Existing Node tests cover backend cancellation/process cleanup and modal geometry, but are not substitutes for real-host interactive tests.