@opengsd/gsd-pi 1.0.1-dev.bf2899e → 1.0.2-dev.0ee79e5

package/src/resources/extensions/gsd/db-transaction.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Transaction depth helper for the GSD database facade.
 
 export interface DbTransactionControls {

package/src/resources/extensions/gsd/db-verification-evidence-rows.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verification evidence row contract for GSD workflow database consumers.
 
 export interface VerificationEvidenceRow {

package/src/resources/extensions/gsd/db-verification-evidence-schema.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verification evidence SQLite schema helpers for the GSD database facade.
 
 import type { DbAdapter } from "./db-adapter.js";

package/src/resources/extensions/gsd/doctor-git-checks.ts

@@ -1,4 +1,4 @@
-// GSD-2 doctor git health checks
+// gsd-pi doctor git health checks
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
 import { join } from "node:path";

package/src/resources/extensions/gsd/doctor-types.ts

@@ -1,4 +1,4 @@
-// GSD-2 doctor report types
+// gsd-pi doctor report types
 export type DoctorSeverity = "info" | "warning" | "error";
 export type DoctorIssueCode =
   | "invalid_preferences"

package/src/resources/extensions/gsd/ecosystem/gsd-extension-api.ts

@@ -1,4 +1,4 @@
-// GSD2 — Ecosystem Extension API wrapper
+// gsd-pi — Ecosystem Extension API wrapper
 // Wraps pi's ExtensionAPI to expose typed GSD context (phase + active unit)
 // to extensions loaded from `./.gsd/extensions/`. The wrapper intercepts only
 // `on("before_agent_start", ...)` so GSD can dispatch ecosystem handlers AFTER

package/src/resources/extensions/gsd/ecosystem/loader.ts

@@ -1,4 +1,4 @@
-// GSD2 — Ecosystem extension loader for ./.gsd/extensions/
+// gsd-pi — Ecosystem extension loader for ./.gsd/extensions/
 // Discovers and registers single-file extensions that consume GSDExtensionAPI.
 // Trust-gated (mirrors pi's `.pi/extensions/` model) and isolated from pi's
 // own loader chain — handlers run in GSD's own dispatch step, not pi's.

package/src/resources/extensions/gsd/escalation.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Mid-execution escalation artifact and state helpers for GSD tasks.
 // GSD Extension — ADR-011 Phase 2 Mid-Execution Escalation
 //

package/src/resources/extensions/gsd/fresh-run-ui.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Clears stale GSD run surfaces before starting new workflow work.
 
 import type { ExtensionCommandContext } from "@gsd/pi-coding-agent";

package/src/resources/extensions/gsd/git-conflict-state.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Detect unresolved Git conflict state before automation runs.
 
 import { execFileSync } from "node:child_process";

package/src/resources/extensions/gsd/git-service.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Git operations, commit-message formatting, and turn git actions.
 /**
  * GSD Git Service

package/src/resources/extensions/gsd/gsd-command-home.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: State-aware home menu for the bare /gsd command.
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@gsd/pi-coding-agent";

package/src/resources/extensions/gsd/gsd-db.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: GSD database facade, schema, migrations, and single-writer write API.
 // GSD Database Abstraction Layer
 // Provides a SQLite database with provider fallback chain:

package/src/resources/extensions/gsd/guided-unit-context.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Guided workflow Unit context.
+// gsd-pi — Guided workflow Unit context.
 // Tracks the guided Unit whose queued turn should use manifest Tool Contract policy.
 
 export interface GuidedUnitContext {

package/src/resources/extensions/gsd/health-widget.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Always-on ambient health signal rendered below the editor.
 
 import type { ExtensionContext } from "@gsd/pi-coding-agent";

package/src/resources/extensions/gsd/knowledge-backfill.ts

@@ -1,4 +1,4 @@
-// GSD2 — KNOWLEDGE.md -> memories backfill (ADR-013 Stage 2b).
+// gsd-pi — KNOWLEDGE.md -> memories backfill (ADR-013 Stage 2b).
 //
 // Idempotent migration of `.gsd/KNOWLEDGE.md` Patterns and Lessons rows into
 // the `memories` table. Patterns become memories with `category: "pattern"`;

package/src/resources/extensions/gsd/knowledge-capture.ts

@@ -1,4 +1,4 @@
-// GSD2 — KNOWLEDGE.md write-side cutover (ADR-013 Stage 2c).
+// gsd-pi — KNOWLEDGE.md write-side cutover (ADR-013 Stage 2c).
 //
 // Replaces the legacy `appendKnowledge` file-append path for Patterns and
 // Lessons with `createMemory` calls. Rules (K###) continue to flow through

package/src/resources/extensions/gsd/knowledge-parser.ts

@@ -1,4 +1,4 @@
-// GSD-2 — KNOWLEDGE.md parsing helpers shared by the consolidation scanner,
+// gsd-pi — KNOWLEDGE.md parsing helpers shared by the consolidation scanner,
 // the Patterns/Lessons backfill, and the hybrid projection renderer
 // (ADR-013 Stage 2a/2b).
 //

package/src/resources/extensions/gsd/knowledge-projection.ts

@@ -1,4 +1,4 @@
-// GSD2 — KNOWLEDGE.md hybrid projection renderer (ADR-013 Stage 2b).
+// gsd-pi — KNOWLEDGE.md hybrid projection renderer (ADR-013 Stage 2b).
 //
 // Renders `.gsd/KNOWLEDGE.md` as a hybrid file:
 //   - Rules section: read directly from the existing KNOWLEDGE.md (manual,

package/src/resources/extensions/gsd/legacy-telemetry.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Runtime counters for telemetry-gated legacy compatibility paths.
 
 import { mkdirSync, writeFileSync } from "node:fs";

package/src/resources/extensions/gsd/markdown-renderer.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Markdown projection renderer for GSD workflow database rows.
 // GSD Markdown Renderer — DB → Markdown file generation
 //

package/src/resources/extensions/gsd/memory-backfill.ts

@@ -1,4 +1,4 @@
-// GSD2 — Decisions -> memories backfill (ADR-013 step 5)
+// gsd-pi — Decisions -> memories backfill (ADR-013 step 5)
 //
 // Idempotent migration that copies every decisions row (active and
 // superseded — see Stage 2a note below) into the memories table with

package/src/resources/extensions/gsd/memory-consolidation-scanner.ts

@@ -1,4 +1,4 @@
-// GSD-2 — ADR-013 Phase 6 preflight scanner.
+// gsd-pi — ADR-013 Phase 6 preflight scanner.
 //
 // Read-only detection of rows in the legacy knowledge surfaces (decisions
 // table, `.gsd/KNOWLEDGE.md`) that lack a corresponding `memories` row.

package/src/resources/extensions/gsd/metrics.ts

@@ -1,4 +1,4 @@
-// GSD-2 + metrics.ts: token & cost tracking for auto-mode units
+// gsd-pi + metrics.ts: token & cost tracking for auto-mode units
 /**
  * GSD Metrics — Token & Cost Tracking
  *

package/src/resources/extensions/gsd/migrate/audit.ts

@@ -1,4 +1,4 @@
-// GSD-2 - /gsd migrate audit helpers.
+// gsd-pi - /gsd migrate audit helpers.
 // File Purpose: Legacy archive, migration manifest, and projection verification support.
 
 import { cpSync, existsSync, readFileSync } from "node:fs";
@@ -88,7 +88,7 @@ export async function archiveLegacyPlanningDirectory(
     sourcePath,
     archivePath: relToGsd(targetRoot, archivePath),
     strategy: "full-source-copy",
-    note: "Full .planning source copied so legacy content without a GSD-2 field is not lost.",
+    note: "Full .planning source copied so legacy content without a gsd-pi field is not lost.",
   };
 
   await saveFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);

package/src/resources/extensions/gsd/migrate/command.ts

@@ -6,7 +6,7 @@
  * All business logic lives in the pipeline modules (S01–S03).
  *
  * After a successful write, offers a read-only review that audits the output
- * for GSD-2 standards compliance.
+ * for gsd-pi standards compliance.
  */
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@gsd/pi-coding-agent";
@@ -341,7 +341,7 @@ export async function handleMigrate(
       `Legacy source archived at ${execution.legacyArchive.archivePath}`,
       `Migration audit written at ${execution.audit.migrationPath}`,
       "",
-      "The agent can now review the migrated output against GSD-2 standards —",
+      "The agent can now review the migrated output against gsd-pi standards —",
       "checking structure, content quality, deriveState() round-trip, and",
       "requirement statuses. The review is read-only by default.",
     ],

package/src/resources/extensions/gsd/migrate/index.ts

@@ -32,7 +32,7 @@ export type {
   ValidationResult,
   ValidationIssue,
   ValidationSeverity,
-  // Output types (GSD-2 format)
+  // Output types (gsd-pi format)
   GSDProject,
   GSDMilestone,
   GSDSlice,

package/src/resources/extensions/gsd/migrate/safety.ts

@@ -1,4 +1,4 @@
-// GSD-2 - /gsd migrate safety helpers.
+// gsd-pi - /gsd migrate safety helpers.
 // File Purpose: Path resolution, target guards, backup, and restore support for v1 migration.
 
 import { cpSync, existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";

package/src/resources/extensions/gsd/migrate/types.ts

@@ -277,7 +277,7 @@ export interface PlanningPhaseFile {
 
 // ═══════════════════════════════════════════════════════════════════════════
 // GSD Output Types — produced by transformer, consumed by writer (S03)
-// Mirror GSD-2 runtime shapes so deriveState() works on migrated output.
+// Mirror gsd-pi runtime shapes so deriveState() works on migrated output.
 // ═══════════════════════════════════════════════════════════════════════════
 
 export interface GSDProject {

package/src/resources/extensions/gsd/migrate/writer.ts

@@ -1,6 +1,6 @@
 // GSD Directory Writer — Format Functions & Directory Orchestrator
 // Format functions: pure string-returning functions that serialize GSD types into the exact markdown
-// format that GSD-2's parsers expect (parseRoadmap, parsePlan, parseSummary, parseRequirementCounts).
+// format that gsd-pi's parsers expect (parseRoadmap, parsePlan, parseSummary, parseRequirementCounts).
 // writeGSDDirectory: orchestrator that writes a complete .gsd directory tree from a GSDProject.
 
 import { join } from 'node:path';

package/src/resources/extensions/gsd/milestone-scope-classifier.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Milestone scope classifier (#4781 / ADR-003 companion).
+// gsd-pi — Milestone scope classifier (#4781 / ADR-003 companion).
 //
 // Pure heuristics over milestone planning fields. Produces a PipelineVariant
 // that downstream dispatch logic can use to shape the auto-mode sequence.

package/src/resources/extensions/gsd/model-router.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Routes work to appropriate models while preserving configured ceilings.
 
 import type { ComplexityTier, ClassificationResult, TaskMetadata } from "./complexity-classifier.js";

package/src/resources/extensions/gsd/notification-overlay.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Notification history overlay with severity filtering and width-safe TUI rendering.
 
 import type { Theme } from "@gsd/pi-coding-agent";

package/src/resources/extensions/gsd/orphan-stash-audit.ts

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/orphan-stash-audit.ts
+// gsd-pi + src/resources/extensions/gsd/orphan-stash-audit.ts
 // Startup sweep for orphaned gsd-preflight-stash entries left behind by
 // interrupted milestone merges (#5538-followup).
 

package/src/resources/extensions/gsd/parallel-monitor-overlay.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Parallel worker monitor overlay with width-safe operations-console rendering.
 
 import { existsSync, statSync, readFileSync, openSync, readSync, closeSync, readdirSync } from "node:fs";

package/src/resources/extensions/gsd/paths.ts

@@ -1,4 +1,4 @@
-// GSD-2 — ID-based path resolution for GSD project files and directories
+// gsd-pi — ID-based path resolution for GSD project files and directories
 /**
  * GSD Paths — ID-based path resolution
  *

package/src/resources/extensions/gsd/pending-auto-start.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Pending auto-start handoff state.
+// gsd-pi — Pending auto-start handoff state.
 // Stores discuss-to-auto handoff entries keyed by project root.
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@gsd/pi-coding-agent";

package/src/resources/extensions/gsd/planning-depth.ts

@@ -1,4 +1,4 @@
-// gsd-2 / Deep planning mode — Helper to set planning_depth in .gsd/PREFERENCES.md.
+// gsd-pi / Deep planning mode — Helper to set planning_depth in .gsd/PREFERENCES.md.
 //
 // Persists the user's deep-mode opt-in across sessions. Reads the existing
 // preferences file (if any), parses its YAML frontmatter, sets/updates

package/src/resources/extensions/gsd/post-execution-checks.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Post-execution validation checks for completed GSD task output.
 
 /**

package/src/resources/extensions/gsd/pr-evidence.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Shared pull request evidence generator for GSD shipping paths.
 
 export type PrChangeType = "feat" | "fix" | "refactor" | "test" | "docs" | "chore";

package/src/resources/extensions/gsd/pre-execution-checks.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Pre-execution validation checks for GSD task plans.
 
 /**

package/src/resources/extensions/gsd/preferences-skills.ts

@@ -24,24 +24,19 @@ export type { GSDSkillRule, SkillDiscoveryMode, SkillResolution, SkillResolution
 
 /**
  * Known skill directories, in priority order.
- * Searches both the skills.sh ecosystem directory (~/.agents/skills/) and
- * Claude Code's official directory (~/.claude/skills/). Project-level
- * directories for both conventions are included as well.
- * Legacy ~/.gsd/agent/skills/ is included as a fallback for pre-migration installs.
+ * GSD bundled skills live in ~/.gsd/agent/skills/ and win name collisions.
+ * User-global and project-local ecosystem directories remain available as
+ * read-only discovery sources, followed by Claude Code compatibility paths.
  */
 export function getSkillSearchDirs(cwd: string): Array<{ dir: string; method: SkillResolution["method"] }> {
   const dirs: Array<{ dir: string; method: SkillResolution["method"] }> = [
+    { dir: join(gsdHome(), "agent", "skills"), method: "user-skill" },
     { dir: join(homedir(), ".agents", "skills"), method: "user-skill" },
     { dir: join(cwd, ".agents", "skills"), method: "project-skill" },
     // Claude Code official skill directories
     { dir: join(homedir(), ".claude", "skills"), method: "user-skill" },
     { dir: join(cwd, ".claude", "skills"), method: "project-skill" },
   ];
-  // Legacy fallback — read skills from old GSD directory only if migration hasn't completed
-  const legacyDir = join(gsdHome(), "agent", "skills");
-  if (existsSync(legacyDir) && !existsSync(join(legacyDir, ".migrated-to-agents"))) {
-    dirs.push({ dir: legacyDir, method: "user-skill" });
-  }
   return dirs;
 }
 

package/src/resources/extensions/gsd/process-task-path.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Canonical process recommendations for routing work by task size.
 
 export type ProcessTaskSize =

package/src/resources/extensions/gsd/prompts/discuss-headless.md

@@ -112,6 +112,9 @@ In a single pass:
 **Depth-Preservation Guidance for context.md:** Preserve the specification's exact terminology, emphasis, and framing. Do not flatten domain-specific language into generics. CONTEXT.md is downstream agents' only window into this spec.
 
 4. Write `{{contextPath}}` from the **Context** template. Preserve risks, unknowns, codebase constraints, integration points, relevant requirements, and an "Assumptions" section.
+
+**gsd_plan_milestone tool shape (NON-BYPASSABLE):** NEVER call `gsd_plan_milestone` with only `milestoneId` and `sliceId` — that is the `gsd_plan_slice` tool. Required fields: `milestoneId`, `title`, `vision`, `slices[]` (each slice needs `sliceId`, `title`, `risk`, `depends`, `demo`, `goal`). Build `slices[]` from the Roadmap Preview table you printed in chat.
+
 5. Call `gsd_plan_milestone` to create demoable vertical slices with risk, depends, demo, proof strategy, verification classes, definition of done, requirement coverage, and boundary map. If crossing runtime boundaries, include a final end-to-end integration slice. Use the **Roadmap** output template below.
 6. For each architectural or pattern decision, call `gsd_decision_save` — the tool auto-assigns IDs and regenerates `.gsd/DECISIONS.md` automatically.
 7. {{commitInstruction}}
@@ -152,6 +155,9 @@ Next steps:
 #### Phase 2: Primary milestone
 
 5. Write a full `CONTEXT.md` for the primary milestone (the first in sequence). Include an "Assumptions" section.
+
+**gsd_plan_milestone tool shape (NON-BYPASSABLE):** NEVER call `gsd_plan_milestone` with only `milestoneId` and `sliceId` — that is the `gsd_plan_slice` tool. Required fields: `milestoneId`, `title`, `vision`, `slices[]` (each slice needs `sliceId`, `title`, `risk`, `depends`, `demo`, `goal`). Build `slices[]` from the Roadmap Preview table you printed in chat.
+
 6. Call `gsd_plan_milestone` for **only the primary milestone**; detail-planning later milestones now is waste because the codebase will change. Include requirement coverage and definition of done.
 
 #### MANDATORY: depends_on Frontmatter in CONTEXT.md

package/src/resources/extensions/gsd/prompts/discuss.md

@@ -235,6 +235,9 @@ When writing context.md, preserve the user's exact terminology, emphasis, and fr
 When writing CONTEXT.md, include discussion-layer sections: **Scope**, **Architectural Decisions** with rationale/evidence/alternatives, **Error Handling Strategy**, and **Acceptance Criteria** specific enough for planning.
 
 4. Write `{{contextPath}}` — use the **Context** output template below. Preserve key risks, unknowns, existing codebase constraints, integration points, and relevant requirements surfaced during discussion.
+
+**gsd_plan_milestone tool shape (NON-BYPASSABLE):** NEVER call `gsd_plan_milestone` with only `milestoneId` and `sliceId` — that is the `gsd_plan_slice` tool. Required fields: `milestoneId`, `title`, `vision`, `slices[]` (each slice needs `sliceId`, `title`, `risk`, `depends`, `demo`, `goal`). Build `slices[]` from the Roadmap Preview table you printed in chat.
+
 5. Call `gsd_plan_milestone` to create the roadmap. Decompose into demoable vertical slices with risk, depends, demo sentences, proof strategy, verification classes, definition of done, requirement coverage, and a boundary map. If crossing runtime boundaries, include a final integration slice proving end-to-end behavior in a real environment. Use the **Roadmap** template below for tool parameters.
 6. For each architectural or pattern decision made during discussion, call `gsd_decision_save` — the tool auto-assigns IDs and regenerates `.gsd/DECISIONS.md` automatically.
 7. {{commitInstruction}}
@@ -277,6 +280,9 @@ Once the user confirms the milestone split:
 #### Phase 2: Primary milestone
 
 5. Write a full `CONTEXT.md` for the primary milestone (the one discussed in depth).
+
+**gsd_plan_milestone tool shape (NON-BYPASSABLE):** NEVER call `gsd_plan_milestone` with only `milestoneId` and `sliceId` — that is the `gsd_plan_slice` tool. Required fields: `milestoneId`, `title`, `vision`, `slices[]` (each slice needs `sliceId`, `title`, `risk`, `depends`, `demo`, `goal`). Build `slices[]` from the Roadmap Preview table you printed in chat.
+
 6. Call `gsd_plan_milestone` for **only the primary milestone**; detail-planning later milestones now is waste because the codebase will change. Include requirement coverage and definition of done.
 
 #### MANDATORY: depends_on Frontmatter in CONTEXT.md

package/src/resources/extensions/gsd/prompts/plan-milestone.md

@@ -50,6 +50,9 @@ Then:
 2. {{skillActivation}}
 3. Create only as many demoable vertical slices as the work genuinely needs. Use 1-10 slices, sized to the work; tiny/single-file/static work should usually be one slice.
 4. Order by risk, high-risk first.
+
+**gsd_plan_milestone tool shape (NON-BYPASSABLE):** NEVER call `gsd_plan_milestone` with only `milestoneId` and `sliceId` — that is the `gsd_plan_slice` tool. Required fields: `milestoneId`, `title`, `vision`, `slices[]` (each slice needs `sliceId`, `title`, `risk`, `depends`, `demo`, `goal`). Build `slices[]` from the Roadmap output template / decomposition above.
+
 5. Call `gsd_plan_milestone` to persist milestone fields, slice rows, and **Horizontal Checklist** through the DB-backed path. Fill checklist concerns considered during planning: requirements, decisions, shutdown, revenue, auth, shared resources, reconnection. Omit for trivial milestones. Do **not** write `{{outputPath}}`, `ROADMAP.md`, or other planning artifacts manually; the tool owns rendering and persistence.
 6. If planning produced structural decisions (slice ordering, technology choices, scope exclusions), call `gsd_decision_save` for each; the tool assigns IDs and regenerates `.gsd/DECISIONS.md`.
 

package/src/resources/extensions/gsd/prompts/review-migration.md

@@ -1,6 +1,6 @@
 ## Review Migrated .gsd Directory
 
-A `/gsd migrate` command just wrote a `.gsd/` directory from an old `.planning` source. Your job is to audit the output and verify it meets GSD-2 standards before the user starts working with it. This review is read-only: report issues and recommended fixes, but do not edit files in place.
+A `/gsd migrate` command just wrote a `.gsd/` directory from an old `.planning` source. Your job is to audit the output and verify it meets gsd-pi standards before the user starts working with it. This review is read-only: report issues and recommended fixes, but do not edit files in place.
 
 ### Source
 - Old `.planning` directory: `{{sourcePath}}`
@@ -63,4 +63,4 @@ Issues: <list any problems found>
 Recommended fixes: <list any fixes needed>
 ```
 
-If the overall result is FAIL, explain what needs manual attention. If PASS WITH NOTES, explain what's imperfect but acceptable. If PASS, confirm the `.gsd` directory is ready for GSD-2 auto-mode.
+If the overall result is FAIL, explain what needs manual attention. If PASS WITH NOTES, explain what's imperfect but acceptable. If PASS, confirm the `.gsd` directory is ready for gsd-pi auto-mode.

package/src/resources/extensions/gsd/provider-switch-observer.ts

@@ -1,4 +1,4 @@
-// GSD-2 — ADR-005 Phase 3b: surface ProviderSwitchReport from pi-ai.
+// gsd-pi — ADR-005 Phase 3b: surface ProviderSwitchReport from pi-ai.
 //
 // pi-ai builds a ProviderSwitchReport on every cross-provider transform but
 // only logs it to stderr when GSD_VERBOSE=1. This module installs a

package/src/resources/extensions/gsd/recovery-classification.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: ADR-015 Recovery Classification module for runtime failure taxonomy.
 
 import { classifyError, isTransient, type ErrorClass } from "./error-classifier.js";

package/src/resources/extensions/gsd/repository-registry.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Repository registry seam for parent workspace multi-repo resolution.
 
 import { execFileSync } from "node:child_process";

package/src/resources/extensions/gsd/root-write-leak-guard.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Detect project-root file writes during isolated milestone worktree units.
 
 import { execFileSync } from "node:child_process";
@@ -6,6 +6,8 @@ import { createHash } from "node:crypto";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
 
+const MAX_SYNC_FINGERPRINT_BYTES = 1_500_000_000;
+
 export interface RootDirtyEntry {
   path: string;
   status: string;
@@ -31,6 +33,7 @@ function fileFingerprint(rootPath: string, relPath: string): string {
   if (!existsSync(absPath)) return "missing";
   const stat = statSync(absPath);
   if (!stat.isFile()) return `${stat.isDirectory() ? "dir" : "other"}:${stat.size}:${stat.mtimeMs}`;
+  if (stat.size > MAX_SYNC_FINGERPRINT_BYTES) return `large:${stat.size}:${stat.mtimeMs}`;
   return createHash("sha256").update(readFileSync(absPath)).digest("hex");
 }
 

package/src/resources/extensions/gsd/schemas/parsers.ts

@@ -1,4 +1,4 @@
-// gsd-2 / Deep planning mode — Markdown → structured object parsers for artifact validation.
+// gsd-pi / Deep planning mode — Markdown → structured object parsers for artifact validation.
 //
 // Each parser converts a markdown artifact into a typed object suitable for
 // JSON Schema validation. The parsers are intentionally minimal — they only

package/src/resources/extensions/gsd/schemas/validate.ts

@@ -1,4 +1,4 @@
-// gsd-2 / Deep planning mode — Artifact validator entry point.
+// gsd-pi / Deep planning mode — Artifact validator entry point.
 //
 // Validates PROJECT.md, REQUIREMENTS.md, and per-milestone ROADMAP.md
 // against the contract spec in .planning/phases/11-deep-planning-mode/11-CONTRACTS.md.

package/src/resources/extensions/gsd/skill-catalog.ts

@@ -8,8 +8,9 @@
  * Installation is delegated entirely to the skills.sh CLI:
  *   npx skills add <repo> --skill <name> --skill <name> -y
  *
- * Skills are installed into ~/.agents/skills/ (the industry-standard
- * ecosystem directory shared across all agents).
+ * User-selected catalog skills are installed into ~/.agents/skills/ (the
+ * industry-standard ecosystem directory shared across all agents). GSD's own
+ * bundled skills are managed separately in ~/.gsd/agent/skills/.
  */
 
 import { execFile } from "node:child_process";
@@ -19,6 +20,7 @@ import { homedir } from "node:os";
 import type { ExtensionCommandContext } from "@gsd/pi-coding-agent";
 import { showNextAction } from "../shared/tui.js";
 import type { ProjectSignals, XcodePlatform } from "./detection.js";
+import { gsdHome } from "./gsd-home.js";
 
 // ─── Catalog Types ────────────────────────────────────────────────────────────
 
@@ -935,10 +937,11 @@ export async function installPacksBatched(
 
 /**
  * Check if any skills from a pack are already installed.
- * Searches both the skills.sh ecosystem directory and Claude Code's official directory.
+ * Searches GSD bundled, skills.sh ecosystem, and Claude Code's official directory.
  */
 export function isPackInstalled(pack: SkillPack): boolean {
   const skillsDirs = [
+    join(gsdHome(), "agent", "skills"),
     join(homedir(), ".agents", "skills"),
     join(homedir(), ".claude", "skills"),
   ];

package/src/resources/extensions/gsd/skill-discovery.ts

@@ -11,8 +11,10 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
+import { gsdHome } from "./gsd-home.js";
 
-/** Skills directories — skills.sh ecosystem + Claude Code official */
+/** Skills directories — GSD bundled, skills.sh ecosystem, and Claude Code official */
+const GSD_SKILLS_DIR = join(gsdHome(), "agent", "skills");
 const SKILLS_DIR = join(homedir(), ".agents", "skills");
 const CLAUDE_SKILLS_DIR = join(homedir(), ".claude", "skills");
 
@@ -112,6 +114,7 @@ function listSkillDirsFrom(dir: string): string[] {
 
 function listSkillDirs(): string[] {
   const names = new Set<string>();
+  for (const name of listSkillDirsFrom(GSD_SKILLS_DIR)) names.add(name);
   for (const name of listSkillDirsFrom(SKILLS_DIR)) names.add(name);
   for (const name of listSkillDirsFrom(CLAUDE_SKILLS_DIR)) names.add(name);
   return [...names];
@@ -141,7 +144,7 @@ function parseSkillFrontmatter(path: string): { name?: string; description?: str
 }
 
 function resolveSkillMdPath(skillName: string): string | null {
-  for (const dir of [SKILLS_DIR, CLAUDE_SKILLS_DIR]) {
+  for (const dir of [GSD_SKILLS_DIR, SKILLS_DIR, CLAUDE_SKILLS_DIR]) {
     const candidate = join(dir, skillName, "SKILL.md");
     if (existsSync(candidate)) return candidate;
   }

package/src/resources/extensions/gsd/skill-health.ts

@@ -19,6 +19,7 @@ import { homedir } from "node:os";
 import type { UnitMetrics, MetricsLedger } from "./metrics.js";
 import { formatCost, formatTokenCount, loadLedgerFromDisk } from "./metrics.js";
 import { getSkillLastUsed, detectStaleSkills } from "./skill-telemetry.js";
+import { gsdHome } from "./gsd-home.js";
 
 // ─── Types ────────────────────────────────────────────────────────────────────
 
@@ -207,8 +208,9 @@ export function formatSkillDetail(basePath: string, skillName: string): string {
     lines.push(`  ${date}  ${u.id.padEnd(20)}  ${formatTokenCount(u.tokens.total).padStart(8)} tokens  ${formatCost(u.cost)}`);
   }
 
-  // Check for SKILL.md existence — search both ecosystem and Claude Code directories
+  // Check for SKILL.md existence across GSD bundled, ecosystem, and Claude directories.
   const candidatePaths = [
+    join(gsdHome(), "agent", "skills", skillName, "SKILL.md"),
     join(homedir(), ".agents", "skills", skillName, "SKILL.md"),
     join(homedir(), ".claude", "skills", skillName, "SKILL.md"),
   ];

package/src/resources/extensions/gsd/skill-manifest.ts

@@ -1,4 +1,4 @@
-// GSD2 + skill-manifest — per-unit-type skill allowlist resolver (RFC #4779)
+// gsd-pi + skill-manifest — per-unit-type skill allowlist resolver (RFC #4779)
 //
 // Each auto-mode unit type can declare which skills are relevant to it. This
 // trims the set of skills considered for activation in the per-unit prompt,