gsd-pi 2.33.1 → 2.34.0-dev.6769913

package/dist/resources/extensions/gsd/triage-ui.ts

@@ -1,175 +0,0 @@
-/**
- * GSD Triage UI — Confirmation flow for programmatic triage results
- *
- * Used by auto-mode dispatch (S02) when triage fires between tasks.
- * For manual `/gsd triage`, the LLM session handles confirmation directly.
- *
- * This module provides `showTriageConfirmation` which presents each
- * triage result to the user via `showNextAction` and returns the
- * confirmed classifications.
- */
-
-import type { ExtensionCommandContext } from "@gsd/pi-coding-agent";
-import { showNextAction } from "../shared/mod.js";
-import type { CaptureEntry, Classification, TriageResult } from "./captures.js";
-import { markCaptureResolved } from "./captures.js";
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface ConfirmedTriage {
-  captureId: string;
-  classification: Classification;
-  rationale: string;
-  affectedFiles?: string[];
-  targetSlice?: string;
-  userOverride: boolean;  // true if user changed the proposed classification
-}
-
-// ─── Classification Labels ────────────────────────────────────────────────────
-
-const CLASSIFICATION_LABELS: Record<Classification, { label: string; description: string }> = {
-  "quick-task": {
-    label: "Quick task",
-    description: "Execute as a one-off at the next seam — no plan modification.",
-  },
-  "inject": {
-    label: "Inject into plan",
-    description: "Add a new task to the current slice plan.",
-  },
-  "defer": {
-    label: "Defer",
-    description: "Move to a future slice or milestone — not urgent now.",
-  },
-  "replan": {
-    label: "Replan slice",
-    description: "Remaining tasks need rewriting — triggers slice replan.",
-  },
-  "note": {
-    label: "Note",
-    description: "Informational only — no action needed.",
-  },
-};
-
-const ALL_CLASSIFICATIONS: Classification[] = [
-  "quick-task", "inject", "defer", "replan", "note",
-];
-
-// ─── Public API ───────────────────────────────────────────────────────────────
-
-/**
- * Present triage results to the user for confirmation.
- *
- * For each capture:
- * - note/defer: auto-confirm (no user interaction needed)
- * - quick-task/inject/replan: show confirmation UI with proposed + alternatives
- *
- * Returns confirmed results with final classifications.
- * Updates CAPTURES.md with resolved status.
- *
- * @param fileOverlaps - Map of captureId → list of planned task IDs whose files overlap
- */
-export async function showTriageConfirmation(
-  ctx: ExtensionCommandContext,
-  triageResults: TriageResult[],
-  captures: CaptureEntry[],
-  basePath: string,
-  fileOverlaps?: Map<string, string[]>,
-): Promise<ConfirmedTriage[]> {
-  const confirmed: ConfirmedTriage[] = [];
-  const captureMap = new Map(captures.map(c => [c.id, c]));
-
-  for (const result of triageResults) {
-    const capture = captureMap.get(result.captureId);
-    if (!capture) continue;
-
-    // Auto-confirm note and defer — low-impact, no plan modification
-    if (result.classification === "note" || result.classification === "defer") {
-      const resolution = result.classification === "note"
-        ? "acknowledged as note"
-        : `deferred${result.targetSlice ? ` to ${result.targetSlice}` : ""}`;
-
-      markCaptureResolved(
-        basePath,
-        result.captureId,
-        result.classification,
-        resolution,
-        result.rationale,
-      );
-
-      confirmed.push({
-        captureId: result.captureId,
-        classification: result.classification,
-        rationale: result.rationale,
-        affectedFiles: result.affectedFiles,
-        targetSlice: result.targetSlice,
-        userOverride: false,
-      });
-      continue;
-    }
-
-    // Build summary lines for the confirmation UI
-    const summary: string[] = [
-      `"${capture.text}"`,
-      "",
-      `Proposed: **${CLASSIFICATION_LABELS[result.classification].label}** — ${result.rationale}`,
-    ];
-
-    // Add file overlap warning if present
-    const overlaps = fileOverlaps?.get(result.captureId);
-    if (overlaps && overlaps.length > 0) {
-      summary.push("");
-      summary.push(`⚠ Touches files planned for ${overlaps.join(", ")} — consider inject or defer`);
-    }
-
-    if (result.affectedFiles && result.affectedFiles.length > 0) {
-      summary.push("");
-      summary.push(`Files: ${result.affectedFiles.join(", ")}`);
-    }
-
-    // Build action options — proposed first (recommended), then alternatives
-    const proposed = result.classification;
-    const actions = ALL_CLASSIFICATIONS.map(cls => ({
-      id: cls,
-      label: CLASSIFICATION_LABELS[cls].label,
-      description: CLASSIFICATION_LABELS[cls].description,
-      recommended: cls === proposed,
-    }));
-
-    const choice = await showNextAction(ctx, {
-      title: `Triage: ${result.captureId}`,
-      summary,
-      actions,
-      notYetMessage: "Capture will remain pending for later triage.",
-    });
-
-    if (choice === "not_yet") {
-      // User skipped — leave capture pending
-      continue;
-    }
-
-    const finalClassification = choice as Classification;
-    const userOverride = finalClassification !== proposed;
-    const resolution = userOverride
-      ? `user chose ${finalClassification} (was ${proposed})`
-      : `confirmed as ${finalClassification}`;
-
-    markCaptureResolved(
-      basePath,
-      result.captureId,
-      finalClassification,
-      resolution,
-      userOverride ? `User override: ${result.rationale}` : result.rationale,
-    );
-
-    confirmed.push({
-      captureId: result.captureId,
-      classification: finalClassification,
-      rationale: result.rationale,
-      affectedFiles: result.affectedFiles,
-      targetSlice: result.targetSlice,
-      userOverride,
-    });
-  }
-
-  return confirmed;
-}

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