@nexus-cortex/cli 4.108.2 → 4.108.3

package/.env.defaults

@@ -740,6 +740,10 @@ CORTEX_ENDTURN_GATE=true
 # reminder is appended to the session JSONL, and .cortex/memory/resume-<session>.md is written. false = the old silent drop.
 # [LEDGER 2026-09-12 @4.108.0] BUILT + unit-tested (compactionResume.test.ts); UNMEASURED on a bench — the first TB4.0 (8-h budget) run on
 # 4.108.x is the field test (count `compaction` events per session; compare pass rate on tasks that compacted vs the 4.107.2 VM run).
+# [LEDGER 2026-09-12 @4.108.3] LIVE-PROVED (forced 14K threshold, deepseek-flash, /tmp/claude-1000/cmp-test/run.sh): reminder + verbatim task
+# pin + rebuild protocol on every compaction; resume file written; facts survived 6 compactions (4/4). The hardened proof (task working set
+# > window) found the v2 stale-checkpoint replay (fixed, v3 rolling memory) and that the anti-loop stack fights chunked reads
+# (HB-CHUNKED-READS, open) — a task whose working set exceeds the window still degrades; that is the model's problem class, not this lever's.
 #CORTEX_COMPACTION_RESUME=
 # CORTEX_COMPACTION_CHECKPOINT_PCT / _STEP — the PRESSURE RUNG (4.108.2): the resume memory of the WHOLE conversation is written by the
 # helper model at PCT (default 0.75) of the compaction threshold — BEFORE any drop, the way the operator's resume-session routine checkpoints
@@ -748,8 +752,22 @@ CORTEX_ENDTURN_GATE=true
 # DONE, OUTSTANDING with next commands, DECISIONS/REJECTED, ARTIFACTS, TRAPS, CURRENT WORK) and the reminder ends with the REBUILD PROTOCOL.
 # [LEDGER 2026-09-12 @4.108.2] BUILT + unit-tested (compactionResumeTemplate.test.ts); UNMEASURED on a bench — field read = `compaction` events
 # with mode checkpoint|proactive and memorySource checkpoint|dropped per session on the first 4.108.2 TB4.0 run.
+# [LEDGER 2026-09-12 @4.108.3] v3: reuse is gated on COVERAGE (the checkpoint summarized every dropped message), else the prior memory is
+# ROLLED forward with the dropped messages (memorySource `rolled`); the rung RE-ARMS after each compaction so the last band before the
+# threshold refires every cycle (one whole-conversation helper call per cycle). Live: 28 compactions / 28 fresh covering checkpoints /
+# 0 stale replays (proof run 6). The v2 rule (token distance) replayed ONE stale memory into 27 compactions — never ship a reuse test on tokens.
 #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
+# from the model card's context window (the ~747K/1M rung). Set = that many tokens becomes the compaction threshold and the kept-history
+# budget is half of it, so the whole compaction path (checkpoint rung → helper resume memory → proactive drop → reminder + rebuild protocol)
+# can be exercised in minutes on a small task instead of after hours of an 8-h bench task. NOT a tuning lever for production: a low value
+# discards history the model still needs. The resume memory is sized to ~10% of the threshold (clamp 1500–6000 tokens) so a small threshold
+# does not produce a memory larger than the history it replaces.
+# [LEDGER 2026-09-12 @4.108.3] BUILT + unit-tested (compactionResume.test.ts: resumeMemoryTargetTokens, resolveTaskText); used by the LIVE
+# proof (/tmp/claude-1000/cmp-test/run.sh, deepseek-flash, threshold 14000, rung 0.6): checkpoint fired, 6 proactive compactions in 17
+# iterations (5 reused the checkpoint at $0), task pinned verbatim in every reminder, final answer 4/4 planted facts — mechanism proven.
+#CORTEX_COMPACTION_THRESHOLD_TOKENS=
 
 # CORTEX_DELEGATION_HINT — DARK (4.108.1, HB-DELEGATION-DOCTRINE). true = the boot-minimal prompt gains ONE clause naming the Task tool for
 # large / independent / output-heavy sub-tasks (delegate with a self-contained prompt, continue from the summary). The Task tool is

package/package.json

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