@specforge/mcp 2.0.9 → 2.1.0

package/dist/cli/config/writer.js

@@ -0,0 +1,312 @@
+/**
+ * Config Writer
+ *
+ * Provides safe config file writing with atomic operations and proper permissions.
+ *
+ * Security features:
+ * - Global config (contains API key) written with mode 0600 (owner read/write only)
+ * - Global directory created with mode 0700 (owner access only)
+ * - Project config written with standard permissions (0644)
+ * - Path validation to prevent writes outside allowed directories
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { getGlobalConfigDir, getGlobalConfigPath, getProjectConfigPath, getMcpConfigPath, } from './paths.js';
+import { loadGlobalConfig, loadProjectConfig } from './loader.js';
+/**
+ * File permission constants
+ */
+const PERMISSIONS = {
+    /** Directory accessible only by owner (rwx------) */
+    SECURE_DIR: 0o700,
+    /** File readable/writable only by owner (rw-------) */
+    SECRET_FILE: 0o600,
+    /** Regular file permissions (rw-r--r--) */
+    REGULAR_FILE: 0o644,
+};
+/**
+ * Ensure global config directory exists with secure permissions
+ *
+ * Creates ~/.specforge/ if it doesn't exist, with mode 0700 (owner-only access).
+ * Idempotent - safe to call multiple times.
+ *
+ * @throws Error if directory creation fails
+ *
+ * @example
+ * ```typescript
+ * ensureGlobalDir();
+ * // ~/.specforge/ now exists with drwx------ permissions
+ * ```
+ */
+export function ensureGlobalDir() {
+    const globalDir = getGlobalConfigDir();
+    if (fs.existsSync(globalDir)) {
+        return; // Already exists
+    }
+    try {
+        fs.mkdirSync(globalDir, { mode: PERMISSIONS.SECURE_DIR, recursive: true });
+    }
+    catch (error) {
+        throw new Error(`Failed to create global config directory: ${globalDir}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Save global configuration
+ *
+ * Merges the provided config with existing global config and writes to
+ * ~/.specforge/config.json with secure permissions (0600).
+ *
+ * Undefined values are removed from the final config.
+ *
+ * @param config - Partial global config to save
+ * @throws Error if write fails
+ *
+ * @example
+ * ```typescript
+ * // Save API key
+ * saveGlobalConfig({ apiKey: 'sf_live_...' });
+ *
+ * // Update format, keeping existing apiKey
+ * saveGlobalConfig({ format: 'json' });
+ * ```
+ */
+export function saveGlobalConfig(config) {
+    ensureGlobalDir();
+    const configPath = getGlobalConfigPath();
+    // Load existing config
+    const existing = loadGlobalConfig();
+    // Merge configs
+    const merged = {
+        ...existing,
+        ...config,
+    };
+    // Remove undefined values
+    Object.keys(merged).forEach(key => {
+        if (merged[key] === undefined) {
+            delete merged[key];
+        }
+    });
+    // Write with secure permissions
+    const content = JSON.stringify(merged, null, 2) + '\n';
+    try {
+        fs.writeFileSync(configPath, content, { mode: PERMISSIONS.SECRET_FILE });
+    }
+    catch (error) {
+        throw new Error(`Failed to write global config: ${configPath}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Delete a field from global config
+ *
+ * Loads existing config, removes the specified field, and saves.
+ * No-op if the field doesn't exist.
+ *
+ * @param field - Field name to remove
+ * @throws Error if read/write fails
+ *
+ * @example
+ * ```typescript
+ * deleteGlobalConfigField('apiKey');
+ * deleteGlobalConfigField('defaultProjectId');
+ * ```
+ */
+export function deleteGlobalConfigField(field) {
+    const configPath = getGlobalConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return; // No config to modify
+    }
+    const existing = loadGlobalConfig();
+    // Remove field
+    delete existing[field];
+    // Save updated config
+    const content = JSON.stringify(existing, null, 2) + '\n';
+    try {
+        fs.writeFileSync(configPath, content, { mode: PERMISSIONS.SECRET_FILE });
+    }
+    catch (error) {
+        throw new Error(`Failed to update global config: ${configPath}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Save project configuration
+ *
+ * Merges the provided config with existing project config and writes to
+ * .specforge.json in the current directory.
+ *
+ * Undefined values are removed from the final config.
+ *
+ * @param config - Partial project config to save
+ * @param targetDir - Directory to write .specforge.json to (defaults to cwd)
+ * @throws Error if write fails
+ *
+ * @example
+ * ```typescript
+ * // Initialize project
+ * saveProjectConfig({
+ *   projectId: 'proj_123',
+ *   specificationId: 'spec_456',
+ * });
+ *
+ * // Update format setting
+ * saveProjectConfig({ format: 'json' });
+ * ```
+ */
+export function saveProjectConfig(config, targetDir) {
+    const configPath = targetDir
+        ? path.join(path.resolve(targetDir), '.specforge.json')
+        : getProjectConfigPath();
+    // Load existing config (may be null if new file)
+    const existing = loadProjectConfig() || {};
+    // Merge configs
+    const merged = {
+        ...existing,
+        ...config,
+    };
+    // Remove undefined values
+    Object.keys(merged).forEach(key => {
+        if (merged[key] === undefined) {
+            delete merged[key];
+        }
+    });
+    // Write with standard permissions
+    const content = JSON.stringify(merged, null, 2) + '\n';
+    try {
+        fs.writeFileSync(configPath, content, { mode: PERMISSIONS.REGULAR_FILE });
+    }
+    catch (error) {
+        throw new Error(`Failed to write project config: ${configPath}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Generate MCP configuration for Claude Code integration
+ *
+ * Creates a .mcp.json configuration that registers the SpecForge MCP server
+ * for Claude Code. The server is registered under the @specforge/mcp
+ * package name.
+ *
+ * @returns MCP config object
+ *
+ * @example
+ * ```typescript
+ * const mcpConfig = generateMcpConfig();
+ * console.log(mcpConfig.mcpServers['@specforge/mcp']);
+ * // { command: 'npx', args: [...] }
+ * ```
+ */
+export function generateMcpConfig() {
+    return {
+        mcpServers: {
+            '@specforge/mcp': {
+                command: 'npx',
+                args: ['-y', '@specforge/mcp'],
+            },
+        },
+    };
+}
+/**
+ * Save MCP configuration file
+ *
+ * Writes .mcp.json to the current directory (or specified directory)
+ * to enable Claude Code integration with the SpecForge MCP server.
+ *
+ * @param targetDir - Directory to write .mcp.json to (defaults to cwd)
+ * @throws Error if write fails
+ *
+ * @example
+ * ```typescript
+ * saveMcpConfig();
+ * // .mcp.json created in current directory
+ * ```
+ */
+export function saveMcpConfig(targetDir) {
+    const configPath = targetDir
+        ? path.join(path.resolve(targetDir), '.mcp.json')
+        : getMcpConfigPath();
+    const content = JSON.stringify(generateMcpConfig(), null, 2) + '\n';
+    try {
+        fs.writeFileSync(configPath, content, { mode: PERMISSIONS.REGULAR_FILE });
+    }
+    catch (error) {
+        throw new Error(`Failed to write MCP config: ${configPath}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Add an entry to .gitignore if it exists
+ *
+ * Does not create .gitignore if it doesn't exist.
+ * Does not duplicate existing entries.
+ *
+ * @param entry - Line to add to .gitignore
+ * @param targetDir - Directory containing .gitignore (defaults to cwd)
+ * @returns true if entry was added, false if already exists or no .gitignore
+ *
+ * @example
+ * ```typescript
+ * const added = addToGitignore('.specforge.json');
+ * if (added) {
+ *   console.log('Added .specforge.json to .gitignore');
+ * }
+ * ```
+ */
+export function addToGitignore(entry, targetDir) {
+    const gitignorePath = targetDir
+        ? path.join(path.resolve(targetDir), '.gitignore')
+        : path.resolve('.gitignore');
+    if (!fs.existsSync(gitignorePath)) {
+        return false;
+    }
+    try {
+        const content = fs.readFileSync(gitignorePath, 'utf-8');
+        const lines = content.split('\n');
+        // Check if entry already exists (exact match, trimmed)
+        const normalizedEntry = entry.trim();
+        if (lines.some(line => line.trim() === normalizedEntry)) {
+            return false; // Already exists
+        }
+        // Add entry with proper newline handling
+        const newContent = content.endsWith('\n')
+            ? content + normalizedEntry + '\n'
+            : content + '\n' + normalizedEntry + '\n';
+        fs.writeFileSync(gitignorePath, newContent);
+        return true;
+    }
+    catch (error) {
+        // Log warning but don't fail - this is a nice-to-have
+        console.warn(`Warning: Could not update .gitignore: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+/**
+ * Remove API key from global config (logout)
+ *
+ * @example
+ * ```typescript
+ * clearApiKey();
+ * console.log('Logged out successfully');
+ * ```
+ */
+export function clearApiKey() {
+    deleteGlobalConfigField('apiKey');
+}
+/**
+ * Check if global config file exists
+ *
+ * @returns true if ~/.specforge/config.json exists
+ */
+export function hasGlobalConfig() {
+    return fs.existsSync(getGlobalConfigPath());
+}
+/**
+ * Check if project config file exists in cwd
+ *
+ * @returns true if .specforge.json exists
+ */
+export function hasProjectConfig() {
+    return fs.existsSync(getProjectConfigPath());
+}
+//# sourceMappingURL=writer.js.map

package/dist/cli/config/writer.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SpecForge MCP CLI Entry Point
+ *
+ * Main CLI application using Commander.js.
+ * Sets up command routing, middleware, and global options.
+ */
+import { Command } from 'commander';
+/**
+ * CLI version - should match package.json
+ */
+declare const CLI_VERSION = "2.1.0";
+/**
+ * The main CLI program instance
+ */
+declare const program: Command;
+/**
+ * Run the CLI with given arguments
+ *
+ * @param argv - Command line arguments (defaults to process.argv)
+ */
+export declare function runCLI(argv?: string[]): void;
+/**
+ * Export program for testing and extension
+ */
+export { program };
+/**
+ * Export version for external use
+ */
+export { CLI_VERSION };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC;;GAEG;AACH,QAAA,MAAM,WAAW,UAAU,CAAC;AAoK5B;;GAEG;AACH,QAAA,MAAM,OAAO,SAAkB,CAAC;AAShC;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CAQ1D;AAED;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,183 @@
+/**
+ * SpecForge MCP CLI Entry Point
+ *
+ * Main CLI application using Commander.js.
+ * Sets up command routing, middleware, and global options.
+ */
+import { Command } from 'commander';
+import { authGuardHook } from './middleware/auth-guard.js';
+import { withErrorHandler, debugLog } from './middleware/error-handler.js';
+import { resolveConfig } from './config/loader.js';
+import { colors } from './ui/index.js';
+import { registerLoginCommand, registerInitCommand, registerConfigureCommand, registerDoctorCommand, registerStatusCommand, registerProjectsCommand, registerSpecsCommand, registerSwitchCommand, registerTicketsCommand, registerNextCommand, registerBlockedCommand, } from './commands/index.js';
+import { registerTicketCommand } from './commands/ticket/index.js';
+import { registerSessionCommands } from './commands/session/index.js';
+import { registerDebugCommands } from './commands/debug/index.js';
+import { registerScaffoldCommand } from './commands/scaffold/index.js';
+import { registerDocumentationCommands } from './commands/docs/index.js';
+/**
+ * CLI version - should match package.json
+ */
+const CLI_VERSION = '2.1.0';
+/**
+ * CLI name for display
+ */
+const CLI_NAME = 'specforge-mcp';
+/**
+ * Create and configure the CLI program
+ */
+function createProgram() {
+    const program = new Command();
+    // Basic program info
+    program
+        .name(CLI_NAME)
+        .description('SpecForge MCP CLI - Configure and interact with SpecForge')
+        .version(CLI_VERSION, '-v, --version', 'Display version number');
+    // Global options
+    program
+        .option('--debug', 'Enable debug output')
+        .option('--no-color', 'Disable colored output')
+        .option('--json', 'Output in JSON format');
+    // Pre-action hook for auth guard
+    program.hook('preAction', (thisCommand, actionCommand) => {
+        const commandName = actionCommand.name();
+        // Set debug mode from flag
+        if (thisCommand.opts().debug) {
+            process.env.SPECFORGE_DEBUG = 'true';
+        }
+        // Disable colors if requested
+        if (thisCommand.opts().noColor) {
+            // chalk.level = 0 is handled in colors module
+            process.env.NO_COLOR = '1';
+        }
+        debugLog(`Running command: ${commandName}`);
+        debugLog('Resolved config:', resolveConfig());
+        // Run auth guard
+        authGuardHook({ name: () => commandName });
+    });
+    return program;
+}
+/**
+ * Register the default serve command (MCP server mode)
+ *
+ * This is the hidden default when no subcommand is provided.
+ * Maintains backward compatibility with direct MCP server usage.
+ */
+function registerServeCommand(program) {
+    program
+        .command('serve', { isDefault: true, hidden: true })
+        .description('Start MCP server (default)')
+        .action(withErrorHandler(async () => {
+        debugLog('Starting MCP server');
+        // Dynamic import to avoid loading server code for CLI commands
+        const { loadConfig, validateConfig } = await import('../config/index.js');
+        const { createServer, startServer } = await import('../server.js');
+        // Load and validate config
+        const config = await loadConfig();
+        validateConfig(config);
+        // Create and start server
+        const server = await createServer(config);
+        await startServer(server);
+    }));
+}
+/**
+ * Register all CLI commands
+ */
+function registerCommands(program) {
+    // E02 - Login command (implemented)
+    registerLoginCommand(program);
+    // E03 - Init command (implemented)
+    registerInitCommand(program);
+    // E04 - Configure command (implemented)
+    registerConfigureCommand(program);
+    // E05 - Doctor command (implemented)
+    registerDoctorCommand(program);
+    // E06 - Status command (implemented)
+    registerStatusCommand(program);
+    // E07 - Projects Command (implemented)
+    registerProjectsCommand(program);
+    // E07 - Specs Command (implemented)
+    registerSpecsCommand(program);
+    // E08 - Switch Command (implemented)
+    registerSwitchCommand(program);
+    // E09 - Tickets Command (implemented)
+    registerTicketsCommand(program);
+    // E10 - Next Command (implemented)
+    registerNextCommand(program);
+    // E10 - Blocked Command (implemented)
+    registerBlockedCommand(program);
+    // E11 - Ticket Command (implemented)
+    registerTicketCommand(program);
+    // E12 - Session Commands (implemented)
+    registerSessionCommands(program);
+    // E13 - Debug Commands (implemented)
+    registerDebugCommands(program);
+    // E14 - Scaffold Command (implemented)
+    registerScaffoldCommand(program);
+    // E15 - MCP Docs Command (implemented)
+    registerDocumentationCommands(program);
+    // E16 - Review Command
+    program
+        .command('review')
+        .description('Review implementation progress')
+        .action(() => {
+        console.log(colors.muted('Review command will be implemented in E16'));
+    });
+}
+/**
+ * Configure help output styling
+ */
+function configureHelp(program) {
+    program.configureHelp({
+        sortSubcommands: true,
+        subcommandTerm: (cmd) => cmd.name(),
+    });
+    // Custom help footer
+    program.addHelpText('after', `
+${colors.muted('Examples:')}
+  $ specforge-mcp login           # Authenticate with API key
+  $ specforge-mcp init            # Initialize in current directory
+  $ specforge-mcp status          # Show current status
+  $ specforge-mcp tickets         # List all tickets
+  $ specforge-mcp next            # Get next ticket to work on
+
+${colors.muted('Documentation:')}
+  ${colors.primary('https://docs.specforge.com/cli')}
+
+${colors.muted('Report issues:')}
+  ${colors.primary('https://github.com/specforge/mcp/issues')}
+`);
+}
+/**
+ * The main CLI program instance
+ */
+const program = createProgram();
+// Register commands
+registerServeCommand(program);
+registerCommands(program);
+// Configure help
+configureHelp(program);
+/**
+ * Run the CLI with given arguments
+ *
+ * @param argv - Command line arguments (defaults to process.argv)
+ */
+export function runCLI(argv = process.argv) {
+    try {
+        program.parse(argv);
+    }
+    catch (error) {
+        // Commander handles most errors, but catch any that slip through
+        debugLog('CLI parse error:', error);
+        process.exit(1);
+    }
+}
+/**
+ * Export program for testing and extension
+ */
+export { program };
+/**
+ * Export version for external use
+ */
+export { CLI_VERSION };
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/middleware/auth-guard.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Auth Guard Middleware
+ *
+ * Checks for valid API key authentication before executing protected commands.
+ * Provides helpful error messages directing users to authenticate.
+ */
+/**
+ * Check if a command requires authentication
+ *
+ * @param command - Command name or flag to check
+ * @returns true if command requires authentication
+ *
+ * @example
+ * ```typescript
+ * requiresAuth('status');  // true
+ * requiresAuth('login');   // false
+ * requiresAuth('--help');  // false
+ * ```
+ */
+export declare function requiresAuth(command: string): boolean;
+/**
+ * Get the list of public commands
+ *
+ * @returns Array of command names that don't require auth
+ */
+export declare function getPublicCommands(): string[];
+/**
+ * Add a command to the public (no-auth-required) list
+ *
+ * Useful for plugins or extensions that add unauthenticated commands.
+ *
+ * @param command - Command name to add
+ */
+export declare function addPublicCommand(command: string): void;
+/**
+ * Authentication guard - checks auth and exits if not authenticated
+ *
+ * Call this at the start of protected command handlers.
+ * Exits the process with code 1 if not authenticated.
+ *
+ * @param command - Command name being executed (for logging)
+ *
+ * @example
+ * ```typescript
+ * // In a command handler
+ * export function statusCommand() {
+ *   authGuard('status');
+ *   // ... rest of command (only runs if authenticated)
+ * }
+ * ```
+ */
+export declare function authGuard(command: string): void;
+/**
+ * Check authentication without exiting
+ *
+ * Use this for conditional logic where you don't want to exit.
+ *
+ * @returns Object with auth status and config
+ *
+ * @example
+ * ```typescript
+ * const { authenticated, config } = checkAuth();
+ * if (!authenticated) {
+ *   // Handle gracefully without exiting
+ * }
+ * ```
+ */
+export declare function checkAuth(): {
+    authenticated: boolean;
+    apiKeySource: 'env' | 'global' | null;
+};
+/**
+ * Validate API key format
+ *
+ * Checks that the API key matches expected format without making API calls.
+ *
+ * @param apiKey - API key to validate
+ * @returns Object with validity and any error message
+ *
+ * @example
+ * ```typescript
+ * const { valid, error } = validateApiKeyFormat('sf_live_abc123');
+ * if (!valid) {
+ *   console.error(error);
+ * }
+ * ```
+ */
+export declare function validateApiKeyFormat(apiKey: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Commander.js pre-action hook for auth guard
+ *
+ * Use this with Commander's hook system for automatic auth checking.
+ *
+ * @param thisCommand - Commander command object
+ *
+ * @example
+ * ```typescript
+ * program.hook('preAction', authGuardHook);
+ * ```
+ */
+export declare function authGuardHook(thisCommand: {
+    name: () => string;
+}): void;
+//# sourceMappingURL=auth-guard.d.ts.map

package/dist/cli/middleware/auth-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-guard.d.ts","sourceRoot":"","sources":["../../../src/cli/middleware/auth-guard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAc/C;AA8BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,IAAI;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;CACvC,CAOA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA2BA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,IAAI,CAGvE"}