oh-langfuse 0.1.53 → 0.1.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-langfuse",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "private": false,
   "type": "module",
   "description": "Use npm scripts to configure Claude Code / OpenCode / Codex with Langfuse tracing.",

package/scripts/auto-update-runtime.mjs

@@ -1,190 +1,190 @@
-import fs from "node:fs";
-import path from "node:path";
-import readline from "node:readline";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { extractVersionFromNpmMetadata, isNewerVersion } from "./update-utils.mjs";
-import { getRuntimeInstallRecord } from "./runtime-state-utils.mjs";
-
-const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
-const ALLOWED_TARGETS = new Set(["claude", "opencode", "codex"]);
-
-const colorEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
-const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : "");
-const t = {
-  reset: ansi(0),
-  bold: ansi(1),
-  cyan: ansi("96"),
-  green: ansi("92"),
-  gold: ansi("93"),
-};
-
-function paint(text, ...styles) {
-  if (!colorEnabled) return text;
-  return `${styles.join("")}${text}${t.reset}`;
-}
-
-function parseArgs(argv) {
-  const args = { _: [] };
-  for (const raw of argv) {
-    if (!raw.startsWith("--")) {
-      args._.push(raw);
-      continue;
-    }
-    const eq = raw.indexOf("=");
-    if (eq === -1) args[raw.slice(2)] = true;
-    else args[raw.slice(2, eq)] = raw.slice(eq + 1);
-  }
-  return args;
-}
-
-async function latestVersion(registry = "https://registry.npmjs.org") {
-  const base = registry.replace(/\/+$/, "");
-  const response = await fetch(`${base}/oh-langfuse`, { headers: { accept: "application/json" } });
-  if (!response.ok) throw new Error(`npm registry ${response.status} ${response.statusText}`);
-  return extractVersionFromNpmMetadata(await response.json());
-}
-
-function question(text) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(text, (answer) => {
-      rl.close();
-      resolve(String(answer || "").trim());
-    });
-  });
-}
-
-function npxCommand() {
-  return process.platform === "win32" ? "npx.cmd" : "npx";
-}
-
-function runNpx(args, options = {}) {
-  if (process.platform === "win32") {
-    return spawnSync("cmd.exe", ["/d", "/s", "/c", npxCommand(), ...args], {
-      ...options,
-      windowsHide: true,
-    });
-  }
-  return spawnSync(npxCommand(), args, {
-    ...options,
-    windowsHide: true,
-  });
-}
-
-function targetLabel(target) {
-  if (target === "claude") return "Claude";
-  if (target === "codex") return "Codex";
-  if (target === "opencode") return "OpenCode";
-  return target;
-}
-
-function printUpdateAvailable(target, message, updateCommand) {
-  const label = targetLabel(target);
-  console.log(paint(`[UPDATE] \u68c0\u6d4b\u5230 ${label} Langfuse \u53ef\u66f4\u65b0`, t.bold, t.gold));
-  console.log(`[INFO] ${message}`);
-  console.log(`${paint("[CMD]", t.bold, t.cyan)} ${updateCommand}`);
-}
-
-function printUpdateCommand(target, updateCommand) {
-  const label = targetLabel(target);
-  console.log(paint(`[UPDATE] \u6b63\u5728\u6267\u884c\u66f4\u65b0\u547d\u4ee4\uff1a${label} Langfuse`, t.bold, t.cyan));
-  console.log(`${paint("[CMD]", t.bold, t.cyan)} ${updateCommand}`);
-}
-
-function shouldPrintStartupStatus(args, env = process.env) {
-  const raw = String(env.OH_LANGFUSE_AUTO_UPDATE_STATUS || "").trim().toLowerCase();
-  return !!(args["startup-status"] || args.startupStatus || /^(1|true|yes|on)$/i.test(raw));
-}
-
-function printAlreadyCurrent(target, version) {
-  const label = targetLabel(target);
-  console.log(paint(`[OK] ${label} Langfuse \u5df2\u662f\u6700\u65b0\uff1a${packageJson.name}@${version}`, t.bold, t.green));
-}
-
-function runUpdate(target, args) {
-  const updateArgs = ["-y", "oh-langfuse@latest", "update", target];
-  if (args["skip-check"]) updateArgs.push("--skip-check");
-  if (args.npmRegistry) updateArgs.push(`--npmRegistry=${args.npmRegistry}`);
-  if (args.pipIndexUrl) updateArgs.push(`--pipIndexUrl=${args.pipIndexUrl}`);
-  const result = runNpx(updateArgs, {
-    stdio: "inherit",
-    timeout: 900000,
-  });
-  return result.status ?? (result.error ? 1 : 0);
-}
-
-function autoUpdateMode(args, env = process.env) {
-  const raw = String(env.OH_LANGFUSE_AUTO_UPDATE || "").trim().toLowerCase();
-  if (/^(0|false|no|off)$/i.test(raw)) return "off";
-  if (args.yes || args.y || raw === "auto" || raw === "yes" || raw === "1" || raw === "true") return "auto";
-  if (args["notify-only"] || args.notifyOnly || raw === "notify" || raw === "prompt") return "notify";
-  return "ask";
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const mode = autoUpdateMode(args);
-  if (mode === "off") return 0;
-
-  const target = String(args._[0] || "").trim().toLowerCase();
-  if (!ALLOWED_TARGETS.has(target)) {
-    throw new Error("Usage: oh-langfuse auto-update <claude|opencode|codex>");
-  }
-
-  let latest;
-  try {
-    latest = await latestVersion(args.npmRegistry);
-  } catch (error) {
-    if (args.verbose) console.log(`[INFO] oh-langfuse update check skipped: ${error.message}`);
-    return 0;
-  }
-
-  const record = getRuntimeInstallRecord(target);
-  const installedVersion = record?.packageVersion || record?.version || "";
-  const needsUpdate = installedVersion ? isNewerVersion(latest, installedVersion) : isNewerVersion(latest, packageJson.version);
-  if (!needsUpdate) {
-    if (shouldPrintStartupStatus(args)) printAlreadyCurrent(target, installedVersion || packageJson.version);
-    return 0;
-  }
-
-  const message = installedVersion
-    ? `oh-langfuse ${target} runtime update available: ${installedVersion} -> ${latest}.`
-    : `oh-langfuse ${target} runtime may need update. Latest package: ${latest}.`;
-  const updateCommand = `npx oh-langfuse@latest update ${target}`;
-
-  if (mode === "notify") {
-    printUpdateAvailable(target, message, updateCommand);
-    console.log(`[INFO] To update safely, close the agent and run: ${updateCommand}`);
-    return 0;
-  }
-
-  if (mode === "auto") {
-    printUpdateAvailable(target, message, updateCommand);
-    printUpdateCommand(target, updateCommand);
-    const code = runUpdate(target, args);
-    return args.strict ? code : 0;
-  }
-
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    printUpdateAvailable(target, message, updateCommand);
-    return 0;
-  }
-
-  printUpdateAvailable(target, message, updateCommand);
-  const answer = await question(`${paint("[CONFIRM]", t.bold, t.gold)} Update now? (y/N) `);
-  if (!/^(y|yes)$/i.test(answer)) return 0;
-  printUpdateCommand(target, updateCommand);
-  const code = runUpdate(target, args);
-  return args.strict ? code : 0;
-}
-
-main()
-  .then((code) => {
-    process.exitCode = code;
-  })
-  .catch((error) => {
-    console.error(`[WARN] oh-langfuse auto-update skipped: ${error?.message || String(error)}`);
-    process.exitCode = 0;
-  });
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { extractVersionFromNpmMetadata, isNewerVersion } from "./update-utils.mjs";
+import { getRuntimeInstallRecord } from "./runtime-state-utils.mjs";
+
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
+const ALLOWED_TARGETS = new Set(["claude", "opencode", "codex"]);
+
+const colorEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
+const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : "");
+const t = {
+  reset: ansi(0),
+  bold: ansi(1),
+  cyan: ansi("96"),
+  green: ansi("92"),
+  gold: ansi("93"),
+};
+
+function paint(text, ...styles) {
+  if (!colorEnabled) return text;
+  return `${styles.join("")}${text}${t.reset}`;
+}
+
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (const raw of argv) {
+    if (!raw.startsWith("--")) {
+      args._.push(raw);
+      continue;
+    }
+    const eq = raw.indexOf("=");
+    if (eq === -1) args[raw.slice(2)] = true;
+    else args[raw.slice(2, eq)] = raw.slice(eq + 1);
+  }
+  return args;
+}
+
+async function latestVersion(registry = "https://registry.npmjs.org") {
+  const base = registry.replace(/\/+$/, "");
+  const response = await fetch(`${base}/oh-langfuse`, { headers: { accept: "application/json" } });
+  if (!response.ok) throw new Error(`npm registry ${response.status} ${response.statusText}`);
+  return extractVersionFromNpmMetadata(await response.json());
+}
+
+function question(text) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(text, (answer) => {
+      rl.close();
+      resolve(String(answer || "").trim());
+    });
+  });
+}
+
+function npxCommand() {
+  return process.platform === "win32" ? "npx.cmd" : "npx";
+}
+
+function runNpx(args, options = {}) {
+  if (process.platform === "win32") {
+    return spawnSync("cmd.exe", ["/d", "/s", "/c", npxCommand(), ...args], {
+      ...options,
+      windowsHide: true,
+    });
+  }
+  return spawnSync(npxCommand(), args, {
+    ...options,
+    windowsHide: true,
+  });
+}
+
+function targetLabel(target) {
+  if (target === "claude") return "Claude";
+  if (target === "codex") return "Codex";
+  if (target === "opencode") return "OpenCode";
+  return target;
+}
+
+function printUpdateAvailable(target, message, updateCommand) {
+  const label = targetLabel(target);
+  console.log(paint(`[UPDATE] \u68c0\u6d4b\u5230 ${label} Langfuse \u53ef\u66f4\u65b0`, t.bold, t.gold));
+  console.log(`[INFO] ${message}`);
+  console.log(`${paint("[CMD]", t.bold, t.cyan)} ${updateCommand}`);
+}
+
+function printUpdateCommand(target, updateCommand) {
+  const label = targetLabel(target);
+  console.log(paint(`[UPDATE] \u6b63\u5728\u6267\u884c\u66f4\u65b0\u547d\u4ee4\uff1a${label} Langfuse`, t.bold, t.cyan));
+  console.log(`${paint("[CMD]", t.bold, t.cyan)} ${updateCommand}`);
+}
+
+function shouldPrintStartupStatus(args, env = process.env) {
+  const raw = String(env.OH_LANGFUSE_AUTO_UPDATE_STATUS || "").trim().toLowerCase();
+  return !!(args["startup-status"] || args.startupStatus || /^(1|true|yes|on)$/i.test(raw));
+}
+
+function printAlreadyCurrent(target, version) {
+  const label = targetLabel(target);
+  console.log(paint(`[OK] ${label} Langfuse \u5df2\u662f\u6700\u65b0\uff1a${packageJson.name}@${version}`, t.bold, t.green));
+}
+
+function runUpdate(target, args) {
+  const updateArgs = ["-y", "oh-langfuse@latest", "update", target];
+  if (args["skip-check"]) updateArgs.push("--skip-check");
+  if (args.npmRegistry) updateArgs.push(`--npmRegistry=${args.npmRegistry}`);
+  if (args.pipIndexUrl) updateArgs.push(`--pipIndexUrl=${args.pipIndexUrl}`);
+  const result = runNpx(updateArgs, {
+    stdio: "inherit",
+    timeout: 900000,
+  });
+  return result.status ?? (result.error ? 1 : 0);
+}
+
+function autoUpdateMode(args, env = process.env) {
+  const raw = String(env.OH_LANGFUSE_AUTO_UPDATE || "").trim().toLowerCase();
+  if (/^(0|false|no|off)$/i.test(raw)) return "off";
+  if (args.yes || args.y || raw === "auto" || raw === "yes" || raw === "1" || raw === "true") return "auto";
+  if (args["notify-only"] || args.notifyOnly || raw === "notify" || raw === "prompt") return "notify";
+  return "ask";
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const mode = autoUpdateMode(args);
+  if (mode === "off") return 0;
+
+  const target = String(args._[0] || "").trim().toLowerCase();
+  if (!ALLOWED_TARGETS.has(target)) {
+    throw new Error("Usage: oh-langfuse auto-update <claude|opencode|codex>");
+  }
+
+  let latest;
+  try {
+    latest = await latestVersion(args.npmRegistry);
+  } catch (error) {
+    if (args.verbose) console.log(`[INFO] oh-langfuse update check skipped: ${error.message}`);
+    return 0;
+  }
+
+  const record = getRuntimeInstallRecord(target);
+  const installedVersion = record?.packageVersion || record?.version || "";
+  const needsUpdate = installedVersion ? isNewerVersion(latest, installedVersion) : isNewerVersion(latest, packageJson.version);
+  if (!needsUpdate) {
+    if (shouldPrintStartupStatus(args)) printAlreadyCurrent(target, installedVersion || packageJson.version);
+    return 0;
+  }
+
+  const message = installedVersion
+    ? `oh-langfuse ${target} runtime update available: ${installedVersion} -> ${latest}.`
+    : `oh-langfuse ${target} runtime may need update. Latest package: ${latest}.`;
+  const updateCommand = `npx oh-langfuse@latest update ${target}`;
+
+  if (mode === "notify") {
+    printUpdateAvailable(target, message, updateCommand);
+    console.log(`[INFO] To update safely, close the agent and run: ${updateCommand}`);
+    return 0;
+  }
+
+  if (mode === "auto") {
+    printUpdateAvailable(target, message, updateCommand);
+    printUpdateCommand(target, updateCommand);
+    const code = runUpdate(target, args);
+    return args.strict ? code : 0;
+  }
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    printUpdateAvailable(target, message, updateCommand);
+    return 0;
+  }
+
+  printUpdateAvailable(target, message, updateCommand);
+  const answer = await question(`${paint("[CONFIRM]", t.bold, t.gold)} Update now? (y/N) `);
+  if (!/^(y|yes)$/i.test(answer)) return 0;
+  printUpdateCommand(target, updateCommand);
+  const code = runUpdate(target, args);
+  return args.strict ? code : 0;
+}
+
+main()
+  .then((code) => {
+    process.exitCode = code;
+  })
+  .catch((error) => {
+    console.error(`[WARN] oh-langfuse auto-update skipped: ${error?.message || String(error)}`);
+    process.exitCode = 0;
+  });

package/scripts/codex-langfuse-check.mjs

@@ -49,15 +49,15 @@ function venvPython(codexHome) {
     : path.join(codexHome, "langfuse-venv", "bin", "python");
 }
 
-function configHasNotify(configText) {
-  const firstSection = configText.search(/^\s*\[/m);
-  const topLevel = firstSection === -1 ? configText : configText.slice(0, firstSection);
-  return /^\s*notify\s*=.*codex_langfuse_notify\.py/m.test(topLevel);
-}
-
-function addResult(results, item, ok, detail, fix = "", options = {}) {
-  results.push({ item, ok, detail, fix, required: options.required !== false });
-}
+function configHasNotify(configText) {
+  const firstSection = configText.search(/^\s*\[/m);
+  const topLevel = firstSection === -1 ? configText : configText.slice(0, firstSection);
+  return /^\s*notify\s*=.*codex_langfuse_notify\.py/m.test(topLevel);
+}
+
+function addResult(results, item, ok, detail, fix = "", options = {}) {
+  results.push({ item, ok, detail, fix, required: options.required !== false });
+}
 
 function main() {
   const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
@@ -72,80 +72,80 @@ function main() {
   const python = commandOk(process.platform === "win32" ? "python" : "python3", ["--version"]);
   const langfuseImport = commandOk(hookPython, ["-c", "import langfuse; print('langfuse ok')"]);
 
-  const logPath = path.join(codexHome, "langfuse", "codex_langfuse_notify.log");
-  const logText = fs.existsSync(logPath) ? stripBom(fs.readFileSync(logPath, "utf8")) : "";
-  const recentLogHasError = /Traceback|ERROR|Exception|Failed/i.test(logText.slice(-4000));
-
-  const results = [];
-  addResult(results, "Codex home", fs.existsSync(codexHome), codexHome, "Run: npx oh-langfuse@latest setup codex");
-  addResult(results, "config.toml", fs.existsSync(configPath), configPath, "Run setup again to update Codex config.");
-  addResult(
-    results,
-    "notify hook configured",
-    configHasNotify(configText),
-    configHasNotify(configText) ? "OK" : "missing notify entry for codex_langfuse_notify.py",
-    "Run setup again, then restart Codex."
-  );
-  addResult(results, "hook script", fs.existsSync(hookPath), hookPath, "Run setup again to install the notify hook.");
-  addResult(results, "Langfuse config", !!langfuseConfig, langfuseConfigPath, "Run setup again to write Langfuse credentials.");
-  addResult(
-    results,
-    "Langfuse keys",
-    !!(langfuseConfig?.publicKey && langfuseConfig?.secretKey),
-    langfuseConfig?.publicKey ? "configured" : "missing",
-    "Provide publicKey/secretKey or use the defaults from the installer."
-  );
-  addResult(
-    results,
-    "sessions directory",
-    fs.existsSync(sessionsDir),
-    fs.existsSync(sessionsDir) ? sessionsDir : `${sessionsDir} (not created yet)`,
-    "Start Codex once so session JSONL files are created.",
-    { required: false }
-  );
-  addResult(
-    results,
-    "latest session JSONL",
-    !!latestSession,
-    latestSession || "not found yet",
-    "Start a Codex conversation, then check again.",
-    { required: false }
-  );
-  addResult(results, "Python", python.ok, python.detail || "not found", "Install Python and pip, then rerun setup.");
-  addResult(results, "Langfuse venv Python", fs.existsSync(hookPython), hookPython, "Run setup again; on Linux install python3-venv if venv creation fails.");
-  addResult(
-    results,
-    "Python langfuse package",
-    langfuseImport.ok,
-    langfuseImport.detail || "not importable from venv",
-    "Run setup again, or pass --pipIndexUrl=https://pypi.tuna.tsinghua.edu.cn/simple."
-  );
-  addResult(
-    results,
-    "notify log recent errors",
-    !recentLogHasError,
-    fs.existsSync(logPath) ? logPath : "log not created yet",
-    "Open the log path above and inspect the newest error after running Codex."
-  );
+  const logPath = path.join(codexHome, "langfuse", "codex_langfuse_notify.log");
+  const logText = fs.existsSync(logPath) ? stripBom(fs.readFileSync(logPath, "utf8")) : "";
+  const recentLogHasError = /Traceback|ERROR|Exception|Failed/i.test(logText.slice(-4000));
+
+  const results = [];
+  addResult(results, "Codex home", fs.existsSync(codexHome), codexHome, "Run: npx oh-langfuse@latest setup codex");
+  addResult(results, "config.toml", fs.existsSync(configPath), configPath, "Run setup again to update Codex config.");
+  addResult(
+    results,
+    "notify hook configured",
+    configHasNotify(configText),
+    configHasNotify(configText) ? "OK" : "missing notify entry for codex_langfuse_notify.py",
+    "Run setup again, then restart Codex."
+  );
+  addResult(results, "hook script", fs.existsSync(hookPath), hookPath, "Run setup again to install the notify hook.");
+  addResult(results, "Langfuse config", !!langfuseConfig, langfuseConfigPath, "Run setup again to write Langfuse credentials.");
+  addResult(
+    results,
+    "Langfuse keys",
+    !!(langfuseConfig?.publicKey && langfuseConfig?.secretKey),
+    langfuseConfig?.publicKey ? "configured" : "missing",
+    "Provide publicKey/secretKey or use the defaults from the installer."
+  );
+  addResult(
+    results,
+    "sessions directory",
+    fs.existsSync(sessionsDir),
+    fs.existsSync(sessionsDir) ? sessionsDir : `${sessionsDir} (not created yet)`,
+    "Start Codex once so session JSONL files are created.",
+    { required: false }
+  );
+  addResult(
+    results,
+    "latest session JSONL",
+    !!latestSession,
+    latestSession || "not found yet",
+    "Start a Codex conversation, then check again.",
+    { required: false }
+  );
+  addResult(results, "Python", python.ok, python.detail || "not found", "Install Python and pip, then rerun setup.");
+  addResult(results, "Langfuse venv Python", fs.existsSync(hookPython), hookPython, "Run setup again; on Linux install python3-venv if venv creation fails.");
+  addResult(
+    results,
+    "Python langfuse package",
+    langfuseImport.ok,
+    langfuseImport.detail || "not importable from venv",
+    "Run setup again, or pass --pipIndexUrl=https://pypi.tuna.tsinghua.edu.cn/simple."
+  );
+  addResult(
+    results,
+    "notify log recent errors",
+    !recentLogHasError,
+    fs.existsSync(logPath) ? logPath : "log not created yet",
+    "Open the log path above and inspect the newest error after running Codex."
+  );
 
   const w = Math.max(...results.map((r) => r.item.length)) + 2;
   const pad = (s, n) => (s.length >= n ? s : s + " ".repeat(n - s.length));
-  const failed = [];
-  for (const r of results) {
-    const status = r.ok ? "OK " : r.required ? "BAD" : "INFO";
-    console.log(`${status}  ${pad(r.item, w)} ${r.detail}`);
-    if (!r.ok && r.required) failed.push(r);
-  }
-
-  if (failed.length) {
-    console.log("");
-    console.log("Fix suggestions:");
-    for (const r of failed) {
-      if (r.fix) console.log(`- ${r.item}: ${r.fix}`);
-    }
-  }
-
-  process.exit(failed.length ? 2 : 0);
-}
+  const failed = [];
+  for (const r of results) {
+    const status = r.ok ? "OK " : r.required ? "BAD" : "INFO";
+    console.log(`${status}  ${pad(r.item, w)} ${r.detail}`);
+    if (!r.ok && r.required) failed.push(r);
+  }
+
+  if (failed.length) {
+    console.log("");
+    console.log("Fix suggestions:");
+    for (const r of failed) {
+      if (r.fix) console.log(`- ${r.item}: ${r.fix}`);
+    }
+  }
+
+  process.exit(failed.length ? 2 : 0);
+}
 
 main();