@delt/claude-jev-advisor 0.2.0 → 0.4.0

package/dist/statusline.js

@@ -18,6 +18,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 }
 };
@@ -45,6 +46,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)
   };
@@ -73,18 +75,20 @@ import path3 from "path";
 
 // src/display/line.ts
 var STALE_SIZE_RATIO = 0.7;
-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?"
   }
 };
+var COMMANDS = { clear: "/clear", compact: "/compact", compactLater: "/compact" };
+var phrase = (lang, advice) => `${QUESTIONS[lang][advice]} ${COMMANDS[advice]}`;
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -99,20 +103,29 @@ 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 usableJudgment(state, liveSize, turnStartedAt) {
   if (!state || !state.judgment || state.at < turnStartedAt) return null;

package/mod/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "jev-advisor",
-  "version": "0.2.0",
-  "description": "Bottom-row compact/clear advice from @delt/claude-jev-advisor (unofficial)",
+  "version": "0.4.0",
+  "description": "Bottom-row compact/clear advice and an advice button from @delt/claude-jev-advisor (unofficial)",
   "author": { "name": "delt96" },
   "userConfig": {
     "dataDir": {

package/mod/hooks/register.js

@@ -4,6 +4,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 }
 };
@@ -31,6 +32,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)
   };
@@ -38,21 +40,26 @@ function normalizeConfig(raw) {
 
 // src/display/line.ts
 var STALE_SIZE_RATIO = 0.7;
-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?"
   }
 };
+var COMMANDS = { clear: "/clear", compact: "/compact", compactLater: "/compact" };
+var phrase = (lang, advice) => `${QUESTIONS[lang][advice]} ${COMMANDS[advice]}`;
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function adviceQuestion(kind, lang) {
+  return QUESTIONS[lang][kind];
+}
 function formatSize(tokens) {
   return `${Math.round(tokens / 1e3)}k`;
 }
@@ -64,20 +71,42 @@ 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 bandAdvice({ size, threshold, judgment, config }) {
+  if (size === null) return null;
+  const counted = size >= config.context.minTokens ? judgment : null;
+  if (!counted || counted.phase === "working") return null;
+  const red = redRemaining(size, threshold, config);
+  if (red !== null) return { kind: counted.clear ? "clear" : "compact", remainingPct: red };
+  const kind = adviceKind(size, counted, config);
+  return kind ? { kind, remainingPct: null } : null;
+}
+function modTail(input) {
+  if (input.size === null) return "";
+  return bandAdvice(input) ? `${formatSize(input.size)}${increaseSuffix(input.increase)}` : adviceLine(input);
 }
 function usableJudgment(state, liveSize2, turnStartedAt) {
   if (!state || !state.judgment || state.at < turnStartedAt) return null;
@@ -91,6 +120,43 @@ function parseState(raw) {
   return { sessionId: raw.sessionId, at: raw.at, size: typeof raw.size === "number" ? raw.size : null, judgment };
 }
 
+// src/display/shortcut.ts
+var SHORTCUT_ACTION = "diff:back";
+
+// src/mod/band.ts
+var ICONS = { compact: "\u{1F4E6}", clear: "\u{1F9F9}" };
+function drawBand(ui, { advice, config, onPress }) {
+  const { Box, Text, Button } = ui;
+  const head = advice.remainingPct === null ? "\u{1F7E1}" : `\u{1F534} ${advice.remainingPct}%`;
+  const controls = [
+    h(Button, {
+      key: `jev-${advice.kind}`,
+      label: `${ICONS[advice.kind]} /${advice.kind}`,
+      variant: "primary",
+      autoFocus: true,
+      hover: { bold: true },
+      onPress,
+      ...config.shortcut ? { action: SHORTCUT_ACTION } : {}
+    })
+  ];
+  if (config.shortcut) controls.push(h(Text, { dimColor: true }, config.shortcut));
+  return h(
+    Box,
+    { flexDirection: "row", flexWrap: "wrap", columnGap: 2, paddingTop: 1 },
+    h(
+      Box,
+      { flexDirection: "row", gap: 1, minWidth: 0, flexShrink: 1 },
+      h(Box, { flexShrink: 0 }, h(Text, { bold: advice.remainingPct !== null }, head)),
+      h(
+        Box,
+        { minWidth: 0, flexShrink: 1 },
+        h(Text, { wrap: "truncate-end" }, adviceQuestion(advice.kind, config.lang))
+      )
+    ),
+    h(Box, { key: `jev-${advice.kind}-control`, flexDirection: "row", gap: 1, flexShrink: 0 }, ...controls)
+  );
+}
+
 // src/mod/register.ts
 var REFRESH_MS = 2e3;
 async function readJson($, file) {
@@ -130,13 +196,36 @@ async function liveSize($) {
     return null;
   }
 }
+function reason(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  return message.replace(/^[^:]+: \$\.[\w]+(?:\.[\w]+)*: /, "");
+}
+async function press($, kind) {
+  try {
+    $.ui.invalidate("ui.render");
+    if (kind === "compact") {
+      const result = await $.session.compact();
+      if (result?.skip) $.ui.toast("/compact: skipped by a hook");
+    } else {
+      await $.command.run({ command: "clear" });
+    }
+  } catch (err) {
+    try {
+      $.ui.toast(`/${kind}: ${reason(err)}`);
+    } catch {
+    }
+  }
+}
 function register(on, options) {
   const dataDir = typeof options.dataDir === "string" ? options.dataDir.replace(/[\\/]+$/, "") : "";
   let config = null;
   let state = null;
   let threshold = null;
   let turnStartedAt = 0;
+  let baseline = null;
   let seen = "";
+  let handledAt = -Infinity;
+  const judgmentFor = (size) => state && state.at <= handledAt ? null : usableJudgment(state, size, turnStartedAt);
   on("session.start", async ($, e, next) => {
     const result = await next(e);
     if (!dataDir || e.isInteractive === false) return result;
@@ -159,8 +248,10 @@ function register(on, options) {
     return result;
   });
   on("turn.start", async ($, e, next) => {
+    baseline = null;
     try {
       turnStartedAt = await $.clock.now();
+      baseline = await liveSize($);
       $.ui.invalidate("ui.render");
     } catch {
     }
@@ -171,19 +262,50 @@ function register(on, options) {
     threshold = await autoCompactThreshold($);
     return result;
   });
+  on("session.end", async ($, e, next) => {
+    baseline = null;
+    state = null;
+    seen = "";
+    try {
+      $.ui.invalidate("ui.render");
+    } catch {
+    }
+    return next(e);
+  });
   on("ui.render", { component: "PromptHint" }, async ($, e, next) => {
     let tail = "";
     try {
       const current = config;
       if (current && current.context.enabled && current.display === "mod") {
         const size = await liveSize($);
-        tail = adviceLine({ size, threshold, judgment: usableJudgment(state, size, turnStartedAt), config: current });
+        const increase = baseline !== null && size !== null ? size - baseline : null;
+        tail = modTail({ size, threshold, judgment: judgmentFor(size), config: current, increase });
       }
     } catch {
       tail = "";
     }
     return tail ? next({ ...e, props: { ...e.props, tail } }) : next(e);
   });
+  on("ui.render", { component: "AbovePrompt" }, async ($, e, next) => {
+    let band = null;
+    try {
+      const current = config;
+      const props = e.props ?? {};
+      if (current && current.context.enabled && current.display === "mod" && props.isWorking !== true && props.hasSurvey !== true) {
+        const size = await liveSize($);
+        const advice = bandAdvice({ size, threshold, judgment: judgmentFor(size), config: current });
+        const at = state?.at;
+        if (advice && at !== void 0) band = drawBand($.ui.resolve(e), { advice, config: current, onPress: () => {
+          if (at <= handledAt) return;
+          handledAt = at;
+          void press($, advice.kind);
+        } });
+      }
+    } catch {
+      band = null;
+    }
+    return band ?? next(e);
+  });
 }
 export {
   register

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delt/claude-jev-advisor",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Unofficial Claude Code helpers using TypeSafe Jev: compact/clear advice and an rm guard",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "dist",
-    "mod",
+    "mod/.claude-plugin/plugin.json",
+    "mod/hooks",
     "README.md"
   ],
   "engines": {
@@ -17,7 +18,7 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "test": "node --import tsx --import ./test/isolate-home.ts --test --test-timeout=30000 \"test/**/*.test.ts\"",
+    "test": "node --import tsx --import ./test/isolate-home.ts --test --test-timeout=120000 \"test/**/*.test.ts\"",
     "prepack": "npm run build"
   },
   "keywords": [