@opengsd/gsd-pi 1.0.1 → 1.0.2

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: SQLite provider loading and fallback helpers for the GSD database facade.
 
 export type DbProviderName = "node:sqlite" | "better-sqlite3";

package/src/resources/extensions/gsd/db-runtime-kv-schema.ts

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

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

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

package/src/resources/extensions/gsd/db-task-slice-rows.ts

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Task and slice row mappers for the GSD database facade.
 
 export interface SliceRow {

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";
@@ -7,7 +7,6 @@ import { dirname } from "node:path";
 import { logWarning } from "./workflow-logger.js";
 
 export type LegacyTelemetryCounter =
-  | "legacy.markdownFallbackUsed"
   | "legacy.workflowEngineUsed"
   | "legacy.uokFallbackUsed"
   | "legacy.mcpAliasUsed"
@@ -22,7 +21,6 @@ export interface LegacyTelemetryReport {
 }
 
 const COUNTERS: LegacyTelemetryCounter[] = [
-  "legacy.markdownFallbackUsed",
   "legacy.workflowEngineUsed",
   "legacy.uokFallbackUsed",
   "legacy.mcpAliasUsed",
@@ -37,7 +35,6 @@ const values: LegacyTelemetrySnapshot = Object.fromEntries(
 const warnedCounters = new Set<LegacyTelemetryCounter>();
 
 const DIAGNOSTICS: Record<LegacyTelemetryCounter, string> = {
-  "legacy.markdownFallbackUsed": "Deprecated markdown state fallback used; migrate projects to DB-authoritative state before removing markdown derivation.",
   "legacy.workflowEngineUsed": "Deprecated workflow engine path used; prefer auto-milestone workflow templates before removing legacy engines.",
   "legacy.uokFallbackUsed": "Deprecated UOK fallback path used; resolve UOK kernel blockers before removing parity fallback wrappers.",
   "legacy.mcpAliasUsed": "Deprecated MCP alias tool used; update callers to the canonical gsd_* tool name before alias removal.",

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/md-importer.ts

@@ -175,8 +175,8 @@ export function parseRequirementsSections(content: string): Requirement[] {
       continue;
     }
 
-    // Check for requirement heading (### RXXX — Title)
-    const reqMatch = line.match(/^###\s+(R\d+)\s*[—–-]\s*(.+)/);
+    // Check for requirement heading (### RXXX — Title or ### NET-01 — Title)
+    const reqMatch = line.match(/^###\s+([A-Z][A-Z0-9]*-\d+|R\d+)\s*[—–-]\s*(.+)/i);
     if (reqMatch) {
       flushReq();
       if (currentSectionStatus !== null) {

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";
@@ -28,6 +28,10 @@ export interface LegacyArchiveResult {
 export interface MigrationProjectionVerification {
   markdown: HierarchyCounts;
   db: HierarchyCounts;
+  dbReadiness: {
+    phase: string;
+    registry: number;
+  };
   rendered: number;
   skipped: number;
   errors: string[];
@@ -84,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`);
@@ -125,6 +129,7 @@ export async function verifyMigrationProjection(
   return {
     markdown,
     db,
+    dbReadiness: { phase: "not-checked", registry: 0 },
     rendered: render.rendered,
     skipped: render.skipped,
     errors,
@@ -156,6 +161,7 @@ function formatMigrationMarkdown(input: MigrationAuditInput): string {
     "",
     `- DB: ${input.verification.db.milestones}M/${input.verification.db.slices}S/${input.verification.db.tasks}T`,
     `- Markdown: ${input.verification.markdown.milestones}M/${input.verification.markdown.slices}S/${input.verification.markdown.tasks}T`,
+    `- DB readiness: ${input.verification.dbReadiness.phase} (${input.verification.dbReadiness.registry} milestone(s) visible)`,
     `- Rendered: ${input.verification.rendered}`,
     `- Skipped: ${input.verification.skipped}`,
     "",

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";
@@ -27,7 +27,7 @@ import type { MigrationPreview, WrittenFiles } from "./writer.js";
 import { ensureDbOpen } from "../bootstrap/dynamic-tools.js";
 import { clearArtifacts, clearDecisions, clearRequirements, clearEngineHierarchy, transaction } from "../gsd-db.js";
 import { migrateFromMarkdown } from "../md-importer.js";
-import { invalidateStateCache } from "../state.js";
+import { deriveState, invalidateStateCache } from "../state.js";
 import {
   archiveLegacyPlanningDirectory,
   verifyMigrationProjection,
@@ -100,6 +100,25 @@ export async function importWrittenMigrationToDb(
   return counts;
 }
 
+export async function assertMigrationDbReadiness(
+  targetRoot: string,
+  preview: MigrationPreview,
+): Promise<{ phase: string; registry: number }> {
+  invalidateStateCache();
+  const state = await deriveState(targetRoot);
+  const dbUnavailable = state.blockers.some((blocker) => blocker.includes("DB unavailable"));
+  if (dbUnavailable) {
+    throw new Error(`migration DB readiness failed: ${state.blockers.join("; ")}`);
+  }
+  if (state.registry.length !== preview.milestoneCount) {
+    throw new Error(`migration DB readiness failed: registry ${state.registry.length}/${preview.milestoneCount}`);
+  }
+  return {
+    phase: state.phase,
+    registry: state.registry.length,
+  };
+}
+
 export async function executeMigrationWrite(
   sourcePath: string,
   targetRoot: string,
@@ -114,6 +133,7 @@ export async function executeMigrationWrite(
     const legacyArchive = await archiveLegacyPlanningDirectory(sourcePath, targetRoot);
     const imported = await importWrittenMigrationToDb(targetRoot, preview);
     const verification = await verifyMigrationProjection(targetRoot, preview);
+    verification.dbReadiness = await assertMigrationDbReadiness(targetRoot, preview);
     const audit = await writeMigrationAudit({
       sourcePath,
       targetRoot,
@@ -144,9 +164,12 @@ function formatPreviewStats(preview: MigrationPreview): string {
   ];
   if (preview.requirements.total > 0) {
     lines.push(
-      `- Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred)`,
+      `- Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred, ${preview.requirements.outOfScope} out of scope)`,
     );
   }
+  if (preview.migrationInputs) {
+    lines.push(`- Legacy inputs: ${preview.migrationInputs.milestonePhaseDirs} milestone phase dir(s), ${preview.migrationInputs.decisions} decision file(s), ${preview.migrationInputs.seeds} seed file(s)`);
+  }
   return lines.join("\n");
 }
 
@@ -248,9 +271,12 @@ export async function handleMigrate(
 
   if (preview.requirements.total > 0) {
     lines.push(
-      `Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred)`,
+      `Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred, ${preview.requirements.outOfScope} out of scope)`,
     );
   }
+  if (preview.migrationInputs) {
+    lines.push(`Legacy inputs: ${preview.migrationInputs.milestonePhaseDirs} milestone phase dir(s), ${preview.migrationInputs.decisions} decision file(s), ${preview.migrationInputs.seeds} seed file(s)`);
+  }
 
   const targetGsdExists = existsSync(gsdRoot(targetRoot));
   if (targetGsdExists) {
@@ -315,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/parser.ts

@@ -23,6 +23,8 @@ import type {
   PlanningQuickTask,
   PlanningMilestone,
   PlanningResearch,
+  PlanningDecision,
+  PlanningSeed,
   PlanningPhaseFile,
 } from './types.js';
 
@@ -73,9 +75,11 @@ function parseQuickDir(dirName: string): { number: number; slug: string } | null
 
 /** Plan file pattern: NN-NN-PLAN.md (e.g. 29-01-PLAN.md) or NN-NNb-PLAN.md. */
 const PLAN_RE = /^(\d+(?:\.\d+)?)-(\d+[a-z]?)-PLAN\.md$/i;
+const SHORT_PLAN_RE = /^(\d+[a-z]?)-PLAN\.md$/i;
 
 /** Summary file pattern: NN-NN-SUMMARY.md (e.g. 29-01-SUMMARY.md) or NN-NNb-SUMMARY.md. */
 const SUMMARY_RE = /^(\d+(?:\.\d+)?)-(\d+[a-z]?)-SUMMARY\.md$/i;
+const SHORT_SUMMARY_RE = /^(\d+[a-z]?)-SUMMARY\.md$/i;
 
 /** Research file pattern: contains RESEARCH (case-insensitive) */
 const RESEARCH_RE = /research/i;
@@ -103,17 +107,17 @@ function scanPhaseDirectory(phaseDir: string, dirName: string, parsed: ReturnTyp
     // Skip directories within phase dirs
     if (isDir(entryPath)) continue;
 
-    const planMatch = entry.match(PLAN_RE);
+    const planMatch = entry.match(PLAN_RE) ?? entry.match(SHORT_PLAN_RE);
     if (planMatch) {
-      const planNumber = planMatch[2];
+      const planNumber = planMatch[2] ?? planMatch[1];
       const content = readFileSync(entryPath, 'utf-8');
       phase.plans[planNumber] = parseOldPlan(content, entry, planNumber);
       continue;
     }
 
-    const summaryMatch = entry.match(SUMMARY_RE);
+    const summaryMatch = entry.match(SUMMARY_RE) ?? entry.match(SHORT_SUMMARY_RE);
     if (summaryMatch) {
-      const planNumber = summaryMatch[2];
+      const planNumber = summaryMatch[2] ?? summaryMatch[1];
       const content = readFileSync(entryPath, 'utf-8');
       phase.summaries[planNumber] = parseOldSummary(content, entry, planNumber);
       continue;
@@ -184,19 +188,37 @@ function scanMilestonesDirectory(msDir: string): PlanningMilestone[] {
   if (entries.length === 0) return [];
 
   // Group files by milestone ID prefix (e.g. "v2.2" from "v2.2-ROADMAP.md")
-  const grouped = new Map<string, { requirements: string | null; roadmap: string | null; extraFiles: PlanningPhaseFile[] }>();
+  const grouped = new Map<string, { requirements: string | null; roadmap: string | null; phases: Record<string, PlanningPhase>; extraFiles: PlanningPhaseFile[] }>();
+
+  function ensureMilestone(id: string) {
+    if (!grouped.has(id)) grouped.set(id, { requirements: null, roadmap: null, phases: {}, extraFiles: [] });
+    return grouped.get(id)!;
+  }
 
   for (const entry of entries) {
     const entryPath = join(msDir, entry);
-    if (isDir(entryPath)) continue;
+    if (isDir(entryPath)) {
+      const phasesMatch = entry.match(/^(.+)-phases$/i);
+      if (!phasesMatch) continue;
+      const ms = ensureMilestone(phasesMatch[1]);
+      const phaseDirs = listDir(entryPath).sort();
+      for (const dirName of phaseDirs) {
+        if (dirName.startsWith('.')) continue;
+        const dirPath = join(entryPath, dirName);
+        if (!isDir(dirPath)) continue;
+        const parsed = parsePhaseDir(dirName);
+        if (!parsed) continue;
+        ms.phases[dirName] = scanPhaseDirectory(dirPath, dirName, parsed);
+      }
+      continue;
+    }
 
     // Extract milestone ID: everything before the first dash-followed-by-uppercase or common suffix
     const idMatch = entry.match(/^(.+?)-(ROADMAP|REQUIREMENTS|SUMMARY)\.md$/i);
     if (idMatch) {
       const id = idMatch[1];
       const type = idMatch[2].toUpperCase();
-      if (!grouped.has(id)) grouped.set(id, { requirements: null, roadmap: null, extraFiles: [] });
-      const ms = grouped.get(id)!;
+      const ms = ensureMilestone(id);
       const content = readFileSync(entryPath, 'utf-8');
 
       if (type === 'REQUIREMENTS') ms.requirements = content;
@@ -206,9 +228,9 @@ function scanMilestonesDirectory(msDir: string): PlanningMilestone[] {
       // Non-standard file — try to extract ID from filename
       const simpleMatch = entry.match(/^(.+?)\./);
       const id = simpleMatch ? simpleMatch[1] : entry;
-      if (!grouped.has(id)) grouped.set(id, { requirements: null, roadmap: null, extraFiles: [] });
+      const ms = ensureMilestone(id);
       const content = readFileSync(entryPath, 'utf-8');
-      grouped.get(id)!.extraFiles.push({ fileName: entry, content });
+      ms.extraFiles.push({ fileName: entry, content });
     }
   }
 
@@ -216,6 +238,7 @@ function scanMilestonesDirectory(msDir: string): PlanningMilestone[] {
     id,
     requirements: data.requirements,
     roadmap: data.roadmap,
+    phases: data.phases,
     extraFiles: data.extraFiles,
   }));
 }
@@ -236,6 +259,28 @@ function scanResearchDirectory(researchDir: string): PlanningResearch[] {
   return research;
 }
 
+function scanDecisionDirectory(decisionsDir: string): PlanningDecision[] {
+  return scanFlatMarkdownDirectory(decisionsDir);
+}
+
+function scanSeedDirectory(seedsDir: string): PlanningSeed[] {
+  return scanFlatMarkdownDirectory(seedsDir);
+}
+
+function scanFlatMarkdownDirectory<T extends PlanningPhaseFile>(dir: string): T[] {
+  const entries = listDir(dir).sort();
+  const files: T[] = [];
+
+  for (const entry of entries) {
+    const entryPath = join(dir, entry);
+    if (isDir(entryPath)) continue;
+    const content = readFileSync(entryPath, 'utf-8');
+    files.push({ fileName: entry, content } as T);
+  }
+
+  return files;
+}
+
 // ─── Main Orchestrator ─────────────────────────────────────────────────────
 
 /**
@@ -307,6 +352,12 @@ export async function parsePlanningDirectory(path: string): Promise<PlanningProj
   const researchDir = join(path, 'research');
   const research = isDir(researchDir) ? scanResearchDirectory(researchDir) : [];
 
+  const decisionsDir = join(path, 'decisions');
+  const decisions = isDir(decisionsDir) ? scanDecisionDirectory(decisionsDir) : [];
+
+  const seedsDir = join(path, 'seeds');
+  const seeds = isDir(seedsDir) ? scanSeedDirectory(seedsDir) : [];
+
   return {
     path,
     project,
@@ -318,6 +369,8 @@ export async function parsePlanningDirectory(path: string): Promise<PlanningProj
     quickTasks,
     milestones,
     research,
+    decisions,
+    seeds,
     validation,
   };
 }

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

@@ -610,6 +610,23 @@ export function parseOldRequirements(content: string): PlanningRequirement[] {
       continue;
     }
 
+    const emojiReqMatch = line.match(/^-\s+(✅|✓|⏳|✗)\s+([A-Z][A-Z0-9]*-\d+|R\d+)\s*:\s*(.+)$/i);
+    if (emojiReqMatch) {
+      flushReq();
+      const marker = emojiReqMatch[1];
+      const id = emojiReqMatch[2].trim();
+      const desc = emojiReqMatch[3].trim();
+      const status = marker === '✗' ? 'rejected' : marker === '⏳' ? 'active' : 'validated';
+      requirements.push({
+        id,
+        title: desc,
+        status,
+        description: desc,
+        raw: line,
+      });
+      continue;
+    }
+
     // Description or metadata within a requirement
     if (currentReq) {
       currentRaw.push(line);

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

@@ -46,6 +46,7 @@ export function generatePreview(project: GSDProject): MigrationPreview {
     decisions: {
       total: countCanonicalDecisionRows(project.decisionsContent),
     },
+    migrationInputs: project.migrationInputs,
     milestoneCount: project.milestones.length,
     totalSlices,
     totalTasks,

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";