fraim 2.0.164 → 2.0.166

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/first-run.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -9,7 +42,6 @@ const chalk_1 = __importDefault(require("chalk"));
 const child_process_1 = require("child_process");
 const server_1 = require("../../first-run/server");
 const session_service_1 = require("../../first-run/session-service");
-const server_2 = require("../../ai-hub/server");
 function openBrowser(url) {
     try {
         if (process.platform === 'win32') {
@@ -45,7 +77,10 @@ const runFirstRun = async (options) => {
         projectRoot: options.projectRoot,
     });
     const server = new server_1.FirstRunServer({ sessionService });
-    const port = await (0, server_2.findAvailablePort)(43120);
+    // Lazy import: ai-hub/server pulls server-only code not shipped in the client
+    // package; keep it out of the CLI startup graph so the packed client loads (#422).
+    const { findAvailablePort } = await Promise.resolve().then(() => __importStar(require('../../ai-hub/server')));
+    const port = await findAvailablePort(43120);
     const url = `http://127.0.0.1:${port}/first-run/`;
     await server.start(port);
     console.log(chalk_1.default.blue('Starting FRAIM first-run...'));

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

@@ -1,11 +1,46 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hubCommand = void 0;
 const commander_1 = require("commander");
-const server_1 = require("../../ai-hub/server");
+// ai-hub/server pulls in server-only code (persona-hiring etc.) that is not
+// shipped in the client package; it is imported lazily inside the action below
+// to keep it out of the CLI startup graph so the packed client loads (issue #422).
 const git_utils_1 = require("../../core/utils/git-utils");
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
@@ -69,13 +104,14 @@ exports.hubCommand = new commander_1.Command('hub')
     .option('--no-open', 'Do not open the hub after startup')
     .option('--browser', 'Open in the default browser instead of the desktop shell')
     .action(async (options) => {
+    const { AiHubServer, findAvailablePort } = await Promise.resolve().then(() => __importStar(require('../../ai-hub/server')));
     const preferredPort = options.port || (0, git_utils_1.getPort)() + 100;
     const projectPath = path_1.default.resolve(options.projectPath || process.cwd());
     if (options.open) {
         const openedDesktop = !options.browser && openDesktopWindow(projectPath, preferredPort);
         if (!openedDesktop) {
-            const port = await (0, server_1.findAvailablePort)(preferredPort);
-            const server = new server_1.AiHubServer({ projectPath });
+            const port = await findAvailablePort(preferredPort);
+            const server = new AiHubServer({ projectPath });
             await server.start(port);
             const url = `http://127.0.0.1:${port}/ai-hub/`;
             console.log(`AI Hub running at ${url}`);
@@ -87,8 +123,8 @@ exports.hubCommand = new commander_1.Command('hub')
         console.log(`Project path: ${projectPath}`);
         return;
     }
-    const port = await (0, server_1.findAvailablePort)(preferredPort);
-    const server = new server_1.AiHubServer({ projectPath });
+    const port = await findAvailablePort(preferredPort);
+    const server = new AiHubServer({ projectPath });
     await server.start(port);
     const url = `http://127.0.0.1:${port}/ai-hub/`;
     console.log(`AI Hub running at ${url}`);

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

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orgCommand = void 0;
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const org_publish_1 = require("../utils/org-publish");
+exports.orgCommand = new commander_1.Command('org')
+    .description('Manage your shared organization context');
+exports.orgCommand
+    .command('publish')
+    .description('Publish org context/rules/learnings files to the configured org backend')
+    .argument('<files...>', 'Local files to publish: org_context.md, org_rules.md, and/or org-*.md learnings')
+    .action(async (files) => {
+    try {
+        const artifacts = files.map((f) => {
+            if (!fs_1.default.existsSync(f))
+                throw new Error(`File not found: ${f}`);
+            return { relativePath: (0, org_publish_1.packRelativePathFor)(f), content: fs_1.default.readFileSync(f, 'utf8') };
+        });
+        const result = await (0, org_publish_1.publishOrgArtifacts)(artifacts);
+        if (result.backend === 'fraim-cloud') {
+            console.log(chalk_1.default.green(`Published ${artifacts.length} org artifact(s) to your FRAIM organization (version ${result.version}).`));
+            console.log(chalk_1.default.gray('Run "fraim sync" on each machine to pull the update.'));
+        }
+        else {
+            console.log(chalk_1.default.green(`Pushed ${artifacts.length} org artifact(s) to branch "${result.branch}" in your organization repo.`));
+            if (result.prUrl)
+                console.log(chalk_1.default.cyan(`Open the pull request: ${result.prUrl}`));
+            console.log(chalk_1.default.gray('After it merges, run "fraim sync" to pull the update.'));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`org publish failed: ${error.message}`));
+        process.exit(1);
+    }
+});

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

@@ -0,0 +1,171 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testMCPCommand = exports.runTestMCP = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ide_detector_1 = require("../setup/ide-detector");
+const script_sync_utils_1 = require("../utils/script-sync-utils");
+const testIDEConfig = async (ide) => {
+    const result = {
+        ide: ide.name,
+        configExists: false,
+        configValid: false,
+        mcpServers: [],
+        errors: []
+    };
+    const configPath = (0, ide_detector_1.expandPath)(ide.configPath);
+    if (!fs_1.default.existsSync(configPath)) {
+        result.errors.push('Config file does not exist');
+        return result;
+    }
+    result.configExists = true;
+    try {
+        if (ide.configFormat === 'json') {
+            const configContent = fs_1.default.readFileSync(configPath, 'utf8');
+            const config = JSON.parse(configContent);
+            const servers = ide.configType === 'vscode' ? config.servers : config.mcpServers;
+            if (servers) {
+                result.configValid = true;
+                result.mcpServers = Object.keys(servers);
+            }
+            else {
+                const expectedKey = ide.configType === 'vscode' ? 'servers' : 'mcpServers';
+                result.errors.push(`No ${expectedKey} section found`);
+            }
+        }
+        else if (ide.configFormat === 'toml') {
+            const configContent = fs_1.default.readFileSync(configPath, 'utf8');
+            // Simple TOML parsing for MCP servers
+            const serverMatches = configContent.match(/\[mcp_servers\.(\w+)\]/g);
+            if (serverMatches) {
+                result.configValid = true;
+                result.mcpServers = serverMatches.map(match => match.replace(/\[mcp_servers\.(\w+)\]/, '$1'));
+            }
+            else {
+                result.errors.push('No mcp_servers sections found');
+            }
+        }
+    }
+    catch (error) {
+        result.errors.push(`Failed to parse config: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    return result;
+};
+const checkGlobalSetup = () => {
+    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
+    return fs_1.default.existsSync(globalConfigPath);
+};
+const runTestMCP = async () => {
+    console.log(chalk_1.default.blue('🔍 Testing MCP configuration...\n'));
+    // Check global setup
+    if (!checkGlobalSetup()) {
+        console.log(chalk_1.default.red('❌ Global FRAIM setup not found.'));
+        console.log(chalk_1.default.yellow('Please run: fraim setup --key=<your-fraim-key>'));
+        return;
+    }
+    console.log(chalk_1.default.green('✅ Global FRAIM setup found'));
+    // Detect IDEs
+    const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
+    if (detectedIDEs.length === 0) {
+        console.log(chalk_1.default.yellow('⚠️ No supported IDEs detected.'));
+        return;
+    }
+    console.log(chalk_1.default.blue(`\n🔍 Testing ${detectedIDEs.length} detected IDEs...\n`));
+    const results = await Promise.all(detectedIDEs.map(ide => testIDEConfig(ide)));
+    let totalConfigured = 0;
+    let totalWithFRAIM = 0;
+    for (const result of results) {
+        console.log(chalk_1.default.white(`📱 ${result.ide}`));
+        if (!result.configExists) {
+            console.log(chalk_1.default.red('   ❌ No MCP config found'));
+            console.log(chalk_1.default.gray(`   💡 Run: fraim setup --ide=${result.ide.toLowerCase()}`));
+        }
+        else if (!result.configValid) {
+            console.log(chalk_1.default.yellow('   ⚠️ Config exists but invalid'));
+            result.errors.forEach(error => {
+                console.log(chalk_1.default.red(`   ❌ ${error}`));
+            });
+        }
+        else {
+            totalConfigured++;
+            console.log(chalk_1.default.green(`   ✅ MCP config valid (${result.mcpServers.length} servers)`));
+            // Check for essential servers
+            const { BASE_MCP_SERVERS } = await Promise.resolve().then(() => __importStar(require('../mcp/mcp-server-registry')));
+            const essentialServers = BASE_MCP_SERVERS.map(s => s.id); // fraim, git, playwright
+            const hasEssential = essentialServers.filter(server => result.mcpServers.includes(server));
+            if (hasEssential.includes('fraim')) {
+                totalWithFRAIM++;
+                console.log(chalk_1.default.green('   ✅ FRAIM server configured'));
+            }
+            else {
+                console.log(chalk_1.default.yellow('   ⚠️ FRAIM server missing'));
+            }
+            if (hasEssential.length > 1) {
+                console.log(chalk_1.default.green(`   ✅ ${hasEssential.length - 1} additional servers: ${hasEssential.filter(s => s !== 'fraim').join(', ')}`));
+            }
+            const missingEssential = essentialServers.filter(server => !result.mcpServers.includes(server));
+            if (missingEssential.length > 0) {
+                console.log(chalk_1.default.yellow(`   ⚠️ Missing servers: ${missingEssential.join(', ')}`));
+            }
+        }
+        console.log(); // Empty line
+    }
+    // Summary
+    console.log(chalk_1.default.blue('📊 Summary:'));
+    console.log(chalk_1.default.green(`   ✅ ${totalConfigured}/${detectedIDEs.length} IDEs have valid MCP configs`));
+    console.log(chalk_1.default.green(`   ✅ ${totalWithFRAIM}/${detectedIDEs.length} IDEs have FRAIM configured`));
+    if (totalWithFRAIM === 0) {
+        console.log(chalk_1.default.red('\n❌ No IDEs have FRAIM configured!'));
+        console.log(chalk_1.default.yellow('💡 Run: fraim setup --key=<your-fraim-key>'));
+    }
+    else if (totalWithFRAIM < detectedIDEs.length) {
+        console.log(chalk_1.default.yellow(`\n⚠️ ${detectedIDEs.length - totalWithFRAIM} IDEs missing FRAIM configuration`));
+        console.log(chalk_1.default.yellow('💡 Run: fraim setup to configure remaining IDEs'));
+    }
+    else {
+        console.log(chalk_1.default.green('\n🎉 All detected IDEs have FRAIM configured!'));
+        console.log(chalk_1.default.blue('💡 Try running: fraim init-project in any project'));
+    }
+};
+exports.runTestMCP = runTestMCP;
+exports.testMCPCommand = new commander_1.Command('test-mcp')
+    .description('Test MCP server configurations for all detected IDEs')
+    .action(exports.runTestMCP);

package/dist/src/cli/fraim.js

@@ -53,6 +53,7 @@ const migrate_project_fraim_1 = require("./commands/migrate-project-fraim");
 const hub_1 = require("./commands/hub");
 const first_run_1 = require("./commands/first-run");
 const workspace_config_1 = require("./commands/workspace-config");
+const org_1 = require("./commands/org");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const program = new commander_1.Command();
@@ -95,6 +96,7 @@ program.addCommand(migrate_project_fraim_1.migrateProjectFraimCommand);
 program.addCommand(hub_1.hubCommand);
 program.addCommand(first_run_1.firstRunCommand);
 program.addCommand(workspace_config_1.workspaceConfigCommand);
+program.addCommand(org_1.orgCommand);
 // Wait for async command initialization before parsing
 (async () => {
     // Import the initialization promise from setup command