repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

release: v0.0.3

e94909742ac64bbc17dca5f5b64f6916fdeaf21d

Oliver Krylow <o.krylow@isp-insoft.de> ·

unsigned

Browse filesCompare with HEAD

Changed files (62)

README.md

Modified
21 21 pi install git:github.com/bugabinga/pi-ext
24 +Local checkout, absolute path:
26 +```bash
27 +pi install /home/me/Workspace/pi-ext
28 +```
30 +Local checkout, `~` path:
32 +```bash
33 +pi install ~/Workspace/pi-ext
34 +```
24 36 ### Filtering
26 -Load only a subset via `~/.pi/agent/settings.json`:
38 +Load only one extension via `~/.pi/agent/settings.json`:
28 40 ```json
158 170 git clone https://github.com/bugabinga/pi-ext.git
159 171 cd pi-ext
160 172 npm install
161 -pi install /absolute/path/to/pi-ext
173 +pi install /home/me/Workspace/pi-ext
164 176 Or add to `~/.pi/agent/settings.json`:
168 180 "packages": [
170 - "source": "/absolute/path/to/pi-ext"
182 + "source": "/home/me/Workspace/pi-ext"
176 -> **Note:** Local paths and git sources both require manual dependency installation.
177 -> Pi runs `npm install --omit=dev` for git sources.
188 +> **Note:** Git installs run `npm install --omit=dev`.
178 189 > For local development, run `npm install` inside the repo first.

extensions/angel/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test runner with Vitest across the workspace
6 +- Isolate extension harness environment in tests
7 +- Update extension guide and demo docs
8 +- Format Markdown and code fences with dprint
9 +- Tighten Biome lint rules and remove low-risk explicit any
3 11 ## 0.0.2
5 13 - Extension has no commits after v0.0.1; release-only cut

extensions/angel/README.md

Modified
12 12 ## Install / load
14 14 Angel is loaded through the root `pi-ext` package.
15 -See [root README](../../README.md).
15 +See [root README](../../README.md).
17 17 ## Commands / tools / settings
19 -### Tool
19 +### Tools
21 21 `angel` asks the configured advisor model for structured advice.

extensions/builtin-tools/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Test harness env isolated; Vitest replaces Bun test runner
6 +- Build tooling moved to mise with root Bun workspace
7 +- Docs and suite demos updated for extension guides
3 9 ## 0.0.2
5 11 - Ship release only; `extensions/builtin-tools` has no diff from `v0.0.1`

extensions/builtin-tools/README.md

Modified
4 4 # builtin-tools
6 6 Toggle Pi builtin file-search tools.
8 8 ## Install / load
10 -Loaded through root pi-ext package.
11 -See [root README](../../README.md).
10 +Loaded through the root pi-ext package.
11 +See [root README](../../README.md).
13 13 ## Commands / tools / settings

extensions/context-size/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Switch workspace test runner from Bun to Vitest.
6 +- Add mise toolchain setup for builds.
7 +- Isolate extension harness env in tests.
8 +- Format extension guide and demo markdown.
3 10 ## 0.0.2
5 12 - Release contains no context-size commits since v0.0.1

extensions/context-size/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root `pi-ext` package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings
31 31 Emits:
33 -- `footer:segment` to publish/clear the `context-size` footer segment.
33 +- `footer:segment` to publish or clear the `context-size` footer segment.
35 35 ## Behavior
45 45 Usage color:
47 -- `< 70%`:
48 - muted
49 -- `≥ 70%`:
50 - warning
51 -- `≥ 85%`:
52 - error
53 -- unknown percent:
54 - muted
47 +- `< 70%`: muted
48 +- `≥ 70%`: warning
49 +- `≥ 85%`: error
50 +- unknown percent: muted
56 52 No UI update runs when UI is unavailable.

extensions/cost/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Move extension tests from bun test to Vitest.
6 +- Add mise-managed tooling for local development.
7 +- Isolate extension harness env for stable test runs.
8 +- Format docs and update extension guide demos.
3 10 ## 0.0.2
5 12 - Source unchanged from v0.0.1

extensions/cost/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root `pi-ext` package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings

extensions/ctx/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Vitest replaces bun for workspace tests
6 +- Tests isolate extension harness environment
7 +- Harness tests fix import.meta.dirname, Vitest deps, and Chai matchers
8 +- mise manages workspace tooling
9 +- ctx docs and demos reflect current extension guides
3 11 ## 0.0.2
5 13 - Ship no source, README, test, or changelog changes since `v0.0.1`

extensions/ctx/README.md

Modified
42 42 3. compares UTF-8 byte length against threshold
43 43 4. if read output exceeds threshold, returns:
44 44 - first 8 lines
45 - - `[ctx compacted read:
46 - ...]` marker
45 + - `[ctx compacted read: ...]` marker
47 46 - grep/read-offset instruction
48 47 - last 32 lines
49 48 5. leaves `bash`, `grep`, `find`, `ls`, and all other tools untouched

extensions/cwd/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Switch tests from bun to vitest; add vitest deps and chai matchers
6 +- Isolate extension harness env; fix import.meta.dirname in tests
7 +- Tighten Biome lint rules; fix cwd violations
8 +- Move repo tooling to mise and root bun workspace
9 +- Format cwd docs; update extension guides and demos
3 11 ## 0.0.2
5 13 - Tag 0.0.2:

extensions/cwd/README.md

Modified
5 5 ## Install / load
7 7 This extension is loaded through the root pi-ext package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings
33 33 - Uses target cwd session directory config when available.
34 34 - Writes a target session file from in-memory entries when no source session
35 35 file exists.
36 -- Completion suggestions for empty prefix:
37 - `.`, `..`, `~`.
36 +- Completion suggestions for empty prefix: `.`, `..`, `~`.

extensions/devil/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Fix win32 release readiness
6 +- Switch tests from Bun to Vitest
7 +- Isolate extension harness environment in tests
8 +- Tighten Biome lint; remove explicit any and non-null assertions
9 +- Format markdown; update extension guides and demos
3 11 ## 0.0.2
5 13 - Source unchanged from `v0.0.1`; no `extensions/devil` diff.

extensions/devil/README.md

Modified
6 6 ## Install / load
8 8 Loaded through the root pi-ext package.
9 -See [root README](../../README.md).
9 +See [root README](../../README.md).
11 11 ## Commands / tools / settings
24 24 Commands:
26 26 - `/devil <idea>` — start an interactive debate.
27 -- `/devil` — reports `Usage:
28 - /devil <your idea>`.
27 +- `/devil` — reports `Usage: /devil <your idea>`.
30 29 Registered flags:

extensions/diff-review/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace browser mode with an SSR review pipeline.
6 +- Restore live reviews only from the diff-review command.
7 +- Harden diff collection.
8 +- Fix Win32 release packaging.
9 +- Move tests and formatting to npm, Vitest, dprint, and mise.
3 11 ## 0.0.2
5 13 - Reissue v0.0.1 contents; no `extensions/diff-review` file changes

extensions/diff-review/README.md

Modified
13 13 ## Install / load
15 15 Loaded through the root pi-ext package.
16 -See [root README](../../README.md).
16 +See [root README](../../README.md).
18 18 ## Commands / tools / settings
74 74 - Server renders a file tree, split diffs, and findings panel as HTML.
75 75 - Minimal inline JS handles line selection, theme toggle, pane layout, and code
76 76 search.
77 +- Code search accepts literal text or `/regex/` and returns up to 500 hits.
77 78 - Browser fetches current review data, polls for diff changes every 2s, and
78 79 refreshes diff before submit.
79 80 - Browser posts heartbeat every 5s.

extensions/fast/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Move fast status ownership into @bugabinga/pi-ext-fast
6 +- Replace Bun test with Vitest for extension harness tests
7 +- Isolate harness env for extension tests
8 +- Format docs after guide and demo updates
3 10 ## 0.0.2
5 12 - Git history:

extensions/fast/README.md

Modified
44 44 Registers provider `openai-codex` with API `openai-codex-responses`.
46 -When enabled, wraps `openai-codex` streaming and sends native `serviceTier:
46 +When enabled, uses OpenAI Codex responses streaming with native `serviceTier:
47 47 "priority"`.
49 49 When disabled, uses the normal simple OpenAI Codex response stream.
56 56 `openai-codex-responses`
57 57 - all OpenAI Codex models
59 -Reasoning options are clamped for the selected model before sending.
59 +On the priority path, reasoning options are clamped for the selected model
60 +before
61 +sending.
60 62 If the clamped reasoning level is `off`, no `reasoningEffort` is sent.
62 64 No model allowlist.

extensions/footer/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Vitest replaces Bun runner for footer harness tests
6 +- Test harness isolates extension env and fixes import.meta.dirname deps
7 +- Biome rules remove explicit any and non-null assertions
8 +- Docs and demos update footer guides and markdown formatting
3 10 ## 0.0.2
5 12 - Ship unchanged footer package; no source diff since v0.0.1

extensions/footer/README.md

Modified
1 1 # footer
3 -<!-- demo:footer:start -->
5 -![Footer](assets/footer.gif)
7 -<!-- demo:footer:end -->
9 3 Shared stable footer renderer for Pi.
11 5 ## Install / load
13 7 Loaded through the root `pi-ext` package.
14 -See [root README](../../README.md).
8 +See [root README](../../README.md).
16 10 ## Commands / tools / settings
18 -- Command:
19 - `/footer` toggles footer visibility.
20 -- Shortcut:
21 - `ctrl+alt+f` toggles footer visibility.
22 -- Tools:
23 - none.
12 +- Commands:
13 + - `/footer`: toggle footer visibility.
14 +- Shortcuts:
15 + - `ctrl+alt+f`: toggle footer visibility.
16 +- Tools: none.
24 17 - Hooks:
25 - `session_start`, `session_shutdown`.
18 + - `session_start`
19 + - `session_shutdown`
26 20 - Events:
27 - listens for `footer:segment`.
28 -- Settings:
29 - none.
21 + - listens for `footer:segment`.
22 +- Settings: none.
31 24 ## Behavior
35 28 Visible footer has stable height:
37 -- line 0:
38 - `workspace` segments plus current session name.
39 -- lines 1-2:
40 - `llm` segments, flow layout, overflow on line 2.
41 -- line 3:
42 - extension statuses from `footerData.getExtensionStatuses()`.
30 +- line 0: `workspace` segments plus current session name.
31 +- lines 1-2: `llm` segments, flow layout, overflow on line 2.
32 +- line 3: extension statuses.
44 34 `footer:segment` payloads use `id`, `text`, and `zone` (`workspace` or `llm`).
45 -Optional fields:
46 -`variants`, `icon`, `color`, `bar`, `suffix`, `order`.
35 +Optional fields: `variants`, `icon`, `color`, `bar`, `suffix`, `order`.
48 -Send `{ id, text:
49 -undefined }` to remove a segment.
37 +Send `{ id, text: undefined }` to remove a segment.
51 39 Segments sort by `order`; default is `50`.
52 40 Current session name is inserted in the `workspace` zone with order `0.5`.
63 51 Bar values clamp to `0..100`.
65 53 Publishes capability state at `Symbol.for("@bugabinga/pi-ext-footer")`:
66 -`{ version:
67 -1, loaded:
68 -true }`.
54 +`{ version: 1, loaded: true }`.
69 55 On quit/reload shutdown, `loaded` becomes `false`.
71 57 Hidden mode swaps in a zero-height footer stub.
72 58 Shutdown clears segments and footer context.
60 +## Demo
62 +<!-- demo:footer:start -->
64 +![Footer](assets/footer.gif)
66 +<!-- demo:footer:end -->

extensions/git-safe/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Support sparse safe clones in git-safe sessions
6 +- Recover tracked paths during session start
7 +- Replace Bun test runner with Vitest in the extension harness
8 +- Isolate harness environment for extension tests
3 10 ## 0.0.2
5 12 - Release 0.0.2 with no commits touching `extensions/git-safe`

extensions/git-safe/README.md

Modified
12 12 - Commands:
13 13 none
14 14 - Tools:
15 - - `git_clone_safe(url, path, branch?)`
15 + - `git_clone_safe(url, path, branch?, sparse?)`
16 16 - `url`:
17 17 Git repository URL
18 18 - `path`:
19 19 local target directory, absolute or relative to cwd
20 20 - `branch`:
21 21 optional branch name
22 + - `sparse`:
23 + optional repository-relative sparse checkout paths
22 24 - Hooks:
23 25 - `session_start`
24 26 - `session_shutdown`
40 42 - runs `git clone --no-checkout --depth 1 --single-branch -c
41 43 core.symlinks=false`
42 44 - passes `--branch` when `branch` is provided
45 +- when `sparse` paths are provided, adds `--filter=blob:none` and `--sparse`
46 + to clone args
47 +- rejects unsafe sparse paths: empty paths, absolute paths, `.`, `..`,
48 + traversal, and null bytes
43 49 - disables credential prompts with `GIT_TERMINAL_PROMPT=0` and
44 50 `GIT_TERMINAL_PROMPT_AUTOCHECK=0`
45 51 - sets repo-local `core.hooksPath` to an empty hooks dir
54 60 - kills clone after 60s and checkout after 30s
55 61 - writes `.pi-git-safe` marker after successful checkout
56 62 - returns canonical clone path, URL, optional branch, file count, total byte
57 - count, symlink count, symlink paths, and warnings
63 + count, symlink count, symlink paths, warnings, and optional sparse paths
58 64 - recovers marked clone dirs on `session_start` by scanning cwd, temp dir,
59 65 `~/.local/state/pi`, and home up to depth 4
60 66 - cancels stale async recovery work on `session_shutdown`

extensions/goal/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Add planner dossier for goal setup
6 +- Harden autonomous goal loop continuation and judge retries
7 +- Show judge history, live widget updates, retryable errors, and all criteria
8 +- Replace Bun with npm and Vitest; fix Windows release metadata
9 +- Stabilize goal harness tests; cover goal flow with 170 tests
3 11 ## 0.0.2
5 13 - Reissue 0.0.1 code; no extension commits since v0.0.1.

extensions/goal/README.md

Modified
48 48 Marks the active goal complete or blocked.
49 50 Hidden until a continue verdict increments `turnsUsed`, then hidden again when
50 51 the goal is complete, blocked, paused, cleared, or resumed into a fresh 0-turn
51 52 state.
52 54 If invoked while stale, it errors when no active goal exists, the goal has not
53 55 been judged, or the goal belongs to another session.
60 62 "judgeModel": "provider/model",
61 63 "plannerModel": "provider/model",
62 64 "plannerThinkingLevel": "high",
63 - "tailBytes": 4096
65 + "tailBytes": 4096,
66 + "tokenBudget": "100k",
67 + "timeBudgetSeconds": 1800,
68 + "timeBudget": "30m"
145 150 the goal.
146 151 There is no max-turn budget.
147 152 - If still active, continuation is queued as a hidden `goal-continuation` custom
148 - message with `deliverAs:
149 - "followUp"` and `triggerTurn:
150 - true`.
153 + message with `deliverAs: "followUp"` and `triggerTurn: true`.
151 154 - `update_goal` is hidden until the first continue verdict increments
152 155 `turnsUsed`, then hidden again for terminal or paused goals.
153 156 - `/goal pause` only pauses active owned goals.

extensions/leaks/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test workflow with npm and Vitest.
6 +- Isolate extension harness tests from ambient env.
7 +- Fix harness tests for import.meta.dirname, Vitest deps, and Chai matchers.
8 +- Tighten Biome lint rules and fix violations.
9 +- Format markdown docs; update extension guides and demos.
3 11 ## 0.0.2
5 13 - Ship no source, README, or test changes since v0.0.1.

extensions/leaks/README.md

Modified
4 4 # leaks
6 6 Provider-bound secret redaction for Pi.
8 8 ## Install / load
10 -Loaded through the root [pi-ext package](../../README.md).
10 +Loaded through the root [pi-ext package](../../README.md).
12 12 ## Commands / tools / settings
15 15 none.
17 17 Hooks:
18 -provider requests, context messages, tool calls, assistant message end.
18 +`beforeProviderRequest`, `context`, `toolCall`, `messageEnd`.
20 20 Settings namespace:
21 21 `leaks` in Pi `settings.json`.
23 +Settings:
25 +- `enabled`: boolean, default `true`
26 +- `keywords`: string[], default `[]`
27 +- `regex`: string[] or `{ pattern, flags, label }[]`, default `[]`
28 +- `secretFiles`: string[], default `[".env", ".env.local", ".env.*.local"]`
29 +- `exclude`: string[], default `["localhost", "127.0.0.1", "0.0.0.0",
30 + "example.com"]`
23 32 ```json
25 34 "leaks": {
35 44 ## Behavior
37 -Redacts only copies sent to providers.
46 +Redacts copies sent to providers.
38 47 Context-message copies are redacted without mutating originals.
39 -Local tools receive restored args before execution.
48 +Local tool calls receive restored args before execution.
40 49 Final assistant messages are restored locally.
41 50 Secret values are loaded from configured files relative to Pi cwd.
51 +Settings are read from Pi settings, with `.pi/settings.json` fallback when the
52 +runtime settings API is absent.
42 53 Built-in rules cover common AI provider tokens, developer tokens, cloud keys,
43 54 JWTs, private keys, and selected connection strings.
44 55 Custom `keywords` use smart boundaries.
46 57 `label`.
47 58 Generic assignment redaction requires sufficiently random values and skips
48 59 common false positives.
60 +`/leaks test` is a dry run; its placeholders do not persist.
49 61 Placeholders are generic:
50 -`__LEAK_<hash>__`.
62 +`__LEAK_<12 hex>__`.

extensions/llmiterate/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Fix win32 release readiness
6 +- Replace Bun build/test paths with npm and Vitest
7 +- Inline gitignore matcher; drop `ignore` dependency; cut scan time
8 +- Stabilize extension and goal harness tests with isolated env
9 +- Tighten Biome lint rules; remove non-null assertions
3 11 ## 0.0.2
5 13 - Ship no llmiterate file changes since v0.0.1.

extensions/llmiterate/README.md

Modified
4 4 # llmiterate
6 6 Manual editor-save bridge from comment markers to background Pi edits.
8 8 ## Install / load
10 -Loaded through the root pi-ext package.
10 +This extension is loaded through the root pi-ext package.
11 11 See [../../README.md](../../README.md).
13 13 ## Commands / tools / settings

extensions/model-info/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Own fast status state in the extension.
6 +- Replace Bun test runs with Vitest.
7 +- Tighten Biome lint rules; remove low-risk explicit `any`.
8 +- Isolate harness env; fix `import.meta.dirname` and Chai matchers.
9 +- Format markdown docs; update extension guides and demos.
3 11 ## 0.0.2
5 13 - Mark 0.0.2; source, README, tests, lockfile match `v0.0.1`

extensions/model-info/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root `pi-ext` package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings
21 21 Hooks:
23 -- `session_start`, `model_select`, `thinking_level_select`, `session_compact`:
24 - publish telemetry.
23 +- `session_start`, `model_select`, `session_compact`:
24 + publish telemetry from the current session state.
25 +- `thinking_level_select`:
26 + publish telemetry using the selected thinking level from the event.
25 27 - `session_shutdown`:
26 - clears published status/footer segment.
28 + clears the footer segment and status fallback.
28 30 Events emitted:
30 -- `footer:segment` when `@bugabinga/pi-ext-footer` is loaded:
31 - `model` in the `llm` zone.
32 +- `footer:segment`:
33 + publishes or clears segment `model` in the `llm` zone.
33 35 UI status:
35 -- `model-info` status fallback when shared footer is not loaded.
37 +- `model-info` status fallback when `@bugabinga/pi-ext-footer` is not loaded.
37 39 ## Behavior
49 51 Thinking level comes from `thinking_level_select`; otherwise from the latest
50 52 `thinking_level_change` session entry; fallback is `off`.
54 +When the shared footer is loaded, the extension publishes footer segment
55 +`model` with color `syntaxKeyword`, zone `llm`, and order `0`.
57 +Without the shared footer, it clears the footer segment and writes the
58 +`model-info` UI status fallback.
52 60 Publishing only runs when UI is available.
53 61 On shutdown, the extension clears its footer segment and status fallback.

extensions/neko/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Fix win32 release packaging
6 +- Replace Bun tests with Vitest
7 +- Isolate extension harness env in tests
8 +- Format docs and refresh demos
3 10 ## 0.0.2
5 12 - Keep neko source identical to v0.0.1.

extensions/neko/README.md

Modified
7 7 ## Install / load
9 9 Loaded through the root pi-ext package.
10 -See [root README](../../README.md).
10 +See [root README](../../README.md).
12 12 ## Commands / tools / settings

extensions/nu-bang/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Fix win32 release packaging checks
6 +- Relax nu-bang timing tests to reduce flaky shell runs
7 +- Isolate harness env and temp-dir cleanup assertions
8 +- Replace Bun test runner wiring with Vitest
9 +- Format extension guides and demos
3 11 ## 0.0.2
5 13 - Source unchanged under `extensions/nu-bang` since `v0.0.1`.

extensions/nu-bang/README.md

Modified
9 9 ## Install / load
11 11 Loaded through the root pi-ext package.
12 -See [root README](../../README.md).
12 +See [root README](../../README.md).
14 14 ## Commands / tools / settings

extensions/prompt-autopsy/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test runner with Vitest across workspace
6 +- Fix harness tests for import.meta.dirname, Vitest deps, and Chai matchers
7 +- Isolate extension harness env in tests
8 +- Migrate build tooling to mise; add root Bun workspace
9 +- Format markdown docs; update guides; replace suite demos
3 11 ## 0.0.2
5 13 - Release @bugabinga/pi-ext-prompt-autopsy with no code delta from v0.0.1

extensions/prompt-autopsy/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root pi-ext package.
8 -See the [root README](../../README.md).
8 +See the [root README](../../README.md).
10 10 ## Commands / tools / settings

extensions/pulse/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Fix win32 release readiness for @bugabinga/pi-ext-pulse
6 +- Run harness tests on Vitest with isolated env and Chai matchers
7 +- Move workspace tooling to mise and root Bun workspace
8 +- Apply stricter Biome lint rules; remove non-null assertions
9 +- Replace suite demos with current pulse demos
3 11 ## 0.0.2
5 13 - Release package metadata only; no source diff under `extensions/pulse`

extensions/pulse/README.md

Modified
87 87 `file`, `dir`, or `glob`.
88 88 Default `file`.
89 89 - `glob`:
90 - glob used with `type:
91 - "dir"`.
90 + glob used with `type: "dir"`.
92 91 Default `**/*.md`.
93 92 - `instruction`:
94 93 optional per-doc note sent with content.
115 114 - Invalid config fields make the config unloadable.
116 115 Invalid persisted document specs are dropped while loading config.
117 116 - Dir and glob specs expand to sorted files; duplicate paths are ignored.
118 -- Automatic checks wait for Pi idle, a quiet window after mutations, and a
119 - cooldown after the last update.
117 +- Automatic checks wait for Pi idle, a 60 second quiet window after mutations,
118 + and a 5 minute cooldown after the last update.
120 119 - Periodic checks use `interval`; dirty checks also run after workspace-changing
121 120 tools settle.
122 121 - Bash output is not parsed.
127 126 - Model output must be JSON updates for allowed paths only.
128 127 Unknown paths, duplicate paths, invalid JSON, and unchanged content are
129 128 rejected or skipped.
130 -- Invalid JSON gets correction retries before the check fails.
129 +- Invalid JSON gets up to 2 correction retries before the check fails.
131 130 - `auto` writes validated updates.
132 131 `confirm` asks before writing.
133 132 `review` opens each proposed file in an editor before writing.

extensions/q/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Format code fences with dprint
6 +- Run extension harness tests with isolated env
7 +- Replace Bun test tooling with Vitest
8 +- Move workspace tooling to mise
9 +- Replace suite demos
3 11 ## 0.0.2
5 13 - Runtime unchanged; no commits touched `extensions/q` since `v0.0.1`

extensions/quota/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Show quota reset time in parentheses.
6 +- Run workspace tests with Vitest instead of Bun.
7 +- Isolate extension harness environment in tests.
8 +- Apply stricter Biome lint rules to quota sources.
3 10 ## 0.0.2
5 12 - Source:

extensions/quota/README.md

Modified
4 4 # quota
6 6 Subscription quota dashboard for Pi providers.
8 8 ## Install / load
10 -Loaded through the root [pi-ext package](../../README.md).
10 +Loaded through the root [pi-ext package](../../README.md).
12 12 ## Commands / tools / settings
48 48 - With `@bugabinga/pi-ext-footer`:
49 49 emits one segment for the active visible provider into the `llm` zone with
50 - `order:
51 - 4`.
50 + `order: 4`.
52 51 - Without it:
53 52 writes compact Pi status text under status id `quota`.
54 53 - Footer and fallback status text are filtered to the active model provider.

extensions/runtime/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Switch tests from Bun to Vitest
6 +- Isolate extension harness environment
7 +- Fix harness tests for import.meta.dirname, Vitest deps, and Chai matchers
8 +- Migrate workspace tooling to mise
9 +- Tighten Biome lint rules and explicit any usage
3 11 ## 0.0.2
5 13 - Keep `index.ts` unchanged from `v0.0.1`

extensions/runtime/README.md

Modified
5 5 ## Install / load
7 7 Loaded through root `pi-ext` package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings
12 -- Commands:
13 - none.
14 -- Tools:
15 - none.
16 -- Hooks:
17 - `session_start`, `agent_end`, `session_shutdown`.
18 -- Settings:
19 - none.
12 +- Commands: none.
13 +- Tools: none.
14 +- Hooks: `session_start`, `agent_end`, `session_shutdown`.
15 +- Settings: none.
21 17 ## Behavior
23 -Detects project runtime from entries in `cwd`, then parent dirs up to `$HOME`.
24 -If `cwd` is outside `$HOME`, only `cwd` is checked.
19 +Detects project runtime from marker entries in `cwd`, then parent dirs up to
20 +`$HOME`. If `$HOME` is unset, or `cwd` is outside `$HOME`, only `cwd` is
21 +checked.
26 23 Detection order:
55 52 If `@bugabinga/pi-ext-footer` is loaded, emits `footer:segment`:
57 -- id:
58 - `runtime`
59 -- zone:
60 - `workspace`
61 -- order:
62 - `3`
54 +- id: `runtime`
55 +- zone: `workspace`
56 +- order: `3`
64 58 Without footer, writes Pi status text under id `runtime`.

extensions/session-rename/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Vitest runs extension harness tests; Chai matchers fixed
6 +- import.meta.dirname fixes harness paths under Vitest
7 +- Biome rules tightened; non-null assertions removed
8 +- mise defines workspace toolchain for builds
3 10 ## 0.0.2
5 12 - Ship release-only version bump; no session-rename source changes

extensions/session-rename/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root pi-ext package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings

extensions/ssh-tools/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test/build scripts with npm and Vitest workspace tasks
6 +- Add mise toolchain config for repeatable local commands
7 +- Fix harness tests for import.meta.dirname and Chai matchers
8 +- Remove non-null assertions and satisfy stricter Biome rules
3 10 ## 0.0.2
5 12 - Keep ssh-tools source identical to v0.0.1; no extension commits

extensions/ssh-tools/README.md

Modified
6 6 ## Install / load
8 -Loaded through the root [pi-ext package](../../README.md).
8 +Loaded through the root [pi-ext package](../../README.md).
10 10 ## Commands

extensions/terminal-notifier/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test runner with Vitest for extension harness tests
6 +- Isolate extension harness environment in tests
7 +- Tighten Biome lint rules and fix violations
8 +- Move tooling to mise; add root Bun workspace
3 10 ## 0.0.2
5 12 - Release only:

extensions/terminal-notifier/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root pi-ext package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings
32 32 Events:
34 -- listens for `notify:send` with `{ message, severity?, source?
35 - }`.
34 +- listens for `notify:send` with `{ message, severity?, source? }`.
36 35 - emits `notify:ui` with `{ message, severity, source }` before relaying
37 36 `notify:send` to terminal/native notification output.

extensions/terminal-signals/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Migrate workspace tooling to mise, Vitest, and a root Bun workspace
6 +- Fix harness tests: env isolation, import.meta.dirname, Vitest deps, Chai
7 + matchers
8 +- Tighten Biome lint rules and fix violations
9 +- Replace suite demos for terminal-signals
3 11 ## 0.0.2
5 13 - Source unchanged since v0.0.1.

extensions/terminal-signals/README.md

Modified
5 5 ## Install / load
7 7 Loaded through the root `pi-ext` package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings

extensions/terse/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Migrate workspace tooling to mise and Vitest
6 +- Isolate extension harness env in tests; fix import.meta.dirname and Chai
7 + matchers
8 +- Add side-by-side terse demo; replace old suite demos
9 +- Update extension guides and demo docs
3 11 ## 0.0.2
5 13 - Cut version-only release; no diff from v0.0.1.

extensions/terse/README.md

Modified
1 1 # terse
3 +Terse response protocol injector for Pi.
5 +## Demo
3 7 <!-- demo:terse:start -->
5 9 | **Same prompt** | **Same prompt + terse** |
9 13 <!-- demo:terse:end -->
11 -Terse response protocol injector for Pi.
13 15 ## Install / load
15 17 Loaded through the root pi-ext package.
16 -See [root README](../../README.md).
18 +See [root README](../../README.md).
18 20 ## Commands / tools / settings
20 -- Commands:
21 - none.
22 -- Tools:
23 - none.
24 -- Settings:
25 - none.
26 -- Hooks:
27 - `before_agent_start`.
22 +- Commands: none.
23 +- Tools: none.
24 +- Settings: none.
25 +- Hooks: `before_agent_start`.
29 27 ## Behavior
36 34 - inserts before Pi SDK `Current date:` footer when present
37 35 - appends to prompt when footer is absent
38 36 - keeps code, tool args, file contents, quoted errors exact
39 -- pushes terse output:
40 - no preamble, no recap, no hedging
37 +- pushes terse output: no preamble, no recap, no hedging
41 38 - allows clarity over compression for security, destructive ops, user confusion

extensions/tldr/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Fix tldr harness tests under isolated environment
6 +- Switch workspace tests from bun to vitest
7 +- Add model test prompts for tldr
8 +- Tighten Biome lint rules; fix tldr violations
9 +- Update extension guides and demos
3 11 ## 0.0.2
5 13 - Keep `extensions/tldr` files unchanged from `v0.0.1`

extensions/tps/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test harness with Vitest
6 +- Move dev tooling to mise
7 +- Fix harness tests for import.meta.dirname, Vitest deps, and Chai matchers
8 +- Update extension guides and demos for current Pi APIs
3 10 ## 0.0.2
5 12 - Keep @bugabinga/pi-ext-tps source unchanged from v0.0.1

extensions/tps/README.md

Modified
1 1 # tps
3 -<!-- demo:tps:start -->
5 -![Tokens per second](assets/tps.gif)
7 -<!-- demo:tps:end -->
9 3 Tokens-per-second footer segment for Pi.
11 5 ## Install / load
15 9 ## Commands / tools / settings
17 -- Commands:
18 - none.
19 -- Tools:
20 - none.
21 -- Settings:
22 - none.
11 +- Commands: none.
12 +- Tools: none.
13 +- Settings: none.
23 14 - Hooks/events:
24 15 - `session_start`
25 16 - `agent_start`
28 19 - `message_end`
29 20 - `agent_end`
30 21 - `session_shutdown`
31 - - emits `footer:segment` when shared footer is loaded.
22 + - emits `footer:segment` when the shared footer is loaded.
33 24 ## Behavior
35 -- `session_start`:
36 - shows `󰓅 —/s`.
37 -- `agent_start`:
38 - starts timing; shows `󰓅 0.0/s`.
39 -- `message_start`:
40 - records assistant span start for non-streaming fallback.
41 -- `message_update`:
42 - starts decode timing on the first non-empty streamed delta, excludes that
43 - baseline chunk from TPS, and estimates live TPS from later streamed delta
44 - chars / 4.
26 +- `session_start`: shows `󰓅 —/s`.
27 +- `agent_start`: resets run state, starts timing, shows `󰓅 0.0/s`.
28 +- `message_start`: records assistant span start for non-streaming fallback.
29 +- `message_update`: reads string deltas from assistant events whose type ends
30 + with `_delta`.
31 +- The first non-empty streamed delta starts decode timing as a baseline and is
32 + not counted in the live TPS numerator.
33 +- Later streamed delta chars are counted as live output, estimated at 4 chars
34 + per token.
45 35 - Live updates are throttled to every 250 ms.
46 -- `message_end`:
47 - stops decode timing, or assistant-span fallback when no deltas streamed.
48 -- `agent_end`:
49 - shows final `󰓅 N.N/s` from assistant output tokens / measured decode seconds.
50 -- No assistant output token usage → returns to `󰓅 —/s`.
51 -- Shared footer present → emits `footer:segment` in `llm` zone.
52 -- No shared footer → falls back to `ctx.ui.setStatus("tps", ...)`.
53 -- `session_shutdown`:
54 - clears state and removes status/segment.
36 +- `message_end`: closes the assistant span. Streamed spans with more than one
37 + delta add measured decode time; otherwise fallback timing uses the assistant
38 + span.
39 +- `agent_end`: sums `usage.output` from assistant messages only.
40 +- Final streamed TPS uses assistant output tokens scaled by measured streamed
41 + chars / total streamed chars, divided by measured decode seconds.
42 +- Fallback final TPS uses assistant output tokens divided by assistant span
43 + seconds.
44 +- Multiple assistant spans are summed; tool gaps are excluded from measured
45 + decode time.
46 +- No assistant output tokens or no measured duration returns to `󰓅 —/s`.
47 +- Shared footer present: emits a `footer:segment` in the `llm` zone.
48 +- No shared footer: falls back to `ctx.ui.setStatus("tps", ...)`.
49 +- `session_shutdown`: clears state and removes status/segment.
51 +## Demo
53 +<!-- demo:tps:start -->
55 +![Tokens per second](assets/tps.gif)
57 +<!-- demo:tps:end -->

extensions/usage/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Replace Bun test runner with Vitest for the extension harness
6 +- Isolate harness environment in usage tests
7 +- Move workspace tooling to mise
8 +- Remove non-null assertions under stricter Biome rules
3 10 ## 0.0.2
5 12 - Keep `/usage` dashboard unchanged from v0.0.1.

extensions/vcs-status/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Keep vcs-status runtime unchanged; release covers build and test tooling
6 +- Replace Bun test runner with Vitest for workspace tests
7 +- Fix harness tests: import.meta.dirname, Vitest deps, Chai matchers
8 +- Move tool version management to mise
9 +- Tighten Biome lint rules and fix reported violations
3 11 ## 0.0.2
5 13 - git diff v0.0.1 -- extensions/vcs-status:

extensions/vcs-status/README.md

Modified
5 5 ## Install / load
7 7 Loaded through root `pi-ext` package.
8 -See [root README](../../README.md).
8 +See [root README](../../README.md).
10 10 ## Commands / tools / settings

extensions/web/CHANGELOG.md

Modified
1 1 # Changelog
3 +## 0.0.3
5 +- Persist capped fetch results for later tool reads
6 +- Show local image preview in `understand_image`
7 +- Fix win32 release readiness for `@bugabinga/pi-ext-web`
8 +- Switch build and tests from Bun to npm, Vitest, and mise
3 10 ## 0.0.2
5 12 - Source unchanged; no `extensions/web` commits since `v0.0.1`

extensions/web/README.md

Modified
1 1 # web
3 -Web fetch, search, and image-analysis tools for Pi.
3 +Web fetch, search, site-map, and image-analysis tools for Pi.
5 5 ## Install / load
25 25 optional; declared by schema.
26 26 Current `web_fetch` execution uses the Pi/tool abort signal and does not
27 27 pass this value to `fetchUrlStream`.
28 + - `linesMatching`:
29 + optional; returns matching line excerpts instead of the full visible output.
30 + - `contextLines`:
31 + optional; line context around `linesMatching` hits.
32 +- `web_map`
33 + - discovers site maps and related links.
28 34 - `web_search`
29 35 - `query`:
30 36 search query.
67 73 Pi model registry providers `zai`, `z-ai`, `z.ai`, `bigmodel`; fallback env
68 74 `ZAI_API_KEY`, `Z_AI_API_KEY`.
69 75 - Z.AI search endpoint/options:
70 - `ZAI_SEARCH_MCP_URL`, `ZAI_SEARCH_BASE_URL`, `ZAI_SEARCH_FRESHNESS`,
71 - `ZAI_SEARCH_CONTENT_SIZE`, `ZAI_SEARCH_LOCATION`.
76 + `ZAI_BASE_URL`, `ZAI_SEARCH_MCP_URL`, `ZAI_SEARCH_BASE_URL`,
77 + `ZAI_SEARCH_FRESHNESS`, `ZAI_SEARCH_CONTENT_SIZE`, `ZAI_SEARCH_LOCATION`.
72 78 - MiniMax key:
73 79 Pi model registry provider `minimax`; fallback env `MINIMAX_API_KEY`.
74 80 - MiniMax base URL:
82 88 - `web_fetch` uses native `fetch` with browser-like headers and a per-host
83 89 referer.
90 +- `web_fetch` accepts only HTTP and HTTPS URLs.
91 + Private/reserved IP targets, blocked DNS answers, and unsafe redirects are
92 + rejected.
93 +- Fetch output is stored in the Pi state directory with a `responseId` and
94 + `fullOutputPath`.
95 + Tool-visible text is capped; full output stays on disk.
96 +- `linesMatching` returns numbered excerpts with optional surrounding context.
84 97 - Content routing is based on `Content-Type`:
85 98 - HTML/XHTML:
86 99 strips common prompt-injection delivery vectors, extracts main content,
113 126 untrusted external data.
114 127 Image, media, and binary early-return paths are not wrapped by the current
115 128 implementation.
129 +- `web_map` discovers site maps from robots.txt, sitemap XML, and llms links.
116 130 - `web_search` provider order:
117 131 OpenAI Codex native search when authenticated, then Z.AI Coding Plan MCP when
118 132 configured, then MiniMax search when configured, then DuckDuckGo HTML.
120 134 `week`, `month`, `year`, or no-limit values.
121 135 - DuckDuckGo fallback throttles requests to at least 2 seconds apart and reports
122 136 captcha/dedup diagnostics.
137 +- MiniMax search posts to `/v1/coding_plan/search`.
123 138 - `understand_image` sends the prompt and image data to MiniMax VLM.
124 139 It accepts HTTP/HTTPS URLs, data URLs, and local files.
125 140 Local file data is base64 encoded before the request.