@delt/claude-jev-advisor 0.1.0

package/mod/hooks/register.js

@@ -0,0 +1,181 @@
+// src/config-shape.ts
+var DEFAULT_CONFIG = {
+  lang: "ko",
+  keyFile: null,
+  display: "mod",
+  context: { enabled: true, minTokens: 1e5, compactMinTokens: 2e5, redRemainingPct: 20, unitDoneYes: 0.7, goalDoneYes: 0.8 },
+  rm: { enabled: true, jev: true, throwawayYes: 0.8, maxDirFiles: 50 }
+};
+var LANGS = ["ko", "en"];
+var DISPLAYS = ["mod", "statusline", "message"];
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function mergeSection(defaults, raw) {
+  const out = { ...defaults };
+  if (!isRecord(raw)) return out;
+  for (const [key, value] of Object.entries(defaults)) {
+    if (typeof raw[key] === typeof value) out[key] = raw[key];
+  }
+  return out;
+}
+function normalizeConfig(raw) {
+  const r = isRecord(raw) ? raw : {};
+  return {
+    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,
+    context: mergeSection(DEFAULT_CONFIG.context, r.context),
+    rm: mergeSection(DEFAULT_CONFIG.rm, r.rm)
+  };
+}
+
+// src/display/line.ts
+var STALE_SIZE_RATIO = 0.7;
+var PHRASES = {
+  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"
+  },
+  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"
+  }
+};
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatSize(tokens) {
+  return `${Math.round(tokens / 1e3)}k`;
+}
+function remainingPct(size, threshold) {
+  return Math.max(0, Math.round((threshold - size) / threshold * 100));
+}
+function adviceLine({ size, threshold, judgment, config }) {
+  if (size === null) return "";
+  const k = formatSize(size);
+  const phrases = PHRASES[config.lang];
+  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)}%`;
+    if (!counted) return head;
+    if (counted.phase === "working") return `${head} \xB7 ${phrases.compactLater}`;
+    return `${head} \xB7 ${counted.clear ? phrases.clear : phrases.compact}`;
+  }
+  if (!counted) return k;
+  if (counted.phase === "working") return `\u{1F7E2} ${k}`;
+  if (counted.clear) return `\u{1F7E1} ${k} ${phrases.clear}`;
+  if (size >= config.context.compactMinTokens) return `\u{1F7E1} ${k} ${phrases.compact}`;
+  return `\u{1F7E2} ${k}`;
+}
+function usableJudgment(state, liveSize2, turnStartedAt) {
+  if (!state || !state.judgment || state.at < turnStartedAt) return null;
+  if (liveSize2 !== null && state.size !== null && liveSize2 < state.size * STALE_SIZE_RATIO) return null;
+  return state.judgment;
+}
+function parseState(raw) {
+  if (!isRecord2(raw) || typeof raw.sessionId !== "string" || typeof raw.at !== "number") return null;
+  const j = raw.judgment;
+  const judgment = isRecord2(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/mod/register.ts
+var REFRESH_MS = 2e3;
+async function readJson($, file) {
+  try {
+    const text = await $.fs.read(file);
+    return typeof text === "string" ? JSON.parse(text.replace(/^\uFEFF/, "")) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function loadConfig($, dataDir) {
+  const raw = await readJson($, `${dataDir}/config.json`);
+  return raw === void 0 ? null : normalizeConfig(raw);
+}
+async function loadState($, dataDir) {
+  try {
+    const sessionId = await $.session.id();
+    const state = parseState(await readJson($, `${dataDir}/state/${sessionId}.json`));
+    return state && state.sessionId === sessionId ? state : null;
+  } catch {
+    return null;
+  }
+}
+async function autoCompactThreshold($) {
+  try {
+    const usage = await $.session.usage({ breakdown: "summary" });
+    return usage.context.breakdown?.autoCompactThreshold ?? null;
+  } catch {
+    return null;
+  }
+}
+async function liveSize($) {
+  try {
+    const tokens = (await $.session.usage()).context.tokens;
+    return typeof tokens === "number" && tokens > 0 ? tokens : null;
+  } catch {
+    return null;
+  }
+}
+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 seen = "";
+  on("session.start", async ($, e, next) => {
+    const result = await next(e);
+    if (!dataDir || e.isInteractive === false) return result;
+    try {
+      config = await loadConfig($, dataDir);
+      threshold = await autoCompactThreshold($);
+      $.clock.every(REFRESH_MS, () => {
+        Promise.all([loadConfig($, dataDir), loadState($, dataDir), liveSize($)]).then(([nextConfig, nextState, size]) => {
+          const key = JSON.stringify([nextConfig, nextState, size === null ? null : Math.round(size / 1e3)]);
+          if (key === seen) return;
+          seen = key;
+          if (nextConfig) config = nextConfig;
+          state = nextState;
+          $.ui.invalidate("ui.render");
+        }).catch(() => {
+        });
+      });
+    } catch {
+    }
+    return result;
+  });
+  on("turn.start", async ($, e, next) => {
+    try {
+      turnStartedAt = await $.clock.now();
+      $.ui.invalidate("ui.render");
+    } catch {
+    }
+    return next(e);
+  });
+  on("turn.complete", async ($, e, next) => {
+    const result = await next(e);
+    threshold = await autoCompactThreshold($);
+    return result;
+  });
+  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 });
+      }
+    } catch {
+      tail = "";
+    }
+    return tail ? next({ ...e, props: { ...e.props, tail } }) : next(e);
+  });
+}
+export {
+  register
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@delt/claude-jev-advisor",
+  "version": "0.1.0",
+  "description": "Unofficial Claude Code helpers using TypeSafe Jev: compact/clear advice and an rm guard",
+  "type": "module",
+  "bin": {
+    "claude-jev-advisor": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "mod",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --import ./test/isolate-home.ts --test --test-timeout=30000 \"test/**/*.test.ts\"",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "hooks",
+    "compact",
+    "context",
+    "typesafe",
+    "jev",
+    "rm"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/delt96/claude-jev-advisor.git"
+  },
+  "bugs": {
+    "url": "https://github.com/delt96/claude-jev-advisor/issues"
+  },
+  "homepage": "https://github.com/delt96/claude-jev-advisor#readme",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "^5.5.0"
+  }
+}