pi-braid 0.43.52 → 0.43.54

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
@@ -96,6 +96,29 @@ 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
+ ## Skills — the VPN skill names the surface that actually starts a tunnel (2026-11-12)
100
+
101
+ A VPN profile was disconnected for hours and the operator clicked Connect by hand, because the skill's
102
+ recovery table pointed at the client's URL schemes and the client's bundle carries only
103
+ `happ://disconnect`. The operating system was the answer: macOS NetworkExtension profiles are enumerated
104
+ and driven by name with `scutil --nc`, and `scutil --nc start "Happ"` brought the profile up in seconds.
105
+ The skill now names that surface first on macOS, keeps the client links as the fallback for a client that
106
+ tunnels inside its own process, and its roster records Happ as validated with what was observed rather
107
+ than a vendor claim.
108
+
109
+ ## Contrib — a design audit that measures a rendered page (2026-11-12)
110
+
111
+ The measurement everything in the design program is judged by, as a tool: `design_audit` renders a page at
112
+ declared widths and reports, per width, the dominant colours with their coverage, the contrast ratio of
113
+ every text-bearing element against its effective background with the failing pairs named by selector path,
114
+ the distinct font sizes, weights, line-heights, spacings, radii and shadows in use with whether the project's
115
+ `DESIGN.md` holds each value, tap targets under 44 px, and elements that overflow their container. The
116
+ measurement is a pure function over a DOM snapshot, so the gate runs on recorded fixtures instead of a live
117
+ browser: a page with seven planted defects reports exactly those seven, a page with none reports zero, and
118
+ two runs over the same snapshot are byte-identical. On the dating app's built page it found four sub-44 px
119
+ targets, one off-grid spacing used eight times, and four icon wrappers overflowing their boxes, and it
120
+ reports one skipped element rather than guessing: a heading painted by a gradient clipped to its glyphs.
121
+
99
122
  ## Release — three fixes that never left the monorepo (2026-11-12)
100
123
 
101
124
  The publisher skips a workspace whose version is already on the registry, and three fixes landed in
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` | 13 extensions | browser, codebase, diff, healthcheck, observatory, repl, sleep, system-monitor - **not owned by this package**, see appendix |
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 13 extensions are all enabled by default with a per-extension toggle via
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.52",
4
- "sha": "3a3de965131cd125b58a807b064a43d37b7f466f",
5
- "shaShort": "3a3de965",
3
+ "version": "0.43.54",
4
+ "sha": "9e365fc3c4a2155c2d7cdce88f1f38cc6971a5ed",
5
+ "shaShort": "9e365fc3",
6
6
  "branch": "detached",
7
7
  "dirty": false,
8
- "packedAt": "2026-11-11T22:45:10.259Z"
8
+ "packedAt": "2026-11-12T05:33:59.469Z"
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 12 directly and these booleans are not read.
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.52",
3
+ "version": "0.43.54",
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",