fraim 2.0.159 → 2.0.160

package/dist/src/ai-hub/word-sideload.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Sideloads the Word add-in manifest so it appears in Word's Developer Add-ins
+ * list without admin rights or AppSource publishing.
+ *
+ * Windows: writes a registry value under HKCU\SOFTWARE\Microsoft\Office\16.0\WEF\Developer
+ * macOS:   writes an entry to ~/Library/Containers/com.microsoft.Word/Data/Documents/wef/
+ *
+ * Both paths are non-admin and survive app updates (keyed by manifest GUID).
+ * Safe to call multiple times — checks before writing.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSideloaded = isSideloaded;
+exports.sideloadManifest = sideloadManifest;
+exports.removeSideload = removeSideload;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
+const MANIFEST_GUID = 'd1090951-50cf-4cf2-9d12-b0f8541d265c';
+function resolveManifestPath(projectPath) {
+    const candidates = [
+        path_1.default.resolve(projectPath, 'extensions/office-word/manifest.xml'),
+        path_1.default.resolve(__dirname, '..', '..', 'extensions/office-word/manifest.xml'),
+        path_1.default.resolve(__dirname, '..', '..', '..', 'extensions/office-word/manifest.xml'),
+    ];
+    return candidates.find(c => fs_1.default.existsSync(c)) ?? null;
+}
+function isSideloaded() {
+    if (process.platform === 'win32') {
+        const result = (0, child_process_1.spawnSync)('reg', [
+            'query',
+            `HKCU\\SOFTWARE\\Microsoft\\Office\\16.0\\WEF\\Developer`,
+            '/v', MANIFEST_GUID,
+        ], { encoding: 'utf8' });
+        return result.status === 0 && result.stdout.includes(MANIFEST_GUID);
+    }
+    if (process.platform === 'darwin') {
+        const wefDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', 'com.microsoft.Word', 'Data', 'Documents', 'wef');
+        return fs_1.default.existsSync(path_1.default.join(wefDir, `${MANIFEST_GUID}.xml`));
+    }
+    return false;
+}
+function sideloadManifest(projectPath) {
+    const manifestPath = resolveManifestPath(projectPath);
+    if (!manifestPath) {
+        return { ok: false, reason: 'Manifest file not found — is extensions/office-word/ present?' };
+    }
+    if (process.platform === 'win32') {
+        const result = (0, child_process_1.spawnSync)('reg', [
+            'add',
+            `HKCU\\SOFTWARE\\Microsoft\\Office\\16.0\\WEF\\Developer`,
+            '/v', MANIFEST_GUID,
+            '/t', 'REG_SZ',
+            '/d', manifestPath,
+            '/f',
+        ], { encoding: 'utf8' });
+        if (result.status !== 0) {
+            return { ok: false, reason: result.stderr || 'reg add failed' };
+        }
+        return { ok: true };
+    }
+    if (process.platform === 'darwin') {
+        const wefDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', 'com.microsoft.Word', 'Data', 'Documents', 'wef');
+        try {
+            fs_1.default.mkdirSync(wefDir, { recursive: true });
+            fs_1.default.copyFileSync(manifestPath, path_1.default.join(wefDir, `${MANIFEST_GUID}.xml`));
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, reason: String(err) };
+        }
+    }
+    return { ok: false, reason: `Unsupported platform: ${process.platform}` };
+}
+function removeSideload() {
+    if (process.platform === 'win32') {
+        (0, child_process_1.spawnSync)('reg', [
+            'delete',
+            `HKCU\\SOFTWARE\\Microsoft\\Office\\16.0\\WEF\\Developer`,
+            '/v', MANIFEST_GUID,
+            '/f',
+        ], { encoding: 'utf8' });
+        return;
+    }
+    if (process.platform === 'darwin') {
+        const wefDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', 'com.microsoft.Word', 'Data', 'Documents', 'wef');
+        const target = path_1.default.join(wefDir, `${MANIFEST_GUID}.xml`);
+        if (fs_1.default.existsSync(target))
+            fs_1.default.unlinkSync(target);
+    }
+}

package/dist/src/cli/commands/add-ide.js

@@ -218,12 +218,18 @@ const configureIDEMCP = async (ide, fraimKey, tokens, providerConfigs) => {
         // Merge MCP servers intelligently
         const mergedMCPServers = { ...existingMCPServers };
         const addedServers = [];
+        const updatedServers = [];
         const skippedServers = [];
+        const alwaysUpdateServers = new Set(['fraim', 'github', 'gitlab', 'jira', 'ado', 'linear']);
         for (const [serverName, serverConfig] of Object.entries(newMCPServers)) {
             if (!existingMCPServers[serverName]) {
                 mergedMCPServers[serverName] = serverConfig;
                 addedServers.push(serverName);
             }
+            else if (alwaysUpdateServers.has(serverName)) {
+                mergedMCPServers[serverName] = serverConfig;
+                updatedServers.push(serverName);
+            }
             else {
                 skippedServers.push(serverName);
             }
@@ -239,6 +245,9 @@ const configureIDEMCP = async (ide, fraimKey, tokens, providerConfigs) => {
         addedServers.forEach(server => {
             console.log(chalk_1.default.green(`  ✅ Added ${server} MCP server`));
         });
+        updatedServers.forEach(server => {
+            console.log(chalk_1.default.blue(`  Updated ${server} MCP server`));
+        });
         skippedServers.forEach(server => {
             console.log(chalk_1.default.gray(`  ⏭️ Skipped ${server} (already exists)`));
         });

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

@@ -11,7 +11,6 @@ const provider_client_1 = require("../api/provider-client");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const version_utils_1 = require("../utils/version-utils");
 const auto_mcp_setup_1 = require("../setup/auto-mcp-setup");
 exports.loginCommand = new commander_1.Command('login')
     .description('Login to platforms (GitHub, etc.)');
@@ -51,7 +50,7 @@ exports.loginCommand
             ...(config.tokens || {}),
             github: token
         };
-        config.version = config.version || (0, version_utils_1.getFraimVersion)();
+        delete config.version;
         config.updatedAt = new Date().toISOString();
         fs_1.default.writeFileSync(globalConfigPath, JSON.stringify(config, null, 2));
         console.log(chalk_1.default.green('\n✅ GitHub token saved to global configuration.'));

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

@@ -44,7 +44,6 @@ const prompts_1 = __importDefault(require("prompts"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const auto_mcp_setup_1 = require("../setup/auto-mcp-setup");
-const version_utils_1 = require("../utils/version-utils");
 const provider_client_1 = require("../api/provider-client");
 const provider_prompts_1 = require("../setup/provider-prompts");
 const provider_registry_1 = require("../providers/provider-registry");
@@ -225,7 +224,6 @@ const saveGlobalConfig = (fraimKey, mode, tokens, configs) => {
         };
     });
     const config = {
-        version: (0, version_utils_1.getFraimVersion)(),
         apiKey: fraimKey,
         mode: mode,
         tokens: {

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

@@ -84,22 +84,30 @@ function loadUserApiKey() {
         return undefined;
     }
 }
-function updateVersionInConfig(fraimDir) {
+function writeSyncMetadata(fraimDir, mode, remoteUrl) {
+    fs_1.default.mkdirSync(fraimDir, { recursive: true });
+    fs_1.default.writeFileSync(path_1.default.join(fraimDir, '.sync-metadata.json'), JSON.stringify({
+        localVersion: (0, version_utils_1.getFraimVersion)(),
+        mode,
+        remoteUrl,
+        syncedAt: new Date().toISOString()
+    }, null, 2), 'utf8');
+}
+function removeLegacyVersionFromConfig(fraimDir) {
     const configPath = path_1.default.join(fraimDir, 'config.json');
     if (!fs_1.default.existsSync(configPath)) {
         return;
     }
     try {
         const currentConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-        const newVersion = (0, version_utils_1.getFraimVersion)();
-        if (currentConfig.version !== newVersion) {
-            currentConfig.version = newVersion;
+        if (Object.prototype.hasOwnProperty.call(currentConfig, 'version')) {
+            delete currentConfig.version;
             fs_1.default.writeFileSync(configPath, JSON.stringify(currentConfig, null, 2));
-            console.log(chalk_1.default.green(`Updated FRAIM version to ${newVersion} in config.`));
+            console.log(chalk_1.default.green('Removed legacy config.version from config.json.'));
         }
     }
     catch {
-        console.warn(chalk_1.default.yellow('Could not update version in config.json.'));
+        console.warn(chalk_1.default.yellow('Could not remove legacy version from config.json.'));
     }
 }
 function failSync(mode, message) {
@@ -141,7 +149,7 @@ const runSync = async (options) => {
     if (isGlobal && !options.skipUpdates) {
         console.log(chalk_1.default.yellow('You are running a global installation of FRAIM.'));
         console.log(chalk_1.default.gray('Updates are not automatic in this mode.'));
-        console.log(chalk_1.default.cyan('Recommended: Use "npx fraim-framework@latest sync" instead.\n'));
+        console.log(chalk_1.default.cyan('Recommended: Use "npx fraim@latest sync" instead.\n'));
     }
     const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../utils/remote-sync')));
     // Allow `FRAIM_LOCAL_SYNC=1` to flip into local-mode without needing
@@ -163,7 +171,8 @@ const runSync = async (options) => {
         });
         if (result.success) {
             console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from local server`));
-            updateVersionInConfig(fraimDir);
+            removeLegacyVersionFromConfig(fraimDir);
+            writeSyncMetadata(fraimDir, 'local', localUrl);
             refreshLocalIgnoreConfig();
             const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
             if (adapterUpdates.length > 0) {
@@ -210,13 +219,13 @@ const runSync = async (options) => {
         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).'));
-            updateVersionInConfig(fraimDir);
             return;
         }
         failSync(failHard, `Remote sync failed: ${result.error}`);
     }
     console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from remote`));
-    updateVersionInConfig(fraimDir);
+    removeLegacyVersionFromConfig(fraimDir);
+    writeSyncMetadata(fraimDir, 'remote', config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
     refreshLocalIgnoreConfig();
     if (config.repository?.provider === 'github' && (0, github_workflow_sync_1.isGitHubWorkflowAutomationEnabled)(config)) {
         const workflowBundle = await (0, github_workflow_sync_1.fetchGitHubWorkflowBundle)({

package/dist/src/cli/doctor/checks/mcp-connectivity-checks.js

@@ -41,13 +41,66 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNpmMajorVersion = getNpmMajorVersion;
+exports.diagnoseFraimMcpLaunchPlan = diagnoseFraimMcpLaunchPlan;
 exports.getMCPConnectivityChecks = getMCPConnectivityChecks;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
 const axios_1 = __importDefault(require("axios"));
 const toml = __importStar(require("toml"));
 const ide_detector_1 = require("../../setup/ide-detector");
+const fraim_mcp_latest_launcher_1 = require("../../mcp/fraim-mcp-latest-launcher");
+function getNpmMajorVersion() {
+    try {
+        const command = process.platform === 'win32' ? (process.env.ComSpec || 'cmd.exe') : 'npm';
+        const args = process.platform === 'win32' ? ['/d', '/s', '/c', 'npm --version'] : ['--version'];
+        const output = (0, child_process_1.execFileSync)(command, args, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore']
+        });
+        const major = Number.parseInt(output.trim().split('.')[0], 10);
+        return Number.isFinite(major) ? major : null;
+    }
+    catch {
+        return null;
+    }
+}
+function diagnoseFraimMcpLaunchPlan(fraimServer, platform = process.platform, npmMajorVersion = getNpmMajorVersion()) {
+    const command = String(fraimServer?.command || '');
+    const args = Array.isArray(fraimServer?.args) ? fraimServer.args.map(String) : [];
+    const usesDirectLatest = command.toLowerCase().includes('npx')
+        && args.some((arg) => arg === 'fraim-framework@latest' || arg === 'fraim@latest');
+    if (usesDirectLatest) {
+        const isKnownBrokenWindowsNpm = platform === 'win32' && npmMajorVersion !== null && npmMajorVersion >= 11;
+        return {
+            status: isKnownBrokenWindowsNpm ? 'error' : 'warning',
+            message: isKnownBrokenWindowsNpm
+                ? 'FRAIM MCP config uses direct npx @latest, which is fragile on Windows npm 11'
+                : 'FRAIM MCP config uses direct npx @latest',
+            suggestion: 'Run: fraim add-ide to regenerate MCP config with the FRAIM latest launcher',
+            details: {
+                launchPlanSource: 'direct-npx-latest',
+                platform,
+                npmMajorVersion,
+                args
+            }
+        };
+    }
+    const launcherPath = (0, fraim_mcp_latest_launcher_1.getFraimMcpLatestLauncherPath)();
+    const usesLatestLauncher = command === process.execPath && args.length > 0 && path_1.default.resolve(args[0]) === path_1.default.resolve(launcherPath);
+    if (usesLatestLauncher) {
+        return {
+            status: 'passed',
+            message: 'FRAIM MCP config uses the latest launcher',
+            details: {
+                launchPlanSource: 'fraim-latest-launcher'
+            }
+        };
+    }
+    return null;
+}
 /**
  * Test FRAIM connectivity by calling fraim_connect
  */
@@ -325,6 +378,16 @@ async function validateIDEMCPConfig(ide) {
                 details: { configPath }
             };
         }
+        const launchPlanDiagnostic = diagnoseFraimMcpLaunchPlan(fraimServer);
+        if (launchPlanDiagnostic && launchPlanDiagnostic.status !== 'passed') {
+            return {
+                ...launchPlanDiagnostic,
+                details: {
+                    ...launchPlanDiagnostic.details,
+                    configPath
+                }
+            };
+        }
         // Check for auth header (for HTTP servers)
         if (fraimServer.url) {
             const hasAuth = fraimServer.headers?.Authorization || fraimServer.http_headers?.Authorization;
@@ -339,10 +402,11 @@ async function validateIDEMCPConfig(ide) {
         }
         return {
             status: 'passed',
-            message: `${ide.name} MCP config valid`,
+            message: launchPlanDiagnostic?.message || `${ide.name} MCP config valid`,
             details: {
                 configPath,
-                serverCount: Object.keys(servers).length
+                serverCount: Object.keys(servers).length,
+                ...(launchPlanDiagnostic?.details || {})
             }
         };
     }

package/dist/src/cli/doctor/checks/workflow-checks.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Job checks for FRAIM doctor command
- * Validates job installation and versions
+ * Validates job installation
  * Issue #144: Enhanced doctor command
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
@@ -100,69 +100,6 @@ function checkJobStubsPresent() {
         }
     };
 }
-/**
- * Check if jobs are up to date
- */
-function checkJobsUpToDate() {
-    return {
-        name: 'Jobs up to date',
-        category: 'jobs',
-        critical: false,
-        run: async () => {
-            const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
-            if (!fs_1.default.existsSync(configPath)) {
-                return {
-                    status: 'warning',
-                    message: 'Cannot check job version - config missing'
-                };
-            }
-            try {
-                const config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-                const possiblePaths = [
-                    path_1.default.join(__dirname, '../../../../package.json'),
-                    path_1.default.join(__dirname, '../../../package.json'),
-                    path_1.default.join(process.cwd(), 'package.json')
-                ];
-                let packageJson = null;
-                for (const pkgPath of possiblePaths) {
-                    if (fs_1.default.existsSync(pkgPath)) {
-                        packageJson = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf8'));
-                        break;
-                    }
-                }
-                if (!packageJson) {
-                    return {
-                        status: 'warning',
-                        message: 'Cannot determine package version'
-                    };
-                }
-                const currentVersion = packageJson.version;
-                const configVersion = config.version;
-                if (configVersion === currentVersion) {
-                    return {
-                        status: 'passed',
-                        message: `Jobs up to date (v${currentVersion})`,
-                        details: { version: currentVersion }
-                    };
-                }
-                return {
-                    status: 'warning',
-                    message: `Jobs outdated (v${configVersion} -> v${currentVersion})`,
-                    suggestion: 'Update local job stubs with fraim sync.',
-                    command: 'fraim sync',
-                    details: { configVersion, currentVersion }
-                };
-            }
-            catch (error) {
-                return {
-                    status: 'error',
-                    message: 'Failed to check job version',
-                    details: { error: error.message }
-                };
-            }
-        }
-    };
-}
 /**
  * Check if override syntax is valid
  */
@@ -245,7 +182,6 @@ function getJobChecks() {
     return [
         checkJobsDirectoryExists(),
         checkJobStubsPresent(),
-        checkJobsUpToDate(),
         checkOverrideSyntaxValid()
     ];
 }

package/dist/src/cli/mcp/fraim-mcp-latest-launcher.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFraimMcpLatestLauncherPath = getFraimMcpLatestLauncherPath;
+exports.ensureFraimMcpLatestLauncher = ensureFraimMcpLatestLauncher;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const LAUNCHER_VERSION = 1;
+const launcherSource = `#!/usr/bin/env node
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const LAUNCHER_VERSION = ${LAUNCHER_VERSION};
+const USER_DIR = process.env.FRAIM_USER_DIR || path.join(os.homedir(), '.fraim');
+const STATE_DIR = path.join(USER_DIR, 'mcp-launcher');
+const STATE_PATH = path.join(STATE_DIR, 'latest.json');
+const CACHE_ROOT = path.join(USER_DIR, 'npm-cache', 'mcp');
+
+const commandName = (name) => process.platform === 'win32' ? name + '.cmd' : name;
+const npmCommand = commandName('npm');
+const npxCommand = commandName('npx');
+const cliArgs = process.argv.slice(2).length > 0 ? process.argv.slice(2) : ['mcp'];
+
+function quoteCmdArg(arg) {
+  const value = String(arg);
+  return /[\\s"&|<>^]/.test(value) ? '"' + value.replace(/"/g, '""') + '"' : value;
+}
+
+function runCommand(command, args, options) {
+  if (process.platform !== 'win32') {
+    return spawnSync(command, args, options);
+  }
+
+  return spawnSync(process.env.ComSpec || 'cmd.exe', ['/d', '/s', '/c', [command, ...args.map(quoteCmdArg)].join(' ')], options);
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function readState() {
+  try {
+    return JSON.parse(fs.readFileSync(STATE_PATH, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeState(state) {
+  ensureDir(STATE_DIR);
+  fs.writeFileSync(STATE_PATH, JSON.stringify({ ...state, launcherVersion: LAUNCHER_VERSION, updatedAt: new Date().toISOString() }, null, 2));
+}
+
+function resolveLatest(packageName) {
+  const result = runCommand(npmCommand, ['view', packageName, 'version', '--silent'], {
+    encoding: 'utf8',
+    env: process.env
+  });
+
+  if (result.status !== 0) {
+    return null;
+  }
+
+  const version = String(result.stdout || '').trim();
+  return /^\\d+\\.\\d+\\.\\d+/.test(version) ? version : null;
+}
+
+function resolvePackage() {
+  const fraimVersion = resolveLatest('fraim');
+  if (fraimVersion) {
+    const state = { packageName: 'fraim', binName: 'fraim', version: fraimVersion, fromCache: false };
+    writeState(state);
+    return state;
+  }
+
+  const cached = readState();
+  if (cached && cached.packageName === 'fraim' && cached.binName === 'fraim' && cached.version) {
+    console.error('[fraim-mcp-launcher] Could not resolve npm latest; using cached fraim@' + cached.version + '.');
+    return { packageName: 'fraim', binName: 'fraim', version: cached.version, fromCache: true };
+  }
+
+  console.error('[fraim-mcp-launcher] Could not resolve fraim latest from npm and no cached fraim version exists.');
+  process.exit(1);
+}
+
+function runPackage(plan, cacheDir) {
+  ensureDir(cacheDir);
+  const env = { ...process.env, npm_config_cache: cacheDir };
+  const result = runCommand(npxCommand, ['--yes', '--package', plan.packageName + '@' + plan.version, plan.binName, ...cliArgs], {
+    stdio: 'inherit',
+    env
+  });
+  return typeof result.status === 'number' ? result.status : 1;
+}
+
+const plan = resolvePackage();
+const versionCacheDir = path.join(CACHE_ROOT, plan.packageName + '-' + plan.version.replace(/[^a-zA-Z0-9._-]/g, '_'));
+let status = runPackage(plan, versionCacheDir);
+
+if (status !== 0 && process.platform === 'win32') {
+  const retryCache = path.join(CACHE_ROOT, 'retry-' + Date.now() + '-' + process.pid);
+  console.error('[fraim-mcp-launcher] Package execution failed; retrying once with a fresh npm cache.');
+  status = runPackage(plan, retryCache);
+}
+
+process.exit(status);
+`;
+function getFraimMcpLatestLauncherPath() {
+    return path_1.default.join(process.env.FRAIM_USER_DIR || path_1.default.join(os_1.default.homedir(), '.fraim'), 'bin', 'fraim-mcp-latest.js');
+}
+function ensureFraimMcpLatestLauncher() {
+    const launcherPath = getFraimMcpLatestLauncherPath();
+    const launcherDir = path_1.default.dirname(launcherPath);
+    fs_1.default.mkdirSync(launcherDir, { recursive: true });
+    if (!fs_1.default.existsSync(launcherPath) || fs_1.default.readFileSync(launcherPath, 'utf8') !== launcherSource) {
+        fs_1.default.writeFileSync(launcherPath, launcherSource, 'utf8');
+        if (process.platform !== 'win32') {
+            try {
+                fs_1.default.chmodSync(launcherPath, 0o755);
+            }
+            catch {
+                // Best effort only. IDE configs invoke this through node, so chmod is not required.
+            }
+        }
+    }
+    return {
+        command: process.execPath,
+        args: [launcherPath],
+        path: launcherPath
+    };
+}

package/dist/src/cli/mcp/mcp-server-registry.js

@@ -10,6 +10,7 @@ exports.isHTTPServer = isHTTPServer;
 exports.buildAllBaseServers = buildAllBaseServers;
 const provider_registry_1 = require("../providers/provider-registry");
 const command_resolution_1 = require("./command-resolution");
+const fraim_mcp_latest_launcher_1 = require("./fraim-mcp-latest-launcher");
 exports.BASE_MCP_SERVERS = [
     {
         id: 'git',
@@ -33,16 +34,19 @@ exports.BASE_MCP_SERVERS = [
         id: 'fraim',
         name: 'FRAIM',
         description: 'FRAIM job orchestration and mentoring',
-        buildServer: (fraimKey) => ({
-            command: (0, command_resolution_1.resolveManagedCommand)('npx'),
-            args: ['-y', 'fraim-framework@latest', 'mcp'],
-            env: {
-                // Include API key for IDE configs (Codex, VSCode, etc.)
-                // The stdio-server will use this if set, otherwise falls back to ~/.fraim/config.json
-                FRAIM_API_KEY: fraimKey,
-                FRAIM_REMOTE_URL: 'https://fraim.wellnessatwork.me'
-            }
-        })
+        buildServer: (fraimKey) => {
+            const launcher = (0, fraim_mcp_latest_launcher_1.ensureFraimMcpLatestLauncher)();
+            return {
+                command: launcher.command,
+                args: launcher.args,
+                env: {
+                    // Include API key for IDE configs (Codex, VSCode, etc.)
+                    // The stdio-server will use this if set, otherwise falls back to ~/.fraim/config.json
+                    FRAIM_API_KEY: fraimKey,
+                    FRAIM_REMOTE_URL: 'https://fraim.wellnessatwork.me'
+                }
+            };
+        }
     }
 ];
 // ============================================================================

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

@@ -338,7 +338,7 @@ const autoConfigureMCP = async (fraimKey, tokenInput, selectedIDEs, providerConf
         console.log(chalk_1.default.blue('\n🎯 Next steps:'));
         console.log(chalk_1.default.cyan('   1. Restart your configured IDEs'));
         console.log(chalk_1.default.cyan('   2. Go to any project directory'));
-        console.log(chalk_1.default.cyan('   3. Run: npx fraim-framework@latest init-project'));
+        console.log(chalk_1.default.cyan('   3. Run: npx fraim@latest init-project'));
         console.log(chalk_1.default.cyan('   4. Tell your AI agent: "Onboard this project"'));
     }
 };

package/dist/src/cli/utils/fraim-gitignore.js

@@ -12,6 +12,7 @@ exports.FRAIM_SYNC_GITIGNORE_ENTRIES = [
     'fraim/ai-employee/',
     'fraim/ai-manager/',
     'fraim/docs/',
+    'fraim/.sync-metadata.json',
 ];
 const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 const managedBlockPattern = new RegExp(`\\n?${escapeRegExp(exports.FRAIM_SYNC_GITIGNORE_START)}[\\s\\S]*?${escapeRegExp(exports.FRAIM_SYNC_GITIGNORE_END)}\\n?`, 'm');
@@ -43,6 +44,16 @@ function resolveGitInfoExcludePath(projectRoot) {
     const gitDir = path_1.default.isAbsolute(match[1])
         ? match[1]
         : path_1.default.resolve(projectRoot, match[1]);
+    const commonDirPath = path_1.default.join(gitDir, 'commondir');
+    if (fs_1.default.existsSync(commonDirPath)) {
+        const commonDirRaw = fs_1.default.readFileSync(commonDirPath, 'utf8').trim();
+        if (commonDirRaw.length > 0) {
+            const commonDir = path_1.default.isAbsolute(commonDirRaw)
+                ? commonDirRaw
+                : path_1.default.resolve(gitDir, commonDirRaw);
+            return path_1.default.join(commonDir, 'info', 'exclude');
+        }
+    }
     return path_1.default.join(gitDir, 'info', 'exclude');
 }
 const removeFraimSyncedContentGitignoreBlock = (projectRoot) => {

package/dist/src/cli/utils/remote-sync.js

@@ -31,8 +31,8 @@ function shouldLockSyncedContent() {
 }
 function getSyncedContentLockTargets(projectRoot) {
     return fraim_gitignore_1.FRAIM_SYNC_GITIGNORE_ENTRIES
+        .filter((entry) => /[\\/]$/.test(entry))
         .map((entry) => entry.replace(/[\\/]+$/, ''))
-        .filter((entry) => entry.length > 0)
         .map((entry) => (0, path_1.join)(projectRoot, entry));
 }
 function setFileWriteLockRecursively(dirPath, readOnly) {

package/dist/src/core/config-loader.js

@@ -88,7 +88,6 @@ function normalizeAutomation(config) {
 function normalizeFraimConfig(config) {
     // Handle backward compatibility and migration
     const mergedConfig = {
-        version: config.version || types_1.DEFAULT_FRAIM_CONFIG.version,
         project: {
             ...types_1.DEFAULT_FRAIM_CONFIG.project,
             ...(config.project || {})
@@ -154,7 +153,7 @@ function loadFraimConfig(configPath = (0, project_fraim_paths_1.getWorkspaceConf
         const configContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
         const config = JSON.parse(configContent);
         const mergedConfig = normalizeFraimConfig(config);
-        console.log(`Loaded FRAIM config from ${displayPath} (version ${mergedConfig.version})`);
+        console.log(`Loaded FRAIM config from ${displayPath}`);
         if (config.git && !config.repository) {
             console.warn('Deprecated: "git" config detected. Consider migrating to "repository" config.');
         }