@specforge/mcp 2.0.9 → 2.1.0

package/dist/cli/commands/ticket/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Ticket Command Types & Interfaces
+ *
+ * Type definitions for the ticket detail command, including ticket data structures,
+ * display options, and code/type reference formats.
+ */
+/**
+ * Command options for ticket detail
+ */
+export interface TicketCommandOptions {
+    json?: boolean;
+    toon?: boolean;
+}
+/**
+ * Code reference attached to a ticket
+ */
+export interface CodeReference {
+    /** Reference name/title */
+    name: string;
+    /** Code snippet */
+    code: string;
+    /** Programming language for syntax highlighting */
+    language?: string;
+}
+/**
+ * Type definition reference attached to a ticket
+ */
+export interface TypeReference {
+    /** Type name */
+    name: string;
+    /** Type definition (TypeScript code) */
+    definition: string;
+}
+/**
+ * Acceptance criteria validation status
+ */
+export interface AcceptanceCriteriaValidation {
+    /** The criterion text */
+    criterion: string;
+    /** Validation status */
+    status: 'pending' | 'passed' | 'failed';
+    /** Optional notes explaining the status */
+    notes?: string;
+}
+/**
+ * Ticket implementation details
+ */
+export interface TicketImplementation {
+    /** Implementation approach description */
+    approach?: string;
+    /** Additional implementation notes */
+    notes?: string;
+    /** Files to be modified/created */
+    files?: string[];
+}
+/**
+ * Epic summary for ticket context
+ */
+export interface TicketEpicSummary {
+    id: string;
+    title: string;
+}
+/**
+ * Ticket priority levels
+ */
+export type TicketPriority = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Ticket status values
+ */
+export type TicketStatus = 'pending' | 'in_progress' | 'done' | 'blocked' | 'cancelled';
+/**
+ * Ticket complexity levels
+ */
+export type TicketComplexity = 'trivial' | 'low' | 'medium' | 'high' | 'complex';
+/**
+ * Complete ticket detail structure
+ */
+export interface Ticket {
+    /** Unique ticket ID */
+    id: string;
+    /** Sequential ticket number within specification */
+    ticketNumber: number;
+    /** Ticket title */
+    title: string;
+    /** Detailed description */
+    description?: string;
+    /** Priority level */
+    priority: TicketPriority;
+    /** Current status */
+    status: TicketStatus;
+    /** Complexity estimate */
+    complexity?: TicketComplexity;
+    /** Estimated hours to complete */
+    estimatedHours?: number;
+    /** Actual hours spent */
+    actualHours?: number;
+    /** List of acceptance criteria */
+    acceptanceCriteria?: string[];
+    /** Validation status for each criterion */
+    acceptanceCriteriaValidation?: AcceptanceCriteriaValidation[];
+    /** Technical implementation details */
+    technicalDetails?: string;
+    /** Implementation notes and approach */
+    implementation?: TicketImplementation;
+    /** IDs of tickets this ticket blocks */
+    dependencies?: string[];
+    /** IDs of tickets blocking this ticket */
+    blockedBy?: string[];
+    /** Code snippets referenced by this ticket */
+    codeReferences?: CodeReference[];
+    /** Type definitions referenced by this ticket */
+    typeReferences?: TypeReference[];
+    /** Parent epic information */
+    epic?: TicketEpicSummary;
+    /** Creation timestamp */
+    createdAt?: string;
+    /** Last update timestamp */
+    updatedAt?: string;
+}
+/**
+ * Minimal ticket info for dependency display
+ */
+export interface TicketSummary {
+    id: string;
+    ticketNumber: number;
+    title: string;
+    status: TicketStatus;
+}
+/**
+ * Color function type for chalk styling
+ */
+export type ColorFunction = (text: string) => string;
+/**
+ * Section display configuration
+ */
+export interface TicketSection {
+    /** Section title */
+    title: string;
+    /** Section icon (emoji) */
+    icon: string;
+    /** Whether the section has content to display */
+    hasContent: boolean;
+    /** Render function for the section */
+    render: () => void;
+}
+/**
+ * Ticket formatting options
+ */
+export interface TicketFormatOptions {
+    /** Show colors in output */
+    colors: boolean;
+    /** Show icons/emojis */
+    icons: boolean;
+    /** Wrap long lines at this width */
+    wrapWidth?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/commands/ticket/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ticket/types.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ticket/types.js

@@ -0,0 +1,8 @@
+/**
+ * Ticket Command Types & Interfaces
+ *
+ * Type definitions for the ticket detail command, including ticket data structures,
+ * display options, and code/type reference formats.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/commands/ticket/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/commands/ticket/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/cli/commands/tickets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tickets Command
+ *
+ * Lists tickets for the current specification with filtering options.
+ */
+import { Command } from 'commander';
+import { TicketsOptions } from './tickets.types.js';
+/**
+ * Tickets command action handler
+ */
+export declare function ticketsAction(options: TicketsOptions): Promise<void>;
+/**
+ * Register tickets command with Commander
+ */
+export declare function registerTicketsCommand(program: Command): void;
+//# sourceMappingURL=tickets.d.ts.map

package/dist/cli/commands/tickets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EACL,cAAc,EAaf,MAAM,oBAAoB,CAAC;AA8I5B;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuI1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoC7D"}

package/dist/cli/commands/tickets.js

@@ -0,0 +1,271 @@
+/**
+ * Tickets Command
+ *
+ * Lists tickets for the current specification with filtering options.
+ */
+import ora from 'ora';
+import Table from 'cli-table3';
+import { resolveConfig } from '../config/index.js';
+import { withErrorHandler, CliError, NetworkError, ValidationError } from '../middleware/error-handler.js';
+import { printBlank, printHeader } from '../ui/output.js';
+import { colors } from '../ui/colors.js';
+import { ApiClient } from '../../client/api-client.js';
+import { formatTicketNumber, truncateTitle, isTicketBlocked, isValidStatus, isValidPriority, VALID_STATUSES, VALID_PRIORITIES, } from './tickets.types.js';
+/**
+ * Get chalk color function for priority
+ */
+function getPriorityColorFn(priority) {
+    switch (priority) {
+        case 'critical':
+            return colors.error;
+        case 'high':
+            return colors.warning;
+        case 'medium':
+            return colors.primary;
+        case 'low':
+            return colors.muted;
+        default:
+            return (s) => s;
+    }
+}
+/**
+ * Get chalk color function for status
+ */
+function getStatusColorFn(status) {
+    switch (status) {
+        case 'done':
+            return colors.success;
+        case 'in_progress':
+            return colors.primary;
+        case 'pending':
+            return colors.warning;
+        case 'blocked':
+            return colors.error;
+        default:
+            return (s) => s;
+    }
+}
+/**
+ * Format tickets as TOON
+ */
+function formatTicketsAsToon(tickets, specTitle) {
+    const lines = [`@tickets (${specTitle})`];
+    for (const ticket of tickets) {
+        const blocked = isTicketBlocked(ticket) ? ' [BLOCKED]' : '';
+        lines.push(`  ${formatTicketNumber(ticket.ticketNumber)}${blocked}`);
+        lines.push(`    title: ${ticket.title}`);
+        lines.push(`    priority: ${ticket.priority}`);
+        lines.push(`    status: ${ticket.status}`);
+        if (ticket.epicId) {
+            lines.push(`    epic: ${ticket.epicId}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Display tickets as table
+ */
+function displayTicketsTable(tickets, specTitle) {
+    printBlank();
+    printHeader(`Tickets (${specTitle})`);
+    printBlank();
+    const table = new Table({
+        head: [
+            colors.muted('#'),
+            colors.muted('TITLE'),
+            colors.muted('PRIORITY'),
+            colors.muted('STATUS'),
+            colors.muted('BLOCKED'),
+        ],
+        style: {
+            head: [],
+            border: [],
+        },
+        chars: {
+            'top': '', 'top-mid': '', 'top-left': '', 'top-right': '',
+            'bottom': '', 'bottom-mid': '', 'bottom-left': '', 'bottom-right': '',
+            'left': '', 'left-mid': '', 'mid': '', 'mid-mid': '',
+            'right': '', 'right-mid': '', 'middle': ' ',
+        },
+        colWidths: [7, 42, 12, 14, 10],
+    });
+    for (const ticket of tickets) {
+        const priorityColor = getPriorityColorFn(ticket.priority);
+        const statusColor = getStatusColorFn(ticket.status);
+        const blocked = isTicketBlocked(ticket);
+        table.push([
+            formatTicketNumber(ticket.ticketNumber),
+            truncateTitle(ticket.title),
+            priorityColor(ticket.priority),
+            statusColor(ticket.status),
+            blocked ? colors.error('Yes') : colors.muted('No'),
+        ]);
+    }
+    console.log(table.toString());
+    printBlank();
+}
+/**
+ * Display empty state
+ */
+function displayEmptyState(specTitle, hasFilters) {
+    printBlank();
+    console.log(colors.muted(`No tickets found in "${specTitle}".`));
+    if (hasFilters) {
+        console.log(colors.muted('Try adjusting your filters.'));
+    }
+    printBlank();
+}
+/**
+ * Display summary footer
+ */
+function displaySummary(tickets, limit) {
+    const blockedCount = tickets.filter(isTicketBlocked).length;
+    const parts = [`${tickets.length} ticket${tickets.length !== 1 ? 's' : ''}`];
+    if (limit) {
+        parts.push(`(limited to ${limit})`);
+    }
+    if (blockedCount > 0) {
+        parts.push(`${blockedCount} blocked`);
+    }
+    console.log(colors.muted(parts.join(' | ')));
+    printBlank();
+}
+/**
+ * Tickets command action handler
+ */
+export async function ticketsAction(options) {
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        throw new CliError('Not authenticated', 1, 'Run `specforge-mcp login` to authenticate first');
+    }
+    if (!config.specificationId) {
+        throw new CliError('No specification configured', 1, "Run 'specforge-mcp init' or 'specforge-mcp switch <spec-id>' to set a specification");
+    }
+    // Validate filters
+    if (options.status && !isValidStatus(options.status)) {
+        throw new ValidationError(`Invalid status: ${options.status}`, `Valid statuses: ${VALID_STATUSES.join(', ')}`);
+    }
+    if (options.priority && !isValidPriority(options.priority)) {
+        throw new ValidationError(`Invalid priority: ${options.priority}`, `Valid priorities: ${VALID_PRIORITIES.join(', ')}`);
+    }
+    const spinner = ora({
+        text: 'Fetching tickets...',
+        color: 'cyan',
+    }).start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: config.apiUrl,
+            debug: config.debug,
+        });
+        // Get specification info for header
+        let specTitle = config.specificationId;
+        try {
+            const specResponse = await client.call('get_specification', {
+                specificationId: config.specificationId,
+            });
+            specTitle = specResponse.title || config.specificationId;
+        }
+        catch {
+            // Use spec ID if name fetch fails
+        }
+        // Build query parameters
+        const queryParams = {
+            specificationId: config.specificationId,
+        };
+        if (options.epic) {
+            queryParams.epicId = options.epic;
+        }
+        if (options.status) {
+            queryParams.status = options.status;
+        }
+        if (options.priority) {
+            queryParams.priority = options.priority;
+        }
+        if (options.limit) {
+            queryParams.limit = parseInt(options.limit, 10);
+        }
+        // Fetch tickets
+        const response = await client.call('list_tickets', queryParams);
+        spinner.stop();
+        const tickets = response.tickets || [];
+        const hasFilters = !!(options.epic || options.status || options.priority);
+        // Handle empty state
+        if (tickets.length === 0) {
+            displayEmptyState(specTitle, hasFilters);
+            return;
+        }
+        // Output based on format
+        if (options.json) {
+            console.log(JSON.stringify({
+                specification: specTitle,
+                tickets,
+                filters: hasFilters ? {
+                    epic: options.epic,
+                    status: options.status,
+                    priority: options.priority,
+                } : undefined,
+            }, null, 2));
+            return;
+        }
+        if (options.toon) {
+            console.log(formatTicketsAsToon(tickets, specTitle));
+            return;
+        }
+        // Default: table format
+        displayTicketsTable(tickets, specTitle);
+        displaySummary(tickets, options.limit);
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch tickets');
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        if (message.includes('404') || message.includes('not found')) {
+            throw new CliError('Specification not found', 1, 'The configured specification may have been deleted. Run `specforge-mcp init` to select a new one.');
+        }
+        if (message.includes('401') || message.includes('Unauthorized')) {
+            throw new CliError('Authentication failed', 1, 'Your API key may be invalid. Run `specforge-mcp login` to re-authenticate');
+        }
+        throw new NetworkError(`Failed to fetch tickets: ${message}`);
+    }
+}
+/**
+ * Register tickets command with Commander
+ */
+export function registerTicketsCommand(program) {
+    program
+        .command('tickets')
+        .description('List tickets in the current specification')
+        .option('--epic <id>', 'Filter by epic ID')
+        .option('--status <status>', 'Filter by status (pending, in_progress, done, blocked)')
+        .option('--priority <priority>', 'Filter by priority (critical, high, medium, low)')
+        .option('--limit <n>', 'Limit number of results')
+        .option('--json', 'Output as JSON')
+        .option('--toon', 'Output as TOON format')
+        .addHelpText('after', `
+Examples:
+  $ specforge-mcp tickets                          # List all tickets
+  $ specforge-mcp tickets --status pending         # Filter by status
+  $ specforge-mcp tickets --priority high          # Filter by priority
+  $ specforge-mcp tickets --epic epic_abc123       # Filter by epic
+  $ specforge-mcp tickets --status pending --priority high  # Combine filters
+  $ specforge-mcp tickets --limit 10               # Limit results
+  $ specforge-mcp tickets --json                   # Output as JSON
+
+Valid statuses: pending, in_progress, done, blocked
+Valid priorities: critical, high, medium, low
+
+Priority colors:
+  ${colors.error('critical')} - Immediate attention needed
+  ${colors.warning('high')} - Important, address soon
+  ${colors.primary('medium')} - Normal priority
+  ${colors.muted('low')} - Can wait
+
+Status colors:
+  ${colors.success('done')} - Completed
+  ${colors.primary('in_progress')} - Currently being worked on
+  ${colors.warning('pending')} - Not yet started
+  ${colors.error('blocked')} - Blocked by dependencies
+`)
+        .action(withErrorHandler(ticketsAction));
+}
+//# sourceMappingURL=tickets.js.map

package/dist/cli/commands/tickets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.js","sourceRoot":"","sources":["../../../src/cli/commands/tickets.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/tickets.types.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Tickets Command Types
+ *
+ * Type definitions for the tickets list command.
+ */
+/**
+ * Tickets command options from Commander
+ */
+export interface TicketsOptions {
+    /** Filter by epic ID */
+    epic?: string;
+    /** Filter by status */
+    status?: TicketStatus;
+    /** Filter by priority */
+    priority?: TicketPriority;
+    /** Limit number of results */
+    limit?: string;
+    /** Output as JSON */
+    json?: boolean;
+    /** Output as TOON format */
+    toon?: boolean;
+}
+/**
+ * Valid ticket statuses
+ */
+export type TicketStatus = 'pending' | 'in_progress' | 'done' | 'blocked';
+/**
+ * All valid ticket statuses
+ */
+export declare const VALID_STATUSES: TicketStatus[];
+/**
+ * Valid ticket priorities
+ */
+export type TicketPriority = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * All valid ticket priorities
+ */
+export declare const VALID_PRIORITIES: TicketPriority[];
+/**
+ * Ticket data from API
+ */
+export interface Ticket {
+    /** Ticket ID */
+    id: string;
+    /** Sequential ticket number within specification */
+    ticketNumber: number;
+    /** Ticket title */
+    title: string;
+    /** Ticket priority */
+    priority: TicketPriority;
+    /** Ticket status */
+    status: TicketStatus;
+    /** Epic ID this ticket belongs to (optional) */
+    epicId?: string;
+    /** List of ticket IDs that block this ticket */
+    blockedBy?: string[];
+    /** Ticket description (optional) */
+    description?: string;
+    /** Estimated complexity (optional) */
+    complexity?: string;
+}
+/**
+ * API request for list_tickets
+ */
+export interface ListTicketsRequest {
+    /** Specification ID */
+    specificationId: string;
+    /** Filter by epic ID */
+    epicId?: string;
+    /** Filter by status */
+    status?: TicketStatus;
+    /** Filter by priority */
+    priority?: TicketPriority;
+    /** Limit number of results */
+    limit?: number;
+}
+/**
+ * API response for list_tickets
+ */
+export interface ListTicketsApiResponse {
+    /** Array of tickets */
+    tickets: Ticket[];
+    /** Total count (for pagination) */
+    total?: number;
+}
+/**
+ * API response for get_specification (used for header)
+ */
+export interface GetSpecificationApiResponse {
+    /** Specification ID */
+    id: string;
+    /** Specification title */
+    title: string;
+    /** Project ID */
+    projectId: string;
+}
+/**
+ * Tickets list response for output
+ */
+export interface TicketsListResponse {
+    /** Specification title for display */
+    specification: string;
+    /** Array of tickets */
+    tickets: Ticket[];
+    /** Applied filters (for display) */
+    filters?: {
+        epic?: string;
+        status?: string;
+        priority?: string;
+    };
+}
+/**
+ * Table column configuration
+ */
+export interface TicketTableColumn {
+    /** Column header */
+    header: string;
+    /** Column width */
+    width?: number;
+    /** Alignment */
+    align?: 'left' | 'right' | 'center';
+}
+/**
+ * Default table columns for tickets
+ */
+export declare const TICKET_TABLE_COLUMNS: TicketTableColumn[];
+/**
+ * Priority display colors (chalk color names)
+ */
+export declare const PRIORITY_COLORS: Record<TicketPriority, string>;
+/**
+ * Status display colors (chalk color names)
+ */
+export declare const STATUS_COLORS: Record<TicketStatus, string>;
+/**
+ * Maximum title length for table display
+ */
+export declare const MAX_TITLE_LENGTH = 38;
+/**
+ * Ticket number padding width
+ */
+export declare const TICKET_NUMBER_WIDTH = 3;
+/**
+ * Format ticket number with leading zeros
+ *
+ * @param num Ticket number
+ * @returns Formatted ticket number (e.g., "001", "042")
+ */
+export declare function formatTicketNumber(num: number): string;
+/**
+ * Truncate title if too long for display
+ *
+ * @param title Ticket title
+ * @param maxLength Maximum length (default: MAX_TITLE_LENGTH)
+ * @returns Truncated title with ellipsis if needed
+ */
+export declare function truncateTitle(title: string, maxLength?: number): string;
+/**
+ * Check if a ticket is blocked
+ *
+ * @param ticket Ticket to check
+ * @returns True if ticket has blockers
+ */
+export declare function isTicketBlocked(ticket: Ticket): boolean;
+/**
+ * Validate status filter
+ *
+ * @param status Status to validate
+ * @returns True if valid status
+ */
+export declare function isValidStatus(status: string): status is TicketStatus;
+/**
+ * Validate priority filter
+ *
+ * @param priority Priority to validate
+ * @returns True if valid priority
+ */
+export declare function isValidPriority(priority: string): priority is TicketPriority;
+/**
+ * Get count of blocked tickets
+ *
+ * @param tickets Array of tickets
+ * @returns Number of blocked tickets
+ */
+export declare function countBlockedTickets(tickets: Ticket[]): number;
+/**
+ * Get tickets by status
+ *
+ * @param tickets Array of tickets
+ * @param status Status to filter by
+ * @returns Filtered tickets
+ */
+export declare function getTicketsByStatus(tickets: Ticket[], status: TicketStatus): Ticket[];
+/**
+ * Get tickets by priority
+ *
+ * @param tickets Array of tickets
+ * @param priority Priority to filter by
+ * @returns Filtered tickets
+ */
+export declare function getTicketsByPriority(tickets: Ticket[], priority: TicketPriority): Ticket[];
+//# sourceMappingURL=tickets.types.d.ts.map