gsd-pi 2.33.1 → 2.34.0-dev.6769913

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

@@ -1,370 +0,0 @@
-// Old .planning format type definitions
-// Defines the contract for parsing legacy .planning directories into typed structures.
-// Zero Pi dependencies — pure type definitions only.
-
-// ─── Validation ────────────────────────────────────────────────────────────
-
-export type ValidationSeverity = 'fatal' | 'warning';
-
-export interface ValidationIssue {
-  file: string;
-  severity: ValidationSeverity;
-  message: string;
-}
-
-export interface ValidationResult {
-  valid: boolean;
-  issues: ValidationIssue[];
-}
-
-// ─── Top-Level Container ───────────────────────────────────────────────────
-
-export interface PlanningProject {
-  /** Absolute path to the .planning directory */
-  path: string;
-  /** Parsed PROJECT.md content, null if missing */
-  project: string | null;
-  /** Parsed ROADMAP.md */
-  roadmap: PlanningRoadmap | null;
-  /** Parsed REQUIREMENTS.md entries */
-  requirements: PlanningRequirement[];
-  /** Parsed STATE.md */
-  state: PlanningState | null;
-  /** Parsed config.json */
-  config: PlanningConfig | null;
-  /** Phase directories keyed by full directory name (e.g. "29-auth-system") */
-  phases: Record<string, PlanningPhase>;
-  /** Quick tasks from quick/ directory */
-  quickTasks: PlanningQuickTask[];
-  /** Milestone-level data from milestones/ directory */
-  milestones: PlanningMilestone[];
-  /** Research files from top-level research/ directory */
-  research: PlanningResearch[];
-  /** Validation result from pre-flight checks */
-  validation: ValidationResult;
-}
-
-// ─── Roadmap ───────────────────────────────────────────────────────────────
-
-export interface PlanningRoadmap {
-  /** Raw content for reference */
-  raw: string;
-  /** Milestone sections (for milestone-sectioned roadmaps) */
-  milestones: PlanningRoadmapMilestone[];
-  /** Flat phase entries (for simple flat roadmaps) */
-  phases: PlanningRoadmapEntry[];
-}
-
-export interface PlanningRoadmapMilestone {
-  /** Milestone identifier (e.g. "v2.5") */
-  id: string;
-  /** Milestone title */
-  title: string;
-  /** Whether the milestone section is collapsed (inside <details>) */
-  collapsed: boolean;
-  /** Phase entries within this milestone */
-  phases: PlanningRoadmapEntry[];
-}
-
-export interface PlanningRoadmapEntry {
-  /** Phase number */
-  number: number;
-  /** Phase title/slug */
-  title: string;
-  /** Whether the phase checkbox is checked */
-  done: boolean;
-  /** Raw line text for reference */
-  raw: string;
-}
-
-// ─── Phase ─────────────────────────────────────────────────────────────────
-
-export interface PlanningPhase {
-  /** Full directory name (e.g. "29-auth-system") */
-  dirName: string;
-  /** Extracted phase number */
-  number: number;
-  /** Extracted phase slug */
-  slug: string;
-  /** Plan files keyed by plan number (e.g. "01") */
-  plans: Record<string, PlanningPlan>;
-  /** Summary files keyed by plan number (e.g. "01"), includes orphans */
-  summaries: Record<string, PlanningSummary>;
-  /** Research files in phase directory */
-  research: PlanningResearch[];
-  /** Verification files */
-  verifications: PlanningPhaseFile[];
-  /** Non-standard extra files */
-  extraFiles: PlanningPhaseFile[];
-}
-
-// ─── Plan (XML-in-Markdown) ────────────────────────────────────────────────
-
-export interface PlanningPlan {
-  /** File name (e.g. "29-01-PLAN.md") */
-  fileName: string;
-  /** Plan number within phase (e.g. "01") */
-  planNumber: string;
-  /** Parsed YAML frontmatter */
-  frontmatter: PlanningPlanFrontmatter;
-  /** Extracted <objective> content */
-  objective: string;
-  /** Extracted <tasks> with individual <task> entries */
-  tasks: string[];
-  /** Extracted <context> content */
-  context: string;
-  /** Extracted <verification> content */
-  verification: string;
-  /** Extracted <success_criteria> content */
-  successCriteria: string;
-  /** Raw content for reference */
-  raw: string;
-}
-
-export interface PlanningPlanFrontmatter {
-  phase: string;
-  plan: string;
-  type: string;
-  wave: number | null;
-  depends_on: string[];
-  files_modified: string[];
-  autonomous: boolean;
-  must_haves: PlanningPlanMustHaves | null;
-}
-
-export interface PlanningPlanMustHaves {
-  truths: string[];
-  artifacts: string[];
-  key_links: string[];
-}
-
-// ─── Summary (YAML Frontmatter) ────────────────────────────────────────────
-
-export interface PlanningSummary {
-  /** File name (e.g. "29-01-SUMMARY.md") */
-  fileName: string;
-  /** Plan number within phase (e.g. "01") */
-  planNumber: string;
-  /** Parsed YAML frontmatter */
-  frontmatter: PlanningSummaryFrontmatter;
-  /** Body content (after frontmatter) */
-  body: string;
-  /** Raw content for reference */
-  raw: string;
-}
-
-export interface PlanningSummaryFrontmatter {
-  phase: string;
-  plan: string;
-  subsystem: string;
-  tags: string[];
-  requires: PlanningSummaryRequires[];
-  provides: string[];
-  affects: string[];
-  'tech-stack': string[];
-  'key-files': string[];
-  'key-decisions': string[];
-  'patterns-established': string[];
-  duration: string;
-  completed: string;
-}
-
-export interface PlanningSummaryRequires {
-  phase: string;
-  provides: string;
-}
-
-// ─── Requirements ──────────────────────────────────────────────────────────
-
-export interface PlanningRequirement {
-  /** Requirement ID (e.g. "R001") */
-  id: string;
-  /** Requirement title */
-  title: string;
-  /** Status (active, validated, deferred, etc.) */
-  status: string;
-  /** Description text */
-  description: string;
-  /** Raw section content */
-  raw: string;
-}
-
-// ─── Research ──────────────────────────────────────────────────────────────
-
-export interface PlanningResearch {
-  /** File name */
-  fileName: string;
-  /** Raw content */
-  content: string;
-}
-
-// ─── Config ────────────────────────────────────────────────────────────────
-
-export interface PlanningConfig {
-  /** Project name from config */
-  projectName: string;
-  /** Any other config fields */
-  [key: string]: unknown;
-}
-
-// ─── Quick Tasks ───────────────────────────────────────────────────────────
-
-export interface PlanningQuickTask {
-  /** Directory name (e.g. "001-fix-login") */
-  dirName: string;
-  /** Task number */
-  number: number;
-  /** Task slug */
-  slug: string;
-  /** Plan file content, null if missing */
-  plan: string | null;
-  /** Summary file content, null if missing */
-  summary: string | null;
-}
-
-// ─── Milestones ────────────────────────────────────────────────────────────
-
-export interface PlanningMilestone {
-  /** Directory or file identifier (e.g. "v2.2") */
-  id: string;
-  /** Requirements file content, null if missing */
-  requirements: string | null;
-  /** Roadmap file content, null if missing */
-  roadmap: string | null;
-  /** Any other files */
-  extraFiles: PlanningPhaseFile[];
-}
-
-// ─── State ─────────────────────────────────────────────────────────────────
-
-export interface PlanningState {
-  /** Raw content */
-  raw: string;
-  /** Extracted current phase */
-  currentPhase: string | null;
-  /** Extracted status */
-  status: string | null;
-}
-
-// ─── Generic File Reference ────────────────────────────────────────────────
-
-export interface PlanningPhaseFile {
-  /** File name */
-  fileName: string;
-  /** Raw content */
-  content: string;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// GSD Output Types — produced by transformer, consumed by writer (S03)
-// Mirror GSD-2 runtime shapes so deriveState() works on migrated output.
-// ═══════════════════════════════════════════════════════════════════════════
-
-export interface GSDProject {
-  milestones: GSDMilestone[];
-  /** Raw PROJECT.md text (pass through from old format) */
-  projectContent: string;
-  requirements: GSDRequirement[];
-  /** Empty or pass-through from old project key decisions */
-  decisionsContent: string;
-}
-
-export interface GSDMilestone {
-  /** e.g. "M001", "M002" */
-  id: string;
-  /** From old milestone section title or roadmap H1 */
-  title: string;
-  /** Derived from PROJECT.md description or roadmap H1 */
-  vision: string;
-  /** Empty [] if none found */
-  successCriteria: string[];
-  slices: GSDSlice[];
-  /** Consolidated research blob, null if no research */
-  research: string | null;
-  /** Empty [] — old format has no boundary map equivalent */
-  boundaryMap: GSDBoundaryEntry[];
-}
-
-export interface GSDSlice {
-  /** e.g. "S01", "S02" */
-  id: string;
-  /** Titlecased from phase slug */
-  title: string;
-  /** Default 'medium' */
-  risk: 'low' | 'medium' | 'high';
-  /** [prev slice ID] for sequential, [] for S01 */
-  depends: string[];
-  /** From roadmap checkbox */
-  done: boolean;
-  /** Derived from first plan objective or defaulted */
-  demo: string;
-  /** Same as demo or phase slug */
-  goal: string;
-  tasks: GSDTask[];
-  /** Per-phase research content, null if none */
-  research: string | null;
-  /** Only populated if done */
-  summary: GSDSliceSummaryData | null;
-}
-
-export interface GSDTask {
-  /** e.g. "T01", "T02" */
-  id: string;
-  /** From plan frontmatter or phase slug + plan number */
-  title: string;
-  /** From plan objective */
-  description: string;
-  /** Summary exists for this plan number */
-  done: boolean;
-  /** From summary duration if available, else '' */
-  estimate: string;
-  /** From plan frontmatter files_modified */
-  files: string[];
-  /** From plan frontmatter must_haves.truths */
-  mustHaves: string[];
-  /** Only populated if done */
-  summary: GSDTaskSummaryData | null;
-}
-
-export interface GSDRequirement {
-  /** e.g. "R001" */
-  id: string;
-  title: string;
-  /** Default 'core-capability' */
-  class: string;
-  /** 'active' | 'validated' | 'deferred' */
-  status: string;
-  description: string;
-  /** Default 'inferred' */
-  source: string;
-  /** Default 'none yet' */
-  primarySlice: string;
-}
-
-export interface GSDSliceSummaryData {
-  /** From last plan summary's completed field */
-  completedAt: string;
-  provides: string[];
-  keyFiles: string[];
-  keyDecisions: string[];
-  patternsEstablished: string[];
-  duration: string;
-  /** From summary body */
-  whatHappened: string;
-}
-
-export interface GSDTaskSummaryData {
-  completedAt: string;
-  provides: string[];
-  keyFiles: string[];
-  duration: string;
-  /** From summary body */
-  whatHappened: string;
-}
-
-export interface GSDBoundaryEntry {
-  fromSlice: string;
-  toSlice: string;
-  produces: string;
-  consumes: string;
-}

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

@@ -1,55 +0,0 @@
-// Old .planning directory validator
-// Pre-flight checks for minimum viable .planning directory.
-// Pure functions, zero Pi dependencies — uses only Node built-ins + exported helpers.
-
-import { existsSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-
-import type { ValidationResult, ValidationIssue, ValidationSeverity } from './types.js';
-
-function issue(file: string, severity: ValidationSeverity, message: string): ValidationIssue {
-  return { file, severity, message };
-}
-
-/**
- * Validate that a .planning directory has the minimum required structure.
- * Returns structured issues with severity levels:
- * - fatal: directory doesn't exist (migration cannot proceed)
- * - warning: optional files missing (migration can proceed with reduced data)
- */
-export async function validatePlanningDirectory(path: string): Promise<ValidationResult> {
-  const issues: ValidationIssue[] = [];
-
-  // Check directory exists
-  if (!existsSync(path) || !statSync(path).isDirectory()) {
-    issues.push(issue(path, 'fatal', 'Directory does not exist'));
-    return { valid: false, issues };
-  }
-
-  // ROADMAP.md — warn if missing (transformer falls back to filesystem phases)
-  if (!existsSync(join(path, 'ROADMAP.md'))) {
-    issues.push(issue('ROADMAP.md', 'warning',
-      'ROADMAP.md not found — milestone structure will be inferred from phases/ directory',
-    ));
-  }
-
-  // Optional files — warn if missing
-  if (!existsSync(join(path, 'PROJECT.md'))) {
-    issues.push(issue('PROJECT.md', 'warning', 'PROJECT.md not found — project metadata will be empty'));
-  }
-
-  if (!existsSync(join(path, 'REQUIREMENTS.md'))) {
-    issues.push(issue('REQUIREMENTS.md', 'warning', 'REQUIREMENTS.md not found — requirements will be empty'));
-  }
-
-  if (!existsSync(join(path, 'STATE.md'))) {
-    issues.push(issue('STATE.md', 'warning', 'STATE.md not found — state information will be empty'));
-  }
-
-  if (!existsSync(join(path, 'phases')) || !statSync(join(path, 'phases')).isDirectory()) {
-    issues.push(issue('phases/', 'warning', 'phases/ directory not found — no phase data will be parsed'));
-  }
-
-  const hasFatal = issues.some(i => i.severity === 'fatal');
-  return { valid: !hasFatal, issues };
-}