@vladimirven/openswe 0.1.0

package/src/github/issues.ts

@@ -0,0 +1,351 @@
+/**
+ * GitHub issue fetching via gh CLI
+ *
+ * Provides functions for fetching and viewing GitHub issues.
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+/** Issue state filter */
+export type IssueState = "open" | "closed" | "all"
+
+/** Issue label information */
+export interface IssueLabel {
+  /** Label name */
+  name: string
+  /** Label color (hex without #) */
+  color: string
+}
+
+/** GitHub issue data */
+export interface GitHubIssue {
+  /** Issue number */
+  number: number
+  /** Issue title */
+  title: string
+  /** Issue body/description (may be null) */
+  body: string | null
+  /** Issue state */
+  state: "OPEN" | "CLOSED"
+  /** Issue URL on GitHub */
+  url: string
+  /** Labels attached to the issue */
+  labels: IssueLabel[]
+  /** ISO timestamp when issue was created */
+  createdAt: string
+  /** ISO timestamp when issue was last updated */
+  updatedAt: string
+}
+
+/** Options for fetching issues */
+export interface FetchIssuesOptions {
+  /** Filter by state (default: "open") */
+  state?: IssueState
+  /** Filter by labels (AND logic) */
+  labels?: string[]
+  /** Maximum number of issues to fetch (default: 50) */
+  limit?: number
+}
+
+/** Result of fetching issues */
+export interface FetchIssuesResult {
+  /** Whether the fetch succeeded */
+  success: boolean
+  /** Fetched issues */
+  issues: GitHubIssue[]
+  /** Error message if fetch failed */
+  error?: string
+}
+
+/** Result of fetching a single issue */
+export interface FetchIssueResult {
+  /** Whether the fetch succeeded */
+  success: boolean
+  /** The fetched issue (null if not found) */
+  issue: GitHubIssue | null
+  /** Error message if fetch failed */
+  error?: string
+}
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+/** Default timeout for GitHub API operations in milliseconds */
+const DEFAULT_TIMEOUT_MS = 30000
+
+// ============================================================================
+// Issue Fetching
+// ============================================================================
+
+/**
+ * Fetch issues from a GitHub repository
+ *
+ * @param ownerRepo - Repository in "owner/repo" format
+ * @param options - Fetch options (state, labels, limit)
+ * @returns Result with fetched issues or error
+ */
+export async function fetchIssues(
+  ownerRepo: string,
+  options?: FetchIssuesOptions
+): Promise<FetchIssuesResult> {
+  const { state = "open", labels = [], limit = 50 } = options ?? {}
+
+  try {
+    // Build command arguments
+    const args = [
+      "gh",
+      "issue",
+      "list",
+      "--repo",
+      ownerRepo,
+      "--state",
+      state,
+      "--limit",
+      String(limit),
+      "--json",
+      "number,title,body,state,url,labels,createdAt,updatedAt",
+    ]
+
+    // Add label filters
+    for (const label of labels) {
+      args.push("--label", label)
+    }
+
+    const proc = Bun.spawn(args, {
+      stdout: "pipe",
+      stderr: "pipe",
+    })
+
+    // Race between process completion and timeout
+    const timeoutPromise = new Promise<"timeout">((resolve) =>
+      setTimeout(() => resolve("timeout"), DEFAULT_TIMEOUT_MS)
+    )
+
+    const raceResult = await Promise.race([proc.exited, timeoutPromise])
+
+    if (raceResult === "timeout") {
+      // Kill the process if it's still running
+      try {
+        proc.kill()
+      } catch {
+        // Ignore kill errors
+      }
+      return {
+        success: false,
+        issues: [],
+        error: "Request timed out. Check your internet connection.",
+      }
+    }
+
+    const stdout = await new Response(proc.stdout).text()
+    const stderr = await new Response(proc.stderr).text()
+    const exitCode = raceResult
+
+    if (exitCode !== 0) {
+      return {
+        success: false,
+        issues: [],
+        error: parseGhError(stderr),
+      }
+    }
+
+    // Parse JSON response
+    try {
+      const rawIssues = JSON.parse(stdout) as Array<{
+        number: number
+        title: string
+        body: string | null
+        state: string
+        url: string
+        labels: Array<{ name: string; color: string }>
+        createdAt: string
+        updatedAt: string
+      }>
+
+      const issues: GitHubIssue[] = rawIssues.map((raw) => ({
+        number: raw.number,
+        title: raw.title,
+        body: raw.body,
+        state: raw.state as "OPEN" | "CLOSED",
+        url: raw.url,
+        labels: raw.labels.map((l) => ({ name: l.name, color: l.color })),
+        createdAt: raw.createdAt,
+        updatedAt: raw.updatedAt,
+      }))
+
+      return {
+        success: true,
+        issues,
+      }
+    } catch {
+      return {
+        success: false,
+        issues: [],
+        error: "Failed to parse GitHub response",
+      }
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error"
+    return {
+      success: false,
+      issues: [],
+      error: `Failed to fetch issues: ${message}`,
+    }
+  }
+}
+
+/**
+ * Fetch a single issue by number
+ *
+ * @param ownerRepo - Repository in "owner/repo" format
+ * @param issueNumber - Issue number
+ * @returns Result with the issue or error
+ */
+export async function getIssue(
+  ownerRepo: string,
+  issueNumber: number
+): Promise<FetchIssueResult> {
+  try {
+    const proc = Bun.spawn(
+      [
+        "gh",
+        "issue",
+        "view",
+        String(issueNumber),
+        "--repo",
+        ownerRepo,
+        "--json",
+        "number,title,body,state,url,labels,createdAt,updatedAt",
+      ],
+      {
+        stdout: "pipe",
+        stderr: "pipe",
+      }
+    )
+
+    const stdout = await new Response(proc.stdout).text()
+    const stderr = await new Response(proc.stderr).text()
+    const exitCode = await proc.exited
+
+    if (exitCode !== 0) {
+      return {
+        success: false,
+        issue: null,
+        error: parseGhError(stderr),
+      }
+    }
+
+    // Parse JSON response
+    try {
+      const raw = JSON.parse(stdout) as {
+        number: number
+        title: string
+        body: string | null
+        state: string
+        url: string
+        labels: Array<{ name: string; color: string }>
+        createdAt: string
+        updatedAt: string
+      }
+
+      const issue: GitHubIssue = {
+        number: raw.number,
+        title: raw.title,
+        body: raw.body,
+        state: raw.state as "OPEN" | "CLOSED",
+        url: raw.url,
+        labels: raw.labels.map((l) => ({ name: l.name, color: l.color })),
+        createdAt: raw.createdAt,
+        updatedAt: raw.updatedAt,
+      }
+
+      return {
+        success: true,
+        issue,
+      }
+    } catch {
+      return {
+        success: false,
+        issue: null,
+        error: "Failed to parse GitHub response",
+      }
+    }
+  } catch (err) {
+    return {
+      success: false,
+      issue: null,
+      error: err instanceof Error ? err.message : "Failed to fetch issue",
+    }
+  }
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Parse gh CLI error messages into user-friendly strings
+ */
+function parseGhError(stderr: string): string {
+  const trimmed = stderr.trim()
+
+  if (trimmed.includes("not logged in")) {
+    return "Not authenticated with GitHub. Run: gh auth login"
+  }
+  if (trimmed.includes("Could not resolve to a Repository")) {
+    return "Repository not found. Check the repository name."
+  }
+  if (trimmed.includes("HTTP 404")) {
+    return "Repository not found or you don't have access."
+  }
+  if (trimmed.includes("HTTP 403")) {
+    return "Access denied. Check your permissions."
+  }
+  if (trimmed.includes("no issues match")) {
+    return "No issues found matching the criteria."
+  }
+  if (trimmed.includes("could not find issue")) {
+    return "Issue not found."
+  }
+
+  return trimmed || "Failed to fetch from GitHub"
+}
+
+/**
+ * Format relative time from an ISO timestamp
+ *
+ * @param isoString - ISO timestamp string
+ * @returns Human-readable relative time (e.g., "3 days ago")
+ */
+export function formatRelativeTime(isoString: string): string {
+  const date = new Date(isoString)
+  const now = new Date()
+  const diffMs = now.getTime() - date.getTime()
+
+  const seconds = Math.floor(diffMs / 1000)
+  const minutes = Math.floor(seconds / 60)
+  const hours = Math.floor(minutes / 60)
+  const days = Math.floor(hours / 24)
+  const weeks = Math.floor(days / 7)
+  const months = Math.floor(days / 30)
+
+  if (months > 0) {
+    return months === 1 ? "1 month ago" : `${months} months ago`
+  }
+  if (weeks > 0) {
+    return weeks === 1 ? "1 week ago" : `${weeks} weeks ago`
+  }
+  if (days > 0) {
+    return days === 1 ? "1 day ago" : `${days} days ago`
+  }
+  if (hours > 0) {
+    return hours === 1 ? "1 hour ago" : `${hours} hours ago`
+  }
+  if (minutes > 0) {
+    return minutes === 1 ? "1 min ago" : `${minutes} mins ago`
+  }
+  return "just now"
+}

package/src/index.ts

@@ -0,0 +1,369 @@
+#!/usr/bin/env bun
+/**
+ * OpenSWE - AI-powered Software Engineering orchestration
+ *
+ * Main entry point with CLI argument parsing, config loading, and workspace detection.
+ */
+
+// IMPORTANT: Must import preload before any JSX code to register Solid.js JSX runtime.
+// This is needed because bunfig.toml is only read from cwd, not the package directory.
+import "@opentui/solid/preload"
+
+import { join } from "path"
+import yargs from "yargs"
+import { hideBin } from "yargs/helpers"
+import { loadConfig, getConfigPath, type GlobalConfig, type AIBackend } from "./config"
+import { logger, setLogLevel, initFileLogging } from "./utils/logger"
+import { checkPrerequisites, formatPrerequisiteErrors } from "./utils/prerequisites"
+import { closeDatabase } from "./store"
+import {
+  detectWorkspace,
+  loadProjectConfig,
+  updateLastOpened,
+  getLogsDir,
+  type WorkspaceResult,
+} from "./workspace"
+import {
+  runEmptyDirectoryWizard,
+  runExistingRepoWizard,
+  runReconfigureWizard,
+} from "./wizard"
+
+// NOTE: startTUI is dynamically imported to ensure the preload runs first.
+// Static imports are hoisted and parsed before any code executes, which would
+// cause app.tsx to be parsed before the Solid.js JSX runtime is registered.
+
+// ============================================================================
+// CLI Argument Types
+// ============================================================================
+
+interface CLIArgs {
+  repo?: string
+  setup?: boolean
+  status?: boolean
+  backend?: "opencode" | "claude"
+  model?: string
+  debug?: boolean
+}
+
+// ============================================================================
+// CLI Argument Parsing
+// ============================================================================
+
+// Parse CLI arguments
+const argv = await yargs(hideBin(process.argv))
+  .scriptName("openswe")
+  .usage("$0 [options]")
+  .option("repo", {
+    alias: "r",
+    type: "string",
+    description: "GitHub repository (owner/repo) to link",
+  })
+  .option("setup", {
+    type: "boolean",
+    description: "Force re-run the setup wizard",
+  })
+  .option("status", {
+    type: "boolean",
+    description: "Show project status without TUI",
+  })
+  .option("backend", {
+    type: "string",
+    choices: ["opencode", "claude"] as const,
+    description: "AI backend to use",
+  })
+  .option("model", {
+    type: "string",
+    description: "AI model to use (e.g. claude-3-5-sonnet-20240620)",
+  })
+  .option("debug", {
+    type: "boolean",
+    description: "Enable debug logging",
+  })
+  .help()
+  .alias("h", "help")
+  .version("0.1.0")
+  .alias("v", "version")
+  .parse() as CLIArgs
+
+// ============================================================================
+// Main Function
+// ============================================================================
+
+async function main() {
+  // Load configuration with CLI overrides
+  const config = await loadConfig({
+    backend: argv.backend as AIBackend | undefined,
+    model: argv.model,
+    debug: argv.debug,
+  })
+
+  // Apply log level from merged config
+  setLogLevel(config.advanced.logLevel)
+
+  logger.debug("OpenSWE starting...")
+  logger.debug("Config file path:", getConfigPath())
+  logger.debug("Loaded configuration:", config)
+
+  // Detect workspace type
+  const cwd = process.cwd()
+  const workspace = await detectWorkspace(cwd)
+
+  logger.debug("Workspace detection result:", workspace)
+
+  // Show status mode (uses workspace info)
+  if (argv.status) {
+    await showStatus(config, workspace)
+    return
+  }
+
+  // Handle workspace based on type
+  await handleWorkspace(workspace, config, argv)
+
+  exitApp(0)
+}
+
+// ============================================================================
+// Exit Handling
+// ============================================================================
+
+function exitApp(code: number): never {
+  try {
+    closeDatabase()
+  } catch {
+    // Ignore close errors during shutdown
+  }
+  process.exit(code)
+}
+
+// ============================================================================
+// Workspace Handling
+// ============================================================================
+
+/**
+ * Handle the detected workspace type
+ */
+async function handleWorkspace(
+  workspace: WorkspaceResult,
+  config: GlobalConfig,
+  args: CLIArgs
+): Promise<void> {
+  // Handle --setup flag for reconfiguration
+  if (args.setup && workspace.type === "existing-project") {
+    const projectConfig = await loadProjectConfig(workspace.projectRoot)
+    if (projectConfig) {
+      const result = await runReconfigureWizard(
+        workspace.projectRoot,
+        projectConfig.repoFullName
+      )
+    if (result.cancelled) {
+      logger.info("Setup cancelled.")
+      exitApp(0)
+    }
+    if (!result.completed) {
+      logger.error("Setup failed:", result.error)
+      exitApp(1)
+    }
+    }
+    // Continue to normal project handling after reconfiguration
+  }
+
+  switch (workspace.type) {
+    case "existing-project":
+      await handleExistingProject(workspace, config)
+      break
+
+    case "existing-repo":
+      await handleExistingRepo(workspace, args)
+      break
+
+    case "empty":
+      await handleEmptyDirectory(workspace, args)
+      break
+  }
+}
+
+/**
+ * Handle existing OpenSWE project - load and continue
+ */
+async function handleExistingProject(
+  workspace: WorkspaceResult,
+  config: GlobalConfig
+): Promise<void> {
+  // Initialize file logging
+  const logsDir = getLogsDir(workspace.projectRoot)
+  initFileLogging(join(logsDir, "openswe.log"))
+
+  // Check prerequisites before launching TUI
+  const prereqResult = await checkPrerequisites()
+  if (!prereqResult.success) {
+    logger.error(formatPrerequisiteErrors(prereqResult))
+    exitApp(1)
+  }
+
+  // Log warnings if any
+  if (prereqResult.warnings.length > 0) {
+    for (const warning of prereqResult.warnings) {
+      logger.warn(warning)
+    }
+  }
+
+  // Load project config and update lastOpened
+  const projectConfig = await loadProjectConfig(workspace.projectRoot)
+  if (projectConfig) {
+    await updateLastOpened(workspace.projectRoot)
+    logger.debug("Project config:", projectConfig)
+  }
+
+  // Launch TUI - dynamic import to ensure preload runs first
+  const { startTUI } = await import("./app")
+  await startTUI(config, workspace.projectRoot)
+}
+
+/**
+ * Handle existing git repo - offer to adopt
+ */
+async function handleExistingRepo(
+  workspace: WorkspaceResult,
+  args: CLIArgs
+): Promise<void> {
+  // If we don't have a repo name, we can't run the wizard
+  if (!workspace.repoFullName) {
+    logger.error("Could not detect repository name from git remote.")
+    logger.error("Please ensure you have a remote named 'origin' configured.")
+    exitApp(1)
+  }
+
+  // Run the adoption wizard
+  const result = await runExistingRepoWizard(
+    workspace.projectRoot,
+    workspace.repoFullName,
+    workspace.remoteUrl ?? undefined
+  )
+
+  if (result.cancelled) {
+    logger.info("Setup cancelled.")
+    exitApp(0)
+  }
+
+  if (!result.completed) {
+    logger.error("Setup failed:", result.error)
+    exitApp(1)
+  }
+
+  // Wizard completed successfully - show summary
+  const updatedConfig = await loadConfig({
+    backend: args.backend as AIBackend | undefined,
+    debug: args.debug,
+  })
+
+  logger.debug("")
+  logConfigSummary(updatedConfig)
+  logger.debug("")
+  logger.debug("OpenSWE initialized (Phase 4 - wizard complete)")
+  logger.debug("Launching TUI...")
+
+  await handleExistingProject(
+    {
+      type: "existing-project",
+      projectRoot: workspace.projectRoot,
+    },
+    updatedConfig
+  )
+}
+
+/**
+ * Handle empty directory - need full setup
+ */
+async function handleEmptyDirectory(
+  workspace: WorkspaceResult,
+  args: CLIArgs
+): Promise<void> {
+  // Run the empty directory wizard
+  const result = await runEmptyDirectoryWizard(workspace.projectRoot, args.repo)
+
+  if (result.cancelled) {
+    logger.info("Setup cancelled.")
+    exitApp(0)
+  }
+
+  if (!result.completed) {
+    logger.error("Setup failed:", result.error)
+    exitApp(1)
+  }
+
+  // Wizard completed successfully - show summary
+  const updatedConfig = await loadConfig({
+    backend: args.backend as AIBackend | undefined,
+    debug: args.debug,
+  })
+
+  logger.info("")
+  logConfigSummary(updatedConfig)
+  logger.info("")
+  logger.info("OpenSWE initialized (Phase 4 - wizard complete)")
+  logger.info("Launching TUI...")
+
+  await handleExistingProject(
+    {
+      type: "existing-project",
+      projectRoot: workspace.projectRoot,
+    },
+    updatedConfig
+  )
+}
+
+// ============================================================================
+// Status Display
+// ============================================================================
+
+/**
+ * Show project status (non-TUI mode)
+ */
+async function showStatus(config: GlobalConfig, workspace: WorkspaceResult): Promise<void> {
+  console.log("OpenSWE Status")
+  console.log("==============")
+  console.log("")
+  console.log("Configuration:")
+  console.log(`  Config file: ${getConfigPath()}`)
+  console.log(`  AI Backend: ${config.ai.backend}`)
+  console.log(`  Log Level: ${config.advanced.logLevel}`)
+  console.log("")
+  console.log("Workspace:")
+  console.log(`  Type: ${workspace.type}`)
+  console.log(`  Path: ${workspace.projectRoot}`)
+
+  if (workspace.type === "existing-repo" && workspace.repoFullName) {
+    console.log(`  Repository: ${workspace.repoFullName}`)
+  }
+
+  if (workspace.type === "existing-project") {
+    console.log("  Status: Initialized")
+    // TODO: Phase 5 - show session count, active tasks, etc.
+  } else if (workspace.type === "existing-repo") {
+    console.log("  Status: Git repo detected (not yet initialized)")
+  } else {
+    console.log("  Status: Empty directory (needs setup)")
+  }
+
+  console.log("")
+}
+
+/**
+ * Log configuration summary
+ */
+function logConfigSummary(config: GlobalConfig): void {
+  logger.debug("Configuration:")
+  logger.debug(`  AI Backend: ${config.ai.backend}`)
+  logger.debug(`  Log Level: ${config.advanced.logLevel}`)
+}
+
+// ============================================================================
+// Entry Point
+// ============================================================================
+
+// Run main
+main().catch((err) => {
+  logger.error("Fatal error:", err)
+  exitApp(1)
+})