@nexus-cortex/cli 4.90.2 → 4.91.0

package/.env.example

@@ -7,7 +7,7 @@
 # ║ .cortex/bench/r-*.md. K=5 CONFIG (settled 2026-09-03 @4.90.1, r-v4-validation):    ║
 # ║ ON set + CORTEX_ENDTURN_GATE=true + CORTEX_ENDTURN_REQUIREMENTS=strict +           ║
 # ║ ENABLE_WEBTOOLS=false (bench pin) + VISION_HELPER_MODEL on + TOOL_TIMEOUT_MODE=auto; ║
-# ║ MENTOR_AUTO / EFFORT_TAIL / EFFORT_PULSE dark. Pin nexus-cortex@4.90.1 (4.90.0's    ║
+# ║ MENTOR_AUTO / EFFORT_TAIL / EFFORT_PULSE dark. Pin nexus-cortex@4.90.2 (4.90.0.s    ║
 # ║ timeout-promote was inert). Both models.                                            ║
 # ╚══════════════════════════════════════════════════════════════════════════════════╝
 # Copy to .env and fill in the API keys for the providers you use. Every other value
@@ -271,6 +271,10 @@ MENTORSHIP_HELPER_MODEL=deepseek-v4-pro
 # montage of individually LABELED squares (def-a3e7920cf9): grid/crop-aware prompts beat whole-image reads; a stronger
 # vision card is the next lever once available.
 VISION_HELPER_MODEL=deepseek-v4-flash-vision-exp
+# Per-turn cap on ReadImage→vision-helper hand-offs (0 = unlimited). Past the cap ReadImage returns a
+# "consolidate your reads into ONE labeled montage / change approach" reminder instead of another vision call.
+# [LEDGER 2026-09-03 @4.91.0] ON=8 (NEW) — v4 gcode-to-text: 14 (flash) / 34 (pro) slice reads burned the whole task budget without converging (def-fcb719427f); chess flash passed with 6 reads. Cap event kind: vision_handoff_capped. Measure at k=5 (gcode budget_frac, chess flips).
+VISION_HANDOFF_MAX=8
 # Periodic mentorship review every N turns
 MENTORSHIP_TURN_BASED_ENABLED=false
 # Turns between periodic reviews (1-50)
@@ -754,6 +758,10 @@ CORTEX_SURRENDER_NUDGE=true
 # N-in-window → one diversify nudge; 2N → break. Default off; bench/serving arm it.
 # [LEDGER 2026-09-02 @4.89.0] ON — guard stack; the retry-loop ladder (retry_loop = 65-74% of fails pre-guards). Code defaults NEARDUP_NUDGE_AT=12 (8 regressed rstan-class grinds) / NEARDUP_WINDOW=30 (break rung unreachable at 20).
 CORTEX_NEARDUP_BREAKER=true
+# Slice-reader nudge: after the 3rd bash slice-read (sed -n N,Mp / head -n / tail -n) of the SAME file in a session,
+# append a one-line reminder to read the file once with Read (offset/limit) instead. Event kind: slice_read.
+# [LEDGER 2026-09-03 @4.91.0] ON (NEW) — doctrine gap flagged 08-29 (A′ doctrine-mine) and recurring in v4 make-doom on BOTH models (5 sed slices of /app/vm.js each); the Bash description's Read-preference line alone does not hold under the bash-edit frame. Post-tool reminder = no turn-1 prompt mass.
+CORTEX_SLICE_NUDGE=true
 # [LEDGER 2026-09-02 @4.89.0] code default 30 (4.88.0) — 20 made the break rung (2N=24) unreachable; preserves 40%/80% density semantics.
 #NEARDUP_WINDOW=30
 # [LEDGER 2026-09-02 @4.89.0] code default 12 (4.88.0) — 8 misfired on persistence-wins grinds (rstan-to-pystan regressed both arms).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/cli",
-  "version": "4.90.2",
+  "version": "4.91.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.90.2",
+    "@nexus-cortex/core": "4.91.0",
     "chalk": "^4.1.2",
     "cli-spinners": "^2.9.0",
     "commander": "^11.0.0",