# Changelog

All notable changes to `@izhimu/pi-caveman` will be documented in this file.

## [0.5.0] - 2026-10-24

### Removed
- **Standalone `/ultracave` and `/megacave` slash commands** (including their plugin-namespaced `/caveman:ultracave` / `/caveman:megacave` forms and the `input` interception branches). The modes themselves are unchanged and remain reachable via `/caveman ultracave`, `/caveman megacave` (plus legacy aliases `ultra`, `wenyan*`) and natural-language triggers.

## [0.4.1] - 2026-10-24

### Fixed
- **Host API conformance for `sendMessage`**: the `/caveman status` summary is now sent as `{ customType: "caveman-status", content, display: false }`, matching pi's `SendMessageHandler` payload (which requires `customType`/`display` and has no `attribution` field). The old call passed an unsupported `attribution: "user"` and omitted `customType`, so pi persisted a session entry with `customType: undefined`. oh-my-pi accepts both shapes.
- **Session boundary handling**:
  - Fixed a dead-code bug: `reason === "resume" || reason === "reload" || "fork"` was always truthy (the last operand is a non-empty string literal), so session stats never reset on fresh sessions.
  - oh-my-pi adaptation: its `session_start` carries no `reason` and fires only on initial load; mid-process switches arrive as a separate `session_switch` event with reason `new|resume|fork`. The extension now handles both events; on pi the extra registration is a no-op (its runtime accepts arbitrary event names and never dispatches it).

### Testing
- Added mock-`ExtensionAPI` runtime tests: status message payload shape (including the `attribution` regression guard) and session stats continuity across `reload`/`resume`/`fork`/`session_switch` boundaries, sandboxed via `XDG_CONFIG_HOME` so they never touch `~/.pi`, `~/.omp`, or the machine caveman config.

## [0.4.0] - 2026-10-10

### Added & Changed
- **Three Skills, One Mode Model (Upstream 3.2.0 Sync)**:
  - Replaced the 6 intensity levels with 3 dedicated standalone skills:
    - `caveman`: Default smart terse voice, adhering to 9 core rules.
    - `ultracave`: Grammar stripped, fragments only, each fact once.
    - `megacave`: Classical Chinese (文言文) register with character minimization.
  - Shipped `skills/ultracave/` and `skills/megacave/` skills directories alongside `skills/caveman/`.
  - Added `canonicalMode()` to seamlessly map legacy mode names (`full`, `lite`, `ultra`, `wenyan*`) to the new three-skill architecture.
- **Upstream 3.2.0 Core Rules**:
  - Rule 6: Retain existing file comments in full unless explicitly asked to modify them.
  - Rule 7: Bounded tool runs — no narration between routine tool calls; single-line phase notices.
  - Exceptions: Always use full sentences when offering options or asking clarifying questions to the user.
  - Updated reinforcement thesis line extraction to synchronize with skill definitions.
- **Commands & UX**:
  - Added dedicated `/ultracave` and `/megacave` slash commands.
  - Supported `/caveman status` as a first-class subcommand.
  - Non-permanent status bar: clears status bar on mode changes and session start while providing clean transient toast notifications (`ui.notify`).
- **Testing**:
  - Comprehensive unit test suite covering mode canonicalization, three-skill loading, negation boundaries, and slash command parsing without logic duplication.

## [0.3.0] - 2026-09-17

### Changed & Improved
- **Upstream Core Sync**: Synchronized `skills/caveman/SKILL.md` with upstream Caveman ruleset:
  - Added ASD-STE100 Simplified Technical English clarity register (sentences ≤20 words, imperative instructions, unambiguous terms).
  - Added explicit reply-language precedence (honoring user/project language directives while preserving technical terms).
  - Removed meta-announcements and boilerplate prefixes (`me caveman think`, `Caveman:` tags).
  - Shortened skill description and token-optimized punctuation.
- **Host Adaptation (pi & oh-my-pi)**:
  - Dynamic host directory resolution (`~/.pi` vs `~/.omp`) for flags and logs.
  - Gated prompt reinforcement: injects full ruleset on activation or mode change; subsequent turns use lightweight one-line reminders to save tokens and avoid prompt cache misses.
  - Session persistence: preserves mid-session modes across compactions, reloads, and forks.
  - Removed unsupported `attribution: "system"` property from injected custom messages.
  - Added `"omp"` manifest and optional peer dependencies in `package.json`.
- **Robust Mode Parsing**:
  - Integrated upstream gap whitelist (`ACTIVATION_GAP`) to prevent false positives on phrases like "i want to start building a caveman-themed game".
  - Added clause-bounded negation detection (`don't activate caveman` won't trigger; `don't use vim, activate caveman` works).
- **Pruning**:
  - Removed `caveman-compress` skill and Python scripts to keep the package lightweight and focused purely on core caveman communication.

## [0.2.1] - 2026-08-21

### Changed & Improved
- **Prompt Rules Upstream Sync**: Synchronized core compression rules with upstream Caveman v2.2.0 — added anti-expansion guards (no fake broken grammar), verb preservation on equal token cost, and clear external issue/ticket boundaries.
- **Robust Mode Parser**: Added quoted-span disambiguation to prevent quoted text like `"stop caveman"` from triggering deactivation; added punctuation and quote normalization for `/caveman` arguments.
- **Enhanced `caveman-compress`**: Fixed Windows `cp1252` encoding exceptions, improved CommonMark code fence parsing, and preserved original file line endings (CRLF/LF) atomically.
- **Skill Slimming**: Trimmed redundant cloud-dependent and generic workflow skills to reduce initial system prompt index overhead by ~75%.

## [0.2.0] - 2026-08-16

### Added
- Multi-skill integration for pi package format.
- Namespaced slash commands and extended mode parsing.
- Published package under `@izhimu/pi-caveman`.

## [0.1.0] - 2026-07-15

### Added
- Initial release of pi-caveman extension for the Pi coding agent.
- 6 compression intensity levels (`lite`, `full`, `ultra`, `wenyan-lite`, `wenyan-full`, `wenyan-ultra`).
- Per-turn prompt reinforcement and auto-activation support.
- Session token tracking and estimated savings display via `/caveman-status`.