nexus-agents 2.173.1 → 2.173.2

package/dist/{chunk-A7RTXDXK.js → chunk-GNXQBXFI.js}

@@ -8,7 +8,7 @@ import {
   checkSqlite,
   defaultConfig,
   initDataDirectories
-} from "./chunk-OKZ72FVJ.js";
+} from "./chunk-H63X54TU.js";
 import {
   BUILT_IN_EXPERTS
 } from "./chunk-ZM4O442V.js";
@@ -2001,4 +2001,4 @@ export {
   setupCommand,
   setupCommandAsync
 };
-//# sourceMappingURL=chunk-A7RTXDXK.js.map
+//# sourceMappingURL=chunk-GNXQBXFI.js.map

package/dist/{chunk-OKZ72FVJ.js → chunk-H63X54TU.js}

@@ -46,7 +46,7 @@ import {
 } from "./chunk-DHVMSIT5.js";
 
 // src/version.ts
-var VERSION = true ? "2.173.1" : "dev";
+var VERSION = true ? "2.173.2" : "dev";
 
 // src/config/schemas-core.ts
 import { z } from "zod";
@@ -2182,7 +2182,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-JVQTBFUD.js");
+    const { runSetup } = await import("./setup-command-24Z3KEHP.js");
     const setupResult = runSetup({
       skipMcp: true,
       skipRules: true,
@@ -2295,4 +2295,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-OKZ72FVJ.js.map
+//# sourceMappingURL=chunk-H63X54TU.js.map

package/dist/cli.js

@@ -18,7 +18,7 @@ import "./chunk-O6VB54QJ.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-A7RTXDXK.js";
+} from "./chunk-GNXQBXFI.js";
 import "./chunk-4KURMOBY.js";
 import {
   AuthHandler,
@@ -139,7 +139,7 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-CC3H5XJR.js";
+} from "./chunk-5UKKGPRS.js";
 import "./chunk-P6POKYSM.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-YF35FKKD.js";
@@ -166,7 +166,7 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-OKZ72FVJ.js";
+} from "./chunk-H63X54TU.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv

package/dist/index.d.ts

@@ -12444,6 +12444,13 @@ declare class FailureDetector {
  *  3. behavioral archetype (arxiv:2512.07497)            → per-strategy action
  *  4. otherwise                                          → PERMANENT (fail closed)
  *
+ * PRIMARY shipped behavior is transport retry (step 2): the common recoverable
+ * case is a transient 429/5xx/network blip. The archetype path (step 3) is a
+ * SECONDARY guidance channel that only fires when the error cause-chain TEXT
+ * carries ≥2 independent indicator families (see
+ * {@link EXPERT_ERROR_TEXT_CONFIDENCE_THRESHOLD}); a lone one-family signal
+ * (e.g. a 401 "Invalid API key") stays permanent and fails closed.
+ *
  * The retry loop, backoff, and jitter are NOT reimplemented here — they are the
  * shared `withRetry`/`isRetryableError` primitives (adapters/retry.ts:9-19
  * forbids a third retry loop). Delay/attempt knobs default to
@@ -12453,10 +12460,14 @@ declare class FailureDetector {
 /**
  * Opt-in recovery policy attached to an expert at creation time. All fields are
  * optional and fall through to {@link DEFAULT_RETRY_CONFIG} (retry knobs) and
- * {@link DEFAULT_DETECTOR_CONFIG} (detector).
+ * this module's detector defaults.
  */
 interface ExpertRecoveryPolicy {
-    /** Maximum retries (attempts = maxRetries + 1). Default: DEFAULT_RETRY_CONFIG. */
+    /**
+     * Maximum retries (attempts = maxRetries + 1). Default:
+     * {@link EXPERT_RECOVERY_DEFAULT_MAX_RETRIES} (1 → 2 attempts), NOT
+     * DEFAULT_RETRY_CONFIG.maxRetries (3).
+     */
     maxRetries?: number;
     /** Base backoff delay (ms). Default: DEFAULT_RETRY_CONFIG. */
     baseDelayMs?: number;
@@ -12500,6 +12511,13 @@ declare class RecoverableExpert extends Expert {
     execute(task: Task$1, options?: {
         signal?: AbortSignal;
     }): Promise<Result<TaskResult, AgentError$1>>;
+    /**
+     * Builds the annotated failure returned when recovery is exhausted. withRetry
+     * skips isRetryable on the final attempt, so the per-attempt `lastClassification`
+     * can be stale (or undefined for maxRetries:0). Re-classify the actual `lastError`
+     * so the recovery trace labels the failure that was truly returned.
+     */
+    private annotateExhausted;
     /** Appends archetype recovery guidance to a mutable copy of the task. */
     private injectRecoveryGuidance;
     /** Recovers the DetectedFailure for an archetype (re-detect, else synthesize). */

package/dist/index.js

@@ -541,7 +541,7 @@ import {
   withLogging,
   withRetry,
   withRetryWrapper
-} from "./chunk-CC3H5XJR.js";
+} from "./chunk-5UKKGPRS.js";
 import {
   FALLBACK_SCANNER_DATA,
   buildPlanFromAnalysis,
@@ -575,7 +575,7 @@ import {
   getKnownNexusVarNames,
   startStdioServer,
   validateNexusEnv
-} from "./chunk-OKZ72FVJ.js";
+} from "./chunk-H63X54TU.js";
 import {
   OPENAI_MODELS,
   OPENAI_MODEL_ALIASES,

package/dist/{setup-command-JVQTBFUD.js → setup-command-24Z3KEHP.js}

@@ -8,9 +8,9 @@ import {
   runWizard,
   setupCommand,
   setupCommandAsync
-} from "./chunk-A7RTXDXK.js";
+} from "./chunk-GNXQBXFI.js";
 import "./chunk-4KURMOBY.js";
-import "./chunk-OKZ72FVJ.js";
+import "./chunk-H63X54TU.js";
 import "./chunk-3DYABC5Y.js";
 import "./chunk-5IDFZ2PC.js";
 import "./chunk-NUBSJGQZ.js";
@@ -38,4 +38,4 @@ export {
   setupCommand,
   setupCommandAsync
 };
-//# sourceMappingURL=setup-command-JVQTBFUD.js.map
+//# sourceMappingURL=setup-command-24Z3KEHP.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agents",
-  "version": "2.173.1",
+  "version": "2.173.2",
   "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",