@xynogen/pix-commands 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,31 @@
+# pix-commands
+
+Pi extension — `/diff` and `/clear` slash commands.
+
+## What it does
+
+Registers two slash commands. `/diff` asks the agent to inspect `git status` and `git diff`, then respond with a one-sentence TL;DR, a per-file breakdown of what changed and why (with +/− line counts), and a brief impact note on behaviour or tests. If an agent turn is already in progress, the prompt is queued as a follow-up. `/clear` deletes `~/.cache/pi` — useful for flushing stale model-data or BenchLM cache — and prompts you to run `/reload` to apply the change. No extra dependencies beyond Pi.
+
+## Install
+
+```bash
+pi install npm:@xynogen/pix-commands
+```
+
+> Also included in [`@xynogen/pix-core`](https://github.com/xynogen/pix-mono/tree/main/packages/pix-core):
+>
+> ```bash
+> pi install npm:@xynogen/pix-core
+> ```
+
+## Full distro
+
+To install the complete pix suite (all packages + Pi itself):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-commands",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Pi extension — /diff and /clear commands",
 	"type": "module",
 	"main": "src/index.ts",

package/src/extension.ts

@@ -1,8 +1,11 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import registerClear from "./clear.ts";
 import registerDiff from "./diff.ts";
+import { once } from "./once.ts";
 
 export default function (pi: ExtensionAPI): void {
-	registerDiff(pi);
-	registerClear(pi);
+	once("pix-commands", () => {
+		registerDiff(pi);
+		registerClear(pi);
+	});
 }

package/src/once.ts

@@ -0,0 +1,16 @@
+/**
+ * Idempotency guard for extension activation.
+ *
+ * pix-core (the meta-package) invokes this package's factory in addition to a
+ * possible direct install. Pi's loader uses jiti with `moduleCache: false`, so
+ * each load pass re-evaluates modules — a plain module-level flag would not be
+ * shared. The dedupe key therefore lives on `globalThis`, which persists for
+ * the lifetime of the process across all load passes.
+ */
+export function once(key: string, fn: () => void): void {
+	const g = globalThis as { __pixLoaded?: Set<string> };
+	const loaded = (g.__pixLoaded ??= new Set<string>());
+	if (loaded.has(key)) return;
+	loaded.add(key);
+	fn();
+}