nexus-agents 4.5.1 → 4.6.0

package/dist/cli.js

@@ -18,7 +18,7 @@ import "./chunk-HBGA62JG.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-QNT5WS7E.js";
+} from "./chunk-EKS3ECXS.js";
 import "./chunk-YLESXBB3.js";
 import {
   AuthHandler,
@@ -139,7 +139,7 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-CGJPW5BI.js";
+} from "./chunk-ZZED3BWY.js";
 import "./chunk-C6SAPXUV.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-RSMG2DPB.js";
@@ -166,7 +166,7 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-EPD5MGPB.js";
+} from "./chunk-RWI6YQXG.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv

package/dist/index.d.ts

@@ -11183,15 +11183,44 @@ interface AdaptiveProtocolConfig {
  * Selection result with metadata.
  */
 interface SelectionResult$2 {
-    /** Selected protocol pattern */
+    /**
+     * The pattern that will be used.
+     *
+     * This is always `config.pattern`. `CollaborationPattern` has no `auto`
+     * member, so a caller cannot ask for adaptive selection and adaptation can
+     * never win — see {@link adaptivePattern} for what it would have chosen
+     * (#4833).
+     */
     readonly pattern: CollaborationPattern;
-    /** Classification that led to selection */
+    /**
+     * The pattern adaptation would choose from the task classification (#4833).
+     *
+     * Advisory. Previously computed and discarded, which left the caller unable
+     * to see the one thing this class exists to produce.
+     */
+    readonly adaptivePattern: CollaborationPattern;
+    /** Classification that led to {@link adaptivePattern}. */
     readonly classification: ClassificationResult;
-    /** Whether an explicit override was applied */
+    /**
+     * Whether the caller's pattern differs from {@link adaptivePattern}.
+     *
+     * A comparison, NOT evidence that a selection was applied and then
+     * overridden — nothing is applied. It was logged as though a live decision
+     * had been made and reversed (#4833).
+     */
     readonly wasOverridden: boolean;
 }
 /**
- * Adaptive protocol selector that chooses protocols based on task type.
+ * Adaptive protocol selector that classifies tasks and recommends protocols.
+ *
+ * Advisory: `selectProtocol` cannot change the protocol in use, because
+ * `CollaborationPattern` has no `auto` member and so a caller has no way to
+ * defer to adaptation. `getRecommendation` reports what adaptation would
+ * choose; acting on it is the caller's decision.
+ *
+ * Whether to add that sentinel so adaptation can win is #4833. Its named
+ * consumer is `TechLeadCollaboration.executeCollaboration`, which currently
+ * declines the recommendation on purpose.
  */
 declare class AdaptiveProtocolSelector {
     private readonly factory;
@@ -11200,10 +11229,14 @@ declare class AdaptiveProtocolSelector {
     private readonly log;
     constructor(config?: AdaptiveProtocolConfig);
     /**
-     * Select the optimal protocol for a task.
+     * Classify a task and report which protocol adaptation would choose.
+     *
+     * The returned `pattern` is always `config.pattern`: `CollaborationPattern`
+     * has no `auto` member, so there is no way for a caller to defer to
+     * adaptation. `adaptivePattern` carries the advisory choice (#4833).
      *
-     * @param config - Collaboration config (pattern may be overridden)
-     * @returns Selection result with chosen pattern and reasoning
+     * @param config - Collaboration config; its `pattern` is always honoured
+     * @returns The pattern in use, the advisory choice, and the classification
      */
     selectProtocol(config: CollaborationConfig): SelectionResult$2;
     /**
@@ -11218,9 +11251,11 @@ declare class AdaptiveProtocolSelector {
      */
     execute(config: CollaborationConfig, agents: Map<string, IAgent>): Promise<Result<CollaborationResult, AgentError$1>>;
     /**
-     * Get recommended protocol for a task without executing.
+     * Get the recommended protocol for a task without executing.
      *
-     * Useful for preview/explanation of what protocol would be selected.
+     * Returns the *adaptive* choice. It previously returned `selection.pattern`
+     * — the caller's own input — so the "recommendation" echoed the question
+     * back with reasoning attached that read as an answer (#4833).
      */
     getRecommendation(config: CollaborationConfig): {
         recommendedPattern: CollaborationPattern;

package/dist/index.js

@@ -541,7 +541,7 @@ import {
   withLogging,
   withRetry,
   withRetryWrapper
-} from "./chunk-CGJPW5BI.js";
+} from "./chunk-ZZED3BWY.js";
 import {
   FALLBACK_SCANNER_DATA,
   buildPlanFromAnalysis,
@@ -575,7 +575,7 @@ import {
   getKnownNexusVarNames,
   startStdioServer,
   validateNexusEnv
-} from "./chunk-EPD5MGPB.js";
+} from "./chunk-RWI6YQXG.js";
 import {
   OPENAI_MODELS,
   OPENAI_MODEL_ALIASES,

package/dist/{setup-command-DIL56GPR.js → setup-command-GEWL2HS4.js}

@@ -8,9 +8,9 @@ import {
   runWizard,
   setupCommand,
   setupCommandAsync
-} from "./chunk-QNT5WS7E.js";
+} from "./chunk-EKS3ECXS.js";
 import "./chunk-YLESXBB3.js";
-import "./chunk-EPD5MGPB.js";
+import "./chunk-RWI6YQXG.js";
 import "./chunk-BLY3DXM2.js";
 import "./chunk-7Y7UFVQ5.js";
 import "./chunk-OQB3XC5O.js";
@@ -41,4 +41,4 @@ export {
   setupCommand,
   setupCommandAsync
 };
-//# sourceMappingURL=setup-command-DIL56GPR.js.map
+//# sourceMappingURL=setup-command-GEWL2HS4.js.map

package/package.json

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