fraim-framework 2.0.72 → 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/list-overridable.js

@@ -10,7 +10,9 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 exports.listOverridableCommand = new commander_1.Command('list-overridable')
     .description('List all FRAIM registry paths that can be overridden')
-    .action(async () => {
+    .option('--job-category <category>', 'Filter by workflow category (e.g., product-building, customer-development, marketing)')
+    .option('--rules', 'Show all overridable rules')
+    .action(async (options) => {
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
     const configPath = path_1.default.join(fraimDir, 'config.json');
@@ -20,35 +22,24 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         console.log(chalk_1.default.red('❌ .fraim/ directory not found. Run "fraim setup" or "fraim init-project" first.'));
         process.exit(1);
     }
-    console.log(chalk_1.default.blue('📋 Overridable FRAIM Registry Paths:\n'));
-    // Define overridable categories
-    const categories = [
-        {
-            name: 'Workflows',
-            paths: [
-                'workflows/product-building/spec.md',
-                'workflows/product-building/design.md',
-                'workflows/product-building/implement.md',
-                'workflows/product-building/test.md',
-                'workflows/product-building/resolve.md',
-                'workflows/product-building/prep-issue.md'
-            ]
-        },
-        {
-            name: 'Templates',
-            paths: [
-                'templates/specs/FEATURESPEC-TEMPLATE.md',
-                'templates/design/DESIGN-TEMPLATE.md'
-            ]
-        },
-        {
-            name: 'Rules',
-            paths: [
-                'rules/coding-standards.md',
-                'rules/communication.md'
-            ]
+    // Determine registry location (try framework root first, then node_modules)
+    let registryRoot = null;
+    const frameworkRoot = path_1.default.join(__dirname, '..', '..', '..');
+    const frameworkRegistry = path_1.default.join(frameworkRoot, 'registry');
+    if (fs_1.default.existsSync(frameworkRegistry)) {
+        registryRoot = frameworkRegistry;
+    }
+    else {
+        const nodeModulesRegistry = path_1.default.join(process.cwd(), 'node_modules', '@fraim', 'framework', 'registry');
+        if (fs_1.default.existsSync(nodeModulesRegistry)) {
+            registryRoot = nodeModulesRegistry;
         }
-    ];
+    }
+    if (!registryRoot) {
+        console.log(chalk_1.default.red('❌ Could not find FRAIM registry. Please ensure @fraim/framework is installed.'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.blue('📋 Overridable FRAIM Registry Paths:\n'));
     // Get list of existing overrides
     const existingOverrides = new Set();
     if (fs_1.default.existsSync(overridesDir)) {
@@ -66,10 +57,50 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         };
         scanDir(overridesDir);
     }
-    // Display categories
-    for (const category of categories) {
-        console.log(chalk_1.default.bold.cyan(`${category.name}:`));
-        for (const filePath of category.paths) {
+    // Handle --rules flag
+    if (options.rules) {
+        const rulesDir = path_1.default.join(registryRoot, 'rules');
+        if (fs_1.default.existsSync(rulesDir)) {
+            console.log(chalk_1.default.bold.cyan('Rules:\n'));
+            const ruleFiles = fs_1.default.readdirSync(rulesDir)
+                .filter(f => f.endsWith('.md'))
+                .sort();
+            for (const file of ruleFiles) {
+                const filePath = `rules/${file}`;
+                const hasOverride = existingOverrides.has(filePath);
+                const status = hasOverride
+                    ? chalk_1.default.green('[OVERRIDDEN]')
+                    : chalk_1.default.gray('[OVERRIDABLE]');
+                console.log(`  ${status} ${filePath}`);
+            }
+            console.log('');
+        }
+        showTips();
+        return;
+    }
+    // Handle --job-category flag
+    if (options.jobCategory) {
+        const category = options.jobCategory;
+        const workflowsDir = path_1.default.join(registryRoot, 'workflows', category);
+        const templatesDir = path_1.default.join(registryRoot, 'templates', category);
+        if (!fs_1.default.existsSync(workflowsDir)) {
+            console.log(chalk_1.default.red(`❌ Category "${category}" not found.`));
+            console.log(chalk_1.default.gray('\nAvailable categories:'));
+            const categoriesDir = path_1.default.join(registryRoot, 'workflows');
+            const categories = fs_1.default.readdirSync(categoriesDir, { withFileTypes: true })
+                .filter(d => d.isDirectory())
+                .map(d => d.name)
+                .sort();
+            categories.forEach(c => console.log(chalk_1.default.gray(`  - ${c}`)));
+            process.exit(1);
+        }
+        // Show workflows for this category
+        console.log(chalk_1.default.bold.cyan(`Workflows (${category}):\n`));
+        const workflowFiles = fs_1.default.readdirSync(workflowsDir)
+            .filter(f => f.endsWith('.md'))
+            .sort();
+        for (const file of workflowFiles) {
+            const filePath = `workflows/${category}/${file}`;
             const hasOverride = existingOverrides.has(filePath);
             const status = hasOverride
                 ? chalk_1.default.green('[OVERRIDDEN]')
@@ -77,21 +108,95 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
             console.log(`  ${status} ${filePath}`);
         }
         console.log('');
+        // Show templates for this category (if they exist)
+        if (fs_1.default.existsSync(templatesDir)) {
+            console.log(chalk_1.default.bold.cyan(`Templates (${category}):\n`));
+            const templateFiles = fs_1.default.readdirSync(templatesDir)
+                .filter(f => f.endsWith('.md') || f.endsWith('.html') || f.endsWith('.csv') || f.endsWith('.yml'))
+                .sort();
+            for (const file of templateFiles) {
+                const filePath = `templates/${category}/${file}`;
+                const hasOverride = existingOverrides.has(filePath);
+                const status = hasOverride
+                    ? chalk_1.default.green('[OVERRIDDEN]')
+                    : chalk_1.default.gray('[OVERRIDABLE]');
+                console.log(`  ${status} ${filePath}`);
+            }
+            console.log('');
+        }
+        showTips();
+        return;
+    }
+    // Default: Show available categories and existing overrides
+    console.log(chalk_1.default.bold.cyan('Available Workflow Categories:\n'));
+    const workflowsDir = path_1.default.join(registryRoot, 'workflows');
+    const categories = fs_1.default.readdirSync(workflowsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name)
+        .sort();
+    // Group categories for better display
+    const columns = 3;
+    for (let i = 0; i < categories.length; i += columns) {
+        const row = categories.slice(i, i + columns);
+        const formatted = row.map(cat => chalk_1.default.gray(`  • ${cat.padEnd(30)}`)).join('');
+        console.log(formatted);
     }
-    // Show existing overrides not in the standard list
-    const standardPaths = new Set(categories.flatMap(c => c.paths));
-    const customOverrides = Array.from(existingOverrides)
-        .filter(p => !standardPaths.has(p));
-    if (customOverrides.length > 0) {
-        console.log(chalk_1.default.bold.cyan('Custom Overrides:'));
-        for (const filePath of customOverrides) {
-            console.log(`  ${chalk_1.default.green('[OVERRIDDEN]')} ${filePath}`);
+    console.log('');
+    // Show existing overrides
+    if (existingOverrides.size > 0) {
+        console.log(chalk_1.default.bold.cyan('Your Active Overrides:\n'));
+        // Group by type
+        const overridesByType = {
+            workflows: [],
+            templates: [],
+            rules: [],
+            other: []
+        };
+        for (const override of Array.from(existingOverrides).sort()) {
+            if (override.startsWith('workflows/')) {
+                overridesByType.workflows.push(override);
+            }
+            else if (override.startsWith('templates/')) {
+                overridesByType.templates.push(override);
+            }
+            else if (override.startsWith('rules/')) {
+                overridesByType.rules.push(override);
+            }
+            else {
+                overridesByType.other.push(override);
+            }
         }
-        console.log('');
+        if (overridesByType.workflows.length > 0) {
+            console.log(chalk_1.default.gray('  Workflows:'));
+            overridesByType.workflows.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+        if (overridesByType.templates.length > 0) {
+            console.log(chalk_1.default.gray('  Templates:'));
+            overridesByType.templates.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+        if (overridesByType.rules.length > 0) {
+            console.log(chalk_1.default.gray('  Rules:'));
+            overridesByType.rules.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+        if (overridesByType.other.length > 0) {
+            console.log(chalk_1.default.gray('  Other:'));
+            overridesByType.other.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+    }
+    else {
+        console.log(chalk_1.default.gray('No active overrides yet.\n'));
+    }
+    showTips();
+    function showTips() {
+        console.log(chalk_1.default.gray('Tips:'));
+        console.log(chalk_1.default.gray('  • Use "fraim override <path> --inherit" to inherit from global'));
+        console.log(chalk_1.default.gray('  • Use "fraim override <path> --copy" to copy current content'));
+        console.log(chalk_1.default.gray('  • Use --job-category <category> to see category-specific items'));
+        console.log(chalk_1.default.gray('  • Use --rules to see all overridable rules'));
+        console.log(chalk_1.default.gray('  • Overrides are stored in .fraim/overrides/'));
     }
-    // Show tips
-    console.log(chalk_1.default.gray('Tips:'));
-    console.log(chalk_1.default.gray('  • Use "fraim override <path> --inherit" to inherit from global'));
-    console.log(chalk_1.default.gray('  • Use "fraim override <path> --copy" to copy current content'));
-    console.log(chalk_1.default.gray('  • Overrides are stored in .fraim/overrides/'));
 });

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/override.js

@@ -9,11 +9,13 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const axios_1 = __importDefault(require("axios"));
+const git_utils_1 = require("../../core/utils/git-utils");
 exports.overrideCommand = new commander_1.Command('override')
     .description('Create a local override for a FRAIM registry file')
     .argument('<path>', 'Registry path to override (e.g., workflows/product-building/spec.md)')
     .option('--inherit', 'Create override with {{ import }} directive (inherits from global)')
-    .option('--copy', 'Copy current content from remote to local')
+    .option('--copy', 'Copy current content from server to local')
+    .option('--local', 'Fetch from local development server (port derived from git branch)')
     .action(async (registryPath, options) => {
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
@@ -56,48 +58,112 @@ exports.overrideCommand = new commander_1.Command('override')
         console.log(chalk_1.default.blue(`📝 Creating inherited override for: ${registryPath}`));
     }
     else {
-        // Fetch current content from remote
-        console.log(chalk_1.default.blue(`📥 Fetching current content from remote: ${registryPath}`));
+        // Fetch current content from server using MCP protocol
+        const isLocal = options.local || false;
+        const serverType = isLocal ? 'local server' : 'remote server';
+        console.log(chalk_1.default.blue(`📥 Fetching current content from ${serverType}: ${registryPath}`));
         try {
             // Read config to get remote URL
             let config = {};
             if (fs_1.default.existsSync(configPath)) {
                 config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
             }
-            const remoteUrl = config.remoteUrl || 'https://fraim-registry.azurewebsites.net';
-            const apiKey = config.apiKey;
-            // Determine endpoint based on path
-            let endpoint;
-            if (registryPath.startsWith('workflows/')) {
-                const workflowName = registryPath.replace('workflows/', '').replace('.md', '');
-                endpoint = `${remoteUrl}/api/workflows/${workflowName}`;
+            // Determine server URL
+            let serverUrl;
+            if (isLocal) {
+                const localPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : (0, git_utils_1.getPort)();
+                serverUrl = `http://localhost:${localPort}`;
             }
             else {
-                endpoint = `${remoteUrl}/api/files/${registryPath}`;
+                serverUrl = config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
             }
-            const headers = {};
+            const apiKey = isLocal ? 'local-dev' : (config.apiKey || process.env.FRAIM_API_KEY);
+            const headers = {
+                'Content-Type': 'application/json'
+            };
             if (apiKey) {
                 headers['x-api-key'] = apiKey;
             }
-            const response = await axios_1.default.get(endpoint, {
+            // First, establish session with fraim_connect
+            const connectRequest = {
+                jsonrpc: '2.0',
+                id: 0,
+                method: 'tools/call',
+                params: {
+                    name: 'fraim_connect',
+                    arguments: {
+                        agent: { name: 'fraim-cli', model: 'override-command' },
+                        machine: {
+                            hostname: require('os').hostname(),
+                            platform: process.platform,
+                            memory: require('os').totalmem(),
+                            cpus: require('os').cpus().length
+                        },
+                        repo: {
+                            url: config.repository?.url || 'https://github.com/unknown/unknown',
+                            owner: config.repository?.owner || 'unknown',
+                            name: config.repository?.name || 'unknown',
+                            branch: 'main'
+                        }
+                    }
+                }
+            };
+            await axios_1.default.post(`${serverUrl}/mcp`, connectRequest, { headers, timeout: 30000 });
+            // Now determine MCP tool and arguments based on path
+            let toolName;
+            let toolArgs;
+            if (registryPath.startsWith('workflows/')) {
+                // Extract workflow name from path
+                // e.g., "workflows/product-building/spec.md" -> "spec"
+                const parts = registryPath.split('/');
+                const workflowName = parts[parts.length - 1].replace('.md', '');
+                toolName = 'get_fraim_workflow';
+                toolArgs = { workflow: workflowName };
+            }
+            else {
+                toolName = 'get_fraim_file';
+                toolArgs = { path: registryPath };
+            }
+            console.log(chalk_1.default.gray(`   Using MCP tool: ${toolName}`));
+            // Make MCP JSON-RPC request
+            const mcpRequest = {
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'tools/call',
+                params: {
+                    name: toolName,
+                    arguments: toolArgs
+                }
+            };
+            const response = await axios_1.default.post(`${serverUrl}/mcp`, mcpRequest, {
                 headers,
                 timeout: 30000
             });
-            // Extract content from response
-            if (response.data.content) {
-                content = response.data.content;
+            // Extract content from MCP response
+            if (response.data.error) {
+                throw new Error(response.data.error.message || 'MCP request failed');
             }
-            else if (typeof response.data === 'string') {
-                content = response.data;
+            const result = response.data.result;
+            if (!result || !result.content || !Array.isArray(result.content)) {
+                throw new Error('Unexpected MCP response format');
             }
-            else {
-                throw new Error('Unexpected response format');
+            // Extract text content from MCP response
+            const textContent = result.content.find((c) => c.type === 'text');
+            if (!textContent || !textContent.text) {
+                throw new Error('No text content in MCP response');
             }
-            console.log(chalk_1.default.green(`✅ Fetched ${content.length} bytes from remote`));
+            content = textContent.text;
+            console.log(chalk_1.default.green(`✅ Fetched ${content.length} bytes from ${serverType}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`❌ Failed to fetch content from remote: ${error.message}`));
-            console.log(chalk_1.default.gray('   Tip: Check your network connection and .fraim/config.json settings'));
+            console.log(chalk_1.default.red(`❌ Failed to fetch content from ${serverType}: ${error.message}`));
+            if (isLocal) {
+                console.log(chalk_1.default.gray(`   Tip: Make sure the FRAIM server is running locally (npm run start:fraim)`));
+            }
+            else {
+                console.log(chalk_1.default.gray(`   Tip: Check your API key and network connection`));
+                console.log(chalk_1.default.gray(`   Or use --local to fetch from a locally running server`));
+            }
             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.72",
+  "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"