fraim-framework 2.0.127 → 2.0.128

package/dist/src/cli/commands/init-project.js

@@ -160,11 +160,15 @@ const createGitHubLabels = (projectRoot) => {
 };
 const runInitProject = async (options = {}) => {
     console.log(chalk_1.default.blue('Initializing FRAIM project...'));
+    const failHard = options.failHard ?? 'exit';
     const globalSetup = checkGlobalSetup();
     if (!globalSetup.exists) {
         console.log(chalk_1.default.red('Global FRAIM setup not found.'));
         console.log(chalk_1.default.yellow('Please run global setup first:'));
         console.log(chalk_1.default.cyan('   fraim setup'));
+        if (failHard === 'throw') {
+            throw new Error('Global FRAIM setup not found.');
+        }
         process.exit(1);
     }
     const projectRoot = options.projectRoot || process.cwd();
@@ -312,7 +316,7 @@ const runInitProject = async (options = {}) => {
         result.repositoryDetected = true;
     }
     if (!process.env.FRAIM_SKIP_SYNC) {
-        await (0, sync_1.runSync)({ projectRoot });
+        await (0, sync_1.runSync)({ projectRoot, failHard });
         result.syncPerformed = true;
     }
     else {

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

@@ -101,7 +101,14 @@ function updateVersionInConfig(fraimDir) {
         console.warn(chalk_1.default.yellow('Could not update version in config.json.'));
     }
 }
+function failSync(mode, message) {
+    if (mode === 'throw') {
+        throw new Error(message);
+    }
+    process.exit(1);
+}
 const runSync = async (options) => {
+    const failHard = options.failHard ?? 'exit';
     // Handle --global flag: sync to user-level ~/.fraim/ instead of project
     if (options.global) {
         console.log(chalk_1.default.blue('Syncing FRAIM content to user-level directory (~/.fraim/)...'));
@@ -112,7 +119,7 @@ const runSync = async (options) => {
         }
         catch (error) {
             console.error(chalk_1.default.red(`User-level sync failed: ${error.message}`));
-            process.exit(1);
+            failSync(failHard, `User-level sync failed: ${error.message}`);
         }
         return;
     }
@@ -158,7 +165,7 @@ const runSync = async (options) => {
         }
         console.error(chalk_1.default.red(`Local sync failed: ${result.error}`));
         console.error(chalk_1.default.yellow('Make sure the FRAIM MCP server is running locally (npm run dev).'));
-        process.exit(1);
+        failSync(failHard, `Local sync failed: ${result.error}`);
     }
     let apiKey = loadUserApiKey() || config.apiKey || process.env.FRAIM_API_KEY;
     if (!apiKey) {
@@ -170,7 +177,7 @@ const runSync = async (options) => {
             console.error(chalk_1.default.red('No API key configured. Cannot sync.'));
             console.error(chalk_1.default.yellow(`Set FRAIM_API_KEY in your environment, or add apiKey to ~/.fraim/config.json or ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`));
             console.error(chalk_1.default.yellow('Or use --local to sync from a locally running FRAIM server.'));
-            process.exit(1);
+            failSync(failHard, 'No API key configured.');
         }
     }
     console.log(chalk_1.default.blue('Syncing FRAIM jobs from remote server...'));
@@ -188,7 +195,7 @@ const runSync = async (options) => {
             updateVersionInConfig(fraimDir);
             return;
         }
-        process.exit(1);
+        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);

package/dist/src/first-run/install-state.js

@@ -27,14 +27,12 @@ function maskInstallKey(key) {
 function createInitialFirstRunState(key) {
     const now = new Date().toISOString();
     return {
-        version: 1,
+        version: 2,
         installKeyRef: maskInstallKey(key),
         platform: process.platform,
-        detectedAgents: [],
-        configuredAgents: [],
-        restartDeferredAgents: [],
+        agentId: 'claude-code',
+        rows: (0, types_1.createInitialRows)(),
         resourcesUrl: types_1.FIRST_RUN_RESOURCES_URL,
-        stepStates: (0, types_1.createDefaultStepStates)(),
         createdAt: now,
         updatedAt: now,
     };
@@ -46,6 +44,10 @@ function loadFirstRunState() {
     }
     try {
         const state = JSON.parse(fs_1.default.readFileSync(statePath, 'utf8'));
+        // Reject persisted v1 state — schema changed materially in #352 v1.
+        if (state.version !== 2) {
+            return null;
+        }
         if (typeof state.installKeyRef === 'string' && !state.installKeyRef.includes('...')) {
             state.installKeyRef = maskInstallKey(state.installKeyRef);
         }

package/dist/src/first-run/server.js

@@ -8,6 +8,7 @@ const express_1 = __importDefault(require("express"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
+const session_service_1 = require("./session-service");
 function resolveFirstRunPublicDir() {
     const candidates = [
         path_1.default.resolve(process.cwd(), 'public/first-run'),
@@ -47,6 +48,9 @@ function pickProjectPath() {
     });
     return result.status === 0 ? result.stdout.trim() || null : null;
 }
+function isCanonicalRowId(value) {
+    return typeof value === 'string' && session_service_1.FIRST_RUN_ROW_IDS.includes(value);
+}
 class FirstRunServer {
     constructor(options) {
         this.app = (0, express_1.default)();
@@ -100,21 +104,25 @@ class FirstRunServer {
         this.app.get('/api/first-run/session', (_req, res) => {
             res.json(this.sessionService.getSession());
         });
-        this.app.post('/api/first-run/prereqs', (_req, res) => {
-            res.json(this.sessionService.runPrereqChecks());
-        });
-        this.app.post('/api/first-run/agents/select', (req, res) => {
-            if (!req.body.agentId) {
-                return res.status(400).json({ error: 'agentId is required.' });
+        this.app.post('/api/first-run/rows/:rowId/run', async (req, res) => {
+            const { rowId } = req.params;
+            if (!isCanonicalRowId(rowId)) {
+                return res.status(400).json({ error: `Unknown row id: ${rowId}` });
+            }
+            try {
+                const result = await this.sessionService.runRow(rowId, req.body || {});
+                return res.json(result);
+            }
+            catch (error) {
+                return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not run row.' });
             }
-            return res.json(this.sessionService.selectAgent(req.body.agentId));
         });
-        this.app.post('/api/first-run/configure', async (_req, res) => {
+        this.app.post('/api/first-run/agent/change', (req, res) => {
             try {
-                return res.json(await this.sessionService.configureFraim());
+                return res.json(this.sessionService.changeAgent(req.body || {}));
             }
             catch (error) {
-                return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not configure FRAIM.' });
+                return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not change agent.' });
             }
         });
         this.app.post('/api/first-run/project-path/pick', (_req, res) => {
@@ -129,25 +137,22 @@ class FirstRunServer {
                 return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not open the folder picker.' });
             }
         });
-        this.app.post('/api/first-run/project', async (req, res) => {
-            if (!req.body.projectPath) {
-                return res.status(400).json({ error: 'projectPath is required.' });
-            }
-            try {
-                return res.json(await this.sessionService.initializeProject(req.body.projectPath, req.body.initializeGit !== false));
-            }
-            catch (error) {
-                return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not initialize the project.' });
-            }
-        });
-        this.app.post('/api/first-run/launch', (_req, res) => {
-            return res.json(this.sessionService.launchAndProbe());
-        });
         this.app.post('/api/first-run/finish', (_req, res) => {
             const result = this.sessionService.finish();
             this.finishResolver?.();
             return res.json(result);
         });
+        // Hub-launch helper — starts an AiHubServer for the chosen project and
+        // opens the user's browser. v2 (#355) replaces the in-process spawn with
+        // a durable launcher binary.
+        this.app.post('/api/first-run/open-hub', async (_req, res) => {
+            try {
+                return res.json(await this.sessionService.openHub());
+            }
+            catch (error) {
+                return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not open Hub.' });
+            }
+        });
     }
 }
 exports.FirstRunServer = FirstRunServer;