pi-advisor-flow 0.5.6 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to this project are documented here.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0/).
 
+## 0.7.0 - 2026-09-19
+
+### Added
+
+- **Jev consultation filter** — an optional gate in front of `ask_advisor`. Jev, a small classification model by TypeSafe, takes one quick, inexpensive look at each consultation request; when it is clearly low-stakes and resolvable without the Advisor, the consultation is skipped with a short note telling the Executor to carry on — saving a full Advisor call. Everything else consults exactly as before, and if Jev cannot be reached the consultation simply goes through. Off by default.
+- **Proactive turn gate** — pi-advisor can now notice when the Executor has worked through several turns without any advice. Every N turns, one quick Jev check asks whether a senior second opinion is warranted right now; on a confident yes the Advisor consults and its advice is delivered to the Executor between turns. Also off by default.
+- **One-step setup** — open `/advisor-settings` → *Jev consultation filter* for guided setup: it verifies your access with one live call before turning anything on. Either paste a TypeSafe API key (stored securely — in your system's secret store when available, otherwise a dedicated owner-only file under `~/.pi/agent/`) or skip keys entirely: with an existing OpenRouter login in Pi, Jev reuses it automatically. A hand-placed plaintext key in `advisor.json` keeps working read-only and can be migrated to secure storage from the same screen.
+- **Skip-aware accounting** — the Session Advisor Summary shows how many consultations were screened, skipped, or overridden, what the Jev checks cost, and a labelled upper-bound estimate of what the skips saved; skipped consultations never touch the Advisor-call budget.
+- `/advisor-manual` consultations are now remembered by their question: if the Executor later asks the Advisor the exact same thing, the earlier advice is reattached instead of running another consultation. This deduplication is instant, free, and works even with the Jev screening filter turned off; sessions without any Jev activity report it as `Consultation dedup:` in the summary.
+- All Jev thresholds, costs, and the turn-gate interval are tunable from the `Jev …` rows in `/advisor-settings` without editing files. The default Jev call timeout is provisional pending real-world measurements.
+
+### Changed
+
+- The manual Advisor result message to the Executor now states it is informational and that no follow-up consultation is needed, preventing duplicate consultations.
+- Updated development tooling dependencies (ultracite 7.12.0, Biome 2.5.13, knip 6.37.0, lint-staged 17.5.1, typebox 1.3.34, @types/node 26.6.2, bun-types 1.4.2); no runtime dependencies changed. Biome is held at 2.5.13 because 2.5.14's `noUnnecessaryConditions` regression falsely flags the gate parsers' required `RegExp.exec` null-guards as dead code.
+
+## 0.6.0 - 2026-09-12
+
+### Fixed
+
+- Advisor and Scout thinking previews now respect Pi's `hide_thinking` setting, collapsing to a one-line `Thinking…` cue the way Pi renders the Executor's own hidden thinking.
+- The `ask_advisor` result no longer renders a doubled blank gap between the request and the first Scout line; the result box's own top padding was stacking on the call box's padding.
+- Session summaries keep the cumulative gate-intervention count when the loop gate resets repetition after a proceed decision.
+
+### Changed
+
+- Advisor thinking previews no longer render the 💭 emoji; the cue is a plain indented, italic line.
+- Internal code-quality remediation with no behavior change: Biome scanner rules (`noConsole`, `noFloatingPromises`, `noPrivateImports`, `noUndeclaredDependencies`, `useImportExtensions`) activated and all import specifiers normalized to `.ts`; knip-verified dead exports removed; `src/untracked.ts` renamed to `src/attachments.ts` (deep imports of the old path must switch; the four `src/config.ts`, `src/ui.ts`, `src/tools.ts`, and `src/commands.ts` facades are unchanged and now pinned by `test/facade-exports.test.ts`); the registration test suite split into fifteen focused files under 500 lines each with shared mock/config/harness helpers; Scout context building decomposed into `scout-types`, `scout-protocol`, `scout-groups`, and `scout-reconstruct` modules with a single invalid-protocol failure constructor; configuration key lists derived from one declarative `src/config/schema.ts` table; conversation redaction and tool-result capping extracted into `redaction.ts` and `tool-result-cap.ts` with linear-time byte capping; and repeated cancellation/teardown/fallback blocks collapsed in the Scout runner.
+
 ## 0.5.6 - 2026-09-11
 
 ### Fixed

package/README.md

@@ -25,6 +25,7 @@ Keep implementation on a fast model and borrow frontier reasoning only when deci
 - **Optional persistent activation, Simple mode, session summaries, and Herdr integration.**
 - **Compact searchable `/advisor-settings`** that matches Pi's settings list and saves changes immediately.
 - **Experimental Advisor Scout** that uses the configured Executor model to curate conversation evidence before every Advisor call.
+- **Optional Jev consultation filter and proactive turn gate** (TypeSafe): one cheap typed screening call skips low-stakes, self-answerable consultations; a periodic turn check can proactively pull in the Advisor. Works directly with a TypeSafe key or by reusing an existing OpenRouter login; both features are off by default.
 
 ## How it works