nexus-agents 2.94.0 → 2.96.0

package/README.md

@@ -1,6 +1,6 @@
 # Nexus Agents
 
-> The intelligence layer between you and your AI coding tools
+> Governance substrate for your AI coding agents — adversarial review, drift-detected rules, immutable audit, closed-loop telemetry
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen)](https://nodejs.org)
@@ -12,7 +12,7 @@
 
 ## Overview
 
-Nexus Agents makes your AI coding tools work together intelligently. It coordinates Claude, Codex, Gemini, and OpenCode — routing each task to the best model using data-driven algorithms (LinUCB bandit, TOPSIS scoring, adaptive bonuses), validating outputs through multi-model consensus voting, and continuously improving through outcome-driven learning. Connect it to any MCP-compatible editor and it handles the rest.
+Nexus Agents is a governance layer that sits above your AI coding agents — Claude, Codex, Gemini, and OpenCode. The agents do the engineering; nexus-agents enforces the rules they follow, reviews their work adversarially before it ships, audits everything they touch, and routes the next task based on what actually worked (LinUCB bandit + TOPSIS scoring fed by an outcome store). It connects to any MCP-compatible editor. Routing is a means to the governance end, not the product.
 
 ### Key Capabilities
 
@@ -155,7 +155,7 @@ steps:
 
 ### MCP Tools
 
-The server exposes 24 MCP tools for integration. Key tools include:
+The server exposes 42 MCP tools for integration. Key tools include:
 
 | Tool                 | Description                                    |
 | -------------------- | ---------------------------------------------- |
@@ -213,7 +213,7 @@ MCP Server (external boundary)
     ↓
 Orchestration Layer (workflows, graph execution, worker dispatch)
     ↓
-Agents Layer (Orchestrator, 10 Expert types)
+Agents Layer (Orchestrator, 12 Expert types)
     ↓
 Adapters Layer (Claude, Gemini, Codex, OpenCode CLIs)
     ↓

package/dist/{child-mcp-config-PPFHJZSO.js → child-mcp-config-HZUEFKXB.js}

@@ -1,6 +1,6 @@
 import {
   createLogger
-} from "./chunk-OT6V5ROA.js";
+} from "./chunk-2KHD2ANY.js";
 import "./chunk-CH7QIDHQ.js";
 import "./chunk-PR4QN5HX.js";
 
@@ -59,4 +59,4 @@ export {
   generateMcpConfig,
   getDefaultAllowedTools
 };
-//# sourceMappingURL=child-mcp-config-PPFHJZSO.js.map
+//# sourceMappingURL=child-mcp-config-HZUEFKXB.js.map

package/dist/{chunk-77JUKFTG.js → chunk-23NNSR45.js}

@@ -1,6 +1,6 @@
 import {
   DEFAULTS
-} from "./chunk-43UDRX3N.js";
+} from "./chunk-MMW4KIBH.js";
 import {
   resolveInsideRoot
 } from "./chunk-NUBSJGQZ.js";
@@ -10,7 +10,7 @@ import {
 import {
   createAllAdapters,
   probeCli
-} from "./chunk-4QESFYGV.js";
+} from "./chunk-XMYJWMWN.js";
 import {
   CliNameSchema,
   DEFAULT_CAPABILITIES,
@@ -26,7 +26,7 @@ import {
   ok,
   symbols,
   writeLine
-} from "./chunk-OT6V5ROA.js";
+} from "./chunk-2KHD2ANY.js";
 import {
   detectSandbox,
   getLearningDir,
@@ -40,7 +40,7 @@ import {
 } from "./chunk-CH7QIDHQ.js";
 
 // src/version.ts
-var VERSION = true ? "2.94.0" : "dev";
+var VERSION = true ? "2.96.0" : "dev";
 
 // src/config/schemas-core.ts
 import { z } from "zod";
@@ -2096,7 +2096,7 @@ async function runDoctorFix(result) {
   writeLine2("\u2500".repeat(40));
   let fixCount = 0;
   if (!result.dataDirectory.rootExists || result.dataDirectory.subdirectories.some((d) => !d.exists || !d.writable)) {
-    const { runSetup } = await import("./setup-command-6WVEOE4Q.js");
+    const { runSetup } = await import("./setup-command-U3ILRY5H.js");
     const setupResult = runSetup({
       skipMcp: true,
       skipRules: true,
@@ -2110,7 +2110,7 @@ async function runDoctorFix(result) {
     }
   }
   if (!result.configFile.found) {
-    const { runConfigInitSync } = await import("./setup-config-KUZU2GFI.js");
+    const { runConfigInitSync } = await import("./setup-config-WZYLXPDO.js");
     const configResult = runConfigInitSync(process.cwd(), false, false);
     if (configResult.success && configResult.created) {
       writeLine2(`\u2713 Generated config: ${configResult.path}`);
@@ -2208,4 +2208,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-77JUKFTG.js.map
+//# sourceMappingURL=chunk-23NNSR45.js.map

package/dist/{chunk-G5EBHQ2L.js → chunk-2472O6HR.js}

@@ -8,7 +8,7 @@ import {
   getErrorMessage,
   ok,
   parseBoolEnv
-} from "./chunk-OT6V5ROA.js";
+} from "./chunk-2KHD2ANY.js";
 
 // src/cli/research-helpers-synthesize.ts
 import { z } from "zod";
@@ -1015,4 +1015,4 @@ export {
   AttributedInsightSchema,
   synthesizeResearch
 };
-//# sourceMappingURL=chunk-G5EBHQ2L.js.map
+//# sourceMappingURL=chunk-2472O6HR.js.map

package/dist/{chunk-OT6V5ROA.js → chunk-2KHD2ANY.js}

@@ -513,8 +513,22 @@ var BoundedLRUCache = class {
 var TUNE_DEMOTION_FLOOR = 0.5;
 var TUNE_MAX_STEP = 0.2;
 var TUNE_DECAY_WINDOW_MS = 30 * 6e4;
+var STAT_REASON_MAX = 512;
 var TuneAdjustmentStore = class {
   adjustments = /* @__PURE__ */ new Map();
+  /** Cumulative telemetry — never evicted (bounded by CLI cardinality). */
+  stats = /* @__PURE__ */ new Map();
+  /** Increment a CLI's cumulative demotion counter. Pure telemetry. */
+  bumpStat(cli, kind, reason) {
+    let stat = this.stats.get(cli);
+    if (stat === void 0) {
+      stat = { cli, applied: 0, intended: 0, lastReason: "", lastAt: 0 };
+      this.stats.set(cli, stat);
+    }
+    stat[kind] += 1;
+    stat.lastReason = reason.length > STAT_REASON_MAX ? reason.slice(0, STAT_REASON_MAX) : reason;
+    stat.lastAt = getTimeProvider().now();
+  }
   /**
    * Apply a bounded demotion to `cli`. `magnitude` is the requested reduction
    * (capped to {@link TUNE_MAX_STEP}); compounds on any current (decayed) value
@@ -533,8 +547,20 @@ var TuneAdjustmentStore = class {
       reason
     };
     this.adjustments.set(cli, adjustment);
+    this.bumpStat(cli, "applied", reason);
     return adjustment;
   }
+  /**
+   * Record a demotion the loop WOULD have applied, for shadow-soak telemetry
+   * (#3323) — increments the `intended` counter ONLY and does NOT touch the
+   * routing adjustments. Lets an operator observe what enabling the loop would
+   * do (via {@link demotionStats}) while `effectiveMultiplier` stays 1.0 and
+   * routing is untouched. Non-empty `reason` required; otherwise a no-op.
+   */
+  recordIntended(cli, reason) {
+    if (reason === "") return;
+    this.bumpStat(cli, "intended", reason);
+  }
   /**
    * Current effective multiplier for `cli` — the stored multiplier decayed
    * linearly back toward 1.0 over {@link TUNE_DECAY_WINDOW_MS}. Returns 1.0
@@ -556,9 +582,17 @@ var TuneAdjustmentStore = class {
   list() {
     return [...this.adjustments.values()];
   }
-  /** Remove all adjustments. */
+  /**
+   * Cumulative demotion telemetry per CLI (#3323) — survives decay, so a shadow
+   * soak shows how often each CLI is (or would be) demoted. Read-only snapshot.
+   */
+  demotionStats() {
+    return [...this.stats.values()].map((s) => ({ ...s })).sort((a, b) => a.cli.localeCompare(b.cli));
+  }
+  /** Remove all adjustments and telemetry. */
   clear() {
     this.adjustments.clear();
+    this.stats.clear();
   }
 };
 var singleton;
@@ -10842,7 +10876,7 @@ function aggregateStageScores(scoring, taskContent, candidates) {
 var TUNE_ENFORCE_ENV = "NEXUS_TUNE_ENFORCE";
 function getTuneAdjustmentScores(candidates) {
   const scores = /* @__PURE__ */ new Map();
-  if (!parseBoolEnv(TUNE_ENFORCE_ENV, false)) return scores;
+  if (!parseBoolEnv(TUNE_ENFORCE_ENV, true)) return scores;
   const store = getTuneAdjustmentStore();
   for (const cli of candidates) {
     const multiplier = store.effectiveMultiplier(cli);
@@ -11388,7 +11422,7 @@ var CompositeRouter = class _CompositeRouter {
    */
   async consultUnifiedContext(task) {
     try {
-      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-JM564MOV.js");
+      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-PTRDEBBH.js");
       const ctx = await getContextForTask({
         task: task.content,
         category: inferTaskCategory(task.content),
@@ -12662,6 +12696,7 @@ export {
   CompositeRouterConfigSchema,
   DEFAULT_COMPOSITE_CONFIG,
   CompositeRoutingError,
+  parseIntEnv,
   parseBoolEnv,
   createGetTimeout,
   createGetRetryConfig,
@@ -12719,4 +12754,4 @@ export {
   ParseError,
   OrchestratorError
 };
-//# sourceMappingURL=chunk-OT6V5ROA.js.map
+//# sourceMappingURL=chunk-2KHD2ANY.js.map