lsd-pi 1.0.0 → 1.1.0

package/src/resources/extensions/gsd/rule-types.ts

@@ -1,68 +0,0 @@
-// GSD Extension — Unified Rule Type Definitions
-//
-// Every dispatch rule and hook is expressed as a `UnifiedRule` with a
-// consistent when/where/then shape. This file defines the type system;
-// the `RuleRegistry` class in rule-registry.ts holds instances at runtime.
-
-import type { DispatchAction, DispatchContext } from "./auto-dispatch.js";
-import type {
-  PostUnitHookConfig,
-  PreDispatchHookConfig,
-  HookDispatchResult,
-  PreDispatchResult,
-  HookExecutionState,
-  HookStatusEntry,
-} from "./types.js";
-
-// ─── Phase & Evaluation Strategy ────────────────────────────────────────────
-
-/** Which phase/event a rule responds to. */
-export type RulePhase = "dispatch" | "post-unit" | "pre-dispatch";
-
-/** How a rule is evaluated relative to peers in the same phase. */
-export type RuleEvaluation = "first-match" | "all-matching";
-
-// ─── Lifecycle Metadata (hooks only) ────────────────────────────────────────
-
-/** Optional lifecycle metadata attached to hook-derived rules. */
-export interface RuleLifecycle {
-  /** Expected output file name (relative to unit dir). Used for idempotency. */
-  artifact?: string;
-  /** If this file is produced instead of artifact, re-run the trigger unit. */
-  retry_on?: string;
-  /** Max times this hook can fire for the same trigger unit. */
-  max_cycles?: number;
-  /** Idempotency key pattern for this hook. */
-  idempotency_key?: string;
-}
-
-// ─── Unified Rule ───────────────────────────────────────────────────────────
-
-/**
- * A single entry in the rule registry. Dispatch rules, post-unit hooks,
- * and pre-dispatch hooks all share this shape.
- */
-export interface UnifiedRule {
-  /** Stable human-readable identifier (existing names preserved per D005). */
-  name: string;
-  /** Which phase/event this rule responds to. */
-  when: RulePhase;
-  /** How this rule is evaluated relative to peers. */
-  evaluation: RuleEvaluation;
-  /**
-   * Predicate/match function.
-   * - Dispatch rules: async, receives DispatchContext, returns DispatchAction | null.
-   * - Post-unit hooks: sync, receives (unitType, unitId, basePath).
-   * - Pre-dispatch hooks: sync, receives (unitType, unitId, prompt, basePath).
-   */
-  where: (...args: any[]) => Promise<any> | any;
-  /**
-   * Action builder. May be merged with `where` for dispatch rules where
-   * the match function returns the action directly.
-   */
-  then: (...args: any[]) => any;
-  /** Optional human-readable summary for LLM inspection. */
-  description?: string;
-  /** Optional hook lifecycle metadata. */
-  lifecycle?: RuleLifecycle;
-}

package/src/resources/extensions/gsd/run-manager.ts

@@ -1,180 +0,0 @@
-/**
- * run-manager.ts — Create and list isolated workflow run directories.
- *
- * Each run lives under `.gsd/workflow-runs/<name>/<timestamp>/` and contains:
- * - DEFINITION.yaml — frozen snapshot of the workflow definition at run-creation time
- * - GRAPH.yaml — initialized step graph with all steps pending
- * - PARAMS.json — (optional) parameter overrides used for this run
- *
- * Observability:
- * - All run state is on disk in human-readable YAML/JSON — inspectable with cat/less.
- * - `listRuns()` returns structured metadata including step counts and overall status.
- * - Timestamp directory names are filesystem-safe (ISO with hyphens replacing colons).
- * - Errors include the full path context for diagnosis.
- */
-
-import { mkdirSync, writeFileSync, existsSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { stringify } from "yaml";
-import { loadDefinition, substituteParams } from "./definition-loader.js";
-import { initializeGraph, writeGraph, readGraph } from "./graph.js";
-import type { WorkflowDefinition } from "./definition-loader.js";
-import type { WorkflowGraph } from "./graph.js";
-
-// ─── Types ───────────────────────────────────────────────────────────────
-
-export interface RunMetadata {
-  /** Workflow definition name. */
-  name: string;
-  /** Filesystem-safe timestamp string used as dir name. */
-  timestamp: string;
-  /** Full path to the run directory. */
-  runDir: string;
-  /** Step counts derived from GRAPH.yaml. */
-  steps: { total: number; completed: number; pending: number; active: number };
-  /** Overall status derived from step states. */
-  status: "pending" | "running" | "complete";
-}
-
-// ─── Constants ───────────────────────────────────────────────────────────
-
-const RUNS_DIR = "workflow-runs";
-const DEFS_DIR = "workflow-defs";
-
-// ─── Helpers ─────────────────────────────────────────────────────────────
-
-/**
- * Generate a filesystem-safe timestamp: `YYYY-MM-DDTHH-MM-SS`.
- * Replaces colons with hyphens so the string is safe as a directory name
- * on all platforms (Windows forbids colons in paths).
- */
-function makeTimestamp(date: Date = new Date()): string {
-  return date.toISOString().replace(/:/g, "-").replace(/\.\d{3}Z$/, "");
-}
-
-/**
- * Derive overall status from a graph's step statuses.
- */
-function deriveStatus(graph: WorkflowGraph): "pending" | "running" | "complete" {
-  const hasActive = graph.steps.some((s) => s.status === "active");
-  const allDone = graph.steps.every(
-    (s) => s.status === "complete" || s.status === "expanded",
-  );
-  if (allDone) return "complete";
-  if (hasActive) return "running";
-  return "pending";
-}
-
-// ─── Public API ──────────────────────────────────────────────────────────
-
-/**
- * Create a new isolated run directory for a workflow definition.
- *
- * 1. Loads the definition from `<basePath>/.gsd/workflow-defs/<defName>.yaml`
- * 2. Applies parameter substitution if overrides are provided
- * 3. Creates `<basePath>/.gsd/workflow-runs/<defName>/<timestamp>/`
- * 4. Writes frozen DEFINITION.yaml, initialized GRAPH.yaml, and optional PARAMS.json
- *
- * @param basePath — project root directory
- * @param defName — definition filename (without .yaml extension)
- * @param overrides — optional parameter overrides (merged with definition defaults)
- * @returns Full path to the created run directory
- * @throws Error if the definition file doesn't exist or is invalid
- */
-export function createRun(
-  basePath: string,
-  defName: string,
-  overrides?: Record<string, string>,
-): string {
-  const defsDir = join(basePath, ".gsd", DEFS_DIR);
-
-  // Load and validate the definition
-  const rawDef = loadDefinition(defsDir, defName);
-
-  // Apply parameter substitution if overrides provided
-  const def: WorkflowDefinition = overrides
-    ? substituteParams(rawDef, overrides)
-    : substituteParams(rawDef); // still resolve default params if any
-
-  // Create the run directory
-  const timestamp = makeTimestamp();
-  const runDir = join(basePath, ".gsd", RUNS_DIR, defName, timestamp);
-  mkdirSync(runDir, { recursive: true });
-
-  // Freeze the definition as DEFINITION.yaml
-  writeFileSync(join(runDir, "DEFINITION.yaml"), stringify(def), "utf-8");
-
-  // Initialize and write GRAPH.yaml
-  const graph = initializeGraph(def);
-  writeGraph(runDir, graph);
-
-  // Write PARAMS.json if overrides were provided
-  if (overrides && Object.keys(overrides).length > 0) {
-    writeFileSync(
-      join(runDir, "PARAMS.json"),
-      JSON.stringify(overrides, null, 2),
-      "utf-8",
-    );
-  }
-
-  return runDir;
-}
-
-/**
- * List existing workflow runs with metadata.
- *
- * Scans `<basePath>/.gsd/workflow-runs/` for run directories. Each run's
- * GRAPH.yaml is read to derive step counts and overall status.
- *
- * @param basePath — project root directory
- * @param defName — optional filter: only list runs for this definition name
- * @returns Array of run metadata, sorted newest-first within each definition
- */
-export function listRuns(basePath: string, defName?: string): RunMetadata[] {
-  const runsRoot = join(basePath, ".gsd", RUNS_DIR);
-  if (!existsSync(runsRoot)) return [];
-
-  const results: RunMetadata[] = [];
-
-  // Get workflow name directories
-  const nameDirs = defName ? [defName] : readdirSync(runsRoot).filter((entry) => {
-    const full = join(runsRoot, entry);
-    return statSync(full).isDirectory();
-  });
-
-  for (const name of nameDirs) {
-    const nameDir = join(runsRoot, name);
-    if (!existsSync(nameDir)) continue;
-
-    const timestamps = readdirSync(nameDir).filter((entry) => {
-      const full = join(nameDir, entry);
-      return statSync(full).isDirectory();
-    });
-
-    // Sort newest-first (ISO strings sort lexicographically)
-    timestamps.sort().reverse();
-
-    for (const ts of timestamps) {
-      const runDir = join(nameDir, ts);
-      try {
-        const graph = readGraph(runDir);
-        const total = graph.steps.length;
-        const completed = graph.steps.filter((s) => s.status === "complete").length;
-        const pending = graph.steps.filter((s) => s.status === "pending").length;
-        const active = graph.steps.filter((s) => s.status === "active").length;
-
-        results.push({
-          name,
-          timestamp: ts,
-          runDir,
-          steps: { total, completed, pending, active },
-          status: deriveStatus(graph),
-        });
-      } catch {
-        // Skip runs with invalid/missing GRAPH.yaml
-      }
-    }
-  }
-
-  return results;
-}

package/src/resources/extensions/gsd/safe-fs.ts

@@ -1,47 +0,0 @@
-import { existsSync, mkdirSync, cpSync, type CopySyncOptions } from "node:fs"
-import { dirname } from "node:path"
-
-/**
- * Safely creates a directory. Returns true if successful, false on error.
- * Logs to stderr when GSD_DEBUG is set.
- */
-export function safeMkdir(dirPath: string): boolean {
-  try {
-    mkdirSync(dirPath, { recursive: true })
-    return true
-  } catch (err) {
-    if (process.env.GSD_DEBUG) console.error(`[gsd] mkdir failed: ${dirPath}`, err)
-    return false
-  }
-}
-
-/**
- * Safely copies src to dst. Returns true if successful, false if src doesn't exist or copy fails.
- * Logs to stderr when GSD_DEBUG is set.
- */
-export function safeCopy(src: string, dst: string, opts?: CopySyncOptions): boolean {
-  if (!existsSync(src)) return false
-  try {
-    cpSync(src, dst, opts)
-    return true
-  } catch (err) {
-    if (process.env.GSD_DEBUG) console.error(`[gsd] copy failed: ${src} → ${dst}`, err)
-    return false
-  }
-}
-
-/**
- * Safely copies a directory recursively, creating the parent of dst if needed.
- * Returns true if successful.
- */
-export function safeCopyRecursive(src: string, dst: string, opts?: Omit<CopySyncOptions, 'recursive'>): boolean {
-  if (!existsSync(src)) return false
-  try {
-    mkdirSync(dirname(dst), { recursive: true })
-    cpSync(src, dst, { ...opts, recursive: true })
-    return true
-  } catch (err) {
-    if (process.env.GSD_DEBUG) console.error(`[gsd] recursive copy failed: ${src} → ${dst}`, err)
-    return false
-  }
-}

package/src/resources/extensions/gsd/service-tier.ts

@@ -1,196 +0,0 @@
-/**
- * Service Tier — gating, status formatting, icon resolution, and
- * the /gsd fast command handler.
- *
- * Service tiers (priority/flex) are an OpenAI feature that only applies
- * to gpt-5.4 variants. This module centralizes the model-gating logic
- * so that icons, preferences, and the before_provider_request hook all
- * use a single source of truth.
- */
-
-import type { ExtensionCommandContext } from "@gsd/pi-coding-agent";
-
-import { existsSync, readFileSync } from "node:fs";
-import { saveFile } from "./files.js";
-import {
-  getGlobalGSDPreferencesPath,
-  loadEffectiveGSDPreferences,
-  loadGlobalGSDPreferences,
-} from "./preferences.js";
-import { ensurePreferencesFile, serializePreferencesToFrontmatter } from "./commands-prefs-wizard.js";
-
-// ─── Types ───────────────────────────────────────────────────────────────────
-
-export type ServiceTierSetting = "priority" | "flex" | undefined;
-
-const SERVICE_TIER_SCOPE_NOTE = "Only affects gpt-5.4 models, regardless of provider.";
-
-// ─── Gating ──────────────────────────────────────────────────────────────────
-
-/**
- * Model ID prefixes (bare, without provider) that support OpenAI service tiers.
- *
- * This list is the fallback for callers that only have a model ID string.
- * The authoritative source of truth is `model.capabilities.supportsServiceTier`
- * (set via CAPABILITY_PATCHES in packages/pi-ai/src/models.ts). When callers
- * have access to the full Model object, prefer reading capabilities directly.
- *
- * See: https://github.com/gsd-build/gsd-2/issues/2546
- */
-const SERVICE_TIER_MODEL_PREFIXES = ["gpt-5.4"] as const;
-
-/**
- * Returns true when the given model ID supports OpenAI service tiers.
- * Reads from SERVICE_TIER_MODEL_PREFIXES — update that list, not this function.
- */
-export function supportsServiceTier(modelId: string): boolean {
-  if (!modelId) return false;
-  // Strip provider prefix if present (e.g. "openai/gpt-5.4" → "gpt-5.4")
-  const bare = modelId.includes("/") ? modelId.split("/").pop()! : modelId;
-  return SERVICE_TIER_MODEL_PREFIXES.some((prefix) => bare.startsWith(prefix));
-}
-
-// ─── Status Formatting ───────────────────────────────────────────────────────
-
-/**
- * Human-readable description of the current service tier setting.
- */
-export function formatServiceTierStatus(tier: ServiceTierSetting): string {
-  if (!tier) {
-    return [
-      "Service tier: disabled",
-      "",
-      "Usage:",
-      "  /gsd fast on     Set to priority (2x cost, faster)",
-      "  /gsd fast flex   Set to flex (0.5x cost, slower)",
-      "  /gsd fast off    Disable service tier",
-      "",
-      SERVICE_TIER_SCOPE_NOTE,
-    ].join("\n");
-  }
-
-  const label = tier === "priority" ? "priority (2x cost, faster)" : "flex (0.5x cost, slower)";
-  return [
-    `Service tier: ${label}`,
-    "",
-    "Usage:",
-    "  /gsd fast on     Set to priority (2x cost, faster)",
-    "  /gsd fast flex   Set to flex (0.5x cost, slower)",
-    "  /gsd fast off    Disable service tier",
-    "",
-    SERVICE_TIER_SCOPE_NOTE,
-  ].join("\n");
-}
-
-export function formatServiceTierFooterStatus(
-  tier: ServiceTierSetting,
-  modelId: string | undefined,
-): string | undefined {
-  if (!tier || !modelId || !supportsServiceTier(modelId)) return undefined;
-  return tier === "priority" ? "fast: ⚡ priority" : "fast: 💰 flex";
-}
-
-// ─── Icon Resolution ─────────────────────────────────────────────────────────
-
-/**
- * Returns the appropriate icon for the active service tier and model.
- * Returns empty string when the tier is inactive or the model doesn't
- * support service tiers.
- */
-export function resolveServiceTierIcon(tier: ServiceTierSetting, modelId: string): string {
-  if (!tier || !supportsServiceTier(modelId)) return "";
-  return tier === "priority" ? "⚡" : "💰";
-}
-
-// ─── Preference Read ─────────────────────────────────────────────────────────
-
-/**
- * Read the effective service_tier setting from preferences.
- */
-export function getEffectiveServiceTier(): ServiceTierSetting {
-  const prefs = loadEffectiveGSDPreferences()?.preferences;
-  const raw = prefs?.service_tier;
-  if (raw === "priority" || raw === "flex") return raw;
-  return undefined;
-}
-
-// ─── Preference Write ────────────────────────────────────────────────────────
-
-function extractBodyAfterFrontmatter(content: string): string | null {
-  const start = content.startsWith("---\n") ? 4 : content.startsWith("---\r\n") ? 5 : -1;
-  if (start === -1) return null;
-  const closingIdx = content.indexOf("\n---", start);
-  if (closingIdx === -1) return null;
-  const after = content.slice(closingIdx + 4);
-  return after.trim() ? after : null;
-}
-
-async function writeGlobalServiceTier(
-  ctx: ExtensionCommandContext,
-  tier: ServiceTierSetting,
-): Promise<void> {
-  const path = getGlobalGSDPreferencesPath();
-  await ensurePreferencesFile(path, ctx, "global");
-
-  const existing = loadGlobalGSDPreferences();
-  const prefs: Record<string, unknown> = existing?.preferences ? { ...existing.preferences } : {};
-  prefs.version = prefs.version || 1;
-
-  if (tier) {
-    prefs.service_tier = tier;
-  } else {
-    delete prefs.service_tier;
-  }
-
-  const frontmatter = serializePreferencesToFrontmatter(prefs);
-  let body = "\n# GSD Skill Preferences\n\nSee `~/.gsd/agent/extensions/gsd/docs/preferences-reference.md` for full field documentation and examples.\n";
-  if (existsSync(path)) {
-    const preserved = extractBodyAfterFrontmatter(readFileSync(path, "utf-8"));
-    if (preserved) body = preserved;
-  }
-
-  await saveFile(path, `---\n${frontmatter}---${body}`);
-  await ctx.waitForIdle();
-  await ctx.reload();
-}
-
-// ─── Command Handler ─────────────────────────────────────────────────────────
-
-/**
- * Handle `/gsd fast [on|off|flex|status]`.
- */
-export async function handleFast(args: string, ctx: ExtensionCommandContext): Promise<void> {
-  const trimmed = args.trim().toLowerCase();
-
-  if (!trimmed || trimmed === "status") {
-    const tier = getEffectiveServiceTier();
-    ctx.ui.notify(formatServiceTierStatus(tier), "info");
-    return;
-  }
-
-  if (trimmed === "on") {
-    await writeGlobalServiceTier(ctx, "priority");
-    ctx.ui.setStatus("gsd-fast", formatServiceTierFooterStatus("priority", ctx.model?.id));
-    ctx.ui.notify("Service tier set to priority (2x cost, faster responses). Only affects gpt-5.4 models, regardless of provider.", "info");
-    return;
-  }
-
-  if (trimmed === "off") {
-    await writeGlobalServiceTier(ctx, undefined);
-    ctx.ui.setStatus("gsd-fast", undefined);
-    ctx.ui.notify("Service tier disabled.", "info");
-    return;
-  }
-
-  if (trimmed === "flex") {
-    await writeGlobalServiceTier(ctx, "flex");
-    ctx.ui.setStatus("gsd-fast", formatServiceTierFooterStatus("flex", ctx.model?.id));
-    ctx.ui.notify("Service tier set to flex (0.5x cost, slower responses). Only affects gpt-5.4 models, regardless of provider.", "info");
-    return;
-  }
-
-  ctx.ui.notify(
-    "Usage: /gsd fast [on|off|flex|status]\n\n  on    Priority tier (2x cost, faster)\n  off   Disable service tier\n  flex  Flex tier (0.5x cost, slower)\n  status Show current setting",
-    "warning",
-  );
-}