nexus-agents 4.37.2 → 5.0.1

package/dist/{consensus-vote-VNLVKZZK.js → consensus-vote-X2EF47XM.js}

@@ -11,11 +11,11 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-BL2RCXGC.js";
+} from "./chunk-DDUZI6OD.js";
 import "./chunk-SOKS6XK2.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-DLWXTCLB.js";
-import "./chunk-3BL6HLHW.js";
+import "./chunk-BZRUZSJ6.js";
+import "./chunk-7A63AX2A.js";
 import "./chunk-ZSNWRX2B.js";
 import "./chunk-OKS6I7T7.js";
 import "./chunk-VS2DUTJ5.js";
@@ -50,4 +50,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-VNLVKZZK.js.map
+//# sourceMappingURL=consensus-vote-X2EF47XM.js.map

package/dist/{improvement-review-RVR2XRU2.js → improvement-review-VBLDRXFP.js}

@@ -11,9 +11,9 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-DIMPT3NS.js";
-import "./chunk-DLWXTCLB.js";
-import "./chunk-3BL6HLHW.js";
+} from "./chunk-GQXDNAMB.js";
+import "./chunk-BZRUZSJ6.js";
+import "./chunk-7A63AX2A.js";
 import "./chunk-ZSNWRX2B.js";
 import "./chunk-AVYTX7JQ.js";
 import "./chunk-GBHJ37V3.js";
@@ -33,4 +33,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-RVR2XRU2.js.map
+//# sourceMappingURL=improvement-review-VBLDRXFP.js.map

package/dist/index.d.ts

@@ -20649,16 +20649,28 @@ interface DistributionStats {
  * Regret analysis result comparing actual vs optimal decisions.
  */
 interface RegretAnalysis {
-    /** Total cumulative regret */
-    readonly cumulativeRegret: number;
-    /** Average regret per decision */
-    readonly avgRegret: number;
-    /** Number of decisions analyzed */
+    /**
+     * Total cumulative regret, or `null` when no decision was comparable (#5255).
+     *
+     * These three were plain `number` and returned `0`/`0`/`1` for an empty
+     * decision set — which the dashboard rendered as "Cumulative Regret: 0.00"
+     * and "Optimal Decision Rate: 100.0%" with a full progress bar. A perfect
+     * routing record asserted over nothing is an absent measurement wearing a
+     * good score, and the primary consumer of these numbers is the learning loop
+     * itself, which has no way to consult a sibling flag.
+     *
+     * `null` means UNMEASURED — no comparable decision existed. It does not mean
+     * zero regret; that is `0`, and the two are now distinguishable.
+     */
+    readonly cumulativeRegret: number | null;
+    /** Average regret per decision, or `null` when unmeasured — see above. */
+    readonly avgRegret: number | null;
+    /** Number of decisions analyzed. Stays numeric: 0 is the true count. */
     readonly totalDecisions: number;
-    /** Number of suboptimal decisions */
+    /** Number of suboptimal decisions. Stays numeric: 0 is the true count. */
     readonly suboptimalDecisions: number;
-    /** Percentage of optimal decisions */
-    readonly optimalRate: number;
+    /** Share of optimal decisions, or `null` when unmeasured — see above. */
+    readonly optimalRate: number | null;
     /** Regret per model (how much worse each model performed vs best) */
     readonly regretPerModel: Record<string, number>;
 }
@@ -20790,21 +20802,35 @@ interface TaskTypePerformance {
  * Learning progress metrics.
  */
 interface LearningProgress {
-    /** LinUCB exploration rate over time */
-    readonly explorationRate: number;
+    /**
+     * LinUCB exploration rate, or `null` when nothing was recorded (#5255).
+     *
+     * `0` was the empty-case value and rendered as "0.0%" — indistinguishable
+     * from a real fully-greedy policy, which is a legitimate 0.0%. `null` means
+     * UNMEASURED; `0` means measured-and-zero.
+     */
+    readonly explorationRate: number | null;
     readonly explorationRateTrend: number;
-    /** Cumulative regret */
-    readonly cumulativeRegret: number;
-    readonly avgRegret: number;
-    /** Optimal decision rate */
-    readonly optimalRate: number;
+    /** Cumulative regret, or `null` when no decision was comparable. */
+    readonly cumulativeRegret: number | null;
+    /** Average regret per decision, or `null` when unmeasured. */
+    readonly avgRegret: number | null;
+    /** Optimal decision rate, or `null` when unmeasured. */
+    readonly optimalRate: number | null;
     /** Feature importance ranking */
     readonly featureImportance: readonly {
         readonly feature: string;
         readonly importance: number;
     }[];
     /** Learning convergence metric (0-1, 1 = converged) */
-    readonly convergenceScore: number;
+    /**
+     * Convergence score, or `null` when no feature weights were recorded (#5255).
+     *
+     * The empty case returned `0`, which reads as WORST-possible convergence —
+     * `Math.exp(-variance)` only approaches 0 and never reaches it, so a literal
+     * 0% could not have been a real reading.
+     */
+    readonly convergenceScore: number | null;
 }
 /**
  * Dashboard summary.
@@ -20838,10 +20864,27 @@ interface DashboardSummary {
 interface DashboardHealthIndicators {
     /** Whether we have enough data for statistical inference */
     readonly hasMinimumData: boolean;
-    /** Whether learning is progressing (regret decreasing) */
-    readonly isLearning: boolean;
-    /** Whether exploration rate is in healthy range (10-20%) */
-    readonly healthyExploration: boolean;
+    /**
+     * Whether learning is progressing, or `null` when unmeasured (#5255).
+     *
+     * This was `boolean` and computed from `avgRegret`/`optimalRate`, whose empty
+     * case returned `0`/`1` — so it answered "yes" on the strength of no data.
+     * #4714 spotted that and guarded only the aggregate `healthScore`; the guard
+     * keys on total outcomes, which is a DIFFERENT collection from the one these
+     * metrics read, so on a live system it passed and the fabricated verdict
+     * flowed through anyway.
+     */
+    readonly isLearning: boolean | null;
+    /**
+     * Whether exploration is in the healthy 10-20% range, or `null` when nothing
+     * was recorded (#5255).
+     *
+     * Previously rendered `✗ Healthy Exploration` over ZERO samples — asserting a
+     * health *failure* from absence — while the warning that would have explained
+     * it was gated behind `explorationHistory.length > 10`, so the one disclosing
+     * line was exactly the suppressed one.
+     */
+    readonly healthyExploration: boolean | null;
     /** Whether any model is significantly underperforming */
     readonly noUnderperformers: boolean;
     /** Overall health score (0-1) */

package/dist/index.js

@@ -553,7 +553,7 @@ import {
   withLogging,
   withRetry,
   withRetryWrapper
-} from "./chunk-EZVDJJ4T.js";
+} from "./chunk-LFAIB5MG.js";
 import {
   FALLBACK_SCANNER_DATA,
   buildPlanFromAnalysis,
@@ -574,7 +574,7 @@ import {
   connectTransport,
   createServer,
   startStdioServer
-} from "./chunk-WCQD5WJX.js";
+} from "./chunk-AYJNW7JN.js";
 import {
   OPENAI_MODELS,
   OPENAI_MODEL_ALIASES,
@@ -632,7 +632,7 @@ import {
   generateProposalId,
   parseAgentPairKey,
   registerConsensusVoteTool
-} from "./chunk-BL2RCXGC.js";
+} from "./chunk-DDUZI6OD.js";
 import "./chunk-SOKS6XK2.js";
 import {
   allOf
@@ -683,7 +683,7 @@ import {
 import {
   ImprovementReviewInputSchema,
   registerImprovementReviewTool
-} from "./chunk-DIMPT3NS.js";
+} from "./chunk-GQXDNAMB.js";
 import {
   AgentPerformanceSchema,
   ConsensusAlgorithmSchema,
@@ -719,10 +719,10 @@ import {
   toolSuccess,
   toolSuccessStructured,
   validateToolInput
-} from "./chunk-DLWXTCLB.js";
+} from "./chunk-BZRUZSJ6.js";
 import {
   VERSION
-} from "./chunk-3BL6HLHW.js";
+} from "./chunk-7A63AX2A.js";
 import {
   AuditTrail,
   MAX_STRIPPED_ELEMENTS_PER_EVENT,
@@ -4755,7 +4755,7 @@ function buildVotingInput(plan, config) {
 }
 async function executeSingleVote(plan, config, log) {
   try {
-    const { executeVoting } = await import("./consensus-vote-VNLVKZZK.js");
+    const { executeVoting } = await import("./consensus-vote-X2EF47XM.js");
     const input = buildVotingInput(plan, config);
     const result = await executeVoting(input, log);
     return parseVotingResult(result);

package/dist/{setup-data-dir-TCVUSEDW.js → setup-data-dir-RQCYL3D3.js}

@@ -2,11 +2,11 @@ import {
   NEXUS_DATA_DIR,
   describeDataDirFix,
   initDataDirectories
-} from "./chunk-WCQD5WJX.js";
+} from "./chunk-AYJNW7JN.js";
 import "./chunk-VZM7YQZL.js";
 import "./chunk-SOKS6XK2.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-3BL6HLHW.js";
+import "./chunk-7A63AX2A.js";
 import "./chunk-6T3EPABN.js";
 import "./chunk-VRJJGXUE.js";
 import "./chunk-2P6GBKUN.js";
@@ -26,4 +26,4 @@ export {
   describeDataDirFix,
   initDataDirectories
 };
-//# sourceMappingURL=setup-data-dir-TCVUSEDW.js.map
+//# sourceMappingURL=setup-data-dir-RQCYL3D3.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agents",
-  "version": "4.37.2",
+  "version": "5.0.1",
   "description": "Governance substrate for AI coding agents — adversarial PR review, drift-detected rules, tamper-evident audit, and closed-loop outcome routing for Claude, Codex, Gemini, and OpenCode",
   "mcpName": "io.github.nexus-substrate/nexus-agents",
   "license": "MIT",

package/dist/chunk-3BL6HLHW.js

@@ -1,7 +0,0 @@
-// src/version.ts
-var VERSION = true ? "4.37.2" : "dev";
-
-export {
-  VERSION
-};
-//# sourceMappingURL=chunk-3BL6HLHW.js.map