@mnemom/mnemom 0.17.6-next.0 → 0.17.6-next.2

package/dist/lib/first-run/screen.js

@@ -1,5 +1,5 @@
 /**
- * The first-run screen: one plain terminal screen (at most 16 lines of at most 78
+ * The first-run screen: one plain terminal screen (at most 22 lines of at most 78
  * columns, ASCII) built from the backtest numbers. Pure — no I/O — so every layout is
  * unit-tested. Every number on it is recorded in the audit with its raw value and
  * method.
@@ -26,7 +26,7 @@
  */
 import { ESTIMATOR_METHOD } from "./backtest.js";
 export const WIDTH = 78;
-export const MAX_LINES = 16;
+export const MAX_LINES = 22;
 /** Less history than this (API prices, in the window) is too little to backtest. */
 export const MIN_HISTORY_USD = 5;
 /** Variation A iff the shown saving is at least this many dollars and this many percent. */
@@ -34,14 +34,14 @@ export const STRONG_MIN_USD = 5;
 export const STRONG_MIN_PCT = 5;
 export const DAYS = 30;
 /**
- * The forward line: the best finished chain45 run with its error margin (operator
- * 2026-10-01, until something better): S43 C2 total bill -19.5% [-23.9, -14.9], Opus 5.5,
- * n=23, 95% CI rounded to 15-25. The d240p1 ~45% figure is NOT used (its re-bill
- * undercounts output).
+ * The forward line: chain45 S46 C2n (context runtime, aggressive profile) total bill vs
+ * stock, -20.9% [-25.6, -15.9], Opus 5.5, n=13 (r15 readout; operator 2026-10-02: quote
+ * S46, not S43), 95% CI rounded to fives, 15-25. The d240p1 ~45% figure is NOT used
+ * (its re-bill undercounts output).
  */
-export const FORWARD_LINE = "Long sessions are where Mnemom saves the most: about 15 to 25% in our tests.";
-const FORWARD_SOURCE = "operator 2026-10-01: S43 C2 total bill -19.5% [-23.9, -14.9] (Opus 5.5, n=23), 95% CI " +
-    "rounded to 15 to 25; measured vs stock at the 1M default";
+export const FORWARD_LINE = "Long sessions are where Mnemom saves the most: about 15 to 25% in our datasets.";
+const FORWARD_SOURCE = "operator 2026-10-02: S46 C2n total bill -20.9% [-25.6, -15.9] (Opus 5.5, n=13), 95% CI " +
+    "rounded to fives, 15 to 25; measured vs stock";
 /** Prices, promotions and plan allocations move; the saving is in usage (operator 2026-10-01). */
 export const PRICE_LINE = "Prices and plan limits change. Mnemom cuts what you use, so you stay ahead.";
 /** What `mnemom agent` does today: routes through the gateway, records, keeps context lean. */
@@ -73,11 +73,11 @@ export function pair(total, saved) {
     const tot = sig3(total);
     return [tot, Math.min(sv, tot), Math.max(tot - sv, 0)];
 }
-/** part / whole as a percentage rounded DOWN to a multiple of 5. */
-export function pct5(part, whole) {
+/** part / whole as a whole-number percentage, decimals dropped (rounded DOWN). */
+export function pctDown(part, whole) {
     if (whole <= 0 || part <= 0)
         return 0;
-    return Math.floor((100 * part) / whole / 5 + 1e-9) * 5;
+    return Math.floor((100 * part) / whole + 1e-9);
 }
 const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
 export function day(t) {
@@ -126,17 +126,17 @@ const SAVED_METHOD = `backtest.estimate(): ${ESTIMATOR_METHOD}; 2 sig figs DOWN`
 function subLines(sub, A) {
     if (!sub)
         return [];
-    const p = pct5(sub.saved, sub.actual);
+    const p = pctDown(sub.saved, sub.actual);
     const raw = sub.actual > 0 ? (100 * sub.saved) / sub.actual : 0;
     if (p < 5) {
-        A("sub_line_omitted", { shown: true, raw, method: "usage cut rounds DOWN below 5%" });
+        A("sub_line_omitted", { shown: true, raw, method: "usage cut below 5% (decimals dropped)" });
         return [];
     }
     A("sub_usage_pct", {
         shown: p,
         raw,
         method: "saving / API-price cost over the subscription sessions in the window (all sessions if " +
-            "none is tagged); cost-weighted, rounded DOWN to 5s",
+            "none is tagged); cost-weighted, decimals dropped",
     });
     return wrap(`On your subscription that is about ${p}% less usage: fewer limit hits, and less ` +
         "overage if you use extra usage.");
@@ -151,7 +151,7 @@ export function buildScreen(inp) {
     const actual = ses.reduce((t, r) => t + r.actual, 0);
     const saved = ses.reduce((t, r) => t + r.saved, 0);
     const [a, s, e] = pair(actual, saved);
-    const p = pct5(saved, actual);
+    const p = pctDown(saved, actual);
     const enough = actual >= MIN_HISTORY_USD;
     const variation = enough && s >= STRONG_MIN_USD && p >= STRONG_MIN_PCT ? "A" : enough ? "B" : "C";
     A("variation", { shown: variation, raw: { actual, saved }, method: "see screen.ts header" });
@@ -162,7 +162,11 @@ export function buildScreen(inp) {
     L.push("");
     if (variation === "A") {
         A("spent_usd", { shown: a, raw: actual, method: SPENT_METHOD });
-        A("saved_pct", { shown: p, raw: (100 * saved) / actual, method: "rounded DOWN to 5s" });
+        A("saved_pct", {
+            shown: p,
+            raw: (100 * saved) / actual,
+            method: "decimals dropped (rounded DOWN)",
+        });
         const viaRaw = ses.reduce((t, r) => t + (r.viaMnemom ? r.saved : 0), 0);
         const via = sig2(viaRaw);
         const rest = sig2(saved - viaRaw);
@@ -170,12 +174,14 @@ export function buildScreen(inp) {
             A("saved_usd", { shown: s, raw: saved, method: SAVED_METHOD });
             A("with_mnemom_usd", { shown: e, raw: actual - saved, method: "spent shown - saved shown" });
             L.push(...wrap(`At API prices that usage cost about ${usd(a)}. With Mnemom: about ${usd(e)}.`));
+            L.push("");
             L.push(...wrap(`That's about ${usd(s)} less (${p}%), and you don't change how you work.`));
         }
         else {
             const m = `${SAVED_METHOD}; sessions the launch ledger shows ran through Mnemom`;
             A("saved_via_mnemom_usd", { shown: via, raw: viaRaw, method: m });
             L.push(...wrap(`At API prices that usage comes to about ${usd(a)} without Mnemom.`));
+            L.push("");
             if (rest < 1) {
                 L.push(...wrap(`Mnemom saved you about ${usd(via)} of it (${p}%), and you didn't change how you work.`));
             }
@@ -202,11 +208,14 @@ export function buildScreen(inp) {
             raw: big.actual - big.saved,
             method: "its cost shown - its saving (2 sig figs DOWN)",
         });
+        L.push("");
         const where = big.label ? `${big.label} on ${day(big.end)}` : `on ${day(big.end)}`;
         L.push(...wrap(big.viaMnemom
             ? `Your biggest session, ${where}: ${usd(ba)} without Mnemom, about ${usd(be)} with it.`
             : `Your biggest session, ${where}: ${usd(ba)}, with Mnemom about ${usd(be)}.`));
-        L.push(...subLines(inp.sub, A));
+        const subL = subLines(inp.sub, A);
+        if (subL.length)
+            L.push("", ...subL);
     }
     else {
         if (variation === "B") {
@@ -219,10 +228,12 @@ export function buildScreen(inp) {
             L.push(...wrap(`Your sessions used about ${usd(a)} at API prices. They stayed small, so Mnemom ` +
                 "wouldn't have changed that much."));
         }
-        L.push(FORWARD_LINE);
+        if (variation === "B")
+            L.push("");
+        L.push(...wrap(FORWARD_LINE));
         A("forward_range_pct", {
             shown: "15 to 25",
-            raw: [-23.9, -19.5, -14.9],
+            raw: [-25.6, -20.9, -15.9],
             method: FORWARD_SOURCE,
         });
     }

package/dist/lib/launcher-config.d.ts

@@ -16,7 +16,7 @@
  * the caller folds the plain-value settings under the CLI flags.
  */
 import { type AgentAuth } from "./subscription-login.js";
-import type { ExperimentalId } from "./experimental.js";
+import { type ExperimentalId } from "./experimental.js";
 import { type ContextProfile, type GoalModeDefault, type LaunchShape } from "./agent.js";
 /** The human-editable settings file. Secret key lives elsewhere (launcher.json). */
 export declare const LAUNCHER_CONFIG_PATH: string;
@@ -61,6 +61,12 @@ export interface LauncherConfig {
      * folds earlier with a tighter working set. `--context-profile` overrides it per launch.
      */
     contextProfile?: ContextProfile;
+    /**
+     * The gateway compaction target (`--compact-at`; unset means no target — Claude Code's own
+     * 1M window, nothing new sent). Stored as the validated raw string (e.g. "200k", "1m",
+     * "off", "350000"), parsed with `parseCompactAt` at the point of use.
+     */
+    compactAt?: string;
     guardrails?: {
         maxTurns?: number;
         budgetUsd?: number;
@@ -113,6 +119,9 @@ export declare function launcherEntries(cfg: LauncherConfig): Array<[string, str
 /**
  * `cfg` without the settings of experimental features that are off (a copy; `cfg` is
  * untouched): `slack_*` while `slack` is off, `context_handoff` while `context-handoff` is
- * off, `compaction_intercept` while `compaction-intercept` is off, and `goal_mode = implicit` while `implicit` is off (`goal_mode = off` is kept).
+ * off, `compaction_intercept` (and an ARMED `compact_at` — it arms the same two gateway keys,
+ * so it needs the same opt-in; `compact_at = "off"`/`"1m"` carries no gated behaviour and is
+ * kept) while `compaction-intercept` is off, and `goal_mode = implicit` while `implicit` is
+ * off (`goal_mode = off` is kept).
  */
 export declare function withoutDisabledExperimental(cfg: LauncherConfig, enabled: readonly ExperimentalId[]): LauncherConfig;

package/dist/lib/launcher-config.js

@@ -20,7 +20,8 @@ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "
 import { dirname, join } from "node:path";
 import { parse as parseToml, stringify as stringifyToml, TomlError } from "smol-toml";
 import { MNEMOM_DIR } from "./config.js";
-import { CONTEXT_PROFILES, isPositiveInt, isPositiveNumber, parseContextProfile, } from "./agent.js";
+import { compactAtArmed } from "./experimental.js";
+import { CONTEXT_PROFILES, isPositiveInt, isPositiveNumber, parseCompactAt, parseContextProfile, } from "./agent.js";
 /** The human-editable settings file. Secret key lives elsewhere (launcher.json). */
 export const LAUNCHER_CONFIG_PATH = join(MNEMOM_DIR, "launcher.toml");
 const LAUNCH_SHAPES = ["terminal", "remote-control", "server"];
@@ -67,6 +68,13 @@ function coerceNonEmpty(name, raw) {
         throw new Error(`${name} must be a non-empty string.`);
     return v;
 }
+function coerceCompactAt(raw) {
+    const v = raw.trim().toLowerCase();
+    // Validate against the same parser the flag/env use, but keep the human-chosen spelling
+    // ("200k" vs "200000") — resolveCompactAt re-parses it at launch time anyway.
+    parseCompactAt(v, "compact_at");
+    return v;
+}
 function coerceMemberIds(raw) {
     const ids = raw
         .split(/[\s,]+/)
@@ -213,6 +221,14 @@ export const CONFIG_KEYS = [
             c.contextProfile = parseContextProfile(v, "context_profile");
         },
     },
+    {
+        key: "compact_at",
+        describe: "Gateway compaction target: a token count (k/m suffix OK), '1m' or 'off' for none (default: none — Claude Code's own 1M window)",
+        get: (c) => c.compactAt,
+        set: (c, v) => {
+            c.compactAt = coerceCompactAt(v);
+        },
+    },
     {
         key: "guardrails.max_turns",
         describe: "Contract guardrail: turn ceiling (positive integer)",
@@ -297,6 +313,8 @@ export function parseLauncherConfig(text) {
         cfg.compactionIntercept = coerceBool("compaction_intercept", str(raw.compaction_intercept) ?? "");
     if (raw.context_profile !== undefined)
         cfg.contextProfile = parseContextProfile(str(raw.context_profile) ?? "", "context_profile");
+    if (raw.compact_at !== undefined)
+        cfg.compactAt = coerceCompactAt(str(raw.compact_at) ?? "");
     const g = raw.guardrails;
     if (g !== undefined) {
         if (typeof g !== "object" || g === null || Array.isArray(g)) {
@@ -371,6 +389,8 @@ export function serializeLauncherConfig(cfg) {
         doc.compaction_intercept = cfg.compactionIntercept;
     if (cfg.contextProfile !== undefined)
         doc.context_profile = cfg.contextProfile;
+    if (cfg.compactAt !== undefined)
+        doc.compact_at = cfg.compactAt;
     const g = cfg.guardrails;
     if (g && (g.maxTurns !== undefined || g.budgetUsd !== undefined || g.stallTurns !== undefined)) {
         const gr = {};
@@ -433,6 +453,9 @@ export function applyConfigToEnv(cfg, env = process.env) {
     if (cfg.contextProfile !== undefined && !(env.MNEMOM_AGENT_CONTEXT_PROFILE ?? "").trim()) {
         env.MNEMOM_AGENT_CONTEXT_PROFILE = cfg.contextProfile;
     }
+    if (cfg.compactAt !== undefined && !(env.MNEMOM_COMPACT_AT ?? "").trim()) {
+        env.MNEMOM_COMPACT_AT = cfg.compactAt;
+    }
 }
 /** The set keys of `cfg` as `[key, value]` pairs (CONFIG_KEYS order, values stringified). */
 export function launcherEntries(cfg) {
@@ -444,7 +467,10 @@ export function launcherEntries(cfg) {
 /**
  * `cfg` without the settings of experimental features that are off (a copy; `cfg` is
  * untouched): `slack_*` while `slack` is off, `context_handoff` while `context-handoff` is
- * off, `compaction_intercept` while `compaction-intercept` is off, and `goal_mode = implicit` while `implicit` is off (`goal_mode = off` is kept).
+ * off, `compaction_intercept` (and an ARMED `compact_at` — it arms the same two gateway keys,
+ * so it needs the same opt-in; `compact_at = "off"`/`"1m"` carries no gated behaviour and is
+ * kept) while `compaction-intercept` is off, and `goal_mode = implicit` while `implicit` is
+ * off (`goal_mode = off` is kept).
  */
 export function withoutDisabledExperimental(cfg, enabled) {
     const out = { ...cfg };
@@ -455,8 +481,11 @@ export function withoutDisabledExperimental(cfg, enabled) {
     }
     if (!enabled.includes("context-handoff"))
         delete out.contextHandoff;
-    if (!enabled.includes("compaction-intercept"))
+    if (!enabled.includes("compaction-intercept")) {
         delete out.compactionIntercept;
+        if (compactAtArmed(out.compactAt))
+            delete out.compactAt;
+    }
     if (!enabled.includes("implicit") && out.goalMode === "implicit")
         delete out.goalMode;
     return out;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.6-next.0",
+  "version": "0.17.6-next.2",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {