nexus-prime 7.5.0 → 7.6.2

package/dist/agents/adapters/mcp/definitions.js

@@ -962,8 +962,13 @@ export function buildMcpToolDefinitions() {
                 required: ['taskId', 'goal', 'findings'],
             },
         },
-        ...synapseToolDefinitions,
-        ...architectsToolDefinitions,
+        // When NEXUS_DISABLE_WORKFORCE=1 (the daemon default since v7.6.1),
+        // strip the 24 nexus_synapse_* / nexus_architects_* tools from the
+        // catalog so the model doesn't see surface area for engines that
+        // aren't initialized at runtime. Set NEXUS_DISABLE_WORKFORCE=0 to
+        // re-enable both engines + their tools.
+        ...(process.env.NEXUS_DISABLE_WORKFORCE === '1' ? [] : synapseToolDefinitions),
+        ...(process.env.NEXUS_DISABLE_WORKFORCE === '1' ? [] : architectsToolDefinitions),
         // ── Workforce (unified worker+job layer) ──────────────────────────
         {
             name: 'nexus_work_enqueue',

package/dist/cli.js

@@ -788,6 +788,16 @@ program
     if (process.env.NEXUS_DAEMON_FAST_START === undefined) {
         process.env.NEXUS_DAEMON_FAST_START = '1';
     }
+    // Default the daemon to "workforce-disabled" mode: Synapse + Architects
+    // engines stay in the source tree (tests still run, code is preserved)
+    // but they don't open their SQLite DBs, run schema migrations, or
+    // surface their 24 MCP tools to clients. Saves ~700ms boot, shrinks
+    // the model-visible tool catalog, and removes the empty Workforce
+    // surface from the dashboard. Re-enable with NEXUS_DISABLE_WORKFORCE=0
+    // for users who actually hire operatives + dispatch missions.
+    if (process.env.NEXUS_DISABLE_WORKFORCE === undefined) {
+        process.env.NEXUS_DISABLE_WORKFORCE = '1';
+    }
     const workspaceContext = resolveWorkspaceContext({ workspaceRoot: getWorkspaceRoot() });
     const daemon = new NexusDaemonServer(workspaceContext);
     const { started, record } = await daemon.start();
@@ -1905,6 +1915,75 @@ program
         timeoutMs: opts.timeout ? Number(opts.timeout) : undefined,
     });
 });
+program
+    .command('fix-claude-hooks')
+    .description('Strip stale Nexus hook entries from ~/.claude/settings.json (use after downgrading from a newer version)')
+    .option('--dry-run', 'Show what would change without writing')
+    .option('--workspace', 'Also clean ./.claude/settings.json in the current workspace')
+    .action(async (opts) => {
+    const fs = await import('fs');
+    const path = await import('path');
+    const os = await import('os');
+    const { NEXUS_HOOK_COMMAND_MARKER } = await import('./install/claude-code-hooks.js');
+    const targets = [path.join(os.homedir(), '.claude', 'settings.json')];
+    if (opts.workspace)
+        targets.push(path.join(process.cwd(), '.claude', 'settings.json'));
+    let totalRemoved = 0;
+    for (const target of targets) {
+        if (!fs.existsSync(target)) {
+            console.log(`  skip: ${target} (not found)`);
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(fs.readFileSync(target, 'utf8'));
+        }
+        catch (err) {
+            console.error(`  error: ${target} (invalid JSON: ${err instanceof Error ? err.message : String(err)})`);
+            continue;
+        }
+        const hooks = parsed?.hooks;
+        if (!hooks || typeof hooks !== 'object') {
+            console.log(`  ok: ${target} (no hooks block)`);
+            continue;
+        }
+        let removedHere = 0;
+        for (const event of Object.keys(hooks)) {
+            if (!Array.isArray(hooks[event]))
+                continue;
+            const before = hooks[event];
+            const after = before.filter((entry) => {
+                const entryHooks = entry?.hooks;
+                if (!Array.isArray(entryHooks))
+                    return true;
+                const hasNexus = entryHooks.some((h) => typeof h?.command === 'string' && h.command.trimStart().startsWith(NEXUS_HOOK_COMMAND_MARKER));
+                if (hasNexus)
+                    removedHere += 1;
+                return !hasNexus;
+            });
+            if (after.length === 0) {
+                delete hooks[event];
+            }
+            else {
+                hooks[event] = after;
+            }
+        }
+        if (Object.keys(hooks).length === 0)
+            delete parsed.hooks;
+        totalRemoved += removedHere;
+        if (removedHere === 0) {
+            console.log(`  ok: ${target} (no Nexus entries)`);
+            continue;
+        }
+        if (opts.dryRun) {
+            console.log(`  dry-run: ${target} would remove ${removedHere} Nexus hook entry/entries`);
+            continue;
+        }
+        fs.writeFileSync(target, JSON.stringify(parsed, null, 2) + '\n', 'utf8');
+        console.log(`  fixed: ${target} (removed ${removedHere} entry/entries)`);
+    }
+    console.log(opts.dryRun ? `\nDry-run total: ${totalRemoved} entry/entries.` : `\nDone. Removed ${totalRemoved} stale Nexus hook entry/entries.`);
+});
 program
     .command('watch')
     .description('Tail live SSE events from the running daemon in a colored terminal feed')
@@ -1923,4 +2002,26 @@ program
 if (process.argv.length === 2) {
     process.argv.push('setup', 'auto');
 }
-program.parse();
+// Graceful fallback for unknown `nexus-prime hook <subcommand>` invocations.
+// When users downgrade from a version that wrote hook entries to
+// ~/.claude/settings.json, the older binary may not have the referenced
+// subcommand. Exiting non-zero would fail every Claude Code session start.
+// Drain piped stdin (Claude pipes JSON into hooks) and exit 0 silently.
+const KNOWN_HOOK_SUBCOMMANDS = new Set([
+    'bootstrap', 'memory', 'mindkit', 'ghost-pass', 'session-dna',
+    'generate', 'deploy', 'undeploy', 'list', 'help', '--help', '-h',
+]);
+if (process.argv[2] === 'hook' && process.argv[3] && !KNOWN_HOOK_SUBCOMMANDS.has(process.argv[3])) {
+    if (!process.stdin.isTTY) {
+        process.stdin.resume();
+        process.stdin.on('data', () => { });
+        process.stdin.on('end', () => process.exit(0));
+        setTimeout(() => process.exit(0), 200).unref();
+    }
+    else {
+        process.exit(0);
+    }
+}
+else {
+    program.parse();
+}

package/dist/dashboard/app/index.html

@@ -95,6 +95,12 @@ if(location.protocol==='file:'){
           <div id="board-pyramid"></div>
         </div>
 
+        <!-- Connected Ecosystem (per-client MCP status) -->
+        <div id="connected-ecosystem" class="card" style="margin-bottom:16px;display:none">
+          <div class="shd" style="margin-bottom:8px">Connected Ecosystem <span id="ecosystem-stamp" style="font-size:11px;opacity:.5;font-weight:400"></span></div>
+          <div id="ecosystem-list" style="display:flex;flex-wrap:wrap;gap:8px"></div>
+        </div>
+
         <!-- Hero KPI row -->
         <div id="hero-stats" role="region" aria-label="Key metrics">
           <div class="hero-stat"><div class="metric-val" id="m-tokens">—</div><div class="metric-lbl">Tokens Saved</div><canvas id="spark-tokens" class="sparkline" width="80" height="24" aria-hidden="true"></canvas></div>
@@ -116,6 +122,16 @@ if(location.protocol==='file:'){
         <!-- Orchestration pipeline (live decomposition + completion) -->
         <div id="orchestration-pipeline" class="card" style="margin-bottom:16px;display:none"></div>
 
+        <!-- Neural Stream HUD (live SSE event feed strip) -->
+        <div id="neural-stream-card" class="card" style="margin-bottom:16px;display:none">
+          <div class="shd" style="margin-bottom:8px;display:flex;align-items:center;gap:8px">
+            <span>Neural Stream</span>
+            <span id="neural-stream-count" style="font-size:11px;opacity:.5;font-weight:400"></span>
+            <span style="margin-left:auto;display:inline-flex;align-items:center;gap:4px;font-size:11px;opacity:.6;font-weight:400"><span style="display:inline-block;width:6px;height:6px;border-radius:50%;background:var(--accent-good,#4ade80);animation:pulse 2s ease-in-out infinite"></span> live</span>
+          </div>
+          <div id="neural-stream-list" style="display:flex;flex-direction:column;gap:4px;max-height:200px;overflow-y:auto"></div>
+        </div>
+
         <!-- Tool health strip -->
         <div id="tool-health-card" class="card" style="margin-bottom:16px;display:none">
           <div class="shd" style="margin-bottom:8px">Tool Health <span id="tool-health-stamp" style="font-size:11px;opacity:.5;font-weight:400"></span></div>

package/dist/dashboard/app/main.js

@@ -45,6 +45,9 @@ setOnEvent(evt => {
     // Runtime tab ingests ALL events regardless of active tab (for live history)
     Runtime.ingestEvent(evt);
 
+    // Neural Stream HUD ring buffer ingests ALL events too (board card auto-renders)
+    Board.pushNeuralEvent?.(evt);
+
     const tab = S.tab;
     if (tab === 'board') {
         Board.render();

package/dist/dashboard/app/state.js

@@ -82,6 +82,9 @@ export const S = {
     lastDecomposition: null,
     lastCompletion:    null,
 
+    // Neural Stream HUD ring buffer (latest SSE events, restored from v3.8.0)
+    neuralStream: [],
+
     // Assets sub-tabs
     assetsSubTab: 'skills',
 

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

@@ -93,6 +93,7 @@ export async function load() {
 }
 
 export function render() {
+    renderConnectedEcosystem();
     renderPyramidWidget();
     renderHero();
     renderFirstRunHero();
@@ -101,6 +102,126 @@ export function render() {
     renderEvents();
     renderPulse();
     renderToolHealth();
+    renderNeuralStream();
+}
+
+/* ── Connected Ecosystem (per-client MCP status, restored from v3.8.0) ── */
+const _CLIENT_LABEL = {
+    'claude-code': 'Claude Code',
+    claude: 'Claude',
+    'claude-desktop': 'Claude Desktop',
+    codex: 'Codex',
+    cursor: 'Cursor',
+    opencode: 'Opencode',
+    windsurf: 'Windsurf',
+    antigravity: 'Antigravity',
+    aider: 'Aider',
+    continue: 'Continue',
+    cline: 'Cline',
+    openclaw: 'OpenClaw',
+    mcp: 'MCP',
+};
+function _clientStateColor(state) {
+    const s = String(state || '').toLowerCase();
+    if (s === 'primaryactive' || s === 'active') return 'var(--accent-good, #4ade80)';
+    if (s === 'idle' || s === 'detected') return 'var(--accent-warn, #fbbf24)';
+    if (s === 'installed') return 'var(--accent, #60a5fa)';
+    return 'var(--muted, #6b7280)';
+}
+function renderConnectedEcosystem() {
+    const host = document.getElementById('connected-ecosystem');
+    if (!host) return;
+    const list = document.getElementById('ecosystem-list');
+    const stamp = document.getElementById('ecosystem-stamp');
+    const op = S.operateSurface;
+    const clients = (op?.clients?.detected || op?.clients || []);
+    const arr = Array.isArray(clients) ? clients : [];
+    if (arr.length === 0) {
+        host.style.display = 'none';
+        return;
+    }
+    host.style.display = 'block';
+    const primaryId = op?.clients?.primary?.clientId || op?.primaryClient?.clientId || null;
+    const ordered = [...arr].sort((a, b) => {
+        const ap = a.clientId === primaryId ? 0 : 1;
+        const bp = b.clientId === primaryId ? 0 : 1;
+        if (ap !== bp) return ap - bp;
+        return String(a.clientId || '').localeCompare(String(b.clientId || ''));
+    });
+    const html = ordered.slice(0, 12).map((c) => {
+        const id = String(c.clientId || c.id || 'unknown');
+        const label = _CLIENT_LABEL[id] || id;
+        const isPrimary = id === primaryId;
+        const stateRaw = isPrimary ? 'primaryActive' : (c.state || c.status || 'idle');
+        const color = _clientStateColor(stateRaw);
+        const stateLabel = isPrimary ? 'PRIMARY·ACTIVE' : String(stateRaw).toUpperCase();
+        const lastSeen = c.lastHeartbeatAt || c.lastSeenAt;
+        const ago = lastSeen ? timeAgo(lastSeen) : '';
+        return `<div style="display:flex;align-items:center;gap:8px;padding:6px 10px;border-radius:6px;background:var(--surface2);font-size:12px;border-left:3px solid ${color}">
+            <span style="width:6px;height:6px;border-radius:50%;background:${color};flex-shrink:0"></span>
+            <span style="font-family:var(--font-mono);font-weight:600;color:var(--fg1)">${esc(label)}</span>
+            <span style="font-size:10px;color:${color};font-family:var(--font-mono);text-transform:uppercase;letter-spacing:0.5px">${esc(stateLabel)}</span>
+            ${ago ? `<span style="margin-left:auto;font-size:10px;color:var(--muted)">${esc(ago)}</span>` : ''}
+        </div>`;
+    }).join('');
+    list.innerHTML = html;
+    if (stamp) stamp.textContent = `${ordered.length} client${ordered.length === 1 ? '' : 's'}`;
+}
+
+/* ── Neural Stream HUD (live SSE event feed strip, restored from v3.8.0) ── */
+const _NEURAL_MAX = 12;
+function _neuralColor(category) {
+    switch (String(category || '').toLowerCase()) {
+        case 'memory': return 'oklch(68% 0.22 295)';
+        case 'token':
+        case 'tokens': return 'oklch(87% 0.19 152)';
+        case 'orchestration':
+        case 'planner': return 'oklch(83% 0.14 220)';
+        case 'synapse':
+        case 'operative':
+        case 'mission': return 'oklch(83% 0.17 55)';
+        case 'architects':
+        case 'dispatch':
+        case 'sentinel': return 'oklch(75% 0.20 30)';
+        case 'darwin':
+        case 'governance': return 'oklch(78% 0.18 340)';
+        case 'graph': return 'oklch(80% 0.15 180)';
+        default: return 'var(--muted, #6b7280)';
+    }
+}
+export function pushNeuralEvent(evt) {
+    if (!evt || typeof evt !== 'object') return;
+    if (!Array.isArray(S.neuralStream)) S.neuralStream = [];
+    S.neuralStream.unshift({
+        type: String(evt.type || ''),
+        category: String(evt.category || ''),
+        time: Number(evt.time || Date.now()),
+        summary: typeof evt.summary === 'string' ? evt.summary : '',
+    });
+    if (S.neuralStream.length > _NEURAL_MAX) S.neuralStream.length = _NEURAL_MAX;
+    renderNeuralStream();
+}
+function renderNeuralStream() {
+    const host = document.getElementById('neural-stream-card');
+    if (!host) return;
+    const list = document.getElementById('neural-stream-list');
+    const count = document.getElementById('neural-stream-count');
+    const items = Array.isArray(S.neuralStream) ? S.neuralStream : [];
+    if (items.length === 0) {
+        host.style.display = 'none';
+        return;
+    }
+    host.style.display = 'block';
+    if (count) count.textContent = `${items.length} signal${items.length === 1 ? '' : 's'}`;
+    list.innerHTML = items.map((e) => {
+        const color = _neuralColor(e.category);
+        const ago = timeAgo(e.time);
+        return `<div style="display:flex;align-items:baseline;gap:8px;padding:3px 6px;border-left:2px solid ${color};font-size:11px;font-family:var(--font-mono);line-height:1.4">
+            <span style="color:${color};font-weight:600;min-width:90px">${esc(e.type)}</span>
+            <span style="color:var(--fg1);flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">${esc(e.summary || e.category || '')}</span>
+            <span style="color:var(--muted);font-size:10px;flex-shrink:0">${esc(ago)}</span>
+        </div>`;
+    }).join('');
 }
 
 /* ── Memory pyramid (above kanban) ── */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.5.0",
+  "version": "7.6.2",
   "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",