@vladimirven/openswe 0.1.0

package/src/components/types.ts

@@ -0,0 +1,215 @@
+/**
+ * Component type definitions for OpenSWE TUI
+ */
+
+import type { Session, Phase, Status, ProjectState } from "../store"
+import type { GlobalConfig, AIBackend } from "../config"
+import type { ProviderBranding } from "../providers"
+import type { SessionManager } from "../core/session"
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+/** Status icons for session display */
+export const STATUS_ICONS: Record<Status, string> = {
+  active: "●",
+  queued: "○",
+  needs_attention: "!",
+  completed: "✓",
+  paused: "P",
+  failed: "✗",
+}
+
+/** Ordered list of phases for progress calculation */
+export const PHASE_ORDER: readonly Phase[] = [
+  "pending",
+  "planning",
+  "working",
+  "completed",
+  "failed",
+]
+
+/** Human-readable phase display names */
+export const PHASE_DISPLAY_NAMES: Record<Phase, string> = {
+  pending: "Pending",
+  planning: "Planning",
+  working: "Building",
+  completed: "Done",
+  failed: "Failed",
+}
+
+// ============================================================================
+// Modal Types
+// ============================================================================
+
+/** Active modal state */
+export type ModalType = "none" | "tasks" | "issues" | "help" | "confirm-delete" | "manual" | "provider" | "theme"
+
+// ============================================================================
+// Component Props
+// ============================================================================
+
+/** Props for the root App component */
+export interface AppProps {
+  config: GlobalConfig
+  projectRoot: string
+}
+
+/** Props for the session list component */
+export interface SessionListProps {
+  sessions: Session[]
+  selectedIndex: number
+  onSelect: (index: number) => void
+  listWidth: number
+}
+
+/** Props for individual session cards */
+export interface SessionCardProps {
+  session: Session
+  isSelected: boolean
+  availableWidth: number
+}
+
+/** Props for the preview pane */
+export interface PreviewProps {
+  session: Session | null
+  startedAt?: Date
+  snapshotLines?: string[]
+  providerBranding?: ProviderBranding
+}
+
+/** Props for the status bar */
+export interface StatusBarProps {
+  variant: "header" | "footer"
+  // Header variant props
+  repoName?: string
+  taskCount?: number
+  backend?: string
+  sessionId?: string
+  providerBranding?: ProviderBranding
+  // Footer variant props (keybinding hints)
+}
+
+/** Props for phase progress indicator */
+export interface PhaseProgressProps {
+  phase: Phase
+  variant: "inline" | "full"
+}
+
+/** Props for HelpModal component */
+export interface HelpModalProps {
+  onClose: () => void
+}
+
+/** Props for ConfirmDialog component */
+export interface ConfirmDialogProps {
+  title: string
+  message: string
+  onConfirm: () => void
+  onCancel: () => void
+}
+
+/** Props for IssueSelectorModal component */
+export interface IssueSelectorModalProps {
+  /** Repository in "owner/repo" format */
+  ownerRepo: string
+  /** Absolute path to the project root */
+  projectRoot: string
+  /** Current AI backend */
+  currentBackend: AIBackend
+  /** Callback when modal is closed */
+  onClose: () => void
+  /** Callback when sessions are created - receives created sessions for auto-start */
+  onSessionsCreated: (sessions: Session[]) => void
+}
+
+/** Props for ManualSessionModal component */
+export interface ManualSessionModalProps {
+  /** Absolute path to the project root */
+  projectRoot: string
+  /** Current AI backend */
+  currentBackend: AIBackend
+  /** Session manager for starting the session */
+  sessionManager: SessionManager
+  /** Callback when modal is closed */
+  onClose: () => void
+  /** Callback when sessions are created (for refreshing the list) */
+  onSessionCreated: () => void
+}
+
+/** Props for TaskQueueModal component */
+export interface TaskQueueModalProps {
+  /** Callback when modal is closed */
+  onClose: () => void
+  /** Callback when user selects a task to jump to its session */
+  onJumpToSession: (sessionId: string) => void
+}
+
+/** Props for ProviderSwitcherModal component */
+export interface ProviderSwitcherModalProps {
+  /** Current AI backend */
+  currentBackend: AIBackend
+  /** Callback when a provider is selected */
+  onSelect: (backend: AIBackend) => void
+  /** Callback when modal is closed */
+  onClose: () => void
+}
+
+/** Props for ThemeSwitcherModal component */
+export interface ThemeSwitcherModalProps {
+  /** Current active theme name */
+  currentTheme: string
+  /** Callback when a theme is selected */
+  onSelect: (themeName: string) => void
+  /** Callback when modal is closed */
+  onClose: () => void
+}
+
+/** Pending action for confirmation dialogs */
+export interface PendingAction {
+  type: "delete"
+  sessionId: string
+  sessionName: string
+}
+
+// ============================================================================
+// Derived Types
+// ============================================================================
+
+/** Project info for header display */
+export interface ProjectInfo {
+  repoFullName: string
+  repoUrl: string
+}
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+/**
+ * Get the progress percentage for a given phase
+ * Returns 0-100 based on phase position in workflow
+ */
+export function getPhaseProgress(phase: Phase): number {
+  const index = PHASE_ORDER.indexOf(phase)
+  if (index === -1) return 0
+  // failed and completed are at the end, treat them as 100%
+  if (phase === "completed" || phase === "failed") return 100
+  // Calculate progress (excluding completed/failed which are terminal states)
+  const progressPhases = PHASE_ORDER.slice(0, -2)
+  const progressIndex = progressPhases.indexOf(phase)
+  if (progressIndex === -1) return 100
+  return Math.round((progressIndex / (progressPhases.length - 1)) * 100)
+}
+
+/**
+ * Generate a progress bar string
+ * @param progress - Progress percentage (0-100)
+ * @param width - Total width of the progress bar
+ */
+export function generateProgressBar(progress: number, width: number = 10): string {
+  const filled = Math.round((progress / 100) * width)
+  const empty = width - filled
+  return "█".repeat(filled) + "░".repeat(empty)
+}

package/src/config/defaults.ts

@@ -0,0 +1,44 @@
+/**
+ * Default configuration values for OpenSWE
+ */
+
+import type { GlobalConfig } from "./types"
+
+/**
+ * Default global configuration
+ * Used as the base when no config file exists or for missing values
+ */
+export const DEFAULT_CONFIG: GlobalConfig = {
+  ai: {
+    backend: "opencode",
+    opencode: {
+      model: "claude-sonnet",
+      provider: "anthropic",
+    },
+    claude: {
+      model: "claude-sonnet-4-20250514",
+    },
+  },
+
+  keybindings: {
+    navigateUp: "k",
+    navigateDown: "j",
+    select: "Enter",
+    newSession: "n",
+    deleteSession: "d",
+    pauseSession: "p",
+    taskQueue: "t",
+    issues: "i",
+    quit: "q",
+    help: "?",
+  },
+
+  advanced: {
+    logLevel: "info",
+  },
+
+  ui: {
+    theme: "tokyonight",
+    themeMode: "dark",
+  },
+}

package/src/config/env.ts

@@ -0,0 +1,67 @@
+/**
+ * Environment variable configuration loader
+ *
+ * Parses OPENSWE_* environment variables into a partial config.
+ * Uses lenient validation - warns and skips invalid values.
+ */
+
+import type { PartialConfig } from "./types"
+import { isValidBackend, isValidLogLevel } from "./types"
+
+/**
+ * Parse a string to boolean
+ * Accepts: "true", "1", "yes" as true; "false", "0", "no" as false
+ */
+function parseBoolean(val: string): boolean | undefined {
+  const lower = val.toLowerCase().trim()
+  if (["true", "1", "yes"].includes(lower)) return true
+  if (["false", "0", "no"].includes(lower)) return false
+  return undefined
+}
+
+/**
+ * Log a warning for invalid environment variable values
+ * Uses console.warn directly to avoid circular dependency with logger
+ */
+function warnInvalidEnv(varName: string, value: string, expected: string): void {
+  console.warn(
+    `[OpenSWE] Invalid value for ${varName}="${value}". Expected ${expected}. Using default.`
+  )
+}
+
+/**
+ * Load configuration from environment variables
+ *
+ * Supported variables:
+ * - OPENSWE_BACKEND: "opencode" | "claude"
+ * - OPENSWE_LOG_LEVEL: "debug" | "info" | "warn" | "error"
+ */
+export function loadEnvConfig(): PartialConfig {
+  const config: PartialConfig = {}
+
+  // AI Backend
+  const backend = process.env.OPENSWE_BACKEND
+  if (backend !== undefined) {
+    if (isValidBackend(backend)) {
+      config.ai = { backend }
+    } else {
+      warnInvalidEnv("OPENSWE_BACKEND", backend, '"opencode" or "claude"')
+    }
+  }
+
+  // Log Level
+  const logLevel = process.env.OPENSWE_LOG_LEVEL
+  if (logLevel !== undefined) {
+    if (isValidLogLevel(logLevel)) {
+      config.advanced = { logLevel }
+    } else {
+      warnInvalidEnv(
+        "OPENSWE_LOG_LEVEL",
+        logLevel,
+        '"debug", "info", "warn", or "error"'
+      )
+    }
+  }
+
+  return config
+}

package/src/config/global.ts

@@ -0,0 +1,252 @@
+/**
+ * Global configuration file loader and saver
+ *
+ * Handles loading and saving TOML config files with XDG support.
+ * Location: $XDG_CONFIG_HOME/openswe/config.toml or ~/.config/openswe/config.toml
+ */
+
+import { parse as parseToml, stringify as stringifyToml, type JsonMap } from "@iarna/toml"
+import { homedir } from "os"
+import { join } from "path"
+import { mkdir } from "fs/promises"
+import type { PartialConfig } from "./types"
+import { isValidBackend, isValidLogLevel, isBoolean, isNonEmptyString } from "./types"
+
+// ============================================================================
+// Path Utilities
+// ============================================================================
+
+/**
+ * Get the configuration directory path (XDG-compliant)
+ */
+export function getConfigDir(): string {
+  const xdgConfig = process.env.XDG_CONFIG_HOME
+  if (xdgConfig) {
+    return join(xdgConfig, "openswe")
+  }
+  return join(homedir(), ".config", "openswe")
+}
+
+/**
+ * Get the full path to the config file
+ */
+export function getConfigPath(): string {
+  return join(getConfigDir(), "config.toml")
+}
+
+/**
+ * Check if the config file exists
+ */
+export async function configFileExists(): Promise<boolean> {
+  const file = Bun.file(getConfigPath())
+  return file.exists()
+}
+
+// ============================================================================
+// Key Transformation (snake_case <-> camelCase)
+// ============================================================================
+
+/** Map of camelCase keys to snake_case TOML keys */
+const CAMEL_TO_SNAKE: Record<string, string> = {
+  navigateUp: "navigate_up",
+  navigateDown: "navigate_down",
+  newSession: "new_session",
+  deleteSession: "delete_session",
+  pauseSession: "pause_session",
+  taskQueue: "task_queue",
+  logLevel: "log_level",
+}
+
+/** Map of snake_case TOML keys to camelCase keys */
+const SNAKE_TO_CAMEL: Record<string, string> = Object.fromEntries(
+  Object.entries(CAMEL_TO_SNAKE).map(([k, v]) => [v, k])
+)
+
+/**
+ * Convert a snake_case key to camelCase
+ */
+function snakeToCamel(key: string): string {
+  return SNAKE_TO_CAMEL[key] ?? key
+}
+
+/**
+ * Convert a camelCase key to snake_case
+ */
+function camelToSnake(key: string): string {
+  return CAMEL_TO_SNAKE[key] ?? key
+}
+
+/**
+ * Recursively transform object keys from snake_case to camelCase
+ */
+function transformKeysSnakeToCamel(obj: unknown): unknown {
+  if (obj === null || obj === undefined) return obj
+  if (Array.isArray(obj)) return obj.map(transformKeysSnakeToCamel)
+  if (typeof obj !== "object") return obj
+
+  const result: Record<string, unknown> = {}
+  for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {
+    const camelKey = snakeToCamel(key)
+    result[camelKey] = transformKeysSnakeToCamel(value)
+  }
+  return result
+}
+
+/**
+ * Recursively transform object keys from camelCase to snake_case
+ */
+function transformKeysCamelToSnake(obj: unknown): unknown {
+  if (obj === null || obj === undefined) return obj
+  if (Array.isArray(obj)) return obj.map(transformKeysCamelToSnake)
+  if (typeof obj !== "object") return obj
+
+  const result: Record<string, unknown> = {}
+  for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {
+    const snakeKey = camelToSnake(key)
+    result[snakeKey] = transformKeysCamelToSnake(value)
+  }
+  return result
+}
+
+// ============================================================================
+// Validation
+// ============================================================================
+
+/**
+ * Validate and sanitize parsed TOML config
+ * Returns a partial config with only valid values
+ */
+function validateParsedConfig(parsed: unknown): PartialConfig {
+  if (typeof parsed !== "object" || parsed === null) {
+    return {}
+  }
+
+  const raw = parsed as Record<string, unknown>
+  const config: PartialConfig = {}
+
+  // Validate ai section
+  if (raw.ai && typeof raw.ai === "object") {
+    const ai = raw.ai as Record<string, unknown>
+    config.ai = {}
+
+    if (isValidBackend(ai.backend)) {
+      config.ai.backend = ai.backend
+    } else if (ai.backend !== undefined) {
+      warnInvalidConfig("ai.backend", ai.backend, '"opencode" or "claude"')
+    }
+
+    if (ai.opencode && typeof ai.opencode === "object") {
+      const oc = ai.opencode as Record<string, unknown>
+      config.ai.opencode = {}
+      if (isNonEmptyString(oc.model)) config.ai.opencode.model = oc.model
+      if (isNonEmptyString(oc.provider)) config.ai.opencode.provider = oc.provider
+    }
+
+    if (ai.claude && typeof ai.claude === "object") {
+      const cl = ai.claude as Record<string, unknown>
+      config.ai.claude = {}
+      if (isNonEmptyString(cl.model)) config.ai.claude.model = cl.model
+    }
+  }
+
+  // Validate keybindings section
+  if (raw.keybindings && typeof raw.keybindings === "object") {
+    const kb = raw.keybindings as Record<string, unknown>
+    config.keybindings = {}
+
+    const keyFields = [
+      "navigateUp", "navigateDown", "select", "newSession",
+      "deleteSession", "pauseSession", "taskQueue", "issues", "quit", "help"
+    ] as const
+
+    for (const field of keyFields) {
+      if (isNonEmptyString(kb[field])) {
+        (config.keybindings as Record<string, string>)[field] = kb[field] as string
+      }
+    }
+  }
+
+  // Validate advanced section
+  if (raw.advanced && typeof raw.advanced === "object") {
+    const adv = raw.advanced as Record<string, unknown>
+    config.advanced = {}
+
+    if (isValidLogLevel(adv.logLevel)) {
+      config.advanced.logLevel = adv.logLevel
+    } else if (adv.logLevel !== undefined) {
+      warnInvalidConfig("advanced.logLevel", adv.logLevel, '"debug", "info", "warn", or "error"')
+    }
+  }
+
+  return config
+}
+
+/**
+ * Log a warning for invalid config file values
+ */
+function warnInvalidConfig(path: string, value: unknown, expected: string): void {
+  console.warn(
+    `[OpenSWE] Invalid config value at "${path}": ${JSON.stringify(value)}. Expected ${expected}. Using default.`
+  )
+}
+
+// ============================================================================
+// Load and Save Functions
+// ============================================================================
+
+/**
+ * Load global configuration from TOML file
+ * Returns empty partial config if file doesn't exist or has errors
+ */
+export async function loadGlobalConfig(): Promise<PartialConfig> {
+  const configPath = getConfigPath()
+
+  try {
+    const file = Bun.file(configPath)
+    if (!(await file.exists())) {
+      return {} // No config file yet - use defaults
+    }
+
+    const content = await file.text()
+    const parsed = parseToml(content)
+
+    // Transform snake_case keys to camelCase
+    const transformed = transformKeysSnakeToCamel(parsed)
+
+    // Validate and return
+    return validateParsedConfig(transformed)
+  } catch (err) {
+    if (err instanceof Error) {
+      console.warn(`[OpenSWE] Failed to load config from ${configPath}: ${err.message}`)
+    } else {
+      console.warn(`[OpenSWE] Failed to load config from ${configPath}`)
+    }
+    return {}
+  }
+}
+
+/**
+ * Save configuration to TOML file
+ * Creates the config directory if it doesn't exist
+ */
+export async function saveGlobalConfig(config: PartialConfig): Promise<void> {
+  const configDir = getConfigDir()
+  const configPath = getConfigPath()
+
+  try {
+    // Ensure config directory exists
+    await mkdir(configDir, { recursive: true })
+
+    // Transform camelCase keys to snake_case for TOML
+    const transformed = transformKeysCamelToSnake(config) as Record<string, unknown>
+
+    // Stringify and write
+    const tomlContent = stringifyToml(transformed as JsonMap)
+    await Bun.write(configPath, tomlContent)
+  } catch (err) {
+    if (err instanceof Error) {
+      throw new Error(`Failed to save config to ${configPath}: ${err.message}`)
+    }
+    throw new Error(`Failed to save config to ${configPath}`)
+  }
+}