nexus-prime 7.9.3 → 7.9.5

package/dist/dashboard/app/widgets/runtime-badge.js

@@ -1,7 +1,7 @@
 /**
  * runtime-badge.js — Push-mode runtime availability badges.
  *
- * Fetches GET /api/runtimes and renders one pill per invoker in the
+ * Fetches GET /api/invokers and renders one pill per invoker in the
  * sidebar footer showing amber (unavailable) or green (available) status.
  *
  * Mounts into #runtime-badges (created by index.html in the sidebar foot).
@@ -21,7 +21,7 @@ export async function refresh() {
     const container = $('runtime-badges');
     if (!container) return;
 
-    const runtimes = await api('/api/runtimes', 8_000);
+    const runtimes = await api('/api/invokers', 8_000);
     if (!Array.isArray(runtimes)) return;
 
     container.innerHTML = runtimes.map(r => _badge(r)).join('');

package/dist/dashboard/routes/runtime.js

@@ -215,7 +215,7 @@ export const handleRuntimeRoutes = async (ctx, req, res, url) => {
         return true;
     }
     // ── Push-mode dispatch ────────────────────────────────────────────────────
-    if (req.method === 'GET' && url.pathname === '/api/runtimes') {
+    if (req.method === 'GET' && url.pathname === '/api/invokers') {
         const availability = await invokerRegistry.listAvailability();
         ctx.respondJson(res, availability);
         return true;

package/dist/dashboard/server.js

@@ -81,6 +81,20 @@ function stringifyDashboardJson(data) {
         return value;
     }, DASHBOARD_PRETTY_JSON ? 2 : 0);
 }
+function resolveDashboardAppFile(relativePath) {
+    const roots = [
+        path.join(__dirname, 'app'),
+        path.resolve(__dirname, '..', '..', 'src', 'dashboard', 'app'),
+    ];
+    for (const root of roots) {
+        const resolved = path.resolve(root, relativePath);
+        if (resolved !== root && !resolved.startsWith(root + path.sep))
+            continue;
+        if (fs.existsSync(resolved))
+            return resolved;
+    }
+    return null;
+}
 export class DashboardServer {
     server;
     runtimeProvider;
@@ -485,7 +499,12 @@ export class DashboardServer {
             'X-Content-Type-Options': 'nosniff',
             'X-Frame-Options': 'DENY',
         };
-        const htmlPath = path.join(__dirname, 'app', 'index.html');
+        const htmlPath = resolveDashboardAppFile('index.html');
+        if (!htmlPath) {
+            res.writeHead(500);
+            res.end('Error loading LATTICE dashboard HTML: missing app/index.html');
+            return;
+        }
         fs.readFile(htmlPath, 'utf8', (err, data) => {
             if (err) {
                 res.writeHead(500);
@@ -514,7 +533,12 @@ export class DashboardServer {
             res.end('Bad request');
             return;
         }
-        const filePath = path.join(__dirname, 'app', rel);
+        const filePath = resolveDashboardAppFile(rel);
+        if (!filePath) {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+        }
         const ext = path.extname(filePath).toLowerCase();
         const ct = EXT_TYPES[ext] ?? 'application/octet-stream';
         fs.readFile(filePath, (err, data) => {

package/dist/engines/code-review-graph-client.d.ts

@@ -4,21 +4,30 @@
  * Connects via Stdio transport to the configured cr-graph binary.
  * Binary discovery order:
  *   1. NEXUS_CRG_BIN env var
- *   2. ~/.nexus-prime/cr-graph.json  { "bin": "/path/to/binary", "args": [...] }
+ *   2. <repo>/.mcp.json code-review-graph entry
+ *   3. ~/.nexus-prime/cr-graph.json  { "bin": "/path/to/binary", "args": [...] }
  *
  * Failure mode: when the binary is not found or the process fails to start,
  * the client returns `available = false` and all methods return empty results.
  * The orchestrator falls back to the n-gram index. No regression.
  */
+interface CrGraphConfig {
+    bin: string;
+    args?: string[];
+    cwd?: string;
+}
+export declare function discoverCrGraphConfig(repoRoot?: string): CrGraphConfig | null;
 export declare class CodeReviewGraphClient {
     private client;
     private transport;
     private _available;
     private _initialized;
+    private initPromise;
     private repoRoot;
     constructor(repoRoot: string);
     get available(): boolean;
     init(): Promise<void>;
+    private initialize;
     /**
      * Search for file nodes relevant to a task description.
      * Returns absolute file paths, clamped to `limit`.
@@ -44,3 +53,4 @@ export declare class CodeReviewGraphClient {
  *   orchestrator falls back to the n-gram index if unavailable.
  */
 export declare function ensureCrGraphBuilt(repoRoot: string): Promise<void>;
+export {};

package/dist/engines/code-review-graph-client.js

@@ -4,7 +4,8 @@
  * Connects via Stdio transport to the configured cr-graph binary.
  * Binary discovery order:
  *   1. NEXUS_CRG_BIN env var
- *   2. ~/.nexus-prime/cr-graph.json  { "bin": "/path/to/binary", "args": [...] }
+ *   2. <repo>/.mcp.json code-review-graph entry
+ *   3. ~/.nexus-prime/cr-graph.json  { "bin": "/path/to/binary", "args": [...] }
  *
  * Failure mode: when the binary is not found or the process fails to start,
  * the client returns `available = false` and all methods return empty results.
@@ -18,13 +19,18 @@ import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'
 import { nexusEventBus } from './event-bus.js';
 const MIN_CRG_CANDIDATES = 5;
 const REQUEST_TIMEOUT_MS = 4_000;
-function discoverCrGraphConfig() {
+const INIT_TIMEOUT_MS = 4_000;
+export function discoverCrGraphConfig(repoRoot) {
     // 1. Env var
     const envBin = process.env['NEXUS_CRG_BIN'];
     if (envBin) {
         return { bin: envBin, args: [] };
     }
-    // 2. ~/.nexus-prime/cr-graph.json
+    // 2. Repo-local MCP config.
+    const repoMcpConfig = repoRoot ? readMcpCrGraphConfig(path.join(repoRoot, '.mcp.json'), repoRoot) : null;
+    if (repoMcpConfig)
+        return repoMcpConfig;
+    // 3. ~/.nexus-prime/cr-graph.json
     try {
         const configPath = path.join(os.homedir(), '.nexus-prime', 'cr-graph.json');
         const raw = fs.readFileSync(configPath, 'utf8');
@@ -42,11 +48,37 @@ function discoverCrGraphConfig() {
     }
     return null;
 }
+function readMcpCrGraphConfig(configPath, repoRoot) {
+    try {
+        const raw = fs.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const servers = parsed['mcpServers'];
+        if (!servers || typeof servers !== 'object' || Array.isArray(servers))
+            return null;
+        const server = servers['code-review-graph'];
+        if (!server || typeof server !== 'object' || Array.isArray(server))
+            return null;
+        const record = server;
+        if (typeof record['command'] !== 'string' || !record['command'])
+            return null;
+        return {
+            bin: record['command'],
+            args: Array.isArray(record['args'])
+                ? record['args'].filter((arg) => typeof arg === 'string')
+                : [],
+            cwd: repoRoot,
+        };
+    }
+    catch {
+        return null;
+    }
+}
 export class CodeReviewGraphClient {
     client = null;
     transport = null;
     _available = false;
     _initialized = false;
+    initPromise = null;
     repoRoot;
     constructor(repoRoot) {
         this.repoRoot = repoRoot;
@@ -55,10 +87,18 @@ export class CodeReviewGraphClient {
         return this._available;
     }
     async init() {
+        if (this.initPromise)
+            return this.initPromise;
         if (this._initialized)
             return;
+        this.initPromise = this.initialize().finally(() => {
+            this.initPromise = null;
+        });
+        return this.initPromise;
+    }
+    async initialize() {
         this._initialized = true;
-        const config = discoverCrGraphConfig();
+        const config = discoverCrGraphConfig(this.repoRoot);
         if (!config)
             return;
         try {
@@ -69,11 +109,18 @@ export class CodeReviewGraphClient {
                 stderr: 'ignore',
             });
             this.client = new Client({ name: 'nexus-prime', version: '1.0.0' }, { capabilities: {} });
-            await this.client.connect(this.transport);
+            await Promise.race([
+                this.client.connect(this.transport),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('cr-graph init timeout')), INIT_TIMEOUT_MS)),
+            ]);
             this._available = true;
         }
         catch {
             // binary not found or failed to start — degrade gracefully
+            try {
+                await this.transport?.close();
+            }
+            catch { /* best-effort */ }
             this.client = null;
             this.transport = null;
             this._available = false;
@@ -85,6 +132,7 @@ export class CodeReviewGraphClient {
      * Returns empty array when unavailable or on error.
      */
     async semanticSearchNodes(query, limit = 20) {
+        await this.init();
         if (!this._available || !this.client)
             return [];
         try {
@@ -148,7 +196,7 @@ export async function ensureCrGraphBuilt(repoRoot) {
             }
         }
         catch { /* stamp missing or corrupt — proceed */ }
-        const config = discoverCrGraphConfig();
+        const config = discoverCrGraphConfig(repoRoot);
         if (!config)
             return; // binary not configured — nothing to do
         const transport = new StdioClientTransport({

package/dist/engines/knowledge-fabric.js

@@ -41,7 +41,7 @@ export class KnowledgeFabricEngine {
                     reused: true,
                 },
             };
-            this.persistBundle(bundle);
+            await this.persistBundle(bundle);
             return bundle;
         }
         const bundle = await this.composeStage(input, stage, cacheKey);
@@ -53,7 +53,7 @@ export class KnowledgeFabricEngine {
                 reused: false,
             },
         });
-        this.persistBundle(bundle);
+        await this.persistBundle(bundle);
         return bundle;
     }
     async composeStage(input, stage, cacheKey) {
@@ -299,7 +299,7 @@ export class KnowledgeFabricEngine {
             trace: snapshot?.modelTierTrace ?? [],
         };
     }
-    persistBundle(bundle) {
+    async persistBundle(bundle) {
         const snapshot = {
             runtimeId: bundle.runtimeId,
             sessionId: bundle.sessionId,
@@ -325,8 +325,12 @@ export class KnowledgeFabricEngine {
         };
         // Update in-memory cache immediately so getSessionSnapshot has zero disk latency.
         this.snapshotCache.set(bundle.runtimeId, snapshot);
-        // Persist to disk asynchronously — callers never await this return value.
-        void this.persistBundleAsync(bundle.runtimeId, bundle.sessionId, snapshot);
+        try {
+            await this.persistBundleAsync(bundle.runtimeId, bundle.sessionId, snapshot);
+        }
+        catch {
+            // Snapshot persistence is best effort; the in-memory cache remains authoritative in-process.
+        }
     }
     async persistBundleAsync(runtimeId, sessionId, snapshot) {
         const runtimeDir = path.join(this.stateDir, runtimeId);

package/package.json

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