nexus-prime 7.9.27 → 7.9.28

package/README.md

@@ -38,9 +38,9 @@
   <a href="https://www.producthunt.com/products/nexus-prime?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-nexus-prime" target="_blank" rel="noopener noreferrer"><img alt="Nexus-Prime — Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1096831&theme=dark&t=1773345508816"></a>
 </div>
 
-> **Coding agents were never built to remember. Nexus Prime gives them a memory.**
+> **Stop restarting your coding agents from zero.**
 >
-> Install once. Every coding agent on your machine gets smarter — together.
+> Nexus Prime gives Claude Code, Codex, Cursor, Windsurf, OpenCode, Aider, and the rest of your local agent stack one shared memory, one proof trail, and one dashboard for what actually happened.
 
 ---
 
@@ -74,14 +74,15 @@ Agents should start with `nexus_session_bootstrap`, then route the raw request t
 
 ---
 
-## Provenance and social proof
+## Why teams install it
 
-Nexus Prime now treats provenance as a product surface, not a footer afterthought.
+Nexus Prime is the local-first control plane for serious AI-assisted coding.
 
-- Every Nexus-enabled PR can carry a **Nexus Prime Presence** block that links back to https://nexus-prime.cfd/ and states whether Nexus observed, verified, assisted, authored, or published the change.
-- Nexus-generated commits use the repo-local Git-native `Co-Authored-By` trailer for the Nexus Prime GitHub identity; human-only commits are not falsely claimed.
-- Generated artifacts can include a Nexus Prime signature with run ID, verification state, human-review state, and website proof.
-- Opt-in telemetry can send privacy-safe PLG events such as `pr_presence_added`, `commit_attributed`, `document_signed`, `release_verified`, and `proof_badge_viewed` to the configured Supabase endpoint. Raw prompts, code, repo names, branch names, file paths, secrets, and tokens are redacted by default.
+- **Shared memory for every agent.** Your tools stop acting like strangers and start carrying useful context across sessions.
+- **Lower token waste.** Nexus routes agents toward the files and facts that matter instead of rereading the repo every turn.
+- **Runtime truth you can inspect.** The dashboard shows runs, memory, token savings, and agent activity instead of hiding the messy parts.
+- **Safer multi-file work.** Planning, verification, and handoff state stay attached to the repo, so interrupted work is easier to resume and review.
+- **Local by default.** Your code and agent memory stay on your machine unless you explicitly opt into something else.
 
 ---
 
@@ -95,7 +96,7 @@ One tracked session was measured at **100,000,000 tokens**. Ninety-nine point fo
 
 This is **agent amnesia** — and it's the quiet tax on every hour you spend with AI-assisted coding.
 
-**Nexus Prime ends it.**
+**Nexus Prime turns that cold start into a remembered workspace.**
 
 ---
 
@@ -458,7 +459,8 @@ Nexus Prime was designed privacy-first, because the code on your machine is your
 |---------|-------------------|
 | 💬 [**Discord**](https://discord.gg/tByGZgk5gS) | Real-time help, show-and-tell, feature ideas |
 | 🔴 [**Reddit — r/Nexus_Prime**](https://www.reddit.com/r/Nexus_Prime/) | Long-form posts, releases, community wins |
-| 🐦 [**X / Twitter**](https://x.com/nexusprime_ai) | Launch announcements, tips, updates |
+| 🐦 [**X / Twitter**](https://x.com/getnexusprime) | Launch announcements, tips, updates |
+| 📸 [**Instagram**](https://www.instagram.com/nexus_prime.cfd/) | Product clips, launch updates, behind-the-scenes |
 | 📧 [**adarsh@nexus-prime.cfd**](mailto:adarsh@nexus-prime.cfd) | License requests, upgrades, pilots, enterprise |
 | 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | General support, press, community |
 | 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) | Product site, demos, pricing, setup guides |

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

@@ -238,7 +238,7 @@ export function buildMcpToolDefinitions() {
                 properties: {
                     goal: { type: 'string', description: 'Raw goal or task description for this session' },
                     files: { type: 'array', items: { type: 'string' }, description: 'Optional candidate file constraints' },
-                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug'], description: 'Response verbosity; defaults to compact for MCP callers' },
+                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug', 'full'], description: 'Response verbosity; defaults to compact for MCP callers' },
                     depth: { type: 'string', enum: ['fast', 'deep'], description: 'Optional bootstrap depth override; defaults to fast unless debug mode is requested' },
                     include: { type: 'array', items: { type: 'string' }, description: 'Optional rich payload sections to include for advanced clients' },
                     intent: { type: 'string', enum: ['inspect', 'plan', 'mutate'], description: 'Requested orchestration stance for the bootstrap summary' },
@@ -268,7 +268,7 @@ export function buildMcpToolDefinitions() {
                 properties: {
                     prompt: { type: 'string', description: 'Raw prompt or objective to orchestrate end-to-end' },
                     files: { type: 'array', items: { type: 'string' }, description: 'Optional hard constraints for candidate files' },
-                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug'], description: 'Response verbosity; defaults to compact for MCP callers' },
+                    detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug', 'full'], description: 'Response verbosity; defaults to compact for MCP callers' },
                     intent: { type: 'string', enum: ['inspect', 'plan', 'mutate'], description: 'Requested orchestration stance; inspect/plan should stay read-only' },
                     topology: { type: 'string', enum: ['auto', 'manager-tools', 'handoff', 'dag-pool', 'worktree-swarm'], description: 'Requested orchestration topology hint' },
                     workers: { type: 'number', description: 'Optional worker override' },
@@ -282,6 +282,7 @@ export function buildMcpToolDefinitions() {
                     executionPreset: { type: 'string', enum: ['fast', 'balanced', 'deep', 'release'], description: 'Optional execution preset that maps orchestration depth, verification strictness, and backend routing' },
                     background: { type: 'boolean', description: 'Compatibility flag; nexus_orchestrate already returns a queued hiring preflight by default and continues in the async gate.' },
                     async: { type: 'boolean', description: 'Alias for background; useful for clients that prefer explicit async orchestration.' },
+                    wait: { type: 'boolean', description: 'Alias for inline/sync execution. Waits up to the MCP-safe bounded window and returns the final result when it completes in time.' },
                     waitMs: { type: 'number', description: 'Advanced/debug bounded wait for inline execution. Clamped to 45 seconds; normal orchestrate calls return a queued preflight immediately.' },
                     inline: { type: 'boolean', description: 'Advanced/debug only: wait for inline orchestrate output instead of the default fast queued preflight.' }
                 },

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

@@ -101,7 +101,10 @@ function shouldReturnQueuedReceipt(toolName, args) {
     if (!SLOW_TOOLS.has(toolName))
         return false;
     if (toolName === 'nexus_orchestrate') {
-        return !isTruthyFlag(args.inline) && !isTruthyFlag(args.sync) && !isTruthyFlag(args.blocking);
+        return !isTruthyFlag(args.inline)
+            && !isTruthyFlag(args.sync)
+            && !isTruthyFlag(args.blocking)
+            && !isTruthyFlag(args.wait);
     }
     return isTruthyFlag(args.background)
         || isTruthyFlag(args.async)
@@ -109,8 +112,13 @@ function shouldReturnQueuedReceipt(toolName, args) {
         || isTruthyFlag(args.detach);
 }
 function resolveMaxSyncMs(toolName, args) {
+    const explicitWait = isTruthyFlag(args.wait)
+        || isTruthyFlag(args.inline)
+        || isTruthyFlag(args.sync)
+        || isTruthyFlag(args.blocking);
     return coerceBoundedWaitMs(args.waitMs)
         ?? coerceBoundedWaitMs(args.maxSyncMs)
+        ?? (toolName === 'nexus_orchestrate' && explicitWait ? MAX_CLIENT_SYNC_WAIT_MS : undefined)
         ?? (toolName === 'nexus_orchestrate' ? ORCHESTRATE_DEFAULT_MAX_SYNC_MS : DEFAULT_MAX_SYNC_MS);
 }
 function asStringList(value) {

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

@@ -22,6 +22,8 @@ function renderTable(rows, maxRows = 20) {
 }
 /** Build a compact timing + savings footer line for tool responses. */
 function buildMcpFooter(meta) {
+    if (process.env.NEXUS_MCP_RESPONSE_FOOTER !== '1')
+        return '';
     const ms = meta.durationMs;
     const timing = ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s`;
     return `\n\n─── nexus-prime · ${meta.toolName} · ${timing} · dashboard: http://localhost:${DASH_PORT}/#runtime ───`;

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

@@ -275,7 +275,8 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
             const timings = {
                 totalMs: Date.now() - callStartedAt,
             };
-            const payload = detailLevel === 'debug'
+            const fullBootstrapDetails = detailLevel === 'debug' || detailLevel === 'full';
+            const payload = fullBootstrapDetails
                 ? {
                     depth: bootstrap.depth,
                     workspace,
@@ -390,7 +391,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                         return '';
                                     }
                                 })(),
-                                ...(detailLevel === 'debug' ? [
+                                ...(fullBootstrapDetails ? [
                                     `Bootstrap depth: ${bootstrap.depth || bootstrapDepth}`,
                                     `Execution mode: ${bootstrap.recommendedExecutionMode || 'autonomous'}`,
                                     `Shortlist: ${bootstrap.shortlist?.skills?.slice(0, 3).join(', ') || 'none'} (skills), ${bootstrap.shortlist?.specialists?.slice(0, 3).join(', ') || 'none'} (specialists)`,
@@ -410,7 +411,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                     `Bootstrap status: ${bootstrap.clientBootstrapStatus?.clients?.length || 0} client manifests tracked`,
                                 ] : []),
                             ]),
-                            detailLevel === 'debug' && bootstrap.tokenOptimization?.autoApplied && bootstrap.tokenOptimization?.plan
+                            fullBootstrapDetails && bootstrap.tokenOptimization?.autoApplied && bootstrap.tokenOptimization?.plan
                                 ? `Auto token plan\n\`\`\`txt\n${bootstrap.tokenOptimization.plan}\n\`\`\``
                                 : '',
                             formatJsonDetails('Structured details', payload),
@@ -547,7 +548,36 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                     intent: requestedIntent,
                     topology: requestedTopology,
                 };
+                const verboseDetails = detailLevel === 'debug' || detailLevel === 'full';
                 const compactPayload = {
+                    workspace,
+                    runId: execution.runId,
+                    state: execution.state,
+                    summary: summarizeExecution(execution),
+                    resultPreview: truncateText(execution.result || summarizeExecution(execution), 700),
+                    artifactsPath: execution.artifactsPath,
+                    planner: execution.plannerState
+                        ? {
+                            selectedCrew: execution.plannerState.selectedCrew?.name,
+                            selectedSpecialists: execution.plannerState.selectedSpecialists.slice(0, 4).map((specialist) => specialist.name),
+                            selectedWorkflows: execution.plannerState.selectedWorkflows.slice(0, 4),
+                        }
+                        : undefined,
+                    worktreeHealth: runtimeUsage.worktreeHealth
+                        ? {
+                            repoRoot: runtimeUsage.worktreeHealth.repoRoot,
+                            overall: runtimeUsage.worktreeHealth.overall,
+                            brokenEntries: runtimeUsage.worktreeHealth.brokenEntries,
+                            repairedEntries: runtimeUsage.worktreeHealth.repairedEntries,
+                            issues: runtimeUsage.worktreeHealth.issues,
+                        }
+                        : undefined,
+                    modelRoute: selectionSummary.modelRoute,
+                    verifiedWorkers,
+                    continuationChildren: execution.continuationChildren.length,
+                    timings,
+                };
+                const standardPayload = {
                     workspace,
                     runId: execution.runId,
                     state: execution.state,
@@ -616,31 +646,43 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                     timings,
                     payloadRef,
                 };
-                const payload = detailLevel === 'debug' ? debugPayload : compactPayload;
+                const payload = verboseDetails
+                    ? debugPayload
+                    : detailLevel === 'standard'
+                        ? standardPayload
+                        : compactPayload;
+                const verboseResponse = detailLevel !== 'compact';
+                const stateLine = execution.state === 'inspected'
+                    ? 'Orchestrated run inspected (read-only advisory; no diff expected).'
+                    : `Orchestrated run ${execution.state}.`;
                 return {
                     content: [{
                             type: 'text',
                             text: [
                                 upfrontTokenNote ? `[Token plan] ${upfrontTokenNote}` : '',
-                                `Orchestrated run ${execution.state}.`,
+                                stateLine,
                                 formatBullets([
                                     `Workspace: ${workspace.repoName} (${workspace.workspaceSource})`,
                                     `Run ID: ${execution.runId}`,
                                     `Summary: ${summarizeExecution(execution)}`,
                                     `Crew: ${execution.plannerState?.selectedCrew?.name || 'baseline path'}`,
-                                    `Decomposition: ${selectionSummary.phaseCount} phase(s), ${selectionSummary.workerLaneCount} worker lane(s), ${selectionSummary.mode}`,
                                     `Hired/selected: crew ${selectionSummary.crew}; specialists ${formatSelectionList(selectionSummary.specialists)}; workflows ${formatSelectionList(selectionSummary.workflows)}; skills ${formatSelectionList(selectionSummary.skills)}`,
-                                    `Model route: ${formatModelRoute(selectionSummary.modelRoute)}`,
-                                    `Budget route: ${selectionSummary.budgetRoute || 'budget pending'}`,
-                                    selectionSummary.agentFlow?.stages?.length
-                                        ? `AgentFlow gates: ${selectionSummary.agentFlow.stages.map((stage) => `${stage.stage}:${stage.ownerRole}`).join(' -> ')}`
-                                        : null,
-                                    `Selection audit: ${selectionSummary.auditSelected} selected, ${selectionSummary.auditRejected} rejected`,
+                                    ...(verboseResponse ? [
+                                        `Decomposition: ${selectionSummary.phaseCount} phase(s), ${selectionSummary.workerLaneCount} worker lane(s), ${selectionSummary.mode}`,
+                                        `Model route: ${formatModelRoute(selectionSummary.modelRoute)}`,
+                                        `Budget route: ${selectionSummary.budgetRoute || 'budget pending'}`,
+                                        selectionSummary.agentFlow?.stages?.length
+                                            ? `AgentFlow gates: ${selectionSummary.agentFlow.stages.map((stage) => `${stage.stage}:${stage.ownerRole}`).join(' -> ')}`
+                                            : null,
+                                        `Selection audit: ${selectionSummary.auditSelected} selected, ${selectionSummary.auditRejected} rejected`,
+                                    ] : [
+                                        `Model route: ${formatModelRoute(selectionSummary.modelRoute)}`,
+                                    ]),
                                     `Verification: ${verifiedWorkers}/${execution.workerResults.length} worker(s) verified`,
-                                    `Tokens: saved ${Number(execution.tokenTelemetry?.savedTokens || 0).toLocaleString()} · compression ${Number(execution.tokenTelemetry?.compressionPct || 0)}%`,
+                                    verboseResponse ? `Tokens: saved ${Number(execution.tokenTelemetry?.savedTokens || 0).toLocaleString()} · compression ${Number(execution.tokenTelemetry?.compressionPct || 0)}%` : null,
                                     autoTokenApplyNote || null,
-                                    `Payload ref: ${workspace.stateKey} · ${detailLevel}`,
-                                    ...(detailLevel === 'debug' ? [
+                                    verboseResponse ? `Payload ref: ${workspace.stateKey} · ${detailLevel}` : null,
+                                    ...(verboseDetails ? [
                                         `Specialists: ${execution.plannerState?.selectedSpecialists.map((specialist) => specialist.name).slice(0, 4).join(', ') || 'none selected'}`,
                                         `Assets: ${(execution.activeSkills || []).length} skills · ${(execution.activeWorkflows || []).length} workflows · ${(runtimeUsage.artifactSelectionAudit?.selected?.length || 0)} audited selections`,
                                         `Task graph: ${runtimeUsage.taskGraph?.phases?.length || execution.taskGraph?.phases?.length || 0} phases · ${runtimeUsage.workerPlan?.totalWorkers || execution.workerPlan?.totalWorkers || 0} workers`,
@@ -652,9 +694,9 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                         `Payload ref: ${workspace.stateKey} · ${detailLevel}`,
                                     ] : []),
                                 ]),
-                                detailLevel === 'debug' && execution.result ? `Result\n\`\`\`\n${execution.result}\n\`\`\`` : `Result preview\n\`\`\`\n${truncateText(execution.result || summarizeExecution(execution), 900)}\n\`\`\``,
+                                verboseDetails && execution.result ? `Result\n\`\`\`\n${execution.result}\n\`\`\`` : `Result preview\n\`\`\`\n${truncateText(execution.result || summarizeExecution(execution), 900)}\n\`\`\``,
                                 formatJsonDetails('Structured details', payload),
-                                hctx.formatRemainingProtocolSteps(),
+                                verboseResponse ? hctx.formatRemainingProtocolSteps() : '',
                             ].filter(Boolean).join('\n\n'),
                         }],
                 };
@@ -684,7 +726,7 @@ export async function handleOrchestrationGroup(toolName, hctx, request, args, ct
                                     runtimeUsage?.skipReasons?.length ? `Skipped stages: ${runtimeUsage.skipReasons.join(' · ')}` : 'Skipped stages: not recorded',
                                 ]),
                                 formatJsonDetails('Structured details', payload),
-                                hctx.formatRemainingProtocolSteps(),
+                                detailLevel !== 'compact' ? hctx.formatRemainingProtocolSteps() : '',
                             ].join('\n\n'),
                         }],
                 };

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

@@ -90,7 +90,7 @@ export function formatJsonDetails(label, value) {
 }
 export function normalizeDetailLevel(value) {
     const normalized = String(value ?? 'compact').toLowerCase();
-    if (normalized === 'standard' || normalized === 'debug')
+    if (normalized === 'standard' || normalized === 'debug' || normalized === 'full')
         return normalized;
     return 'compact';
 }
@@ -100,7 +100,7 @@ export function normalizeBootstrapDepth(value, detailLevel) {
         return 'deep';
     if (normalized === 'fast')
         return 'fast';
-    return detailLevel === 'debug' ? 'deep' : 'fast';
+    return detailLevel === 'debug' || detailLevel === 'full' ? 'deep' : 'fast';
 }
 export function normalizeResponseIntent(value) {
     const normalized = String(value ?? 'inspect').toLowerCase();

package/dist/agents/adapters/mcp/types.d.ts

@@ -14,7 +14,7 @@ import type { SessionDNAManager } from '../../../engines/session-dna.js';
 import type { NgramIndex } from '../../../engines/ngram-index.js';
 export type McpToolProfile = 'autonomous' | 'full';
 export type LifecyclePhase = 'pre-bootstrap' | 'bootstrapped' | 'orchestrated' | 'working' | 'closing';
-export type ResponseDetailLevel = 'compact' | 'standard' | 'debug';
+export type ResponseDetailLevel = 'compact' | 'standard' | 'debug' | 'full';
 export type ResponseIntent = 'inspect' | 'plan' | 'mutate';
 export type ResponseTopology = 'auto' | 'manager-tools' | 'handoff' | 'dag-pool' | 'worktree-swarm';
 /** Session-level telemetry tracker. Moved to types.ts so handler files can

package/dist/index.js

@@ -103,7 +103,9 @@ export class NexusPrime {
             workspaceRoot: config?.runtime?.workspaceRoot,
         });
         markStartup('workspace:resolve:done');
-        process.env.NEXUS_WORKSPACE_ROOT = this.workspaceContext.workspaceRoot;
+        if (this.workspaceContext.workspaceSource !== 'package') {
+            process.env.NEXUS_WORKSPACE_ROOT = this.workspaceContext.workspaceRoot;
+        }
         const memoryDbPath = config?.memory?.cortex?.path ?? process.env.NEXUS_MEMORY_DB_PATH;
         this.config = {
             network: {

package/dist/licensing/enforcement.js

@@ -12,12 +12,29 @@
 import { getSharedLicenseManager } from './license-manager.js';
 import { getToolTier, isToolAllowed } from './tool-tiers.js';
 import { toolGateMessage, capWarningMessage, capExceededMessage, noLicenseMessage, trialActiveMessage, trialExpiredMessage, } from './upgrade-prompts.js';
+const MCP_RESPONSE_ADAPTERS = new Set([
+    'mcp',
+    'claude-code',
+    'codex',
+    'cursor',
+    'opencode',
+    'windsurf',
+    'hermes',
+    'nanoclaw',
+    'picoclaw',
+    'openclaw',
+]);
 function getMode() {
     const val = (process.env.NEXUS_ENFORCEMENT_MODE ?? 'soft').toLowerCase();
     if (val === 'audit' || val === 'hard')
         return val;
     return 'soft';
 }
+function shouldAppendUpgradeHint(ctx) {
+    if (process.env.NEXUS_LICENSE_MCP_HINTS === '1')
+        return true;
+    return !MCP_RESPONSE_ADAPTERS.has(String(ctx.adapterName ?? '').toLowerCase());
+}
 // Tools that create resources subject to quantity caps
 const MEMORY_CREATION_TOOLS = new Set(['nexus_store_memory']);
 const OPERATIVE_CREATION_TOOLS = new Set(['nexus_synapse_hire', 'nexus_synapse_mandate']);
@@ -122,7 +139,7 @@ export const LicenseEnforcementMiddleware = {
     },
     after(ctx, result) {
         const hint = ctx.meta.licenseUpgradeHint;
-        if (hint && result.content) {
+        if (hint && result.content && shouldAppendUpgradeHint(ctx)) {
             result.content.push({ type: 'text', text: `\n---\n${hint}` });
         }
     },

package/dist/phantom/runtime.d.ts

@@ -385,7 +385,7 @@ export declare class SubAgentRuntime {
         tokenAutoApplied?: boolean;
         toolProfile?: 'autonomous' | 'full';
         instructionFiles?: string[];
-        detailLevel?: 'compact' | 'standard' | 'debug';
+        detailLevel?: 'compact' | 'standard' | 'debug' | 'full';
         intent?: 'inspect' | 'plan' | 'mutate';
         topology?: 'auto' | 'manager-tools' | 'handoff' | 'dag-pool' | 'worktree-swarm';
     }): RuntimeRegistrySnapshot;

package/package.json

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