fraim 2.0.154 → 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/init-project.js

@@ -19,6 +19,8 @@ const fraim_gitignore_1 = require("../utils/fraim-gitignore");
 const agent_adapters_1 = require("../utils/agent-adapters");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 const project_bootstrap_1 = require("../utils/project-bootstrap");
+const config_loader_1 = require("../../core/config-loader");
+const github_workflow_sync_1 = require("../utils/github-workflow-sync");
 const checkGlobalSetup = () => {
     const fraimUserDir = process.env.FRAIM_USER_DIR || path_1.default.join(os_1.default.homedir(), '.fraim');
     const globalConfigPath = path_1.default.join(fraimUserDir, 'config.json');
@@ -63,7 +65,6 @@ const findProjectFile = (filename) => {
 exports.findProjectFile = findProjectFile;
 ;
 const installGitHubWorkflows = (projectRoot) => {
-    const workflowsDir = path_1.default.join(projectRoot, '.github', 'workflows');
     const registryDir = (0, exports.findProjectFile)('registry');
     const sourceDir = path_1.default.join(registryDir, 'github', 'workflows');
     if (!fs_1.default.existsSync(sourceDir)) {
@@ -73,21 +74,22 @@ const installGitHubWorkflows = (projectRoot) => {
         console.log(chalk_1.default.gray(`Process cwd: ${process.cwd()}`));
         return;
     }
-    if (!fs_1.default.existsSync(workflowsDir)) {
-        fs_1.default.mkdirSync(workflowsDir, { recursive: true });
+    const config = fs_1.default.existsSync((0, project_fraim_paths_1.getWorkspaceConfigPath)(projectRoot))
+        ? (0, config_loader_1.loadFraimConfig)((0, project_fraim_paths_1.getWorkspaceConfigPath)(projectRoot))
+        : null;
+    if (!(0, github_workflow_sync_1.isGitHubWorkflowAutomationEnabled)(config)) {
+        console.log(chalk_1.default.gray('GitHub workflow automation disabled or not configured; skipping managed workflow install.'));
+        return;
     }
-    const workflowFiles = ['phase-change.yml', 'status-change.yml', 'sync-on-pr-review.yml'];
-    workflowFiles.forEach((file) => {
-        const sourcePath = path_1.default.join(sourceDir, file);
-        const destPath = path_1.default.join(workflowsDir, file);
-        if (fs_1.default.existsSync(sourcePath)) {
-            fs_1.default.copyFileSync(sourcePath, destPath);
-            console.log(chalk_1.default.green(`Installed workflow: .github/workflows/${file}`));
-        }
-        else {
-            console.log(chalk_1.default.yellow(`Warning: Workflow not found in registry: ${file}`));
-        }
+    const bundle = (0, github_workflow_sync_1.loadLocalGitHubWorkflowBundle)(registryDir);
+    const result = (0, github_workflow_sync_1.reconcileGitHubWorkflowAssets)({
+        projectRoot,
+        files: bundle,
+        config
     });
+    for (const line of (0, github_workflow_sync_1.formatGitHubWorkflowSyncSummary)(result)) {
+        console.log(chalk_1.default.green(line));
+    }
 };
 const createGitHubLabels = (projectRoot) => {
     try {
@@ -137,6 +139,9 @@ function formatPlatformLabel(provider) {
             return provider.toUpperCase();
     }
 }
+function isMinimalConversationMode(mode) {
+    return mode === 'conversational';
+}
 const runInitProject = async (options = {}) => {
     console.log(chalk_1.default.blue('Initializing FRAIM project...'));
     const failHard = options.failHard ?? 'exit';
@@ -187,7 +192,9 @@ const runInitProject = async (options = {}) => {
         const detection = (0, platform_detection_1.detectPlatformFromGit)();
         if (detection.provider !== 'unknown' && detection.repository) {
             result.repositoryDetected = true;
-            result.projectName = detection.repository.name || projectName;
+            if (!isMinimalConversationMode(preferredMode)) {
+                result.projectName = detection.repository.name || projectName;
+            }
             const jiraConfig = globalSetup.providerConfigs?.jiraConfig;
             if (preferredMode === 'split' && globalSetup.tokens?.jira && jiraConfig?.baseUrl) {
                 result.issueTrackingDetected = true;
@@ -200,26 +207,31 @@ const runInitProject = async (options = {}) => {
                     result.mode = 'integrated';
                     result.warnings.push('Split mode is not fully configured for this repo yet, so issue tracking will fall back to the repository provider during onboarding.');
                 }
-                console.log(chalk_1.default.blue(`   Platform: ${formatPlatformLabel(detection.provider)}`));
-            }
-            const repo = detection.repository;
-            if (repo.owner && repo.name) {
-                console.log(chalk_1.default.gray(`   Repository: ${repo.owner}/${repo.name}`));
-            }
-            else if (repo.organization && repo.project && repo.name) {
-                console.log(chalk_1.default.gray(`   Organization: ${repo.organization}`));
-                console.log(chalk_1.default.gray(`   Project: ${repo.project}`));
-                console.log(chalk_1.default.gray(`   Repository: ${repo.name}`));
+                if (!isMinimalConversationMode(preferredMode)) {
+                    console.log(chalk_1.default.blue(`   Platform: ${formatPlatformLabel(detection.provider)}`));
+                }
             }
-            else if (repo.namespace && repo.name) {
-                console.log(chalk_1.default.gray(`   Namespace: ${repo.namespace || '(none)'}`));
-                console.log(chalk_1.default.gray(`   Repository: ${repo.name}`));
+            if (!isMinimalConversationMode(preferredMode)) {
+                const repo = detection.repository;
+                if (repo.owner && repo.name) {
+                    console.log(chalk_1.default.gray(`   Repository: ${repo.owner}/${repo.name}`));
+                }
+                else if (repo.organization && repo.project && repo.name) {
+                    console.log(chalk_1.default.gray(`   Organization: ${repo.organization}`));
+                    console.log(chalk_1.default.gray(`   Project: ${repo.project}`));
+                    console.log(chalk_1.default.gray(`   Repository: ${repo.name}`));
+                }
+                else if (repo.namespace && repo.name) {
+                    console.log(chalk_1.default.gray(`   Namespace: ${repo.namespace || '(none)'}`));
+                    console.log(chalk_1.default.gray(`   Repository: ${repo.name}`));
+                }
             }
         }
         else {
             result.mode = 'conversational';
-            result.warnings.push('No git remote detected. FRAIM fell back to conversational project setup.');
-            console.log(chalk_1.default.yellow('   No git remote detected. Falling back to conversational mode.'));
+            if (!isMinimalConversationMode(preferredMode)) {
+                console.log(chalk_1.default.yellow('   Starting conversational project setup.'));
+            }
         }
         result.warnings.push(`${configDisplayPath} was not created by init-project. The manager \`project-onboarding\` job is the only supported config-writing path.`);
     }
@@ -236,15 +248,15 @@ const runInitProject = async (options = {}) => {
         }
     });
     const ignoreUpdate = (0, fraim_gitignore_1.ensureFraimSyncedContentLocallyExcluded)(projectRoot);
-    if (ignoreUpdate.gitInfoExcludeUpdated) {
+    if (ignoreUpdate.gitInfoExcludeUpdated && !isMinimalConversationMode(result.mode)) {
         console.log(chalk_1.default.green('Updated .git/info/exclude FRAIM managed block'));
     }
-    if (ignoreUpdate.gitignoreUpdated) {
+    if (ignoreUpdate.gitignoreUpdated && !isMinimalConversationMode(result.mode)) {
         console.log(chalk_1.default.green('Removed legacy FRAIM sync block from .gitignore'));
     }
     const detection = (0, platform_detection_1.detectPlatformFromGit)();
-    if (detection.provider === 'github') {
-        console.log(chalk_1.default.blue('\nSetting up GitHub workflows and labels...'));
+    if (detection.provider === 'github' && !isMinimalConversationMode(result.mode)) {
+        console.log(chalk_1.default.blue('\nSetting up GitHub labels...'));
         installGitHubWorkflows(projectRoot);
         createGitHubLabels(projectRoot);
         result.repositoryDetected = true;

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

@@ -48,6 +48,7 @@ const git_utils_1 = require("../../core/utils/git-utils");
 const agent_adapters_1 = require("../utils/agent-adapters");
 const fraim_gitignore_1 = require("../utils/fraim-gitignore");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+const github_workflow_sync_1 = require("../utils/github-workflow-sync");
 function resolveExplicitLocalSyncUrl() {
     const candidates = [
         process.env.FRAIM_TEST_SERVER_URL,
@@ -83,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) {
@@ -124,7 +133,7 @@ const runSync = async (options) => {
         return;
     }
     const projectRoot = options.projectRoot ? path_1.default.resolve(options.projectRoot) : process.cwd();
-    const config = (0, config_loader_1.loadFraimConfig)();
+    const config = (0, config_loader_1.loadFraimConfig)((0, project_fraim_paths_1.getWorkspaceConfigPath)(projectRoot));
     const fraimDir = (0, project_fraim_paths_1.getWorkspaceFraimDir)(projectRoot);
     const refreshLocalIgnoreConfig = () => {
         const ignoreUpdate = (0, fraim_gitignore_1.ensureFraimSyncedContentLocallyExcluded)(projectRoot);
@@ -140,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
@@ -162,12 +171,23 @@ 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) {
                 console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
             }
+            if (config.repository?.provider === 'github' && (0, github_workflow_sync_1.isGitHubWorkflowAutomationEnabled)(config)) {
+                const workflowBundle = await (0, github_workflow_sync_1.fetchGitHubWorkflowBundle)({
+                    remoteUrl: localUrl,
+                    apiKey: 'local-dev'
+                });
+                const workflowResult = (0, github_workflow_sync_1.reconcileGitHubWorkflowAssets)({ projectRoot, files: workflowBundle, config });
+                for (const line of (0, github_workflow_sync_1.formatGitHubWorkflowSyncSummary)(workflowResult)) {
+                    console.log(chalk_1.default.green(line));
+                }
+            }
             return;
         }
         console.error(chalk_1.default.red(`Local sync failed: ${result.error}`));
@@ -199,14 +219,24 @@ 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)({
+            remoteUrl: config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me',
+            apiKey
+        });
+        const workflowResult = (0, github_workflow_sync_1.reconcileGitHubWorkflowAssets)({ projectRoot, files: workflowBundle, config });
+        for (const line of (0, github_workflow_sync_1.formatGitHubWorkflowSyncSummary)(workflowResult)) {
+            console.log(chalk_1.default.green(line));
+        }
+    }
     const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
     if (adapterUpdates.length > 0) {
         console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));

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()
     ];
 }