nexus-prime 6.2.0 → 6.3.0

package/dist/dashboard/app/api.js

@@ -64,13 +64,14 @@ export async function post(url, body, opts = {}) {
             return { ok: true, data, error: null, status: r.status };
         }
         let errText = `HTTP ${r.status}`;
+        let errData = null;
         try {
-            const err = await r.json();
-            errText = err?.error || err?.message || errText;
+            errData = await r.json();
+            errText = errData?.error || errData?.message || errText;
         } catch {
             try { errText = (await r.text()) || errText; } catch { /* ignore */ }
         }
-        return { ok: false, data: null, error: errText, status: r.status };
+        return { ok: false, data: errData, error: errText, status: r.status };
     }).catch((e) => ({ ok: false, data: null, error: e?.message || String(e), status: 0 }));
 
     if (optimistic !== undefined) {

package/dist/dashboard/app/main.js

@@ -63,6 +63,16 @@ setOnEvent(evt => {
     if (tab === 'governance' && evt.category === 'byzantine') {
         Governance.handleByzantineEvent(evt);
     }
+    if (String(evt.type||'').startsWith('graph.cr.build')) {
+        bustCache('/api/knowledge-topology');
+        Repo.handleBuildEvent?.(evt);
+        if (tab === 'knowledge') {
+            Knowledge.load();
+        }
+        if (tab === 'memory' && evt.type === 'graph.cr.build.complete') {
+            Memory.load();
+        }
+    }
     // Route push-mode dispatch events regardless of active tab
     if (String(evt.type||'').startsWith('dispatch.')) {
         Workforce.handleDispatchEvent(evt);
@@ -87,6 +97,7 @@ async function loadWorkspace() {
     const repoEl = $('workspace-repo'), branchEl = $('workspace-branch');
     if (repoEl)   repoEl.textContent   = ws.repoName || '—';
     if (branchEl) branchEl.textContent = ws.branch   || 'detached';
+    document.title = `${ws.repoName || 'Nexus Prime'} · Nexus Prime`;
     const badge = $('workspace-badge');
     if (badge) badge.title = `${ws.repoName||''} @ ${ws.repoRoot||''}`;
 }
@@ -181,6 +192,7 @@ function _attachHandlers() {
     document.addEventListener('keydown', e => {
         if ((e.ctrlKey||e.metaKey) && e.key === '`') { e.preventDefault(); _toggleChat(); }
     });
+    $('chat-toggle-btn')?.addEventListener('click', _toggleChat);
     $('chat-send-btn')?.addEventListener('click', _sendChat);
     $('chat-input')?.addEventListener('keydown', e => { if (e.key==='Enter'&&!e.shiftKey){ e.preventDefault(); _sendChat(); } });
     $('chat-close-btn')?.addEventListener('click', _toggleChat);
@@ -226,7 +238,7 @@ async function bootstrap() {
     _renderHeader(false);
 
     // Fast first paint: board + workspace + projects + repo-tree + license
-    const [,,, lic] = await Promise.all([
+    const [, , , , lic] = await Promise.all([
         Board.load(),
         loadWorkspace(),
         loadProjects(),

package/dist/dashboard/app/state.js

@@ -34,6 +34,7 @@ export const S = {
     tokensLifetime: null,
     operateSurface: null,
     synapseHealth:  [],
+    synapseHealthRaw: null,
     events:         [],
     ticker:         [],
     spark:          null,

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

@@ -3,8 +3,8 @@
  * PM tweak: pyramid is rendered ABOVE the kanban. The pyramid is the memory aha moment.
  */
 
-import { S }               from '../state.js';
-import { api, post, bustCache } from '../api.js';
+import { S, bus }          from '../state.js';
+import { api, post, bustCache, notifyNotReady } from '../api.js';
 import { openDrawer }      from '../widgets/drawer.js';
 import { drawSparkline }   from '../widgets/sparkline.js';
 import { renderPyramid }   from '../widgets/pyramid.js';
@@ -66,18 +66,22 @@ function normalizeOperative(op) {
 
 /* ── Data loader ── */
 export async function load() {
-    const [tok, life, op, sh] = await Promise.all([
+    const [tok, life, op, sh, health] = await Promise.all([
         api('/api/tokens/summary'),
         api('/api/tokens/lifetime', 15000),
         api('/api/dashboard/surface/operate', 5000),
         api('/api/synapse/health', 5000),
+        api('/api/health', 15000),
     ]);
     // Non-blocking: tool health data from ring buffer
     loadToolHealth();
     S.tokensSummary  = tok;
     S.tokensLifetime = life;
     S.operateSurface = op;
+    S.synapseHealthRaw = sh;
     S.synapseHealth  = (Array.isArray(sh) ? sh : (sh?.operatives||[])).map(normalizeOperative);
+    S.healthData     = health;
+    notifyNotReady([sh]);
     // Prefetch curated specialists for first-run hero (non-blocking)
     if (!S.synapseHealth.length && !S.curatedSpecialists) {
         api('/api/specialists/curated', 60000).then(d => {
@@ -120,10 +124,31 @@ function renderPyramidWidget() {
 /* ── Hero KPI row ── */
 function renderHero() {
     const t=S.tokensSummary, lt=S.tokensLifetime, op=S.operateSurface;
-    const saved = lt?.totalSaved ?? lt?.lifetime?.saved ?? t?.saved ?? 0;
+    const saved = Number(
+        lt?.savedTokens
+        ?? lt?.lifetime?.savedTokens
+        ?? lt?.totalSaved
+        ?? lt?.lifetime?.saved
+        ?? op?.tokenOptimization?.savedTokens
+        ?? t?.savedTokens
+        ?? t?.saved
+        ?? 0,
+    );
     animCounter('m-tokens', saved);
-    const gross=t?.gross||0, net=t?.net||0;
-    const pct = gross>0 ? Math.round((1-net/gross)*100) : 0;
+    const gross = Number(
+        lt?.grossInputTokens
+        ?? lt?.lifetime?.grossInputTokens
+        ?? op?.tokenOptimization?.grossInputTokens
+        ?? t?.gross
+        ?? 0,
+    );
+    const net = Number(t?.net ?? 0);
+    const pct = Number(
+        lt?.compressionPct
+        ?? lt?.lifetime?.compressionPct
+        ?? op?.tokenOptimization?.compressionPct
+        ?? (gross > 0 && net > 0 ? Math.round((1-net/gross)*100) : 0),
+    );
     const pEl = $('m-pct');
     if (pEl) { pEl.innerHTML=`${pct}<sup>%</sup>`; pEl.dataset.raw=pct; }
     const memCount = op?.memory?.total ?? S.memHealth?.total ?? S.memories.length;
@@ -143,6 +168,36 @@ function renderHero() {
 /* ── First-run hero (shown when no operatives are hired yet) ── */
 const FIRST_RUN_KEY = 'nexus_first_run_seen';
 
+function getHireReadiness() {
+    const notes = [];
+    const synapseState = S.healthData?.runtimeEnvelope?.engines?.synapse ?? {};
+    const memoryStorage = S.healthData?.memory?.storage ?? {};
+    const rawReason = S.synapseHealthRaw?.reason;
+    const unavailable = Boolean(
+        S.synapseHealthRaw?.notReady
+        || synapseState.ready === false
+        || synapseState.available === false,
+    );
+    if (unavailable) {
+        notes.push({ tone: 'bad', text: rawReason || synapseState.reason || 'Synapse is not ready for hires in this dashboard session.' });
+    }
+    if (synapseState.fallbackApplied) {
+        notes.push({ tone: 'warn', text: synapseState.reason || 'Synapse is running in fallback storage mode.' });
+    }
+    if (memoryStorage.fallbackApplied) {
+        notes.push({ tone: 'warn', text: memoryStorage.fallbackReason || 'Memory storage fallback is active.' });
+    }
+    return { unavailable, notes };
+}
+
+function setFirstRunStatus(message, tone='info') {
+    const el = $('frh-status');
+    if (!el) return;
+    el.textContent = message || '';
+    el.style.display = message ? 'block' : 'none';
+    el.style.color = tone === 'bad' ? 'var(--bad)' : tone === 'warn' ? '#ffd14d' : 'var(--accent)';
+}
+
 function renderFirstRunHero() {
     const el = $('first-run-hero');
     // No placeholder in current HTML — inject it before the live strip if needed
@@ -160,6 +215,12 @@ function renderFirstRunHero() {
 
     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">
+            ${readiness.notes.map(note => `<div class="chip ${note.tone === 'bad' ? 'bad' : ''}" style="${note.tone === 'bad' ? 'color:var(--bad);border-color:#ff5f5733;background:#ff5f5712' : 'color:#ffd14d;border-color:#ffd14d33;background:#ffd14d12'}">${esc(note.text)}</div>`).join('')}
+        </div>`
+        : '';
 
     const card = document.createElement('div');
     card.id = 'first-run-hero';
@@ -169,33 +230,48 @@ function renderFirstRunHero() {
             <div class="frh-title">Your next hire</div>
             <div class="frh-sub">Hire a specialist to start running tasks autonomously.</div>
         </div>
+        ${noticesHtml}
         <div class="frh-picks">
             ${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)}">Hire</button>
+                <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>
+        <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>`;
 
     // Wire buttons before inserting
     card.querySelectorAll('.frh-hire-btn').forEach(btn => {
         btn.addEventListener('click', async e => {
             e.stopPropagation();
+            if (readiness.unavailable) {
+                setFirstRunStatus(readiness.notes[0]?.text || 'Synapse is not ready for hires.', 'bad');
+                return;
+            }
             btn.disabled = true; btn.textContent = 'Hiring…';
+            setFirstRunStatus('Submitting hire request…');
             const result = await post('/api/synapse/hire', {
                 specialistId: btn.dataset.specid,
                 name: btn.dataset.specname,
                 budgetCapUsd: 2,
             });
             if (result.ok) {
+                setFirstRunStatus(readiness.notes.some(note => note.tone === 'warn')
+                    ? 'Hired successfully. Fallback storage warning is still active.'
+                    : 'Hired successfully.');
                 try { localStorage.setItem(FIRST_RUN_KEY, '1'); } catch { /* ignore */ }
                 bustCache('/api/synapse/health');
                 setTimeout(load, 800);
             } else {
                 btn.disabled = false; btn.textContent = 'Hire';
+                const failure = result?.data?.hint
+                    ? `${result.error}. ${result.data.hint}`
+                    : (result.error || 'Hire failed.');
+                setFirstRunStatus(failure, 'bad');
+                bus.emit('toast', { msg: failure, kind: 'bad' });
             }
         });
     });

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

@@ -4,6 +4,7 @@
 
 import { S }          from '../state.js';
 import { api, post, bustCache } from '../api.js';
+import { openDrawer } from '../widgets/drawer.js';
 
 const $ = id => document.getElementById(id);
 const esc = s => s==null?'':String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
@@ -179,17 +180,39 @@ async function _ingestCollection(id, name, btn) {
 }
 
 function _showCreateSheet() {
-    const nameInput=$('rag-new-name'); if (!nameInput) return; // needs to be in HTML
-    const name=(nameInput?.value||'').trim();
-    if (!name) { _toast('Collection name is required', 'bad'); return; }
-    post('/api/rag/collections', { name }).then(r => {
-        if (r.ok) {
+    openDrawer({
+        title: 'Create collection',
+        body: `<div class="dsec">
+            <div class="dsec-title">New RAG collection</div>
+            <label class="form-label" for="rag-new-name">Collection name</label>
+            <input id="rag-new-name" class="form-input" type="text" placeholder="${esc(S.workspace?.repoName || 'repo-knowledge')}" autocomplete="off">
+            <button class="btn btn-primary" id="rag-create-confirm" style="margin-top:var(--space-4)">Create collection</button>
+            <div id="rag-create-status" style="margin-top:var(--space-3);font-size:var(--text-sm);color:var(--text-muted)"></div>
+        </div>`,
+    });
+    const submit = async () => {
+        const nameInput = $('rag-new-name');
+        const status = $('rag-create-status');
+        const name = (nameInput?.value || '').trim();
+        if (!name) {
+            if (status) { status.textContent = 'Collection name is required.'; status.style.color = 'var(--bad)'; }
+            return;
+        }
+        if (status) { status.textContent = 'Creating collection…'; status.style.color = 'var(--text-muted)'; }
+        const r = await post('/api/rag/collections', { name }).catch(() => null);
+        if (r?.ok) {
+            if (status) { status.textContent = `Collection "${name}" created.`; status.style.color = 'var(--ok)'; }
             _toast(`Collection "${name}" created.`, 'good');
             bustCache('/api/rag/collections');
             setTimeout(load, 800);
-        } else {
-            _toast(`Create failed: ${r.error}`, 'bad');
+        } else if (status) {
+            status.textContent = `Create failed: ${r?.error ?? 'unknown error'}`;
+            status.style.color = 'var(--bad)';
         }
+    };
+    $('rag-create-confirm')?.addEventListener('click', submit);
+    $('rag-new-name')?.addEventListener('keydown', e => {
+        if (e.key === 'Enter') submit();
     });
 }
 

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

@@ -303,18 +303,18 @@ async function _doSync() {
     if (msg) msg.textContent = 'Syncing…';
     const r = await post('/api/license/sync', {}).catch(() => null);
     if (btn) btn.disabled = false;
-    if (r?.success) {
-        if (msg) { msg.textContent = r.message ?? 'License synced.'; msg.style.color = 'var(--ok)'; }
+    if (r?.ok) {
+        if (msg) { msg.textContent = r.data?.message ?? 'License synced.'; msg.style.color = 'var(--ok)'; }
         setTimeout(load, 1000);
     } else {
-        if (msg) { msg.textContent = r?.message ?? 'Sync failed.'; msg.style.color = 'var(--bad)'; }
+        if (msg) { msg.textContent = r?.error ?? r?.data?.message ?? 'Sync failed.'; msg.style.color = 'var(--bad)'; }
     }
 }
 
 async function _doDeactivate() {
     if (!confirm('Deactivate your license and return to the free tier?')) return;
     const r = await post('/api/license/deactivate', {}).catch(() => null);
-    if (r?.success) setTimeout(load, 500);
+    if (r?.ok) setTimeout(load, 500);
 }
 
 async function _doActivate() {
@@ -327,10 +327,10 @@ async function _doActivate() {
     if (msg) msg.textContent = 'Activating…';
     const r = await post('/api/license/activate', { key }).catch(() => null);
     if (btn) btn.disabled = false;
-    if (r?.success) {
-        if (msg) { msg.textContent = r.message ?? 'Activated!'; msg.style.color = 'var(--ok)'; }
+    if (r?.ok) {
+        if (msg) { msg.textContent = r.data?.message ?? 'Activated!'; msg.style.color = 'var(--ok)'; }
         setTimeout(load, 1200);
     } else {
-        if (msg) { msg.textContent = r?.message ?? 'Activation failed.'; msg.style.color = 'var(--bad)'; }
+        if (msg) { msg.textContent = r?.error ?? r?.data?.message ?? 'Activation failed.'; msg.style.color = 'var(--bad)'; }
     }
 }

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

@@ -11,6 +11,14 @@ import { renderPyramid } from '../widgets/pyramid.js';
 const $ = id => document.getElementById(id);
 const esc = s => s==null?'':String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
 
+function fmtNum(n) {
+    if (n == null || isNaN(n)) return '—';
+    const v = Number(n);
+    if (v >= 1e6) return (v/1e6).toFixed(1)+'M';
+    if (v >= 1000) return (v/1000).toFixed(1)+'K';
+    return String(Math.round(v));
+}
+
 function timeAgo(ts) {
     if (!ts) return '';
     const d=Date.now()-ts;
@@ -43,6 +51,7 @@ export function render() {
     renderPyramidWidget();
     renderFormationRate();
     renderPromotionTicker();
+    renderStats();
     renderGraph();
     renderMemList();
     initSlider();
@@ -87,6 +96,38 @@ function renderPromotionTicker() {
         </div>`).join('');
 }
 
+function renderStats() {
+    const el = $('mem-stats'); if (!el) return;
+    const h = S.memHealth || {};
+    const meta = S.topology?.meta || {};
+    const prov = S.topology?.provenance || {};
+    const rows = [
+        ['Active memories', fmtNum(h.active ?? S.memories.length)],
+        ['Working / episodic / semantic', `${fmtNum(h.working ?? 0)} / ${fmtNum(h.episodic ?? 0)} / ${fmtNum(h.semantic ?? 0)}`],
+        ['Quarantined', fmtNum(h.quarantined ?? 0)],
+        ['Graph nodes / edges', `${fmtNum(S.gNodes.length)} / ${fmtNum(S.gLinks.length)}`],
+        ['Graph source', prov.graphSource || meta.graphSource || 'summary-only'],
+        ['Freshness', prov.freshness || meta.freshness || 'n/a'],
+    ];
+    const topTags = Array.isArray(h.topTags) ? h.topTags.slice(0, 6) : [];
+    el.innerHTML = `
+        <div class="shd" style="margin-bottom:8px">Memory signals</div>
+        ${rows.map(([k, v]) => `<div class="row"><span class="row-k">${esc(k)}</span><span class="row-v">${esc(String(v))}</span></div>`).join('')}
+        <div style="margin-top:12px;font-size:var(--text-sm);color:var(--text-dim)">Top tags</div>
+        <div style="display:flex;gap:6px;flex-wrap:wrap;margin-top:8px">
+            ${topTags.length ? topTags.map(tag => `<span class="chip">${esc(tag)}</span>`).join('') : '<span style="color:var(--text-dim);font-size:var(--text-sm)">No tags yet</span>'}
+        </div>`;
+}
+
+function setGraphFallback(title, subtitle) {
+    const emptyCta = $('graph-empty-cta');
+    if (!emptyCta) return;
+    emptyCta.style.display = 'flex';
+    emptyCta.innerHTML = `
+        <div class="empty-title">${esc(title)}</div>
+        <div class="empty-sub">${esc(subtitle)}</div>`;
+}
+
 /* ── D3 graph ── */
 function buildGraph() {
     S.gNodes=S.memories.map(m=>({
@@ -113,7 +154,7 @@ function buildGraph() {
 }
 
 function renderGraph() {
-    const svg=$('graph-svg'); if (!svg||typeof d3==='undefined') return;
+    const svg=$('graph-svg'); if (!svg) return;
     const c=$('graph-container'), W=c?.clientWidth||640, H=c?.clientHeight||320;
     const cutoff=S.temporalCursor||Date.now();
     const nodes=S.gNodes.filter(n=>(n.createdAt||0)<=cutoff).map(n=>({...n}));
@@ -124,12 +165,21 @@ function renderGraph() {
         return nset.has(s)&&nset.has(t);
     }).map(l=>({...l}));
 
+    if (typeof d3 === 'undefined') {
+        svg.innerHTML = '';
+        setGraphFallback('Graph rendering unavailable', 'D3 did not load. Memory list and time controls still work.');
+        return;
+    }
+
     const d3s=d3.select(svg);
     d3s.selectAll('*').remove();
     d3s.attr('width',W).attr('height',H);
 
+    if (!nodes.length) {
+        setGraphFallback('No memory graph yet', 'Run a few tasks and memories will appear here.');
+        return;
+    }
     const emptyCta=$('graph-empty-cta');
-    if (!nodes.length) { if (emptyCta) emptyCta.style.display='flex'; return; }
     if (emptyCta) emptyCta.style.display='none';
 
     if (S.graphSim) S.graphSim.stop();
@@ -203,8 +253,16 @@ function _memHoverOut(nodeEl, fileEl, linkEl) {
 
 /* ── Temporal slider ── */
 function initSlider() {
-    const slider=$('temporal-slider'); if (!slider||!S.gNodes.length) return;
+    const slider=$('temporal-slider'); if (!slider) return;
+    if (!S.gNodes.length) {
+        slider.disabled = true;
+        const sL=$('slider-start'), nL=$('slider-now');
+        if (sL) sL.textContent = '—';
+        if (nL) nL.textContent = 'Now';
+        return;
+    }
     const minTs=Math.min(...S.gNodes.map(n=>n.createdAt||Date.now())), maxTs=Date.now();
+    slider.disabled = false;
     slider.min=String(minTs); slider.max=String(maxTs); slider.value=String(maxTs);
     S.temporalCursor=maxTs;
     const sL=$('slider-start'), nL=$('slider-now');