@nexus-cortex/cli 4.108.18 → 4.108.19

package/.env.defaults

@@ -769,6 +769,15 @@ CORTEX_ENDTURN_GATE=true
 # (+ chars/4 of what was appended since; proportional shrink after a drop) — the chars/4-of-the-JSON-envelope heuristic (R129-scaled) is only
 # the fallback before the first usage arrives. Field read on the TB4.0 definitive run (4.108.5): heat-pump-warranty compacted at "760K-1.0M"
 # vs an API max of 151,763 prompt tokens (5-7x over). Compaction rows now bank estimateSource usage-anchored|heuristic + anchorTokens.
+# CORTEX_COMPACTION_HANDOFF_QA / _MAX_QUESTIONS — R143 HB-HANDOFF-QA-SUMMARY (4.108.19), from Terminus 2's three-step handoff: after the checkpoint
+# memory is written, (2) a history-FREE helper call is given the task + the summary + the workspace state and asks up to N gap questions a
+# successor would need answered; (3) a helper call WITH the covered history answers them (verbatim values; "not recorded" when unknown); the
+# memory gets a `## GAPS (Q/A)` section. Banked on the compaction row as handoffQA {questions, answered, notRecorded, cost}; any failure keeps
+# the plain memory. DARK (default false) — an A/B on the compaction proof task decides it (rig must be rebuilt; recipe in the 4.108.3 lines).
+# [LEDGER 2026-09-13 @4.108.19] BUILT + unit-tested (compactionResume.test.ts 28, effectiveConfig-handoffQA 2); UNMEASURED. Known gap: the helper
+# adapter's chunking path ignores the prompt override on oversize histories (answers degrade to "not recorded").
+#CORTEX_COMPACTION_HANDOFF_QA=
+#CORTEX_COMPACTION_HANDOFF_QA_MAX_QUESTIONS=
 #CORTEX_COMPACTION_CHECKPOINT_PCT=
 #CORTEX_COMPACTION_CHECKPOINT_STEP=
 # CORTEX_COMPACTION_THRESHOLD_TOKENS — TEST/OPS OVERRIDE of the compaction threshold (4.108.3). Unset (default) = the threshold is derived
@@ -957,6 +966,20 @@ PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=
 # input through a 0600 temp file + `tmux load-buffer` / `paste-buffer -d -p` (bracketed), Enter always a separate send-keys; short input stays
 # `send-keys -l`. Fixes heredoc/`python3 -c` bodies breaking at the send-keys limit (TB4.0 rs-archive-clone "unexpected end of file"). Smoke:
 # 8733-byte heredoc byte-exact through tmux; 6 KB via herdr send-text.
+# CORTEX_TMUX_AUTO_INSTALL / CORTEX_TMUX_STATIC_URL / CORTEX_TMUX_HISTORY_LIMIT / CORTEX_TMUX_PANE_SIZE — R138/R139/R141 (4.108.19), from Terminus 2's
+# tmux_session.py. R138: when tmux is missing and AUTO_INSTALL != false, the first persistent-mode request tries (time-bounded 120 s each) the
+# detected package manager (apt-get with expired-Release tolerance, apk, dnf, yum, brew) then a static binary from STATIC_URL into ~/.local/bin
+# (no default URL = skipped), then degrades (R134); one [INFO]/[WARN]; cached per process; runs as the harness user (no sudo). R139: blocking
+# persistent runs signal completion with `tmux wait-for -S <chan>` and block on the channel under a hard in-process cap (cap expiry = timedOut,
+# process left running) — the 400 ms sentinel poll remains only for `wait_for` regex waits. R141: sessions are created with history-limit
+# (default 50000) and a fixed pane (default 160x40); every tmux capture/read is capped at 10 KB middle-omitted; TmuxSession capture gains `lines`.
+# [LEDGER 2026-09-13 @4.108.19] BUILT + unit-tested (TmuxManager 19, TerminalBackend 33, TmuxSessionToolCaptureCap 4, ShellTool 63) + tmux SMOKE
+# (create 50000/160x40; wait-for rc; cap expiry timedOut with the process alive; 40 KB capture → 10 KB). Smoke caught + fixed: the tmux client
+# traps SIGTERM and exits 0, which execFile's timeout reported as success — the exec now owns the timer (SIGKILL + explicit killed).
+#CORTEX_TMUX_AUTO_INSTALL=
+#CORTEX_TMUX_STATIC_URL=
+#CORTEX_TMUX_HISTORY_LIMIT=
+#CORTEX_TMUX_PANE_SIZE=
 TMUX_BIN=
 # Google Vertex AI project (only when using Vertex instead of the Gemini API)
 GOOGLE_CLOUD_PROJECT=

package/package.json

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