ralphctl 0.1.0 → 0.1.2

package/src/commands/ticket/refine-utils.ts

@@ -1,89 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { formatTicketDisplay } from '@src/store/ticket.ts';
-import { spawnInteractive } from '@src/ai/session.ts';
-import { getActiveProvider } from '@src/providers/index.ts';
-import { extractJsonArray } from '@src/utils/json-extract.ts';
-import { type RefinedRequirement, RefinedRequirementsSchema, type Ticket } from '@src/schemas/index.ts';
-
-/**
- * Format a single ticket for the AI prompt.
- */
-export function formatTicketForPrompt(ticket: Ticket): string {
-  const lines: string[] = [];
-
-  lines.push(`### ${formatTicketDisplay(ticket)}`);
-  lines.push(`Project: ${ticket.projectName}`);
-
-  if (ticket.description) {
-    lines.push('');
-    lines.push('**Description:**');
-    lines.push(ticket.description);
-  }
-  if (ticket.link) {
-    lines.push('');
-    lines.push(`**Link:** ${ticket.link}`);
-  }
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-/**
- * Parse a requirements JSON file into validated RefinedRequirement array.
- */
-export function parseRequirementsFile(content: string): RefinedRequirement[] {
-  // Try to extract a balanced JSON array from the content (handles surrounding text)
-  const jsonStr = extractJsonArray(content);
-
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(jsonStr);
-  } catch (err) {
-    throw new Error(`Invalid JSON: ${err instanceof Error ? err.message : 'parse error'}`, { cause: err });
-  }
-
-  if (!Array.isArray(parsed)) {
-    throw new Error('Expected JSON array');
-  }
-
-  // Validate against schema
-  const result = RefinedRequirementsSchema.safeParse(parsed);
-  if (!result.success) {
-    const issues = result.error.issues
-      .map((issue) => {
-        const path = issue.path.length > 0 ? `[${issue.path.join('.')}]` : '';
-        return `  ${path}: ${issue.message}`;
-      })
-      .join('\n');
-    throw new Error(`Invalid requirements format:\n${issues}`);
-  }
-
-  return result.data;
-}
-
-/**
- * Run an interactive AI session for refinement in the given working directory.
- */
-export async function runAiSession(workingDir: string, prompt: string, ticketTitle: string): Promise<void> {
-  // Write full context to a file for reference
-  const contextFile = join(workingDir, 'refine-context.md');
-  await writeFile(contextFile, prompt, 'utf-8');
-
-  const provider = await getActiveProvider();
-
-  // Build initial prompt that tells the AI to read the context file
-  const startPrompt = `I need help refining the requirements for "${ticketTitle}". The full context is in refine-context.md. Please read that file now and follow the instructions to help refine the ticket requirements.`;
-
-  const result = spawnInteractive(
-    startPrompt,
-    {
-      cwd: workingDir,
-    },
-    provider
-  );
-
-  if (result.error) {
-    throw new Error(result.error);
-  }
-}

package/src/commands/ticket/refine.ts

@@ -1,268 +0,0 @@
-import { mkdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { confirm } from '@inquirer/prompts';
-import {
-  createSpinner,
-  emoji,
-  field,
-  fieldMultiline,
-  icons,
-  log,
-  printHeader,
-  renderCard,
-  showError,
-  showSuccess,
-  showTip,
-  showWarning,
-} from '@src/theme/ui.ts';
-import { assertSprintStatus, getSprint, resolveSprintId, saveSprint } from '@src/store/sprint.ts';
-import { formatTicketDisplay } from '@src/store/ticket.ts';
-import { buildTicketRefinePrompt } from '@src/ai/prompts/index.ts';
-import { fileExists } from '@src/utils/storage.ts';
-import { getRefinementDir, getSchemaPath } from '@src/utils/paths.ts';
-import { IssueFetchError, fetchIssueFromUrl, formatIssueContext } from '@src/utils/issue-fetch.ts';
-import { type RefinedRequirement } from '@src/schemas/index.ts';
-import { resolveProvider, providerDisplayName } from '@src/utils/provider.ts';
-import { formatTicketForPrompt, parseRequirementsFile, runAiSession } from './refine-utils.ts';
-import { selectTicket } from '@src/interactive/selectors.ts';
-import { EXIT_ERROR, exitWithCode } from '@src/utils/exit-codes.ts';
-
-export interface TicketRefineOptions {
-  interactive?: boolean;
-}
-
-export async function ticketRefineCommand(ticketId?: string, options: TicketRefineOptions = {}): Promise<void> {
-  const isInteractive = options.interactive !== false;
-
-  // Resolve sprint
-  let sprintId: string;
-  try {
-    sprintId = await resolveSprintId();
-  } catch {
-    showWarning('No current sprint set.');
-    showTip('Create a sprint first or set one with: ralphctl sprint current');
-    log.newline();
-    return;
-  }
-
-  const sprint = await getSprint(sprintId);
-
-  // Must be draft
-  try {
-    assertSprintStatus(sprint, ['draft'], 'refine ticket');
-  } catch (err) {
-    if (err instanceof Error) {
-      showError(err.message);
-      log.newline();
-    }
-    return;
-  }
-
-  // Find approved tickets
-  const approvedTickets = sprint.tickets.filter((t) => t.requirementStatus === 'approved');
-  if (approvedTickets.length === 0) {
-    showWarning('No approved tickets to re-refine.');
-    showTip('Run "ralphctl sprint refine" to refine pending tickets first.');
-    log.newline();
-    return;
-  }
-
-  // Resolve 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 re-refine:', (t) => t.requirementStatus === 'approved');
-    if (!selected) return;
-    resolvedId = selected;
-  }
-
-  // Find the ticket
-  const ticket = sprint.tickets.find((t) => t.id === resolvedId);
-  if (!ticket) {
-    showError(`Ticket not found: ${resolvedId}`);
-    if (!isInteractive) exitWithCode(EXIT_ERROR);
-    return;
-  }
-
-  if (ticket.requirementStatus !== 'approved') {
-    showError('Only approved tickets can be re-refined. Run "ralphctl sprint refine" for pending tickets.');
-    if (!isInteractive) exitWithCode(EXIT_ERROR);
-    return;
-  }
-
-  // Show ticket info
-  printHeader('Re-Refine Ticket', icons.ticket);
-  console.log(field('Sprint', sprint.name));
-  console.log(field('Ticket', formatTicketDisplay(ticket)));
-  console.log(field('Project', ticket.projectName));
-  if (ticket.link) {
-    console.log(field('Link', ticket.link));
-  }
-  if (ticket.description) {
-    console.log(fieldMultiline('Description', ticket.description));
-  }
-  log.newline();
-
-  // Load schema
-  const schemaPath = getSchemaPath('requirements-output.schema.json');
-  const schema = await readFile(schemaPath, 'utf-8');
-
-  const providerName = providerDisplayName(await resolveProvider());
-
-  // Confirm before starting AI session
-  const proceed = await confirm({
-    message: `${emoji.donut} Start ${providerName} re-refinement session?`,
-    default: true,
-  });
-
-  if (!proceed) {
-    log.dim('Cancelled.');
-    log.newline();
-    return;
-  }
-
-  // Fetch live issue data if ticket has a link
-  let issueContext = '';
-  if (ticket.link) {
-    const fetchSpinner = createSpinner('Fetching issue data...');
-    fetchSpinner.start();
-    try {
-      const issueData = fetchIssueFromUrl(ticket.link);
-      if (issueData) {
-        issueContext = formatIssueContext(issueData);
-        fetchSpinner.succeed(`Issue data fetched (${String(issueData.comments.length)} comment(s))`);
-      } else {
-        fetchSpinner.stop();
-      }
-    } catch (err) {
-      fetchSpinner.fail('Could not fetch issue data');
-      if (err instanceof IssueFetchError || err instanceof Error) {
-        showWarning(`${err.message} — continuing without issue context`);
-      }
-    }
-  }
-
-  // Build prompt with existing requirements as context
-  const refineDir = getRefinementDir(sprintId, ticket.id);
-  await mkdir(refineDir, { recursive: true });
-  const outputFile = join(refineDir, 'requirements.json');
-
-  let ticketContent = formatTicketForPrompt(ticket);
-  if (ticket.requirements) {
-    ticketContent += '\n### Previously Approved Requirements\n\n';
-    ticketContent += ticket.requirements;
-    ticketContent += '\n';
-  }
-
-  const prompt = buildTicketRefinePrompt(ticketContent, outputFile, schema, issueContext);
-
-  log.dim(`Working directory: ${refineDir}`);
-  log.dim(`Requirements output: ${outputFile}`);
-  log.newline();
-
-  const spinner = createSpinner(`Starting ${providerName} session...`);
-  spinner.start();
-
-  try {
-    await runAiSession(refineDir, prompt, ticket.title);
-    spinner.succeed(`${providerName} session completed`);
-  } catch (err) {
-    spinner.fail(`${providerName} session failed`);
-    if (err instanceof Error) {
-      showError(err.message);
-    }
-    log.newline();
-    return;
-  }
-
-  log.newline();
-
-  // Process the requirements file
-  if (!(await fileExists(outputFile))) {
-    showWarning('No requirements file found from AI session.');
-    log.newline();
-    return;
-  }
-
-  let content: string;
-  try {
-    content = await readFile(outputFile, 'utf-8');
-  } catch {
-    showError(`Failed to read requirements file: ${outputFile}`);
-    log.newline();
-    return;
-  }
-
-  let refinedRequirements: RefinedRequirement[];
-  try {
-    refinedRequirements = parseRequirementsFile(content);
-  } catch (err) {
-    if (err instanceof Error) {
-      showError(`Failed to parse requirements file: ${err.message}`);
-    }
-    log.newline();
-    return;
-  }
-
-  if (refinedRequirements.length === 0) {
-    showWarning('No requirements found in output file.');
-    log.newline();
-    return;
-  }
-
-  // Find matching requirements
-  const matchingRequirements = refinedRequirements.filter((r) => r.ref === ticket.id || r.ref === ticket.title);
-
-  if (matchingRequirements.length === 0) {
-    showWarning('Requirement reference does not match this ticket.');
-    log.newline();
-    return;
-  }
-
-  // Combine multiple requirements into one (safety net for split outputs)
-  const requirement: RefinedRequirement =
-    matchingRequirements.length === 1
-      ? {
-          ref: matchingRequirements[0]?.ref ?? '',
-          requirements: matchingRequirements[0]?.requirements ?? '',
-        }
-      : {
-          ref: matchingRequirements[0]?.ref ?? '',
-          requirements: matchingRequirements
-            .map((r, idx) => {
-              const text = r.requirements.trim();
-              if (/^#\s/.test(text)) return text;
-              return `# ${String(idx + 1)}. Section ${String(idx + 1)}\n\n${text}`;
-            })
-            .join('\n\n---\n\n'),
-        };
-
-  // Show requirement for review
-  const reqLines = requirement.requirements.split('\n');
-  console.log(renderCard(`${icons.ticket} Re-Refined Requirements`, reqLines));
-  log.newline();
-
-  const approveRequirement = await confirm({
-    message: `${emoji.donut} Approve these requirements?`,
-    default: true,
-  });
-
-  if (approveRequirement) {
-    const ticketIdx = sprint.tickets.findIndex((t) => t.id === ticket.id);
-    const ticketToSave = sprint.tickets[ticketIdx];
-    if (ticketIdx !== -1 && ticketToSave) {
-      ticketToSave.requirements = requirement.requirements;
-      // Keep requirementStatus as 'approved'
-    }
-    await saveSprint(sprint);
-    showSuccess('Requirements updated and saved!');
-  } else {
-    log.dim('Requirements not approved. Previous requirements unchanged.');
-  }
-
-  log.newline();
-}

package/src/commands/ticket/remove.ts

@@ -1,48 +0,0 @@
-import { confirm } from '@inquirer/prompts';
-import { muted } from '@src/theme/index.ts';
-import { formatTicketDisplay, getTicket, removeTicket, TicketNotFoundError } from '@src/store/ticket.ts';
-import { SprintStatusError } from '@src/store/sprint.ts';
-import { selectTicket } from '@src/interactive/selectors.ts';
-import { log, showError, showNextStep, showSuccess } from '@src/theme/ui.ts';
-
-export async function ticketRemoveCommand(args: string[]): Promise<void> {
-  const skipConfirm = args.includes('-y') || args.includes('--yes');
-  let ticketId = args.find((a) => !a.startsWith('-'));
-
-  if (!ticketId) {
-    const selected = await selectTicket('Select ticket to remove:');
-    if (!selected) return;
-    ticketId = selected;
-  }
-
-  try {
-    const ticket = await getTicket(ticketId);
-
-    if (!skipConfirm) {
-      const confirmed = await confirm({
-        message: `Remove ticket ${formatTicketDisplay(ticket)}?`,
-        default: false,
-      });
-
-      if (!confirmed) {
-        console.log(muted('\nTicket removal cancelled.\n'));
-        return;
-      }
-    }
-
-    await removeTicket(ticketId);
-    showSuccess('Ticket removed', [['ID', ticketId]]);
-    log.newline();
-  } catch (err) {
-    if (err instanceof TicketNotFoundError) {
-      showError(`Ticket not found: ${ticketId}`);
-      showNextStep('ralphctl ticket list', 'see available tickets');
-      log.newline();
-    } else if (err instanceof SprintStatusError) {
-      showError(err.message);
-      log.newline();
-    } else {
-      throw err;
-    }
-  }
-}

package/src/commands/ticket/show.ts

@@ -1,74 +0,0 @@
-import { muted } from '@src/theme/index.ts';
-import { getTicket, TicketNotFoundError } from '@src/store/ticket.ts';
-import { getProject } from '@src/store/project.ts';
-import { selectTicket } from '@src/interactive/selectors.ts';
-import { badge, icons, labelValue, log, renderCard, showError, showNextStep } from '@src/theme/ui.ts';
-
-export async function ticketShowCommand(args: string[]): Promise<void> {
-  let ticketId = args[0];
-
-  if (!ticketId) {
-    const selected = await selectTicket('Select ticket to show:');
-    if (!selected) return;
-    ticketId = selected;
-  }
-
-  try {
-    const ticket = await getTicket(ticketId);
-
-    const reqBadge = ticket.requirementStatus === 'approved' ? badge('approved', 'success') : badge('pending', 'muted');
-
-    // Ticket info card
-    const infoLines: string[] = [labelValue('ID', ticket.id)];
-    infoLines.push(labelValue('Project', ticket.projectName));
-    infoLines.push(labelValue('Requirements', reqBadge));
-
-    if (ticket.link) {
-      infoLines.push(labelValue('Link', ticket.link));
-    }
-
-    // Repositories
-    try {
-      const project = await getProject(ticket.projectName);
-      infoLines.push('');
-      for (const repo of project.repositories) {
-        infoLines.push(`  ${icons.bullet} ${repo.name} ${muted('→')} ${muted(repo.path)}`);
-      }
-    } catch {
-      infoLines.push(labelValue('Repositories', muted('(project not found)')));
-    }
-
-    log.newline();
-    console.log(renderCard(`${icons.ticket} ${ticket.title}`, infoLines));
-
-    // Description card (if present)
-    if (ticket.description) {
-      log.newline();
-      const descLines: string[] = [];
-      for (const line of ticket.description.split('\n')) {
-        descLines.push(line);
-      }
-      console.log(renderCard(`${icons.edit} Description`, descLines));
-    }
-
-    // Affected repositories card (if set from planning)
-    if (ticket.affectedRepositories && ticket.affectedRepositories.length > 0) {
-      log.newline();
-      const affectedLines: string[] = [];
-      for (const repoPath of ticket.affectedRepositories) {
-        affectedLines.push(`${icons.bullet} ${repoPath}`);
-      }
-      console.log(renderCard(`${icons.project} Affected Repositories`, affectedLines));
-    }
-
-    log.newline();
-  } catch (err) {
-    if (err instanceof TicketNotFoundError) {
-      showError(`Ticket not found: ${ticketId}`);
-      showNextStep('ralphctl ticket list', 'see available tickets');
-      log.newline();
-    } else {
-      throw err;
-    }
-  }
-}

package/src/completion/handle.ts

@@ -1,30 +0,0 @@
-import type { Command } from 'commander';
-
-/**
- * Check for shell completion environment variables and handle the completion request.
- * Returns `true` if a completion was handled (caller should exit), `false` otherwise.
- *
- * This runs BEFORE banner/interactive mode — must not produce any extra output.
- */
-export async function handleCompletionRequest(program: Command): Promise<boolean> {
-  const env = process.env;
-
-  // tabtab sets these env vars when the shell triggers completion
-  if (!env['COMP_CWORD'] || !env['COMP_POINT'] || !env['COMP_LINE']) {
-    return false;
-  }
-
-  const tabtab = (await import('tabtab')).default;
-  const { resolveCompletions } = await import('@src/completion/resolver.ts');
-
-  const tabEnv = tabtab.parseEnv(env);
-
-  const completions = await resolveCompletions(program, {
-    line: tabEnv.line,
-    last: tabEnv.last,
-    prev: tabEnv.prev,
-  });
-
-  tabtab.log(completions);
-  return true;
-}