opencode-manager 0.3.1 → 0.4.0

package/src/cli/commands/sessions.ts

@@ -0,0 +1,495 @@
+/**
+ * Sessions CLI subcommands.
+ *
+ * Provides commands for listing, deleting, renaming, moving, and copying
+ * OpenCode sessions.
+ */
+
+import { Command, type OptionValues } from "commander"
+import { parseGlobalOptions, type GlobalOptions } from "../index"
+import {
+  loadSessionRecords,
+  loadProjectRecords,
+  deleteSessionMetadata,
+  updateSessionTitle,
+  moveSession,
+  copySession,
+  type SessionRecord,
+} from "../../lib/opencode-data"
+import {
+  getOutputOptions,
+  printSessionsOutput,
+  printDryRunOutput,
+  createDryRunResult,
+  printSuccessOutput,
+} from "../output"
+import { fuzzySearch, type SearchCandidate } from "../../lib/search"
+import { resolveSessionId, resolveProjectId } from "../resolvers"
+import { requireConfirmation, withErrorHandling, FileOperationError, UsageError } from "../errors"
+import { copyToBackupDir, formatBackupResult } from "../backup"
+
+/**
+ * Collect all options from a command and its ancestors.
+ * Commander stores global options on the root program, not on subcommands.
+ */
+function collectOptions(cmd: Command): OptionValues {
+  const opts: OptionValues = {}
+  let current: Command | null = cmd
+  while (current) {
+    Object.assign(opts, current.opts())
+    current = current.parent
+  }
+  return opts
+}
+
+/**
+ * Options specific to the sessions list command.
+ */
+export interface SessionsListOptions {
+  /** Filter sessions by project ID */
+  project?: string
+  /** Search query to filter sessions (fuzzy match) */
+  search?: string
+}
+
+/**
+ * Options specific to the sessions delete command.
+ */
+export interface SessionsDeleteOptions {
+  /** Session ID to delete */
+  session: string
+  /** Skip confirmation prompt */
+  yes: boolean
+  /** Preview changes without deleting */
+  dryRun: boolean
+  /** Directory to backup files before deletion */
+  backupDir?: string
+}
+
+/**
+ * Options specific to the sessions rename command.
+ */
+export interface SessionsRenameOptions {
+  /** Session ID to rename */
+  session: string
+  /** New title for the session */
+  title: string
+}
+
+/**
+ * Options specific to the sessions move command.
+ */
+export interface SessionsMoveOptions {
+  /** Session ID to move */
+  session: string
+  /** Target project ID */
+  to: string
+}
+
+/**
+ * Options specific to the sessions copy command.
+ */
+export interface SessionsCopyOptions {
+  /** Session ID to copy */
+  session: string
+  /** Target project ID */
+  to: string
+}
+
+/**
+ * Register sessions subcommands on the given parent command.
+ */
+export function registerSessionsCommands(parent: Command): void {
+  const sessions = parent
+    .command("sessions")
+    .description("Manage OpenCode sessions")
+
+  sessions
+    .command("list")
+    .description("List sessions")
+    .option("-p, --project <projectId>", "Filter by project ID")
+    .option("-s, --search <query>", "Search query to filter sessions")
+    .action(function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const cmdOpts = this.opts()
+      const listOpts: SessionsListOptions = {
+        project: cmdOpts.project as string | undefined,
+        search: cmdOpts.search as string | undefined,
+      }
+      handleSessionsList(globalOpts, listOpts)
+    })
+
+  sessions
+    .command("delete")
+    .description("Delete a session's metadata file")
+    .requiredOption("--session <sessionId>", "Session ID to delete")
+    .option("--yes", "Skip confirmation prompt", false)
+    .option("--dry-run", "Preview changes without deleting", false)
+    .option("--backup-dir <dir>", "Directory to backup files before deletion")
+    .action(async function (this: Command) {
+      const allOpts = collectOptions(this)
+      const globalOpts = parseGlobalOptions(allOpts)
+      const cmdOpts = this.opts()
+      const deleteOpts: SessionsDeleteOptions = {
+        session: String(cmdOpts.session),
+        yes: Boolean(allOpts.yes ?? cmdOpts.yes),
+        dryRun: Boolean(allOpts.dryRun ?? cmdOpts.dryRun),
+        backupDir: (allOpts.backupDir ?? cmdOpts.backupDir) as string | undefined,
+      }
+      await withErrorHandling(handleSessionsDelete, getOutputOptions(globalOpts).format)(
+        globalOpts,
+        deleteOpts
+      )
+    })
+
+  sessions
+    .command("rename")
+    .description("Rename a session")
+    .requiredOption("--session <sessionId>", "Session ID to rename")
+    .requiredOption("-t, --title <title>", "New title for the session")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const cmdOpts = this.opts()
+      const renameOpts: SessionsRenameOptions = {
+        session: String(cmdOpts.session),
+        title: String(cmdOpts.title),
+      }
+      await withErrorHandling(handleSessionsRename, getOutputOptions(globalOpts).format)(
+        globalOpts,
+        renameOpts
+      )
+    })
+
+  sessions
+    .command("move")
+    .description("Move a session to another project")
+    .requiredOption("--session <sessionId>", "Session ID to move")
+    .requiredOption("--to <projectId>", "Target project ID")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const cmdOpts = this.opts()
+      const moveOpts: SessionsMoveOptions = {
+        session: String(cmdOpts.session),
+        to: String(cmdOpts.to),
+      }
+      await withErrorHandling(handleSessionsMove, getOutputOptions(globalOpts).format)(
+        globalOpts,
+        moveOpts
+      )
+    })
+
+  sessions
+    .command("copy")
+    .description("Copy a session to another project")
+    .requiredOption("--session <sessionId>", "Session ID to copy")
+    .requiredOption("--to <projectId>", "Target project ID")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const cmdOpts = this.opts()
+      const copyOpts: SessionsCopyOptions = {
+        session: String(cmdOpts.session),
+        to: String(cmdOpts.to),
+      }
+      await withErrorHandling(handleSessionsCopy, getOutputOptions(globalOpts).format)(
+        globalOpts,
+        copyOpts
+      )
+    })
+}
+
+/**
+ * Build search text for a session record (matches TUI behavior).
+ * Combines title, sessionId, directory, and projectId.
+ */
+function buildSessionSearchText(session: SessionRecord): string {
+  return [
+    session.title || "",
+    session.sessionId,
+    session.directory || "",
+    session.projectId,
+  ].join(" ").replace(/\s+/g, " ").trim()
+}
+
+/**
+ * Handle the sessions list command.
+ */
+async function handleSessionsList(
+  globalOpts: GlobalOptions,
+  listOpts: SessionsListOptions
+): Promise<void> {
+  // Load session records from the data layer
+  // If a project filter is provided, pass it to the loader
+  let sessions = await loadSessionRecords({
+    root: globalOpts.root,
+    projectId: listOpts.project,
+  })
+
+  // Apply fuzzy search if search query is provided
+  if (listOpts.search?.trim()) {
+    const candidates: SearchCandidate<SessionRecord>[] = sessions.map((s) => ({
+      item: s,
+      searchText: buildSessionSearchText(s),
+    }))
+    
+    const results = fuzzySearch(candidates, listOpts.search, {
+      limit: globalOpts.limit,
+    })
+    
+    // Sort by score descending, then by sort field descending, then by sessionId
+    const sortField = globalOpts.sort // "updated" or "created"
+    results.sort((a, b) => {
+      if (b.score !== a.score) return b.score - a.score
+      const aTime = sortField === "created"
+        ? (a.item.createdAt?.getTime() ?? 0)
+        : ((a.item.updatedAt ?? a.item.createdAt)?.getTime() ?? 0)
+      const bTime = sortField === "created"
+        ? (b.item.createdAt?.getTime() ?? 0)
+        : ((b.item.updatedAt ?? b.item.createdAt)?.getTime() ?? 0)
+      if (bTime !== aTime) return bTime - aTime
+      return a.item.sessionId.localeCompare(b.item.sessionId)
+    })
+    
+    sessions = results.map((r) => r.item)
+  } else {
+    // Sort by the specified sort field (descending), then by sessionId
+    const sortField = globalOpts.sort // "updated" or "created"
+    sessions.sort((a, b) => {
+      const aTime = sortField === "created"
+        ? (a.createdAt?.getTime() ?? 0)
+        : ((a.updatedAt ?? a.createdAt)?.getTime() ?? 0)
+      const bTime = sortField === "created"
+        ? (b.createdAt?.getTime() ?? 0)
+        : ((b.updatedAt ?? b.createdAt)?.getTime() ?? 0)
+      if (bTime !== aTime) return bTime - aTime
+      return a.sessionId.localeCompare(b.sessionId)
+    })
+    
+    // Apply limit cap (default 200) when no search
+    sessions = sessions.slice(0, globalOpts.limit)
+  }
+
+  // Output the sessions using the appropriate formatter
+  const outputOpts = getOutputOptions(globalOpts)
+  printSessionsOutput(sessions, outputOpts)
+}
+
+/**
+ * Handle the sessions delete command.
+ *
+ * This command deletes a session's metadata file from the OpenCode storage.
+ * It does NOT delete associated chat message files (yet).
+ *
+ * Exit codes:
+ * - 0: Success (or dry-run completed)
+ * - 2: Usage error (--yes not provided for destructive operation)
+ * - 3: Session not found
+ * - 4: File operation failure (backup or delete failed)
+ */
+async function handleSessionsDelete(
+  globalOpts: GlobalOptions,
+  deleteOpts: SessionsDeleteOptions
+): Promise<void> {
+  const outputOpts = getOutputOptions(globalOpts)
+
+  // Resolve session ID to a session record
+  const { session } = await resolveSessionId(deleteOpts.session, {
+    root: globalOpts.root,
+    allowPrefix: true,
+  })
+
+  const pathsToDelete = [session.filePath]
+
+  // Handle dry-run mode
+  if (deleteOpts.dryRun) {
+    const dryRunResult = createDryRunResult(pathsToDelete, "delete", "session")
+    printDryRunOutput(dryRunResult, outputOpts.format)
+    return
+  }
+
+  // Require confirmation for destructive operation
+  requireConfirmation(deleteOpts.yes, "Session deletion")
+
+  // Backup files if requested
+  if (deleteOpts.backupDir) {
+    const backupResult = await copyToBackupDir(pathsToDelete, {
+      backupDir: deleteOpts.backupDir,
+      prefix: "session",
+      preserveStructure: true,
+      structureRoot: globalOpts.root,
+    })
+
+    if (backupResult.failed.length > 0) {
+      throw new FileOperationError(
+        `Backup failed for ${backupResult.failed.length} file(s): ${backupResult.failed
+          .map((f) => f.path)
+          .join(", ")}`,
+        "backup"
+      )
+    }
+
+    if (!globalOpts.quiet) {
+      console.log(formatBackupResult(backupResult))
+    }
+  }
+
+  // Perform the deletion
+  const deleteResult = await deleteSessionMetadata([session], { dryRun: false })
+
+  if (deleteResult.failed.length > 0) {
+    throw new FileOperationError(
+      `Failed to delete ${deleteResult.failed.length} file(s): ${deleteResult.failed
+        .map((f) => `${f.path}: ${f.error}`)
+        .join(", ")}`,
+      "delete"
+    )
+  }
+
+  // Output success
+  printSuccessOutput(
+    `Deleted session: ${session.sessionId}`,
+    { sessionId: session.sessionId, deleted: deleteResult.removed },
+    outputOpts.format
+  )
+}
+
+/**
+ * Handle the sessions rename command.
+ *
+ * This command updates a session's title in its metadata file.
+ *
+ * Exit codes:
+ * - 0: Success
+ * - 2: Usage error (empty title provided)
+ * - 3: Session not found
+ */
+async function handleSessionsRename(
+  globalOpts: GlobalOptions,
+  renameOpts: SessionsRenameOptions
+): Promise<void> {
+  const outputOpts = getOutputOptions(globalOpts)
+
+  // Validate non-empty title
+  const newTitle = renameOpts.title.trim()
+  if (!newTitle) {
+    throw new UsageError("Title cannot be empty")
+  }
+
+  // Resolve session ID to a session record
+  const { session } = await resolveSessionId(renameOpts.session, {
+    root: globalOpts.root,
+    allowPrefix: true,
+  })
+
+  // Update the session title
+  await updateSessionTitle(session.filePath, newTitle)
+
+  // Output success
+  printSuccessOutput(
+    `Renamed session: ${session.sessionId}`,
+    { sessionId: session.sessionId, title: newTitle },
+    outputOpts.format
+  )
+}
+
+/**
+ * Handle the sessions move command.
+ *
+ * This command moves a session to a different project.
+ * The session file is moved to the target project's session directory.
+ *
+ * Exit codes:
+ * - 0: Success
+ * - 3: Session or target project not found
+ * - 4: File operation failure
+ */
+async function handleSessionsMove(
+  globalOpts: GlobalOptions,
+  moveOpts: SessionsMoveOptions
+): Promise<void> {
+  const outputOpts = getOutputOptions(globalOpts)
+
+  // Resolve session ID to a session record
+  const { session } = await resolveSessionId(moveOpts.session, {
+    root: globalOpts.root,
+    allowPrefix: true,
+  })
+
+  // Validate target project exists
+  // Use prefix matching for convenience, but require exactly one match
+  await resolveProjectId(moveOpts.to, {
+    root: globalOpts.root,
+    allowPrefix: true,
+  })
+
+  // Check if session is already in the target project
+  if (session.projectId === moveOpts.to) {
+    printSuccessOutput(
+      `Session ${session.sessionId} is already in project ${moveOpts.to}`,
+      { sessionId: session.sessionId, projectId: moveOpts.to, moved: false },
+      outputOpts.format
+    )
+    return
+  }
+
+  // Move the session
+  const newRecord = await moveSession(session, moveOpts.to, globalOpts.root)
+
+  // Output success
+  printSuccessOutput(
+    `Moved session ${session.sessionId} to project ${moveOpts.to}`,
+    {
+      sessionId: session.sessionId,
+      fromProject: session.projectId,
+      toProject: moveOpts.to,
+      newPath: newRecord.filePath,
+    },
+    outputOpts.format
+  )
+}
+
+/**
+ * Handle the sessions copy command.
+ *
+ * This command copies a session to a different project.
+ * A new session file is created in the target project with a new session ID.
+ *
+ * Exit codes:
+ * - 0: Success
+ * - 3: Session or target project not found
+ * - 4: File operation failure
+ */
+async function handleSessionsCopy(
+  globalOpts: GlobalOptions,
+  copyOpts: SessionsCopyOptions
+): Promise<void> {
+  const outputOpts = getOutputOptions(globalOpts)
+
+  // Resolve session ID to a session record
+  const { session } = await resolveSessionId(copyOpts.session, {
+    root: globalOpts.root,
+    allowPrefix: true,
+  })
+
+  // Validate target project exists
+  // Use prefix matching for convenience, but require exactly one match
+  const { project: targetProject } = await resolveProjectId(copyOpts.to, {
+    root: globalOpts.root,
+    allowPrefix: true,
+  })
+
+  // Copy the session
+  const newRecord = await copySession(session, targetProject.projectId, globalOpts.root)
+
+  // Output success
+  printSuccessOutput(
+    `Copied session ${session.sessionId} to project ${targetProject.projectId}`,
+    {
+      originalSessionId: session.sessionId,
+      newSessionId: newRecord.sessionId,
+      fromProject: session.projectId,
+      toProject: targetProject.projectId,
+      newPath: newRecord.filePath,
+    },
+    outputOpts.format
+  )
+}

package/src/cli/commands/tokens.ts

@@ -0,0 +1,168 @@
+/**
+ * Tokens CLI subcommands.
+ *
+ * Provides commands for viewing token usage statistics at session,
+ * project, and global levels.
+ */
+
+import { Command, type OptionValues } from "commander"
+import { parseGlobalOptions, type GlobalOptions } from "../index"
+import {
+  computeGlobalTokenSummary,
+  computeProjectTokenSummary,
+  computeSessionTokenSummary,
+  loadProjectRecords,
+  loadSessionRecords,
+} from "../../lib/opencode-data"
+import { getOutputOptions, printAggregateTokensOutput, printTokensOutput } from "../output"
+import { handleError } from "../errors"
+import { findProjectById, findSessionById } from "../resolvers"
+
+/**
+ * Collect all options from a command and its ancestors.
+ * Commander stores global options on the root program, not on subcommands.
+ */
+function collectOptions(cmd: Command): OptionValues {
+  const opts: OptionValues = {}
+  let current: Command | null = cmd
+  while (current) {
+    Object.assign(opts, current.opts())
+    current = current.parent
+  }
+  return opts
+}
+
+/**
+ * Options specific to the tokens session command.
+ */
+export interface TokensSessionOptions {
+  /** Session ID to show token usage for */
+  session: string
+}
+
+/**
+ * Options specific to the tokens project command.
+ */
+export interface TokensProjectOptions {
+  /** Project ID to show token usage for */
+  project: string
+}
+
+/**
+ * Register tokens subcommands on the given parent command.
+ */
+export function registerTokensCommands(parent: Command): void {
+  const tokens = parent
+    .command("tokens")
+    .description("View token usage statistics")
+
+  tokens
+    .command("session")
+    .description("Show token usage for a session")
+    .requiredOption("--session <sessionId>", "Session ID to show token usage for")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const cmdOpts = this.opts()
+      const sessionOpts: TokensSessionOptions = {
+        session: String(cmdOpts.session),
+      }
+      try {
+        await handleTokensSession(globalOpts, sessionOpts)
+      } catch (error) {
+        handleError(error, globalOpts.format)
+      }
+    })
+
+  tokens
+    .command("project")
+    .description("Show token usage for a project")
+    .requiredOption("--project <projectId>", "Project ID to show token usage for")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const cmdOpts = this.opts()
+      const projectOpts: TokensProjectOptions = {
+        project: String(cmdOpts.project),
+      }
+      try {
+        await handleTokensProject(globalOpts, projectOpts)
+      } catch (error) {
+        handleError(error, globalOpts.format)
+      }
+    })
+
+  tokens
+    .command("global")
+    .description("Show global token usage")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      try {
+        await handleTokensGlobal(globalOpts)
+      } catch (error) {
+        handleError(error, globalOpts.format)
+      }
+    })
+}
+
+/**
+ * Handle the tokens session command.
+ */
+async function handleTokensSession(
+  globalOpts: GlobalOptions,
+  sessionOpts: TokensSessionOptions
+): Promise<void> {
+  // Load all sessions to find the one we want
+  const sessions = await loadSessionRecords({ root: globalOpts.root })
+
+  // Find the session by ID
+  const session = findSessionById(sessions, sessionOpts.session)
+
+  // Compute token summary for the session
+  const summary = await computeSessionTokenSummary(session, globalOpts.root)
+
+  // Output the result
+  const outputOpts = getOutputOptions(globalOpts)
+  printTokensOutput(summary, outputOpts.format)
+}
+
+/**
+ * Handle the tokens project command.
+ */
+async function handleTokensProject(
+  globalOpts: GlobalOptions,
+  projectOpts: TokensProjectOptions
+): Promise<void> {
+  // Load all projects to validate the project exists
+  const projects = await loadProjectRecords({ root: globalOpts.root })
+
+  // Find the project by ID (throws if not found)
+  findProjectById(projects, projectOpts.project)
+
+  // Load all sessions to compute token summary
+  const sessions = await loadSessionRecords({ root: globalOpts.root })
+
+  // Compute token summary for the project
+  const summary = await computeProjectTokenSummary(
+    projectOpts.project,
+    sessions,
+    globalOpts.root
+  )
+
+  // Output the result
+  const outputOpts = getOutputOptions(globalOpts)
+  printAggregateTokensOutput(summary, outputOpts.format, `Project: ${projectOpts.project}`)
+}
+
+/**
+ * Handle the tokens global command.
+ */
+async function handleTokensGlobal(globalOpts: GlobalOptions): Promise<void> {
+  // Load all sessions to compute global token summary
+  const sessions = await loadSessionRecords({ root: globalOpts.root })
+
+  // Compute token summary across all sessions
+  const summary = await computeGlobalTokenSummary(sessions, globalOpts.root)
+
+  // Output the result
+  const outputOpts = getOutputOptions(globalOpts)
+  printAggregateTokensOutput(summary, outputOpts.format, "Global")
+}

package/src/cli/commands/tui.ts

@@ -0,0 +1,36 @@
+/**
+ * TUI CLI subcommand.
+ *
+ * Provides a command to explicitly launch the Terminal UI from the CLI.
+ */
+
+import { Command, type OptionValues } from "commander"
+import { parseGlobalOptions } from "../index"
+
+/**
+ * Collect all options from a command and its ancestors.
+ * Commander stores global options on the root program, not on subcommands.
+ */
+function collectOptions(cmd: Command): OptionValues {
+  const opts: OptionValues = {}
+  let current: Command | null = cmd
+  while (current) {
+    Object.assign(opts, current.opts())
+    current = current.parent
+  }
+  return opts
+}
+
+/**
+ * Register the TUI subcommand on the given parent command.
+ */
+export function registerTUICommand(parent: Command): void {
+  parent
+    .command("tui")
+    .description("Launch the Terminal UI for interactive project management")
+    .action(async function (this: Command) {
+      const globalOpts = parseGlobalOptions(collectOptions(this))
+      const { launchTUI } = await import("../../tui/index")
+      await launchTUI({ root: globalOpts.root })
+    })
+}