nexus-prime 7.9.19 → 7.9.20

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

@@ -976,11 +976,10 @@ export function buildMcpToolDefinitions() {
                 required: ['taskId', 'goal', 'findings'],
             },
         },
-        // When NEXUS_DISABLE_WORKFORCE=1 (the daemon default since v7.6.1),
+        // When NEXUS_DISABLE_WORKFORCE=1 (explicit break-glass mode),
         // 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.
+        // aren't initialized at runtime.
         ...(process.env.NEXUS_DISABLE_WORKFORCE === '1' ? [] : synapseToolDefinitions),
         ...(process.env.NEXUS_DISABLE_WORKFORCE === '1' ? [] : architectsToolDefinitions),
         // ── Workforce (unified worker+job layer) ──────────────────────────

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

@@ -173,7 +173,7 @@ export async function handleGovernanceGroup(toolName, hctx, request, args, ctx)
             const manifest = ensureBootstrap({
                 packageRoot: PROJECT_ROOT,
                 workspaceRoot: hctx.nexusRef.getWorkspaceContext().workspaceRoot,
-                phase: 'runtime',
+                phase: 'install',
                 silent: true,
             });
             const memoryMaintenance = hctx.nexusRef.maintainMemory();

package/dist/cli/doctor-storage.js

@@ -12,10 +12,9 @@ import { resolveRunsBudget, resolveWorktreeBudget } from './cleanup.js';
 import { dirBytes, formatBytes } from '../install/fs-purge.js';
 import { enumerateNgramArchives, enumerateStatePaths, getNexusStateDir, getRuntimeTmpRoots, getWorktreeRoots, } from '../install/state-locator.js';
 import { INSTALL_ARCH_GENERATION, loadManifest, } from '../install/manifest.js';
-import { getNgramFootprintBytes } from '../engines/ngram-index.js';
+import { getNgramFootprintBytes, NGRAM_DEFAULT_FOOTPRINT_BYTES } from '../engines/ngram-index.js';
 import { getSharedLicenseManager } from '../licensing/license-manager.js';
 const NGRAM_DEFAULT_WAL_LIMIT_BYTES = 64 * 1024 * 1024;
-const NGRAM_DEFAULT_FOOTPRINT_BYTES = 512 * 1024 * 1024;
 function readEnvBytesPositive(name, fallback) {
     const raw = process.env[name];
     if (!raw)

package/dist/cli.js

@@ -30,7 +30,7 @@ import { cliSetup, configureIDE, computeFileHash, readSetupMarker, writeSetupMar
 import { isNewUser, promptLicenseKey, printReturningUserBanner } from './cli/interactive-setup.js';
 import { runHookBootstrap, runHookMemory, runHookMindkit, runHookGhostPass, runHookSessionDna } from './cli/hook.js';
 import { resolveWorkspaceContext } from './engines/workspace-resolver.js';
-import { ensureDaemonReady, getDaemonStatus, stopDaemon } from './daemon/client.js';
+import { ensureDaemonReady, getDaemonStatus, pingDaemonHealth, stopDaemon } from './daemon/client.js';
 import { NexusDaemonServer } from './daemon/server.js';
 import { DaemonSupervisor } from './daemon/supervisor.js';
 import { startDaemonBackedMcpProxy } from './daemon/proxy.js';
@@ -720,8 +720,10 @@ program
     try {
         const record = await ensureDaemonManaged({ force: options.force });
         const dashboardPort = process.env.NEXUS_DASHBOARD_PORT ?? '3377';
+        const health = await pingDaemonHealth(record).catch(() => null);
+        const dashboardUrl = health?.dashboardUrl ?? `http://localhost:${dashboardPort}`;
         console.log(`Nexus Prime daemon running (pid ${record.pid}, ${formatDaemonAddress(record)})`);
-        console.log(`Dashboard: http://localhost:${dashboardPort}`);
+        console.log(`Dashboard: ${dashboardUrl}`);
     }
     catch (err) {
         console.error(`Failed to start daemon: ${err.message}`);
@@ -820,15 +822,14 @@ 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';
+    // Keep daemon startup fast, but do not disable workforce. Synapse and
+    // Architects can lazily warm on first hire/tool call unless the operator
+    // explicitly sets the NEXUS_DISABLE_WORKFORCE escape hatch.
+    if (process.env.NEXUS_SYNAPSE_LAZY === undefined) {
+        process.env.NEXUS_SYNAPSE_LAZY = '1';
+    }
+    if (process.env.NEXUS_ARCHITECTS_LAZY === undefined) {
+        process.env.NEXUS_ARCHITECTS_LAZY = '1';
     }
     const workspaceContext = resolveWorkspaceContext({ workspaceRoot: getWorkspaceRoot() });
     const daemon = new NexusDaemonServer(workspaceContext);

package/dist/daemon/client.d.ts

@@ -9,6 +9,7 @@ export interface DaemonHealthResponse {
     stateKey: string;
     workspaceRoot: string;
     repoRoot: string;
+    dashboardUrl?: string | null;
     startedAt: number;
 }
 export interface DaemonStatus {

package/dist/daemon/server.js

@@ -390,6 +390,7 @@ export class NexusDaemonServer {
                     stateKey: this.workspace.stateKey,
                     workspaceRoot: this.workspace.workspaceRoot,
                     repoRoot: this.workspace.repoRoot,
+                    dashboardUrl: this.nexus?.getDashboardAddress?.() ?? null,
                     startedAt: this.lockRecord?.startedAt ?? Date.now(),
                 });
                 return;

package/dist/dashboard/server.js

@@ -1126,9 +1126,26 @@ export class DashboardServer {
         const capabilities = this.buildAdvertisedCapabilities();
         const compatibility = this.buildCompatibilityStatus(capabilities);
         const runtimeEnvelope = this.buildProbeRuntimeEnvelope();
+        const workspace = this.resolveCanonicalWorkspaceContext();
         return {
             dashboardApiVersion: DASHBOARD_API_VERSION,
-            projectName: path.basename(this.repoRoot) || 'workspace',
+            projectName: workspace.repoName,
+            repoIdentity: {
+                repoName: workspace.repoName,
+                repoRoot: workspace.repoRoot,
+                workspaceRoot: workspace.workspaceRoot,
+                workspaceSource: workspace.workspaceSource,
+                workspaceStateKey: workspace.stateKey,
+                remoteUrl: workspace.remoteUrl ?? null,
+                currentRepoId: null,
+            },
+            scanContext: {
+                repoRoot: workspace.repoRoot,
+                workspaceRoot: workspace.workspaceRoot,
+                workspaceSource: workspace.workspaceSource,
+                workspaceStateKey: workspace.stateKey,
+                notes: ['Probe snapshot uses the lightweight compatibility contract.'],
+            },
             capabilities,
             compatibility,
             dashboardUrl: this.getAddress(),
@@ -1513,6 +1530,10 @@ export class DashboardServer {
         if (payload.compatibility?.status !== 'compatible') {
             return false;
         }
+        const stateRoot = payload.runtimeEnvelope?.workspace?.stateRoot;
+        if (!stateRoot || path.resolve(stateRoot) !== path.resolve(resolveNexusStateDir())) {
+            return false;
+        }
         const required = payload.compatibility?.requiredCapabilities?.length
             ? payload.compatibility.requiredCapabilities
             : [...DASHBOARD_COMPATIBILITY_CAPABILITIES];

package/dist/engines/ngram-index.d.ts

@@ -11,6 +11,9 @@
  *
  * Persistence: SQLite (same pattern as memory.db / graph.db)
  */
+export declare const NGRAM_WARMUP_MAX_DB_BYTES: number;
+export declare const NGRAM_DEFAULT_ROTATE_BYTES: number;
+export declare const NGRAM_DEFAULT_FOOTPRINT_BYTES: number;
 export declare function getNgramWalPath(dbPath: string): string;
 export declare function getNgramShmPath(dbPath: string): string;
 export declare function getNgramFootprintBytes(dbPath: string): number;
@@ -147,7 +150,7 @@ export declare class NgramIndex {
     optimizeStorage(force?: boolean): void;
     /**
      * Operator-focused maintenance for the on-disk ngram DB.
-     * - Bounds runaway DB growth via rotation (default >= 1GB), counting the
+     * - Bounds runaway DB growth via rotation, counting the
      *   full SQLite footprint (db + wal + shm) so a runaway WAL triggers it.
      * - Vacuums only when safe (<= vacuumMaxBytes) and either forced or dirty.
      */

package/dist/engines/ngram-index.js

@@ -45,7 +45,9 @@ function safeStatSize(filePath) {
 // wal/shm misses the bug that turned ngram-index.db-wal into 84GB on disk.
 // ─────────────────────────────────────────────────────────────────────────────
 const NGRAM_DEFAULT_WAL_LIMIT_BYTES = 64 * 1024 * 1024; // 64 MB
-const NGRAM_DEFAULT_FOOTPRINT_BYTES = 512 * 1024 * 1024; // 512 MB
+export const NGRAM_WARMUP_MAX_DB_BYTES = 200 * 1024 * 1024; // 200 MB
+export const NGRAM_DEFAULT_ROTATE_BYTES = NGRAM_WARMUP_MAX_DB_BYTES;
+export const NGRAM_DEFAULT_FOOTPRINT_BYTES = NGRAM_WARMUP_MAX_DB_BYTES;
 const NGRAM_DEFAULT_CHECKPOINT_INTERVAL_MS = 30_000;
 const NGRAM_DEFAULT_CHECKPOINT_DOC_COUNT = 200;
 export function getNgramWalPath(dbPath) {
@@ -199,13 +201,13 @@ export class NgramIndex {
         this.warmHashSet();
         try {
             const sizeBytes = safeStatSize(this.dbPath);
-            // Only VACUUM on medium-size DBs. Large DBs (>200MB) take too long
+            // Only VACUUM on medium-size DBs. Large DBs take too long
             // synchronously — VACUUM rewrites the entire file. Skip here; let
             // periodic maintenance handle it.
-            if (sizeBytes > 32 * 1024 * 1024 && sizeBytes <= 200 * 1024 * 1024) {
+            if (sizeBytes > 32 * 1024 * 1024 && sizeBytes <= NGRAM_WARMUP_MAX_DB_BYTES) {
                 this.optimizeStorage(true);
             }
-            else if (sizeBytes > 200 * 1024 * 1024) {
+            else if (sizeBytes > NGRAM_WARMUP_MAX_DB_BYTES) {
                 logNgramNoticeOnce(`ngram:vacuum-skip:${this.dbPath}`, `[NgramIndex] skipping VACUUM on large DB (${Math.round(sizeBytes / 1024 / 1024)}MB) db=${this.dbPath}`);
             }
         }
@@ -217,17 +219,17 @@ export class NgramIndex {
         // Count the full SQLite footprint (db + wal + shm). The 84GB regression
         // happened because a 32MB db file had a 84GB -wal sibling that this
         // routine never inspected.
-        const rotateBytes = readEnvBytes('NEXUS_NGRAM_ROTATE_BYTES', 1024 * 1024 * 1024); // 1GB default
+        const rotateBytes = readEnvBytes('NEXUS_NGRAM_ROTATE_BYTES', NGRAM_DEFAULT_ROTATE_BYTES);
         const dbBytes = safeStatSize(this.dbPath);
         const footprint = getNgramFootprintBytes(this.dbPath);
         if (footprint <= 0 || footprint < rotateBytes)
             return;
-        // Keep only the most recent oversize archive to bound disk usage. When the
-        // operator opts out of archiving (ARCHIVE_OVERSIZE=0), drop the leftovers
-        // outright instead of growing a backlog of multi-GB carcasses.
+        // The n-gram DB is a rebuildable cache, so oversized rotation drops it by
+        // default. Operators can opt into one retained archive for forensics with
+        // NEXUS_NGRAM_ARCHIVE_OVERSIZE=1.
         const dir = path.dirname(this.dbPath);
         const base = path.basename(this.dbPath);
-        const archiveEnabled = process.env.NEXUS_NGRAM_ARCHIVE_OVERSIZE !== '0';
+        const archiveEnabled = process.env.NEXUS_NGRAM_ARCHIVE_OVERSIZE === '1';
         const existing = fs.existsSync(dir)
             ? fs.readdirSync(dir).filter((entry) => entry.startsWith(`${base}.oversize.`)).sort().reverse()
             : [];
@@ -324,8 +326,8 @@ export class NgramIndex {
         // Size guard: SELECT DISTINCT on very large DBs blocks startup under swap pressure.
         try {
             const sizeBytes = fs.statSync(this.dbPath).size;
-            if (sizeBytes > 200 * 1024 * 1024) {
-                logNgramNoticeOnce(`ngram:warmup-skip:${this.dbPath}`, `[NgramIndex] warmup skipped — DB too large (${Math.round(sizeBytes / 1024 / 1024)}MB > 200MB) db=${this.dbPath}`);
+            if (sizeBytes > NGRAM_WARMUP_MAX_DB_BYTES) {
+                logNgramNoticeOnce(`ngram:warmup-skip:${this.dbPath}`, `[NgramIndex] warmup skipped — DB too large (${Math.round(sizeBytes / 1024 / 1024)}MB > ${Math.round(NGRAM_WARMUP_MAX_DB_BYTES / 1024 / 1024)}MB) db=${this.dbPath}`);
                 return;
             }
         }
@@ -667,17 +669,17 @@ export class NgramIndex {
     }
     /**
      * Operator-focused maintenance for the on-disk ngram DB.
-     * - Bounds runaway DB growth via rotation (default >= 1GB), counting the
+     * - Bounds runaway DB growth via rotation, counting the
      *   full SQLite footprint (db + wal + shm) so a runaway WAL triggers it.
      * - Vacuums only when safe (<= vacuumMaxBytes) and either forced or dirty.
      */
     maintainBounded(options = {}) {
         const dbBytes = safeStatSize(this.dbPath);
         const footprint = this.getSqliteFootprintBytes();
-        const rotateBytes = readEnvBytes('NEXUS_NGRAM_ROTATE_BYTES', 1024 * 1024 * 1024);
+        const rotateBytes = readEnvBytes('NEXUS_NGRAM_ROTATE_BYTES', NGRAM_DEFAULT_ROTATE_BYTES);
         const vacuumMaxBytes = readEnvBytes('NEXUS_NGRAM_VACUUM_MAX_BYTES', 256 * 1024 * 1024);
         if (footprint >= rotateBytes && footprint > 0) {
-            const archiveEnabled = process.env.NEXUS_NGRAM_ARCHIVE_OVERSIZE !== '0';
+            const archiveEnabled = process.env.NEXUS_NGRAM_ARCHIVE_OVERSIZE === '1';
             const rotatedPath = `${this.dbPath}.oversize.${Date.now()}`;
             const removeSibling = (suffix) => {
                 try {

package/dist/index.d.ts

@@ -213,6 +213,7 @@ export declare class NexusPrime {
     awaitReady(): Promise<void>;
     getClientRegistry(): ClientRegistry;
     getRuntimeHotAt(): number | null;
+    getDashboardAddress(): string | null;
     getSynapse(): SynapseRuntime | null;
     getArchitects(): ArchitectsRuntime | null;
     /**

package/dist/index.js

@@ -847,6 +847,9 @@ export class NexusPrime {
     getRuntimeHotAt() {
         return this.runtimeHotAt;
     }
+    getDashboardAddress() {
+        return this.dashboardServer.getAddress();
+    }
     getSynapse() {
         return this.synapse;
     }
@@ -1070,7 +1073,7 @@ export class NexusPrime {
         const bootstrapManifest = ensureBootstrap({
             packageRoot: PACKAGE_ROOT,
             workspaceRoot: this.getWorkspaceContext().workspaceRoot,
-            phase: 'runtime',
+            phase: 'install',
             silent: true,
         });
         this.runtime.recordBootstrapManifestStatus?.(bootstrapManifest);

package/package.json

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