gsd-pi 2.33.1 → 2.34.0-dev.6769913

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

@@ -1,219 +0,0 @@
-/**
- * /gsd migrate — one-shot migration from .planning to .gsd
- *
- * Thin UX orchestrator: resolves paths, runs the validate → parse → transform →
- * preview → write pipeline, and shows confirmation UI via showNextAction.
- * All business logic lives in the pipeline modules (S01–S03).
- *
- * After a successful write, offers an agent-driven review that audits the
- * output for GSD-2 standards compliance.
- */
-
-import type { ExtensionAPI, ExtensionCommandContext } from "@gsd/pi-coding-agent";
-import { existsSync, readFileSync } from "node:fs";
-import { resolve, join, dirname } from "node:path";
-import { gsdRoot } from "../paths.js";
-import { fileURLToPath } from "node:url";
-import { showNextAction } from "../../shared/mod.js";
-import {
-  validatePlanningDirectory,
-  parsePlanningDirectory,
-  transformToGSD,
-  generatePreview,
-  writeGSDDirectory,
-} from "./index.js";
-
-import type { MigrationPreview } from "./writer.js";
-
-/** Format preview stats for embedding in the review prompt. */
-function formatPreviewStats(preview: MigrationPreview): string {
-  const lines = [
-    `- Milestones: ${preview.milestoneCount}`,
-    `- Slices: ${preview.totalSlices} (${preview.doneSlices} done — ${preview.sliceCompletionPct}%)`,
-    `- Tasks: ${preview.totalTasks} (${preview.doneTasks} done — ${preview.taskCompletionPct}%)`,
-  ];
-  if (preview.requirements.total > 0) {
-    lines.push(
-      `- Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred)`,
-    );
-  }
-  return lines.join("\n");
-}
-
-/** Load and interpolate the review-migration prompt template. */
-function buildReviewPrompt(
-  sourcePath: string,
-  gsdPath: string,
-  preview: MigrationPreview,
-): string {
-  const promptsDir = join(dirname(fileURLToPath(import.meta.url)), "..", "prompts");
-  const templatePath = join(promptsDir, "review-migration.md");
-  let content = readFileSync(templatePath, "utf-8");
-
-  content = content.replaceAll("{{sourcePath}}", sourcePath);
-  content = content.replaceAll("{{gsdPath}}", gsdPath);
-  content = content.replaceAll("{{previewStats}}", formatPreviewStats(preview));
-
-  return content.trim();
-}
-
-/** Dispatch the review prompt to the agent. */
-function dispatchReview(
-  pi: ExtensionAPI,
-  sourcePath: string,
-  gsdPath: string,
-  preview: MigrationPreview,
-): void {
-  const prompt = buildReviewPrompt(sourcePath, gsdPath, preview);
-
-  pi.sendMessage(
-    {
-      customType: "gsd-migrate-review",
-      content: prompt,
-      display: false,
-    },
-    { triggerTurn: true },
-  );
-}
-
-export async function handleMigrate(
-  args: string,
-  ctx: ExtensionCommandContext,
-  pi: ExtensionAPI,
-): Promise<void> {
-  // ── Resolve source path ────────────────────────────────────────────────────
-  // Default to cwd when no args given; expand ~ to HOME
-  let rawPath = args.trim() || ".";
-  if (rawPath.startsWith("~/")) {
-    rawPath = join(process.env.HOME ?? "~", rawPath.slice(2));
-  } else if (rawPath === "~") {
-    rawPath = process.env.HOME ?? "~";
-  }
-
-  let sourcePath = resolve(process.cwd(), rawPath);
-  if (!sourcePath.endsWith(".planning")) {
-    sourcePath = join(sourcePath, ".planning");
-  }
-
-  if (!existsSync(sourcePath)) {
-    ctx.ui.notify(
-      `Directory not found: ${sourcePath}\n\n` +
-      'Migration converts a .planning/ directory (from older GSD versions) into .gsd/ format.\n' +
-      'If you are starting a new project, use /gsd:new-project instead.\n' +
-      'If migrating, ensure the path contains a .planning/ directory.',
-      "error",
-    );
-    return;
-  }
-
-  // ── Validate ───────────────────────────────────────────────────────────────
-  const validation = await validatePlanningDirectory(sourcePath);
-
-  const warnings = validation.issues.filter((i) => i.severity === "warning");
-  const fatals = validation.issues.filter((i) => i.severity === "fatal");
-
-  for (const w of warnings) {
-    ctx.ui.notify(`⚠ ${w.message} (${w.file})`, "warning");
-  }
-  for (const f of fatals) {
-    ctx.ui.notify(`✖ ${f.message} (${f.file})`, "error");
-  }
-
-  if (!validation.valid) {
-    ctx.ui.notify(
-      "Migration blocked — fix the fatal issues above before retrying.",
-      "error",
-    );
-    return;
-  }
-
-  // ── Parse → Transform → Preview ───────────────────────────────────────────
-  const parsed = await parsePlanningDirectory(sourcePath);
-  const project = transformToGSD(parsed);
-  const preview = generatePreview(project);
-
-  // ── Build preview text ─────────────────────────────────────────────────────
-  const lines: string[] = [
-    `Milestones: ${preview.milestoneCount}`,
-    `Slices: ${preview.totalSlices} (${preview.doneSlices} done — ${preview.sliceCompletionPct}%)`,
-    `Tasks: ${preview.totalTasks} (${preview.doneTasks} done — ${preview.taskCompletionPct}%)`,
-  ];
-
-  if (preview.requirements.total > 0) {
-    lines.push(
-      `Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred)`,
-    );
-  }
-
-  const targetGsdExists = existsSync(gsdRoot(process.cwd()));
-  if (targetGsdExists) {
-    lines.push("");
-    lines.push("⚠ A .gsd directory already exists in the current working directory — it will be overwritten.");
-  }
-
-  // ── Confirmation via showNextAction ────────────────────────────────────────
-  const choice = await showNextAction(ctx, {
-    title: "Migration preview",
-    summary: lines,
-    actions: [
-      {
-        id: "confirm",
-        label: "Write .gsd directory",
-        description: `Migrate ${preview.milestoneCount} milestone(s) to ${process.cwd()}/.gsd`,
-        recommended: true,
-      },
-      {
-        id: "cancel",
-        label: "Cancel",
-        description: "Exit without writing anything",
-      },
-    ],
-    notYetMessage: "Run /gsd migrate again when ready.",
-  });
-
-  if (choice !== "confirm") {
-    ctx.ui.notify("Migration cancelled — no files were written.", "info");
-    return;
-  }
-
-  // ── Write ──────────────────────────────────────────────────────────────────
-  ctx.ui.notify("Writing .gsd directory…", "info");
-
-  const result = await writeGSDDirectory(project, process.cwd());
-  const gsdPath = gsdRoot(process.cwd());
-
-  ctx.ui.notify(
-    `✓ Migration complete — ${result.paths.length} file(s) written to .gsd/`,
-    "info",
-  );
-
-  // ── Post-write review offer ────────────────────────────────────────────────
-  const reviewChoice = await showNextAction(ctx, {
-    title: "Migration written",
-    summary: [
-      `${result.paths.length} files written to .gsd/`,
-      "",
-      "The agent can now review the migrated output against GSD-2 standards —",
-      "checking structure, content quality, deriveState() round-trip, and",
-      "requirement statuses. It will fix minor issues in-place.",
-    ],
-    actions: [
-      {
-        id: "review",
-        label: "Review migration",
-        description: "Agent audits the .gsd output and reports PASS/FAIL per category",
-        recommended: true,
-      },
-      {
-        id: "skip",
-        label: "Skip review",
-        description: "Trust the migration output as-is",
-      },
-    ],
-    notYetMessage: "Run /gsd migrate again to re-migrate, or review .gsd manually.",
-  });
-
-  if (reviewChoice === "review") {
-    dispatchReview(pi, sourcePath, gsdPath, preview);
-  }
-}

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

@@ -1,42 +0,0 @@
-// Barrel export for old .planning migration module
-
-export { handleMigrate } from './command.js';
-export { parsePlanningDirectory } from './parser.js';
-export { validatePlanningDirectory } from './validator.js';
-export { transformToGSD } from './transformer.js';
-export { writeGSDDirectory } from './writer.js';
-export type { WrittenFiles, MigrationPreview } from './writer.js';
-export { generatePreview } from './preview.js';
-export type {
-  // Input types (old .planning format)
-  PlanningProject,
-  PlanningPhase,
-  PlanningPlan,
-  PlanningPlanFrontmatter,
-  PlanningPlanMustHaves,
-  PlanningSummary,
-  PlanningSummaryFrontmatter,
-  PlanningSummaryRequires,
-  PlanningRoadmap,
-  PlanningRoadmapMilestone,
-  PlanningRoadmapEntry,
-  PlanningRequirement,
-  PlanningResearch,
-  PlanningConfig,
-  PlanningQuickTask,
-  PlanningMilestone,
-  PlanningState,
-  PlanningPhaseFile,
-  ValidationResult,
-  ValidationIssue,
-  ValidationSeverity,
-  // Output types (GSD-2 format)
-  GSDProject,
-  GSDMilestone,
-  GSDSlice,
-  GSDTask,
-  GSDRequirement,
-  GSDSliceSummaryData,
-  GSDTaskSummaryData,
-  GSDBoundaryEntry,
-} from './types.js';

package/dist/resources/extensions/gsd/migrate/parser.ts

@@ -1,323 +0,0 @@
-// Old .planning directory parser orchestrator
-// Walks a .planning directory tree, delegates to per-file parsers,
-// and assembles the complete typed PlanningProject.
-// Zero Pi dependencies — uses only Node built-ins + local parsers.
-
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { join, basename } from 'node:path';
-
-import {
-  parseOldRoadmap,
-  parseOldPlan,
-  parseOldSummary,
-  parseOldRequirements,
-  parseOldProject,
-  parseOldState,
-  parseOldConfig,
-} from './parsers.js';
-import { validatePlanningDirectory } from './validator.js';
-
-import type {
-  PlanningProject,
-  PlanningPhase,
-  PlanningQuickTask,
-  PlanningMilestone,
-  PlanningResearch,
-  PlanningPhaseFile,
-} from './types.js';
-
-// ─── Helpers ───────────────────────────────────────────────────────────────
-
-/** Read a file, returning null if it doesn't exist. */
-function readOptional(path: string): string | null {
-  try {
-    return readFileSync(path, 'utf-8');
-  } catch {
-    return null;
-  }
-}
-
-/** List directory entries (names only), returning [] if dir doesn't exist. */
-function listDir(path: string): string[] {
-  try {
-    return readdirSync(path);
-  } catch {
-    return [];
-  }
-}
-
-/** Check if a path is a directory. */
-function isDir(path: string): boolean {
-  try {
-    return statSync(path).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-/** Extract phase number and slug from a directory name like "29-auth-system" or "01.2-setup". */
-function parsePhaseDir(dirName: string): { number: number; slug: string } | null {
-  const match = dirName.match(/^(\d+(?:\.\d+)?)-(.+)$/);
-  if (!match) return null;
-  return { number: parseFloat(match[1]), slug: match[2] };
-}
-
-/** Extract quick task number and slug from a directory name like "001-fix-login". */
-function parseQuickDir(dirName: string): { number: number; slug: string } | null {
-  const match = dirName.match(/^(\d+)-(.+)$/);
-  if (!match) return null;
-  return { number: parseInt(match[1], 10), slug: match[2] };
-}
-
-// ─── Phase Scanner ─────────────────────────────────────────────────────────
-
-/** Plan file pattern: NN-NN-PLAN.md (e.g. 29-01-PLAN.md) */
-const PLAN_RE = /^(\d+(?:\.\d+)?)-(\d+)-PLAN\.md$/i;
-
-/** Summary file pattern: NN-NN-SUMMARY.md (e.g. 29-01-SUMMARY.md) */
-const SUMMARY_RE = /^(\d+(?:\.\d+)?)-(\d+)-SUMMARY\.md$/i;
-
-/** Research file pattern: contains RESEARCH (case-insensitive) */
-const RESEARCH_RE = /research/i;
-
-/** Verification file pattern: contains VERIFICATION (case-insensitive) */
-const VERIFICATION_RE = /verification/i;
-
-function scanPhaseDirectory(phaseDir: string, dirName: string, parsed: ReturnType<typeof parsePhaseDir>): PlanningPhase {
-  const phase: PlanningPhase = {
-    dirName,
-    number: parsed!.number,
-    slug: parsed!.slug,
-    plans: {},
-    summaries: {},
-    research: [],
-    verifications: [],
-    extraFiles: [],
-  };
-
-  const entries = listDir(phaseDir);
-
-  for (const entry of entries) {
-    const entryPath = join(phaseDir, entry);
-
-    // Skip directories within phase dirs
-    if (isDir(entryPath)) continue;
-
-    const planMatch = entry.match(PLAN_RE);
-    if (planMatch) {
-      const planNumber = planMatch[2];
-      const content = readFileSync(entryPath, 'utf-8');
-      phase.plans[planNumber] = parseOldPlan(content, entry, planNumber);
-      continue;
-    }
-
-    const summaryMatch = entry.match(SUMMARY_RE);
-    if (summaryMatch) {
-      const planNumber = summaryMatch[2];
-      const content = readFileSync(entryPath, 'utf-8');
-      phase.summaries[planNumber] = parseOldSummary(content, entry, planNumber);
-      continue;
-    }
-
-    if (VERIFICATION_RE.test(entry)) {
-      const content = readFileSync(entryPath, 'utf-8');
-      phase.verifications.push({ fileName: entry, content });
-      continue;
-    }
-
-    if (RESEARCH_RE.test(entry)) {
-      const content = readFileSync(entryPath, 'utf-8');
-      phase.research.push({ fileName: entry, content });
-      continue;
-    }
-
-    // Everything else is an extra file
-    const content = readFileSync(entryPath, 'utf-8');
-    phase.extraFiles.push({ fileName: entry, content });
-  }
-
-  return phase;
-}
-
-// ─── Quick Task Scanner ────────────────────────────────────────────────────
-
-function scanQuickDirectory(quickDir: string): PlanningQuickTask[] {
-  const tasks: PlanningQuickTask[] = [];
-  const entries = listDir(quickDir).sort();
-
-  for (const dirName of entries) {
-    const dirPath = join(quickDir, dirName);
-    if (!isDir(dirPath)) continue;
-
-    const parsed = parseQuickDir(dirName);
-    if (!parsed) continue;
-
-    // Look for NNN-PLAN.md and NNN-SUMMARY.md
-    const files = listDir(dirPath);
-    let plan: string | null = null;
-    let summary: string | null = null;
-
-    for (const file of files) {
-      if (/^\d+-PLAN\.md$/i.test(file)) {
-        plan = readFileSync(join(dirPath, file), 'utf-8');
-      } else if (/^\d+-SUMMARY\.md$/i.test(file)) {
-        summary = readFileSync(join(dirPath, file), 'utf-8');
-      }
-    }
-
-    tasks.push({
-      dirName,
-      number: parsed.number,
-      slug: parsed.slug,
-      plan,
-      summary,
-    });
-  }
-
-  return tasks;
-}
-
-// ─── Milestones Scanner ────────────────────────────────────────────────────
-
-function scanMilestonesDirectory(msDir: string): PlanningMilestone[] {
-  const entries = listDir(msDir);
-  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[] }>();
-
-  for (const entry of entries) {
-    const entryPath = join(msDir, entry);
-    if (isDir(entryPath)) 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 content = readFileSync(entryPath, 'utf-8');
-
-      if (type === 'REQUIREMENTS') ms.requirements = content;
-      else if (type === 'ROADMAP') ms.roadmap = content;
-      else ms.extraFiles.push({ fileName: entry, content });
-    } else {
-      // 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 content = readFileSync(entryPath, 'utf-8');
-      grouped.get(id)!.extraFiles.push({ fileName: entry, content });
-    }
-  }
-
-  return Array.from(grouped.entries()).map(([id, data]) => ({
-    id,
-    requirements: data.requirements,
-    roadmap: data.roadmap,
-    extraFiles: data.extraFiles,
-  }));
-}
-
-// ─── Research Scanner ──────────────────────────────────────────────────────
-
-function scanResearchDirectory(researchDir: string): PlanningResearch[] {
-  const entries = listDir(researchDir);
-  const research: PlanningResearch[] = [];
-
-  for (const entry of entries) {
-    const entryPath = join(researchDir, entry);
-    if (isDir(entryPath)) continue;
-    const content = readFileSync(entryPath, 'utf-8');
-    research.push({ fileName: entry, content });
-  }
-
-  return research;
-}
-
-// ─── Main Orchestrator ─────────────────────────────────────────────────────
-
-/**
- * Parse an old .planning directory into a complete typed PlanningProject.
- *
- * Handles:
- * - Top-level files: PROJECT.md, ROADMAP.md, REQUIREMENTS.md, STATE.md, config.json
- * - Phase directories with plans, summaries, research, verification, extras
- * - Duplicate phase numbers (full directory name as key)
- * - .archive/ skipping
- * - Orphan summaries (summaries without matching plans)
- * - Quick tasks from quick/ directory
- * - Milestones from milestones/ directory
- * - Research from research/ directory
- *
- * Missing files produce null values, not thrown errors.
- * Use validatePlanningDirectory() for pre-flight structural checks.
- */
-export async function parsePlanningDirectory(path: string): Promise<PlanningProject> {
-  // Run validation first
-  const validation = await validatePlanningDirectory(path);
-
-  // Parse top-level files
-  const projectContent = readOptional(join(path, 'PROJECT.md'));
-  const project = projectContent !== null ? parseOldProject(projectContent) : null;
-
-  const roadmapContent = readOptional(join(path, 'ROADMAP.md'));
-  const roadmap = roadmapContent !== null ? parseOldRoadmap(roadmapContent) : null;
-
-  const reqContent = readOptional(join(path, 'REQUIREMENTS.md'));
-  const requirements = reqContent !== null ? parseOldRequirements(reqContent) : [];
-
-  const stateContent = readOptional(join(path, 'STATE.md'));
-  const state = stateContent !== null ? parseOldState(stateContent) : null;
-
-  const configContent = readOptional(join(path, 'config.json'));
-  const config = configContent !== null ? parseOldConfig(configContent) : null;
-
-  // Scan phases/ directory
-  const phases: Record<string, PlanningPhase> = {};
-  const phasesDir = join(path, 'phases');
-
-  if (isDir(phasesDir)) {
-    const phaseDirs = listDir(phasesDir).sort();
-
-    for (const dirName of phaseDirs) {
-      // Skip .archive and hidden directories
-      if (dirName.startsWith('.')) continue;
-
-      const dirPath = join(phasesDir, dirName);
-      if (!isDir(dirPath)) continue;
-
-      const parsed = parsePhaseDir(dirName);
-      if (!parsed) continue;
-
-      phases[dirName] = scanPhaseDirectory(dirPath, dirName, parsed);
-    }
-  }
-
-  // Scan quick/ directory
-  const quickDir = join(path, 'quick');
-  const quickTasks = isDir(quickDir) ? scanQuickDirectory(quickDir) : [];
-
-  // Scan milestones/ directory
-  const msDir = join(path, 'milestones');
-  const milestones = isDir(msDir) ? scanMilestonesDirectory(msDir) : [];
-
-  // Scan research/ directory
-  const researchDir = join(path, 'research');
-  const research = isDir(researchDir) ? scanResearchDirectory(researchDir) : [];
-
-  return {
-    path,
-    project,
-    roadmap,
-    requirements,
-    state,
-    config,
-    phases,
-    quickTasks,
-    milestones,
-    research,
-    validation,
-  };
-}