pi-braid 0.43.45 → 0.43.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -80,6 +80,22 @@ record; the tag scheme above applies unchanged.
80
80
  contract; a new fixture covers both trees, the scoping and the absent-versus-empty
81
81
  populations.
82
82
 
83
+ ## Contrib — the pi-braid-contrib bundle gains a `git` tool (2026-11-11)
84
+
85
+ A census of 4,387 session files counted 27,200 `git` calls through the shell, 9,551 of them a single
86
+ read-only subcommand: the largest class that needs no shell semantics at all. The new `git` tool takes
87
+ an argv array, never a command string, and refuses an argument carrying a shell metacharacter before
88
+ anything spawns. Read-only subcommands run freely; anything else needs `write: true`, which is gated
89
+ rather than trusted — the call refuses on a dirty tree and names the dirty paths, because that is the
90
+ state where an agent's tidy-up becomes someone's lost work. A data table refuses the destructive
91
+ shapes (`push --force`, `reset --hard`, `clean -fdx`, `filter-branch`, `reflog expire`,
92
+ `gc --prune=now`, `branch -D` of an unmerged branch) with its own message each. Output is bounded and
93
+ reports its truncation in bytes and lines; a non-zero exit is a result, not an exception.
94
+
95
+ Adding a thirteenth extension moves the counts six source claims pin to the manifest, and the
96
+ schema's recorded line for the `braid.contrib.*` reader; `check:doc-drift` and `check:schema` demanded
97
+ both repairs in the same commit.
98
+
83
99
  ## Core — 0.43.45 (2026-11-11: a re-read is a covered range, not a repeated path)
84
100
 
85
101
  The re-read whisper keyed `recentlyReadFiles` on the path, so a second slice of one document in a turn
package/TOOLS.md CHANGED
@@ -29,7 +29,7 @@ fails until the other catches up.
29
29
  | Braid-registered tools | 24 | Registered via `pi.registerTool()` in `src/extensions/` - owned by this package |
30
30
  | pi-native core tools | 9 | `read`/`bash`/`edit`/`write`/`grep`/`find`/`ls`/`powershell` - pi builtins surfaced through the package with stable one-liners (`TOOL_GUIDELINES`, `prompt-builder/tool-guidelines.ts`); `tool_search` is pi's built-in tool-search extension, activated by braid at session start |
31
31
  | **Documented catalog** | **33** | the rows between the markers below |
32
- | In-repo sibling `pi-braid-contrib` | 12 extensions | browser, codebase, diff, healthcheck, observatory, repl, sleep, system-monitor - **not owned by this package**, see appendix |
32
+ | In-repo sibling `pi-braid-contrib` | 13 extensions | browser, codebase, diff, healthcheck, observatory, repl, sleep, system-monitor - **not owned by this package**, see appendix |
33
33
  | Third-party npm packages | web_search/fetch_content/source_check/get_search_content (pi-web-access); herdr\*\* (@ogulcancelik/pi-herdr) | **not owned by this package**, see appendix |
34
34
 
35
35
  ## Enablement reference
@@ -126,7 +126,7 @@ fall back to the first sentence of their description.
126
126
  ### pi-braid-contrib (in-repo workspace)
127
127
 
128
128
  `pi-braid-contrib` is the sibling `packages/contrib` workspace of this monorepo.
129
- Its 12 extensions are all enabled by default with a per-extension toggle via
129
+ Its 13 extensions are all enabled by default with a per-extension toggle via
130
130
  `braid.contrib.<name>` in
131
131
  `~/.pi/agent/settings.json` (e.g. `"browser": false` drops the whole browser family).
132
132
  Tool families it registers:
@@ -134,6 +134,7 @@ Tool families it registers:
134
134
  - **browser** - `browser_navigate`, `browser_snapshot`, `browser_eval`, `browser_screenshot` (plus `browser_content`, `browser_cookies`, `browser_tabs_*` in the full family). Drive a real browser tab for JS-heavy pages.
135
135
  - **codebase** - analyze a codebase's structure or module dependency graph (tree/graph/impact).
136
136
  - **diff** - `file_diff`: compare two files or git revisions (unified hunks and stats).
137
+ - **git** - `git`: one git subcommand from an argv array, read-only by default; `write: true` needs a clean tree and a fixed refusal list for the destructive shapes.
137
138
  - **healthcheck** - comprehensive health checks on tools, extensions, and system resources.
138
139
  - **observatory** - inspect the current pi session (status, registered tools, recorded events).
139
140
  - **repl** - execute JavaScript code with context (RLM mode for chunk/search/map/reduce).
package/build-info.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "pi-braid",
3
- "version": "0.43.45",
4
- "sha": "615ea4c889b4ed58120ba82f1a3d8a4150df29fb",
5
- "shaShort": "615ea4c8",
3
+ "version": "0.43.46",
4
+ "sha": "a57f85f08833b98c46ae3b5b171cc0eec520bd25",
5
+ "shaShort": "a57f85f0",
6
6
  "branch": "detached",
7
7
  "dirty": false,
8
- "packedAt": "2026-11-10T22:28:49.644Z"
8
+ "packedAt": "2026-11-11T08:48:25.856Z"
9
9
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-braid",
3
- "version": "0.43.45",
3
+ "version": "0.43.46",
4
4
  "description": "🥨 Braid - Metacognitive extension suite for pi coding agent: Adds memory, plan tracking, structured cognitive signals and completion checks on top of pi core loop, so long sessions keep their context and stop claiming unfinished work.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",