@fiftth/fiftth-cli 0.1.0 → 1.0.0

package/src/git/gitService.ts

@@ -1,29 +1,29 @@
-import fs from 'fs'
-import path from 'path'
-import { simpleGit } from 'simple-git'
-
-export function checkRepoExists(repoPath: string): boolean {
-  return fs.existsSync(repoPath) && fs.statSync(repoPath).isDirectory()
-}
-
-export function checkGitRepo(repoPath: string): boolean {
-  const gitPath = path.join(repoPath, '.git')
-  return fs.existsSync(gitPath) && fs.statSync(gitPath).isDirectory()
-}
-
-export async function checkUncommittedChanges(repoPath: string): Promise<boolean> {
-  const git = simpleGit(repoPath)
-  const status = await git.status()
-
-  return !status.isClean()
-}
-
-export async function fetch(repoPath: string): Promise<void> {
-  const git = simpleGit(repoPath)
-  await git.fetch()
-}
-
-export async function checkoutBranch(repoPath: string, branch: string): Promise<void> {
-  const git = simpleGit(repoPath)
-  await git.checkout(branch)
-}
+import fs from 'fs'
+import path from 'path'
+import { simpleGit } from 'simple-git'
+
+export function checkRepoExists(repoPath: string): boolean {
+  return fs.existsSync(repoPath) && fs.statSync(repoPath).isDirectory()
+}
+
+export function checkGitRepo(repoPath: string): boolean {
+  const gitPath = path.join(repoPath, '.git')
+  return fs.existsSync(gitPath) && fs.statSync(gitPath).isDirectory()
+}
+
+export async function checkUncommittedChanges(repoPath: string): Promise<boolean> {
+  const git = simpleGit(repoPath)
+  const status = await git.status()
+
+  return !status.isClean()
+}
+
+export async function fetch(repoPath: string): Promise<void> {
+  const git = simpleGit(repoPath)
+  await git.fetch()
+}
+
+export async function checkoutBranch(repoPath: string, branch: string): Promise<void> {
+  const git = simpleGit(repoPath)
+  await git.checkout(branch)
+}

package/src/index.ts

@@ -1,133 +1,133 @@
-#!/usr/bin/env node
-import { Command } from 'commander'
-import chalk from 'chalk'
-import { loginCommand, logoutCommand, loginStatusCommand } from './commands/login.js'
-import { useCommand } from './commands/use.js'
-import { registerRepoCommands } from './commands/repo.js'
-import { tasksCommand } from './commands/tasks.js'
-import { checkoutCommand } from './commands/checkout.js'
-import { loadConfig, getConfigPath } from './utils/config.js'
-import { cmd, fail, kv, muted, ok, section, title } from './utils/ui.js'
-
-const program = new Command()
-
-program
-  .name('fiftth')
-  .description('Startup-grade CLI for autonomous software teams')
-  .version('0.1.0', '-v, --version', 'Output the current version')
-  .addHelpText(
-    'before',
-    `\n${title('Fiftth CLI')}\n${muted('start orchestrating your AI engineering workflows.')}\n`,
-  )
-  .addHelpText(
-    'after',
-    `
-${chalk.dim('Examples:')}
-  ${cmd('$ fiftth login')}                      Authenticate with Fiftth
-  ${cmd('$ fiftth login --token <tok>')}        Authenticate using a token directly
-  ${cmd('$ fiftth use my-workspace')}           Switch to a workspace
-  ${cmd('$ fiftth use')}                        Interactively select a workspace
-  ${cmd('$ fiftth use --list')}                 List all available workspaces
-  ${cmd('$ fiftth repo add api ~/dev/api')}     Register a local git repository
-  ${cmd('$ fiftth repo list')}                  List configured repositories
-  ${cmd('$ fiftth tasks')}                      Select an active task and inspect repos
-  ${cmd('$ fiftth checkout owner/repo')}        Checkout selected task branch
-`,
-  )
-
-// ─── fiftth login ──────────────────────────────────────────────────────────
-const loginCmd = program
-  .command('login')
-  .description('Authenticate with the Fiftth platform')
-  .option('-t, --token <token>', 'Access token (for non-interactive / CI use)')
-  .option('--host <host>', 'API host (defaults to https://api.fiftth.io)')
-  .addHelpText(
-    'after',
-    `
-${chalk.dim('Examples:')}
-  ${chalk.cyan('$ fiftth login')}
-  ${chalk.cyan('$ fiftth login --token ghp_xxxxxxxxxxxx')}
-  ${chalk.cyan('$ fiftth login --host https://selfhosted.example.com')}
-`,
-  )
-
-loginCmd
-  .command('status')
-  .description('Show current authentication status')
-  .action(async () => {
-    await loginStatusCommand().catch(handleError)
-  })
-
-loginCmd
-  .command('logout')
-  .description('Log out and remove stored credentials')
-  .action(async () => {
-    await logoutCommand().catch(handleError)
-  })
-
-loginCmd.action(async (options: { token?: string; host?: string }) => {
-  await loginCommand(options).catch(handleError)
-})
-
-// ─── fiftth use ────────────────────────────────────────────────────────────
-program
-  .command('use [workspace]')
-  .description('Select the active workspace')
-  .option('-l, --list', 'List all available workspaces')
-  .addHelpText(
-    'after',
-    `
-${chalk.dim('Examples:')}
-  ${chalk.cyan('$ fiftth use')}                 Interactively select a workspace
-  ${chalk.cyan('$ fiftth use my-workspace')}     Switch directly to a workspace by slug or name
-  ${chalk.cyan('$ fiftth use --list')}           List all workspaces
-`,
-  )
-  .action(async (workspace: string | undefined, options: { list?: boolean }) => {
-    await useCommand(workspace, options).catch(handleError)
-  })
-
-// ─── fiftth config ─────────────────────────────────────────────────────────
-program
-  .command('config')
-  .description('Show current CLI configuration')
-  .action(() => {
-    const config = loadConfig()
-    console.log(`\n${section('CLI configuration')}\n`)
-    console.log(kv('Config file', cmd(getConfigPath())))
-    console.log(kv('Host', cmd(config.host)))
-    console.log(kv('Workspace', config.workspace ? cmd(config.workspace) : muted('(none)')))
-    console.log(kv('Logged in', config.token ? ok('yes') : fail('no')))
-    console.log()
-  })
-
-// ─── fiftth repo ───────────────────────────────────────────────────────────
-registerRepoCommands(program)
-
-// ─── fiftth tasks ──────────────────────────────────────────────────────────
-program
-  .command('tasks')
-  .description('List and select active tasks')
-  .action(async () => {
-    await tasksCommand().catch(handleError)
-  })
-
-// ─── fiftth checkout ───────────────────────────────────────────────────────
-program
-  .command('checkout <repoName>')
-  .description('Checkout the selected task branch for a repository')
-  .action(async (repoName: string) => {
-    await checkoutCommand(repoName).catch(handleError)
-  })
-
-// ─── Error handling ────────────────────────────────────────────────────────
-function handleError(err: unknown): void {
-  if (err instanceof Error) {
-    console.error(`\n${fail(`Error: ${err.message}`)}\n`)
-  } else {
-    console.error(`\n${fail('An unexpected error occurred.')}\n`)
-  }
-  process.exit(1)
-}
-
-program.parse()
+#!/usr/bin/env node
+import { Command } from 'commander'
+import chalk from 'chalk'
+import { loginCommand, logoutCommand, loginStatusCommand } from './commands/login.js'
+import { useCommand } from './commands/use.js'
+import { registerRepoCommands } from './commands/repo.js'
+import { tasksCommand } from './commands/tasks.js'
+import { checkoutCommand } from './commands/checkout.js'
+import { loadConfig, getConfigPath } from './utils/config.js'
+import { cmd, fail, kv, muted, ok, section, title } from './utils/ui.js'
+
+const program = new Command()
+
+program
+  .name('fiftth')
+  .description('Startup-grade CLI for autonomous software teams')
+  .version('0.1.0', '-v, --version', 'Output the current version')
+  .addHelpText(
+    'before',
+    `\n${title('Fiftth CLI')}\n${muted('start orchestrating your AI engineering workflows.')}\n`,
+  )
+  .addHelpText(
+    'after',
+    `
+${chalk.dim('Examples:')}
+  ${cmd('$ fiftth login')}                      Authenticate with Fiftth
+  ${cmd('$ fiftth login --token <tok>')}        Authenticate using a token directly
+  ${cmd('$ fiftth use my-workspace')}           Switch to a workspace
+  ${cmd('$ fiftth use')}                        Interactively select a workspace
+  ${cmd('$ fiftth use --list')}                 List all available workspaces
+  ${cmd('$ fiftth repo add api ~/dev/api')}     Register a local git repository
+  ${cmd('$ fiftth repo list')}                  List configured repositories
+  ${cmd('$ fiftth tasks')}                      Select an active task and inspect repos
+  ${cmd('$ fiftth checkout <taskId>')}          Checkout task branches in all linked repositories
+`,
+  )
+
+// ─── fiftth login ──────────────────────────────────────────────────────────
+const loginCmd = program
+  .command('login')
+  .description('Authenticate with the Fiftth platform')
+  .option('-t, --token <token>', 'Access token (for non-interactive / CI use)')
+  .option('--host <host>', 'API host (defaults to https://api.fiftth.io)')
+  .addHelpText(
+    'after',
+    `
+${chalk.dim('Examples:')}
+  ${chalk.cyan('$ fiftth login')}
+  ${chalk.cyan('$ fiftth login --token ghp_xxxxxxxxxxxx')}
+  ${chalk.cyan('$ fiftth login --host https://selfhosted.example.com')}
+`,
+  )
+
+loginCmd
+  .command('status')
+  .description('Show current authentication status')
+  .action(async () => {
+    await loginStatusCommand().catch(handleError)
+  })
+
+loginCmd
+  .command('logout')
+  .description('Log out and remove stored credentials')
+  .action(async () => {
+    await logoutCommand().catch(handleError)
+  })
+
+loginCmd.action(async (options: { token?: string; host?: string }) => {
+  await loginCommand(options).catch(handleError)
+})
+
+// ─── fiftth use ────────────────────────────────────────────────────────────
+program
+  .command('use [workspace]')
+  .description('Select the active workspace')
+  .option('-l, --list', 'List all available workspaces')
+  .addHelpText(
+    'after',
+    `
+${chalk.dim('Examples:')}
+  ${chalk.cyan('$ fiftth use')}                 Interactively select a workspace
+  ${chalk.cyan('$ fiftth use my-workspace')}     Switch directly to a workspace by slug or name
+  ${chalk.cyan('$ fiftth use --list')}           List all workspaces
+`,
+  )
+  .action(async (workspace: string | undefined, options: { list?: boolean }) => {
+    await useCommand(workspace, options).catch(handleError)
+  })
+
+// ─── fiftth config ─────────────────────────────────────────────────────────
+program
+  .command('config')
+  .description('Show current CLI configuration')
+  .action(() => {
+    const config = loadConfig()
+    console.log(`\n${section('CLI configuration')}\n`)
+    console.log(kv('Config file', cmd(getConfigPath())))
+    console.log(kv('Host', cmd(config.host)))
+    console.log(kv('Workspace', config.workspace ? cmd(config.workspace) : muted('(none)')))
+    console.log(kv('Logged in', config.token ? ok('yes') : fail('no')))
+    console.log()
+  })
+
+// ─── fiftth repo ───────────────────────────────────────────────────────────
+registerRepoCommands(program)
+
+// ─── fiftth tasks ──────────────────────────────────────────────────────────
+program
+  .command('tasks')
+  .description('List and select active tasks')
+  .action(async () => {
+    await tasksCommand().catch(handleError)
+  })
+
+// ─── fiftth checkout ───────────────────────────────────────────────────────
+program
+  .command('checkout <taskId>')
+  .description('Checkout the selected task branches for all linked repositories')
+  .action(async (taskId: string) => {
+    await checkoutCommand(taskId).catch(handleError)
+  })
+
+// ─── Error handling ────────────────────────────────────────────────────────
+function handleError(err: unknown): void {
+  if (err instanceof Error) {
+    console.error(`\n${fail(`Error: ${err.message}`)}\n`)
+  } else {
+    console.error(`\n${fail('An unexpected error occurred.')}\n`)
+  }
+  process.exit(1)
+}
+
+program.parse()

package/src/services/taskContext.ts

@@ -1,32 +1,32 @@
-export interface SelectedTaskRepository {
-  repoName: string
-  branch: string
-}
-
-export interface SelectedTaskContext {
-  taskId: string
-  title: string
-  repositories: SelectedTaskRepository[]
-}
-
-let selectedTaskContext: SelectedTaskContext | null = null
-
-export function setSelectedTaskContext(task: SelectedTaskContext): void {
-  selectedTaskContext = task
-}
-
-export function getSelectedTaskContext(): SelectedTaskContext | null {
-  return selectedTaskContext
-}
-
-export function getSelectedTaskBranch(repoName: string): string | undefined {
-  const repository = selectedTaskContext?.repositories.find(
-    (entry) => entry.repoName === repoName,
-  )
-
-  return repository?.branch
-}
-
-export function clearSelectedTaskContext(): void {
-  selectedTaskContext = null
-}
+export interface SelectedTaskRepository {
+  repoName: string
+  branch: string
+}
+
+export interface SelectedTaskContext {
+  taskId: string
+  title: string
+  repositories: SelectedTaskRepository[]
+}
+
+let selectedTaskContext: SelectedTaskContext | null = null
+
+export function setSelectedTaskContext(task: SelectedTaskContext): void {
+  selectedTaskContext = task
+}
+
+export function getSelectedTaskContext(): SelectedTaskContext | null {
+  return selectedTaskContext
+}
+
+export function getSelectedTaskBranch(repoName: string): string | undefined {
+  const repository = selectedTaskContext?.repositories.find(
+    (entry) => entry.repoName === repoName,
+  )
+
+  return repository?.branch
+}
+
+export function clearSelectedTaskContext(): void {
+  selectedTaskContext = null
+}

package/src/services/taskService.ts

@@ -1,45 +1,53 @@
-import { createApiClient } from '../api/client.js'
-
-const ALLOWED_COLUMNS = new Set(['IN_PROGRESS', 'HUMAN_REVIEW'])
-
-interface ApiTaskRepository {
-  fullName: string
-  githubPrBranch: string
-}
-
-interface ApiTask {
-  id: string
-  title: string
-  column: string
-  repositories?: ApiTaskRepository[]
-}
-
-export interface TaskRepository {
-  fullName: string
-  branch: string
-}
-  
-export interface Task {
-  id: string
-  title: string
-  column: string
-  repositories: TaskRepository[]
-}
-
-export async function fetchActiveTasks(workspaceId: string): Promise<Task[]> {
-  const client = createApiClient()
-  const query = new URLSearchParams({ workspaceId }).toString()
-  const tasks = await client.get<ApiTask[]>(`/tasks?${query}`)
-
-  return tasks
-    .filter((task) => ALLOWED_COLUMNS.has(task.column))
-    .map((task) => ({
-      id: task.id,
-      title: task.title,
-      column: task.column,
-      repositories: (task.repositories ?? []).map((repository) => ({
-        fullName: repository.fullName,
-        branch: repository.githubPrBranch,
-      })),
-    }))
-}
+import { createApiClient } from '../api/client.js'
+
+const ALLOWED_COLUMNS = new Set(['IN_PROGRESS', 'HUMAN_REVIEW'])
+
+interface ApiTaskRepository {
+  fullName: string
+  githubPrBranch: string
+}
+
+interface ApiTask {
+  id: string
+  title: string
+  column: string
+  repositories?: ApiTaskRepository[]
+}
+
+export interface TaskRepository {
+  fullName: string
+  branch: string
+}
+  
+export interface Task {
+  id: string
+  title: string
+  column: string
+  repositories: TaskRepository[]
+}
+
+export async function moveTaskToHumanReview(taskId: string): Promise<void> {
+  const client = createApiClient()
+  await client.post(`/tasks/${taskId}/move`, {
+    targetColumn: 'HUMAN_REVIEW',
+    targetOrder: 0,
+  })
+}
+
+export async function fetchActiveTasks(workspaceId: string): Promise<Task[]> {
+  const client = createApiClient()
+  const query = new URLSearchParams({ workspaceId }).toString()
+  const tasks = await client.get<ApiTask[]>(`/tasks?${query}`)
+
+  return tasks
+    .filter((task) => ALLOWED_COLUMNS.has(task.column))
+    .map((task) => ({
+      id: task.id,
+      title: task.title,
+      column: task.column,
+      repositories: (task.repositories ?? []).map((repository) => ({
+        fullName: repository.fullName,
+        branch: repository.githubPrBranch,
+      })),
+    }))
+}

package/src/utils/api.ts

@@ -1,41 +1,41 @@
-import { loadConfig } from './config.js'
-
-export interface Workspace {
-  id: string
-  name: string
-  slug: string
-}
-
-export interface ApiClient {
-  getWorkspaces(): Promise<Workspace[]>
-}
-
-export function createApiClient(): ApiClient {
-  const config = loadConfig()
-
-  async function request<T>(endpoint: string): Promise<T> {
-    const url = `${config.host}${endpoint}`
-    const response = await fetch(url, {
-      headers: {
-        Authorization: `Bearer ${config.token}`,
-        'Content-Type': 'application/json',
-        'User-Agent': 'fiftth-cli/0.1.0',
-      },
-    })
-
-    if (!response.ok) {
-      const body = await response.text().catch(() => '')
-      throw new Error(
-        `API request failed: ${response.status} ${response.statusText}${body ? ` — ${body}` : ''}`,
-      )
-    }
-
-    return response.json() as Promise<T>
-  }
-
-  return {
-    getWorkspaces(): Promise<Workspace[]> {
-      return request<Workspace[]>('/workspaces')
-    },
-  }
-}
+import { loadConfig } from './config.js'
+
+export interface Workspace {
+  id: string
+  name: string
+  slug: string
+}
+
+export interface ApiClient {
+  getWorkspaces(): Promise<Workspace[]>
+}
+
+export function createApiClient(): ApiClient {
+  const config = loadConfig()
+
+  async function request<T>(endpoint: string): Promise<T> {
+    const url = `${config.host}${endpoint}`
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${config.token}`,
+        'Content-Type': 'application/json',
+        'User-Agent': 'fiftth-cli/0.1.0',
+      },
+    })
+
+    if (!response.ok) {
+      const body = await response.text().catch(() => '')
+      throw new Error(
+        `API request failed: ${response.status} ${response.statusText}${body ? ` — ${body}` : ''}`,
+      )
+    }
+
+    return response.json() as Promise<T>
+  }
+
+  return {
+    getWorkspaces(): Promise<Workspace[]> {
+      return request<Workspace[]>('/workspaces')
+    },
+  }
+}