# Changelog

All notable changes to this project are documented in this file.

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

## [Unreleased]

## [0.3.2] - 2026-07-24

### Added

- Add the real interactive demo GIF as Pi package-gallery preview media so the extension has a visual preview on pi.dev.

## [0.3.1] - 2026-07-24

### Changed

- Redesign the README as a polished product showcase with responsive light and dark banners, a real interactive demo, restrained project badges, a workflow overview, grouped features, and clearer progressive disclosure.
- Include README media assets in the published npm package.

### Fixed

- Expose the package through `extensions/index.ts` to remove the redundant `:pi-rich-questions` suffix from Pi's package provenance label; npm installs now display simply as `pi-rich-questions`.
- Correct README wording while retaining the requested playful opening and clarify the empty-session demo and TUI requirements.

## [0.3.0] - 2026-07-23

### Added

- A progressive-disclosure public README and complete task-oriented documentation set for installation, authoring, configuration/extraction, interaction/accessibility, results, troubleshooting, security/privacy, architecture, development/testing, and releasing/deployment.
- MIT licensing, contribution guidelines, and a private-first vulnerability reporting policy for the public project.
- A friendly empty-session prompt that can hand `demo pi-rich-questions` to the active agent for a natural demonstration.
- Concise first-run extraction setup with the session model and low extraction thinking as the recommended default.
- A searchable picker for authenticated Pi models and model-supported thinking levels, with low thinking initially highlighted and recommended for speed and lower cost.
- Global extraction preferences with `/rich-questions config` and `/rich-questions reset`.
- Automatic retry with the active session model and session thinking setting when a dedicated extraction model is unavailable or fails.

### Changed

- Prepare npm metadata for the public `ArtOfIntel/pi-rich-questions` repository with author, license, repository, homepage, issue tracker, discoverability keywords, and an explicit package-files allowlist.
- Replace the draft documentation outline with maintained public guides and mark documentation TODO #1 complete.
- Define inheritance as using the current session model with low extraction thinking, clamped to model support, rather than inheriting the session thinking level.
- Standardize current naming on display name **Pi Rich Questions**, project/repository and npm package `pi-rich-questions`, extension directory `extensions/pi-rich-questions`, slash command `/rich-questions`, and tool API `ask_rich_questions`.
- Replace the `/answer-rich` command with the unified `/rich-questions` command namespace.

### Fixed

- Make Page Up and Page Down move by a visible page in the searchable extraction-model picker using Pi's injected selection bindings.
- Resolve session fallback credentials lazily for custom extraction models, while retaining configured-first/session-second retry order and the session thinking level on fallback.
- Keep empty-session demo decline behavior friendly while accepted demos flow through a normal user message and agent turn.

## [0.2.1] - 2026-07-21

### Fixed

- Render the rich-question form as a terminal-width modal overlay, isolating its viewport from the underlying Pi transcript so Page Up and Page Down scroll the form content.
- Resolve Page Up and Page Down through Pi's injected `tui.select.pageUp` and `tui.select.pageDown` keybindings instead of hard-coding physical keys.

### Added

- Integration coverage for modal presentation and form-local Page Up/Page Down scrolling.
- A concise `AGENTS.md` project guide and separate documentation outline and task tracker under `docs/`.

## [0.2.0]

### Added

- Modular form, state, rendering, layout, extraction, and formatting implementation.
- Markdown-rich prompts, context, recommendations, caveats, and option details.
- Per-option user notes, multiline editing, review-before-submit, and self-contained model-facing results.
- ANSI/Unicode-safe layout and height-aware form scrolling.
- Type checking and Bun test coverage.

## [0.1.0]

### Added

- Initial single-file local extension with the `ask_rich_questions` tool and `/answer-rich` command.