@kulapard/pi-caveman 0.4.0 → 0.4.2

package/AGENTS.md

@@ -1,55 +1,25 @@
 # AGENTS.md — pi-caveman conventions
 
-Project memory for agents working in this repo. Non-obvious conventions only.
+Project memory. Non-obvious only.
 
 ## Architecture (do not rebuild)
 
-- `extensions/caveman.ts` is the Pi extension; `extensions/caveman-core.ts` holds
-  the pure, SDK-free logic (`normalizeMode`, `modeInstructions`, `VALID_MODES`,
-  the activation/deactivation regexes) so it is unit-testable without a fake SDK.
-- Mode state is **session-scoped**: stored via `pi.appendEntry("caveman-mode", …)`
-  and restored from `ctx.sessionManager.getBranch()` on `session_start`. A new
-  session always starts `off`. There is **no** cross-session config file or env var.
-- Activation = `before_agent_start` appends `modeInstructions(mode)` to the
-  system prompt. Statusline = `ctx.ui.setStatus("caveman", …)` guarded by `hasUI`.
-- The extension's `modeInstructions` injection is the **canonical** activator;
-  the `caveman` skill (`skills/caveman/SKILL.md`) is a standalone fallback for
-  hosts that load skills but not this extension. When both are active the model
-  may see both rule sets — mild, intentional redundancy. They are not
-  programmatically de-duped: skill loading is model-driven and the skill's prose
-  differs from `modeInstructions`, so there is no reliable text to match on.
-- Pi 0.80.2 has **no `agents/` subagent mechanism**. The `agents/cavecrew-*.md`
-  files are reference personas only and cavecrew is optional/out-of-scope.
+- `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-scoped**: `pi.appendEntry("caveman-mode", …)`, restored from `ctx.sessionManager.getBranch()` on `session_start`. New session always `off`. No cross-session config/env.
+- 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. If 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 is `import type` only** in `extensions/*.ts`. The JS tests run via
-  `--experimental-strip-types`, which erases type-only imports, so no installed
-  SDK is needed at test time. A value import from `@earendil-works/pi-coding-agent`
-  would break the tests — `tests/extension.test.mjs` asserts this invariant.
-- **Verbatim preservation**: caveman-compress never alters code blocks, inline
-  code, URLs, file paths, commands, or exact error strings. The skill instructs
-  the agent to self-validate these against the original and, on any mismatch it
-  cannot fix, restore from the `.original` backup that was created during the
-  same invocation (stale backups are rejected before compression starts).
-- `caveman-compress` is **prompt-only**: the Pi agent performs the compression
-  with its own model and file tools, driven by `SKILL.md`. There is no Python and
-  no external model CLI; coverage is the doc-guard test `tests/compress-docs.test.mjs`.
+- **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. Skill instructs 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`.
 
 ## Changelog
 
-Every notable change must update `CHANGELOG.md` under `[Unreleased]`. Before
-finishing a task, run `npm run changelog:check` to confirm the changelog was
-updated for the files you changed. CI also runs this check on every pull
-request.
-
-- `npm test` runs `pretest` (`npm run typecheck` → `tsc --noEmit`) first, then the
-  `node --test` suites under `tests/`. Typecheck failures fail the test run.
-- The JS test glob (`tests/**/*.test.mjs`) is expanded by the Node `--test` runner,
-  not the shell. Directory-recursion (`--test tests/`) does **not** work on the
-  current Node — keep the glob.
-- Several tests are **phantom-reference guards** (`tests/stats-docs.test.mjs`,
-  `tests/cavecrew-docs.test.mjs`, `tests/compress-docs.test.mjs`): they assert the
-  docs do **not** mention a Claude-Code hooks layer, a plugin install path, the
-  `⛏` badge, Claude-only subagent presets, or broken asset paths. Do not
-  reintroduce those references.
+Every notable change must update `CHANGELOG.md` under `[Unreleased]`. Before finishing task, run `npm run changelog:check` to confirm changelog updated for files changed. CI runs same check on every PR.
+
+- `npm test` runs `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,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.2] - 2026-06-29
+
+### Changed
+
+- Compressed `AGENTS.md` with `caveman-compress` to reduce session token load.
+- Added `*.original` and `*.original.*` to `.gitignore` so caveman-compress
+  backups are not committed accidentally.
+
+## [0.4.1] - 2026-06-29
+
+### Changed
+
+- README install instructions now recommend `pi install
+  https://github.com/kulapard/pi-caveman` as the primary direct-load method,
+  keeping `pi -e` documented as a per-session fallback.
+
+### Added
+
+- Guard tests for `caveman-compress` backup rules, the GitHub install URL in
+  the root README, and the `caveman` skill's delegation to `caveman-commit` /
+  `caveman-review`.
+
 ## [0.4.0] - 2026-06-29
 
 ### Fixed
@@ -90,7 +112,9 @@ 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.4.0...HEAD
+[Unreleased]: https://github.com/kulapard/pi-caveman/compare/v0.4.2...HEAD
+[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
 [0.4.0]: https://github.com/kulapard/pi-caveman/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/kulapard/pi-caveman/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/kulapard/pi-caveman/compare/v0.1.0...v0.2.0

package/README.md

@@ -20,13 +20,23 @@ Install it into a Pi setup with:
 pi install npm:@kulapard/pi-caveman
 ```
 
-You can also load it straight from a checkout on disk (no install needed) — see
-the `pi -e` mechanism below.
+You can also load it straight from a checkout on disk — see the `pi -e`
+mechanism below.
 
-### Load the extension directly (confirmed mechanism)
+### Install from GitHub
 
-The simplest, confirmed way to load it is Pi's `-e` flag, which loads the
-extension file for a session:
+The simplest way to load the latest version directly from the repository is:
+
+```bash
+pi install https://github.com/kulapard/pi-caveman
+```
+
+Pi resolves the `pi` block in `package.json` and loads both the extension and
+all skills from the cloned directory.
+
+### Load the extension directly (per-session)
+
+For quick testing without installing, use Pi's `-e` flag for a single session:
 
 ```bash
 pi -e /path/to/pi-caveman/extensions/caveman.ts --skill /path/to/pi-caveman/skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kulapard/pi-caveman",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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",