ralphctl 0.1.0 → 0.1.2

package/src/interactive/menu.ts

@@ -1,403 +0,0 @@
-import { Separator } from '@inquirer/prompts';
-import { colors } from '@src/theme/index.ts';
-import type { NextAction } from './dashboard.ts';
-
-/**
- * Dynamic context-aware menu system for interactive mode
- */
-
-const SEPARATOR_WIDTH = 48;
-
-/** Create a titled separator: ── LABEL ──────────── */
-function titled(label: string): SeparatorInstance {
-  const lineLen = Math.max(2, SEPARATOR_WIDTH - label.length - 4); // 4 = "── " + " "
-  return new Separator(colors.muted(`\n── ${label} ${'─'.repeat(lineLen)}`));
-}
-
-/** Plain line separator: ────────────────────────── */
-function line(): SeparatorInstance {
-  return new Separator(colors.muted('─'.repeat(SEPARATOR_WIDTH)));
-}
-
-interface Choice {
-  name: string;
-  value: string;
-  description?: string;
-  disabled?: string | boolean;
-}
-
-type SeparatorInstance = InstanceType<typeof Separator>;
-
-export type MenuItem = Choice | SeparatorInstance;
-
-export interface SubMenu {
-  title: string;
-  items: MenuItem[];
-}
-
-/** Sprint/ticket/task counts for menu context */
-export interface MenuContext {
-  hasProjects: boolean;
-  projectCount: number;
-  currentSprintId: string | null;
-  currentSprintName: string | null;
-  currentSprintStatus: 'draft' | 'active' | 'closed' | null;
-  ticketCount: number;
-  taskCount: number;
-  tasksDone: number;
-  tasksInProgress: number;
-  pendingRequirements: number;
-  allRequirementsApproved: boolean;
-  /** Number of tickets that have at least one associated task */
-  plannedTicketCount: number;
-  nextAction: NextAction | null;
-  /** Current AI provider setting */
-  aiProvider: string | null;
-}
-
-// ============================================================================
-// WORKFLOW ACTIONS — actions that advance sprint state
-// ============================================================================
-
-const WORKFLOW_ACTIONS: Record<string, Set<string>> = {
-  sprint: new Set(['create', 'refine', 'ideate', 'plan', 'start', 'close']),
-  ticket: new Set(['add', 'refine']),
-  task: new Set(['add', 'import']),
-  progress: new Set(['log']),
-};
-
-/**
- * Check if a command is a workflow action that should return to main menu.
- */
-export function isWorkflowAction(group: string, subCommand: string): boolean {
-  return WORKFLOW_ACTIONS[group]?.has(subCommand) ?? false;
-}
-
-/**
- * Build PLAN section actions — sprint planning lifecycle.
- */
-function buildPlanActions(ctx: MenuContext): MenuItem[] {
-  const items: MenuItem[] = [];
-  const isDraft = ctx.currentSprintStatus === 'draft';
-  const hasSprint = ctx.currentSprintId !== null;
-
-  // Create Sprint — always available
-  items.push({ name: 'Create Sprint', value: 'action:sprint:create', description: 'Start a new sprint' });
-
-  // Add Ticket — requires draft sprint + projects
-  const addTicketDisabled = !hasSprint
-    ? 'create a sprint first'
-    : !isDraft
-      ? 'need draft sprint'
-      : !ctx.hasProjects
-        ? 'add a project first'
-        : false;
-  items.push({
-    name: 'Add Ticket',
-    value: 'action:ticket:add',
-    description: 'Add work to current sprint',
-    disabled: addTicketDisabled,
-  });
-
-  // Refine Requirements — requires draft sprint + pending tickets
-  let refineDisabled: string | false = false;
-  let refineDesc = 'Clarify ticket requirements';
-  if (!hasSprint) {
-    refineDisabled = 'create a sprint first';
-  } else if (!isDraft) {
-    refineDisabled = 'need draft sprint';
-  } else if (ctx.ticketCount === 0) {
-    refineDisabled = 'add tickets first';
-  } else if (ctx.pendingRequirements === 0) {
-    refineDisabled = 'all tickets refined';
-  } else {
-    refineDesc = `${String(ctx.pendingRequirements)} ticket${ctx.pendingRequirements !== 1 ? 's' : ''} pending`;
-  }
-  items.push({
-    name: 'Refine Requirements',
-    value: 'action:sprint:refine',
-    description: refineDesc,
-    disabled: refineDisabled,
-  });
-
-  // Plan Tasks — requires draft sprint
-  let planDisabled: string | false = false;
-  const planDesc = 'Generate tasks from requirements';
-  if (!hasSprint) {
-    planDisabled = 'create a sprint first';
-  } else if (!isDraft) {
-    planDisabled = 'need draft sprint';
-  } else if (ctx.ticketCount === 0) {
-    planDisabled = 'add tickets first';
-  } else if (!ctx.allRequirementsApproved) {
-    planDisabled = 'refine all tickets first';
-  }
-  items.push({
-    name: ctx.taskCount > 0 ? 'Re-Plan Tasks' : 'Plan Tasks',
-    value: 'action:sprint:plan',
-    description: planDesc,
-    disabled: planDisabled,
-  });
-
-  // Ideate — requires draft + projects
-  const ideateDisabled = !hasSprint
-    ? 'create a sprint first'
-    : !isDraft
-      ? 'need draft sprint'
-      : !ctx.hasProjects
-        ? 'add a project first'
-        : false;
-  items.push({
-    name: 'Ideate',
-    value: 'action:sprint:ideate',
-    description: 'Quick idea to tasks',
-    disabled: ideateDisabled,
-  });
-
-  return items;
-}
-
-/**
- * Build EXECUTE section actions — sprint execution lifecycle.
- */
-function buildExecuteActions(ctx: MenuContext): MenuItem[] {
-  const items: MenuItem[] = [];
-  const isDraft = ctx.currentSprintStatus === 'draft';
-  const isActive = ctx.currentSprintStatus === 'active';
-  const hasSprint = ctx.currentSprintId !== null;
-
-  // Start Sprint — requires draft/active + tasks
-  let startDisabled: string | false = false;
-  if (!hasSprint) {
-    startDisabled = 'create a sprint first';
-  } else if (!isDraft && !isActive) {
-    startDisabled = 'need draft or active sprint';
-  } else if (ctx.taskCount === 0) {
-    startDisabled = 'plan tasks first';
-  }
-  items.push({
-    name: 'Start Sprint',
-    value: 'action:sprint:start',
-    description: 'Begin implementation',
-    disabled: startDisabled,
-  });
-
-  // Health Check — requires a sprint
-  items.push({
-    name: 'Health Check',
-    value: 'action:sprint:health',
-    description: 'Diagnose blockers and stale tasks',
-    disabled: !hasSprint ? 'no sprint' : false,
-  });
-
-  // Close Sprint — requires active sprint
-  items.push({
-    name: 'Close Sprint',
-    value: 'action:sprint:close',
-    description: 'Close the current sprint',
-    disabled: !isActive ? 'need active sprint' : false,
-  });
-
-  return items;
-}
-
-/**
- * Build main menu items based on current application state.
- */
-export function buildMainMenu(ctx: MenuContext): { items: MenuItem[]; defaultValue?: string } {
-  const items: MenuItem[] = [];
-
-  // Next action — first item, default selection
-  let defaultValue: string | undefined;
-  if (ctx.nextAction) {
-    const actionValue = `action:${ctx.nextAction.group}:${ctx.nextAction.subCommand}`;
-    items.push({
-      name: `\u2192 ${ctx.nextAction.label}`,
-      value: actionValue,
-      description: ctx.nextAction.description,
-    });
-    defaultValue = actionValue;
-  }
-
-  // Plan section — sprint planning lifecycle
-  items.push(titled('PLAN'));
-  for (const action of buildPlanActions(ctx)) {
-    items.push(action);
-  }
-
-  // Execute section — sprint execution lifecycle
-  items.push(titled('EXECUTE'));
-  for (const action of buildExecuteActions(ctx)) {
-    items.push(action);
-  }
-
-  // Browse section — entity submenus
-  items.push(titled('BROWSE'));
-  items.push({ name: 'Sprints', value: 'sprint', description: 'List, show, switch' });
-  items.push({ name: 'Tickets', value: 'ticket', description: 'List, show, edit' });
-  items.push({ name: 'Tasks', value: 'task', description: 'List, show, manage' });
-
-  // Setup section — one-time configuration
-  items.push(titled('SETUP'));
-  items.push({ name: 'Projects', value: 'project', description: 'Manage projects & repositories' });
-  items.push({ name: 'Configuration', value: 'config', description: 'AI provider, settings' });
-  items.push({ name: 'Doctor', value: 'action:doctor:run', description: 'Check environment health' });
-
-  // Session
-  items.push(titled('SESSION'));
-  if (!ctx.currentSprintId) {
-    items.push({ name: 'Quick Start Wizard', value: 'wizard', description: 'Guided sprint setup' });
-  }
-  items.push({ name: 'Exit', value: 'exit' });
-
-  return { items, defaultValue };
-}
-
-/**
- * Build sprint submenu — browse/manage only (workflow actions are in main menu).
- */
-function buildSprintSubMenu(ctx: MenuContext): SubMenu {
-  const items: MenuItem[] = [];
-
-  items.push(titled('BROWSE'));
-  items.push({ name: 'List', value: 'list', description: 'List all sprints' });
-  items.push({ name: 'Show', value: 'show', description: 'Show sprint details' });
-  items.push({ name: 'Set Current', value: 'current', description: 'Set current sprint' });
-  items.push(titled('EXPORT'));
-  items.push({
-    name: 'Requirements',
-    value: 'requirements',
-    description: 'Export refined requirements',
-  });
-  items.push({ name: 'Context', value: 'context', description: 'Output full sprint context' });
-  items.push({ name: 'Progress', value: 'progress show', description: 'View progress log' });
-  items.push(titled('MANAGE'));
-  items.push({ name: 'Log Progress', value: 'progress log', description: 'Add progress entry' });
-  items.push({ name: 'Delete', value: 'delete', description: 'Delete a sprint permanently' });
-  items.push(line());
-  items.push({ name: 'Back', value: 'back', description: 'Return to main menu' });
-
-  const titleSuffix = ctx.currentSprintName
-    ? ` \u2014 ${ctx.currentSprintName} (${ctx.currentSprintStatus ?? 'unknown'})`
-    : '';
-  return { title: `Sprint${titleSuffix}`, items };
-}
-
-/**
- * Build ticket submenu with state-aware descriptions.
- */
-function buildTicketSubMenu(ctx: MenuContext): SubMenu {
-  const items: MenuItem[] = [];
-
-  items.push({
-    name: 'Add',
-    value: 'add',
-    description: ctx.hasProjects ? 'Add a ticket' : 'Add a ticket (add a project first)',
-    disabled: !ctx.hasProjects ? 'add a project first' : false,
-  });
-  items.push({ name: 'Edit', value: 'edit', description: 'Edit a ticket' });
-  items.push({ name: 'List', value: 'list', description: 'List all tickets' });
-  items.push({ name: 'Show', value: 'show', description: 'Show ticket details' });
-
-  // Re-refine — requires draft sprint with approved tickets
-  const approvedCount = ctx.ticketCount - ctx.pendingRequirements;
-  let refineDisabled: string | false = false;
-  if (ctx.currentSprintStatus !== 'draft') {
-    refineDisabled = 'need draft sprint';
-  } else if (approvedCount === 0) {
-    refineDisabled = 'no approved tickets';
-  }
-  items.push({
-    name: 'Refine',
-    value: 'refine',
-    description: 'Re-refine approved requirements',
-    disabled: refineDisabled,
-  });
-
-  items.push(line());
-  items.push({ name: 'Remove', value: 'remove', description: 'Remove a ticket' });
-  items.push({ name: 'Back', value: 'back', description: 'Return to main menu' });
-
-  const titleSuffix = ctx.currentSprintName ? ` \u2014 ${ctx.currentSprintName}` : '';
-  return { title: `Ticket${titleSuffix}`, items };
-}
-
-/**
- * Build task submenu.
- */
-function buildTaskSubMenu(ctx: MenuContext): SubMenu {
-  const items: MenuItem[] = [];
-
-  items.push(titled('VIEW'));
-  items.push({ name: 'List', value: 'list', description: 'List all tasks' });
-  items.push({ name: 'Show', value: 'show', description: 'Show task details' });
-  items.push({ name: 'Next', value: 'next', description: 'Get next task' });
-  items.push(titled('MANAGE'));
-  items.push({ name: 'Add', value: 'add', description: 'Add a new task' });
-  items.push({ name: 'Import', value: 'import', description: 'Import from JSON' });
-  items.push({ name: 'Status', value: 'status', description: 'Update status' });
-  items.push({ name: 'Reorder', value: 'reorder', description: 'Change priority' });
-  items.push(line());
-  items.push({ name: 'Remove', value: 'remove', description: 'Remove a task' });
-  items.push({ name: 'Back', value: 'back', description: 'Return to main menu' });
-
-  const titleSuffix = ctx.currentSprintName ? ` \u2014 ${ctx.currentSprintName}` : '';
-  return { title: `Task${titleSuffix}`, items };
-}
-
-/**
- * Build project submenu.
- */
-function buildProjectSubMenu(): SubMenu {
-  const items: MenuItem[] = [];
-
-  items.push({ name: 'Add', value: 'add', description: 'Add a new project' });
-  items.push({ name: 'List', value: 'list', description: 'List all projects' });
-  items.push({ name: 'Show', value: 'show', description: 'Show project details' });
-  items.push(titled('REPOSITORIES'));
-  items.push({
-    name: 'Add Repository',
-    value: 'repo add',
-    description: 'Add repository to project',
-  });
-  items.push({ name: 'Remove Repository', value: 'repo remove', description: 'Remove repository' });
-  items.push(line());
-  items.push({ name: 'Remove', value: 'remove', description: 'Remove a project' });
-  items.push({ name: 'Back', value: 'back', description: 'Return to main menu' });
-
-  return { title: 'Project', items };
-}
-
-/**
- * Build config submenu.
- */
-function buildConfigSubMenu(): SubMenu {
-  const items: MenuItem[] = [];
-
-  items.push({ name: 'Show Settings', value: 'show', description: 'View current configuration' });
-  items.push({ name: 'Set AI Provider', value: 'set provider', description: 'Choose Claude Code or GitHub Copilot' });
-  items.push(line());
-  items.push({ name: 'Back', value: 'back', description: 'Return to main menu' });
-
-  return { title: 'Configuration', items };
-}
-
-/**
- * Build a submenu by group name with full context.
- */
-export function buildSubMenu(group: string, ctx: MenuContext): SubMenu | null {
-  switch (group) {
-    case 'sprint':
-      return buildSprintSubMenu(ctx);
-    case 'ticket':
-      return buildTicketSubMenu(ctx);
-    case 'task':
-      return buildTaskSubMenu(ctx);
-    case 'project':
-      return buildProjectSubMenu();
-    case 'config':
-      return buildConfigSubMenu();
-    default:
-      return null;
-  }
-}

package/src/interactive/selectors.ts

@@ -1,273 +0,0 @@
-import { checkbox, confirm, input } from '@inquirer/prompts';
-import { listProjects } from '@src/store/project.ts';
-import { listSprints } from '@src/store/sprint.ts';
-import { formatTicketDisplay, listTickets } from '@src/store/ticket.ts';
-import { listTasks } from '@src/store/task.ts';
-import { emoji, formatSprintStatus, formatTaskStatus } from '@src/theme/ui.ts';
-import { muted } from '@src/theme/index.ts';
-import type { Repository, SprintStatus, TaskStatus, Ticket } from '@src/schemas/index.ts';
-import { escapableSelect } from './escapable.ts';
-
-/**
- * Select a project from the list.
- * @returns project name or null if no projects exist
- */
-export async function selectProject(message = 'Select project:'): Promise<string | null> {
-  const projects = await listProjects();
-  if (projects.length === 0) {
-    console.log(muted('\nNo projects found.'));
-    const create = await confirm({
-      message: 'Create one now?',
-      default: true,
-    });
-    if (create) {
-      const { projectAddCommand } = await import('@src/commands/project/add.ts');
-      await projectAddCommand({ interactive: true });
-      // Re-check after creation
-      const updated = await listProjects();
-      if (updated.length === 0) return null;
-      if (updated.length === 1 && updated[0]) return updated[0].name;
-      // Fall through to selection below
-      return escapableSelect({
-        message: `${emoji.donut} ${message}`,
-        choices: updated.map((p) => ({
-          name: p.displayName,
-          value: p.name,
-          description: p.description,
-        })),
-      });
-    }
-    return null;
-  }
-
-  return escapableSelect({
-    message: `${emoji.donut} ${message}`,
-    choices: projects.map((p) => ({
-      name: p.displayName,
-      value: p.name,
-      description: p.description,
-    })),
-  });
-}
-
-/**
- * Select a project and then a repository within it.
- * Auto-selects if only one option available at each step.
- * @returns repository path or null if no projects exist
- */
-export async function selectProjectRepository(message = 'Select repository:'): Promise<string | null> {
-  const projects = await listProjects();
-  if (projects.length === 0) {
-    console.log(muted('\nNo projects found.\n'));
-    return null;
-  }
-
-  // Step 1: Select project (auto-select if only one)
-  let projectName: string | null;
-  const firstProject = projects[0];
-  if (projects.length === 1 && firstProject) {
-    projectName = firstProject.name;
-  } else {
-    projectName = await escapableSelect({
-      message: `${emoji.donut} Select project:`,
-      choices: projects.map((p) => ({
-        name: p.displayName,
-        value: p.name,
-        description: `${String(p.repositories.length)} repo(s)`,
-      })),
-    });
-  }
-
-  if (!projectName) return null;
-
-  const project = projects.find((p) => p.name === projectName);
-  if (!project) {
-    return null;
-  }
-
-  // Step 2: Select repository (auto-select if only one)
-  const firstRepo = project.repositories[0];
-  if (project.repositories.length === 1 && firstRepo) {
-    return firstRepo.path;
-  }
-
-  return escapableSelect({
-    message: `${emoji.donut} ${message}`,
-    choices: project.repositories.map((r) => ({
-      name: r.name,
-      value: r.path,
-      description: r.path,
-    })),
-  });
-}
-
-/**
- * Select a sprint from the list, optionally filtered by status.
- * @returns sprint ID or null if no matching sprints
- */
-export async function selectSprint(message = 'Select sprint:', filter?: SprintStatus[]): Promise<string | null> {
-  const sprints = await listSprints();
-  const filtered = filter ? sprints.filter((s) => filter.includes(s.status)) : sprints;
-
-  if (filtered.length === 0) {
-    console.log(muted('\nNo sprints found.'));
-    const create = await confirm({
-      message: 'Create one now?',
-      default: true,
-    });
-    if (create) {
-      const { sprintCreateCommand } = await import('@src/commands/sprint/create.ts');
-      await sprintCreateCommand({ interactive: true });
-      // Re-check
-      const updated = await listSprints();
-      const refiltered = filter ? updated.filter((s) => filter.includes(s.status)) : updated;
-      if (refiltered.length === 0) return null;
-      if (refiltered.length === 1 && refiltered[0]) return refiltered[0].id;
-      return escapableSelect({
-        message: `${emoji.donut} ${message}`,
-        choices: refiltered.map((s) => ({
-          name: `${s.id} - ${s.name} (${formatSprintStatus(s.status)})`,
-          value: s.id,
-        })),
-      });
-    }
-    return null;
-  }
-
-  return escapableSelect({
-    message: `${emoji.donut} ${message}`,
-    choices: filtered.map((s) => ({
-      name: `${s.id} - ${s.name} (${formatSprintStatus(s.status)})`,
-      value: s.id,
-    })),
-  });
-}
-
-/**
- * Select a ticket from the current sprint, optionally filtered.
- * @returns ticket ID or null if no tickets exist/match
- */
-export async function selectTicket(
-  message = 'Select ticket:',
-  filter?: (t: Ticket) => boolean
-): Promise<string | null> {
-  const tickets = await listTickets();
-  const filtered = filter ? tickets.filter(filter) : tickets;
-
-  if (filtered.length === 0) {
-    if (tickets.length === 0) {
-      console.log(muted('\nNo tickets found.'));
-      const create = await confirm({
-        message: 'Add one now?',
-        default: true,
-      });
-      if (create) {
-        const { ticketAddCommand } = await import('@src/commands/ticket/add.ts');
-        await ticketAddCommand({ interactive: true });
-        // Re-check
-        const updated = await listTickets();
-        const refiltered = filter ? updated.filter(filter) : updated;
-        if (refiltered.length === 0) return null;
-        if (refiltered.length === 1 && refiltered[0]) return refiltered[0].id;
-        return escapableSelect({
-          message: `${emoji.donut} ${message}`,
-          choices: refiltered.map((t) => ({
-            name: formatTicketDisplay(t),
-            value: t.id,
-          })),
-        });
-      }
-      return null;
-    }
-    console.log(muted('\nNo matching tickets found.\n'));
-    return null;
-  }
-
-  return escapableSelect({
-    message: `${emoji.donut} ${message}`,
-    choices: filtered.map((t) => ({
-      name: formatTicketDisplay(t),
-      value: t.id,
-    })),
-  });
-}
-
-/**
- * Select a task from the current sprint, optionally filtered by status.
- * @returns task ID or null if no matching tasks
- */
-export async function selectTask(message = 'Select task:', filter?: TaskStatus[]): Promise<string | null> {
-  const tasks = await listTasks();
-  const filtered = filter ? tasks.filter((t) => filter.includes(t.status)) : tasks;
-
-  if (filtered.length === 0) {
-    console.log(muted('\nNo tasks found. Use "sprint plan" to generate tasks.\n'));
-    return null;
-  }
-
-  return escapableSelect({
-    message: `${emoji.donut} ${message}`,
-    choices: filtered.map((t) => ({
-      name: `${formatTaskStatus(t.status)} ${t.name}`,
-      value: t.id,
-    })),
-  });
-}
-
-/**
- * Select a task status.
- * @returns task status
- */
-export async function selectTaskStatus(message = 'Select status:'): Promise<TaskStatus | null> {
-  const statuses: TaskStatus[] = ['todo', 'in_progress', 'done'];
-
-  return escapableSelect({
-    message: `${emoji.donut} ${message}`,
-    choices: statuses.map((s) => ({
-      name: formatTaskStatus(s),
-      value: s,
-    })),
-  });
-}
-
-/**
- * Prompt for a positive integer.
- * @returns the parsed number
- */
-export async function inputPositiveInt(message: string): Promise<number> {
-  const value = await input({
-    message: `${emoji.donut} ${message}`,
-    validate: (v) => {
-      const n = parseInt(v, 10);
-      if (isNaN(n) || n < 1) return 'Must be a positive integer';
-      return true;
-    },
-  });
-  return parseInt(value, 10);
-}
-
-/**
- * Select project repositories for AI to explore.
- * If preSelected is provided, those paths are checked by default.
- * Otherwise, the first repository per project is pre-selected.
- */
-export async function selectProjectPaths(
-  reposByProject: Map<string, Repository[]>,
-  message = 'Select paths to explore:',
-  preSelected?: string[]
-): Promise<string[]> {
-  const choices: { name: string; value: string; checked: boolean }[] = [];
-  const preSelectedSet = preSelected ? new Set(preSelected) : null;
-
-  for (const [projectName, repos] of reposByProject) {
-    repos.forEach((repo, i) => {
-      choices.push({
-        name: `[${projectName}] ${repo.name} (${repo.path})`,
-        value: repo.path,
-        checked: preSelectedSet ? preSelectedSet.has(repo.path) : i === 0,
-      });
-    });
-  }
-
-  return checkbox({ message: `${emoji.donut} ${message}`, choices });
-}