@vladimirven/openswe 0.1.0

package/src/components/index.ts

@@ -0,0 +1,58 @@
+/**
+ * Components module - OpenSWE TUI components
+ *
+ * Exports all components and types for the TUI interface.
+ */
+
+// ============================================================================
+// Components
+// ============================================================================
+
+export { App } from "./App"
+export { StatusBar } from "./StatusBar"
+export { SessionList } from "./SessionList"
+export { SessionCard } from "./SessionCard"
+export { Preview } from "./Preview"
+export { PhaseProgress } from "./PhaseProgress"
+export { HelpModal } from "./HelpModal"
+export { ConfirmDialog } from "./ConfirmDialog"
+export { ManualSessionModal } from "./ManualSessionModal"
+export { ProviderSwitcherModal } from "./ProviderSwitcherModal"
+export { ThemeSwitcherModal } from "./ThemeSwitcherModal"
+export { SessionTerminal } from "./SessionTerminal"
+export { ScrollableText } from "./ScrollableText"
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type {
+  AppProps,
+  StatusBarProps,
+  SessionListProps,
+  SessionCardProps,
+  PreviewProps,
+  PhaseProgressProps,
+  HelpModalProps,
+  ConfirmDialogProps,
+  ManualSessionModalProps,
+  ProviderSwitcherModalProps,
+  ThemeSwitcherModalProps,
+  PendingAction,
+  ModalType,
+  ProjectInfo,
+} from "./types"
+
+export {
+  STATUS_ICONS,
+  PHASE_ORDER,
+  PHASE_DISPLAY_NAMES,
+  getPhaseProgress,
+  generateProgressBar,
+} from "./types"
+
+// ============================================================================
+// Theme
+// ============================================================================
+
+export { colors, borders, layout, typography, keybindings } from "./theme"

package/src/components/session-utils.ts

@@ -0,0 +1,337 @@
+/**
+ * Session utility functions
+ *
+ * Bridge functions connecting GitHub issues, git worktrees, and sessions.
+ * These functions handle the complete workflow of creating and deleting sessions.
+ */
+
+import { createWorktree, removeWorktree, worktreeExists } from "../git"
+import { createSession, deleteSession, getSession } from "../store"
+import { getWorktreePath, generateBranchName, sanitizeWorktreeName } from "../workspace/paths"
+import type { GitHubIssue } from "../github"
+import type { Session, AISessionData } from "../store"
+import { logger } from "../utils/logger"
+
+// ============================================================================
+// Types
+// ============================================================================
+
+/** Options for creating a session from an issue */
+export interface CreateSessionOptions {
+	/**
+	 * Custom worktree name to use instead of the issue number.
+	 * Useful when resolving conflicts by appending a suffix.
+	 */
+	worktreeNameOverride?: string
+	
+	/**
+	 * Whether to overwrite an existing worktree if it exists.
+	 * If false (default), will fail if worktree exists.
+	 */
+	overwriteWorktreeChoice?: OverwriteWorktreeChoice
+
+	/**
+	 * Initial AI session data (e.g. backend provider)
+	 */
+	aiSessionData?: AISessionData
+}
+
+export enum OverwriteWorktreeChoice {
+	use_existing = 0,
+	create_new = 1,
+	overwrite = 2
+}
+
+/** Result of creating a session */
+export interface CreateSessionResult {
+	/** Whether the operation succeeded */
+	success: boolean
+	/** Created session (null if failed) */
+	session: Session | null
+	/** Error message if operation failed */
+	error?: string
+}
+
+/** Result of deleting a session with worktree */
+export interface DeleteSessionResult {
+	/** Whether the operation succeeded */
+	success: boolean
+	/** Error message if operation failed */
+	error?: string
+}
+
+// ============================================================================
+// Session Creation
+// ============================================================================
+
+/**
+ * Find the next available worktree name by appending a counter
+ * 
+ * @param projectRoot - Absolute path to the project root
+ * @param baseName - Base name (e.g. issue number)
+ * @returns Available name (e.g. "issue-123", "issue-123-1")
+ */
+export async function findNextAvailableWorktreeName(
+	projectRoot: string,
+	baseName: string | number
+): Promise<string> {
+	// Get the canonical folder name first (e.g. 123 -> "issue-123")
+	const safeBase = sanitizeWorktreeName(baseName)
+	
+	// First check the base name
+	if (!(await worktreeExists(projectRoot, safeBase))) {
+		return safeBase
+	}
+	
+	// Try appending counters until we find a free one
+	let counter = 1
+	while (true) {
+		const candidate = `${safeBase}-${counter}`
+		if (!(await worktreeExists(projectRoot, candidate))) {
+			return candidate
+		}
+		counter++
+	}
+}
+
+/**
+ * Create a session from a GitHub issue
+ *
+ * This function:
+ * 1. Creates a git worktree at `.worktrees/issue-{number}`
+ * 2. Creates a session in the database linked to the issue
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param issue - GitHub issue data
+ * @param options - Creation options (optional)
+ * @returns Result with the created session or error
+ */
+export async function createSessionFromIssue(
+	projectRoot: string,
+	issue: GitHubIssue,
+	options: CreateSessionOptions = {}
+): Promise<CreateSessionResult> {
+	const worktreeName = options.worktreeNameOverride ?? issue.number
+
+	logger.debug("Creating worktree for issue", {
+		issueNumber: issue.number,
+		worktreeName,
+		projectRoot,
+		overwriteChoice: options.overwriteWorktreeChoice,
+	})
+	logger.info(options)
+	logger.info(options.overwriteWorktreeChoice)
+
+	let worktreePath: string
+	let branchName: string
+
+	if (options.overwriteWorktreeChoice === OverwriteWorktreeChoice.use_existing) {
+		// Continue with existing worktree
+		worktreePath = getWorktreePath(projectRoot, worktreeName)
+		branchName = generateBranchName(worktreeName)
+	} else {
+		// Handle overwrite if requested
+		if (options.overwriteWorktreeChoice === OverwriteWorktreeChoice.overwrite) {
+			const exists = await worktreeExists(projectRoot, worktreeName)
+			if (exists) {
+				logger.info("Overwriting existing worktree", { worktreeName })
+				await removeWorktree(projectRoot, worktreeName, { force: true, deleteBranch: true })
+			}
+		}
+
+		// Create the worktree
+		const worktreeResult = await createWorktree(projectRoot, worktreeName)
+		if (!worktreeResult.success) {
+			logger.warn("Worktree creation failed", worktreeResult.error)
+			return {
+				success: false,
+				session: null,
+				error: worktreeResult.error ?? "Failed to create worktree",
+			}
+		}
+
+		worktreePath = worktreeResult.worktreePath!
+		branchName = worktreeResult.branchName!
+	}
+
+	// Create the session in the database
+	try {
+		const session = createSession({
+			name: `#${issue.number}: ${issue.title}`,
+			issueNumber: issue.number,
+			issueTitle: issue.title,
+			issueBody: issue.body ?? undefined,
+			issueUrl: issue.url,
+			worktreePath,
+			branchName,
+			aiSessionData: options.aiSessionData,
+		})
+
+		logger.debug("Session created", {
+			sessionId: session.id,
+			issueNumber: issue.number,
+		})
+
+		return {
+			success: true,
+			session,
+		}
+	} catch (err) {
+		// Clean up the worktree if session creation fails
+		logger.warn("Session creation failed, cleaning up worktree", err)
+		await removeWorktree(projectRoot, worktreeName, { force: true, deleteBranch: true })
+
+		return {
+			success: false,
+			session: null,
+			error: err instanceof Error ? err.message : "Failed to create session",
+		}
+	}
+}
+
+/**
+ * Create a manual session (not linked to a GitHub issue)
+ *
+ * This function:
+ * 1. Creates a git worktree at `.worktrees/{name}`
+ * 2. Creates a session in the database
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param name - Session name (will be sanitized for worktree)
+ * @param options - Creation options (optional)
+ * @returns Result with the created session or error
+ */
+export async function createManualSession(
+	projectRoot: string,
+	name: string,
+	options: { aiSessionData?: AISessionData } = {}
+): Promise<CreateSessionResult> {
+	const sanitizedName = sanitizeWorktreeName(name)
+
+	logger.debug("Creating manual session", {
+		name,
+		sanitizedName,
+		projectRoot,
+	})
+
+	// Create the worktree
+	const worktreeResult = await createWorktree(projectRoot, sanitizedName)
+	if (!worktreeResult.success) {
+		logger.warn("Worktree creation failed", worktreeResult.error)
+		return {
+			success: false,
+			session: null,
+			error: worktreeResult.error ?? "Failed to create worktree",
+		}
+	}
+
+	// Create the session in the database
+	try {
+		const session = createSession({
+			name,
+			worktreePath: worktreeResult.worktreePath!,
+			branchName: worktreeResult.branchName!,
+			aiSessionData: options.aiSessionData,
+		})
+
+		logger.debug("Manual session created", { sessionId: session.id })
+
+		return {
+			success: true,
+			session,
+		}
+	} catch (err) {
+		// Clean up the worktree if session creation fails
+		logger.warn("Manual session creation failed, cleaning up worktree", err)
+		await removeWorktree(projectRoot, sanitizedName, { force: true, deleteBranch: true })
+
+		return {
+			success: false,
+			session: null,
+			error: err instanceof Error ? err.message : "Failed to create session",
+		}
+	}
+}
+
+// ============================================================================
+// Session Deletion
+// ============================================================================
+
+/**
+ * Delete a session and its associated worktree
+ *
+ * This function:
+ * 1. Gets the session to find the worktree path
+ * 2. Removes the git worktree
+ * 3. Deletes the session from the database
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param sessionId - Session UUID
+ * @returns Result indicating success or failure
+ */
+export async function deleteSessionWithWorktree(
+	projectRoot: string,
+	sessionId: string
+): Promise<DeleteSessionResult> {
+	// Get the session to find worktree info
+	const session = getSession(sessionId)
+	if (!session) {
+		return {
+			success: false,
+			error: "Session not found",
+		}
+	}
+
+	// Determine worktree name from session
+	let worktreeName: string | number
+	if (session.issueNumber !== null) {
+		worktreeName = session.issueNumber
+	} else {
+		// Extract from worktree path or branch name
+		const pathParts = session.worktreePath.split("/")
+		worktreeName = pathParts[pathParts.length - 1] ?? session.branchName.replace("openswe/", "")
+	}
+
+	// Remove the worktree (force to handle uncommitted changes)
+	const worktreeResult = await removeWorktree(projectRoot, worktreeName, {
+		force: true,
+		deleteBranch: true,
+	})
+
+	if (!worktreeResult.success) {
+		// Log the error but continue to delete the session
+		// The worktree might already be gone
+		console.error(`Warning: Failed to remove worktree: ${worktreeResult.error}`)
+	}
+
+	// Delete the session from the database
+	try {
+		deleteSession(sessionId)
+		return { success: true }
+	} catch (err) {
+		return {
+			success: false,
+			error: err instanceof Error ? err.message : "Failed to delete session",
+		}
+	}
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Extract worktree name from a session
+ *
+ * @param session - Session to extract name from
+ * @returns Worktree name (issue number or sanitized name)
+ */
+export function getWorktreeNameFromSession(session: Session): string | number {
+	if (session.issueNumber !== null) {
+		return session.issueNumber
+	}
+
+	// Extract from worktree path
+	const pathParts = session.worktreePath.split("/")
+	return pathParts[pathParts.length - 1] ?? session.branchName.replace("openswe/", "")
+}

package/src/components/theme.ts

@@ -0,0 +1,206 @@
+/**
+ * Theme configuration for OpenSWE TUI
+ *
+ * Defines colors, border styles, and layout constants
+ * Colors are derived from the theme system for consistency
+ */
+
+import { createMemo, type Accessor } from "solid-js"
+import type { Status } from "../store"
+import type { ResolvedTheme } from "../theme/types"
+import { getDefaultTheme, useTheme } from "../theme/context"
+
+// ============================================================================
+// Color Palette - Derived from Theme System
+// ============================================================================
+
+/**
+ * Create colors object from a resolved theme
+ * This allows components to use either the reactive theme or static defaults
+ */
+export function createColors(theme: ResolvedTheme) {
+  return {
+    // Background colors
+    bg: {
+      primary: theme.background,
+      secondary: theme.backgroundPanel,
+      card: theme.backgroundElement,
+      cardSelected: theme.borderSubtle,
+    },
+
+    // Text colors
+    text: {
+      primary: theme.text,
+      secondary: theme.textMuted,
+      muted: theme.borderSubtle,
+      inverse: theme.background,
+    },
+
+    // Status colors (semantic colors)
+    status: {
+      active: theme.success,
+      queued: theme.borderSubtle,
+      needs_attention: theme.warning,
+      completed: theme.success,
+      paused: theme.info,
+      failed: theme.error,
+    } as Record<Status, string>,
+
+    // Border colors
+    border: {
+      primary: theme.border,
+      secondary: theme.borderSubtle,
+      accent: theme.accent,
+    },
+
+    // Progress bar colors
+    progress: {
+      filled: theme.primary,
+      empty: theme.backgroundElement,
+      text: theme.accent,
+    },
+
+    // Accent colors
+    accent: {
+      primary: theme.primary,
+      secondary: theme.secondary,
+      success: theme.success,
+      warning: theme.warning,
+      error: theme.error,
+      info: theme.info,
+    },
+  }
+}
+
+/** Type for the colors object */
+export type Colors = ReturnType<typeof createColors>
+
+/** Default colors using the default theme (tokyonight) */
+export const colors = createColors(getDefaultTheme())
+
+/**
+ * Reactive hook to get colors that update when the theme changes
+ *
+ * Must be used within a component that is inside the ThemeProvider
+ *
+ * @returns Accessor to the current colors object
+ */
+export function useColors(): Accessor<Colors> {
+	const { theme } = useTheme()
+	return createMemo(() => createColors(theme()))
+}
+
+// ============================================================================
+// Border Styles
+// ============================================================================
+
+export const borders = {
+  // Rounded borders for main panels
+  panel: {
+    topLeft: "╭",
+    topRight: "╮",
+    bottomLeft: "╰",
+    bottomRight: "╯",
+    horizontal: "─",
+    vertical: "│",
+  },
+
+  // Single line borders for cards
+  card: {
+    topLeft: "┌",
+    topRight: "┐",
+    bottomLeft: "└",
+    bottomRight: "┘",
+    horizontal: "─",
+    vertical: "│",
+  },
+
+  // Double borders for emphasis
+  double: {
+    topLeft: "╔",
+    topRight: "╗",
+    bottomLeft: "╚",
+    bottomRight: "╝",
+    horizontal: "═",
+    vertical: "║",
+  },
+}
+
+// ============================================================================
+// Layout Constants
+// ============================================================================
+
+export const layout = {
+  // Pane widths (percentages)
+  sessionListWidth: "30%",
+  previewWidth: "70%",
+
+  // Padding values
+  padding: {
+    none: 0,
+    small: 1,
+    medium: 2,
+    large: 3,
+  },
+
+  // Card dimensions
+  card: {
+    minHeight: 4,
+    padding: 1,
+  },
+
+  // Status bar heights
+  statusBar: {
+    height: 1,
+  },
+
+  // Minimum dimensions
+  minWidth: 80,
+  minHeight: 24,
+}
+
+// ============================================================================
+// Typography
+// ============================================================================
+
+export const typography = {
+  // Truncation lengths
+  maxSessionNameLength: 25,
+  maxIssueNumberWidth: 8,
+  maxTokensWidth: 8,
+}
+
+// ============================================================================
+// Modal Dimensions
+// ============================================================================
+
+export const modals = {
+  issueSelector: {
+    width: 70,
+    height: 24,
+  },
+  help: {
+    width: 44,
+    height: 24,
+  },
+  confirm: {
+    width: 45,
+  },
+  manualSession: {
+    width: 50,
+  },
+}
+
+// ============================================================================
+// Keybinding Display
+// ============================================================================
+
+export const keybindings = {
+  navigate: "j/k or ↑/↓",
+  newSession: "n",
+  issues: "i",
+  theme: "t",
+  select: "Enter",
+  help: "?",
+  quit: "q",
+}