nexus-prime 7.0.0 → 7.0.1

package/dist/engines/context-assembler.d.ts

@@ -23,6 +23,8 @@ export interface ContextChunk {
     entropy?: number;
     /** Memory trust (0-1) — used to boost high-trust memory chunks */
     trust?: number;
+    /** Pre-computed mtime so scoreRecency does not statSync per chunk in the hot loop. */
+    mtimeMs?: number;
 }
 export interface QualityWeights {
     relevance: number;

package/dist/engines/context-assembler.js

@@ -154,15 +154,12 @@ export class ContextAssembler {
     }
     /** Recency: how recently the file was modified (exponential decay) */
     scoreRecency(chunk) {
-        try {
-            const stat = fs.statSync(chunk.source);
-            const ageHours = (Date.now() - stat.mtimeMs) / 3_600_000;
-            // Exponential decay: half-life of 24 hours
-            return Math.exp(-0.693 * ageHours / 24);
-        }
-        catch {
-            return 0.3; // default for unresolvable files
-        }
+        // Hot loop: rely on chunk.mtimeMs stamped at chunk creation time. No per-chunk fs.
+        // Chunks without a stamp (legacy producers) get a neutral 0.3 default.
+        if (typeof chunk.mtimeMs !== 'number' || chunk.mtimeMs <= 0)
+            return 0.3;
+        const ageHours = (Date.now() - chunk.mtimeMs) / 3_600_000;
+        return Math.exp(-0.693 * ageHours / 24);
     }
     /** Novelty: chunks not yet seen in this session score higher */
     scoreNovelty(chunk) {
@@ -216,16 +213,23 @@ export class ContextAssembler {
     chunkFile(filepath) {
         const resolved = path.isAbsolute(filepath) ? filepath : path.join(process.cwd(), filepath);
         let content;
+        let mtimeMs;
         try {
             content = fs.readFileSync(resolved, 'utf-8');
+            // Single stat per file — cached onto every chunk so scoreRecency stays sync-free.
+            try {
+                mtimeMs = fs.statSync(resolved).mtimeMs;
+            }
+            catch { /* ignore */ }
         }
         catch {
             return [];
         }
         const lines = content.split('\n');
+        let chunks;
         // For small files (< 100 lines), return as single chunk
         if (lines.length < 100) {
-            return [{
+            chunks = [{
                     source: resolved,
                     content,
                     tokens: Math.ceil(content.length / 4),
@@ -235,13 +239,17 @@ export class ContextAssembler {
                     endLine: lines.length,
                 }];
         }
-        // Detect function/class boundaries for .ts/.js files
-        const ext = path.extname(filepath).toLowerCase();
-        if (['.ts', '.js', '.tsx', '.jsx'].includes(ext)) {
-            return this.chunkByBoundaries(resolved, lines);
+        else {
+            const ext = path.extname(filepath).toLowerCase();
+            chunks = ['.ts', '.js', '.tsx', '.jsx'].includes(ext)
+                ? this.chunkByBoundaries(resolved, lines)
+                : this.chunkByWindow(resolved, lines, 80);
+        }
+        if (mtimeMs !== undefined) {
+            for (const chunk of chunks)
+                chunk.mtimeMs = mtimeMs;
         }
-        // For other files, chunk by fixed window
-        return this.chunkByWindow(resolved, lines, 80);
+        return chunks;
     }
     /** Chunk TypeScript/JavaScript by function and class boundaries */
     chunkByBoundaries(filepath, lines) {

package/dist/engines/event-bus.d.ts

@@ -1,4 +1,4 @@
-export type NexusEventType = 'system.boot' | 'planner.stage' | 'memory.store' | 'memory.dedup' | 'memory.recall' | 'memory.flushed' | 'memory.health.tick' | 'memory.sqlite.retry' | 'pod.signal' | 'tokens.optimized' | 'tokens.searchSaved' | 'session.summaryBootstrap' | 'phantom.worker.start' | 'phantom.worker.complete' | 'phantom.merge.complete' | 'phantom.merge' | 'guardrail.check' | 'ghost.pass' | 'graph.query' | 'graph.sync.failed' | 'graph.coverage.low' | 'graph.cr.build.start' | 'graph.cr.build.complete' | 'graph.cr.build.failed' | 'darwin.cycle' | 'darwin.cycle.complete' | 'session.dna' | 'skill.register' | 'skill.deploy' | 'skill.revoke' | 'hook.deploy' | 'hook.revoke' | 'hook.fire' | 'hook.error' | 'workflow.deploy' | 'workflow.run' | 'automation.deploy' | 'automation.revoke' | 'automation.run' | 'shield.decision' | 'memory.audit' | 'federation.heartbeat' | 'client.heartbeat' | 'client.inferred' | 'client.status' | 'dashboard.action' | 'workspace.changed' | 'nexus.shutdown' | 'nexus.daemon.error' | 'orchestrator.disposed' | 'orchestrator.funnel.stage' | 'orchestrator.warn' | 'nexusnet.publish' | 'nexusnet.sync' | 'mcp.call.start' | 'mcp.call.stream' | 'mcp.call.complete' | 'mcp.handler.complete' | 'mcp.handler.failed' | 'mcp.handler.retry' | 'mcp.handler.best-effort-failed' | 'tool.invocation' | 'nexus.deprecation.used' | 'memory.tier.promoted' | 'memory.tier.promoted.failed' | 'memory.pre-compaction' | 'memory.flush-requested' | 'entanglement.create' | 'entanglement.collapse' | 'entanglement.correlate' | 'cas.encode' | 'cas.decode' | 'cas.pattern_learned' | 'kv.merge' | 'kv.adapt' | 'kv.consensus' | 'byzantine.vote.started' | 'byzantine.vote.result' | 'synapse.ready' | 'synapse.operative.hired' | 'synapse.operative.retired' | 'synapse.operative.health.changed' | 'synapse.striketeam.deployed' | 'synapse.striketeam.completed' | 'synapse.mission.assigned' | 'synapse.mission.completed' | 'synapse.sortie.started' | 'synapse.sortie.completed' | 'synapse.sortie.failed' | 'synapse.fieldreport.submitted' | 'synapse.echo.fired' | 'synapse.budget.warning' | 'synapse.budget.exceeded' | 'synapse.approval.requested' | 'synapse.approval.resolved' | 'synapse.compaction.standdown' | 'synapse.compaction.resumed' | 'synapse.watchdog.stall' | 'synapse.watchdog.zombie' | 'architects.ready' | 'architects.blueprint.instantiated' | 'architects.worklist.created' | 'architects.workitem.claimed' | 'architects.workitem.completed' | 'architects.workitem.blocked' | 'architects.constructionlock.acquired' | 'architects.constructionlock.renewed' | 'architects.constructionlock.released' | 'architects.constructionlock.contested' | 'architects.relay.sent' | 'architects.relay.read' | 'architects.sentinel.patrol' | 'architects.sentinel.stall' | 'architects.sentinel.zombie' | 'architects.ward.patrol' | 'architects.ward.escalation' | 'architects.convergence.started' | 'architects.convergence.merged' | 'architects.convergence.failed' | 'architects.dispatch.go' | 'architects.dispatch.queued' | 'architects.relay.failed' | 'architects.event.failed' | 'ledger.duplicate-prevented' | 'nexus.circuit-open' | 'nexus.circuit-tripped' | 'license.activated' | 'license.deactivated' | 'license.expired' | 'license.cap.warning' | 'license.cap.reached' | 'dispatch.started' | 'dispatch.event' | 'dispatch.token-usage' | 'dispatch.complete' | 'dispatch.failed' | 'dispatch.cancelled' | 'dispatch.budget-exceeded' | 'mcp.auto-memory.failed' | 'daemon.self-heal.db-corrupt' | 'feature.time_to_first_bootstrap' | 'feature.time_to_first_memory' | 'feature.time_to_first_interaction' | 'feature.time_to_first_mission_complete' | 'async_gate.completed' | 'async_gate.failed' | 'install.step' | 'license.tierChanged' | 'license.upgradeNudge' | 'orchestrator.run.start' | 'orchestrator.run.complete';
+export type NexusEventType = 'system.boot' | 'planner.stage' | 'memory.store' | 'memory.dedup' | 'memory.recall' | 'memory.flushed' | 'memory.health.tick' | 'memory.sqlite.retry' | 'pod.signal' | 'tokens.optimized' | 'tokens.searchSaved' | 'session.summaryBootstrap' | 'phantom.worker.start' | 'phantom.worker.complete' | 'phantom.merge.complete' | 'phantom.merge' | 'guardrail.check' | 'ghost.pass' | 'graph.query' | 'graph.sync.failed' | 'graph.coverage.low' | 'graph.cr.build.start' | 'graph.cr.build.complete' | 'graph.cr.build.failed' | 'darwin.cycle' | 'darwin.cycle.complete' | 'session.dna' | 'skill.register' | 'skill.deploy' | 'skill.revoke' | 'hook.deploy' | 'hook.revoke' | 'hook.fire' | 'hook.error' | 'workflow.deploy' | 'workflow.run' | 'automation.deploy' | 'automation.revoke' | 'automation.run' | 'shield.decision' | 'memory.audit' | 'federation.heartbeat' | 'client.heartbeat' | 'client.inferred' | 'client.status' | 'dashboard.action' | 'workspace.changed' | 'nexus.shutdown' | 'nexus.daemon.error' | 'orchestrator.disposed' | 'orchestrator.funnel.stage' | 'orchestrator.warn' | 'nexusnet.publish' | 'nexusnet.sync' | 'mcp.call.start' | 'mcp.call.stream' | 'mcp.call.complete' | 'mcp.handler.complete' | 'mcp.handler.failed' | 'mcp.handler.retry' | 'mcp.handler.best-effort-failed' | 'tool.invocation' | 'nexus.deprecation.used' | 'memory.tier.promoted' | 'memory.tier.promoted.failed' | 'memory.pre-compaction' | 'memory.flush-requested' | 'entanglement.create' | 'entanglement.collapse' | 'entanglement.correlate' | 'cas.encode' | 'cas.decode' | 'cas.pattern_learned' | 'kv.merge' | 'kv.adapt' | 'kv.consensus' | 'byzantine.vote.started' | 'byzantine.vote.result' | 'synapse.ready' | 'synapse.operative.hired' | 'synapse.operative.retired' | 'synapse.operative.health.changed' | 'synapse.striketeam.deployed' | 'synapse.striketeam.completed' | 'synapse.mission.assigned' | 'synapse.mission.completed' | 'synapse.sortie.started' | 'synapse.sortie.completed' | 'synapse.sortie.failed' | 'synapse.fieldreport.submitted' | 'synapse.echo.fired' | 'synapse.budget.warning' | 'synapse.budget.exceeded' | 'synapse.approval.requested' | 'synapse.approval.resolved' | 'synapse.compaction.standdown' | 'synapse.compaction.resumed' | 'synapse.coordination.publish.failed' | 'synapse.watchdog.stall' | 'synapse.watchdog.zombie' | 'architects.ready' | 'architects.blueprint.instantiated' | 'architects.worklist.created' | 'architects.workitem.claimed' | 'architects.workitem.completed' | 'architects.workitem.blocked' | 'architects.constructionlock.acquired' | 'architects.constructionlock.renewed' | 'architects.constructionlock.released' | 'architects.constructionlock.contested' | 'architects.relay.sent' | 'architects.relay.read' | 'architects.sentinel.patrol' | 'architects.sentinel.stall' | 'architects.sentinel.zombie' | 'architects.ward.patrol' | 'architects.ward.escalation' | 'architects.convergence.started' | 'architects.convergence.merged' | 'architects.convergence.failed' | 'architects.dispatch.go' | 'architects.dispatch.queued' | 'architects.relay.failed' | 'architects.event.failed' | 'ledger.duplicate-prevented' | 'nexus.circuit-open' | 'nexus.circuit-tripped' | 'license.activated' | 'license.deactivated' | 'license.expired' | 'license.cap.warning' | 'license.cap.reached' | 'dispatch.started' | 'dispatch.event' | 'dispatch.token-usage' | 'dispatch.complete' | 'dispatch.failed' | 'dispatch.cancelled' | 'dispatch.budget-exceeded' | 'mcp.auto-memory.failed' | 'daemon.self-heal.db-corrupt' | 'feature.time_to_first_bootstrap' | 'feature.time_to_first_memory' | 'feature.time_to_first_interaction' | 'feature.time_to_first_mission_complete' | 'async_gate.completed' | 'async_gate.failed' | 'install.step' | 'license.tierChanged' | 'license.upgradeNudge' | 'orchestrator.run.start' | 'orchestrator.run.complete';
 export interface NexusEventPayloads {
     'system.boot': {
         version: string;
@@ -521,6 +521,14 @@ export interface NexusEventPayloads {
     'synapse.compaction.resumed': {
         operativesResumed: number;
     };
+    'synapse.coordination.publish.failed': {
+        stage: string;
+        phase: string;
+        operativeId?: string;
+        missionId?: string;
+        sortieId?: string;
+        error: string;
+    };
     'synapse.watchdog.stall': {
         operativeId: string;
     };

package/dist/engines/runtime-registry.d.ts

@@ -346,6 +346,7 @@ export declare function resolveNexusStateDir(): string;
 export declare class RuntimeRegistry {
     private readonly registryDir;
     constructor(rootDir?: string);
+    private ensureDir;
     list(): ListedRuntimeSnapshot[];
     read(runtimeId: string): RuntimeRegistrySnapshot | undefined;
     write(snapshot: RuntimeRegistrySnapshot): RuntimeRegistrySnapshot;

package/dist/engines/runtime-registry.js

@@ -56,9 +56,19 @@ export class RuntimeRegistry {
     registryDir;
     constructor(rootDir) {
         this.registryDir = path.join(rootDir ?? resolveNexusStateDir(), 'runtime-registry');
-        fs.mkdirSync(this.registryDir, { recursive: true });
+        this.ensureDir();
+    }
+    ensureDir() {
+        // Re-create on every entry. The directory may be wiped by `nexus-prime reset`,
+        // a stale-clean script, or the user — without this, list/write/pruneStale will
+        // ENOENT and crash nexus_doctor / nexus_runtime_health / nexus_orchestrate.
+        try {
+            fs.mkdirSync(this.registryDir, { recursive: true });
+        }
+        catch { /* best-effort */ }
     }
     list() {
+        this.ensureDir();
         this.pruneStale();
         const now = Date.now();
         return fs.readdirSync(this.registryDir)
@@ -72,6 +82,7 @@ export class RuntimeRegistry {
             .sort((left, right) => right.lastActivityAt - left.lastActivityAt);
     }
     read(runtimeId) {
+        this.ensureDir();
         const target = this.snapshotPath(runtimeId);
         if (!fs.existsSync(target))
             return undefined;
@@ -104,6 +115,7 @@ export class RuntimeRegistry {
             skipReasons: snapshot.skipReasons ?? [],
             lastToolCalls: snapshot.lastToolCalls ?? [],
         };
+        this.ensureDir();
         fs.writeFileSync(this.snapshotPath(snapshot.runtimeId), JSON.stringify(normalized, null, 2), 'utf8');
         return normalized;
     }
@@ -117,6 +129,7 @@ export class RuntimeRegistry {
         this.pruneStale();
     }
     pruneStale() {
+        this.ensureDir();
         const now = Date.now();
         for (const entry of fs.readdirSync(this.registryDir)) {
             if (!entry.endsWith('.json'))

package/dist/synapse/coordination/safe-publish.d.ts

@@ -0,0 +1,7 @@
+import type { SynapseCoordinationSignal, SynapseProviders } from '../types.js';
+/**
+ * Wrap providers.coordination.publish() so a coordination failure can never
+ * abort a sortie or mandate. Failures are emitted as a structured event so
+ * they remain observable instead of being silently swallowed.
+ */
+export declare function safePublish(coordination: SynapseProviders['coordination'] | undefined, signal: SynapseCoordinationSignal, stage?: string): void;

package/dist/synapse/coordination/safe-publish.js

@@ -0,0 +1,23 @@
+import { nexusEventBus } from '../../engines/event-bus.js';
+/**
+ * Wrap providers.coordination.publish() so a coordination failure can never
+ * abort a sortie or mandate. Failures are emitted as a structured event so
+ * they remain observable instead of being silently swallowed.
+ */
+export function safePublish(coordination, signal, stage = 'coordination') {
+    if (!coordination)
+        return;
+    try {
+        coordination.publish(signal);
+    }
+    catch (err) {
+        nexusEventBus.emit('synapse.coordination.publish.failed', {
+            stage,
+            phase: signal.phase,
+            operativeId: signal.operativeId,
+            missionId: signal.workItemId,
+            sortieId: signal.sortieId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}

package/dist/synapse/mandate/pipeline.js

@@ -6,6 +6,7 @@ import { matchNPAssets } from './asset-matcher.js';
 import { insertStrikeTeam, insertMission, getStrikeTeam } from '../missions/crud.js';
 import { insertOperative, updateOperativeMission } from '../operatives/crud.js';
 import { SynapseConfig } from '../config.js';
+import { safePublish } from '../coordination/safe-publish.js';
 function unique(values) {
     return [...new Set(values)];
 }
@@ -122,19 +123,16 @@ export async function executeMandatePipeline(db, mandateText, providers, opts =
                 worklistId,
                 correlationId: mission.correlationId ?? mission.id,
             });
-            try {
-                providers.coordination?.publish({
-                    phase: 'mandate',
-                    summary: `Mission assigned: ${mission.title}`,
-                    strikeTeamId: teamId,
-                    worklistId,
-                    workItemId: mission.id,
-                    operativeId,
-                    correlationId: mission.correlationId ?? mission.id,
-                    status: 'assigned',
-                });
-            }
-            catch { /* non-fatal: coordination publish failure should not abort mandate */ }
+            safePublish(providers.coordination, {
+                phase: 'mandate',
+                summary: `Mission assigned: ${mission.title}`,
+                strikeTeamId: teamId,
+                worklistId,
+                workItemId: mission.id,
+                operativeId,
+                correlationId: mission.correlationId ?? mission.id,
+                status: 'assigned',
+            }, 'mandate');
             return mission.id;
         });
         insertStrikeTeam(db, {
@@ -152,17 +150,14 @@ export async function executeMandatePipeline(db, mandateText, providers, opts =
             worklistId,
             correlationId: teamId,
         });
-        try {
-            providers.coordination?.publish({
-                phase: 'mandate',
-                summary: `Strike team deployed for mandate: ${mandateText.slice(0, 120)}`,
-                strikeTeamId: teamId,
-                worklistId,
-                correlationId: teamId,
-                status: 'deployed',
-            });
-        }
-        catch { /* non-fatal: coordination publish failure should not abort mandate */ }
+        safePublish(providers.coordination, {
+            phase: 'mandate',
+            summary: `Strike team deployed for mandate: ${mandateText.slice(0, 120)}`,
+            strikeTeamId: teamId,
+            worklistId,
+            correlationId: teamId,
+            status: 'deployed',
+        }, 'mandate');
         providers.memory.store(`[Synapse:Mandate] ${mandateText}`, 0.85, ['#synapse', '#mandate', `#team:${teamId}`], undefined, 0, {
             provenance: {
                 source: 'runtime',

package/dist/synapse/sorties/runner.js

@@ -12,6 +12,8 @@ import { enforceBudget } from '../budgets/enforcer.js';
 import { getMission, updateMissionStatus, updateStrikeTeamStatus } from '../missions/crud.js';
 import { getOperative, updateOperativeMission } from '../operatives/crud.js';
 import { transitionOperative } from '../operatives/state-machine.js';
+import { safePublish as safePublishImpl } from '../coordination/safe-publish.js';
+const safePublish = (coordination, signal) => safePublishImpl(coordination, signal, 'sortie');
 function mapSortie(row) {
     return {
         id: row.id,
@@ -88,7 +90,7 @@ export async function runSortie(db, operative, providers) {
     if (providers.claimWorkItem) {
         const lock = await providers.claimWorkItem(mission.id, operative.id);
         if (!lock) {
-            providers.coordination?.publish({
+            safePublish(providers.coordination, {
                 phase: 'worklist',
                 summary: `Work item ${mission.id} is already claimed`,
                 strikeTeamId: mission.strikeTeamId,
@@ -118,7 +120,7 @@ export async function runSortie(db, operative, providers) {
         worklistId,
         correlationId,
     });
-    providers.coordination?.publish({
+    safePublish(providers.coordination, {
         phase: 'sortie',
         summary: `Sortie started for ${mission.title}`,
         strikeTeamId: mission.strikeTeamId,
@@ -207,7 +209,7 @@ export async function runSortie(db, operative, providers) {
             status: report.status,
             tokensUsed: report.tokensUsed,
         });
-        providers.coordination?.publish({
+        safePublish(providers.coordination, {
             phase: 'field-report',
             summary: `Sortie ${sortie.id} finished with ${report.status}`,
             strikeTeamId: mission.strikeTeamId,
@@ -238,7 +240,7 @@ export async function runSortie(db, operative, providers) {
             correlationId,
             error: String(error?.message ?? error),
         });
-        providers.coordination?.publish({
+        safePublish(providers.coordination, {
             phase: 'field-report',
             summary: `Sortie ${sortie.id} failed for ${mission.title}`,
             strikeTeamId: mission.strikeTeamId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.0.0",
+  "version": "7.0.1",
   "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",
@@ -77,7 +77,7 @@
     "express": "^4.18.2",
     "js-yaml": "^4.1.1",
     "pino": "^8.17.2",
-    "uuid": "^9.0.1",
+    "uuid": "^14.0.0",
     "ws": "^8.16.0",
     "zod": "^3.22.4"
   },
@@ -99,7 +99,7 @@
     "@types/jest": "^29.5.11",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",
-    "@types/uuid": "^9.0.7",
+    "@types/uuid": "^11.0.0",
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^6.19.0",
     "@typescript-eslint/parser": "^6.19.0",