pi-gsd 1.1.0 → 1.2.2

package/.gsd/extensions/gsd-hooks.ts

@@ -1,5 +1,5 @@
 /**
- * gsd-hooks.ts — GSD pi Extension
+ * gsd-hooks.ts - GSD pi Extension
  * gsd-extension-version: 1.30.0
  *
  * Pi lifecycle extension for the Get Shit Done (GSD) workflow framework.
@@ -23,215 +23,215 @@ import { join } from "node:path";
 import type { ContextUsage, ExtensionAPI } from "@mariozechner/pi-coding-agent";
 
 export default function (pi: ExtensionAPI) {
-	// ── session_start: GSD update check ──────────────────────────────────────
-	pi.on("session_start", async (_event, ctx) => {
-		try {
-			const cacheDir = join(homedir(), ".pi", "cache");
-			const cacheFile = join(cacheDir, "gsd-update-check.json");
-			const CACHE_TTL_SECONDS = 86_400; // 24 hours
-
-			// Show cached update notification if available
-			if (existsSync(cacheFile)) {
-				try {
-					const cache = JSON.parse(readFileSync(cacheFile, "utf8")) as {
-						update_available?: boolean;
-						installed?: string;
-						latest?: string;
-						checked?: number;
-					};
-					const ageSeconds =
-						Math.floor(Date.now() / 1000) - (cache.checked ?? 0);
-
-					if (cache.update_available && cache.latest) {
-						ctx.ui.notify(
-							`GSD update available: ${cache.installed ?? "?"} → ${cache.latest}. Run: npm i -g pi-gsd`,
-							"info",
-						);
-					}
-
-					// Cache is fresh — skip network check
-					if (ageSeconds < CACHE_TTL_SECONDS) return;
-				} catch {
-					// Corrupt cache — fall through to fresh check
-				}
-			}
-
-			// Run network check asynchronously after 3 s to avoid blocking startup
-			setTimeout(() => {
-				try {
-					mkdirSync(cacheDir, { recursive: true });
-
-					// Resolve installed version from project or global GSD install
-					let installed = "0.0.0";
-					const versionPaths = [
-						join(ctx.cwd, ".pi", "get-shit-done", "VERSION"),
-						join(homedir(), ".pi", "get-shit-done", "VERSION"),
-					];
-					for (const vp of versionPaths) {
-						if (existsSync(vp)) {
-							try {
-								installed = readFileSync(vp, "utf8").trim();
-								break;
-							} catch {
-								/* skip unreadable */
-							}
-						}
-					}
-
-					let latest: string | null = null;
-					try {
-						latest = execSync("npm view pi-gsd version", {
-							encoding: "utf8",
-							timeout: 10_000,
-							windowsHide: true,
-						}).trim();
-					} catch {
-						/* offline or npm unavailable */
-					}
-
-					writeFileSync(
-						cacheFile,
-						JSON.stringify({
-							update_available:
-								latest !== null &&
-								installed !== "0.0.0" &&
-								installed !== latest,
-							installed,
-							latest: latest ?? "unknown",
-							checked: Math.floor(Date.now() / 1000),
-						}),
-					);
-				} catch {
-					/* silent fail */
-				}
-			}, 3_000);
-		} catch {
-			/* silent fail — never throw from session_start */
-		}
-	});
-
-	// ── tool_call: workflow guard (advisory only, never blocking) ────────────
-	pi.on("tool_call", async (event, ctx) => {
-		try {
-			// Only guard write and edit tool calls
-			if (event.toolName !== "write" && event.toolName !== "edit")
-				return undefined;
-
-			const filePath = (event.input as { path?: string }).path ?? "";
-
-			// Allow .planning/ edits (GSD state management)
-			if (filePath.includes(".planning/")) return undefined;
-
-			// Allow common config/docs files that don't need GSD tracking
-			const allowed = [
-				/\.gitignore$/,
-				/\.env/,
-				/AGENTS\.md$/,
-				/settings\.json$/,
-				/gsd-hooks\.ts$/,
-			];
-			if (allowed.some((p) => p.test(filePath))) return undefined;
-
-			// Only activate when GSD project has workflow_guard enabled
-			const configPath = join(ctx.cwd, ".planning", "config.json");
-			if (!existsSync(configPath)) return undefined; // No GSD project
-
-			try {
-				const config = JSON.parse(readFileSync(configPath, "utf8")) as {
-					hooks?: { workflow_guard?: boolean };
-				};
-				if (!config.hooks?.workflow_guard) return undefined; // Guard disabled (default)
-			} catch {
-				return undefined;
-			}
-
-			// Advisory only — never block tool execution
-			const fileName = filePath.split("/").pop() ?? filePath;
-			ctx.ui.notify(
-				`⚠️ GSD: Editing ${fileName} outside a GSD workflow. Consider /gsd-fast or /gsd-quick to maintain state tracking.`,
-				"info",
-			);
-		} catch {
-			/* silent fail — never block tool execution */
-		}
-
-		return undefined;
-	});
-
-	// ── tool_result: context usage monitor ───────────────────────────────────
-	const WARNING_THRESHOLD = 35; // warn when remaining % ≤ 35
-	const CRITICAL_THRESHOLD = 25; // critical when remaining % ≤ 25
-	const DEBOUNCE_CALLS = 5; // minimum tool uses between repeated warnings
-
-	let callsSinceWarn = 0;
-	let lastLevel: "warning" | "critical" | null = null;
-
-	pi.on("tool_result", async (_event, ctx) => {
-		try {
-			const usage: ContextUsage | undefined = ctx.getContextUsage();
-			if (!usage || usage.percent === null) return undefined;
-
-			const usedPct = Math.round(usage.percent);
-			const remaining = 100 - usedPct;
-
-			// Below warning threshold — just increment debounce counter
-			if (remaining > WARNING_THRESHOLD) {
-				callsSinceWarn++;
-				return undefined;
-			}
-
-			// Respect opt-out via project config
-			const configPath = join(ctx.cwd, ".planning", "config.json");
-			if (existsSync(configPath)) {
-				try {
-					const config = JSON.parse(readFileSync(configPath, "utf8")) as {
-						hooks?: { context_warnings?: boolean };
-					};
-					if (config.hooks?.context_warnings === false) return undefined;
-				} catch {
-					/* ignore config errors */
-				}
-			}
-
-			const isCritical = remaining <= CRITICAL_THRESHOLD;
-			const currentLevel: "warning" | "critical" = isCritical
-				? "critical"
-				: "warning";
-
-			callsSinceWarn++;
-
-			// Debounce — allow severity escalation (warning → critical bypasses debounce)
-			const severityEscalated =
-				currentLevel === "critical" && lastLevel === "warning";
-			if (
-				lastLevel !== null &&
-				callsSinceWarn < DEBOUNCE_CALLS &&
-				!severityEscalated
-			) {
-				return undefined;
-			}
-
-			callsSinceWarn = 0;
-			lastLevel = currentLevel;
-
-			const isGsdActive = existsSync(join(ctx.cwd, ".planning", "STATE.md"));
-
-			let msg: string;
-			if (isCritical) {
-				msg = isGsdActive
-					? `🔴 CONTEXT CRITICAL: ${usedPct}% used (${remaining}% left). GSD state is in STATE.md. Inform user to run /gsd-pause-work.`
-					: `🔴 CONTEXT CRITICAL: ${usedPct}% used (${remaining}% left). Inform user context is nearly exhausted.`;
-			} else {
-				msg = isGsdActive
-					? `⚠️ CONTEXT WARNING: ${usedPct}% used (${remaining}% left). Avoid starting new complex work.`
-					: `⚠️ CONTEXT WARNING: ${usedPct}% used (${remaining}% left). Context is getting limited.`;
-			}
-
-			ctx.ui.notify(msg, isCritical ? "error" : "info");
-		} catch {
-			/* silent fail — never throw from tool_result */
-		}
-
-		return undefined;
-	});
+    // ── session_start: GSD update check ──────────────────────────────────────
+    pi.on("session_start", async (_event, ctx) => {
+        try {
+            const cacheDir = join(homedir(), ".pi", "cache");
+            const cacheFile = join(cacheDir, "gsd-update-check.json");
+            const CACHE_TTL_SECONDS = 86_400; // 24 hours
+
+            // Show cached update notification if available
+            if (existsSync(cacheFile)) {
+                try {
+                    const cache = JSON.parse(readFileSync(cacheFile, "utf8")) as {
+                        update_available?: boolean;
+                        installed?: string;
+                        latest?: string;
+                        checked?: number;
+                    };
+                    const ageSeconds =
+                        Math.floor(Date.now() / 1000) - (cache.checked ?? 0);
+
+                    if (cache.update_available && cache.latest) {
+                        ctx.ui.notify(
+                            `GSD update available: ${cache.installed ?? "?"} → ${cache.latest}. Run: npm i -g pi-gsd`,
+                            "info",
+                        );
+                    }
+
+                    // Cache is fresh - skip network check
+                    if (ageSeconds < CACHE_TTL_SECONDS) return;
+                } catch {
+                    // Corrupt cache - fall through to fresh check
+                }
+            }
+
+            // Run network check asynchronously after 3 s to avoid blocking startup
+            setTimeout(() => {
+                try {
+                    mkdirSync(cacheDir, { recursive: true });
+
+                    // Resolve installed version from project or global GSD install
+                    let installed = "0.0.0";
+                    const versionPaths = [
+                        join(ctx.cwd, ".pi", "gsd", "VERSION"),
+                        join(homedir(), ".pi", "gsd", "VERSION"),
+                    ];
+                    for (const vp of versionPaths) {
+                        if (existsSync(vp)) {
+                            try {
+                                installed = readFileSync(vp, "utf8").trim();
+                                break;
+                            } catch {
+                                /* skip unreadable */
+                            }
+                        }
+                    }
+
+                    let latest: string | null = null;
+                    try {
+                        latest = execSync("npm view pi-gsd version", {
+                            encoding: "utf8",
+                            timeout: 10_000,
+                            windowsHide: true,
+                        }).trim();
+                    } catch {
+                        /* offline or npm unavailable */
+                    }
+
+                    writeFileSync(
+                        cacheFile,
+                        JSON.stringify({
+                            update_available:
+                                latest !== null &&
+                                installed !== "0.0.0" &&
+                                installed !== latest,
+                            installed,
+                            latest: latest ?? "unknown",
+                            checked: Math.floor(Date.now() / 1000),
+                        }),
+                    );
+                } catch {
+                    /* silent fail */
+                }
+            }, 3_000);
+        } catch {
+            /* silent fail - never throw from session_start */
+        }
+    });
+
+    // ── tool_call: workflow guard (advisory only, never blocking) ────────────
+    pi.on("tool_call", async (event, ctx) => {
+        try {
+            // Only guard write and edit tool calls
+            if (event.toolName !== "write" && event.toolName !== "edit")
+                return undefined;
+
+            const filePath = (event.input as { path?: string }).path ?? "";
+
+            // Allow .planning/ edits (GSD state management)
+            if (filePath.includes(".planning/")) return undefined;
+
+            // Allow common config/docs files that don't need GSD tracking
+            const allowed = [
+                /\.gitignore$/,
+                /\.env/,
+                /AGENTS\.md$/,
+                /settings\.json$/,
+                /gsd-hooks\.ts$/,
+            ];
+            if (allowed.some((p) => p.test(filePath))) return undefined;
+
+            // Only activate when GSD project has workflow_guard enabled
+            const configPath = join(ctx.cwd, ".planning", "config.json");
+            if (!existsSync(configPath)) return undefined; // No GSD project
+
+            try {
+                const config = JSON.parse(readFileSync(configPath, "utf8")) as {
+                    hooks?: { workflow_guard?: boolean };
+                };
+                if (!config.hooks?.workflow_guard) return undefined; // Guard disabled (default)
+            } catch {
+                return undefined;
+            }
+
+            // Advisory only - never block tool execution
+            const fileName = filePath.split("/").pop() ?? filePath;
+            ctx.ui.notify(
+                `⚠️ GSD: Editing ${fileName} outside a GSD workflow. Consider /gsd-fast or /gsd-quick to maintain state tracking.`,
+                "info",
+            );
+        } catch {
+            /* silent fail - never block tool execution */
+        }
+
+        return undefined;
+    });
+
+    // ── tool_result: context usage monitor ───────────────────────────────────
+    const WARNING_THRESHOLD = 35; // warn when remaining % ≤ 35
+    const CRITICAL_THRESHOLD = 25; // critical when remaining % ≤ 25
+    const DEBOUNCE_CALLS = 5; // minimum tool uses between repeated warnings
+
+    let callsSinceWarn = 0;
+    let lastLevel: "warning" | "critical" | null = null;
+
+    pi.on("tool_result", async (_event, ctx) => {
+        try {
+            const usage: ContextUsage | undefined = ctx.getContextUsage();
+            if (!usage || usage.percent === null) return undefined;
+
+            const usedPct = Math.round(usage.percent);
+            const remaining = 100 - usedPct;
+
+            // Below warning threshold - just increment debounce counter
+            if (remaining > WARNING_THRESHOLD) {
+                callsSinceWarn++;
+                return undefined;
+            }
+
+            // Respect opt-out via project config
+            const configPath = join(ctx.cwd, ".planning", "config.json");
+            if (existsSync(configPath)) {
+                try {
+                    const config = JSON.parse(readFileSync(configPath, "utf8")) as {
+                        hooks?: { context_warnings?: boolean };
+                    };
+                    if (config.hooks?.context_warnings === false) return undefined;
+                } catch {
+                    /* ignore config errors */
+                }
+            }
+
+            const isCritical = remaining <= CRITICAL_THRESHOLD;
+            const currentLevel: "warning" | "critical" = isCritical
+                ? "critical"
+                : "warning";
+
+            callsSinceWarn++;
+
+            // Debounce - allow severity escalation (warning → critical bypasses debounce)
+            const severityEscalated =
+                currentLevel === "critical" && lastLevel === "warning";
+            if (
+                lastLevel !== null &&
+                callsSinceWarn < DEBOUNCE_CALLS &&
+                !severityEscalated
+            ) {
+                return undefined;
+            }
+
+            callsSinceWarn = 0;
+            lastLevel = currentLevel;
+
+            const isGsdActive = existsSync(join(ctx.cwd, ".planning", "STATE.md"));
+
+            let msg: string;
+            if (isCritical) {
+                msg = isGsdActive
+                    ? `🔴 CONTEXT CRITICAL: ${usedPct}% used (${remaining}% left). GSD state is in STATE.md. Inform user to run /gsd-pause-work.`
+                    : `🔴 CONTEXT CRITICAL: ${usedPct}% used (${remaining}% left). Inform user context is nearly exhausted.`;
+            } else {
+                msg = isGsdActive
+                    ? `⚠️ CONTEXT WARNING: ${usedPct}% used (${remaining}% left). Avoid starting new complex work.`
+                    : `⚠️ CONTEXT WARNING: ${usedPct}% used (${remaining}% left). Context is getting limited.`;
+            }
+
+            ctx.ui.notify(msg, isCritical ? "error" : "info");
+        } catch {
+            /* silent fail - never throw from tool_result */
+        }
+
+        return undefined;
+    });
 }

package/README.md

@@ -6,7 +6,7 @@
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![skills: 57](https://img.shields.io/badge/skills-57-orange.svg)](#skills)
 
-GSD is a structured software-delivery framework for AI coding agents. It wraps any AI coding session with a six-step phase lifecycle, 57 slash commands, 18 specialized subagents, background hooks, and model profiles — all backed by a git-committed `.planning/` directory that survives context resets.
+GSD is a structured software-delivery framework for AI coding agents. It wraps any AI coding session with a six-step phase lifecycle, 57 slash commands, 18 specialized subagents, background hooks, and model profiles - all backed by a git-committed `.planning/` directory that survives context resets.
 
 This package installs GSD into your project for pi (and optionally Claude Code, Gemini CLI, Cursor, Windsurf, OpenCode, Codex, and GitHub Copilot) automatically on `npm install`.
 
@@ -39,7 +39,7 @@ After install, run your first GSD command:
 | Artifact   | Count | Description                                                       |
 | ---------- | ----: | ----------------------------------------------------------------- |
 | Skills     |    57 | pi skill definitions (`/gsd-*`) loaded automatically              |
-| CLI binary |     1 | `gsd-tools` — state management, scaffolding, model routing        |
+| CLI binary |     1 | `pi-gsd-tools` - state management, scaffolding, model routing     |
 | Hooks      |     5 | Background hooks (context monitor, workflow guard, statusline, …) |
 
 ---
@@ -56,7 +56,7 @@ After install, run your first GSD command:
                                 └─► (next phase or /gsd-complete-milestone)
 ```
 
-All project state lives in `.planning/` — committed to git, survives `/clear` and context resets.
+All project state lives in `.planning/` - committed to git, survives `/clear` and context resets.
 
 ---
 
@@ -77,26 +77,26 @@ Run `/gsd-help` for the full list with descriptions.
 
 ---
 
-## CLI: `gsd-tools`
+## CLI: `pi-gsd-tools`
 
-The `gsd-tools` binary is the runtime backbone called by GSD workflow files. It manages all `.planning/` state. You rarely need to call it directly, but it's available:
+The `pi-gsd-tools` binary is the runtime backbone called by GSD workflow files. It manages all `.planning/` state. You rarely need to call it directly, but it's available:
 
 ```sh
-gsd-tools state json                        # dump current STATE.md as JSON
-gsd-tools state update <field> <value>      # update a state field
-gsd-tools find-phase <N>                    # locate a phase directory
-gsd-tools roadmap analyze                   # analyse ROADMAP.md structure
-gsd-tools validate health --repair          # check and auto-repair .planning/
-gsd-tools stats json                        # project statistics
-gsd-tools progress json                     # progress summary
-gsd-tools commit "message" --files a b c    # commit with GSD tracking
+pi-gsd-tools state json                        # dump current STATE.md as JSON
+pi-gsd-tools state update <field> <value>      # update a state field
+pi-gsd-tools find-phase <N>                    # locate a phase directory
+pi-gsd-tools roadmap analyze                   # analyse ROADMAP.md structure
+pi-gsd-tools validate health --repair          # check and auto-repair .planning/
+pi-gsd-tools stats json                        # project statistics
+pi-gsd-tools progress json                     # progress summary
+pi-gsd-tools commit "message" --files a b c    # commit with GSD tracking
 
 # Output formatting (pi-native)
-gsd-tools state json --output toon          # pretty-print with toon renderer
-gsd-tools state json --pick phase           # extract a single field
+pi-gsd-tools state json --output toon          # pretty-print with toon renderer
+pi-gsd-tools state json --pick phase           # extract a single field
 ```
 
-Run `gsd-tools --help` for the full command reference.
+Run `pi-gsd-tools --help` for the full command reference.
 
 ---
 
@@ -106,8 +106,8 @@ GSD routes subagents to different models based on your active profile:
 
 | Profile    | Description                                           |
 | ---------- | ----------------------------------------------------- |
-| `quality`  | Maximum reasoning — Opus/Pro for all decision agents  |
-| `balanced` | Default — Sonnet/Flash tier, good cost/quality ratio  |
+| `quality`  | Maximum reasoning - Opus/Pro for all decision agents  |
+| `balanced` | Default - Sonnet/Flash tier, good cost/quality ratio  |
 | `budget`   | Cheapest available model per agent                    |
 | `inherit`  | Use the session's currently selected model everywhere |
 
@@ -117,35 +117,36 @@ Switch profile: `/gsd-set-profile <profile>`
 
 ## Comparison with GSD v1.30.0
 
-| Feature | gsd v1.30 | pi-gsd | Details |
-| ---: | :---: | :---: | :--- |
-| `.planning/` data format | ✔️ | ✔️ | 100% compatible — projects are portable across tools |
-| `gsd-tools` CLI | ✔️ | ✔️ | Full TypeScript port, same command signatures |
-| 57 GSD skills | ✔️ | ✔️ | All commands available via pi skill system |
-| 18 subagents | ✔️ | ✔️ | Identical agent definitions |
-| 4 model profiles | ✔️ | ✔️ | quality / balanced / budget / inherit |
-| Workstreams | ✔️ | ✔️ | Full workstream isolation |
-| Multi-harness install | ✔️ | ✔️ | 8 harnesses via postinstall |
-| pi harness (`.pi/`) | ❌ | ✔️ | New — GSD installs into pi's config dir |
-| Background hooks (Claude/Gemini) | ✔️ | ✔️ | All 5 hooks, hardlinked |
-| Background hooks (pi) | ❌ | ✔️ | TypeScript extension (`gsd-hooks.ts`) installed via postinstall |
-| Correct skill paths for pi | ✔️ | ✔️ | All 57 skills use `.pi/get-shit-done/` paths |
-| Pi harness config entry | ❌ | ✔️ | `HARNESS_CONFIG` pi entry — generates `AGENTS.md` via `/gsd-profile-user` |
-| `-o toon` output | ❌ | ✔️ | Token-efficient toon renderer output |
-| `--pick` JSONPath extraction | ❌ | ✔️ | Field extraction from CLI output |
-| TypeScript source | ❌ | ✔️ | Full TS port of gsd-tools (9 k lines) |
-| Compile-time type safety | ❌ | ✔️ | Fully typed — `Record<string, any>` replaced with Zod-inferred types |
-| Runtime validation (Zod) | ❌ | ✔️ | Schema-driven `validate health` with field-path errors |
-| Smarter `--repair` | ❌ | ✔️ | Zod schema defaults fill all missing / invalid fields at once |
-| Toon output in skills | ❌ | ✔️ | `gsd-progress`, `gsd-stats`, `gsd-health` use `--output toon` |
-| Pi session history ingestion | ❌ | ✔️ | `/gsd-profile-user` reads pi JSONL sessions from `~/.pi/agent/sessions/` |
-| `/gsd-setup-pi` onboarding | ❌ | ✔️ | Setup skill for bun installs where postinstall is skipped |
+|                              Feature | gsd v1.30 | pi-gsd | Details                                                                                              |
+| -----------------------------------: | :-------: | :----: | :--------------------------------------------------------------------------------------------------- |
+|             `.planning/` data format |     ✔️     |   ✔️    | 100% compatible - projects are portable across tools                                                 |
+|                          Workstreams |     ✔️     |   ✔️    | Full workstream isolation                                                                            |
+|                     4 model profiles |     ✔️     |   ✔️    | quality / balanced / budget / inherit                                                                |
+|                         18 subagents |     ✔️     |   ✔️    | Identical agent definitions                                                                          |
+|                        57 GSD skills |     ✔️     |   ✔️    | All commands available via pi ~~skill system~~ prompt dispatcher (_more details below_)              |
+|        Different skills paths for pi |     ✔️     |   ⚡    | All 57 skills moved to `.pi/gsd/` to allow for advanced `pi-gsd-tools` usage  (_more details below_) |
+|                  pi harness (`.pi/`) |     ❌     |   ✔️    | New - GSD installs into pi's config dir                                                              |
+|                Background hooks (pi) |     ❌     |   ✔️    | TypeScript extension (`gsd-hooks.ts`) installed via postinstall                                      |
+|         Pi session history ingestion |     ❌     |   ✔️    | `/gsd-profile-user` reads pi JSONL sessions from `~/.pi/agent/sessions/`                             |
+|           `/gsd-setup-pi` onboarding |     ❌     |   ✔️    | Setup skill for `bun install` where postinstall is skipped   (default untrusted behavior)            |
+|      `gsd-tools` →`pi-gsd-tools` CLI |     ✔️     |   ⚡    | Same commands basic signatures as original (`gsd-tools`) but enhanced                                |
+| `[-o\|--output] [toon\|json]` output |     ❌     |   ⚡    | Token-efficient toon renderer output (or json, if LLM absolutely needs it...)                        |
+| `[-p\|--pick] {JSONPath}` extraction |     ❌     |   ⚡    | Field extraction from CLI output                                                                     |
+|                    TypeScript source |     ❌     |   ⚡    | Full TS port of gsd-tools (~9k lines)                                                                |
+|             Compile-time type safety |     ❌     |   ⚡    | Fully typed - no `any`, only Zod-inferred types                                                      |
+|             Runtime validation (Zod) |     ❌     |   ⚡    | Schema-driven `validate health` with field-path errors                                               |
+|                   Smarter `--repair` |     ❌     |   ⚡    | Zod schema defaults fill all missing/invalid fields at once                                          |
+|       Instant commands (no LLM cost) |     ❌     |   🚧    | `/gsd-progress`, `/gsd-stats`, `/gsd-help`, `/gsd-health` via pi extension commands                  |
+|       Prompt-dispatch for all skills |     ❌     |   🚧    | Pi prompt templates replace skill dispatch - clean autocomplete + arg hints                          |
+
+<!-- |        Pi harness config entry |     ❌     |   ✔️    | `HARNESS_CONFIG` pi entry - generates `AGENTS.md` via `/gsd-profile-user`           | -->
+<!-- |          Toon output in skills |     ❌     |   ✔️    | `gsd-progress`, `gsd-stats`, `gsd-health` use `--output toon`                       | -->
 
 ---
 
 ## Data Format Compatibility
 
-This package is a **faithful port** of GSD v1.30.0. The `.planning/` directory layout, all file formats (`STATE.md`, `ROADMAP.md`, `REQUIREMENTS.md`, `PLAN.md`, `SUMMARY.md`, `UAT.md`), frontmatter schemas, and `gsd-tools` command signatures are **byte-compatible** with the original `get-shit-done-cc` package.
+This package is a **faithful port** of GSD v1.30.0. The `.planning/` directory layout, all file formats (`STATE.md`, `ROADMAP.md`, `REQUIREMENTS.md`, `PLAN.md`, `SUMMARY.md`, `UAT.md`), frontmatter schemas, and `pi-gsd-tools` command signatures are **byte-compatible** with the original `get-shit-done-cc` package.
 
 Projects started with the original GSD work without migration.
 
@@ -157,7 +158,7 @@ Projects started with the original GSD work without migration.
 # Type-check
 npm run typecheck
 
-# Build CLI (TypeScript → dist/gsd-tools.js)
+# Build CLI (TypeScript → dist/pi-gsd-tools.js)
 npm run build
 
 # Validate integrity
@@ -168,4 +169,4 @@ node scripts/validate-model-profiles.cjs
 
 ## License
 
-MIT — this is an unofficial port. Original GSD by [Get Shit Done](https://github.com/gsd-build/get-shit-done).
+MIT - this is an unofficial port. Original GSD by [Get Shit Done](https://github.com/gsd-build/get-shit-done).