dsh-auto-compaction 0.1.0 → 0.1.2

package/lib/index.js

@@ -26,7 +26,9 @@ import { decideTrigger, shouldAttempt } from "./plan.js";
 const LOG = "[handoff]";
 
 const SETTINGS_DIR = join(homedir(), ".dsh-handoff-compaction");
-const SETTINGS_FILE = join(SETTINGS_DIR, "settings.json");
+// Test harnesses point this at a missing file so the live sidecar cannot leak
+// into a case that expects the configured ratio.
+const SETTINGS_FILE = process.env.DSH_HANDOFF_SETTINGS_FILE ?? join(SETTINGS_DIR, "settings.json");
 const DEFAULT_TEMPLATE_FILE = join(SETTINGS_DIR, "template.md");
 
 /**
@@ -328,6 +330,13 @@ export default class HandoffCompaction extends BasicCompactionEngine {
       : undefined;
     const target = configured ?? latest ?? agentTarget;
     if (target === undefined) throw new Error("no provider/model available for the handoff summary");
+    // Replaying the prefix only reuses the provider cache when the auxiliary
+    // request carries the same routing knobs as the routed one. Strata writes
+    // the reasoning directive into the prefix, so a missing effort breaks the
+    // cache a few thousand tokens in. Only inherit it when the summary target
+    // is the same model that produced the latest request.
+    const sameTarget = latest !== undefined && target.provider === latest.provider && target.model === latest.model;
+    const reasoningEffort = sameTarget ? latest.reasoningEffort : undefined;
 
     const resolved = this.handoff.instruction === undefined
       ? readTemplate(this.handoff.templateFile, this.handoff.autoCreateTemplate)
@@ -349,6 +358,7 @@ export default class HandoffCompaction extends BasicCompactionEngine {
       toolHistory: agent.session.toolHistory(),
       ...(input.tools === undefined ? {} : { tools: [...input.tools] }),
       maxTokens: this.config.maxTokens,
+      ...(reasoningEffort === undefined ? {} : { reasoningEffort }),
       sessionId: agent.session.id,
       purpose: "compaction",
       ...(signal === undefined ? {} : { signal }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-auto-compaction",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -8,7 +8,7 @@
     "./lib/*": "./lib/*",
     "./package.json": "./package.json"
   },
-  "description": "Idle-time handoff compaction for DeepSeek Harness: at a context ratio, write a handoff checkpoint and replace the whole conversation with it.",
+  "description": "A session auto-compaction plugin that is friendly to local models: compaction never makes the local engine re-read history, saving a lot of time; the trigger point and the saved content of the compacted session are user-configurable.",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
@@ -40,5 +40,8 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
   }
 }

package/scripts/preset-scope.mjs

@@ -2,42 +2,141 @@
  * preset-scope.mjs — switch an editable DSH preset between the handoff plugin and
  * DSH's native compaction, reversibly.
  *
- * A preset context can only have ONE provider of `ctx.compaction`, so "native off"
- * means "which row is active". The script replaces a marker-delimited slot in the
- * preset's cordis.patch.yml with either row file, validates the resulting YAML, and
- * keeps a .bak-scope copy. Disabling restores the stock row (`auto: true`), so a
- * preset goes back to DSH native compaction the moment the plugin is switched off.
+ * Two layers must agree for "native off" to be real:
+ *   1. the preset's marker-delimited compaction slot (the row that supplies
+ *      `ctx.compaction` inside the preset group), and
+ *   2. the profile-level root `compaction-basic` node (DSH's default engine,
+ *      which also listens on `agent/pre-step` and can compact before the
+ *      preset's isolated plugin is consulted).
+ *
+ * Layer 1 is replaced wholesale between row-plugin.yml and row-native.yml.
+ * Layer 2 is guarded by a marker comment that sets `auto: false` while the
+ * plugin is enabled and is removed on disable, restoring the stock default.
+ *
+ * Without --preset/--all-local, `enable` reads the plugin settings sidecar:
+ * `scope: "preset"` switches exactly the listed preset ids to the plugin and
+ * resets every other editable preset to native; `scope: "global"` switches all.
+ * `disable` restores native everywhere. The root guard is on only while at
+ * least one preset uses the plugin.
  *
  * Usage:
- *   node scripts/preset-scope.mjs status  [--preset <cordis.patch.yml>] [--all-local]
- *   node scripts/preset-scope.mjs enable  [--preset <cordis.patch.yml>] [--all-local]
- *   node scripts/preset-scope.mjs disable [--preset <cordis.patch.yml>] [--all-local]
+ *   node scripts/preset-scope.mjs status  [--preset <cordis.patch.yml>] [--profile-patch <cordis.patch.yml>] [--all-local] [--skip-profile]
+ *   node scripts/preset-scope.mjs enable  [--preset <cordis.patch.yml>] [--profile-patch <cordis.patch.yml>] [--all-local] [--skip-profile]
+ *   node scripts/preset-scope.mjs disable [--preset <cordis.patch.yml>] [--profile-patch <cordis.patch.yml>] [--all-local] [--skip-profile]
  * Restart DSH afterwards.
  */
 import fs from "node:fs";
+import { homedir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { createRequire } from "node:module";
 
 const HERE = path.dirname(fileURLToPath(import.meta.url));
-const DEFAULT_PRESET = "C:/Users/Me/.dsh-local-pkgs/dsh-preset-lightweight-local/cordis.patch.yml";
-const LOCAL_PKGS = "C:/Users/Me/.dsh-local-pkgs";
+const APP_DATA = process.env.APPDATA ?? path.join(homedir(), "AppData", "Roaming");
+const DEFAULT_PROFILE_PATCH = process.env.DSH_PROFILE_PATCH
+  ?? path.join(APP_DATA, "dsh-desktop", "harness", "profiles", "web", "cordis.patch.yml");
+const DEFAULT_SETTINGS = path.join(homedir(), ".dsh-handoff-compaction", "settings.json");
+const LOCAL_PKGS = process.env.DSH_LOCAL_PKGS ?? path.join(homedir(), ".dsh-local-pkgs");
+const SETTINGS_FILE = process.env.DSH_HANDOFF_SETTINGS_FILE ?? DEFAULT_SETTINGS;
 const SLOT_BEGIN = "# >>> handoff:slot:begin";
 const SLOT_END = "# <<< handoff:slot:end";
+const GUARD_BEGIN = "# >>> handoff:native-guard:begin";
+const GUARD_END = "# <<< handoff:native-guard:end";
 const ROW_INDENT = 14;
 
 const argv = process.argv.slice(2);
 const mode = (argv.find((a) => !a.startsWith("--")) ?? "status").toLowerCase();
 const presetArg = argv.indexOf("--preset");
+const profileArg = argv.indexOf("--profile-patch");
 const allLocal = argv.includes("--all-local");
+const skipProfile = argv.includes("--skip-profile");
+const profilePatch = profileArg >= 0
+  ? argv[profileArg + 1]
+  : (process.env.DSH_PROFILE_PATCH ?? DEFAULT_PROFILE_PATCH);
+
+function readSettings() {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function presetIdOf(text) {
+  const yaml = loadYaml();
+  if (yaml === undefined) return undefined;
+  try {
+    const doc = yaml.load(text, { schema: yamlSchema(yaml) });
+    return doc?.[0]?.insert?.[0]?.config?.id;
+  } catch {
+    return undefined;
+  }
+}
+
+/** Every editable local preset that carries the handoff slot markers. */
+function discoverPresetFiles() {
+  if (!fs.existsSync(LOCAL_PKGS)) return [];
+  return fs.readdirSync(LOCAL_PKGS)
+    .map((name) => path.join(LOCAL_PKGS, name, "cordis.patch.yml"))
+    .filter((file) => fs.existsSync(file) && fs.readFileSync(file, "utf8").includes(SLOT_BEGIN));
+}
 
-function targets() {
-  if (allLocal) {
-    return fs.readdirSync(LOCAL_PKGS)
-      .map((name) => path.join(LOCAL_PKGS, name, "cordis.patch.yml"))
-      .filter((file) => fs.existsSync(file) && fs.readFileSync(file, "utf8").includes(SLOT_BEGIN));
+function defaultPresetFile() {
+  return discoverPresetFiles()[0]
+    ?? path.join(LOCAL_PKGS, "dsh-preset-lightweight-local", "cordis.patch.yml");
+}
+
+/**
+ * Rows to apply. `enable: true` means the plugin takes this preset; `false`
+ * restores its own native row. Non-selected presets are reset to native so a
+ * previous switch cannot leak into a preset the user did not select.
+ */
+function selection(action) {
+  if (presetArg >= 0) {
+    return [{ file: argv[presetArg + 1], enable: action === "enable" }];
+  }
+  const files = discoverPresetFiles();
+  if (action === "disable") return files.map((file) => ({ file, enable: false }));
+  if (allLocal) return files.map((file) => ({ file, enable: true }));
+  const settings = readSettings();
+  if (settings?.scope === "global") return files.map((file) => ({ file, enable: true }));
+  if (settings?.scope === "preset") {
+    const selected = new Set(Array.isArray(settings.presets) ? settings.presets : []);
+    const planned = files.map((file) => {
+      const id = presetIdOf(fs.readFileSync(file, "utf8"));
+      return { file, id, enable: id !== undefined && selected.has(id) };
+    });
+    for (const id of selected) {
+      if (!planned.some((entry) => entry.id === id)) {
+        console.error(`warn: selected preset "${id}" has no editable handoff slot; left native`);
+      }
+    }
+    return planned;
   }
-  return [presetArg >= 0 ? argv[presetArg + 1] : DEFAULT_PRESET];
+  return [{ file: defaultPresetFile(), enable: action === "enable" }];
+}
+
+function statusPlan() {
+  if (presetArg >= 0) return [{ file: argv[presetArg + 1] }];
+  const settings = readSettings();
+  const files = discoverPresetFiles();
+  if (settings?.scope === "global") return files.map((file) => ({ file, selected: true }));
+  if (settings?.scope === "preset") {
+    const selected = new Set(Array.isArray(settings.presets) ? settings.presets : []);
+    return files.map((file) => ({ file, selected: selected.has(presetIdOf(fs.readFileSync(file, "utf8"))) }));
+  }
+  return [{ file: defaultPresetFile() }];
+}
+
+function pluginRow(presetId) {
+  const text = fs.readFileSync(path.join(HERE, "row-plugin.yml"), "utf8");
+  const trace = path.join(homedir(), ".dsh-handoff-compaction", "trace.log").replace(/\\/g, "/");
+  const withId = (presetId === undefined
+    ? text
+    : text.replace(/^(\s*presetId:\s*).*$/m, `$1${presetId}`))
+    .replace(/^(\s*traceFile:\s*).*$/m, `$1"${trace}"`);
+  return indentRow(withId);
 }
 
 function indentRow(text) {
@@ -47,23 +146,43 @@ function indentRow(text) {
 
 function loadYaml() {
   try {
-    return createRequire("C:/Users/Me/AppData/Roaming/dsh-desktop/harness/profiles/web/")("js-yaml");
+    return createRequire(import.meta.url)("js-yaml");
+  } catch {
+    // The engine's own dependency is preferred; a profile-installed copy is the fallback.
+  }
+  try {
+    const profileRoot = path.join(APP_DATA, "dsh-desktop", "harness", "profiles", "web");
+    return createRequire(path.join(profileRoot, "package.json"))("js-yaml");
   } catch {
     return undefined;
   }
 }
 
-function validate(text) {
+function yamlSchema(yaml) {
+  const jsTag = new yaml.Type("tag:yaml.org,2002:js", { kind: "scalar", construct: (d) => d });
+  return yaml.DEFAULT_SCHEMA.extend([jsTag]);
+}
+
+function validatePreset(text) {
   const yaml = loadYaml();
   if (yaml === undefined) return "skipped (js-yaml unavailable)";
-  const jsTag = new yaml.Type("tag:yaml.org,2002:js", { kind: "scalar", construct: (d) => d });
-  const doc = yaml.load(text, { schema: yaml.DEFAULT_SCHEMA.extend([jsTag]) });
+  const doc = yaml.load(text, { schema: yamlSchema(yaml) });
   const group = doc[0].insert[0].config.plugins.find((entry) => entry.id === "compaction");
   const rows = group.config.filter((entry) => entry.id === "compaction-basic");
   if (rows.length !== 1) throw new Error(`expected exactly one compaction-basic row, found ${rows.length}`);
   return `ok -> ${rows[0].name}`;
 }
 
+function validateProfile(text) {
+  const yaml = loadYaml();
+  if (yaml === undefined) return "skipped (js-yaml unavailable)";
+  const doc = yaml.load(text, { schema: yamlSchema(yaml) });
+  if (!Array.isArray(doc)) throw new Error("profile patch: expected a top-level array");
+  const row = doc.find((entry) => entry?.id === "compaction-basic" && entry?.name === "@deepseek-ai/dsh-compaction-basic");
+  if (row === undefined) throw new Error("profile patch: native compaction-basic entry not found");
+  return `ok -> ${row.name}, auto=${row.config?.auto === undefined ? "default" : String(row.config.auto)}`;
+}
+
 function slotBounds(lines) {
   const begin = lines.findIndex((line) => line.includes(SLOT_BEGIN));
   const end = lines.findIndex((line) => line.includes(SLOT_END));
@@ -81,7 +200,148 @@ function activeName(lines) {
   return "unknown";
 }
 
-for (const file of targets()) {
+/** Locate the top-level native compaction-basic entry that carries a name + config. */
+function nativeBounds(lines) {
+  const starts = [];
+  for (let i = 0; i < lines.length; i += 1) {
+    if (/^-\s+id:\s*compaction-basic\s*$/.test(lines[i])) starts.push(i);
+  }
+  for (let index = 0; index < starts.length; index += 1) {
+    const start = starts[index];
+    const end = index + 1 < starts.length ? starts[index + 1] : lines.length;
+    const block = lines.slice(start, end).join("\n");
+    if (/name:\s*["']?@deepseek-ai\/dsh-compaction-basic["']?/.test(block) && /^\s{2}config:\s*$/m.test(block)) {
+      return { start, end };
+    }
+  }
+  return undefined;
+}
+
+function configLine(lines, bounds) {
+  for (let i = bounds.start + 1; i < bounds.end; i += 1) {
+    if (/^\s{2}config:\s*$/.test(lines[i])) return i;
+  }
+  return -1;
+}
+
+function guardBounds(lines, bounds) {
+  let begin = -1;
+  let end = -1;
+  for (let i = bounds.start; i < bounds.end; i += 1) {
+    if (lines[i].includes(GUARD_BEGIN)) begin = i;
+    if (lines[i].includes(GUARD_END)) end = i;
+  }
+  return begin >= 0 && end > begin ? { begin, end } : undefined;
+}
+
+function autoLine(lines, configIdx, bounds) {
+  for (let i = configIdx + 1; i < bounds.end; i += 1) {
+    if (/^- /.test(lines[i])) break;
+    if (/^\s{2}[A-Za-z]/.test(lines[i])) break;
+    if (/^\s{4}auto:\s*/.test(lines[i])) return i;
+  }
+  return -1;
+}
+
+function guardState(lines, bounds) {
+  const cfg = configLine(lines, bounds);
+  if (cfg < 0) return "no config";
+  const guard = guardBounds(lines, bounds);
+  if (guard !== undefined) {
+    const hasFalse = lines.slice(guard.begin + 1, guard.end).some((line) => /^\s*auto:\s*false\s*$/.test(line));
+    return hasFalse ? "auto:false (plugin guard)" : "guarded (auto missing!)";
+  }
+  const auto = autoLine(lines, cfg, bounds);
+  return auto < 0 ? "absent (default true)" : `auto:${lines[auto].split(":")[1].trim()}`;
+}
+
+function editProfilePatch(file, action) {
+  if (!fs.existsSync(file)) {
+    console.error(`skip (missing profile patch): ${file}`);
+    return;
+  }
+  const original = fs.readFileSync(file, "utf8");
+  const lines = original.split(/\r?\n/);
+  const bounds = nativeBounds(lines);
+  if (bounds === undefined) {
+    console.error(`skip (no native compaction-basic entry): ${file}`);
+    return;
+  }
+  const cfg = configLine(lines, bounds);
+  if (cfg < 0) {
+    console.error(`skip (native entry has no config block): ${file}`);
+    return;
+  }
+  const guard = guardBounds(lines, bounds);
+  let nextLines = [...lines];
+
+  if (action === "enable") {
+    if (guard !== undefined) {
+      const hasAuto = nextLines.slice(guard.begin + 1, guard.end).some((line) => /^\s*auto:\s*/.test(line));
+      nextLines = nextLines.map((line, index) => (index > guard.begin && index < guard.end && /^\s*auto:\s*/.test(line)
+        ? line.replace(/^(\s*)auto:\s*.*$/, "$1auto: false")
+        : line));
+      if (!hasAuto) nextLines.splice(guard.begin + 1, 0, "    auto: false");
+    } else {
+      const auto = autoLine(nextLines, cfg, bounds);
+      if (auto >= 0) {
+        nextLines[auto] = nextLines[auto].replace(/^(\s*)auto:\s*.*$/, "$1auto: false");
+      } else {
+        nextLines.splice(cfg + 1, 0,
+          "    " + GUARD_BEGIN,
+          "    auto: false",
+          "    " + GUARD_END);
+      }
+    }
+  } else {
+    if (guard !== undefined) {
+      nextLines.splice(guard.begin, guard.end - guard.begin + 1);
+    } else {
+      const auto = autoLine(nextLines, cfg, bounds);
+      if (auto >= 0) nextLines[auto] = nextLines[auto].replace(/^(\s*)auto:\s*.*$/, "$1auto: true");
+    }
+  }
+
+  const next = nextLines.join("\n");
+  if (next === original) {
+    console.log(`${file}\n  -> native ${action === "enable" ? "auto:false" : "auto:true"}  [no change]`);
+    return;
+  }
+  const verdict = validateProfile(next);
+  if (!verdict.startsWith("ok")) {
+    console.error(`aborted (validation): ${verdict}`);
+    process.exitCode = 1;
+    return;
+  }
+  fs.copyFileSync(file, `${file}.bak-scope`);
+  fs.writeFileSync(file, next);
+  console.log(`${file}\n  -> native ${action === "enable" ? "auto:false" : "auto:true"}  [${verdict}]`);
+}
+
+function profileStatus() {
+  if (skipProfile) return;
+  if (!fs.existsSync(profilePatch)) {
+    console.log(`${profilePatch}\n  missing`);
+    return;
+  }
+  const original = fs.readFileSync(profilePatch, "utf8");
+  const lines = original.split(/\r?\n/);
+  const bounds = nativeBounds(lines);
+  if (bounds === undefined) {
+    console.log(`${profilePatch}\n  native compaction-basic entry not found`);
+    return;
+  }
+  console.log(`${profilePatch}\n  原生守卫: ${guardState(lines, bounds)}\n  YAML: ${validateProfile(original)}`);
+}
+
+if (mode !== "status" && mode !== "enable" && mode !== "disable") {
+  console.error("usage: preset-scope.mjs <status|enable|disable> [--preset <file>] [--profile-patch <file>] [--all-local] [--skip-profile]");
+  process.exit(2);
+}
+
+const plan = mode === "status" ? statusPlan() : selection(mode);
+for (const entry of plan) {
+  const file = entry.file;
   if (!fs.existsSync(file)) {
     console.error(`skip (missing): ${file}`);
     continue;
@@ -96,27 +356,34 @@ for (const file of targets()) {
 
   if (mode === "status") {
     const current = activeName(lines);
-    const kind = current === "dsh-handoff-compaction" ? "插件接管（原生关闭）"
+    const kind = current === "dsh-handoff-compaction" || current === "dsh-auto-compaction" ? "插件接管（原生关闭）"
       : current === "@deepseek-ai/dsh-compaction-basic" ? "DSH 原生压缩"
       : "未知";
-    console.log(`${file}\n  当前: ${current}\n  含义: ${kind}\n  YAML: ${validate(original)}`);
+    const selected = entry.selected === undefined ? "" : `\n  勾选: ${entry.selected ? "是（插件）" : "否（原生）"}`;
+    console.log(`${file}\n  当前: ${current}\n  含义: ${kind}${selected}\n  YAML: ${validatePreset(original)}`);
     continue;
   }
 
-  if (mode !== "enable" && mode !== "disable") {
-    console.error("usage: preset-scope.mjs <status|enable|disable> [--preset <file>] [--all-local]");
-    process.exit(2);
+  const id = presetIdOf(original);
+  if (entry.enable && id === undefined) {
+    console.error(`skip (cannot read preset id): ${file}`);
+    continue;
   }
-
-  const rowFile = path.join(HERE, mode === "enable" ? "row-plugin.yml" : "row-native.yml");
-  const row = indentRow(fs.readFileSync(rowFile, "utf8"));
+  const row = entry.enable
+    ? pluginRow(id)
+    : indentRow(fs.readFileSync(path.join(HERE, "row-native.yml"), "utf8"));
   const next = [
     ...lines.slice(0, bounds.begin + 1),
     ...row,
     ...lines.slice(bounds.end),
   ].join("\n");
 
-  const verdict = validate(next);
+  if (next === original) {
+    console.log(`${file}\n  -> ${activeName(lines)}  [no change]`);
+    continue;
+  }
+
+  const verdict = validatePreset(next);
   if (!verdict.startsWith("ok")) {
     console.error(`aborted (validation): ${verdict}`);
     process.exit(1);
@@ -126,4 +393,14 @@ for (const file of targets()) {
   console.log(`${file}\n  -> ${activeName(next.split(/\r?\n/))}  [${verdict}]`);
 }
 
-if (mode === "enable" || mode === "disable") console.log("重启 DSH 后生效。");
+if (mode === "status") {
+  profileStatus();
+} else {
+  // The root guard only disables DSH's profile-level duplicate engine. Each
+  // preset's own compaction row stays native unless the plan selected it, so
+  // this is not "native off for every preset".
+  const anyPlugin = plan.some((entry) => entry.enable);
+  if (!skipProfile) editProfilePatch(profilePatch, mode === "enable" && anyPlugin ? "enable" : "disable");
+  if (mode === "enable" && !anyPlugin) console.error("warn: no selected preset uses the plugin; root native fallback left on");
+  console.log("重启 DSH 后生效。");
+}

package/scripts/row-plugin.yml

@@ -7,4 +7,4 @@
     idleDelayMs: 1500
     dryRun: false
     presetId: lightweight-local
-    traceFile: "C:/Users/Me/.dsh-handoff-work/trace.log"
+    traceFile: ""