@vladimirven/openswe 0.1.0

package/src/utils/format.ts

@@ -0,0 +1,46 @@
+/**
+ * Format a number of tokens for display (e.g., 2300 -> "2.3k")
+ */
+export function formatTokens(tokens: number): string {
+  if (tokens >= 1_000_000) {
+    return `${(tokens / 1_000_000).toFixed(1)}M`
+  }
+  if (tokens >= 1000) {
+    return `${(tokens / 1000).toFixed(1)}k`
+  }
+  return String(tokens)
+}
+
+/**
+ * Format a date as relative time (e.g., "3d ago", "2h ago")
+ */
+export function formatRelativeTime(date: Date): string {
+  const now = new Date()
+  const diffMs = now.getTime() - date.getTime()
+
+  if (diffMs < 0) {
+    return "in the future"
+  }
+
+  const diffSecs = Math.floor(diffMs / 1000)
+  const diffMins = Math.floor(diffSecs / 60)
+  const diffHours = Math.floor(diffMins / 60)
+  const diffDays = Math.floor(diffHours / 24)
+  const diffWeeks = Math.floor(diffDays / 7)
+  const diffMonths = Math.floor(diffDays / 30)
+
+  if (diffMonths > 0) return `${diffMonths}mo ago`
+  if (diffWeeks > 0) return `${diffWeeks}w ago`
+  if (diffDays > 0) return `${diffDays}d ago`
+  if (diffHours > 0) return `${diffHours}h ago`
+  if (diffMins > 0) return `${diffMins}m ago`
+  return "just now"
+}
+
+/**
+ * Truncate a string to a maximum length, adding ellipsis if truncated
+ */
+export function truncate(str: string, maxLength: number): string {
+  if (str.length <= maxLength) return str
+  return `${str.slice(0, maxLength - 1)}…`
+}

package/src/utils/id.ts

@@ -0,0 +1,15 @@
+import { v4 as uuidv4 } from "uuid"
+
+/**
+ * Generate a unique identifier (UUID v4)
+ */
+export function generateId(): string {
+  return uuidv4()
+}
+
+/**
+ * Generate a short ID (first 8 characters of UUID)
+ */
+export function generateShortId(): string {
+  return uuidv4().slice(0, 8)
+}

package/src/utils/logger.ts

@@ -0,0 +1,112 @@
+/**
+ * Logging utility for OpenSWE
+ */
+
+import type { LogLevel } from "../config/types"
+
+// Re-export LogLevel for convenience
+export type { LogLevel }
+
+const LOG_LEVELS: Record<LogLevel, number> = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+}
+
+// Can be overridden by config/env
+let currentLevel: LogLevel = "info"
+let logFileSink: any = null
+
+/**
+ * Set the current log level
+ */
+export function setLogLevel(level: LogLevel) {
+  currentLevel = level
+}
+
+/**
+ * Initialize file logging
+ * @param path - Absolute path to the log file
+ */
+export function initFileLogging(path: string) {
+  try {
+    const file = Bun.file(path)
+    logFileSink = file.writer()
+  } catch (error) {
+    console.error("Failed to initialize file logging:", error)
+  }
+}
+
+/**
+ * Get the current log level
+ */
+export function getLogLevel(): LogLevel {
+  return currentLevel
+}
+
+function shouldLog(level: LogLevel): boolean {
+  return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel]
+}
+
+function formatTimestamp(): string {
+  return new Date().toISOString()
+}
+
+function formatValue(value: unknown): string {
+  if (value === null) return "null"
+  if (value === undefined) return "undefined"
+  if (typeof value === "string") return value
+  if (value instanceof Error) {
+    return `${value.name}: ${value.message}${value.stack ? `\n${value.stack}` : ""}`
+  }
+  try {
+    return JSON.stringify(value, null, 2)
+  } catch {
+    return String(value)
+  }
+}
+
+function formatMessage(level: LogLevel, args: unknown[]): string {
+  const timestamp = formatTimestamp()
+  const levelStr = level.toUpperCase().padEnd(5)
+  const message = args.map(formatValue).join(" ")
+  return `[${timestamp}] [${levelStr}] ${message}`
+}
+
+function log(level: LogLevel, args: unknown[]) {
+  if (shouldLog(level)) {
+    const msg = formatMessage(level, args)
+
+    // Console output
+    switch (level) {
+      case "debug":
+        console.debug(msg)
+        break
+      case "info":
+        console.log(msg)
+        break
+      case "warn":
+        console.warn(msg)
+        break
+      case "error":
+        console.error(msg)
+        break
+    }
+
+    // File output
+    if (logFileSink) {
+      logFileSink.write(msg + "\n")
+      logFileSink.flush()
+    }
+  }
+}
+
+export const logger = {
+  debug: (...args: unknown[]) => log("debug", args),
+  info: (...args: unknown[]) => log("info", args),
+  warn: (...args: unknown[]) => log("warn", args),
+  error: (...args: unknown[]) => log("error", args),
+}
+
+export default logger

package/src/utils/prerequisites.ts

@@ -0,0 +1,118 @@
+/**
+ * Prerequisites checker for OpenSWE
+ *
+ * Verifies required tools are installed before starting the TUI.
+ */
+
+import { checkGitInstalled } from "../git"
+import { checkGhCli } from "../github"
+
+// ============================================================================
+// Types
+// ============================================================================
+
+/** Result of prerequisite checks */
+export interface PrerequisiteResult {
+  /** Whether all prerequisites are met */
+  success: boolean
+  /** List of error messages for unmet prerequisites */
+  errors: string[]
+  /** List of warning messages (non-fatal) */
+  warnings: string[]
+}
+
+// ============================================================================
+// Prerequisite Checks
+// ============================================================================
+
+/**
+ * Check all prerequisites for running OpenSWE
+ *
+ * Verifies:
+ * - Git is installed
+ * - GitHub CLI (gh) is installed and authenticated
+ *
+ * @returns Result indicating whether prerequisites are met
+ */
+export async function checkPrerequisites(): Promise<PrerequisiteResult> {
+  const errors: string[] = []
+  const warnings: string[] = []
+
+  // Check git installation
+  const gitInstalled = await checkGitInstalled()
+  if (!gitInstalled) {
+    errors.push("Git is not installed. Install it from https://git-scm.com/")
+  }
+
+  // Check gh CLI installation and authentication
+  const ghResult = await checkGhCli()
+  if (!ghResult.installed) {
+    errors.push(
+      "GitHub CLI (gh) is not installed. Install it from https://cli.github.com/"
+    )
+  } else if (!ghResult.authenticated) {
+    errors.push(
+      ghResult.error ?? "Not authenticated with GitHub. Run: gh auth login"
+    )
+  }
+
+  // Check if opencode is available (warning only, not required for all operations)
+  const opencodeAvailable = await isCommandAvailable("opencode")
+  if (!opencodeAvailable) {
+    warnings.push(
+      "opencode command not found in PATH. Sessions won't be able to start until it's installed."
+    )
+  }
+
+  return {
+    success: errors.length === 0,
+    errors,
+    warnings,
+  }
+}
+
+/**
+ * Check if a command is available in PATH
+ *
+ * @param command - Command name to check
+ * @returns True if command is available
+ */
+async function isCommandAvailable(command: string): Promise<boolean> {
+  try {
+    const proc = Bun.spawn(["which", command], {
+      stdout: "pipe",
+      stderr: "pipe",
+    })
+    const exitCode = await proc.exited
+    return exitCode === 0
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Format prerequisite errors for display
+ *
+ * @param result - Prerequisite check result
+ * @returns Formatted string for console output
+ */
+export function formatPrerequisiteErrors(result: PrerequisiteResult): string {
+  const lines: string[] = []
+
+  if (result.errors.length > 0) {
+    lines.push("Prerequisites not met:")
+    for (const error of result.errors) {
+      lines.push(`  - ${error}`)
+    }
+  }
+
+  if (result.warnings.length > 0) {
+    if (lines.length > 0) lines.push("")
+    lines.push("Warnings:")
+    for (const warning of result.warnings) {
+      lines.push(`  - ${warning}`)
+    }
+  }
+
+  return lines.join("\n")
+}

package/src/utils/shell.ts

@@ -0,0 +1,9 @@
+/**
+ * Quote a string for use in a shell command.
+ * Wraps the string in single quotes and escapes any single quotes within it.
+ * This preserves all other characters (including newlines) literally.
+ */
+export function shellQuote(s: string): string {
+  // Replace ' with '\'' (close quote, literal quote, open quote)
+  return "'" + s.replace(/'/g, "'\\''") + "'"
+}