ralphctl 0.1.0

package/src/store/ticket.ts

@@ -0,0 +1,178 @@
+import { getSprintFilePath } from '@src/utils/paths.ts';
+import { readValidatedJson, writeValidatedJson } from '@src/utils/storage.ts';
+import { type Sprint, SprintSchema, type Ticket } from '@src/schemas/index.ts';
+import { assertSprintStatus, resolveSprintId } from '@src/store/sprint.ts';
+import { generateUuid8 } from '@src/utils/ids.ts';
+import { getProject, ProjectNotFoundError } from '@src/store/project.ts';
+
+export class TicketNotFoundError extends Error {
+  public readonly ticketId: string;
+
+  constructor(ticketId: string) {
+    super(`Ticket not found: ${ticketId}`);
+    this.name = 'TicketNotFoundError';
+    this.ticketId = ticketId;
+  }
+}
+
+async function getSprintData(sprintId?: string): Promise<Sprint> {
+  const id = await resolveSprintId(sprintId);
+  return readValidatedJson(getSprintFilePath(id), SprintSchema);
+}
+
+async function saveSprintData(sprint: Sprint): Promise<void> {
+  await writeValidatedJson(getSprintFilePath(sprint.id), sprint, SprintSchema);
+}
+
+export interface AddTicketInput {
+  title: string;
+  description?: string;
+  link?: string;
+  projectName: string;
+}
+
+export async function addTicket(input: AddTicketInput, sprintId?: string): Promise<Ticket> {
+  const sprint = await getSprintData(sprintId);
+
+  // Check sprint status - must be draft to add tickets
+  assertSprintStatus(sprint, ['draft'], 'add tickets');
+
+  // Validate that the project exists
+  try {
+    await getProject(input.projectName);
+  } catch (err) {
+    if (err instanceof ProjectNotFoundError) {
+      throw new Error(`Project '${input.projectName}' does not exist. Add it first with 'ralphctl project add'.`, {
+        cause: err,
+      });
+    }
+    throw err;
+  }
+
+  const ticket: Ticket = {
+    id: generateUuid8(),
+    title: input.title,
+    description: input.description,
+    link: input.link,
+    projectName: input.projectName,
+    requirementStatus: 'pending',
+  };
+
+  sprint.tickets.push(ticket);
+  await saveSprintData(sprint);
+  return ticket;
+}
+
+export interface UpdateTicketInput {
+  title?: string;
+  description?: string;
+  link?: string;
+}
+
+export async function updateTicket(ticketId: string, updates: UpdateTicketInput, sprintId?: string): Promise<Ticket> {
+  const sprint = await getSprintData(sprintId);
+
+  // Check sprint status - must be draft to update tickets
+  assertSprintStatus(sprint, ['draft'], 'update tickets');
+
+  const ticketIdx = sprint.tickets.findIndex((t) => t.id === ticketId);
+  if (ticketIdx === -1) {
+    throw new TicketNotFoundError(ticketId);
+  }
+
+  const ticket = sprint.tickets[ticketIdx];
+  if (!ticket) {
+    throw new TicketNotFoundError(ticketId);
+  }
+
+  // Apply updates
+  if (updates.title !== undefined) {
+    ticket.title = updates.title;
+  }
+  if (updates.description !== undefined) {
+    ticket.description = updates.description || undefined;
+  }
+  if (updates.link !== undefined) {
+    ticket.link = updates.link || undefined;
+  }
+
+  await saveSprintData(sprint);
+  return ticket;
+}
+
+export async function removeTicket(ticketId: string, sprintId?: string): Promise<void> {
+  const sprint = await getSprintData(sprintId);
+
+  // Check sprint status - must be draft to remove tickets
+  assertSprintStatus(sprint, ['draft'], 'remove tickets');
+
+  const index = sprint.tickets.findIndex((t) => t.id === ticketId);
+  if (index === -1) {
+    throw new TicketNotFoundError(ticketId);
+  }
+  sprint.tickets.splice(index, 1);
+  await saveSprintData(sprint);
+}
+
+export async function listTickets(sprintId?: string): Promise<Ticket[]> {
+  const sprint = await getSprintData(sprintId);
+  return sprint.tickets;
+}
+
+export async function getTicket(ticketId: string, sprintId?: string): Promise<Ticket> {
+  const sprint = await getSprintData(sprintId);
+  const ticket = sprint.tickets.find((t) => t.id === ticketId);
+  if (!ticket) {
+    throw new TicketNotFoundError(ticketId);
+  }
+  return ticket;
+}
+
+/**
+ * Get a ticket by title (for tickets without an external ID).
+ */
+export async function getTicketByTitle(title: string, sprintId?: string): Promise<Ticket | undefined> {
+  const sprint = await getSprintData(sprintId);
+  return sprint.tickets.find((t) => t.title === title);
+}
+
+/**
+ * Group tickets by their project name.
+ */
+export function groupTicketsByProject(tickets: Ticket[]): Map<string, Ticket[]> {
+  const grouped = new Map<string, Ticket[]>();
+  for (const ticket of tickets) {
+    const existing = grouped.get(ticket.projectName) ?? [];
+    existing.push(ticket);
+    grouped.set(ticket.projectName, existing);
+  }
+  return grouped;
+}
+
+/**
+ * Check if all tickets have approved requirements.
+ */
+export function allRequirementsApproved(tickets: Ticket[]): boolean {
+  return tickets.length > 0 && tickets.every((t) => t.requirementStatus === 'approved');
+}
+
+/**
+ * Get tickets that still need requirement refinement.
+ */
+export function getPendingRequirements(tickets: Ticket[]): Ticket[] {
+  return tickets.filter((t) => t.requirementStatus === 'pending');
+}
+
+/**
+ * Format ticket for display: "[ID] Title"
+ */
+export function formatTicketDisplay(ticket: Ticket): string {
+  return `[${ticket.id}] ${ticket.title}`;
+}
+
+/**
+ * Format ticket ID for display.
+ */
+export function formatTicketId(ticket: Ticket): string {
+  return ticket.id;
+}

package/src/theme/index.ts

@@ -0,0 +1,215 @@
+import { bold, cyan, dim, gray, green, magenta, red, yellow } from 'colorette';
+import gradient from 'gradient-string';
+
+// Re-export colorette functions for direct usage
+export { cyan, green, red, yellow, blue, gray, bold, dim, isColorSupported } from 'colorette';
+
+// ============================================================================
+// COLOR FUNCTIONS
+// ============================================================================
+
+/**
+ * Color function type (matches colorette signature)
+ */
+export type ColorFn = (text: string | number) => string;
+
+/**
+ * Theme color mappings
+ */
+export const colors = {
+  // Semantic colors
+  success: green,
+  error: red,
+  warning: yellow,
+  info: cyan,
+  muted: gray,
+  highlight: yellow,
+  accent: bold,
+  subtle: dim,
+  // Ralph-specific
+  primary: yellow,
+  secondary: magenta,
+} as const;
+
+// Semantic color shortcuts (replaces utils/colors.ts)
+export const success = (text: string): string => colors.success(text);
+export const error = (text: string): string => colors.error(text);
+export const warning = (text: string): string => colors.warning(text);
+export const info = (text: string): string => colors.info(text);
+export const muted = (text: string): string => colors.muted(text);
+export const highlight = (text: string): string => colors.highlight(text);
+export const accent = (text: string): string => colors.accent(text);
+export const subtle = (text: string): string => colors.subtle(text);
+export const primary = (text: string): string => colors.primary(text);
+export const secondary = (text: string): string => colors.secondary(text);
+
+// ============================================================================
+// GRADIENT RENDERING (powered by gradient-string)
+// ============================================================================
+
+/**
+ * Built-in gradient presets for banner/header styling.
+ * Each gradient is a function: gradients.donut(text) or gradients.donut.multiline(text)
+ */
+export const gradients = {
+  /** Gold → Orange → Hot Pink → Orchid → Violet (Ralph's signature donut warmth) */
+  donut: gradient(['#FFD700', '#FFA500', '#FF69B4', '#DA70D6', '#9400D3'], {
+    interpolation: 'hsv',
+    hsvSpin: 'short',
+  }),
+  /** Green → Dark Cyan (success/completion) */
+  success: gradient(['#00FF00', '#00CED1']),
+  /** Orange Red → Gold (warning/attention) */
+  warning: gradient(['#FF4500', '#FFD700']),
+} as const;
+
+// ============================================================================
+// BANNER
+// ============================================================================
+
+const BANNER = `
+  🍩 ██████╗  █████╗ ██╗     ██████╗ ██╗  ██╗ ██████╗████████╗██╗     🍩
+     ██╔══██╗██╔══██╗██║     ██╔══██╗██║  ██║██╔════╝╚══██╔══╝██║
+     ██████╔╝███████║██║     ██████╔╝███████║██║        ██║   ██║
+     ██╔══██╗██╔══██║██║     ██╔═══╝ ██╔══██║██║        ██║   ██║
+     ██║  ██║██║  ██║███████╗██║     ██║  ██║╚██████╗   ██║   ███████╗
+     ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝     ╚═╝  ╚═╝ ╚═════╝   ╚═╝   ╚══════╝
+`;
+
+export const banner = {
+  art: BANNER,
+  tagline: "I'm helping with your sprints!",
+} as const;
+
+// ============================================================================
+// QUOTES
+// ============================================================================
+
+export const RALPH_QUOTES = [
+  "I'm helping!",
+  "Me fail English? That's unpossible!",
+  'Go banana!',
+  'Hi, Super Nintendo Chalmers!',
+  'I bent my wookie.',
+  "My cat's breath smells like cat food.",
+  "I'm learnding!",
+  "The doctor said I wouldn't have so many nose bleeds if I kept my finger outta there.",
+  'I found a moonrock in my nose!',
+  "That's where I saw the leprechaun. He told me to burn things.",
+  "My daddy's gonna put you in jail!",
+  "I'm a unitard!",
+  'I ate the purple berries...',
+  'Tastes like burning!',
+  "My parents won't let me use scissors.",
+  'I dress myself!',
+  'Principal Skinner, I got carsick in your office.',
+  "I'm Idaho!",
+  'Mrs. Krabappel and Principal Skinner were in the closet making babies!',
+  'Even my boogers are spicy!',
+  'It smells like hot dogs.',
+  'I sleep in a drawer!',
+  'I picked the red one!',
+  'The pointy kitty took it!',
+  'When I grow up, I want to be a principal or a caterpillar.',
+] as const;
+
+export function getRandomQuote(): string {
+  const index = Math.floor(Math.random() * RALPH_QUOTES.length);
+  return RALPH_QUOTES[index] ?? '';
+}
+
+// ============================================================================
+// CONTEXT-SENSITIVE QUOTES
+// ============================================================================
+
+export type QuoteCategory = 'error' | 'success' | 'farewell' | 'idle';
+
+export const QUOTES_BY_CATEGORY: Record<QuoteCategory, readonly string[]> = {
+  error: [
+    'My tummy hurts!',
+    'Tastes like burning!',
+    'I ate the purple berries...',
+    "The doctor said I wouldn't have so many nose bleeds if I kept my finger outta there.",
+    "My parents won't let me use scissors.",
+    'Principal Skinner, I got carsick in your office.',
+    'I eated the purple berries. They taste like... burning.',
+  ],
+  success: [
+    "I'm helping!",
+    'Go banana!',
+    "I'm learnding!",
+    "I'm a unitard!",
+    'I dress myself!',
+    'I picked the red one!',
+    'I found a moonrock in my nose!',
+    "Yay! I'm a helper!",
+  ],
+  farewell: [
+    "Bye bye! My cat's breath smells like cat food!",
+    'When I grow up, I want to be a principal or a caterpillar.',
+    'I sleep in a drawer!',
+    "I'm Idaho!",
+    'The pointy kitty took it!',
+  ],
+  idle: [
+    'Hi, Super Nintendo Chalmers!',
+    'I bent my wookie.',
+    "My cat's breath smells like cat food.",
+    'It smells like hot dogs.',
+    "That's where I saw the leprechaun. He told me to burn things.",
+    "Me fail English? That's unpossible!",
+    'Even my boogers are spicy!',
+    'Mrs. Krabappel and Principal Skinner were in the closet making babies!',
+  ],
+} as const;
+
+/**
+ * Get a random quote appropriate for the given context category.
+ */
+export function getQuoteForContext(category: QuoteCategory): string {
+  const quotes = QUOTES_BY_CATEGORY[category];
+  const index = Math.floor(Math.random() * quotes.length);
+  return quotes[index] ?? '';
+}
+
+// ============================================================================
+// STATUS EMOJI
+// ============================================================================
+
+export const statusEmoji = {
+  todo: '📝',
+  in_progress: '🏃',
+  done: '✅',
+  blocked: '🚫',
+  draft: '📋',
+  active: '🎯',
+  closed: '🎉',
+} as const;
+
+export function getStatusEmoji(status: string): string {
+  if (status in statusEmoji) {
+    return statusEmoji[status as keyof typeof statusEmoji];
+  }
+  return status;
+}
+
+// ============================================================================
+// MESSAGES
+// ============================================================================
+
+export const messages = {
+  welcome: "Hi, Super Nintendo Chalmers! I'm ready to help!",
+  goodbye: "Bye bye! My cat's breath smells like cat food!",
+  taskComplete: "Yay! I did a task! I'm a unitard!",
+  sprintCreated: 'I made a sprint! Go banana!',
+  sprintActivated: "The sprint is awake now! It's unpossible to fail!",
+  sprintClosed: "We finished! That's where I saw the leprechaun!",
+  ticketAdded: "I added a ticket! I'm learnding!",
+  projectAdded: 'I found a project! It smells like hot dogs!',
+  error: 'My tummy hurts:',
+  confirm: 'Do you want to? I picked the red one!',
+} as const;
+
+export function getMessage(key: keyof typeof messages): string {
+  return messages[key];
+}