# Changelog

## Unreleased

### Changed

- Centralize optional JSON state-file loading in `src/fs-errors.ts` so run and record state modules share identical missing-file and parse-error behavior.

- Consolidate duplicated ENOENT detection into `src/fs-errors.ts` for run state, record state, playbook loading, and gitignore advisory paths.

- Include `CHANGELOG.md` and `SECURITY.md` in the npm package `files` manifest so `npm pack` ships both alongside README and LICENSE.

- Bump package version to `1.5.3` for the next patch release.

- Add Buy Me a Coffee sponsor button to README and native GitHub funding link via `.github/FUNDING.yml`.

## 1.5.2

- Runtime gitignore advisory now covers `.pi/playbook-records/` in addition to `.pi/playbook-runs/`; `docs/examples.md` aligned with README.

## 1.5.0

- Implemented `/playbook:import-web` to import external workflow articles into validated playbook drafts.
- Added Brave Search adapter support (`BRAVE_SEARCH_API_KEY` or `BRAVE_API_KEY`), URL fetching, model-assisted drafting with confirmation, skill mapping, and Required Source Trace metadata in saved YAML.
- Documented Brave Search and model configuration requirements in README.

## 1.4.0

- Dogfood review of `/playbook:rundiff`: step change lines include step names, duplicate final-outcome lines are omitted, and run-pair selectors show outcomes.
- Documented when to prefer rundiff vs history after regression dogfood.

- Added `/playbook:rundiff` to compare recent completed playbook runs with a compact diff view.
- The diff highlights meaningful changes: different playbooks, step sequences, outcomes, and extra/missing steps.
- Handles edge cases: identical runs (shows "All steps match"), changed runs (per-step diff), and insufficient runs (guidance to complete more runs).
- Documented rundiff usage, a regression/debugging example, and `rundiff vs history` comparison in `docs/examples.md`.

## 1.3.0

- Added `/playbook:history` to browse completed runs with compact metadata (playbook name, run id, finished time, final outcome).
- `/playbook:status` now points to history when no active run is loaded.
- Documented active vs completed run lifecycle in README, `docs/examples.md`, and `CONTEXT.md`.

## 1.2.0

- Implemented `/playbook:record:*` commands for explicit skill-flow recording with start, mark, branch, stop, and status subcommands.
- Added Recorded Skill Flow → Playbook Draft conversion with preview, strict validation, and confirm-before-save to `.pi/playbooks/`.
- Added `src/draft-save.ts` as the shared validation gate for recorded (and future imported) drafts.
- Documented how record complements deferred `/playbook:import-web` in README.

## 1.1.0

- Added Pi OSS lane sample playbooks: `pi-oss-new.yml`, `pi-oss-bootstrap-only.yml`, and `oss-maintenance-onboard.yml`.
- Documented when to use generic vs Pi OSS samples in README and expanded `docs/examples.md` with copy-and-start steps.
- Added `tests/samples.test.ts` to validate packaged samples against the strict schema and vault skill names.

## 1.0.1

- Added root `SECURITY.md` with vulnerability reporting instructions.
- Linked README Security section to `SECURITY.md`.

## 1.0.0

### Breaking changes

- Removed legacy `/playbook <subcommand>` space-dispatch. Use colon commands only (`/playbook:list`, `/playbook:start`, etc.).
- Removed explicit-argument forms (`/playbook:start <id>`, `/playbook:resume <run-id>`, `/playbook:choose <outcome>`, `/playbook:cancel <run-id>`). All subcommands are argument-free and use the Pi TUI selection UI on the happy path.
- Removed tab-completion for playbook IDs, run IDs, outcomes, and `--run` flags.

### Changed

- `playbook:*` commands are now the sole registered command surface.
- Auto-advance suggestion messages point to `/playbook:choose` without embedding outcome names.

## 0.1.5

- Rewrote README to align with the Pi OSS minimal-docs policy.
  - Added badges (CI, Publish, npm version, npm downloads, License, Pi package).
  - Added durable sections: What this is, Features, Install, Quick start, Usage summary, Package contents, Development, Release, Security, Links, License.
  - Documented all seven commands with a summary table.
  - Added Playbook YAML structure reference with auto advance modes.
  - No changes to runtime code.

## 0.1.4

- Initial public release.

## [1.5.4] - 2026-08-04

### Changed

- Bump package version for the Discord release webhook verification.