# Changelog

## [0.2.5] - 2026-11-03

### Fixed
- A loop with a limit of N iterations now runs iteration N before it completes ([#140](https://github.com/tmustier/pi-extensions/pull/140)).
- Starting or resuming a loop pauses the session's other active loop, and an empty task file no longer leaves a loop active ([#140](https://github.com/tmustier/pi-extensions/pull/140)).
- Loops keep going when Pi retries a failed request ([#141](https://github.com/tmustier/pi-extensions/pull/141)).

### Changed
- The stop banner is shown as a message, so the model no longer takes an extra turn to reply to it ([#141](https://github.com/tmustier/pi-extensions/pull/141)).

## [0.2.4] - 2026-09-22

### Changed
- Use Pi 0.87's bundled `typebox` as a peer for Ralph tool schemas instead of installing a separate runtime copy.

## [0.2.3] - 2026-07-21

### Fixed
- Bind active Ralph loops to their owning Pi session. Reloads and compaction restore only that session's loop; unrelated sessions sharing the same working directory no longer receive Ralph prompt injection or mutate the loop. `/ralph resume <name>` explicitly transfers ownership.

Thanks to @juicetin for the detailed report, regression test, and implementation ([#50](https://github.com/tmustier/pi-extensions/issues/50), [#52](https://github.com/tmustier/pi-extensions/pull/52)).

### Documentation
- Clarify that Ralph iterations are turns within one Pi session and context window, with normal Pi compaction, rather than fresh sessions per iteration.

Thanks to @rhossack and @RichardScottOZ for prompting the clarification ([#46](https://github.com/tmustier/pi-extensions/issues/46)).

## [0.2.2] - 2026-07-04

### Changed
- Add a completion gate to Ralph prompts and skill guidance. Agents are now instructed to preserve required verification artifacts and record an exact monitor-rerunnable final command before emitting `<promise>COMPLETE</promise>`.
- Deliver all Ralph-scheduled prompts (loop start, resume, iteration, and completion banner) with `deliverAs: "followUp"` so messages queue cleanly instead of steering when the agent is still processing.
- Add a stale-prompt guard instructing agents to reload loop state and ignore already-completed loops instead of doing duplicate work.

Thanks to @jorgecurious for contributing the completion gate, follow-up delivery, and stale-prompt guard ([#40](https://github.com/tmustier/pi-extensions/pull/40)).

## [0.2.1] - 2026-05-07

### Changed
- Declare the `@earendil-works/pi-coding-agent` peer and development dependency used by runtime imports.
- Update Pi extension imports to the new `@earendil-works` namespace.

## 0.2.0 - 2026-04-19

### Changed
- **BREAKING:** SKILL.md `name` renamed `ralph-wiggum` → `pi-ralph-wiggum` to match the parent directory (both in the repo and after `pi install npm:@tmustier/pi-ralph-wiggum`). This removes the `[Skill conflicts]` warning pi emitted on every startup, but it also changes the skill's public identifier — explicit invocations must now use `/skill:pi-ralph-wiggum` instead of `/skill:ralph-wiggum`. Thanks to @ishanmalik for reporting ([#12](https://github.com/tmustier/pi-extensions/issues/12)).
- Repo directory renamed `ralph-wiggum/` → `pi-ralph-wiggum/` as part of the same fix. Git-source users referencing `~/pi-extensions/ralph-wiggum/…` in their pi config should update the path to `~/pi-extensions/pi-ralph-wiggum/…`. The npm package name (`@tmustier/pi-ralph-wiggum`) is unchanged.
- Renamed the README's `Install` section to `Installation` so it matches the skill validator's expectations.

## 0.1.7 - 2026-04-19

### Fixed
- Ralph loops no longer silently stop after auto-compaction or `/compact`. On session reload, `currentLoop` is now rehydrated from the on-disk state (most-recently-updated active loop wins on ties), so `ralph_done`, `agent_end`, and `before_agent_start` continue to function. Thanks to @elecnix for the detailed report and proposed fix ([#11](https://github.com/tmustier/pi-extensions/issues/11)).

## 0.1.5 - 2026-02-03

### Added
- Add preview image metadata for the extension listing.

## 0.1.4 - 2026-02-02

### Changed
- **BREAKING:** Updated tool execute signatures for Pi v0.51.0 compatibility (`signal` parameter now comes before `onUpdate`)
- **BREAKING:** Changed `before_agent_start` handler to use `systemPrompt` instead of deprecated `systemPromptAppend` (Pi v0.39.0+)

## 0.1.3 - 2026-01-26
- Added note clarifying this is a flat version without subagents.

## 0.1.1 - 2026-01-25
- Clarified that agents must write the task file themselves (tool does not auto-create it).

## 0.1.0 - 2026-01-13
- Initial release.