nexus-agents 2.63.0 → 2.63.2

package/dist/{chunk-QGZBCD2A.js → chunk-EBFXDM3P.js}

@@ -1,6 +1,6 @@
 import {
   getErrorMessage
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/cli/setup-config.ts
 import { copyFileSync, existsSync, writeFileSync } from "fs";
@@ -74,4 +74,4 @@ function ensureBackup(outputPath) {
 export {
   runConfigInitSync
 };
-//# sourceMappingURL=chunk-QGZBCD2A.js.map
+//# sourceMappingURL=chunk-EBFXDM3P.js.map

package/dist/{chunk-GMOGKX4E.js → chunk-ETZULQ7Z.js}

@@ -5,7 +5,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/cli-adapters/circuit-breaker-types.ts
 var CircuitErrorCode = {
@@ -353,4 +353,4 @@ export {
   CircuitBreakerRegistry,
   mapCliErrorToCategory
 };
-//# sourceMappingURL=chunk-GMOGKX4E.js.map
+//# sourceMappingURL=chunk-ETZULQ7Z.js.map

package/dist/{chunk-R2Y57PM3.js → chunk-FAUHVWYZ.js}

@@ -1,6 +1,6 @@
 import {
   isPersistenceEnabled
-} from "./chunk-CLYZ7FWP.js";
+} from "./chunk-LJT65EA7.js";
 import {
   __require
 } from "./chunk-UP2VWCW5.js";
@@ -11127,4 +11127,4 @@ export {
   ParseError,
   OrchestratorError
 };
-//# sourceMappingURL=chunk-R2Y57PM3.js.map
+//# sourceMappingURL=chunk-FAUHVWYZ.js.map

package/dist/{chunk-H43PABG4.js → chunk-FHFNOMNK.js}

@@ -5,7 +5,7 @@ import {
   MCP_TIMEOUTS,
   TEST_TIMEOUTS,
   WORKFLOW_TIMEOUTS
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/config/defaults-env.ts
 function parseIntEnv(envKey, fallback) {
@@ -399,4 +399,4 @@ export {
   CUSTOM_API_DEFAULT_MODEL,
   DEFAULTS
 };
-//# sourceMappingURL=chunk-H43PABG4.js.map
+//# sourceMappingURL=chunk-FHFNOMNK.js.map

package/dist/{chunk-EDGG3RQE.js → chunk-FTWGBV7S.js}

@@ -1,6 +1,6 @@
 import {
   createLogger
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/swe-bench/mcp-config.ts
 import { writeFile, mkdtemp, rm } from "fs/promises";
@@ -58,4 +58,4 @@ export {
   generateMcpConfig,
   getDefaultAllowedTools
 };
-//# sourceMappingURL=chunk-EDGG3RQE.js.map
+//# sourceMappingURL=chunk-FTWGBV7S.js.map

package/dist/{chunk-7Y36JLES.js → chunk-I37IQ26H.js}

@@ -4,7 +4,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/context/session-memory.ts
 import * as fs from "fs";
@@ -351,4 +351,4 @@ export {
   SessionMemory,
   createSessionMemory
 };
-//# sourceMappingURL=chunk-7Y36JLES.js.map
+//# sourceMappingURL=chunk-I37IQ26H.js.map

package/dist/{chunk-XEMRMZUN.js → chunk-KLZHA5KA.js}

@@ -1,14 +1,14 @@
 import {
   resolveToken
-} from "./chunk-EZXOJZYE.js";
+} from "./chunk-UCQTXKTS.js";
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-K7EA5OV4.js";
+} from "./chunk-UDKYZ7CS.js";
 import {
   err,
   ok
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/scm/factory.ts
 async function createScmProvider(config) {
@@ -41,4 +41,4 @@ export {
   createScmProvider,
   createGitHubProvider
 };
-//# sourceMappingURL=chunk-XEMRMZUN.js.map
+//# sourceMappingURL=chunk-KLZHA5KA.js.map

package/dist/{chunk-TFEFN37P.js → chunk-KVZNQWWI.js}

@@ -11,7 +11,7 @@ import {
   formatZodError,
   getTimeProvider,
   ok
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/context/memory-backend-types.ts
 import { z } from "zod";
@@ -941,4 +941,4 @@ export {
   AdaptiveMemoryBackend,
   createAdaptiveMemory
 };
-//# sourceMappingURL=chunk-TFEFN37P.js.map
+//# sourceMappingURL=chunk-KVZNQWWI.js.map

package/dist/chunk-LJT65EA7.js

@@ -0,0 +1,32 @@
+import {
+  getNexusDataDir
+} from "./chunk-FDNWRZNJ.js";
+
+// src/config/learning-persistence.ts
+import { mkdirSync } from "fs";
+import { join } from "path";
+function getLearningDir() {
+  return join(getNexusDataDir(), "learning");
+}
+function getOutcomesFile() {
+  return join(getLearningDir(), "outcomes.jsonl");
+}
+function getRulesFile() {
+  return join(getLearningDir(), "rules.json");
+}
+var DIR_MODE = 448;
+function isPersistenceEnabled() {
+  return process.env["NEXUS_PERSIST_LEARNING"] !== "false";
+}
+function ensureLearningDir(dir) {
+  mkdirSync(dir ?? getLearningDir(), { recursive: true, mode: DIR_MODE });
+}
+
+export {
+  getLearningDir,
+  getOutcomesFile,
+  getRulesFile,
+  isPersistenceEnabled,
+  ensureLearningDir
+};
+//# sourceMappingURL=chunk-LJT65EA7.js.map

package/dist/chunk-LJT65EA7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/learning-persistence.ts"],"sourcesContent":["/**\n * Shared configuration for cross-session learning persistence.\n *\n * Controls where learning data (outcomes, distilled rules) is stored\n * on disk and whether persistence is enabled via feature flag.\n *\n * @module config/learning-persistence\n * (Source: Issue #1009 — Cross-session persistence)\n */\n\nimport { mkdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { getNexusDataDir } from './nexus-data-dir.js';\n\n// ============================================================================\n// Path resolution (#2316: must read NEXUS_DATA_DIR at call time, not import)\n// ============================================================================\n\n/**\n * Base directory for learning persistence data. Resolved at call time so\n * `NEXUS_DATA_DIR` overrides take effect — the const-at-import-time\n * pattern this replaces was the bug discovered while dogfooding v2.63.0\n * (#2316). Outcome counts on a fresh portable workspace were leaking\n * the host home directory's outcome history.\n */\nexport function getLearningDir(): string {\n  return join(getNexusDataDir(), 'learning');\n}\n\n/** JSONL file for persisted task outcomes. */\nexport function getOutcomesFile(): string {\n  return join(getLearningDir(), 'outcomes.jsonl');\n}\n\n/** JSON file for persisted distilled rules. */\nexport function getRulesFile(): string {\n  return join(getLearningDir(), 'rules.json');\n}\n\n// Note: previous LEARNING_DIR / OUTCOMES_FILE / RULES_FILE exports were\n// removed in #2316 — they were evaluated at module import time and ignored\n// `NEXUS_DATA_DIR`. All callers must use the getter functions above.\n\n/** Directory mode: owner-only (rwx------). */\nconst DIR_MODE = 0o700;\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Check whether learning persistence is enabled via feature flag.\n *\n * Defaults to true — cross-session LinUCB routing data persists to\n * `~/.nexus-agents/learning/` unless explicitly disabled.\n * Only routing metadata is stored (model, success, duration, category).\n * No user prompts, API keys, or model outputs are persisted.\n *\n * Set NEXUS_PERSIST_LEARNING=false to disable.\n */\nexport function isPersistenceEnabled(): boolean {\n  return process.env['NEXUS_PERSIST_LEARNING'] !== 'false';\n}\n\n/** Ensure the learning data directory exists. */\nexport function ensureLearningDir(dir?: string): void {\n  mkdirSync(dir ?? getLearningDir(), { recursive: true, mode: DIR_MODE });\n}\n"],"mappings":";;;;;AAUA,SAAS,iBAAiB;AAC1B,SAAS,YAAY;AAcd,SAAS,iBAAyB;AACvC,SAAO,KAAK,gBAAgB,GAAG,UAAU;AAC3C;AAGO,SAAS,kBAA0B;AACxC,SAAO,KAAK,eAAe,GAAG,gBAAgB;AAChD;AAGO,SAAS,eAAuB;AACrC,SAAO,KAAK,eAAe,GAAG,YAAY;AAC5C;AAOA,IAAM,WAAW;AAgBV,SAAS,uBAAgC;AAC9C,SAAO,QAAQ,IAAI,wBAAwB,MAAM;AACnD;AAGO,SAAS,kBAAkB,KAAoB;AACpD,YAAU,OAAO,eAAe,GAAG,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AACxE;","names":[]}

package/dist/{chunk-6QU4DJYW.js → chunk-MSFUOGN4.js}

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

package/dist/{chunk-YU4NABXM.js → chunk-NF5KOUKM.js}

@@ -2,7 +2,7 @@ import {
   ConfigError,
   err,
   ok
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/adapters/sdk/types.ts
 var PROVIDER_ENV_KEYS = {
@@ -117,4 +117,4 @@ export {
   CUSTOM_API_ALLOW_PRIVATE_ENV,
   validateCustomApiBaseUrl
 };
-//# sourceMappingURL=chunk-YU4NABXM.js.map
+//# sourceMappingURL=chunk-NF5KOUKM.js.map

package/dist/{chunk-TC46TRLR.js → chunk-PB2EXTSV.js}

@@ -5,7 +5,7 @@ import {
   ParseError,
   SecurityError,
   getErrorMessage
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 
 // src/cli/research-helpers-io.ts
 import * as fs from "fs/promises";
@@ -918,4 +918,4 @@ export {
   normalizeTopicToCanonical,
   synthesizeResearch
 };
-//# sourceMappingURL=chunk-TC46TRLR.js.map
+//# sourceMappingURL=chunk-PB2EXTSV.js.map

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

@@ -2,16 +2,21 @@ import {
   CUSTOM_API_BASE_URL_ENV,
   PROVIDER_ENV_KEYS,
   validateCustomApiBaseUrl
-} from "./chunk-YU4NABXM.js";
+} from "./chunk-NF5KOUKM.js";
 import {
   CUSTOM_API_DEFAULT_MODEL
-} from "./chunk-H43PABG4.js";
+} from "./chunk-FHFNOMNK.js";
 import {
-  nexusDataPath
-} from "./chunk-FDNWRZNJ.js";
+  createCliAdapter,
+  createCliDetectionCache,
+  delay,
+  getAvailableClis,
+  isCliAvailable,
+  withTimeout
+} from "./chunk-ZC4KHPRL.js";
 import {
   SessionMemory
-} from "./chunk-7Y36JLES.js";
+} from "./chunk-I37IQ26H.js";
 import {
   AdaptiveMemoryBackend,
   HybridMemoryBackend,
@@ -20,19 +25,11 @@ import {
   getMemoryEntry,
   memoryExists,
   memoryRowToEntry
-} from "./chunk-TFEFN37P.js";
+} from "./chunk-KVZNQWWI.js";
 import {
   stringifyValue,
   tokenizeFiltered
 } from "./chunk-633WH2ML.js";
-import {
-  createCliAdapter,
-  createCliDetectionCache,
-  delay,
-  getAvailableClis,
-  isCliAvailable,
-  withTimeout
-} from "./chunk-YQAOMDR2.js";
 import {
   AgentError,
   CACHE_TIMEOUTS,
@@ -79,11 +76,14 @@ import {
   resolveVoteTimeout,
   toRateLimitError,
   validateTimeout
-} from "./chunk-R2Y57PM3.js";
+} from "./chunk-FAUHVWYZ.js";
 import {
-  OUTCOMES_FILE,
-  ensureLearningDir
-} from "./chunk-CLYZ7FWP.js";
+  ensureLearningDir,
+  getOutcomesFile
+} from "./chunk-LJT65EA7.js";
+import {
+  nexusDataPath
+} from "./chunk-FDNWRZNJ.js";
 
 // src/mcp/tools/consensus-vote.ts
 import { z as z19 } from "zod";
@@ -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;
@@ -10345,7 +10347,6 @@ var AgenticMemoryBackend = class {
 
 // src/context/belief-memory-persistence.ts
 import * as fs2 from "fs";
-import * as os from "os";
 import * as path from "path";
 
 // src/context/belief-persistence-types.ts
@@ -10424,7 +10425,9 @@ var BeliefSnapshotSchema = z16.object({
 });
 
 // src/context/belief-memory-persistence.ts
-var BELIEFS_DIR = path.join(os.homedir(), ".nexus-agents", "memory", "beliefs");
+function getBeliefsDir() {
+  return nexusDataPath("memory", "beliefs");
+}
 var MAX_SNAPSHOT_FILES = 10;
 var SNAPSHOT_VERSION = 1;
 function optProp(key, value) {
@@ -10602,11 +10605,11 @@ function hydrateSnapshot(snapshot) {
   };
 }
 function ensureBeliefsDir() {
-  if (!fs2.existsSync(BELIEFS_DIR)) fs2.mkdirSync(BELIEFS_DIR, { recursive: true });
+  if (!fs2.existsSync(getBeliefsDir())) fs2.mkdirSync(getBeliefsDir(), { recursive: true });
 }
 function getSnapshotFiles() {
   try {
-    return fs2.readdirSync(BELIEFS_DIR).filter((f) => f.startsWith("beliefs-") && f.endsWith(".json")).sort().reverse();
+    return fs2.readdirSync(getBeliefsDir()).filter((f) => f.startsWith("beliefs-") && f.endsWith(".json")).sort().reverse();
   } catch {
     return [];
   }
@@ -10616,7 +10619,7 @@ function enforceRetention(logger11) {
     const files = getSnapshotFiles();
     if (files.length <= MAX_SNAPSHOT_FILES) return;
     const toDelete = files.slice(MAX_SNAPSHOT_FILES);
-    for (const file of toDelete) fs2.unlinkSync(path.join(BELIEFS_DIR, file));
+    for (const file of toDelete) fs2.unlinkSync(path.join(getBeliefsDir(), file));
     logger11.debug("Belief snapshot retention enforced", {
       kept: MAX_SNAPSHOT_FILES,
       deleted: toDelete.length
@@ -10633,7 +10636,7 @@ function saveBeliefSnapshot(data, logger11) {
     const snapshot = createSnapshot(data);
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
     const filename = `beliefs-${timestamp}.json`;
-    const filepath = path.join(BELIEFS_DIR, filename);
+    const filepath = path.join(getBeliefsDir(), filename);
     fs2.writeFileSync(filepath, JSON.stringify(snapshot, null, 2), "utf-8");
     logger11.info("Belief memory snapshot saved", { filename, beliefs: snapshot.beliefs.length });
     enforceRetention(logger11);
@@ -10653,7 +10656,7 @@ function loadBeliefSnapshot(logger11) {
     }
     for (const file of files.slice(0, 3)) {
       try {
-        const filepath = path.join(BELIEFS_DIR, file);
+        const filepath = path.join(getBeliefsDir(), file);
         const raw = JSON.parse(fs2.readFileSync(filepath, "utf-8"));
         const validation = BeliefSnapshotSchema.safeParse(raw);
         if (!validation.success) {
@@ -12493,7 +12496,7 @@ var PersistentOutcomeStore = class extends OutcomeStore {
   logger;
   constructor(config, logger11) {
     super(config);
-    this.filePath = config?.filePath ?? OUTCOMES_FILE;
+    this.filePath = config?.filePath ?? getOutcomesFile();
     this.logger = logger11 ?? createLogger({ component: "PersistentOutcomeStore" });
     const dataDir = config?.dataDir;
     ensureLearningDir(dataDir);
@@ -12637,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({
@@ -12700,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() {
@@ -12855,7 +12877,7 @@ async function processVotesWithCascade(votes, opts) {
 var CONTRARIAN_ESCALATION_THRESHOLD = 0.8;
 async function runContrarianCheck(proposal, log) {
   try {
-    const { executeExpert } = await import("./expert-bridge-BHTUNALT.js");
+    const { executeExpert } = await import("./expert-bridge-R6FQWUHB.js");
     const prompt = [
       "You are a contrarian analyst. Your job is to find reasons this proposal should be REJECTED.",
       "Look for: YAGNI (not needed), MISALIGNED (wrong tech/architecture), SECURITY_RISK, SCOPE_CREEP.",
@@ -12932,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";
@@ -13064,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), {
@@ -13223,9 +13246,10 @@ export {
   createCorrelationTracker,
   VotingStrategySchema,
   ConsensusVoteInputSchema,
+  warnIfSimulatedOutsideTests,
   resetCorrelationTracker,
   executeVoting,
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-FEWWXGFE.js.map
+//# sourceMappingURL=chunk-PEDEZRPR.js.map