@specforge/mcp 2.6.0 → 3.0.1

package/README.md

@@ -251,6 +251,22 @@ The SpecForge MCP server provides the following tool categories:
 - `get_ticket_commits` - Get commits for a ticket
 - `get_ticket_prs` - Get PRs for a ticket
 
+### Blueprint Management
+- `blueprint` - Manage specification blueprints (diagrams, mockups, ADRs)
+  - Operations: `create`, `get`, `update`, `list`, `delete`, `link`, `unlink`, `get_for_ticket`
+  - Categories: flowchart, architecture, state, sequence, erd, mockup, adr, component, deployment, api
+  - See [Blueprint Documentation](/docs/mcp/tools/blueprint.md)
+
+### Project Sharing
+- `list_project_members` - List all members of a project
+- `invite_to_project` - Invite a user by email
+- `remove_project_member` - Remove a member from project
+- `update_member_role` - Change a member's role (owner, editor, viewer)
+- `list_invitations` - List pending invitations
+- `accept_project_invitation` - Accept an invitation
+- `decline_project_invitation` - Decline an invitation
+- See [Project Sharing Documentation](/docs/mcp/collaboration/)
+
 ## CLI Commands
 
 The SpecForge MCP package includes a CLI for project configuration and management.
@@ -278,6 +294,11 @@ The SpecForge MCP package includes a CLI for project configuration and managemen
 | `tools` | List available MCP tools |
 | `test` | Test API connection |
 | `whoami` | Show current user/config |
+| `autopilot run` | Start autonomous implementation |
+| `autopilot status` | Show autopilot session status |
+| `autopilot pause` | Pause active session |
+| `autopilot resume` | Resume paused session |
+| `autopilot abort` | Stop and cleanup session |
 
 ### Setup Commands
 
@@ -506,6 +527,58 @@ specforge whoami [--json]
 
 Show current user information and configuration settings.
 
+### Autopilot Commands
+
+Autopilot enables autonomous ticket implementation using Claude Code. See [full documentation](/docs/mcp/autopilot/).
+
+#### autopilot run
+
+```bash
+specforge autopilot run [options]
+```
+
+Start autonomous ticket implementation.
+
+| Option | Description |
+|--------|-------------|
+| `-s, --spec <id>` | Specification ID |
+| `-e, --epic <id>` | Only implement tickets from this epic |
+| `-p, --parallel <n>` | Number of parallel workers (1-10) |
+| `-c, --max-cost <usd>` | Maximum cost in USD |
+| `-n, --dry-run` | Show plan without executing |
+| `-w, --watch` | Watch mode with live dashboard |
+| `-r, --resume <id>` | Resume a previous run |
+
+Examples:
+```bash
+specforge autopilot run --dry-run      # Preview
+specforge autopilot run --parallel 2   # Run with 2 workers
+specforge autopilot run --max-cost 10  # Limit to $10
+specforge autopilot run --watch        # Live dashboard
+```
+
+#### autopilot status
+
+```bash
+specforge autopilot status [options]
+```
+
+Show current autopilot session status.
+
+| Option | Description |
+|--------|-------------|
+| `-w, --watch` | Live updates (2s refresh) |
+| `-v, --verbose` | Show detailed dashboard |
+| `--json` | Output as JSON |
+
+#### autopilot pause / resume / abort
+
+```bash
+specforge autopilot pause              # Pause gracefully
+specforge autopilot resume             # Resume latest session
+specforge autopilot abort --force      # Stop and cleanup
+```
+
 ### Configuration Files
 
 | File | Location | Purpose |

package/bin/{specforge-mcp → specforge}

@@ -10,11 +10,6 @@
  * When called with subcommands/flags: runs CLI
  */
 
-// Show deprecation warning when invoked as specforge-mcp
-if (process.argv[1]?.includes('specforge-mcp')) {
-  console.warn('\x1b[33m⚠ Warning: "specforge-mcp" is deprecated. Use "specforge" instead.\x1b[0m\n');
-}
-
 import('../dist/cli/index.js')
   .then(({ runCLI }) => runCLI())
   .catch((error) => {

package/dist/ai-provider/circuit-breaker.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Circuit Breaker Pattern
+ *
+ * Prevents cascading failures by opening the circuit after too many failures.
+ * States: closed (normal) -> open (failing) -> half-open (testing) -> closed
+ */
+import type { CircuitState, CircuitBreakerConfig } from './types.js';
+export declare class CircuitBreaker {
+    private config;
+    private state;
+    private failures;
+    private successes;
+    private lastFailureTime;
+    private halfOpenAttempts;
+    constructor(config: CircuitBreakerConfig);
+    /**
+     * Check if a request can proceed.
+     */
+    canRequest(): boolean;
+    /**
+     * Record a successful request.
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed request.
+     */
+    recordFailure(): void;
+    /**
+     * Get current circuit state.
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics.
+     */
+    getStats(): {
+        state: CircuitState;
+        failures: number;
+        successes: number;
+        lastFailureTime: number | null;
+        halfOpenAttempts: number;
+    };
+    /**
+     * Force reset the circuit breaker to closed state.
+     */
+    forceReset(): void;
+    /**
+     * Update state based on recovery time.
+     */
+    private updateState;
+    /**
+     * Transition to a new state with event emission.
+     */
+    private transitionTo;
+    /**
+     * Reset internal counters.
+     */
+    private reset;
+}
+/**
+ * Create a circuit breaker with default configuration.
+ */
+export declare function createCircuitBreaker(config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/ai-provider/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/ai-provider/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMrE,qBAAa,cAAc;IAOb,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,gBAAgB,CAAa;gBAEjB,MAAM,EAAE,oBAAoB;IAEhD;;OAEG;IACH,UAAU,IAAI,OAAO;IAarB;;OAEG;IACH,aAAa,IAAI,IAAI;IAkBrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAsBrB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAKxB;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,YAAY,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAUD;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;OAEG;IACH,OAAO,CAAC,KAAK;CAId;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,cAAc,CAMhB"}

package/dist/ai-provider/circuit-breaker.js

@@ -0,0 +1,160 @@
+/**
+ * Circuit Breaker Pattern
+ *
+ * Prevents cascading failures by opening the circuit after too many failures.
+ * States: closed (normal) -> open (failing) -> half-open (testing) -> closed
+ */
+import { aiProviderEvents } from './events.js';
+import { createLogger } from './logger.js';
+const logger = createLogger('CircuitBreaker');
+export class CircuitBreaker {
+    config;
+    state = 'closed';
+    failures = 0;
+    successes = 0;
+    lastFailureTime = 0;
+    halfOpenAttempts = 0;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Check if a request can proceed.
+     */
+    canRequest() {
+        this.updateState();
+        switch (this.state) {
+            case 'closed':
+                return true;
+            case 'open':
+                return false;
+            case 'half-open':
+                return this.halfOpenAttempts < this.config.halfOpenRequests;
+        }
+    }
+    /**
+     * Record a successful request.
+     */
+    recordSuccess() {
+        // Update state first (open -> half-open if recovery time elapsed)
+        this.updateState();
+        this.successes++;
+        if (this.state === 'half-open') {
+            this.halfOpenAttempts++;
+            if (this.halfOpenAttempts >= this.config.halfOpenRequests) {
+                // Recovery successful - close the circuit
+                this.transitionTo('closed');
+                this.reset();
+            }
+        }
+        else if (this.state === 'closed') {
+            // Reset failure count on success in closed state
+            this.failures = 0;
+        }
+    }
+    /**
+     * Record a failed request.
+     */
+    recordFailure() {
+        // Update state first (open -> half-open if recovery time elapsed)
+        this.updateState();
+        this.failures++;
+        this.lastFailureTime = Date.now();
+        if (this.state === 'half-open') {
+            // Failed during recovery - reopen the circuit
+            this.transitionTo('open');
+            this.halfOpenAttempts = 0;
+        }
+        else if (this.failures >= this.config.failureThreshold) {
+            // Too many failures - open the circuit
+            this.transitionTo('open');
+        }
+        logger.warn('Failure recorded', {
+            failures: this.failures,
+            threshold: this.config.failureThreshold,
+            state: this.state,
+        });
+    }
+    /**
+     * Get current circuit state.
+     */
+    getState() {
+        this.updateState();
+        return this.state;
+    }
+    /**
+     * Get circuit breaker statistics.
+     */
+    getStats() {
+        return {
+            state: this.getState(),
+            failures: this.failures,
+            successes: this.successes,
+            lastFailureTime: this.lastFailureTime || null,
+            halfOpenAttempts: this.halfOpenAttempts,
+        };
+    }
+    /**
+     * Force reset the circuit breaker to closed state.
+     */
+    forceReset() {
+        this.reset();
+        this.transitionTo('closed');
+        logger.info('Circuit breaker force reset');
+    }
+    /**
+     * Update state based on recovery time.
+     */
+    updateState() {
+        if (this.state === 'open') {
+            const elapsed = Date.now() - this.lastFailureTime;
+            if (elapsed >= this.config.recoveryTimeMs) {
+                this.transitionTo('half-open');
+                this.halfOpenAttempts = 0;
+            }
+        }
+    }
+    /**
+     * Transition to a new state with event emission.
+     */
+    transitionTo(newState) {
+        const previousState = this.state;
+        if (previousState === newState) {
+            return;
+        }
+        this.state = newState;
+        logger.info('Circuit breaker state change', {
+            previousState,
+            newState,
+        });
+        const payload = { previousState, newState };
+        switch (newState) {
+            case 'open':
+                aiProviderEvents.emit('circuit_breaker:opened', payload);
+                break;
+            case 'half-open':
+                aiProviderEvents.emit('circuit_breaker:half_open', payload);
+                break;
+            case 'closed':
+                aiProviderEvents.emit('circuit_breaker:closed', payload);
+                break;
+        }
+    }
+    /**
+     * Reset internal counters.
+     */
+    reset() {
+        this.failures = 0;
+        this.halfOpenAttempts = 0;
+    }
+}
+/**
+ * Create a circuit breaker with default configuration.
+ */
+export function createCircuitBreaker(config) {
+    return new CircuitBreaker({
+        failureThreshold: config?.failureThreshold ?? 5,
+        recoveryTimeMs: config?.recoveryTimeMs ?? 30000,
+        halfOpenRequests: config?.halfOpenRequests ?? 2,
+    });
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/ai-provider/circuit-breaker.js.map

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

package/dist/ai-provider/cli-version.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CLI Version Detection
+ *
+ * Detects Claude CLI version and feature support.
+ */
+import type { CLIVersionInfo } from './types.js';
+export declare class CLIVersionDetector {
+    private cachedVersion?;
+    /**
+     * Detect CLI version and capabilities.
+     */
+    detect(): Promise<CLIVersionInfo>;
+    /**
+     * Check if CLI is installed.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Get cached version info (throws if not detected yet).
+     */
+    getCachedVersion(): CLIVersionInfo | undefined;
+    /**
+     * Clear cached version.
+     */
+    clearCache(): void;
+    /**
+     * Build appropriate arguments based on version capabilities.
+     */
+    buildArgs(options: {
+        prompt: string;
+        outputFormat?: string;
+    }): string[];
+    /**
+     * Compare two semver versions.
+     * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+     */
+    private compareVersions;
+}
+/**
+ * Get or create the CLI version detector.
+ */
+export declare function getCLIVersionDetector(): CLIVersionDetector;
+/**
+ * Detect CLI version (convenience function).
+ */
+export declare function detectCLIVersion(): Promise<CLIVersionInfo>;
+/**
+ * Check if CLI is installed (convenience function).
+ */
+export declare function isCLIInstalled(): Promise<boolean>;
+//# sourceMappingURL=cli-version.d.ts.map

package/dist/ai-provider/cli-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version.d.ts","sourceRoot":"","sources":["../../src/ai-provider/cli-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBjD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAiB;IAEvC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAqCvC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;OAEG;IACH,gBAAgB,IAAI,cAAc,GAAG,SAAS;IAI9C;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAoBvE;;;OAGG;IACH,OAAO,CAAC,eAAe;CAcxB;AAOD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,cAAc,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvD"}

package/dist/ai-provider/cli-version.js

@@ -0,0 +1,141 @@
+/**
+ * CLI Version Detection
+ *
+ * Detects Claude CLI version and feature support.
+ */
+import { execSync } from 'child_process';
+import { CLINotFoundError } from './errors.js';
+import { createLogger } from './logger.js';
+const logger = createLogger('CLIVersionDetector');
+/**
+ * Minimum required version for various features.
+ */
+const FEATURE_REQUIREMENTS = {
+    outputFormat: '1.0.0',
+    printMode: '1.0.0',
+    workingDirectory: '1.0.0',
+    streamJson: '1.0.0',
+    modelSelection: '1.0.0',
+};
+export class CLIVersionDetector {
+    cachedVersion;
+    /**
+     * Detect CLI version and capabilities.
+     */
+    async detect() {
+        if (this.cachedVersion) {
+            return this.cachedVersion;
+        }
+        try {
+            const output = execSync('claude --version', {
+                encoding: 'utf-8',
+                timeout: 10000,
+            });
+            const match = output.match(/v?(\d+\.\d+\.\d+)/);
+            if (!match) {
+                logger.warn('Could not parse version from output', { output });
+                throw new Error('Could not parse version');
+            }
+            const version = match[1];
+            this.cachedVersion = {
+                version,
+                supportsOutputFormat: this.compareVersions(version, FEATURE_REQUIREMENTS.outputFormat) >= 0,
+                supportsPrintMode: this.compareVersions(version, FEATURE_REQUIREMENTS.printMode) >= 0,
+                supportsWorkingDirectory: this.compareVersions(version, FEATURE_REQUIREMENTS.workingDirectory) >= 0,
+            };
+            logger.info('CLI version detected', { ...this.cachedVersion });
+            return this.cachedVersion;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new CLINotFoundError();
+            }
+            throw new CLINotFoundError();
+        }
+    }
+    /**
+     * Check if CLI is installed.
+     */
+    async isInstalled() {
+        try {
+            await this.detect();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get cached version info (throws if not detected yet).
+     */
+    getCachedVersion() {
+        return this.cachedVersion;
+    }
+    /**
+     * Clear cached version.
+     */
+    clearCache() {
+        this.cachedVersion = undefined;
+    }
+    /**
+     * Build appropriate arguments based on version capabilities.
+     */
+    buildArgs(options) {
+        const version = this.cachedVersion;
+        const args = [];
+        // Print mode for non-interactive execution
+        if (version?.supportsPrintMode) {
+            args.push('--print');
+        }
+        // Output format
+        if (version?.supportsOutputFormat && options.outputFormat) {
+            args.push('--output-format', options.outputFormat);
+        }
+        // The prompt (positional argument, not --prompt flag)
+        args.push(options.prompt);
+        return args;
+    }
+    /**
+     * Compare two semver versions.
+     * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+     */
+    compareVersions(a, b) {
+        const partsA = a.split('.').map(Number);
+        const partsB = b.split('.').map(Number);
+        for (let i = 0; i < 3; i++) {
+            const numA = partsA[i] || 0;
+            const numB = partsB[i] || 0;
+            if (numA < numB)
+                return -1;
+            if (numA > numB)
+                return 1;
+        }
+        return 0;
+    }
+}
+/**
+ * Singleton instance for convenience.
+ */
+let detector = null;
+/**
+ * Get or create the CLI version detector.
+ */
+export function getCLIVersionDetector() {
+    if (!detector) {
+        detector = new CLIVersionDetector();
+    }
+    return detector;
+}
+/**
+ * Detect CLI version (convenience function).
+ */
+export async function detectCLIVersion() {
+    return getCLIVersionDetector().detect();
+}
+/**
+ * Check if CLI is installed (convenience function).
+ */
+export async function isCLIInstalled() {
+    return getCLIVersionDetector().isInstalled();
+}
+//# sourceMappingURL=cli-version.js.map

package/dist/ai-provider/cli-version.js.map

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

package/dist/ai-provider/config-loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * AI Provider Configuration Loader
+ *
+ * Loads configuration from local sources with caching.
+ */
+import type { AIProviderConfig } from './types.js';
+export declare class ConfigLoader {
+    private cache;
+    private cacheTimestamp;
+    private userId;
+    constructor(userId: string);
+    /**
+     * Get configuration with caching.
+     */
+    getConfig(): Promise<AIProviderConfig>;
+    /**
+     * Update configuration.
+     */
+    updateConfig(updates: Partial<AIProviderConfig>): Promise<AIProviderConfig>;
+    /**
+     * Get default configuration.
+     */
+    getDefaults(): AIProviderConfig;
+    /**
+     * Invalidate cache.
+     */
+    invalidateCache(): void;
+    /**
+     * Set cache directly (useful for testing or initialization).
+     */
+    setCache(config: AIProviderConfig): void;
+    /**
+     * Get user ID.
+     */
+    getUserId(): string;
+}
+/**
+ * Get or create a config loader for a user.
+ */
+export declare function getConfigLoader(userId: string): ConfigLoader;
+/**
+ * Create a new config loader.
+ */
+export declare function createConfigLoader(userId: string): ConfigLoader;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/ai-provider/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/ai-provider/config-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoBnD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAe5C;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAcjF;;OAEG;IACH,WAAW,IAAI,gBAAgB;IAI/B;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAKxC;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB;AAOD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAO5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE/D"}