fraim-framework 2.0.166 → 2.0.168

package/dist/src/core/fraim-config-schema.generated.js

@@ -138,14 +138,6 @@ exports.FRAIM_CONFIG_SCHEMA = {
                         }
                     }
                 },
-                "githubWorkflows": {
-                    "kind": "object",
-                    "properties": {
-                        "enabled": {
-                            "kind": "boolean"
-                        }
-                    }
-                },
                 "validation": {
                     "kind": "object",
                     "properties": {
@@ -312,6 +304,78 @@ exports.FRAIM_CONFIG_SCHEMA = {
                             ]
                         }
                     }
+                },
+                "recruiting": {
+                    "kind": "object",
+                    "properties": {
+                        "ats": {
+                            "kind": "object",
+                            "properties": {
+                                "provider": {
+                                    "kind": "enum",
+                                    "values": [
+                                        "greenhouse",
+                                        "lever",
+                                        "ashby",
+                                        "none"
+                                    ]
+                                },
+                                "pipeline_source": {
+                                    "kind": "enum",
+                                    "values": [
+                                        "api",
+                                        "browser",
+                                        "csv",
+                                        "manual"
+                                    ]
+                                }
+                            }
+                        },
+                        "leadgen": {
+                            "kind": "object",
+                            "properties": {
+                                "provider": {
+                                    "kind": "enum",
+                                    "values": [
+                                        "gem",
+                                        "linkedin-recruiter",
+                                        "apollo",
+                                        "outreach",
+                                        "none"
+                                    ]
+                                },
+                                "pipeline_source": {
+                                    "kind": "enum",
+                                    "values": [
+                                        "api",
+                                        "browser",
+                                        "csv",
+                                        "manual"
+                                    ]
+                                }
+                            }
+                        },
+                        "staleness_days": {
+                            "kind": "object",
+                            "properties": {
+                                "sourcing": {
+                                    "kind": "number"
+                                },
+                                "applied": {
+                                    "kind": "number"
+                                },
+                                "screen": {
+                                    "kind": "number"
+                                },
+                                "interview": {
+                                    "kind": "number"
+                                },
+                                "offer": {
+                                    "kind": "number"
+                                }
+                            }
+                        }
+                    }
                 }
             }
         },
@@ -335,23 +399,6 @@ exports.FRAIM_CONFIG_SCHEMA = {
                                 "autonomous"
                             ]
                         },
-                        "contextResolver": {
-                            "kind": "object",
-                            "properties": {
-                                "scriptPath": {
-                                    "kind": "string"
-                                },
-                                "arguments": {
-                                    "kind": "array",
-                                    "element": {
-                                        "kind": "string"
-                                    }
-                                },
-                                "timeoutMs": {
-                                    "kind": "number"
-                                }
-                            }
-                        },
                         "playbooks": {
                             "kind": "object",
                             "properties": {
@@ -560,8 +607,6 @@ exports.SUPPORTED_FRAIM_CONFIG_PATHS = [
     "customizations.designSystem",
     "customizations.designSystem.path",
     "customizations.designSystem.brand",
-    "customizations.githubWorkflows",
-    "customizations.githubWorkflows.enabled",
     "customizations.validation",
     "customizations.validation.buildCommand",
     "customizations.validation.testSuiteCommand",
@@ -600,14 +645,23 @@ exports.SUPPORTED_FRAIM_CONFIG_PATHS = [
     "integrations.itsm.accessScript",
     "integrations.identity",
     "integrations.identity.provider",
+    "integrations.recruiting",
+    "integrations.recruiting.ats",
+    "integrations.recruiting.ats.provider",
+    "integrations.recruiting.ats.pipeline_source",
+    "integrations.recruiting.leadgen",
+    "integrations.recruiting.leadgen.provider",
+    "integrations.recruiting.leadgen.pipeline_source",
+    "integrations.recruiting.staleness_days",
+    "integrations.recruiting.staleness_days.sourcing",
+    "integrations.recruiting.staleness_days.applied",
+    "integrations.recruiting.staleness_days.screen",
+    "integrations.recruiting.staleness_days.interview",
+    "integrations.recruiting.staleness_days.offer",
     "automation",
     "automation.support",
     "automation.support.startMode",
     "automation.support.defaultDecisionMode",
-    "automation.support.contextResolver",
-    "automation.support.contextResolver.scriptPath",
-    "automation.support.contextResolver.arguments",
-    "automation.support.contextResolver.timeoutMs",
     "automation.support.playbooks",
     "automation.support.playbooks.directory",
     "automation.support.playbooks.decisionCommand",

package/dist/src/core/manager-pack.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANAGER_PACK_RELATIVE_PATH_RE = exports.MANAGER_LEARNING_FILE_RE = exports.MANAGER_RULES_RELATIVE_PATH = exports.MANAGER_CONTEXT_RELATIVE_PATH = void 0;
+exports.isManagerPackRelativePath = isManagerPackRelativePath;
+exports.managerPackRelativePathForFileName = managerPackRelativePathForFileName;
+const path_1 = __importDefault(require("path"));
+exports.MANAGER_CONTEXT_RELATIVE_PATH = 'context/manager_context.md';
+exports.MANAGER_RULES_RELATIVE_PATH = 'rules/manager_rules.md';
+exports.MANAGER_LEARNING_FILE_RE = /^(?!org-)[A-Za-z0-9._%+@-]+-(mistake-patterns|preferences|manager-coaching|validated-patterns)\.md$/;
+exports.MANAGER_PACK_RELATIVE_PATH_RE = /^(context\/manager_context\.md|rules\/manager_rules\.md|learnings\/(?!org-)[A-Za-z0-9._%+@-]+-(mistake-patterns|preferences|manager-coaching|validated-patterns)\.md)$/;
+function isManagerPackRelativePath(value) {
+    return exports.MANAGER_PACK_RELATIVE_PATH_RE.test(value);
+}
+function managerPackRelativePathForFileName(fileName) {
+    const base = path_1.default.basename(fileName);
+    if (base === 'manager_context.md')
+        return exports.MANAGER_CONTEXT_RELATIVE_PATH;
+    if (base === 'manager_rules.md')
+        return exports.MANAGER_RULES_RELATIVE_PATH;
+    if (exports.MANAGER_LEARNING_FILE_RE.test(base))
+        return `learnings/${base}`;
+    return null;
+}

package/dist/src/core/utils/local-registry-resolver.js

@@ -371,9 +371,11 @@ class LocalRegistryResolver {
         if (!this.hasLocalOverride(path)) {
             const syncedLocalContent = this.readSyncedLocalFile(path);
             if (syncedLocalContent !== null) {
+                // Synced baseline (fraim/ai-employee), not personalized.
                 return {
                     content: syncedLocalContent,
                     source: 'local',
+                    personalized: false,
                     inherited: false
                 };
             }
@@ -384,6 +386,7 @@ class LocalRegistryResolver {
                 return {
                     content,
                     source: 'remote',
+                    personalized: false,
                     inherited: false
                 };
             }
@@ -408,6 +411,7 @@ class LocalRegistryResolver {
             return {
                 content,
                 source: 'remote',
+                personalized: false,
                 inherited: false
             };
         }
@@ -422,13 +426,16 @@ class LocalRegistryResolver {
             return {
                 content,
                 source: 'remote',
+                personalized: false,
                 inherited: false
             };
         }
-        // Build result
+        // Build result — a local override hit means this came from the
+        // personalized-employee layer (the manager taught/customized it).
         const result = {
             content: resolved.content,
             source: 'local',
+            personalized: true,
             inherited: resolved.imports.length > 0,
             imports: resolved.imports.length > 0 ? resolved.imports : undefined
         };

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

@@ -31,6 +31,7 @@ function createInitialFirstRunState(key) {
         installKeyRef: maskInstallKey(key),
         platform: process.platform,
         agentId: 'claude-code',
+        agentInstalls: {},
         rows: (0, types_1.createInitialRows)(),
         resourcesUrl: types_1.FIRST_RUN_RESOURCES_URL,
         createdAt: now,

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

@@ -272,6 +272,15 @@ class FirstRunServer {
                 return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not check agent.' });
             }
         });
+        this.app.post('/api/first-run/done-recruiting', async (_req, res) => {
+            try {
+                const result = await this.sessionService.finishAgentRecruiting();
+                return res.json(result);
+            }
+            catch (error) {
+                return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not finish local agent setup.' });
+            }
+        });
         // 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 that survives independently.

package/dist/src/first-run/session-service.js

@@ -184,6 +184,14 @@ function buildConfiguredSurfaces() {
         status: 'configured',
     }));
 }
+function surfaceForAgent(option) {
+    return {
+        id: option.id,
+        name: option.label,
+        invocationHint: `${option.label}: /fraim onboard this project`,
+        status: 'configured',
+    };
+}
 class FirstRunSessionService {
     constructor(options) {
         this.key = options.key;
@@ -294,15 +302,15 @@ class FirstRunSessionService {
     }
     updateAgentSummaryRow() {
         const agentRow = this.getRow('agent');
-        const surfaces = this.fakeMode === 'no-agents' ? [] : buildConfiguredSurfaces();
+        const surfaces = this.getConfiguredAgentSurfaces();
         if (surfaces.length > 0) {
             agentRow.status = 'ok';
-            agentRow.verb = `${surfaces.length} AI Employee${surfaces.length === 1 ? '' : 's'} ready`;
+            agentRow.verb = `${surfaces.length} local AI agent${surfaces.length === 1 ? '' : 's'} ready`;
             agentRow.detail = surfaces.map((surface) => surface.name).join(', ');
         }
         else {
             agentRow.status = 'manual-required';
-            agentRow.verb = "let's recruit AI Employees";
+            agentRow.verb = 'No problem, we will install AI agents next.';
             delete agentRow.detail;
         }
         this.state.setupResult = {
@@ -313,6 +321,36 @@ class FirstRunSessionService {
             completedAt: new Date().toISOString(),
         };
     }
+    getReadyInstalledAgentSurfaces() {
+        const installs = this.state.agentInstalls || {};
+        return types_1.FIRST_RUN_AGENT_OPTIONS
+            .filter((option) => installs[option.id]?.status === 'ready')
+            .map(surfaceForAgent);
+    }
+    getConfiguredAgentSurfaces() {
+        const byId = new Map();
+        for (const surface of this.getReadyInstalledAgentSurfaces()) {
+            byId.set(surface.id, surface);
+        }
+        if (this.fakeMode !== 'no-agents') {
+            for (const surface of buildConfiguredSurfaces()) {
+                byId.set(surface.id, surface);
+            }
+        }
+        return Array.from(byId.values());
+    }
+    setAgentInstallStatus(agentId, status, message) {
+        const option = findAgentOption(agentId);
+        if (!option)
+            return;
+        this.state.agentInstalls = this.state.agentInstalls || {};
+        this.state.agentInstalls[agentId] = {
+            status,
+            label: option.label,
+            updatedAt: new Date().toISOString(),
+            ...(message ? { message } : {}),
+        };
+    }
     applyFakeStateOnLoad(mode) {
         const setStatus = (rowId, status, verb, detail) => {
             const row = this.getRow(rowId);
@@ -325,7 +363,7 @@ class FirstRunSessionService {
             setStatus('node', 'pending', "we'll install");
             setStatus('git', 'pending', "we'll install");
             setStatus('fraim', 'pending', "we'll install");
-            setStatus('agent', 'pending', "we'll check for AI Employees");
+            setStatus('agent', 'pending', "we'll check for local AI agents");
             delete this.state.setupResult;
             return;
         }
@@ -333,7 +371,7 @@ class FirstRunSessionService {
             setStatus('node', 'ok', 'v20.11.1 detected');
             setStatus('git', 'ok', 'git version 2.45 detected');
             setStatus('fraim', 'ok', 'fraim-framework detected');
-            setStatus('agent', 'ok', '1 AI Employee ready', 'Claude Code');
+            setStatus('agent', 'ok', '1 local AI agent ready', 'Claude Code');
             this.state.setupResult = {
                 mode: 'conversational',
                 configuredSurfaces: [
@@ -348,8 +386,8 @@ class FirstRunSessionService {
         if (mode === 'no-agents') {
             setStatus('node', 'ok', 'v20.11.1 detected');
             setStatus('git', 'ok', 'git version 2.45 detected');
-            setStatus('fraim', 'ok', 'fraim-framework detected');
-            setStatus('agent', 'manual-required', "let's recruit AI Employees");
+            setStatus('fraim', 'pending', "we'll configure FRAIM after local agents are ready");
+            setStatus('agent', 'manual-required', 'No problem, we will install AI agents next.');
             this.state.setupResult = {
                 mode: 'conversational',
                 configuredSurfaces: [],
@@ -363,7 +401,7 @@ class FirstRunSessionService {
             setStatus('node', 'ok', 'v20.11.1 installed');
             setStatus('git', 'ok', '2.45 installed');
             setStatus('fraim', 'ok', 'fraim-framework installed');
-            setStatus('agent', 'pending', "we'll check for AI Employees");
+            setStatus('agent', 'pending', "we'll check for local AI agents");
             delete this.state.setupResult;
             return;
         }
@@ -371,7 +409,7 @@ class FirstRunSessionService {
         setStatus('node', 'ok', 'v20.11.1 detected');
         setStatus('git', 'ok', 'git version 2.45 detected');
         setStatus('fraim', 'ok', 'fake-mode fraim installed');
-        setStatus('agent', 'ok', 'fake-mode AI Employee ready', 'Claude Code');
+        setStatus('agent', 'ok', 'fake-mode local AI agent ready', 'Claude Code');
         this.state.setupResult = {
             mode: 'conversational',
             configuredSurfaces: [
@@ -493,16 +531,31 @@ class FirstRunSessionService {
         this.persist();
         return this.respond('git not found — continuing without it. Install git later if you plan to do code delivery work.', true);
     }
-    async runFraimRow() {
+    async runFraimRow(forceConfigure = false) {
         const row = this.getRow('fraim');
         if (this.fakeMode) {
             row.status = 'ok';
             row.verb = 'FRAIM ready (fake-mode)';
+            const surfaces = this.getConfiguredAgentSurfaces();
+            this.state.setupResult = {
+                mode: 'conversational',
+                configuredSurfaces: surfaces,
+                failedSurfaces: [],
+                detectedSurfaceCount: surfaces.length,
+                completedAt: new Date().toISOString(),
+            };
             this.persist();
             return this.respond('Fake-mode fraim ok.', true);
         }
         try {
-            if (!commandVersion('fraim')) {
+            if (!forceConfigure && !commandVersion('fraim')) {
+                const prefix = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'node');
+                fs_1.default.mkdirSync(prefix, { recursive: true });
+                row.streamOutput = 'Installing FRAIM on this machine...';
+                this.persist();
+                await runProcess('npm', ['install', '-g', 'fraim@latest'], { npm_config_prefix: prefix });
+            }
+            else if (forceConfigure && !commandVersion('fraim')) {
                 const prefix = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'node');
                 fs_1.default.mkdirSync(prefix, { recursive: true });
                 row.streamOutput = 'Installing FRAIM on this machine...';
@@ -526,6 +579,14 @@ class FirstRunSessionService {
             row.status = 'ok';
             row.verb = 'Ready — open a new terminal before running fraim commands.';
             delete row.streamOutput;
+            const surfaces = this.getConfiguredAgentSurfaces();
+            this.state.setupResult = {
+                mode: 'conversational',
+                configuredSurfaces: surfaces,
+                failedSurfaces: [],
+                detectedSurfaceCount: surfaces.length,
+                completedAt: new Date().toISOString(),
+            };
             this.persist();
             return this.respond('FRAIM is ready. Open a new terminal window so your PATH update takes effect before running fraim commands.', true);
         }
@@ -543,7 +604,7 @@ class FirstRunSessionService {
         const row = this.getRow('agent');
         if (request.errorActionId === 'skip') {
             row.status = 'manual-required';
-            row.verb = "let's recruit AI Employees";
+            row.verb = 'No problem, we will install AI agents next.';
             this.state.setupResult = {
                 mode: 'conversational',
                 configuredSurfaces: [],
@@ -552,21 +613,21 @@ class FirstRunSessionService {
                 completedAt: new Date().toISOString(),
             };
             this.persist();
-            return this.respond('AI Employee recruiting deferred.', true);
+            return this.respond('A local AI agent is required before FRAIM setup can finish.', false);
         }
         if (this.fakeMode === 'agent-install-fails') {
-            this.setRowError(row, 'Checking for installed AI Employees and configuring one for this project', this.fakeStderr, [
+            this.setRowError(row, 'Checking for installed local AI agents and configuring one for this project', this.fakeStderr, [
                 { id: 'retry', label: 'Retry', variant: 'primary' },
                 { id: 'alternative', label: 'Try alternative', variant: 'secondary' },
-                { id: 'skip', label: 'Skip and continue', variant: 'ghost' },
+                { id: 'alternative', label: 'Manual setup help', variant: 'ghost' },
             ]);
             this.persist();
-            return this.respond('AI Employee recruiting failed.', false);
+            return this.respond('Local AI agent setup failed.', false);
         }
         this.updateAgentSummaryRow();
         this.persist();
         const count = this.state.setupResult?.detectedSurfaceCount || 0;
-        return this.respond(count > 0 ? 'AI Employees are ready.' : 'No AI Employees found.', true);
+        return this.respond(count > 0 ? 'Local AI agents are ready.' : 'No problem, we will install AI agents next.', true);
     }
     /**
      * Update the current agent selection (inline `Change…` picker).
@@ -617,7 +678,20 @@ class FirstRunSessionService {
         if (!option) {
             return { ok: false, message: `Unknown agent: ${agentId}` };
         }
+        this.setAgentInstallStatus(agentId, 'installing', `Installing ${option.label}.`);
+        this.persist();
         if (this.fakeMode) {
+            if (this.fakeMode === 'agent-install-fails') {
+                const stderr = process.env.FRAIM_FIRST_RUN_FAKE_STDERR || `Failed to install ${option.label}.`;
+                this.setAgentInstallStatus(agentId, 'failed', stderr);
+                this.persist();
+                return {
+                    ok: false,
+                    message: stderr,
+                };
+            }
+            this.setAgentInstallStatus(agentId, 'needs-sign-in', `Sign in to ${option.label} to activate it.`);
+            this.persist();
             return {
                 ok: true,
                 message: `${option.label} installed successfully.`,
@@ -634,11 +708,9 @@ class FirstRunSessionService {
             if (!ver) {
                 throw new Error(`${option.label} install completed, but the CLI is not runnable from FRAIM's managed PATH.`);
             }
-            const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
-            if (detectedIDEs.length > 0) {
-                await (0, auto_mcp_setup_1.autoConfigureMCP)(this.key, {}, detectedIDEs.map((ide) => ide.name), {});
-            }
+            this.setAgentInstallStatus(agentId, 'needs-sign-in', `Sign in to ${option.label} to activate it.`);
             appendInstallLog(`agent-installed ${agentId}`);
+            this.persist();
             return {
                 ok: true,
                 message: `${option.label} installed successfully.`,
@@ -649,6 +721,8 @@ class FirstRunSessionService {
         }
         catch (error) {
             const detail = error instanceof Error ? error.message : 'Unknown error';
+            this.setAgentInstallStatus(agentId, 'failed', detail);
+            this.persist();
             appendInstallLog(`agent-install-failed ${agentId} ${detail}`);
             return { ok: false, message: `Failed to install ${option.label}: ${detail}` };
         }
@@ -683,20 +757,40 @@ class FirstRunSessionService {
             return { ok: false, ready: false, message: `Unknown agent: ${agentId}` };
         }
         if (this.fakeMode) {
+            this.setAgentInstallStatus(agentId, 'ready', `${option.label} is ready.`);
+            this.updateAgentSummaryRow();
+            this.persist();
             return { ok: true, ready: true, message: `${option.label} is ready (fake-mode).` };
         }
         const ver = commandVersion(option.launchCommand, (0, managed_agent_paths_1.getManagedAgentBinDirs)());
         if (ver) {
+            this.setAgentInstallStatus(agentId, 'ready', `${option.label} is ready.`);
             this.updateAgentSummaryRow();
             this.persist();
             return { ok: true, ready: true, message: `${option.label} is ready.` };
         }
+        this.setAgentInstallStatus(agentId, 'needs-sign-in', `${option.label} is not detected yet.`);
+        this.persist();
         return {
             ok: true,
             ready: false,
             message: `${option.label} is not detected yet. Make sure sign-in is complete and try again.`,
         };
     }
+    async finishAgentRecruiting() {
+        this.updateAgentSummaryRow();
+        const readyCount = this.state.setupResult?.detectedSurfaceCount || 0;
+        if (readyCount < 1) {
+            this.persist();
+            return this.respond('At least one local AI agent is required before FRAIM setup can finish.', false);
+        }
+        const fraimRow = this.getRow('fraim');
+        fraimRow.status = 'pending';
+        fraimRow.verb = 'configuring FRAIM for local AI agents';
+        this.persist();
+        appendInstallLog(`agent-recruiting-complete ready=${readyCount}`);
+        return this.runFraimRow(true);
+    }
     openTerminalWithCommand(command) {
         if (process.platform === 'win32') {
             (0, child_process_1.spawn)('cmd.exe', ['/c', 'start', 'cmd.exe', '/k', command], { detached: true, stdio: 'ignore' }).unref();
@@ -730,7 +824,7 @@ class FirstRunSessionService {
     async openHub() {
         if (this.fakeMode) {
             // Tests don't actually want a Hub server running — just confirm intent.
-            return { ok: true, message: 'Fake-mode Hub open requested.', hubUrl: 'http://127.0.0.1:0/ai-hub/?firstRun=true' };
+            return { ok: true, message: 'Fake-mode Hub open requested.', hubUrl: 'http://127.0.0.1:0/ai-hub/' };
         }
         // Hub launches a real CLI process, so folder-only config surfaces are not
         // enough here. Require a runnable command in the managed or ambient PATH.
@@ -748,7 +842,7 @@ class FirstRunSessionService {
             const port = await findAvailablePort(43091);
             const hubServer = new AiHubServer({ projectPath: this.state.workspacePath });
             await hubServer.start(port);
-            const hubUrl = `http://127.0.0.1:${port}/ai-hub/?firstRun=true`;
+            const hubUrl = `http://127.0.0.1:${port}/ai-hub/`;
             appendInstallLog(`hub-opened ${hubUrl}`);
             return {
                 ok: true,

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

@@ -16,8 +16,8 @@ exports.derivePrimaryButtonLabel = derivePrimaryButtonLabel;
 exports.FIRST_RUN_ROW_IDS = [
     'node',
     'git',
-    'fraim',
     'agent',
+    'fraim',
 ];
 exports.FIRST_RUN_PROMPT = 'Onboard this project';
 exports.FIRST_RUN_RESOURCES_URL = 'https://fraimworks.ai/resources.html';
@@ -67,8 +67,8 @@ function createInitialRows() {
     return [
         { id: 'node', label: 'Node.js', status: 'pending', verb: "we'll install" },
         { id: 'git', label: 'git', status: 'pending', verb: "we'll install", optional: true },
+        { id: 'agent', label: 'Locally installed AI agents', status: 'pending', verb: "we'll detect local AI agents" },
         { id: 'fraim', label: 'FRAIM', status: 'pending', verb: "we'll set up FRAIM" },
-        { id: 'agent', label: 'Execution surfaces', status: 'pending', verb: "we'll detect execution surfaces" },
     ];
 }
 /**
@@ -87,9 +87,6 @@ function derivePrimaryButtonLabel(rows) {
     if (allOk)
         return 'Get Started';
     // Skip-path: every required row is ok-or-manual-required — nothing left for the wizard.
-    if (required.every((row) => row.status === 'ok' || row.status === 'manual-required')) {
-        return 'Get Started';
-    }
     if (required.some((row) => row.status === 'ok'))
         return 'Continue';
     return 'Set up FRAIM';