@nexus-cortex/core 4.108.1 → 4.108.3

package/dist/orchestrator/compactionResume.d.ts

@@ -27,7 +27,29 @@ export interface CompactionResumeInput {
     resumeText: string;
     taskText: string;
     helperModelId?: string;
+    rebuild?: string;
+    memorySource?: 'checkpoint' | 'dropped' | 'rolled' | 'none';
 }
 /** The `<system-reminder>` prepended to the compacted history. */
 export declare function buildCompactionResumeReminder(i: CompactionResumeInput): string;
+/** Recover the ORIGINAL TASK text from a prior compaction reminder (the task message itself is gone after the first compaction). */
+export declare function extractTaskFromReminder(reminderText: string): string;
+/**
+ * The task, from the first plain user message if it still exists, else from the newest compaction reminder in the history,
+ * else the pinned copy the orchestrator kept from an earlier compaction.
+ */
+export declare function resolveTaskText(messages: any[], pinned: string, maxChars?: number): string;
+/** Resume-memory size: ~10% of the compaction threshold, clamped to [1500, 6000] tokens (a forced 14K test window gets ~1.5K). */
+export declare function resumeMemoryTargetTokens(threshold: number): number;
+/**
+ * v3 (4.108.3, from the live proof): a checkpoint may be REUSED at compaction only if it already covered every message being
+ * dropped. The v2 rule compared token distance, which goes negative once a compaction shrinks the history — so one stale checkpoint
+ * was replayed into every later reminder and the model's progress after it was erased each time (27 compactions, 0 fresh memories).
+ */
+export declare function coversAll(covered: WeakSet<object> | undefined, dropped: any[]): boolean;
+/**
+ * v3: when the checkpoint is stale, the new summary must ROLL the prior memory forward — the helper sees the prior memory as the
+ * first message, then the newly dropped messages, and writes one memory covering both (otherwise each compaction forgets the last).
+ */
+export declare function buildRollingSeedMessage(priorText: string): any;
 //# sourceMappingURL=compactionResume.d.ts.map

package/dist/orchestrator/compactionResume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compactionResume.d.ts","sourceRoot":"","sources":["../../src/orchestrator/compactionResume.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAE9E,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGrF;AAmBD,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,QAAQ,SAAO,GAAG,MAAM,CAS7E;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGvD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAc9E"}
+{"version":3,"file":"compactionResume.d.ts","sourceRoot":"","sources":["../../src/orchestrator/compactionResume.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAE9E,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGrF;AAmBD,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,QAAQ,SAAO,GAAG,MAAM,CAS7E;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGvD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC7D;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAkB9E;AAED,oIAAoI;AACpI,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAWxF;AAED,kIAAkI;AAClI,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAGvF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAU9D"}

package/dist/orchestrator/compactionResume.js

@@ -58,14 +58,72 @@ export function pickDropped(all, kept) {
 export function buildCompactionResumeReminder(i) {
     const head = `${COMPACTION_RESUME_MARKER} at turn ${i.turn}: ${i.droppedCount} older message(s) (~${Math.max(0, i.tokensBefore - i.tokensAfter)} tokens) ` +
         `were removed from your context to stay within the model window; ${i.keptCount} recent message(s) were kept verbatim.]`;
+    const src = i.memorySource === 'checkpoint' ? 'at the pre-compaction checkpoint (whole conversation)'
+        : i.memorySource === 'rolled' ? 'from the removed messages, carrying the earlier resume memory forward'
+            : 'from the removed messages';
     const memory = i.resumeText.trim()
-        ? `RESUME MEMORY (written by ${i.helperModelId ?? 'the helper model'} from the removed messages — decisions, artifacts, what worked, what failed, open plan):\n${i.resumeText.trim()}`
+        ? `RESUME MEMORY (written by ${i.helperModelId ?? 'the helper model'} ${src}):\n${i.resumeText.trim()}`
         : 'RESUME MEMORY: unavailable (the helper summary failed); rely on the files on disk and the recent messages below.';
     const task = i.taskText.trim()
         ? `ORIGINAL TASK (verbatim — this is still the goal):\n${i.taskText.trim()}`
         : 'ORIGINAL TASK: not recoverable from history; re-read any task file in the working directory.';
-    const tail = 'Continue from the CURRENT state: files already written are on disk (re-read before editing), commands already run need not be repeated, ' +
-        'and completed sub-goals in the resume memory are done. Do not restart from scratch.</system-reminder>';
+    const tail = (i.rebuild && i.rebuild.trim()
+        ? i.rebuild.trim()
+        : 'Continue from the CURRENT state: files already written are on disk (re-read before editing), commands already run need not be repeated, ' +
+            'and completed sub-goals in the resume memory are done. Do not restart from scratch.') + '</system-reminder>';
     return `${head}\n${memory}\n${task}\n${tail}`;
 }
+/** Recover the ORIGINAL TASK text from a prior compaction reminder (the task message itself is gone after the first compaction). */
+export function extractTaskFromReminder(reminderText) {
+    const m = reminderText.match(/ORIGINAL TASK \(verbatim[^\n]*\):\n([\s\S]*?)\n(?:REBUILD PROTOCOL|Continue from the CURRENT state)/);
+    return m && m[1] ? m[1].trim() : '';
+}
+/**
+ * The task, from the first plain user message if it still exists, else from the newest compaction reminder in the history,
+ * else the pinned copy the orchestrator kept from an earlier compaction.
+ */
+export function resolveTaskText(messages, pinned, maxChars = 6000) {
+    const direct = extractFirstUserText(messages, maxChars);
+    if (direct)
+        return direct;
+    for (let i = (messages ?? []).length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (isCompactionResumeMessage(m)) {
+            const t = extractTaskFromReminder(textOf(m));
+            if (t)
+                return t;
+        }
+    }
+    return pinned || '';
+}
+/** Resume-memory size: ~10% of the compaction threshold, clamped to [1500, 6000] tokens (a forced 14K test window gets ~1.5K). */
+export function resumeMemoryTargetTokens(threshold) {
+    if (!(threshold > 0))
+        return 6000;
+    return Math.max(1500, Math.min(6000, Math.floor(threshold * 0.1)));
+}
+/**
+ * v3 (4.108.3, from the live proof): a checkpoint may be REUSED at compaction only if it already covered every message being
+ * dropped. The v2 rule compared token distance, which goes negative once a compaction shrinks the history — so one stale checkpoint
+ * was replayed into every later reminder and the model's progress after it was erased each time (27 compactions, 0 fresh memories).
+ */
+export function coversAll(covered, dropped) {
+    if (!covered)
+        return false;
+    return (dropped ?? []).every((m) => !!m && typeof m === 'object' && covered.has(m));
+}
+/**
+ * v3: when the checkpoint is stale, the new summary must ROLL the prior memory forward — the helper sees the prior memory as the
+ * first message, then the newly dropped messages, and writes one memory covering both (otherwise each compaction forgets the last).
+ */
+export function buildRollingSeedMessage(priorText) {
+    const text = 'PRIOR RESUME MEMORY (already summarizes everything before the messages that follow — carry every DONE / OUTSTANDING / DECISION ' +
+        'item forward unless the messages below supersede it):\n' + String(priorText ?? '').trim();
+    return {
+        uuid: `resume-seed-${Date.now().toString(36)}`,
+        timestamp: new Date().toISOString(),
+        type: 'user',
+        message: { role: 'user', content: [{ type: 'text', text }] },
+    };
+}
 //# sourceMappingURL=compactionResume.js.map

package/dist/orchestrator/compactionResume.js.map

@@ -1 +1 @@
-{"version":3,"file":"compactionResume.js","sourceRoot":"","sources":["../../src/orchestrator/compactionResume.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AAE9E,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC1E,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1E,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,MAAM,CAAC,OAAY;IAC1B,MAAM,CAAC,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC;IACtC,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aACxE,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACvB,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,MAAM,CAAC,OAAY;IAC1B,OAAO,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;AACxE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,yBAAyB,CAAC,OAAY;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAe,EAAE,QAAQ,GAAG,IAAI;IACnE,KAAK,MAAM,CAAC,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM;YAAE,SAAS;QACnC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC;YAAE,SAAS;QAChD,OAAO,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,8BAA8B,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAI,GAAQ,EAAE,IAAS;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAI,IAAI,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAaD,kEAAkE;AAClE,MAAM,UAAU,6BAA6B,CAAC,CAAwB;IACpE,MAAM,IAAI,GACR,GAAG,wBAAwB,YAAY,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,YAAY,uBAAuB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW;QAC7I,mEAAmE,CAAC,CAAC,SAAS,yCAAyC,CAAC;IAC1H,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE;QAChC,CAAC,CAAC,6BAA6B,CAAC,CAAC,aAAa,IAAI,kBAAkB,6FAA6F,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;QACtL,CAAC,CAAC,kHAAkH,CAAC;IACvH,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC5B,CAAC,CAAC,uDAAuD,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE;QAC5E,CAAC,CAAC,8FAA8F,CAAC;IACnG,MAAM,IAAI,GACR,0IAA0I;QAC1I,uGAAuG,CAAC;IAC1G,OAAO,GAAG,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"compactionResume.js","sourceRoot":"","sources":["../../src/orchestrator/compactionResume.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/compactionResumeTemplate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HB-COMPACTION-RESUME v2 (4.108.2, 2026-09-12) — the resume-memory PROTOCOL, ported from the operator's own
+ * `resume-session` skill (the routine used in Claude Code sessions for months: checkpoint BEFORE compaction,
+ * rebuild from the checkpoint AFTER). Three pieces:
+ *   1. `RESUME_MEMORY_PROMPT` — what the helper model writes at the pressure rung / at compaction (the skill's §2 template).
+ *   2. `buildRebuildInstructions` — the post-compaction wake protocol injected with the memory (the skill's §4).
+ *   3. `resolveCheckpointBand` — the pressure rung: checkpoint at N% of the compaction threshold, refreshed per band.
+ */
+/** The skill's §2 template, addressed to the helper model. `{{CONVERSATION}}` is replaced with the history text. */
+export declare const RESUME_MEMORY_PROMPT = "You are writing a RESUME MEMORY for an autonomous coding agent whose conversation context is about to be\ncompacted (older messages removed). The agent that continues will have ONLY this memory, the original task, and the\nmost recent few messages. Write it so that agent can continue with NO loss of useful work. Be concrete: real paths,\nreal commands, real values, verbatim error text. Never paraphrase a constraint. Target ~{{TARGET_TOKENS}} tokens.\n\nUse EXACTLY these sections:\n\n## 0. WORK ORDER \u2014 the task, VERBATIM\nQuote the user's task/instructions word for word (every constraint, every literal). If the task evolved, quote each user message in order.\n\n## 1. STATE \u2014 DONE (with evidence)\nBullet list of what is COMPLETE: files created/edited (absolute paths + what changed), commands run and their results,\ntests/verifications that passed, sub-goals satisfied. Mark anything only partially done as PARTIAL with what remains.\n\n## 2. STATE \u2014 OUTSTANDING, in order, with the exact next commands\nOrdered list of what remains. For each: the concrete next action (a command line, a file to edit and how, a check to run).\nThe first item is what the agent should do immediately after reading this.\n\n## 3. DECISIONS and REJECTED APPROACHES\nChoices made and why; approaches tried that FAILED, with the error text, so they are not repeated.\n\n## 4. ARTIFACTS and POINTERS\nEvery path that matters (source files, outputs, logs, temp dirs), key line numbers, environment facts (installed tools,\nversions, ports, credentials locations \u2014 never the secret values), and any external state (services started, containers).\n\n## 5. TRAPS\nGotchas discovered (environment quirks, flaky commands, wrong assumptions corrected). One line each.\n\n## 6. CURRENT WORK \u2014 the last few actions\nWhat was happening right before this memory was written (last tool calls and their results), so the agent can pick up mid-step.\n\nCONVERSATION HISTORY:\n{{CONVERSATION}}\n\nWrite the resume memory now (sections 0\u20136, nothing else):";
+/** The skill's §4 wake protocol, spoken to the resumed agent. */
+export declare function buildRebuildInstructions(): string;
+/**
+ * Pressure rung: the checkpoint band. `pct` = fraction of the compaction threshold at which the FIRST checkpoint is
+ * written (default 0.75, env CORTEX_COMPACTION_CHECKPOINT_PCT); after that a refresh happens every `stepPct` of the
+ * threshold (default 0.10). Returns the band index the current token count is in (0 = below the first rung), so the
+ * caller checkpoints exactly once per band.
+ */
+export declare function resolveCheckpointBand(currentTokens: number, threshold: number, env?: NodeJS.ProcessEnv): number;
+/** Fill the prompt template. */
+export declare function renderResumeMemoryPrompt(conversationText: string, targetTokens: number): string;
+/**
+ * v3 (4.108.3): the band to re-arm the rung at AFTER a compaction. The memory is fresh at that moment, so later cycles need only
+ * the LAST rung before the threshold (one whole-conversation helper call per cycle, not one per band — each call summarizes the
+ * whole history, which at a 747K threshold is a ~$0.1 helper call). Returns max(band at the post-compaction level, lastBand − 1).
+ */
+export declare function resolveRearmBand(tokensAfter: number, threshold: number, env?: NodeJS.ProcessEnv): number;
+//# sourceMappingURL=compactionResumeTemplate.d.ts.map

package/dist/orchestrator/compactionResumeTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactionResumeTemplate.d.ts","sourceRoot":"","sources":["../../src/orchestrator/compactionResumeTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oHAAoH;AACpH,eAAO,MAAM,oBAAoB,4gEAkCyB,CAAC;AAE3D,iEAAiE;AACjE,wBAAgB,wBAAwB,IAAI,MAAM,CASjD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAOR;AAQD,gCAAgC;AAChC,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAIR"}

package/dist/orchestrator/compactionResumeTemplate.js

@@ -0,0 +1,91 @@
+/**
+ * HB-COMPACTION-RESUME v2 (4.108.2, 2026-09-12) — the resume-memory PROTOCOL, ported from the operator's own
+ * `resume-session` skill (the routine used in Claude Code sessions for months: checkpoint BEFORE compaction,
+ * rebuild from the checkpoint AFTER). Three pieces:
+ *   1. `RESUME_MEMORY_PROMPT` — what the helper model writes at the pressure rung / at compaction (the skill's §2 template).
+ *   2. `buildRebuildInstructions` — the post-compaction wake protocol injected with the memory (the skill's §4).
+ *   3. `resolveCheckpointBand` — the pressure rung: checkpoint at N% of the compaction threshold, refreshed per band.
+ */
+/** The skill's §2 template, addressed to the helper model. `{{CONVERSATION}}` is replaced with the history text. */
+export const RESUME_MEMORY_PROMPT = `You are writing a RESUME MEMORY for an autonomous coding agent whose conversation context is about to be
+compacted (older messages removed). The agent that continues will have ONLY this memory, the original task, and the
+most recent few messages. Write it so that agent can continue with NO loss of useful work. Be concrete: real paths,
+real commands, real values, verbatim error text. Never paraphrase a constraint. Target ~{{TARGET_TOKENS}} tokens.
+
+Use EXACTLY these sections:
+
+## 0. WORK ORDER — the task, VERBATIM
+Quote the user's task/instructions word for word (every constraint, every literal). If the task evolved, quote each user message in order.
+
+## 1. STATE — DONE (with evidence)
+Bullet list of what is COMPLETE: files created/edited (absolute paths + what changed), commands run and their results,
+tests/verifications that passed, sub-goals satisfied. Mark anything only partially done as PARTIAL with what remains.
+
+## 2. STATE — OUTSTANDING, in order, with the exact next commands
+Ordered list of what remains. For each: the concrete next action (a command line, a file to edit and how, a check to run).
+The first item is what the agent should do immediately after reading this.
+
+## 3. DECISIONS and REJECTED APPROACHES
+Choices made and why; approaches tried that FAILED, with the error text, so they are not repeated.
+
+## 4. ARTIFACTS and POINTERS
+Every path that matters (source files, outputs, logs, temp dirs), key line numbers, environment facts (installed tools,
+versions, ports, credentials locations — never the secret values), and any external state (services started, containers).
+
+## 5. TRAPS
+Gotchas discovered (environment quirks, flaky commands, wrong assumptions corrected). One line each.
+
+## 6. CURRENT WORK — the last few actions
+What was happening right before this memory was written (last tool calls and their results), so the agent can pick up mid-step.
+
+CONVERSATION HISTORY:
+{{CONVERSATION}}
+
+Write the resume memory now (sections 0–6, nothing else):`;
+/** The skill's §4 wake protocol, spoken to the resumed agent. */
+export function buildRebuildInstructions() {
+    return ('REBUILD PROTOCOL — do these in order before new work: ' +
+        '(1) Re-read the WORK ORDER above; that is still the goal. ' +
+        '(2) Trust the files on disk over this memory: verify the state of every artifact in §4 (ls / cat / git status / the check commands in §2) before acting on it. ' +
+        '(3) Do NOT redo anything listed as DONE in §1; do NOT retry anything listed as REJECTED in §3. ' +
+        '(4) Start with §2 item 1. ' +
+        '(5) If something in this memory contradicts what you observe, the observation wins — note the discrepancy and continue.');
+}
+/**
+ * Pressure rung: the checkpoint band. `pct` = fraction of the compaction threshold at which the FIRST checkpoint is
+ * written (default 0.75, env CORTEX_COMPACTION_CHECKPOINT_PCT); after that a refresh happens every `stepPct` of the
+ * threshold (default 0.10). Returns the band index the current token count is in (0 = below the first rung), so the
+ * caller checkpoints exactly once per band.
+ */
+export function resolveCheckpointBand(currentTokens, threshold, env = process.env) {
+    if (!(threshold > 0) || !(currentTokens > 0))
+        return 0;
+    const pct = clampPct(env.CORTEX_COMPACTION_CHECKPOINT_PCT, 0.75);
+    const step = clampPct(env.CORTEX_COMPACTION_CHECKPOINT_STEP, 0.10, 0.02, 0.5);
+    const ratio = currentTokens / threshold;
+    if (ratio < pct)
+        return 0;
+    return 1 + Math.floor((ratio - pct) / step + 1e-9); // epsilon: 0.85-0.75 is 0.0999… in binary
+}
+function clampPct(raw, dflt, lo = 0.3, hi = 0.99) {
+    const n = Number(String(raw ?? '').trim());
+    if (!Number.isFinite(n) || n <= 0)
+        return dflt;
+    return Math.min(hi, Math.max(lo, n));
+}
+/** Fill the prompt template. */
+export function renderResumeMemoryPrompt(conversationText, targetTokens) {
+    return RESUME_MEMORY_PROMPT.replace('{{TARGET_TOKENS}}', String(targetTokens)).replace('{{CONVERSATION}}', conversationText);
+}
+/**
+ * v3 (4.108.3): the band to re-arm the rung at AFTER a compaction. The memory is fresh at that moment, so later cycles need only
+ * the LAST rung before the threshold (one whole-conversation helper call per cycle, not one per band — each call summarizes the
+ * whole history, which at a 747K threshold is a ~$0.1 helper call). Returns max(band at the post-compaction level, lastBand − 1).
+ */
+export function resolveRearmBand(tokensAfter, threshold, env = process.env) {
+    if (!(threshold > 0))
+        return 0;
+    const lastBand = resolveCheckpointBand(threshold * 0.999999, threshold, env);
+    return Math.max(resolveCheckpointBand(tokensAfter, threshold, env), Math.max(0, lastBand - 1));
+}
+//# sourceMappingURL=compactionResumeTemplate.js.map

package/dist/orchestrator/compactionResumeTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactionResumeTemplate.js","sourceRoot":"","sources":["../../src/orchestrator/compactionResumeTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oHAAoH;AACpH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAkCsB,CAAC;AAE3D,iEAAiE;AACjE,MAAM,UAAU,wBAAwB;IACtC,OAAO,CACL,wDAAwD;QACxD,4DAA4D;QAC5D,iKAAiK;QACjK,iGAAiG;QACjG,4BAA4B;QAC5B,yHAAyH,CAC1H,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,SAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,aAAa,GAAG,SAAS,CAAC;IACxC,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,0CAA0C;AAChG,CAAC;AAED,SAAS,QAAQ,CAAC,GAAuB,EAAE,IAAY,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,IAAI;IAC1E,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,wBAAwB,CAAC,gBAAwB,EAAE,YAAoB;IACrF,OAAO,oBAAoB,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;AAC/H,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,SAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,SAAS,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/core",
-  "version": "4.108.1",
+  "version": "4.108.3",
   "description": "Core orchestration library implementing Claude CLI architecture patterns",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,8 +47,8 @@
     "@google/generative-ai": "^0.2.1",
     "@gradio/client": "^2.3.1",
     "@modelcontextprotocol/sdk": "^1.20.2",
-    "@nexus-cortex/executors": "4.108.1",
-    "@nexus-cortex/types": "4.108.1",
+    "@nexus-cortex/executors": "4.108.3",
+    "@nexus-cortex/types": "4.108.3",
     "@types/uuid": "^10.0.0",
     "ajv": "^8.12.0",
     "chokidar": "^3.6.0",