fraim-framework 2.0.73 → 2.0.74

package/bin/fraim.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework CLI Entry Point

package/dist/src/cli/commands/init.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = exports.runInit = void 0;
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const first_run_1 = require("../setup/first-run");
+const sync_1 = require("./sync");
+const platform_detection_1 = require("../../utils/platform-detection");
+const version_utils_1 = require("../../utils/version-utils");
+const script_sync_utils_1 = require("../../utils/script-sync-utils");
+const runInit = async (options = {}) => {
+    const projectRoot = process.cwd();
+    const fraimDir = path_1.default.join(projectRoot, '.fraim');
+    const configPath = path_1.default.join(fraimDir, 'config.json');
+    console.log(chalk_1.default.blue('🚀 Initializing FRAIM...'));
+    if (!fs_1.default.existsSync(fraimDir)) {
+        fs_1.default.mkdirSync(fraimDir, { recursive: true });
+        console.log(chalk_1.default.green('✅ Created .fraim directory'));
+    }
+    else {
+        console.log(chalk_1.default.yellow('ℹ️  .fraim directory already exists'));
+    }
+    if (!fs_1.default.existsSync(configPath)) {
+        let config;
+        // Try to detect platform from git remote
+        const detection = (0, platform_detection_1.detectPlatformFromGit)();
+        if (options.skipPlatform || detection.provider === 'unknown' || !detection.repository) {
+            // Conversational mode - no platform integration
+            if (!options.skipPlatform && (detection.provider === 'unknown' || !detection.repository)) {
+                console.log(chalk_1.default.yellow('\nℹ️  No git remote found or unsupported platform.'));
+                console.log(chalk_1.default.blue('   Initializing in conversational mode (no platform integration).'));
+                console.log(chalk_1.default.gray('   You can still use FRAIM workflows and AI features.'));
+                console.log(chalk_1.default.gray('   Platform features (issues, PRs) will be unavailable.\n'));
+            }
+            else {
+                console.log(chalk_1.default.blue('\n   Initializing in conversational mode (platform integration skipped).\n'));
+            }
+            // Get project name from directory or git
+            let projectName = path_1.default.basename(projectRoot);
+            try {
+                const { execSync } = require('child_process');
+                const gitName = execSync('git config --get remote.origin.url', {
+                    stdio: 'pipe',
+                    timeout: 2000
+                }).toString().trim();
+                const match = gitName.match(/\/([^\/]+?)(\.git)?$/);
+                if (match) {
+                    projectName = match[1];
+                }
+            }
+            catch (e) {
+                // Use directory name as fallback
+            }
+            config = {
+                version: (0, version_utils_1.getFraimVersion)(),
+                project: {
+                    name: projectName
+                },
+                customizations: {
+                    workflowsPath: '.fraim/workflows'
+                }
+            };
+            console.log(chalk_1.default.gray(`   Project: ${projectName}`));
+            console.log(chalk_1.default.gray(`   Mode: Conversational (no platform integration)`));
+        }
+        else {
+            // Integrated mode - use platform
+            if (!detection.repository) {
+                console.log(chalk_1.default.red('❌ Error: Repository information not available'));
+                process.exit(1);
+            }
+            // Validate the detected repository config
+            const validation = (0, platform_detection_1.validateRepositoryConfig)(detection.repository);
+            if (!validation.valid) {
+                console.log(chalk_1.default.red('❌ Error: Invalid repository configuration:'));
+                validation.errors.forEach(err => console.log(chalk_1.default.red(`   - ${err}`)));
+                process.exit(1);
+            }
+            console.log(chalk_1.default.blue('\n   Initializing in integrated mode (platform integration enabled).'));
+            console.log(chalk_1.default.gray(`   Platform: ${detection.provider.toUpperCase()}`));
+            if (detection.provider === 'github') {
+                console.log(chalk_1.default.gray(`   Repository: ${detection.repository.owner}/${detection.repository.name}`));
+            }
+            else if (detection.provider === 'ado') {
+                console.log(chalk_1.default.gray(`   Organization: ${detection.repository.organization}`));
+                console.log(chalk_1.default.gray(`   Project: ${detection.repository.project}`));
+                console.log(chalk_1.default.gray(`   Repository: ${detection.repository.name}`));
+            }
+            console.log();
+            config = {
+                version: (0, version_utils_1.getFraimVersion)(),
+                project: {
+                    name: detection.repository.name
+                },
+                repository: detection.repository,
+                customizations: {
+                    workflowsPath: '.fraim/workflows'
+                }
+            };
+        }
+        fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        console.log(chalk_1.default.green('✅ Created .fraim/config.json'));
+    }
+    // Create subdirectories
+    ['workflows'].forEach(dir => {
+        const dirPath = path_1.default.join(fraimDir, dir);
+        if (!fs_1.default.existsSync(dirPath)) {
+            fs_1.default.mkdirSync(dirPath, { recursive: true });
+            console.log(chalk_1.default.green(`✅ Created .fraim/${dir}`));
+        }
+    });
+    console.log(chalk_1.default.blue('\n🎉 FRAIM initialized successfully!'));
+    // Sync workflows from registry
+    await (0, sync_1.runSync)({});
+    // Sync scripts to user directory
+    console.log(chalk_1.default.blue('🔄 Syncing FRAIM scripts to user directory...'));
+    // Find registry path (same logic as sync command)
+    let registryPath = path_1.default.join(__dirname, '../../../../registry');
+    if (!fs_1.default.existsSync(registryPath)) {
+        registryPath = path_1.default.join(__dirname, '../../../registry');
+    }
+    if (!fs_1.default.existsSync(registryPath)) {
+        registryPath = path_1.default.join(projectRoot, 'registry');
+    }
+    if (fs_1.default.existsSync(registryPath)) {
+        const syncResult = (0, script_sync_utils_1.syncScriptsToUserDirectory)(registryPath);
+        console.log(chalk_1.default.green(`✅ Synced ${syncResult.synced} self-contained scripts to user directory.`));
+        if (syncResult.ephemeral > 0) {
+            console.log(chalk_1.default.gray(`   ${syncResult.ephemeral} dependent scripts will use ephemeral execution.`));
+        }
+    }
+    else {
+        console.log(chalk_1.default.yellow('⚠️ Registry not found, skipping script sync.'));
+    }
+    // Trigger First Run Experience
+    await (0, first_run_1.runFirstRunExperience)();
+    process.exit(0);
+};
+exports.runInit = runInit;
+exports.initCommand = new commander_1.Command('init')
+    .description('Initialize FRAIM in the current project')
+    .option('--skip-platform', 'Skip platform integration (conversational mode only)')
+    .action((options) => (0, exports.runInit)(options));

package/dist/src/cli/commands/mcp.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpCommand = void 0;
+const commander_1 = require("commander");
+const server_1 = require("../../local-mcp-server/server");
+const chalk_1 = __importDefault(require("chalk"));
+exports.mcpCommand = new commander_1.Command('mcp')
+    .description('Start the local FRAIM MCP server')
+    .option('-p, --port <port>', 'Port to run the server on', '3003')
+    .option('--remote-only', 'Use remote server only (skip local proxy)', false)
+    .action(async (options) => {
+    try {
+        if (options.remoteOnly) {
+            console.log(chalk_1.default.yellow('⚠️ Remote-only mode not yet implemented'));
+            console.log(chalk_1.default.blue('ℹ️ Starting local MCP server instead...'));
+        }
+        const port = parseInt(options.port);
+        if (isNaN(port) || port < 1 || port > 65535) {
+            console.error(chalk_1.default.red('❌ Invalid port number. Must be between 1 and 65535.'));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.blue('🚀 Starting FRAIM Local MCP Server...'));
+        console.log(chalk_1.default.gray(`📡 Port: ${port}`));
+        console.log(chalk_1.default.gray(`🔄 Auto-updates: Every 5 minutes`));
+        console.log(chalk_1.default.gray(`📁 Cache: ~/.fraim/cache`));
+        console.log('');
+        // Set the port in environment
+        process.env.FRAIM_LOCAL_MCP_PORT = port.toString();
+        // Start the server
+        await (0, server_1.startLocalMCPServer)();
+        // Server is now running, show configuration instructions
+        console.log('');
+        console.log(chalk_1.default.green('✅ FRAIM Local MCP Server is running!'));
+        console.log('');
+        console.log(chalk_1.default.bold('📋 Agent Configuration:'));
+        console.log('');
+        console.log(chalk_1.default.gray('Add this to your agent\'s MCP configuration:'));
+        console.log('');
+        console.log(chalk_1.default.cyan(JSON.stringify({
+            "mcpServers": {
+                "fraim": {
+                    "command": "fraim",
+                    "args": ["mcp"],
+                    "env": {}
+                }
+            }
+        }, null, 2)));
+        console.log('');
+        console.log(chalk_1.default.bold('🔗 Endpoints:'));
+        console.log(chalk_1.default.gray(`  MCP: http://localhost:${port}/mcp`));
+        console.log(chalk_1.default.gray(`  Health: http://localhost:${port}/health`));
+        console.log('');
+        console.log(chalk_1.default.bold('🛑 To stop the server:'));
+        console.log(chalk_1.default.gray('  Press Ctrl+C'));
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Failed to start Local MCP Server:'));
+        console.error(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});

package/dist/src/cli/commands/sync.js

@@ -113,6 +113,10 @@ const runSync = async (options) => {
     if (!result.success) {
         console.error(chalk_1.default.red(`❌ Remote sync failed: ${result.error}`));
         console.error(chalk_1.default.yellow('💡 Check your API key and network connection.'));
+        if (process.env.TEST_MODE === 'true') {
+            console.log(chalk_1.default.yellow('⚠️ TEST_MODE: Continuing without remote sync (server may be unavailable).'));
+            return;
+        }
         process.exit(1);
     }
     console.log(chalk_1.default.green(`✅ Successfully synced ${result.workflowsSynced} workflows and ${result.scriptsSynced} scripts from remote`));

package/dist/src/cli/commands/test-mcp.js

@@ -28,12 +28,14 @@ const testIDEConfig = async (ide) => {
         if (ide.configFormat === 'json') {
             const configContent = fs_1.default.readFileSync(configPath, 'utf8');
             const config = JSON.parse(configContent);
-            if (config.mcpServers) {
+            const servers = ide.configType === 'vscode' ? config.servers : config.mcpServers;
+            if (servers) {
                 result.configValid = true;
-                result.mcpServers = Object.keys(config.mcpServers);
+                result.mcpServers = Object.keys(servers);
             }
             else {
-                result.errors.push('No mcpServers section found');
+                const expectedKey = ide.configType === 'vscode' ? 'servers' : 'mcpServers';
+                result.errors.push(`No ${expectedKey} section found`);
             }
         }
         else if (ide.configFormat === 'toml') {

package/dist/src/cli/commands/wizard.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wizardCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const init_js_1 = require("./init.js");
+const sync_js_1 = require("./sync.js");
+exports.wizardCommand = new commander_1.Command('wizard')
+    .description('Run the interactive setup wizard')
+    .action(async () => {
+    console.log(chalk_1.default.cyan('🔮 FRAIM Interactive Setup Wizard\n'));
+    console.log('Running V2 setup (Init + Sync)...\n');
+    try {
+        // Run initialization
+        try {
+            await (0, init_js_1.runInit)();
+        }
+        catch (err) {
+            console.log(chalk_1.default.yellow('⚠️ Init notice:'), err.message);
+        }
+        console.log(''); // newline
+        // Run sync (Force not strictly required if init is fresh, but safe)
+        // But if user runs wizard on existing project, maybe they want to resync
+        await (0, sync_js_1.runSync)({ force: false });
+        console.log(chalk_1.default.blue('\n✨ Wizard completed successfully!'));
+        console.log(chalk_1.default.gray('Tip: In the future, you can run `fraim sync` to update workflows.'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Wizard failed:'), error);
+        process.exit(1);
+    }
+});

package/dist/src/cli/setup/auto-mcp-setup.js

@@ -209,10 +209,11 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
     }
     let existingConfig = {};
     let existingMCPServers = {};
+    const serversKey = ide.configType === 'vscode' ? 'servers' : 'mcpServers';
     if (fs_1.default.existsSync(configPath) && ide.configFormat === 'json') {
         try {
             existingConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-            existingMCPServers = existingConfig.mcpServers || {};
+            existingMCPServers = existingConfig[serversKey] || {};
             console.log(chalk_1.default.gray(`  📋 Found existing config with ${Object.keys(existingMCPServers).length} MCP servers`));
         }
         catch (e) {
@@ -253,7 +254,7 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
     else {
         // For JSON configs - intelligent merging
         const newConfig = (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, githubToken);
-        const newMCPServers = newConfig.mcpServers || {};
+        const newMCPServers = newConfig[serversKey] || newConfig.mcpServers || {};
         // Merge MCP servers intelligently
         const mergedMCPServers = { ...existingMCPServers };
         const addedServers = [];
@@ -267,11 +268,10 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
                 skippedServers.push(serverName);
             }
         }
-        // Merge with existing config
+        // Merge with existing config (VS Code uses "servers", others use "mcpServers")
         const mergedConfig = {
             ...existingConfig,
-            ...newConfig,
-            mcpServers: mergedMCPServers
+            [serversKey]: mergedMCPServers
         };
         // Write updated config
         fs_1.default.writeFileSync(configPath, JSON.stringify(mergedConfig, null, 2));

package/dist/src/cli/setup/first-run.js

@@ -99,6 +99,26 @@ const checkMCPConfigurations = () => {
             // Ignore parsing errors
         }
     }
+    // Check VS Code MCP config (uses "servers" key)
+    const vscodePaths = [
+        path_1.default.join(os_1.default.homedir(), 'AppData', 'Roaming', 'Code', 'User', 'mcp.json'),
+        path_1.default.join(os_1.default.homedir(), 'Library', 'Application Support', 'Code', 'User', 'mcp.json'),
+        path_1.default.join(os_1.default.homedir(), '.config', 'Code', 'User', 'mcp.json')
+    ];
+    for (const vscodePath of vscodePaths) {
+        if (fs_1.default.existsSync(vscodePath)) {
+            try {
+                const vscodeConfig = JSON.parse(fs_1.default.readFileSync(vscodePath, 'utf8'));
+                if (vscodeConfig.servers?.fraim) {
+                    sources.push('VSCode');
+                    break;
+                }
+            }
+            catch (e) {
+                // Ignore parsing errors
+            }
+        }
+    }
     return {
         found: sources.length > 0,
         sources

package/dist/src/cli/setup/ide-detector.js

@@ -108,14 +108,18 @@ exports.IDE_CONFIGS = [
     },
     {
         name: 'VSCode',
-        configPath: '~/.vscode/settings/mcp.json',
+        configPath: process.platform === 'win32'
+            ? '~/AppData/Roaming/Code/User/mcp.json'
+            : process.platform === 'darwin'
+                ? '~/Library/Application Support/Code/User/mcp.json'
+                : '~/.config/Code/User/mcp.json',
         configFormat: 'json',
-        configType: 'kiro',
+        configType: 'vscode',
         detectMethod: detectVSCode,
         alternativePaths: [
-            '~/Library/Application Support/Code/User/settings/mcp.json',
-            '~/AppData/Roaming/Code/User/settings/mcp.json',
-            '~/.config/Code/User/settings/mcp.json'
+            '~/Library/Application Support/Code/User/mcp.json',
+            '~/AppData/Roaming/Code/User/mcp.json',
+            '~/.config/Code/User/mcp.json'
         ],
         description: 'Visual Studio Code'
     },

package/dist/src/cli/setup/mcp-config-generator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMCPConfig = exports.generateWindsurfMCPServers = exports.generateCodexMCPServers = exports.generateKiroMCPServers = exports.generateClaudeMCPServers = exports.generateStandardMCPServers = void 0;
+exports.generateMCPConfig = exports.generateWindsurfMCPServers = exports.generateVSCodeMCPServers = exports.generateCodexMCPServers = exports.generateKiroMCPServers = exports.generateClaudeMCPServers = exports.generateStandardMCPServers = void 0;
 const generateStandardMCPServers = (fraimKey, githubToken) => {
     const servers = {
         git: {
@@ -121,6 +121,40 @@ FRAIM_REMOTE_URL = "https://fraim.wellnessatwork.me"
     return config;
 };
 exports.generateCodexMCPServers = generateCodexMCPServers;
+/** VS Code uses "servers" key and requires type: "stdio" for stdio servers */
+const generateVSCodeMCPServers = (fraimKey, githubToken) => {
+    const servers = {
+        git: {
+            type: 'stdio',
+            command: 'npx',
+            args: ['-y', '@cyanheads/git-mcp-server']
+        },
+        playwright: {
+            type: 'stdio',
+            command: 'npx',
+            args: ['-y', '@playwright/mcp']
+        },
+        fraim: {
+            type: 'stdio',
+            command: 'fraim-mcp',
+            env: {
+                FRAIM_API_KEY: fraimKey,
+                FRAIM_REMOTE_URL: 'https://fraim.wellnessatwork.me'
+            }
+        }
+    };
+    if (githubToken) {
+        servers.github = {
+            type: 'http',
+            url: 'https://api.githubcopilot.com/mcp/',
+            headers: {
+                Authorization: `Bearer ${githubToken}`
+            }
+        };
+    }
+    return { servers };
+};
+exports.generateVSCodeMCPServers = generateVSCodeMCPServers;
 const generateWindsurfMCPServers = (fraimKey, githubToken) => {
     const servers = {
         git: {
@@ -160,6 +194,8 @@ const generateMCPConfig = (configType, fraimKey, githubToken) => {
             return (0, exports.generateClaudeMCPServers)(fraimKey, githubToken);
         case 'kiro':
             return (0, exports.generateKiroMCPServers)(fraimKey, githubToken);
+        case 'vscode':
+            return (0, exports.generateVSCodeMCPServers)(fraimKey, githubToken);
         case 'codex':
             return (0, exports.generateCodexMCPServers)(fraimKey, githubToken);
         case 'windsurf':

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework - Smart Entry Point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.73",
+  "version": "2.0.74",
   "description": "FRAIM v2: Framework for Rigor-based AI Management - Transform from solo developer to AI manager orchestrating production-ready code with enterprise-grade discipline",
   "main": "index.js",
   "bin": {
@@ -25,7 +25,7 @@
     "prepublishOnly": "npm run build",
     "release": "npm version patch && npm publish",
     "test-smoke-ci": "tsx --test tests/test-genericization.ts tests/test-cli.ts tests/test-stub-registry.ts",
-    "test-all-ci": "tsx --test tests/test-*.ts",
+    "test-all-ci": "node scripts/test-with-server.js",
     "validate:registry": "tsx scripts/verify-registry-paths.ts && npm run validate:workflows && npm run validate:platform-agnostic",
     "validate:workflows": "tsx scripts/validate-workflows.ts",
     "validate:platform-agnostic": "tsx scripts/validate-platform-agnostic.ts"