fraim-framework 2.0.73 → 2.0.75

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

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const https_1 = __importDefault(require("https"));
+const http_1 = __importDefault(require("http"));
+/**
+ * fraim install - One-command installer with key or token
+ * Usage: fraim install --key=<key> | fraim install --token=<token> [--api-url=<url>]
+ *
+ * Convenience wrapper over fraim setup: installs fraim-framework globally, fetches key from
+ * token if needed (no copy-paste), then runs fraim setup --key. fraim setup alone requires
+ * the user to already have fraim installed and know their key.
+ */
+exports.installCommand = new commander_1.Command('install')
+    .description('Install FRAIM globally and configure with your key (use --key or --token from dashboard)')
+    .option('--key <key>', 'FRAIM API key (from dashboard)')
+    .option('--token <token>', 'Installer token (one-time, from dashboard download link)')
+    .option('--api-url <url>', 'API base URL for token fetch', process.env.FRAIM_API_URL || 'https://fraim.wellnessatwork.me')
+    .action(async (opts) => {
+    let key = opts.key;
+    const token = opts.token;
+    const apiUrl = (opts.apiUrl || '').replace(/\/$/, '') || 'https://fraim.wellnessatwork.me';
+    if (token && !key) {
+        console.log(chalk_1.default.blue('Fetching key from FRAIM...'));
+        try {
+            key = await fetchInstallerKey(token, apiUrl);
+            console.log(chalk_1.default.green('Key retrieved.\n'));
+        }
+        catch (err) {
+            console.error(chalk_1.default.red('Failed to fetch key:'), err.message);
+            console.error(chalk_1.default.gray('Token may be expired. Get a new link from the FRAIM site.'));
+            process.exit(1);
+        }
+    }
+    if (!key) {
+        console.error(chalk_1.default.red('Usage: fraim install --key=<your-key>'));
+        console.error(chalk_1.default.gray('   or: fraim install --token=<installer-token> [--api-url=<url>]'));
+        console.error(chalk_1.default.gray('\nGet your key at https://fraim.wellnessatwork.me (click Get Started)'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.blue('Installing fraim-framework...'));
+    const installResult = (0, child_process_1.spawnSync)('npm', ['install', '-g', 'fraim-framework'], {
+        stdio: 'inherit',
+        shell: true
+    });
+    if (installResult.status !== 0)
+        process.exit(installResult.status || 1);
+    console.log(chalk_1.default.blue('\nConfiguring FRAIM with your key...'));
+    const setupResult = (0, child_process_1.spawnSync)('fraim', ['setup', '--key', key], {
+        stdio: 'inherit',
+        shell: true
+    });
+    if (setupResult.status !== 0)
+        process.exit(setupResult.status || 1);
+    console.log(chalk_1.default.green('\n✅ FRAIM is ready. Run "fraim init-project" in your project directory.'));
+});
+function fetchInstallerKey(token, apiUrl) {
+    return new Promise((resolve, reject) => {
+        const url = new URL(`${apiUrl}/api/installer-key`);
+        url.searchParams.set('token', token);
+        const lib = url.protocol === 'https:' ? https_1.default : http_1.default;
+        const req = lib.get(url.toString(), (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(data);
+                    if (json.key)
+                        resolve(json.key);
+                    else
+                        reject(new Error(json.error || 'No key in response'));
+                }
+                catch {
+                    reject(new Error(`Invalid response: ${data}`));
+                }
+            });
+        });
+        req.on('error', reject);
+    });
+}

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

@@ -88,7 +88,7 @@ const runSync = async (options) => {
             skipUpdates: true
         });
         if (result.success) {
-            console.log(chalk_1.default.green(`✅ Successfully synced ${result.workflowsSynced} workflows and ${result.scriptsSynced} scripts from local server`));
+            console.log(chalk_1.default.green(`✅ Successfully synced ${result.workflowsSynced} workflows, ${result.scriptsSynced} scripts, and ${result.coachingSynced} coaching files from local server`));
             return;
         }
         console.error(chalk_1.default.red(`❌ Local sync failed: ${result.error}`));
@@ -113,9 +113,13 @@ 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`));
+    console.log(chalk_1.default.green(`✅ Successfully synced ${result.workflowsSynced} workflows, ${result.scriptsSynced} scripts, and ${result.coachingSynced} coaching files from remote`));
     // Update version in config.json
     const configPath = path_1.default.join(fraimDir, 'config.json');
     if (fs_1.default.existsSync(configPath)) {

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

@@ -14,6 +14,7 @@ const test_mcp_1 = require("./commands/test-mcp");
 const add_ide_1 = require("./commands/add-ide");
 const override_1 = require("./commands/override");
 const list_overridable_1 = require("./commands/list-overridable");
+const install_1 = require("./commands/install");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const program = new commander_1.Command();
@@ -50,4 +51,5 @@ program.addCommand(test_mcp_1.testMCPCommand);
 program.addCommand(add_ide_1.addIDECommand);
 program.addCommand(override_1.overrideCommand);
 program.addCommand(list_overridable_1.listOverridableCommand);
+program.addCommand(install_1.installCommand);
 program.parse(process.argv);

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/dist/src/cli/utils/remote-sync.js

@@ -28,6 +28,7 @@ async function syncFromRemote(options) {
             success: false,
             workflowsSynced: 0,
             scriptsSynced: 0,
+            coachingSynced: 0,
             error: 'FRAIM_API_KEY not set'
         };
     }
@@ -48,6 +49,7 @@ async function syncFromRemote(options) {
                 success: false,
                 workflowsSynced: 0,
                 scriptsSynced: 0,
+                coachingSynced: 0,
                 error: 'No files received'
             };
         }
@@ -88,11 +90,28 @@ async function syncFromRemote(options) {
             (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
             console.log(chalk_1.default.gray(`  + ${file.path}`));
         }
-        console.log(chalk_1.default.green(`\n✅ Synced ${workflowFiles.length} workflows and ${scriptFiles.length} scripts from remote`));
+        // Sync coaching files to .fraim/coaching-moments/
+        const coachingFiles = files.filter(f => f.type === 'coaching');
+        const coachingDir = (0, path_1.join)(options.projectRoot, '.fraim', 'coaching-moments');
+        if (!(0, fs_1.existsSync)(coachingDir)) {
+            (0, fs_1.mkdirSync)(coachingDir, { recursive: true });
+        }
+        cleanDirectory(coachingDir);
+        for (const file of coachingFiles) {
+            const filePath = (0, path_1.join)(coachingDir, file.path);
+            const fileDir = (0, path_1.dirname)(filePath);
+            if (!(0, fs_1.existsSync)(fileDir)) {
+                (0, fs_1.mkdirSync)(fileDir, { recursive: true });
+            }
+            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
+            console.log(chalk_1.default.gray(`  + coaching-moments/${file.path}`));
+        }
+        console.log(chalk_1.default.green(`\n✅ Synced ${workflowFiles.length} workflows, ${scriptFiles.length} scripts, and ${coachingFiles.length} coaching files from remote`));
         return {
             success: true,
             workflowsSynced: workflowFiles.length,
-            scriptsSynced: scriptFiles.length
+            scriptsSynced: scriptFiles.length,
+            coachingSynced: coachingFiles.length
         };
     }
     catch (error) {
@@ -101,6 +120,7 @@ async function syncFromRemote(options) {
             success: false,
             workflowsSynced: 0,
             scriptsSynced: 0,
+            coachingSynced: 0,
             error: error.message
         };
     }

package/dist/src/core/utils/include-resolver.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Resolve {{include:path}} directives in registry content.
+ *
+ * Used by: MCP service (get_fraim_file, get_fraim_workflow), AI Mentor (phase instructions),
+ * and any other server-side content that needs includes resolved.
+ *
+ * - Resolves recursively (e.g. skills can include other skills)
+ * - MAX_PASSES prevents infinite loops from circular includes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_INCLUDE_PASSES = void 0;
+exports.resolveIncludesWithIndex = resolveIncludesWithIndex;
+const fs_1 = require("fs");
+/** Maximum resolution passes to prevent infinite loops from circular includes */
+exports.MAX_INCLUDE_PASSES = 10;
+/**
+ * Resolve {{include:path}} directives in content.
+ * Looks up referenced files in the fileIndex and inlines their content.
+ *
+ * @param content - Raw content that may contain {{include:path}} directives
+ * @param fileIndex - Map of path -> { fullPath, ... } for registry files
+ * @returns Content with all resolvable includes inlined (recursive, up to MAX_PASSES)
+ */
+function resolveIncludesWithIndex(content, fileIndex) {
+    let result = content;
+    let pass = 0;
+    while (result.includes('{{include:') && pass < exports.MAX_INCLUDE_PASSES) {
+        result = result.replace(/\{\{include:([^}]+)\}\}/g, (match, filePath) => {
+            const trimmedPath = filePath.trim();
+            const fileEntry = fileIndex.get(trimmedPath);
+            if (fileEntry?.fullPath) {
+                try {
+                    return (0, fs_1.readFileSync)(fileEntry.fullPath, 'utf-8');
+                }
+                catch (error) {
+                    console.error(`❌ Failed to read included file: ${trimmedPath}`, error);
+                    return match;
+                }
+            }
+            console.warn(`⚠️ Include file not found in fileIndex: ${trimmedPath}`);
+            return match;
+        });
+        pass++;
+    }
+    return result;
+}

package/index.js

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

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.73",
+  "version": "2.0.75",
   "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": {
     "fraim": "./index.js",
+    "fraim-framework": "./index.js",
     "fraim-mcp": "./bin/fraim-mcp.js"
   },
   "scripts": {
@@ -24,11 +25,12 @@
     "postinstall": "fraim sync --skip-updates || echo 'FRAIM setup skipped.'",
     "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",
-    "validate:registry": "tsx scripts/verify-registry-paths.ts && npm run validate:workflows && npm run validate:platform-agnostic",
+    "test-smoke-ci": "tsx --test tests/test-genericization.ts tests/test-cli.ts tests/test-stub-registry.ts tests/test-include-resolver.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:skills && npm run validate:platform-agnostic",
     "validate:workflows": "tsx scripts/validate-workflows.ts",
-    "validate:platform-agnostic": "tsx scripts/validate-platform-agnostic.ts"
+    "validate:platform-agnostic": "tsx scripts/validate-platform-agnostic.ts",
+    "validate:skills": "tsx scripts/validate-skills.ts"
   },
   "repository": {
     "type": "git",
@@ -70,6 +72,7 @@
     "html-to-docx": "^1.8.0",
     "markdown-it": "^14.1.0",
     "markdown-it-highlightjs": "^4.2.0",
+    "playwright": "^1.58.2",
     "pptxgenjs": "^4.0.1",
     "puppeteer": "^24.36.1",
     "qrcode": "^1.5.4",
@@ -96,11 +99,11 @@
     "axios": "^1.7.0",
     "chalk": "4.1.2",
     "commander": "^14.0.2",
+    "cors": "^2.8.5",
     "dotenv": "^16.4.7",
-    "prompts": "^2.4.2",
-    "tree-kill": "^1.2.2",
     "express": "^5.2.1",
-    "cors": "^2.8.5",
-    "mongodb": "^7.0.0"
+    "mongodb": "^7.0.0",
+    "prompts": "^2.4.2",
+    "tree-kill": "^1.2.2"
   }
 }