@butlerw/vellum 0.1.0

package/src/commands/mode.ts

@@ -0,0 +1,331 @@
+/**
+ * Mode Slash Commands (T041)
+ *
+ * Provides slash commands for coding mode management:
+ * - /mode - Show current mode and options
+ * - /vibe - Switch to vibe mode
+ * - /plan - Switch to plan mode
+ * - /spec - Switch to spec mode (with confirmation)
+ *
+ * @module cli/commands/mode
+ */
+
+import {
+  BUILTIN_CODING_MODES,
+  CODING_MODES,
+  type CodingMode,
+  type ModeManager,
+} from "@vellum/core";
+import { getModeIcon } from "../utils/icons.js";
+import type { CommandContext, CommandResult, SlashCommand } from "./types.js";
+import { error, interactive, success } from "./types.js";
+
+// =============================================================================
+// Module State
+// =============================================================================
+
+/**
+ * Reference to the active ModeManager instance.
+ * Set by the App component when initialized.
+ */
+let modeManager: ModeManager | null = null;
+
+/**
+ * Set the ModeManager instance for mode commands.
+ * Called by the App component during initialization.
+ *
+ * @param manager - The ModeManager instance to use
+ */
+export function setModeCommandsManager(manager: ModeManager | null): void {
+  modeManager = manager;
+}
+
+/**
+ * Get the current ModeManager instance.
+ * Returns null if not yet initialized.
+ */
+export function getModeCommandsManager(): ModeManager | null {
+  return modeManager;
+}
+
+// =============================================================================
+// Mode Description Helpers
+// =============================================================================
+
+/**
+ * Get a human-readable description for a coding mode.
+ */
+function getModeDescription(mode: CodingMode): string {
+  const config = BUILTIN_CODING_MODES[mode];
+  return config?.description ?? mode;
+}
+
+/**
+ * Get text-based icon indicator for a coding mode.
+ */
+function getModeIndicator(mode: CodingMode): string {
+  return getModeIcon(mode);
+}
+
+/**
+ * Format mode information for display.
+ */
+function formatModeInfo(mode: CodingMode, isCurrent: boolean): string {
+  const icon = getModeIndicator(mode);
+  const desc = getModeDescription(mode);
+  const marker = isCurrent ? " (current)" : "";
+  return `  ${icon} ${mode}${marker} - ${desc}`;
+}
+
+// =============================================================================
+// /mode Command - Show Current Mode and Options
+// =============================================================================
+
+/**
+ * /mode command - Display current mode and available options.
+ *
+ * Shows the current coding mode and lists all available modes
+ * with their descriptions. Without a ModeManager, shows a
+ * placeholder indicating the mode system is not initialized.
+ */
+export const modeCommand: SlashCommand = {
+  name: "mode",
+  description: "Show current coding mode and options",
+  kind: "builtin",
+  category: "workflow",
+  aliases: ["modes"],
+  positionalArgs: [
+    {
+      name: "mode",
+      type: "string",
+      description: "Mode to switch to (vibe, plan, spec)",
+      required: false,
+    },
+  ],
+  examples: [
+    "/mode        - Show current mode and options",
+    "/mode vibe   - Switch to vibe mode",
+    "/mode plan   - Switch to plan mode",
+    "/mode spec   - Switch to spec mode",
+  ],
+  subcommands: [
+    { name: "vibe", description: "Quick autonomous mode" },
+    { name: "plan", description: "Plan before execute mode" },
+    { name: "spec", description: "Full specification workflow" },
+  ],
+
+  execute: async (ctx: CommandContext): Promise<CommandResult> => {
+    const requestedMode = ctx.parsedArgs.positional[0] as string | undefined;
+
+    // If a mode is specified, delegate to switch logic
+    if (requestedMode) {
+      return switchToMode(requestedMode, ctx);
+    }
+
+    // Show current mode and options
+    if (!modeManager) {
+      // No manager available - show static info
+      const lines = [
+        "Coding Modes",
+        "",
+        "Available modes:",
+        ...CODING_MODES.map((m) => formatModeInfo(m, m === "vibe")),
+        "",
+        "Mode system not yet initialized. Using default: vibe",
+        "",
+        "Use /vibe, /plan, or /spec to switch modes.",
+      ];
+      return success(lines.join("\n"));
+    }
+
+    const currentMode = modeManager.getCurrentMode();
+    const lines = [
+      "Coding Modes",
+      "",
+      `Current mode: ${getModeIndicator(currentMode)} ${currentMode}`,
+      "",
+      "Available modes:",
+      ...CODING_MODES.map((m) => formatModeInfo(m, m === currentMode)),
+      "",
+      "Use /vibe, /plan, or /spec to switch modes.",
+    ];
+
+    return success(lines.join("\n"));
+  },
+};
+
+// =============================================================================
+// Mode Switch Helper
+// =============================================================================
+
+/**
+ * Switch to a specified mode with validation.
+ *
+ * @param mode - Mode name to switch to
+ * @param ctx - Command context
+ * @returns Command result
+ */
+async function switchToMode(mode: string, _ctx: CommandContext): Promise<CommandResult> {
+  // Validate mode name
+  if (!CODING_MODES.includes(mode as CodingMode)) {
+    return error("INVALID_ARGUMENT", `Invalid mode: ${mode}`, [
+      `Valid modes: ${CODING_MODES.join(", ")}`,
+    ]);
+  }
+
+  const targetMode = mode as CodingMode;
+
+  // If no manager, return a message about it
+  if (!modeManager) {
+    return success(
+      `Mode system not initialized. Would switch to ${getModeIndicator(targetMode)} ${targetMode}.`
+    );
+  }
+
+  // Check if already in this mode
+  const currentMode = modeManager.getCurrentMode();
+  if (currentMode === targetMode) {
+    return success(`Already in ${getModeIndicator(targetMode)} ${targetMode} mode.`);
+  }
+
+  // Spec mode requires confirmation
+  if (targetMode === "spec") {
+    return interactive({
+      inputType: "confirm",
+      message: `[WARN] Switch to spec mode? This enables a 6-phase structured workflow.`,
+      defaultValue: "n",
+      handler: async (value: string): Promise<CommandResult> => {
+        const confirmed = value.toLowerCase() === "y" || value.toLowerCase() === "yes";
+        if (confirmed) {
+          return await executeSwitch(targetMode);
+        }
+        return success("Mode switch cancelled.");
+      },
+      onCancel: () => success("Mode switch cancelled."),
+    });
+  }
+
+  // Direct switch for vibe and plan modes
+  return await executeSwitch(targetMode);
+}
+
+/**
+ * Execute the actual mode switch via ModeManager.
+ *
+ * @param targetMode - Mode to switch to
+ * @returns Command result
+ */
+async function executeSwitch(targetMode: CodingMode): Promise<CommandResult> {
+  if (!modeManager) {
+    return error("OPERATION_NOT_ALLOWED", "Mode system not initialized", []);
+  }
+
+  const result = await modeManager.switchMode(targetMode, {
+    skipConfirmation: targetMode === "spec",
+  });
+
+  if (result.success) {
+    const icon = getModeIndicator(targetMode);
+    return success(`${icon} Switched to ${targetMode} mode.`, {
+      previousMode: result.previousMode,
+      currentMode: result.currentMode,
+    });
+  }
+
+  return error(
+    "OPERATION_NOT_ALLOWED",
+    `Cannot switch to ${targetMode}: ${result.reason ?? "Unknown error"}`,
+    []
+  );
+}
+
+// =============================================================================
+// /vibe Command - Switch to Vibe Mode
+// =============================================================================
+
+/**
+ * /vibe command - Switch to vibe (fast autonomous) mode.
+ *
+ * Vibe mode enables fast, autonomous coding with full tool access.
+ * No checkpoints or confirmations required - the AI executes
+ * tasks directly.
+ */
+export const vibeCommand: SlashCommand = {
+  name: "vibe",
+  description: "Switch to vibe mode (fast autonomous coding)",
+  kind: "builtin",
+  category: "workflow",
+  aliases: [],
+  examples: ["/vibe - Switch to fast autonomous mode"],
+
+  execute: async (ctx: CommandContext): Promise<CommandResult> => {
+    return switchToMode("vibe", ctx);
+  },
+};
+
+// =============================================================================
+// /plan Command - Switch to Plan Mode
+// =============================================================================
+
+/**
+ * /plan command - Switch to plan mode.
+ *
+ * Plan mode requires the AI to create a plan before execution.
+ * One checkpoint for plan approval, then execution proceeds.
+ */
+export const planCommand: SlashCommand = {
+  name: "plan",
+  description: "Switch to plan mode (plan-then-execute)",
+  kind: "builtin",
+  category: "workflow",
+  aliases: [],
+  examples: ["/plan - Switch to plan-then-execute mode"],
+
+  execute: async (ctx: CommandContext): Promise<CommandResult> => {
+    return switchToMode("plan", ctx);
+  },
+};
+
+// =============================================================================
+// /spec Command - Switch to Spec Mode
+// =============================================================================
+
+/**
+ * /spec command - Switch to spec mode.
+ *
+ * Spec mode enables a 6-phase structured workflow:
+ * 1. Research
+ * 2. Requirements
+ * 3. Design
+ * 4. Tasks
+ * 5. Implementation
+ * 6. Validation
+ *
+ * Requires confirmation before switching due to its structured nature.
+ */
+export const specCommand: SlashCommand = {
+  name: "spec",
+  description: "Switch to spec mode (6-phase structured workflow)",
+  kind: "builtin",
+  category: "workflow",
+  aliases: [],
+  examples: ["/spec - Switch to 6-phase structured workflow"],
+
+  execute: async (ctx: CommandContext): Promise<CommandResult> => {
+    return switchToMode("spec", ctx);
+  },
+};
+
+// =============================================================================
+// Export All Mode Commands
+// =============================================================================
+
+/**
+ * All mode-related slash commands for registration.
+ */
+export const modeSlashCommands: SlashCommand[] = [
+  modeCommand,
+  vibeCommand,
+  planCommand,
+  specCommand,
+];

package/src/commands/model.ts

@@ -0,0 +1,298 @@
+/**
+ * Model Slash Command (Chain 22)
+ *
+ * Provides slash commands for AI model management:
+ * - /model - Show current model and options
+ * - /model <provider>/<model> - Switch to a specific model
+ *
+ * @module cli/commands/model
+ */
+
+import {
+  getModelInfo,
+  getProviderModels,
+  getSupportedProviders,
+  type ModelInfo,
+} from "@vellum/provider";
+import type { CommandContext, CommandResult, SlashCommand } from "./types.js";
+import { error, success } from "./types.js";
+
+// =============================================================================
+// Module State
+// =============================================================================
+
+/**
+ * Current model configuration.
+ * Set by the App component when initialized.
+ */
+interface ModelConfig {
+  provider: string;
+  model: string;
+}
+
+let currentConfig: ModelConfig | null = null;
+
+/**
+ * Callback to update model selection.
+ */
+let onModelChange: ((provider: string, model: string) => void) | null = null;
+
+/**
+ * Set the current model configuration.
+ *
+ * @param provider - Current provider
+ * @param model - Current model ID
+ * @param onChange - Callback when model changes
+ */
+export function setModelCommandConfig(
+  provider: string,
+  model: string,
+  onChange?: (provider: string, model: string) => void
+): void {
+  currentConfig = { provider, model };
+  onModelChange = onChange ?? null;
+}
+
+/**
+ * Get the current model configuration.
+ */
+export function getModelCommandConfig(): ModelConfig | null {
+  return currentConfig;
+}
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Format context window for display.
+ */
+function formatContextWindow(tokens: number): string {
+  if (tokens >= 1_000_000) {
+    return `${(tokens / 1_000_000).toFixed(1)}M`;
+  }
+  if (tokens >= 1_000) {
+    return `${(tokens / 1_000).toFixed(0)}K`;
+  }
+  return `${tokens}`;
+}
+
+/**
+ * Format price for display.
+ */
+function formatPrice(pricePer1M: number): string {
+  if (pricePer1M === 0) {
+    return "Free";
+  }
+  return `$${pricePer1M.toFixed(2)}/M`;
+}
+
+/**
+ * Format model info for display.
+ */
+function formatModelInfo(_provider: string, model: ModelInfo, isCurrent: boolean): string {
+  const marker = isCurrent ? " (current)" : "";
+  const ctx = formatContextWindow(model.contextWindow);
+  const priceIn = formatPrice(model.inputPrice ?? 0);
+  const priceOut = formatPrice(model.outputPrice ?? 0);
+  return `    ${model.name}${marker} [${ctx} ctx, ${priceIn}/${priceOut}]`;
+}
+
+// =============================================================================
+// /model Command
+// =============================================================================
+
+/**
+ * /model command - Display current model and available options.
+ *
+ * Usage:
+ * - /model - Show current model and list all available models
+ * - /model <provider>/<model> - Switch to a specific model
+ */
+export const modelCommand: SlashCommand = {
+  name: "model",
+  description: "Show or change the current AI model",
+  kind: "builtin",
+  category: "system",
+  aliases: ["models"],
+  positionalArgs: [
+    {
+      name: "model",
+      type: "string",
+      description: "Model to switch to (format: provider/model-id)",
+      required: false,
+    },
+  ],
+  examples: [
+    "/model                         - Show current model and options",
+    "/model anthropic/claude-sonnet-4-20250514  - Switch to Claude Sonnet 4",
+    "/model openai/gpt-4o           - Switch to GPT-4o",
+  ],
+  // Dynamic subcommands: list all providers for autocomplete
+  subcommands: getSupportedProviders().map((provider) => ({
+    name: provider,
+    description: `${provider} models`,
+  })),
+
+  execute: async (ctx: CommandContext): Promise<CommandResult> => {
+    const positional = ctx.parsedArgs.positional as (string | undefined)[];
+
+    let requestedModel: string | undefined;
+
+    if (positional[0] && positional[1]) {
+      // Two args: provider and model from autocomplete flow
+      requestedModel = `${positional[0]}/${positional[1]}`;
+    } else if (positional[0]?.includes("/")) {
+      // Single arg with / separator (backwards compatible)
+      requestedModel = positional[0];
+    } else if (positional[0]) {
+      // Provider only - show available models for that provider
+      return showProviderModels(positional[0]);
+    }
+
+    if (requestedModel) {
+      return switchToModel(requestedModel);
+    }
+
+    // Show current model and options
+    return showModelInfo();
+  },
+};
+
+/**
+ * Show current model and available options.
+ */
+function showModelInfo(): CommandResult {
+  const providers = getSupportedProviders();
+  const lines: string[] = ["AI Models", ""];
+
+  // Show current model if configured
+  if (currentConfig) {
+    const info = getModelInfo(currentConfig.provider, currentConfig.model);
+    lines.push(`Current: ${currentConfig.provider}/${info.name}`);
+    lines.push(
+      `  Context: ${formatContextWindow(info.contextWindow)} | ` +
+        `Input: ${formatPrice(info.inputPrice ?? 0)} | ` +
+        `Output: ${formatPrice(info.outputPrice ?? 0)}`
+    );
+    lines.push("");
+  } else {
+    lines.push("Current: Not configured");
+    lines.push("");
+  }
+
+  lines.push("Available models:");
+  lines.push("");
+
+  // List all providers and their models
+  for (const provider of providers) {
+    const models = getProviderModels(provider);
+
+    if (models.length === 0) continue;
+
+    lines.push(`  ${provider}`);
+
+    for (const model of models) {
+      const isCurrent = currentConfig?.provider === provider && currentConfig?.model === model.id;
+      lines.push(formatModelInfo(provider, model, isCurrent));
+    }
+    lines.push("");
+  }
+
+  lines.push("Usage: /model <provider>/<model-id>");
+
+  return success(lines.join("\n"));
+}
+
+/**
+ * Show available models for a specific provider.
+ */
+function showProviderModels(provider: string): CommandResult {
+  const providers = getSupportedProviders();
+  const normalizedProvider = provider.toLowerCase();
+
+  if (!providers.includes(normalizedProvider)) {
+    return error("INVALID_ARGUMENT", `Unknown provider: ${provider}`, [
+      `Valid providers: ${providers.join(", ")}`,
+    ]);
+  }
+
+  const models = getProviderModels(normalizedProvider);
+
+  if (models.length === 0) {
+    return error("INVALID_ARGUMENT", `No models available for ${provider}`);
+  }
+
+  const lines: string[] = [`${provider} Models`, ""];
+
+  for (const model of models) {
+    const isCurrent =
+      currentConfig?.provider === normalizedProvider && currentConfig?.model === model.id;
+    lines.push(formatModelInfo(normalizedProvider, model, isCurrent));
+  }
+
+  lines.push("");
+  lines.push(`Usage: /model ${provider}/<model-id>`);
+  lines.push(`Example: /model ${provider}/${models[0]?.id ?? "model-id"}`);
+
+  return success(lines.join("\n"));
+}
+
+/**
+ * Switch to a specified model.
+ */
+function switchToModel(modelSpec: string): CommandResult {
+  // Parse provider/model format
+  const parts = modelSpec.split("/");
+  if (parts.length < 2) {
+    return error("INVALID_ARGUMENT", `Invalid model format: ${modelSpec}`, [
+      "Expected format: provider/model-id",
+      "Example: anthropic/claude-sonnet-4-20250514",
+    ]);
+  }
+
+  const [provider, ...modelParts] = parts;
+  const modelId = modelParts.join("/"); // Handle models with / in name
+
+  if (!provider || !modelId) {
+    return error("INVALID_ARGUMENT", `Invalid model format: ${modelSpec}`, [
+      "Expected format: provider/model-id",
+    ]);
+  }
+
+  // Validate provider
+  const providers = getSupportedProviders();
+  if (!providers.includes(provider.toLowerCase())) {
+    return error("INVALID_ARGUMENT", `Unknown provider: ${provider}`, [
+      `Valid providers: ${providers.join(", ")}`,
+    ]);
+  }
+
+  // Get model info (validates model exists or returns default)
+  const info = getModelInfo(provider, modelId);
+
+  // Check if already using this model
+  if (currentConfig?.provider === provider.toLowerCase() && currentConfig?.model === modelId) {
+    return success(`Already using ${info.name}`);
+  }
+
+  // Update via callback if available
+  if (onModelChange) {
+    onModelChange(provider.toLowerCase(), modelId);
+    return success(
+      `Switched to ${info.name}\n` +
+        `  Context: ${formatContextWindow(info.contextWindow)} | ` +
+        `Input: ${formatPrice(info.inputPrice ?? 0)} | ` +
+        `Output: ${formatPrice(info.outputPrice ?? 0)}`
+    );
+  }
+
+  // No callback - just report what would happen
+  return success(`Would switch to ${info.name}\n(Model system not fully initialized)`);
+}
+
+// =============================================================================
+// Exports
+// =============================================================================
+
+export default modelCommand;