gsd-pi 2.33.0-dev.bafba33 → 2.33.1-dev.235d83a

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

@@ -1,425 +0,0 @@
-// GSD Extension — Core Type Definitions
-// Types consumed by state derivation, file parsing, and status display.
-// Pure interfaces — no logic, no runtime dependencies.
-
-// ─── Enums & Literal Unions ────────────────────────────────────────────────
-
-export type RiskLevel = 'low' | 'medium' | 'high';
-export type Phase = 'pre-planning' | 'needs-discussion' | 'discussing' | 'researching' | 'planning' | 'executing' | 'verifying' | 'summarizing' | 'advancing' | 'validating-milestone' | 'completing-milestone' | 'replanning-slice' | 'complete' | 'paused' | 'blocked';
-export type ContinueStatus = 'in_progress' | 'interrupted' | 'compacted';
-
-// ─── Roadmap (Milestone-level) ─────────────────────────────────────────────
-
-export interface RoadmapSliceEntry {
-  id: string;          // e.g. "S01"
-  title: string;       // e.g. "Types + File I/O + Git Operations"
-  risk: RiskLevel;
-  depends: string[];   // e.g. ["S01", "S02"]
-  done: boolean;
-  demo: string;        // the "After this:" sentence
-}
-
-export interface BoundaryMapEntry {
-  fromSlice: string;   // e.g. "S01"
-  toSlice: string;     // e.g. "S02" or "terminal"
-  produces: string;    // raw text block of what this slice produces
-  consumes: string;    // raw text block of what it consumes (or "nothing")
-}
-
-export interface Roadmap {
-  title: string;       // e.g. "M001: GSD Extension — Hierarchical Planning with Auto Mode"
-  vision: string;
-  successCriteria: string[];
-  slices: RoadmapSliceEntry[];
-  boundaryMap: BoundaryMapEntry[];
-}
-
-// ─── Slice Plan ────────────────────────────────────────────────────────────
-
-export interface TaskPlanEntry {
-  id: string;          // e.g. "T01"
-  title: string;       // e.g. "Core Type Definitions"
-  description: string;
-  done: boolean;
-  estimate: string;    // e.g. "30m", "2h" — informational only
-  files?: string[];    // e.g. ["types.ts", "files.ts"] — extracted from "- Files:" subline
-  verify?: string;     // e.g. "run tests" — extracted from "- Verify:" subline
-}
-
-// ─── Verification Gate ─────────────────────────────────────────────────────
-
-/** Result of a single verification command execution */
-export interface VerificationCheck {
-  command: string;       // e.g. "npm run lint"
-  exitCode: number;      // 0 = pass
-  stdout: string;
-  stderr: string;
-  durationMs: number;
-  blocking: boolean;     // true for preference/task-plan sources, false for package-json (advisory only)
-}
-
-/** A runtime error captured from bg-shell processes or browser console */
-export interface RuntimeError {
-  source: "bg-shell" | "browser";
-  severity: "crash" | "error" | "warning";
-  message: string;
-  blocking: boolean;
-}
-
-/** A dependency vulnerability warning from npm audit */
-export interface AuditWarning {
-  name: string;
-  severity: "low" | "moderate" | "high" | "critical";
-  title: string;
-  url: string;
-  fixAvailable: boolean;
-}
-
-/** Aggregate result from the verification gate */
-export interface VerificationResult {
-  passed: boolean;              // true if all checks passed (or no checks discovered)
-  checks: VerificationCheck[];  // per-command results
-  discoverySource: "preference" | "task-plan" | "package-json" | "none";
-  timestamp: number;            // Date.now() at gate start
-  runtimeErrors?: RuntimeError[];  // optional — populated by captureRuntimeErrors()
-  auditWarnings?: AuditWarning[];  // optional — populated by runDependencyAudit()
-}
-
-export interface SlicePlan {
-  id: string;          // e.g. "S01"
-  title: string;       // from the H1
-  goal: string;
-  demo: string;
-  mustHaves: string[]; // top-level must-have bullet points
-  tasks: TaskPlanEntry[];
-  filesLikelyTouched: string[];
-}
-
-// ─── Summary (Task & Slice level) ──────────────────────────────────────────
-
-export interface SummaryRequires {
-  slice: string;
-  provides: string;
-}
-
-export interface SummaryFrontmatter {
-  id: string;
-  parent: string;
-  milestone: string;
-  provides: string[];
-  requires: SummaryRequires[];
-  affects: string[];
-  key_files: string[];
-  key_decisions: string[];
-  patterns_established: string[];
-  drill_down_paths: string[];
-  observability_surfaces: string[];
-  duration: string;
-  verification_result: string;
-  completed_at: string;
-  blocker_discovered: boolean;
-}
-
-export interface FileModified {
-  path: string;
-  description: string;
-}
-
-export interface Summary {
-  frontmatter: SummaryFrontmatter;
-  title: string;
-  oneLiner: string;
-  whatHappened: string;
-  deviations: string;
-  filesModified: FileModified[];
-}
-
-// ─── Continue-Here ─────────────────────────────────────────────────────────
-
-export interface ContinueFrontmatter {
-  milestone: string;
-  slice: string;
-  task: string;
-  step: number;
-  totalSteps: number;
-  status: ContinueStatus;
-  savedAt: string;
-}
-
-export interface Continue {
-  frontmatter: ContinueFrontmatter;
-  completedWork: string;
-  remainingWork: string;
-  decisions: string;
-  context: string;
-  nextAction: string;
-}
-
-// ─── Secrets Manifest ──────────────────────────────────────────────────────
-
-export type SecretsManifestEntryStatus = 'pending' | 'collected' | 'skipped';
-
-export interface SecretsManifestEntry {
-  key: string;              // e.g. "OPENAI_API_KEY"
-  service: string;          // e.g. "OpenAI"
-  dashboardUrl: string;     // e.g. "https://platform.openai.com/api-keys" — empty if unknown
-  guidance: string[];       // numbered setup steps
-  formatHint: string;       // e.g. "starts with sk-" — empty if unknown
-  status: SecretsManifestEntryStatus;
-  destination: string;      // e.g. "dotenv", "vercel", "convex"
-}
-
-export interface SecretsManifest {
-  milestone: string;        // e.g. "M001"
-  generatedAt: string;      // ISO 8601 timestamp
-  entries: SecretsManifestEntry[];
-}
-
-export interface ManifestStatus {
-  pending: string[];    // manifest status = pending AND not in env
-  collected: string[];  // manifest status = collected AND not in env
-  skipped: string[];    // manifest status = skipped
-  existing: string[];   // key present in .env or process.env (regardless of manifest status)
-}
-
-// ─── GSD State (Derived Dashboard) ────────────────────────────────────────
-
-export interface ActiveRef {
-  id: string;
-  title: string;
-}
-
-export interface MilestoneRegistryEntry {
-  id: string;
-  title: string;
-  status: 'complete' | 'active' | 'pending' | 'parked';
-  /** Milestone IDs that must be complete before this milestone becomes active. Populated from CONTEXT.md YAML frontmatter. */
-  dependsOn?: string[];
-}
-
-export interface RequirementCounts {
-  active: number;
-  validated: number;
-  deferred: number;
-  outOfScope: number;
-  blocked: number;
-  total: number;
-}
-
-export interface GSDState {
-  activeMilestone: ActiveRef | null;
-  activeSlice: ActiveRef | null;
-  activeTask: ActiveRef | null;
-  phase: Phase;
-  recentDecisions: string[];
-  blockers: string[];
-  nextAction: string;
-  activeWorkspace?: string;
-  registry: MilestoneRegistryEntry[];
-  requirements?: RequirementCounts;
-  progress?: {
-    milestones: { done: number; total: number };
-    slices?: { done: number; total: number };
-    tasks?: { done: number; total: number };
-  };
-}
-
-// ─── Post-Unit Hook Types ─────────────────────────────────────────────────
-
-export interface PostUnitHookConfig {
-  /** Unique hook identifier — used in idempotency keys and logging. */
-  name: string;
-  /** Unit types that trigger this hook (e.g., ["execute-task"]). */
-  after: string[];
-  /** Prompt sent to the LLM session. Supports {milestoneId}, {sliceId}, {taskId} substitutions. */
-  prompt: string;
-  /** Max times this hook can fire for the same trigger unit. Default 1, max 10. */
-  max_cycles?: number;
-  /** Model override for hook sessions. */
-  model?: string;
-  /** Expected output file name (relative to task/slice dir). Used for idempotency — skip if exists. */
-  artifact?: string;
-  /** If this file is produced instead of artifact, re-run the trigger unit then re-run hooks. */
-  retry_on?: string;
-  /** Agent definition file to use. */
-  agent?: string;
-  /** Set false to disable without removing config. Default true. */
-  enabled?: boolean;
-}
-
-export interface HookExecutionState {
-  /** Hook name. */
-  hookName: string;
-  /** The unit type that triggered this hook. */
-  triggerUnitType: string;
-  /** The unit ID that triggered this hook. */
-  triggerUnitId: string;
-  /** Current cycle (1-based). */
-  cycle: number;
-  /** Whether the hook completed with a retry signal (retry_on artifact found). */
-  pendingRetry: boolean;
-}
-
-export interface HookDispatchResult {
-  /** Hook name for display. */
-  hookName: string;
-  /** The prompt to send. */
-  prompt: string;
-  /** Model override, if configured. */
-  model?: string;
-  /** Synthetic unit type, e.g. "hook/code-review". */
-  unitType: string;
-  /** The trigger unit's ID, reused for the hook. */
-  unitId: string;
-}
-
-// ─── Budget & Notification Types ──────────────────────────────────────────
-
-export type BudgetEnforcementMode = 'warn' | 'pause' | 'halt';
-
-export type TokenProfile = 'budget' | 'balanced' | 'quality';
-
-export type InlineLevel = 'full' | 'standard' | 'minimal';
-
-export type ComplexityTier = 'light' | 'standard' | 'heavy';
-
-export interface ClassificationResult {
-  tier: ComplexityTier;
-  reason: string;
-  downgraded: boolean;
-}
-
-export interface TaskMetadata {
-  fileCount?: number;
-  dependencyCount?: number;
-  isNewFile?: boolean;
-  tags?: string[];
-  estimatedLines?: number;
-  codeBlockCount?: number;
-  complexityKeywords?: string[];
-}
-
-export interface PhaseSkipPreferences {
-  skip_research?: boolean;
-  skip_reassess?: boolean;
-  skip_slice_research?: boolean;
-  skip_milestone_validation?: boolean;
-  /** When true, reassess-roadmap fires after each slice completion. Opt-in. */
-  reassess_after_slice?: boolean;
-  /** When true, auto-mode pauses before each slice for discussion (#789). */
-  require_slice_discussion?: boolean;
-}
-
-export interface NotificationPreferences {
-  enabled?: boolean;           // default true
-  on_complete?: boolean;       // notify on each unit completion
-  on_error?: boolean;          // notify on errors
-  on_budget?: boolean;         // notify on budget thresholds
-  on_milestone?: boolean;      // notify when milestone finishes
-  on_attention?: boolean;      // notify when manual attention needed
-}
-
-// ─── Pre-Dispatch Hook Types ──────────────────────────────────────────────
-
-export interface PreDispatchHookConfig {
-  /** Unique hook identifier. */
-  name: string;
-  /** Unit types this hook intercepts before dispatch (e.g., ["execute-task"]). */
-  before: string[];
-  /** Action to take: "modify" mutates the prompt, "skip" skips the unit, "replace" swaps it. */
-  action: 'modify' | 'skip' | 'replace';
-  /** For "modify": text prepended to the unit prompt. Supports {milestoneId}, {sliceId}, {taskId}. */
-  prepend?: string;
-  /** For "modify": text appended to the unit prompt. Supports {milestoneId}, {sliceId}, {taskId}. */
-  append?: string;
-  /** For "replace": the replacement prompt. Supports {milestoneId}, {sliceId}, {taskId}. */
-  prompt?: string;
-  /** For "replace": override the unit type label. */
-  unit_type?: string;
-  /** For "skip": optional condition file — only skip if this file exists (relative to unit dir). */
-  skip_if?: string;
-  /** Model override when this hook fires. */
-  model?: string;
-  /** Set false to disable without removing config. Default true. */
-  enabled?: boolean;
-}
-
-export interface PreDispatchResult {
-  /** What happened: the unit proceeds with modifications, was skipped, or was replaced. */
-  action: 'proceed' | 'skip' | 'replace';
-  /** Modified/replacement prompt (for "proceed" and "replace"). */
-  prompt?: string;
-  /** Override unit type (for "replace"). */
-  unitType?: string;
-  /** Model override. */
-  model?: string;
-  /** Names of hooks that fired, for logging. */
-  firedHooks: string[];
-}
-
-// ─── Hook State Persistence Types ─────────────────────────────────────────
-
-export interface PersistedHookState {
-  /** Cycle counts keyed as "hookName/triggerUnitType/triggerUnitId". */
-  cycleCounts: Record<string, number>;
-  /** Timestamp of last state save. */
-  savedAt: string;
-}
-
-export interface HookStatusEntry {
-  /** Hook name. */
-  name: string;
-  /** Hook type: "post" or "pre". */
-  type: 'post' | 'pre';
-  /** Whether hook is enabled. */
-  enabled: boolean;
-  /** What unit types it targets. */
-  targets: string[];
-  /** Current cycle counts for active triggers. */
-  activeCycles: Record<string, number>;
-}
-
-// ─── Database Types (Decisions & Requirements) ────────────────────────────
-
-export interface Decision {
-  seq: number;              // auto-increment primary key
-  id: string;               // e.g. "D001"
-  when_context: string;     // when/context of the decision
-  scope: string;            // scope (milestone, slice, global, etc.)
-  decision: string;         // what was decided
-  choice: string;           // the specific choice made
-  rationale: string;        // why this choice
-  revisable: string;        // whether/when revisable
-  superseded_by: string | null;  // ID of superseding decision, or null
-}
-
-export interface Requirement {
-  id: string;               // e.g. "R001"
-  class: string;            // requirement class (functional, non-functional, etc.)
-  status: string;           // active, validated, deferred, etc.
-  description: string;      // short description
-  why: string;              // rationale
-  source: string;           // origin (milestone, user, etc.)
-  primary_owner: string;    // owning slice/milestone
-  supporting_slices: string; // other slices that touch this
-  validation: string;       // how to validate
-  notes: string;            // additional notes
-  full_content: string;     // full requirement text
-  superseded_by: string | null;  // ID of superseding requirement, or null
-}
-
-// ─── Parallel Orchestration Types ────────────────────────────────────────
-
-export type CompressionStrategy = 'truncate' | 'compress';
-export type ContextSelectionMode = 'full' | 'smart';
-
-export type MergeStrategy = "per-slice" | "per-milestone";
-export type AutoMergeMode = "auto" | "confirm" | "manual";
-
-export interface ParallelConfig {
-  enabled: boolean;
-  max_workers: number;
-  budget_ceiling?: number;
-  merge_strategy: MergeStrategy;
-  auto_merge: AutoMergeMode;
-}

package/dist/resources/extensions/gsd/undo.ts

@@ -1,223 +0,0 @@
-// GSD Extension — Undo Last Unit
-// Rollback the most recent completed unit: revert git, remove state, uncheck plans.
-
-import type { ExtensionCommandContext, ExtensionAPI } from "@gsd/pi-coding-agent";
-import { existsSync, readFileSync, writeFileSync, unlinkSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-import { nativeRevertCommit, nativeRevertAbort } from "./native-git-bridge.js";
-import { deriveState } from "./state.js";
-import { invalidateAllCaches } from "./cache.js";
-import { gsdRoot, resolveTasksDir, resolveSlicePath, buildTaskFileName } from "./paths.js";
-import { sendDesktopNotification } from "./notifications.js";
-import { parseUnitId } from "./unit-id.js";
-
-/**
- * Undo the last completed unit: revert git commits, remove from completed-units,
- * delete summary artifacts, and uncheck the task in PLAN.
- */
-export async function handleUndo(args: string, ctx: ExtensionCommandContext, _pi: ExtensionAPI, basePath: string): Promise<void> {
-  const force = args.includes("--force");
-
-  // 1. Load completed-units.json
-  const completedKeysFile = join(gsdRoot(basePath), "completed-units.json");
-  if (!existsSync(completedKeysFile)) {
-    ctx.ui.notify("Nothing to undo — no completed units found.", "info");
-    return;
-  }
-
-  let keys: string[];
-  try {
-    keys = JSON.parse(readFileSync(completedKeysFile, "utf-8"));
-  } catch {
-    ctx.ui.notify("Nothing to undo — completed-units.json is corrupt.", "warning");
-    return;
-  }
-
-  if (keys.length === 0) {
-    ctx.ui.notify("Nothing to undo — no completed units.", "info");
-    return;
-  }
-
-  // Get the last completed unit
-  const lastKey = keys[keys.length - 1];
-  const sepIdx = lastKey.indexOf("/");
-  const unitType = sepIdx >= 0 ? lastKey.slice(0, sepIdx) : lastKey;
-  const unitId = sepIdx >= 0 ? lastKey.slice(sepIdx + 1) : lastKey;
-
-  if (!force) {
-    ctx.ui.notify(
-      `Will undo: ${unitType} (${unitId})\n` +
-      `This will:\n` +
-      `  - Remove from completed-units.json\n` +
-      `  - Delete summary artifacts\n` +
-      `  - Uncheck task in PLAN (if execute-task)\n` +
-      `  - Attempt to revert associated git commits\n\n` +
-      `Run /gsd undo --force to confirm.`,
-      "warning",
-    );
-    return;
-  }
-
-  // 2. Remove from completed-units.json
-  keys = keys.filter(k => k !== lastKey);
-  writeFileSync(completedKeysFile, JSON.stringify(keys), "utf-8");
-
-  // 3. Delete summary artifact
-  const { milestone: mid, slice: sid, task: tid } = parseUnitId(unitId);
-  let summaryRemoved = false;
-  if (mid && sid && tid) {
-    // Task-level: M001/S01/T01
-    const tasksDir = resolveTasksDir(basePath, mid, sid);
-    if (tasksDir) {
-      const summaryFile = join(tasksDir, buildTaskFileName(tid, "SUMMARY"));
-      if (existsSync(summaryFile)) {
-        unlinkSync(summaryFile);
-        summaryRemoved = true;
-      }
-    }
-  } else if (mid && sid) {
-    // Slice-level: M001/S01
-    const slicePath = resolveSlicePath(basePath, mid, sid);
-    if (slicePath) {
-      // Try common summary filenames
-      for (const suffix of ["SUMMARY", "COMPLETE"]) {
-        const candidates = findFileWithPrefix(slicePath, sid, suffix);
-        for (const f of candidates) {
-          unlinkSync(f);
-          summaryRemoved = true;
-        }
-      }
-    }
-  }
-
-  // 4. Uncheck task in PLAN if execute-task
-  let planUpdated = false;
-  if (unitType === "execute-task" && mid && sid && tid) {
-    planUpdated = uncheckTaskInPlan(basePath, mid, sid, tid);
-  }
-
-  // 5. Try to revert git commits from activity log
-  let commitsReverted = 0;
-  const activityDir = join(gsdRoot(basePath), "activity");
-  try {
-    if (existsSync(activityDir)) {
-      const commits = findCommitsForUnit(activityDir, unitType, unitId);
-      if (commits.length > 0) {
-        for (const sha of commits.reverse()) {
-          try {
-            nativeRevertCommit(basePath, sha);
-            commitsReverted++;
-          } catch {
-            // Revert conflict or already reverted — skip
-            try { nativeRevertAbort(basePath); } catch { /* no-op */ }
-            break;
-          }
-        }
-      }
-    }
-  } finally {
-    // 6. Re-derive state — always invalidate caches even if git operations fail
-    invalidateAllCaches();
-    await deriveState(basePath);
-  }
-
-  // Build result message
-  const results: string[] = [`Undone: ${unitType} (${unitId})`];
-  results.push(`  - Removed from completed-units.json`);
-  if (summaryRemoved) results.push(`  - Deleted summary artifact`);
-  if (planUpdated) results.push(`  - Unchecked task in PLAN`);
-  if (commitsReverted > 0) {
-    results.push(`  - Reverted ${commitsReverted} commit(s) (staged, not committed)`);
-    results.push(`  Review with 'git diff --cached' then 'git commit' or 'git reset HEAD'`);
-  }
-
-  ctx.ui.notify(results.join("\n"), "success");
-  sendDesktopNotification("GSD", `Undone: ${unitType} (${unitId})`, "info", "complete");
-}
-
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
-export function uncheckTaskInPlan(basePath: string, mid: string, sid: string, tid: string): boolean {
-  const slicePath = resolveSlicePath(basePath, mid, sid);
-  if (!slicePath) return false;
-
-  // Find the PLAN file
-  const planCandidates = findFileWithPrefix(slicePath, sid, "PLAN");
-  if (planCandidates.length === 0) return false;
-
-  const planFile = planCandidates[0];
-  let content = readFileSync(planFile, "utf-8");
-
-  // Match checked task line: - [x] **T01** or - [x] T01:
-  const regex = new RegExp(`^(\\s*-\\s*)\\[x\\](\\s*\\**${tid}\\**[:\\s])`, "mi");
-  if (regex.test(content)) {
-    content = content.replace(regex, "$1[ ]$2");
-    writeFileSync(planFile, content, "utf-8");
-    return true;
-  }
-  return false;
-}
-
-function findFileWithPrefix(dir: string, prefix: string, suffix: string): string[] {
-  try {
-    const files = readdirSync(dir);
-    return files
-      .filter(f => f.includes(suffix) && (f.startsWith(prefix) || f.startsWith(`${prefix}-`)))
-      .map(f => join(dir, f));
-  } catch {
-    return [];
-  }
-}
-
-export function findCommitsForUnit(activityDir: string, unitType: string, unitId: string): string[] {
-  const safeUnitId = unitId.replace(/\//g, "-");
-  const commitSet = new Set<string>();
-  const commits: string[] = [];
-
-  try {
-    const files = readdirSync(activityDir)
-      .filter(f => f.includes(unitType) && f.includes(safeUnitId) && f.endsWith(".jsonl"))
-      .sort()
-      .reverse();
-
-    if (files.length === 0) return [];
-
-    // Parse the most recent activity log for this unit
-    const content = readFileSync(join(activityDir, files[0]), "utf-8");
-    for (const line of content.split("\n")) {
-      if (!line.trim()) continue;
-      try {
-        const entry = JSON.parse(line);
-        // Look for tool results containing git commit output
-        if (entry?.message?.content) {
-          const blocks = Array.isArray(entry.message.content) ? entry.message.content : [];
-          for (const block of blocks) {
-            if (block.type === "tool_result" && typeof block.content === "string") {
-              for (const sha of extractCommitShas(block.content)) {
-                if (!commitSet.has(sha)) {
-                  commitSet.add(sha);
-                  commits.push(sha);
-                }
-              }
-            }
-          }
-        }
-      } catch { /* malformed JSON line — skip */ }
-    }
-  } catch { /* activity dir issues — skip */ }
-
-  return commits;
-}
-
-export function extractCommitShas(content: string): string[] {
-  const seen = new Set<string>();
-  const commits: string[] = [];
-  for (const match of content.matchAll(/\[[\w/.-]+\s+([a-f0-9]{7,40})\]/g)) {
-    const sha = match[1];
-    if (sha && !seen.has(sha)) {
-      seen.add(sha);
-      commits.push(sha);
-    }
-  }
-  return commits;
-}

package/dist/resources/extensions/gsd/unit-id.ts

@@ -1,14 +0,0 @@
-// GSD Extension — Unit ID Parsing
-// Centralizes the milestone/slice/task decomposition of unit ID strings.
-
-export interface ParsedUnitId {
-  milestone: string;
-  slice?: string;
-  task?: string;
-}
-
-/** Parse a unit ID string (e.g. "M1/S1/T1") into its milestone, slice, and task components. */
-export function parseUnitId(unitId: string): ParsedUnitId {
-  const [milestone, slice, task] = unitId.split("/");
-  return { milestone: milestone!, slice, task };
-}