pi-braid 0.43.51 → 0.43.53
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 +32 -0
- package/TOOLS.md +3 -2
- package/build-info.json +4 -4
- package/docs/SETUP.md +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -96,6 +96,38 @@ Adding a thirteenth extension moves the counts six source claims pin to the mani
|
|
|
96
96
|
schema's recorded line for the `braid.contrib.*` reader; `check:doc-drift` and `check:schema` demanded
|
|
97
97
|
both repairs in the same commit.
|
|
98
98
|
|
|
99
|
+
## Contrib — a design audit that measures a rendered page (2026-11-12)
|
|
100
|
+
|
|
101
|
+
The measurement everything in the design program is judged by, as a tool: `design_audit` renders a page at
|
|
102
|
+
declared widths and reports, per width, the dominant colours with their coverage, the contrast ratio of
|
|
103
|
+
every text-bearing element against its effective background with the failing pairs named by selector path,
|
|
104
|
+
the distinct font sizes, weights, line-heights, spacings, radii and shadows in use with whether the project's
|
|
105
|
+
`DESIGN.md` holds each value, tap targets under 44 px, and elements that overflow their container. The
|
|
106
|
+
measurement is a pure function over a DOM snapshot, so the gate runs on recorded fixtures instead of a live
|
|
107
|
+
browser: a page with seven planted defects reports exactly those seven, a page with none reports zero, and
|
|
108
|
+
two runs over the same snapshot are byte-identical. On the dating app's built page it found four sub-44 px
|
|
109
|
+
targets, one off-grid spacing used eight times, and four icon wrappers overflowing their boxes, and it
|
|
110
|
+
reports one skipped element rather than guessing: a heading painted by a gradient clipped to its glyphs.
|
|
111
|
+
|
|
112
|
+
## Release — three fixes that never left the monorepo (2026-11-12)
|
|
113
|
+
|
|
114
|
+
The publisher skips a workspace whose version is already on the registry, and three fixes landed in
|
|
115
|
+
workspaces whose versions did not move. Green CI, a published core tarball, and nothing shipping is the
|
|
116
|
+
result: the transport class in the provider's failure classifier, the poller heartbeat's non-fatal write,
|
|
117
|
+
and the contrib git tool were all on `main` and in no tarball anyone installs.
|
|
118
|
+
|
|
119
|
+
Steady versions do not mean steady content. The guard is now visible as a defect of the release process
|
|
120
|
+
rather than of any one change: before this entry, `pi-braid-providers` 1.0.6, `pi-braid-telegram` 0.1.9
|
|
121
|
+
and `pi-braid-contrib` 0.1.4 were each their published version and each carried a change the published
|
|
122
|
+
tarball did not have. All three move here, with the fixes they already hold:
|
|
123
|
+
|
|
124
|
+
- `pi-braid-providers` 1.0.7: a port is not an HTTP status, and a connect timeout or a reset classifies
|
|
125
|
+
as transport instead of a shape refusal, so the route walk stops rotating away from a provider that
|
|
126
|
+
refused nothing.
|
|
127
|
+
- `pi-braid-telegram` 0.1.10: a poller-lock write that cannot land is reported on the heartbeat handle
|
|
128
|
+
instead of throwing out of a timer and ending the process.
|
|
129
|
+
- `pi-braid-contrib` 0.1.5: the git tool, argv-only and read-only by default.
|
|
130
|
+
|
|
99
131
|
## Core — a prefix is ranked, never qualifying on its own (2026-11-11)
|
|
100
132
|
|
|
101
133
|
The same defect as the class noun, one leg over: `improve` starts `improvement`, so the token-prefix leg
|
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` | 14 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,13 +126,14 @@ 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 14 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:
|
|
133
133
|
|
|
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
|
+
- **design** - `design_audit`: render a page at declared widths and measure contrast, colour coverage, type and space values, tap targets, overflow, and DESIGN.md token verdicts.
|
|
136
137
|
- **diff** - `file_diff`: compare two files or git revisions (unified hunks and stats).
|
|
137
138
|
- **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.
|
|
138
139
|
- **healthcheck** - comprehensive health checks on tools, extensions, and system resources.
|
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.53",
|
|
4
|
+
"sha": "b12ccc14af51a3c7d8b4677e3d0edead69a36eb7",
|
|
5
|
+
"shaShort": "b12ccc14",
|
|
6
6
|
"branch": "detached",
|
|
7
7
|
"dirty": false,
|
|
8
|
-
"packedAt": "2026-11-
|
|
8
|
+
"packedAt": "2026-11-11T23:21:24.935Z"
|
|
9
9
|
}
|
package/docs/SETUP.md
CHANGED
|
@@ -349,7 +349,7 @@ The full surface as a single file: [`examples/full-config.settings.json`](../../
|
|
|
349
349
|
|
|
350
350
|
The 12 contrib extension names: `browser`, `codebase`, `diff`, `healthcheck`, `networkMonitor`, `observatory`, `pathSecurity`, `rateLimiter`, `repl`, `sleep`, `systemMonitor`, `toolConfig`.
|
|
351
351
|
|
|
352
|
-
- Loaded through the convenience bundle (`packages/contrib/index.ts` as an extension entry): `braid.contrib.<name>: false` skips that extension entirely; absent or `true` loads it. With `packages/contrib` registered as a package, pi loads all
|
|
352
|
+
- Loaded through the convenience bundle (`packages/contrib/index.ts` as an extension entry): `braid.contrib.<name>: false` skips that extension entirely; absent or `true` loads it. With `packages/contrib` registered as a package, pi loads all 14 directly and these booleans are not read.
|
|
353
353
|
- Behavior keys (honored in both load paths):
|
|
354
354
|
- `braid.contrib.browserAdvanced: true` - the 7 advanced browser tools (opt-in).
|
|
355
355
|
- `braid.contrib.pathSecurity.block: true` - hard-block dangerous operations instead of soft-warn.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-braid",
|
|
3
|
-
"version": "0.43.
|
|
3
|
+
"version": "0.43.53",
|
|
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",
|