fraim-framework 2.0.146 → 2.0.148

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

@@ -253,22 +253,40 @@ function detectEmployees() {
         };
     });
 }
-// Rewrite a /fraim or $fraim job invocation to a direct MCP tool call instruction.
-// Gemini CLI has a /fraim command but it conflicts when both workspace-level and
-// user-level fraim.toml commands exist (Gemini renames both), making /fraim
-// unrecognised. Sending an explicit get_fraim_job instruction bypasses the slash
-// command entirely and works regardless of whether the command exists.
-function transformGeminiMessage(message) {
-    const match = message.match(/^[/$]fraim\s+(\S+)\n?([\s\S]*)$/);
+function parseFraimInvocation(message) {
+    const trimmed = message.trim();
+    if (!trimmed)
+        return null;
+    const match = trimmed.match(/^[/$]fraim(?:\s+(\S+))?\s*([\s\S]*)$/);
     if (!match)
+        return null;
+    return {
+        jobId: match[1] || null,
+        remainder: (match[2] || '').trim(),
+    };
+}
+// Rewrite UI-facing /fraim or $fraim invocations into direct MCP tool
+// instructions for headless hosts. The Hub still shows the familiar
+// invocation in the manager timeline, but the actual CLI child process
+// receives an explicit instruction that works in non-interactive mode.
+function transformHeadlessFraimMessage(message, kind) {
+    const parsed = parseFraimInvocation(message);
+    if (!parsed)
+        return message;
+    if (kind === 'continue') {
+        if (parsed.remainder) {
+            return `Continue the active FRAIM job with this manager coaching:\n\n${parsed.remainder}`;
+        }
+        return 'Continue the active FRAIM job using the current session context.';
+    }
+    if (!parsed.jobId)
         return message;
-    const jobId = match[1];
-    const instructions = match[2].trim();
     const parts = [
-        `Call the get_fraim_job MCP tool with job "${jobId}" to get the full job instructions, then follow them exactly.`,
+        `Call the get_fraim_job MCP tool with job "${parsed.jobId}" to get the full job instructions, then follow them exactly.`,
     ];
-    if (instructions)
-        parts.push(`\n\nUser instructions: ${instructions}`);
+    if (parsed.remainder) {
+        parts.push(`\n\nUser instructions: ${parsed.remainder}`);
+    }
     return parts.join('');
 }
 // If ~/.gemini/settings.json has a wrong/test FRAIM_API_KEY, patch it with the
@@ -301,7 +319,7 @@ function buildStartPlan(hostId, message) {
         return {
             command: executableName('codex'),
             args: ['exec', '--json', '--skip-git-repo-check', '--dangerously-bypass-approvals-and-sandbox'],
-            stdin: message,
+            stdin: transformHeadlessFraimMessage(message, 'start'),
         };
     }
     if (hostId === 'gemini') {
@@ -309,13 +327,13 @@ function buildStartPlan(hostId, message) {
         return {
             command: executableName('gemini'),
             args: ['--yolo', '--skip-trust'],
-            stdin: transformGeminiMessage(message),
+            stdin: transformHeadlessFraimMessage(message, 'start'),
         };
     }
     return {
         command: executableName('claude'),
         args: ['-p', '--verbose', '--output-format', 'stream-json', '--dangerously-skip-permissions'],
-        stdin: message,
+        stdin: transformHeadlessFraimMessage(message, 'start'),
     };
 }
 function buildContinuePlan(hostId, sessionId, message) {
@@ -323,7 +341,7 @@ function buildContinuePlan(hostId, sessionId, message) {
         return {
             command: executableName('codex'),
             args: ['exec', 'resume', '--json', '--skip-git-repo-check', '--dangerously-bypass-approvals-and-sandbox', sessionId],
-            stdin: message,
+            stdin: transformHeadlessFraimMessage(message, 'continue'),
         };
     }
     if (hostId === 'gemini') {
@@ -332,13 +350,13 @@ function buildContinuePlan(hostId, sessionId, message) {
         return {
             command: executableName('gemini'),
             args: ['--yolo', '--skip-trust'],
-            stdin: message,
+            stdin: transformHeadlessFraimMessage(message, 'continue'),
         };
     }
     return {
         command: executableName('claude'),
         args: ['-p', '--verbose', '--output-format', 'stream-json', '--dangerously-skip-permissions', '-r', sessionId],
-        stdin: message,
+        stdin: transformHeadlessFraimMessage(message, 'continue'),
     };
 }
 function parseHostLine(hostId, line) {

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

@@ -13,8 +13,6 @@ const os_1 = __importDefault(require("os"));
 const crypto_1 = require("crypto");
 const child_process_1 = require("child_process");
 const types_1 = require("../first-run/types");
-const persona_entitlement_service_1 = require("../services/persona-entitlement-service");
-const persona_capability_bundles_1 = require("../config/persona-capability-bundles");
 const PERSONA_AVATAR_SEEDS = {
     maestro: { seed: 'MAESTRO-founder-mode', bg: 'fde68a' },
     beza: { seed: 'BEZA-strategist', bg: 'c7d2fe' },
@@ -39,11 +37,51 @@ function buildPersonaAvatarUrl(personaKey) {
     const params = new URLSearchParams({ seed: data.seed, backgroundColor: data.bg, radius: '50' });
     return `https://api.dicebear.com/9.x/notionists/svg?${params.toString()}`;
 }
-const db_service_1 = require("../fraim/db-service");
 const catalog_1 = require("./catalog");
 const agent_token_prices_1 = require("../local-mcp-server/agent-token-prices");
 const hosts_1 = require("./hosts");
 const preferences_1 = require("./preferences");
+function loadPersonaCapabilityModule() {
+    try {
+        // Server deployments include the persona catalog. The npm client package
+        // intentionally does not, so Hub setup must degrade without loading it.
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('../config/persona-capability-bundles');
+    }
+    catch {
+        return null;
+    }
+}
+function getProtectedPersonaForHubJob(jobName) {
+    return loadPersonaCapabilityModule()?.getProtectedPersonaForJob(jobName) ?? null;
+}
+function listHubPersonaBundles() {
+    return loadPersonaCapabilityModule()?.listPersonaCapabilityBundles() ?? [];
+}
+function buildHubPersonaHireUrl(personaKey, hireMode = 'job') {
+    const params = new URLSearchParams({ persona: personaKey, mode: hireMode });
+    return `/pricing?${params.toString()}`;
+}
+async function getHubWorkspacePersonaState(dbService, userId, apiKey) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const service = require('../services/persona-entitlement-service');
+        return await service.getWorkspacePersonaState(dbService, userId, apiKey);
+    }
+    catch {
+        return null;
+    }
+}
+function createDefaultDbService() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { FraimDbService } = require('../fraim/db-service');
+        return new FraimDbService();
+    }
+    catch {
+        return undefined;
+    }
+}
 class AiHubRunRegistry {
     constructor() {
         this.runs = new Map();
@@ -358,13 +396,7 @@ class AiHubServer {
             this.dbService = options.dbService;
         }
         else {
-            try {
-                this.dbService = new db_service_1.FraimDbService();
-            }
-            catch {
-                this.dbService = undefined;
-                console.warn('[ai-hub] No dbService — personas will show as locked');
-            }
+            this.dbService = createDefaultDbService();
         }
         this.app.use(express_1.default.json());
         this.app.use('/ai-hub', express_1.default.static(resolveAiHubPublicDir()));
@@ -424,7 +456,7 @@ class AiHubServer {
         const rawJobs = (0, catalog_1.discoverEmployeeJobs)(normalizedProjectPath);
         const jobs = rawJobs.map((job) => ({
             ...job,
-            requiredPersonaKey: (0, persona_capability_bundles_1.getProtectedPersonaForJob)(job.id),
+            requiredPersonaKey: getProtectedPersonaForHubJob(job.id),
         }));
         const managerTemplates = (0, catalog_1.discoverManagerTemplates)(normalizedProjectPath);
         const { personas, subscriptionActive } = await this.computePersonas(apiKey || preferences.apiKey);
@@ -447,7 +479,7 @@ class AiHubServer {
         };
     }
     async computePersonas(apiKey) {
-        const allBundles = (0, persona_capability_bundles_1.listPersonaCapabilityBundles)();
+        const allBundles = listHubPersonaBundles();
         const fallbackPersonas = allBundles.map((bundle) => ({
             key: bundle.personaKey,
             displayName: bundle.catalogMetadata.displayName,
@@ -455,12 +487,14 @@ class AiHubServer {
             avatarUrl: buildPersonaAvatarUrl(bundle.personaKey),
             pricingLabel: bundle.catalogMetadata.pricingLabel,
             status: 'locked',
-            hireUrl: (0, persona_entitlement_service_1.buildPersonaHireUrl)(bundle.personaKey, bundle.defaultHireMode),
+            hireUrl: buildHubPersonaHireUrl(bundle.personaKey, bundle.defaultHireMode),
         }));
         if (!apiKey || !this.dbService)
             return { personas: fallbackPersonas, subscriptionActive: false };
         try {
-            const state = await (0, persona_entitlement_service_1.getWorkspacePersonaState)(this.dbService, 'anonymous', apiKey);
+            const state = await getHubWorkspacePersonaState(this.dbService, 'anonymous', apiKey);
+            if (!state)
+                return { personas: fallbackPersonas, subscriptionActive: false };
             const hiredKeys = new Set(state.entitlements
                 .filter((e) => e.status === 'active')
                 .map((e) => e.personaKey));
@@ -471,7 +505,7 @@ class AiHubServer {
                 avatarUrl: buildPersonaAvatarUrl(bundle.personaKey),
                 pricingLabel: hiredKeys.has(bundle.personaKey) ? '' : bundle.catalogMetadata.pricingLabel,
                 status: (hiredKeys.has(bundle.personaKey) ? 'hired' : 'locked'),
-                hireUrl: (0, persona_entitlement_service_1.buildPersonaHireUrl)(bundle.personaKey, bundle.defaultHireMode),
+                hireUrl: buildHubPersonaHireUrl(bundle.personaKey, bundle.defaultHireMode),
             }));
             return { personas, subscriptionActive: state.subscriptionActive };
         }
@@ -613,7 +647,7 @@ class AiHubServer {
                     phaseHistory: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
-                    personaKey: (0, persona_capability_bundles_1.getProtectedPersonaForJob)(jobId) ?? null,
+                    personaKey: getProtectedPersonaForHubJob(jobId),
                     // Gemini CLI does not emit a session ID in its output stream;
                     // pre-seed one so the Send button is enabled and the continue
                     // endpoint can proceed. continueRun for Gemini ignores it.

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework - Smart Entry Point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.146",
+  "version": "2.0.148",
   "description": "FRAIM: AI Workforce Infrastructure — the organizational capability that turns AI agents into an accountable workforce, their operators into capable AI managers, and executives into leaders with clear optics on AI proficiency.",
   "main": "index.js",
   "bin": {

package/public/ai-hub/index.html

@@ -12,7 +12,10 @@
   <div class="page">
 
     <header class="header">
-      <h1>AI Hub</h1>
+      <div class="header-copy">
+        <span class="header-eyebrow">FRAIM Hub</span>
+        <h1>AI Hub</h1>
+      </div>
       <button class="project-button" type="button" id="project-button">
         <span class="folder">Project</span>
         <strong id="project-name">Choose a folder</strong>
@@ -65,10 +68,17 @@
     <div class="layout">
       <aside class="rail">
         <button class="new-conv" type="button" id="new-conv-btn">+ New job</button>
+        <div class="rail-note">Alpha: browser shell for directing employees across your project.</div>
         <!-- R2.4: team roster — horizontal row of avatar chips per hired persona -->
-        <div class="team-roster" id="team-roster" hidden></div>
-
-        <div class="conv-list" id="conv-list"></div>
+        <section class="rail-section rail-section--employees">
+          <div class="rail-section-label">Hired employees</div>
+          <div class="team-roster" id="team-roster" hidden></div>
+        </section>
+
+        <section class="rail-section rail-section--runs">
+          <div class="rail-section-label">Runs</div>
+          <div class="conv-list" id="conv-list"></div>
+        </section>
       </aside>
 
       <main class="conversation" id="conversation">
@@ -78,12 +88,21 @@
         </div>
 
         <div id="active-conv" hidden>
+          <div class="conv-topline">
+            <div class="employee-identity" id="active-identity"></div>
+            <div class="run-state-pill" id="run-state-pill"></div>
+          </div>
+
           <div class="conv-header">
-            <h2 id="active-title"></h2>
-            <div class="conv-job" id="active-job"></div>
+            <div class="title-block">
+              <h2 id="active-title"></h2>
+              <div class="conv-job" id="active-job"></div>
+            </div>
             <div id="artifact-slot"></div>
           </div>
 
+          <div class="summary-strip" id="summary-strip"></div>
+
           <!-- Issue #347 R1: pizza tracker. Hidden when the active job
                declares no phases. Populated by renderTracker() in script.js. -->
           <div class="tracker" id="tracker" aria-label="Job progress" hidden>
@@ -96,13 +115,16 @@
             <span class="latest" id="latest"></span>
           </div>
 
-          <div class="messages" id="messages"></div>
+          <section class="thread-surface" aria-label="Manager and employee thread">
+            <div class="thread-surface-label">Manager and employee thread</div>
+            <div class="messages" id="messages"></div>
+          </section>
 
           <div class="coach">
             <div class="coach-title-row">
               <span class="section-title">Coach the employee</span>
               <span class="active-employee-row">
-                <label for="active-employee-select" class="active-employee-label">via</label>
+                <label for="active-employee-select" class="active-employee-label">tool</label>
                 <select id="active-employee-select" class="employee-select inline"></select>
               </span>
             </div>
@@ -114,6 +136,7 @@
               <button class="send-button" type="button" id="send" disabled>Send</button>
               <div class="template-popover" id="template-popover" role="menu" hidden></div>
             </div>
+            <div class="coach-note" id="coach-note"></div>
             <!-- Issue #347 R4: run-level totals. Discoverable, not dominating.
                  Populated by renderTotals() each poll tick. -->
             <div class="totals" id="totals" aria-label="Run totals" hidden></div>