pi-blackhole 0.5.4 → 0.5.6

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 ---
 
+## [0.5.6] - 2026-09-19
+
+### Changed
+
+- **Minimum supported Pi raised to 0.85.1; compat-floor CI retired.** The `compat-min-supported` job re-pinned the `@earendil-works/*` peers to the `peerDependencies` floor and typechecked against them, going red every time. The extension now builds against the pinned devDependencies (0.85.1) and the peer floor is set to match; `peerDependencies` remains the single source of truth for the declared minimum.
+
+### Fixed
+
+- **Observer chunk cap now counts every entry type** ([#110](https://github.com/k0valik/pi-blackhole/issues/110)). `capSourceEntriesToTokens` used a hand-rolled type table that had drifted from the trigger's estimator, so `custom_message` entries (text lives in `.content`, not `.summary`) counted as zero tokens and an oversized chunk could exceed `maxTokens`; it now reuses the same `estimateEntryTokens` the trigger uses (CJK-aware), and debug logging exposes the post-cap chunk size and cooldown-skipped models on the normal path.
+- **CJK-aware token accounting, text primitives, and extractor language handling** ([#106](https://github.com/k0valik/pi-blackhole/issues/106), [#105](https://github.com/k0valik/pi-blackhole/issues/105)). Script detection is automatic — no new config keys. `estimateStringTokens` counts CJK scripts as ~1 token/char instead of `ceil(chars/4)`, so every budget built on it (OM `tokenCount`, pool caps, `retainedToolOutputMaxTokens`, worker context pre-check) no longer admits ~3× the configured tokens. Clipping recognizes CJK terminators (`。！？；`, fullwidth included) and pause punctuation instead of hard-cutting space-free text. `recall` word-segments CJK queries via `Intl.Segmenter`, restoring per-term BM25 ranking with script-aware document-length normalization. `[User Preferences]` accepts CJK correction anchors (`不要`/`回退`/`错了`…) and `[Outstanding Context]` CJK failure stems (`失败`/`报错`/`错误`…) with benign-compound guards, scanning the whole fresh window instead of the last 20 blocks.
+- **`[Files And Changes]` and `[Commits]` now extract what actually happened** ([#105](https://github.com/k0valik/pi-blackhole/issues/105)). File attribution correlates tool calls with results (native path args, anchor-based edits, a bash parser for redirects/`sed -i`/`tee`/`cp`/`mv`/`rm`/`curl -o`), sanitizes arg strings so `src/a.ts:10-40` no longer phantoms next to `/repo/src/a.ts`, and adds git grounding tags (`staged`, `new`, `deleted`, …); the collector runs only at compaction time. `[Commits]` uses a quote-aware token parser with a message-recovery chain (segment-scoped `-m`, `-F -` heredocs, the git success line) and precision guards (`--dry-run`, failed commits, non-`git` commands produce nothing).
+- **`[Files And Changes]` display and cross-compaction merge overhauled**. cwd-relative paths, capped counted lists that never shrink after merge, and single-token paths hard-broken by `wrapLongLines` are reassembled; `(#N)` refs on `[Scope change]` and `[Commits]` for `recall` drill-down; session-goal and outstanding-context clips raised to 200.
+
+---
+
+## [0.5.5] - 2026-09-15
+
+### Changed
+
+- **Minimum supported Pi raised to 0.84.3.** The `compat-min-supported` CI job now derives its pin from the `peerDependencies` floor instead of a hardcoded version, so the floor only moves when new Pi APIs are adopted. Fail-closed behavior on older hosts is unchanged.
+
+### Fixed
+
+- **OM workers now send provider-required session headers (OpenCode Go `MissingSessionID`).** Observer/reflector/dropper calls bypass Pi's interactive header pipeline (`mergeProviderAttributionHeaders` + `before_provider_headers` in `sdk.ts`) by invoking `streamSimple` directly, so the OpenCode Go gateway rejected every worker request with `400 MissingSessionID` while Pi's own calls worked. Attribution now happens at a single choke point (`withProviderAttributionHeaders`, pi-core `getSessionHeaders` mirror with exact-hostname matching): the Pi session id travels through standard stream options (`sessionId`) and is materialized both as pre-merged `headers` and as a composed `transformHeaders` (honored by pi-ai `applyAuth` after the auth merge), covering builtin, custom-registered, and future providers without per-stage branching. Reworks PR #95 with the contributor's regression assertions kept verbatim. ([#93](https://github.com/k0valik/pi-blackhole/issues/93))
+- **Deterministic 4xx errors now cool models down and engage fallbacks.** A 400-class failure (missing provider-required headers, bad credentials, unknown model) previously retried the same broken session model on every consolidation cycle: `recordRetryableError` is a no-op without a candidate config, and `isRetryableError` gated nothing (debug logging only) — so a deterministic 4xx like `MissingSessionID` never cooled the resolved session model at all. New `isDeterministicError` / `isCooldownWorthyError` classification; deterministic failures persist cooldown (default 1h) including for the resolved session model, so the stage falls through to `*FallbackModels` instead of burning attempts. Transient blips on the main model still only trip the 30s retry gate, never an hour-long cooldown.
+- **Surface silently skipped stale-ctx auto-compactions ([#92](https://github.com/k0valik/pi-blackhole/issues/92)).** In-memory subagent/flow sessions are disposed by their parent right after `agent_end`, so the deferred auto-compaction microtask always bails on a stale extension ctx — previously invisible outside `debug.ndjson`, leaving large headless sessions unbounded with no signal. Each skipped compaction is now counted (`Skipped compactions (disposed ctx)` in `/blackhole-memory` status, process-wide so a parent surfaces nested-session skips) and warned once per session (UI notification; stderr for headless runs). Bail behavior itself is unchanged.
+- **Reliable mid-run host discovery and recovery.** ([#98](https://github.com/k0valik/pi-blackhole/pull/98), thanks @sonSunnoi) On Pi's unbundled layout (`dist/cli.js` importing `dist/main.js`) a resolved bundled chunk no longer counts as host discovery on its own — each package root now falls back to its `dist/index.js` barrel, so inline (mid-run) compaction works instead of silently staying unavailable. Each discovered host also binds its own `prepareCompaction` helper, so a session never borrows another installed host's helper for eligibility checks. Plus: below-threshold observer content now accumulates instead of being dropped by the not-due cursor advance, stale cursors fall back to the coverage/compaction rule, and the startup adapter probe is carried into the runtime so `resume` mode warns once instead of silently falling back. Closes [#96](https://github.com/k0valik/pi-blackhole/issues/96).
+- **Test host doubles without type escapes, and lint-staged tolerates ignored paths.** ([#99](https://github.com/k0valik/pi-blackhole/pull/99), thanks @sonSunnoi) The compaction host test double is now a complete typed `ExtensionAPI` implementation (compile-time contract test included); production code unchanged. Also fixes `lint-staged` failing docs-only commits (`oxfmt --check` on ignored `docs/` paths). Closes [#97](https://github.com/k0valik/pi-blackhole/issues/97).
+- **Quitting right after startup no longer kills Pi.** ([#91](https://github.com/k0valik/pi-blackhole/pull/91), thanks @priaculun) The `session_start` migration notice runs behind a dynamic `import()`, so a quit, `/reload`, or `/new` in that window threw on the stale ctx — with no `.catch()`, the throw escaped as an unhandled rejection and terminated the process. The notice is now catch-terminated (best-effort, never fatal).
+
+---
+
 ## [0.5.4] - 2026-09-13
 
 ### Fixed

package/README.md

@@ -31,13 +31,12 @@ Then `/reload` or restart Pi. The config file at `~/.pi/agent/pi-blackhole/pi-bl
 
 ## ✨ What's new
 
-> **Latest release: [0.5.4](CHANGELOG.md)**
+> **Latest release: [0.5.6](CHANGELOG.md)**
 >
-> - **Recall responses are now budget-bounded** — one knob (`recallResponseMaxChars`, default 48k chars ≈ 12k tokens) caps search snippets, expansions, and related observations; clipped content stays reachable via the new `#N:text` drill-down and `page:N` continuation. `/blackhole-recall` itself stays uncapped (human TUI output). ([#83](https://github.com/k0valik/pi-blackhole/issues/83))
-> - **Compaction summaries now speak recall's index space** — `(#N)` refs are session-global, so they resolve to the right operation after compactions and branches instead of pointing at unrelated history. ([#82](https://github.com/k0valik/pi-blackhole/issues/82))
-> - **Memory that curates for a future session** — rebuilt observer/reflector/dropper prompts (survival test, grounding rules, noise exclusions) plus observation timestamps derived from cited evidence instead of model-typed dates.
-> - **Observer fires before the first compaction** — a never-compacted session (fresh start, fork, subagent) no longer stays at zero observations forever; the observer runs as soon as the token threshold is hit. ([#87](https://github.com/k0valik/pi-blackhole/issues/87))
-> - **Auto-compaction no longer errors on "session too small"** — proactive triggers pre-check Pi's own compaction eligibility instead of notice-spamming and throwing.
+> - **Non-English (CJK) sessions are now fully script-aware** — token accounting counts CJK as ~1 token/char (no more ~3× silent overage), text clipping and `recall` queries respect CJK punctuation and word boundaries, and the extractors accept CJK correction anchors and failure stems. ([#105](https://github.com/k0valik/pi-blackhole/issues/105), [#106](https://github.com/k0valik/pi-blackhole/issues/106))
+> - **`[Files And Changes]` and `[Commits]` extract what actually happened** — file attribution correlates tool calls with results instead of guessing from a hardcoded tool list, and commit capture understands real-world flag orders and heredocs. ([#105](https://github.com/k0valik/pi-blackhole/issues/105))
+> - **Observer chunks always respect `maxTokens`** — `custom_message` entries (previously zero-counted) are now sized like every other entry. ([#110](https://github.com/k0valik/pi-blackhole/issues/110))
+> - **`[Files And Changes]` display and cross-compaction merge overhauled** — cwd-relative paths, capped lists that never shrink, and `(#N)` drill-down refs.
 
 See [`CHANGELOG.md`](CHANGELOG.md) for the full history.