nexus-prime 7.9.27 → 7.9.29

package/README.md

@@ -38,9 +38,9 @@
   <a href="https://www.producthunt.com/products/nexus-prime?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-nexus-prime" target="_blank" rel="noopener noreferrer"><img alt="Nexus-Prime — Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1096831&theme=dark&t=1773345508816"></a>
 </div>
 
-> **Coding agents were never built to remember. Nexus Prime gives them a memory.**
+> **Stop restarting your coding agents from zero.**
 >
-> Install once. Every coding agent on your machine gets smarter — together.
+> Nexus Prime gives Claude Code, Codex, Cursor, Windsurf, OpenCode, Aider, and the rest of your local agent stack one shared memory, one proof trail, and one dashboard for what actually happened.
 
 ---
 
@@ -74,14 +74,15 @@ Agents should start with `nexus_session_bootstrap`, then route the raw request t
 
 ---
 
-## Provenance and social proof
+## Why teams install it
 
-Nexus Prime now treats provenance as a product surface, not a footer afterthought.
+Nexus Prime is the local-first control plane for serious AI-assisted coding.
 
-- Every Nexus-enabled PR can carry a **Nexus Prime Presence** block that links back to https://nexus-prime.cfd/ and states whether Nexus observed, verified, assisted, authored, or published the change.
-- Nexus-generated commits use the repo-local Git-native `Co-Authored-By` trailer for the Nexus Prime GitHub identity; human-only commits are not falsely claimed.
-- Generated artifacts can include a Nexus Prime signature with run ID, verification state, human-review state, and website proof.
-- Opt-in telemetry can send privacy-safe PLG events such as `pr_presence_added`, `commit_attributed`, `document_signed`, `release_verified`, and `proof_badge_viewed` to the configured Supabase endpoint. Raw prompts, code, repo names, branch names, file paths, secrets, and tokens are redacted by default.
+- **Shared memory for every agent.** Your tools stop acting like strangers and start carrying useful context across sessions.
+- **Lower token waste.** Nexus routes agents toward the files and facts that matter instead of rereading the repo every turn.
+- **Runtime truth you can inspect.** The dashboard shows runs, memory, token savings, and agent activity instead of hiding the messy parts.
+- **Safer multi-file work.** Planning, verification, and handoff state stay attached to the repo, so interrupted work is easier to resume and review.
+- **Local by default.** Your code and agent memory stay on your machine unless you explicitly opt into something else.
 
 ---
 
@@ -95,7 +96,7 @@ One tracked session was measured at **100,000,000 tokens**. Ninety-nine point fo
 
 This is **agent amnesia** — and it's the quiet tax on every hour you spend with AI-assisted coding.
 
-**Nexus Prime ends it.**
+**Nexus Prime turns that cold start into a remembered workspace.**
 
 ---
 
@@ -458,7 +459,8 @@ Nexus Prime was designed privacy-first, because the code on your machine is your
 |---------|-------------------|
 | 💬 [**Discord**](https://discord.gg/tByGZgk5gS) | Real-time help, show-and-tell, feature ideas |
 | 🔴 [**Reddit — r/Nexus_Prime**](https://www.reddit.com/r/Nexus_Prime/) | Long-form posts, releases, community wins |
-| 🐦 [**X / Twitter**](https://x.com/nexusprime_ai) | Launch announcements, tips, updates |
+| 🐦 [**X / Twitter**](https://x.com/getnexusprime) | Launch announcements, tips, updates |
+| 📸 [**Instagram**](https://www.instagram.com/nexus_prime.cfd/) | Product clips, launch updates, behind-the-scenes |
 | 📧 [**adarsh@nexus-prime.cfd**](mailto:adarsh@nexus-prime.cfd) | License requests, upgrades, pilots, enterprise |
 | 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | General support, press, community |
 | 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) | Product site, demos, pricing, setup guides |

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

@@ -238,7 +238,7 @@ export function buildMcpToolDefinitions() {
                 properties: {
                     goal: { type: 'string', description: 'Raw goal or task description for this session' },
                     files: { type: 'array', items: { type: 'string' }, description: 'Optional candidate file constraints' },
-                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug'], description: 'Response verbosity; defaults to compact for MCP callers' },
+                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug', 'full'], description: 'Response verbosity; defaults to compact for MCP callers' },
                     depth: { type: 'string', enum: ['fast', 'deep'], description: 'Optional bootstrap depth override; defaults to fast unless debug mode is requested' },
                     include: { type: 'array', items: { type: 'string' }, description: 'Optional rich payload sections to include for advanced clients' },
                     intent: { type: 'string', enum: ['inspect', 'plan', 'mutate'], description: 'Requested orchestration stance for the bootstrap summary' },
@@ -268,7 +268,7 @@ export function buildMcpToolDefinitions() {
                 properties: {
                     prompt: { type: 'string', description: 'Raw prompt or objective to orchestrate end-to-end' },
                     files: { type: 'array', items: { type: 'string' }, description: 'Optional hard constraints for candidate files' },
-                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug'], description: 'Response verbosity; defaults to compact for MCP callers' },
+                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug', 'full'], description: 'Response verbosity; defaults to compact for MCP callers' },
                     intent: { type: 'string', enum: ['inspect', 'plan', 'mutate'], description: 'Requested orchestration stance; inspect/plan should stay read-only' },
                     topology: { type: 'string', enum: ['auto', 'manager-tools', 'handoff', 'dag-pool', 'worktree-swarm'], description: 'Requested orchestration topology hint' },
                     workers: { type: 'number', description: 'Optional worker override' },
@@ -282,6 +282,7 @@ export function buildMcpToolDefinitions() {
                     executionPreset: { type: 'string', enum: ['fast', 'balanced', 'deep', 'release'], description: 'Optional execution preset that maps orchestration depth, verification strictness, and backend routing' },
                     background: { type: 'boolean', description: 'Compatibility flag; nexus_orchestrate already returns a queued hiring preflight by default and continues in the async gate.' },
                     async: { type: 'boolean', description: 'Alias for background; useful for clients that prefer explicit async orchestration.' },
+                    wait: { type: 'boolean', description: 'Alias for inline/sync execution. Waits up to the MCP-safe bounded window and returns the final result when it completes in time.' },
                     waitMs: { type: 'number', description: 'Advanced/debug bounded wait for inline execution. Clamped to 45 seconds; normal orchestrate calls return a queued preflight immediately.' },
                     inline: { type: 'boolean', description: 'Advanced/debug only: wait for inline orchestrate output instead of the default fast queued preflight.' }
                 },

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

@@ -101,7 +101,10 @@ function shouldReturnQueuedReceipt(toolName, args) {
     if (!SLOW_TOOLS.has(toolName))
         return false;
     if (toolName === 'nexus_orchestrate') {
-        return !isTruthyFlag(args.inline) && !isTruthyFlag(args.sync) && !isTruthyFlag(args.blocking);
+        return !isTruthyFlag(args.inline)
+            && !isTruthyFlag(args.sync)
+            && !isTruthyFlag(args.blocking)
+            && !isTruthyFlag(args.wait);
     }
     return isTruthyFlag(args.background)
         || isTruthyFlag(args.async)
@@ -109,8 +112,13 @@ function shouldReturnQueuedReceipt(toolName, args) {
         || isTruthyFlag(args.detach);
 }
 function resolveMaxSyncMs(toolName, args) {
+    const explicitWait = isTruthyFlag(args.wait)
+        || isTruthyFlag(args.inline)
+        || isTruthyFlag(args.sync)
+        || isTruthyFlag(args.blocking);
     return coerceBoundedWaitMs(args.waitMs)
         ?? coerceBoundedWaitMs(args.maxSyncMs)
+        ?? (toolName === 'nexus_orchestrate' && explicitWait ? MAX_CLIENT_SYNC_WAIT_MS : undefined)
         ?? (toolName === 'nexus_orchestrate' ? ORCHESTRATE_DEFAULT_MAX_SYNC_MS : DEFAULT_MAX_SYNC_MS);
 }
 function asStringList(value) {

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

@@ -22,6 +22,8 @@ function renderTable(rows, maxRows = 20) {
 }
 /** Build a compact timing + savings footer line for tool responses. */
 function buildMcpFooter(meta) {
+    if (process.env.NEXUS_MCP_RESPONSE_FOOTER !== '1')
+        return '';
     const ms = meta.durationMs;
     const timing = ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s`;
     return `\n\n─── nexus-prime · ${meta.toolName} · ${timing} · dashboard: http://localhost:${DASH_PORT}/#runtime ───`;

package/dist/agents/adapters/mcp/handlers/orchestration.js

@@ -275,7 +275,8 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
             const timings = {
                 totalMs: Date.now() - callStartedAt,
             };
-            const payload = detailLevel === 'debug'
+            const fullBootstrapDetails = detailLevel === 'debug' || detailLevel === 'full';
+            const payload = fullBootstrapDetails
                 ? {
                     depth: bootstrap.depth,
                     workspace,
@@ -390,7 +391,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                         return '';
                                     }
                                 })(),
-                                ...(detailLevel === 'debug' ? [
+                                ...(fullBootstrapDetails ? [
                                     `Bootstrap depth: ${bootstrap.depth || bootstrapDepth}`,
                                     `Execution mode: ${bootstrap.recommendedExecutionMode || 'autonomous'}`,
                                     `Shortlist: ${bootstrap.shortlist?.skills?.slice(0, 3).join(', ') || 'none'} (skills), ${bootstrap.shortlist?.specialists?.slice(0, 3).join(', ') || 'none'} (specialists)`,
@@ -410,7 +411,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                     `Bootstrap status: ${bootstrap.clientBootstrapStatus?.clients?.length || 0} client manifests tracked`,
                                 ] : []),
                             ]),
-                            detailLevel === 'debug' && bootstrap.tokenOptimization?.autoApplied && bootstrap.tokenOptimization?.plan
+                            fullBootstrapDetails && bootstrap.tokenOptimization?.autoApplied && bootstrap.tokenOptimization?.plan
                                 ? `Auto token plan\n\`\`\`txt\n${bootstrap.tokenOptimization.plan}\n\`\`\``
                                 : '',
                             formatJsonDetails('Structured details', payload),
@@ -547,7 +548,36 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                     intent: requestedIntent,
                     topology: requestedTopology,
                 };
+                const verboseDetails = detailLevel === 'debug' || detailLevel === 'full';
                 const compactPayload = {
+                    workspace,
+                    runId: execution.runId,
+                    state: execution.state,
+                    summary: summarizeExecution(execution),
+                    resultPreview: truncateText(execution.result || summarizeExecution(execution), 700),
+                    artifactsPath: execution.artifactsPath,
+                    planner: execution.plannerState
+                        ? {
+                            selectedCrew: execution.plannerState.selectedCrew?.name,
+                            selectedSpecialists: execution.plannerState.selectedSpecialists.slice(0, 4).map((specialist) => specialist.name),
+                            selectedWorkflows: execution.plannerState.selectedWorkflows.slice(0, 4),
+                        }
+                        : undefined,
+                    worktreeHealth: runtimeUsage.worktreeHealth
+                        ? {
+                            repoRoot: runtimeUsage.worktreeHealth.repoRoot,
+                            overall: runtimeUsage.worktreeHealth.overall,
+                            brokenEntries: runtimeUsage.worktreeHealth.brokenEntries,
+                            repairedEntries: runtimeUsage.worktreeHealth.repairedEntries,
+                            issues: runtimeUsage.worktreeHealth.issues,
+                        }
+                        : undefined,
+                    modelRoute: selectionSummary.modelRoute,
+                    verifiedWorkers,
+                    continuationChildren: execution.continuationChildren.length,
+                    timings,
+                };
+                const standardPayload = {
                     workspace,
                     runId: execution.runId,
                     state: execution.state,
@@ -616,31 +646,43 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                     timings,
                     payloadRef,
                 };
-                const payload = detailLevel === 'debug' ? debugPayload : compactPayload;
+                const payload = verboseDetails
+                    ? debugPayload
+                    : detailLevel === 'standard'
+                        ? standardPayload
+                        : compactPayload;
+                const verboseResponse = detailLevel !== 'compact';
+                const stateLine = execution.state === 'inspected'
+                    ? 'Orchestrated run inspected (read-only advisory; no diff expected).'
+                    : `Orchestrated run ${execution.state}.`;
                 return {
                     content: [{
                             type: 'text',
                             text: [
                                 upfrontTokenNote ? `[Token plan] ${upfrontTokenNote}` : '',
-                                `Orchestrated run ${execution.state}.`,
+                                stateLine,
                                 formatBullets([
                                     `Workspace: ${workspace.repoName} (${workspace.workspaceSource})`,
                                     `Run ID: ${execution.runId}`,
                                     `Summary: ${summarizeExecution(execution)}`,
                                     `Crew: ${execution.plannerState?.selectedCrew?.name || 'baseline path'}`,
-                                    `Decomposition: ${selectionSummary.phaseCount} phase(s), ${selectionSummary.workerLaneCount} worker lane(s), ${selectionSummary.mode}`,
                                     `Hired/selected: crew ${selectionSummary.crew}; specialists ${formatSelectionList(selectionSummary.specialists)}; workflows ${formatSelectionList(selectionSummary.workflows)}; skills ${formatSelectionList(selectionSummary.skills)}`,
-                                    `Model route: ${formatModelRoute(selectionSummary.modelRoute)}`,
-                                    `Budget route: ${selectionSummary.budgetRoute || 'budget pending'}`,
-                                    selectionSummary.agentFlow?.stages?.length
-                                        ? `AgentFlow gates: ${selectionSummary.agentFlow.stages.map((stage) => `${stage.stage}:${stage.ownerRole}`).join(' -> ')}`
-                                        : null,
-                                    `Selection audit: ${selectionSummary.auditSelected} selected, ${selectionSummary.auditRejected} rejected`,
+                                    ...(verboseResponse ? [
+                                        `Decomposition: ${selectionSummary.phaseCount} phase(s), ${selectionSummary.workerLaneCount} worker lane(s), ${selectionSummary.mode}`,
+                                        `Model route: ${formatModelRoute(selectionSummary.modelRoute)}`,
+                                        `Budget route: ${selectionSummary.budgetRoute || 'budget pending'}`,
+                                        selectionSummary.agentFlow?.stages?.length
+                                            ? `AgentFlow gates: ${selectionSummary.agentFlow.stages.map((stage) => `${stage.stage}:${stage.ownerRole}`).join(' -> ')}`
+                                            : null,
+                                        `Selection audit: ${selectionSummary.auditSelected} selected, ${selectionSummary.auditRejected} rejected`,
+                                    ] : [
+                                        `Model route: ${formatModelRoute(selectionSummary.modelRoute)}`,
+                                    ]),
                                     `Verification: ${verifiedWorkers}/${execution.workerResults.length} worker(s) verified`,
-                                    `Tokens: saved ${Number(execution.tokenTelemetry?.savedTokens || 0).toLocaleString()} · compression ${Number(execution.tokenTelemetry?.compressionPct || 0)}%`,
+                                    verboseResponse ? `Tokens: saved ${Number(execution.tokenTelemetry?.savedTokens || 0).toLocaleString()} · compression ${Number(execution.tokenTelemetry?.compressionPct || 0)}%` : null,
                                     autoTokenApplyNote || null,
-                                    `Payload ref: ${workspace.stateKey} · ${detailLevel}`,
-                                    ...(detailLevel === 'debug' ? [
+                                    verboseResponse ? `Payload ref: ${workspace.stateKey} · ${detailLevel}` : null,
+                                    ...(verboseDetails ? [
                                         `Specialists: ${execution.plannerState?.selectedSpecialists.map((specialist) => specialist.name).slice(0, 4).join(', ') || 'none selected'}`,
                                         `Assets: ${(execution.activeSkills || []).length} skills · ${(execution.activeWorkflows || []).length} workflows · ${(runtimeUsage.artifactSelectionAudit?.selected?.length || 0)} audited selections`,
                                         `Task graph: ${runtimeUsage.taskGraph?.phases?.length || execution.taskGraph?.phases?.length || 0} phases · ${runtimeUsage.workerPlan?.totalWorkers || execution.workerPlan?.totalWorkers || 0} workers`,
@@ -652,9 +694,9 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                         `Payload ref: ${workspace.stateKey} · ${detailLevel}`,
                                     ] : []),
                                 ]),
-                                detailLevel === 'debug' && execution.result ? `Result\n\`\`\`\n${execution.result}\n\`\`\`` : `Result preview\n\`\`\`\n${truncateText(execution.result || summarizeExecution(execution), 900)}\n\`\`\``,
+                                verboseDetails && execution.result ? `Result\n\`\`\`\n${execution.result}\n\`\`\`` : `Result preview\n\`\`\`\n${truncateText(execution.result || summarizeExecution(execution), 900)}\n\`\`\``,
                                 formatJsonDetails('Structured details', payload),
-                                hctx.formatRemainingProtocolSteps(),
+                                verboseResponse ? hctx.formatRemainingProtocolSteps() : '',
                             ].filter(Boolean).join('\n\n'),
                         }],
                 };
@@ -684,7 +726,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                     runtimeUsage?.skipReasons?.length ? `Skipped stages: ${runtimeUsage.skipReasons.join(' · ')}` : 'Skipped stages: not recorded',
                                 ]),
                                 formatJsonDetails('Structured details', payload),
-                                hctx.formatRemainingProtocolSteps(),
+                                detailLevel !== 'compact' ? hctx.formatRemainingProtocolSteps() : '',
                             ].join('\n\n'),
                         }],
                 };

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

@@ -90,7 +90,7 @@ export function formatJsonDetails(label, value) {
 }
 export function normalizeDetailLevel(value) {
     const normalized = String(value ?? 'compact').toLowerCase();
-    if (normalized === 'standard' || normalized === 'debug')
+    if (normalized === 'standard' || normalized === 'debug' || normalized === 'full')
         return normalized;
     return 'compact';
 }
@@ -100,7 +100,7 @@ export function normalizeBootstrapDepth(value, detailLevel) {
         return 'deep';
     if (normalized === 'fast')
         return 'fast';
-    return detailLevel === 'debug' ? 'deep' : 'fast';
+    return detailLevel === 'debug' || detailLevel === 'full' ? 'deep' : 'fast';
 }
 export function normalizeResponseIntent(value) {
     const normalized = String(value ?? 'inspect').toLowerCase();

package/dist/agents/adapters/mcp/types.d.ts

@@ -14,7 +14,7 @@ import type { SessionDNAManager } from '../../../engines/session-dna.js';
 import type { NgramIndex } from '../../../engines/ngram-index.js';
 export type McpToolProfile = 'autonomous' | 'full';
 export type LifecyclePhase = 'pre-bootstrap' | 'bootstrapped' | 'orchestrated' | 'working' | 'closing';
-export type ResponseDetailLevel = 'compact' | 'standard' | 'debug';
+export type ResponseDetailLevel = 'compact' | 'standard' | 'debug' | 'full';
 export type ResponseIntent = 'inspect' | 'plan' | 'mutate';
 export type ResponseTopology = 'auto' | 'manager-tools' | 'handoff' | 'dag-pool' | 'worktree-swarm';
 /** Session-level telemetry tracker. Moved to types.ts so handler files can

package/dist/dashboard/app/api.js

@@ -8,6 +8,18 @@
 import { CACHE_TTL, S, bus } from './state.js';
 
 const _cache = new Map();
+const DEFAULT_TIMEOUT_MS = 5_000;
+
+function _timeoutFor(url, override) {
+    if (Number.isFinite(Number(override))) return Number(override);
+    if (url.includes('/api/tokens/')) return 1_800;
+    if (url.includes('/api/license')) return 2_500;
+    if (url.includes('/api/runtimes')) return 3_000;
+    if (url.includes('/api/dashboard/surface/')) return 4_000;
+    if (url.includes('/api/dashboard/summary')) return 4_500;
+    if (url.includes('/api/knowledge-topology')) return 7_000;
+    return DEFAULT_TIMEOUT_MS;
+}
 
 function _scopedUrl(url) {
     if (typeof url !== 'string' || !url.startsWith('/api/')) return url;
@@ -27,32 +39,39 @@ function _scopedUrl(url) {
  * then kick off a background refresh.  Callers get the fast synchronous hit
  * for p50 <5ms; the next render cycle gets the fresh value.
  */
-export async function api(url, ttl = CACHE_TTL) {
+export async function api(url, ttl = CACHE_TTL, opts = {}) {
     const requestUrl = _scopedUrl(url);
     const hit = _cache.get(requestUrl);
     const fresh = !hit || (Date.now() - hit.ts >= ttl);
 
-    // Return stale data synchronously while refresh fires in background.
-    const refreshPromise = fresh ? _fetch(requestUrl) : Promise.resolve(hit.data);
-
-    if (hit && !fresh) {
-        // Background refresh — don't await, just schedule.
-        _fetch(requestUrl).catch(() => {});
+    if (hit) {
+        if (fresh) {
+            _fetch(requestUrl, opts).catch(() => {});
+            bus.emit('api:stale', { url: requestUrl, ageMs: Date.now() - hit.ts });
+        } else {
+            _fetch(requestUrl, opts).catch(() => {});
+        }
+        return hit.data;
     }
 
-    return refreshPromise;
+    return _fetch(requestUrl, opts);
 }
 
-async function _fetch(url) {
+async function _fetch(url, opts = {}) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), _timeoutFor(url, opts.timeoutMs));
     try {
-        const r = await fetch(url);
+        const r = await fetch(url, { signal: controller.signal });
         if (!r.ok) return null;
         const d = await r.json();
         _cache.set(url, { data: d, ts: Date.now() });
         bus.emit('cache:updated', url);
         return d;
-    } catch {
+    } catch (err) {
+        bus.emit('api:timeout', { url, error: err?.name === 'AbortError' ? 'timeout' : String(err?.message || err) });
         return null;
+    } finally {
+        clearTimeout(timeout);
     }
 }
 

package/dist/dashboard/app/index.html

@@ -12,6 +12,7 @@
 <link rel="stylesheet" href="./styles/workforce.css">
 <link rel="stylesheet" href="./styles/memory.css">
 <link rel="stylesheet" href="./styles/context-log.css">
+<link rel="stylesheet" href="./styles/learning.css">
 <link rel="stylesheet" href="./styles/governance.css">
 <link rel="stylesheet" href="./styles/trust.css">
 <link rel="stylesheet" href="./styles/animation.css">
@@ -56,6 +57,7 @@ if(location.protocol==='file:'){
       <a class="nav-item" data-nav="runtime" href="#runtime">⚡ Runtime</a>
       <a class="nav-item" data-nav="workforce" href="#workforce">Workforce</a>
       <a class="nav-item" data-nav="memory" href="#memory">Memory</a>
+      <a class="nav-item" data-nav="learning" href="#learning">Learning</a>
       <a class="nav-item" data-nav="context-log" href="#context-log">Context Log</a>
       <a class="nav-item" data-nav="repo" href="#repo">Repo</a>
       <a class="nav-item" data-nav="knowledge" href="#knowledge">Knowledge</a>
@@ -111,6 +113,8 @@ if(location.protocol==='file:'){
           <div class="hero-stat"><div class="metric-val" id="m-ops">—</div><div class="metric-lbl">Operatives</div><canvas id="spark-ops" class="sparkline" width="80" height="24" aria-hidden="true"></canvas></div>
         </div>
 
+        <div id="model-router-panel" class="model-router-panel card" aria-label="Model and context router"></div>
+
         <!-- Live strip + kanban -->
         <div id="agents-live-strip"></div>
         <div id="kanban-board">
@@ -189,6 +193,7 @@ if(location.protocol==='file:'){
 
         <div class="memory-toolbar">
           <button class="btn btn-sm" id="mem-graph-max-btn">Maximize graph</button>
+          <button class="btn btn-sm" id="mem-graph-focus-btn">Focus selected</button>
           <button class="btn btn-sm" id="mem-browse-btn">Browse memories</button>
         </div>
         <div id="graph-container" class="card">
@@ -228,13 +233,33 @@ if(location.protocol==='file:'){
         <div id="context-log-view"></div>
       </section>
 
+      <!-- LEARNING ───────────────────────────────────────────────── -->
+      <section class="view-panel" data-view="learning" aria-label="Learning network">
+        <div id="learning-view"></div>
+      </section>
+
       <!-- REPO ───────────────────────────────────────────────────── -->
       <section class="view-panel" data-view="repo" aria-label="Repo graph">
         <div class="shd">Repo knowledge graph</div>
-        <div id="repo-graph-header" style="display:flex;align-items:center;gap:12px;padding:0 2px 10px;font-size:var(--text-sm);color:var(--text-muted)">
+        <div id="repo-graph-header" class="repo-graph-header">
           <span id="repo-graph-meta">—</span>
-          <button id="repo-build-btn" class="btn btn-sm" style="margin-left:auto">Build graph</button>
-          <input id="repo-search-input" type="text" placeholder="Search nodes…" style="padding:3px 8px;border:1px solid var(--border);border-radius:4px;background:var(--surface-1);color:var(--text);font-size:var(--text-sm);width:180px" autocomplete="off">
+          <div class="repo-graph-actions">
+            <button id="repo-build-btn" class="btn btn-sm">Build graph</button>
+            <button id="repo-memory-focus-btn" class="btn btn-sm">Memory overlay</button>
+            <input id="repo-search-input" class="repo-graph-search" type="text" placeholder="Search nodes…" autocomplete="off">
+            <div class="repo-graph-controls" aria-label="Repo graph navigation controls">
+              <button id="repo-zoom-out-btn" class="repo-graph-control" title="Zoom out">-</button>
+              <button id="repo-zoom-in-btn" class="repo-graph-control" title="Zoom in">+</button>
+              <button id="repo-fit-btn" class="repo-graph-control repo-graph-control-wide" title="Fit graph">Fit</button>
+              <button id="repo-reset-btn" class="repo-graph-control repo-graph-control-wide" title="Reset view">Reset</button>
+              <button id="repo-pan-left-btn" class="repo-graph-control" title="Pan left">&lt;</button>
+              <button id="repo-pan-right-btn" class="repo-graph-control" title="Pan right">&gt;</button>
+              <button id="repo-pan-up-btn" class="repo-graph-control" title="Pan up">^</button>
+              <button id="repo-pan-down-btn" class="repo-graph-control" title="Pan down">v</button>
+              <button id="repo-graph-max-btn" class="repo-graph-control repo-graph-control-wide" title="Maximize graph">Max</button>
+              <span id="repo-viewport-badge" class="repo-viewport-badge">100%</span>
+            </div>
+          </div>
         </div>
         <div class="card" style="position:relative;overflow:hidden">
           <div id="repo-graph-container" style="width:100%;height:480px;position:relative">

package/dist/dashboard/app/main.js

@@ -15,6 +15,7 @@ import { init as initCmdBar }     from './widgets/command-bar.js';
 import * as Board                 from './views/board.js';
 import * as Workforce             from './views/workforce.js';
 import * as Memory                from './views/memory.js';
+import * as Learning              from './views/learning.js';
 import * as ContextLog            from './views/context-log.js';
 import * as Knowledge             from './views/knowledge.js';
 import * as Repo                  from './views/repo.js';
@@ -54,6 +55,7 @@ navRegister('board',      Board.load);
 navRegister('runtime',    Runtime.load);
 navRegister('workforce',  Workforce.load);
 navRegister('memory',     Memory.load);
+navRegister('learning',   Learning.load);
 navRegister('context-log', ContextLog.load);
 navRegister('repo',       Repo.load);
 navRegister('knowledge',  Knowledge.load);
@@ -89,6 +91,10 @@ setOnEvent(evt => {
     if (tab === 'memory' && evt.category === 'memory') {
         _refreshMemorySoon();
     }
+    if (tab === 'learning' && (evt.category === 'memory' || String(evt.type||'').startsWith('orchestration.'))) {
+        bustCache('/api/learning/packets?limit=24');
+        Learning.load();
+    }
     if (tab === 'governance' && evt.category === 'darwin') {
         Governance.load();
     }
@@ -123,6 +129,9 @@ setOnEvent(evt => {
         if (tab === 'context-log') {
             ContextLog.load();
         }
+        if (tab === 'learning') {
+            Learning.load();
+        }
     }
     // Workspace root promoted (e.g. from bootstrap hint) — refresh header immediately.
     if (String(evt.type||'') === 'workspace.changed') {
@@ -184,8 +193,9 @@ async function loadProjects() {
     ]);
     S.projects = Array.isArray(projectsD) ? projectsD : (projectsD?.projects||[]);
     S.runtimes = Array.isArray(runtimesD) ? runtimesD : (runtimesD?.runtimes||[]);
-    _selectDefaultRuntime();
+    const scopeChanged = _selectDefaultRuntime();
     _renderProjectSelectors();
+    return scopeChanged;
 }
 
 async function loadCompanies() {
@@ -210,7 +220,7 @@ function _renderProjectSelectors() {
 }
 
 function _selectDefaultRuntime() {
-    if (S.scope.runtimeId || !(S.runtimes||[]).length) return;
+    if (S.scope.runtimeId || !(S.runtimes||[]).length) return false;
     const current = S.workspace?.repoRoot || S.workspace?.workspaceRoot || '';
     const candidates = (S.runtimes||[]).filter(r => r?.runtimeId);
     const exact = current ? candidates.find(r => r.repoIdentity?.repoRoot === current) : null;
@@ -228,7 +238,10 @@ function _selectDefaultRuntime() {
         return root && root !== '/';
     });
     const selected = (exact && !currentLooksLikeHome ? exact : null) || remoteRepo || deepestRepo || candidates[0];
-    S.scope.runtimeId = selected?.runtimeId || null;
+    const nextRuntimeId = selected?.runtimeId || null;
+    const changed = nextRuntimeId !== S.scope.runtimeId;
+    S.scope.runtimeId = nextRuntimeId;
+    return changed;
 }
 
 /* ─────────────────── Header / ticker ─────────────────── */
@@ -344,29 +357,30 @@ async function bootstrap() {
     _renderHeader(false);
 
     await loadWorkspace();
-    await loadProjects();
-
-    // Fast first paint: board + companies + repo-tree + license
-    const [, , , lic] = await Promise.all([
-        Board.load(),
-        loadCompanies(),
-        loadRepoTree(),
-        api('/api/license', 60000),
-    ]);
-    S.license = lic;
-
-    // Populate agent selector
-    const agentSel = $('ctx-agent');
-    if (agentSel && S.synapseHealth.length) {
-        agentSel.innerHTML = '<option value="">All agents</option>' +
-            S.synapseHealth.map(o=>`<option value="${esc(o.id||o.operativeId)}">${esc(o.role||o.name||o.id||'agent')}</option>`).join('');
+    const scopeChanged = await loadProjects();
+    if (scopeChanged) {
+        bustCache('/api/workspace');
+        bustCache('/api/repo-tree');
+        await loadWorkspace();
     }
 
-    // Wire router after first paint
+    // Wire router before slow side panels. Each view owns progressive loading.
     routerStart();
 
     // Connect SSE stream — SSE drives all live updates; no polling needed.
     connectSSE();
+
+    Promise.allSettled([
+        loadCompanies(),
+        loadRepoTree(),
+        api('/api/license', 60000, { timeoutMs: 2500 }).then(lic => { S.license = lic; }),
+    ]).then(() => {
+        const agentSel = $('ctx-agent');
+        if (agentSel && S.synapseHealth.length) {
+            agentSel.innerHTML = '<option value="">All agents</option>' +
+                S.synapseHealth.map(o=>`<option value="${esc(o.id||o.operativeId)}">${esc(o.role||o.name||o.id||'agent')}</option>`).join('');
+        }
+    });
 }
 
 // Start when DOM is ready

package/dist/dashboard/app/state.js

@@ -86,6 +86,10 @@ export const S = {
     contextLogRuns: [],
     contextLogSelectedRunId: null,
     contextLogSpine: null,
+    contextLogLearning: null,
+    learningSurface: null,
+    learningGraph: null,
+    learningSelectedPacketId: null,
 
     // Neural Stream HUD ring buffer (latest SSE events, restored from v3.8.0)
     neuralStream: [],