nexus-agents 2.63.1 → 2.63.3

package/README.md

@@ -16,14 +16,14 @@ Nexus Agents makes your AI coding tools work together intelligently. It coordina
 
 ### Key Capabilities
 
-- **Intelligent Routing** — 9-stage CompositeRouter with LinUCB bandit, TOPSIS multi-criteria, and adaptive bonuses. Learns from outcomes.
-- **Multi-Expert Orchestration** — 9 specialized experts (code, architecture, security, testing, docs, devops, research, PM, UX) coordinated by TechLead/Orchestrator agents
-- **Consensus Voting** — 7 algorithms including higher-order Bayesian aggregation with correlation awareness
+- **Intelligent Routing** — Multi-stage CompositeRouter (TOPSIS, LinUCB bandit, distilled-rule short-circuit, weather-aware penalties). Learns from outcomes.
+- **Multi-Expert Orchestration** — Specialized expert agents (code, architecture, security, testing, docs, devops, research, PM, UX, infrastructure, QA, data-visualization) coordinated by an Orchestrator.
+- **Consensus Voting** — Six aggregation strategies: simple/super-majority, unanimous, higher-order Bayesian, opinion-wise, proof-of-learning.
 - **Development Pipeline** — Research → Plan → Vote → Decompose → Implement → QA → Security. Autonomous, harness, and dry-run modes.
-- **Memory & Learning** — 8 backends (session, belief, adaptive, routing, graph, hybrid, agentic, typed) with cross-session persistence
-- **29 MCP Tools** — Agent management, workflow execution, research, memory, codebase intelligence, repo analysis, consensus, operations
-- **Research System** — 9 discovery sources (arXiv, GitHub, Semantic Scholar, etc) with auto-catalog and synthesis
-- **Security** — Sandboxing, trust classification, SARIF parsing, input sanitization, red team pipeline
+- **Memory & Learning** — Multiple backends (session, belief, adaptive, routing, graph, hybrid, agentic, typed) with cross-session persistence.
+- **MCP Tools** — Agent management, workflow execution, research, memory, codebase intelligence, repo analysis, consensus, operations. See [docs/ENTRYPOINTS.md](https://github.com/williamzujkowski/nexus-agents/blob/main/docs/ENTRYPOINTS.md) for the canonical list.
+- **Research System** — Discovery across arXiv, GitHub, Semantic Scholar, and other sources with auto-catalog and synthesis.
+- **Security** — Sandboxing, trust classification, SARIF parsing, input sanitization, red team pipeline.
 
 ---
 

package/dist/{chunk-C3FCZKNW.js → chunk-53FRKIEQ.js}

@@ -38,7 +38,7 @@ import {
 } from "./chunk-FDNWRZNJ.js";
 
 // src/version.ts
-var VERSION = true ? "2.63.1" : "dev";
+var VERSION = true ? "2.63.3" : "dev";
 
 // src/config/schemas-core.ts
 import { z } from "zod";
@@ -2024,7 +2024,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-WTVF4YEJ.js");
+    const { runSetup } = await import("./setup-command-2JSXOAIS.js");
     const setupResult = runSetup({
       skipMcp: true,
       skipRules: true,
@@ -2134,4 +2134,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-C3FCZKNW.js.map
+//# sourceMappingURL=chunk-53FRKIEQ.js.map

package/dist/{chunk-UDP5MKHK.js → chunk-F4XV6DGK.js}

@@ -8,7 +8,7 @@ import {
   checkSqlite,
   defaultConfig,
   initDataDirectories
-} from "./chunk-C3FCZKNW.js";
+} from "./chunk-53FRKIEQ.js";
 import {
   BUILT_IN_EXPERTS
 } from "./chunk-GJVHRJO2.js";
@@ -1933,4 +1933,4 @@ export {
   setupCommand,
   setupCommandAsync
 };
-//# sourceMappingURL=chunk-UDP5MKHK.js.map
+//# sourceMappingURL=chunk-F4XV6DGK.js.map

package/dist/{chunk-RIMON2SA.js → chunk-PEDEZRPR.js}

@@ -8082,7 +8082,9 @@ var ConsensusVoteInputSchema = z8.object({
     "Voting strategy: simple_majority (default), supermajority, unanimous, proof_of_learning, or higher_order (Bayesian-optimal)"
   ),
   quickMode: z8.boolean().optional().default(false).describe("Use 3 agents instead of 5 for faster execution"),
-  simulateVotes: z8.boolean().optional().default(false).describe("Use simulated votes instead of LLM execution")
+  simulateVotes: z8.boolean().optional().default(false).describe(
+    "TESTS ONLY \u2014 when true, voters return random decisions. Output must not be used for real decisions. (#2319)"
+  )
 });
 function toAgentVoteSummary(result) {
   const roleName = VOTER_ROLES[result.role].split(" - ")[0] ?? result.role;
@@ -12638,6 +12640,11 @@ function emitTrendDetected(bus, detail) {
 // src/mcp/tools/consensus-vote-recording.ts
 var logger10 = createLogger({ tool: "consensus-vote" });
 function recordVoteSuccess(proposal, strategy, outcome, duration, votes) {
+  const allSimulated = votes !== void 0 && votes.length > 0 && votes.every((v) => v.source === "simulation");
+  if (allSimulated) {
+    logger10.debug("Skipping memory + outcome recording \u2014 all votes simulated");
+    return;
+  }
   try {
     const memory = getToolMemory();
     memory.recordTask({
@@ -12701,6 +12708,20 @@ function recordVoteOutcomes(votes) {
   }
 }
 
+// src/mcp/tools/simulation-guard.ts
+var WARNED = /* @__PURE__ */ new Set();
+function isTestRunner() {
+  return process.env.VITEST === "true" || process.env.NODE_ENV === "test";
+}
+function warnIfSimulatedOutsideTests(toolName, logger11) {
+  if (isTestRunner()) return;
+  if (WARNED.has(toolName)) return;
+  WARNED.add(toolName);
+  logger11.warn(
+    `[${toolName}] simulateVotes=true: output is RANDOM and reserved for tests/demos. Do not treat the result as a real decision.`
+  );
+}
+
 // src/mcp/tools/consensus-vote.ts
 var persistentCorrelationTracker;
 function getOrCreateCorrelationTracker() {
@@ -12933,6 +12954,7 @@ async function executeVoting(input, logger11) {
 }
 async function handleConsensusVote(deps, args) {
   const logger11 = deps.logger ?? createLogger({ tool: "consensus_vote" });
+  if (args.simulateVotes) warnIfSimulatedOutsideTests("consensus_vote", logger11);
   try {
     const result = await executeVoting(args, logger11);
     const strategy = args.strategy ?? "simple_majority";
@@ -13065,7 +13087,7 @@ function registerConsensusVoteTool(server, deps) {
       "Voting strategy: simple_majority (default), supermajority, unanimous, proof_of_learning, or higher_order"
     ),
     quickMode: z19.boolean().optional().default(false).describe("Use 3 agents instead of 7"),
-    simulateVotes: z19.boolean().optional().default(false).describe("Use simulated votes")
+    simulateVotes: z19.boolean().optional().default(false).describe("TESTS ONLY \u2014 random output, must not be used for real decisions (#2319)")
   };
   const description = "Execute multi-model consensus voting on a proposal. Uses 7 specialized agent roles (architect, security, devex, ai_ml, pm, catfish, scope_steward) to vote on proposals with configurable strategies. Supports higher_order strategy for Bayesian-optimal aggregation with correlation awareness (Issue #514).";
   const secureHandler = createSecureHandler(createConsensusVoteHandler(depsWithNotifier), {
@@ -13224,9 +13246,10 @@ export {
   createCorrelationTracker,
   VotingStrategySchema,
   ConsensusVoteInputSchema,
+  warnIfSimulatedOutsideTests,
   resetCorrelationTracker,
   executeVoting,
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-RIMON2SA.js.map
+//# sourceMappingURL=chunk-PEDEZRPR.js.map