@specforge/mcp 3.0.7 → 3.1.1

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

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

package/dist/cli/commands/review-implementation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Review Implementation Command
+ *
+ * CLI command to evaluate the implementation review gate for a specification.
+ * Calls the review_implementation API operation and displays the result.
+ */
+import { Command } from 'commander';
+interface ReviewImplementationOptions {
+    json?: boolean;
+    fix?: boolean;
+    verbose?: boolean;
+}
+export declare function reviewImplementationCommand(specId: string | undefined, options: ReviewImplementationOptions): Promise<void>;
+export declare function registerReviewImplementationCommand(program: Command): void;
+export {};
+//# sourceMappingURL=review-implementation.d.ts.map

package/dist/cli/commands/review-implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-implementation.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review-implementation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,UAAU,2BAA2B;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmMD,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAuDf;AAMD,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyB1E"}

package/dist/cli/commands/review-implementation.js

@@ -0,0 +1,226 @@
+/**
+ * Review Implementation Command
+ *
+ * CLI command to evaluate the implementation review gate for a specification.
+ * Calls the review_implementation API operation and displays the result.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { resolveConfig } from '../config/index.js';
+import { ApiClient } from '../../client/api-client.js';
+import { withErrorHandler, CliError } from '../middleware/error-handler.js';
+// =============================================================================
+// Display helpers
+// =============================================================================
+const SEVERITY_ICONS = {
+    error: chalk.red('\u2717'),
+    warning: chalk.yellow('\u26A0'),
+    info: chalk.blue('\u2139'),
+};
+const CATEGORY_LABELS = {
+    structural: 'Structural',
+    semantic: 'Semantic',
+    'cross-entity': 'Cross-Entity',
+};
+function formatImplementationResult(response, showFix, verbose) {
+    const lines = [];
+    const { result } = response;
+    lines.push('');
+    if (result.passed) {
+        lines.push(chalk.green('\u2713') + chalk.bold(' Implementation review passed'));
+        lines.push(chalk.gray('\u2500'.repeat(40)));
+        if (response.autoTransitioned) {
+            lines.push(chalk.green(`  Specification auto-transitioned to: ${response.newStatus}`));
+        }
+        else {
+            lines.push(chalk.dim('  Specification eligible for transition: in_progress \u2192 completed'));
+        }
+        if (response.message) {
+            lines.push(chalk.dim(`  ${response.message}`));
+        }
+    }
+    else {
+        lines.push(chalk.red('\u2717') + chalk.bold(' Implementation review failed'));
+        lines.push(chalk.gray('\u2500'.repeat(40)));
+        if (response.message) {
+            lines.push(chalk.dim(`  ${response.message}`));
+        }
+        // Group findings by category
+        const grouped = groupByCategory(result.findings);
+        for (const [category, findings] of Object.entries(grouped)) {
+            lines.push('');
+            lines.push(chalk.bold(`  ${CATEGORY_LABELS[category] || category} Findings`));
+            lines.push(chalk.gray('  ' + '\u2500'.repeat(36)));
+            for (const finding of findings) {
+                const icon = SEVERITY_ICONS[finding.severity] || chalk.dim('\u2022');
+                lines.push(`    ${icon} ${finding.message}`);
+                if (showFix && finding.suggestion) {
+                    lines.push(chalk.dim(`      Fix: ${finding.suggestion}`));
+                }
+            }
+        }
+        // Show suggestions
+        if (result.suggestions.length > 0) {
+            lines.push('');
+            lines.push(chalk.bold('  Suggestions'));
+            lines.push(chalk.gray('  ' + '\u2500'.repeat(36)));
+            for (const suggestion of result.suggestions) {
+                lines.push(chalk.dim(`    \u2022 ${suggestion}`));
+            }
+        }
+    }
+    // Verbose: per-ticket breakdown
+    if (verbose) {
+        lines.push('');
+        lines.push(formatVerboseBreakdown(result));
+    }
+    // Show summary counts
+    const errorCount = result.findings.filter(f => f.severity === 'error').length;
+    const warningCount = result.findings.filter(f => f.severity === 'warning').length;
+    const infoCount = result.findings.filter(f => f.severity === 'info').length;
+    if (result.findings.length > 0) {
+        lines.push('');
+        const parts = [];
+        if (errorCount > 0)
+            parts.push(chalk.red(`${errorCount} error(s)`));
+        if (warningCount > 0)
+            parts.push(chalk.yellow(`${warningCount} warning(s)`));
+        if (infoCount > 0)
+            parts.push(chalk.blue(`${infoCount} info`));
+        lines.push(`  ${parts.join(', ')}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function formatVerboseBreakdown(result) {
+    const lines = [];
+    lines.push(chalk.bold('  Per-Ticket Breakdown'));
+    lines.push(chalk.gray('  ' + '\u2500'.repeat(36)));
+    // Extract ticket-scoped findings
+    const ticketFindings = new Map();
+    for (const finding of result.findings) {
+        const match = finding.field.match(/^ticket:([^:]+):/);
+        if (match) {
+            const ticketId = match[1];
+            if (!ticketFindings.has(ticketId)) {
+                ticketFindings.set(ticketId, []);
+            }
+            ticketFindings.get(ticketId).push(finding);
+        }
+    }
+    if (ticketFindings.size === 0) {
+        lines.push(chalk.dim('    No per-ticket findings'));
+    }
+    else {
+        for (const [ticketId, findings] of ticketFindings) {
+            lines.push(`    ${chalk.bold(ticketId)}`);
+            for (const finding of findings) {
+                const icon = SEVERITY_ICONS[finding.severity] || chalk.dim('\u2022');
+                lines.push(`      ${icon} ${finding.message}`);
+            }
+        }
+    }
+    // Show aggregate stats from findings
+    const ticketCompletion = result.findings.find(f => f.field === 'ticketCompletion');
+    const timeTracking = result.findings.find(f => f.field === 'timeTracking');
+    if (ticketCompletion || timeTracking) {
+        lines.push('');
+        lines.push(chalk.bold('  Aggregate Stats'));
+        lines.push(chalk.gray('  ' + '\u2500'.repeat(36)));
+        if (ticketCompletion) {
+            lines.push(`    ${SEVERITY_ICONS[ticketCompletion.severity]} ${ticketCompletion.message}`);
+        }
+        if (timeTracking) {
+            lines.push(`    ${SEVERITY_ICONS[timeTracking.severity]} ${timeTracking.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+function groupByCategory(findings) {
+    const grouped = {};
+    for (const finding of findings) {
+        const cat = finding.category;
+        if (!grouped[cat]) {
+            grouped[cat] = [];
+        }
+        grouped[cat].push(finding);
+    }
+    return grouped;
+}
+// =============================================================================
+// Command handler
+// =============================================================================
+export async function reviewImplementationCommand(specId, options) {
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        throw new CliError('Not authenticated', 1, 'Run `specforge login` to authenticate first');
+    }
+    // Resolve spec ID from arg or config
+    const specificationId = specId || config.specificationId;
+    if (!specificationId) {
+        console.error(chalk.red('\nError: No specification specified and no active specification.'));
+        console.error('Usage: specforge review-implementation [specId]');
+        console.error(chalk.dim("Run 'specforge init' or 'specforge switch' to set an active specification."));
+        process.exit(1);
+    }
+    const spinner = options.json ? null : ora('Running implementation review gate...').start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: config.apiUrl,
+            debug: config.debug,
+        });
+        const response = await client.call('review_implementation', {
+            specificationId,
+        });
+        spinner?.stop();
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+        }
+        else {
+            console.log(formatImplementationResult(response, !!options.fix, !!options.verbose));
+        }
+    }
+    catch (error) {
+        spinner?.fail('Implementation review failed');
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk.red(`\nError: ${message}`));
+        if (!options.json) {
+            console.error(chalk.dim('\nPossible causes:'));
+            console.error(chalk.dim('  - Invalid specification ID'));
+            console.error(chalk.dim('  - Network connectivity issues'));
+            console.error(chalk.dim('  - Authentication expired (try: specforge login)'));
+        }
+        process.exit(1);
+    }
+}
+// =============================================================================
+// Command registration
+// =============================================================================
+export function registerReviewImplementationCommand(program) {
+    program
+        .command('review-implementation [specId]')
+        .description('Run implementation review gate on a specification')
+        .addHelpText('after', `
+Arguments:
+  specId           Specification ID (defaults to active specification)
+
+Examples:
+  $ specforge review-implementation                         # Review active specification
+  $ specforge review-implementation spec_abc123             # Review specific specification
+  $ specforge review-implementation --json                  # JSON output
+  $ specforge review-implementation --fix                   # Show remediation suggestions
+  $ specforge review-implementation --verbose               # Per-ticket breakdown
+
+Implementation Gate Checks:
+  Ticket Completion   All tickets should be done
+  File Coverage       Planned vs actual files delivered
+  Test Coverage       Test tickets have reported results
+  Time Tracking       Estimated vs actual hours comparison
+    `)
+        .option('--json', 'Output as JSON')
+        .option('--fix', 'Show auto-remediation suggestions')
+        .option('--verbose', 'Show per-ticket implementation breakdown')
+        .action(withErrorHandler(reviewImplementationCommand));
+}
+//# sourceMappingURL=review-implementation.js.map

package/dist/cli/commands/review-implementation.js.map

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

package/dist/cli/commands/review-planning.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Review Planning Command
+ *
+ * CLI command to evaluate the planning review gate for a specification.
+ * Calls the review_planning API operation and displays the result.
+ */
+import { Command } from 'commander';
+interface ReviewPlanningOptions {
+    json?: boolean;
+    fix?: boolean;
+}
+export declare function reviewPlanningCommand(specId: string | undefined, options: ReviewPlanningOptions): Promise<void>;
+export declare function registerReviewPlanningCommand(program: Command): void;
+export {};
+//# sourceMappingURL=review-planning.d.ts.map

package/dist/cli/commands/review-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-planning.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review-planning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,UAAU,qBAAqB;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAqID,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAuDf;AAMD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBpE"}

package/dist/cli/commands/review-planning.js

@@ -0,0 +1,177 @@
+/**
+ * Review Planning Command
+ *
+ * CLI command to evaluate the planning review gate for a specification.
+ * Calls the review_planning API operation and displays the result.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { resolveConfig } from '../config/index.js';
+import { ApiClient } from '../../client/api-client.js';
+import { withErrorHandler, CliError } from '../middleware/error-handler.js';
+// =============================================================================
+// Display helpers
+// =============================================================================
+const SEVERITY_ICONS = {
+    error: chalk.red('\u2717'),
+    warning: chalk.yellow('\u26A0'),
+    info: chalk.blue('\u2139'),
+};
+const CATEGORY_LABELS = {
+    structural: 'Structural',
+    semantic: 'Semantic',
+    'cross-entity': 'Cross-Entity',
+};
+function formatPlanningResult(response, showFix) {
+    const lines = [];
+    const { result } = response;
+    lines.push('');
+    if (result.passed) {
+        lines.push(chalk.green('\u2713') + chalk.bold(' Planning review passed'));
+        lines.push(chalk.gray('\u2500'.repeat(40)));
+        if (response.autoTransitioned) {
+            lines.push(chalk.green(`  Specification auto-transitioned to: ${response.newStatus}`));
+        }
+        else {
+            lines.push(chalk.dim('  Specification eligible for transition: planning \u2192 ready'));
+        }
+        if (response.message) {
+            lines.push(chalk.dim(`  ${response.message}`));
+        }
+    }
+    else {
+        lines.push(chalk.red('\u2717') + chalk.bold(' Planning review failed'));
+        lines.push(chalk.gray('\u2500'.repeat(40)));
+        if (response.message) {
+            lines.push(chalk.dim(`  ${response.message}`));
+        }
+        // Group findings by category
+        const grouped = groupByCategory(result.findings);
+        for (const [category, findings] of Object.entries(grouped)) {
+            lines.push('');
+            lines.push(chalk.bold(`  ${CATEGORY_LABELS[category] || category} Findings`));
+            lines.push(chalk.gray('  ' + '\u2500'.repeat(36)));
+            for (const finding of findings) {
+                const icon = SEVERITY_ICONS[finding.severity] || chalk.dim('\u2022');
+                lines.push(`    ${icon} ${finding.message}`);
+                if (showFix && finding.suggestion) {
+                    lines.push(chalk.dim(`      Fix: ${finding.suggestion}`));
+                }
+            }
+        }
+        // Show suggestions
+        if (result.suggestions.length > 0) {
+            lines.push('');
+            lines.push(chalk.bold('  Suggestions'));
+            lines.push(chalk.gray('  ' + '\u2500'.repeat(36)));
+            for (const suggestion of result.suggestions) {
+                lines.push(chalk.dim(`    \u2022 ${suggestion}`));
+            }
+        }
+    }
+    // Show summary counts
+    const errorCount = result.findings.filter(f => f.severity === 'error').length;
+    const warningCount = result.findings.filter(f => f.severity === 'warning').length;
+    const infoCount = result.findings.filter(f => f.severity === 'info').length;
+    if (result.findings.length > 0) {
+        lines.push('');
+        const parts = [];
+        if (errorCount > 0)
+            parts.push(chalk.red(`${errorCount} error(s)`));
+        if (warningCount > 0)
+            parts.push(chalk.yellow(`${warningCount} warning(s)`));
+        if (infoCount > 0)
+            parts.push(chalk.blue(`${infoCount} info`));
+        lines.push(`  ${parts.join(', ')}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function groupByCategory(findings) {
+    const grouped = {};
+    for (const finding of findings) {
+        const cat = finding.category;
+        if (!grouped[cat]) {
+            grouped[cat] = [];
+        }
+        grouped[cat].push(finding);
+    }
+    return grouped;
+}
+// =============================================================================
+// Command handler
+// =============================================================================
+export async function reviewPlanningCommand(specId, options) {
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        throw new CliError('Not authenticated', 1, 'Run `specforge login` to authenticate first');
+    }
+    // Resolve spec ID from arg or config
+    const specificationId = specId || config.specificationId;
+    if (!specificationId) {
+        console.error(chalk.red('\nError: No specification specified and no active specification.'));
+        console.error('Usage: specforge review-planning [specId]');
+        console.error(chalk.dim("Run 'specforge init' or 'specforge switch' to set an active specification."));
+        process.exit(1);
+    }
+    const spinner = options.json ? null : ora('Running planning review gate...').start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: config.apiUrl,
+            debug: config.debug,
+        });
+        const response = await client.call('review_planning', {
+            specificationId,
+        });
+        spinner?.stop();
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+        }
+        else {
+            console.log(formatPlanningResult(response, !!options.fix));
+        }
+    }
+    catch (error) {
+        spinner?.fail('Planning review failed');
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk.red(`\nError: ${message}`));
+        if (!options.json) {
+            console.error(chalk.dim('\nPossible causes:'));
+            console.error(chalk.dim('  - Invalid specification ID'));
+            console.error(chalk.dim('  - Network connectivity issues'));
+            console.error(chalk.dim('  - Authentication expired (try: specforge login)'));
+        }
+        process.exit(1);
+    }
+}
+// =============================================================================
+// Command registration
+// =============================================================================
+export function registerReviewPlanningCommand(program) {
+    program
+        .command('review-planning [specId]')
+        .description('Run planning review gate on a specification')
+        .addHelpText('after', `
+Arguments:
+  specId           Specification ID (defaults to active specification)
+
+Examples:
+  $ specforge review-planning                         # Review active specification
+  $ specforge review-planning spec_abc123             # Review specific specification
+  $ specforge review-planning --json                  # JSON output
+  $ specforge review-planning --fix                   # Show remediation suggestions
+
+Planning Gate Checks:
+  Goals             At least one goal defined
+  Requirements      At least one requirement defined
+  Architecture      Architecture section populated
+  Tech Stack        At least one technology listed
+  Epics             At least one epic exists
+  Tickets           At least one epic has tickets
+    `)
+        .option('--json', 'Output as JSON')
+        .option('--fix', 'Show auto-remediation suggestions')
+        .action(withErrorHandler(reviewPlanningCommand));
+}
+//# sourceMappingURL=review-planning.js.map

package/dist/cli/commands/review-planning.js.map

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

package/dist/cli/commands/score/display.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Score Display Utilities
+ *
+ * Formats and displays readiness scores in the terminal
+ * with colored output based on readiness level.
+ */
+import type { ScoreResult, ReadinessReportResponse } from './types.js';
+/**
+ * Format a readiness score with color based on level
+ */
+export declare function formatScore(score: number | null, level: string | null): string;
+/**
+ * Format a single entity's score for display
+ */
+export declare function formatScoreResult(result: ScoreResult): string;
+/**
+ * Format the full readiness report for display
+ */
+export declare function formatScoreReport(report: ReadinessReportResponse): string;
+//# sourceMappingURL=display.d.ts.map

package/dist/cli/commands/score/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/score/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAYvE;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAW7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAwCzE"}

package/dist/cli/commands/score/display.js

@@ -0,0 +1,111 @@
+/**
+ * Score Display Utilities
+ *
+ * Formats and displays readiness scores in the terminal
+ * with colored output based on readiness level.
+ */
+import chalk from 'chalk';
+/**
+ * Color mapping for readiness levels
+ */
+const LEVEL_COLORS = {
+    exemplary: chalk.green,
+    complete: chalk.blue,
+    partial: chalk.yellow,
+    minimal: chalk.red,
+};
+/**
+ * Format a readiness score with color based on level
+ */
+export function formatScore(score, level) {
+    if (score === null || level === null)
+        return chalk.gray('unscored');
+    const colorFn = LEVEL_COLORS[level] || chalk.white;
+    return colorFn(`${score}/100 (${level})`);
+}
+/**
+ * Format a single entity's score for display
+ */
+export function formatScoreResult(result) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold(`${capitalize(result.type)}: ${result.title}`));
+    lines.push(chalk.gray('─'.repeat(40)));
+    lines.push(`  ID:    ${chalk.dim(result.id)}`);
+    lines.push(`  Score: ${formatScore(result.readinessScore, result.readinessLevel)}`);
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format the full readiness report for display
+ */
+export function formatScoreReport(report) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold('Readiness Report'));
+    lines.push(chalk.gray('═'.repeat(50)));
+    // Format the report sections generically since the shape may vary
+    for (const [key, value] of Object.entries(report)) {
+        if (key === 'type' || key === 'scope' || key === 'scopeId' || key === 'format')
+            continue;
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            lines.push('');
+            lines.push(chalk.bold(`  ${formatKey(key)}`));
+            lines.push(chalk.gray('  ' + '─'.repeat(36)));
+            for (const [subKey, subValue] of Object.entries(value)) {
+                lines.push(`    ${formatKey(subKey)}: ${formatValue(subValue)}`);
+            }
+        }
+        else if (Array.isArray(value)) {
+            lines.push('');
+            lines.push(chalk.bold(`  ${formatKey(key)}`));
+            lines.push(chalk.gray('  ' + '─'.repeat(36)));
+            for (const item of value) {
+                if (typeof item === 'object' && item !== null) {
+                    const obj = item;
+                    const title = obj.title || obj.name || obj.id || '';
+                    const score = typeof obj.readinessScore === 'number' ? obj.readinessScore : null;
+                    const level = typeof obj.readinessLevel === 'string' ? obj.readinessLevel : null;
+                    lines.push(`    ${title}: ${formatScore(score, level)}`);
+                }
+                else {
+                    lines.push(`    ${chalk.dim('•')} ${String(item)}`);
+                }
+            }
+        }
+        else {
+            lines.push(`  ${formatKey(key)}: ${formatValue(value)}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format a camelCase or snake_case key for display
+ */
+function formatKey(key) {
+    return key
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/_/g, ' ')
+        .replace(/^\s/, '')
+        .replace(/\b\w/g, c => c.toUpperCase());
+}
+/**
+ * Format a value for display
+ */
+function formatValue(value) {
+    if (value === null || value === undefined)
+        return chalk.gray('N/A');
+    if (typeof value === 'number')
+        return chalk.cyan(String(value));
+    if (typeof value === 'boolean')
+        return value ? chalk.green('Yes') : chalk.red('No');
+    return String(value);
+}
+/**
+ * Capitalize first letter
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=display.js.map

package/dist/cli/commands/score/display.js.map

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

package/dist/cli/commands/score/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Score Command Module
+ *
+ * Exports all score-related functionality.
+ */
+export * from './types.js';
+export { formatScore, formatScoreResult, formatScoreReport } from './display.js';
+export { scoreCommand, registerScoreCommand } from './score.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/score/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/score/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjF,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli/commands/score/index.js

@@ -0,0 +1,12 @@
+/**
+ * Score Command Module
+ *
+ * Exports all score-related functionality.
+ */
+// Types
+export * from './types.js';
+// Display utilities
+export { formatScore, formatScoreResult, formatScoreReport } from './display.js';
+// Command registration
+export { scoreCommand, registerScoreCommand } from './score.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/score/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/score/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjF,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}