@delt/claude-jev-advisor 0.3.0 → 0.4.1

package/dist/cli.js

@@ -71,7 +71,7 @@ function terminalPrompt(terminal = PROCESS_TERMINAL) {
 }
 
 // src/cli/run.ts
-import fs9 from "fs";
+import fs10 from "fs";
 import path9 from "path";
 
 // src/config.ts
@@ -84,6 +84,7 @@ var DEFAULT_CONFIG = {
   lang: "ko",
   keyFile: null,
   display: "mod",
+  shortcut: null,
   context: { enabled: true, minTokens: 25e4, compactMinTokens: 25e4, redRemainingPct: 20, unitDoneYes: 0.6, phaseDoneYes: 0.6 },
   rm: { enabled: true, jev: true, throwawayYes: 0.8, maxDirFiles: 50 }
 };
@@ -111,6 +112,7 @@ function normalizeConfig(raw) {
     lang: typeof r.lang === "string" && LANGS.includes(r.lang) ? r.lang : DEFAULT_CONFIG.lang,
     keyFile: typeof r.keyFile === "string" && r.keyFile !== "" ? r.keyFile : null,
     display: typeof r.display === "string" && DISPLAYS.includes(r.display) ? r.display : DEFAULT_CONFIG.display,
+    shortcut: typeof r.shortcut === "string" && r.shortcut !== "" ? r.shortcut : null,
     context: mergeSection(DEFAULT_CONFIG.context, r.version === CONFIG_VERSION ? r.context : withoutLegacyDefaults(r.context)),
     rm: mergeSection(DEFAULT_CONFIG.rm, r.rm)
   };
@@ -135,6 +137,7 @@ var claudeDir = (home) => path.join(home, ".claude");
 var dataDir = (home) => path.join(claudeDir(home), "claude-jev-advisor");
 var configPath = (home) => path.join(dataDir(home), "config.json");
 var settingsPath = (home) => path.join(claudeDir(home), "settings.json");
+var keybindingsPath = (home) => path.join(claudeDir(home), "keybindings.json");
 var backupsDir = (home) => path.join(claudeDir(home), "backups");
 var stateDir = (home) => path.join(dataDir(home), "state");
 var logDir = (home) => path.join(dataDir(home), "log");
@@ -161,6 +164,11 @@ function updateConfig(home, change) {
   return next;
 }
 
+// src/display/shortcut.ts
+var SHORTCUT_CHORD = "ctrl+x ctrl+f";
+var SHORTCUT_ACTION = "diff:back";
+var SHORTCUT_CONTEXT = "DiffDialog";
+
 // src/features.ts
 var FEATURES = ["rm", "context"];
 var HOOK_SPECS = {
@@ -189,9 +197,187 @@ function isFeature(value) {
 // src/install.ts
 import path5 from "path";
 
-// src/display/settings.ts
+// src/display/keybindings.ts
+import fs3 from "fs";
+
+// src/settings-file.ts
 import fs2 from "fs";
 import path3 from "path";
+function readSettingsFile(file) {
+  let text;
+  try {
+    text = fs2.readFileSync(file, "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") return {};
+    throw err;
+  }
+  const parsed = JSON.parse(text.replace(/^\uFEFF/, ""));
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error(`${file} does not hold a JSON object`);
+  return parsed;
+}
+function backupName(now, fileName = "settings.json") {
+  const two = (n) => String(n).padStart(2, "0");
+  const stamp = `${now.getFullYear()}-${two(now.getMonth() + 1)}-${two(now.getDate())}-${two(now.getHours())}${two(now.getMinutes())}${two(now.getSeconds())}`;
+  return `${fileName}.${stamp}-before-claude-jev-advisor`;
+}
+function backupSettingsFile(file, dir, now) {
+  if (!fs2.existsSync(file)) return null;
+  fs2.mkdirSync(dir, { recursive: true });
+  const baseName = backupName(now, path3.basename(file));
+  let target = path3.join(dir, baseName);
+  let suffix = 2;
+  while (true) {
+    try {
+      fs2.copyFileSync(file, target, fs2.constants.COPYFILE_EXCL);
+      return target;
+    } catch (err) {
+      if (err.code === "EEXIST") {
+        target = path3.join(dir, `${baseName}-${suffix}`);
+        suffix++;
+      } else {
+        throw err;
+      }
+    }
+  }
+}
+function writeSettingsFile(file, settings) {
+  fs2.mkdirSync(path3.dirname(file), { recursive: true });
+  const temp = `${file}.claude-jev-advisor.tmp`;
+  fs2.writeFileSync(temp, `${JSON.stringify(settings, null, 2)}
+`);
+  try {
+    fs2.renameSync(temp, file);
+  } catch (err) {
+    try {
+      fs2.unlinkSync(temp);
+    } catch {
+    }
+    throw err;
+  }
+}
+
+// src/display/keybindings.ts
+var KEYBINDINGS_SCHEMA = "https://www.schemastore.org/claude-code-keybindings.json";
+var KEYBINDINGS_DOCS = "https://code.claude.com/docs/en/keybindings";
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isBlock(value) {
+  return isRecord2(value) && typeof value.context === "string" && isRecord2(value.bindings);
+}
+function normalizeChord(chord) {
+  return chord.trim().toLowerCase().split(/\s+/).map((stroke) => stroke.split("+").map((key) => key === "control" ? "ctrl" : key).join("+")).join(" ");
+}
+function chordKeys(block) {
+  const target = normalizeChord(SHORTCUT_CHORD);
+  return Object.keys(block.bindings).filter((key) => normalizeChord(key) === target);
+}
+function isOurs(block, key) {
+  return block.context === SHORTCUT_CONTEXT && block.bindings[key] === SHORTCUT_ACTION;
+}
+function parseKeybindings(raw) {
+  return isRecord2(raw) && Array.isArray(raw.bindings) ? raw : null;
+}
+function newKeybindings() {
+  return { $schema: KEYBINDINGS_SCHEMA, $docs: KEYBINDINGS_DOCS, bindings: [] };
+}
+function hasShortcut(kb) {
+  return kb.bindings.some((b) => isBlock(b) && chordKeys(b).some((key) => isOurs(b, key)));
+}
+function shortcutTakenBy(kb) {
+  for (const b of kb.bindings) {
+    if (!isBlock(b)) continue;
+    for (const key of chordKeys(b)) {
+      if (!isOurs(b, key)) return `${b.context}: ${String(b.bindings[key])}`;
+    }
+  }
+  return null;
+}
+function withShortcut(kb) {
+  if (hasShortcut(kb)) return kb;
+  const bindings = [...kb.bindings];
+  const at = bindings.findIndex((b) => isBlock(b) && b.context === SHORTCUT_CONTEXT);
+  if (at === -1) {
+    bindings.push({ context: SHORTCUT_CONTEXT, bindings: { [SHORTCUT_CHORD]: SHORTCUT_ACTION } });
+  } else {
+    const block = bindings[at];
+    bindings[at] = { ...block, bindings: { ...block.bindings, [SHORTCUT_CHORD]: SHORTCUT_ACTION } };
+  }
+  return { ...kb, bindings };
+}
+function withoutShortcut(kb) {
+  if (!hasShortcut(kb)) return kb;
+  const bindings = [];
+  for (const b of kb.bindings) {
+    if (!isBlock(b)) {
+      bindings.push(b);
+      continue;
+    }
+    const keys = chordKeys(b).filter((key) => isOurs(b, key));
+    if (!keys.length) {
+      bindings.push(b);
+      continue;
+    }
+    const rest = { ...b.bindings };
+    for (const key of keys) delete rest[key];
+    if (Object.keys(rest).length) bindings.push({ ...b, bindings: rest });
+  }
+  return { ...kb, bindings };
+}
+function readKeybindings(file) {
+  if (!fs3.existsSync(file)) return "missing";
+  return parseKeybindings(readSettingsFile(file));
+}
+function installShortcut(home, now) {
+  const none = (takenBy, problem) => ({ shortcut: null, takenBy, problem, backup: null });
+  const file = keybindingsPath(home);
+  try {
+    const read = readKeybindings(file);
+    if (read === null) return none(null, 'it holds no "bindings" list');
+    const kb = read === "missing" ? newKeybindings() : read;
+    const takenBy = shortcutTakenBy(kb);
+    if (takenBy) return none(takenBy, null);
+    if (hasShortcut(kb)) return { shortcut: SHORTCUT_CHORD, takenBy: null, problem: null, backup: null };
+    const backup = backupSettingsFile(file, backupsDir(home), now);
+    writeSettingsFile(file, withShortcut(kb));
+    return { shortcut: SHORTCUT_CHORD, takenBy: null, problem: null, backup };
+  } catch (err) {
+    return none(null, err.message);
+  }
+}
+function removeShortcut(home, now) {
+  const file = keybindingsPath(home);
+  try {
+    const read = readKeybindings(file);
+    if (read === "missing" || read === null || !hasShortcut(read)) return { removed: false, backup: null };
+    const backup = backupSettingsFile(file, backupsDir(home), now);
+    writeSettingsFile(file, withoutShortcut(read));
+    return { removed: true, backup };
+  } catch {
+    return { removed: false, backup: null };
+  }
+}
+function shortcutTakenInFile(home) {
+  try {
+    const read = readKeybindings(keybindingsPath(home));
+    return read === null || read === "missing" ? null : shortcutTakenBy(read);
+  } catch {
+    return null;
+  }
+}
+function shortcutState(home) {
+  try {
+    const read = readKeybindings(keybindingsPath(home));
+    if (read === null) return "unreadable";
+    return read !== "missing" && hasShortcut(read) ? "present" : "absent";
+  } catch {
+    return "unreadable";
+  }
+}
+
+// src/display/settings.ts
+import fs4 from "fs";
+import path4 from "path";
 
 // src/settings.ts
 var forwardSlashes = (text) => text.replace(/\\/g, "/");
@@ -212,19 +398,19 @@ function withHook(settings, entry) {
 }
 function withoutCommands(settings, pattern) {
   if (!settings.hooks) return settings;
-  const isOurs = (h) => typeof h.command === "string" && commandMatches(h.command, pattern);
+  const isOurs2 = (h) => typeof h.command === "string" && commandMatches(h.command, pattern);
   const hooks = {};
   let removedAny = false;
   for (const [event, groups] of Object.entries(settings.hooks)) {
     const kept = [];
     let emptiedByUs = false;
     for (const group of groups) {
-      if (!Array.isArray(group.hooks) || !group.hooks.some(isOurs)) {
+      if (!Array.isArray(group.hooks) || !group.hooks.some(isOurs2)) {
         kept.push(group);
         continue;
       }
       removedAny = true;
-      const remaining = group.hooks.filter((h) => !isOurs(h));
+      const remaining = group.hooks.filter((h) => !isOurs2(h));
       if (remaining.length) kept.push({ ...group, hooks: remaining });
       else emptiedByUs = true;
     }
@@ -253,7 +439,7 @@ function findCommands(settings, pattern) {
 // src/display/settings.ts
 var PLUGIN_DIRS_ENV = "CLAUDE_CODE_PLUGIN_DIRS";
 var STATUSLINE_REFRESH_SECONDS = 3;
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var forwardSlashes2 = (text) => text.replace(/\\/g, "/");
@@ -263,7 +449,7 @@ function withoutKey(settings, key) {
 }
 function withoutModDisplay(settings, delimiter) {
   let next = settings;
-  const env = isRecord2(settings.env) ? settings.env : null;
+  const env = isRecord3(settings.env) ? settings.env : null;
   const dirs = env?.[PLUGIN_DIRS_ENV];
   if (env && typeof dirs === "string") {
     const all = dirs.split(delimiter);
@@ -274,7 +460,7 @@ function withoutModDisplay(settings, delimiter) {
       next = Object.keys(nextEnv).length ? { ...next, env: nextEnv } : withoutKey(next, "env");
     }
   }
-  const configs = isRecord2(next.pluginConfigs) ? next.pluginConfigs : null;
+  const configs = isRecord3(next.pluginConfigs) ? next.pluginConfigs : null;
   if (configs && MOD_PLUGIN_NAME in configs) {
     const { [MOD_PLUGIN_NAME]: _ours, ...others } = configs;
     next = Object.keys(others).length ? { ...next, pluginConfigs: others } : withoutKey(next, "pluginConfigs");
@@ -283,9 +469,9 @@ function withoutModDisplay(settings, delimiter) {
 }
 function withModDisplay(settings, modDir, dataDirPath, delimiter) {
   const base = withoutModDisplay(settings, delimiter);
-  const env = isRecord2(base.env) ? base.env : {};
+  const env = isRecord3(base.env) ? base.env : {};
   const dirs = typeof env[PLUGIN_DIRS_ENV] === "string" ? env[PLUGIN_DIRS_ENV].split(delimiter).filter(Boolean) : [];
-  const configs = isRecord2(base.pluginConfigs) ? base.pluginConfigs : {};
+  const configs = isRecord3(base.pluginConfigs) ? base.pluginConfigs : {};
   return {
     ...base,
     env: { ...env, [PLUGIN_DIRS_ENV]: [...dirs, forwardSlashes2(modDir)].join(delimiter) },
@@ -293,12 +479,12 @@ function withModDisplay(settings, modDir, dataDirPath, delimiter) {
   };
 }
 function isOurStatusLine(value) {
-  return isRecord2(value) && typeof value.command === "string" && commandMatches(value.command, ownScriptPattern(STATUSLINE_SCRIPT));
+  return isRecord3(value) && typeof value.command === "string" && commandMatches(value.command, ownScriptPattern(STATUSLINE_SCRIPT));
 }
 function readStatusLineBefore(home) {
   try {
-    const value = JSON.parse(fs2.readFileSync(statusLineBeforePath(home), "utf8"));
-    return isRecord2(value) ? value : null;
+    const value = JSON.parse(fs4.readFileSync(statusLineBeforePath(home), "utf8"));
+    return isRecord3(value) ? value : null;
   } catch {
     return null;
   }
@@ -306,17 +492,17 @@ function readStatusLineBefore(home) {
 function writeStatusLineBefore(home, value) {
   const file = statusLineBeforePath(home);
   if (!value) {
-    fs2.rmSync(file, { force: true });
+    fs4.rmSync(file, { force: true });
     return;
   }
-  fs2.mkdirSync(path3.dirname(file), { recursive: true });
-  fs2.writeFileSync(file, `${JSON.stringify(value, null, 2)}
+  fs4.mkdirSync(path4.dirname(file), { recursive: true });
+  fs4.writeFileSync(file, `${JSON.stringify(value, null, 2)}
 `);
 }
 function applyStatusLineDisplay(settings, home, command) {
   const current = settings.statusLine;
   const ours = isOurStatusLine(current);
-  const userLine = ours ? readStatusLineBefore(home) : isRecord2(current) ? current : null;
+  const userLine = ours ? readStatusLineBefore(home) : isRecord3(current) ? current : null;
   if (command !== null) {
     writeStatusLineBefore(home, userLine);
     return { ...settings, statusLine: { type: "command", command, refreshInterval: STATUSLINE_REFRESH_SECONDS } };
@@ -328,62 +514,6 @@ function forgetStatusLineBefore(home, settings) {
   if (!isOurStatusLine(settings.statusLine)) writeStatusLineBefore(home, null);
 }
 
-// src/settings-file.ts
-import fs3 from "fs";
-import path4 from "path";
-function readSettingsFile(file) {
-  let text;
-  try {
-    text = fs3.readFileSync(file, "utf8");
-  } catch (err) {
-    if (err.code === "ENOENT") return {};
-    throw err;
-  }
-  const parsed = JSON.parse(text.replace(/^\uFEFF/, ""));
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error(`${file} does not hold a JSON object`);
-  return parsed;
-}
-function backupName(now) {
-  const two = (n) => String(n).padStart(2, "0");
-  const stamp = `${now.getFullYear()}-${two(now.getMonth() + 1)}-${two(now.getDate())}-${two(now.getHours())}${two(now.getMinutes())}${two(now.getSeconds())}`;
-  return `settings.json.${stamp}-before-claude-jev-advisor`;
-}
-function backupSettingsFile(file, dir, now) {
-  if (!fs3.existsSync(file)) return null;
-  fs3.mkdirSync(dir, { recursive: true });
-  const baseName = backupName(now);
-  let target = path4.join(dir, baseName);
-  let suffix = 2;
-  while (true) {
-    try {
-      fs3.copyFileSync(file, target, fs3.constants.COPYFILE_EXCL);
-      return target;
-    } catch (err) {
-      if (err.code === "EEXIST") {
-        target = path4.join(dir, `${baseName}-${suffix}`);
-        suffix++;
-      } else {
-        throw err;
-      }
-    }
-  }
-}
-function writeSettingsFile(file, settings) {
-  fs3.mkdirSync(path4.dirname(file), { recursive: true });
-  const temp = `${file}.claude-jev-advisor.tmp`;
-  fs3.writeFileSync(temp, `${JSON.stringify(settings, null, 2)}
-`);
-  try {
-    fs3.renameSync(temp, file);
-  } catch (err) {
-    try {
-      fs3.unlinkSync(temp);
-    } catch {
-    }
-    throw err;
-  }
-}
-
 // src/install.ts
 function withoutFeature(settings, feature) {
   return HOOK_SPECS[feature].reduce((s, spec) => withoutCommands(s, ownScriptPattern(spec.script)), settings);
@@ -436,15 +566,20 @@ function install(opts) {
   if (display !== null) next = withDisplay(next, { home: opts.home, distDir: opts.distDir, display, delimiter });
   const backup = same(before, next) ? null : save(opts.home, next, opts.now);
   forgetStatusLineBefore(opts.home, next);
+  let shortcut = null;
+  let shortcutRemoved = null;
+  if (display === "mod") shortcut = installShortcut(opts.home, opts.now);
+  else if (display !== null) shortcutRemoved = removeShortcut(opts.home, opts.now);
   updateConfig(opts.home, (c) => ({
     ...c,
     lang: opts.lang ?? c.lang,
     keyFile: opts.keyFile ?? c.keyFile,
     display: opts.display ?? c.display,
+    shortcut: shortcut ? shortcut.shortcut : display !== null ? null : c.shortcut,
     rm: installed.includes("rm") ? { ...c.rm, enabled: true } : c.rm,
     context: installed.includes("context") ? { ...c.context, enabled: true } : c.context
   }));
-  return { settingsFile: file, backup, installed, skipped, replacedLegacyRmGuard, display };
+  return { settingsFile: file, backup, installed, skipped, replacedLegacyRmGuard, display, shortcut, shortcutRemoved };
 }
 function uninstall(opts) {
   const delimiter = opts.delimiter ?? path5.delimiter;
@@ -460,7 +595,12 @@ function uninstall(opts) {
   }
   const backup = removed.length ? save(opts.home, next, opts.now) : null;
   forgetStatusLineBefore(opts.home, next);
-  return { settingsFile: file, backup, removed };
+  let shortcut = null;
+  if (opts.features.includes("context")) {
+    shortcut = removeShortcut(opts.home, opts.now);
+    if (readConfig(opts.home).shortcut !== null) updateConfig(opts.home, (c) => ({ ...c, shortcut: null }));
+  }
+  return { settingsFile: file, backup, removed, shortcut };
 }
 function setEnabled(home, features, enabled) {
   updateConfig(home, (c) => ({
@@ -471,7 +611,7 @@ function setEnabled(home, features, enabled) {
 }
 
 // src/jev.ts
-import fs4 from "fs";
+import fs5 from "fs";
 var JEV_URL = "https://api.typesafe.ai/v1/systemone";
 var JEV_TIMEOUT_MS = 8e3;
 var KEY_PREFIX = "TYPESAFE_API_KEY=";
@@ -481,7 +621,7 @@ function readJevKey(env, keyFile) {
   if (!keyFile) return null;
   let text;
   try {
-    text = fs4.readFileSync(keyFile, "utf8");
+    text = fs5.readFileSync(keyFile, "utf8");
   } catch {
     return null;
   }
@@ -534,7 +674,7 @@ async function callJev(request, opts) {
 }
 
 // src/key.ts
-import fs5 from "fs";
+import fs6 from "fs";
 import path6 from "path";
 var CHECK_REQUEST = {
   state: { text: "hello" },
@@ -548,10 +688,10 @@ async function checkJevKey(key, fetchFn) {
 }
 function saveJevKey(home, key) {
   const file = savedKeyPath(home);
-  fs5.mkdirSync(path6.dirname(file), { recursive: true });
-  fs5.writeFileSync(file, `TYPESAFE_API_KEY=${key}
+  fs6.mkdirSync(path6.dirname(file), { recursive: true });
+  fs6.writeFileSync(file, `TYPESAFE_API_KEY=${key}
 `, { mode: 384 });
-  fs5.chmodSync(file, 384);
+  fs6.chmodSync(file, 384);
   return file;
 }
 async function promptForKey(prompt, check) {
@@ -569,15 +709,15 @@ async function promptForKey(prompt, check) {
 }
 
 // src/report.ts
-import fs7 from "fs";
+import fs8 from "fs";
 import path7 from "path";
 
 // src/context/transcript.ts
-import fs6 from "fs";
+import fs7 from "fs";
 var TAIL_START_BYTES = 1024 * 1024;
 var TAIL_MAX_BYTES = 8 * 1024 * 1024;
 var REQUEST_ORIGINS = /* @__PURE__ */ new Set(["human", "channel", "peer"]);
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseLines(text) {
@@ -586,7 +726,7 @@ function parseLines(text) {
     if (!line.trim()) continue;
     try {
       const value = JSON.parse(line);
-      if (isRecord3(value)) entries.push(value);
+      if (isRecord4(value)) entries.push(value);
     } catch {
     }
   }
@@ -595,29 +735,31 @@ function parseLines(text) {
 function messageText(content) {
   if (typeof content === "string") return content;
   if (!Array.isArray(content)) return "";
-  return content.filter((block) => isRecord3(block) && block.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n");
+  return content.filter((block) => isRecord4(block) && block.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n");
 }
 function isRequest(entry) {
-  return entry.type === "user" && entry.isSidechain !== true && isRecord3(entry.origin) && REQUEST_ORIGINS.has(String(entry.origin.kind));
+  return entry.type === "user" && entry.isSidechain !== true && isRecord4(entry.origin) && REQUEST_ORIGINS.has(String(entry.origin.kind));
 }
 function requestText(entry) {
-  return messageText(isRecord3(entry.message) ? entry.message.content : void 0).trim();
+  return messageText(isRecord4(entry.message) ? entry.message.content : void 0).trim();
 }
 
 // src/display/line.ts
-var PHRASES = {
+var QUESTIONS = {
   ko: {
-    clear: "\uC0C8\uB86D\uAC8C \uC2DC\uC791\uD558\uB294 \uAC74 \uC5B4\uB5A0\uC138\uC694? /clear",
-    compact: "\uC9C0\uAE08\uAE4C\uC9C0 \uC815\uB9AC\uD558\uACE0 \uC774\uC5B4\uAC00\uB294 \uAC74 \uC5B4\uB5A0\uC138\uC694? /compact",
-    compactLater: "\uC791\uC5C5\uC774 \uB05D\uB098\uBA74 \uC815\uB9AC\uD558\uACE0 \uC774\uC5B4\uAC00\uB294 \uAC74 \uC5B4\uB5A0\uC138\uC694? /compact"
+    clear: "\uC0C8\uB86D\uAC8C \uC2DC\uC791\uD558\uB294 \uAC74 \uC5B4\uB5A0\uC138\uC694?",
+    compact: "\uC9C0\uAE08\uAE4C\uC9C0 \uC815\uB9AC\uD558\uACE0 \uC774\uC5B4\uAC00\uB294 \uAC74 \uC5B4\uB5A0\uC138\uC694?",
+    compactLater: "\uC791\uC5C5\uC774 \uB05D\uB098\uBA74 \uC815\uB9AC\uD558\uACE0 \uC774\uC5B4\uAC00\uB294 \uAC74 \uC5B4\uB5A0\uC138\uC694?"
   },
   en: {
-    clear: "Start fresh? /clear",
-    compact: "Wrap up what you have and continue? /compact",
-    compactLater: "When this work is done, wrap up and continue? /compact"
+    clear: "Start fresh?",
+    compact: "Wrap up what you have and continue?",
+    compactLater: "When this work is done, wrap up and continue?"
   }
 };
-function isRecord4(value) {
+var COMMANDS = { clear: "/clear", compact: "/compact", compactLater: "/compact" };
+var phrase = (lang, advice) => `${QUESTIONS[lang][advice]} ${COMMANDS[advice]}`;
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function formatSize(tokens) {
@@ -631,32 +773,41 @@ function adviceKind(size, judgment, config) {
   if (judgment.clear) return "clear";
   return size >= config.context.compactMinTokens ? "compact" : null;
 }
-function adviceLine({ size, threshold, judgment, config }) {
+function increaseSuffix(increase) {
+  if (increase === null || increase === void 0) return "";
+  const k = Math.round(increase / 1e3);
+  return k > 0 ? ` +${k}k` : "";
+}
+function redRemaining(size, threshold, config) {
+  if (threshold === null || threshold <= 0 || size < threshold * (1 - config.context.redRemainingPct / 100)) return null;
+  return remainingPct(size, threshold);
+}
+function adviceLine({ size, threshold, judgment, config, increase }) {
   if (size === null) return "";
-  const k = formatSize(size);
-  const phrases = PHRASES[config.lang];
+  const k = `${formatSize(size)}${increaseSuffix(increase)}`;
   const counted = size >= config.context.minTokens ? judgment : null;
-  if (threshold !== null && threshold > 0 && size >= threshold * (1 - config.context.redRemainingPct / 100)) {
-    const head = `\u{1F534} ${k} ${remainingPct(size, threshold)}%`;
+  const red = redRemaining(size, threshold, config);
+  if (red !== null) {
+    const head = `\u{1F534} ${k} ${red}%`;
     if (!counted) return head;
-    if (counted.phase === "working") return `${head} \xB7 ${phrases.compactLater}`;
-    return `${head} \xB7 ${counted.clear ? phrases.clear : phrases.compact}`;
+    if (counted.phase === "working") return `${head} \xB7 ${phrase(config.lang, "compactLater")}`;
+    return `${head} \xB7 ${phrase(config.lang, counted.clear ? "clear" : "compact")}`;
   }
   if (!counted) return k;
   const kind = adviceKind(size, counted, config);
-  return kind ? `\u{1F7E1} ${k} ${phrases[kind]}` : `\u{1F7E2} ${k}`;
+  return kind ? `\u{1F7E1} ${k} ${phrase(config.lang, kind)}` : `\u{1F7E2} ${k}`;
 }
 function parseState(raw) {
-  if (!isRecord4(raw) || typeof raw.sessionId !== "string" || typeof raw.at !== "number") return null;
+  if (!isRecord5(raw) || typeof raw.sessionId !== "string" || typeof raw.at !== "number") return null;
   const j = raw.judgment;
-  const judgment = isRecord4(j) && (j.phase === "working" || j.phase === "unit_done") && typeof j.clear === "boolean" ? { phase: j.phase, clear: j.clear } : null;
+  const judgment = isRecord5(j) && (j.phase === "working" || j.phase === "unit_done") && typeof j.clear === "boolean" ? { phase: j.phase, clear: j.clear } : null;
   return { sessionId: raw.sessionId, at: raw.at, size: typeof raw.size === "number" ? raw.size : null, judgment };
 }
 
 // src/report.ts
 var FOLLOW_REQUESTS = 3;
 var DAY_MS = 24 * 60 * 60 * 1e3;
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function monthFiles(home, since, now) {
@@ -671,7 +822,7 @@ function readLogRecords(home, since, now) {
   for (const file of monthFiles(home, since, now)) {
     let text;
     try {
-      text = fs7.readFileSync(file, "utf8");
+      text = fs8.readFileSync(file, "utf8");
     } catch {
       continue;
     }
@@ -693,7 +844,7 @@ function outcomeAfter(entries, at, endedByClear) {
     const time = typeof entry.timestamp === "string" ? Date.parse(entry.timestamp) : NaN;
     if (!(time > at)) continue;
     if (entry.type === "system" && entry.subtype === "compact_boundary") {
-      const trigger = isRecord5(entry.compactMetadata) ? entry.compactMetadata.trigger : void 0;
+      const trigger = isRecord6(entry.compactMetadata) ? entry.compactMetadata.trigger : void 0;
       return { kind: trigger === "auto" ? "auto_compact" : "compact" };
     }
     if (isRequest(entry) && requestText(entry)) {
@@ -712,7 +863,7 @@ function adviceRows(home, now, days) {
     if (typeof file !== "string") return null;
     if (!transcripts.has(file)) {
       try {
-        transcripts.set(file, parseLines(fs7.readFileSync(file, "utf8")));
+        transcripts.set(file, parseLines(fs8.readFileSync(file, "utf8")));
       } catch {
         transcripts.set(file, null);
       }
@@ -726,8 +877,8 @@ function adviceRows(home, now, days) {
     if (!advice) continue;
     const at = new Date(record.at);
     const entries = entriesOf(record.transcriptPath);
-    const jev = isRecord5(record.jev) ? record.jev : {};
-    const state = isRecord5(jev.state) ? jev.state : {};
+    const jev = isRecord6(record.jev) ? record.jev : {};
+    const state = isRecord6(jev.state) ? jev.state : {};
     const requests = Array.isArray(state.recent_requests) ? state.recent_requests : [];
     const last = requests[requests.length - 1];
     rows.push({
@@ -735,7 +886,7 @@ function adviceRows(home, now, days) {
       sessionId: record.sessionId,
       size: record.size,
       advice,
-      answers: isRecord5(jev.answers) ? jev.answers : null,
+      answers: isRecord6(jev.answers) ? jev.answers : null,
       request: typeof last === "string" ? last : "",
       outcome: entries ? outcomeAfter(entries, at.getTime(), cleared.has(record.sessionId)) : { kind: "unknown" }
     });
@@ -769,7 +920,7 @@ function rmLines(home, now, days) {
   const passed = records.filter((r) => r.decision === "pass");
   const lines = [`rm deletions Jev let through: ${passed.length} (asked anyway after a Jev check: ${records.length - passed.length})`];
   for (const record of passed) {
-    const targets = Array.isArray(record.targets) ? record.targets.filter(isRecord5) : [];
+    const targets = Array.isArray(record.targets) ? record.targets.filter(isRecord6) : [];
     const listed = targets.map((t) => `${String(t.shown)} (${typeof t.p === "number" ? t.p.toFixed(2) : "?"})`).join(", ");
     lines.push(`  ${localTime(new Date(record.at))}  ${String(record.sessionId ?? "").slice(0, 8)}  ${listed}`);
   }
@@ -794,34 +945,43 @@ function reportLines(home, now, days) {
 }
 
 // src/status.ts
-import fs8 from "fs";
+import fs9 from "fs";
 import path8 from "path";
 var SCRIPT_IN_COMMAND = /^node "([^"]+)"/;
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function displaySetUp(settings, config) {
   if (config.display === "message") return true;
   if (config.display === "statusline") return isOurStatusLine(settings.statusLine);
-  const env = isRecord6(settings.env) ? settings.env : {};
+  const env = isRecord7(settings.env) ? settings.env : {};
   const dirs = typeof env[PLUGIN_DIRS_ENV] === "string" ? env[PLUGIN_DIRS_ENV] : "";
   const hasDir = dirs.split(path8.delimiter).some((dir) => MOD_DIR_PATTERN.test(dir.replace(/\\/g, "/")));
-  return hasDir && isRecord6(settings.pluginConfigs) && MOD_PLUGIN_NAME in settings.pluginConfigs;
+  return hasDir && isRecord7(settings.pluginConfigs) && MOD_PLUGIN_NAME in settings.pluginConfigs;
 }
 function newestState(home) {
   let newest = null;
   try {
-    for (const name of fs8.readdirSync(stateDir(home))) {
+    for (const name of fs9.readdirSync(stateDir(home))) {
       if (!name.endsWith(".json")) continue;
       const file = path8.join(stateDir(home), name);
-      const mtime = fs8.statSync(file).mtimeMs;
+      const mtime = fs9.statSync(file).mtimeMs;
       if (!newest || mtime > newest.mtime) newest = { file, mtime };
     }
-    return newest ? parseState(JSON.parse(fs8.readFileSync(newest.file, "utf8"))) : null;
+    return newest ? parseState(JSON.parse(fs9.readFileSync(newest.file, "utf8"))) : null;
   } catch {
     return null;
   }
 }
+function shortcutLine(home, config) {
+  const takenBy = shortcutTakenInFile(home);
+  if (!config.shortcut) return takenBy ? `  shortcut: none - ${SHORTCUT_CHORD} is already bound (${takenBy}); press the button with a click, or ctrl+x tab then Enter` : `  shortcut: none - run "claude-jev-advisor install context" to bind ${SHORTCUT_CHORD}`;
+  if (takenBy) return `  shortcut: ${config.shortcut} (also bound by ${takenBy}, which wins - run "claude-jev-advisor install context")`;
+  const state = shortcutState(home);
+  if (state === "present") return `  shortcut: ${config.shortcut}`;
+  const why = state === "unreadable" ? "keybindings.json cannot be read" : "missing from keybindings.json";
+  return `  shortcut: ${config.shortcut} (${why} - run "claude-jev-advisor install context")`;
+}
 function contextLines(home, settings, config, env) {
   const c = config.context;
   const lines = [
@@ -830,6 +990,7 @@ function contextLines(home, settings, config, env) {
     `  thresholds: judge from ${formatSize(c.minTokens)}, /compact from ${formatSize(c.compactMinTokens)}, red at ${c.redRemainingPct}% left`,
     `  Jev: work done from ${c.unitDoneYes}, stage done (/clear) from ${c.phaseDoneYes}`
   ];
+  if (config.display === "mod") lines.splice(1, 0, shortcutLine(home, config));
   const last = newestState(home);
   if (last) {
     const line = adviceLine({ size: last.size, threshold: null, judgment: last.judgment, config }) || "(no size)";
@@ -869,7 +1030,7 @@ function statusLines(home, env = process.env) {
     lines.push(`${feature}: installed, ${state}`);
     for (const c of commands) {
       const script = SCRIPT_IN_COMMAND.exec(c.command)?.[1];
-      if (script && !fs8.existsSync(script)) {
+      if (script && !fs9.existsSync(script)) {
         lines.push(`  broken: ${c.event} hook points to a missing file (${script}) - run "claude-jev-advisor install ${feature}" again, or "claude-jev-advisor uninstall ${feature}"`);
       }
     }
@@ -968,6 +1129,11 @@ async function ensureKey(io, keyFileGiven) {
   }
   await askAndSaveKey(io, io.prompt);
 }
+function shortcutLine2(s) {
+  if (s.shortcut) return `shortcut: ${s.shortcut} presses the advice button above the prompt (~/.claude/keybindings.json)`;
+  const why = s.takenBy ? `${SHORTCUT_CHORD} is already bound (${s.takenBy})` : `keybindings.json: ${s.problem}`;
+  return `shortcut: none - ${why}; press the button with a click, or ctrl+x tab then Enter`;
+}
 async function runCli(argv, io) {
   const parsed = parse(argv);
   const problem = typeof parsed === "string" ? parsed : checkOptions(parsed.command, parsed.options);
@@ -995,9 +1161,15 @@ async function runCli(argv, io) {
         if (r.replacedLegacyRmGuard) io.out("replaced the legacy rm-guard hook (its files under ~/.claude/hooks/rm-guard were left in place)");
         if (r.display) io.out(`display: ${r.display}`);
         if (r.backup) io.out(`backup: ${r.backup}`);
+        if (r.shortcut) io.out(shortcutLine2(r.shortcut));
+        if (r.shortcut?.backup) io.out(`backup: ${r.shortcut.backup}`);
+        if (r.shortcutRemoved?.removed) {
+          io.out(`removed the ${SHORTCUT_CHORD} shortcut from keybindings.json`);
+          if (r.shortcutRemoved.backup) io.out(`backup: ${r.shortcutRemoved.backup}`);
+        }
         if (r.installed.length) {
           io.out(
-            r.display === "mod" ? "Hooks apply right away, also in open Claude Code sessions; the bottom-row display starts with the next new session." : "Hooks apply right away, also in open Claude Code sessions."
+            r.display === "mod" ? "Hooks apply right away, also in open Claude Code sessions. The bottom-row display and the advice button start with the next new session; sessions that already show the bottom-row display pick up an upgrade by themselves." : "Hooks apply right away, also in open Claude Code sessions."
           );
         }
         if (r.installed.includes("context")) await ensureKey(io, options["key-file"] !== void 0);
@@ -1008,7 +1180,9 @@ async function runCli(argv, io) {
         if (!r.removed.length) io.out("nothing to remove");
         for (const f of r.removed) io.out(`removed ${f}`);
         if (r.backup) io.out(`backup: ${r.backup}`);
-        if (r.removed.includes("context") && fs9.existsSync(savedKeyPath(io.home))) io.out(`kept your saved TypeSafe key at ${savedKeyPath(io.home)}`);
+        if (r.shortcut?.removed) io.out(`removed the ${SHORTCUT_CHORD} shortcut from keybindings.json`);
+        if (r.shortcut?.backup) io.out(`backup: ${r.shortcut.backup}`);
+        if (r.removed.includes("context") && fs10.existsSync(savedKeyPath(io.home))) io.out(`kept your saved TypeSafe key at ${savedKeyPath(io.home)}`);
         return 0;
       }
       case "key": {