@diegopetrucci/pi-extensions 0.1.22 → 0.1.24

package/README.md

@@ -5,6 +5,7 @@ A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions
 - [`confirm-destructive`](./extensions/confirm-destructive): Confirms before destructive session actions like clear, switch, and fork.
 - [`context-cap`](./extensions/context-cap): Caps effective model context windows at 200k tokens by default so pi avoids the `dumb zone`; toggle temporarily with `/context-cap`.
 - [`context-inspector`](./extensions/context-inspector): Adds `/context`, a local self-contained HTML dashboard that breaks down where the current session context is going, with category overview, top offenders, and drilldown search.
+- [`dirty-repo-guard`](./extensions/dirty-repo-guard): Prompts before new sessions, session switches, or forks when the current git repo has uncommitted changes.
 - [`librarian`](./extensions/librarian): Adds a GitHub research scout with a local repo checkout cache enabled by default under the OS user cache directory, toggleable with `/librarian-cache`, with cached repos expiring after 30 days of non-use.
 - [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch/repo on the first line, context/model on the second, optional `DUMB ZONE`, plus OpenAI Codex 5-hour and 7-day usage when available.
 - [`notify`](./extensions/notify): Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.
@@ -26,7 +27,7 @@ pi install npm:@diegopetrucci/pi-extensions
 Or pin the GitHub package to this release:
 
 ```bash
-pi install git:github.com/diegopetrucci/pi-extensions@v0.1.22
+pi install git:github.com/diegopetrucci/pi-extensions@v0.1.24
 ```
 
 Or a specific extension:

package/extensions/dirty-repo-guard/README.md

@@ -0,0 +1,47 @@
+# dirty-repo-guard
+
+A small pi extension that prompts before session changes when the current git repo has uncommitted changes.
+
+This is copied from the original `dirty-repo-guard.ts` example in [`earendil-works/pi`](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/dirty-repo-guard.ts) and kept basically the same.
+
+## What it checks
+
+Before creating a new session, switching sessions, or forking, the extension runs:
+
+```bash
+git status --porcelain
+```
+
+If the command reports changed files, pi asks whether to proceed anyway. If pi is running without an interactive UI, matching actions are cancelled by default.
+
+## Install
+
+### Standalone npm package
+
+```bash
+pi install npm:@diegopetrucci/pi-dirty-repo-guard
+```
+
+### Collection package
+
+```bash
+pi install npm:@diegopetrucci/pi-extensions
+```
+
+### GitHub package
+
+```bash
+pi install git:github.com/diegopetrucci/pi-extensions
+```
+
+Then reload pi:
+
+```text
+/reload
+```
+
+## Notes
+
+- Hooks `session_before_switch` and `session_before_fork`.
+- Allows session changes outside git repos.
+- Cancels the action when the user declines.

package/extensions/dirty-repo-guard/index.ts

@@ -0,0 +1,56 @@
+/**
+ * Dirty Repo Guard Extension
+ *
+ * Prevents session changes when there are uncommitted git changes.
+ * Useful to ensure work is committed before switching context.
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+async function checkDirtyRepo(
+	pi: ExtensionAPI,
+	ctx: ExtensionContext,
+	action: string,
+): Promise<{ cancel: boolean } | undefined> {
+	// Check for uncommitted changes
+	const { stdout, code } = await pi.exec("git", ["status", "--porcelain"]);
+
+	if (code !== 0) {
+		// Not a git repo, allow the action
+		return;
+	}
+
+	const hasChanges = stdout.trim().length > 0;
+	if (!hasChanges) {
+		return;
+	}
+
+	if (!ctx.hasUI) {
+		// In non-interactive mode, block by default
+		return { cancel: true };
+	}
+
+	// Count changed files
+	const changedFiles = stdout.trim().split("\n").filter(Boolean).length;
+
+	const choice = await ctx.ui.select(`You have ${changedFiles} uncommitted file(s). ${action} anyway?`, [
+		"Yes, proceed anyway",
+		"No, let me commit first",
+	]);
+
+	if (choice !== "Yes, proceed anyway") {
+		ctx.ui.notify("Commit your changes first", "warning");
+		return { cancel: true };
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_before_switch", async (event, ctx) => {
+		const action = event.reason === "new" ? "new session" : "switch session";
+		return checkDirtyRepo(pi, ctx, action);
+	});
+
+	pi.on("session_before_fork", async (_event, ctx) => {
+		return checkDirtyRepo(pi, ctx, "fork");
+	});
+}

package/extensions/dirty-repo-guard/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@diegopetrucci/pi-dirty-repo-guard",
+  "version": "0.1.0",
+  "description": "A pi extension that prompts before session changes when the current git repo has uncommitted changes.",
+  "keywords": ["pi-package", "pi", "git", "safety"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diegopetrucci/pi-extensions.git",
+    "directory": "extensions/dirty-repo-guard"
+  },
+  "files": [
+    "index.ts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/extensions/librarian/index.ts

@@ -260,8 +260,13 @@ function getCacheConfigPath(): string {
 }
 
 function parseCacheMode(value: unknown): CacheMode | undefined {
-	if (value === "enabled" || value === "on" || value === true) return "enabled";
-	if (value === "disabled" || value === "off" || value === false) return "disabled";
+	if (typeof value === "string") {
+		const normalized = value.trim().toLowerCase();
+		if (normalized === "enabled" || normalized === "on" || normalized === "true") return "enabled";
+		if (normalized === "disabled" || normalized === "off" || normalized === "false") return "disabled";
+	}
+	if (value === true) return "enabled";
+	if (value === false) return "disabled";
 	return undefined;
 }
 
@@ -280,8 +285,8 @@ async function readCachePreference(): Promise<CacheMode> {
 			parseCacheMode(parsed.cache?.enabled) ??
 			DEFAULT_CACHE_MODE
 		);
-	} catch {
-		return DEFAULT_CACHE_MODE;
+	} catch (error) {
+		return (error as NodeJS.ErrnoException).code === "ENOENT" ? DEFAULT_CACHE_MODE : "disabled";
 	}
 }
 
@@ -324,7 +329,12 @@ function resolveToolPath(cwd: string, rawPath: string): string {
 }
 
 function getBlockedBashReason(command: string, options: { workspace: string; cacheRoot: string; cacheEnabled: boolean }): string | undefined {
-	const scan = command.split(options.workspace).join("<WORKSPACE>").split(options.cacheRoot).join("<CACHE>");
+	if (!options.cacheEnabled && command.includes(options.cacheRoot)) {
+		return "Local repo checkout cache is disabled for this Librarian call.";
+	}
+
+	let scan = command.split(options.workspace).join("<WORKSPACE>");
+	if (options.cacheEnabled) scan = scan.split(options.cacheRoot).join("<CACHE>");
 	if (/(^|[\n;&|()])\s*\//.test(scan)) return "Librarian bash blocks absolute-path executables.";
 
 	const destructiveLocal = /(^|[\n;&|()])\s*(?:sudo|su|rm|rmdir|mv|cp|chmod|chown|dd|truncate|killall|pkill|launchctl|osascript|pbcopy|pbpaste|eval|exec|xargs)(?=$|[\s;&|()])/;
@@ -580,9 +590,21 @@ export default function librarianExtension(pi: ExtensionAPI) {
 			await fs.mkdir(path.join(workspace, "repos"), { recursive: true });
 
 			const cacheRoot = getUserCacheReposRoot();
-			const cacheDecision = resolveCacheDecision(cachePreference);
-			if (cacheDecision.enabled) await fs.mkdir(cacheRoot, { recursive: true });
-			const cleanup = cacheDecision.enabled ? await cleanupExpiredCache(cacheRoot) : { deleted: 0, errors: [] };
+			let cacheDecision = resolveCacheDecision(cachePreference);
+			let cleanup: { deleted: number; errors: string[] } = { deleted: 0, errors: [] };
+			if (cacheDecision.enabled) {
+				try {
+					await fs.mkdir(cacheRoot, { recursive: true });
+					cleanup = await cleanupExpiredCache(cacheRoot);
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					cacheDecision = {
+						enabled: false,
+						reason: `cache setup failed (${message}); using GitHub API/temp files only`,
+					};
+					cleanup = { deleted: 0, errors: [`cache setup: ${message}`] };
+				}
+			}
 
 			const details: LibrarianDetails = {
 				status: "running",

package/extensions/librarian/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-librarian",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A pi GitHub research scout with a toggleable local repo checkout cache under the user's OS cache directory.",
   "keywords": ["pi-package", "pi", "github", "research", "subagent", "cache"],
   "license": "MIT",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.22",
-  "description": "A collection of pi extensions, including a GitHub librarian with toggleable local repo checkout caching, a minimal custom footer, an Amp-style oracle, a 200k context cap for auto-compaction, a local HTML context inspector, OpenAI Codex Fast mode controls, quiet one-line collapsed invocation previews, a permission gate for dangerous bash commands, confirm-before-destructive session actions, and terminal notifications when pi is ready for input.",
+  "version": "0.1.24",
+  "description": "A collection of pi extensions, including a GitHub librarian with toggleable local repo checkout caching, a minimal custom footer, an Amp-style oracle, a 200k context cap for auto-compaction, a local HTML context inspector, a dirty repository guard for session changes, OpenAI Codex Fast mode controls, quiet one-line collapsed invocation previews, a permission gate for dangerous bash commands, confirm-before-destructive session actions, and terminal notifications when pi is ready for input.",
   "keywords": ["pi-package", "pi", "terminal", "agent"],
   "license": "MIT",
   "repository": {
@@ -32,6 +32,7 @@
       "./extensions/oracle/index.ts",
       "./extensions/context-cap/index.ts",
       "./extensions/context-inspector/index.ts",
+      "./extensions/dirty-repo-guard/index.ts",
       "./extensions/librarian/index.ts",
       "./extensions/quiet-tools/index.ts",
       "./extensions/permission-gate/index.ts",