fraim-framework 2.0.168 → 2.0.170

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

@@ -50,7 +50,6 @@ const https_1 = __importDefault(require("https"));
 const types_1 = require("../first-run/types");
 const learning_context_builder_1 = require("../local-mcp-server/learning-context-builder");
 const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
-const persona_hiring_1 = require("../config/persona-hiring");
 const catalog_1 = require("./catalog");
 const agent_token_prices_1 = require("../local-mcp-server/agent-token-prices");
 const hosts_1 = require("./hosts");
@@ -59,6 +58,44 @@ const preferences_1 = require("./preferences");
 const conversation_store_1 = require("./conversation-store");
 const managed_browser_1 = require("./managed-browser");
 const managed_agent_paths_1 = require("../cli/utils/managed-agent-paths");
+let personaHiringModule;
+let managerHiringModule;
+function loadPersonaHiringModule() {
+    const cached = personaHiringModule;
+    if (cached !== undefined) {
+        return cached;
+    }
+    try {
+        // Server deployments include the persona catalog. The npm client package
+        // intentionally does not, so importing ai-hub/server must not require it.
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const loaded = require('../config/persona-hiring');
+        personaHiringModule = loaded;
+        return loaded;
+    }
+    catch {
+        personaHiringModule = null;
+        return null;
+    }
+}
+function loadManagerHiringModule() {
+    const cached = managerHiringModule;
+    if (cached !== undefined) {
+        return cached;
+    }
+    try {
+        // Server deployments include the manager-hiring catalog. The npm client
+        // package intentionally does not, so Hub bootstrap must not require it.
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const loaded = require('../config/ai-manager-hiring');
+        managerHiringModule = loaded;
+        return loaded;
+    }
+    catch {
+        managerHiringModule = null;
+        return null;
+    }
+}
 function loadPersonaCapabilityModule() {
     try {
         // Server deployments include the persona catalog. The npm client package
@@ -80,6 +117,16 @@ function buildHubPersonaHireUrl(personaKey, hireMode = 'job') {
     const params = new URLSearchParams({ persona: personaKey, mode: hireMode });
     return `/pricing?${params.toString()}`;
 }
+function buildHubPersonaAvatarUrl(personaKey) {
+    return loadPersonaHiringModule()?.buildPersonaAvatarUrl(personaKey) ?? '';
+}
+function buildHubManagerHiringCatalog() {
+    return loadManagerHiringModule()?.buildManagerHiringCatalog() ?? {
+        qualities: [],
+        services: [],
+        roles: {},
+    };
+}
 async function getHubWorkspacePersonaState(dbService, userId, apiKey) {
     try {
         // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -1016,7 +1063,7 @@ class AiHubServer {
             // Issue #538 — source of truth for the "Hire a human manager" UI. Lazy-required
             // (not a top-level import) so the lightweight client CLI paths that import this
             // module for findAvailablePort do not eagerly load server-only config (repro #422).
-            managerHiring: require('../config/ai-manager-hiring').buildManagerHiringCatalog(),
+            managerHiring: buildHubManagerHiringCatalog(),
             // Issue #540: server-authoritative manager team (personas assigned by this manager).
             managerTeam,
         };
@@ -1175,7 +1222,7 @@ class AiHubServer {
             key: bundle.personaKey,
             displayName: bundle.catalogMetadata.displayName,
             role: bundle.catalogMetadata.role,
-            avatarUrl: (0, persona_hiring_1.buildPersonaAvatarUrl)(bundle.personaKey),
+            avatarUrl: buildHubPersonaAvatarUrl(bundle.personaKey),
             pricingLabel: bundle.catalogMetadata.pricingLabel,
             status: 'locked',
             hireUrl: buildHubPersonaHireUrl(bundle.personaKey, bundle.defaultHireMode),
@@ -1213,7 +1260,7 @@ class AiHubServer {
                 key: bundle.personaKey,
                 displayName: bundle.catalogMetadata.displayName,
                 role: bundle.catalogMetadata.role,
-                avatarUrl: (0, persona_hiring_1.buildPersonaAvatarUrl)(bundle.personaKey),
+                avatarUrl: buildHubPersonaAvatarUrl(bundle.personaKey),
                 pricingLabel: hiredKeys.has(bundle.personaKey) ? '' : bundle.catalogMetadata.pricingLabel,
                 status: (hiredKeys.has(bundle.personaKey) ? 'hired' : 'locked'),
                 hireUrl: buildHubPersonaHireUrl(bundle.personaKey, bundle.defaultHireMode),

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

@@ -0,0 +1,242 @@
+"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.runFirstRunExperience = void 0;
+const prompts_1 = __importDefault(require("prompts"));
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const script_sync_utils_1 = require("../utils/script-sync-utils");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+const loadGlobalConfig = () => {
+    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
+    if (!fs_1.default.existsSync(globalConfigPath)) {
+        return null;
+    }
+    try {
+        const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
+        return {
+            fraimKey: config.apiKey,
+            githubToken: config.githubToken
+        };
+    }
+    catch (e) {
+        return null;
+    }
+};
+const checkMCPConfigurations = () => {
+    const sources = [];
+    // Check Kiro MCP config
+    const kiroConfigPath = path_1.default.join(os_1.default.homedir(), '.kiro', 'settings', 'mcp.json');
+    if (fs_1.default.existsSync(kiroConfigPath)) {
+        try {
+            const kiroConfig = JSON.parse(fs_1.default.readFileSync(kiroConfigPath, 'utf8'));
+            if (kiroConfig.mcpServers?.fraim) {
+                sources.push('Kiro');
+            }
+        }
+        catch (e) {
+            // Ignore parsing errors
+        }
+    }
+    // Check Claude Desktop / Cowork config
+    const claudeConfigPath = path_1.default.join(os_1.default.homedir(), 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
+    if (fs_1.default.existsSync(claudeConfigPath)) {
+        try {
+            const claudeConfig = JSON.parse(fs_1.default.readFileSync(claudeConfigPath, 'utf8'));
+            if (claudeConfig.mcpServers?.fraim) {
+                sources.push('Claude Desktop / Cowork');
+            }
+        }
+        catch (e) {
+            // Ignore parsing errors
+        }
+    }
+    // Check macOS Claude Desktop / Cowork config path
+    const claudeMacPath = path_1.default.join(os_1.default.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    if (fs_1.default.existsSync(claudeMacPath)) {
+        try {
+            const claudeConfig = JSON.parse(fs_1.default.readFileSync(claudeMacPath, 'utf8'));
+            if (claudeConfig.mcpServers?.fraim) {
+                sources.push('Claude Desktop / Cowork (macOS)');
+            }
+        }
+        catch (e) {
+            // Ignore parsing errors
+        }
+    }
+    // Check VS Code MCP config (uses "servers" key)
+    const vscodePaths = [
+        path_1.default.join(os_1.default.homedir(), 'AppData', 'Roaming', 'Code', 'User', 'mcp.json'),
+        path_1.default.join(os_1.default.homedir(), 'Library', 'Application Support', 'Code', 'User', 'mcp.json'),
+        path_1.default.join(os_1.default.homedir(), '.config', 'Code', 'User', 'mcp.json')
+    ];
+    for (const vscodePath of vscodePaths) {
+        if (fs_1.default.existsSync(vscodePath)) {
+            try {
+                const vscodeConfig = JSON.parse(fs_1.default.readFileSync(vscodePath, 'utf8'));
+                if (vscodeConfig.servers?.fraim) {
+                    sources.push('VSCode');
+                    break;
+                }
+            }
+            catch (e) {
+                // Ignore parsing errors
+            }
+        }
+    }
+    return {
+        found: sources.length > 0,
+        sources
+    };
+};
+const runFirstRunExperience = async () => {
+    // Skip interactive setup in CI/Test environments
+    if (process.env.CI === 'true' || process.env.TEST_MODE === 'true') {
+        console.log(chalk_1.default.yellow('ℹ️  Skipping interactive first-run experience (CI/TEST_MODE detected)'));
+        return;
+    }
+    console.log(chalk_1.default.blue('\n👋 Welcome to FRAIM! Let\'s get you set up.\n'));
+    // Check for existing configuration
+    const globalConfig = loadGlobalConfig();
+    const mcpCheck = checkMCPConfigurations();
+    if (globalConfig && globalConfig.fraimKey) {
+        console.log(chalk_1.default.green('✅ Found existing FRAIM configuration'));
+        if (mcpCheck.found) {
+            console.log(chalk_1.default.green(`✅ Found FRAIM MCP configuration in: ${mcpCheck.sources.join(', ')}`));
+            console.log(chalk_1.default.blue('🎉 You\'re all set! FRAIM is ready to use.\n'));
+        }
+        else {
+            console.log(chalk_1.default.yellow('⚠️  FRAIM key found but no MCP configuration detected.'));
+            console.log(chalk_1.default.cyan('💡 Consider running "fraim add-ide" to configure your IDE.\n'));
+        }
+    }
+    else if (mcpCheck.found) {
+        console.log(chalk_1.default.green(`✅ Found FRAIM MCP configuration in: ${mcpCheck.sources.join(', ')}`));
+        console.log(chalk_1.default.yellow('⚠️  But no global FRAIM configuration found.'));
+        console.log(chalk_1.default.cyan('💡 Your MCP setup looks good! Skipping key setup.\n'));
+    }
+    else {
+        // No existing configuration found - ask for FRAIM key
+        console.log(chalk_1.default.yellow('🔍 No existing FRAIM configuration detected.\n'));
+        let response;
+        try {
+            response = await (0, prompts_1.default)({
+                type: 'text',
+                name: 'fraimKey',
+                message: 'Do you have a FRAIM key? (Input key or press Enter to skip)',
+                validate: (value) => true // Optional input
+            });
+        }
+        catch (e) {
+            console.warn(chalk_1.default.yellow('\n⚠️  Interactive prompts experienced an issue. Skipping setup.\n'));
+            return;
+        }
+        if (response.fraimKey && response.fraimKey.trim().length > 0) {
+            const key = response.fraimKey.trim();
+            console.log(chalk_1.default.green('\n✅ Key received.'));
+            console.log(chalk_1.default.yellow('\nPlease add the following to your IDE\'s MCP config (e.g. claude_desktop_config.json):'));
+            const mcpConfig = {
+                mcpServers: {
+                    fraim: {
+                        serverUrl: "https://fraim.wellnessatwork.me",
+                        headers: {
+                            "x-api-key": key
+                        }
+                    }
+                }
+            };
+            console.log(chalk_1.default.cyan(JSON.stringify(mcpConfig, null, 2)));
+            console.log('\n');
+        }
+        else {
+            console.log(chalk_1.default.yellow('\nℹ️  If you need a key, please email sid.mathur@gmail.com to request one.\n'));
+        }
+    }
+    // 2. Ask about Architecture Document
+    const archResponse = await (0, prompts_1.default)({
+        type: 'confirm',
+        name: 'hasArchDoc',
+        message: 'Do you have an architecture document for this project?',
+        initial: false
+    });
+    if (!archResponse.hasArchDoc) {
+        console.log(chalk_1.default.yellow('\n💡 To create an architecture document, please ask your IDE Agent:'));
+        console.log(chalk_1.default.cyan('  "Run the bootstrap/create-architecture workflow"'));
+        console.log(chalk_1.default.gray('  (This ensures your agent understands your codebase structure)\n'));
+    }
+    else {
+        const pathResponse = await (0, prompts_1.default)({
+            type: 'text',
+            name: 'archDocPath',
+            message: 'Please provide the relative path to your architecture document:',
+            initial: 'docs/architecture.md',
+            validate: (value) => value.length > 0 ? true : 'Path cannot be empty'
+        });
+        if (pathResponse.archDocPath) {
+            const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+            const path = await Promise.resolve().then(() => __importStar(require('path')));
+            const resolvedPath = path.resolve(process.cwd(), pathResponse.archDocPath);
+            if (fs.existsSync(resolvedPath)) {
+                try {
+                    const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
+                    if (fs.existsSync(configPath)) {
+                        const configContent = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+                        if (!configContent.customizations)
+                            configContent.customizations = {};
+                        configContent.customizations.architectureDoc = pathResponse.archDocPath;
+                        fs.writeFileSync(configPath, JSON.stringify(configContent, null, 2));
+                        console.log(chalk_1.default.green(`\n✅ Linked architecture document: ${pathResponse.archDocPath}`));
+                    }
+                    else {
+                        console.log(chalk_1.default.red(`\n❌ ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')} not found. Could not save preference.`));
+                    }
+                }
+                catch (e) {
+                    console.error(chalk_1.default.red('\n❌ Failed to update config:'), e);
+                }
+            }
+            else {
+                console.log(chalk_1.default.yellow(`\n⚠️  File not found at ${pathResponse.archDocPath}. We'll skip linking it for now.`));
+            }
+        }
+    }
+    console.log(chalk_1.default.green(`\n✅ Jobs are installed in ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/jobs')} and ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-manager/jobs')}.\n`));
+};
+exports.runFirstRunExperience = runFirstRunExperience;

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

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFraimConfigRaw = readFraimConfigRaw;
+exports.mergeFraimConfig = mergeFraimConfig;
+exports.writeFraimConfigUpdate = writeFraimConfigUpdate;
+exports.writeFraimConfig = writeFraimConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_loader_1 = require("./config-loader");
+const types_1 = require("./types");
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function deepMerge(baseValue, updateValue) {
+    if (updateValue === undefined) {
+        return baseValue;
+    }
+    if (Array.isArray(updateValue)) {
+        return [...updateValue];
+    }
+    if (!isPlainObject(updateValue)) {
+        return updateValue;
+    }
+    const baseObject = isPlainObject(baseValue) ? baseValue : {};
+    const merged = { ...baseObject };
+    for (const [key, value] of Object.entries(updateValue)) {
+        merged[key] = deepMerge(baseObject[key], value);
+    }
+    return merged;
+}
+function ensureWritableFraimConfigShape(rawConfig) {
+    const config = { ...rawConfig };
+    if (typeof config.version !== 'string' || config.version.trim().length === 0) {
+        config.version = types_1.DEFAULT_FRAIM_CONFIG.version;
+    }
+    const projectConfig = isPlainObject(config.project) ? config.project : {};
+    config.project = {
+        ...types_1.DEFAULT_FRAIM_CONFIG.project,
+        ...projectConfig
+    };
+    const customizationsConfig = isPlainObject(config.customizations) ? config.customizations : {};
+    config.customizations = {
+        ...types_1.DEFAULT_FRAIM_CONFIG.customizations,
+        ...customizationsConfig
+    };
+    return config;
+}
+function readFraimConfigRaw(configPath) {
+    if (!(0, fs_1.existsSync)(configPath)) {
+        return {};
+    }
+    const parsed = JSON.parse((0, fs_1.readFileSync)(configPath, 'utf8'));
+    if (!isPlainObject(parsed)) {
+        throw new Error('FRAIM config must contain a JSON object at the top level.');
+    }
+    return parsed;
+}
+function mergeFraimConfig(existingRawConfig, update) {
+    const rawConfig = ensureWritableFraimConfigShape(deepMerge(existingRawConfig, update));
+    return {
+        config: (0, config_loader_1.normalizeFraimConfig)(rawConfig),
+        created: Object.keys(existingRawConfig).length === 0,
+        rawConfig
+    };
+}
+function writeFraimConfigUpdate(configPath, update) {
+    const existingRawConfig = readFraimConfigRaw(configPath);
+    const result = mergeFraimConfig(existingRawConfig, update);
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(configPath), { recursive: true });
+    (0, fs_1.writeFileSync)(configPath, JSON.stringify(result.rawConfig, null, 2));
+    return result;
+}
+function writeFraimConfig(configPath, config) {
+    return writeFraimConfigUpdate(configPath, config);
+}