fraim 2.0.202 → 2.0.204

package/dist/src/ai-hub/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,95 +0,0 @@
-"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/hub.js

@@ -1,238 +0,0 @@
-"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");
-// 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");
-const fs_1 = __importDefault(require("fs"));
-const net_1 = __importDefault(require("net"));
-const http_1 = __importDefault(require("http"));
-// #755: light, server-free modules — safe to import eagerly in the packed client
-// (unlike ai-hub/server, which is lazy-required per #422).
-const hub_launch_decision_1 = require("../../ai-hub/hub-launch-decision");
-const hub_runtime_file_1 = require("../../ai-hub/hub-runtime-file");
-const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
-const version_utils_1 = require("../utils/version-utils");
-function resolveElectronBinary() {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        return require('electron');
-    }
-    catch {
-        return null;
-    }
-}
-function resolveDesktopEntry() {
-    const candidates = [
-        path_1.default.resolve(__dirname, '..', '..', 'ai-hub', 'desktop-main.js'),
-        path_1.default.resolve(process.cwd(), 'dist', 'src', 'ai-hub', 'desktop-main.js'),
-    ];
-    for (const candidate of candidates) {
-        try {
-            fs_1.default.accessSync(candidate);
-            return candidate;
-        }
-        catch {
-            continue;
-        }
-    }
-    return null;
-}
-function openDesktopWindow(projectPath, preferredPort) {
-    const electronBinary = resolveElectronBinary();
-    const desktopEntry = resolveDesktopEntry();
-    if (!electronBinary || !desktopEntry) {
-        return false;
-    }
-    const child = (0, child_process_1.spawn)(electronBinary, [desktopEntry, '--project-path', projectPath, '--port', String(preferredPort)], {
-        detached: true,
-        stdio: 'ignore',
-    });
-    child.unref();
-    return true;
-}
-function openBrowser(url) {
-    if (process.platform === 'win32') {
-        const child = (0, child_process_1.spawn)('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' });
-        child.unref();
-        return;
-    }
-    if (process.platform === 'darwin') {
-        const child = (0, child_process_1.spawn)('open', [url], { detached: true, stdio: 'ignore' });
-        child.unref();
-        return;
-    }
-    const child = (0, child_process_1.spawn)('xdg-open', [url], { detached: true, stdio: 'ignore' });
-    child.unref();
-}
-// #755: version-aware kill-and-replace. Electron's single-instance lock otherwise
-// re-focuses a stale running build instead of launching a newly-released one.
-function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (e) {
-        // EPERM => the process exists but we can't signal it (still "alive").
-        return !!(e && e.code === 'EPERM');
-    }
-}
-function killPid(pid) {
-    try {
-        if (process.platform === 'win32') {
-            (0, child_process_1.execFileSync)('taskkill', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore' });
-        }
-        else {
-            process.kill(pid, 'SIGTERM');
-        }
-    }
-    catch {
-        /* already gone */
-    }
-}
-function isPortFree(port, timeoutMs = 500) {
-    return new Promise((resolve) => {
-        const sock = net_1.default.connect({ host: '127.0.0.1', port }, () => { sock.destroy(); resolve(false); });
-        sock.on('error', () => resolve(true));
-        sock.setTimeout(timeoutMs, () => { sock.destroy(); resolve(true); });
-    });
-}
-async function waitForPortFree(port, totalMs = 5000) {
-    const start = Date.now();
-    while (Date.now() - start < totalMs) {
-        if (await isPortFree(port))
-            return;
-        await new Promise((r) => setTimeout(r, 200));
-    }
-}
-/**
- * Reconcile a running desktop Hub with the version about to launch. Replaces a
- * stale/older instance (or any instance under --restart) so the new build takes
- * over; keeps the running instance under --keep-running.
- */
-/** Confirm the recorded port actually serves a FRAIM Hub, returning its authoritative version. */
-function fetchRunningHubVersion(port) {
-    return new Promise((resolve) => {
-        const req = http_1.default.get({ host: '127.0.0.1', port, path: '/api/ai-hub/version', timeout: 1000 }, (res) => {
-            if (res.statusCode !== 200) {
-                res.resume();
-                return resolve(null);
-            }
-            let body = '';
-            res.on('data', (c) => { body += c; });
-            res.on('end', () => { try {
-                resolve(JSON.parse(body).version ?? null);
-            }
-            catch {
-                resolve(null);
-            } });
-        });
-        req.on('error', () => resolve(null));
-        req.on('timeout', () => { req.destroy(); resolve(null); });
-    });
-}
-async function reconcileRunningHub(flags) {
-    const running = (0, hub_runtime_file_1.readHubRuntimeFile)((0, project_fraim_paths_1.getUserFraimDirPath)());
-    // Confirm the recorded port genuinely serves a FRAIM Hub before trusting the file.
-    // This (a) prevents killing an unrelated process that reused a crashed Hub's pid,
-    // and (b) yields the authoritative running version (the file may be stale).
-    const confirmedVersion = running ? await fetchRunningHubVersion(running.port) : null;
-    const live = !!(running && confirmedVersion && isProcessAlive(running.pid));
-    const effective = live && running ? { ...running, version: confirmedVersion } : null;
-    const decision = (0, hub_launch_decision_1.decideHubLaunch)({
-        running: effective,
-        pidAlive: live,
-        cliVersion: (0, version_utils_1.getFraimVersion)(),
-        restart: flags.restart,
-        noRestart: flags.keepRunning,
-    });
-    if (decision.action === 'replace' && effective) {
-        console.log(`Replacing running Hub (v${effective.version}, pid ${effective.pid}) — ${decision.reason}`);
-        killPid(effective.pid);
-        await waitForPortFree(effective.port);
-    }
-    else if (decision.action === 'focus-existing' && effective) {
-        console.log(`A Hub (v${effective.version}) is already running — focusing it. Use --restart to replace it.`);
-    }
-}
-exports.hubCommand = new commander_1.Command('hub')
-    .description('Start the AI Hub local companion for running FRAIM jobs through Codex or Claude Code')
-    .option('--port <port>', 'Preferred local port for the hub', (value) => Number(value), 43091)
-    .option('--project-path <path>', 'Initial project path for job discovery', process.cwd())
-    .option('--no-open', 'Do not open the hub after startup')
-    .option('--browser', 'Open in the default browser instead of the desktop shell')
-    .option('--restart', 'Replace any running Hub instance with this build (even at the same version)')
-    .option('--keep-running', 'Do not replace a running Hub; keep single-instance focus (default replaces only an older/stale instance)')
-    .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 wantDesktop = !options.browser;
-        // #755: before spawning Electron (whose single-instance lock would re-focus a
-        // stale build), replace an older/forced running instance so the new build wins.
-        if (wantDesktop) {
-            await reconcileRunningHub({ restart: !!options.restart, keepRunning: !!options.keepRunning });
-        }
-        const openedDesktop = wantDesktop && openDesktopWindow(projectPath, preferredPort);
-        if (!openedDesktop) {
-            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}`);
-            console.log(`Project path: ${projectPath}`);
-            openBrowser(url);
-            return;
-        }
-        console.log('AI Hub desktop shell launched.');
-        console.log(`Project path: ${projectPath}`);
-        return;
-    }
-    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}`);
-    console.log(`Project path: ${projectPath}`);
-});

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

@@ -1,171 +0,0 @@
-"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);