fraim-hub 2.0.217 → 2.0.218

package/dist/src/ai-hub/configured-agents.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiHubConfiguredAgentStore = void 0;
 exports.synthesizeDefaultConfiguredAgents = synthesizeDefaultConfiguredAgents;
 exports.checkConfiguredAgentAvailability = checkConfiguredAgentAvailability;
+exports.checkConfiguredAgentReadiness = checkConfiguredAgentReadiness;
 exports.projectConfiguredAgent = projectConfiguredAgent;
 exports.resolveConfiguredAgentForHost = resolveConfiguredAgentForHost;
 exports.resolveConfiguredAgentEnv = resolveConfiguredAgentEnv;
@@ -78,7 +79,9 @@ function normalizeSetupScript(value) {
 }
 function synthesizeDefaultConfiguredAgents(employees) {
     const timestamp = '1970-01-01T00:00:00.000Z';
-    return employees.map((employee) => ({
+    return employees
+        .filter((employee) => employee.available)
+        .map((employee) => ({
         id: `${employee.id}-default`,
         label: employee.label,
         description: 'Default local launch for this agent tool.',
@@ -161,6 +164,25 @@ function checkConfiguredAgentAvailability(agent, employees, env = process.env) {
     }
     return { id: agent.id, label: agent.label, baseHostId: agent.baseHostId, enabled: agent.enabled, available: reasons.length === 0, reasons, warnings };
 }
+function checkConfiguredAgentReadiness(agent, employees, env = process.env) {
+    const check = checkConfiguredAgentAvailability(agent, employees, env);
+    if (!check.available || !agent.setupScript)
+        return check;
+    try {
+        resolveConfiguredAgentEnv(agent);
+        return check;
+    }
+    catch (error) {
+        return {
+            ...check,
+            available: false,
+            reasons: [
+                ...check.reasons,
+                error instanceof Error ? error.message : 'Configured agent setup script failed.',
+            ],
+        };
+    }
+}
 function projectConfiguredAgent(agent, employees) {
     const check = checkConfiguredAgentAvailability(agent, employees);
     return {
@@ -244,7 +266,7 @@ function runSetupScript(setupScript) {
         env: captureEnv,
     });
     if (result.error || result.status !== 0) {
-        const detail = result.error?.message || result.stderr?.trim() || `exit ${result.status}`;
+        const detail = result.error?.message || `exit ${result.status}`;
         throw new Error(`Configured agent setup script failed: ${detail}`);
     }
     return filterSafeEnv(parseEnvLines(result.stdout || ''));

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

@@ -143,10 +143,13 @@ function getProtectedPersonaForHubJob(jobName) {
     return loadPersonaCapabilityModule()?.getProtectedPersonaForJob(jobName) ?? null;
 }
 const GENERIC_WORKER_PERSONA_KEY = 'fraimworker';
+// Unprotected jobs default to mandy so unassigned work surfaces
+// under MANdy's employee row rather than the generic FRAIMworker placeholder.
+const DEFAULT_UNASSIGNED_PERSONA_KEY = 'mandy';
 function getHubPersonaForJob(jobName) {
     if (!jobName || jobName === '__freeform__')
         return null;
-    return getProtectedPersonaForHubJob(jobName) ?? GENERIC_WORKER_PERSONA_KEY;
+    return getProtectedPersonaForHubJob(jobName) ?? DEFAULT_UNASSIGNED_PERSONA_KEY;
 }
 const FRAIM_INTERNAL_JOB_IDS = new Set([
     'contribute-to-fraim',
@@ -3053,7 +3056,7 @@ class AiHubServer {
             const agent = this.configuredAgentsForCurrentMachine(employees).find((entry) => entry.id === req.params.id);
             if (!agent)
                 return res.status(404).json({ error: 'Configured agent not found.' });
-            return res.json((0, configured_agents_1.checkConfiguredAgentAvailability)(agent, employees));
+            return res.json((0, configured_agents_1.checkConfiguredAgentReadiness)(agent, employees));
         });
         this.app.post('/api/ai-hub/runs', (req, res) => {
             try {

package/dist/src/cli/commands/add-ide.js

@@ -44,7 +44,6 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const ide_detector_1 = require("../setup/ide-detector");
 const mcp_config_generator_1 = require("../setup/mcp-config-generator");
-const codex_local_config_1 = require("../setup/codex-local-config");
 const claude_code_telemetry_1 = require("../setup/claude-code-telemetry");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 const mcp_server_registry_1 = require("../mcp/mcp-server-registry");
@@ -254,12 +253,6 @@ const configureIDEMCP = async (ide, fraimKey, tokens, providerConfigs) => {
         });
     }
     console.log(chalk_1.default.green(`✅ Updated ${configPath}`));
-    // Handle IDE-specific local config (e.g., Codex needs project-level config)
-    if (ide.configType === 'codex') {
-        const localResult = (0, codex_local_config_1.ensureCodexLocalConfig)(process.cwd());
-        const status = localResult.created ? 'Created' : localResult.updated ? 'Updated' : 'Verified';
-        console.log(chalk_1.default.green(`  ✅ ${status} local ${ide.name} config: ${localResult.path}`));
-    }
     // Enable token telemetry for Claude Code via project-level settings
     if (ide.configType === 'claude-code') {
         (0, claude_code_telemetry_1.ensureClaudeCodeTelemetryEnv)();

package/dist/src/cli/setup/codex-local-config.js

@@ -4,34 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureCodexLocalConfig = void 0;
-const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const mcp_config_generator_1 = require("./mcp-config-generator");
-const escapeTomlString = (value) => value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-const buildFraimCwdBlock = (projectRoot) => `
-[mcp_servers.fraim]
-cwd = "${escapeTomlString(projectRoot)}"
-`;
 const ensureCodexLocalConfig = (projectRoot) => {
-    const codexDir = path_1.default.join(projectRoot, '.codex');
-    const codexConfigPath = path_1.default.join(codexDir, 'config.toml');
-    if (!fs_1.default.existsSync(codexDir)) {
-        fs_1.default.mkdirSync(codexDir, { recursive: true });
-    }
-    const hadExistingFile = fs_1.default.existsSync(codexConfigPath);
-    const existingContent = hadExistingFile ? fs_1.default.readFileSync(codexConfigPath, 'utf8') : '';
-    const generatedContent = buildFraimCwdBlock(projectRoot);
-    const mergeResult = (0, mcp_config_generator_1.mergeTomlMCPServers)(existingContent, generatedContent, ['fraim']);
-    const normalizedExisting = existingContent.replace(/\r\n/g, '\n');
-    const normalizedMerged = mergeResult.content.replace(/\r\n/g, '\n');
-    const shouldWrite = !hadExistingFile || normalizedExisting !== normalizedMerged;
-    if (shouldWrite) {
-        fs_1.default.writeFileSync(codexConfigPath, mergeResult.content);
-    }
-    return {
-        path: codexConfigPath,
-        created: !hadExistingFile,
-        updated: shouldWrite && hadExistingFile
-    };
+    const codexConfigPath = path_1.default.join(projectRoot, '.codex', 'config.toml');
+    // Codex resolves the active workspace from its process cwd. FRAIM's Codex
+    // MCP server belongs in machine-level config; project-local partial TOML can
+    // shadow a valid profile and break configured Hub launches.
+    return { path: codexConfigPath, created: false, updated: false };
 };
 exports.ensureCodexLocalConfig = ensureCodexLocalConfig;

package/dist/src/config/persona-capability-bundles.js

@@ -8,10 +8,16 @@ exports.listPersonaCapabilityBundles = listPersonaCapabilityBundles;
 const persona_hiring_1 = require("./persona-hiring");
 const persona_catalog_routes_1 = require("../routes/persona-catalog-routes");
 exports.FREE_JOBS = new Set([
-    'create-architecture', 'project-scaffolding',
-    'blue-sky-brainstorming', 'codebase-analysis-and-ideation',
-    'domain-registration-research', 'google-workspace-setup', 'github-org-setup',
-    'contribute-to-fraim', 'file-fraim-issue', 'praise-fraim',
+    'create-architecture',
+    'project-scaffolding',
+    'blue-sky-brainstorming',
+    'codebase-analysis-and-ideation',
+    'domain-registration-research',
+    'google-workspace-setup',
+    'github-org-setup',
+    'contribute-to-fraim',
+    'file-fraim-issue',
+    'praise-fraim',
 ]);
 function isFreeJob(jobName) {
     return exports.FREE_JOBS.has(jobName);
@@ -39,8 +45,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     beza: {
         personaKey: 'beza',
         bundleId: 'persona-beza-core',
-        catalogMetadata: buildCatalogMetadata('beza', ['competitive-analysis', 'review-business-strategy', 'business-plan-creation']),
-        protectedJobs: ['competitive-analysis', 'review-business-strategy', 'business-plan-creation', 'problem-statement-crystallization', 'business-idea-validation-and-scoping', 'founder-market-fit-analysis', 'community-funding-preparation', 'fundraising-prospect-discovery', 'investor-pitch-preparation', 'review-funding-preparation', 'advisory-board-development', 'advisor-interview', 'advisory-board-selection', 'blue-sky-brainstorming', 'domain-registration-research'],
+        catalogMetadata: buildCatalogMetadata('beza', ['competitive-analysis', 'review-business-strategy', 'pricing-strategy-definition']),
+        protectedJobs: ['competitive-analysis', 'review-business-strategy', 'business-plan-creation', 'problem-statement-crystallization', 'business-idea-validation-and-scoping', 'founder-market-fit-analysis', 'advisory-board-development', 'advisor-interview', 'advisory-board-selection', 'pricing-strategy-definition'],
         protectedAliases: ['business-strategy', 'company-strategy'],
         defaultHireMode: 'job',
         lockCopy: 'Hire BeZa to unlock business strategy work for this request.'
@@ -48,8 +54,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     pam: {
         personaKey: 'pam',
         bundleId: 'persona-pam-core',
-        catalogMetadata: buildCatalogMetadata('pam', ['feature-specification', 'technical-design', 'issue-preparation']),
-        protectedJobs: ['feature-specification', 'technical-design', 'issue-preparation', 'implementation-design-review', 'issue-retrospective', 'work-completion', 'scrum-sprint-planning', 'mvp-validation-plan', 'sprint-planning', 'customer-prospect-discovery', 'interview-preparation', 'participant-recruitment', 'process-interview-notes', 'review-customer-development', 'triage-customer-needs'],
+        catalogMetadata: buildCatalogMetadata('pam', ['feature-specification', 'technical-design', 'project-plan-creation']),
+        protectedJobs: ['feature-specification', 'technical-design', 'experiment-tracking', 'project-plan-creation', 'implementation-feature-review', 'scrum-sprint-planning', 'mvp-validation-plan', 'sprint-planning', 'customer-prospect-discovery', 'interview-preparation', 'participant-recruitment', 'process-interview-notes', 'review-customer-development', 'triage-customer-needs'],
         protectedAliases: ['product-management', 'product-spec'],
         defaultHireMode: 'job',
         lockCopy: 'Hire PaM to unlock product-management work for this request.'
@@ -57,8 +63,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     swen: {
         personaKey: 'swen',
         bundleId: 'persona-swen-core',
-        catalogMetadata: buildCatalogMetadata('swen', ['feature-implementation', 'code-refactoring', 'pr-iteration']),
-        protectedJobs: ['feature-implementation', 'code-refactoring', 'pr-iteration', 'mobile-app-development', 'mcp-server-creation', 'cloud-application-deployment', 'cloud-cost-optimization', 'cloud-performance-diagnosis', 'route-llm-spend-to-cloud-credits', 'set-up-cloud-cost-alerts', 'gitlabs-to-github', 'system-migration', 'cross-cloud-migration', 'data-pipeline-design', 'data-quality-monitoring', 'data-platform-architecture', 'write-dev-docs', 'database-schema-design', 'create-architecture', 'project-scaffolding', 'codebase-analysis-and-ideation', 'github-org-setup', 'google-workspace-setup', 'mobile-app-rejection-response', 'mobile-app-submission', 'publish-mcp-app', 'application-replication-workflow'],
+        catalogMetadata: buildCatalogMetadata('swen', ['feature-implementation', 'technical-design', 'code-refactoring']),
+        protectedJobs: ['feature-implementation', 'implementation-design-review', 'code-refactoring', 'pr-iteration', 'mobile-app-development', 'mcp-server-creation', 'cloud-application-deployment', 'cloud-cost-optimization', 'cloud-performance-diagnosis', 'route-llm-spend-to-cloud-credits', 'set-up-cloud-cost-alerts', 'gitlabs-to-github', 'system-migration', 'cross-cloud-migration', 'data-pipeline-design', 'data-quality-monitoring', 'data-platform-architecture', 'write-dev-docs', 'database-schema-design', 'create-architecture', 'project-scaffolding', 'codebase-analysis-and-ideation', 'github-org-setup', 'google-workspace-setup', 'mobile-app-rejection-response', 'mobile-app-submission', 'publish-mcp-app', 'application-replication-workflow'],
         protectedAliases: ['software-engineering', 'implementation'],
         defaultHireMode: 'job',
         lockCopy: 'Hire SWEn to unlock software-engineering delivery for this request.'
@@ -67,7 +73,7 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
         personaKey: 'qasm',
         bundleId: 'persona-qasm-core',
         catalogMetadata: buildCatalogMetadata('qasm', ['test-execution', 'browser-application-validation', 'ui-polish-validation']),
-        protectedJobs: ['test-execution', 'browser-application-validation', 'ui-polish-validation', 'code-quality-assessment', 'test-quality-assessment', 'user-testing-and-bug-bash', 'broken-windows-detection-and-remediation', 'iterative-quality-improvement', 'implementation-feature-review', 'accessibility-audit', 'api-testing', 'performance-benchmarking'],
+        protectedJobs: ['test-execution', 'browser-application-validation', 'ui-polish-validation', 'code-quality-assessment', 'test-quality-assessment', 'user-testing-and-bug-bash', 'broken-windows-detection-and-remediation', 'iterative-quality-improvement', 'accessibility-audit', 'api-testing', 'performance-benchmarking'],
         protectedAliases: ['qa', 'quality-assurance'],
         defaultHireMode: 'job',
         lockCopy: 'Hire QAsm to unlock QA validation for this request.'
@@ -84,8 +90,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     gautam: {
         personaKey: 'gautam',
         bundleId: 'persona-gautam-core',
-        catalogMetadata: buildCatalogMetadata('gautam', ['analyze-revenue-system', 'build-gtm-motion', 'ppc-campaign-management']),
-        protectedJobs: ['pricing-strategy-definition', 'marketing-strategy-definition', 'product-launch-management', 'evangelist-content-development', 'funnel-analysis', 'growth-loop-design', 'analyze-revenue-system', 'design-gtm-system', 'build-gtm-motion', 'build-gtm-stack', 'plan-gtm-team', 'marketing-content-creation', 'ppc-campaign-management', 'paid-social-strategy', 'ad-performance-analysis', 'tracking-and-attribution-setup', 'developer-advocacy', 'seo-strategy', 'marketing-analytics-review', 'linkedin-company-page-setup', 'x-account-setup', 'social-engagement-campaign', 'thought-leadership-engagement', 'promo-video-creation', 'linkedin-carousel-from-deck'],
+        catalogMetadata: buildCatalogMetadata('gautam', ['analyze-revenue-system', 'build-gtm-motion', 'domain-registration-research']),
+        protectedJobs: ['marketing-strategy-definition', 'product-launch-management', 'evangelist-content-development', 'funnel-analysis', 'growth-loop-design', 'analyze-revenue-system', 'design-gtm-system', 'build-gtm-motion', 'build-gtm-stack', 'plan-gtm-team', 'marketing-content-creation', 'ppc-campaign-management', 'paid-social-strategy', 'ad-performance-analysis', 'tracking-and-attribution-setup', 'developer-advocacy', 'seo-strategy', 'marketing-analytics-review', 'linkedin-company-page-setup', 'x-account-setup', 'domain-registration-research', 'social-engagement-campaign', 'thought-leadership-engagement', 'promo-video-creation', 'linkedin-carousel-from-deck', 'notebooklm-infographic', 'notebooklm-podcast', 'notebooklm-presentation', 'notebooklm-report', 'notebooklm-video-overview'],
         protectedAliases: ['gtm', 'marketing'],
         defaultHireMode: 'job',
         lockCopy: 'Hire GauTaM to unlock go-to-market and paid media work for this request.'
@@ -111,8 +117,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     ashley: {
         personaKey: 'ashley',
         bundleId: 'persona-ashley-core',
-        catalogMetadata: buildCatalogMetadata('ashley', ['chief-of-staff-briefing', 'executive-assistant', 'weekly-operating-review']),
-        protectedJobs: ['chief-of-staff-briefing', 'calendar-triage', 'meeting-preparation', 'executive-assistant', 'weekly-operating-review', 'send-thank-you-notes', 'send-newsletter', 'analyze-transcript', 'send-stakeholder-update'],
+        catalogMetadata: buildCatalogMetadata('ashley', ['chief-of-staff-briefing', 'executive-assistant', 'analyze-transcript']),
+        protectedJobs: ['chief-of-staff-briefing', 'calendar-triage', 'meeting-preparation', 'executive-assistant', 'send-newsletter', 'send-thank-you-notes', 'analyze-transcript'],
         protectedAliases: ['executive-assistant', 'operations-assistant'],
         defaultHireMode: 'job',
         lockCopy: 'Hire AshLey to unlock executive-assistant work for this request.'
@@ -120,8 +126,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     mandy: {
         personaKey: 'mandy',
         bundleId: 'persona-mandy-core',
-        catalogMetadata: buildCatalogMetadata('mandy', ['fully-delegate', 'project-plan-creation', 'stakeholder-status-reporting']),
-        protectedJobs: ['fully-delegate', 'delivery-governance-review', 'project-plan-creation', 'stakeholder-status-reporting', 'experiment-tracking', 'cross-functional-dependency-management', 'portfolio-impact-report'],
+        catalogMetadata: buildCatalogMetadata('mandy', ['fully-delegate', 'stakeholder-status-reporting', 'weekly-operating-review']),
+        protectedJobs: ['fully-delegate', 'delivery-governance-review', 'issue-preparation', 'issue-retrospective', 'work-completion', 'stakeholder-status-reporting', 'send-stakeholder-update', 'weekly-operating-review', 'cross-functional-dependency-management', 'portfolio-impact-report'],
         protectedAliases: ['manager', 'team-lead', 'orchestrator'],
         defaultHireMode: 'job',
         lockCopy: 'Hire MANdy to unlock autonomous multi-role orchestration — MANdy plans the job sequence, runs sub-agents in parallel, coaches them through verification loops, and hands back a synthesized DRAFT for your approval.'
@@ -174,8 +180,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     casey: {
         personaKey: 'casey',
         bundleId: 'persona-casey-core',
-        catalogMetadata: buildCatalogMetadata('casey', ['support-case-resolution', 'support-sop-operationalization', 'support-system-operationalization', 'support-playbook-evaluation']),
-        protectedJobs: ['crm-account-health-review', 'crm-case-resolution', 'customer-health-review', 'loyalty-program-management', 'survey-campaign-management', 'support-queue-management', 'support-case-resolution', 'support-sop-operationalization', 'support-system-operationalization', 'support-playbook-evaluation', 'user-survey-management'],
+        catalogMetadata: buildCatalogMetadata('casey', ['update-crm', 'support-case-resolution', 'support-system-operationalization']),
+        protectedJobs: ['crm-account-health-review', 'crm-case-resolution', 'customer-health-review', 'loyalty-program-management', 'survey-campaign-management', 'update-crm', 'support-queue-management', 'support-case-resolution', 'support-sop-operationalization', 'support-system-operationalization', 'support-playbook-evaluation', 'user-survey-management'],
         protectedAliases: ['customer-success', 'customer-support', 'csm', 'support'],
         defaultHireMode: 'job',
         lockCopy: 'Hire CaSey to unlock customer success and support work for this request.'
@@ -204,8 +210,8 @@ exports.PERSONA_CAPABILITY_BUNDLES = {
     mona: {
         personaKey: 'mona',
         bundleId: 'persona-mona-core',
-        catalogMetadata: buildCatalogMetadata('mona', ['financial-analysis', 'fpa-and-forecasting', 'monthly-close-review']),
-        protectedJobs: ['financial-analysis', 'fpa-and-forecasting', 'monthly-close-review', 'tax-strategy-planning', 'aws-activate-credits-application', 'google-cloud-credits-application', 'microsoft-azure-credits-application', 'invoice-generation', 'business-banking-setup'],
+        catalogMetadata: buildCatalogMetadata('mona', ['financial-analysis', 'fundraising-prospect-discovery', 'investor-pitch-preparation']),
+        protectedJobs: ['financial-analysis', 'fpa-and-forecasting', 'monthly-close-review', 'tax-strategy-planning', 'aws-activate-credits-application', 'community-funding-preparation', 'fundraising-prospect-discovery', 'google-cloud-credits-application', 'investor-pitch-preparation', 'microsoft-azure-credits-application', 'review-funding-preparation', 'invoice-generation', 'business-banking-setup'],
         protectedAliases: ['finance', 'financial-modeling', 'fpa', 'bookkeeping'],
         defaultHireMode: 'job',
         lockCopy: 'Hire MONa to unlock financial modeling, FP&A, and tax strategy work for this request.'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-hub",
-  "version": "2.0.217",
+  "version": "2.0.218",
   "description": "FRAIM Hub local companion package.",
   "main": "index.js",
   "bin": {
@@ -90,7 +90,7 @@
     "dotenv": "^16.4.7",
     "electron": "^41.2.2",
     "express": "^5.2.1",
-    "fraim": "2.0.217",
+    "fraim": "2.0.218",
     "mongodb": "^7.0.0",
     "node-cron": "4.2.1",
     "node-edge-tts": "^1.2.10",

package/public/ai-hub/script.js

@@ -82,6 +82,7 @@ const state = {
   cpHighlightIndex: -1,   // index into cpRows flat list
   cpRows: [],             // [{type:'recent'|'job', job, instructions?}]
   lastRun: null,          // {job, instructions, employeeId} for Cmd+Shift+R
+  configuredAgentCheckResults: {},
   // Issue #540 R10: pending run params captured when hire strip is shown.
   _hireStripPending: null,
 };
@@ -1803,9 +1804,13 @@ function getConversationPersona(conv) {
   return personaMap().get(conv.personaKey) || null;
 }
 
+// Unprotected jobs default to mandy so unassigned work surfaces
+// under MANdy's employee row rather than the generic FRAIMworker placeholder.
+const DEFAULT_UNASSIGNED_PERSONA_KEY = 'mandy';
+
 function assignedPersonaKeyForJob(job) {
   if (!job || job.id === '__freeform__') return null;
-  return job.requiredPersonaKey != null ? job.requiredPersonaKey : GENERIC_WORKER_PERSONA_KEY;
+  return job.requiredPersonaKey != null ? job.requiredPersonaKey : DEFAULT_UNASSIGNED_PERSONA_KEY;
 }
 
 function getEmployeeStatus(employeeId) {
@@ -6577,6 +6582,10 @@ function renderConfiguredAgentsPanel() {
     return;
   }
   for (const agent of agents) {
+    const latestCheck = state.configuredAgentCheckResults[agent.id] || null;
+    const renderedAvailable = latestCheck ? latestCheck.available !== false : agent.available !== false;
+    const renderedEnabled = agent.enabled !== false;
+    const renderedReasons = latestCheck?.reasons || agent.reasons || [];
     const card = document.createElement('div');
     card.className = 'configured-agent-card';
     card.dataset.testid = 'configured-agent-card';
@@ -6585,8 +6594,8 @@ function renderConfiguredAgentsPanel() {
     const title = document.createElement('strong');
     title.textContent = agent.label;
     const status = document.createElement('span');
-    status.className = 'configured-agent-status ' + (agent.available !== false && agent.enabled !== false ? 'ok' : 'warn');
-    status.textContent = agent.available !== false && agent.enabled !== false ? 'Ready' : 'Check setup';
+    status.className = 'configured-agent-status ' + (renderedAvailable && renderedEnabled ? 'ok' : 'warn');
+    status.textContent = renderedAvailable && renderedEnabled ? 'Ready' : 'Check setup';
     head.appendChild(title);
     head.appendChild(status);
 
@@ -6599,8 +6608,9 @@ function renderConfiguredAgentsPanel() {
     check.addEventListener('click', async () => {
       try {
         const result = await requestJson(`/api/ai-hub/configured-agents/${encodeURIComponent(agent.id)}/check`, { method: 'POST' });
+        state.configuredAgentCheckResults[agent.id] = result;
         showStatus(result.available ? `${agent.label} is ready.` : `${agent.label}: ${(result.reasons || []).join(' ') || 'Check setup.'}`, !result.available);
-        await refreshConfiguredAgents();
+        renderConfiguredAgentsPanel();
       } catch (err) {
         showStatus(err.message || 'Agent check failed.', true);
       }
@@ -6622,6 +6632,7 @@ function renderConfiguredAgentsPanel() {
       del.addEventListener('click', async () => {
         try {
           await requestJson(`/api/ai-hub/configured-agents/${encodeURIComponent(agent.id)}`, { method: 'DELETE' });
+          delete state.configuredAgentCheckResults[agent.id];
           if (state.configuredAgentEditingId === agent.id) state.configuredAgentEditingId = null;
           await refreshConfiguredAgents();
         } catch (err) {
@@ -6641,7 +6652,9 @@ function renderConfiguredAgentsPanel() {
 
     const detail = document.createElement('div');
     detail.className = 'configured-agent-detail';
-    detail.textContent = agent.description || ((agent.reasons || []).join(' ') || 'Uses local Hub launch settings.');
+    detail.textContent = (latestCheck && renderedReasons.length)
+      ? renderedReasons.join(' ')
+      : (agent.description || (renderedReasons.join(' ') || 'Uses local Hub launch settings.'));
 
     card.appendChild(head);
     card.appendChild(meta);
@@ -6766,6 +6779,7 @@ function buildConfiguredAgentForm(agent) {
         body: JSON.stringify(body),
       });
       state.configuredAgentEditingId = null;
+      delete state.configuredAgentCheckResults[body.id || agent?.id];
       await refreshConfiguredAgents();
       showStatus(`${body.label || body.id} saved.`);
     } catch (err) {
@@ -6778,6 +6792,10 @@ function buildConfiguredAgentForm(agent) {
 async function refreshConfiguredAgents() {
   const configuredAgents = await requestJson('/api/ai-hub/configured-agents');
   if (state.bootstrap) state.bootstrap.configuredAgents = Array.isArray(configuredAgents) ? configuredAgents : [];
+  const ids = new Set((state.bootstrap?.configuredAgents || []).map((agent) => agent.id));
+  for (const id of Object.keys(state.configuredAgentCheckResults)) {
+    if (!ids.has(id)) delete state.configuredAgentCheckResults[id];
+  }
   renderConfiguredAgentsPanel();
   renderActiveEmployeeSelect(activeConversation());
 }
@@ -7646,12 +7664,18 @@ function tfLoadClientState() {
 }
 
 async function tfSaveProjectsToServer(projects, options) {
-  if (!state.projectPath) throw new Error('No active project path available.');
+  // #891: on a true first run there is no recorded/active project (per #866 the
+  // launch directory is never assumed as a project), so state.projectPath is empty.
+  // Creating the FIRST project must still work: fall back to the project path being
+  // created (the folder the manager just chose), passed explicitly by the caller.
+  // state.projectPath stays authoritative whenever a project is already active.
+  const projectPath = (options && options.projectPath) || state.projectPath;
+  if (!projectPath) throw new Error('No active project path available.');
   const reviveRemovedPaths = options && Array.isArray(options.reviveRemovedPaths) ? options.reviveRemovedPaths : [];
   const payload = await requestJson('/api/ai-hub/projects', {
     method: 'PUT',
     headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ projectPath: state.projectPath, projects: Array.isArray(projects) ? projects : [], reviveRemovedPaths }),
+    body: JSON.stringify({ projectPath, projects: Array.isArray(projects) ? projects : [], reviveRemovedPaths }),
   });
   tfAdoptServerProjects(payload && payload.projects);
   return payload;
@@ -11430,7 +11454,7 @@ async function tfCreateProject() {
   };
   const removedKey = tfCanonicalProjectPath(folderPath);
   try {
-    await tfSaveProjectsToServer([...(tf.projects || []), project], { reviveRemovedPaths: [folderPath] });
+    await tfSaveProjectsToServer([...(tf.projects || []), project], { reviveRemovedPaths: [folderPath], projectPath: state.projectPath || folderPath });
     tf.removedPaths.delete(removedKey);
   } catch (error) {
     showStatus('Could not create project: ' + (error && error.message ? error.message : 'request failed.'), true);

package/public/ai-hub/styles.css

@@ -1437,6 +1437,7 @@ img.coach-employee-avatar { object-fit: cover; border-radius: 4px; }
   padding: 8px 12px;
   width: 100%;
   flex: 1 1 100%;
+  overflow-x: auto;
 }
 
 .thread-surface {
@@ -3039,7 +3040,7 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
 .ptb-dismiss { font-size: 13px; color: var(--muted); background: none; border: 1px solid var(--line, rgba(0,0,0,.1)); border-radius: 6px; padding: 6px 12px; cursor: pointer; white-space: nowrap; flex-shrink: 0; }
 .ptb-dismiss:hover { color: var(--text); border-color: var(--muted); }
 /* #521: project-onboarding input modal (manager's direction before a run). */
-.obi-input { width: 100%; box-sizing: border-box; resize: vertical; min-height: 96px; font: inherit; font-size: 14px; line-height: 1.5; padding: 11px 13px; border: 1px solid var(--line, #e2e2e2); border-radius: 10px; background: var(--surface, #fff); color: var(--ink, #1a1a1a); }
+.obi-input { width: 100%; box-sizing: border-box; resize: vertical; min-height: 96px; font: inherit; font-size: 14px; line-height: 1.5; padding: 11px 13px; border: 1px solid var(--line, #e2e2e2); border-radius: 10px; background: var(--surface, #fff); color: var(--text); }
 .obi-input:focus { outline: none; border-color: var(--accent, #1f6feb); }
 .obi-actions { display: flex; justify-content: flex-end; gap: 10px; margin-top: 14px; }
 .obi-cancel { font-size: 14px; font-weight: 500; color: var(--muted, #666); background: none; border: none; padding: 10px 14px; cursor: pointer; }
@@ -3623,7 +3624,7 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
   font-size: 13px;
   font-weight: 600;
   text-align: left;
-  color: var(--ink, #1a1a1a);
+  color: var(--text);
   background: var(--surface, #fff);
   border: 1px solid var(--line, #e2e2e2);
   border-radius: 8px;
@@ -3660,7 +3661,7 @@ body.hub-shell { display: flex; flex-direction: column; height: 100vh; overflow:
   padding: 8px 10px;
   font-size: 13px;
   text-align: left;
-  color: var(--ink, #1a1a1a);
+  color: var(--text);
   background: transparent;
   border: none;
   border-radius: 7px;