@specforge/mcp 3.0.7 → 3.1.1

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

@@ -0,0 +1,17 @@
+/**
+ * Score Command Implementation
+ *
+ * Main entry point for the score command that fetches and displays
+ * readiness scores for specifications, epics, and tickets.
+ */
+import { Command } from 'commander';
+import { ScoreDisplayOptions } from './types.js';
+/**
+ * Main score command handler
+ */
+export declare function scoreCommand(entityType: string | undefined, entityId: string | undefined, options: ScoreDisplayOptions): Promise<void>;
+/**
+ * Register score command with Commander
+ */
+export declare function registerScoreCommand(program: Command): void;
+//# sourceMappingURL=score.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/score/score.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,EACL,mBAAmB,EASpB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgHf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0B3D"}

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

@@ -0,0 +1,144 @@
+/**
+ * Score Command Implementation
+ *
+ * Main entry point for the score command that fetches and displays
+ * readiness scores for specifications, epics, and tickets.
+ */
+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';
+import { isValidEntityType, getOperationForType, getParamNameForType, getFullTypeName, VALID_ENTITY_TYPES, } from './types.js';
+import { formatScoreResult, formatScoreReport } from './display.js';
+/**
+ * Main score command handler
+ */
+export async function scoreCommand(entityType, entityId, options) {
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        throw new CliError('Not authenticated', 1, 'Run `specforge login` to authenticate first');
+    }
+    // If no entity type specified, default to active specification
+    if (!entityType) {
+        if (!config.specificationId) {
+            console.error(chalk.red('\nError: No entity specified and no active specification.'));
+            console.error('Usage: specforge score [spec|epic|ticket] [id]');
+            console.error(chalk.dim("Run 'specforge init' or 'specforge switch' to set an active specification."));
+            process.exit(1);
+        }
+        entityType = 'spec';
+        entityId = config.specificationId;
+    }
+    if (!isValidEntityType(entityType)) {
+        console.error(chalk.red(`\nError: Unknown entity type "${entityType}"`));
+        console.error(`Valid types: ${VALID_ENTITY_TYPES.join(', ')}`);
+        process.exit(1);
+    }
+    if (!entityId) {
+        console.error(chalk.red(`\nError: Entity ID is required.`));
+        console.error(`Usage: specforge score ${entityType} <id>`);
+        process.exit(1);
+    }
+    const spinner = options.json ? null : ora('Fetching readiness score...').start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: config.apiUrl,
+            debug: config.debug,
+        });
+        // Fetch the entity
+        const operation = getOperationForType(entityType);
+        const paramName = getParamNameForType(entityType);
+        const entity = await client.call(operation, {
+            [paramName]: entityId,
+        });
+        const result = {
+            id: entity.id,
+            title: entity.title,
+            type: getFullTypeName(entityType),
+            readinessScore: typeof entity.readinessScore === 'number' ? entity.readinessScore : null,
+            readinessLevel: typeof entity.readinessLevel === 'string' ? entity.readinessLevel : null,
+        };
+        spinner?.stop();
+        // Output based on format
+        if (options.json && !options.report) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (!options.report) {
+            console.log(formatScoreResult(result));
+        }
+        // Fetch and display full report if requested
+        if (options.report) {
+            const reportSpinner = options.json ? null : ora('Fetching readiness report...').start();
+            try {
+                const report = await client.call('get_report', {
+                    type: 'readiness',
+                    scope: getFullTypeName(entityType),
+                    scopeId: entityId,
+                    format: 'json',
+                });
+                reportSpinner?.stop();
+                if (options.json) {
+                    console.log(JSON.stringify({ score: result, report }, null, 2));
+                }
+                else {
+                    console.log(formatScoreResult(result));
+                    console.log(formatScoreReport(report));
+                }
+            }
+            catch (reportError) {
+                reportSpinner?.fail('Failed to fetch readiness report');
+                // Still show the score even if report fails
+                if (!options.json) {
+                    console.log(formatScoreResult(result));
+                }
+                const msg = reportError instanceof Error ? reportError.message : 'Unknown error';
+                console.error(chalk.dim(`\nReport unavailable: ${msg}`));
+            }
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to fetch score');
+        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 entity ID'));
+            console.error(chalk.dim('  - Network connectivity issues'));
+            console.error(chalk.dim('  - Authentication expired (try: specforge login)'));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Register score command with Commander
+ */
+export function registerScoreCommand(program) {
+    program
+        .command('score [type] [id]')
+        .description('Display readiness score for a specification, epic, or ticket')
+        .addHelpText('after', `
+Arguments:
+  type             Entity type: spec, epic, or ticket (default: spec)
+  id               Entity ID (defaults to active specification)
+
+Examples:
+  $ specforge score                         # Score for active specification
+  $ specforge score spec spec_abc123        # Score for specific specification
+  $ specforge score epic epic_def456        # Score for specific epic
+  $ specforge score ticket ticket_ghi789    # Score for specific ticket
+  $ specforge score --report                # Full readiness report
+  $ specforge score --json                  # JSON output
+
+Score Levels:
+  exemplary   90-100  Outstanding readiness
+  complete    70-89   Good readiness
+  partial     40-69   Needs improvement
+  minimal     0-39    Significant gaps
+    `)
+        .option('--report', 'Show full readiness report')
+        .option('--json', 'Output as JSON')
+        .action(withErrorHandler(scoreCommand));
+}
+//# sourceMappingURL=score.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * Score Command Types
+ *
+ * Type definitions for the score command which displays
+ * readiness scores for specifications, epics, and tickets.
+ */
+/**
+ * Score command options from Commander
+ */
+export interface ScoreDisplayOptions {
+    /** Entity type to fetch (spec, epic, ticket) */
+    entityType?: string;
+    /** Entity ID */
+    entityId?: string;
+    /** Generate full readiness report */
+    report?: boolean;
+    /** Output as JSON */
+    json?: boolean;
+}
+/**
+ * Score result for a single entity
+ */
+export interface ScoreResult {
+    /** Entity ID */
+    id: string;
+    /** Entity title */
+    title: string;
+    /** Entity type */
+    type: 'specification' | 'epic' | 'ticket';
+    /** Readiness score (0-100 or null if unscored) */
+    readinessScore: number | null;
+    /** Readiness level (exemplary, complete, partial, minimal) */
+    readinessLevel: string | null;
+}
+/**
+ * API response with readiness fields
+ */
+export interface EntityWithReadiness {
+    id: string;
+    title: string;
+    readinessScore?: number | null;
+    readinessLevel?: string | null;
+    [key: string]: unknown;
+}
+/**
+ * Readiness report from get_report API
+ */
+export interface ReadinessReportResponse {
+    [key: string]: unknown;
+}
+/**
+ * Valid entity types for the score command
+ */
+export type ScoreEntityType = 'spec' | 'epic' | 'ticket';
+/**
+ * Valid readiness levels
+ */
+export declare const READINESS_LEVELS: readonly ["exemplary", "complete", "partial", "minimal"];
+/**
+ * Valid entity types
+ */
+export declare const VALID_ENTITY_TYPES: ScoreEntityType[];
+/**
+ * Check if a string is a valid entity type
+ */
+export declare function isValidEntityType(type: string): type is ScoreEntityType;
+/**
+ * Map short entity type to API operation name
+ */
+export declare function getOperationForType(type: ScoreEntityType): string;
+/**
+ * Map short entity type to API parameter name
+ */
+export declare function getParamNameForType(type: ScoreEntityType): string;
+/**
+ * Map short entity type to full type name
+ */
+export declare function getFullTypeName(type: ScoreEntityType): 'specification' | 'epic' | 'ticket';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/score/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,kDAAkD;IAClD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB,0DAA2D,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAA+B,CAAC;AAEhF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAEvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,MAAM,GAAG,QAAQ,CAM1F"}

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

@@ -0,0 +1,51 @@
+/**
+ * Score Command Types
+ *
+ * Type definitions for the score command which displays
+ * readiness scores for specifications, epics, and tickets.
+ */
+/**
+ * Valid readiness levels
+ */
+export const READINESS_LEVELS = ['exemplary', 'complete', 'partial', 'minimal'];
+/**
+ * Valid entity types
+ */
+export const VALID_ENTITY_TYPES = ['spec', 'epic', 'ticket'];
+/**
+ * Check if a string is a valid entity type
+ */
+export function isValidEntityType(type) {
+    return VALID_ENTITY_TYPES.includes(type);
+}
+/**
+ * Map short entity type to API operation name
+ */
+export function getOperationForType(type) {
+    switch (type) {
+        case 'spec': return 'get_specification';
+        case 'epic': return 'get_epic';
+        case 'ticket': return 'get_ticket';
+    }
+}
+/**
+ * Map short entity type to API parameter name
+ */
+export function getParamNameForType(type) {
+    switch (type) {
+        case 'spec': return 'specificationId';
+        case 'epic': return 'epicId';
+        case 'ticket': return 'ticketId';
+    }
+}
+/**
+ * Map short entity type to full type name
+ */
+export function getFullTypeName(type) {
+    switch (type) {
+        case 'spec': return 'specification';
+        case 'epic': return 'epic';
+        case 'ticket': return 'ticket';
+    }
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/commands/score/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAEzF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAuB,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,mBAAmB,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,OAAO,UAAU,CAAC;QAC/B,KAAK,QAAQ,CAAC,CAAC,OAAO,YAAY,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,iBAAiB,CAAC;QACtC,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC;QAC7B,KAAK,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAqB;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,eAAe,CAAC;QACpC,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC;QAC3B,KAAK,QAAQ,CAAC,CAAC,OAAO,QAAQ,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/cli/commands/spec-activate.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Spec Activate Command
+ *
+ * Sets or clears the active specification in .specforge.json.
+ * The active specification tells Agent Teams which spec to implement.
+ */
+import { Command } from 'commander';
+/**
+ * Activate a specification as the active spec for Agent Teams
+ *
+ * @param specId Specification ID to activate
+ * @param options Command options
+ */
+export declare function specActivateAction(specId: string, options: {
+    json?: boolean;
+}): Promise<void>;
+/**
+ * Deactivate the current active specification
+ *
+ * @param options Command options
+ */
+export declare function specDeactivateAction(options: {
+    json?: boolean;
+}): Promise<void>;
+/**
+ * Register spec activate/deactivate commands with Commander
+ */
+export declare function registerSpecActivateCommand(program: Command): void;
+//# sourceMappingURL=spec-activate.d.ts.map

package/dist/cli/commands/spec-activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-activate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/spec-activate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CA2Gf;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuClE"}

package/dist/cli/commands/spec-activate.js

@@ -0,0 +1,155 @@
+/**
+ * Spec Activate Command
+ *
+ * Sets or clears the active specification in .specforge.json.
+ * The active specification tells Agent Teams which spec to implement.
+ */
+import ora from 'ora';
+import { resolveConfig } from '../config/index.js';
+import { setActiveSpecification } from '../config/writer.js';
+import { withErrorHandler, CliError, NetworkError, ValidationError } from '../middleware/error-handler.js';
+import { printBlank, printSuccess, printJson } from '../ui/output.js';
+import { colors } from '../ui/colors.js';
+import { ApiClient } from '../../client/api-client.js';
+/**
+ * Activate a specification as the active spec for Agent Teams
+ *
+ * @param specId Specification ID to activate
+ * @param options Command options
+ */
+export async function specActivateAction(specId, options) {
+    if (!specId || specId.trim() === '') {
+        throw new ValidationError('Specification ID is required', 'Usage: specforge spec activate <specId>');
+    }
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        throw new CliError('Not authenticated', 1, 'Run `specforge login` to authenticate first');
+    }
+    const spinner = ora({
+        text: 'Validating specification...',
+        color: 'cyan',
+    }).start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: config.apiUrl,
+            debug: config.debug,
+        });
+        // Validate the specification exists
+        const spec = await client.call('get_specification', {
+            specificationId: specId,
+            summary: true,
+        });
+        if (!spec || !spec.id) {
+            spinner.fail('Specification not found');
+            throw new CliError(`Specification not found: ${specId}`, 1, "Run 'specforge specs' to list available specifications.");
+        }
+        // Set active specification in .specforge.json
+        spinner.text = 'Setting active specification...';
+        setActiveSpecification({
+            id: spec.id,
+            title: spec.title,
+            activatedAt: new Date().toISOString(),
+        });
+        spinner.succeed(`Active specification set to: ${colors.primary(spec.title)}`);
+        if (options.json) {
+            printJson({
+                action: 'activate',
+                specification: {
+                    id: spec.id,
+                    title: spec.title,
+                    status: spec.status,
+                    epicCount: spec.epicCount,
+                    ticketCount: spec.ticketCount,
+                    completedTicketCount: spec.completedTicketCount,
+                },
+            });
+        }
+        else {
+            printBlank();
+            console.log(colors.muted(`  ID:      ${spec.id}`));
+            console.log(colors.muted(`  Status:  ${spec.status}`));
+            if (spec.ticketCount !== undefined) {
+                const completed = spec.completedTicketCount ?? 0;
+                console.log(colors.muted(`  Tickets: ${completed}/${spec.ticketCount} completed`));
+            }
+            printBlank();
+            console.log(colors.muted("Run 'specforge status' to see the current context."));
+            printBlank();
+        }
+    }
+    catch (error) {
+        if (error instanceof CliError || error instanceof ValidationError) {
+            spinner.stop();
+            throw error;
+        }
+        spinner.fail('Failed to activate specification');
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        if (message.includes('401') || message.includes('Unauthorized')) {
+            throw new CliError('Authentication failed', 1, 'Your API key may be invalid. Run `specforge login` to re-authenticate');
+        }
+        if (message.includes('404') || message.includes('Not Found') || message.includes('not found')) {
+            throw new CliError(`Specification not found: ${specId}`, 1, "Run 'specforge specs' to list available specifications.");
+        }
+        throw new NetworkError(`Failed to activate specification: ${message}`);
+    }
+}
+/**
+ * Deactivate the current active specification
+ *
+ * @param options Command options
+ */
+export async function specDeactivateAction(options) {
+    setActiveSpecification(null);
+    if (options.json) {
+        printJson({ action: 'deactivate', specification: null });
+    }
+    else {
+        printSuccess('Active specification cleared');
+        printBlank();
+        console.log(colors.muted("No specification is active. Run 'specforge spec activate <specId>' to set one."));
+        printBlank();
+    }
+}
+/**
+ * Register spec activate/deactivate commands with Commander
+ */
+export function registerSpecActivateCommand(program) {
+    const spec = program
+        .command('spec')
+        .description('Manage active specification for Agent Teams');
+    spec
+        .command('activate <specId>')
+        .description('Set active specification for Agent Teams implementation')
+        .option('--json', 'Output in JSON format')
+        .addHelpText('after', `
+Arguments:
+  specId    Specification ID to activate
+
+Examples:
+  $ specforge spec activate ff1f8edb-4976-458b-acb0-b0860cd9a60d
+  $ specforge spec activate ff1f8edb --json
+
+The active specification is stored in .specforge.json and tells Agent Teams
+which specification to implement when you say "implement the active spec".
+
+Use 'specforge specs' to list available specifications.
+Use 'specforge spec deactivate' to clear the active specification.
+`)
+        .action(withErrorHandler(specActivateAction));
+    spec
+        .command('deactivate')
+        .description('Clear the active specification')
+        .option('--json', 'Output in JSON format')
+        .addHelpText('after', `
+Examples:
+  $ specforge spec deactivate
+  $ specforge spec deactivate --json
+
+Removes the activeSpecification section from .specforge.json.
+`)
+        .action(withErrorHandler(async (options) => {
+        await specDeactivateAction(options);
+    }));
+}
+//# sourceMappingURL=spec-activate.js.map

package/dist/cli/commands/spec-activate.js.map

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

package/dist/cli/commands/spec-activate.types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Spec Activate Command Types
+ *
+ * Type definitions for the spec activate/deactivate commands
+ * that manage the active specification in .specforge.json.
+ */
+/**
+ * Specification summary from get_specification API (summary mode)
+ */
+export interface SpecificationSummary {
+    /** Specification ID */
+    id: string;
+    /** Specification title */
+    title: string;
+    /** Current status */
+    status: string;
+    /** Number of epics */
+    epicCount?: number;
+    /** Total number of tickets */
+    ticketCount?: number;
+    /** Number of completed tickets */
+    completedTicketCount?: number;
+}
+//# sourceMappingURL=spec-activate.types.d.ts.map

package/dist/cli/commands/spec-activate.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-activate.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/spec-activate.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/cli/commands/spec-activate.types.js

@@ -0,0 +1,8 @@
+/**
+ * Spec Activate Command Types
+ *
+ * Type definitions for the spec activate/deactivate commands
+ * that manage the active specification in .specforge.json.
+ */
+export {};
+//# sourceMappingURL=spec-activate.types.js.map

package/dist/cli/commands/spec-activate.types.js.map

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

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

@@ -1 +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"}
+{"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;AAQpC,OAAO,EACL,aAAa,EAad,MAAM,mBAAmB,CAAC;AAmO3B;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsIxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C5D"}