ralphctl 0.1.0 → 0.1.2

package/src/commands/ticket/add.ts

@@ -1,265 +0,0 @@
-import { confirm, input, select } from '@inquirer/prompts';
-import { error, muted } from '@src/theme/index.ts';
-import {
-  createSpinner,
-  emoji,
-  field,
-  fieldMultiline,
-  icons,
-  log,
-  renderCard,
-  showEmpty,
-  showError,
-  showSuccess,
-  showWarning,
-} from '@src/theme/ui.ts';
-import { editorInput } from '@src/utils/editor-input.ts';
-import { addTicket } from '@src/store/ticket.ts';
-import { listProjects, projectExists } from '@src/store/project.ts';
-import { SprintStatusError } from '@src/store/sprint.ts';
-import { EXIT_ERROR, exitWithCode } from '@src/utils/exit-codes.ts';
-import { IssueFetchError, fetchIssueFromUrl, type IssueData } from '@src/utils/issue-fetch.ts';
-import type { Ticket } from '@src/schemas/index.ts';
-
-export interface TicketAddOptions {
-  title?: string;
-  description?: string;
-  link?: string;
-  project?: string;
-  interactive?: boolean; // Set by REPL or CLI (default true unless --no-interactive)
-}
-
-/**
- * Attempt to fetch issue data from a URL. Returns the data if the user confirms,
- * undefined otherwise. Non-fatal — warns on failure and returns undefined.
- */
-function tryFetchIssue(url: string): IssueData | undefined {
-  const spinner = createSpinner('Fetching issue data...');
-  spinner.start();
-
-  let data: IssueData | null;
-  try {
-    data = fetchIssueFromUrl(url);
-  } catch (err) {
-    spinner.fail('Could not fetch issue data');
-    if (err instanceof IssueFetchError) {
-      showWarning(err.message);
-    } else if (err instanceof Error) {
-      showWarning(err.message);
-    }
-    log.newline();
-    return undefined;
-  }
-
-  if (!data) {
-    spinner.stop();
-    return undefined;
-  }
-
-  spinner.succeed('Issue data fetched');
-  log.newline();
-
-  // Show summary card
-  const bodyPreview = data.body.length > 200 ? data.body.slice(0, 200) + '...' : data.body;
-  const cardLines = [`Title: ${data.title}`, '', bodyPreview];
-  if (data.comments.length > 0) {
-    cardLines.push('', `${String(data.comments.length)} comment(s)`);
-  }
-  console.log(renderCard(`${icons.info} Fetched Issue`, cardLines));
-  log.newline();
-
-  return data;
-}
-
-function validateUrl(url: string): boolean {
-  try {
-    new URL(url);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Non-interactive ticket creation: validates params and creates ticket.
- */
-async function addSingleTicketNonInteractive(options: TicketAddOptions): Promise<void> {
-  const errors: string[] = [];
-  const trimmedTitle = options.title?.trim();
-  const trimmedProject = options.project?.trim();
-
-  if (!trimmedTitle) {
-    errors.push('--title is required');
-  }
-  if (!trimmedProject) {
-    errors.push('--project is required');
-  } else if (!(await projectExists(trimmedProject))) {
-    errors.push(`Project '${trimmedProject}' does not exist. Add it first with 'ralphctl project add'.`);
-  }
-  if (options.link && !validateUrl(options.link)) {
-    errors.push('--link must be a valid URL');
-  }
-
-  if (errors.length > 0 || !trimmedTitle || !trimmedProject) {
-    showError('Validation failed');
-    for (const e of errors) {
-      log.item(error(e));
-    }
-    log.newline();
-    exitWithCode(EXIT_ERROR);
-  }
-
-  const title = trimmedTitle;
-  const trimmedDesc = options.description?.trim();
-  const description = trimmedDesc === '' ? undefined : trimmedDesc;
-  const trimmedLink = options.link?.trim();
-  const link = trimmedLink === '' ? undefined : trimmedLink;
-  const projectName = trimmedProject;
-
-  try {
-    const ticket = await addTicket({
-      title,
-      description,
-      link,
-      projectName,
-    });
-
-    showTicketResult(ticket);
-  } catch (err) {
-    handleTicketError(err);
-  }
-}
-
-/**
- * Interactive ticket creation: prompts for fields and creates ticket.
- * Returns the created ticket on success, or null on failure.
- */
-export async function addSingleTicketInteractive(options: TicketAddOptions): Promise<Ticket | null> {
-  const projects = await listProjects();
-
-  if (projects.length === 0) {
-    showEmpty('projects', 'Add one first with: ralphctl project add');
-    return null;
-  }
-
-  const projectName = await select({
-    message: `${icons.project} Project:`,
-    default: options.project ?? projects[0]?.name,
-    choices: projects.map((p) => ({
-      name: `${icons.project} ${p.name} ${muted(`- ${p.displayName}`)}`,
-      value: p.name,
-    })),
-  });
-
-  // Link prompt first — enables issue fetching for pre-fill
-  const link: string | undefined = await input({
-    message: `${icons.info} Issue link (optional):`,
-    default: options.link?.trim(),
-    validate: (v) => {
-      if (!v) return true;
-      return validateUrl(v) ? true : 'Invalid URL format';
-    },
-  });
-
-  const trimmedLink = link.trim();
-  const normalizedLink = trimmedLink === '' ? undefined : trimmedLink;
-
-  // Try to fetch issue data if a valid issue URL was provided
-  let prefill: IssueData | undefined;
-  if (normalizedLink) {
-    prefill = tryFetchIssue(normalizedLink);
-  }
-
-  let title = await input({
-    message: `${icons.ticket} Title:`,
-    default: prefill?.title ?? options.title?.trim(),
-    validate: (v) => (v.trim().length > 0 ? true : 'Title is required'),
-  });
-
-  const description = await editorInput({
-    message: 'Description (recommended):',
-    default: prefill?.body ?? options.description?.trim(),
-  });
-
-  // Trim and normalize empty strings to undefined
-  title = title.trim();
-  const trimmedDescription = description.trim();
-  const normalizedDescription = trimmedDescription === '' ? undefined : trimmedDescription;
-
-  try {
-    const ticket = await addTicket({
-      title,
-      description: normalizedDescription,
-      link: normalizedLink,
-      projectName,
-    });
-
-    showTicketResult(ticket);
-    return ticket;
-  } catch (err) {
-    handleTicketError(err);
-    return null;
-  }
-}
-
-/**
- * Display the result of a successfully added ticket.
- */
-function showTicketResult(ticket: Ticket): void {
-  showSuccess('Ticket added!', [
-    ['ID', ticket.id],
-    ['Title', ticket.title],
-    ['Project', ticket.projectName],
-  ]);
-
-  if (ticket.description) {
-    console.log(fieldMultiline('Description', ticket.description));
-  }
-  if (ticket.link) {
-    console.log(field('Link', ticket.link));
-  }
-  console.log('');
-}
-
-/**
- * Handle known ticket creation errors with user-friendly messages.
- */
-function handleTicketError(err: unknown): void {
-  if (err instanceof SprintStatusError) {
-    showError(err.message);
-  } else if (err instanceof Error && err.message.includes('does not exist')) {
-    showError(err.message);
-  } else {
-    throw err;
-  }
-}
-
-export async function ticketAddCommand(options: TicketAddOptions = {}): Promise<void> {
-  if (options.interactive === false) {
-    await addSingleTicketNonInteractive(options);
-    return;
-  }
-
-  // Interactive mode with batch loop
-  let count = 0;
-  let lastProjectName: string | undefined = options.project;
-
-  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- loop control via break
-  while (true) {
-    const ticket = await addSingleTicketInteractive({ ...options, project: lastProjectName });
-    if (ticket) {
-      count++;
-      lastProjectName = ticket.projectName;
-      log.dim(`${String(count)} ticket(s) added in this session`);
-    } else {
-      // No ticket created (no projects, or unrecoverable error) — exit loop
-      break;
-    }
-
-    const another = await confirm({
-      message: `${emoji.donut} Add another ticket?`,
-      default: true,
-    });
-    if (!another) break;
-  }
-}

package/src/commands/ticket/edit.ts

@@ -1,166 +0,0 @@
-import { input } from '@inquirer/prompts';
-import { muted } from '@src/theme/index.ts';
-import { field, fieldMultiline, icons, showError, showNextStep, showSuccess } from '@src/theme/ui.ts';
-import { formatTicketDisplay, getTicket, TicketNotFoundError, updateTicket } from '@src/store/ticket.ts';
-import { SprintStatusError } from '@src/store/sprint.ts';
-import { EXIT_ERROR, exitWithCode } from '@src/utils/exit-codes.ts';
-import { selectTicket } from '@src/interactive/selectors.ts';
-import { editorInput } from '@src/utils/editor-input.ts';
-
-export interface TicketEditOptions {
-  title?: string;
-  description?: string;
-  link?: string;
-  interactive?: boolean;
-}
-
-function validateUrl(url: string): boolean {
-  try {
-    new URL(url);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export async function ticketEditCommand(ticketId?: string, options: TicketEditOptions = {}): Promise<void> {
-  const isInteractive = options.interactive !== false;
-
-  // Get ticket ID
-  let resolvedId = ticketId;
-  if (!resolvedId) {
-    if (!isInteractive) {
-      showError('Ticket ID is required in non-interactive mode');
-      exitWithCode(EXIT_ERROR);
-    }
-
-    const selected = await selectTicket('Select ticket to edit:');
-    if (!selected) {
-      return;
-    }
-    resolvedId = selected;
-  }
-
-  // Fetch existing ticket
-  let ticket;
-  try {
-    ticket = await getTicket(resolvedId);
-  } catch (err) {
-    if (err instanceof TicketNotFoundError) {
-      showError(`Ticket not found: ${resolvedId}`);
-      showNextStep('ralphctl ticket list', 'see available tickets');
-      if (!isInteractive) exitWithCode(EXIT_ERROR);
-      return;
-    }
-    throw err;
-  }
-
-  let newTitle: string | undefined;
-  let newDescription: string | undefined;
-  let newLink: string | undefined;
-
-  if (isInteractive) {
-    // Show current ticket info
-    console.log(`\n  Editing: ${formatTicketDisplay(ticket)}`);
-    console.log(muted(`  Project: ${ticket.projectName} (read-only)\n`));
-
-    // Prompt for each field with current value as default
-    newTitle = await input({
-      message: `${icons.ticket} Title:`,
-      default: ticket.title,
-      validate: (v) => (v.trim().length > 0 ? true : 'Title is required'),
-    });
-
-    newDescription = await editorInput({
-      message: 'Description:',
-      default: ticket.description,
-    });
-
-    newLink = await input({
-      message: `${icons.info} Link:`,
-      default: ticket.link ?? '',
-      validate: (v) => {
-        if (!v) return true;
-        return validateUrl(v) ? true : 'Invalid URL format';
-      },
-    });
-
-    // Trim and normalize empty values
-    newTitle = newTitle.trim();
-    newDescription = newDescription.trim() || undefined;
-    newLink = newLink.trim() || undefined;
-  } else {
-    // Non-interactive mode: use provided options
-    if (options.title !== undefined) {
-      const trimmed = options.title.trim();
-      if (trimmed.length === 0) {
-        showError('--title cannot be empty');
-        exitWithCode(EXIT_ERROR);
-      }
-      newTitle = trimmed;
-    }
-
-    if (options.description !== undefined) {
-      newDescription = options.description.trim() || undefined;
-    }
-
-    if (options.link !== undefined) {
-      const trimmed = options.link.trim();
-      if (trimmed && !validateUrl(trimmed)) {
-        showError('--link must be a valid URL');
-        exitWithCode(EXIT_ERROR);
-      }
-      newLink = trimmed || undefined;
-    }
-
-    // Check if any updates were provided
-    if (newTitle === undefined && newDescription === undefined && newLink === undefined) {
-      showError('No updates provided. Use --title, --description, or --link.');
-      exitWithCode(EXIT_ERROR);
-    }
-  }
-
-  // Build updates object (only include changed fields)
-  const updates: { title?: string; description?: string; link?: string } = {};
-
-  if (newTitle !== undefined && newTitle !== ticket.title) {
-    updates.title = newTitle;
-  }
-  if (newDescription !== undefined && newDescription !== ticket.description) {
-    updates.description = newDescription;
-  }
-  if (newLink !== undefined && newLink !== ticket.link) {
-    updates.link = newLink;
-  }
-
-  // Check if anything changed
-  if (Object.keys(updates).length === 0) {
-    console.log(muted('\n  No changes made.\n'));
-    return;
-  }
-
-  try {
-    const updated = await updateTicket(ticket.id, updates);
-
-    showSuccess('Ticket updated!', [
-      ['ID', updated.id],
-      ['Title', updated.title],
-      ['Project', updated.projectName],
-    ]);
-
-    if (updated.description) {
-      console.log(fieldMultiline('Description', updated.description));
-    }
-    if (updated.link) {
-      console.log(field('Link', updated.link));
-    }
-    console.log('');
-  } catch (err) {
-    if (err instanceof SprintStatusError) {
-      showError(err.message);
-    } else {
-      throw err;
-    }
-    if (!isInteractive) exitWithCode(EXIT_ERROR);
-  }
-}

package/src/commands/ticket/index.ts

@@ -1,114 +0,0 @@
-import type { Command } from 'commander';
-import { ticketAddCommand } from '@src/commands/ticket/add.ts';
-import { ticketEditCommand } from '@src/commands/ticket/edit.ts';
-import { ticketListCommand } from '@src/commands/ticket/list.ts';
-import { ticketShowCommand } from '@src/commands/ticket/show.ts';
-import { ticketRemoveCommand } from '@src/commands/ticket/remove.ts';
-import { ticketRefineCommand } from '@src/commands/ticket/refine.ts';
-
-export function registerTicketCommands(program: Command): void {
-  const ticket = program.command('ticket').description('Manage tickets');
-
-  ticket.addHelpText(
-    'after',
-    `
-Examples:
-  $ ralphctl ticket add --project api --title "Fix auth bug"
-  $ ralphctl ticket edit abc123 --title "New title"
-  $ ralphctl ticket list -b
-  $ ralphctl ticket show abc123
-`
-  );
-
-  ticket
-    .command('add')
-    .description('Add ticket to current sprint')
-    .option('-p, --project <name>', 'Project name')
-    .option('-t, --title <title>', 'Ticket title')
-    .option('-d, --description <desc>', 'Description')
-    .option('--link <url>', 'Link to external issue')
-    .option('-n, --no-interactive', 'Non-interactive mode (error on missing params)')
-    .action(
-      async (opts: {
-        project?: string;
-        title?: string;
-        description?: string;
-        link?: string;
-        interactive?: boolean;
-      }) => {
-        await ticketAddCommand({
-          project: opts.project,
-          title: opts.title,
-          description: opts.description,
-          link: opts.link,
-          // --no-interactive sets interactive=false, otherwise true (prompt for missing)
-          interactive: opts.interactive !== false,
-        });
-      }
-    );
-
-  ticket
-    .command('edit [id]')
-    .description('Edit an existing ticket')
-    .option('--title <title>', 'New title')
-    .option('--description <desc>', 'New description')
-    .option('--link <url>', 'New link')
-    .option('-n, --no-interactive', 'Non-interactive mode')
-    .action(
-      async (
-        id?: string,
-        opts?: {
-          title?: string;
-          description?: string;
-          link?: string;
-          interactive?: boolean;
-        }
-      ) => {
-        await ticketEditCommand(id, {
-          title: opts?.title,
-          description: opts?.description,
-          link: opts?.link,
-          interactive: opts?.interactive !== false,
-        });
-      }
-    );
-
-  ticket
-    .command('list')
-    .description('List tickets')
-    .option('-b, --brief', 'Brief one-liner format')
-    .option('--project <name>', 'Filter by project')
-    .option('--status <status>', 'Filter by requirement status (pending, approved)')
-    .action(async (opts: { brief?: boolean; project?: string; status?: string }) => {
-      const args: string[] = [];
-      if (opts.brief) args.push('-b');
-      if (opts.project) args.push('--project', opts.project);
-      if (opts.status) args.push('--status', opts.status);
-      await ticketListCommand(args);
-    });
-
-  ticket
-    .command('show [id]')
-    .description('Show ticket details')
-    .action(async (id?: string) => {
-      await ticketShowCommand(id ? [id] : []);
-    });
-
-  ticket
-    .command('refine [id]')
-    .description('Re-refine an approved ticket')
-    .action(async (id?: string) => {
-      await ticketRefineCommand(id);
-    });
-
-  ticket
-    .command('remove [id]')
-    .description('Remove a ticket')
-    .option('-y, --yes', 'Skip confirmation')
-    .action(async (id?: string, opts?: { yes?: boolean }) => {
-      const args: string[] = [];
-      if (id) args.push(id);
-      if (opts?.yes) args.push('-y');
-      await ticketRemoveCommand(args);
-    });
-}

package/src/commands/ticket/list.ts

@@ -1,128 +0,0 @@
-import { colors, muted, success } from '@src/theme/index.ts';
-import { formatTicketDisplay, groupTicketsByProject, listTickets } from '@src/store/ticket.ts';
-import { getProject } from '@src/store/project.ts';
-import { RequirementStatusSchema } from '@src/schemas/index.ts';
-import { badge, icons, log, printHeader, showEmpty, showError } from '@src/theme/ui.ts';
-
-interface TicketListFilters {
-  brief: boolean;
-  projectFilter?: string;
-  statusFilter?: string;
-}
-
-function parseListArgs(args: string[]): TicketListFilters {
-  const result: TicketListFilters = {
-    brief: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    const next = args[i + 1];
-    if (arg === '-b' || arg === '--brief') result.brief = true;
-    else if (arg === '--project' && next) {
-      result.projectFilter = next;
-      i++;
-    } else if (arg === '--status' && next) {
-      result.statusFilter = next;
-      i++;
-    }
-  }
-  return result;
-}
-
-function buildFilterSummary(filters: TicketListFilters): string {
-  const parts: string[] = [];
-  if (filters.projectFilter) parts.push(`project=${filters.projectFilter}`);
-  if (filters.statusFilter) parts.push(`status=${filters.statusFilter}`);
-  return parts.length > 0 ? ` (filtered: ${parts.join(', ')})` : '';
-}
-
-export async function ticketListCommand(args: string[]): Promise<void> {
-  const { brief, projectFilter, statusFilter } = parseListArgs(args);
-
-  // Validate status filter
-  if (statusFilter) {
-    const result = RequirementStatusSchema.safeParse(statusFilter);
-    if (!result.success) {
-      showError(`Invalid status: "${statusFilter}". Valid values: pending, approved`);
-      return;
-    }
-  }
-
-  const tickets = await listTickets();
-
-  if (tickets.length === 0) {
-    showEmpty('tickets', 'Add one with: ralphctl ticket add --project <project-name>');
-    return;
-  }
-
-  // Apply filters
-  let filtered = tickets;
-  if (projectFilter) filtered = filtered.filter((t) => t.projectName === projectFilter);
-  if (statusFilter) filtered = filtered.filter((t) => t.requirementStatus === statusFilter);
-
-  const filterStr = buildFilterSummary({ brief, projectFilter, statusFilter });
-  const isFiltered = filtered.length !== tickets.length;
-
-  if (filtered.length === 0) {
-    showEmpty('matching tickets', 'Try adjusting your filters');
-    return;
-  }
-
-  if (brief) {
-    // Brief mode: one line per ticket (markdown for LLM readability)
-    const countLabel = isFiltered ? `${String(filtered.length)} of ${String(tickets.length)}` : String(tickets.length);
-    console.log(`\n# Tickets (${countLabel})${filterStr}\n`);
-    for (const ticket of filtered) {
-      const display = `[${ticket.id}] ${ticket.title}`;
-      const reqBadge = ticket.requirementStatus === 'approved' ? ' [approved]' : ' [pending]';
-      console.log(`- ${display}${reqBadge} (${ticket.projectName})`);
-    }
-    console.log('');
-    return;
-  }
-
-  // Interactive list grouped by project
-  const ticketsByProject = groupTicketsByProject(filtered);
-
-  printHeader(`Tickets (${String(filtered.length)})`, icons.ticket);
-
-  for (const [projectName, projectTickets] of ticketsByProject) {
-    // Project group header
-    log.raw(`${colors.info(icons.project)} ${colors.info(projectName)}`);
-
-    // Show project repos
-    try {
-      const project = await getProject(projectName);
-      for (const repo of project.repositories) {
-        log.raw(`    ${muted(repo.name)} ${muted('→')} ${muted(repo.path)}`, 1);
-      }
-    } catch {
-      log.raw(`    ${muted('(project not found)')}`, 1);
-    }
-    log.newline();
-
-    for (const ticket of projectTickets) {
-      const reqBadge =
-        ticket.requirementStatus === 'approved' ? badge('approved', 'success') : badge('pending', 'muted');
-      log.raw(`  ${icons.bullet} ${formatTicketDisplay(ticket)} ${reqBadge}`);
-      if (ticket.description) {
-        const preview = ticket.description.split('\n')[0] ?? '';
-        const truncated = preview.length > 60 ? preview.slice(0, 57) + '...' : preview;
-        log.raw(`      ${muted(truncated)}`, 1);
-      }
-    }
-    log.newline();
-  }
-
-  // Summary
-  const approved = filtered.filter((t) => t.requirementStatus === 'approved').length;
-  log.dim(
-    `Requirements: ${success(`${String(approved)} approved`)} / ${muted(`${String(filtered.length - approved)} pending`)}`
-  );
-  const showingLabel = isFiltered
-    ? `Showing ${String(filtered.length)} of ${String(tickets.length)} ticket(s)${filterStr}`
-    : `Showing ${String(tickets.length)} ticket(s)`;
-  log.dim(showingLabel);
-  log.newline();
-}