@nexus-cortex/cli 4.84.0 → 4.86.0

package/.env.example

@@ -157,6 +157,12 @@ MENTORSHIP_ENABLED=true
 # Forced-tool_choice backstop (AskForAdvice v2): on HIGH-confidence thrash, FORCE the model to
 # call AskForAdvice for one turn. Voluntary heed is ~0 (0/47 lifted transcripts), so forcing is
 # what actually makes the mentor fire. OFF by default — the v2 forcing path is not yet TB2-validated.
+# 🔴 MASTER GATE for the ENTIRE v2 forced-choice chain. Setting this =true (with MENTORSHIP_ENABLED=true)
+# is the ONLY thing that produces a forced tool_choice, which in turn activates ALL of the v2 provider
+# fixes for that forced turn: DeepSeek thinking-mode disable, tools-array restriction to the forced tool,
+# and parallel_tool_calls off. With this =false, every one of those paths is inert and request behavior
+# is byte-identical to pre-v2 (verified end-to-end 2026-08-29) — the code ships DARK. Flip to true only
+# after the forced-consult efficacy bench confirms it actually breaks the retry-loop.
 CORTEX_MENTOR_FORCE=false
 # Trigger helper-model review on tool errors (only applies when mentorship is enabled)
 MENTORSHIP_TRIGGER_ON_ERROR=false
@@ -276,10 +282,15 @@ ENABLE_DEFERRED_TOOL_LOADING=true
 #   pointing the model at SearchTools (to reach the tools the deferred filter hides) and,
 #   when mentorship is active, AskForAdvice. Turn 1 stays a pristine narrow door; the
 #   pointer lands only after the model has acted. No-op when deferred loading is off.
+# GLOBAL BASELINE for models WITHOUT a card opinion (harness serves 17 models / 7 providers).
+# The per-model CARD OVERRIDES this (deepseek-v4-flash ships liftNudge:true; pro/vision leave it
+# to this baseline). Set true to enable the signpost fleet-wide for un-carded models; a card can
+# still opt a specific model out. Precedence: card > this env > default.
 CORTEX_LIFT_NUDGE=false
 #   CORTEX_HEADLESS_DROP_ASKUSER — in NON-INTERACTIVE sessions (stateless /v1/messages,
 #   headless API, piped oneshot) there is no human to answer AskUserQuestion, so it is a
 #   stall trap; drop it at the tool source. Kept in interactive TUIs.
+# GLOBAL BASELINE for un-carded models; the per-model card overrides. Precedence: card > env > default.
 CORTEX_HEADLESS_DROP_ASKUSER=false
 # Programmatic Tool Calling (compose tool calls in a script) — experimental
 ENABLE_PTC=false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/cli",
-  "version": "4.84.0",
+  "version": "4.86.0",
   "description": "Nexus Cortex CLI - Terminal interface for multi-provider LLM orchestration",
   "main": "dist/index.js",
   "type": "module",
@@ -19,7 +19,7 @@
     "prepack": "node ../../scripts/copy-pkg-cortex-scaffold.mjs"
   },
   "dependencies": {
-    "@nexus-cortex/core": "4.84.0",
+    "@nexus-cortex/core": "4.86.0",
     "chalk": "^4.1.2",
     "cli-spinners": "^2.9.0",
     "commander": "^11.0.0",