@nexus-cortex/cli 4.103.0 → 4.104.0

package/.env.defaults

@@ -308,6 +308,25 @@ MENTORSHIP_CUSTOM_KEYWORDS=
 #   lift plan / resolver verdict / deadline-exit / loop-exit / consult in every cell to date was a NON-thinking call. From
 #   4.103.0 the mentor's *_EFFORT (max) is sent as reasoning_effort. cell-m is the first cell with a thinking mentor.
 MENTORSHIP_HELPER_MODEL=deepseek-flash
+# ── MENTOR ROLE (2026-09-10, training/mentorRole.ts) — the bounded single-shot judges/planners are a ROLE, distinct from
+#    the HELPER role (HELPER_MODEL_ID: compaction/summaries/vision, thinking OFF). Model = MENTORSHIP_HELPER_MODEL above;
+#    per-surface effort/budget/timeout = CORTEX_LIFT_PLAN_* / CORTEX_ENDTURN_RESOLVER_* / CORTEX_DEADLINE_EXIT_MENTOR_* /
+#    CORTEX_LOOP_TOOL_BLOCK_* (below, in their sections); role-level switches here. Every mentor event banks
+#    `mentor:{model,thinking,effort,budget}` = what the wire carried, so a ledger can prove the config.
+#   CORTEX_MENTOR_REASONING — on|none. Whether the MENTOR surfaces (lift planner, EndTurn resolver, deadline exit,
+#   loop-exit planner — the ones that pass an explicit *_EFFORT, default max) send that effort on the wire (thinking ON),
+#   or keep the helper-role thinking-OFF behaviour (`none`). The AskForAdvice consult and all helper-role calls stay
+#   thinking-off regardless (08-30: thinking-on hints came back blank — reasoning ate the small budget).
+# [LEDGER 2026-09-10 @4.104.0] on (default) — 🔴 every mentor result before 4.103.0 (resolver A/B 09-05, resolver k=5 09-06
+#   +17pp, cell-d-k3 judges) was measured with thinking OFF on the wire despite the "@max" configs (HB-MENTOR-THINKING); the
+#   plans were real and non-empty even so. `none` reproduces that baseline. cell-m A/Bs {pro, deepseek-flash} × {on, none}.
+#CORTEX_MENTOR_REASONING=on
+#   CORTEX_MENTOR_CONSULT_REASONING — on|none. The AskForAdvice consult hint (400-token budget). Default none: the
+#   08-30 measurement — thinking-on hints came back BLANK (reasoning ate the budget); the m88 results were thinking-off.
+# [LEDGER 2026-09-10 @4.104.0] none (default) — unmeasured ON; opt in per cell.
+#CORTEX_MENTOR_CONSULT_REASONING=none
+#   CORTEX_MENTOR_TEMPERATURE — optional sampling temperature for mentor calls (0-2); empty = adapter default 0.7.
+#CORTEX_MENTOR_TEMPERATURE=
 
 # [LEDGER 2026-09-02 @4.90.0] ON — the VISION HAND-OFF (operator design): text-only primaries keep the ReadImage
 # tool; the orchestrator sends the image + the caller's `prompt` to this vision card THROUGH THE HELPER MIDDLEWARE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/cli",
-  "version": "4.103.0",
+  "version": "4.104.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.103.0",
+    "@nexus-cortex/core": "4.104.0",
     "chalk": "^4.1.2",
     "cli-spinners": "^2.9.0",
     "commander": "^11.0.0",