@specforge/mcp 2.0.9 → 2.1.0

package/dist/cli/commands/specs.js

@@ -0,0 +1,212 @@
+/**
+ * Specs Command
+ *
+ * Lists specifications within a project.
+ */
+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 { formatSpecId, formatProgress, isCurrentSpec, isValidStatus, CURRENT_MARKER, VALID_STATUSES, } from './specs.types.js';
+/**
+ * Get chalk color function for status
+ */
+function getStatusColorFn(status) {
+    switch (status) {
+        case 'completed':
+            return colors.success;
+        case 'in_progress':
+            return colors.primary;
+        case 'ready':
+            return colors.warning;
+        case 'draft':
+            return colors.muted;
+        default:
+            return (s) => s;
+    }
+}
+/**
+ * Format specifications as TOON
+ */
+function formatSpecsAsToon(specs, projectName, currentSpecId) {
+    const lines = [`@specs (${projectName})`];
+    for (const spec of specs) {
+        const isCurrent = isCurrentSpec(spec, currentSpecId);
+        const marker = isCurrent ? '* ' : '  ';
+        const progress = formatProgress(spec.completedTickets, spec.ticketCount);
+        lines.push(`${marker}${spec.id}`);
+        lines.push(`    title: ${spec.title}`);
+        lines.push(`    status: ${spec.status}`);
+        lines.push(`    tickets: ${spec.completedTickets}/${spec.ticketCount} (${progress})`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Display specifications as table
+ */
+function displaySpecsTable(specs, projectName, currentSpecId) {
+    printBlank();
+    printHeader(`Specifications (${projectName})`);
+    printBlank();
+    const table = new Table({
+        head: [
+            colors.muted('ID'),
+            colors.muted('TITLE'),
+            colors.muted('STATUS'),
+            colors.muted('TICKETS'),
+            colors.muted('PROGRESS'),
+        ],
+        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': ' ',
+        },
+    });
+    for (const spec of specs) {
+        const isCurrent = isCurrentSpec(spec, currentSpecId);
+        const marker = isCurrent ? colors.primary(CURRENT_MARKER) : '  ';
+        const displayId = formatSpecId(spec.id);
+        const displayTitle = isCurrent ? colors.primary(spec.title) : spec.title;
+        const statusColor = getStatusColorFn(spec.status);
+        const progress = formatProgress(spec.completedTickets, spec.ticketCount);
+        table.push([
+            marker + displayId,
+            displayTitle,
+            statusColor(spec.status),
+            spec.ticketCount.toString(),
+            progress,
+        ]);
+    }
+    console.log(table.toString());
+    printBlank();
+}
+/**
+ * Display empty state
+ */
+function displayEmptyState(projectName, statusFilter) {
+    printBlank();
+    console.log(colors.muted(`No specifications found in "${projectName}".`));
+    if (statusFilter) {
+        console.log(colors.muted(`Try removing the --status filter.`));
+    }
+    printBlank();
+}
+/**
+ * Specs command action handler
+ */
+export async function specsAction(projectId, options) {
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        throw new CliError('Not authenticated', 1, 'Run `specforge-mcp login` to authenticate first');
+    }
+    // Determine project ID
+    const targetProjectId = projectId || config.projectId;
+    if (!targetProjectId) {
+        throw new CliError('No project specified', 1, "Provide a project ID or run 'specforge-mcp init' to set a default project");
+    }
+    // Validate status filter if provided
+    if (options.status && !isValidStatus(options.status)) {
+        throw new ValidationError(`Invalid status: ${options.status}`, `Valid statuses: ${VALID_STATUSES.join(', ')}`);
+    }
+    const spinner = ora({
+        text: 'Fetching specifications...',
+        color: 'cyan',
+    }).start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: config.apiUrl,
+            debug: config.debug,
+        });
+        // Get project name for display
+        let projectName = targetProjectId;
+        try {
+            const projectResponse = await client.call('get_project', {
+                projectId: targetProjectId,
+            });
+            projectName = projectResponse.name || targetProjectId;
+        }
+        catch {
+            // Use project ID if name fetch fails
+        }
+        // Get specifications
+        const response = await client.call('list_specifications', {
+            projectId: targetProjectId,
+            status: options.status,
+        });
+        spinner.stop();
+        const specs = response.specifications || [];
+        // Handle empty state
+        if (specs.length === 0) {
+            displayEmptyState(projectName, options.status);
+            return;
+        }
+        // Output based on format
+        if (options.json) {
+            console.log(JSON.stringify({
+                project: projectName,
+                specifications: specs,
+            }, null, 2));
+            return;
+        }
+        if (options.toon) {
+            console.log(formatSpecsAsToon(specs, projectName, config.specificationId ?? undefined));
+            return;
+        }
+        // Default: table format
+        displaySpecsTable(specs, projectName, config.specificationId ?? undefined);
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch specifications');
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        if (message.includes('404') || message.includes('not found')) {
+            throw new CliError(`Project "${targetProjectId}" not found`, 1, 'Check the project ID or run `specforge-mcp projects` to see available projects');
+        }
+        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');
+        }
+        if (message.includes('403') || message.includes('Forbidden')) {
+            throw new CliError(`Access denied to project "${targetProjectId}"`, 1, 'You may not have permission to view this project');
+        }
+        throw new NetworkError(`Failed to fetch specifications: ${message}`);
+    }
+}
+/**
+ * Register specs command with Commander
+ */
+export function registerSpecsCommand(program) {
+    program
+        .command('specs [projectId]')
+        .description('List specifications in a project')
+        .option('--status <status>', 'Filter by status (draft, ready, in_progress, completed)')
+        .option('--json', 'Output as JSON')
+        .option('--toon', 'Output as TOON format')
+        .addHelpText('after', `
+Examples:
+  $ specforge-mcp specs                    # List specs for current project
+  $ specforge-mcp specs proj_abc123        # List specs for specific project
+  $ specforge-mcp specs --status ready     # Filter by status
+  $ specforge-mcp specs --json             # Output as JSON
+  $ specforge-mcp specs --toon             # Output as TOON format
+
+Valid statuses: draft, ready, in_progress, completed
+
+The current specification (set via 'init' or 'switch') is marked with ▶
+
+Status colors:
+  ${colors.success('completed')} - All tickets done
+  ${colors.primary('in_progress')} - Currently being implemented
+  ${colors.warning('ready')} - Ready to start implementation
+  ${colors.muted('draft')} - Still being defined
+`)
+        .action(withErrorHandler(specsAction));
+}
+//# sourceMappingURL=specs.js.map

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

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

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

@@ -0,0 +1,120 @@
+/**
+ * Specs Command Types
+ *
+ * Type definitions for the specifications list command.
+ */
+/**
+ * Specs command options from Commander
+ */
+export interface SpecsOptions {
+    /** Filter by status */
+    status?: SpecificationStatus;
+    /** Output as JSON */
+    json?: boolean;
+    /** Output as TOON format */
+    toon?: boolean;
+}
+/**
+ * Valid specification statuses
+ */
+export type SpecificationStatus = 'draft' | 'ready' | 'in_progress' | 'completed';
+/**
+ * All valid specification statuses
+ */
+export declare const VALID_STATUSES: SpecificationStatus[];
+/**
+ * Specification summary for list display
+ */
+export interface Specification {
+    /** Specification ID */
+    id: string;
+    /** Specification title */
+    title: string;
+    /** Current status */
+    status: SpecificationStatus;
+    /** Total number of tickets */
+    ticketCount: number;
+    /** Number of completed tickets */
+    completedTickets: number;
+    /** Specification description (optional) */
+    description?: string;
+}
+/**
+ * API response for get_project
+ */
+export interface GetProjectApiResponse {
+    /** Project ID */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Project description */
+    description?: string;
+}
+/**
+ * API response for list_specifications
+ */
+export interface ListSpecificationsApiResponse {
+    /** Array of specifications */
+    specifications: Specification[];
+    /** Total count (for pagination) */
+    total?: number;
+}
+/**
+ * Specs list response for output
+ */
+export interface SpecsListResponse {
+    /** Project name for display */
+    project: string;
+    /** Array of specifications */
+    specifications: Specification[];
+    /** Current specification ID (for marking) */
+    currentSpecId?: string;
+}
+/**
+ * Table column configuration
+ */
+export interface SpecTableColumn {
+    /** Column header */
+    header: string;
+    /** Column width */
+    width?: number;
+    /** Alignment */
+    align?: 'left' | 'right' | 'center';
+}
+/**
+ * Default table columns for specifications
+ */
+export declare const SPEC_TABLE_COLUMNS: SpecTableColumn[];
+/**
+ * Status display colors
+ */
+export declare const STATUS_COLORS: Record<SpecificationStatus, string>;
+/**
+ * Current specification marker
+ */
+export declare const CURRENT_MARKER = "\u25B6 ";
+/**
+ * ID truncation length
+ */
+export declare const ID_DISPLAY_LENGTH = 8;
+/**
+ * Calculate progress percentage
+ */
+export declare function calculateProgress(completed: number, total: number): number;
+/**
+ * Format progress for display
+ */
+export declare function formatProgress(completed: number, total: number): string;
+/**
+ * Format a specification ID for display (truncated)
+ */
+export declare function formatSpecId(id: string): string;
+/**
+ * Check if a specification is the current specification
+ */
+export declare function isCurrentSpec(spec: Specification, currentId?: string): boolean;
+/**
+ * Validate status filter
+ */
+export declare function isValidStatus(status: string): status is SpecificationStatus;
+//# sourceMappingURL=specs.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/specs.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,mBAAmB,EAK/C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,8BAA8B;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAM/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAK7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,YAAO,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,mBAAmB,CAE3E"}

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

@@ -0,0 +1,75 @@
+/**
+ * Specs Command Types
+ *
+ * Type definitions for the specifications list command.
+ */
+/**
+ * All valid specification statuses
+ */
+export const VALID_STATUSES = [
+    'draft',
+    'ready',
+    'in_progress',
+    'completed',
+];
+/**
+ * Default table columns for specifications
+ */
+export const SPEC_TABLE_COLUMNS = [
+    { header: 'ID', width: 10 },
+    { header: 'TITLE', width: 30 },
+    { header: 'STATUS', width: 12 },
+    { header: 'TICKETS', width: 8, align: 'right' },
+    { header: 'PROGRESS', width: 10, align: 'right' },
+];
+/**
+ * Status display colors
+ */
+export const STATUS_COLORS = {
+    completed: 'green',
+    in_progress: 'blue',
+    ready: 'yellow',
+    draft: 'dim',
+};
+/**
+ * Current specification marker
+ */
+export const CURRENT_MARKER = '▶ ';
+/**
+ * ID truncation length
+ */
+export const ID_DISPLAY_LENGTH = 8;
+/**
+ * Calculate progress percentage
+ */
+export function calculateProgress(completed, total) {
+    if (total === 0)
+        return 0;
+    return Math.round((completed / total) * 100);
+}
+/**
+ * Format progress for display
+ */
+export function formatProgress(completed, total) {
+    const percentage = calculateProgress(completed, total);
+    return `${percentage}%`;
+}
+/**
+ * Format a specification ID for display (truncated)
+ */
+export function formatSpecId(id) {
+    return id.slice(0, ID_DISPLAY_LENGTH);
+}
+/**
+ * Check if a specification is the current specification
+ */
+export function isCurrentSpec(spec, currentId) {
+    return !!currentId && spec.id === currentId;
+}
+/**
+ * Validate status filter
+ */
+export function isValidStatus(status) {
+    return VALID_STATUSES.includes(status);
+}
+//# sourceMappingURL=specs.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.types.js","sourceRoot":"","sources":["../../../src/cli/commands/specs.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,OAAO;IACP,OAAO;IACP,aAAa;IACb,WAAW;CACZ,CAAC;AAkEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IAC3B,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9B,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;IAC/B,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;IAC/C,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwC;IAChE,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,KAAK;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,KAAa;IAChE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,KAAa;IAC7D,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO,GAAG,UAAU,GAAG,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,SAAkB;IACnE,OAAO,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,MAA6B,CAAC,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Status Command
+ *
+ * Displays the current working context and implementation session status,
+ * providing a quick overview of where the user is in their workflow.
+ */
+import { Command } from 'commander';
+import { StatusOptions } from './status.types.js';
+/**
+ * Status command action handler
+ */
+export declare function statusAction(options: StatusOptions): Promise<void>;
+/**
+ * Register status command with Commander
+ */
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EACL,aAAa,EAad,MAAM,mBAAmB,CAAC;AAsK3B;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmC5D"}