fraim 2.0.129 → 2.0.130

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

@@ -269,10 +269,13 @@ function readJobFrontmatter(filePath) {
     }
 }
 function findJobStubPath(projectPath, jobId) {
-    // Walk the same layer set used by discoverEmployeeJobs (employee layers
-    // are first-class jobs; manager layers are templates and don't carry
-    // multi-phase frontmatter). Personalized layer wins over baseline.
-    const layers = discoverLayers(projectPath, EMPLOYEE_JOB_LAYERS);
+    // Walk both employee and manager layer sets. The analytics surfaces can
+    // inspect any FRAIM job run, including manager-side jobs such as
+    // sleep-on-learnings.
+    const layers = discoverLayers(projectPath, [
+        ...EMPLOYEE_JOB_LAYERS,
+        ...MANAGER_JOB_LAYERS,
+    ]);
     let resolved = null;
     for (const layer of layers) {
         const candidate = path_1.default.join(layer.categoryDir, `${jobId}.md`);

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

@@ -9,49 +9,16 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const chalk_1 = __importDefault(require("chalk"));
-const prompts_1 = __importDefault(require("prompts"));
 const child_process_1 = require("child_process");
 const sync_1 = require("./sync");
 const platform_detection_1 = require("../utils/platform-detection");
-const version_utils_1 = require("../utils/version-utils");
 const ide_detector_1 = require("../setup/ide-detector");
 const codex_local_config_1 = require("../setup/codex-local-config");
 const claude_code_telemetry_1 = require("../setup/claude-code-telemetry");
-const provider_registry_1 = require("../providers/provider-registry");
 const fraim_gitignore_1 = require("../utils/fraim-gitignore");
-const config_writer_1 = require("../../core/config-writer");
 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 promptForJiraProjectKey = async (jiraBaseUrl) => {
-    console.log(chalk_1.default.blue('\nJira Project Configuration'));
-    console.log(chalk_1.default.gray(`Jira instance: ${jiraBaseUrl}`));
-    console.log(chalk_1.default.gray('Enter the Jira project key for this repository (e.g., TEAM, PROJ, DEV)\n'));
-    if (process.env.FRAIM_NON_INTERACTIVE) {
-        const defaultKey = process.env.FRAIM_JIRA_PROJECT_KEY || 'PROJ';
-        console.log(chalk_1.default.yellow(`\nNon-interactive mode: using Jira project key "${defaultKey}"`));
-        return defaultKey;
-    }
-    const response = await (0, prompts_1.default)({
-        type: 'text',
-        name: 'projectKey',
-        message: 'Jira Project Key:',
-        validate: (value) => {
-            if (!value || value.trim().length === 0) {
-                return 'Project key is required';
-            }
-            if (!/^[A-Z][A-Z0-9]*$/.test(value.trim())) {
-                return 'Project key must start with a letter and contain only uppercase letters and numbers';
-            }
-            return true;
-        }
-    });
-    if (!response.projectKey) {
-        console.log(chalk_1.default.red('\nJira project key is required for split mode'));
-        process.exit(1);
-    }
-    return response.projectKey.trim().toUpperCase();
-};
 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');
@@ -158,6 +125,18 @@ const createGitHubLabels = (projectRoot) => {
         console.log(chalk_1.default.yellow(`Error reading labels.json: ${error.message}`));
     }
 };
+function formatPlatformLabel(provider) {
+    switch (provider) {
+        case 'ado':
+            return 'Azure DevOps';
+        case 'github':
+            return 'GitHub';
+        case 'gitlab':
+            return 'GitLab';
+        default:
+            return provider.toUpperCase();
+    }
+}
 const runInitProject = async (options = {}) => {
     console.log(chalk_1.default.blue('Initializing FRAIM project...'));
     const failHard = options.failHard ?? 'exit';
@@ -188,94 +167,7 @@ const runInitProject = async (options = {}) => {
         console.log(chalk_1.default.yellow(`${fraimDirDisplayPath} directory already exists`));
         (0, project_bootstrap_1.recordPathStatus)(result, fraimDirDisplayPath, false);
     }
-    if (!fs_1.default.existsSync(configPath)) {
-        const preferredMode = globalSetup.mode || 'integrated';
-        result.mode = preferredMode;
-        let config;
-        if (preferredMode === 'conversational') {
-            config = {
-                version: (0, version_utils_1.getFraimVersion)(),
-                project: {
-                    name: projectName
-                },
-                customizations: {}
-            };
-            console.log(chalk_1.default.blue('   conversational mode: no platform integration'));
-            console.log(chalk_1.default.gray(`   Project: ${projectName}`));
-        }
-        else {
-            const detection = (0, platform_detection_1.detectPlatformFromGit)();
-            if (detection.provider !== 'unknown' && detection.repository) {
-                result.repositoryDetected = true;
-                let issueTracking;
-                const jiraConfig = globalSetup.providerConfigs?.jiraConfig;
-                if (preferredMode === 'split' && globalSetup.tokens?.jira && jiraConfig?.baseUrl) {
-                    const projectKey = process.env.FRAIM_JIRA_PROJECT_KEY ||
-                        await promptForJiraProjectKey(jiraConfig.baseUrl);
-                    issueTracking = {
-                        provider: 'jira',
-                        baseUrl: jiraConfig.baseUrl,
-                        projectKey,
-                        email: jiraConfig.email
-                    };
-                    result.issueTrackingDetected = true;
-                    console.log(chalk_1.default.blue(`   Code Repository: ${detection.provider.toUpperCase()}`));
-                    console.log(chalk_1.default.blue(`   Issue Tracking: JIRA (${projectKey})`));
-                }
-                else {
-                    issueTracking = {
-                        provider: detection.provider,
-                        ...detection.repository
-                    };
-                    result.issueTrackingDetected = true;
-                    if (preferredMode === 'split') {
-                        result.mode = 'integrated';
-                        result.warnings.push('Split mode is not fully configured for this repo yet, so issue tracking fell back to the repository provider.');
-                    }
-                    const providerDef = await (0, provider_registry_1.getProvider)(detection.provider);
-                    console.log(chalk_1.default.blue(`   Platform: ${providerDef?.displayName || detection.provider.toUpperCase()}`));
-                }
-                config = {
-                    version: (0, version_utils_1.getFraimVersion)(),
-                    project: {
-                        name: detection.repository.name || projectName
-                    },
-                    repository: detection.repository,
-                    issueTracking,
-                    customizations: {}
-                };
-                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 {
-                config = {
-                    version: (0, version_utils_1.getFraimVersion)(),
-                    project: {
-                        name: projectName
-                    },
-                    customizations: {}
-                };
-                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.'));
-            }
-        }
-        (0, config_writer_1.writeFraimConfig)(configPath, config);
-        console.log(chalk_1.default.green(`Created ${configDisplayPath}`));
-        (0, project_bootstrap_1.recordPathStatus)(result, configDisplayPath, true);
-    }
-    else {
+    if (fs_1.default.existsSync(configPath)) {
         (0, project_bootstrap_1.recordPathStatus)(result, configDisplayPath, false);
         try {
             const existingConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
@@ -289,6 +181,48 @@ const runInitProject = async (options = {}) => {
             result.warnings.push(`Existing ${configDisplayPath} could not be parsed for summary details.`);
         }
     }
+    else {
+        const preferredMode = globalSetup.mode || 'integrated';
+        result.mode = preferredMode;
+        const detection = (0, platform_detection_1.detectPlatformFromGit)();
+        if (detection.provider !== 'unknown' && detection.repository) {
+            result.repositoryDetected = true;
+            result.projectName = detection.repository.name || projectName;
+            const jiraConfig = globalSetup.providerConfigs?.jiraConfig;
+            if (preferredMode === 'split' && globalSetup.tokens?.jira && jiraConfig?.baseUrl) {
+                result.issueTrackingDetected = true;
+                console.log(chalk_1.default.blue(`   Code Repository: ${formatPlatformLabel(detection.provider)}`));
+                console.log(chalk_1.default.blue('   Issue Tracking: JIRA'));
+            }
+            else {
+                result.issueTrackingDetected = preferredMode !== 'conversational';
+                if (preferredMode === 'split') {
+                    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}`));
+            }
+            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.'));
+        }
+        result.warnings.push(`${configDisplayPath} was not created by init-project. The manager \`project-onboarding\` job is the only supported config-writing path.`);
+    }
     ['jobs', 'ai-employee/jobs', 'ai-employee/skills', 'ai-manager/jobs', 'personalized-employee'].forEach((dir) => {
         const dirPath = path_1.default.join(fraimDir, dir);
         if (!fs_1.default.existsSync(dirPath)) {

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

@@ -45,11 +45,9 @@ 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 platform_detection_1 = require("../utils/platform-detection");
 const provider_client_1 = require("../api/provider-client");
 const provider_prompts_1 = require("../setup/provider-prompts");
 const provider_registry_1 = require("../providers/provider-registry");
-const init_project_1 = require("./init-project");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 function parseModeOption(mode) {
     if (mode === 'conversational' || mode === 'integrated' || mode === 'split') {
@@ -650,17 +648,6 @@ const runSetup = async (options) => {
     catch (e) {
         console.log(chalk_1.default.yellow(`⚠️  IDE integration encountered issues: ${e.message}`));
     }
-    // Auto-run project init if we're in a git repo (only on initial setup)
-    if (!isUpdate) {
-        if ((0, platform_detection_1.isGitRepository)()) {
-            console.log(chalk_1.default.blue('\n📁 Git repository detected — initializing project...'));
-            await (0, init_project_1.runInitProject)();
-        }
-        else {
-            console.log(chalk_1.default.yellow('\nℹ️  Not in a git repository — skipping project initialization.'));
-            console.log(chalk_1.default.cyan('   To initialize a project later, cd into a repo and run: fraim init-project'));
-        }
-    }
     // Show mode-aware summary with clear value prop and next steps
     console.log(chalk_1.default.green('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
     console.log(chalk_1.default.green('  FRAIM is ready!'));
@@ -671,40 +658,78 @@ const runSetup = async (options) => {
     console.log(chalk_1.default.white('  your leadership gains clear optics on AI proficiency.'));
     console.log(chalk_1.default.gray('\n  120+ jobs across engineering, marketing, fundraising,'));
     console.log(chalk_1.default.gray('  legal, product, hiring, customer development, and more.'));
-    // Show which IDEs were configured and how to use FRAIM in each
-    const { detectInstalledIDEs: detectIDEs } = await Promise.resolve().then(() => __importStar(require('../setup/ide-detector')));
-    const configuredIDEs = detectIDEs();
-    if (configuredIDEs.length > 0) {
-        const ideNames = configuredIDEs.map(ide => ide.name).join(', ');
-        console.log(chalk_1.default.cyan(`\n  FRAIM is configured for: `) + chalk_1.default.white(ideNames));
-        console.log(chalk_1.default.cyan('\n  Get started — open any of those tools and:'));
+    // Ask how the user wants to work with their AI employees.
+    // Skip prompt when the user already chose on a previous run (R2.2/R3.2/R4.6).
+    const { writeSetupHandoffChoice, readSetupHandoffChoice } = await Promise.resolve().then(() => __importStar(require('../../core/utils/setup-preferences')));
+    const storedChoice = readSetupHandoffChoice();
+    let choice;
+    if (storedChoice) {
+        console.log(chalk_1.default.gray(`\n  Using your saved preference: ${storedChoice === 'ide' ? 'In my IDE' : 'In FRAIM Hub'}`));
+        choice = storedChoice;
     }
     else {
-        console.log(chalk_1.default.cyan('\n  Get started — open your AI tool and:'));
+        const userTypeResponse = await (0, prompts_1.default)({
+            type: 'select',
+            name: 'choice',
+            message: 'How would you like to work with your AI employees?',
+            choices: [
+                { title: 'In my IDE  (Claude Code, Cursor, or another AI tool)', value: 'ide' },
+                { title: 'In FRAIM Hub  (browser-based — no terminal needed)', value: 'hub' },
+            ],
+        });
+        choice = userTypeResponse.choice;
     }
-    const { describeConfiguredInvocationSurfaces } = await Promise.resolve().then(() => __importStar(require('../setup/ide-global-integration')));
-    const invocationSummaries = describeConfiguredInvocationSurfaces(configuredIDEs);
-    invocationSummaries.forEach((summary) => {
-        console.log(chalk_1.default.white(`    ${summary}`));
-    });
-    console.log(chalk_1.default.white('    "What can FRAIM help me with?"'));
-    console.log(chalk_1.default.gray('\n  Just tell your AI what you need — FRAIM will find the right job.'));
-    if (mode !== 'conversational') {
-        console.log(chalk_1.default.cyan('\n  To set up FRAIM in a specific project:'));
-        console.log(chalk_1.default.white('    cd your-project && fraim init-project'));
-        console.log(chalk_1.default.gray('    This enables project-specific customizations,'));
-        console.log(chalk_1.default.gray('    GitHub workflows, and team learning.'));
-        const configuredProviders = await Promise.all(Object.keys(tokens).map(async (id) => await (0, provider_registry_1.getProviderDisplayName)(id)));
-        if (configuredProviders.length > 0) {
-            console.log(chalk_1.default.gray(`\n  Platforms: ${configuredProviders.join(', ')}`));
+    if (!choice)
+        return; // user cancelled (Ctrl+C)
+    writeSetupHandoffChoice(choice);
+    if (choice === 'ide') {
+        const { detectInstalledIDEs: detectIDEs } = await Promise.resolve().then(() => __importStar(require('../setup/ide-detector')));
+        const configuredIDEs = detectIDEs();
+        if (configuredIDEs.length > 0) {
+            const ideNames = configuredIDEs.map((ide) => ide.name).join(', ');
+            console.log(chalk_1.default.cyan(`\n  FRAIM is configured for: `) + chalk_1.default.white(ideNames));
+            console.log(chalk_1.default.cyan('\n  Open any of those tools and type:'));
         }
-        const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
-        const unconfiguredProviders = allProviderIds.filter(id => !tokens[id]);
-        if (unconfiguredProviders.length > 0) {
-            console.log(chalk_1.default.gray('\n  To add more platforms later:'));
-            unconfiguredProviders.forEach(id => {
-                console.log(chalk_1.default.gray(`    fraim setup --${id}`));
-            });
+        else {
+            console.log(chalk_1.default.cyan('\n  Open your AI tool and type:'));
+        }
+        const { describeConfiguredInvocationSurfaces } = await Promise.resolve().then(() => __importStar(require('../setup/ide-global-integration')));
+        const invocationSummaries = describeConfiguredInvocationSurfaces(configuredIDEs);
+        invocationSummaries.forEach((summary) => {
+            console.log(chalk_1.default.white(`    ${summary}`));
+        });
+        console.log(chalk_1.default.white('    "What can FRAIM help me with?"'));
+        console.log(chalk_1.default.gray('\n  Just tell your AI what you need — FRAIM will find the right job.'));
+        if (mode !== 'conversational') {
+            console.log(chalk_1.default.cyan('\n  To set up FRAIM in a specific project:'));
+            console.log(chalk_1.default.white('    cd your-project && fraim init-project'));
+            console.log(chalk_1.default.gray('    This enables project-specific customizations,'));
+            console.log(chalk_1.default.gray('    GitHub workflows, and team learning.'));
+            const configuredProviders = await Promise.all(Object.keys(tokens).map(async (id) => await (0, provider_registry_1.getProviderDisplayName)(id)));
+            if (configuredProviders.length > 0) {
+                console.log(chalk_1.default.gray(`\n  Platforms: ${configuredProviders.join(', ')}`));
+            }
+            const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
+            const unconfiguredProviders = allProviderIds.filter(id => !tokens[id]);
+            if (unconfiguredProviders.length > 0) {
+                console.log(chalk_1.default.gray('\n  To add more platforms later:'));
+                unconfiguredProviders.forEach(id => {
+                    console.log(chalk_1.default.gray(`    fraim setup --${id}`));
+                });
+            }
+        }
+    }
+    else {
+        // Hub path: launch the Hub with firstRun=true and let the user pick a project there.
+        const { FirstRunSessionService } = await Promise.resolve().then(() => __importStar(require('../../first-run/session-service')));
+        const svc = new FirstRunSessionService({ key: 'setup-hub-launch', projectRoot: process.cwd() });
+        const result = await svc.openHub();
+        if (result.ok) {
+            console.log(chalk_1.default.green(`\n  Hub is open at ${result.hubUrl}`));
+            console.log(chalk_1.default.gray('  Your AI employee will help you onboard your first project.'));
+        }
+        else {
+            console.log(chalk_1.default.yellow(`\n  ${result.message}`));
         }
     }
 };

package/dist/src/cli/commands/workspace-config.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workspaceConfigCommand = void 0;
+exports.runWorkspaceConfigValidate = runWorkspaceConfigValidate;
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const fraim_config_contract_1 = require("../../core/fraim-config-contract");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+function resolveConfigPath(projectRoot, explicitPath) {
+    if (explicitPath) {
+        return path_1.default.resolve(explicitPath);
+    }
+    return (0, project_fraim_paths_1.getWorkspaceConfigPath)(projectRoot ? path_1.default.resolve(projectRoot) : process.cwd());
+}
+function runWorkspaceConfigValidate(options) {
+    const configPath = resolveConfigPath(options.projectRoot, options.configPath);
+    const rawConfig = JSON.parse((0, fs_1.readFileSync)(configPath, 'utf8'));
+    (0, fraim_config_contract_1.assertValidWorkspaceFraimConfig)(rawConfig);
+    console.log(`Validated ${path_1.default.relative(process.cwd(), configPath) || (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`);
+}
+exports.workspaceConfigCommand = new commander_1.Command('workspace-config')
+    .description('Deterministically validate workspace fraim/config.json')
+    .addCommand(new commander_1.Command('validate')
+    .description('Validate fraim/config.json against the shared workspace config contract')
+    .option('--project-root <path>', 'Project root used to resolve fraim/config.json')
+    .option('--config-path <path>', 'Explicit path to fraim/config.json')
+    .action((options) => runWorkspaceConfigValidate(options)));

package/dist/src/cli/fraim.js

@@ -52,6 +52,7 @@ const mcp_1 = require("./commands/mcp");
 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 fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const program = new commander_1.Command();
@@ -93,6 +94,7 @@ program.addCommand(mcp_1.mcpCommand);
 program.addCommand(migrate_project_fraim_1.migrateProjectFraimCommand);
 program.addCommand(hub_1.hubCommand);
 program.addCommand(first_run_1.firstRunCommand);
+program.addCommand(workspace_config_1.workspaceConfigCommand);
 // Wait for async command initialization before parsing
 (async () => {
     // Import the initialization promise from setup command

package/dist/src/cli/setup/ide-global-integration.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.describeConfiguredInvocationSurfaces = describeConfiguredInvocationSurfaces;
+exports.describeOnboardingInvocationSurfaces = describeOnboardingInvocationSurfaces;
 exports.installSlashCommands = installSlashCommands;
 exports.installGlobalRules = installGlobalRules;
 /**
@@ -20,6 +21,24 @@ const ide_invocation_surfaces_1 = require("./ide-invocation-surfaces");
 function describeConfiguredInvocationSurfaces(installedIDEs) {
     return installedIDEs.map((ide) => (0, ide_invocation_surfaces_1.describeInvocationSurface)(ide.name, ide.invocationProfile));
 }
+// Returns IDE-specific onboarding commands for the post-setup routing screen.
+// Maps each IDE's invocation prefix to the project-onboarding task string so
+// the user sees the exact command to type, not a generic FRAIM invocation.
+function describeOnboardingInvocationSurfaces(installedIDEs) {
+    if (installedIDEs.length === 0)
+        return ['/fraim onboard this project'];
+    return installedIDEs.map((ide) => {
+        const profile = ide.invocationProfile;
+        if (profile === 'cursor-mention')
+            return `${ide.name}: @fraim onboard this project`;
+        if (profile === 'launch-phrase')
+            return `${ide.name}: onboard this project`;
+        if (profile === 'instructions-only')
+            return `${ide.name}: "onboard this project"`;
+        // claude-slash, vscode-prompt, codex-skill, windsurf-command, kiro-hashtag, gemini-command
+        return `${ide.name}: /fraim onboard this project`;
+    });
+}
 /**
  * Install Claude FRAIM discovery artifacts at the user level.
  * Writes a skill to ~/.claude/skills/fraim/SKILL.md and a compatibility command

package/dist/src/cli/setup/user-level-sync.js

@@ -69,6 +69,10 @@ function ensureUserLevelDependencies(userFraimDir) {
     const baseDir = userFraimDir || (0, script_sync_utils_1.getUserFraimDir)();
     const pkgPath = path_1.default.join(baseDir, 'package.json');
     const nodeModulesDir = path_1.default.join(baseDir, 'node_modules');
+    const childEnv = { ...process.env };
+    delete childEnv.NODE_CHANNEL_FD;
+    delete childEnv.NODE_CHANNEL_SERIALIZATION_MODE;
+    delete childEnv.NODE_UNIQUE_ID;
     let pkg = {};
     if (fs_1.default.existsSync(pkgPath)) {
         try {
@@ -92,6 +96,7 @@ function ensureUserLevelDependencies(userFraimDir) {
         (0, child_process_1.execSync)('npm install --no-audit --no-fund --no-save --no-package-lock --omit=dev', {
             cwd: baseDir,
             stdio: 'pipe',
+            env: childEnv,
         });
         console.log(chalk_1.default.green(`✅ Installed: ${missing.join(', ')}`));
     }

package/dist/src/cli/utils/project-bootstrap.js

@@ -22,11 +22,11 @@ function formatModeLabel(mode) {
 function getModeSpecificNextStep(mode) {
     switch (mode) {
         case 'conversational':
-            return `The agent will focus on project context, validation commands, and durable repo rules. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
+            return `The agent will create fraim/config.json during onboarding, then focus on project context, validation commands, and durable repo rules. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
         case 'split':
-            return `The agent will confirm the code-host and issue-tracker split, then ask only for the missing project details. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
+            return `The agent will create fraim/config.json during onboarding, confirm the code-host and issue-tracker split, then ask only for the missing project details. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
         default:
-            return `The agent will review the detected repo setup, then ask only for the highest-value missing project details. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
+            return `The agent will create fraim/config.json during onboarding, review the detected repo setup, then ask only for the highest-value missing project details. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
     }
 }
 function createInitProjectResult(projectName, mode) {

package/dist/src/core/fraim-config-contract.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRAIM_CONFIG_SCHEMA = void 0;
+exports.listSupportedFraimConfigPaths = listSupportedFraimConfigPaths;
+exports.isValidFraimConfigField = isValidFraimConfigField;
+exports.sanitizeFraimConfigToSchema = sanitizeFraimConfigToSchema;
+exports.validateWorkspaceFraimConfig = validateWorkspaceFraimConfig;
+exports.assertValidWorkspaceFraimConfig = assertValidWorkspaceFraimConfig;
+const fraim_config_schema_generated_1 = require("./fraim-config-schema.generated");
+exports.FRAIM_CONFIG_SCHEMA = fraim_config_schema_generated_1.FRAIM_CONFIG_SCHEMA;
+const SUPPORTED_FRAIM_CONFIG_PATHS = [...fraim_config_schema_generated_1.SUPPORTED_FRAIM_CONFIG_PATHS];
+const SUPPORTED_FRAIM_CONFIG_PATH_SET = new Set(SUPPORTED_FRAIM_CONFIG_PATHS);
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function listSupportedFraimConfigPaths() {
+    return [...SUPPORTED_FRAIM_CONFIG_PATHS];
+}
+function isValidFraimConfigField(path) {
+    if (SUPPORTED_FRAIM_CONFIG_PATH_SET.has(path)) {
+        return true;
+    }
+    for (const validField of SUPPORTED_FRAIM_CONFIG_PATH_SET) {
+        if (validField.startsWith(`${path}.`)) {
+            return true;
+        }
+    }
+    return false;
+}
+function sanitizeNode(node, value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (node.kind === 'object') {
+        if (!isPlainObject(value)) {
+            return value;
+        }
+        const sanitized = {};
+        for (const [key, child] of Object.entries(node.properties)) {
+            const childValue = sanitizeNode(child, value[key]);
+            if (childValue !== undefined) {
+                sanitized[key] = childValue;
+            }
+        }
+        return sanitized;
+    }
+    if (node.kind === 'record') {
+        if (!isPlainObject(value)) {
+            return value;
+        }
+        const sanitized = {};
+        for (const [key, entryValue] of Object.entries(value)) {
+            const childValue = sanitizeNode(node.value, entryValue);
+            if (childValue !== undefined) {
+                sanitized[key] = childValue;
+            }
+        }
+        return sanitized;
+    }
+    if (node.kind === 'array' && Array.isArray(value)) {
+        return value.map((entry) => sanitizeNode(node.element, entry));
+    }
+    return value;
+}
+function validateNode(node, value, path, issues) {
+    if (value === undefined) {
+        if (node.required) {
+            issues.push({ path, message: `${path} is required.` });
+        }
+        return;
+    }
+    switch (node.kind) {
+        case 'string':
+            if (typeof value !== 'string' || value.trim().length === 0) {
+                issues.push({ path, message: `${path} must be a non-empty string.` });
+            }
+            return;
+        case 'number':
+            if (typeof value !== 'number' || !Number.isFinite(value)) {
+                issues.push({ path, message: `${path} must be a finite number.` });
+            }
+            return;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                issues.push({ path, message: `${path} must be a boolean.` });
+            }
+            return;
+        case 'enum':
+            if (typeof value !== 'string' || !node.values.includes(value)) {
+                issues.push({ path, message: `${path} must be one of: ${node.values.join(', ')}.` });
+            }
+            return;
+        case 'array':
+            if (!Array.isArray(value)) {
+                issues.push({ path, message: `${path} must be an array.` });
+                return;
+            }
+            value.forEach((entry, index) => validateNode(node.element, entry, `${path}[${index}]`, issues));
+            return;
+        case 'record':
+            if (!isPlainObject(value)) {
+                issues.push({ path, message: `${path} must be an object.` });
+                return;
+            }
+            for (const [key, entryValue] of Object.entries(value)) {
+                validateNode(node.value, entryValue, `${path}.${key}`, issues);
+            }
+            return;
+        case 'object':
+            if (!isPlainObject(value)) {
+                issues.push({ path, message: `${path} must be an object.` });
+                return;
+            }
+            for (const key of Object.keys(value)) {
+                if (!(key in node.properties)) {
+                    issues.push({
+                        path: path ? `${path}.${key}` : key,
+                        message: `${path ? `${path}.${key}` : key} is not part of the supported FRAIM config schema.`
+                    });
+                }
+            }
+            for (const [key, child] of Object.entries(node.properties)) {
+                validateNode(child, value[key], path ? `${path}.${key}` : key, issues);
+            }
+            return;
+    }
+}
+function sanitizeFraimConfigToSchema(rawConfig) {
+    return sanitizeNode(exports.FRAIM_CONFIG_SCHEMA, rawConfig);
+}
+function validateWorkspaceFraimConfig(rawConfig) {
+    const issues = [];
+    validateNode(exports.FRAIM_CONFIG_SCHEMA, rawConfig, '', issues);
+    return issues.map((issue) => ({
+        path: issue.path || '$',
+        message: issue.message
+    }));
+}
+function assertValidWorkspaceFraimConfig(rawConfig) {
+    const issues = validateWorkspaceFraimConfig(rawConfig);
+    if (issues.length === 0) {
+        return;
+    }
+    throw new Error(`Workspace FRAIM config validation failed:\n${issues.map((issue) => `- ${issue.path}: ${issue.message}`).join('\n')}`);
+}