pi-gsd 1.6.1 → 1.6.3

package/.gsd/extensions/{gsd-hooks.ts → pi-gsd-hooks.ts}

@@ -1,6 +1,6 @@
 /**
- * gsd-hooks.ts - GSD pi Extension
- * gsd-extension-version: 1.30.0
+ * pi-gsd-hooks.ts — pi-gsd Extension
+ * pi-gsd-extension-version: 1.6.2
  *
  * Pi lifecycle extension for the Get Shit Done (GSD) workflow framework.
  * Provides three non-blocking hooks:
@@ -128,7 +128,7 @@ export default function (pi: ExtensionAPI) {
 				/\.env/,
 				/AGENTS\.md$/,
 				/settings\.json$/,
-				/gsd-hooks\.ts$/,
+				/pi-gsd-hooks\.ts$/,
 			];
 			if (allowed.some((p) => p.test(filePath))) return undefined;
 
@@ -517,7 +517,6 @@ export default function (pi: ExtensionAPI) {
 		},
 	});
 
-
 	// ── tool_result: context usage monitor ───────────────────────────────────
 	const WARNING_THRESHOLD = 35; // warn when remaining % ≤ 35
 	const CRITICAL_THRESHOLD = 25; // critical when remaining % ≤ 25

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-gsd",
-	"version": "1.6.1",
+	"version": "1.6.3",
 	"description": "Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",
 	"main": "dist/pi-gsd-tools.js",
 	"bin": {

package/scripts/postinstall.js

@@ -5,7 +5,7 @@
  * Runs automatically after `npm install pi-gsd`.
  * Copies the pi harness from this package's
  * \`.gsd/harnesses/pi/\` into the consumer project's \`.pi/gsd/\`
- * and installs the \`gsd-hooks.ts\` extension into \`.pi/extensions/\`.
+ * and installs the \`pi-gsd-hooks.ts\` extension into \`.pi/extensions/\`.
  *
  * Safe to re-run — files are skipped if already present (unless GSD_FORCE=1).
  */
@@ -219,7 +219,7 @@ function main() {
 		installed++;
 	}
 
-	// ── Pi extension (.pi/extensions/gsd-hooks.ts) ─────────────────────────────
+	// ── Pi extension (.pi/extensions/pi-gsd-hooks.ts) ─────────────────────────────
 	// Install the GSD pi lifecycle extension (session_start, tool_call, tool_result hooks).
 	// The extension is auto-discovered by pi from .pi/extensions/ - no manual wiring needed.
 	installPiExtension(PROJECT_ROOT, PKG_DIR, FORCE, (copied) => {
@@ -227,19 +227,32 @@ function main() {
 		else totalSkipped++;
 	});
 
-	// ── Pi prompt templates (.pi/prompts/gsd-*.md) ──────────────────────────────
-	const promptsSrc = path.join(PKG_DIR, "prompts");
+	// ── Pi prompt templates — cleanup stale local copies ───────────────────────
+	// Prompts are served directly from the npm package (user scope).
+	// Local copies in .pi/prompts/ cause collision warnings on every pi update.
+	// Remove any gsd-*.md files previously installed there.
+	// Also remove the old gsd-hooks.ts if present (renamed to pi-gsd-hooks.ts).
 	const promptsDest = path.join(PROJECT_ROOT, ".pi", "prompts");
-	if (fs.existsSync(promptsSrc)) {
-		const p = copyDir(promptsSrc, promptsDest, FORCE);
-		totalCopied += p.copied;
-		totalSkipped += p.skipped;
-		if (p.copied > 0) {
-			log("ok", `.pi/prompts  (${p.copied} template${p.copied === 1 ? "" : "s"} installed)`);
-		} else {
-			log("skip", `.pi/prompts  (already up-to-date)`);
+	if (fs.existsSync(promptsDest)) {
+		const stale = fs
+			.readdirSync(promptsDest)
+			.filter((f) => f.startsWith("gsd-") && f.endsWith(".md"));
+		if (stale.length > 0) {
+			for (const f of stale) fs.rmSync(path.join(promptsDest, f));
+			log(
+				"ok",
+				`.pi/prompts  (removed ${stale.length} stale local gsd-*.md — served from package instead)`,
+			);
 		}
 	}
+	const oldExt = path.join(PROJECT_ROOT, ".pi", "extensions", "gsd-hooks.ts");
+	if (fs.existsSync(oldExt)) {
+		fs.rmSync(oldExt);
+		log(
+			"ok",
+			".pi/extensions/gsd-hooks.ts  (removed — renamed to pi-gsd-hooks.ts)",
+		);
+	}
 
 	console.log("");
 
@@ -299,17 +312,33 @@ function getPackageVersion() {
 function installPiExtension(projectRoot, pkgDir, force, callback) {
 	const piDir = path.join(projectRoot, ".pi");
 	const extDir = path.join(piDir, "extensions");
-	const extDest = path.join(extDir, "gsd-hooks.ts");
-	const extSrc = path.join(pkgDir, ".gsd", "extensions", "gsd-hooks.ts");
+	const extDest = path.join(extDir, "pi-gsd-hooks.ts");
+	const extSrc = path.join(pkgDir, ".gsd", "extensions", "pi-gsd-hooks.ts");
 
 	if (!fs.existsSync(extSrc)) {
-		log("warn", ".pi/extensions/gsd-hooks.ts  (source absent - skipped)");
+		log("warn", ".pi/extensions/pi-gsd-hooks.ts  (source absent - skipped)");
 		callback(false);
 		return;
 	}
 
-	if (!force && fs.existsSync(extDest)) {
-		log("skip", ".pi/extensions/gsd-hooks.ts  (already exists)");
+	// Always update the extension — it is owned by pi-gsd, not the user.
+	// Compare pi-gsd-extension-version comments to detect staleness.
+	const extractVersion = (file) => {
+		try {
+			const match = fs
+				.readFileSync(file, "utf8")
+				.match(/pi-gsd-extension-version:\s*([\d.]+)/);
+			return match ? match[1] : null;
+		} catch {
+			return null;
+		}
+	};
+	const srcVersion = extractVersion(extSrc);
+	const destVersion = fs.existsSync(extDest) ? extractVersion(extDest) : null;
+	const needsUpdate = force || !destVersion || destVersion !== srcVersion;
+
+	if (!needsUpdate) {
+		log("skip", `.pi/extensions/pi-gsd-hooks.ts  (up-to-date v${destVersion})`);
 		callback(false);
 	} else {
 		try {
@@ -317,13 +346,13 @@ function installPiExtension(projectRoot, pkgDir, force, callback) {
 			fs.copyFileSync(extSrc, extDest);
 			log(
 				"ok",
-				".pi/extensions/gsd-hooks.ts  (GSD lifecycle extension installed)",
+				".pi/extensions/pi-gsd-hooks.ts  (GSD lifecycle extension installed)",
 			);
 			callback(true);
 		} catch (e) {
 			log(
 				"warn",
-				".pi/extensions/gsd-hooks.ts  (install failed: " + e.message + ")",
+				".pi/extensions/pi-gsd-hooks.ts  (install failed: " + e.message + ")",
 			);
 			callback(false);
 			return;
@@ -348,9 +377,13 @@ function installPiExtension(projectRoot, pkgDir, force, callback) {
 			? settings.extensions
 			: [];
 
+		// Remove stale gsd-hooks.ts entry if present (renamed to pi-gsd-hooks.ts)
+		const oldExtPath = path.join(extDir, "gsd-hooks.ts");
+		const cleaned = extensions.filter((e) => e !== oldExtPath);
+
 		// Avoid duplicate entries
-		if (!extensions.includes(extDest)) {
-			settings.extensions = [...extensions, extDest];
+		if (!cleaned.includes(extDest)) {
+			settings.extensions = [...cleaned, extDest];
 			fs.mkdirSync(piDir, { recursive: true });
 			fs.writeFileSync(
 				settingsFile,
@@ -358,6 +391,11 @@ function installPiExtension(projectRoot, pkgDir, force, callback) {
 				"utf8",
 			);
 			log("ok", ".pi/settings.json  (extensions array updated)");
+		} else if (cleaned.length !== extensions.length) {
+			// Removed stale entry but extDest already present
+			settings.extensions = cleaned;
+			fs.writeFileSync(settingsFile, JSON.stringify(settings, null, "\t"), "utf8");
+			log("ok", ".pi/settings.json  (removed stale gsd-hooks.ts entry)");
 		}
 	} catch (e) {
 		log("warn", ".pi/settings.json  (could not update: " + e.message + ")");

package/skills/gsd-setup-pi/SKILL.md

@@ -4,7 +4,7 @@ description: Check and repair GSD hook wiring for pi. Use when postinstall was s
 ---
 
 <objective>
-Verify that the GSD pi extension (`gsd-hooks.ts`) is correctly installed in the current project.
+Verify that the GSD pi extension (`pi-gsd-hooks.ts`) is correctly installed in the current project.
 If the extension is missing, install it and update `.pi/settings.json`.
 If already present, confirm hook wiring and report status.
 Always route first-time users to `/gsd-new-project` at the end.
@@ -12,7 +12,7 @@ Always route first-time users to `/gsd-new-project` at the end.
 
 <context>
 **Why this skill exists:**
-`bun install` does not run npm `postinstall` scripts, so `gsd-hooks.ts` may not be
+`bun install` does not run npm `postinstall` scripts, so `pi-gsd-hooks.ts` may not be
 automatically copied into the consumer project's `.pi/extensions/` directory.
 This skill provides a manual fallback that performs the same wiring as `postinstall.js`.
 
@@ -23,34 +23,34 @@ This skill provides a manual fallback that performs the same wiring as `postinst
 - `tool_result` → context-usage monitor with debounced warnings
 
 **Extension source inside the pi-gsd package:**
-`.gsd/extensions/gsd-hooks.ts`
+`.gsd/extensions/pi-gsd-hooks.ts`
 
 **Target location in the consumer project:**
-`.pi/extensions/gsd-hooks.ts`
+`.pi/extensions/pi-gsd-hooks.ts`
 
 **settings.json entry (belt-and-suspenders - pi also auto-discovers from `.pi/extensions/`):**
-`{ "extensions": ["<absolute-path-to-.pi/extensions/gsd-hooks.ts>"] }`
+`{ "extensions": ["<absolute-path-to-.pi/extensions/pi-gsd-hooks.ts>"] }`
 </context>
 
 <process>
 
 ## Step 1 - Locate the pi-gsd package
 
-Resolve the pi-gsd package root (where `gsd-hooks.ts` lives):
+Resolve the pi-gsd package root (where `pi-gsd-hooks.ts` lives):
 
 1. Try `node -e "console.log(require.resolve('pi-gsd/package.json'))"` - strip `/package.json` suffix to get PKG_DIR.
 2. If that fails, try common global paths:
    - `~/.bun/install/global/node_modules/pi-gsd`
    - `/home/linuxbrew/.linuxbrew/lib/node_modules/pi-gsd`
    - Output of `npm root -g` + `/pi-gsd`
-3. Confirm the extension source exists at `<PKG_DIR>/.gsd/extensions/gsd-hooks.ts`.
+3. Confirm the extension source exists at `<PKG_DIR>/.gsd/extensions/pi-gsd-hooks.ts`.
    If the source cannot be found, report the error clearly and stop - do not proceed to Step 2.
 
 ## Step 2 - Check current project extension status
 
 In the current working directory (the consumer project):
 
-- **Check A:** Does `.pi/extensions/gsd-hooks.ts` exist?
+- **Check A:** Does `.pi/extensions/pi-gsd-hooks.ts` exist?
 - **Check B:** Does `.pi/settings.json` exist? If yes, does `extensions` array include an absolute path to the extension file?
 - **Check C:** Does `.pi/extensions/` directory exist?
 
@@ -59,21 +59,21 @@ In the current working directory (the consumer project):
 ### If extension is MISSING (Check A failed):
 
 1. Create `.pi/extensions/` directory if it does not exist.
-2. Copy `<PKG_DIR>/.gsd/extensions/gsd-hooks.ts` → `.pi/extensions/gsd-hooks.ts`.
+2. Copy `<PKG_DIR>/.gsd/extensions/pi-gsd-hooks.ts` → `.pi/extensions/pi-gsd-hooks.ts`.
 3. Update `.pi/settings.json`:
-   - If the file does not exist, create it as `{ "extensions": ["<absolute-path>/.pi/extensions/gsd-hooks.ts"] }`.
+   - If the file does not exist, create it as `{ "extensions": ["<absolute-path>/.pi/extensions/pi-gsd-hooks.ts"] }`.
    - If the file exists but `extensions` array is missing or does not include the path, add the absolute path.
    - Preserve all other existing settings - merge, do not overwrite.
-4. Report: `✓ GSD extension installed at .pi/extensions/gsd-hooks.ts`
+4. Report: `✓ GSD extension installed at .pi/extensions/pi-gsd-hooks.ts`
 5. Report: `✓ .pi/settings.json updated`
 
 ### If extension is PRESENT (Check A passed):
 
 1. Confirm the file is non-empty (not a zero-byte stub).
-2. Confirm it contains the marker comment `gsd-extension-version:` - indicating it is the genuine GSD extension, not a stale copy from another tool.
+2. Confirm it contains the marker comment `pi-gsd-extension-version:` - indicating it is the genuine GSD extension, not a stale copy from another tool.
 3. Check Check B - if `settings.json` is missing or the extension path is absent, add it now (same logic as missing case, step 3).
 4. Report:
-   - `✓ GSD extension present at .pi/extensions/gsd-hooks.ts`
+   - `✓ GSD extension present at .pi/extensions/pi-gsd-hooks.ts`
    - `✓ hooks: session_start (update-check), tool_call (workflow-guard), tool_result (context-monitor)`
    - `✓ .pi/settings.json` - either "already registered" or "path added"
 
@@ -84,9 +84,9 @@ Print a concise status table:
 ```
 GSD pi hook wiring status
 ──────────────────────────────────────────────────────────
-Extension file     .pi/extensions/gsd-hooks.ts   ✓ / ✗
+Extension file     .pi/extensions/pi-gsd-hooks.ts   ✓ / ✗
 Settings entry     .pi/settings.json extensions   ✓ / ✗
-Extension version  gsd-extension-version: X.Y.Z   (value)
+Extension version  pi-gsd-extension-version: X.Y.Z   (value)
 ──────────────────────────────────────────────────────────
 ```