@pareto4/pp-core 1.6.0 → 1.6.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pp-core",
   "displayName": "PP Core",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "PP Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.",
   "author": {
     "name": "pareto4",

package/agents/pp-code-fixer.md

@@ -271,7 +271,7 @@ wt=$(mktemp -d "/tmp/sv-${padded_phase}-reviewfix-XXXXXX")
 # failed before the agent could do any work). The temp branch shares
 # history with $branch up to the moment of creation, so commits made
 # inside the worktree fast-forward $branch on cleanup.
-reviewfix_branch="gsd-reviewfix/${padded_phase}-$$"
+reviewfix_branch="pp-reviewfix/${padded_phase}-$$"
 git worktree add -b "$reviewfix_branch" "$wt" "$branch"
 
 # Write the recovery sentinel ONLY AFTER `git worktree add` succeeds.
@@ -297,7 +297,7 @@ Concrete steps:
 2. Resolve the current branch: `branch=$(git branch --show-current)`. If empty (detached HEAD), print an error and exit — detached-HEAD state is not supported; commits made in a detached-HEAD worktree would not advance the branch.
 3. **Recovery check (#2839, #2990):** If `${phase_dir}/.review-fix-recovery-pending.json` already exists, a prior run was interrupted. Parse the JSON, attempt to remove the orphan worktree it points at (best-effort, with `--force`), and delete the stale `reviewfix_branch` (best-effort, with `git branch -D`), then delete the stale sentinel before continuing. This makes a re-run of `/pp:code-review --fix` self-healing.
 4. Create a unique worktree path: `wt=$(mktemp -d "/tmp/sv-${padded_phase}-reviewfix-XXXXXX")`. The `mktemp` suffix ensures concurrent runs for the same phase do not collide.
-5. Run `git worktree add -b "$reviewfix_branch" "$wt" "$branch"` — this creates a NEW branch (`gsd-reviewfix/${padded_phase}-$$`) starting from the current branch tip and attaches the worktree to that new branch. Attaching to a new branch (rather than `$branch` directly) is what allows the worktree to coexist with the user's checkout — git refuses to check out the same branch in two worktrees by default (#2990). Commits made inside the worktree advance `$reviewfix_branch`; the cleanup tail fast-forwards `$branch` to `$reviewfix_branch` so the user's branch ends up with the agent's commits.
+5. Run `git worktree add -b "$reviewfix_branch" "$wt" "$branch"` — this creates a NEW branch (`pp-reviewfix/${padded_phase}-$$`) starting from the current branch tip and attaches the worktree to that new branch. Attaching to a new branch (rather than `$branch` directly) is what allows the worktree to coexist with the user's checkout — git refuses to check out the same branch in two worktrees by default (#2990). Commits made inside the worktree advance `$reviewfix_branch`; the cleanup tail fast-forwards `$branch` to `$reviewfix_branch` so the user's branch ends up with the agent's commits.
 6. **Write the recovery sentinel** at `${phase_dir}/.review-fix-recovery-pending.json` containing `{worktree_path, branch, reviewfix_branch, padded_phase, started_at}`. Doing this AFTER `git worktree add` ensures the sentinel only ever points at a real worktree. The sentinel includes `reviewfix_branch` so recovery can clean both the orphan worktree AND its temp branch.
 7. All subsequent file reads, edits, and commits happen inside `$wt` (which is on `$reviewfix_branch`, not `$branch`).
 
@@ -454,7 +454,7 @@ For each finding in sorted order:
 
 **If verification passed:**
 
-Use `pp-tools query commit` with conventional format (message first, then every staged file path):
+Use `pp_run query commit` with conventional format (message first, then every staged file path):
 ```bash
 _PP_SHIM_NAME="pp-tools.cjs"; _PP_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; PP_TOOLS="${_PP_RUNTIME_ROOT}/pp-core/bin/${_PP_SHIM_NAME}"; if [ -f "$PP_TOOLS" ]; then pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${_PP_RUNTIME_ROOT}/.claude/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${_PP_RUNTIME_ROOT}/.claude/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${_PP_RUNTIME_ROOT}/.codex/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${_PP_RUNTIME_ROOT}/.codex/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif command -v pp-tools >/dev/null 2>&1; then PP_TOOLS="$(command -v pp-tools)"; pp_run() { "$PP_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="$HOME/.claude/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${HERMES_HOME:-$HOME/.hermes}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${CODEX_HOME:-$HOME/.codex}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/pp-core/bin/${_PP_SHIM_NAME}" ]; then PP_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/pp-core/bin/${_PP_SHIM_NAME}"; pp_run() { node "$PP_TOOLS" "$@"; }; else echo "ERROR: pp-tools.cjs not found at $PP_TOOLS and pp-tools is not on PATH. Run: npx -y @pareto4/pp-core@latest --claude --local" >&2; exit 1; fi; if [ -n "${CLAUDE_ENV_FILE:-}" ] && [ -n "${PP_TOOLS:-}" ]; then printf "export PATH='%s':\"\$PATH\"\n" "${PP_TOOLS%/*}" >> "$CLAUDE_ENV_FILE" 2>/dev/null || true; fi
 pp_run query commit \

package/bin/install.js

@@ -11504,8 +11504,6 @@ function finishInstall(settingsPath, settings, statuslineCommand, shouldInstallS
   if (runtime === 'claude' && isGlobal) {
     console.log(`
   ${green}Done!${reset} Restart ${program}, then in any directory either type ${cyan}${command}${reset} or ask Claude to run the ${cyan}pp-new-project${reset} skill.
-
-  ${cyan}Join the community:${reset} https://discord.gg/mYgfVNfA2r
 `);
     return;
   }
@@ -11514,16 +11512,12 @@ function finishInstall(settingsPath, settings, statuslineCommand, shouldInstallS
     const agentPath = configDir ? path.join(configDir, 'agents', 'gsd.yaml') : 'agents/gsd.yaml';
     console.log(`
   ${green}Done!${reset} Start ${program} with ${cyan}kimi --agent-file ${agentPath}${reset}, then run ${cyan}${command}${reset}.
-
-  ${cyan}Join the community:${reset} https://discord.gg/mYgfVNfA2r
 `);
     return;
   }
 
   console.log(`
   ${green}Done!${reset} Open a blank directory in ${program} and run ${cyan}${command}${reset}.
-
-  ${cyan}Join the community:${reset} https://discord.gg/mYgfVNfA2r
 `);
 }
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "pp-core",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "PP Core — a meta-prompting, context engineering, and spec-driven development system for AI coding agents. Loads pp-core's operating context into every Gemini CLI session.",
   "contextFileName": "GEMINI.md"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pareto4/pp-core",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Pareto pp-core — The Pareto Project's AI-assisted engineering framework: meta-prompting, context engineering, and spec-driven development for AI coding agents.",
   "bin": {
     "pp-core": "bin/install.js",

package/pp-core/bin/lib/agent-install-check.cjs

@@ -25,7 +25,7 @@ const runtime_homes_cjs_1 = require("./runtime-homes.cjs");
  *   1. GSD_AGENTS_DIR env var (explicit override, any runtime)
  *   2. For claude runtime: __dirname-relative path (agents/ sibling of gsd-core/)
  *      This is correct for both repo runs and real installs (the runtime config dir's
- *      agents/ folder) because gsd-tools.cjs lives inside gsd-core/bin/ in both cases.
+ *      agents/ folder) because pp-tools.cjs lives inside gsd-core/bin/ in both cases.
  *   3. For non-claude runtimes: getGlobalConfigDir(runtime)/agents
  *
  * @param runtime - the active runtime name; defaults to GSD_RUNTIME env, then 'claude'

package/pp-core/bin/lib/audit-command-router.cjs

@@ -1,11 +1,11 @@
 'use strict';
 /**
- * Audit command routers — CLI dispatchers for `gsd-tools audit-uat` and
- * `gsd-tools audit-open`.
+ * Audit command routers — CLI dispatchers for `pp-tools audit-uat` and
+ * `pp-tools audit-open`.
  *
  * ADR-959 (phase 4d-impl-3): audit command family cutover.
  * Extracted from the hardcoded `case 'audit-uat':` and `case 'audit-open':`
- * arms in gsd-tools.cjs.  Behaviour is preserved byte-for-behaviour from the
+ * arms in pp-tools.cjs.  Behaviour is preserved byte-for-behaviour from the
  * prior inline cases; the dispatch path now flows:
  *   default → dispatchCapabilityCommand →
  *   require(audit-command-router.cjs) → routeAuditUat | routeAuditOpen.

package/pp-core/bin/lib/audit.cjs

@@ -4,7 +4,7 @@
  *
  * Scans all .planning/ artifact categories for items with open/unresolved state.
  * Returns structured JSON for workflow consumption.
- * Called by: gsd-tools.cjs audit-open
+ * Called by: pp-tools.cjs audit-open
  * Used by: /gsd:complete-milestone pre-close gate
  *
  * ADR-457 build-at-publish: the hand-written bin/lib/audit.cjs collapsed

package/pp-core/bin/lib/capability-activation.cjs

@@ -43,7 +43,7 @@ function _readRawConfigKey(filePath, dotKey) {
             if (!_warnedRawConfigPaths.has(filePath)) {
                 _warnedRawConfigPaths.add(filePath);
                 try {
-                    process.stderr.write(`gsd-tools: warning: failed to parse ${filePath} as JSON — skipping for activation resolution\n`);
+                    process.stderr.write(`pp-tools: warning: failed to parse ${filePath} as JSON — skipping for activation resolution\n`);
                 }
                 catch { /* stderr might be closed */ }
             }

package/pp-core/bin/lib/capability-registry.cjs

@@ -115,7 +115,7 @@ const capabilities = {
     "id": "audit",
     "role": "feature",
     "title": "Audit",
-    "description": "Open-artifact audit and UAT-gap audit for milestone close gates; exposes `gsd-tools audit-uat` (cross-phase UAT outstanding items) and `gsd-tools audit-open` (structured open-artifact scan across debug, tasks, threads, todos, seeds, UAT, verification, context-questions).",
+    "description": "Open-artifact audit and UAT-gap audit for milestone close gates; exposes `pp-tools audit-uat` (cross-phase UAT outstanding items) and `pp-tools audit-open` (structured open-artifact scan across debug, tasks, threads, todos, seeds, UAT, verification, context-questions).",
     "tier": "full",
     "requires": [],
     "runtimeCompat": {
@@ -858,7 +858,7 @@ const capabilities = {
     "id": "intel",
     "role": "feature",
     "title": "Codebase intelligence",
-    "description": "Code-intelligence store for codebase querying, diff, snapshot, and API-surface extraction; exposes `gsd-tools intel` subcommands (query, status, update, diff, snapshot, patch-meta, validate, extract-exports, api-surface) and backs `/gsd-map-codebase` and `gsd-intel-updater`.",
+    "description": "Code-intelligence store for codebase querying, diff, snapshot, and API-surface extraction; exposes `pp-tools intel` subcommands (query, status, update, diff, snapshot, patch-meta, validate, extract-exports, api-surface) and backs `/pp-map-codebase` and `pp-intel-updater`.",
     "tier": "full",
     "requires": [],
     "runtimeCompat": {
@@ -1432,7 +1432,7 @@ const capabilities = {
     "id": "profile-pipeline",
     "role": "feature",
     "title": "Developer profiling pipeline",
-    "description": "Developer behavioral profiling from Claude Code session history; scans session JSONL files, extracts and samples user messages, and generates profile artifacts (USER-PROFILE.md, dev-preferences.md, CLAUDE.md sections). Exposes eight `gsd-tools` commands: scan-sessions, extract-messages, profile-sample (pipeline phase) and write-profile, profile-questionnaire, generate-dev-preferences, generate-claude-profile, generate-claude-md (output phase). Backs the /gsd-profile-user skill and gsd-user-profiler agent.",
+    "description": "Developer behavioral profiling from Claude Code session history; scans session JSONL files, extracts and samples user messages, and generates profile artifacts (USER-PROFILE.md, dev-preferences.md, CLAUDE.md sections). Exposes eight `pp-tools` commands: scan-sessions, extract-messages, profile-sample (pipeline phase) and write-profile, profile-questionnaire, generate-dev-preferences, generate-claude-profile, generate-claude-md (output phase). Backs the /pp-profile-user skill and pp-user-profiler agent.",
     "tier": "full",
     "requires": [],
     "runtimeCompat": {

package/pp-core/bin/lib/capability-state.cjs

@@ -5,7 +5,7 @@
  * Unified capability-state resolver that composes the three toggle systems
  * (install profile, runtime surface, config activation) into one per-capability
  * view. The loop resolver consumes this state so workflow dispatch and the
- * `gsd-tools capability state` diagnostic share the same enablement answer.
+ * `pp-tools capability state` diagnostic share the same enablement answer.
  *
  * Exports (three things, mirroring loop-resolver):
  *   resolveCapabilityState({ registry, installedSkills, surfacedSkills, config, cwd })

package/pp-core/bin/lib/capability-writer.cjs

@@ -299,7 +299,7 @@ function setCapabilityState(cwd, runtimeConfigDir, desired, opts) {
     };
 }
 /**
- * CLI command entry point for `gsd-tools capability set`.
+ * CLI command entry point for `pp-tools capability set`.
  *
  * Builds one DesiredCapability from the provided options, calls setCapabilityState,
  * then prints the result. When raw=true emits JSON; else emits a human summary.

package/pp-core/bin/lib/check-command-router.cjs

@@ -349,7 +349,7 @@ function cmdDecisionCoverageVerify(projectDir, args, raw) {
  * Returns JSON: { frontend: boolean, hasUiSpec: boolean, block: boolean }
  *   block = frontend && !hasUiSpec (gate fires when UI work is detected but no spec exists)
  *
- * Invocable as: gsd_run check ui-plan-gate <phase>
+ * Invocable as: pp_run check ui-plan-gate <phase>
  *
  * Uses checkUiPresence from ui-safety-gate.cjs — does NOT reimplement frontend detection.
  * Uses getRoadmapPhaseWithFallback + findPhaseInternal from leaf modules for phase data.
@@ -459,8 +459,8 @@ function cmdUiPlanGate(projectDir, args, raw) {
  *   block = frontend && hasUiFiles && !hasUiSpec
  *
  * Args: check ui-safety-gate <phase>
- * Invocable as: gsd_run check ui-safety-gate <phase>
- *             or gsd_run check ui.safety-gate <phase> (dots normalized to hyphens)
+ * Invocable as: pp_run check ui-safety-gate <phase>
+ *             or pp_run check ui.safety-gate <phase> (dots normalized to hyphens)
  *
  * Uses checkUiPresence from ui-safety-gate.cjs — does NOT reimplement frontend detection.
  * Checks whether any files changed in recent git history match frontend file patterns.
@@ -705,7 +705,7 @@ function cmdTddReviewCheckpoint(projectDir, args, raw) {
  * This gate is always advisory (passed: true) — it never blocks phase advancement.
  *
  * Args: check gap-analysis.plan-post <phase-dir> [phase-req-ids]
- * Invocable as: gsd_run check gap-analysis.plan-post <phase-dir> [phase-req-ids]
+ * Invocable as: pp_run check gap-analysis.plan-post <phase-dir> [phase-req-ids]
  */
 function cmdGapAnalysisPlanPost(projectDir, args, raw) {
     // args[0] = 'check', args[1] = 'gap-analysis-plan-post' (normalized), args[2] = phaseDir, args[3] = phaseReqIds
@@ -904,9 +904,9 @@ function cmdShipPlatformDrift(cwd, args, raw) {
 function routeCheckCommand({ args, cwd, raw }) {
     // Normalize dots to hyphens in the subcommand so both forms are accepted.
     // This makes `check.query = "ui.plan-gate"` (dotted form in capability.json gates)
-    // directly runnable as `gsd_run check ui.plan-gate` — the dot is normalized to
+    // directly runnable as `pp_run check ui.plan-gate` — the dot is normalized to
     // `ui-plan-gate` before routing. The generic gate-dispatch in §5.6 reads
-    // `check.query` from the active gate hook and runs `gsd_run check ${hook.check.query}`,
+    // `check.query` from the active gate hook and runs `pp_run check ${hook.check.query}`,
     // so the declared query must be dispatchable exactly as declared.
     const rawSubcommand = args[1];
     const subcommand = typeof rawSubcommand === 'string' ? rawSubcommand.replace(/\./g, '-') : rawSubcommand;
@@ -964,7 +964,7 @@ function routeCheckCommand({ args, cwd, raw }) {
         // The deterministic test-tier prohibition PRODUCER/gate (#1259, ADR-550 D5d). Locates the
         // wired mechanical check (node-test or lint-rule), confirms fail-first, runs it, builds
         // enforcementEvidence, and emits the dispositionForProhibition verdict. Invocable as
-        // `gsd_run check prohibition-enforcement <request.json>`.
+        // `pp_run check prohibition-enforcement <request.json>`.
         (0, prohibition_enforcement_cjs_1.routeProhibitionEnforcement)(args, raw);
         return;
     }

package/pp-core/bin/lib/cjs-command-router-adapter.cjs

@@ -2,7 +2,7 @@
 /**
  * CJS Command Router Adapter Module
  *
- * Compatibility routing for gsd-tools.cjs command families. Uses generated
+ * Compatibility routing for pp-tools.cjs command families. Uses generated
  * command metadata for availability and small family-local argument shapers for
  * CJS handler calls.
  *

package/pp-core/bin/lib/code-review-flags.cjs

@@ -16,7 +16,7 @@ exports.resolveCodeReviewWorkflow = resolveCodeReviewWorkflow;
 /**
  * Parse code-review flags from an argv array. The first positional argument
  * (phase number) is ignored — phase validation is handled by
- * `gsd-tools query init.phase-op`. Unknown flags are silently ignored.
+ * `pp-tools query init.phase-op`. Unknown flags are silently ignored.
  */
 function parseCodeReviewFlags(argv) {
     const flags = {

package/pp-core/bin/lib/config-loader.cjs

@@ -502,7 +502,7 @@ function loadConfig(cwd, options = {}) {
             const warnKey = unknownKeys.join(',');
             if (!_warnedUnknownConfigKeys.has(warnKey)) {
                 _warnedUnknownConfigKeys.add(warnKey);
-                process.stderr.write(`gsd-tools: warning: unknown config key(s) in .planning/config.json: ${unknownKeys.join(', ')} — these will be ignored\n`);
+                process.stderr.write(`pp-tools: warning: unknown config key(s) in .planning/config.json: ${unknownKeys.join(', ')} — these will be ignored\n`);
             }
         }
         // #2517 — Validate runtime/tier values

package/pp-core/bin/lib/config.cjs

@@ -749,7 +749,7 @@ function cmdConfigPath(cwd, _raw, workstreamContext = null) {
  *
  * Wraps the Configuration Module's migrateOnDisk() for the CLI surface. This
  * is the Phase 2 acceptance-criteria deliverable for opt-in migration (#3536):
- * users can run `gsd-tools migrate-config` to apply all four legacy-key
+ * users can run `pp-tools migrate-config` to apply all four legacy-key
  * migrations to their .planning/config.json without having to load any config
  * implicitly via another command.
  *

package/pp-core/bin/lib/context-utilization.cjs

@@ -8,7 +8,7 @@
  * Pure function. Callers pass tokensUsed + contextWindow; the
  * classifier returns the percent and one of three states. Recommendation
  * strings are NOT in this module — formatting is the renderer's job
- * (see `validate context` in gsd-tools.cjs). That separation lets the
+ * (see `validate context` in pp-tools.cjs). That separation lets the
  * copy change without touching this module's tests.
  *
  * Thresholds:

package/pp-core/bin/lib/docs.cjs

@@ -241,7 +241,7 @@ function detectMonorepoWorkspaces(cwd) {
  * resolution. Follows the cmdInitMapCodebase pattern.
  *
  * @example
- * node gsd-tools.cjs docs-init --raw
+ * node pp-tools.cjs docs-init --raw
  */
 function cmdDocsInit(cwd, raw) {
     const config = loadConfig(cwd);

package/pp-core/bin/lib/frontmatter.cjs

@@ -367,7 +367,7 @@ function parseMustHavesBlock(content, blockName) {
     if (items.length === 0 && blockLines.length > 0) {
         const nonEmptyLines = blockLines.filter(l => l.trim() !== '').length;
         if (nonEmptyLines > 0) {
-            process.stderr.write(`[gsd-tools] WARNING: must_haves.${blockName} block has ${nonEmptyLines} content lines but parsed 0 items. ` +
+            process.stderr.write(`[pp-tools] WARNING: must_haves.${blockName} block has ${nonEmptyLines} content lines but parsed 0 items. ` +
                 `Possible YAML formatting issue — verification will fall back to LLM-derived truths.\n`);
         }
     }

package/pp-core/bin/lib/git-base-branch.cjs

@@ -208,9 +208,9 @@ function gitWorktreeInfoInternal(cwd) {
 }
 // ─── CLI entry point ──────────────────────────────────────────────────────────
 /**
- * CLI command: `gsd-tools git base-branch`
+ * CLI command: `pp-tools git base-branch`
  * Resolves the default branch and writes it to stdout (raw string, newline-terminated).
- * Called by workflows via `gsd_run query git.base-branch`.
+ * Called by workflows via `pp_run query git.base-branch`.
  */
 function cmdGitBaseBranch(cwd, _args, deps) {
     const branch = resolveBaseBranch(cwd, deps);

package/pp-core/bin/lib/graphify-command-router.cjs

@@ -1,9 +1,9 @@
 'use strict';
 /**
- * Graphify command router — CLI subcommand dispatcher for `gsd-tools graphify`.
+ * Graphify command router — CLI subcommand dispatcher for `pp-tools graphify`.
  *
  * ADR-959 (phase 4d-impl-2) pilot: first real capability command cutover.
- * Extracted from the hardcoded `case 'graphify':` arm in gsd-tools.cjs.
+ * Extracted from the hardcoded `case 'graphify':` arm in pp-tools.cjs.
  * Behaviour is preserved byte-for-behaviour from the prior inline case;
  * the dispatch path now flows: default → dispatchCapabilityCommand →
  * require(graphify-command-router.cjs) → routeGraphifyCommand.
@@ -34,7 +34,7 @@ function routeGraphifyCommand({ args, cwd, raw, error, _graphify }) {
     if (subcommand === 'query') {
         const term = args[2];
         if (!term) {
-            error('Usage: gsd-tools graphify query <term>', ERROR_REASON.USAGE);
+            error('Usage: pp-tools graphify query <term>', ERROR_REASON.USAGE);
             return;
         }
         const budgetIdx = args.indexOf('--budget');
@@ -42,7 +42,7 @@ function routeGraphifyCommand({ args, cwd, raw, error, _graphify }) {
         if (budgetIdx !== -1) {
             const rawBudget = args[budgetIdx + 1];
             if (rawBudget === undefined || Number.isNaN(parseInt(rawBudget, 10))) {
-                error('Usage: gsd-tools graphify query <term> [--budget <N>]', ERROR_REASON.USAGE);
+                error('Usage: pp-tools graphify query <term> [--budget <N>]', ERROR_REASON.USAGE);
                 return;
             }
             budget = parseInt(rawBudget, 10);

package/pp-core/bin/lib/graphify.cjs

@@ -20,7 +20,7 @@ const { isCapabilityActive } = capabilityStateMod;
  * Return the standard disabled response object.
  */
 function disabledResponse() {
-    return { disabled: true, message: 'graphify is not enabled. Enable with: gsd-tools config-set graphify.enabled true' };
+    return { disabled: true, message: 'graphify is not enabled. Enable with: pp-tools config-set graphify.enabled true' };
 }
 // ─── Subprocess Helper ───────────────────────────────────────────────────────
 /**

package/pp-core/bin/lib/gsd2-import.cjs

@@ -392,7 +392,7 @@ function writePlanningDir(artifacts, planningRoot) {
 }
 // ─── Command Handler ──────────────────────────────────────────────────────────
 /**
- * Entry point called from gsd-tools.cjs.
+ * Entry point called from pp-tools.cjs.
  * Supports: --force, --dry-run, --path <dir>
  */
 function cmdFromGsd2(args, cwd, raw) {

package/pp-core/bin/lib/init-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed init subcommand router.
- * Keeps gsd-tools.cjs thin while preserving existing command semantics.
+ * Keeps pp-tools.cjs thin while preserving existing command semantics.
  *
  * Phase 6: all init.* subcommands have SDK equivalents and are dispatched
  * via executeForCjs (the sync bridge). CJS fallback retained when:

package/pp-core/bin/lib/init.cjs

@@ -1218,7 +1218,7 @@ function cmdInitManager(cwd, raw) {
         const safe = tokens.every((t) => /^--[a-zA-Z0-9][-a-zA-Z0-9]*$/.test(t) ||
             /^[a-zA-Z0-9][-a-zA-Z0-9_.]*$/.test(t));
         if (!safe) {
-            process.stderr.write(`gsd-tools: warning: manager.flags contains invalid tokens, ignoring: ${val}\n`);
+            process.stderr.write(`pp-tools: warning: manager.flags contains invalid tokens, ignoring: ${val}\n`);
             return '';
         }
         return val;

package/pp-core/bin/lib/intel-command-router.cjs

@@ -1,10 +1,10 @@
 'use strict';
 /**
- * Intel command router — CLI subcommand dispatcher for `gsd-tools intel`.
+ * Intel command router — CLI subcommand dispatcher for `pp-tools intel`.
  *
  * ADR-959 (phase 4d-impl-4): intel command family cutover — last first-party
  * command cutover in the initial capability rollout.
- * Extracted from the hardcoded `case 'intel':` arm in gsd-tools.cjs.
+ * Extracted from the hardcoded `case 'intel':` arm in pp-tools.cjs.
  * Behaviour is preserved byte-for-behaviour from the prior inline case;
  * the dispatch path now flows: default → dispatchCapabilityCommand →
  * require(intel-command-router.cjs) → routeIntelCommand.
@@ -56,7 +56,7 @@ function routeIntelCommand({ args, cwd, raw, error, _intel, _core }) {
     if (subcommand === 'query') {
         const term = args[2];
         if (!term) {
-            error('Usage: gsd-tools intel query <term>', ERROR_REASON.USAGE);
+            error('Usage: pp-tools intel query <term>', ERROR_REASON.USAGE);
             return;
         }
         const planningDir = path.join(cwd, '.planning');
@@ -85,7 +85,7 @@ function routeIntelCommand({ args, cwd, raw, error, _intel, _core }) {
     else if (subcommand === 'patch-meta') {
         const filePath = args[2];
         if (!filePath) {
-            error('Usage: gsd-tools intel patch-meta <file-path>', ERROR_REASON.USAGE);
+            error('Usage: pp-tools intel patch-meta <file-path>', ERROR_REASON.USAGE);
             return;
         }
         c.output(intel.intelPatchMeta(path.resolve(cwd, filePath)), raw);
@@ -97,7 +97,7 @@ function routeIntelCommand({ args, cwd, raw, error, _intel, _core }) {
     else if (subcommand === 'extract-exports') {
         const filePath = args[2];
         if (!filePath) {
-            error('Usage: gsd-tools intel extract-exports <file-path>', ERROR_REASON.USAGE);
+            error('Usage: pp-tools intel extract-exports <file-path>', ERROR_REASON.USAGE);
             return;
         }
         c.output(intel.intelExtractExports(path.resolve(cwd, filePath)), raw);

package/pp-core/bin/lib/intel.cjs

@@ -240,7 +240,7 @@ function intelUpdate(planningDir) {
         return disabledResponse();
     return {
         action: 'spawn_agent',
-        message: 'Run gsd-tools intel update or spawn gsd-intel-updater agent for full refresh',
+        message: 'Run pp-tools intel update or spawn gsd-intel-updater agent for full refresh',
     };
 }
 /**

package/pp-core/bin/lib/io.cjs

@@ -161,7 +161,7 @@ const ERROR_REASON = Object.freeze({
     CONFIG_NO_FILE: 'config_no_file',
     CONFIG_PARSE_FAILED: 'config_parse_failed',
     CONFIG_INVALID_KEY: 'config_invalid_key',
-    // SDK / gsd-tools dispatch
+    // SDK / pp-tools dispatch
     SDK_FAIL_FAST: 'sdk_fail_fast',
     SDK_UNKNOWN_COMMAND: 'sdk_unknown_command',
     SDK_MISSING_ARG: 'sdk_missing_arg',
@@ -183,7 +183,7 @@ const ERROR_REASON = Object.freeze({
 });
 /**
  * Process-level flag: when true, error() emits structured JSON to stderr
- * instead of plain "Error: <message>" text. Set by gsd-tools.cjs when the
+ * instead of plain "Error: <message>" text. Set by pp-tools.cjs when the
  * CLI is invoked with `--json-errors`. Tests opt in to typed-IR error
  * assertions by passing that flag and parsing the JSON.
  *

package/pp-core/bin/lib/loop-resolver.cjs

@@ -10,7 +10,7 @@
  * at plan:pre (ui-phase) and autonomous.md at verify:post (ui-review). Further per-feature
  * cutovers are ongoing.
  *
- * Command surface: gsd-tools loop render-hooks <point>
+ * Command surface: pp-tools loop render-hooks <point>
  *
  * Exports (three things):
  *   resolveLoopHooks({ point, registry, config }) → { point, activeHooks }

package/pp-core/bin/lib/phase-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed phase subcommand router.
- * Keeps gsd-tools.cjs thin while preserving existing command semantics.
+ * Keeps pp-tools.cjs thin while preserving existing command semantics.
  *
  * Unsupported in this router:
  * - scaffold: routed through top-level scaffold command.

package/pp-core/bin/lib/phases-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed phases subcommand router.
- * Keeps gsd-tools.cjs thin while preserving current CJS semantics.
+ * Keeps pp-tools.cjs thin while preserving current CJS semantics.
  *
  * Unsupported in this router (treated as unknown):
  * - archive: `phases archive` is excluded from the subcommands list so it

package/pp-core/bin/lib/plan-drift-guard.cjs

@@ -8,7 +8,7 @@
  * Design constraints:
  *   - Pure module: no I/O, no require() calls, no side effects.
  *   - All inputs are validated; unknown values throw a TypeError.
- *   - Consumed by the `gsd-tools drift-guard` CLI seam and by tests.
+ *   - Consumed by the `pp-tools drift-guard` CLI seam and by tests.
  *
  * Authority ladder (rung values determine MISSING severity):
  *   grep=0  intel=1  treesitter=2  lsp=3  scip=4

package/pp-core/bin/lib/prohibition-enforcement.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * prohibition-enforcement — the deterministic PRODUCER for test-tier prohibition verification
- * (#1259, ADR-550 Decision 5d "heavy half"; the D1 seam — a NEW deterministic gsd-tools
+ * (#1259, ADR-550 Decision 5d "heavy half"; the D1 seam — a NEW deterministic pp-tools
  * sub-command, NOT free-form workflow prose).
  *
  * Today `dispositionForProhibition()` (src/probe-core.cts) already carries the POLICY seam: with
@@ -645,7 +645,7 @@ function parseRequest(args) {
     }
 }
 /**
- * CLI surface: `gsd_run check prohibition-enforcement <request.json>` (or `--json '<inline>'`).
+ * CLI surface: `pp_run check prohibition-enforcement <request.json>` (or `--json '<inline>'`).
  * Parses the request, runs the producer, and emits the result as JSON. Honors the no-throw
  * contract: malformed input -> structured `error(...)`, never an uncaught throw.
  */

package/pp-core/bin/lib/roadmap-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed roadmap subcommand router.
- * Keeps gsd-tools.cjs thin while preserving existing command semantics.
+ * Keeps pp-tools.cjs thin while preserving existing command semantics.
  *
  * ADR-457 build-at-publish: the hand-written bin/lib/roadmap-command-router.cjs
  * collapsed to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour
@@ -40,7 +40,7 @@ function checkW021(content) {
     const warnings = [];
     // Sentinel milestone integers exempt from W021
     const SENTINELS = new Set([0, 999]);
-    const MIGRATION_CMD = 'gsd-tools roadmap upgrade --convention milestone-prefixed';
+    const MIGRATION_CMD = 'pp-tools roadmap upgrade --convention milestone-prefixed';
     // Milestone section heading: ## [GSD] v2.0 — Label  OR  ## v2.0: Label  OR  ## Roadmap v2.0
     //   OR  ## ✅ v2.0  OR  ## 🚧 v2.0  (emoji-prefixed variants used by roadmap templates)
     // Capture the major integer.

package/pp-core/bin/lib/roadmap-parser.cjs

@@ -346,7 +346,7 @@ function getMilestonePhaseFilter(cwd, versionOverride, phaseIdConvention) {
         if (!hasVersionedMilestonesGlobal && hasPhaseHeadings && phaseIdConvention === 'milestone-prefixed') {
             console.warn('[gsd] Deprecated: free-form ROADMAP.md detected (no versioned milestone headings). ' +
                 'The project has phase_id_convention set to "milestone-prefixed" in config.json but the ' +
-                'ROADMAP does not use versioned milestone headings. Run `gsd-tools roadmap upgrade --convention milestone-prefixed` to migrate (dry-run by default).');
+                'ROADMAP does not use versioned milestone headings. Run `pp-tools roadmap upgrade --convention milestone-prefixed` to migrate (dry-run by default).');
         }
         if (versionOverride) {
             const escapedVersion = escapeRegex(versionOverride);

package/pp-core/bin/lib/state-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed state subcommand router.
- * Keeps gsd-tools.cjs thin while preserving existing command semantics.
+ * Keeps pp-tools.cjs thin while preserving existing command semantics.
  *
  * Phase 5.1: handlers that have SDK equivalents are dispatched via
  * executeForCjs (the sync bridge). CJS fallback is retained for:

package/pp-core/bin/lib/state.cjs

@@ -50,7 +50,7 @@ function shouldResyncStateProgress(fields) {
 // ─── Cache ────────────────────────────────────────────────────────────────────
 // Cache disk scan results from buildStateFrontmatter per cwd per process (#1967).
 // Avoids re-reading N+1 directories on every state write when the phase structure
-// hasn't changed within the same gsd-tools invocation.
+// hasn't changed within the same pp-tools invocation.
 const _diskScanCache = new Map();
 // Track all lock files held by this process so they can be removed on exit.
 // process.on('exit') fires even on process.exit(1), unlike try/finally which is
@@ -250,7 +250,7 @@ function stateReplaceFieldWithFallback(content, primary, fallback, value) {
     }
     // Neither pattern matched — field may have been reformatted or removed.
     // Log diagnostic so template drift is detected early rather than silently swallowed.
-    process.stderr.write(`[gsd-tools] WARNING: STATE.md field "${primary}"${fallback ? ` (fallback: "${fallback}")` : ''} not found — update skipped. ` +
+    process.stderr.write(`[pp-tools] WARNING: STATE.md field "${primary}"${fallback ? ` (fallback: "${fallback}")` : ''} not found — update skipped. ` +
         `This may indicate STATE.md was externally modified or uses an unexpected format.\n`);
     return content;
 }

package/pp-core/bin/lib/validate-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed validate subcommand router.
- * Keeps gsd-tools.cjs thin while preserving existing command semantics.
+ * Keeps pp-tools.cjs thin while preserving existing command semantics.
  *
  * Phase 6: validate.consistency, validate.health, validate.agents are
  * dispatched via executeForCjs when the SDK is available. CJS fallback

package/pp-core/bin/lib/verify-command-router.cjs

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Manifest-backed verify subcommand router.
- * Keeps gsd-tools.cjs thin while preserving existing command semantics.
+ * Keeps pp-tools.cjs thin while preserving existing command semantics.
  *
  * ADR-457 build-at-publish: the hand-written bin/lib/verify-command-router.cjs
  * collapsed to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour

package/pp-core/bin/lib/verify.cjs

@@ -1432,7 +1432,7 @@ function cmdValidateHealth(cwd, options, raw) {
                     getMilestoneFromPhaseId: getMilestoneFromPhaseId,
                 });
                 for (const mm of mismatches) {
-                    addIssue('warning', 'W021', `Phase ${mm.phaseId}: integer prefix implies ${mm.expectedMilestone} but listed under ${mm.foundInMilestone}`, 'Run `gsd-tools roadmap upgrade --convention milestone-prefixed` to migrate (dry-run by default)');
+                    addIssue('warning', 'W021', `Phase ${mm.phaseId}: integer prefix implies ${mm.expectedMilestone} but listed under ${mm.foundInMilestone}`, 'Run `pp-tools roadmap upgrade --convention milestone-prefixed` to migrate (dry-run by default)');
                 }
             }
         }

package/pp-core/bin/lib/worktree-base-ref.cjs

@@ -94,9 +94,9 @@ function parseJsonc(text) {
 }
 // ─── Message constants (verbatim — downstream docs/tests depend on these) ─────
 function buildMsgDiverged(headSha, forkRef, forkSha) {
-    return `⚠ Worktree base mismatch: HEAD (${shortSha(headSha)}) differs from ${forkRef} (${shortSha(forkSha)}). Running this phase sequentially on the main working tree. To keep parallel worktrees, set worktree.baseRef:"head" in .claude/settings.local.json (or run: gsd-tools worktree set-baseref). See #683.`;
+    return `⚠ Worktree base mismatch: HEAD (${shortSha(headSha)}) differs from ${forkRef} (${shortSha(forkSha)}). Running this phase sequentially on the main working tree. To keep parallel worktrees, set worktree.baseRef:"head" in .claude/settings.local.json (or run: pp-tools worktree set-baseref). See #683.`;
 }
-const MSG_UNKNOWN = `⚠ Cannot determine the worktree fork base (origin/HEAD unresolved). Running this phase sequentially on the main working tree to avoid a base mismatch. To keep parallel worktrees, set worktree.baseRef:"head" in .claude/settings.local.json (or run: gsd-tools worktree set-baseref). See #683.`;
+const MSG_UNKNOWN = `⚠ Cannot determine the worktree fork base (origin/HEAD unresolved). Running this phase sequentially on the main working tree to avoid a base mismatch. To keep parallel worktrees, set worktree.baseRef:"head" in .claude/settings.local.json (or run: pp-tools worktree set-baseref). See #683.`;
 // ─── Exports ──────────────────────────────────────────────────────────────────
 /**
  * Returns the first 8 characters of a SHA, or '' if null/empty.

package/pp-core/bin/lib/worktree-safety.cjs

@@ -958,7 +958,7 @@ function pruneOrphanedWorktrees(repoRoot) {
         const plan = planWorktreePrune(repoRoot, { allowDestructive: false }, { parseWorktreePorcelain });
         const pruneResult = executeWorktreePrunePlan(plan);
         if (pruneResult && pruneResult.timedOut) {
-            process.stderr.write('[gsd-tools] WARNING: worktree health check degraded' +
+            process.stderr.write('[pp-tools] WARNING: worktree health check degraded' +
                 ' — git worktree prune timed out after 10s.' +
                 ' Orphaned worktree metadata may remain until the next successful run.\n');
         }

package/pp-core/bin/pp-tools.cjs

@@ -6,7 +6,7 @@
  * Replaces repetitive inline bash patterns across ~50 GSD command/workflow/agent files.
  * Centralizes: config parsing, model resolution, phase lookup, git commits, summary verification.
  *
- * Usage: node gsd-tools.cjs <command> [args] [--raw] [--pick <field>]
+ * Usage: node pp-tools.cjs <command> [args] [--raw] [--pick <field>]
  *
  * Atomic Commands:
  *   state load                         Load project config + state
@@ -253,7 +253,7 @@ const profileOutput = require('./lib/profile-output.cjs');
  * @param {object} opts
  * @param {string} opts.registryCommand - legacy bridge placeholder
  * @param {string[]} opts.registryArgs - legacy bridge placeholder
- * @param {string} opts.legacyCommand - original gsd-tools command name
+ * @param {string} opts.legacyCommand - original pp-tools command name
  * @param {string[]} opts.legacyArgs - original args
  * @param {string} opts.cwd - project dir
  * @param {boolean} opts.raw - raw output mode
@@ -293,7 +293,7 @@ function _dispatchNonFamily({ registryCommand, registryArgs, legacyCommand, lega
  *   before requiring — defense-in-depth against corrupted/hand-edited registry entries.
  *
  * @param {object}   opts
- * @param {string}   opts.command        The command name (top-level gsd-tools command)
+ * @param {string}   opts.command        The command name (top-level pp-tools command)
  * @param {string[]} opts.args           Remaining args passed to the router
  * @param {string}   opts.cwd            Project working directory
  * @param {boolean}  opts.raw            Raw output mode flag
@@ -487,7 +487,7 @@ async function main() {
   let command = args[0];
 
   // Accept `query` as a meta-prefix for canonical dotted/spaced commands.
-  // Workflows may call `node gsd-tools.cjs query <command>` directly.
+  // Workflows may call `node pp-tools.cjs query <command>` directly.
   if (command === 'query') {
     args.shift();
     command = args[0];
@@ -512,13 +512,13 @@ async function main() {
     }
   }
 
-  // Top-level usage string — emitted by `gsd-tools` (no args) and by
-  // `gsd-tools --help` / any `--help` request below.
+  // Top-level usage string — emitted by `pp-tools` (no args) and by
+  // `pp-tools --help` / any `--help` request below.
   // CR feedback: the command list must enumerate every top-level command
   // supported by the dispatcher so `--help` is actually useful for
   // discovery; previously it was a partial subset that didn't include
   // phase / roadmap / milestone / progress / etc.
-  const TOP_LEVEL_USAGE = 'Usage: gsd-tools <command> [args] [--raw] [--pick <field>] [--cwd <path>] [--ws <name>] [--json-errors]\n' +
+  const TOP_LEVEL_USAGE = 'Usage: pp-tools <command> [args] [--raw] [--pick <field>] [--cwd <path>] [--ws <name>] [--json-errors]\n' +
     'Commands: agent, agent-skills, audit-open, audit-uat, check, check-commit, commit, commit-to-subrepo, ' +
     'config-ensure-section, config-get, config-new-project, config-path, config-set, migrate-config, ' +
     'current-timestamp, detect-custom-files, docs-init, drift-guard, effort, extract-messages, find-phase, ' +
@@ -534,7 +534,7 @@ async function main() {
     '  --ws <name>        Override active workstream (or set GSD_WORKSTREAM)\n' +
     '  --json-errors      Emit structured JSON error objects on stderr (or set GSD_JSON_ERRORS=1)\n\n' +
     'For command-specific argument requirements, invoke the command without args ' +
-    '(e.g. `gsd-tools phase add`) — the resulting error lists what is required.';
+    '(e.g. `pp-tools phase add`) — the resulting error lists what is required.';
 
   if (!command) {
     error(TOP_LEVEL_USAGE);
@@ -558,7 +558,7 @@ async function main() {
   const NEVER_VALID_FLAGS = new Set(['--version', '-v']);
   for (const arg of args) {
     if (NEVER_VALID_FLAGS.has(arg)) {
-      error(`Unknown flag: ${arg}\ngsd-tools does not accept version flags. Run "gsd-tools" with no arguments for usage.`, ERROR_REASON.USAGE);
+      error(`Unknown flag: ${arg}\npp-tools does not accept version flags. Run "pp-tools" with no arguments for usage.`, ERROR_REASON.USAGE);
     }
   }
 
@@ -1537,18 +1537,18 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       } else if (subcommand === 'query') {
         const tagIdx = args.indexOf('--tag');
         const tag = tagIdx !== -1 ? args[tagIdx + 1] : null;
-        if (!tag) error('Usage: gsd-tools learnings query --tag <tag>', ERROR_REASON.USAGE);
+        if (!tag) error('Usage: pp-tools learnings query --tag <tag>', ERROR_REASON.USAGE);
         learnings.cmdLearningsQuery(tag, raw);
       } else if (subcommand === 'copy') {
         learnings.cmdLearningsCopy(cwd, raw);
       } else if (subcommand === 'prune') {
         const olderIdx = args.indexOf('--older-than');
         const olderThan = olderIdx !== -1 ? args[olderIdx + 1] : null;
-        if (!olderThan) error('Usage: gsd-tools learnings prune --older-than <duration>', ERROR_REASON.USAGE);
+        if (!olderThan) error('Usage: pp-tools learnings prune --older-than <duration>', ERROR_REASON.USAGE);
         learnings.cmdLearningsPrune(olderThan, raw);
       } else if (subcommand === 'delete') {
         const id = args[2];
-        if (!id) error('Usage: gsd-tools learnings delete <id>', ERROR_REASON.USAGE);
+        if (!id) error('Usage: pp-tools learnings delete <id>', ERROR_REASON.USAGE);
         learnings.cmdLearningsDelete(id, raw);
       } else {
         error('Unknown learnings subcommand. Available: list, query, copy, prune, delete', ERROR_REASON.SDK_UNKNOWN_COMMAND);
@@ -1587,7 +1587,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       const configDirIdx = args.indexOf('--config-dir');
       const configDir = configDirIdx !== -1 ? args[configDirIdx + 1] : null;
       if (!configDir) {
-        error('Usage: gsd-tools detect-custom-files --config-dir <path>', ERROR_REASON.USAGE);
+        error('Usage: pp-tools detect-custom-files --config-dir <path>', ERROR_REASON.USAGE);
       }
       const resolvedConfigDir = path.resolve(configDir);
       if (!fs.existsSync(resolvedConfigDir)) {
@@ -1896,7 +1896,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       if (subcommand === 'get') {
         const key = args[2];
         if (!key || key.startsWith('--')) {
-          error('Usage: gsd-tools research-store get <key> [--kind <k>]', ERROR_REASON.USAGE);
+          error('Usage: pp-tools research-store get <key> [--kind <k>]', ERROR_REASON.USAGE);
         }
         if (!researchStore.isValidResearchKey(key)) {
           error('research-store: <key> must be a 64-char sha256 hex (use research-plan to obtain keys)', ERROR_REASON.USAGE);
@@ -1907,7 +1907,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       } else if (subcommand === 'put') {
         const key = args[2];
         if (!key || key.startsWith('--')) {
-          error('Usage: gsd-tools research-store put <key> --content <str> --source <s> --provider <p> --confidence <c> --kind <k>', ERROR_REASON.USAGE);
+          error('Usage: pp-tools research-store put <key> --content <str> --source <s> --provider <p> --confidence <c> --kind <k>', ERROR_REASON.USAGE);
         }
         if (!researchStore.isValidResearchKey(key)) {
           error('research-store: <key> must be a 64-char sha256 hex (use research-plan to obtain keys)', ERROR_REASON.USAGE);
@@ -1932,7 +1932,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
         const confidence = getFlagValue(confidenceIdx, '--confidence');
         const kind = getFlagValue(kindIdx, '--kind');
         if (!content || !source || !provider || !confidence || !kind) {
-          error('Usage: gsd-tools research-store put <key> --content <str> --source <s> --provider <p> --confidence <c> --kind <k>', ERROR_REASON.USAGE);
+          error('Usage: pp-tools research-store put <key> --content <str> --source <s> --provider <p> --confidence <c> --kind <k>', ERROR_REASON.USAGE);
         }
         const entry = researchStore.putResearch(cwd, key, { content, source, provider, confidence, kind }, { homeDir });
         output(entry, raw);
@@ -1953,7 +1953,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       const inputIdx = args.indexOf('--input');
       const inputPath = inputIdx !== -1 ? args[inputIdx + 1] : null;
       if (!inputPath || inputPath.startsWith('--')) {
-        error('Usage: gsd-tools research-plan --input <path>', ERROR_REASON.USAGE);
+        error('Usage: pp-tools research-plan --input <path>', ERROR_REASON.USAGE);
       }
       let planInput;
       try {
@@ -1987,7 +1987,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       const providerIdx = args.indexOf('--provider');
       const provider = providerIdx !== -1 ? args[providerIdx + 1] : null;
       if (!provider || provider.startsWith('--')) {
-        error('Usage: gsd-tools query classify-confidence --provider <id> [--package <name> --ecosystem <npm|pypi|crates>] [--verified]', ERROR_REASON.USAGE);
+        error('Usage: pp-tools query classify-confidence --provider <id> [--package <name> --ecosystem <npm|pypi|crates>] [--verified]', ERROR_REASON.USAGE);
       }
       const verified = args.includes('--verified');
       const pkgIdx = args.indexOf('--package');
@@ -1998,7 +1998,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       if (pkg && (!pkg.startsWith('--'))) {
         const VALID_ECOSYSTEMS = new Set(['npm', 'pypi', 'crates']);
         if (!ecosystem || ecosystem.startsWith('--') || !VALID_ECOSYSTEMS.has(ecosystem)) {
-          error('Usage: gsd-tools query classify-confidence --provider <id> [--package <name> --ecosystem <npm|pypi|crates>] [--verified]', ERROR_REASON.USAGE);
+          error('Usage: pp-tools query classify-confidence --provider <id> [--package <name> --ecosystem <npm|pypi|crates>] [--verified]', ERROR_REASON.USAGE);
         }
         const pkgLegitimacy = require('./lib/package-legitimacy.cjs');
         const results = await pkgLegitimacy.checkPackages({ ecosystem, packages: [pkg] }, {});
@@ -2026,7 +2026,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       const ecosystem = ecoIdx !== -1 ? args[ecoIdx + 1] : null;
       const VALID_ECOSYSTEMS = new Set(['npm', 'pypi', 'crates']);
       if (!ecosystem || !VALID_ECOSYSTEMS.has(ecosystem)) {
-        error('Usage: gsd-tools package-legitimacy check --ecosystem <npm|pypi|crates> <pkg1> ...', ERROR_REASON.USAGE);
+        error('Usage: pp-tools package-legitimacy check --ecosystem <npm|pypi|crates> <pkg1> ...', ERROR_REASON.USAGE);
       }
       // Collect positional package names.
       // Only --ecosystem takes a value. Every non-flag arg is a package name.
@@ -2041,7 +2041,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
         packages.push(a);
       }
       if (packages.length === 0) {
-        error('Usage: gsd-tools package-legitimacy check --ecosystem <eco> <pkg1> <pkg2> ...', ERROR_REASON.USAGE);
+        error('Usage: pp-tools package-legitimacy check --ecosystem <eco> <pkg1> <pkg2> ...', ERROR_REASON.USAGE);
       }
       let pkgResults;
       try {

package/assets/gsd-logo-2000-transparent.svg

@@ -1,17 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2000 2000" width="2000" height="2000">
-  <defs>
-    <style>
-      .logo { font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', 'Courier New', monospace; fill: #7dcfff; }
-    </style>
-  </defs>
-
-  <!-- GSD ASCII Logo - centered -->
-  <g transform="translate(1000, 1000)">
-    <text class="logo" font-size="108" text-anchor="middle" y="-225" xml:space="preserve">  ██████╗ ███████╗██████╗ </text>
-    <text class="logo" font-size="108" text-anchor="middle" y="-105" xml:space="preserve"> ██╔════╝ ██╔════╝██╔══██╗</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="15" xml:space="preserve"> ██║  ███╗███████╗██║  ██║</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="135" xml:space="preserve"> ██║   ██║╚════██║██║  ██║</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="255" xml:space="preserve"> ╚██████╔╝███████║██████╔╝</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="375" xml:space="preserve">  ╚═════╝ ╚══════╝╚═════╝ </text>
-  </g>
-</svg>

package/assets/gsd-logo-2000.svg

@@ -1,21 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2000 2000" width="2000" height="2000">
-  <defs>
-    <style>
-      .bg { fill: #1a1b26; }
-      .logo { font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', 'Courier New', monospace; fill: #7dcfff; }
-    </style>
-  </defs>
-
-  <!-- Background -->
-  <rect class="bg" width="2000" height="2000"/>
-
-  <!-- GSD ASCII Logo - centered -->
-  <g transform="translate(1000, 1000)">
-    <text class="logo" font-size="108" text-anchor="middle" y="-225" xml:space="preserve">  ██████╗ ███████╗██████╗ </text>
-    <text class="logo" font-size="108" text-anchor="middle" y="-105" xml:space="preserve"> ██╔════╝ ██╔════╝██╔══██╗</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="15" xml:space="preserve"> ██║  ███╗███████╗██║  ██║</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="135" xml:space="preserve"> ██║   ██║╚════██║██║  ██║</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="255" xml:space="preserve"> ╚██████╔╝███████║██████╔╝</text>
-    <text class="logo" font-size="108" text-anchor="middle" y="375" xml:space="preserve">  ╚═════╝ ╚══════╝╚═════╝ </text>
-  </g>
-</svg>