@kulapard/pi-caveman 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Caveman mode is now project-scoped: `.pi/caveman-mode.json` in the working
+  directory persists the mode across new sessions, while session entries still
+  override it for the current session. Falls back to `off` when no state exists.
+- Status bar now appends live context usage (`ctx:XX%`) when a caveman mode is
+  active and Pi exposes usage data. Updates on mode changes and at each turn end.
+
 ## [0.4.2] - 2026-06-29
 
 ### Changed

package/extensions/caveman-state.ts

@@ -0,0 +1,49 @@
+// Project-scoped persistence for caveman mode.
+// This is a workaround until Pi exposes SettingsManager to extensions
+// (tracked upstream as pi-coding-agent issue #4981).
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { normalizeMode, type StoredMode } from "./caveman-core.ts";
+
+const STATE_DIR = ".pi";
+const STATE_FILE = "caveman-mode.json";
+
+function statePath(cwd: string): string {
+	return join(cwd, STATE_DIR, STATE_FILE);
+}
+
+/**
+ * Load the project-scoped caveman mode default. Returns `undefined` when no
+ * state file exists or it cannot be read, so the caller can fall back to the
+ * session-scoped default (`off`).
+ */
+export function loadProjectMode(cwd: string): StoredMode | undefined {
+	const path = statePath(cwd);
+	if (!existsSync(path)) return undefined;
+	try {
+		const raw = JSON.parse(readFileSync(path, "utf8"));
+		return normalizeMode(raw.mode);
+	} catch {
+		return undefined;
+	}
+}
+
+/**
+ * Persist the caveman mode for this project directory. Returns `true` on
+ * success; failures are silent so that session operation is never blocked by
+ * disk issues.
+ */
+export function saveProjectMode(cwd: string, mode: StoredMode): boolean {
+	try {
+		const dir = join(cwd, STATE_DIR);
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+		writeFileSync(
+			statePath(cwd),
+			JSON.stringify({ mode, updatedAt: Date.now() }, null, 2),
+		);
+		return true;
+	} catch {
+		return false;
+	}
+}

package/extensions/caveman.ts

@@ -10,6 +10,7 @@ import {
 	normalizeMode,
 	type StoredMode,
 } from "./caveman-core.ts";
+import { loadProjectMode, saveProjectMode } from "./caveman-state.ts";
 
 const HELP_TEXT = `# Caveman for Pi
 
@@ -22,15 +23,22 @@ Commands:
 - /caveman-compress <file> — compress prose file via caveman-compress skill.
 - /caveman-stats — load stats skill/help.
 
-Mode persists in current Pi session and survives /reload via session state.
-Code, commands, API names, file paths, and exact errors stay verbatim.`;
+Mode persists across sessions in the same project via \`.pi/caveman-mode.json\`, and
+survives /reload via session state. Code, commands, API names, file paths, and
+exact errors stay verbatim.`;
 
 export default function cavemanExtension(pi: ExtensionAPI) {
 	let mode: StoredMode = "off";
 
 	function setStatus(ctx?: ExtensionContext) {
 		if (!ctx?.hasUI) return;
-		ctx.ui.setStatus("caveman", mode === "off" ? undefined : `caveman:${mode}`);
+		const usage = ctx.getContextUsage?.();
+		const suffix =
+			usage?.percent != null ? ` ctx:${Math.round(usage.percent)}%` : "";
+		ctx.ui.setStatus(
+			"caveman",
+			mode === "off" ? undefined : `caveman:${mode}${suffix}`,
+		);
 	}
 
 	function persistMode(nextMode: StoredMode, ctx?: ExtensionContext) {
@@ -40,7 +48,7 @@ export default function cavemanExtension(pi: ExtensionAPI) {
 	}
 
 	pi.on("session_start", (_event, ctx) => {
-		mode = "off";
+		mode = loadProjectMode(ctx.cwd) ?? "off";
 		for (const entry of ctx.sessionManager.getBranch() as Array<{
 			type?: string;
 			customType?: string;
@@ -73,6 +81,7 @@ export default function cavemanExtension(pi: ExtensionAPI) {
 				return;
 			}
 			persistMode(nextMode, ctx);
+			saveProjectMode(ctx.cwd, nextMode);
 			ctx.ui.notify(
 				nextMode === "off" ? "Caveman disabled" : `Caveman ${nextMode} enabled`,
 				"info",
@@ -137,14 +146,22 @@ export default function cavemanExtension(pi: ExtensionAPI) {
 		if (event.source !== "extension") {
 			const text = (event.text ?? "").trim();
 			if (DEACTIVATION_RE.test(text)) {
-				if (mode !== "off") persistMode("off", ctx);
+				if (mode !== "off") {
+					persistMode("off", ctx);
+					saveProjectMode(ctx.cwd, "off");
+				}
 			} else if (mode === "off" && ACTIVATION_RE.test(text)) {
 				persistMode("full", ctx);
+				saveProjectMode(ctx.cwd, "full");
 			}
 		}
 		return { action: "continue" as const };
 	});
 
+	pi.on("turn_end", (_event, ctx) => {
+		setStatus(ctx);
+	});
+
 	pi.on("before_agent_start", (event) => {
 		if (mode === "off") return undefined;
 		return {

package/package.json

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