@specforge/mcp 2.5.1 → 3.0.0

package/README.md

@@ -42,7 +42,7 @@ Add to `~/.config/claude/claude_desktop_config.json` (Linux/macOS) or `%APPDATA%
 {
   "mcpServers": {
     "specforge": {
-      "command": "specforge-mcp",
+      "command": "specforge",
       "env": {
         "SPECFORGE_API_KEY": "sf_live_your_api_key_here",
         "SPECFORGE_API_URL": "https://your-api-gateway-url.amazonaws.com/prod"
@@ -60,7 +60,7 @@ Add to `~/.claude/settings.json`:
 {
   "mcpServers": {
     "specforge": {
-      "command": "specforge-mcp",
+      "command": "specforge",
       "env": {
         "SPECFORGE_API_KEY": "sf_live_your_api_key_here",
         "SPECFORGE_API_URL": "https://your-api-gateway-url.amazonaws.com/prod"
@@ -75,7 +75,7 @@ Or set environment variables in your shell and run:
 ```bash
 export SPECFORGE_API_KEY="sf_live_your_api_key_here"
 export SPECFORGE_API_URL="https://your-api-gateway-url.amazonaws.com/prod"
-specforge-mcp
+specforge
 ```
 
 ### Cursor
@@ -107,7 +107,7 @@ Add to your VS Code `settings.json`:
     "mcp": {
       "servers": {
         "specforge": {
-          "command": "specforge-mcp",
+          "command": "specforge",
           "env": {
             "SPECFORGE_API_KEY": "sf_live_your_api_key_here",
             "SPECFORGE_API_URL": "https://your-api-gateway-url.amazonaws.com/prod"
@@ -127,7 +127,7 @@ Create a config file at `~/.config/gh-copilot/mcp.json`:
 {
   "servers": {
     "specforge": {
-      "command": "specforge-mcp",
+      "command": "specforge",
       "env": {
         "SPECFORGE_API_KEY": "sf_live_your_api_key_here",
         "SPECFORGE_API_URL": "https://your-api-gateway-url.amazonaws.com/prod"
@@ -146,7 +146,7 @@ export SPECFORGE_API_KEY="sf_live_your_api_key_here"
 export SPECFORGE_API_URL="https://your-api-gateway-url.amazonaws.com/prod"
 
 # Then configure your Codex CLI to use the MCP server
-codex --mcp-server specforge-mcp
+codex --mcp-server specforge
 ```
 
 ### ChatGPT Desktop
@@ -157,7 +157,7 @@ Add to ChatGPT Desktop's MCP configuration:
 {
   "mcpServers": {
     "specforge": {
-      "command": "specforge-mcp",
+      "command": "specforge",
       "env": {
         "SPECFORGE_API_KEY": "sf_live_your_api_key_here",
         "SPECFORGE_API_URL": "https://your-api-gateway-url.amazonaws.com/prod"
@@ -176,7 +176,7 @@ Add to Windsurf's settings:
   "mcp": {
     "servers": {
       "specforge": {
-        "command": "specforge-mcp",
+        "command": "specforge",
         "env": {
           "SPECFORGE_API_KEY": "sf_live_your_api_key_here",
           "SPECFORGE_API_URL": "https://your-api-gateway-url.amazonaws.com/prod"
@@ -193,7 +193,7 @@ For any MCP-compatible client, the server uses stdio transport:
 
 ```bash
 # Start the server with environment variables
-SPECFORGE_API_KEY="sf_live_xxx" SPECFORGE_API_URL="https://xxx" specforge-mcp
+SPECFORGE_API_KEY="sf_live_xxx" SPECFORGE_API_URL="https://xxx" specforge
 ```
 
 The server communicates via JSON-RPC over stdin/stdout.
@@ -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,13 +294,18 @@ 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
 
 #### login
 
 ```bash
-specforge-mcp login [--api-key <key>] [--force]
+specforge login [--api-key <key>] [--force]
 ```
 
 Authenticate with the SpecForge API.
@@ -296,15 +317,15 @@ Authenticate with the SpecForge API.
 
 Examples:
 ```bash
-specforge-mcp login                    # Interactive login
-specforge-mcp login --api-key sf_live_xxx  # Non-interactive
-specforge-mcp login --force            # Re-authenticate
+specforge login                    # Interactive login
+specforge login --api-key sf_live_xxx  # Non-interactive
+specforge login --force            # Re-authenticate
 ```
 
 #### init
 
 ```bash
-specforge-mcp init [--project <id>] [--spec <id>] [--format <format>] [--force]
+specforge init [--project <id>] [--spec <id>] [--format <format>] [--force]
 ```
 
 Initialize SpecForge in the current directory.
@@ -322,15 +343,15 @@ Creates:
 
 Examples:
 ```bash
-specforge-mcp init                          # Interactive setup
-specforge-mcp init --project proj_abc       # Set project
-specforge-mcp init --project proj_abc --spec spec_xyz --format toon
+specforge init                          # Interactive setup
+specforge init --project proj_abc       # Set project
+specforge init --project proj_abc --spec spec_xyz --format toon
 ```
 
 #### configure
 
 ```bash
-specforge-mcp configure [--format <format>] [--project <id>]
+specforge configure [--format <format>] [--project <id>]
 ```
 
 Configure default preferences.
@@ -338,7 +359,7 @@ Configure default preferences.
 #### doctor
 
 ```bash
-specforge-mcp doctor [--json]
+specforge doctor [--json]
 ```
 
 Diagnose configuration and connection issues.
@@ -358,7 +379,7 @@ Check categories:
 #### switch
 
 ```bash
-specforge-mcp switch [--project <id>] [--spec <id>]
+specforge switch [--project <id>] [--spec <id>]
 ```
 
 Switch between projects or specifications.
@@ -366,7 +387,7 @@ Switch between projects or specifications.
 #### projects
 
 ```bash
-specforge-mcp projects [--json] [--toon]
+specforge projects [--json] [--toon]
 ```
 
 List all accessible projects.
@@ -374,7 +395,7 @@ List all accessible projects.
 #### specs
 
 ```bash
-specforge-mcp specs [--project <id>] [--status <status>] [--json]
+specforge specs [--project <id>] [--status <status>] [--json]
 ```
 
 List specifications for the current or specified project.
@@ -384,7 +405,7 @@ List specifications for the current or specified project.
 #### status
 
 ```bash
-specforge-mcp status [--spec <id>] [--json]
+specforge status [--spec <id>] [--json]
 ```
 
 Show current specification status with progress metrics.
@@ -392,7 +413,7 @@ Show current specification status with progress metrics.
 #### tickets
 
 ```bash
-specforge-mcp tickets [--epic <id>] [--status <status>] [--limit <n>] [--json]
+specforge tickets [--epic <id>] [--status <status>] [--limit <n>] [--json]
 ```
 
 List tickets for the current specification.
@@ -400,7 +421,7 @@ List tickets for the current specification.
 #### ticket
 
 ```bash
-specforge-mcp ticket <id> [--json] [--context]
+specforge ticket <id> [--json] [--context]
 ```
 
 Show full details for a specific ticket.
@@ -413,7 +434,7 @@ Show full details for a specific ticket.
 #### next
 
 ```bash
-specforge-mcp next [--spec <id>] [--count <n>] [--json]
+specforge next [--spec <id>] [--count <n>] [--json]
 ```
 
 Get the next actionable tickets (dependencies satisfied).
@@ -421,7 +442,7 @@ Get the next actionable tickets (dependencies satisfied).
 #### blocked
 
 ```bash
-specforge-mcp blocked [--spec <id>] [--json]
+specforge blocked [--spec <id>] [--json]
 ```
 
 List blocked tickets with blocking reasons.
@@ -431,7 +452,7 @@ List blocked tickets with blocking reasons.
 #### session
 
 ```bash
-specforge-mcp session [--json]
+specforge session [--json]
 ```
 
 Show current implementation session status.
@@ -439,7 +460,7 @@ Show current implementation session status.
 #### session start
 
 ```bash
-specforge-mcp session start [specId] [--mode <mode>] [--max-tickets <n>] [--stop-on-failure] [--force]
+specforge session start [specId] [--mode <mode>] [--max-tickets <n>] [--stop-on-failure] [--force]
 ```
 
 Start a new implementation session.
@@ -455,7 +476,7 @@ Start a new implementation session.
 #### session end
 
 ```bash
-specforge-mcp session end [--status <status>] [--summary <text>]
+specforge session end [--status <status>] [--summary <text>]
 ```
 
 End the current implementation session.
@@ -470,22 +491,22 @@ End the current implementation session.
 #### call
 
 ```bash
-specforge-mcp call <tool> [--args <json>] [--format <format>] [--raw]
+specforge call <tool> [--args <json>] [--format <format>] [--raw]
 ```
 
 Directly call an MCP tool with JSON arguments.
 
 Examples:
 ```bash
-specforge-mcp call list_projects
-specforge-mcp call get_ticket --args='{"ticketId":"abc123"}'
-specforge-mcp call list_tickets --format toon
+specforge call list_projects
+specforge call get_ticket --args='{"ticketId":"abc123"}'
+specforge call list_tickets --format toon
 ```
 
 #### tools
 
 ```bash
-specforge-mcp tools [--category <category>] [--search <query>] [--json]
+specforge tools [--category <category>] [--search <query>] [--json]
 ```
 
 List available MCP tools with optional filtering.
@@ -493,7 +514,7 @@ List available MCP tools with optional filtering.
 #### test
 
 ```bash
-specforge-mcp test
+specforge test
 ```
 
 Test API connection and authentication. Shows response time and user info.
@@ -501,11 +522,63 @@ Test API connection and authentication. Shows response time and user info.
 #### whoami
 
 ```bash
-specforge-mcp whoami [--json]
+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 |
@@ -548,19 +621,19 @@ Non-interactive usage for scripts:
 ```bash
 # Authenticate via environment or flag
 export SPECFORGE_API_KEY="sf_live_xxx"
-specforge-mcp login --api-key $SPECFORGE_API_KEY
+specforge login --api-key $SPECFORGE_API_KEY
 
 # Initialize non-interactively
-specforge-mcp init --project $PROJECT_ID --spec $SPEC_ID --format json --force
+specforge init --project $PROJECT_ID --spec $SPEC_ID --format json --force
 
 # Check health (exits 1 on failure)
-specforge-mcp doctor --json
+specforge doctor --json
 
 # Get tickets as JSON for processing
-specforge-mcp tickets --json | jq '.[]'
+specforge tickets --json | jq '.[]'
 
 # Get next actionable ticket ID
-specforge-mcp next --json | jq -r '.tickets[0].id'
+specforge next --json | jq -r '.tickets[0].id'
 ```
 
 ### Global Options
@@ -607,7 +680,7 @@ If you're experiencing connection issues:
 
 ```bash
 export SPECFORGE_DEBUG=true
-specforge-mcp
+specforge
 ```
 
 ### Debug Mode
@@ -632,11 +705,11 @@ This will output detailed logs to stderr, including:
 
 ### Permission Denied
 
-If you get "permission denied" when running `specforge-mcp`:
+If you get "permission denied" when running `specforge`:
 
 ```bash
 # On macOS/Linux
-chmod +x $(which specforge-mcp)
+chmod +x $(which specforge)
 
 # Or run with node directly
 node $(npm root -g)/@specforge/mcp/dist/index.js

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