@kulapard/pi-caveman 0.5.0 → 0.6.0

package/AGENTS.md

@@ -4,27 +4,27 @@ Project memory. Non-obvious only.
 
 ## Architecture (do not rebuild)
 
-- `extensions/caveman.ts` = Pi extension. `extensions/caveman-core.ts` = pure SDK-free logic (`normalizeMode`, `modeInstructions`, `VALID_MODES`, regexes). Unit-testable without fake SDK.
-- Mode state **session + project-scoped**: `pi.appendEntry("caveman-mode", …)`
-  restores from `ctx.sessionManager.getBranch()` on `session_start`; since
-  v0.4.3 `extensions/caveman-state.ts` also reads/writes `.pi/caveman-mode.json`
-  in the project directory. A session entry overrides the project default; a
-  project without a state file falls back to `off`. No global/env default.
-- Activation = `before_agent_start` appends `modeInstructions(mode)`. Statusline = `ctx.ui.setStatus("caveman", …)` guarded by `hasUI`.
-- Extension `modeInstructions` = **canonical** activator. `skills/caveman/SKILL.md` = fallback for hosts loading skills but not extension. Both active → model sees both rule sets; intentional redundancy, no de-dupe.
+- `extensions/caveman.ts` = Pi extension. `extensions/caveman-core.ts` holds SDK-free logic (`normalizeMode`, `modeInstructions`, `VALID_MODES`, regexes). Testable without fake SDK.
+- Mode state **session + project-scoped**: `pi.appendEntry("caveman-mode", …)` restores from `ctx.sessionManager.getBranch()` on `session_start`; since v0.4.3 `extensions/caveman-state.ts` reads/writes `.pi/caveman-mode.json`. Session entry overrides project default; missing state file → `off`. No global/env default.
+- `before_agent_start` appends `modeInstructions(mode)`. Statusline = `ctx.ui.setStatus("caveman", …)` guarded by `hasUI`.
+- Extension `modeInstructions` = **canonical** activator. `skills/caveman/SKILL.md` = fallback when extension not loaded. Both active → model sees both rule sets; intentional redundancy, no de-dupe.
 - Pi 0.80.2 has **no `agents/` subagent mechanism**. `agents/cavecrew-*.md` = reference personas only; cavecrew optional/out-of-scope.
 
 ## Invariants
 
-- **SDK import `import type` only** in `extensions/*.ts`. JS tests run via `--experimental-strip-types`, erases type-only imports. Value import from `@earendil-works/pi-coding-agent` breaks tests — `tests/extension.test.mjs` asserts this.
-- **Verbatim preservation**: caveman-compress never changes code blocks, inline code, URLs, paths, commands, exact error strings. Self-validate against original. Mismatch unfixable → restore from `.original` backup created in same invocation (stale backups rejected before compression).
-- `caveman-compress` is **prompt-only**: Pi agent compresses with own model + file tools, driven by `SKILL.md`. No Python, no external model CLI. Coverage = `tests/compress-docs.test.mjs`.
+- **SDK import `import type` only** in `extensions/*.ts`. JS tests use `--experimental-strip-types`, erases type-only imports. Value import from `@earendil-works/pi-coding-agent` breaks tests — `tests/extension.test.mjs` asserts this.
+- **Verbatim preservation**: caveman-compress never changes code blocks, inline code, URLs, paths, commands, exact error strings. Self-validate against original. Mismatch unfixable → restore from `.original` backup created in same invocation; stale backups rejected before compression.
+- `caveman-compress` **prompt-only**: Pi agent compresses with own model + file tools, driven by `SKILL.md`. No Python, no external model CLI. Coverage = `tests/compress-docs.test.mjs`.
 - `/caveman-compress` supports `--force`: overwrites existing `.original.<ext>` backup instead of aborting.
 
+## Releases
+
+Tag push triggers npm publish via `.github/workflows/publish.yml`. On release, create GitHub Release with same tag; paste matching `CHANGELOG.md` section into notes.
+
 ## Changelog
 
-Every notable change update `CHANGELOG.md` under `[Unreleased]`. Before finishing, run `npm run changelog:check`. CI runs same check on every PR.
+Every notable change → `CHANGELOG.md` `[Unreleased]`. Before finish, run `npm run changelog:check`. CI runs same check per PR.
 
-- `npm test` runs `pretest` (`npm run typecheck` → `tsc --noEmit`), then `node --test tests/**/*.test.mjs`. Typecheck failures fail test run.
+- `npm test` = `pretest` (`npm run typecheck` → `tsc --noEmit`), then `node --test tests/**/*.test.mjs`. Typecheck failures fail test run.
 - Node `--test` glob expanded by runner, not shell. Directory-recursion `--test tests/` does **not** work on current Node — keep glob.
 - Tests are **phantom-reference guards** (`tests/stats-docs.test.mjs`, `tests/cavecrew-docs.test.mjs`, `tests/compress-docs.test.mjs`): docs must not mention Claude-Code hooks layer, plugin install path, `⛏` badge, Claude-only subagent presets, broken asset paths. Do not reintroduce.

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-06-29
+
+### Added
+
+- Release notes reminder: when tagging a release, also create a GitHub Release with the same tag and paste the relevant `CHANGELOG.md` section into the release notes.
+
+### Changed
+
+- Statusline no longer appends `ctx:XX%`; shows only `caveman:<mode>`.
+- Re-compressed `AGENTS.md` with `/caveman-compress --force` to reduce session token load.
+
+### Repository
+
+- `.gitignore` now excludes `.pi/caveman-mode.json` (project-scoped mode state).
+
 ## [0.5.0] - 2026-06-29
 
 ### Added
@@ -122,7 +137,8 @@ port of [caveman](https://github.com/JuliusBrussee/caveman).
   token, automatic provenance, a tag-equals-version guard, and a concurrency
   group).
 
-[Unreleased]: https://github.com/kulapard/pi-caveman/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/kulapard/pi-caveman/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/kulapard/pi-caveman/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/kulapard/pi-caveman/compare/v0.4.2...v0.5.0
 [0.4.2]: https://github.com/kulapard/pi-caveman/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/kulapard/pi-caveman/compare/v0.4.0...v0.4.1

package/README.md

@@ -116,8 +116,7 @@ default, and a project without a state file falls back to `off`.
 ## Statusline indicator
 
 When a UI is attached, the statusline shows the active mode as
-`caveman:<mode>` (for example `caveman:ultra`), and appends live context usage
-as `ctx:XX%` when Pi provides it. When caveman is off the indicator is cleared.
+`caveman:<mode>` (for example `caveman:ultra`). When caveman is off the indicator is cleared.
 
 ## Compression vs. upstream MCP shrink
 

package/extensions/caveman.ts

@@ -32,13 +32,7 @@ export default function cavemanExtension(pi: ExtensionAPI) {
 
 	function setStatus(ctx?: ExtensionContext) {
 		if (!ctx?.hasUI) return;
-		const usage = ctx.getContextUsage?.();
-		const suffix =
-			usage?.percent != null ? ` ctx:${Math.round(usage.percent)}%` : "";
-		ctx.ui.setStatus(
-			"caveman",
-			mode === "off" ? undefined : `caveman:${mode}${suffix}`,
-		);
+		ctx.ui.setStatus("caveman", mode === "off" ? undefined : `caveman:${mode}`);
 	}
 
 	function persistMode(nextMode: StoredMode, ctx?: ExtensionContext) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kulapard/pi-caveman",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Caveman for Pi: ultra-compressed agent output that preserves technical substance. Six intensity modes, slash commands, natural-language activation, and a session statusline.",
   "type": "module",
   "license": "MIT",