nexus-prime 7.9.25 → 7.9.26

package/dist/dashboard/app/styles/board.css

@@ -479,6 +479,38 @@
     color: var(--text-main); margin-bottom: 4px;
 }
 .frh-sub { font-size: var(--text-sm); color: var(--text-dim); }
+.frh-steps {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: 8px;
+    margin-bottom: 14px;
+}
+.frh-step {
+    display: grid;
+    grid-template-columns: auto 1fr;
+    grid-template-rows: auto auto;
+    gap: 1px 8px;
+    align-items: center;
+    padding: 9px 10px;
+    border: 1px solid color-mix(in oklch, var(--accent) 24%, var(--border));
+    border-radius: var(--radius);
+    background: color-mix(in oklch, var(--accent) 4%, var(--bg-panel));
+    min-width: 0;
+}
+.frh-step span {
+    grid-row: 1 / span 2;
+    display: inline-grid;
+    place-items: center;
+    width: 22px;
+    height: 22px;
+    border-radius: 50%;
+    background: color-mix(in oklch, var(--accent) 18%, transparent);
+    color: var(--accent);
+    font-family: var(--font-mono);
+    font-size: 0.72rem;
+}
+.frh-step strong { font-size: 0.78rem; color: var(--text-main); min-width: 0; }
+.frh-step small { font-size: 0.72rem; color: var(--text-dim); min-width: 0; }
 .frh-command {
     display: grid;
     grid-template-columns: minmax(220px, 1fr) auto auto;
@@ -492,6 +524,7 @@
     transition: border-color 0.15s;
 }
 .frh-pick:hover { border-color: var(--accent); }
+.frh-pick-loading { border-style: dashed; }
 .frh-pick-name { font-size: var(--text-sm); font-weight: var(--weight-semibold); color: var(--text-main); }
 .frh-pick-desc { font-size: 0.78rem; color: var(--text-dim); flex: 1; }
 .frh-pick-cost { font-family: var(--font-mono); font-size: 0.75rem; color: var(--accent); margin-top: 2px; }
@@ -507,6 +540,7 @@
 }
 @media (max-width: 768px) {
     #kanban-board { grid-template-columns: repeat(2, 1fr); }
+    .frh-steps,
     .frh-command,
     .frh-picks { grid-template-columns: 1fr; }
 }

package/dist/dashboard/app/views/board.js

@@ -376,7 +376,6 @@ function renderFirstRunHero() {
     if (hasOps || (alreadySeen && hasRuns)) return;
 
     const specs = (S.curatedSpecialists || []).slice(0, 3);
-    if (!specs.length) return; // Still loading — will re-render when prefetch resolves
     const readiness = getHireReadiness();
     const noticesHtml = readiness.notes.length
         ? `<div class="frh-notices" style="display:flex;flex-direction:column;gap:8px;margin-bottom:12px">
@@ -389,23 +388,33 @@ function renderFirstRunHero() {
     card.className = 'first-run-hero card';
     card.innerHTML = `
         <div class="frh-header">
-            <div class="frh-title">${hasRuns ? 'Your next hire' : 'Start the first real run'}</div>
-            <div class="frh-sub">${hasRuns ? 'Hire a specialist to start running tasks autonomously.' : 'Run a goal from the dashboard or hire a specialist. The run will appear in Board and Context Log.'}</div>
+            <div class="frh-title">${hasRuns ? 'Choose the next worker' : 'Start the first real run'}</div>
+            <div class="frh-sub">${hasRuns ? 'Hire a specialist or queue a goal. Nexus will show the route, budget, workers, and verification here.' : 'Queue one goal from the dashboard. Nexus will route it, show who gets hired, and write the run trail into Board and Context Log.'}</div>
         </div>
         ${noticesHtml}
+        <div class="frh-steps" aria-label="Onboarding steps">
+            <div class="frh-step"><span>1</span><strong>Describe goal</strong><small>Run or hire from here.</small></div>
+            <div class="frh-step"><span>2</span><strong>Watch route</strong><small>Board shows workers and budget.</small></div>
+            <div class="frh-step"><span>3</span><strong>Verify proof</strong><small>Context Log keeps artifacts.</small></div>
+        </div>
         <div class="frh-command">
             <input id="frh-goal-input" class="form-input" type="text" placeholder="Inspect this repo and suggest the next fix" autocomplete="off">
-            <button class="btn btn-primary btn-sm" id="frh-run-btn">Run goal</button>
+            <button class="btn btn-primary btn-sm" id="frh-run-btn">Run first goal</button>
             <button class="btn btn-sm" id="frh-context-btn">Open context</button>
         </div>
         <div class="frh-picks">
-            ${specs.map(s => `
+            ${specs.length ? specs.map(s => `
             <div class="frh-pick" data-specid="${esc(s.specialistId)}" data-specname="${esc(s.name)}">
                 <div class="frh-pick-name">${esc(s.name)}</div>
                 <div class="frh-pick-desc">${esc((s.description||'').slice(0, 72))}${(s.description||'').length > 72 ? '…' : ''}</div>
                 <div class="frh-pick-cost">~$${esc(String(s.pricing?.typical ?? '?'))}/sortie</div>
                 <button class="btn btn-primary btn-sm frh-hire-btn" data-specid="${esc(s.specialistId)}" data-specname="${esc(s.name)}" ${readiness.unavailable ? 'disabled title="Synapse is not ready"' : ''}>Hire</button>
-            </div>`).join('')}
+            </div>`).join('') : `
+            <div class="frh-pick frh-pick-loading">
+                <div class="frh-pick-name">Specialists loading</div>
+                <div class="frh-pick-desc">You can run a goal immediately. Hiring picks will appear when the catalog responds.</div>
+                <div class="frh-pick-cost">route first, hire second</div>
+            </div>`}
         </div>
         <div id="frh-status" style="display:none;margin-top:12px;font-size:var(--text-sm)"></div>
         <button class="btn btn-ghost btn-sm frh-dismiss" style="margin-top:var(--space-3)">Dismiss</button>`;
@@ -424,6 +433,7 @@ function renderFirstRunHero() {
         const result = await post('/api/orchestrate', { goal, source: 'dashboard-onboarding' });
         if (result.ok) {
             setFirstRunStatus('Run queued. Board and Context Log will update as Nexus writes artifacts.');
+            try { localStorage.setItem(FIRST_RUN_KEY, '1'); } catch { /* ignore */ }
             bustCache('/api/runs?limit=12');
             bustCache('/api/events');
             setTimeout(load, 900);
@@ -431,7 +441,7 @@ function renderFirstRunHero() {
             setFirstRunStatus(result.error || 'Run failed to queue.', 'bad');
             if (button) {
                 button.disabled = false;
-                button.textContent = 'Run goal';
+                button.textContent = 'Run first goal';
             }
         }
     });
@@ -508,6 +518,21 @@ function buildKanbanCols() {
             if (sg) cols[sg].push({id:w.id||w.workerId||w.goal,goal:w.goal||w.task||w.approach||'(worker)',status:st,tokens:w.tokensUsed||w.budget,time:w.startedAt||w.createdAt,role:w.role});
         }
     }
+    const ghost = S.lastDecomposition?.autoGhostPass || S.lastCompletion?.autoGhostPass || op?.orchestration?.autoGhostPass || op?.autoGhostPass;
+    if (ghost && (ghost.applied || ghost.policy?.reason)) {
+        const risks = Array.isArray(ghost.riskAreas) ? ghost.riskAreas.length : 0;
+        const reason = ghost.policy?.reason ? ` · ${ghost.policy.reason}` : '';
+        cols.ghostpass.push({
+            id: 'auto-ghostpass',
+            goal: ghost.applied
+                ? `Auto Ghost Pass: ${risks} risk area${risks === 1 ? '' : 's'}, ${ghost.workerApproaches || 0} approach${ghost.workerApproaches === 1 ? '' : 'es'}`
+                : `Auto Ghost Pass skipped${reason}`,
+            status: ghost.applied ? 'reviewing' : 'skipped',
+            tokens: ghost.estimatedTokens,
+            time: S.lastDecomposition?.ts || S.lastCompletion?.ts,
+            role: 'ghost-pass',
+        });
+    }
     for (const r of (S.runs||[]).slice(0,8)) {
         const runId = r.runId || r.id;
         if (!runId) continue;
@@ -874,11 +899,16 @@ function renderOrchestrationPipeline() {
         const more = arr.length > 6 ? ` <span style="color:var(--muted)">+${arr.length - 6}</span>` : '';
         return `<div style="margin:4px 0"><span style="color:var(--muted);font-size:11px;text-transform:uppercase;letter-spacing:0.5px">${esc(label)}</span> <span style="font-family:var(--font-mono);font-size:12px">${head}${more}</span></div>`;
     };
+    const ghostChip = (ghost) => ghost
+        ? chip('ghost-pass', ghost.applied
+            ? `${ghost.riskAreas?.length ?? 0} risks · ${ghost.workerApproaches ?? 0} approaches`
+            : `skipped${ghost.policy?.reason ? ` · ${ghost.policy.reason}` : ''}`)
+        : '';
     const decBlock = dec ? `
         <div style="border-left:3px solid var(--accent);padding:8px 12px;margin-bottom:8px">
             <div style="font-size:13px;font-weight:600;margin-bottom:4px">Decomposition · run ${esc((dec.runId || '').slice(-8))}</div>
             <div style="font-size:12px;color:var(--muted);margin-bottom:6px">${esc(dec.goal || '')}</div>
-            <div>${chip('intent', dec.intent || 'auto')}${chip('crew', dec.crew || 'baseline')}${chip('workers', dec.workers ?? 0)}${chip('phases', dec.phases ?? 0)}</div>
+            <div>${chip('intent', dec.intent || 'auto')}${chip('crew', dec.crew || 'baseline')}${chip('workers', dec.workers ?? 0)}${chip('phases', dec.phases ?? 0)}${ghostChip(dec.autoGhostPass)}</div>
             ${chipList('specialists', dec.specialists)}
             ${chipList('skills', dec.skills)}
             ${chipList('files', dec.files)}
@@ -888,7 +918,7 @@ function renderOrchestrationPipeline() {
         <div style="border-left:3px solid ${stateColor(cmpState)};padding:8px 12px">
             <div style="font-size:13px;font-weight:600;margin-bottom:4px">Completion · run ${esc((cmp.runId || '').slice(-8))} · <span style="color:${stateColor(cmpState)}">${esc(cmpState || '')}</span></div>
             <div style="font-size:12px;color:var(--muted);margin-bottom:6px">${esc(cmp.result || '')}</div>
-            <div>${chip('verified', `${cmp.verifiedWorkers ?? 0}/${cmp.totalWorkers ?? 0}`)}${chip('saved', `${fmtNum(cmp.savedTokens ?? 0)} t`)}${chip('compression', `${cmp.compressionPct ?? 0}%`)}${chip('duration', `${Math.round((cmp.durationMs ?? 0) / 100) / 10}s`)}</div>
+            <div>${chip('verified', `${cmp.verifiedWorkers ?? 0}/${cmp.totalWorkers ?? 0}`)}${chip('saved', `${fmtNum(cmp.savedTokens ?? 0)} t`)}${chip('compression', `${cmp.compressionPct ?? 0}%`)}${chip('duration', `${Math.round((cmp.durationMs ?? 0) / 100) / 10}s`)}${ghostChip(cmp.autoGhostPass)}</div>
         </div>` : '';
     const spineBlock = spine ? _buildDecisionSpineMiniHtml(spine) : '';
     const headerNote = same ? '' : (dec && cmp ? '<div style="font-size:11px;color:var(--muted);margin-bottom:6px">Showing latest decomposition + most recent completion (different runs)</div>' : '');

package/dist/engines/event-bus.d.ts

@@ -93,6 +93,16 @@ export interface NexusEventPayloads {
         files: string[];
         workers: number;
         phases: number;
+        autoGhostPass?: {
+            applied: boolean;
+            riskAreas: string[];
+            workerApproaches: number;
+            estimatedTokens: number;
+            policy?: {
+                enabled?: boolean;
+                reason?: string;
+            };
+        };
     };
     'orchestration.completed': {
         runId: string;
@@ -104,6 +114,12 @@ export interface NexusEventPayloads {
         compressionPct: number;
         durationMs: number;
         result: string;
+        autoGhostPass?: {
+            applied: boolean;
+            riskAreas: string[];
+            workerApproaches: number;
+            estimatedTokens: number;
+        };
     };
     'session.summaryBootstrap': {
         originalTokens: number;

package/dist/engines/orchestrator.js

@@ -1036,7 +1036,7 @@ export class OrchestratorEngine {
             // Non-fatal: bootstrap receipt is a safety net, not a hard dependency
         }
         const [army, prepared] = await this.runParallelPhases(this.induce(task), this._prepareExecution(task, options));
-        const { intent, phases, primaryClient, bootstrapManifest, latestDNA, memoryMatches, memoryStats, candidateFiles, knowledgeFabric, plannedFiles, planner, selections, catalogHealth, tokenBudget, workerCount, mode, taskGraph, workerPlan, autoGhostPass, crSignals, } = prepared;
+        const { intent, phases, primaryClient, bootstrapManifest, latestDNA, memoryMatches, memoryStats, candidateFiles, knowledgeFabric, plannedFiles, planner, selections, catalogHealth, tokenBudget, workerCount, mode, taskGraph, workerPlan, autoGhostPass, autoGhostPassDecision, crSignals, } = prepared;
         this.runtime.recordClientToolCall('nexus_orchestrate', {
             orchestrateCalled: true,
             plannerCalled: true,
@@ -1314,6 +1314,8 @@ export class OrchestratorEngine {
             instructionPacket,
             executionLedger: ledger,
             knowledgeFabric,
+            autoGhostPass,
+            autoGhostPassDecision,
         });
         this.executionDedupeStore.set(fingerprint, {
             id: ledger.runId,

package/dist/install/claude-code-hooks.js

@@ -24,6 +24,10 @@ export function getNexusHookSpec() {
                 matcher: 'Edit|Write|MultiEdit',
                 hooks: [{ type: 'command', command: 'nexus-prime hook mindkit', timeout: 10 }],
             },
+            {
+                matcher: 'MultiEdit',
+                hooks: [{ type: 'command', command: 'nexus-prime hook ghost-pass', timeout: 15 }],
+            },
         ],
         PostToolUse: [
             {

package/dist/phantom/runtime.d.ts

@@ -101,6 +101,12 @@ export interface ExecutionTask {
     instructionPacket?: InstructionPacket;
     executionLedger?: ExecutionLedger;
     knowledgeFabric?: KnowledgeFabricBundle;
+    autoGhostPass?: GhostReport;
+    autoGhostPassDecision?: {
+        enabled: boolean;
+        reason: string;
+        contextHash?: string;
+    };
 }
 export interface WorkerSkillOverlay {
     base: string[];

package/dist/phantom/runtime.js

@@ -225,6 +225,16 @@ export class SubAgentRuntime {
                 files: (task.files ?? []).slice(0, 24),
                 workers: planner.plannerState.selectedSpecialists.length || 1,
                 phases: planner.plannerState.ledger.length,
+                autoGhostPass: {
+                    applied: Boolean(task.autoGhostPass),
+                    riskAreas: task.autoGhostPass?.riskAreas ?? [],
+                    workerApproaches: task.autoGhostPass?.workerAssignments?.length ?? 0,
+                    estimatedTokens: task.autoGhostPass?.totalEstimatedTokens ?? 0,
+                    policy: task.autoGhostPassDecision ? {
+                        enabled: task.autoGhostPassDecision.enabled,
+                        reason: task.autoGhostPassDecision.reason,
+                    } : undefined,
+                },
             });
         }
         catch { /* best-effort */ }
@@ -765,6 +775,12 @@ export class SubAgentRuntime {
                 compressionPct: Number(tt?.compressionPct ?? 0),
                 durationMs: Date.now() - runStartedAt,
                 result: String(applied.summary ?? '').slice(0, 280),
+                autoGhostPass: {
+                    applied: Boolean(task.autoGhostPass),
+                    riskAreas: task.autoGhostPass?.riskAreas ?? [],
+                    workerApproaches: task.autoGhostPass?.workerAssignments?.length ?? 0,
+                    estimatedTokens: task.autoGhostPass?.totalEstimatedTokens ?? 0,
+                },
             });
         }
         catch { /* best-effort */ }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.9.25",
+  "version": "7.9.26",
   "description": "Local-first MCP control plane for coding agents with bootstrap-orchestrate execution, memory fabric, token budgeting, and worktree-backed swarms",
   "type": "module",
   "main": "dist/index.js",