fraim-framework 2.0.184 → 2.0.186

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

@@ -56,6 +56,7 @@ const hosts_1 = require("./hosts");
 const manager_turns_1 = require("./manager-turns");
 const preferences_1 = require("./preferences");
 const conversation_store_1 = require("./conversation-store");
+const remote_hub_gateway_1 = require("./remote-hub-gateway");
 const managed_browser_1 = require("./managed-browser");
 const managed_agent_paths_1 = require("../cli/utils/managed-agent-paths");
 let personaHiringModule;
@@ -137,29 +138,6 @@ function buildHubManagerHiringCatalog() {
         roles: {},
     };
 }
-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;
-    }
-}
-function supportsManagerSeatAssignments(dbService) {
-    return typeof dbService.countHubManagerAssignments === 'function';
-}
 class AiHubRunRegistry {
     constructor() {
         this.runs = new Map();
@@ -249,6 +227,9 @@ function safeHttpUrl(value) {
 }
 // ─── Issue #578: Deployment + Host stores ─────────────────────────────────────
 const VALID_EMPLOYEE_IDS = ['codex', 'claude', 'gemini', 'copilot'];
+function startSessionSeedForHost(hostId, runId) {
+    return hostId === 'gemini' ? undefined : runId;
+}
 class DeploymentStore {
     constructor(filePath) {
         this.filePath = filePath ?? path_1.default.join(getUserHubDir(), 'hub-deployments.json');
@@ -398,19 +379,22 @@ function normalizeReviewHandoff(raw) {
         const url = safeHttpUrl(rawTarget?.url);
         if (!url)
             return null;
+        if (artifacts.length > 0)
+            return null;
         return {
             reviewRequired: true,
             reviewTarget: { type: 'pull_request', label: targetLabel || 'Pull request', url },
-            artifacts,
+            artifacts: [],
             summary: typeof value.summary === 'string' ? value.summary.trim() : '',
             feedbackMode: typeof value.feedbackMode === 'string' ? value.feedbackMode.trim() : 'pull_request_comments',
         };
     }
-    if (targetType === 'artifact_set' && artifacts.length > 0) {
+    const fileArtifacts = artifacts.filter((artifact) => artifact.path && !artifact.url);
+    if (targetType === 'artifact_set' && fileArtifacts.length > 0 && fileArtifacts.length === artifacts.length) {
         return {
             reviewRequired: true,
             reviewTarget: { type: 'artifact_set', label: targetLabel || `${artifacts.length} artifact${artifacts.length === 1 ? '' : 's'}` },
-            artifacts,
+            artifacts: fileArtifacts,
             summary: typeof value.summary === 'string' ? value.summary.trim() : '',
             feedbackMode: typeof value.feedbackMode === 'string' ? value.feedbackMode.trim() : 'inline',
         };
@@ -573,31 +557,6 @@ function extractDelegationLedgerFromText(text) {
     }
     return null;
 }
-const ARTIFACT_EXCLUDE_RE = /(^|[\\/])(retrospectives|evidence|learnings|mocks|raw|archive)[\\/]/i;
-function extractReviewArtifactsFromText(text, projectPath) {
-    if (!text)
-        return [];
-    const artifacts = [];
-    const seen = new Set();
-    const matches = String(text)
-        .split(/[\s`"'()<>{}\[\],;:]+/)
-        .filter((token) => /^(docs|public|src|tests)[\\/]/.test(token));
-    for (const candidate of matches) {
-        const relativePath = candidate.replace(/[.)]+$/g, '').replace(/\\/g, '/');
-        if (!/\.[A-Za-z0-9]+$/.test(relativePath))
-            continue;
-        if (ARTIFACT_EXCLUDE_RE.test(relativePath))
-            continue;
-        const parts = relativePath.split('/').filter(Boolean);
-        const name = parts[parts.length - 1] || relativePath;
-        const artifactPath = path_1.default.isAbsolute(relativePath) ? relativePath : path_1.default.join(projectPath, relativePath);
-        if (seen.has(artifactPath))
-            continue;
-        seen.add(artifactPath);
-        artifacts.push({ type: path_1.default.extname(name).replace(/^\./, '') || 'file', label: name, path: artifactPath });
-    }
-    return artifacts;
-}
 function applyReviewProjection(run, text) {
     const delegation = extractDelegationLedgerFromText(text);
     if (delegation) {
@@ -610,41 +569,9 @@ function applyReviewProjection(run, text) {
     const handoff = extractReviewHandoffFromText(text);
     if (handoff) {
         run.reviewHandoff = handoff;
-        run.artifacts = handoff.artifacts;
+        run.artifacts = handoff.reviewTarget?.type === 'artifact_set' ? handoff.artifacts : [];
         return;
     }
-    const artifacts = extractReviewArtifactsFromText(text, run.projectPath);
-    if (!artifacts.length)
-        return;
-    run.artifacts = run.artifacts || [];
-    for (const artifact of artifacts) {
-        if (!run.artifacts.some((entry) => (entry.path && artifact.path && entry.path === artifact.path) || (entry.url && artifact.url && entry.url === artifact.url))) {
-            run.artifacts.push(artifact);
-        }
-    }
-}
-function mergeReviewArtifacts(existing, discovered) {
-    const merged = [...(existing || [])];
-    for (const artifact of discovered) {
-        if (!merged.some((entry) => (entry.path && artifact.path && entry.path === artifact.path) || (entry.url && artifact.url && entry.url === artifact.url))) {
-            merged.push(artifact);
-        }
-    }
-    return merged;
-}
-function extractRunReviewArtifacts(run) {
-    const discovered = [];
-    for (const message of run.messages || []) {
-        if (message.role !== 'employee')
-            continue;
-        discovered.push(...extractReviewArtifactsFromText(message.text, run.projectPath));
-    }
-    for (const event of run.events || []) {
-        if (event.channel !== 'stdout')
-            continue;
-        discovered.push(...extractReviewArtifactsFromText(event.text, run.projectPath));
-    }
-    return mergeReviewArtifacts(run.artifacts, discovered);
 }
 function emptyTotals() {
     return {
@@ -663,6 +590,42 @@ function emptyTotals() {
         },
     };
 }
+const PHASE_STATUSES = new Set(['starting', 'complete', 'incomplete', 'failure']);
+function normalizePersistedPhaseHistory(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return null;
+        const raw = entry;
+        if (typeof raw.phaseId !== 'string' || !raw.phaseId)
+            return null;
+        const latestStatus = typeof raw.latestStatus === 'string' && PHASE_STATUSES.has(raw.latestStatus)
+            ? raw.latestStatus
+            : null;
+        return {
+            phaseId: raw.phaseId,
+            enteredAt: typeof raw.enteredAt === 'string' ? raw.enteredAt : new Date().toISOString(),
+            latestStatus,
+            latestText: typeof raw.latestText === 'string' ? raw.latestText : null,
+        };
+    })
+        .filter((entry) => Boolean(entry));
+}
+function readPersistedRunProjection(conversation) {
+    const rawRun = conversation?.run;
+    if (!rawRun || typeof rawRun !== 'object')
+        return null;
+    const value = rawRun;
+    return {
+        currentPhase: typeof value.currentPhase === 'string' ? value.currentPhase : null,
+        phaseHistory: normalizePersistedPhaseHistory(value.phaseHistory),
+        stages: Array.isArray(value.stages) ? value.stages : [],
+        totals: value.totals && typeof value.totals === 'object' ? value.totals : null,
+        runDiscriminant: typeof value.runDiscriminant === 'string' ? value.runDiscriminant : null,
+    };
+}
 // Issue #347 — apply per-turn usage from the host stream into the
 // run's tokenTotals. Idempotent on the same turn (we replace, not add)
 // because Codex's `turn.completed.usage` is cumulative, not delta.
@@ -750,8 +713,13 @@ function applySeekMentoringSignal(run, signal) {
     const callJobId = signal.jobId || signal.jobName;
     if (callJobId && targetJobId && callJobId !== targetJobId)
         return;
-    if (signal.reviewHandoff)
-        run.reviewHandoff = signal.reviewHandoff;
+    if (signal.reviewHandoff) {
+        const normalizedReviewHandoff = normalizeReviewHandoff(signal.reviewHandoff);
+        run.reviewHandoff = normalizedReviewHandoff || signal.reviewHandoff;
+        run.artifacts = normalizedReviewHandoff?.reviewTarget?.type === 'artifact_set'
+            ? normalizedReviewHandoff.artifacts
+            : [];
+    }
     if (signal.delegationLedger &&
         run.jobId === 'fully-delegate' &&
         signal.phaseStatus === 'complete' &&
@@ -837,20 +805,17 @@ function deriveStages(run, projectPath) {
     }
     return declaredPath.map((phase, index) => {
         let state;
-        if (currentIndex < 0) {
-            state = 'upcoming';
-        }
-        else if (index < currentIndex) {
-            state = 'done';
-        }
-        else if (index === currentIndex) {
+        const entry = historyMap.get(phase.id);
+        if (index === currentIndex) {
             // If the agent has already reported this phase as 'complete', advance
             // its visual state to 'done' so the tracker doesn't look frozen while
             // waiting for the agent to start the next phase (e.g. after
             // implement-submission completes but before address-feedback starts).
-            const entry = historyMap.get(phase.id);
             state = entry?.latestStatus === 'complete' ? 'done' : 'current';
         }
+        else if (entry?.latestStatus === 'complete' || (currentIndex >= 0 && index < currentIndex && entry)) {
+            state = 'done';
+        }
         else {
             state = 'upcoming';
         }
@@ -1154,14 +1119,14 @@ class AiHubServer {
             explicitPath: process.env.FRAIM_BROWSER_PATH || undefined,
         });
         this.hostRuntime = options.hostRuntime || (process.env.FRAIM_AI_HUB_FAKE_HOST === '1' ? new hosts_1.FakeHostRuntime() : new hosts_1.CliHostRuntime());
-        if (options.dbService !== undefined) {
-            this.dbService = options.dbService;
-            this.ownsDbService = false;
-        }
-        else {
-            this.dbService = createDefaultDbService();
-            this.ownsDbService = this.dbService !== undefined;
-        }
+        // Issue #701: the AI Hub is a loopback companion that never touches MongoDB directly —
+        // on every machine (dev, CI, prod) it resolves persona/manager-team state from the hosted
+        // server through the same code path. The hosted server is the sole owner of DB access.
+        // A dbService is used ONLY when explicitly injected (e.g. the hosted server embedding the
+        // Hub, or a test); it is never auto-created, so there is no dev/prod divergence.
+        this.dbService = options.dbService;
+        this.ownsDbService = false;
+        this.remoteGateway = options.remoteGateway ?? new remote_hub_gateway_1.HttpHubRemoteGateway();
         this.deploymentStore = options.deploymentStore ?? new DeploymentStore();
         this.hostConfigStore = options.hostConfigStore ?? new HostConfigStore();
         this.app.use(express_1.default.json({ limit: '10mb' }));
@@ -1429,8 +1394,9 @@ class AiHubServer {
             requiredPersonaKey: getProtectedPersonaForHubJob(job.id),
         }));
         const managerTemplates = (0, catalog_1.discoverManagerTemplates)(normalizedProjectPath, catalogOptions);
-        const { personas, subscriptionActive, workspaceId, userKey } = await this.computePersonas(apiKey || preferences.apiKey);
-        const managerTeam = await this.computeManagerTeam(workspaceId, userKey);
+        const resolvedApiKey = apiKey || preferences.apiKey;
+        const { personas, subscriptionActive, workspaceId, userKey } = await this.computePersonas(resolvedApiKey);
+        const managerTeam = await this.computeManagerTeam(resolvedApiKey);
         const projects = this.knownProjects(normalizedProjectPath);
         preferences = { ...preferences, projectPath: normalizedProjectPath, projects };
         this.preferencesStore.save(preferences);
@@ -1469,6 +1435,7 @@ class AiHubServer {
     }
     conversationRecordFromRun(run) {
         const lastUpdatedAt = run.updatedAt || new Date().toISOString();
+        const stages = deriveStages(run, run.projectPath);
         return {
             id: run.conversationId || run.id,
             projectPath: path_1.default.resolve(run.projectPath),
@@ -1503,6 +1470,13 @@ class AiHubServer {
             compareRunId: run.compareRunId || null,
             // Issue #578: preserve trigger source so the UI can render the chip.
             sourceTrigger: run.sourceTrigger,
+            run: {
+                stages,
+                currentPhase: run.currentPhase || null,
+                phaseHistory: run.phaseHistory || [],
+                totals: run.totals || null,
+                runDiscriminant: run.runDiscriminant || null,
+            },
         };
     }
     persistRunConversation(run, activeId) {
@@ -1614,8 +1588,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -1637,7 +1613,7 @@ class AiHubServer {
                 }
                 this.runRegistry.dispose(childRun.id);
             },
-        }, childRun.sessionId);
+        }, startSessionSeedForHost(managerRun.hostId, childRun.id));
         this.runRegistry.attachChildIfRunning(childRun.id, child);
     }
     notifyManagerOfDelegatedChild(managerRunId, childRun) {
@@ -1761,8 +1737,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -1834,14 +1812,48 @@ class AiHubServer {
         };
     }
     resolveHubJob(projectPath, jobId) {
+        if (!jobId || jobId === '__freeform__')
+            return null;
         const employeeJob = (0, catalog_1.discoverEmployeeJobs)(projectPath).find((job) => job.id === jobId);
-        if (employeeJob)
-            return { id: employeeJob.id, stubPath: employeeJob.stubPath };
+        if (employeeJob) {
+            return {
+                id: employeeJob.id,
+                title: employeeJob.title,
+                stubPath: employeeJob.stubPath,
+                personaKey: employeeJob.requiredPersonaKey ?? getProtectedPersonaForHubJob(employeeJob.id),
+            };
+        }
         const managerTemplate = (0, catalog_1.discoverManagerTemplates)(projectPath).find((job) => job.id === jobId);
-        if (managerTemplate)
-            return { id: managerTemplate.id, stubPath: managerTemplate.stubPath };
+        if (managerTemplate) {
+            return {
+                id: managerTemplate.id,
+                title: managerTemplate.title,
+                stubPath: managerTemplate.stubPath,
+                personaKey: getProtectedPersonaForHubJob(managerTemplate.id),
+            };
+        }
         return null;
     }
+    applySeekMentoringSignalToRun(run, signal) {
+        this.maybePromoteFreeformRunToJob(run, signal.jobId || signal.jobName);
+        applySeekMentoringSignal(run, signal);
+    }
+    applyFraimJobSignalToRun(run, signal) {
+        this.maybePromoteFreeformRunToJob(run, signal.jobId);
+    }
+    maybePromoteFreeformRunToJob(run, signalJobId) {
+        const normalizedJobId = (signalJobId || '').trim().toLowerCase();
+        if (run.jobId !== '__freeform__' || !normalizedJobId)
+            return;
+        const metadata = this.resolveHubJob(run.projectPath, normalizedJobId);
+        if (!metadata)
+            return;
+        run.jobId = metadata.id;
+        run.jobTitle = metadata.title;
+        run.personaKey = metadata.personaKey;
+        run.updatedAt = new Date().toISOString();
+        run.events.push((0, hosts_1.createHubEvent)('system', `Recognized FRAIM job ${metadata.id} from structured telemetry.`));
+    }
     // Lightweight markdown → .docx. Shared by the GET (file path) and POST (inline
     // content) export routes so a conversational deliverable with no on-disk file
     // can still be downloaded for Word annotation.
@@ -1906,18 +1918,18 @@ class AiHubServer {
             seatCount: 0,
             seatsInUse: 0,
         }));
-        if (!this.dbService) {
-            return { personas: fallbackPersonas, subscriptionActive: false, workspaceId: null, userKey: null };
-        }
         try {
-            const state = await getHubWorkspacePersonaState(this.dbService, getHubUserEmail(), apiKey ?? '');
+            // Issue #701: persona state comes from the hosted server (GET /api/personas/me)
+            // via the user's API key — never a local MongoDB connection. A null result means
+            // no/expired key or the feature is off; render the locked fallback (not-signed-in).
+            const state = await this.remoteGateway.getPersonaState(apiKey);
             if (!state) {
                 return { personas: fallbackPersonas, subscriptionActive: false, workspaceId: null, userKey: null };
             }
             // Legacy bypass: persona gating is not active for this workspace, so all personas are accessible.
             // Mirrors the evaluatePersonaAccess legacy bypass in persona-entitlement-service.ts.
+            // Seats are not assignable on legacy workspaces (the hosted server is always DB-backed).
             if (!state.subscriptionActive) {
-                const legacySeatCount = supportsManagerSeatAssignments(this.dbService) ? 0 : 1;
                 const allPersonas = allBundles.map((bundle) => ({
                     key: bundle.personaKey,
                     displayName: bundle.catalogMetadata.displayName,
@@ -1926,7 +1938,7 @@ class AiHubServer {
                     pricingLabel: '',
                     status: 'hired',
                     hireUrl: buildHubPersonaHireUrl(bundle.personaKey, bundle.defaultHireMode),
-                    seatCount: legacySeatCount,
+                    seatCount: 0,
                     seatsInUse: 0,
                 }));
                 return { personas: allPersonas, subscriptionActive: false, workspaceId: state.workspaceId, userKey: state.userId ?? null };
@@ -1942,13 +1954,13 @@ class AiHubServer {
                     seatCountByKey[e.personaKey] = (seatCountByKey[e.personaKey] ?? 0) + (e.jobCreditsRemaining ?? 1);
                 }
             }
-            // seatsInUse is the count of manager-assignment rows for this workspace/persona.
-            const workspaceId = state.workspaceId;
+            // seatsInUse for display: derived from the hosted manager team. Authoritative
+            // out-of-stock enforcement lives on the hosted assign endpoint (server-side),
+            // so this display count does not need to be workspace-wide.
             const seatsInUseByKey = {};
-            if (this.dbService) {
-                await Promise.all(Object.keys(seatCountByKey).map(async (pKey) => {
-                    seatsInUseByKey[pKey] = await this.dbService.countHubManagerAssignments(workspaceId, pKey);
-                }));
+            const team = await this.remoteGateway.listManagerTeam(apiKey);
+            for (const entry of team) {
+                seatsInUseByKey[entry.personaKey] = (seatsInUseByKey[entry.personaKey] ?? 0) + 1;
             }
             const personas = allBundles.map((bundle) => ({
                 key: bundle.personaKey,
@@ -1961,23 +1973,16 @@ class AiHubServer {
                 seatCount: seatCountByKey[bundle.personaKey] ?? 0,
                 seatsInUse: seatsInUseByKey[bundle.personaKey] ?? 0,
             }));
-            return { personas, subscriptionActive: state.subscriptionActive, workspaceId, userKey: state.userId ?? null };
+            return { personas, subscriptionActive: state.subscriptionActive, workspaceId: state.workspaceId, userKey: state.userId ?? null };
         }
         catch (err) {
-            console.error('[ai-hub] persona entitlement lookup failed:', err);
+            console.error('[ai-hub] persona lookup failed:', err);
             return { personas: fallbackPersonas, subscriptionActive: false, workspaceId: null, userKey: null };
         }
     }
-    async computeManagerTeam(workspaceId, userKey) {
-        if (!workspaceId || !userKey || !this.dbService)
-            return [];
-        try {
-            const rows = await this.dbService.getHubManagerAssignments(workspaceId, userKey);
-            return rows.map((r) => ({ personaKey: r.personaKey, assignedAt: r.assignedAt.toISOString() }));
-        }
-        catch {
-            return [];
-        }
+    async computeManagerTeam(apiKey) {
+        // Issue #701: manager team comes from the hosted server, not local Mongo.
+        return this.remoteGateway.listManagerTeam(apiKey);
     }
     registerRoutes() {
         // Issue #512: Serve the account and analytics pages from public/.
@@ -2121,57 +2126,25 @@ class AiHubServer {
                 return res.status(400).json({ error: error instanceof Error ? error.message : 'Could not write learning.' });
             }
         });
-        // Issue #540: POST /api/ai-hub/manager-team/assign
-        // Assigns a persona to the authenticated manager's team (uses X-Fraim-Api-Key header).
-        // Returns 404 {error:'no_company_seat'} when the workspace has purchased no seats for the persona.
-        // Returns 409 {error:'out_of_stock'} when all company seats are already assigned to other managers.
+        // Issue #540/#701: POST /api/ai-hub/manager-team/assign
+        // Proxies to the hosted server (which owns the DB + seat enforcement). The Hub
+        // accepts the local X-Fraim-Api-Key header and forwards it as the hosted x-api-key.
+        // Hosted returns 404 no_company_seat / 409 out_of_stock; those are passed through.
         this.app.post('/api/ai-hub/manager-team/assign', async (req, res) => {
             const apiKey = typeof req.headers['x-fraim-api-key'] === 'string' ? req.headers['x-fraim-api-key'] : undefined;
             const { personaKey } = (req.body ?? {});
             if (!personaKey)
                 return res.status(400).json({ error: 'personaKey required' });
-            if (!this.dbService) {
-                return res.status(404).json({ error: 'no_company_seat', personaKey });
-            }
-            try {
-                const { workspaceId, userKey, personas } = await this.computePersonas(apiKey);
-                if (!workspaceId || !userKey) {
-                    return res.status(404).json({ error: 'no_company_seat', personaKey });
-                }
-                const persona = personas.find((p) => p.key === personaKey);
-                if (!persona || persona.seatCount === 0) {
-                    return res.status(404).json({ error: 'no_company_seat', personaKey });
-                }
-                if (persona.seatsInUse >= persona.seatCount) {
-                    return res.status(409).json({ error: 'out_of_stock', personaKey, seatCount: persona.seatCount });
-                }
-                await this.dbService.addHubManagerAssignment(workspaceId, userKey, personaKey);
-                const team = await this.computeManagerTeam(workspaceId, userKey);
-                return res.json({ managerTeam: team });
-            }
-            catch (err) {
-                console.error('[ai-hub] assign manager seat failed:', err);
-                return res.status(500).json({ error: 'internal_error' });
-            }
+            const result = await this.remoteGateway.assignManagerTeam(apiKey, personaKey);
+            return res.status(result.status).json(result.body);
         });
-        // Issue #540: DELETE /api/ai-hub/manager-team/assign/:personaKey
-        // Removes a persona from the authenticated manager's team.
+        // Issue #540/#701: DELETE /api/ai-hub/manager-team/assign/:personaKey
+        // Proxies the seat release to the hosted server.
         this.app.delete('/api/ai-hub/manager-team/assign/:personaKey', async (req, res) => {
             const apiKey = typeof req.headers['x-fraim-api-key'] === 'string' ? req.headers['x-fraim-api-key'] : undefined;
             const { personaKey } = req.params;
-            if (!this.dbService)
-                return res.status(204).end();
-            try {
-                const { workspaceId, userKey } = await this.computePersonas(apiKey);
-                if (workspaceId && userKey) {
-                    await this.dbService.removeHubManagerAssignment(workspaceId, userKey, personaKey);
-                }
-                return res.status(204).end();
-            }
-            catch (err) {
-                console.error('[ai-hub] remove manager seat failed:', err);
-                return res.status(500).json({ error: 'internal_error' });
-            }
+            await this.remoteGateway.removeManagerTeam(apiKey, personaKey);
+            return res.status(204).end();
         });
         this.app.get('/api/ai-hub/conversations', (req, res) => {
             const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
@@ -2464,11 +2437,15 @@ class AiHubServer {
                     throw new Error('Choose a FRAIM job before starting a run.');
                 }
                 const startTimestamp = new Date().toISOString();
+                const jobMetadata = this.resolveHubJob(projectPath, jobId);
+                const fallbackJobTitle = typeof req.body.jobTitle === 'string' && req.body.jobTitle.trim()
+                    ? req.body.jobTitle.trim()
+                    : jobId;
                 const run = {
                     id: (0, crypto_1.randomUUID)(),
                     conversationId: typeof req.body.conversationId === 'string' && req.body.conversationId.trim() ? req.body.conversationId.trim() : undefined,
                     conversationTitle: typeof req.body.conversationTitle === 'string' && req.body.conversationTitle.trim() ? req.body.conversationTitle.trim() : undefined,
-                    jobTitle: typeof req.body.jobTitle === 'string' && req.body.jobTitle.trim() ? req.body.jobTitle.trim() : jobId,
+                    jobTitle: jobMetadata?.title || fallbackJobTitle,
                     jobId,
                     hostId,
                     projectPath,
@@ -2482,7 +2459,7 @@ class AiHubServer {
                     phaseHistory: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
-                    personaKey: getProtectedPersonaForHubJob(jobId),
+                    personaKey: jobMetadata?.personaKey ?? getProtectedPersonaForHubJob(jobId),
                     // Issue #442: mark this as the FRAIM side of an A/B pair when applicable.
                     ...(compareMode === 'ab' ? { runRole: 'fraim' } : {}),
                     // #0: trigger source — defaults to 'manager' when not provided by the caller.
@@ -2535,8 +2512,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -2569,7 +2548,7 @@ class AiHubServer {
                         if (latest)
                             this.drainPendingDelegatedReviews(latest);
                     },
-                }, run.sessionId);
+                }, startSessionSeedForHost(hostId, run.id));
                 this.runRegistry.attachChildIfRunning(run.id, child);
                 // Issue #442: spawn the Direct run via startDirectRun so CliHostRuntime
                 // uses buildDirectStartPlan (--strict-mcp-config, raw stdin) rather than
@@ -2598,7 +2577,7 @@ class AiHubServer {
                             });
                             this.runRegistry.dispose(directId);
                         },
-                    }, directRun.sessionId);
+                    }, startSessionSeedForHost(hostId, directRun.id));
                     this.runRegistry.attachChildIfRunning(directRun.id, directChild);
                 }
                 const existingPreferences = this.preferencesStore.load(projectPath);
@@ -2724,8 +2703,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -2786,16 +2767,27 @@ class AiHubServer {
                 if (!employee?.available) {
                     throw new Error(`${employee?.label || 'Selected employee'} is not available on this machine.`);
                 }
+                const conversationId = typeof body.conversationId === 'string' && body.conversationId.trim()
+                    ? body.conversationId.trim()
+                    : undefined;
+                const persistedConversation = conversationId
+                    ? this.conversationStore.loadProject(projectPath).conversations.find((entry) => entry.id === conversationId)
+                    : undefined;
+                const persistedRun = readPersistedRunProjection(persistedConversation);
                 const now = new Date().toISOString();
                 const run = {
                     id: (0, crypto_1.randomUUID)(),
-                    conversationId: typeof body.conversationId === 'string' && body.conversationId.trim() ? body.conversationId.trim() : undefined,
+                    conversationId,
                     conversationTitle: typeof body.conversationTitle === 'string' && body.conversationTitle.trim() ? body.conversationTitle.trim() : undefined,
                     jobTitle: typeof body.jobTitle === 'string' && body.jobTitle.trim() ? body.jobTitle.trim() : jobId,
                     jobId, hostId, projectPath, status: 'running', sessionId,
                     createdAt: now, updatedAt: now, messages: [],
                     events: [(0, hosts_1.createHubEvent)('system', `Resuming ${hostId} session ${sessionId} in ${projectPath}`)],
-                    currentPhase: null, phaseHistory: [], totals: emptyTotals(), lastStatusChangeAt: now,
+                    currentPhase: persistedRun?.currentPhase || null,
+                    phaseHistory: persistedRun?.phaseHistory || [],
+                    totals: persistedRun?.totals || emptyTotals(),
+                    lastStatusChangeAt: now,
+                    runDiscriminant: persistedRun?.runDiscriminant || undefined,
                     personaKey: getProtectedPersonaForHubJob(jobId),
                 };
                 // Continue-turn message (FRAIM invocation for the job + instructions) plus
@@ -2819,8 +2811,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -3248,8 +3242,10 @@ class AiHubServer {
                                 current.events.push((0, hosts_1.createHubEvent)(channel, event.raw));
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -3262,7 +3258,7 @@ class AiHubServer {
                         });
                         this.runRegistry.dispose(run.id);
                     },
-                }, run.sessionId);
+                }, startSessionSeedForHost(hostId, run.id));
                 // Update the registry entry with the real child process handle.
                 this.runRegistry.attachChildIfRunning(run.id, child);
                 return res.json({ runId: run.id, status: 'started', employee: employeeId, job: jobName });
@@ -3368,8 +3364,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -3389,7 +3387,7 @@ class AiHubServer {
                 this.deploymentStore.update(deployment.id, (d) => { d.activeRunId = undefined; });
                 this.runRegistry.dispose(run.id);
             },
-        });
+        }, startSessionSeedForHost(deployment.hostId, run.id));
         this.runRegistry.create(run, child);
         this.deploymentStore.update(deployment.id, (d) => { d.activeRunId = run.id; });
         return run;
@@ -3435,7 +3433,7 @@ class AiHubServer {
                 liveTotals.waitingDurationMs = Math.max(0, liveTotals.waitingDurationMs - overflow);
             }
         }
-        return { ...run, stages, totals: liveTotals, artifacts: extractRunReviewArtifacts(run) };
+        return { ...run, stages, totals: liveTotals, artifacts: run.artifacts || [] };
     }
 }
 exports.AiHubServer = AiHubServer;