@vladimirven/openswe 0.1.0

package/src/prompts/index.ts

@@ -0,0 +1 @@
+export { generateSWEPrompt } from "./swe-system"

package/src/prompts/swe-system.ts

@@ -0,0 +1,22 @@
+/**
+ * SWE system prompt generator
+ *
+ * Creates the system prompt used to guide AI coding sessions.
+ */
+
+import type { Session } from "../store"
+
+/**
+ * Generate the SWE system prompt for a session
+ */
+export function generateSWEPrompt(session: Session): string {
+  const taskSection = session.issueNumber
+    ? `Title: Issue #${session.issueNumber}: "${session.issueTitle ?? ""}"
+${session.issueBody ?? ""}`
+    : `Task: ${session.name}`
+
+  return `Investigate and create a plan to implement this feature:
+
+${taskSection}
+`
+}

package/src/providers/claude.ts

@@ -0,0 +1,103 @@
+/**
+ * Claude Code provider implementation
+ *
+ * Supports the Claude CLI (https://docs.anthropic.com/claude-code)
+ */
+
+import type { Provider, ProviderBranding, ParserPatterns, SpawnCommand } from "./types"
+import type { Session } from "../store"
+import type { ClaudeConfig } from "../config/types"
+
+// ============================================================================
+// Branding
+// ============================================================================
+
+const branding: ProviderBranding = {
+	displayName: "Claude Code",
+	shortName: "claude",
+	accentColor: "#cc785c",
+	secondaryColor: "#a65f48",
+	logoText: "CC",
+}
+
+// ============================================================================
+// Parser Patterns
+// ============================================================================
+
+const parserPatterns: ParserPatterns = {
+	// Claude Code outputs status messages differently
+	workingRegex: /(?:starting|begin|entering).+(?:implementation|coding|execution)|(?:mode|status):\s*(?:implement|coding)|editing|writing.*file/i,
+	doneRegex: /\[?OPENSWE:DONE\]?|completed successfully|task completed/i,
+}
+
+// ============================================================================
+// Provider Implementation
+// ============================================================================
+
+export const claudeProvider: Provider = {
+	id: "claude",
+	name: "Claude Code",
+	branding,
+	parserPatterns,
+
+	buildSpawnCommand(
+		_session: Session,
+		prompt?: string,
+		resumeSessionId?: string,
+		config?: Record<string, unknown>
+	): SpawnCommand {
+		const claudeConfig = config as ClaudeConfig | undefined
+		const model = claudeConfig?.model ?? "claude-sonnet-4-20250514"
+
+		// Run Claude Code interactively (no --print flag)
+		// User can attach to the tmux session to review and approve changes
+		const args = [
+			"--model", model,
+		]
+
+		if (resumeSessionId) {
+			args.push("--resume", resumeSessionId)
+		}
+
+		// Add the prompt as the final argument (omit for interactive mode)
+		if (prompt) {
+			args.push(prompt)
+		}
+
+		return {
+			command: "claude",
+			args,
+		}
+	},
+
+	async validateInstallation(): Promise<boolean> {
+		try {
+			const proc = Bun.spawn(["which", "claude"], {
+				stdout: "pipe",
+				stderr: "pipe",
+			})
+			const exitCode = await proc.exited
+			return exitCode === 0
+		} catch {
+			return false
+		}
+	},
+
+	async getVersion(): Promise<string | null> {
+		try {
+			const proc = Bun.spawn(["claude", "--version"], {
+				stdout: "pipe",
+				stderr: "pipe",
+			})
+			const exitCode = await proc.exited
+			if (exitCode !== 0) return null
+
+			const output = await new Response(proc.stdout).text()
+			// Extract version from output
+			const match = output.match(/v?(\d+\.\d+\.\d+(?:-[\w.]+)?)/)
+			return match ? match[1] ?? null : output.trim() || null
+		} catch {
+			return null
+		}
+	},
+}

package/src/providers/index.ts

@@ -0,0 +1,21 @@
+/**
+ * Provider system exports
+ *
+ * Abstract AI backend provider interface with implementations
+ * for OpenCode and Claude Code.
+ */
+
+// Registry functions
+export { getProvider, getAllProviders, isProviderSupported } from "./registry"
+
+// Provider implementations
+export { openCodeProvider } from "./opencode"
+export { claudeProvider } from "./claude"
+
+// Types
+export type {
+	Provider,
+	ProviderBranding,
+	ParserPatterns,
+	SpawnCommand,
+} from "./types"

package/src/providers/opencode.ts

@@ -0,0 +1,98 @@
+/**
+ * OpenCode provider implementation
+ *
+ * Supports the OpenCode CLI (https://github.com/opencode-ai/opencode)
+ */
+
+import type { Provider, ProviderBranding, ParserPatterns, SpawnCommand } from "./types"
+import type { Session } from "../store"
+import type { OpenCodeConfig } from "../config/types"
+
+// ============================================================================
+// Branding
+// ============================================================================
+
+const branding: ProviderBranding = {
+	displayName: "OpenCode",
+	shortName: "opencode",
+	accentColor: "#fab283",
+	secondaryColor: "#d4956b",
+	logoText: "OC",
+	terminalBackground: "#000000",
+}
+
+// ============================================================================
+// Parser Patterns
+// ============================================================================
+
+const parserPatterns: ParserPatterns = {
+	workingRegex: /(?:starting|begin|entering).+(?:implementation|coding|execution)|(?:mode|status):\s*(?:implement|coding)/i,
+	doneRegex: /\[?OPENSWE:DONE\]?/i,
+}
+
+// ============================================================================
+// Provider Implementation
+// ============================================================================
+
+export const openCodeProvider: Provider = {
+	id: "opencode",
+	name: "OpenCode",
+	branding,
+	parserPatterns,
+
+	buildSpawnCommand(
+		_session: Session,
+		prompt?: string,
+		resumeSessionId?: string,
+		config?: Record<string, unknown>
+	): SpawnCommand {
+		const openCodeConfig = config as OpenCodeConfig | undefined
+
+		const args = []
+
+		// Without them, opencode launches in interactive TUI mode
+		if (prompt) {
+			args.push("--agent", "plan", "--prompt", prompt)
+		}
+
+		if (resumeSessionId) {
+			args.push("--session", resumeSessionId)
+		}
+
+		return {
+			command: "opencode",
+			args,
+		}
+	},
+
+	async validateInstallation(): Promise<boolean> {
+		try {
+			const proc = Bun.spawn(["which", "opencode"], {
+				stdout: "pipe",
+				stderr: "pipe",
+			})
+			const exitCode = await proc.exited
+			return exitCode === 0
+		} catch {
+			return false
+		}
+	},
+
+	async getVersion(): Promise<string | null> {
+		try {
+			const proc = Bun.spawn(["opencode", "--version"], {
+				stdout: "pipe",
+				stderr: "pipe",
+			})
+			const exitCode = await proc.exited
+			if (exitCode !== 0) return null
+
+			const output = await new Response(proc.stdout).text()
+			// Extract version from output (e.g., "opencode v1.2.3" or just "1.2.3")
+			const match = output.match(/v?(\d+\.\d+\.\d+(?:-[\w.]+)?)/)
+			return match ? match[1] ?? null : output.trim() || null
+		} catch {
+			return null
+		}
+	},
+}

package/src/providers/registry.ts

@@ -0,0 +1,53 @@
+/**
+ * Provider registry for AI backend lookup
+ *
+ * Centralized access to all registered providers.
+ */
+
+import type { AIBackend } from "../config/types"
+import type { Provider } from "./types"
+import { openCodeProvider } from "./opencode"
+import { claudeProvider } from "./claude"
+
+// ============================================================================
+// Registry
+// ============================================================================
+
+const providers: Map<AIBackend, Provider> = new Map([
+	["opencode", openCodeProvider],
+	["claude", claudeProvider],
+])
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+/**
+ * Get a provider by its backend ID
+ * @param backend - The backend identifier (e.g., "opencode", "claude")
+ * @returns The provider instance
+ * @throws Error if provider not found
+ */
+export function getProvider(backend: AIBackend): Provider {
+	const provider = providers.get(backend)
+	if (!provider) {
+		throw new Error(`Unknown AI backend: ${backend}. Available: ${Array.from(providers.keys()).join(", ")}`)
+	}
+	return provider
+}
+
+/**
+ * Get all registered providers
+ * @returns Array of all provider instances
+ */
+export function getAllProviders(): Provider[] {
+	return Array.from(providers.values())
+}
+
+/**
+ * Check if a backend is supported
+ * @param backend - The backend identifier to check
+ */
+export function isProviderSupported(backend: string): backend is AIBackend {
+	return providers.has(backend as AIBackend)
+}

package/src/providers/types.ts

@@ -0,0 +1,117 @@
+/**
+ * Provider type definitions for AI backend abstraction
+ *
+ * Supports multiple AI backends (Claude Code, OpenCode, etc.)
+ * with provider-specific command building and branding.
+ */
+
+import type { AIBackend } from "../config/types"
+import type { Session } from "../store"
+
+// ============================================================================
+// Core Provider Interface
+// ============================================================================
+
+/**
+ * Abstract provider interface for AI backends
+ *
+ * Implementations handle:
+ * - Command building for spawning AI sessions
+ * - Branding for UI display
+ * - Parser patterns for output detection
+ * - Installation/version validation
+ */
+export interface Provider {
+	/** Unique identifier matching AIBackend type */
+	readonly id: AIBackend
+	/** Human-readable display name */
+	readonly name: string
+	/** UI branding configuration */
+	readonly branding: ProviderBranding
+	/** Output parser patterns */
+	readonly parserPatterns: ParserPatterns
+
+	/**
+	 * Build the spawn command for starting an AI session
+	 * @param session - Session to start
+	 * @param prompt - Optional prompt to send to the AI (omit for interactive mode)
+	 * @param resumeSessionId - Optional session ID to resume
+	 * @param config - Provider-specific configuration
+	 */
+	buildSpawnCommand(
+		session: Session,
+		prompt?: string,
+		resumeSessionId?: string,
+		config?: Record<string, unknown>
+	): SpawnCommand
+
+	/**
+	 * Validate that the provider CLI is installed
+	 * @returns true if installed and accessible
+	 */
+	validateInstallation(): Promise<boolean>
+
+	/**
+	 * Get the installed version of the provider CLI
+	 * @returns Version string or null if not installed
+	 */
+	getVersion(): Promise<string | null>
+}
+
+// ============================================================================
+// Branding Configuration
+// ============================================================================
+
+/**
+ * UI branding configuration for providers
+ *
+ * Used for consistent styling in Preview, StatusBar, and other components.
+ */
+export interface ProviderBranding {
+	/** Full display name (e.g., "Claude Code") */
+	displayName: string
+	/** Short name for compact displays (e.g., "claude") */
+	shortName: string
+	/** Primary accent color (hex) for borders and highlights */
+	accentColor: string
+	/** Secondary color (hex) for backgrounds and subtle elements */
+	secondaryColor: string
+	/** Optional custom header background color */
+	headerBackground?: string
+	/** Optional logo text for header display */
+	logoText?: string
+	/** Optional terminal output background color (undefined = transparent) */
+	terminalBackground?: string
+}
+
+// ============================================================================
+// Parser Patterns
+// ============================================================================
+
+/**
+ * Regex patterns for parsing AI output
+ *
+ * Each provider may have different markers for phase transitions.
+ */
+export interface ParserPatterns {
+	/** Pattern to detect working/implementation phase */
+	workingRegex: RegExp
+	/** Pattern to detect completion */
+	doneRegex: RegExp
+}
+
+// ============================================================================
+// Spawn Command
+// ============================================================================
+
+/**
+ * Command specification for spawning an AI session
+ */
+export interface SpawnCommand {
+	/** CLI command to execute (e.g., "opencode", "claude") */
+	command: string
+	/** Arguments to pass to the command */
+	args: string[]
+	/** Optional environment variables to set */
+	env?: Record<string, string>
+}

package/src/store/buffers.ts

@@ -0,0 +1,234 @@
+/**
+ * Output buffer database operations
+ *
+ * Manages circular buffers for session output storage.
+ * Each session has a buffer that stores the most recent output lines.
+ */
+
+import { getDatabase, nowISO } from "./db"
+import type { OutputBuffer } from "./types"
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+/** Maximum number of lines to store per buffer */
+export const MAX_BUFFER_LINES = 1000
+
+// ============================================================================
+// Database Row Type
+// ============================================================================
+
+interface BufferRow {
+  session_id: string
+  lines: string
+  last_updated: string
+}
+
+// ============================================================================
+// Row Mapping
+// ============================================================================
+
+/**
+ * Convert database row to OutputBuffer
+ */
+function rowToBuffer(row: BufferRow): OutputBuffer {
+  let lines: string[]
+  try {
+    lines = JSON.parse(row.lines)
+    if (!Array.isArray(lines)) {
+      lines = []
+    }
+  } catch {
+    lines = []
+  }
+
+  return {
+    sessionId: row.session_id,
+    lines,
+    lastUpdated: row.last_updated,
+  }
+}
+
+// ============================================================================
+// Query Operations
+// ============================================================================
+
+/**
+ * Get the output buffer for a session
+ *
+ * @param sessionId - Session UUID
+ * @returns OutputBuffer or null if not found
+ */
+export function getBuffer(sessionId: string): OutputBuffer | null {
+  const db = getDatabase()
+  const row = db
+    .query<BufferRow, [string]>(
+      "SELECT * FROM output_buffers WHERE session_id = ?"
+    )
+    .get(sessionId)
+
+  return row ? rowToBuffer(row) : null
+}
+
+/**
+ * Get recent lines from a session's buffer
+ *
+ * @param sessionId - Session UUID
+ * @param count - Number of recent lines to retrieve
+ * @returns Array of lines (may be empty if buffer doesn't exist)
+ */
+export function getRecentLines(sessionId: string, count: number): string[] {
+  const buffer = getBuffer(sessionId)
+  if (!buffer) {
+    return []
+  }
+
+  // Return last N lines
+  return buffer.lines.slice(-count)
+}
+
+/**
+ * Get all lines from a session's buffer
+ *
+ * @param sessionId - Session UUID
+ * @returns Array of all lines
+ */
+export function getAllLines(sessionId: string): string[] {
+  const buffer = getBuffer(sessionId)
+  return buffer?.lines ?? []
+}
+
+// ============================================================================
+// Create/Update Operations
+// ============================================================================
+
+/**
+ * Create a new output buffer for a session
+ *
+ * @param sessionId - Session UUID
+ * @returns The created OutputBuffer
+ */
+export function createBuffer(sessionId: string): OutputBuffer {
+  const db = getDatabase()
+  const now = nowISO()
+
+  db.query(
+    "INSERT INTO output_buffers (session_id, lines, last_updated) VALUES (?, '[]', ?)"
+  ).run(sessionId, now)
+
+  return {
+    sessionId,
+    lines: [],
+    lastUpdated: now,
+  }
+}
+
+/**
+ * Ensure a buffer exists for a session (create if needed)
+ *
+ * @param sessionId - Session UUID
+ * @returns The OutputBuffer
+ */
+export function ensureBuffer(sessionId: string): OutputBuffer {
+  const existing = getBuffer(sessionId)
+  if (existing) {
+    return existing
+  }
+  return createBuffer(sessionId)
+}
+
+/**
+ * Append lines to a session's output buffer
+ *
+ * Implements circular buffer logic - drops oldest lines when exceeding MAX_BUFFER_LINES.
+ *
+ * @param sessionId - Session UUID
+ * @param newLines - Lines to append
+ */
+export function appendLines(sessionId: string, newLines: string[]): void {
+  if (newLines.length === 0) {
+    return
+  }
+
+  const db = getDatabase()
+  const now = nowISO()
+
+  // Ensure buffer exists
+  const buffer = ensureBuffer(sessionId)
+
+  // Combine existing and new lines
+  let allLines = [...buffer.lines, ...newLines]
+
+  // Apply circular buffer limit
+  if (allLines.length > MAX_BUFFER_LINES) {
+    allLines = allLines.slice(-MAX_BUFFER_LINES)
+  }
+
+  // Update in database
+  db.query(
+    "UPDATE output_buffers SET lines = ?, last_updated = ? WHERE session_id = ?"
+  ).run(JSON.stringify(allLines), now, sessionId)
+}
+
+/**
+ * Append a single line to a session's output buffer
+ *
+ * @param sessionId - Session UUID
+ * @param line - Line to append
+ */
+export function appendLine(sessionId: string, line: string): void {
+  appendLines(sessionId, [line])
+}
+
+/**
+ * Replace all lines in a buffer
+ *
+ * @param sessionId - Session UUID
+ * @param lines - New lines (will be truncated to MAX_BUFFER_LINES)
+ */
+export function setLines(sessionId: string, lines: string[]): void {
+  const db = getDatabase()
+  const now = nowISO()
+
+  // Ensure buffer exists
+  ensureBuffer(sessionId)
+
+  // Apply limit
+  const truncatedLines = lines.slice(-MAX_BUFFER_LINES)
+
+  // Update in database
+  db.query(
+    "UPDATE output_buffers SET lines = ?, last_updated = ? WHERE session_id = ?"
+  ).run(JSON.stringify(truncatedLines), now, sessionId)
+}
+
+// ============================================================================
+// Delete Operations
+// ============================================================================
+
+/**
+ * Clear all lines from a session's buffer
+ *
+ * @param sessionId - Session UUID
+ */
+export function clearBuffer(sessionId: string): void {
+  const db = getDatabase()
+  const now = nowISO()
+
+  db.query(
+    "UPDATE output_buffers SET lines = '[]', last_updated = ? WHERE session_id = ?"
+  ).run(now, sessionId)
+}
+
+/**
+ * Delete a session's buffer
+ *
+ * Note: This is also done automatically via CASCADE when session is deleted.
+ *
+ * @param sessionId - Session UUID
+ */
+export function deleteBuffer(sessionId: string): void {
+  const db = getDatabase()
+  db.query("DELETE FROM output_buffers WHERE session_id = ?").run(sessionId)
+}