fraim-hub 2.0.267 → 2.0.269

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

@@ -7,6 +7,7 @@ exports.summarizeProject = summarizeProject;
 exports.discoverEmployeeJobs = discoverEmployeeJobs;
 exports.discoverManagerTemplates = discoverManagerTemplates;
 exports.loadJobPhases = loadJobPhases;
+exports.resolveJobPhaseTransition = resolveJobPhaseTransition;
 exports.loadAllJobPhaseIds = loadAllJobPhaseIds;
 exports.labelForPhaseId = labelForPhaseId;
 exports.getAiHubCategories = getAiHubCategories;
@@ -470,6 +471,19 @@ function loadJobPhases(jobId, projectPath, discriminant = 'feature') {
 // this job before appending it to the tracker, so cross-job pollution
 // (agent calling seekMentoring for a different job mid-run) cannot
 // surface stages from elsewhere.
+function resolveJobPhaseTransition(jobId, projectPath, phaseId, outcome, discriminant = 'feature') {
+    const stubPath = findJobStubPath(projectPath, jobId);
+    if (!stubPath)
+        return null;
+    const fm = readJobFrontmatter(stubPath);
+    if (!fm || !fm.phases)
+        return null;
+    const phaseDef = fm.phases[phaseId];
+    if (!phaseDef)
+        return null;
+    const edge = outcome === 'complete' ? phaseDef.onSuccess : phaseDef.onFailure;
+    return nextPhase(edge, discriminant);
+}
 function loadAllJobPhaseIds(jobId, projectPath) {
     const stubPath = findJobStubPath(projectPath, jobId);
     if (!stubPath)

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

@@ -36,6 +36,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DESKTOP_HUB_READY_TIMEOUT_ENV = void 0;
+exports.resolveDesktopReadyTimeoutMs = resolveDesktopReadyTimeoutMs;
 exports.waitForDesktopHubReady = waitForDesktopHubReady;
 exports.runHub = runHub;
 // Hub-owned launcher used by the fraim-hub package. Keep this outside
@@ -207,9 +209,55 @@ function fetchRunningHubVersion(port) {
         req.on('timeout', () => { req.destroy(); resolve(null); });
     });
 }
+// #1110: the desktop shell's cold-start cost is work this launcher can neither see nor bound.
+// Before the Hub can answer /api/ai-hub/version it pays for Electron process boot, top-level
+// evaluation of the src/ai-hub/server.ts module graph, cert load plus a blocking certutil
+// trust call, and finally the listens. The same path measured 3.3s on an idle machine and
+// 20.5s on a real `npx fraim-hub@latest --restart` immediately after a release, when npm has
+// just written a fresh Electron dist. A fixed budget inside that spread turns a healthy launch
+// into a reported failure, which is what issue #1110 reports.
+//
+// The only positive evidence of a failed launch is the child dying, and that is handled
+// separately below. A live child that has not answered yet is still starting, so the wait is
+// long, says so out loud while it waits, and stays tunable for slower machines.
+exports.DESKTOP_HUB_READY_TIMEOUT_ENV = 'FRAIM_HUB_READY_TIMEOUT_MS';
+const DEFAULT_DESKTOP_HUB_READY_TIMEOUT_MS = 120000;
+const DEFAULT_DESKTOP_HUB_READY_PROGRESS_MS = 15000;
+function resolveDesktopReadyTimeoutMs() {
+    const configured = Number(process.env[exports.DESKTOP_HUB_READY_TIMEOUT_ENV]);
+    if (Number.isFinite(configured) && configured > 0)
+        return configured;
+    return DEFAULT_DESKTOP_HUB_READY_TIMEOUT_MS;
+}
+// Whole seconds read best at the real cadence (15s, 30s, 120s), but rounding a sub-second
+// duration to whole seconds prints "after 0s" or repeats "1s elapsed" on consecutive notices.
+// Keep one decimal below this threshold so the number is never wrong at any budget.
+const READY_SECONDS_DECIMAL_BELOW_MS = 10000;
+function formatReadySeconds(durationMs) {
+    return durationMs >= READY_SECONDS_DECIMAL_BELOW_MS
+        ? `${Math.round(durationMs / 1000)}s`
+        : `${Math.round(durationMs / 100) / 10}s`;
+}
+function reportDesktopReadyProgress(progress) {
+    console.log(`Still waiting for the FRAIM Hub desktop shell on port ${progress.port} `
+        + `(${formatReadySeconds(progress.elapsedMs)} elapsed, giving up at ${formatReadySeconds(progress.timeoutMs)}). `
+        + 'A first launch after an upgrade unpacks Electron, so this can take a while.');
+}
+// Where the Hub could be answering: the shell records its chosen port in the runtime file once
+// it is listening, which is the only way the launcher learns about a port other than the one it
+// asked for. Re-read every poll, because that file is written mid-wait.
+function readinessProbePorts(fraimDir, runtimeId, preferredPort) {
+    const runtime = (0, hub_runtime_file_1.readHubRuntimeFile)(fraimDir, runtimeId);
+    return runtime?.port && runtime.port !== preferredPort
+        ? [runtime.port, preferredPort]
+        : [preferredPort];
+}
 async function waitForDesktopHubReady(child, preferredPort, options = {}) {
-    const timeoutMs = options.timeoutMs ?? 15000;
+    const timeoutMs = options.timeoutMs ?? resolveDesktopReadyTimeoutMs();
     const pollMs = options.pollMs ?? 250;
+    const progressAfterMs = options.progressAfterMs ?? DEFAULT_DESKTOP_HUB_READY_PROGRESS_MS;
+    const progressIntervalMs = options.progressIntervalMs ?? progressAfterMs;
+    const onProgress = options.onProgress ?? reportDesktopReadyProgress;
     const runtimeId = options.runtimeId || 'hub';
     const fraimDir = options.fraimDir || (0, project_fraim_paths_1.getUserFraimDirPath)();
     const start = Date.now();
@@ -220,7 +268,10 @@ async function waitForDesktopHubReady(child, preferredPort, options = {}) {
     child.once('error', (error) => {
         childState.error = error;
     });
-    while (Date.now() - start < timeoutMs) {
+    // A dead child is the only positive evidence that the launch failed, so it always wins over
+    // the elapsed budget. Checked at the top of every poll and once more after the loop, so a
+    // child that dies during the final sleep is still reported as an exit and not as a timeout.
+    const failIfChildDied = () => {
         if (childState.error) {
             throw new Error(`FRAIM Hub desktop shell failed to launch: ${childState.error.message}`);
         }
@@ -228,19 +279,30 @@ async function waitForDesktopHubReady(child, preferredPort, options = {}) {
             const detail = childState.exit.signal ? `signal ${childState.exit.signal}` : `exit code ${childState.exit.code ?? 'unknown'}`;
             throw new Error(`FRAIM Hub desktop shell exited before the Hub became ready (${detail}).`);
         }
-        const runtime = (0, hub_runtime_file_1.readHubRuntimeFile)(fraimDir, runtimeId);
-        const ports = runtime?.port && runtime.port !== preferredPort
-            ? [runtime.port, preferredPort]
-            : [preferredPort];
-        for (const port of ports) {
+    };
+    let nextProgressAtMs = progressAfterMs;
+    while (Date.now() - start < timeoutMs) {
+        failIfChildDied();
+        for (const port of readinessProbePorts(fraimDir, runtimeId, preferredPort)) {
             const version = await fetchRunningHubVersion(port);
             if (version) {
                 return { port, version };
             }
         }
+        const elapsedMs = Date.now() - start;
+        if (elapsedMs >= nextProgressAtMs) {
+            onProgress({ elapsedMs, timeoutMs, port: preferredPort });
+            nextProgressAtMs = elapsedMs + progressIntervalMs;
+        }
         await new Promise((r) => setTimeout(r, pollMs));
     }
-    throw new Error(`Timed out waiting for FRAIM Hub desktop shell to become ready on port ${preferredPort}.`);
+    failIfChildDied();
+    const stillRunning = typeof child.pid === 'number'
+        ? ` The desktop shell (pid ${child.pid}) is still running and may finish starting on its own.`
+        : '';
+    throw new Error(`Timed out waiting for FRAIM Hub desktop shell to become ready on port ${preferredPort} after ${formatReadySeconds(timeoutMs)}.`
+        + `${stillRunning}`
+        + ` Set ${exports.DESKTOP_HUB_READY_TIMEOUT_ENV} to a larger value if this machine needs longer.`);
 }
 async function reconcileRunningHub(flags, runtimeId = 'hub') {
     const running = (0, hub_runtime_file_1.readHubRuntimeFile)((0, project_fraim_paths_1.getUserFraimDirPath)(), runtimeId);

package/dist/src/ai-hub/desktop-main.js

@@ -5,7 +5,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.launchDesktopShell = launchDesktopShell;
 const electron_1 = require("electron");
-const electron_updater_1 = require("electron-updater");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const server_1 = require("./server");
@@ -91,8 +90,14 @@ function ensureLoginItem() {
 function configureAutoUpdater() {
     if (!electron_1.app.isPackaged)
         return;
-    electron_updater_1.autoUpdater.autoDownload = true;
-    electron_updater_1.autoUpdater.checkForUpdatesAndNotify().catch((err) => {
+    // #1110: electron-updater compiles ~114 files (js-yaml, builder-util-runtime, ...) that a
+    // non-packaged `npx fraim-hub` launch never uses, and this whole function returns early
+    // there. Requiring it lazily keeps those file reads off the cold-start path, which is what
+    // dominates time-to-ready on a freshly unpacked install.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { autoUpdater } = require('electron-updater');
+    autoUpdater.autoDownload = true;
+    autoUpdater.checkForUpdatesAndNotify().catch((err) => {
         console.warn('[fraim] auto-update check failed:', err);
     });
 }
@@ -329,13 +334,10 @@ async function launchDesktopShell(options) {
     const httpsPort = await (0, server_1.findAvailablePortExcluding)(43092, new Set([httpPort]));
     // Generate (or load cached) self-signed cert for HTTPS.
     // Fast on subsequent launches (file read); ~200ms on first launch (key gen).
+    // The cert bundle itself is needed here because server.start() binds the HTTPS listener with
+    // it. Trusting it in the OS store is a separate, Word-Online-only concern and happens after
+    // the Hub is serving (#1110) - see below.
     const certBundle = await (0, cert_store_1.loadOrCreateCert)();
-    try {
-        (0, cert_store_1.trustCert)((0, cert_store_1.certPaths)().certPath);
-    }
-    catch (err) {
-        console.warn('[fraim] could not trust localhost certificate:', err);
-    }
     server = new server_1.AiHubServer({
         ...(options.projectPath ? { projectPath: options.projectPath } : {}),
         // Issue #701: no local DB. Persona/manager-team state resolves through the hosted
@@ -366,6 +368,16 @@ async function launchDesktopShell(options) {
     catch (err) {
         console.warn('[fraim] could not write hub runtime file:', err);
     }
+    // #1110: trusting the loopback cert in the OS store is a blocking `certutil` subprocess and
+    // is only needed so Word *Online* will render the task pane over HTTPS. The Hub does not need
+    // it to serve, so it runs after the server is listening rather than in front of it. Grouped
+    // with the Office sideload because both are Word-only first-run housekeeping.
+    try {
+        (0, cert_store_1.trustCert)((0, cert_store_1.certPaths)().certPath);
+    }
+    catch (err) {
+        console.warn('[fraim] could not trust localhost certificate:', err);
+    }
     ensureWordSideload(resolvedProjectPath, httpsPort);
     const hubUrl = `http://127.0.0.1:${httpPort}/ai-hub/`;
     createTray(hubUrl, runtimeId);

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

@@ -33,7 +33,6 @@ const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const manager_turns_1 = require("./manager-turns");
 const managed_agent_paths_1 = require("../cli/utils/managed-agent-paths");
-const mcp_config_generator_1 = require("../cli/setup/mcp-config-generator");
 const agent_token_prices_1 = require("../local-mcp-server/agent-token-prices");
 const configured_agents_1 = require("./configured-agents");
 const pack_home_1 = require("../cli/utils/pack-home");
@@ -1155,7 +1154,13 @@ function prepareCodexBrowserHome(cdp, env = process.env) {
         const realConfig = path_1.default.join(real, 'config.toml');
         const existing = fs_1.default.existsSync(realConfig) ? fs_1.default.readFileSync(realConfig, 'utf8') : '';
         const pwBlock = `[mcp_servers.playwright]\ncommand = "npx"\nargs = ["-y", "@playwright/mcp@latest", "--cdp-endpoint", "${cdp}"]\n`;
-        const merged = (0, mcp_config_generator_1.mergeTomlMCPServers)(existing, pwBlock, ['playwright']).content;
+        // #1110: this is the only use of mcp-config-generator here, and it runs when a run launches,
+        // never at Hub startup. Importing it at module scope pulled the whole
+        // mcp-server-builder -> mcp-server-registry -> provider-registry -> provider-client -> axios
+        // chain (~30 files) into the graph the Hub must compile before it can listen.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { mergeTomlMCPServers } = require('../cli/setup/mcp-config-generator');
+        const merged = mergeTomlMCPServers(existing, pwBlock, ['playwright']).content;
         fs_1.default.writeFileSync(path_1.default.join(home, 'config.toml'), merged, 'utf8');
         // Auth + the session index (so resume can find existing rollouts by thread id).
         for (const f of ['auth.json', 'session_index.jsonl', 'history.jsonl']) {

package/dist/src/ai-hub/remote-hub-gateway.js

@@ -1,11 +1,7 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpHubRemoteGateway = void 0;
 exports.resolveFraimRemoteUrl = resolveFraimRemoteUrl;
-const axios_1 = __importDefault(require("axios"));
 function resolveFraimRemoteUrl(explicit) {
     return (explicit || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me').replace(/\/+$/, '');
 }
@@ -18,7 +14,12 @@ class HttpHubRemoteGateway {
         this.baseURL = resolveFraimRemoteUrl(serverUrl);
     }
     client(apiKey) {
-        return axios_1.default.create({
+        // #1110: the Hub server module graph is loaded before the local server can listen, and the
+        // axios subtree is ~28 files of that graph. Nothing here runs during startup - every caller
+        // is a request handler - so axios is required on first use instead of at import time.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const axios = require('axios');
+        return axios.create({
             baseURL: this.baseURL,
             headers: { 'x-api-key': apiKey, 'Content-Type': 'application/json' },
             timeout: 10000,

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

@@ -68,13 +68,21 @@ 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");
 const user_config_1 = require("../cli/utils/user-config");
-const org_publish_1 = require("../cli/utils/org-publish");
 const version_utils_1 = require("../cli/utils/version-utils");
 const hub_latest_version_1 = require("./hub-latest-version");
 const ui_runtime_1 = require("./ui-runtime");
 const ui_cache_1 = require("./ui-cache");
-const semver = __importStar(require("semver"));
 const tree_kill_1 = __importDefault(require("tree-kill"));
+// #1110: semver compiles 45 files and this module graph must load before the Hub can listen,
+// so it is required on use rather than at import time. `latest` is null until the best-effort
+// npm registry lookup succeeds, and on that path semver is never needed at all.
+function isNewerPublishedVersion(latest, current) {
+    if (!latest)
+        return false;
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const semver = require('semver');
+    return !!(semver.valid(current) && semver.valid(latest) && semver.gt(latest, current));
+}
 const BOOTSTRAP_PERSONA_FIRST_PAINT_BUDGET_MS = 250;
 let personaHiringModule;
 let managerHiringModule;
@@ -200,6 +208,9 @@ function resolveConversationPersonaKey(conversation, projectPath, customJobOwner
     const custom = customJobOwners
         ? customJobOwners.get(jobId) ?? null
         : getCustomPersonaForJob(projectPath, jobId);
+    if (!custom && conversation.personaKey?.startsWith('custom:')) {
+        return conversation.personaKey;
+    }
     return custom ?? getHubPersonaForJob(jobId);
 }
 /**
@@ -953,6 +964,28 @@ function normalizePersistedPhaseHistory(value) {
     })
         .filter((entry) => Boolean(entry));
 }
+function normalizePersistedPhaseVisits(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')
@@ -961,6 +994,7 @@ function readPersistedRunProjection(conversation) {
     return {
         currentPhase: typeof value.currentPhase === 'string' ? value.currentPhase : null,
         phaseHistory: normalizePersistedPhaseHistory(value.phaseHistory),
+        phaseVisits: normalizePersistedPhaseVisits(value.phaseVisits),
         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,
@@ -1137,6 +1171,28 @@ function applyAgentIdentitySignal(run, identity) {
     run.agentName = identity.agentName;
     run.agentModel = identity.agentModel;
 }
+function recordPhaseVisit(run, phaseId, latestStatus, latestText = null) {
+    run.phaseVisits = run.phaseVisits || [];
+    const last = run.phaseVisits[run.phaseVisits.length - 1];
+    if (last && last.phaseId === phaseId) {
+        last.latestStatus = latestStatus;
+        if (latestText)
+            last.latestText = latestText;
+        return;
+    }
+    run.phaseVisits.push({
+        phaseId,
+        enteredAt: new Date().toISOString(),
+        latestStatus,
+        latestText,
+    });
+}
+function appendSyntheticPhaseVisit(run, phaseId) {
+    const last = run.phaseVisits?.[run.phaseVisits.length - 1];
+    if (last?.phaseId === phaseId)
+        return;
+    recordPhaseVisit(run, phaseId, 'starting', null);
+}
 function stripStructuredHostPayloads(text) {
     return text
         .replace(/<delegation_ledger>\s*[\s\S]*?\s*<\/delegation_ledger>/gi, '')
@@ -1253,7 +1309,25 @@ function applySeekMentoringSignal(run, signal) {
         };
         run.phaseHistory.push(entry);
     }
+    recordPhaseVisit(run, signal.phaseId, signal.phaseStatus, signal.findingsText || null);
     run.currentPhase = signal.phaseId;
+    if (signal.phaseStatus === 'failure') {
+        const nextPhase = (0, catalog_1.resolveJobPhaseTransition)(run.jobId, run.projectPath, signal.phaseId, 'failure', run.runDiscriminant || 'feature');
+        if (nextPhase) {
+            appendSyntheticPhaseVisit(run, nextPhase);
+            run.currentPhase = nextPhase;
+        }
+    }
+}
+function phaseVisitsForProjection(run) {
+    if (Array.isArray(run.phaseVisits) && run.phaseVisits.length > 0)
+        return run.phaseVisits;
+    return (run.phaseHistory || []).map((entry) => ({
+        phaseId: entry.phaseId,
+        enteredAt: entry.enteredAt,
+        latestStatus: entry.latestStatus,
+        latestText: entry.latestText,
+    }));
 }
 // Build the stage list for a run. Combines the FSM's reachable path with
 // any phases the run has actually visited (in case the run took an
@@ -1272,7 +1346,8 @@ function deriveStages(run, projectPath) {
     // phase id NOT in the frontmatter — that last filter prevents
     // cross-job pollution from showing up on the tracker.
     const allDeclared = (0, catalog_1.loadAllJobPhaseIds)(run.jobId, projectPath);
-    const visited = (run.phaseHistory || []).map((entry) => entry.phaseId);
+    const visits = phaseVisitsForProjection(run);
+    const visited = visits.map((entry) => entry.phaseId);
     const known = new Set(declaredPath.map((p) => p.id));
     for (const visitedId of visited) {
         if (visitedId === 'starting' || visitedId === '__discriminant__')
@@ -1288,29 +1363,51 @@ function deriveStages(run, projectPath) {
         ? declaredPath.findIndex((p) => p.id === run.currentPhase)
         : -1;
     const historyMap = new Map((run.phaseHistory || []).map((e) => [e.phaseId, e]));
+    const visitsByPhase = new Map();
+    for (const visit of visits) {
+        const existing = visitsByPhase.get(visit.phaseId) || [];
+        existing.push(visit);
+        visitsByPhase.set(visit.phaseId, existing);
+    }
     const completedWithoutPhaseTelemetry = run.status === 'completed' &&
         currentIndex < 0 &&
-        historyMap.size === 0;
+        historyMap.size === 0 &&
+        visits.length === 0;
     if (completedWithoutPhaseTelemetry) {
         return declaredPath.map((phase) => ({ phaseId: phase.id, label: phase.label, state: 'done' }));
     }
     return declaredPath.map((phase, index) => {
         let state;
         const entry = historyMap.get(phase.id);
+        const phaseVisits = visitsByPhase.get(phase.id) || [];
+        const latestVisit = phaseVisits[phaseVisits.length - 1] || null;
+        const latestStatus = latestVisit?.latestStatus ?? entry?.latestStatus ?? null;
+        const latestText = latestVisit?.latestText ?? entry?.latestText ?? null;
         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).
-            state = entry?.latestStatus === 'complete' ? 'done' : 'current';
+            state = latestStatus === 'complete' ? 'done' : 'current';
         }
-        else if (entry?.latestStatus === 'complete' || (currentIndex >= 0 && index < currentIndex && entry)) {
+        else if (latestStatus === 'complete' ||
+            latestStatus === 'failure' ||
+            latestStatus === 'incomplete' ||
+            (currentIndex >= 0 && index < currentIndex && phaseVisits.length > 0)) {
             state = 'done';
         }
         else {
             state = 'upcoming';
         }
-        return { phaseId: phase.id, label: phase.label, state };
+        return {
+            phaseId: phase.id,
+            label: phase.label,
+            state,
+            visitCount: phaseVisits.length,
+            currentVisit: phase.id === run.currentPhase && phaseVisits.length > 0 ? phaseVisits.length : null,
+            latestStatus,
+            latestText,
+        };
     });
 }
 // ---------------------------------------------------------------------------
@@ -2519,6 +2616,7 @@ class AiHubServer {
                 stages,
                 currentPhase: run.currentPhase || null,
                 phaseHistory: run.phaseHistory || [],
+                phaseVisits: run.phaseVisits || [],
                 totals: run.totals || null,
                 runDiscriminant: run.runDiscriminant || null,
             },
@@ -2788,6 +2886,7 @@ class AiHubServer {
             ],
             currentPhase: persistedRun?.currentPhase || null,
             phaseHistory: persistedRun?.phaseHistory || [],
+            phaseVisits: persistedRun?.phaseVisits || [],
             totals: persistedRun?.totals || emptyTotals(),
             runDiscriminant: persistedRun?.runDiscriminant || undefined,
             artifacts: Array.isArray(conversation.artifacts) ? conversation.artifacts : [],
@@ -3145,6 +3244,7 @@ class AiHubServer {
             events: [(0, hosts_1.createHubEvent)('system', `Mandy started delegated workstream ${task.taskId} for ${task.personaKey || task.jobId}.`)],
             currentPhase: null,
             phaseHistory: [],
+            phaseVisits: [],
             totals: emptyTotals(),
             lastStatusChangeAt: now,
             personaKey: task.personaKey,
@@ -4148,6 +4248,7 @@ class AiHubServer {
                         ],
                         currentPhase: persistedRun?.currentPhase || null,
                         phaseHistory: persistedRun?.phaseHistory || [],
+                        phaseVisits: persistedRun?.phaseVisits || [],
                         stages: persistedRun?.stages || [],
                         totals: persistedRun?.totals || emptyTotals(),
                         lastStatusChangeAt: now,
@@ -4420,7 +4521,7 @@ class AiHubServer {
         this.app.get('/api/ai-hub/version', async (_req, res) => {
             const version = (0, version_utils_1.getFraimVersion)();
             const latest = await (0, hub_latest_version_1.getLatestPublishedVersion)();
-            const updateAvailable = !!(latest && semver.valid(version) && semver.valid(latest) && semver.gt(latest, version));
+            const updateAvailable = isNewerPublishedVersion(latest, version);
             const uiRuntime = await this.resolveHubUiRuntimeResponse();
             return res.json({
                 version,
@@ -4585,7 +4686,12 @@ class AiHubServer {
                 return res.json({ ok: true, brand: stored, published: false });
             }
             try {
-                await (0, org_publish_1.publishOrgArtifacts)([{
+                // #1110: org-publish drags in pack-git-publish and the whole axios subtree (~28 files)
+                // that the Hub must otherwise compile before it can listen. Only this one brand-publish
+                // handler needs it, so it is required on use rather than at import time.
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { publishOrgArtifacts } = require('../cli/utils/org-publish');
+                await publishOrgArtifacts([{
                         relativePath: 'context/org_brand.json',
                         content: JSON.stringify(stored, null, 2),
                     }]);
@@ -4854,6 +4960,7 @@ class AiHubServer {
                     // Issue #347 — seed phase + totals state on creation.
                     currentPhase: null,
                     phaseHistory: [],
+                    phaseVisits: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
                     personaKey: jobMetadata?.personaKey ?? getHubPersonaForJob(jobId),
@@ -5285,6 +5392,7 @@ class AiHubServer {
                     // resuming the session starts a fresh job, so the tracker must be blank.
                     currentPhase: persistedConversation?.status !== 'completed' ? (persistedRun?.currentPhase || null) : null,
                     phaseHistory: persistedConversation?.status !== 'completed' ? (persistedRun?.phaseHistory || []) : [],
+                    phaseVisits: persistedConversation?.status !== 'completed' ? (persistedRun?.phaseVisits || []) : [],
                     totals: persistedRun?.totals || emptyTotals(),
                     lastStatusChangeAt: now,
                     runDiscriminant: persistedConversation?.status !== 'completed' ? (persistedRun?.runDiscriminant || undefined) : undefined,
@@ -5962,6 +6070,7 @@ class AiHubServer {
                     events: [(0, hosts_1.createHubEvent)('system', `Trigger: ${configuredAgent.label} / ${jobName} from ${context?.sourceApp || 'unknown'} in ${projectPath}`)],
                     currentPhase: null,
                     phaseHistory: [],
+                    phaseVisits: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
                     personaKey: getHubPersonaForJob(jobName),
@@ -6113,6 +6222,7 @@ class AiHubServer {
             events: [(0, hosts_1.createHubEvent)('system', `Triggered by deployment: ${deployment.label} (${deployment.type}) using ${configuredAgent.label}`)],
             currentPhase: null,
             phaseHistory: [],
+            phaseVisits: [],
             totals: emptyTotals(),
             lastStatusChangeAt: startTimestamp,
             personaKey: jobMetadata?.personaKey ?? getHubPersonaForJob(jobId),

package/dist/src/ai-hub/ui-runtime.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -41,7 +8,9 @@ exports.evaluateHubUiManifestCompatibility = evaluateHubUiManifestCompatibility;
 exports.resolveHubUiRuntime = resolveHubUiRuntime;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const semver = __importStar(require("semver"));
+// #1110: semver compiles 45 files. This module is on the AI Hub server's import graph, which
+// must load before the Hub can listen, and the only use below runs when a UI release manifest
+// is evaluated - never during startup. Required on use to keep it off the cold-start path.
 const version_utils_1 = require("../cli/utils/version-utils");
 const ui_cache_1 = require("./ui-cache");
 const ui_manifest_client_1 = require("./ui-manifest-client");
@@ -72,6 +41,8 @@ function evaluateHubUiManifestCompatibility(manifest, bridge) {
     if (manifest.schemaVersion !== 1) {
         return { compatible: false, updateRequired: true, reason: `schema-version:${manifest.schemaVersion}` };
     }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const semver = require('semver');
     if (semver.valid(manifest.minBridgeVersion) && semver.valid(bridge.bridgeVersion) && semver.lt(bridge.bridgeVersion, manifest.minBridgeVersion)) {
         return { compatible: false, updateRequired: true, reason: `min-bridge-version:${manifest.minBridgeVersion}` };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-hub",
-  "version": "2.0.267",
+  "version": "2.0.269",
   "description": "FRAIM Hub local companion package.",
   "bin": {
     "fraim-hub": "bin/fraim-hub.js",
@@ -163,7 +163,7 @@
     "electron": "^41.2.2",
     "electron-updater": "^6.8.9",
     "express": "^5.2.1",
-    "fraim": "2.0.267",
+    "fraim": "2.0.269",
     "mongodb": "^7.0.0",
     "node-cron": "4.2.1",
     "node-edge-tts": "^1.2.10",

package/public/ai-hub/script.js

@@ -765,6 +765,12 @@ function ensureTaskPaneLauncher() {
     const project = taskPaneProjectEntries().find((entry) => entry.folderPath === event.target.value);
     if (statusEl && project) statusEl.textContent = `Project: ${project.name || friendlyProjectShortName(project.folderPath)}`;
   });
+  document.getElementById('task-pane-employee-select')?.addEventListener('change', (event) => {
+    const value = event.target && event.target.value;
+    if (value && hubConfiguredAgents().some((agent) => agent.id === value)) {
+      state.selectedEmployeeId = value;
+    }
+  });
   return root;
 }
 
@@ -855,6 +861,8 @@ async function taskPaneStartSelectedJob() {
     if (result && result.ok) {
       taskPaneLauncherForcedOpen = false;
       if (statusEl) statusEl.textContent = 'Started.';
+      renderActive();
+      syncTaskPaneSurfaceMode();
     } else if (statusEl) {
       statusEl.textContent = (result && result.error) || 'Could not start.';
     }
@@ -863,6 +871,7 @@ async function taskPaneStartSelectedJob() {
     console.warn('[ai-hub] task-pane start failed:', error);
   } finally {
     renderTaskPaneLauncher();
+    syncTaskPaneSurfaceMode();
   }
 }
 
@@ -1028,18 +1037,18 @@ function normalizeGeminiConversationMessages(conv) {
 // request 413s, the error is swallowed, and the client-owned fields in the SAME
 // payload (e.g. pauseReason='done' from "Mark complete") never persist. Strip them
 // here; the server's PUT handler merges them back from the stored record.
-const SERVER_OWNED_CONV_FIELDS = ['messages', 'events', 'artifacts', 'run', 'delegation', 'handoffSummary'];
-// Issue #1090: `_bodyFetched` records that THIS CLIENT successfully fetched the
-// body, which is a different claim from "the record has body fields". A run can
-// legitimately finish with no messages, events, artifacts, run, or delegation;
+const SERVER_OWNED_CONV_FIELDS = ['messages', 'events', 'artifacts', 'run', 'delegation', 'handoffSummary'];
+// Issue #1090: `_bodyFetched` records that THIS CLIENT successfully fetched the
+// body, which is a different claim from "the record has body fields". A run can
+// legitimately finish with no messages, events, artifacts, run, or delegation;
 // before this marker existed such a body was indistinguishable from one that had
 // never been hydrated, so the transcript hung on "Loading conversation…" and
 // re-fetched on every poll tick forever.
 //
-// It is listed in CLIENT_ONLY_CONV_FIELDS so `cleanConversationHeader()` strips
-// any inbound value. That is what preserves issue #913: a marker arriving over
-// the wire is never trusted, only one this client set after a real fetch.
-const CLIENT_ONLY_CONV_FIELDS = ['_bodyLoaded', '_bodyFetched', '_stopping'];
+// It is listed in CLIENT_ONLY_CONV_FIELDS so `cleanConversationHeader()` strips
+// any inbound value. That is what preserves issue #913: a marker arriving over
+// the wire is never trusted, only one this client set after a real fetch.
+const CLIENT_ONLY_CONV_FIELDS = ['_bodyLoaded', '_bodyFetched', '_stopping'];
 function slimConversationForPersist(conv) {
   if (!conv || typeof conv !== 'object') return conv;
   const slim = { ...conv };
@@ -3905,7 +3914,7 @@ function renderTracker(conv) {
   const rowCapacity = trackerRowCapacity(tracker, stages);
 
   // Cache key so we only rebuild the DOM when the stage data changes.
-  const key = stages.map((s) => `${s.phaseId}:${s.state}`).join('|') +
+  const key = stages.map((s) => `${s.phaseId}:${s.state}:${s.visitCount || 0}:${s.currentVisit || 0}:${s.latestStatus || ''}`).join('|') +
     '#' + (conv.run.currentPhase || '') +
     '#' + rowCapacity;
   if (key === renderedTrackerKey) {
@@ -3927,7 +3936,9 @@ function renderTracker(conv) {
     rowsHost.parentNode.insertBefore(activeLabelHost, els['tracker-note']);
   }
   const currentStage = stages.find((s) => s.state === 'current');
-  activeLabelHost.textContent = currentStage ? currentStage.label : '';
+  activeLabelHost.textContent = currentStage
+    ? `${currentStage.label}${currentStage.currentVisit && currentStage.currentVisit > 1 ? ` - visit ${currentStage.currentVisit}` : ''}`
+    : '';
   // The pizza tracker is always a single horizontal row. When the pane is too
   // narrow to fit every stage label, collapse to circles + the active-stage
   // label (CSS .tracker-compact) instead of wrapping onto stacked rows.
@@ -3939,12 +3950,21 @@ function renderTracker(conv) {
     const stageEl = document.createElement('div');
     stageEl.className = 'stage ' + stage.state;
     const tooltipText = buildStageTooltip(conv, stage);
-    if (tooltipText) stageEl.setAttribute('title', tooltipText);
+    if (tooltipText) {
+      stageEl.setAttribute('title', tooltipText);
+      stageEl.setAttribute('aria-label', tooltipText);
+    }
     const circle = document.createElement('span');
     circle.className = 'stage-circle';
     if (stage.state === 'done') circle.textContent = '✓';
     else if (stage.state === 'current') circle.textContent = '●';
     else circle.textContent = String(index + 1);
+    if (stage.visitCount && stage.visitCount > 1) {
+      const badge = document.createElement('span');
+      badge.className = 'stage-visit-badge';
+      badge.textContent = `x${stage.visitCount}`;
+      circle.appendChild(badge);
+    }
     const label = document.createElement('span');
     label.className = 'stage-label';
     label.textContent = stage.label;
@@ -3958,6 +3978,11 @@ function renderTracker(conv) {
 function buildStageTooltip(conv, stage) {
   const history = (conv.run && conv.run.phaseHistory) || [];
   const entry = history.find((h) => h.phaseId === stage.phaseId);
+  const details = [stage.phaseId];
+  if (stage.visitCount && stage.visitCount > 1) details.push(`visit ${stage.currentVisit || stage.visitCount} of ${stage.visitCount}`);
+  if (stage.latestStatus) details.push(stage.latestStatus);
+  if (stage.latestText) details.push(stage.latestText);
+  if (details.length > 1) return details.join(' - ');
   const findings = entry && entry.latestText;
   if (findings) return `${stage.phaseId} · ${findings}`;
   return stage.phaseId;
@@ -7687,6 +7712,7 @@ function foldRunIntoConversation(conv, run) {
     stages: run.stages || [],
     currentPhase: run.currentPhase || null,
     phaseHistory: run.phaseHistory || [],
+    phaseVisits: run.phaseVisits || [],
     totals: run.totals || null,
     runDiscriminant: run.runDiscriminant || null,
   };

package/public/ai-hub/styles.css

@@ -2380,6 +2380,26 @@ button.small { padding: 4px 10px; font-size: 12px; }
   color: #fff;
   box-shadow: 0 0 0 4px rgba(176, 132, 66, 0.15);
 }
+.tracker .stage-visit-badge {
+  position: absolute;
+  right: -13px;
+  top: -10px;
+  min-width: 18px;
+  height: 16px;
+  padding: 0 4px;
+  border-radius: 999px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: 1px solid var(--surface);
+  background: var(--text);
+  color: var(--surface);
+  font-size: 9px;
+  font-weight: 800;
+  line-height: 1;
+  z-index: 3;
+  box-sizing: border-box;
+}
 .tracker .stage-label {
   font-size: 10px;
   color: var(--muted);
@@ -2426,6 +2446,13 @@ button.small { padding: 4px 10px; font-size: 12px; }
     border-width: 1px;
     font-size: 10px;
   }
+  .tracker .stage-visit-badge {
+    right: -12px;
+    top: -9px;
+    min-width: 17px;
+    height: 15px;
+    font-size: 8px;
+  }
   .tracker .stage::before { top: 10px; }
   .tracker-active-label { display: block; }
 }
@@ -2866,27 +2893,27 @@ button.small { padding: 4px 10px; font-size: 12px; }
    body:is([data-surface="task-pane"],[data-surface="extension"]). No media queries — this is a surface
    flag, not a viewport breakpoint. */
 
-body:is([data-surface="task-pane"],[data-surface="extension"]) {
-  font-size: 13px;
-  overflow: auto;
-  background: var(--bg);
-  color: var(--text);
-}
+body:is([data-surface="task-pane"],[data-surface="extension"]) {
+  font-size: 13px;
+  overflow: auto;
+  background: var(--bg);
+  color: var(--text);
+}
 body:is([data-surface="task-pane"],[data-surface="extension"]) .hub-tabs,
 body:is([data-surface="task-pane"],[data-surface="extension"]):not(.task-pane-run-active) .hub-area,
 body:is([data-surface="task-pane"],[data-surface="extension"]) .proj-tabs {
   display: none !important;
 }
 .task-pane-launcher { display: none; }
-body:is([data-surface="task-pane"],[data-surface="extension"]):not(.task-pane-run-active) .task-pane-launcher {
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-  padding: 12px;
-  border-bottom: 1px solid var(--line, rgba(0,0,0,0.07));
-  background: var(--surface, #fff);
-  color: var(--text, #171717);
-}
+body:is([data-surface="task-pane"],[data-surface="extension"]):not(.task-pane-run-active) .task-pane-launcher {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 12px;
+  border-bottom: 1px solid var(--line, rgba(0,0,0,0.07));
+  background: var(--surface, #fff);
+  color: var(--text, #171717);
+}
 body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-active #area-projects {
   display: flex !important;
   min-height: 100vh;
@@ -2925,11 +2952,11 @@ body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-act
   font-weight: 650;
   color: var(--text, #171717);
 }
-.tp-launcher-context,
-.tp-launcher-status {
-  min-height: 16px;
-  font-size: 11px;
-  color: var(--muted);
+.tp-launcher-context,
+.tp-launcher-status {
+  min-height: 16px;
+  font-size: 11px;
+  color: var(--muted);
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
@@ -2943,27 +2970,27 @@ body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-act
   font-weight: 600;
   color: var(--muted);
 }
-.tp-launcher-field select,
-.tp-launcher-field textarea {
-  width: 100%;
-  min-width: 0;
-  border: 1px solid var(--line, rgba(0,0,0,0.12));
-  border-radius: 8px;
-  background: var(--surface, #fff);
-  color: var(--text, #171717);
-  font: inherit;
-  font-size: 12px;
-}
-.tp-launcher-field select:focus,
-.tp-launcher-field textarea:focus {
-  outline: 2px solid var(--accent, #0071e3);
-  outline-offset: 1px;
-  border-color: var(--accent, #0071e3);
-}
-.tp-launcher-field textarea::placeholder {
-  color: var(--muted);
-  opacity: 1;
-}
+.tp-launcher-field select,
+.tp-launcher-field textarea {
+  width: 100%;
+  min-width: 0;
+  border: 1px solid var(--line, rgba(0,0,0,0.12));
+  border-radius: 8px;
+  background: var(--surface, #fff);
+  color: var(--text, #171717);
+  font: inherit;
+  font-size: 12px;
+}
+.tp-launcher-field select:focus,
+.tp-launcher-field textarea:focus {
+  outline: 2px solid var(--accent, #0071e3);
+  outline-offset: 1px;
+  border-color: var(--accent, #0071e3);
+}
+.tp-launcher-field textarea::placeholder {
+  color: var(--muted);
+  opacity: 1;
+}
 .tp-launcher-field select {
   height: 34px;
   padding: 0 8px;
@@ -2974,98 +3001,98 @@ body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-act
   padding: 8px;
   line-height: 1.35;
 }
-.tp-launcher-actions {
-  display: grid;
-  grid-template-columns: minmax(0, 1fr) auto auto;
-  align-items: center;
-  gap: 8px;
-}
-body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-start-job,
-body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-current-job {
-  min-height: 34px;
-  padding: 7px 12px;
-  border-radius: 8px;
-  font-size: 12px;
-}
-body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-current-job[hidden] {
-  display: none;
-}
-.task-pane-run-nav {
-  display: none;
-}
-body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-active .task-pane-run-nav {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 10px;
-  min-width: 0;
-  padding: 10px 12px;
-  border-bottom: 1px solid var(--line, rgba(0,0,0,0.07));
-  background: var(--surface, #fff);
-  color: var(--text, #171717);
-}
-.tp-run-copy {
-  min-width: 0;
-  display: flex;
-  flex-direction: column;
-  gap: 1px;
-}
-.tp-run-eyebrow,
-.tp-run-meta {
-  font-size: 11px;
-  line-height: 1.25;
-  color: var(--muted);
-}
-.tp-run-title {
-  min-width: 0;
-  font-size: 13px;
-  line-height: 1.3;
-  font-weight: 650;
-  color: var(--text, #171717);
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.tp-run-actions {
-  flex: 0 0 auto;
-}
-body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-new-job {
-  min-height: 34px;
-  padding: 7px 12px;
-  border-radius: 8px;
-  font-size: 12px;
-  white-space: nowrap;
-}
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) {
-  background: var(--bg);
-}
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]):not(.task-pane-run-active) .task-pane-launcher,
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-active .task-pane-run-nav {
-  background: #242424;
-  border-color: rgba(255, 255, 255, 0.16);
-}
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field select,
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field textarea {
-  background: #171717;
-  color: #f2f2f2;
-  border-color: rgba(255, 255, 255, 0.22);
-}
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field select option {
-  background: #171717;
-  color: #f2f2f2;
-}
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-context,
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-status,
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field,
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-run-eyebrow,
-:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-run-meta {
-  color: #c7c7c7;
-}
-body:is([data-surface="task-pane"],[data-surface="extension"]) .page {
-  padding: 10px 12px 8px;
-  gap: 10px;
-  height: auto;
-  min-height: 100vh;
+.tp-launcher-actions {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto auto;
+  align-items: center;
+  gap: 8px;
+}
+body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-start-job,
+body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-current-job {
+  min-height: 34px;
+  padding: 7px 12px;
+  border-radius: 8px;
+  font-size: 12px;
+}
+body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-current-job[hidden] {
+  display: none;
+}
+.task-pane-run-nav {
+  display: none;
+}
+body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-active .task-pane-run-nav {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  min-width: 0;
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--line, rgba(0,0,0,0.07));
+  background: var(--surface, #fff);
+  color: var(--text, #171717);
+}
+.tp-run-copy {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.tp-run-eyebrow,
+.tp-run-meta {
+  font-size: 11px;
+  line-height: 1.25;
+  color: var(--muted);
+}
+.tp-run-title {
+  min-width: 0;
+  font-size: 13px;
+  line-height: 1.3;
+  font-weight: 650;
+  color: var(--text, #171717);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.tp-run-actions {
+  flex: 0 0 auto;
+}
+body:is([data-surface="task-pane"],[data-surface="extension"]) #task-pane-new-job {
+  min-height: 34px;
+  padding: 7px 12px;
+  border-radius: 8px;
+  font-size: 12px;
+  white-space: nowrap;
+}
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) {
+  background: var(--bg);
+}
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]):not(.task-pane-run-active) .task-pane-launcher,
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]).task-pane-run-active .task-pane-run-nav {
+  background: #242424;
+  border-color: rgba(255, 255, 255, 0.16);
+}
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field select,
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field textarea {
+  background: #171717;
+  color: #f2f2f2;
+  border-color: rgba(255, 255, 255, 0.22);
+}
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field select option {
+  background: #171717;
+  color: #f2f2f2;
+}
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-context,
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-status,
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-launcher-field,
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-run-eyebrow,
+:root[data-theme="dark"] body:is([data-surface="task-pane"],[data-surface="extension"]) .tp-run-meta {
+  color: #c7c7c7;
+}
+body:is([data-surface="task-pane"],[data-surface="extension"]) .page {
+  padding: 10px 12px 8px;
+  gap: 10px;
+  height: auto;
+  min-height: 100vh;
 }
 /* Hide the full-width welcome header — task pane has no room for it */
 body:is([data-surface="task-pane"],[data-surface="extension"]) .header { display: none; }
@@ -3451,8 +3478,8 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
 .pending-banner { background: var(--warn-soft); border: 1px solid rgba(176,132,66,.25); border-radius: 12px; padding: 12px 16px; display: flex; align-items: flex-start; gap: 10px; margin-bottom: 12px; }
 
 /* Projects sub-tabs — HTML uses .proj-tabs (not .proj-tabs-bar) and .ptab-add (not .ptab-add-btn) */
-.proj-tabs, .proj-tabs-bar { display: flex; align-items: center; background: var(--surface); border-bottom: 1px solid var(--line); padding: 0 8px 0 0; flex-shrink: 0; overflow: hidden; }
-#proj-tab-list { display: flex; align-items: center; min-width: 0; flex: 1 1 auto; overflow-x: auto; overflow-y: hidden; white-space: nowrap; }
+.proj-tabs, .proj-tabs-bar { display: flex; align-items: center; background: var(--surface); border-bottom: 1px solid var(--line); padding: 0 8px 0 0; flex-shrink: 0; overflow: hidden; }
+#proj-tab-list { display: flex; align-items: center; min-width: 0; flex: 1 1 auto; overflow-x: auto; overflow-y: hidden; white-space: nowrap; }
 .ptab { padding: 9px 16px; font-size: 13px; font-weight: 500; color: var(--muted); border: none; background: none; cursor: pointer; border-bottom: 2px solid transparent; white-space: nowrap; flex-shrink: 0; margin-bottom: -1px; }
 .ptab.on { color: var(--text); border-bottom-color: var(--text); font-weight: 600; }
 .ptab:hover { color: var(--text); }
@@ -4206,18 +4233,18 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
 .modal-hdr { padding: 18px 22px; border-bottom: 1px solid var(--line); }
 .modal-hdr h2 { font-size: 18px; font-weight: 700; margin: 0 0 4px; }
 .modal-hdr p { font-size: 13px; color: var(--muted); margin: 0; line-height: 1.5; }
-.modal-body { padding: 18px 22px; display: flex; flex-direction: column; gap: 14px; }
-.modal-close { float: right; background: var(--bg); border: none; width: 28px; height: 28px; border-radius: 50%; font-size: 16px; cursor: pointer; color: var(--muted); line-height: 1; }
-.modal-close:hover { color: var(--text); }
-.modal-close:focus, .modal-close:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
-.aom-cancel-btn { background: var(--surface); border: 1px solid color-mix(in srgb, var(--accent-strong) 52%, var(--line)); border-radius: 20px; padding: 9px 20px; font-size: 14px; cursor: pointer; color: var(--accent-strong); }
-.aom-cancel-btn:hover { border-color: var(--accent-strong); color: var(--accent-strong); }
-.aom-cancel-btn:focus, .aom-cancel-btn:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
-.modal-footer { padding: 12px 22px 20px; display: flex; align-items: center; justify-content: space-between; }
-.modal-next { padding: 9px 22px; background: var(--accent-strong); color: var(--bg); border: none; border-radius: 20px; font-size: 14px; font-weight: 600; cursor: pointer; }
-.modal-next:hover { opacity: .9; }
-.modal-next:focus, .modal-next:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
-.modal-back { font-size: 13px; color: var(--muted); background: none; border: none; cursor: pointer; }
+.modal-body { padding: 18px 22px; display: flex; flex-direction: column; gap: 14px; }
+.modal-close { float: right; background: var(--bg); border: none; width: 28px; height: 28px; border-radius: 50%; font-size: 16px; cursor: pointer; color: var(--muted); line-height: 1; }
+.modal-close:hover { color: var(--text); }
+.modal-close:focus, .modal-close:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.aom-cancel-btn { background: var(--surface); border: 1px solid color-mix(in srgb, var(--accent-strong) 52%, var(--line)); border-radius: 20px; padding: 9px 20px; font-size: 14px; cursor: pointer; color: var(--accent-strong); }
+.aom-cancel-btn:hover { border-color: var(--accent-strong); color: var(--accent-strong); }
+.aom-cancel-btn:focus, .aom-cancel-btn:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.modal-footer { padding: 12px 22px 20px; display: flex; align-items: center; justify-content: space-between; }
+.modal-next { padding: 9px 22px; background: var(--accent-strong); color: var(--bg); border: none; border-radius: 20px; font-size: 14px; font-weight: 600; cursor: pointer; }
+.modal-next:hover { opacity: .9; }
+.modal-next:focus, .modal-next:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.modal-back { font-size: 13px; color: var(--muted); background: none; border: none; cursor: pointer; }
 .modal-step-dots { display: flex; gap: 6px; justify-content: center; margin-bottom: 18px; }
 .modal-dot { width: 6px; height: 6px; border-radius: 50%; background: var(--line); }
 .modal-dot.on { background: var(--text); }
@@ -4674,8 +4701,8 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
   align-items: center;
   justify-content: center;
 }
-.np-close:hover { color: var(--text); }
-.np-close:focus, .np-close:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.np-close:hover { color: var(--text); }
+.np-close:focus, .np-close:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
 
 .np-step-dots {
   display: flex;
@@ -4737,29 +4764,29 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
   justify-content: space-between;
 }
 
-.np-next {
-  padding: 9px 22px;
-  background: var(--accent-strong);
-  color: var(--bg);
-  border: none;
-  border-radius: 20px;
-  font-size: 14px;
-  font-weight: 600;
-  cursor: pointer;
-}
-.np-next:hover { opacity: .88; }
-.np-next:focus, .np-next:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
-.np-next:disabled { opacity: .55; cursor: not-allowed; }
-
-.np-back {
-  font-size: 13px;
-  color: var(--accent-strong);
-  background: none;
-  border: none;
-  cursor: pointer;
-}
-.np-back:hover { color: var(--accent-strong); text-decoration: underline; }
-.np-back:focus, .np-back:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.np-next {
+  padding: 9px 22px;
+  background: var(--accent-strong);
+  color: var(--bg);
+  border: none;
+  border-radius: 20px;
+  font-size: 14px;
+  font-weight: 600;
+  cursor: pointer;
+}
+.np-next:hover { opacity: .88; }
+.np-next:focus, .np-next:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.np-next:disabled { opacity: .55; cursor: not-allowed; }
+
+.np-back {
+  font-size: 13px;
+  color: var(--accent-strong);
+  background: none;
+  border: none;
+  cursor: pointer;
+}
+.np-back:hover { color: var(--accent-strong); text-decoration: underline; }
+.np-back:focus, .np-back:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
 
 /* ── Discard-guard confirm (shown when a dirty wizard is dismissed) ── */
 .np-discard {
@@ -4784,11 +4811,11 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
 .np-discard-msg { font-size: 13px; color: var(--muted); margin: 0 0 18px; line-height: 1.5; }
 .np-discard-row { display: flex; gap: 8px; justify-content: flex-end; }
 .np-discard-row button { font: inherit; font-size: 13px; font-weight: 600; border-radius: 9px; padding: 8px 16px; cursor: pointer; }
-.np-discard-keep { background: var(--surface); border: 1px solid var(--line); color: var(--text); }
-.np-discard-keep:hover { border-color: var(--muted); }
-.np-discard-yes { background: var(--danger, #d2261f); color: #fff; border: none; }
-.np-discard-yes:hover { opacity: .9; }
-.np-discard-row button:focus, .np-discard-row button:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
+.np-discard-keep { background: var(--surface); border: 1px solid var(--line); color: var(--text); }
+.np-discard-keep:hover { border-color: var(--muted); }
+.np-discard-yes { background: var(--danger, #d2261f); color: #fff; border: none; }
+.np-discard-yes:hover { opacity: .9; }
+.np-discard-row button:focus, .np-discard-row button:focus-visible { outline: 2px solid var(--accent-strong); outline-offset: 2px; }
 
 /* ── D11: Source attachment row (step 2) ── */
 .np-source {
@@ -5275,9 +5302,9 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
 /* ── New-project: folder picker row ── */
 .np-folder-row { display:flex; gap:8px; }
 .np-folder-row input { flex:1; }
-.np-browse-btn { padding:9px 16px; background:var(--accent-strong); color:var(--bg); border:none; border-radius:9px; font-size:13px; font-weight:600; cursor:pointer; white-space:nowrap; flex-shrink:0; }
-.np-browse-btn:hover { opacity:.85; }
-.np-browse-btn:focus, .np-browse-btn:focus-visible { outline:2px solid var(--accent-strong); outline-offset:2px; }
+.np-browse-btn { padding:9px 16px; background:var(--accent-strong); color:var(--bg); border:none; border-radius:9px; font-size:13px; font-weight:600; cursor:pointer; white-space:nowrap; flex-shrink:0; }
+.np-browse-btn:hover { opacity:.85; }
+.np-browse-btn:focus, .np-browse-btn:focus-visible { outline:2px solid var(--accent-strong); outline-offset:2px; }
 .np-field-hint { font-size:11px; color:var(--muted); margin-top:5px; line-height:1.5; }
 
 @media (max-width: 520px) {