@opengsd/gsd-pi 1.0.1 → 1.0.2

package/src/resources/extensions/gsd/tests/resolve-ts.mjs

@@ -1,9 +1,5 @@
 import { register } from 'node:module';
 import { pathToFileURL } from 'node:url';
 
-// Source legacy state tests exercise markdown derivation through deriveState().
-// Production/runtime keeps this fallback disabled unless explicitly requested.
-process.env.GSD_ALLOW_MARKDOWN_DERIVE_FALLBACK ??= '1';
-
 // Register hook to redirect imports to the dist directory
 register(new URL('./dist-redirect.mjs', import.meta.url), pathToFileURL('./'));

package/src/resources/extensions/gsd/tests/resource-loader-import-path.test.ts

@@ -1,4 +1,4 @@
-// GSD2 — Regression test for deployed resource-loader resolution behavior
+// gsd-pi — Regression test for deployed resource-loader resolution behavior
 
 import { describe, test } from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/resume-missing-worktree-warning.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + Regression tests for missing-worktree warning on resume (M4 fix)
+// gsd-pi + Regression tests for missing-worktree warning on resume (M4 fix)
 //
 // When paused-session.json records a worktreePath that no longer exists on disk,
 // the resume path must emit a logWarning("session", ...) describing the situation

package/src/resources/extensions/gsd/tests/run-uat-composer.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — #4782 phase 3: run-uat migrated to compose context via manifest.
+// gsd-pi — #4782 phase 3: run-uat migrated to compose context via manifest.
 // Regression test: prompt still carries the declared artifacts in the
 // expected shape after the migration.
 

package/src/resources/extensions/gsd/tests/runtime-invariant-modules.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: ADR-015 runtime invariant module contract tests.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/runtime-kv.test.ts

@@ -1,4 +1,4 @@
-// gsd-2 + runtime_kv non-correctness-critical key-value storage tests (Phase C)
+// gsd-pi + runtime_kv non-correctness-critical key-value storage tests (Phase C)
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/schema-v27-v28-sequence.test.ts

@@ -1,4 +1,4 @@
-// gsd-2 / V27 + V28 schema migration regression tests
+// gsd-pi / V27 + V28 schema migration regression tests
 //
 // Same bug class as #4591 (schema-v21-sequence): a migration block can be
 // added but the SCHEMA_VERSION constant left unchanged, causing fresh-install

package/src/resources/extensions/gsd/tests/select-resumable-milestone.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/tests/select-resumable-milestone.test.ts
+// gsd-pi + src/resources/extensions/gsd/tests/select-resumable-milestone.test.ts
 // Regression: bootstrap must rederive `currentMilestoneId` from an unmerged
 // completed milestone branch when in-memory state was lost across a process
 // restart (#5538-followup).

package/src/resources/extensions/gsd/tests/session-lock-multipath.test.ts

@@ -133,8 +133,8 @@ describe('session-lock-multipath', async () => {
       assert.ok(r2.acquired, 'second base lock acquired');
 
       const registered = _getRegisteredLockDirs();
-      const gsd2 = gsdRoot(base2);
-      assert.ok(registered.includes(gsd2), 'second gsdDir is registered');
+      const gsdRoot2 = gsdRoot(base2);
+      assert.ok(registered.includes(gsdRoot2), 'second gsdDir is registered');
 
       releaseSessionLock(base2);
     } finally {

package/src/resources/extensions/gsd/tests/session-start-footer.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verifies GSD session hook widget and footer lifecycle behavior.
 
 /**

package/src/resources/extensions/gsd/tests/session-switch-abort-misclassification.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/tests/session-switch-abort-misclassification.test.ts
+// gsd-pi + src/resources/extensions/gsd/tests/session-switch-abort-misclassification.test.ts
 // Regression: session-transition aborts must not be classified as user cancellations.
 
 import test from "node:test";
@@ -13,7 +13,13 @@ import {
 } from "../bootstrap/agent-end-recovery.js";
 import { _setAutoActiveForTest } from "../auto.js";
 import { shouldIgnoreAgentEndForActiveUnit } from "../auto/unit-runner-events.js";
-import { _resetPendingResolve, _setCurrentResolve } from "../auto/resolve.js";
+import {
+  _consumePendingSwitchCancellation,
+  _resetPendingResolve,
+  _setCurrentResolve,
+  _setSessionSwitchInFlight,
+  resolveAgentEndCancelled,
+} from "../auto/resolve.js";
 import type { ErrorContext } from "../auto/types.js";
 
 test.afterEach(() => {
@@ -45,9 +51,9 @@ test("user-abort message during session-switch is dropped (not propagated as can
   assert.equal(cancelledWith, null, "proxy user-abort during session-switch must not propagate cancellation");
 });
 
-test("genuine stopReason='aborted' with errorMessage during session-switch still propagates", () => {
-  // Regression guard for prior behavior: genuine aborts with diagnostic content
-  // continue to surface as cancellations so transient-pause recovery can run.
+test("aborted with errorMessage during session-switch is dropped instead of queued", () => {
+  // The abort belongs to the old session being torn down by newSession().
+  // Queueing it as pending cancellation kills the freshly-dispatched unit.
   let cancelledWith: { message: string; category: string; isTransient?: boolean } | null = null;
   const resolveCancelled = (ctx: ErrorContext) => {
     cancelledWith = ctx;
@@ -63,11 +69,22 @@ test("genuine stopReason='aborted' with errorMessage during session-switch still
     resolveCancelled,
   );
 
-  assert.deepEqual(cancelledWith, {
-    message: "stream torn down mid-flight",
-    category: "aborted",
-    isTransient: true,
-  });
+  assert.equal(cancelledWith, null);
+});
+
+test("aborted with errorMessage during session-switch does not cancel the next unit", () => {
+  _setSessionSwitchInFlight(true);
+
+  _handleSessionSwitchAgentEnd(
+    {
+      stopReason: "aborted",
+      errorMessage: "stream torn down mid-flight",
+      content: [{ type: "text", text: "partial output" }],
+    },
+    resolveAgentEndCancelled,
+  );
+
+  assert.equal(_consumePendingSwitchCancellation(), null);
 });
 
 test("Claude Code stream-aborted placeholder during session-switch is dropped", () => {

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

@@ -1,4 +1,4 @@
-// GSD2 + skill-manifest.test — unit coverage for the skill manifest resolver
+// gsd-pi + skill-manifest.test — unit coverage for the skill manifest resolver
 //
 // Focused tests for `resolveSkillManifest` and `filterSkillsByManifest`.
 // Covers the wildcard semantics, the newly seeded unit-type entries

package/src/resources/extensions/gsd/tests/slice-cadence.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Slice-cadence merge and resquash tests.
 /**
  * Tests for slice-cadence collapse — #4765.

package/src/resources/extensions/gsd/tests/smart-entry-complete.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Guided smart entry complete-state behavior tests.
+// gsd-pi — Guided smart entry complete-state behavior tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";
@@ -30,10 +30,14 @@ test("deriveState reports the last completed milestone when all milestone slices
   const base = mkdtempSync(join(tmpdir(), "gsd-smart-entry-complete-"));
   try {
     writeCompleteMilestone(base);
+    openDatabase(join(base, ".gsd", "gsd.db"));
+    insertMilestone({ id: "M001", title: "Complete Milestone", status: "complete" });
+    insertSlice({ id: "S01", milestoneId: "M001", title: "Done slice", status: "complete", risk: "low", depends: [] });
     const state = await deriveState(base);
     assert.equal(state.phase, "complete");
     assert.equal(state.lastCompletedMilestone?.id, "M001");
   } finally {
+    closeDatabase();
     rmSync(base, { recursive: true, force: true });
   }
 });

package/src/resources/extensions/gsd/tests/smart-entry-draft.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Guided smart entry draft-state behavior tests.
+// gsd-pi — Guided smart entry draft-state behavior tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";
@@ -8,6 +8,7 @@ import { tmpdir } from "node:os";
 
 import { deriveState } from "../state.js";
 import { resolveMilestoneFile } from "../paths.js";
+import { closeDatabase, insertMilestone, openDatabase } from "../gsd-db.js";
 
 function writeDraftOnlyMilestone(base: string): void {
   const milestoneDir = join(base, ".gsd", "milestones", "M001");
@@ -22,12 +23,15 @@ test("deriveState returns needs-discussion for draft-only milestone", async () =
   const base = mkdtempSync(join(tmpdir(), "gsd-smart-entry-draft-"));
   try {
     writeDraftOnlyMilestone(base);
+    openDatabase(join(base, ".gsd", "gsd.db"));
+    insertMilestone({ id: "M001", title: "Test Milestone", status: "needs-discussion" });
     const state = await deriveState(base);
     assert.equal(state.phase, "needs-discussion");
     assert.equal(state.activeMilestone?.id, "M001");
     assert.match(resolveMilestoneFile(base, "M001", "CONTEXT-DRAFT") ?? "", /M001-CONTEXT-DRAFT\.md$/);
     assert.equal(resolveMilestoneFile(base, "M001", "CONTEXT"), null);
   } finally {
+    closeDatabase();
     rmSync(base, { recursive: true, force: true });
   }
 });

package/src/resources/extensions/gsd/tests/smart-entry-routing.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Smart entry routing behavior tests.
+// gsd-pi — Smart entry routing behavior tests.
 // Verifies guided wizard choices resolve to the correct execution path.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/sqlite-unavailable-gate.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — SQLite unavailable bootstrap gate regression tests.
+// gsd-pi — SQLite unavailable bootstrap gate regression tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/stale-dirlistcache-4648.test.ts

@@ -1,5 +1,5 @@
 /**
- * GSD-2 / agent-end-recovery — regression tests for #4648.
+ * gsd-pi / agent-end-recovery — regression tests for #4648.
  */
 
 import { describe, test } from "node:test";

package/src/resources/extensions/gsd/tests/state-corruption-2945.test.ts

@@ -31,7 +31,7 @@ import type { AutoSession } from "../auto/session.ts";
 // ─── Fixture helpers ────────────────────────────────────────────────────────
 
 function tempDbPath(): string {
-  const dir = mkdtempSync(join(tmpdir(), "gsd-2945-"));
+  const dir = mkdtempSync(join(tmpdir(), "gsd-pi-2945-"));
   return join(dir, "test.db");
 }
 
@@ -46,7 +46,7 @@ function cleanupDb(dbPath: string): void {
 }
 
 function createTempProject(): { basePath: string } {
-  const basePath = mkdtempSync(join(tmpdir(), "gsd-2945-project-"));
+  const basePath = mkdtempSync(join(tmpdir(), "gsd-pi-2945-project-"));
   mkdirSync(join(basePath, ".gsd", "milestones", "M001"), { recursive: true });
   return { basePath };
 }
@@ -270,7 +270,7 @@ describe("#2945 Bug 3: mergeAndExit must teardown worktree after successful merg
     // this test can no longer assert via a deps mock. Rewritten to use
     // a real git fixture and verify the worktree directory is removed
     // from disk after the merge.
-    const tmpBase = realpathSync(mkdtempSync(join(tmpdir(), "gsd-2945-bug3-")));
+    const tmpBase = realpathSync(mkdtempSync(join(tmpdir(), "gsd-pi-2945-bug3-")));
     // ADR-016 phase 3 (#5693): Lifecycle.restoreToProjectRoot now chdirs to
     // s.originalBasePath. Save cwd before the test so we can restore it
     // before rmSync removes tmpBase — otherwise the next test in this file

package/src/resources/extensions/gsd/tests/state-reconciliation-drift.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: ADR-017 contract tests for drift-driven State Reconciliation.
 // Covers sketch-flag (#5700), merge-state (#5701), stale-render (#5702),
 // stale-worker (#5703), unregistered-milestone (#5704), roadmap-divergence

package/src/resources/extensions/gsd/tests/stop-auto-merge-back.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Stop-auto worktree exit strategy regression tests.
 /**
  * stop-auto-merge-back.test.ts — Regression test for #5576.

package/src/resources/extensions/gsd/tests/stop-auto-race-null-unit.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — stopAuto race current-unit guard regression tests.
+// gsd-pi — stopAuto race current-unit guard regression tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/stuck-state-via-db.test.ts

@@ -1,4 +1,4 @@
-// gsd-2 + Stuck-state DB-migration regression (Phase C)
+// gsd-pi + Stuck-state DB-migration regression (Phase C)
 //
 // stuck-state.json file IO has been deleted. The auto-loop now reconstructs
 // recentUnits from unit_dispatches (Phase B ledger) and persists

package/src/resources/extensions/gsd/tests/subagent-model-dispatch.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Subagent model dispatch behavior tests.
+// gsd-pi — Subagent model dispatch behavior tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/system-context-memory.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: System context memory gating regression tests.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/system-context-message-routing.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression coverage for volatile system-context message routing.
 
 import { describe, test } from "node:test";

package/src/resources/extensions/gsd/tests/teardown-chdir-failure-clears-registry.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + Regression test: teardownAutoWorktree clears activeWorkspace even when process.chdir throws
+// gsd-pi + Regression test: teardownAutoWorktree clears activeWorkspace even when process.chdir throws
 
 /**
  * Regression (H3 broadened scope): `teardownAutoWorktree` must clear `activeWorkspace`

package/src/resources/extensions/gsd/tests/teardown-failure-clears-registry.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + Regression test: teardownAutoWorktree clears activeWorkspace even when removeWorktree fails
+// gsd-pi + Regression test: teardownAutoWorktree clears activeWorkspace even when removeWorktree fails
 
 /**
  * Regression: `teardownAutoWorktree` must clear `activeWorkspace` (and therefore

package/src/resources/extensions/gsd/tests/token-profile.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Token profile behavior tests.
+// gsd-pi — Token profile behavior tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/token-tool-gating.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Tests for opt-in GSD tool surface reduction.
 
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/tool-compatibility.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Tool Compatibility + Model Router Tool Filtering Tests (ADR-005 Phases 2-3)
+// gsd-pi — Tool Compatibility + Model Router Tool Filtering Tests (ADR-005 Phases 2-3)
 import { describe, test, beforeEach } from "node:test";
 import assert from "node:assert/strict";
 

package/src/resources/extensions/gsd/tests/tool-naming.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verifies canonical and alias DB tool registration plus legacy alias telemetry.
 
 import { test } from 'node:test';

package/src/resources/extensions/gsd/tests/triage-dispatch.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Triage and quick-task dispatch behavior tests.
+// gsd-pi — Triage and quick-task dispatch behavior tests.
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/tui-header-lifecycle.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression tests for the TUI header lifecycle fixes —
 // header is suppressed (zero lines) when auto-mode activates, the wizard
 // step status badge is cleared, the NEXT-mode footer hint renders when

package/src/resources/extensions/gsd/tests/tui-render-kit.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Unit tests for shared GSD TUI render helpers.
 
 import { describe, test } from "node:test";

package/src/resources/extensions/gsd/tests/uat-stuck-loop-orphaned-worktree.test.ts

@@ -46,7 +46,7 @@ function git(args: string[], cwd: string): string {
 }
 
 function makeBaseRepo(): string {
-  const base = mkdtempSync(join(tmpdir(), "gsd-2821-"));
+  const base = mkdtempSync(join(tmpdir(), "gsd-pi-2821-"));
   git(["init", "-b", "main"], base);
   git(["config", "user.name", "Test"], base);
   git(["config", "user.email", "test@test.com"], base);
@@ -64,8 +64,8 @@ describe("#2821 Bug 1 — ASSESSMENT file force-synced on resume", () => {
   let wtBase: string;
 
   beforeEach(() => {
-    mainBase = mkdtempSync(join(tmpdir(), "gsd-2821-main-"));
-    wtBase = mkdtempSync(join(tmpdir(), "gsd-2821-wt-"));
+    mainBase = mkdtempSync(join(tmpdir(), "gsd-pi-2821-main-"));
+    wtBase = mkdtempSync(join(tmpdir(), "gsd-pi-2821-wt-"));
     mkdirSync(join(mainBase, ".gsd", "milestones", "M011", "slices", "S01"), {
       recursive: true,
     });

package/src/resources/extensions/gsd/tests/unit-context-composer.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Tests unit context composer rendering, budgets, and reassess-roadmap prompt integration.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/unit-context-manifest.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — #4782 phase 1: schema tests + CI coverage guard for manifests.
+// gsd-pi — #4782 phase 1: schema tests + CI coverage guard for manifests.
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/unit-dispatches.test.ts

@@ -1,4 +1,4 @@
-// gsd-2 + Unit dispatch ledger tests (Phase B coordination — partial unique index, retry metadata)
+// gsd-pi + Unit dispatch ledger tests (Phase B coordination — partial unique index, retry metadata)
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/unmerged-milestone-guard.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression tests for blocking completed-but-unmerged milestone branches.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/unstructured-continue-context-injection.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Regression test for #3615: unstructured "continue" must inject task context
+// gsd-pi — Regression test for #3615: unstructured "continue" must inject task context
 
 import { describe, test } from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/uok-contracts.test.ts

@@ -1,4 +1,4 @@
-// GSD2 UOK Contract Versioning and DB Authority Tests
+// gsd-pi UOK Contract Versioning and DB Authority Tests
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/uok-gitops-turn-action.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: UOK turn git action regression tests.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/uok-kernel-path.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verifies UOK kernel path selection and legacy fallback telemetry.
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/update-command.test.ts

@@ -2,6 +2,7 @@ import test from "node:test";
 import assert from "node:assert/strict";
 
 import { registerGSDCommand } from "../commands.ts";
+import { handleOpsCommand } from "../commands/handlers/ops.ts";
 
 function createMockPi() {
   const commands = new Map<string, any>();
@@ -44,6 +45,19 @@ test("/gsd update appears in subcommand completions", () => {
   assert.equal(updateEntry.label, "update");
 });
 
+test("/gsd upgrade appears in subcommand completions", () => {
+  const pi = createMockPi();
+  registerGSDCommand(pi as any);
+
+  const gsd = pi.commands.get("gsd");
+  assert.ok(gsd, "registerGSDCommand should register /gsd");
+
+  const completions = gsd.getArgumentCompletions("upgrade");
+  const upgradeEntry = completions.find((c: any) => c.value === "upgrade");
+  assert.ok(upgradeEntry, "upgrade should appear in completions");
+  assert.equal(upgradeEntry.label, "upgrade");
+});
+
 test("/gsd update appears in help description", () => {
   const pi = createMockPi();
   registerGSDCommand(pi as any);
@@ -52,6 +66,14 @@ test("/gsd update appears in help description", () => {
   assert.ok(gsd?.description?.includes("update"), "description should mention update");
 });
 
+test("/gsd upgrade appears in help description", () => {
+  const pi = createMockPi();
+  registerGSDCommand(pi as any);
+
+  const gsd = pi.commands.get("gsd");
+  assert.ok(gsd?.description?.includes("upgrade"), "description should mention upgrade");
+});
+
 test("/gsd update is listed in completions with correct description", () => {
   const pi = createMockPi();
   registerGSDCommand(pi as any);
@@ -66,6 +88,46 @@ test("/gsd update is listed in completions with correct description", () => {
   );
 });
 
+test("/gsd upgrade routes through the update handler", async () => {
+  const originalFetch = globalThis.fetch;
+  const originalVersion = process.env.GSD_VERSION;
+  const ctx = createMockCtx();
+
+  try {
+    process.env.GSD_VERSION = "1.2.3";
+    globalThis.fetch = async () => Response.json({ version: "1.2.3" });
+
+    const handled = await handleOpsCommand("upgrade", ctx as any, createMockPi() as any);
+
+    assert.equal(handled, true);
+    assert.ok(
+      ctx.notifications.some((notification) => notification.message.includes("Already up to date")),
+      "upgrade should call the shared update handler",
+    );
+  } finally {
+    globalThis.fetch = originalFetch;
+    if (originalVersion === undefined) {
+      delete process.env.GSD_VERSION;
+    } else {
+      process.env.GSD_VERSION = originalVersion;
+    }
+  }
+});
+
+test("/gsd upgrade is listed in completions with correct description", () => {
+  const pi = createMockPi();
+  registerGSDCommand(pi as any);
+
+  const gsd = pi.commands.get("gsd");
+  const completions = gsd.getArgumentCompletions("");
+  const upgradeEntry = completions.find((c: any) => c.value === "upgrade");
+  assert.ok(upgradeEntry, "upgrade should appear in full completion list");
+  assert.ok(
+    upgradeEntry.description.toLowerCase().includes("opengsd"),
+    "completion description should mention the new package scope",
+  );
+});
+
 test("/gsd codebase appears in top-level completions", () => {
   const pi = createMockPi();
   registerGSDCommand(pi as any);

package/src/resources/extensions/gsd/tests/validate-extension-package.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — Tests for validateExtensionPackage (EXTR-02, PKG-05)
+// gsd-pi — Tests for validateExtensionPackage (EXTR-02, PKG-05)
 import test from "node:test";
 import assert from "node:assert/strict";
 import { mkdirSync, rmSync, writeFileSync } from "node:fs";

package/src/resources/extensions/gsd/tests/validate-milestone-prompt-verification-classes.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Prompt contract tests for milestone validation verification-class evidence.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/validate-milestone-write-order.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression tests for milestone validation persistence and evidence gates.
 
 import { describe, it, afterEach } from "node:test";

package/src/resources/extensions/gsd/tests/validation-block-guard.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression tests for validation-blocked command gating.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/validator-scope-parity.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + Tests verifying writer/validator path parity via MilestoneScope (C3)
+// gsd-pi + Tests verifying writer/validator path parity via MilestoneScope (C3)
 //
 // Critical invariant: a writer that constructs paths via scope.contextFile() /
 // scope.roadmapFile() and a validator that resolves paths via the scope-based