fraim-hub 2.0.276 → 2.0.277

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

@@ -15,6 +15,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
 const resolve_phase_edge_1 = require("../core/resolve-phase-edge");
+const pack_home_1 = require("../cli/utils/pack-home");
 // Directories scanned for employee jobs at runtime, in lowest-to-highest
 // precedence order. Later entries win on {categoryId, jobId} collision.
 //
@@ -24,27 +25,12 @@ const resolve_phase_edge_1 = require("../core/resolve-phase-edge");
 //   - <project>/fraim/ai-employee/jobs/<category>/           - synced baseline
 //   - <project>/fraim/personalized-employee/jobs/<category>/ - taught/customized override
 // Only the personalized-employee layer is "personalized" (issue #566).
-// Issue #1002: the machine-level layers are added here so a capability authored
-// at the manager level is DISCOVERABLE, not merely resolvable by exact name.
-// Order matters and mirrors LocalRegistryResolver.resolveFile precedence
-// inverted, because later entries win on a {categoryId, jobId} collision:
-//   synced baseline < company cache < manager synced cache < manager local < project
-// A job that resolves from the manager level must therefore also DISPLAY as the
-// manager's, otherwise the rail would show a baseline job the runtime never runs.
 const EMPLOYEE_JOB_LAYERS = [
     { segments: ['ai-employee', 'jobs'], personalized: false },
-    { base: 'user', segments: ['org', 'jobs'], personalized: true, scope: 'org' },
-    { base: 'user', segments: ['manager', 'jobs'], personalized: true, scope: 'manager' },
-    { base: 'user', segments: ['personalized-employee', 'jobs'], personalized: true, scope: 'manager' },
-    { segments: ['personalized-employee', 'jobs'], personalized: true, scope: 'project' },
 ];
 // Manager templates use the matching layer model.
 const MANAGER_JOB_LAYERS = [
     { segments: ['ai-manager', 'jobs'], personalized: false },
-    { base: 'user', segments: ['org', 'manager-jobs'], personalized: true, scope: 'org' },
-    { base: 'user', segments: ['manager', 'manager-jobs'], personalized: true, scope: 'manager' },
-    { base: 'user', segments: ['personalized-employee', 'manager-jobs'], personalized: true, scope: 'manager' },
-    { segments: ['personalized-employee', 'manager-jobs'], personalized: true, scope: 'project' },
 ];
 const REGISTRY_EMPLOYEE_JOB_LAYERS = [
     { base: 'project', segments: ['registry', 'jobs', 'ai-employee'], personalized: false },
@@ -108,7 +94,6 @@ function resolveExtendedStubPath(projectPath, extendsValue) {
         path_1.default.join(projectPath, 'fraim', 'ai-manager', 'jobs'),
         path_1.default.join(projectPath, 'registry', 'jobs', 'ai-employee'),
         path_1.default.join(projectPath, 'registry', 'jobs', 'ai-manager'),
-        path_1.default.join((0, project_fraim_paths_1.getUserFraimDirPath)(), 'ai-employee', 'jobs'),
     ];
     for (const root of candidateRoots) {
         const candidate = path_1.default.join(root, `${relative}.md`);
@@ -185,13 +170,13 @@ function readMarkdownFileNames(dirPath) {
  * as `~/.fraim/...` rather than as a long `../../..` walk out of the project,
  * which is what path.relative would otherwise produce for a user-level layer.
  */
-function stubDisplayPath(filePath, projectPath, userLevel) {
-    if (!userLevel)
+function stubDisplayPath(filePath, projectPath, displayRoot, displayPrefix) {
+    if (!displayRoot || !displayPrefix)
         return toPosix(path_1.default.relative(projectPath, filePath));
-    const rel = toPosix(path_1.default.relative((0, project_fraim_paths_1.getUserFraimDirPath)(), filePath));
-    return (0, project_fraim_paths_1.getUserFraimDisplayPath)(rel);
+    const rel = toPosix(path_1.default.relative(displayRoot, filePath));
+    return rel ? `${displayPrefix.replace(/\/$/, '')}/${rel}` : displayPrefix;
 }
-function parseJobStub(filePath, categoryId, categoryLabel, projectPath, personalized, scope, userLevel) {
+function parseJobStub(filePath, categoryId, categoryLabel, projectPath, personalized, scope, displayRoot, displayPrefix) {
     const content = fs_1.default.readFileSync(filePath, 'utf8');
     const fileName = path_1.default.basename(filePath, '.md');
     const frontmatter = readJobFrontmatter(filePath);
@@ -206,12 +191,12 @@ function parseJobStub(filePath, categoryId, categoryLabel, projectPath, personal
         categoryLabel,
         intent,
         outcome,
-        stubPath: stubDisplayPath(filePath, projectPath, userLevel),
+        stubPath: stubDisplayPath(filePath, projectPath, displayRoot, displayPrefix),
         personalized: !!personalized,
         ...(scope ? { scope } : {}),
     };
 }
-function parseManagerStub(filePath, groupId, groupLabel, projectPath, scope, userLevel) {
+function parseManagerStub(filePath, groupId, groupLabel, projectPath, scope, displayRoot, displayPrefix) {
     const content = fs_1.default.readFileSync(filePath, 'utf8');
     const fileName = path_1.default.basename(filePath, '.md');
     const frontmatter = readJobFrontmatter(filePath);
@@ -223,7 +208,7 @@ function parseManagerStub(filePath, groupId, groupLabel, projectPath, scope, use
         groupId,
         groupLabel,
         intent,
-        stubPath: stubDisplayPath(filePath, projectPath, userLevel),
+        stubPath: stubDisplayPath(filePath, projectPath, displayRoot, displayPrefix),
         ...(scope ? { scope } : {}),
     };
 }
@@ -262,10 +247,10 @@ function summarizeProject(projectPath) {
     };
 }
 function resolveLayerRoot(projectPath, layer) {
+    if (layer.root)
+        return layer.root;
     if (layer.base === 'project')
         return path_1.default.join(projectPath, ...layer.segments);
-    if (layer.base === 'user')
-        return path_1.default.join((0, project_fraim_paths_1.getUserFraimDirPath)(), ...layer.segments);
     return path_1.default.join((0, project_fraim_paths_1.getWorkspaceFraimDir)(projectPath), ...layer.segments);
 }
 function discoverLayers(projectPath, layers) {
@@ -279,26 +264,37 @@ function discoverLayers(projectPath, layers) {
                 categoryDir: path_1.default.join(layerRoot, categoryName),
                 personalized: layer.personalized,
                 scope: layer.scope,
-                userLevel: layer.base === 'user',
+                displayRoot: layer.displayRoot,
+                displayPrefix: layer.displayPrefix,
             });
         }
     }
     return out;
 }
+function personalizedLayerSegments(projectPath, capabilityDir) {
+    return (0, pack_home_1.personalizedCapabilityReadRoots)(projectPath, capabilityDir).map((root) => ({
+        root: root.capabilityRoot,
+        segments: [],
+        personalized: true,
+        scope: root.scope,
+        displayRoot: root.displayRoot,
+        displayPrefix: root.displayPrefix,
+    }));
+}
 function discoverEmployeeJobs(projectPath, options = {}) {
     const project = summarizeProject(projectPath);
     if (!project.exists || (!project.hasFraim && !options.includeRegistry))
         return [];
     const layers = discoverLayers(projectPath, options.includeRegistry
-        ? [...REGISTRY_EMPLOYEE_JOB_LAYERS, ...EMPLOYEE_JOB_LAYERS]
-        : EMPLOYEE_JOB_LAYERS);
+        ? [...REGISTRY_EMPLOYEE_JOB_LAYERS, ...EMPLOYEE_JOB_LAYERS, ...personalizedLayerSegments(projectPath, 'jobs')]
+        : [...EMPLOYEE_JOB_LAYERS, ...personalizedLayerSegments(projectPath, 'jobs')]);
     // Group by categoryId so all layers contribute to the same labelled category.
     const jobsByKey = new Map();
     for (const layer of layers) {
         const categoryLabel = humanizeName(layer.categoryId);
         for (const fileName of readMarkdownFileNames(layer.categoryDir)) {
             const filePath = path_1.default.join(layer.categoryDir, fileName);
-            const job = parseJobStub(filePath, layer.categoryId, categoryLabel, projectPath, layer.personalized, layer.scope, layer.userLevel);
+            const job = parseJobStub(filePath, layer.categoryId, categoryLabel, projectPath, layer.personalized, layer.scope, layer.displayRoot, layer.displayPrefix);
             // Later layers override earlier layers on {category, jobId} collision —
             // personalized-employee wins over the synced ai-employee baseline. The
             // winning job carries its own layer's `personalized` flag (issue #566).
@@ -317,14 +313,14 @@ function discoverManagerTemplates(projectPath, options = {}) {
     if (!project.exists || (!project.hasFraim && !options.includeRegistry))
         return [];
     const layers = discoverLayers(projectPath, options.includeRegistry
-        ? [...REGISTRY_MANAGER_JOB_LAYERS, ...MANAGER_JOB_LAYERS]
-        : MANAGER_JOB_LAYERS);
+        ? [...REGISTRY_MANAGER_JOB_LAYERS, ...MANAGER_JOB_LAYERS, ...personalizedLayerSegments(projectPath, 'manager-jobs')]
+        : [...MANAGER_JOB_LAYERS, ...personalizedLayerSegments(projectPath, 'manager-jobs')]);
     const templatesByKey = new Map();
     for (const layer of layers) {
         const groupLabel = humanizeName(layer.categoryId);
         for (const fileName of readMarkdownFileNames(layer.categoryDir)) {
             const filePath = path_1.default.join(layer.categoryDir, fileName);
-            const template = parseManagerStub(filePath, layer.categoryId, groupLabel, projectPath, layer.scope, layer.userLevel);
+            const template = parseManagerStub(filePath, layer.categoryId, groupLabel, projectPath, layer.scope, layer.displayRoot, layer.displayPrefix);
             templatesByKey.set(`${template.groupId}::${template.id}`, template);
         }
     }
@@ -407,6 +403,8 @@ function findJobStubPath(projectPath, jobId) {
     const layers = discoverLayers(projectPath, [
         ...EMPLOYEE_JOB_LAYERS,
         ...MANAGER_JOB_LAYERS,
+        ...personalizedLayerSegments(projectPath, 'jobs'),
+        ...personalizedLayerSegments(projectPath, 'manager-jobs'),
     ]);
     let resolved = null;
     for (const layer of layers) {
@@ -520,8 +518,8 @@ function getAiHubCategories(projectPath, options = {}) {
         return [];
     // A category is any directory found at any layer; deduplicate by id.
     const layers = discoverLayers(projectPath, options.includeRegistry
-        ? [...REGISTRY_EMPLOYEE_JOB_LAYERS, ...EMPLOYEE_JOB_LAYERS]
-        : EMPLOYEE_JOB_LAYERS);
+        ? [...REGISTRY_EMPLOYEE_JOB_LAYERS, ...EMPLOYEE_JOB_LAYERS, ...personalizedLayerSegments(projectPath, 'jobs')]
+        : [...EMPLOYEE_JOB_LAYERS, ...personalizedLayerSegments(projectPath, 'jobs')]);
     const seen = new Map();
     for (const layer of layers) {
         if (!seen.has(layer.categoryId)) {

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

@@ -47,7 +47,10 @@ const pack_home_1 = require("../cli/utils/pack-home");
 //     whose item.type === 'mcp_tool_call' and item.tool === 'seekMentoring'
 //     (Codex separates the MCP server name from the tool name).
 function parseSeekMentoringSignal(line) {
-    if (!line.includes('seekMentoring'))
+    // Issue #1264: case-insensitive so a host that flattens the tool name to
+    // all-lowercase (e.g. "fraim_seekmentoring") still reaches the JSON parse
+    // and isFraimTool checks below instead of being dropped by this fast gate.
+    if (!line.toLowerCase().includes('seekmentoring'))
         return null;
     let parsed;
     try {
@@ -301,6 +304,68 @@ function parseAgentIdentitySignal(line) {
     }
     return null;
 }
+// Issue #1264 (R3): defense-in-depth diagnostic. A tool call that carries a
+// submit-phase reviewHandoff (reviewRequired: true) under a name isFraimTool
+// cannot resolve to 'seekMentoring' — even after the flattened-lowercase
+// matching above — means the Hub is about to silently drop a real review
+// handoff, the #1264/#1265 failure mode for a naming shape not yet
+// anticipated. Returns a human-readable diagnostic surfaced via the existing
+// `hostError` channel (already rendered, non-droppable) instead of inventing
+// new UI. Scoped to lines that already carry a `reviewHandoff` key so it
+// never fires for submits that legitimately have none.
+function detectUnrecognizedReviewHandoffCall(line) {
+    if (!line.toLowerCase().includes('reviewhandoff'))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const obj = parsed;
+    const check = (rawName, rawArgs) => {
+        if (isFraimTool(rawName, 'seekMentoring'))
+            return null;
+        const args = normalizeToolArgs(rawArgs);
+        if (!args)
+            return null;
+        const reviewHandoff = extractReviewHandoffFromArgs(args);
+        if (!reviewHandoff || !reviewHandoff.reviewRequired)
+            return null;
+        const name = typeof rawName === 'string' ? rawName : String(rawName);
+        return `FRAIM review handoff detected in host output under an unrecognized tool name ("${name}") — the Hub could not project it onto this conversation. File a FRAIM issue naming this exact tool name so recognition can be extended.`;
+    };
+    if ((obj.type === 'item.started' || obj.type === 'item.completed') && typeof obj.item === 'object' && obj.item !== null) {
+        const item = obj.item;
+        if (item.type === 'mcp_tool_call') {
+            const hit = check(item.tool, item.arguments);
+            if (hit)
+                return hit;
+        }
+    }
+    const candidates = [obj];
+    if (Array.isArray(obj.content))
+        candidates.push(...obj.content);
+    if (typeof obj.message === 'object' && obj.message !== null) {
+        const msg = obj.message;
+        if (Array.isArray(msg.content))
+            candidates.push(...msg.content);
+    }
+    for (const candidate of candidates) {
+        if (typeof candidate !== 'object' || candidate === null)
+            continue;
+        const c = candidate;
+        if (c.type !== 'tool_use' && c.type !== 'function_call')
+            continue;
+        const hit = check(readToolName(c), c.input || c.arguments || c.parameters);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
 function readAgentFromArgs(args) {
     if (!args || typeof args.agent !== 'object' || args.agent === null)
         return null;
@@ -335,7 +400,27 @@ function canonicalToolName(rawName) {
     return byDoubleUnderscore.split(/[./:]/).filter(Boolean).pop() || null;
 }
 function isFraimTool(rawName, canonicalName) {
-    return canonicalToolName(rawName) === canonicalName;
+    if (canonicalToolName(rawName) === canonicalName)
+        return true;
+    return isFlattenedFraimToolName(rawName, canonicalName);
+}
+// Issue #1264: the "Codex Azure Script" configured agent (MCP server
+// codex_apps) flattens tool identity into a single lowercase, separator-less
+// token instead of a qualifier syntax canonicalToolName's __/./\//: split can
+// find (e.g. "fraim_seekmentoring", "fraim_get_fraim_job", "fraim_fraim_connect"
+// — confirmed verbatim in the 2026-08-21 event log). Match that exact flattened
+// shape, plus the bare lowercase form, case-insensitively — scoped only to the
+// three known canonical FRAIM tool identities so an unrelated tool name is
+// never accepted (#982's case-sensitivity intent is preserved for everything
+// that isn't a legitimate flattened/qualified form of a known FRAIM tool).
+function isFlattenedFraimToolName(rawName, canonicalName) {
+    if (typeof rawName !== 'string')
+        return false;
+    const trimmedLower = rawName.trim().toLowerCase();
+    if (!trimmedLower)
+        return false;
+    const lowerCanonical = canonicalName.toLowerCase();
+    return trimmedLower === lowerCanonical || trimmedLower === `fraim_${lowerCanonical}`;
 }
 function readFraimJobFromArgs(rawArgs) {
     const args = normalizeToolArgs(rawArgs);
@@ -1534,8 +1619,11 @@ function parseHostLine(hostId, line) {
     const fraimJob = parseFraimJobLoadSignal(trimmed);
     const usage = parseUsageSignal(trimmed);
     const agentIdentity = parseAgentIdentitySignal(trimmed);
+    // Issue #1264 (R3): only worth checking when seekMentoring itself did not
+    // already resolve — a recognized call has nothing to diagnose.
+    const unrecognizedReviewHandoffError = seekMentoring ? null : detectUnrecognizedReviewHandoffCall(trimmed);
     const withSignal = (event) => {
-        if (!seekMentoring && !fraimJob && !usage && !agentIdentity)
+        if (!seekMentoring && !fraimJob && !usage && !agentIdentity && !unrecognizedReviewHandoffError)
             return event;
         return {
             ...event,
@@ -1543,6 +1631,7 @@ function parseHostLine(hostId, line) {
             ...(fraimJob ? { fraimJob } : {}),
             ...(usage ? { usage } : {}),
             ...(agentIdentity ? { agentIdentity } : {}),
+            ...(unrecognizedReviewHandoffError && !event.hostError ? { hostError: unrecognizedReviewHandoffError } : {}),
         };
     };
     if (hostId === 'codex') {
@@ -1655,7 +1744,7 @@ function parseHostLine(hostId, line) {
                     source: hostId,
                     backgroundTasks: parsed.tasks
                         .filter((t) => typeof t.task_id === 'string')
-                        .map((t) => ({ taskId: t.task_id, description: t.description })),
+                        .map((t) => ({ taskId: t.task_id, description: t.description, taskType: t.task_type })),
                 },
             });
         }
@@ -2209,6 +2298,17 @@ class ScriptedHostRuntime {
             agentIdentity: { agentName, agentModel },
         }, 'stdout');
     }
+    // Test API — feed a raw stdout line through the REAL parseHostLine parser
+    // instead of a hand-built ParsedHostEvent. Issue #1264: lets a test prove
+    // the actual tool-call-name recognition (not just the projection logic)
+    // handles a given raw shape, e.g. a flattened-lowercase tool name.
+    emitRawLine(runId, hostId, line) {
+        const target = this.resolveSession(runId);
+        if (!target)
+            return;
+        const parsed = parseHostLine(hostId, line);
+        target.handlers.onEvent({ ...parsed, sessionId: target.sessionId }, 'stdout');
+    }
     // Test API — emit a message from the employee (appears in the thread as an employee bubble).
     emitEmployeeMessage(runId, text) {
         const target = this.resolveSession(runId);

package/dist/src/ai-hub/manager-turns.js

@@ -4,6 +4,7 @@ exports.extractExplicitFraimInvocation = extractExplicitFraimInvocation;
 exports.fraimInvocationFor = fraimInvocationFor;
 exports.fraimDirectiveFor = fraimDirectiveFor;
 exports.buildCommunicationStyleNote = buildCommunicationStyleNote;
+exports.buildBackgroundTaskPolicyNote = buildBackgroundTaskPolicyNote;
 exports.buildSameJobContinueMessage = buildSameJobContinueMessage;
 exports.buildManagerMessage = buildManagerMessage;
 function extractExplicitFraimInvocation(text) {
@@ -41,6 +42,17 @@ function buildCommunicationStyleNote() {
         '[How to talk to me] In your messages to me, report ONLY on the job and its outcome — what you found, what you changed, the decisions you made, blockers, and what you need from me. Do NOT narrate the FRAIM machinery: don\'t announce that you are talking to FRAIM, asking your mentor, following the process, moving between phases, or calling tools (git, playwright, etc.). I can see the raw tool activity separately if I want it. Keep your updates short and about the work, not the process.',
     ].join('\n');
 }
+// #1275: Hub-injected background-task policy. Agents running in Hub headless
+// (-p) mode must never end their turn while background tasks are active — the
+// Hub cannot reattach to running bash processes or sub-agents after the Claude
+// Code process exits. This note is injected at the Hub layer; it is NOT a
+// registry rule because it only applies to Hub's non-interactive -p invocation.
+function buildBackgroundTaskPolicyNote() {
+    return [
+        '',
+        '[Background task policy] You are running in Hub headless mode. Never end your turn while background tasks (bash commands started with run_in_background=true, or sub-agents) are still active. Instead: monitor them, poll for results, and provide periodic progress commentary to the manager. Only end your turn when all background tasks have finished, or when you genuinely need a user decision or input to continue. If you exit while a background task is active, the Hub loses the link to that task permanently.',
+    ].join('\n');
+}
 // Issue #732: a plain continue of the SAME active job must not re-load the job.
 // Continue turns resume the existing agent session, which already has the job
 // loaded, so this message carries NO `/fraim <job>` invocation — the headless

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

@@ -51,6 +51,7 @@ const learning_context_builder_1 = require("../local-mcp-server/learning-context
 const brand_store_1 = require("../core/brand-store");
 const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
 const catalog_1 = require("./catalog");
+const job_visualization_1 = require("../core/job-visualization");
 const custom_employees_1 = require("./custom-employees");
 const agent_token_prices_1 = require("../local-mcp-server/agent-token-prices");
 const hosts_1 = require("./hosts");
@@ -867,30 +868,6 @@ function normalizeDelegationLedger(raw) {
         tasks,
     };
 }
-function extractReviewHandoffFromText(text) {
-    if (!text || !/reviewRequired|reviewTarget|review_handoff/i.test(text))
-        return null;
-    const candidates = [];
-    for (const match of String(text).matchAll(/```(?:json)?\s*([\s\S]*?)```/gi))
-        candidates.push(match[1]);
-    const tagged = String(text).match(/<review_handoff>\s*([\s\S]*?)\s*<\/review_handoff>/i);
-    if (tagged)
-        candidates.push(tagged[1]);
-    const inline = String(text).match(/(\{\s*"reviewRequired"[\s\S]*\})/i);
-    if (inline)
-        candidates.push(inline[1]);
-    for (const candidate of candidates) {
-        try {
-            const handoff = normalizeReviewHandoff(JSON.parse(candidate.trim()));
-            if (handoff)
-                return handoff;
-        }
-        catch {
-            // Malformed snippets are ignored; the UI can still surface legacy fallback state.
-        }
-    }
-    return null;
-}
 function extractDelegationLedgerFromText(text) {
     if (!text || !/delegationRequired|delegation_ledger|delegationLedger|"goal"\s*:.*"groups"\s*:/is.test(text))
         return null;
@@ -915,7 +892,14 @@ function extractDelegationLedgerFromText(text) {
     }
     return null;
 }
-function applyReviewProjection(run, text) {
+// Issue #1264: review handoffs project ONLY through the structured seekMentoring
+// evidence channel (applySeekMentoringSignal) now — a prose-embedded
+// <review_handoff> tag or bare JSON in an agent's text reply is no longer a
+// recognized review-signal channel, so it is not extracted or applied here.
+// Delegation ledgers still use this text-embedded channel because the
+// fully-delegate job's registry instructions (delegation-graph-planning.md)
+// have not yet been migrated to the structured evidence.delegationLedger path.
+function applyDelegationLedgerProjection(run, text) {
     const delegation = extractDelegationLedgerFromText(text);
     if (delegation) {
         run.delegation = {
@@ -924,12 +908,6 @@ function applyReviewProjection(run, text) {
             managerRunId: delegation.managerRunId || run.id,
         };
     }
-    const handoff = extractReviewHandoffFromText(text);
-    if (handoff) {
-        run.reviewHandoff = handoff;
-        run.artifacts = handoff.reviewTarget?.type === 'artifact_set' ? handoff.artifacts : [];
-        return;
-    }
 }
 function emptyTotals() {
     return {
@@ -1226,13 +1204,13 @@ function stripStructuredHostPayloads(text) {
 function appendHostMessage(run, hostId, event, channel) {
     if (!event.message || channel !== 'stdout')
         return;
-    applyReviewProjection(run, event.message);
+    applyDelegationLedgerProjection(run, event.message);
     if (hostId === 'gemini') {
         const last = run.messages[run.messages.length - 1];
         if (last?.role === 'employee') {
             last.text = `${last.text}\n${event.message}`;
             last.createdAt = new Date().toISOString();
-            applyReviewProjection(run, last.text);
+            applyDelegationLedgerProjection(run, last.text);
             last.text = stripStructuredHostPayloads(last.text);
             if (!last.text)
                 run.messages.pop();
@@ -1890,6 +1868,22 @@ function buildHubCompactionRecoveryContinueMessage(run, exitCode, attempt) {
 function createHubCompactionRecoveryEvent(run, exitCode, attempt) {
     return (0, hosts_1.createHubEvent)('system', `Hub compaction recovery attempt ${attempt}/${MAX_RECOVERY_ATTEMPTS} for run ${run.id} session ${run.sessionId || 'unknown'} after exit ${exitCode ?? 'unknown'}.${hostErrorSuffix(run)}`);
 }
+// #1275: safety-net auto-resume when the agent exited with an active local_bash
+// task. recoveryAttempts is NOT incremented — this is not an error recovery.
+function createHubBackgroundTaskContinueEvent(run) {
+    return (0, hosts_1.createHubEvent)('system', `Hub background-task continuation for run ${run.id} session ${run.sessionId || 'unknown'} — agent exited while a local_bash task was active.${hostErrorSuffix(run)}`);
+}
+function buildHubBackgroundTaskContinueMessage(run) {
+    return [
+        '[FRAIM Hub system recovery]',
+        'Your previous turn started a background bash task and then ended the turn before the task completed.',
+        'This is not a manager-authored instruction. Do not say the manager asked you to continue.',
+        `Run id: ${run.id}`,
+        `Session id: ${run.sessionId || 'unknown'}`,
+        'The background bash task may still be running as an orphan process. Check whether its results are available on disk and continue your work.',
+        'If results are not yet available, wait briefly or check again. Once you have the results, continue with your original plan.',
+    ].join('\n');
+}
 function isHumanActionGate(run) {
     if (run.stoppedByUser)
         return true;
@@ -1899,15 +1893,28 @@ function isHumanActionGate(run) {
     const lastEntry = phaseHistory.length > 0 ? phaseHistory[phaseHistory.length - 1] : null;
     return lastEntry?.latestStatus === 'incomplete' || lastEntry?.latestStatus === 'failure';
 }
+// #1275: true when the host reported an active local_bash task. These are
+// intentional async continuations — the agent ended its turn knowing bash was
+// running, intending to check results in the next turn. In -p mode Claude Code
+// exits before bash finishes, so task_updated is never emitted. Hub should
+// auto-resume (safety net) rather than error.
+function hasActiveLocalBashTask(run) {
+    const tasks = run.hostLifecycle?.backgroundTasks;
+    if (!tasks)
+        return false;
+    return Object.values(tasks).some((task) => task.status === 'active' && task.taskType === 'local_bash');
+}
 // Issue #1234: true when the host reported a background task as active
 // (`background_tasks_changed`) and it either never resolved before the host's
 // child process exited, or resolved as `killed` rather than `completed`. Both
 // are evidence the agent's promised follow-up did not happen.
+// #1275: tightened — local_bash active tasks are handled by hasActiveLocalBashTask above.
 function hasUnresolvedBackgroundTask(run) {
     const tasks = run.hostLifecycle?.backgroundTasks;
     if (!tasks)
         return false;
-    return Object.values(tasks).some((task) => task.status === 'active' || task.status === 'killed');
+    return Object.values(tasks).some((task) => (task.status === 'active' && task.taskType !== 'local_bash') ||
+        task.status === 'killed');
 }
 function describeUnresolvedBackgroundTasks(run) {
     const descriptions = Object.values(run.hostLifecycle?.backgroundTasks || {})
@@ -1955,6 +1962,9 @@ function classifyExit(run, exitCode) {
             if (compactingActive) {
                 return { action: 'resume', pauseReason: 'working', recoveryKind: 'compaction' };
             }
+            if (hasActiveLocalBashTask(run)) {
+                return { action: 'resume', pauseReason: 'working', recoveryKind: 'background_task' };
+            }
             if (hasUnresolvedBackgroundTask(run)) {
                 return { action: 'error', pauseReason: 'error', systemNote: describeUnresolvedBackgroundTasks(run) };
             }
@@ -2035,6 +2045,7 @@ function applyBackgroundTasksChangedSignal(run, signal, now) {
         const existing = existingTasks[task.taskId];
         nextTasks[task.taskId] = {
             description: task.description ?? existing?.description,
+            taskType: task.taskType ?? existing?.taskType,
             status: 'active',
             startedAt: existing?.startedAt || now,
             lastEventAt: now,
@@ -2795,7 +2806,7 @@ class AiHubServer {
             run.lastHostError = undefined;
         }
         if (event.raw) {
-            applyReviewProjection(run, event.raw);
+            applyDelegationLedgerProjection(run, event.raw);
             try {
                 const ref = this.rawEventLogStore.append((0, conversation_store_1.conversationScopeKey)(run.scope, run.projectPath), run.conversationId || run.id, run.id, { channel, text: event.raw });
                 run.eventLogRefs = upsertEventLogRef(run.eventLogRefs, ref);
@@ -3945,12 +3956,13 @@ class AiHubServer {
         // available (env published at boot).
         const browserNote = (0, managed_browser_1.buildBrowserContextNote)(process.env.FRAIM_BROWSER_CDP_ENDPOINT, process.env.FRAIM_HUB_BASE_URL);
         const styleNote = (0, manager_turns_1.buildCommunicationStyleNote)();
+        const backgroundTaskNote = (0, manager_turns_1.buildBackgroundTaskPolicyNote)();
         const ignoreEmbedded = options?.ignoreEmbeddedInvocation === true;
         if (resolvedJobId === '__freeform__') {
             const display = (0, manager_turns_1.buildManagerMessage)(hostId, resolvedJobId, 'start', instructions, { ignoreEmbeddedInvocation: ignoreEmbedded });
             return {
                 jobId: resolvedJobId,
-                message: (0, manager_turns_1.buildManagerMessage)(hostId, resolvedJobId, 'start', instructions, { ignoreEmbeddedInvocation: ignoreEmbedded }) + browserNote + styleNote,
+                message: (0, manager_turns_1.buildManagerMessage)(hostId, resolvedJobId, 'start', instructions, { ignoreEmbeddedInvocation: ignoreEmbedded }) + browserNote + styleNote + backgroundTaskNote,
                 display,
             };
         }
@@ -3961,7 +3973,7 @@ class AiHubServer {
         const display = (0, manager_turns_1.buildManagerMessage)(hostId, resolvedJobId, 'start', instructions, { ignoreEmbeddedInvocation: ignoreEmbedded });
         return {
             jobId: resolvedJobId,
-            message: (0, manager_turns_1.buildManagerMessage)(hostId, resolvedJobId, 'start', instructions, { stubPath: absoluteStubPath, ignoreEmbeddedInvocation: ignoreEmbedded }) + browserNote + styleNote,
+            message: (0, manager_turns_1.buildManagerMessage)(hostId, resolvedJobId, 'start', instructions, { stubPath: absoluteStubPath, ignoreEmbeddedInvocation: ignoreEmbedded }) + browserNote + styleNote + backgroundTaskNote,
             display,
         };
     }
@@ -4015,8 +4027,8 @@ class AiHubServer {
         // Bubble: the command form for a real switch, else the manager's own words.
         const display = invocationForm ?? userText;
         // Agent payload: the same command form for a switch, else a lightweight
-        // same-job continue; the communication-style note is agent-only.
-        const message = (invocationForm ?? (0, manager_turns_1.buildSameJobContinueMessage)(userText)) + (0, manager_turns_1.buildCommunicationStyleNote)();
+        // same-job continue; the communication-style and background-task notes are agent-only.
+        const message = (invocationForm ?? (0, manager_turns_1.buildSameJobContinueMessage)(userText)) + (0, manager_turns_1.buildCommunicationStyleNote)() + (0, manager_turns_1.buildBackgroundTaskPolicyNote)();
         return { message, display };
     }
     async computePersonas(apiKey, managerTeamPromise, 
@@ -4346,6 +4358,17 @@ class AiHubServer {
             const userEmail = await this.resolveHubIdentity();
             return res.json(this.computeBrain(projectPath, jobCount, userEmail));
         });
+        // Issue #1278: Job visualization endpoint — phases + skills for the viz modal.
+        this.app.get('/api/ai-hub/job/:jobId/visualization', async (req, res) => {
+            const { jobId } = req.params;
+            if (!jobId || !/^[a-z0-9-]+$/.test(jobId)) {
+                return res.status(400).json({ error: 'Invalid jobId' });
+            }
+            const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
+                ? path_1.default.resolve(req.query.projectPath)
+                : this.defaultProjectPath();
+            return res.json(await (0, job_visualization_1.buildJobVisualization)(jobId, projectPath));
+        });
         // #533: read the PRESERVED learnings for a section + storage level so the
         // Company/Manager sections (machine level) and the project workspace (project
         // level) can DISPLAY and edit them.
@@ -6788,14 +6811,25 @@ class AiHubServer {
             return;
         const classification = classifyExit(preExit, exitCode);
         if (classification.action === 'resume') {
-            // Auto-continue: keep run in 'running', increment recoveryAttempts.
+            // Auto-continue: keep run in 'running'.
+            // background_task resumes must NOT increment recoveryAttempts (the error-recovery
+            // budget must not be consumed by normal async-bash continuations — #1275).
+            // clearBackgroundTaskLifecycle fires before the continue so stale 'active'
+            // entries from the dead Claude Code process don't re-trigger hasActiveLocalBashTask
+            // on the next exit, causing an infinite loop.
             this.runRegistry.update(runId, (current) => {
-                current.recoveryAttempts = (current.recoveryAttempts ?? 0) + 1;
+                if (classification.recoveryKind === 'background_task') {
+                    clearBackgroundTaskLifecycle(current);
+                    current.events.push(createHubBackgroundTaskContinueEvent(current));
+                }
+                else {
+                    current.recoveryAttempts = (current.recoveryAttempts ?? 0) + 1;
+                    current.events.push(classification.recoveryKind === 'compaction'
+                        ? createHubCompactionRecoveryEvent(current, exitCode, current.recoveryAttempts)
+                        : createHubRecoveryEvent(current, exitCode, current.recoveryAttempts));
+                }
                 current.lastRecoveryAt = new Date().toISOString();
                 current.pauseReason = 'working';
-                current.events.push(classification.recoveryKind === 'compaction'
-                    ? createHubCompactionRecoveryEvent(current, exitCode, current.recoveryAttempts)
-                    : createHubRecoveryEvent(current, exitCode, current.recoveryAttempts));
             });
             const refreshed = this.runRegistry.get(runId);
             if (!refreshed?.sessionId) {
@@ -6818,7 +6852,9 @@ class AiHubServer {
                     return;
                 const message = classification.recoveryKind === 'compaction'
                     ? buildHubCompactionRecoveryContinueMessage(current, exitCode, attempt)
-                    : buildHubRecoveryContinueMessage(current, exitCode, attempt);
+                    : classification.recoveryKind === 'background_task'
+                        ? buildHubBackgroundTaskContinueMessage(current)
+                        : buildHubRecoveryContinueMessage(current, exitCode, attempt);
                 // Issue #1150: recovery must relaunch as the SAME configured agent. Its setup
                 // script supplies the env that selects the profile the host session lives in
                 // (CODEX_HOME for Codex), and resuming without it sends `codex exec resume`

package/dist/src/cli/utils/pack-home.js

@@ -7,6 +7,7 @@ exports.packsDir = packsDir;
 exports.defaultCloneDir = defaultCloneDir;
 exports.resolvePackHome = resolvePackHome;
 exports.packReadRoots = packReadRoots;
+exports.personalizedCapabilityReadRoots = personalizedCapabilityReadRoots;
 exports.migrateStrandedContent = migrateStrandedContent;
 exports.findStrandedLegacyContent = findStrandedLegacyContent;
 exports.gitUrlHasUserinfo = gitUrlHasUserinfo;
@@ -173,6 +174,45 @@ function resolvePackHome(layer) {
 function packReadRoots(layer) {
     return [resolvePackHome(layer).contentRoot];
 }
+function displayPathForContentRoot(contentRoot) {
+    const userRoot = (0, project_fraim_paths_1.getUserFraimDirPath)();
+    const rel = path_1.default.relative(userRoot, contentRoot);
+    if (rel === '' || (rel && !rel.startsWith('..') && !path_1.default.isAbsolute(rel))) {
+        return (0, project_fraim_paths_1.getUserFraimDisplayPath)(rel);
+    }
+    return contentRoot.replace(/\\/g, '/');
+}
+/**
+ * Return personalized capability roots in merge order: org, manager, project.
+ *
+ * Callers that de-duplicate by key can iterate this array directly and let
+ * later entries overwrite earlier ones, matching capability resolution
+ * precedence where project overrides manager and manager overrides org.
+ */
+function personalizedCapabilityReadRoots(projectRoot, capabilityDir) {
+    const roots = [];
+    for (const layer of ['org', 'manager']) {
+        const contentRoot = resolvePackHome(layer).contentRoot;
+        roots.push({
+            scope: layer,
+            contentRoot,
+            capabilityRoot: path_1.default.join(contentRoot, capabilityDir),
+            displayRoot: contentRoot,
+            displayPrefix: displayPathForContentRoot(contentRoot),
+        });
+    }
+    if (projectRoot) {
+        const contentRoot = (0, project_fraim_paths_1.getWorkspaceFraimPath)(projectRoot, 'personalized-employee');
+        roots.push({
+            scope: 'project',
+            contentRoot,
+            capabilityRoot: path_1.default.join(contentRoot, capabilityDir),
+            displayRoot: contentRoot,
+            displayPrefix: (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee'),
+        });
+    }
+    return roots;
+}
 /**
  * Auto-migrate content stranded at the legacy standard path to the configured
  * contentRoot. Runs at most once per process per (layer + contentRoot) pair.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-hub",
-  "version": "2.0.276",
+  "version": "2.0.277",
   "description": "FRAIM Hub local companion package.",
   "bin": {
     "fraim-hub": "bin/fraim-hub.js",
@@ -168,7 +168,7 @@
     "electron-updater": "^6.8.9",
     "express": "^5.2.1",
     "extract-zip": "^2.0.1",
-    "fraim": "2.0.276",
+    "fraim": "2.0.277",
     "mongodb": "^7.0.0",
     "node-cron": "4.2.1",
     "node-edge-tts": "^1.2.10",

package/public/ai-hub/index.html

@@ -826,6 +826,25 @@
     </div>
   </div>
 
+  <!-- Issue #1278: Job visualization modal — phases + skills per job -->
+  <div id="job-viz-modal" class="modal-overlay" role="dialog" aria-modal="true" aria-labelledby="jv-title" hidden>
+    <div class="modal-card jv-modal-card">
+      <div class="modal-hdr">
+        <div class="jv-header">
+          <div class="jv-header-text">
+            <h3 id="jv-title"></h3>
+            <p id="jv-intent"></p>
+          </div>
+          <span class="jv-personalized-badge" id="jv-badge" hidden>✦ Personalized</span>
+        </div>
+        <button class="modal-close" id="jv-close" type="button" aria-label="Close job visualization">×</button>
+      </div>
+      <div class="modal-body" id="jv-body">
+        <div id="jv-phases" class="jv-phases"></div>
+      </div>
+    </div>
+  </div>
+
   <!-- Issue #512: Add-employee modal (preselect-aware) -->
   <div id="add-emp-modal" class="modal-overlay" role="dialog" aria-modal="true" aria-labelledby="ae-title" hidden>
     <div class="modal-card">

package/public/ai-hub/script.js

@@ -7373,6 +7373,19 @@ function renderJobCatalog(searchTerm = '') {
         lockBadge.textContent = `🔒 ${persona ? persona.displayName : job.requiredPersonaKey}`;
         btn.appendChild(lockBadge);
       }
+      // Issue #1278 R1/R2/R14: ⓘ button — skip ad-hoc row, stop propagation so job is not selected.
+      if (job.id !== '__freeform__') {
+        const vizBtn = document.createElement('button');
+        vizBtn.type = 'button';
+        vizBtn.className = 'job-viz-btn';
+        vizBtn.textContent = 'ⓘ';
+        vizBtn.setAttribute('aria-label', `Visualize ${job.title}`);
+        vizBtn.addEventListener('click', (e) => {
+          e.stopPropagation();
+          tfOpenJobViz(job);
+        });
+        btn.appendChild(vizBtn);
+      }
       btn.addEventListener('click', () => {
         if (isLocked) {
           // Issue #540 R10: locked jobs are now non-blocking. Allow selection and proceed
@@ -15185,6 +15198,173 @@ function tfCloseAssignJob() {
   const m = document.getElementById('assign-job-modal');
   if (m) m.hidden = true;
 }
+
+// Issue #1278 — Job Visualization Modal
+function tfOpenJobViz(job) {
+  const modal = document.getElementById('job-viz-modal');
+  if (!modal) return;
+  const titleEl = document.getElementById('jv-title');
+  const intentEl = document.getElementById('jv-intent');
+  const badgeEl = document.getElementById('jv-badge');
+  const phasesEl = document.getElementById('jv-phases');
+  if (!phasesEl) return;
+  if (titleEl) titleEl.textContent = job.title || job.id;
+  if (intentEl) intentEl.textContent = '';
+  if (badgeEl) badgeEl.hidden = true;
+  phasesEl.innerHTML = '<div class="jv-loading">Loading…</div>';
+  modal.hidden = false;
+
+  const projectPath = state.projectPath || '';
+  const url = '/api/ai-hub/job/' + encodeURIComponent(job.id) + '/visualization' +
+    (projectPath ? '?projectPath=' + encodeURIComponent(projectPath) : '');
+
+  fetch(url)
+    .then((r) => r.json())
+    .then((data) => {
+      if (titleEl) titleEl.textContent = data.title || job.title || job.id;
+      if (intentEl) intentEl.textContent = data.intent || '';
+      if (badgeEl) { badgeEl.hidden = !data.personalized; }
+      phasesEl.innerHTML = '';
+      if (!data.phases || data.phases.length === 0) {
+        phasesEl.innerHTML = '<div class="jv-loading">No phase data available for this job.</div>';
+        return;
+      }
+      // Scroll wrapper separates horizontal scrolling from the overflow context
+      // so absolutely-positioned popovers are not clipped by overflow-x:auto.
+      const scrollWrap = document.createElement('div');
+      scrollWrap.className = 'jv-phases-scroll';
+      phasesEl.appendChild(scrollWrap);
+      data.phases.forEach((phase, idx) => {
+        const wrap = document.createElement('div');
+        wrap.className = 'jv-phase-wrap';
+
+        const phaseEl = document.createElement('div');
+        phaseEl.className = 'jv-phase';
+        phaseEl.setAttribute('data-phase-id', phase.id);
+
+        const card = document.createElement('div');
+        card.className = 'jv-phase-card';
+        const numEl = document.createElement('div');
+        numEl.className = 'jv-phase-number';
+        numEl.textContent = String(idx + 1);
+        const labelEl = document.createElement('div');
+        labelEl.className = 'jv-phase-label';
+        labelEl.textContent = phase.label || phase.id;
+        card.appendChild(numEl);
+        card.appendChild(labelEl);
+        phaseEl.appendChild(card);
+
+        // Store tooltip content in data attributes (rendered via #jv-tt portal)
+        phaseEl.dataset.jvIntent = phase.intent || '';
+        phaseEl.dataset.jvOutcome = phase.outcome || '';
+        phaseEl.addEventListener('mouseenter', jvShowPhaseTooltip);
+        phaseEl.addEventListener('mouseleave', jvHideTooltip);
+
+        // Skill chips
+        if (phase.skills && phase.skills.length > 0) {
+          const skillsRow = document.createElement('div');
+          skillsRow.className = 'jv-skills';
+          phase.skills.forEach((skill) => {
+            const wrapper = document.createElement('div');
+            wrapper.className = 'jv-skill-wrap';
+            wrapper.setAttribute('data-skill-id', skill.id);
+            const chip = document.createElement('span');
+            chip.className = 'jv-skill';
+            chip.textContent = skill.label || skill.id;
+            chip.dataset.jvInput = skill.input || '';
+            chip.dataset.jvOutput = skill.output || '';
+            chip.addEventListener('mouseenter', jvShowSkillTooltip);
+            chip.addEventListener('mouseleave', jvHideTooltip);
+            wrapper.appendChild(chip);
+            skillsRow.appendChild(wrapper);
+          });
+          phaseEl.appendChild(skillsRow);
+        }
+
+        wrap.appendChild(phaseEl);
+        const arrow = document.createElement('span');
+        arrow.className = 'jv-arrow';
+        arrow.textContent = '→';
+        wrap.appendChild(arrow);
+        scrollWrap.appendChild(wrap);
+      });
+    })
+    .catch(() => {
+      if (phasesEl) phasesEl.innerHTML = '<div class="jv-loading">Could not load job details.</div>';
+    });
+}
+function tfCloseJobViz() {
+  const m = document.getElementById('job-viz-modal');
+  if (m) m.hidden = true;
+  jvHideTooltip();
+}
+
+// Issue #1278 — fixed-position tooltip portal, escapes scroll-container clip
+function jvGetOrCreateTooltip() {
+  let tt = document.getElementById('jv-tt');
+  if (!tt) {
+    tt = document.createElement('div');
+    tt.id = 'jv-tt';
+    tt.setAttribute('role', 'tooltip');
+    tt.hidden = true;
+    document.body.appendChild(tt);
+  }
+  return tt;
+}
+
+function jvPositionTooltip(anchor) {
+  const tt = jvGetOrCreateTooltip();
+  tt.hidden = false;
+  const r = anchor.getBoundingClientRect();
+  const ttW = tt.offsetWidth || 220;
+  const ttH = tt.offsetHeight || 80;
+  let top = r.bottom + 8;
+  let left = r.left + r.width / 2 - ttW / 2;
+  // Clamp to viewport
+  if (left + ttW > window.innerWidth - 8) left = window.innerWidth - ttW - 8;
+  if (left < 8) left = 8;
+  if (top + ttH > window.innerHeight - 8) top = r.top - ttH - 8;
+  tt.style.top = top + 'px';
+  tt.style.left = left + 'px';
+}
+
+function jvShowPhaseTooltip(e) {
+  const phase = e.currentTarget;
+  const intent = phase.dataset.jvIntent;
+  const outcome = phase.dataset.jvOutcome;
+  const tt = jvGetOrCreateTooltip();
+  if (!intent && !outcome) {
+    tt.innerHTML = '<div class="jv-popover-row">Ask your agent for full details.</div>';
+  } else {
+    let html = '';
+    if (intent) html += '<div class="jv-popover-row"><div class="jv-popover-label">Intent</div>' + tfEscape(intent) + '</div>';
+    if (outcome) html += '<div class="jv-popover-row"><div class="jv-popover-label">Outcome</div>' + tfEscape(outcome) + '</div>';
+    tt.innerHTML = html;
+  }
+  jvPositionTooltip(phase.querySelector('.jv-phase-card') || phase);
+}
+
+function jvShowSkillTooltip(e) {
+  const chip = e.currentTarget;
+  const input = chip.dataset.jvInput;
+  const output = chip.dataset.jvOutput;
+  const tt = jvGetOrCreateTooltip();
+  if (!input && !output) {
+    tt.innerHTML = '<div class="jv-popover-row">Ask your agent for full details.</div>';
+  } else {
+    let html = '';
+    if (input) html += '<div class="jv-popover-row"><div class="jv-popover-label">Input</div>' + tfEscape(input) + '</div>';
+    if (output) html += '<div class="jv-popover-row"><div class="jv-popover-label">Output</div>' + tfEscape(output) + '</div>';
+    tt.innerHTML = html;
+  }
+  jvPositionTooltip(chip);
+}
+
+function jvHideTooltip() {
+  const tt = document.getElementById('jv-tt');
+  if (tt) tt.hidden = true;
+}
+
 function tfAssignJobToEmployee(employeeKey, job) {
   const projectId = tf.activeProjectId;
   if (!projectId) { tfCloseAssignJob(); return; }
@@ -15487,7 +15667,7 @@ function tfWireShell() {
   if (aomStart) aomStart.addEventListener('click', tfSubmitAreaOnboardModal);
   const aomModal = document.getElementById('area-onboard-modal');
   if (aomModal) aomModal.addEventListener('click', (e) => { if (e.target === aomModal) tfCloseAreaOnboardModal(); });
-  const closers = [['aj-close', tfCloseAssignJob], ['ae-close', tfCloseAddEmp], ['pr-close', tfClosePricing], ['hm-close', tfCloseHireManager]];
+  const closers = [['aj-close', tfCloseAssignJob], ['ae-close', tfCloseAddEmp], ['pr-close', tfClosePricing], ['hm-close', tfCloseHireManager], ['jv-close', tfCloseJobViz]];
   for (const [id, fn] of closers) {
     const el = document.getElementById(id);
     if (el) el.addEventListener('click', fn);
@@ -15513,7 +15693,7 @@ function tfWireShell() {
     const q = document.getElementById('hm-query');
     if (q && navigator.clipboard) navigator.clipboard.writeText(q.textContent || '');
   });
-  const backdrops = [['assign-job-modal', tfCloseAssignJob], ['add-emp-modal', tfCloseAddEmp], ['pricing-modal', tfClosePricing], ['hm-modal', tfCloseHireManager]];
+  const backdrops = [['assign-job-modal', tfCloseAssignJob], ['add-emp-modal', tfCloseAddEmp], ['pricing-modal', tfClosePricing], ['hm-modal', tfCloseHireManager], ['job-viz-modal', tfCloseJobViz]];
   for (const [id, fn] of backdrops) {
     const el = document.getElementById(id);
     if (el) el.addEventListener('click', (e) => { if (e.target === el) fn(); });
@@ -15523,6 +15703,7 @@ function tfWireShell() {
   // Escape — unlike the legacy conversation modal. Add an Escape handler that
   // dismisses whichever team-flow modal is open (top-most first).
   const escClosers = [
+    ['job-viz-modal', tfCloseJobViz],
     ['hm-modal', tfCloseHireManager],
     ['pricing-modal', tfClosePricing],
     ['add-emp-modal', tfCloseAddEmp],

package/public/ai-hub/styles.css

@@ -6359,3 +6359,80 @@ img.eh-av { object-fit: cover; background: var(--surface); }
 /* ─── End Issue #1065 ────────────────────────────────────────────────────── */
 
 /* ─── End Issue #1178 ────────────────────────────────────────────────────── */
+
+/* ─── Issue #1278: Job Visualization Modal ──────────────────────────────── */
+/* Must sit above .modal-backdrop (z-index:100) so clicks reach #jv-close. */
+#job-viz-modal { z-index: 110; }
+.jv-modal-card { max-width: 860px; }
+.jv-header { display: flex; align-items: flex-start; gap: 10px; }
+.jv-header-text { flex: 1; min-width: 0; }
+.jv-header-text h3 { margin: 0 0 4px; font-size: 17px; font-weight: 700; }
+.jv-header-text p { margin: 0; color: var(--muted); font-size: 13px; line-height: 1.5; }
+.jv-personalized-badge {
+  display: inline-flex; align-items: center; gap: 4px;
+  padding: 2px 8px; border-radius: 20px; flex-shrink: 0; margin-top: 2px;
+  font-size: 11px; font-weight: 600; letter-spacing: .04em;
+  background: var(--accent-soft); color: var(--accent);
+  border: 1px solid var(--accent); white-space: nowrap;
+}
+.jv-phases { position: relative; overflow: visible; padding: 8px 0 0; }
+.jv-phases-scroll {
+  display: flex; align-items: flex-start; gap: 0;
+  overflow-x: auto; padding-bottom: 16px;
+  scrollbar-width: thin; scrollbar-color: rgba(0,0,0,.15) transparent;
+}
+.jv-phase-wrap { display: flex; align-items: flex-start; gap: 0; flex-shrink: 0; }
+.jv-phase-wrap:last-child .jv-arrow { display: none; }
+.jv-arrow { align-self: flex-start; margin-top: 14px; color: var(--muted); font-size: 14px; padding: 0 4px; flex-shrink: 0; }
+.jv-phase { display: flex; flex-direction: column; align-items: center; min-width: 120px; max-width: 148px; position: relative; }
+.jv-phase-card {
+  width: 100%; background: var(--surface); border: 1px solid var(--line); border-radius: 8px;
+  padding: 8px 10px; text-align: center; font-size: 12px; font-weight: 600; color: var(--text);
+  transition: border-color 120ms, background 120ms; user-select: none; cursor: default;
+}
+.jv-phase-number {
+  width: 20px; height: 20px; border-radius: 50%; margin: 0 auto 5px;
+  background: var(--accent-soft); border: 1.5px solid var(--accent);
+  color: var(--accent); font-size: 10px; font-weight: 700;
+  display: flex; align-items: center; justify-content: center;
+}
+.jv-phase-label { line-height: 1.3; }
+.jv-skills { display: flex; flex-wrap: wrap; gap: 4px; justify-content: center; padding: 6px 2px 0; max-width: 148px; }
+.jv-skill {
+  display: inline-flex; align-items: center; padding: 2px 7px; border-radius: 12px;
+  font-size: 10px; font-weight: 500; background: var(--soft); color: var(--muted);
+  border: 1px solid var(--line); cursor: default; white-space: nowrap;
+  max-width: 140px; overflow: hidden; text-overflow: ellipsis;
+  transition: background 120ms, color 120ms, border-color 120ms;
+}
+.jv-skill:hover { background: var(--accent-soft); color: var(--accent); border-color: var(--accent); }
+/* #jv-tt: fixed-position tooltip portal; appended to body, escapes scroll-container clip */
+#jv-tt {
+  position: fixed; z-index: 9000;
+  background: var(--surface); border: 1px solid var(--line);
+  border-radius: 8px; box-shadow: 0 4px 16px rgba(0,0,0,.15);
+  padding: 10px 12px; min-width: 180px; max-width: 260px;
+  font-size: 12px; line-height: 1.5; color: var(--text); pointer-events: none;
+  white-space: normal; text-align: left;
+}
+.jv-phase:hover .jv-phase-card { border-color: var(--accent); background: var(--accent-soft); }
+.jv-skill:hover { background: var(--accent-soft); color: var(--accent); border-color: var(--accent); }
+.jv-popover-row { margin-bottom: 6px; }
+.jv-popover-row:last-child { margin-bottom: 0; }
+.jv-popover-label { font-size: 10px; font-weight: 700; text-transform: uppercase; letter-spacing: .05em; color: var(--muted); margin-bottom: 2px; }
+.jv-skill-wrap { display: inline-flex; }
+.jv-loading { color: var(--muted); font-size: 13px; padding: 24px 0; text-align: center; }
+/* ⓘ button on job cards in the assign-job picker */
+.job-option { position: relative; display: grid; grid-template-columns: 1fr auto; align-items: start; gap: 2px 6px; }
+.job-option > strong { grid-column: 1; }
+.job-option > span:not(.lock-badge) { grid-column: 1; }
+.job-viz-btn {
+  grid-column: 2; grid-row: 1;
+  background: transparent; border: none; padding: 2px 4px;
+  color: var(--muted); font-size: 13px; cursor: pointer;
+  border-radius: 4px; line-height: 1;
+  transition: background 120ms, color 120ms;
+}
+.job-viz-btn:hover { background: var(--soft); color: var(--accent); }
+.job-viz-btn:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+/* ─── End Issue #1278 ────────────────────────────────────────────────────── */