nexus-prime 7.9.21 → 7.9.23

package/dist/engines/client-bootstrap.js

@@ -19,7 +19,14 @@ function buildWelcomeMemoryTags(workspaceStateKey) {
 }
 const CODEX_MANAGED_START = '<!-- nexus-prime:codex-bootstrap:start -->';
 const CODEX_MANAGED_END = '<!-- nexus-prime:codex-bootstrap:end -->';
-const SUPPORTED_CLIENTS = ['codex', 'cursor', 'claude', 'claude-code', 'claude-desktop', 'opencode', 'windsurf', 'antigravity', 'openclaw', 'aider', 'continue', 'cline'];
+const SUPPORTED_CLIENTS = ['codex', 'cursor', 'claude', 'claude-code', 'claude-desktop', 'opencode', 'windsurf', 'antigravity', 'openclaw', 'hermes', 'nanoclaw', 'picoclaw', 'aider', 'continue', 'cline'];
+const HOME_SKILL_BUNDLE_DIRS = {
+    antigravity: join(homedir(), '.antigravity', 'skills', 'nexus-prime'),
+    openclaw: join(homedir(), '.openclaw', 'skills', 'nexus-prime'),
+    hermes: join(homedir(), '.hermes', 'skills', 'nexus-prime'),
+    nanoclaw: join(homedir(), '.nanoclaw', 'skills', 'nexus-prime'),
+    picoclaw: join(homedir(), '.picoclaw', 'skills', 'nexus-prime'),
+};
 const WORKSPACE_SEED_FILES = [
     {
         relativePath: '.agents/README.md',
@@ -499,16 +506,10 @@ function buildInstructionFiles(clientId, packageRoot, workspaceRoot) {
             scope: 'workspace',
         }));
     }
-    if (clientId === 'antigravity') {
+    const homeSkillDir = HOME_SKILL_BUNDLE_DIRS[clientId];
+    if (homeSkillDir) {
         return bundle.artifacts.map((artifact) => ({
-            path: join(homedir(), '.antigravity', 'skills', 'nexus-prime', artifact.fileName),
-            content: artifact.content,
-            scope: 'home',
-        }));
-    }
-    if (clientId === 'openclaw') {
-        return bundle.artifacts.map((artifact) => ({
-            path: join(homedir(), '.openclaw', 'skills', 'nexus-prime', artifact.fileName),
+            path: join(homeSkillDir, artifact.fileName),
             content: artifact.content,
             scope: 'home',
         }));
@@ -640,6 +641,33 @@ export function getSetupDefinition(clientId, options) {
             instructionFiles,
         };
     }
+    if (clientId === 'hermes') {
+        return {
+            id: clientId,
+            label: 'Hermes',
+            workspaceRoot,
+            configPath: join(homedir(), '.hermes', 'mcp.json'),
+            instructionFiles,
+        };
+    }
+    if (clientId === 'nanoclaw') {
+        return {
+            id: clientId,
+            label: 'NanoClaw',
+            workspaceRoot,
+            configPath: join(homedir(), '.nanoclaw', 'mcp.json'),
+            instructionFiles,
+        };
+    }
+    if (clientId === 'picoclaw') {
+        return {
+            id: clientId,
+            label: 'PicoClaw',
+            workspaceRoot,
+            configPath: join(homedir(), '.picoclaw', 'mcp.json'),
+            instructionFiles,
+        };
+    }
     return {
         id: clientId,
         label: 'Antigravity',
@@ -746,12 +774,71 @@ function instructionState(definition, scope) {
         ? 'installed'
         : 'missing';
 }
+const MEMORY_HOOK_CLIENTS = new Set(['codex', 'cursor', 'claude', 'claude-code', 'claude-desktop']);
+function instructionMentionsMemoryHook(content) {
+    return content.includes('nexus_store_memory') && /memory hooks?/i.test(content);
+}
+function hasInstructionMemoryHook(definition) {
+    return definition.instructionFiles.some((file) => {
+        if (!existsSync(file.path))
+            return false;
+        try {
+            return instructionMentionsMemoryHook(readFileSync(file.path, 'utf8'));
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function hasRepoMemoryHookSeed(workspaceRoot) {
+    return ['.agents/hooks/memory-stored-review.md', '.agent/hooks/memory-stored-review.md']
+        .some((relativePath) => existsSync(join(workspaceRoot, relativePath)));
+}
+function hasClaudeCodeMemoryHook() {
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    if (!existsSync(settingsPath))
+        return false;
+    try {
+        const parsed = JSON.parse(readFileSync(settingsPath, 'utf8'));
+        return Boolean(parsed?.hooks?.PostToolUse?.some((entry) => (entry?.hooks?.some((hook) => hook?.command === 'nexus-prime hook memory'))));
+    }
+    catch {
+        return false;
+    }
+}
+function memoryHookStatus(definition) {
+    if (!MEMORY_HOOK_CLIENTS.has(definition.id)) {
+        return {
+            memoryHookReady: false,
+            memoryHookSummary: 'Memory hook readiness is not tracked for this client',
+        };
+    }
+    const instructionReady = hasInstructionMemoryHook(definition);
+    const repoHookReady = hasRepoMemoryHookSeed(definition.workspaceRoot);
+    const nativeHookRequired = definition.id === 'claude' || definition.id === 'claude-code';
+    const nativeHookReady = nativeHookRequired ? hasClaudeCodeMemoryHook() : true;
+    const memoryHookReady = instructionReady && repoHookReady && nativeHookReady;
+    const missing = [
+        instructionReady ? null : 'client instruction wording',
+        repoHookReady ? null : 'repo memory.stored hook seed',
+        nativeHookReady ? null : 'Claude Code PostToolUse hook',
+    ].filter(Boolean);
+    return {
+        memoryHookReady,
+        memoryHookSummary: memoryHookReady
+            ? nativeHookRequired
+                ? 'Memory hooks ready via Claude Code PostToolUse plus Nexus lifecycle memory storage'
+                : 'Memory hooks ready via Nexus lifecycle memory storage and repo memory.stored hook'
+            : `Memory hooks incomplete: ${missing.join(', ')}`,
+    };
+}
 export function statusForDefinition(definition) {
     const configOk = definition.configPath ? hasExpectedConfig(definition) : true;
     const workspaceState = instructionState(definition, 'workspace');
     const homeState = instructionState(definition, 'home');
     const homeReady = configOk && homeState !== 'drifted';
     const workspaceReady = workspaceState === 'installed' || definition.instructionFiles.every((file) => file.scope !== 'workspace');
+    const memoryHook = memoryHookStatus(definition);
     if (configOk && workspaceState !== 'drifted' && homeState !== 'drifted' && workspaceReady) {
         return {
             state: 'installed',
@@ -760,6 +847,7 @@ export function statusForDefinition(definition) {
                 : 'Managed client instructions are current',
             homeReady,
             workspaceReady,
+            ...memoryHook,
         };
     }
     if ((definition.configPath && existsSync(definition.configPath)) || workspaceState !== 'missing' || homeState !== 'missing') {
@@ -770,6 +858,7 @@ export function statusForDefinition(definition) {
                 : 'A client instruction file exists, but the managed Nexus Prime bootstrap block is missing or outdated',
             homeReady,
             workspaceReady,
+            ...memoryHook,
         };
     }
     return {
@@ -777,6 +866,7 @@ export function statusForDefinition(definition) {
         summary: definition.configPath ? 'Setup not installed yet' : 'No managed client instruction file installed yet',
         homeReady: false,
         workspaceReady: false,
+        ...memoryHook,
     };
 }
 export function supportedSetupClients() {
@@ -817,6 +907,9 @@ function isClientPresent(clientId) {
         'cline': () => existsSync(join(home, '.vscode')),
         'antigravity': () => hasBinary('antigravity') || existsSync(join(home, '.antigravity')),
         'openclaw': () => hasBinary('openclaw') || existsSync(join(home, '.openclaw')),
+        'hermes': () => hasBinary('hermes') || existsSync(join(home, '.hermes')),
+        'nanoclaw': () => hasBinary('nanoclaw') || existsSync(join(home, '.nanoclaw')),
+        'picoclaw': () => hasBinary('picoclaw') || existsSync(join(home, '.picoclaw')),
     };
     try {
         return checks[clientId]?.() ?? false;
@@ -914,6 +1007,8 @@ export function collectBootstrapManifest(options) {
                 instructionFiles: definition.instructionFiles.map((file) => file.path),
                 homeReady: status.homeReady,
                 workspaceReady: status.workspaceReady,
+                memoryHookReady: status.memoryHookReady,
+                memoryHookSummary: status.memoryHookSummary,
                 summary: status.summary,
                 updatedAt: Date.now(),
             };

package/dist/engines/client-registry.js

@@ -37,6 +37,30 @@ const KNOWN_CLIENTS = [
         recentPaths: [path.join(HOME, '.antigravity', 'sessions'), path.join(HOME, '.openclaw', 'sessions')],
         adapterNames: ['openclaw'],
     },
+    {
+        clientId: 'hermes',
+        displayName: 'Hermes',
+        aliases: ['hermes'],
+        configPaths: [path.join(HOME, '.hermes')],
+        recentPaths: [path.join(HOME, '.hermes', 'sessions')],
+        adapterNames: ['hermes'],
+    },
+    {
+        clientId: 'nanoclaw',
+        displayName: 'NanoClaw',
+        aliases: ['nanoclaw', 'nano-claw'],
+        configPaths: [path.join(HOME, '.nanoclaw')],
+        recentPaths: [path.join(HOME, '.nanoclaw', 'sessions')],
+        adapterNames: ['nanoclaw'],
+    },
+    {
+        clientId: 'picoclaw',
+        displayName: 'PicoClaw',
+        aliases: ['picoclaw', 'pico-claw'],
+        configPaths: [path.join(HOME, '.picoclaw')],
+        recentPaths: [path.join(HOME, '.picoclaw', 'sessions')],
+        adapterNames: ['picoclaw'],
+    },
     {
         clientId: 'opencode',
         displayName: 'Opencode',
@@ -412,6 +436,12 @@ export class ClientRegistry {
             return 'opencode';
         if (process.env.OPENCLAW_HOME || process.env.ANTIGRAVITY_HOME)
             return 'antigravity';
+        if (process.env.HERMES_HOME || process.env.HERMES_SESSION)
+            return 'hermes';
+        if (process.env.NANOCLAW_HOME || process.env.NANOCLAW_SESSION)
+            return 'nanoclaw';
+        if (process.env.PICOCLAW_HOME || process.env.PICOCLAW_SESSION)
+            return 'picoclaw';
         if (process.env.WINDSURF_HOME || process.env.WINDSURF_SESSION)
             return 'windsurf';
         if (process.env.MCP_CLIENT_NAME) {
@@ -438,6 +468,12 @@ export class ClientRegistry {
                 return 'windsurf';
             if (ps.includes('antigravity') || ps.includes('openclaw'))
                 return 'antigravity';
+            if (ps.includes('hermes'))
+                return 'hermes';
+            if (ps.includes('nanoclaw') || ps.includes('nano-claw'))
+                return 'nanoclaw';
+            if (ps.includes('picoclaw') || ps.includes('pico-claw'))
+                return 'picoclaw';
         }
         catch (error) {
             this.disableProcessScanIfUnavailable(error);
@@ -461,6 +497,15 @@ export class ClientRegistry {
         if (clientId === 'antigravity' && (process.env.OPENCLAW_HOME || process.env.ANTIGRAVITY_HOME)) {
             return 'env:ANTIGRAVITY detected';
         }
+        if (clientId === 'hermes' && (process.env.HERMES_HOME || process.env.HERMES_SESSION)) {
+            return 'env:HERMES detected';
+        }
+        if (clientId === 'nanoclaw' && (process.env.NANOCLAW_HOME || process.env.NANOCLAW_SESSION)) {
+            return 'env:NANOCLAW detected';
+        }
+        if (clientId === 'picoclaw' && (process.env.PICOCLAW_HOME || process.env.PICOCLAW_SESSION)) {
+            return 'env:PICOCLAW detected';
+        }
         if (clientId === 'windsurf' && (process.env.WINDSURF_HOME || process.env.WINDSURF_SESSION)) {
             return 'env:WINDSURF detected';
         }
@@ -562,6 +607,12 @@ export class ClientRegistry {
 function normalizeDisplayName(value) {
     if (value === 'openclaw')
         return 'Antigravity';
+    if (value === 'hermes')
+        return 'Hermes';
+    if (value === 'nanoclaw' || value === 'nano-claw')
+        return 'NanoClaw';
+    if (value === 'picoclaw' || value === 'pico-claw')
+        return 'PicoClaw';
     if (value === 'claude-code')
         return 'Claude Code';
     if (value === 'cursor')

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.snapshot' | 'memory.health.tick' | 'memory.sqlite.retry' | 'pod.signal' | 'tokens.optimized' | 'tokens.searchSaved' | 'orchestration.decomposed' | 'orchestration.completed' | '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.striketeam.finished' | '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 type NexusEventType = 'system.boot' | 'planner.stage' | 'memory.store' | 'memory.dedup' | 'memory.recall' | 'memory.flushed' | 'memory.snapshot' | 'memory.health.tick' | 'memory.sqlite.retry' | 'pod.signal' | 'tokens.optimized' | 'tokens.searchSaved' | 'orchestration.decomposed' | 'orchestration.completed' | '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.striketeam.finished' | 'synapse.mission.assigned' | 'synapse.mission.completed' | 'synapse.sortie.started' | 'synapse.sortie.selection' | '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;
@@ -24,6 +24,10 @@ export interface NexusEventPayloads {
     'memory.recall': {
         query: string;
         count: number;
+        k?: number;
+        crossClient?: boolean;
+        format?: string;
+        preview?: string[];
     };
     'memory.flushed': {
         count: number;
@@ -442,7 +446,10 @@ export interface NexusEventPayloads {
         operativeId: string;
         name: string;
         skillId: string | null;
-        strikeTeamId: string;
+        specialistId?: string | null;
+        roleTitle?: string | null;
+        reportsToOperativeId?: string | null;
+        strikeTeamId: string | null;
     };
     'synapse.operative.retired': {
         operativeId: string;
@@ -455,6 +462,7 @@ export interface NexusEventPayloads {
         strikeTeamId: string;
         operativeCount: number;
         missionCount: number;
+        selectionSummary?: unknown;
         worklistId?: string | null;
         correlationId?: string | null;
     };
@@ -489,6 +497,16 @@ export interface NexusEventPayloads {
         worklistId?: string | null;
         correlationId?: string | null;
     };
+    'synapse.sortie.selection': {
+        sortieId: string;
+        operativeId: string;
+        missionId: string | null;
+        strikeTeamId?: string | null;
+        skillId?: string | null;
+        specialistId?: string | null;
+        workflowSelectors: string[];
+        workerCount: number;
+    };
     'synapse.sortie.completed': {
         sortieId: string;
         operativeId: string;

package/dist/engines/feature-registry.js

@@ -24,6 +24,7 @@ const CLIENT_BOOTSTRAP_TARGETS = [
     { name: 'Opencode', surface: 'bootstrap target', purpose: 'Installs config plus generated markdown bootstrap note.', notes: 'Project note under .agent/client-bootstrap.' },
     { name: 'Windsurf', surface: 'bootstrap target', purpose: 'Installs MCP config plus .windsurfrules.', notes: 'Workspace-scoped rule surface.' },
     { name: 'Antigravity / OpenClaw', surface: 'bootstrap target', purpose: 'Installs MCP config plus split SKILL.md bundles sized to client limits.', notes: 'Home-scoped skill bundle.' },
+    { name: 'Hermes / NanoClaw / PicoClaw', surface: 'bootstrap target', purpose: 'Installs MCP config plus split SKILL.md bundles for peer agent clients.', notes: 'Memory, skills, token budgeting, and workforce tools are exposed through the same MCP surface.' },
 ];
 const DASHBOARD_CAPABILITIES = [
     { name: 'Overview', surface: 'dashboard', purpose: 'Runtime truth, lifetime token telemetry, graph-centered memory view, and system signals.', notes: 'Default operator cockpit.' },

package/dist/engines/instruction-gateway.d.ts

@@ -43,6 +43,8 @@ export interface TokenPolicySnapshot {
     selectedFiles: string[];
     estimatedSavings: number;
     estimatedCompressionPct: number;
+    codeBlockTemplates?: string[];
+    codeBlockReservedTokens?: number;
 }
 export interface GovernanceSnapshot {
     passed: boolean;
@@ -87,6 +89,13 @@ export interface InstructionPacket {
         relayLastError?: string;
     };
     tokenPolicy: TokenPolicySnapshot;
+    codeQualityBlocks: Array<{
+        id: string;
+        title: string;
+        language: string;
+        purpose: string;
+        content: string;
+    }>;
     memoryContext: {
         matches: string[];
         stats?: Pick<MemoryStats, 'prefrontal' | 'hippocampus' | 'cortex' | 'totalLinks'>;

package/dist/engines/instruction-gateway.js

@@ -5,6 +5,9 @@ import { resolveWorkspaceContext } from './workspace-resolver.js';
 export const PACKET_TOKEN_LIMIT = 3500;
 export const CLIENT_BOOTSTRAP_TOKEN_LIMITS = {
     antigravity: 1200,
+    hermes: 1600,
+    nanoclaw: 1200,
+    picoclaw: 1200,
     cursor: 1800,
     windsurf: 1800,
     'claude-code': 2000,
@@ -29,8 +32,11 @@ export const DEFAULT_REQUIRED_SEQUENCE = [
 export const CLIENT_BOOTSTRAP_SEQUENCE = [
     'MUST call `nexus_session_bootstrap(goal, files?)` then `nexus_orchestrate(prompt)` before any non-trivial task.',
     'MUST call `nexus_mindkit_check(action, files)` before mutations; `nexus_ghost_pass(goal, files)` before 3+ file refactors.',
-    'MUST call `nexus_store_memory(content, priority, tags)` after findings and `nexus_session_dna("generate")` at session end.',
+    'Memory hooks are supported: MUST call `nexus_store_memory(content, priority, tags)` after significant findings, user preferences, decisions, pivots, and verification results; never store secrets; call `nexus_session_dna("generate")` at session end.',
+    'Use fenced code blocks for work packets, implementation notes, verification output, and memory write-back so downstream agents can parse the handoff cleanly.',
     'Use `nexus_describe_tool(id)` to load skill/workflow details on demand. Let Nexus select assets by default.',
+    'Use `nexus_list_skills`, `nexus_list_specialists`, and `nexus_work_hire`/`nexus_work_enqueue` when a client needs skills, specialists, Synapse-style hiring, or workforce delegation.',
+    'When workers are selected, state exactly what is being hired: crew, specialists, workflow, model tier, budget guardrail, and verification gate.',
     'If a tool returns `{ "queued": true, "runId": "..." }`, call `nexus_run_status(runId)` every ~5 seconds until status is `completed` or `failed`, then inspect the `result` field.',
     'Repo graph is internal to Nexus. Do not expose or call a separate `code-review-graph` MCP server from client configs.',
     'The n-gram index is active as a bounded lexical fallback for memory, skills, repo search, and graph-unavailable routing.',
@@ -56,6 +62,7 @@ const PROTOCOL_SOURCES = [
     { source: '.agent/rules/quality-gates.md', relativePath: path.join('.agent', 'rules', 'quality-gates.md') },
     { source: '.agent/rules/agent-guardrails.md', relativePath: path.join('.agent', 'rules', 'agent-guardrails.md') },
 ];
+const SKILL_BUNDLE_CLIENT_FAMILIES = new Set(['antigravity', 'hermes', 'nanoclaw', 'picoclaw']);
 export function estimateInstructionTokens(value) {
     return Math.max(1, Math.ceil(String(value || '').length / 4));
 }
@@ -128,6 +135,74 @@ function normalizeHeading(value) {
 function hashValue(value) {
     return createHash('sha1').update(value).digest('hex');
 }
+function renderList(values, fallback = 'none') {
+    return values.length ? values.join(', ') : fallback;
+}
+function buildCodeQualityBlocks(input) {
+    const selectedFiles = dedupeStrings(input.tokenPolicy?.selectedFiles ?? []);
+    const verifyCommands = dedupeStrings([
+        ...(input.manualOverrides ?? []).filter((entry) => /npm|pnpm|yarn|test|lint|build|cargo|pytest/i.test(entry)),
+    ]);
+    const crewName = input.selectedCrew?.name ?? 'baseline';
+    const specialists = (input.selectedSpecialists ?? []).map((specialist) => specialist.name).filter(Boolean);
+    return [
+        {
+            id: 'work-packet',
+            title: 'Work Packet',
+            language: 'yaml',
+            purpose: 'Stable handoff for a hired worker or sub-agent.',
+            content: [
+                `goal: ${JSON.stringify(input.goal)}`,
+                `crew: ${JSON.stringify(crewName)}`,
+                `specialists: [${specialists.map((item) => JSON.stringify(item)).join(', ')}]`,
+                `owned_files: [${selectedFiles.map((item) => JSON.stringify(item)).join(', ')}]`,
+                `non_goals: ["unrelated refactors", "secret reads", "destructive git changes"]`,
+                `done_when: ["diff is scoped", "verification recorded", "memory write-back prepared"]`,
+            ].join('\n'),
+        },
+        {
+            id: 'implementation-notes',
+            title: 'Implementation Notes',
+            language: 'markdown',
+            purpose: 'Keep coding quality explicit before patching.',
+            content: [
+                '### Why',
+                '<one paragraph explaining the product/runtime reason>',
+                '',
+                '### What Changed',
+                '<short list of files and behavior changed>',
+                '',
+                '### Risk',
+                '<blast radius, rollback path, and compatibility notes>',
+            ].join('\n'),
+        },
+        {
+            id: 'verification-output',
+            title: 'Verification Output',
+            language: 'text',
+            purpose: 'Separate real command proof from assumptions.',
+            content: [
+                `commands: ${renderList(verifyCommands, 'project-specific targeted tests, then build/lint when feasible')}`,
+                'passed: <true|false>',
+                'known_failures: <pre-existing or new failure with file/test name>',
+                'not_run: <commands skipped and why>',
+            ].join('\n'),
+        },
+        {
+            id: 'memory-writeback',
+            title: 'Memory Write-Back',
+            language: 'markdown',
+            purpose: 'Reusable project learning without raw secrets or noisy logs.',
+            content: [
+                'Session YYYY-MM-DD: <what changed, why, and what remains>.',
+                '',
+                'Tags: #session-summary #token-budget #orchestration',
+                'Priority: 0.85',
+                'Do not store secrets, raw credentials, or full logs.',
+            ].join('\n'),
+        },
+    ];
+}
 function sectionPriority(source, heading) {
     const normalized = normalizeHeading(`${source} ${heading}`);
     if (normalized.includes('default operating rule'))
@@ -254,7 +329,15 @@ export class InstructionGateway {
                 selectedFiles: (input.tokenPolicy?.selectedFiles ?? []).slice(0, 16),
                 estimatedSavings: Number(input.tokenPolicy?.estimatedSavings ?? 0),
                 estimatedCompressionPct: Number(input.tokenPolicy?.estimatedCompressionPct ?? 0),
+                codeBlockTemplates: (input.tokenPolicy?.codeBlockTemplates ?? [
+                    'work-packet',
+                    'implementation-notes',
+                    'verification-output',
+                    'memory-writeback',
+                ]).slice(0, 8),
+                codeBlockReservedTokens: Number(input.tokenPolicy?.codeBlockReservedTokens ?? 0),
             },
+            codeQualityBlocks: buildCodeQualityBlocks(input),
             memoryContext: {
                 matches: (input.memoryMatches ?? []).slice(0, 3),
                 stats: input.memoryStats ? {
@@ -351,7 +434,7 @@ export class InstructionGateway {
     renderEnvelope(packet, clientId) {
         const family = this.toClientFamily(clientId ?? packet.client?.clientId);
         const markdown = renderInstructionPacketMarkdown(packet);
-        if (family === 'antigravity') {
+        if (SKILL_BUNDLE_CLIENT_FAMILIES.has(family)) {
             return {
                 clientFamily: family,
                 format: 'skill-md',
@@ -489,6 +572,12 @@ export class InstructionGateway {
         const normalized = String(clientId ?? 'codex').toLowerCase();
         if (normalized === 'openclaw' || normalized === 'antigravity')
             return 'antigravity';
+        if (normalized === 'hermes')
+            return 'hermes';
+        if (normalized === 'nanoclaw')
+            return 'nanoclaw';
+        if (normalized === 'picoclaw')
+            return 'picoclaw';
         if (normalized === 'claude-code')
             return 'claude-code';
         if (normalized === 'opencode')
@@ -505,6 +594,12 @@ export class InstructionGateway {
         const family = this.toClientFamily(clientId);
         if (family === 'antigravity')
             return 'Antigravity / OpenClaw';
+        if (family === 'hermes')
+            return 'Hermes';
+        if (family === 'nanoclaw')
+            return 'NanoClaw';
+        if (family === 'picoclaw')
+            return 'PicoClaw';
         if (family === 'claude-code')
             return 'Claude Code';
         if (family === 'opencode')
@@ -518,7 +613,7 @@ export class InstructionGateway {
         return family.charAt(0).toUpperCase() + family.slice(1);
     }
     renderBootstrapArtifacts(family, envelope, tokenLimit) {
-        if (family === 'antigravity') {
+        if (SKILL_BUNDLE_CLIENT_FAMILIES.has(family)) {
             const chunks = this.chunkContent(envelope.content, tokenLimit);
             return chunks.map((chunk, index) => ({
                 fileName: index === 0 ? 'SKILL.md' : `SKILL-${String(index + 1).padStart(2, '0')}.md`,
@@ -596,7 +691,9 @@ export class InstructionGateway {
             '- REQUIRED before broad reading when bootstrap did not auto-apply: call `nexus_optimize_tokens(goal, files)`.',
             '- REQUIRED before file modification or destructive work: call `nexus_mindkit_check(action, filesToModify)`.',
             '- REQUIRED before refactoring 3+ files: call `nexus_ghost_pass(goal, files)`.',
-            '- REQUIRED after significant findings and at session end: call `nexus_store_memory(content, priority, tags)`.',
+            '- Memory hooks are supported: REQUIRED after significant findings, user preferences, decisions, pivots, and verification results: call `nexus_store_memory(content, priority, tags)` without secrets.',
+            '- Use fenced code blocks for work packets, implementation notes, verification output, and memory write-back.',
+            '- When Nexus selects workers, tell the user exactly what is being hired: crew, specialists, workflow, model tier, budget guardrail, and verification gate.',
             '- REQUIRED before ending the session: call `nexus_session_dna(action="generate")`.',
             '- Repo graph is internal to Nexus; do not expose a separate `code-review-graph` MCP server.',
             '- The n-gram index is active as a bounded lexical fallback for memory, skills, repo search, and graph-unavailable routing.',
@@ -639,6 +736,18 @@ export function renderInstructionPacketMarkdown(packet) {
         `- Selected Files: ${packet.tokenPolicy.selectedFiles.join(', ') || 'none'}`,
         `- Estimated Savings: ${packet.tokenPolicy.estimatedSavings}`,
         `- Estimated Compression: ${packet.tokenPolicy.estimatedCompressionPct}%`,
+        `- Code Block Templates: ${packet.tokenPolicy.codeBlockTemplates?.join(', ') || 'none'}`,
+        `- Code Block Reserve: ${packet.tokenPolicy.codeBlockReservedTokens ?? 0}`,
+        ``,
+        `## Coding Quality Blocks`,
+        ...packet.codeQualityBlocks.flatMap((block) => [
+            `### ${block.title}`,
+            block.purpose,
+            '```' + block.language,
+            block.content,
+            '```',
+            ``,
+        ]),
         ``,
         `## Governance`,
         `- Passed: ${packet.governance.passed}`,

package/dist/engines/memory/types.d.ts

@@ -133,6 +133,8 @@ export interface MemoryFeedbackResult {
     item?: MemorySnapshot;
     trust?: number;
     priority?: number;
+    decay?: MemoryDecayProfile;
+    reinforcement?: MemoryReinforcementProfile;
 }
 export interface MemoryRecallMatch {
     content: string;
@@ -176,6 +178,30 @@ export interface MemoryEntityReference {
     type: 'session' | 'run' | 'skill' | 'workflow';
     id: string;
 }
+export type MemoryDecayState = 'fresh' | 'fading' | 'stale' | 'retiring';
+export type MemoryDecayNextAction = 'keep' | 'reinforce' | 'review' | 'archive';
+export interface MemoryDecayProfile {
+    score: number;
+    state: MemoryDecayState;
+    ageDays: number;
+    halfLifeDays: number;
+    retentionHint: MemoryRetentionHint | 'default';
+    nextAction: MemoryDecayNextAction;
+    reasons: string[];
+}
+export interface MemoryReinforcementProfile {
+    score: number;
+    accessCount: number;
+    trust: number;
+    feedbackCount: number;
+    lastFeedbackAt?: number;
+    qmd: {
+        recency: number;
+        frequency: number;
+        relevance: number;
+    };
+    reasons: string[];
+}
 export interface MemorySnapshot {
     id: string;
     tier: MemoryItem['tier'];
@@ -196,6 +222,8 @@ export interface MemorySnapshot {
     freshnessScore: number;
     trustScore: number;
     entropyScore: number;
+    decay: MemoryDecayProfile;
+    reinforcement: MemoryReinforcementProfile;
     provenance: MemoryProvenance;
     expiresAt?: number;
     purgeAt?: number;

package/dist/engines/memory-bridge.d.ts

@@ -1,5 +1,5 @@
 /**
- * Memory Bridge — OpenClaw/Antigravity Memory Synchronization
+ * Memory Bridge — external agent memory synchronization
  *
  * Provides bidirectional memory sync between Nexus Prime and external agent instances.
  * Uses chunked manifest exports by default while remaining backward compatible with

package/dist/engines/memory-bridge.js

@@ -1,5 +1,5 @@
 /**
- * Memory Bridge — OpenClaw/Antigravity Memory Synchronization
+ * Memory Bridge — external agent memory synchronization
  *
  * Provides bidirectional memory sync between Nexus Prime and external agent instances.
  * Uses chunked manifest exports by default while remaining backward compatible with

package/dist/engines/memory.d.ts

@@ -267,7 +267,12 @@ export declare class MemoryEngine {
     private listVaultIndexItems;
     private listContentCheckCandidates;
     private listReconciliationCandidates;
+    private clamp01;
+    private qmdComponents;
     private computeQmdScore;
+    private getFeedbackStats;
+    private buildDecayProfile;
+    private buildReinforcementProfile;
     private applyRecallRerankerHint;
     private getAllItems;
     private getItemsByIds;