nexus-agents 2.93.0 → 2.95.0

package/dist/{chunk-BNHBZRU7.js → chunk-WGA4VGIR.js}

@@ -3,14 +3,14 @@ import {
   createStream,
   requireApiKey,
   validateApiKeyPresence
-} from "./chunk-JEBWSHSU.js";
+} from "./chunk-D3JSXVX3.js";
 import {
   ModelCapability,
   err,
   getCliModelName,
   getTokenEstimator,
   ok
-} from "./chunk-HKISF2E7.js";
+} from "./chunk-ECBH5INZ.js";
 
 // src/adapters/openai-types.ts
 var OPENAI_MODELS = {
@@ -553,4 +553,4 @@ export {
   OpenAIAdapter,
   createOpenAIAdapter
 };
-//# sourceMappingURL=chunk-BNHBZRU7.js.map
+//# sourceMappingURL=chunk-WGA4VGIR.js.map

package/dist/{chunk-57OH2O2U.js → chunk-Y3OOHHKQ.js}

@@ -1,6 +1,6 @@
 import {
   createLogger
-} from "./chunk-HKISF2E7.js";
+} from "./chunk-ECBH5INZ.js";
 
 // src/config/available-models-cache.ts
 var logger = createLogger({ component: "available-models-cache" });
@@ -150,4 +150,4 @@ export {
   getDefaultAvailableModelsCache,
   setDefaultAvailableModelsCache
 };
-//# sourceMappingURL=chunk-57OH2O2U.js.map
+//# sourceMappingURL=chunk-Y3OOHHKQ.js.map

package/dist/{chunk-VSG6RSE6.js → chunk-YYXJ6RTO.js}

@@ -9,11 +9,11 @@ import {
   gateWithReputation,
   resolveReputationGatingMode,
   sanitizeInput
-} from "./chunk-DTFMYM3V.js";
+} from "./chunk-O4LVC4MQ.js";
 import {
   createLogger,
   getTimeProvider
-} from "./chunk-HKISF2E7.js";
+} from "./chunk-ECBH5INZ.js";
 
 // src/dogfooding/pr-reviewer-helpers.ts
 import { randomUUID } from "crypto";
@@ -288,4 +288,4 @@ export {
   formatReviewComment,
   createFailedReview
 };
-//# sourceMappingURL=chunk-VSG6RSE6.js.map
+//# sourceMappingURL=chunk-YYXJ6RTO.js.map

package/dist/{chunk-E3QWWP67.js → chunk-ZICVVBDW.js}

@@ -2,7 +2,7 @@ import {
   TASK_CATEGORIES,
   getAdaptiveBonus,
   getOutcomeStore
-} from "./chunk-HKISF2E7.js";
+} from "./chunk-ECBH5INZ.js";
 
 // src/cli/doctor-deep.ts
 var CLI_NAMES = ["claude", "gemini", "codex", "opencode"];
@@ -106,4 +106,4 @@ export {
   runDeepDiagnostics,
   formatDeepDiagnostics
 };
-//# sourceMappingURL=chunk-E3QWWP67.js.map
+//# sourceMappingURL=chunk-ZICVVBDW.js.map

package/dist/{cli-circuit-breaker-6E4E2IU7.js → cli-circuit-breaker-LNU5DQSB.js}

@@ -1,13 +1,13 @@
 import {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
-} from "./chunk-T73G67GT.js";
-import "./chunk-RTUZSR4R.js";
-import "./chunk-HKISF2E7.js";
+} from "./chunk-3HXWI34V.js";
+import "./chunk-47Z3YPOK.js";
+import "./chunk-ECBH5INZ.js";
 import "./chunk-CH7QIDHQ.js";
 import "./chunk-PR4QN5HX.js";
 export {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
 };
-//# sourceMappingURL=cli-circuit-breaker-6E4E2IU7.js.map
+//# sourceMappingURL=cli-circuit-breaker-LNU5DQSB.js.map

package/dist/cli.js

@@ -13,19 +13,19 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-VSG6RSE6.js";
-import "./chunk-E3QWWP67.js";
+} from "./chunk-YYXJ6RTO.js";
+import "./chunk-ZICVVBDW.js";
 import {
   buildOpenAICompatAdapters,
   loadUsageEvents,
   readOpenAICompatEnv,
   rollupByModel
-} from "./chunk-AZP66FIA.js";
+} from "./chunk-PFOY5ML6.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-5BTRDVWC.js";
-import "./chunk-2T4NV6QT.js";
+} from "./chunk-55G7KQ7F.js";
+import "./chunk-FXVJLJUF.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -158,25 +158,29 @@ import {
   runImprovementReview,
   saveSourcesRegistry,
   setGlobalToolRateLimiterFactory,
+  shutdownFailoverSignals,
   shutdownFeedbackSubscriber,
+  shutdownSwarmHealthSignals,
+  startFailoverSignals,
   startFeedbackSubscriber,
+  startSwarmHealthSignals,
   validateArgs,
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-IJ2AZZVH.js";
+} from "./chunk-FYGZ4MEQ.js";
 import {
   resolveToken
-} from "./chunk-WU3SUA35.js";
+} from "./chunk-5HBDXW44.js";
 import {
   CATEGORY_DISPLAY_NAMES,
   DEFAULT_PR_REVIEW_CONFIG
 } from "./chunk-OK6U5N5Y.js";
-import "./chunk-BNHBZRU7.js";
-import "./chunk-T73G67GT.js";
+import "./chunk-WGA4VGIR.js";
+import "./chunk-3HXWI34V.js";
 import {
   shutdownExpertBridge
-} from "./chunk-XVY3I7JT.js";
+} from "./chunk-2X24T4ZD.js";
 import {
   DEFAULT_VOTE_TIMEOUT_MS,
   ErrorPolicySchema,
@@ -194,34 +198,34 @@ import {
   toolSuccessStructured,
   warnIfSimulatedOutsideTests,
   wrapToolWithTimeout
-} from "./chunk-LJMO5P6O.js";
-import "./chunk-JEBWSHSU.js";
-import "./chunk-2IBJC2EP.js";
+} from "./chunk-VTMQND6B.js";
+import "./chunk-D3JSXVX3.js";
+import "./chunk-LXROEQAO.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry,
   synthesizeResearch
-} from "./chunk-ZOAU7RE4.js";
+} from "./chunk-ECZW5FXN.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-G5IDRWWI.js";
-import "./chunk-CPH6LKXO.js";
+} from "./chunk-4NVYN2MB.js";
+import "./chunk-LZOTH2GI.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-DTFMYM3V.js";
-import "./chunk-ULBKFMVO.js";
+} from "./chunk-O4LVC4MQ.js";
+import "./chunk-BSHDI4BH.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-3ACDP4E6.js";
-import "./chunk-K7VGX37L.js";
+import "./chunk-TEKWQNQ2.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-FTCU55O6.js";
+} from "./chunk-KHZGMF2W.js";
 import {
   CustomExpertDefinitionSchema,
   DATA_SUBDIRECTORIES,
@@ -240,16 +244,13 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-SHSKW5ML.js";
-import "./chunk-SMGH2B3A.js";
-import "./chunk-57OH2O2U.js";
+} from "./chunk-GC5FH2IA.js";
+import "./chunk-QUPPV6UO.js";
+import "./chunk-Y3OOHHKQ.js";
 import {
   DEFAULTS
-} from "./chunk-4A4WPM75.js";
+} from "./chunk-7GUP6KQQ.js";
 import "./chunk-NUBSJGQZ.js";
-import {
-  parseBoolEnv
-} from "./chunk-NESW2TTD.js";
 import {
   capitalize,
   capitalizeKebab,
@@ -260,12 +261,12 @@ import {
   getAvailableClis,
   isRecord,
   probeAllClis
-} from "./chunk-BHA6V7GK.js";
-import "./chunk-RTUZSR4R.js";
-import "./chunk-SORBJPRA.js";
+} from "./chunk-3H6Q3RZM.js";
+import "./chunk-47Z3YPOK.js";
+import "./chunk-G42N55ZR.js";
 import "./chunk-ZM4O442V.js";
 import "./chunk-PQHVC4BD.js";
-import "./chunk-JCETWDU7.js";
+import "./chunk-6IWPN5UB.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -317,9 +318,11 @@ import {
   getPipelineEventBus,
   getRandomProvider,
   getTimeProvider,
+  getTuneAdjustmentStore,
   logger,
   lookupInTreeCapability,
   ok,
+  parseBoolEnv,
   parseTierOverrides,
   resetOutcomeStore,
   runWarmUp,
@@ -333,7 +336,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-HKISF2E7.js";
+} from "./chunk-ECBH5INZ.js";
 import {
   applyPortableMode,
   detectSandbox,
@@ -3112,7 +3115,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-P24OBKVM.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-XENJ4E2T.js");
     const body = formatReviewComment2(result);
     const postResult = await provider.createReview(pr.prNumber, body, result.decision);
     if (!postResult.ok) {
@@ -17430,6 +17433,9 @@ function runStpaSafetyAnalysis(logger18, failOnHighSeverity) {
 
 // src/pipeline/tune-stage.ts
 var defaultLogger = createLogger({ component: "TuneStage" });
+var TUNE_ENFORCE_ENV = "NEXUS_TUNE_ENFORCE";
+var TUNE_ENFORCE_DEMOTION = 0.15;
+var AUDIT_REASON_MAX = 512;
 var TUNE_SIGNAL_TYPES = [
   "signal.fitness_declined",
   "signal.swarm_unhealthy",
@@ -17459,20 +17465,70 @@ function intendedActionFor(event) {
       return void 0;
   }
 }
+function auditDemotion(auditLogger, agentId, adjustment, log) {
+  if (auditLogger === void 0 || adjustment === void 0) return;
+  const reason = adjustment.reason.length > AUDIT_REASON_MAX ? adjustment.reason.slice(0, AUDIT_REASON_MAX) : adjustment.reason;
+  try {
+    auditLogger.log({
+      category: "configuration",
+      severity: "warning",
+      outcome: "success",
+      action: "tune.demote",
+      actor: { type: "system", id: "tune-stage" },
+      description: `Bounded routing demotion applied to ${agentId} (swarm_unhealthy)`,
+      metadata: {
+        cli: agentId,
+        magnitude: TUNE_ENFORCE_DEMOTION,
+        multiplier: adjustment.multiplier,
+        reason,
+        provenance: "signal.swarm_unhealthy",
+        appliedAt: adjustment.appliedAt
+      }
+    });
+  } catch (auditError) {
+    log.warn("TuneStage \u2014 audit log failed (demotion still applied)", {
+      error: getErrorMessage(auditError)
+    });
+  }
+}
+function enforceSwarmDemotion(event, action, auditLogger, log) {
+  const adjustment = getTuneAdjustmentStore().demote(
+    event.agentId,
+    TUNE_ENFORCE_DEMOTION,
+    `swarm_unhealthy: ${event.reason}`
+  );
+  log.info("TuneStage (enforce) \u2014 applied bounded routing demotion", {
+    kind: action.kind,
+    signal: action.signal,
+    agentId: event.agentId,
+    reason: event.reason,
+    multiplier: adjustment?.multiplier
+  });
+  auditDemotion(auditLogger, event.agentId, adjustment, log);
+}
 function createTuneStage(bus, options = {}) {
   const enabled = options.enabled ?? false;
   const log = options.logger ?? defaultLogger;
+  const auditLogger = options.auditLogger;
   return bus.subscribe({ type: [...TUNE_SIGNAL_TYPES] }, (event) => {
     try {
       const action = intendedActionFor(event);
       if (action === void 0) return;
       if (enabled) {
-        log.warn("TuneStage enabled but bounded mutation is not implemented yet; no-op", {
+        if (event.type === "signal.swarm_unhealthy") {
+          enforceSwarmDemotion(event, action, auditLogger, log);
+          return;
+        }
+        log.info("TuneStage (enforce) \u2014 non-routing action, shadow-only", {
           kind: action.kind,
-          signal: action.signal
+          signal: action.signal,
+          detail: action.detail
         });
         return;
       }
+      if (event.type === "signal.swarm_unhealthy") {
+        getTuneAdjustmentStore().recordIntended(event.agentId, `swarm_unhealthy: ${event.reason}`);
+      }
       log.info("TuneStage (shadow) \u2014 intended action", {
         kind: action.kind,
         signal: action.signal,
@@ -17486,7 +17542,8 @@ function createTuneStage(bus, options = {}) {
 var cachedTuneUnsubscribe = null;
 function startTuneStage(bus, options) {
   if (cachedTuneUnsubscribe !== null) return;
-  cachedTuneUnsubscribe = createTuneStage(bus, options);
+  const enabled = options?.enabled ?? parseBoolEnv(TUNE_ENFORCE_ENV, false);
+  cachedTuneUnsubscribe = createTuneStage(bus, { ...options, enabled });
 }
 function shutdownTuneStage() {
   if (cachedTuneUnsubscribe !== null) {
@@ -18015,12 +18072,14 @@ function registerToolCategories(ctx) {
     if (allowed(tool.name)) tool.register(ctx.server, buildStandardDeps(ctx, tool.name));
   }
 }
-function initV2PipelineSubsystems(logger18) {
+function initV2PipelineSubsystems(logger18, auditLogger) {
   const pluginRegistry = getPipelinePluginRegistry();
   const pipelineEventBus = getPipelineEventBus();
   const bridge = createEventBusBridge({ source: pipelineEventBus });
   startFeedbackSubscriber(pipelineEventBus, getOutcomeStore());
-  startTuneStage(pipelineEventBus);
+  startTuneStage(pipelineEventBus, auditLogger !== void 0 ? { auditLogger } : void 0);
+  startSwarmHealthSignals(getSwarmObserver(), pipelineEventBus);
+  startFailoverSignals({ pipelineBus: pipelineEventBus });
   const policyEngine = createDefaultPolicyEngine();
   const v2Config = resolveV2Config();
   logger18.info("V2 Pipeline OS initialized", {
@@ -18055,7 +18114,7 @@ function registerMcpTools(options) {
     logger: toolInfra.logger
   });
   setGlobalToolRateLimiterFactory(rateLimiterFactory);
-  initV2PipelineSubsystems(logger18);
+  initV2PipelineSubsystems(logger18, options.auditLogger);
   const gatewayOptions = { ...options, server: observableServer };
   const ctx = createToolContext(gatewayOptions, toolInfra, rateLimiterFactory);
   registerToolCategories(ctx);
@@ -19346,7 +19405,7 @@ function adaptConfigToLibrary(config) {
 }
 function createBeliefPromoter() {
   return async (event) => {
-    const { getToolMemory } = await import("./tool-memory-UEQNXIGC.js");
+    const { getToolMemory } = await import("./tool-memory-L7SDFSF5.js");
     const tm = getToolMemory();
     await tm.recordBelief(
       `skill:${event.name}`,
@@ -19661,6 +19720,8 @@ function createShutdownCleanup(options) {
     await shutdownExpertBridge();
     shutdownFeedbackSubscriber();
     shutdownTuneStage();
+    shutdownSwarmHealthSignals();
+    shutdownFailoverSignals();
     const closeResult = await closeServer(server, serverLogger);
     if (!closeResult.ok) {
       throw new Error(closeResult.error.message);
@@ -19716,7 +19777,8 @@ function buildGatewayConfig(config, logger18) {
     ...tierOverrides !== void 0 && { tierOverrides }
   };
 }
-async function initializeAndRegisterTools(server, logger18, policyFirewall, config, feedbackIntegration) {
+async function initializeAndRegisterTools(server, logger18, policyFirewall, config, deps) {
+  const { feedbackIntegration, auditLogger } = deps ?? {};
   logger18.info("Loading built-in workflow templates");
   const builtInTemplates = await initializeBuiltInTemplates();
   logger18.info("Loaded built-in templates", { count: builtInTemplates.size });
@@ -19739,7 +19801,8 @@ async function initializeAndRegisterTools(server, logger18, policyFirewall, conf
     ...allowedPaths !== void 0 && { allowedPaths },
     ...securityConfig !== void 0 && { securityConfig },
     ...workflowConfig !== void 0 && { workflowConfig },
-    ...feedbackIntegration !== void 0 && { feedbackIntegration }
+    ...feedbackIntegration !== void 0 && { feedbackIntegration },
+    ...auditLogger !== null && auditLogger !== void 0 && { auditLogger }
   };
   registerMcpTools(toolsOptions);
 }
@@ -19790,13 +19853,10 @@ async function initializeSubsystems(config, logger18) {
   const policyFirewall = logSecurityConfig(serverLogger, config);
   const auditLogger = initializeAuditLogger(config.security, serverLogger);
   initializeAuth(config, serverLogger);
-  await initializeAndRegisterTools(
-    server,
-    serverLogger,
-    policyFirewall,
-    config,
-    feedbackResult.feedbackIntegration
-  );
+  await initializeAndRegisterTools(server, serverLogger, policyFirewall, config, {
+    feedbackIntegration: feedbackResult.feedbackIntegration,
+    auditLogger
+  });
   return { server, serverLogger, observer, eventBusBridge, auditLogger };
 }
 var SERVER_STARTUP_TIMEOUT_MS = 3e4;
@@ -20210,7 +20270,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-KWWOKJ5C.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-X3O34FAK.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -20258,7 +20318,7 @@ async function handleVerifyCommand(args) {
 async function handleDoctorCommand(args) {
   const exitCode = await doctorCommand({ fix: args.options.fix });
   if (args.options.deep) {
-    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-OU2WC55V.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-PSNJPELP.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
@@ -20302,7 +20362,7 @@ async function handleInitCommand(args) {
   process.exit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
 }
 async function runInitOpencodeFlow(args) {
-  const { runInitOpencode } = await import("./init-opencode-AYMNMWU7.js");
+  const { runInitOpencode } = await import("./init-opencode-25AUARJH.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -20329,7 +20389,7 @@ async function runInitOpencodeFlow(args) {
   process.exit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-AYMNMWU7.js");
+  const { runOpencodeValidate } = await import("./init-opencode-25AUARJH.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -20369,7 +20429,7 @@ async function handleSetupCommandAsync(args) {
   process.exit(exitCode === 0 ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
 }
 async function runCustomApiSetup(args) {
-  const { configureCustomApi } = await import("./setup-custom-api-UNX4OJEX.js");
+  const { configureCustomApi } = await import("./setup-custom-api-KSF2JMTS.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {
@@ -22345,6 +22405,7 @@ function collectHealth() {
     failureBreakdown: report.failureBreakdown ?? [],
     cliCount: report.cliWeather.length,
     cliHealth: report.cliWeather.map(toCliSummary),
+    tuneAdjustments: getTuneAdjustmentStore().demotionStats(),
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
@@ -22460,6 +22521,22 @@ ${c.bold}nexus-agents${c.reset}`);
 `);
   }
   renderFailureBreakdown(w, health.failureBreakdown);
+  renderTuneAdjustments(w, health.tuneAdjustments);
+}
+function renderTuneAdjustments(w, stats) {
+  if (stats.length === 0) return;
+  const c = colors;
+  w(
+    `  ${c.bold}Self-Tuning Demotions${c.reset} ${c.dim}(applied = enforced, intended = shadow)${c.reset}
+`
+  );
+  for (const stat2 of stats) {
+    w(
+      `  ${stat2.cli.padEnd(10)} applied: ${c.cyan}${String(stat2.applied)}${c.reset}  intended: ${c.cyan}${String(stat2.intended)}${c.reset}  ${c.dim}${stat2.lastReason}${c.reset}
+`
+    );
+  }
+  w("\n");
 }
 function renderJson2(health) {
   process.stdout.write(JSON.stringify(health, null, 2) + "\n");