@kulapard/pi-caveman 0.2.0 → 0.3.0

package/AGENTS.md

@@ -12,6 +12,12 @@ Project memory for agents working in this repo. Non-obvious conventions only.
   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.
 

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-06-29
+
+### Fixed
+
+- `/caveman-help` card linked "Full docs" to the upstream `JuliusBrussee/caveman`
+  repo; now points to `kulapard/pi-caveman`.
+- `caveman-help` skill table was missing `/caveman-stats`, disagreeing with the
+  extension's own `HELP_TEXT`; added the row.
+- `ultra` mode was documented as "Tables over prose" in the README and help
+  card, contradicting the injected mode instructions; docs now match behavior
+  (abbreviate prose words, arrows for causality).
+- Input handler no longer throws when an input event arrives without `text`
+  (`event.text.trim()` → `(event.text ?? "").trim()`).
+- `caveman-compress` docs said the backup is always `FILE.original.md`, but the
+  skill preserves the source extension; corrected to `FILE.original.<ext>`.
+
+### Changed
+
+- `engines.node` floor raised from `>=18` to `>=22.6.0`, matching the
+  `node --experimental-strip-types` requirement of the test/typecheck workflow.
+- Natural-language activation now also triggers on `"be brief"` (added to
+  `ACTIVATION_RE`, the `caveman` skill description, and the README) so the
+  deterministic regex matches the advertised triggers.
+
 ## [0.2.0] - 2026-06-29
 
 ### Changed
@@ -41,6 +65,7 @@ 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.2.0...HEAD
+[Unreleased]: https://github.com/kulapard/pi-caveman/compare/v0.3.0...HEAD
+[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
 [0.1.0]: https://github.com/kulapard/pi-caveman/releases/tag/v0.1.0

package/README.md

@@ -12,9 +12,9 @@ plus a set of skills under `skills/`.
 
 ## Install
 
-pi-caveman publishes to npm as
+pi-caveman is published to npm as
 [`@kulapard/pi-caveman`](https://www.npmjs.com/package/@kulapard/pi-caveman).
-Once the first release is live, install it into a Pi setup with:
+Install it into a Pi setup with:
 
 ```bash
 pi install npm:@kulapard/pi-caveman
@@ -67,7 +67,7 @@ session ends.
 |------|---------|--------|
 | **lite** | `/caveman lite` | Drop filler. Keep sentence structure. |
 | **full** | `/caveman` | Drop articles, filler, pleasantries, hedging. Fragments OK. Default. |
-| **ultra** | `/caveman ultra` | Extreme compression. Bare fragments. Tables over prose. |
+| **ultra** | `/caveman ultra` | Extreme compression. Bare fragments. Abbreviate prose words; arrows (X → Y). |
 | **wenyan-lite** | `/caveman wenyan-lite` | Classical Chinese (文言文) style, light compression. |
 | **wenyan-full** | `/caveman wenyan` | Full 文言文. Maximum classical terseness. |
 | **wenyan-ultra** | `/caveman wenyan-ultra` | Extreme classical terseness. |
@@ -91,7 +91,7 @@ You don't have to use a slash command. The extension watches your messages and
 switches mode on phrases like:
 
 - **Activate:** "caveman mode", "talk like caveman", "use caveman", "less
-  tokens", "fewer tokens", "save tokens" → enables **full** mode.
+  tokens", "fewer tokens", "save tokens", "be brief" → enables **full** mode.
 - **Deactivate:** "stop caveman", "normal mode", "disable caveman" → turns it
   off.
 
@@ -118,7 +118,7 @@ package — so it does not belong in this extension-plus-skills package.
 
 The Pi-side equivalent is the `caveman-compress` skill, invoked via the
 `/caveman-compress` command. It is prompt-only: the Pi agent itself compresses a
-prose memory file in place (writing a `FILE.original.md` backup) using its own
+prose memory file in place (writing a `FILE.original.<ext>` backup) using its own
 model and file tools, preserving code, URLs, and paths verbatim. No Python and no
 external Claude CLI are involved — compression is performed by the host Pi agent,
 the same way the other skills work.

package/extensions/caveman-core.ts

@@ -90,5 +90,5 @@ Auto-clarity:
 }
 
 export const ACTIVATION_RE =
-	/\b(caveman mode|talk like caveman|use caveman|less tokens|fewer tokens|save tokens)\b/i;
+	/\b(caveman mode|talk like caveman|use caveman|less tokens|fewer tokens|save tokens|be brief)\b/i;
 export const DEACTIVATION_RE = /\b(stop caveman|normal mode|disable caveman)\b/i;

package/extensions/caveman.ts

@@ -133,15 +133,14 @@ export default function cavemanExtension(pi: ExtensionAPI) {
 	});
 
 	pi.on("input", (event, ctx) => {
-		if (event.source === "extension") return { action: "continue" as const };
-		const text = event.text.trim();
-		if (DEACTIVATION_RE.test(text)) {
-			if (mode !== "off") persistMode("off", ctx);
-			return { action: "continue" as const };
-		}
-		if (mode === "off" && ACTIVATION_RE.test(text)) {
-			persistMode("full", ctx);
-			return { action: "continue" as const };
+		// Ignore the extension's own echoed input (self-echo guard).
+		if (event.source !== "extension") {
+			const text = (event.text ?? "").trim();
+			if (DEACTIVATION_RE.test(text)) {
+				if (mode !== "off") persistMode("off", ctx);
+			} else if (mode === "off" && ACTIVATION_RE.test(text)) {
+				persistMode("full", ctx);
+			}
 		}
 		return { action: "continue" as const };
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kulapard/pi-caveman",
-  "version": "0.2.0",
+  "version": "0.3.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",
@@ -23,7 +23,7 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22.6.0"
   },
   "keywords": [
     "pi-package",
@@ -49,6 +49,6 @@
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.2",
-    "typescript": "^5"
+    "typescript": "^6"
   }
 }

package/skills/caveman/SKILL.md

@@ -5,7 +5,7 @@ description: >
   while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra,
   wenyan-lite, wenyan-full, wenyan-ultra.
   Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens",
-  "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.
+  "fewer tokens", "save tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.
 ---
 
 Respond terse like smart caveman. All technical substance stay. Only fluff die.

package/skills/caveman-compress/SKILL.md

@@ -3,7 +3,7 @@ name: caveman-compress
 description: >
   Compress natural language memory files (AGENTS.md, CLAUDE.md, todos, preferences) into caveman
   format to save input tokens. Preserves all technical substance, code, URLs, and structure.
-  Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md.
+  Compressed version overwrites the original file. Human-readable backup saved as FILE.original.<ext> (same extension as the source).
   Trigger: /caveman-compress FILEPATH or "compress memory file"
 ---
 
@@ -11,7 +11,7 @@ description: >
 
 ## Purpose
 
-Compress natural language files (`AGENTS.md`, `CLAUDE.md`, todos, preferences) into caveman-speak to reduce input tokens. Compressed version overwrites original. Human-readable backup saved as `<filename>.original.md`.
+Compress natural language files (`AGENTS.md`, `CLAUDE.md`, todos, preferences) into caveman-speak to reduce input tokens. Compressed version overwrites original. Human-readable backup saved as `<filename>.original.<ext>` (same extension as the source, e.g. `AGENTS.md` → `AGENTS.original.md`, `notes.txt` → `notes.original.txt`).
 
 ## Trigger
 
@@ -104,5 +104,5 @@ Compressed:
 - Skip files larger than ~500 KB (too big to rewrite safely in one pass)
 - If file has mixed content (prose + code), compress ONLY the prose sections
 - If unsure whether something is code or prose, leave it unchanged
-- Original file is backed up as FILE.original.md before overwriting
-- Never compress FILE.original.md (skip it)
+- Original file is backed up as FILE.original.<ext> (same extension as the source) before overwriting
+- Never compress a FILE.original.<ext> backup (skip it)

package/skills/caveman-help/SKILL.md

@@ -16,7 +16,7 @@ Display this reference card when invoked. One-shot — do NOT change mode, write
 |------|---------|-------------|
 | **Lite** | `/caveman lite` | Drop filler. Keep sentence structure. |
 | **Full** | `/caveman` | Drop articles, filler, pleasantries, hedging. Fragments OK. Default. |
-| **Ultra** | `/caveman ultra` | Extreme compression. Bare fragments. Tables over prose. |
+| **Ultra** | `/caveman ultra` | Extreme compression. Bare fragments. Abbreviate prose words; arrows (X → Y). |
 | **Wenyan-Lite** | `/caveman wenyan-lite` | Classical Chinese style, light compression. |
 | **Wenyan-Full** | `/caveman wenyan` | Full 文言文. Maximum classical terseness. |
 | **Wenyan-Ultra** | `/caveman wenyan-ultra` | Extreme. Ancient scholar on a budget. |
@@ -30,6 +30,7 @@ Mode stick until changed or session end.
 | **caveman-commit** | `/caveman-commit` | Terse commit messages. Conventional Commits. ≤50 char subject. |
 | **caveman-review** | `/caveman-review` | One-line PR comments: `L42: bug: user null. Add guard.` |
 | **caveman-compress** | `/caveman-compress <file>` | Compress .md files to caveman prose. Saves ~46% input tokens. |
+| **caveman-stats** | `/caveman-stats` | On-demand, model-driven estimate of tokens saved this session. |
 | **caveman-help** | `/caveman-help` | This card. |
 
 ## Deactivate
@@ -48,4 +49,4 @@ Mode set per session. New session start → mode `off`; activate again with `/ca
 
 ## More
 
-Full docs: https://github.com/JuliusBrussee/caveman
+Full docs: https://github.com/kulapard/pi-caveman