# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.4.10] - 2026-05-06

### Fixed
- Prevent the supervisor from sending both a mid-run steering message and an end-of-run follow-up for the same agent run.

### Added
- Regression coverage for one supervisor steering intervention per agent run.

## [0.4.9] - 2026-05-06

### Fixed
- Supervisor analysis now includes assistant tool calls, tool results, user bash executions, and assistant runtime errors in its conversation snapshot, so it can verify real shell/gh output instead of falsely demanding a rerun.
- End-of-run steering always specifies a queued delivery mode and ignores stale mid-run analysis results, reducing busy-agent and repeated stale-steer loops.

### Added
- Regression tests for supervisor snapshot extraction of tool calls/results and runtime errors.

## [0.4.8] - 2026-04-22

### Changed
- **Removed the always-on footer status badge** — supervisor no longer renders the `🎯` icon in the footer; only the live widget remains visible when enabled.
- **UI copy/docs updated** — settings text and README references now describe the supervisor widget without mentioning a footer badge.

## [0.4.7] - 2026-04-22

### Fixed
- **Release the hardened analysis runtime setup** — ships the centralized `cwd`/`agentDir`/`settingsManager` helper with explicit path validation for the supervisor's internal analysis session, preventing future partial wiring regressions.

## [0.4.5] - 2026-04-22

### Fixed
- **Pi v0.68+ path crash in supervisor analysis** — the internal one-shot analysis session now passes `cwd`, `agentDir`, and `settingsManager` into `DefaultResourceLoader`, `SessionManager.inMemory()`, and `createAgentSession()`, fixing `The "path" argument must be of type string. Received undefined` during supervision. Mirrors the compatibility fix discussed in `tintinweb/pi-subagents` issues #27 and #31.
- **Centralized analysis runtime wiring** — all `cwd`/`agentDir`/`settingsManager` setup for the supervisor's internal analysis session now lives in a single helper with explicit path validation, reducing the chance of future omissions.

## [0.4.4] - 2026-04-22

### Fixed
- **Removed blind fallback steering** — supervisor analysis errors no longer inject the hardcoded `Please continue working toward the goal.` message; failed analyses now skip steering for that turn instead of causing loops.
- **Safer end-of-run delivery** — `agent_end` steering is deferred one tick and only falls back to queued delivery if pi is still clearing streaming state, avoiding both the processing race and the old `followUp`-only behavior.
- **Duplicate steer suppression** — identical consecutive steering messages are ignored to prevent supervisor loops when the model repeats itself.

## [0.4.3] - 2026-04-22

### Fixed
- **Queued supervision messages at `agent_end`** — explicitly sends end-of-run steering via `deliverAs: "followUp"` so pi does not throw `Agent is already processing` when the runtime still considers the agent streaming.

## [0.4.2] - 2026-03-11

### Added
- **Interactive settings panel** — `/supervise` (no args) and `/supervise settings` now open a navigable settings UI built on pi-tui's `SettingsList` component instead of printing static text
  - Arrow keys to navigate, Enter/Space to cycle values or open submenus, Escape to close
  - **Model**: Enter opens the full interactive model picker as a submenu
  - **Sensitivity**: cycles through `low`/`medium`/`high` with contextual descriptions
  - **Widget**: toggles visibility inline
  - **Outcome** (when active): displays current goal with steer/turn counts
  - **Stop Supervision** (when active): confirm to stop directly from the panel
- `/supervise status` now also opens the interactive settings panel when supervision state exists

## [0.4.1] - 2026-02-22

### Changed
- Updated `@mariozechner/pi-ai`, `@mariozechner/pi-coding-agent`, and `@mariozechner/pi-tui` to 0.54.1

## [0.4.0] - 2026-02-22

### Added
- **`start_supervision` tool** — the agent can initiate supervision itself; once active it is locked and only the user can change or stop it via `/supervise`
- **`/supervise widget`** subcommand — toggle the status widget on/off
- **Workspace model persistence** — supervisor model saved to `.pi/supervisor-config.json` when `.pi/` exists; loaded automatically on next session
- **Streaming thinking** — supervisor reasoning streams live as a second line in the widget while analyzing
- **Stagnation detection** — after 5 consecutive steering messages with no `done`, switches to lenient evaluation (≥80% achieved → done) to avoid infinite loops
- **Mid-run steering for `medium` sensitivity** — checks every 3rd tool cycle (turns 2, 5, 8, …), confidence ≥ 0.90
- **Shortcut detection** — supervisor always steers when the agent takes shortcuts to satisfy the goal without properly achieving it

### Changed
- **Sensitivity reworked** — levels now control both *when* to check and *how confidently* to steer:
  - `low`: end-of-run only, no mid-run checks
  - `medium`: end-of-run + every 3rd tool cycle (confidence ≥ 0.90)
  - `high`: end-of-run + every tool cycle (confidence ≥ 0.85)
- **`/supervise <outcome>` no longer auto-starts the agent** — supervision is set up first; the user starts the conversation separately, giving full control over the opening prompt
- **Supervisor is now a pure outside observer** — removed system prompt injection (`before_agent_start`); the agent runs completely unmodified and the supervisor steers only through user messages
- **Footer simplified** — `🎯` emoji replaces the `[SUPERVISING]` text label
- **Model fallback chain** — session state → `.pi/supervisor-config.json` → active chat model → built-in default
- **Dead `ANALYSIS_INTERVAL` code removed** — `agent_end` always fires once per user prompt with the agent idle; the interval throttle was never reachable
- Desired outcome repeated at the bottom of every supervisor analysis prompt to keep it prominent in long conversations

### Fixed
- Steering loop was broken: `deliverAs: "followUp"` does not trigger a new turn when the agent is already idle; removed to use plain `sendUserMessage`

## [0.3.0] - 2026-02-21

Initial release of `pi-supervisor`.

### Added
- **Supervisor engine** — observes every agent turn and calls a configurable LLM to evaluate progress toward a user-defined outcome
- **`/supervise <outcome>`** — activate supervision with a natural-language goal
- **`/supervise stop`** — deactivate supervision
- **`/supervise status`** — show outcome, model, sensitivity, and intervention history
- **`/supervise model`** — interactive model picker using pi's internal `ModelSelectorComponent` (same UI as Ctrl+P)
- **`/supervise model <provider/modelId>`** — set supervisor model directly for scripting
- **`/supervise sensitivity <low|medium|high>`** — control how aggressively the supervisor steers
- **Separate supervisor model** — runs in an isolated in-memory pi `AgentSession`, independent from the chat model; uses the same API credentials via `ctx.modelRegistry`
- **Steering** — injects follow-up user messages when the agent drifts; supervision stops automatically when the goal is achieved
- **`SUPERVISOR.md` support** — custom supervisor system prompt loaded from `.pi/SUPERVISOR.md` (project) or `~/.pi/agent/SUPERVISOR.md` (global), falling back to the built-in template; mirrors pi's `SYSTEM.md` discovery convention
- **Session persistence** — supervision state (outcome, model, sensitivity, interventions) stored in the session file and restored on restart, session switch, fork, and tree navigation
- **Footer status** — always-visible one-liner showing outcome, model, and steer count while supervising
- **Widget** — shows goal, model, and recent interventions above the editor

[Unreleased]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.10...HEAD
[0.4.10]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.9...v0.4.10
[0.4.9]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.8...v0.4.9
[0.4.8]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.7...v0.4.8
[0.4.7]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.5...v0.4.7
[0.4.5]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.4...v0.4.5
[0.4.4]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.3...v0.4.4
[0.4.3]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.2...v0.4.3
[0.4.2]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.1...v0.4.2
[0.4.1]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.4.0...v0.4.1
[0.4.0]: https://github.com/jeonghyeon-net/pi-supervisor/compare/v0.3.0...v0.4.0
[0.3.0]: https://github.com/jeonghyeon-net/pi-supervisor/releases/tag/v0.3.0