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 +16 -0
- package/TOOLS.md +3 -2
- package/build-info.json +4 -4
- package/package.json +1 -1
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` |
|
|
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
|
|
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.
|
|
4
|
-
"sha": "
|
|
5
|
-
"shaShort": "
|
|
3
|
+
"version": "0.43.46",
|
|
4
|
+
"sha": "a57f85f08833b98c46ae3b5b171cc0eec520bd25",
|
|
5
|
+
"shaShort": "a57f85f0",
|
|
6
6
|
"branch": "detached",
|
|
7
7
|
"dirty": false,
|
|
8
|
-
"packedAt": "2026-11-
|
|
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.
|
|
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",
|