@kulapard/pi-caveman 0.1.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.
 
@@ -22,12 +28,12 @@ Project memory for agents working in this repo. Non-obvious conventions only.
   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. `validate.py` enforces
-  this and `compress.py` aborts + restores the original on any validation failure.
-- `caveman-compress` is **model-bound**: `compress.py` `call_claude()` calls the
-  Anthropic SDK (if `ANTHROPIC_API_KEY` is set) or the `claude --print` CLI. The
-  deterministic, unit-tested pieces are `detect.py`, `validate.py`, and the pure
-  helpers; the live model call is never exercised in tests (it is monkeypatched).
+  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 rather than leave a corrupted file.
+- `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`.
 
 ## Tests / validation
 
@@ -36,9 +42,6 @@ Project memory for agents working in this repo. Non-obvious conventions only.
 - 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.
-- **Python tests are not on PATH.** Create a venv and install pytest:
-  `python3 -m venv .venv && .venv/bin/pip install pytest`, then run
-  `npm run test:py` (which calls `.venv/bin/pytest skills/caveman-compress`).
 - 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

package/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [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
+
+- `caveman-compress` is now a prompt-only skill: the Pi agent performs the
+  compression itself (its own model and file tools), driven by `SKILL.md`. The
+  `/caveman-compress` command and the compression rules are unchanged.
+
+### Removed
+
+- The Python `caveman-compress` toolkit (`scripts/` + the pytest suite) and the
+  `test:py` script. The package no longer requires Python or an external
+  `claude` CLI / `ANTHROPIC_API_KEY`.
+
+## [0.1.0] - 2026-06-29
+
+Initial release — a [Pi](https://github.com/earendil-works/pi-coding-agent)
+port of [caveman](https://github.com/JuliusBrussee/caveman).
+
+### Added
+
+- Caveman output-mode extension (`extensions/caveman.ts`): six intensity modes
+  (lite, full, ultra, wenyan-lite, wenyan-full, wenyan-ultra; default full),
+  slash commands, natural-language activation/deactivation, and a session
+  statusline indicator.
+- Skills: `caveman`, `caveman-commit`, `caveman-review`, `caveman-help`,
+  `caveman-stats`, `caveman-compress`, and the `cavecrew` subagent suite.
+- npm packaging as `@kulapard/pi-caveman` (scoped, public) with a `files`
+  whitelist, a `prepublishOnly` test gate, and repository metadata.
+- GitHub Actions: `ci.yml` (test on push and pull requests) and `publish.yml`
+  (publish to npm via Trusted Publishing / OIDC on `v[0-9]*` tags — no stored
+  token, automatic provenance, a tag-equals-version guard, and a concurrency
+  group).
+
+[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
@@ -56,12 +56,6 @@ persistent install over a per-session `pi -e`.
 ```bash
 npm install            # fetch the Pi SDK + TypeScript dev deps
 npm test               # typecheck + extension/manifest/docs unit tests
-
-# Python tests for the caveman-compress toolkit need pytest in a local venv
-# (pytest is not on PATH on a fresh checkout):
-python3 -m venv .venv
-.venv/bin/pip install pytest
-npm run test:py        # runs: .venv/bin/pytest skills/caveman-compress
 ```
 
 ## Modes
@@ -73,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. |
@@ -97,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.
 
@@ -122,16 +116,12 @@ tool descriptions. pi-caveman does **not** bundle it: that proxy works at the
 MCP-client layer, independent of Pi, and upstream itself ships it as a separate
 package — so it does not belong in this extension-plus-skills package.
 
-The Pi-side equivalent is the Python `caveman-compress` toolkit, invoked via the
-`/caveman-compress` skill/command, which compresses prose memory files in place
-(writing a `FILE.original.md` backup) while preserving code, URLs, and paths
-verbatim. Note plainly: `caveman-compress` is **itself Claude-bound** — it
-performs compression via a live model call (the Anthropic SDK if
-`ANTHROPIC_API_KEY` is set, otherwise the `claude --print` CLI). So "the Pi
-equivalent" means *invoked via a Pi skill/command*, **not** *model-independent*.
-This is the same nature as upstream's MCP shrink (also a model-mediated
-transform); only the integration mechanism differs (a Pi skill here vs. MCP
-middleware upstream).
+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.<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.
 
 ## Attribution & license
 

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.1.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",
@@ -20,12 +20,10 @@
     "skills",
     "agents",
     "AGENTS.md",
-    "!**/__pycache__",
-    "!**/*.pyc",
-    "!skills/**/tests"
+    "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22.6.0"
   },
   "keywords": [
     "pi-package",
@@ -47,11 +45,10 @@
     "pretest": "npm run typecheck",
     "test": "node --experimental-strip-types --test tests/**/*.test.mjs",
     "typecheck": "tsc --noEmit",
-    "test:py": ".venv/bin/pytest skills/caveman-compress",
     "prepublishOnly": "npm test"
   },
   "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/README.md

@@ -40,7 +40,7 @@ Real results on real project files:
 | `mixed-with-code.md` | 888 | 560 | **36.9%** |
 | **Average** | **898** | **481** | **46%** |
 
-All validations passed ✅ — headings, code blocks, URLs, file paths preserved exactly.
+Headings, code blocks, URLs, and file paths preserved exactly.
 
 ## Before / After
 
@@ -65,23 +65,14 @@ All validations passed ✅ — headings, code blocks, URLs, file paths preserved
 
 **Same instructions. ~60% fewer tokens in this example (46% average across the files above). Every. Single. Session.**
 
-## Security
-
-`caveman-compress` is flagged as Snyk High Risk due to subprocess and file I/O patterns detected by static analysis. This is a false positive — see [SECURITY.md](./SECURITY.md) for a full explanation of what the skill does and does not do.
-
 ## Install
 
 This skill ships inside the pi-caveman package. Load the package (see the
 [root README](../../README.md) for the `pi -e … --skill …` / `pi install`
 mechanism), then use `/caveman-compress` in a Pi session.
 
-The compress toolkit lives at `skills/caveman-compress/` within the package; the
-skill instructions run the Python CLI under `scripts/`.
-
-**Requires:** Python 3.10+. Compression calls a model (the Anthropic SDK if
-`ANTHROPIC_API_KEY` is set, otherwise the `claude --print` CLI), so one of those
-must be available — see [Security](#security) and the root README's
-"Compression vs. upstream MCP shrink" note for why this step is model-bound.
+No extra runtime is required: the Pi agent performs the compression itself with
+its own model and file tools — there is no separate tool or language to install.
 
 ## Usage
 
@@ -111,23 +102,20 @@ Examples:
 ```
 /caveman-compress AGENTS.md
         ↓
-detect file type        (no tokens)
+agent detects file type      (prose? else skip)
         ↓
-toolkit calls a model to compress   (tokens — one call)
+agent backs up original  →  AGENTS.original.md   (verbatim, never overwritten)
         ↓
-validate output         (no tokens)
-  checks: headings, code blocks, URLs, file paths, bullets
+agent rewrites prose to caveman, code/URLs/paths left exact
         ↓
-if errors: model fixes cherry-picked issues only    (tokens — targeted fix)
-  does NOT recompress — only patches broken parts
+agent self-validates: protected tokens byte-identical to original
         ↓
-retry up to 2 times
+if a protected token changed: fix it, or restore from backup and report
         ↓
-write compressed → AGENTS.md
-write original   → AGENTS.original.md
+write compressed  →  AGENTS.md
 ```
 
-Only two things use tokens: initial compression + targeted fix if validation fails. Everything else is local Python.
+The agent does this with its own model and file tools — no external CLI, no separate runtime.
 
 ## What Is Preserved
 
@@ -149,15 +137,6 @@ A memory file (`AGENTS.md` / `CLAUDE.md`) loads on **every session start**. A 10
 
 Caveman cut that by ~46% on average. Same instructions. Same accuracy. Less waste.
 
-```
-┌────────────────────────────────────────────┐
-│  TOKEN SAVINGS PER FILE    █████       46% │
-│  SESSIONS THAT BENEFIT     ██████████ 100% │
-│  INFORMATION PRESERVED     ██████████ 100% │
-│  SETUP TIME                █            1x │
-└────────────────────────────────────────────┘
-```
-
 ## Part of Caveman
 
 This skill is part of the [caveman](https://github.com/JuliusBrussee/caveman) toolkit — making the agent use fewer tokens without losing accuracy. pi-caveman is the [Pi](https://github.com/earendil-works/pi-coding-agent) port.

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
 
@@ -19,21 +19,17 @@ Compress natural language files (`AGENTS.md`, `CLAUDE.md`, todos, preferences) i
 
 ## Process
 
-1. The compression scripts live in `scripts/` (adjacent to this SKILL.md). If the path is not immediately available, search for `scripts/__main__.py` next to this SKILL.md.
+You (the Pi agent) perform the compression directly — there is no separate tool to run. Given `/caveman-compress <filepath>`:
 
-2. From the directory containing this SKILL.md, run:
+1. **Skip backups.** If the path ends in `.original.<ext>` (e.g. `AGENTS.original.md`), stop — never compress a backup file.
+2. **Check it is compressible** per **Boundaries** below: prose files (`.md`, `.txt`, `.rst`, `.typ`, `.typst`, `.tex`, or extensionless natural language). If it is code/config (`.py`, `.js`, `.ts`, `.json`, `.yaml`, …) or larger than ~500 KB, report it is out of scope and stop.
+3. **Read** the file's full contents.
+4. **Back up the original.** Write a verbatim copy to `<filename>.original.<ext>` (e.g. `AGENTS.md` → `AGENTS.original.md`), **only if that backup does not already exist** — never overwrite an existing `.original` backup.
+5. **Rewrite** the file in place, applying the **Compression Rules** below. Treat code blocks, inline code, URLs, paths, commands, headings, and table structure as read-only regions.
+6. **Self-validate** against the contents you read in step 3: every protected token — fenced and inline code, URLs, file paths, heading text, table structure, dates/version numbers — must be byte-for-byte identical. If any changed, fix just that region; if you cannot make it identical, restore the file from the `.original` backup and report the failure rather than leave a corrupted file.
+7. **Report** the result: bytes before/after and the approximate reduction.
 
-python3 -m scripts <absolute_filepath>
-
-3. The CLI will:
-- detect file type (no tokens)
-- call a model to compress (Anthropic SDK if `ANTHROPIC_API_KEY` is set, else the `claude --print` CLI)
-- validate output (no tokens)
-- if errors: cherry-pick fix via the same model call (targeted fixes only, no recompression)
-- retry up to 2 times
-- if still failing after 2 retries: report error to user, leave original file untouched
-
-4. Return result to user
+Only the rewrite needs the model (you); detection, backup, and validation are mechanical.
 
 ## Compression Rules
 
@@ -103,9 +99,10 @@ Compressed:
 
 ## Boundaries
 
-- ONLY compress natural language files (.md, .txt, .typ, .typst, .tex, extensionless)
+- ONLY compress natural language files (.md, .txt, .rst, .typ, .typst, .tex, extensionless)
 - NEVER modify: .py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh
+- 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

package/skills/caveman-compress/SECURITY.md

@@ -1,31 +0,0 @@
-# Security
-
-## Snyk High Risk Rating
-
-`caveman-compress` receives a Snyk High Risk rating due to static analysis heuristics. This document explains what the skill does and does not do.
-
-### What triggers the rating
-
-1. **subprocess usage**: The skill calls the `claude` CLI via `subprocess.run()` as a fallback when `ANTHROPIC_API_KEY` is not set. The subprocess call uses a fixed argument list — no shell interpolation occurs. User file content is passed via stdin, not as a shell argument.
-
-2. **File read/write**: The skill reads the file the user explicitly points it at, compresses it, and writes the result back to the same path. A `.original.md` backup is saved alongside it. No files outside the user-specified path are read or written.
-
-### What the skill does NOT do
-
-- Does not execute user file content as code
-- Does not make network requests except to Anthropic's API (via SDK or CLI)
-- Does not access files outside the path the user provides
-- Does not use shell=True or string interpolation in subprocess calls
-- Does not collect or transmit any data beyond the file being compressed
-
-### Auth behavior
-
-If `ANTHROPIC_API_KEY` is set, the skill uses the Anthropic Python SDK directly (no subprocess). If not set, it falls back to the `claude` CLI, which uses the user's existing Claude desktop authentication.
-
-### File size limit
-
-Files larger than 500KB are rejected before any API call is made.
-
-### Reporting a vulnerability
-
-If you believe you've found a genuine security issue, please open a GitHub issue with the label `security`.

package/skills/caveman-compress/scripts/__init__.py

@@ -1,9 +0,0 @@
-"""Caveman compress scripts.
-
-This package provides tools to compress natural language markdown files
-into caveman format to save input tokens.
-"""
-
-__all__ = ["cli", "compress", "detect", "validate"]
-
-__version__ = "1.0.0"

package/skills/caveman-compress/scripts/__main__.py

@@ -1,3 +0,0 @@
-from .cli import main
-
-main()

package/skills/caveman-compress/scripts/benchmark.py

@@ -1,80 +0,0 @@
-#!/usr/bin/env python3
-from pathlib import Path
-import sys
-
-# Support both direct execution and module import
-try:
-    from .validate import validate
-except ImportError:
-    sys.path.insert(0, str(Path(__file__).parent))
-    from validate import validate
-
-try:
-    import tiktoken
-    _enc = tiktoken.get_encoding("o200k_base")
-except ImportError:
-    _enc = None
-
-
-def count_tokens(text):
-    if _enc is None:
-        return len(text.split())  # fallback: word count
-    return len(_enc.encode(text))
-
-
-def benchmark_pair(orig_path: Path, comp_path: Path):
-    orig_text = orig_path.read_text()
-    comp_text = comp_path.read_text()
-
-    orig_tokens = count_tokens(orig_text)
-    comp_tokens = count_tokens(comp_text)
-    saved = 100 * (orig_tokens - comp_tokens) / orig_tokens if orig_tokens > 0 else 0.0
-    result = validate(orig_path, comp_path)
-
-    return (comp_path.name, orig_tokens, comp_tokens, saved, result.is_valid)
-
-
-def print_table(rows):
-    print("\n| File | Original | Compressed | Saved % | Valid |")
-    print("|------|----------|------------|---------|-------|")
-    for r in rows:
-        print(f"| {r[0]} | {r[1]} | {r[2]} | {r[3]:.1f}% | {'✅' if r[4] else '❌'} |")
-
-
-def main():
-    # Direct file pair: python3 benchmark.py original.md compressed.md
-    if len(sys.argv) == 3:
-        orig = Path(sys.argv[1]).resolve()
-        comp = Path(sys.argv[2]).resolve()
-        if not orig.exists():
-            print(f"❌ Not found: {orig}")
-            sys.exit(1)
-        if not comp.exists():
-            print(f"❌ Not found: {comp}")
-            sys.exit(1)
-        print_table([benchmark_pair(orig, comp)])
-        return
-
-    # Glob mode: repo_root/tests/caveman-compress/
-    # __file__ lives at <repo_root>/skills/caveman-compress/scripts/benchmark.py
-    # Walk up four dirs: scripts → caveman-compress → skills → repo_root.
-    tests_dir = Path(__file__).resolve().parents[3] / "tests" / "caveman-compress"
-    if not tests_dir.exists():
-        print(f"❌ Tests dir not found: {tests_dir}")
-        sys.exit(1)
-
-    rows = []
-    for orig in sorted(tests_dir.glob("*.original.md")):
-        comp = orig.with_name(orig.stem.removesuffix(".original") + ".md")
-        if comp.exists():
-            rows.append(benchmark_pair(orig, comp))
-
-    if not rows:
-        print("No compressed file pairs found.")
-        return
-
-    print_table(rows)
-
-
-if __name__ == "__main__":
-    main()

package/skills/caveman-compress/scripts/cli.py

@@ -1,85 +0,0 @@
-#!/usr/bin/env python3
-"""
-Caveman Compress CLI
-
-Usage:
-    caveman <filepath>
-"""
-
-import sys
-
-# Force UTF-8 on stdout/stderr before any code can print. Windows consoles
-# default to cp1252 and crash on the ❌ glyphs in error/validation branches,
-# masking the real error and leaving the user with a half-compressed file.
-for _stream in (sys.stdout, sys.stderr):
-    reconfigure = getattr(_stream, "reconfigure", None)
-    if callable(reconfigure):
-        try:
-            reconfigure(encoding="utf-8", errors="replace")
-        except Exception:
-            pass
-
-from pathlib import Path
-
-from .compress import backup_dir_for, compress_file
-from .detect import detect_file_type, should_compress
-
-
-def print_usage():
-    print("Usage: caveman <filepath>")
-
-
-def main():
-    if len(sys.argv) != 2:
-        print_usage()
-        sys.exit(1)
-
-    filepath = Path(sys.argv[1])
-
-    # Check file exists
-    if not filepath.exists():
-        print(f"❌ File not found: {filepath}")
-        sys.exit(1)
-
-    if not filepath.is_file():
-        print(f"❌ Not a file: {filepath}")
-        sys.exit(1)
-
-    filepath = filepath.resolve()
-
-    # Detect file type
-    file_type = detect_file_type(filepath)
-
-    print(f"Detected: {file_type}")
-
-    # Check if compressible
-    if not should_compress(filepath):
-        print("Skipping: file is not natural language (code/config)")
-        sys.exit(0)
-
-    print("Starting caveman compression...\n")
-
-    try:
-        success = compress_file(filepath)
-
-        if success:
-            print("\nCompression completed successfully")
-            backup_path = backup_dir_for(filepath) / (filepath.stem + ".original.md")
-            print(f"Compressed: {filepath}")
-            print(f"Original:   {backup_path}")
-            sys.exit(0)
-        else:
-            print("\n❌ Compression failed after retries")
-            sys.exit(2)
-
-    except KeyboardInterrupt:
-        print("\nInterrupted by user")
-        sys.exit(130)
-
-    except Exception as e:
-        print(f"\n❌ Error: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()