nexus-prime 6.1.0 → 6.2.0

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

@@ -333,6 +333,36 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
             const executionPreset = request.params.arguments?.executionPreset
                 ? String(request.params.arguments.executionPreset)
                 : undefined;
+            // Auto-apply token optimization when explicit files are provided.
+            // Gives agents an upfront reading plan before orchestrate runs.
+            // No-files path relies on knowledge fabric (handled inside orchestrate).
+            let upfrontTokenNote = '';
+            if (files && files.length > 3) {
+                try {
+                    const statLimit = pLimit(8);
+                    const fileRefs = await Promise.all(files.map((p) => statLimit(async () => {
+                        const resolved = hctx.resolveToolPath(p, request.params.arguments ?? {});
+                        try {
+                            const stat = await fsPromises.stat(resolved);
+                            return { path: resolved, sizeBytes: stat.size, lastModified: stat.mtimeMs };
+                        }
+                        catch {
+                            return { path: resolved, sizeBytes: 0 };
+                        }
+                    })));
+                    const upfrontPlan = await getTokenEngine().plan(prompt, fileRefs);
+                    if (upfrontPlan.savings > 0) {
+                        const pct = upfrontPlan.totalEstimatedTokens > 0
+                            ? Math.round(upfrontPlan.savings / (upfrontPlan.totalEstimatedTokens + upfrontPlan.savings) * 100)
+                            : 0;
+                        upfrontTokenNote = `Token plan: ${upfrontPlan.files.filter(a => a.action === 'full').length} full reads, ${upfrontPlan.files.filter(a => a.action === 'outline').length} outlines, ${upfrontPlan.files.filter(a => a.action === 'skip').length} skipped. ~${upfrontPlan.savings.toLocaleString()} tokens saved (${pct}%). `;
+                        nexusEventBus.emit('tokens.optimized', { savings: upfrontPlan.savings, pct, source: 'orchestrate-preflight' });
+                    }
+                }
+                catch {
+                    // Non-fatal: proceed without upfront plan
+                }
+            }
             try {
                 const preset = resolveExecutionPreset(executionPreset);
                 const execution = await hctx.nexusRef.orchestrate(prompt, applyExecutionPreset({
@@ -459,6 +489,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                     content: [{
                             type: 'text',
                             text: [
+                                upfrontTokenNote ? `[Token plan] ${upfrontTokenNote}` : '',
                                 `Orchestrated run ${execution.state}.`,
                                 formatBullets([
                                     `Workspace: ${workspace.repoName} (${workspace.workspaceSource})`,

package/dist/agents/adapters/mcp.js

@@ -913,9 +913,14 @@ export class MCPAdapter {
             const swarm = await this.getOrchestrator().induce(goal);
             nexusEventBus.emit('nexusnet.sync', { newItemsCount: swarm.length });
         }
-        // v6: Lazy-init Synapse/Architects on first tool call if not yet initialized
+        // v6: Lazy-init Synapse/Architects on first tool call if not yet initialized.
+        // Mandate + hire tools need Architects live so coordination bridge is set before
+        // executeMandatePipeline runs (otherwise worklistId is null, orphaned teams).
         if (toolName.startsWith('nexus_synapse_')) {
             this.nexusRef.ensureSynapseInit();
+            if (toolName === 'nexus_synapse_mandate' || toolName === 'nexus_synapse_assign_mission' || toolName === 'nexus_synapse_hire') {
+                this.nexusRef.ensureArchitectsInit();
+            }
         }
         const synapseResponse = await handleSynapseToolCall(toolName, args, this.nexusRef.getSynapse?.() ?? null);
         if (synapseResponse) {

package/dist/architects/bootstrap.js

@@ -185,41 +185,65 @@ export function initArchitects(options) {
     if (hasOperative)
         ward.start();
     const onOperativeHired = ({ operativeId, strikeTeamId }) => {
-        knownOperatives.add(operativeId);
-        operativeActivity.set(operativeId, { strikeTeamId, lastSortieAt: null });
-        ensureImplicitWorklist(strikeTeamId);
+        try {
+            knownOperatives.add(operativeId);
+            operativeActivity.set(operativeId, { strikeTeamId, lastSortieAt: null });
+            ensureImplicitWorklist(strikeTeamId);
+        }
+        catch (err) {
+            console.error('[Architects] onOperativeHired failed', operativeId, err);
+            nexusEventBus.emit('architects.event.failed', { event: 'operative.hired', operativeId, error: String(err) });
+        }
     };
     const onMissionAssigned = ({ operativeId, missionId, title }) => {
-        const activity = operativeActivity.get(operativeId);
-        const strikeTeamId = activity?.strikeTeamId ?? null;
-        if (!strikeTeamId)
-            return;
-        const worklistId = ensureImplicitWorklist(strikeTeamId);
-        upsertWorkItem(db, {
-            id: missionId,
-            worklistId,
-            title,
-            status: 'todo',
-            assignedOperativeId: operativeId,
-            constructionLockId: null,
-            dependsOn: [],
-            branch: null,
-            mergedAt: null,
-            createdAt: new Date().toISOString(),
-        });
+        try {
+            const activity = operativeActivity.get(operativeId);
+            const strikeTeamId = activity?.strikeTeamId ?? null;
+            if (!strikeTeamId)
+                return;
+            const worklistId = ensureImplicitWorklist(strikeTeamId);
+            upsertWorkItem(db, {
+                id: missionId,
+                worklistId,
+                title,
+                status: 'todo',
+                assignedOperativeId: operativeId,
+                constructionLockId: null,
+                dependsOn: [],
+                branch: null,
+                mergedAt: null,
+                createdAt: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            console.error('[Architects] onMissionAssigned failed', missionId, err);
+            nexusEventBus.emit('architects.event.failed', { event: 'mission.assigned', operativeId, missionId, error: String(err) });
+        }
     };
     const onSortieCompleted = ({ operativeId, missionId, status }) => {
-        const activity = operativeActivity.get(operativeId);
-        if (activity) {
-            activity.lastSortieAt = new Date().toISOString();
-            operativeActivity.set(operativeId, activity);
+        try {
+            const activity = operativeActivity.get(operativeId);
+            if (activity) {
+                activity.lastSortieAt = new Date().toISOString();
+                operativeActivity.set(operativeId, activity);
+            }
+            if (!missionId)
+                return;
+            updateWorkItemStatus(db, missionId, status === 'completed' ? 'done' : status === 'failed' ? 'failed' : 'blocked');
+        }
+        catch (err) {
+            console.error('[Architects] onSortieCompleted failed', missionId, err);
+            nexusEventBus.emit('architects.event.failed', { event: 'sortie.completed', operativeId, missionId: missionId ?? undefined, error: String(err) });
         }
-        if (!missionId)
-            return;
-        updateWorkItemStatus(db, missionId, status === 'completed' ? 'done' : status === 'failed' ? 'failed' : 'blocked');
     };
     const onStriketeamDeployed = ({ strikeTeamId }) => {
-        ensureImplicitWorklist(strikeTeamId);
+        try {
+            ensureImplicitWorklist(strikeTeamId);
+        }
+        catch (err) {
+            console.error('[Architects] onStriketeamDeployed failed', strikeTeamId, err);
+            nexusEventBus.emit('architects.event.failed', { event: 'striketeam.deployed', strikeTeamId, error: String(err) });
+        }
     };
     const onStanddown = () => setConvergencePaused(true);
     const onResumed = () => setConvergencePaused(false);

package/dist/dashboard/routes/governance.js

@@ -120,6 +120,10 @@ export const handleGovernanceRoutes = async (ctx, req, res, url) => {
         return true;
     }
     if (req.method === 'POST' && url.pathname === '/api/synapse/deploy-crew') {
+        // Ensure Architects is live before mandate so coordination bridge is wired.
+        // getSynapse() triggers ensureSynapseInit(); getArchitects() triggers ensureArchitectsInit()
+        // + reconnectSynapseCoordination() so worklistId is non-null in the pipeline.
+        ctx.getArchitects();
         const synapse = ctx.getSynapse();
         if (!synapse) {
             const initErr = ctx.getSynapseInitError();

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' | 'nexus.shutdown' | 'orchestrator.disposed' | 'orchestrator.funnel.stage' | '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' | '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' | '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';
+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' | 'nexus.shutdown' | 'orchestrator.disposed' | 'orchestrator.funnel.stage' | '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' | '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';
 export interface NexusEventPayloads {
     'system.boot': {
         version: string;
@@ -625,6 +625,13 @@ export interface NexusEventPayloads {
         subject: string;
         error: string;
     };
+    'architects.event.failed': {
+        event: string;
+        operativeId?: string;
+        missionId?: string;
+        strikeTeamId?: string;
+        error: string;
+    };
     'ledger.duplicate-prevented': {
         fingerprint: string;
         existingId: string;

package/dist/synapse/bootstrap.js

@@ -144,7 +144,7 @@ export function initSynapse(options) {
         if (payload.operativeId) {
             db.prepare('UPDATE synapse_operatives SET health_state=\'BLOCKED\', state=\'SUSPENDED\', suspend_reason=\'manual\' WHERE id=?').run(payload.operativeId);
             nexusEventBus.emit('synapse.operative.health.changed', { operativeId: payload.operativeId, healthState: 'BLOCKED' });
-            providers.memory.store(`[Architects:Blocked] ${payload.operativeId} ${payload.reason ?? ''}`.trim(), 0.82, ['#synapse', '#blocked']);
+            providers.memory.store(`[Architects:Blocked] ${payload.operativeId} ${payload.reason ?? ''}`.trim(), 0.82, ['#synapse', '#blocked'], undefined, 0, { provenance: { agentId: payload.operativeId, source: 'system' } });
         }
     };
     const stallListener = ({ operativeId }) => {

package/dist/synapse/mandate/pipeline.js

@@ -157,7 +157,12 @@ export async function executeMandatePipeline(db, mandateText, providers, opts =
             correlationId: teamId,
             status: 'deployed',
         });
-        providers.memory.store(`[Synapse:Mandate] ${mandateText}`, 0.85, ['#synapse', '#mandate', `#team:${teamId}`]);
+        providers.memory.store(`[Synapse:Mandate] ${mandateText}`, 0.85, ['#synapse', '#mandate', `#team:${teamId}`], undefined, 0, {
+            provenance: {
+                source: 'runtime',
+                containerTags: [`#team:${teamId}`, ...(worklistId ? [`#worklist:${worklistId}`] : [])],
+            },
+        });
         return getStrikeTeam(db, teamId);
     })();
     return team;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "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",
@@ -25,6 +25,7 @@
     "nexus-prime": "dist/cli.js"
   },
   "scripts": {
+    "prepare": "git config core.hooksPath .hooks || true",
     "nexus:dev": "node dev-orchestrator.mjs",
     "generate:competitive-landscape": "tsx scripts/generate-competitive-landscape.ts",
     "generate:readme-catalog": "tsx scripts/generate-readme-runtime-catalog.ts",