@opengsd/gsd-pi 1.0.1 → 1.0.2

package/src/resources/extensions/gsd/tests/integration/auto-recovery.test.ts

@@ -18,8 +18,6 @@ import {
 } from "../../auto-recovery.ts";
 import { parseRoadmap, parsePlan } from "../../parsers-legacy.ts";
 import { parseTaskPlanFile, clearParseCache } from "../../files.ts";
-import { invalidateAllCaches } from "../../cache.ts";
-import { deriveState, invalidateStateCache } from "../../state.ts";
 import {
   openDatabase,
   closeDatabase,
@@ -698,56 +696,6 @@ test("verifyExpectedArtifact plan-slice fails after deleting a rendered task pla
   }
 });
 
-// ─── #793: invalidateAllCaches unblocks skip-loop ─────────────────────────
-// When the skip-loop breaker fires, it must call invalidateAllCaches() (not
-// just invalidateStateCache()) to clear path/parse caches that deriveState
-// depends on. Without this, even after cache invalidation, deriveState reads
-// stale directory listings and returns the same unit, looping forever.
-test("#793: invalidateAllCaches clears all caches so deriveState sees fresh disk state", async (t) => {
-  const base = makeTmpBase();
-  t.after(() => cleanup(base));
-
-  const mid = "M001";
-  const sid = "S01";
-  const planDir = join(base, ".gsd", "milestones", mid, "slices", sid);
-  const tasksDir = join(planDir, "tasks");
-  mkdirSync(tasksDir, { recursive: true });
-  mkdirSync(join(base, ".gsd", "milestones", mid), { recursive: true });
-
-  writeFileSync(
-    join(base, ".gsd", "milestones", mid, `${mid}-ROADMAP.md`),
-    `# M001: Test Milestone\n\n**Vision:** test.\n\n## Slices\n\n- [ ] **${sid}: Slice One** \`risk:low\` \`depends:[]\`\n  > After this: done.\n`,
-  );
-  const planUnchecked = `# ${sid}: Slice One\n\n**Goal:** test.\n\n## Tasks\n\n- [ ] **T01: Task One** \`est:10m\`\n- [ ] **T02: Task Two** \`est:10m\`\n`;
-  writeFileSync(join(planDir, `${sid}-PLAN.md`), planUnchecked);
-  writeFileSync(join(tasksDir, "T01-PLAN.md"), "# T01: Task One\n\n**Goal:** t\n\n## Steps\n- step\n\n## Verification\n- v\n");
-  writeFileSync(join(tasksDir, "T02-PLAN.md"), "# T02: Task Two\n\n**Goal:** t\n\n## Steps\n- step\n\n## Verification\n- v\n");
-
-  // Warm all caches
-  const state1 = await deriveState(base);
-  assert.equal(state1.activeTask?.id, "T01", "initial: T01 is active");
-
-  // Simulate task completion on disk (what the LLM does)
-  const planChecked = `# ${sid}: Slice One\n\n**Goal:** test.\n\n## Tasks\n\n- [x] **T01: Task One** \`est:10m\`\n- [ ] **T02: Task Two** \`est:10m\`\n`;
-  writeFileSync(join(planDir, `${sid}-PLAN.md`), planChecked);
-  writeFileSync(join(tasksDir, "T01-SUMMARY.md"), "---\nid: T01\n---\n# Summary\n");
-
-  // invalidateStateCache alone: _stateCache cleared but path/parse caches warm
-  invalidateStateCache();
-
-  // invalidateAllCaches: all caches cleared — deriveState must re-read disk
-  invalidateAllCaches();
-  const state2 = await deriveState(base);
-
-  // After full invalidation, T01 should be complete and T02 should be next
-  assert.notEqual(state2.activeTask?.id, "T01", "#793: T01 not re-dispatched after full invalidation");
-
-  // Verify the caches are truly cleared by calling clearParseCache and clearPathCache
-  // do not throw (they should be no-ops after invalidateAllCaches already cleared them)
-  clearParseCache(); // no-op, but should not throw
-  assert.ok(true, "clearParseCache after invalidateAllCaches is safe");
-});
-
 // ─── hasImplementationArtifacts (#1703) ───────────────────────────────────
 
 function makeGitBase(): string {

package/src/resources/extensions/gsd/tests/integration/auto-worktree-milestone-merge.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-worktree milestone squash-merge integration tests.
 /**
  * auto-worktree-milestone-merge.test.ts — Integration tests for mergeMilestoneToMain.

package/src/resources/extensions/gsd/tests/integration/commands-eval-review.integration.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Integration tests for the /gsd eval-review helper chain.
 /**
  * Integration test for `/gsd eval-review` .

package/src/resources/extensions/gsd/tests/integration/git-service.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Git service integration and commit-message tests.
 import { describe, test } from 'node:test';
 import assert from 'node:assert/strict';

package/src/resources/extensions/gsd/tests/integration/headless-command.ts

@@ -318,7 +318,7 @@ function parseJsonlLines(output: string): JsonlEvent[] {
 async function main(): Promise<void> {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
-  // Resolve gsd-2 repo root (6 levels up from tests/integration/)
+  // Resolve gsd-pi repo root (6 levels up from tests/integration/)
   const repoRoot = join(__dirname, "..", "..", "..", "..", "..", "..");
 
   console.log("=== GSD Headless Command Integration Test ===\n");

package/src/resources/extensions/gsd/tests/integration/merge-cwd-restore.test.ts

@@ -1,5 +1,5 @@
 /**
- * GSD-2 — Regression tests for merge cwd restore (#2929)
+ * gsd-pi — Regression tests for merge cwd restore (#2929)
  * merge-cwd-restore.test.ts — Regression tests for #2929.
  *
  * Verifies:

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Integration tests for UAT mode extraction, dispatch, and prompt contracts.
 
 import { describe, test } from 'node:test';

package/src/resources/extensions/gsd/tests/integration/state-machine-edge-cases.test.ts

@@ -345,7 +345,7 @@ describe("state derivation failures", () => {
     assert.equal(state.activeMilestone?.id, "M001");
   });
 
-  test("cache staleness: derive within TTL returns same result after DB mutation", async () => {
+  test("cache invalidation follows DB rows after mutation", async () => {
     base = createFullFixture();
     openDatabase(join(base, ".gsd", "gsd.db"));
     insertMilestone({ id: "M001", title: "Active", status: "active" });
@@ -357,15 +357,8 @@ describe("state derivation failures", () => {
     const state1 = await deriveState(base);
     assert.equal(state1.phase, "executing");
 
-    // Mutate DB WITHOUT invalidating cache
     updateTaskStatus("M001", "S01", "T01", "complete", new Date().toISOString());
 
-    // Second call within 100ms TTL should return cached (stale) result
-    const state2 = await deriveState(base);
-    assert.equal(state2.phase, "executing", "cached result should still show executing");
-
-    // After explicit invalidation, DB rows remain authoritative; PLAN.md is a
-    // projection and must not import missing task rows.
     invalidateStateCache();
     const state3 = await deriveState(base);
     assert.equal(state3.phase, "summarizing", "after cache invalidation should follow DB tasks only");
@@ -1259,21 +1252,6 @@ describe("ghost milestone edge cases", () => {
     assert.equal(isGhostMilestone(base, "M001"), true, "META.json alone → ghost");
   });
 
-  test("ghost milestones are skipped in state derivation", async () => {
-    base = makeTempDir();
-    const gsdDir = join(base, ".gsd", "milestones");
-
-    // M001 is ghost — empty dir
-    mkdirSync(join(gsdDir, "M001"), { recursive: true });
-
-    // M002 is real — has CONTEXT-DRAFT
-    mkdirSync(join(gsdDir, "M002"), { recursive: true });
-    writeFileSync(join(gsdDir, "M002", "M002-CONTEXT-DRAFT.md"), "# Draft\nContent.\n");
-
-    invalidateAllCaches();
-    const state = await deriveState(base);
-    assert.equal(state.activeMilestone?.id, "M002", "ghost M001 skipped, M002 is active");
-  });
 });
 
 // ─────────────────────────────────────────────────────────────────────────

package/src/resources/extensions/gsd/tests/integration/state-machine-live-validation.test.ts

@@ -56,7 +56,6 @@ import {
   deriveState,
   deriveStateFromDb,
   invalidateStateCache,
-  isGhostMilestone,
 } from "../../state.ts";
 
 // ── Status guards ─────────────────────────────────────────────────────────
@@ -316,17 +315,6 @@ describe("state-machine-live-validation", () => {
       assert.equal(state.activeMilestone, null);
     });
 
-    test("step 2: milestone with CONTEXT-DRAFT derives needs-discussion", async () => {
-      base = makeTempDir();
-      const mDir = join(base, ".gsd", "milestones", "M001");
-      mkdirSync(mDir, { recursive: true });
-      writeFileSync(join(mDir, "M001-CONTEXT-DRAFT.md"), "# Draft\nDraft context.\n");
-      invalidateStateCache();
-      const state = await deriveState(base);
-      assert.equal(state.phase, "needs-discussion");
-      assert.equal(state.activeMilestone?.id, "M001");
-    });
-
     test("step 3: full fixture with ROADMAP+PLAN derives planning or executing", async () => {
       base = createFullFixture();
       openDatabase(join(base, ".gsd", "gsd.db"));
@@ -827,22 +815,6 @@ describe("state-machine-live-validation", () => {
       assert.equal(state.phase, "validating-milestone", `expected validating-milestone, got ${state.phase}`);
     });
 
-    test("ghost milestone is skipped by deriveState", async () => {
-      base = makeTempDir();
-      const gsdDir = join(base, ".gsd", "milestones");
-      // M001 is ghost — empty dir
-      mkdirSync(join(gsdDir, "M001"), { recursive: true });
-      // M002 has content
-      mkdirSync(join(gsdDir, "M002"), { recursive: true });
-      writeFileSync(join(gsdDir, "M002", "M002-CONTEXT-DRAFT.md"), "# Draft\nContent.\n");
-
-      assert.ok(isGhostMilestone(base, "M001"), "M001 should be ghost");
-      assert.ok(!isGhostMilestone(base, "M002"), "M002 should not be ghost");
-
-      invalidateStateCache();
-      const state = await deriveState(base);
-      assert.equal(state.activeMilestone?.id, "M002", "should skip ghost M001 and use M002");
-    });
   });
 
   // ─────────────────────────────────────────────────────────────────────────

package/src/resources/extensions/gsd/tests/integration/workspace-collapse-integration.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + Integration regression suite for workspace collapse (feat/workspace-collapse)
+// gsd-pi + Integration regression suite for workspace collapse (feat/workspace-collapse)
 
 import { describe, test, beforeEach, afterEach } from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/lazy-pi-tui-import.test.ts

@@ -1,4 +1,4 @@
-// GSD2 — Shared barrel import behavior without TUI dependency loading
+// gsd-pi — Shared barrel import behavior without TUI dependency loading
 
 import test from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/lease-conflict-notice.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression tests for user-facing milestone lease conflict notices.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/legacy-component-format-telemetry.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verifies telemetry for legacy component formats.
 
 import test from "node:test";

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

@@ -1,9 +1,9 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Tests for telemetry counters guarding legacy compatibility cleanup.
 
 import test from "node:test";
 import assert from "node:assert/strict";
-import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
@@ -15,22 +15,18 @@ import {
   persistLegacyTelemetrySnapshot,
   resetLegacyTelemetry,
 } from "../legacy-telemetry.ts";
-import { closeDatabase } from "../gsd-db.ts";
-import { deriveState, invalidateStateCache } from "../state.ts";
 import { _resetLogs, peekLogs, setStderrLoggingEnabled } from "../workflow-logger.ts";
 
 test("legacy telemetry exposes every Phase 8 cleanup counter", () => {
   resetLegacyTelemetry();
 
   assert.deepEqual(listLegacyTelemetryCounters(), [
-    "legacy.markdownFallbackUsed",
     "legacy.workflowEngineUsed",
     "legacy.uokFallbackUsed",
     "legacy.mcpAliasUsed",
     "legacy.componentFormatUsed",
     "legacy.providerDefaultUsed",
   ]);
-  assert.equal(getLegacyTelemetry()["legacy.markdownFallbackUsed"], 0);
 });
 
 test("legacy telemetry increments positive finite amounts only", () => {
@@ -80,7 +76,6 @@ test("legacy telemetry can persist an opt-in snapshot file", () => {
     const report = JSON.parse(readFileSync(outputPath, "utf-8")) as ReturnType<typeof getLegacyTelemetryReport>;
     assert.equal(typeof report.ts, "string");
     assert.equal(report.counters["legacy.providerDefaultUsed"], 2);
-    assert.equal(report.counters["legacy.markdownFallbackUsed"], 0);
   } finally {
     if (previousOutput === undefined) delete process.env.GSD_LEGACY_TELEMETRY_FILE;
     else process.env.GSD_LEGACY_TELEMETRY_FILE = previousOutput;
@@ -104,7 +99,6 @@ test("legacy telemetry can persist a zero-use snapshot for deletion gates", () =
     const report = JSON.parse(readFileSync(outputPath, "utf-8")) as ReturnType<typeof getLegacyTelemetryReport>;
     assert.equal(typeof report.ts, "string");
     assert.deepEqual(report.counters, {
-      "legacy.markdownFallbackUsed": 0,
       "legacy.workflowEngineUsed": 0,
       "legacy.uokFallbackUsed": 0,
       "legacy.mcpAliasUsed": 0,
@@ -118,27 +112,3 @@ test("legacy telemetry can persist a zero-use snapshot for deletion gates", () =
     rmSync(base, { recursive: true, force: true });
   }
 });
-
-test("deriveState increments markdown fallback telemetry on explicit legacy fallback", async () => {
-  const base = mkdtempSync(join(tmpdir(), "gsd-legacy-telemetry-"));
-  const originalFallback = process.env.GSD_ALLOW_MARKDOWN_DERIVE_FALLBACK;
-  try {
-    closeDatabase();
-    resetLegacyTelemetry();
-    invalidateStateCache();
-    process.env.GSD_ALLOW_MARKDOWN_DERIVE_FALLBACK = "1";
-    mkdirSync(join(base, ".gsd", "milestones", "M001"), { recursive: true });
-    writeFileSync(join(base, ".gsd", "milestones", "M001", "M001-CONTEXT.md"), "# M001: Legacy\n");
-
-    const state = await deriveState(base);
-
-    assert.equal(state.activeMilestone?.id, "M001");
-    assert.equal(getLegacyTelemetry()["legacy.markdownFallbackUsed"], 1);
-  } finally {
-    invalidateStateCache();
-    resetLegacyTelemetry();
-    if (originalFallback === undefined) delete process.env.GSD_ALLOW_MARKDOWN_DERIVE_FALLBACK;
-    else process.env.GSD_ALLOW_MARKDOWN_DERIVE_FALLBACK = originalFallback;
-    rmSync(base, { recursive: true, force: true });
-  }
-});

package/src/resources/extensions/gsd/tests/load-memory-block.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 — loadMemoryBlock tests (ADR-013 step 4 auto-injection parity)
+// gsd-pi — loadMemoryBlock tests (ADR-013 step 4 auto-injection parity)
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 

package/src/resources/extensions/gsd/tests/marketplace-test-fixtures.ts

@@ -33,9 +33,9 @@ function cloneRepo(repo: string, dest: string): void {
 }
 
 export function getMarketplaceFixtures(testFileDir: string): { available: boolean; skipReason?: string; fixtures?: MarketplaceFixtureSet } {
-  const gsd2Root = resolve(testFileDir, '../../../../..');
-  const localClaudeSkillsPath = resolve(gsd2Root, '../claude_skills');
-  const localClaudePluginsOfficialPath = resolve(gsd2Root, '../claude-plugins-official');
+  const gsdPiRoot = resolve(testFileDir, '../../../../..');
+  const localClaudeSkillsPath = resolve(gsdPiRoot, '../claude_skills');
+  const localClaudePluginsOfficialPath = resolve(gsdPiRoot, '../claude-plugins-official');
 
   if (existsSync(localClaudeSkillsPath) && existsSync(localClaudePluginsOfficialPath)) {
     return {

package/src/resources/extensions/gsd/tests/md-importer.test.ts

@@ -247,6 +247,29 @@ test('md-importer: parseRequirementsSections', () => {
   assert.deepStrictEqual(r040?.class, 'anti-feature', 'R040 class');
 });
 
+test('md-importer: parseRequirementsSections accepts categorical requirement IDs', () => {
+  const content = `# Requirements
+
+## Validated
+
+### NET-01 — Bench validated networking
+- Status: validated
+- Description: Network path has been validated.
+
+## Out of Scope
+
+### OBF-10 — Rejected obfuscation path
+- Status: out-of-scope
+- Description: This path was intentionally rejected.
+`;
+
+  const reqs = parseRequirementsSections(content);
+
+  assert.deepStrictEqual(reqs.map((req) => req.id), ['NET-01', 'OBF-10'], 'categorical reqs: IDs parsed');
+  assert.deepStrictEqual(reqs[0]?.status, 'validated', 'categorical reqs: validated status');
+  assert.deepStrictEqual(reqs[1]?.status, 'out-of-scope', 'categorical reqs: out-of-scope status');
+});
+
 // ═══════════════════════════════════════════════════════════════════════════
 // md-importer: migrateFromMarkdown orchestrator
 // ═══════════════════════════════════════════════════════════════════════════

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

@@ -1,4 +1,4 @@
-// GSD-2 — ADR-013 Phase 6 preflight scanner tests.
+// gsd-pi — ADR-013 Phase 6 preflight scanner tests.
 //
 // Locks in the four states the scanner must distinguish:
 //   1. Clean — no gaps, no warning emitted.

package/src/resources/extensions/gsd/tests/memory-decay-factor.test.ts

@@ -1,4 +1,4 @@
-// gsd-2 / memoryDecayFactor unit tests
+// gsd-pi / memoryDecayFactor unit tests
 //
 // Pure-function boundary tests for the V28 time-decay scoring helper.
 // The function maps last_hit_at → multiplier in [0.7, 1.0] used by

package/src/resources/extensions/gsd/tests/merge-self-branch-guard.test.ts

@@ -1,4 +1,4 @@
-// gsd-2 / merge-self-branch-guard.test.ts — regressions for #5024 and #6250
+// gsd-pi / merge-self-branch-guard.test.ts — regressions for #5024 and #6250
 //
 // mergeMilestoneToMain() must recover from stale/corrupt integration metadata
 // that points at milestone branches (integrationBranch recorded as

package/src/resources/extensions/gsd/tests/metrics-atomic-merge.test.ts

@@ -1,5 +1,5 @@
 /**
- * GSD2 Metrics — regression test for parallel-mode atomic merge
+ * gsd-pi Metrics — regression test for parallel-mode atomic merge
  *
  * Verifies that concurrent metrics.json writers do not silently discard
  * each other's entries (last-writer-wins). Two child processes each write

package/src/resources/extensions/gsd/tests/metrics-lock-hardening.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + metrics-lock-hardening.test.ts: regression tests for metrics lock hardening (M3)
+// gsd-pi + metrics-lock-hardening.test.ts: regression tests for metrics lock hardening (M3)
 /**
  * Verifies M3 lock hardening properties:
  *   1. Stale-lock detection: orphaned lock files (mtime > threshold) are forcibly

package/src/resources/extensions/gsd/tests/metrics-lock-not-acquired.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + metrics saveLedger fallback: when lock is not acquired, falls back to direct write (safe, no torn write)
+// gsd-pi + metrics saveLedger fallback: when lock is not acquired, falls back to direct write (safe, no torn write)
 
 import { describe, test, beforeEach, afterEach } from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/metrics-lock-retry-sleep.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + metrics-lock-retry-sleep.test.ts: verify sleep between lock acquire retries (M3 follow-up)
+// gsd-pi + metrics-lock-retry-sleep.test.ts: verify sleep between lock acquire retries (M3 follow-up)
 /**
  * Verifies that acquireLock sleeps between non-stale-evicting retries:
  *
@@ -251,9 +251,11 @@ describe("metrics lock retry sleep (M3 follow-up)", () => {
       `Elapsed: ${elapsed}ms`,
     );
 
-    // Should complete very quickly (no artificial delay).
+    // Should complete without artificial lock-retry delay. The filesystem can
+    // still be slow under process-isolated unit runs, so keep this threshold
+    // loose and rely on the sleepy-retry counter for the real contract.
     assert.ok(
-      elapsed < 200,
+      elapsed < 500,
       `Stale-lock recovery should complete quickly, took ${elapsed}ms`,
     );
   });

package/src/resources/extensions/gsd/tests/metrics-milestone-scope.test.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Regression tests for milestone-scoped metrics aggregation.
 
 import test from "node:test";

package/src/resources/extensions/gsd/tests/metrics-prune-cache-invalidation.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 + metrics prune cache invalidation: pruned units must not reappear after snapshotUnitMetricsByScope
+// gsd-pi + metrics prune cache invalidation: pruned units must not reappear after snapshotUnitMetricsByScope
 
 import { describe, test, beforeEach, afterEach } from "node:test";
 import assert from "node:assert/strict";

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

@@ -1,4 +1,4 @@
-// GSD-2 + metrics-scope.test.ts: tests for scope-aware metrics variants (C6)
+// gsd-pi + metrics-scope.test.ts: tests for scope-aware metrics variants (C6)
 
 import { describe, test, beforeEach, afterEach } from "node:test";
 import assert from "node:assert/strict";

package/src/resources/extensions/gsd/tests/migrate-parser.test.ts

@@ -525,6 +525,80 @@ subsystem: "api"
     }
 });
 
+test('Milestone phase directories, decisions, and seeds are parsed', async () => {
+    const base = createFixtureBase();
+    try {
+      const planning = createPlanningDir(base);
+
+      const milestonesDir = join(planning, 'milestones');
+      mkdirSync(join(milestonesDir, 'v1.0-phases', '01-foundation'), { recursive: true });
+      mkdirSync(join(milestonesDir, 'v2.0-phases', '01-polish'), { recursive: true });
+
+      writeFileSync(join(milestonesDir, 'v1.0-ROADMAP.md'), `# v1.0 Roadmap
+
+## Phases
+
+- [x] 01 — Foundation
+`);
+      writeFileSync(join(milestonesDir, 'v1.0-REQUIREMENTS.md'), `# v1 Requirements
+
+## Validated
+
+- ✅ NET-01: Network baseline is validated
+`);
+      writeFileSync(join(milestonesDir, 'v1.0-phases', '01-foundation', '01-PLAN.md'), `---
+phase: "01-foundation"
+plan: "01"
+---
+
+<objective>Build the foundation.</objective>
+`);
+      writeFileSync(join(milestonesDir, 'v1.0-phases', '01-foundation', '01-SUMMARY.md'), `---
+phase: "01-foundation"
+plan: "01"
+completed: "2026-05-01"
+---
+
+# Foundation summary
+`);
+      writeFileSync(join(milestonesDir, 'v2.0-ROADMAP.md'), `# v2.0 Roadmap
+
+## Phases
+
+- [ ] 01 — Polish
+`);
+      writeFileSync(join(milestonesDir, 'v2.0-phases', '01-polish', '01-PLAN.md'), `---
+phase: "01-polish"
+plan: "01"
+---
+
+<objective>Polish the migration.</objective>
+`);
+
+      mkdirSync(join(planning, 'decisions'), { recursive: true });
+      writeFileSync(join(planning, 'decisions', '2026-05-11-parser-shape.md'), '# Parser Shape\n\nPrefer milestone-local phases.');
+
+      mkdirSync(join(planning, 'seeds'), { recursive: true });
+      writeFileSync(join(planning, 'seeds', 'SEED-001-feature.md'), '# Feature Seed\n\nSeed content.');
+
+      const project = await parsePlanningDirectory(planning);
+
+      assert.deepStrictEqual(project.milestones.length, 2, 'milestone dirs: two legacy milestones parsed');
+      assert.deepStrictEqual(project.milestones[0]?.id, 'v1.0', 'milestone dirs: first legacy ID preserved in parser');
+      assert.ok(project.milestones[0]?.roadmap !== null, 'milestone dirs: roadmap content parsed');
+      assert.ok(project.milestones[0]?.requirements !== null, 'milestone dirs: requirements content parsed');
+      assert.ok('01-foundation' in (project.milestones[0]?.phases ?? {}), 'milestone dirs: v1 phase dir parsed');
+      assert.ok(project.milestones[0]?.phases['01-foundation']?.plans['01'] !== undefined, 'milestone dirs: short plan filename parsed');
+      assert.ok(project.milestones[0]?.phases['01-foundation']?.summaries['01'] !== undefined, 'milestone dirs: short summary filename parsed');
+      assert.deepStrictEqual(project.decisions.length, 1, 'decisions dir: decision file parsed');
+      assert.deepStrictEqual(project.decisions[0]?.fileName, '2026-05-11-parser-shape.md', 'decisions dir: filename preserved');
+      assert.deepStrictEqual(project.seeds.length, 1, 'seeds dir: seed file parsed');
+      assert.deepStrictEqual(project.seeds[0]?.fileName, 'SEED-001-feature.md', 'seeds dir: filename preserved');
+    } finally {
+      cleanup(base);
+    }
+});
+
   // ─── Test 6: Summary file with YAML frontmatter ───────────────────────
 
 test('Summary file with YAML frontmatter', async () => {

package/src/resources/extensions/gsd/tests/migrate-safety-audit.test.ts

@@ -1,4 +1,4 @@
-// GSD-2 - /gsd migrate safety and audit regression tests.
+// gsd-pi - /gsd migrate safety and audit regression tests.
 // File Purpose: Verifies migration hardening contracts for backup, target selection, archive, and DB projections.
 
 import assert from "node:assert/strict";
@@ -19,7 +19,7 @@ import {
   archiveLegacyPlanningDirectory,
   verifyMigrationProjection,
 } from "../migrate/audit.ts";
-import { executeMigrationWrite, importWrittenMigrationToDb } from "../migrate/command.ts";
+import { assertMigrationDbReadiness, executeMigrationWrite, importWrittenMigrationToDb } from "../migrate/command.ts";
 import { writeGSDDirectory } from "../migrate/writer.ts";
 import { closeDatabase, getArtifact } from "../gsd-db.ts";
 import type { GSDProject } from "../migrate/types.ts";
@@ -219,6 +219,24 @@ test("executeMigrationWrite records audit artifacts and verifies DB-backed proje
     assert.ok(getArtifact("migration/manifest.json"), "migration manifest imported as DB artifact");
     assert.deepEqual(result.verification.db, { milestones: 1, slices: 1, tasks: 1 });
     assert.deepEqual(result.verification.markdown, { milestones: 1, slices: 1, tasks: 1 });
+    assert.equal(result.verification.dbReadiness.registry, 1, "migrated DB is readable by deriveState");
+    assert.notEqual(result.verification.dbReadiness.phase, "not-checked", "readiness gate ran before audit");
+  } finally {
+    cleanup(base);
+  }
+});
+
+test("assertMigrationDbReadiness fails loud when deriveState cannot see migrated rows", async () => {
+  const base = makeBase("gsd-migrate-db-readiness-");
+  try {
+    const project = projectFixture();
+    const preview = generatePreview(project);
+    await writeGSDDirectory(project, base);
+
+    await assert.rejects(
+      () => assertMigrationDbReadiness(base, preview),
+      /migration DB readiness failed/,
+    );
   } finally {
     cleanup(base);
   }