oh-aicoding-tool 0.1.0

package/CODEX_LANGFUSE_PLAN.md

@@ -0,0 +1,62 @@
+# Codex Langfuse implementation plan
+
+## Goal
+
+Add Codex support without depending on an unstable Codex plugin API. The first
+version uses Codex's `notify` lifecycle command to trigger an exporter after a
+turn, then the exporter reads Codex session JSONL files and sends the new events
+to Langfuse.
+
+## Architecture
+
+```text
+Codex turn ends
+  -> ~/.codex/config.toml notify command
+  -> ~/.codex/hooks/codex_langfuse_notify.py
+  -> incremental read of ~/.codex/sessions/**/*.jsonl
+  -> Langfuse trace / generation / tool observations
+  -> ~/.codex/langfuse/state.json stores offsets
+```
+
+## Files
+
+- `codex_langfuse_notify.py`: Python notify hook and JSONL exporter.
+- `scripts/codex-langfuse-setup.mjs`: installs the hook, writes Langfuse
+  config, creates `~/.codex/langfuse-venv`, updates `~/.codex/config.toml`,
+  and installs the Python SDK inside the venv.
+- `scripts/codex-langfuse-check.mjs`: validates hook/config/session/package
+  availability.
+- `bin/cli.js`: adds `setup codex` and `check codex`.
+- `package.json`: adds Codex npm scripts and publishes the hook file.
+
+## Commands
+
+```sh
+npm run codex:setup -- --userId=h00613222
+npm run codex:check
+```
+
+or:
+
+```sh
+node bin/cli.js setup codex
+node bin/cli.js check codex
+```
+
+Restart Codex after setup so it reloads `~/.codex/config.toml`.
+
+## Behavior
+
+- The exporter reads Langfuse keys from environment variables first, then from
+  `~/.codex/langfuse/config.json`.
+- It prefers a session path from the notify payload when Codex provides one.
+  If no path is present, it falls back to the latest session JSONL file.
+- It fails open. Errors are logged to
+  `~/.codex/langfuse/codex_langfuse_notify.log` and never block Codex.
+
+## Future improvements
+
+- If Codex exposes a stable OTEL or plugin trace API, add it as an optional
+  second backend.
+- Split shared Langfuse emit logic from the Claude and Codex Python hooks.
+- Add a redaction layer before sending tool output to Langfuse.

package/README.md

@@ -0,0 +1,114 @@
+# oh-aicoding-tool
+
+One npm package for AI coding tooling:
+
+- Langfuse tracing setup for Claude Code, OpenCode, and Codex.
+- `oh-ai-report` issue feedback plugin installer for OpenCode and Claude Code.
+
+## Usage
+
+Run locally from this project:
+
+```sh
+node bin/cli.js
+node bin/cli.js langfuse
+node bin/cli.js report doctor
+```
+
+After publishing to npm:
+
+```sh
+npx oh-aicoding-tool
+npx oh-aicoding-tool langfuse setup
+npx oh-aicoding-tool report install opencode --email user@company.com
+```
+
+Running `npx oh-aicoding-tool` with no subcommand opens a guided menu. Choose
+Langfuse tracing or the issue report plugin; the report path asks for the
+install target and guides company email configuration before installing.
+
+## Commands
+
+```sh
+oh-aicoding-tool                         # guided menu
+oh-aicoding-tool langfuse setup
+oh-aicoding-tool langfuse setup claude
+oh-aicoding-tool langfuse setup opencode
+oh-aicoding-tool langfuse setup codex
+oh-aicoding-tool langfuse check
+oh-aicoding-tool langfuse check environment
+oh-aicoding-tool langfuse check claude
+oh-aicoding-tool langfuse check opencode
+oh-aicoding-tool langfuse check codex
+oh-aicoding-tool report install opencode
+oh-aicoding-tool report install claude
+oh-aicoding-tool report install both
+oh-aicoding-tool report doctor
+```
+
+Compatibility binaries are still published:
+
+```sh
+code-tool-langfuse
+opencode-ohai-report
+ohai-report
+```
+
+## Langfuse
+
+The interactive UI supports arrow-key navigation in terminals that support raw input. Use `Up` / `Down` to move, number keys for quick selection, `Enter` to select, and `q` or `Esc` to exit. In multi-select setup screens, use `Space` to toggle targets and `Enter` to continue. It uses a soft color palette and falls back to plain numeric prompts when raw terminal input is unavailable.
+
+`Setup Langfuse` supports selecting one or more setup targets:
+
+- Claude Code Langfuse
+- OpenCode Langfuse
+- Codex Langfuse
+
+During setup, the only required input is `User ID`, which should be your employee number, for example `h00613222`. Other setup values use the built-in defaults.
+
+Before setup, the CLI checks required local tools and prints install hints when something is missing:
+
+- Node.js / npm
+- Python / pip for Claude Code setup
+- Python / pip for Codex setup
+- OpenCode CLI for OpenCode setup
+
+Python package installation uses pip's default package index by default. If you need a custom PyPI mirror, set `CODE_TOOL_PIP_INDEX_URL` or pass `--pipIndexUrl=...`.
+
+Use dry-run mode to preview the script calls without modifying files, installing packages, or writing environment variables:
+
+```sh
+oh-aicoding-tool langfuse setup --dry-run
+```
+
+## Issue Report Plugin
+
+The report installer copies the packaged runtime to `~/.config/ohai-report/runtime`, installs OpenCode/Claude command files, and sets `OHAI_REPORT_CLI` to a stable path outside the temporary npx cache.
+
+The guided menu prompts for company email and saves it into the corresponding
+tool config so issue reports can carry a stable user identity.
+
+```sh
+oh-aicoding-tool report install opencode --email user@company.com
+oh-aicoding-tool report install claude --email user@company.com
+oh-aicoding-tool report install both --email user@company.com
+oh-aicoding-tool report doctor
+```
+
+## What It Configures
+
+For Claude Code Langfuse setup, the CLI installs `langfuse_hook.py`, creates `~/.claude/langfuse-venv`, installs `langfuse` into that virtual environment, updates `~/.claude/settings.json`, and configures the hook environment. On Ubuntu/Debian, install `python3-venv` first if the setup reports that venv support is missing.
+
+For OpenCode Langfuse setup, the CLI installs and patches `opencode-plugin-langfuse`, updates `~/.config/opencode/opencode.json`, and can write `LANGFUSE_*` values to the user environment.
+
+For Codex Langfuse setup, the CLI installs `codex_langfuse_notify.py`, creates `~/.codex/langfuse-venv`, installs `langfuse` into that virtual environment, writes Langfuse credentials to `~/.codex/langfuse/config.json`, and updates the top-level `notify` command in `~/.codex/config.toml`. Restart Codex after setup so the notify command is loaded.
+
+The Codex integration is implemented as a notify-hook exporter. On each notify event it incrementally reads the matching `~/.codex/sessions/**/*.jsonl` file, converts new user/assistant/tool/token events into Langfuse observations, and then saves its offset in `~/.codex/langfuse/state.json`. If Codex does not provide a session path in the notify payload, the exporter falls back to the latest session JSONL file.
+
+## Notes
+
+- Langfuse Base URL, Public Key, and Secret Key have built-in defaults for this internal setup. You can override them with `LANGFUSE_BASEURL`, `LANGFUSE_PUBLIC_KEY`, and `LANGFUSE_SECRET_KEY`.
+- The default secret key is not printed in the terminal UI.
+- The CLI calls the Node setup/check scripts directly, so it avoids PowerShell `npm.ps1` execution-policy failures.
+- The Python hook reads `userId` from hook payload first, then from configured environment variables.
+- The Codex hook fails open: tracing errors are logged to `~/.codex/langfuse/codex_langfuse_notify.log` and do not block Codex.

package/bin/cli.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+function runNodeScript(script, args) {
+  const result = spawnSync(process.execPath, [script, ...args], {
+    stdio: "inherit",
+    windowsHide: true,
+  });
+  return result.status ?? (result.error ? 1 : 0);
+}
+
+function printHelp() {
+  console.log("oh-aicoding-tool");
+  console.log("");
+  console.log("Usage:");
+  console.log("  oh-aicoding-tool                         Open the installer menu");
+  console.log("  oh-aicoding-tool langfuse [setup|check] [target]");
+  console.log("  oh-aicoding-tool report install opencode [--email user@company.com]");
+  console.log("  oh-aicoding-tool report install claude");
+  console.log("  oh-aicoding-tool report install both");
+  console.log("  oh-aicoding-tool report doctor");
+  console.log("");
+  console.log("Compatibility bins:");
+  console.log("  code-tool-langfuse");
+  console.log("  opencode-ohai-report");
+  console.log("  ohai-report");
+}
+
+function emailIsValid(value) {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(String(value || "").trim());
+}
+
+async function askChoice(rl, title, choices) {
+  console.log("");
+  console.log(title);
+  choices.forEach((choice, index) => {
+    console.log(`  ${index + 1}. ${choice.label}`);
+    if (choice.description) console.log(`     ${choice.description}`);
+  });
+  while (true) {
+    const answer = (await rl.question("> ")).trim().toLowerCase();
+    const index = Number.parseInt(answer, 10) - 1;
+    if (Number.isInteger(index) && choices[index]) return choices[index].value;
+    const byValue = choices.find((choice) => choice.value === answer);
+    if (byValue) return byValue.value;
+    console.log("Please choose one of the listed options.");
+  }
+}
+
+const langfuseCli = path.join(rootDir, "bin", "langfuse-cli.js");
+const reportCli = path.join(rootDir, "opencode-ohai-report", "bin", "cli.js");
+
+async function askEmail(rl) {
+  const envEmail = process.env.OHAI_INSTALL_USER_EMAIL || "";
+  const hint = emailIsValid(envEmail) ? ` [${envEmail}]` : "";
+  console.log("");
+  console.log("Company email is used as the user identity in issue reports.");
+  console.log("Press Enter to skip email setup for now.");
+  while (true) {
+    const answer = (await rl.question(`Company email${hint}: `)).trim();
+    const value = answer || (emailIsValid(envEmail) ? envEmail.trim() : "");
+    if (!value) return "";
+    if (emailIsValid(value)) return value;
+    console.log("Invalid email. Example: name@company.com");
+  }
+}
+
+async function runReportInstallMenu(rl) {
+  const target = await askChoice(rl, "Install issue report plugin for:", [
+    { label: "OpenCode", value: "opencode", description: "Install /report-ai-issue and the OpenCode plugin." },
+    { label: "Claude Code", value: "claude", description: "Install the command and optional hook integration." },
+    { label: "Both", value: "both", description: "Install OpenCode and Claude Code integrations together." },
+    { label: "Back", value: "back" },
+  ]);
+  if (target === "back") return 0;
+  const email = await askEmail(rl);
+  const args = ["install", target];
+  if (email) args.push("--email", email);
+  else args.push("--skip-email");
+  rl.close();
+  return runNodeScript(reportCli, args);
+}
+
+async function runMainMenu() {
+  if (!process.stdin.isTTY) {
+    printHelp();
+    return 0;
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log("");
+    console.log("oh-aicoding-tool");
+    const action = await askChoice(rl, "What would you like to install or configure?", [
+      {
+        label: "Langfuse tracing",
+        value: "langfuse",
+        description: "Configure tracing for Claude Code, OpenCode, or Codex.",
+      },
+      {
+        label: "Issue report plugin",
+        value: "report",
+        description: "Install oh-ai-report and configure company email.",
+      },
+      { label: "Check Langfuse configuration", value: "check-langfuse" },
+      { label: "Check report plugin", value: "check-report" },
+      { label: "Exit", value: "exit" },
+    ]);
+    if (action === "langfuse") {
+      rl.close();
+      return runNodeScript(langfuseCli, ["setup"]);
+    }
+    if (action === "report") return await runReportInstallMenu(rl);
+    if (action === "check-langfuse") {
+      rl.close();
+      return runNodeScript(langfuseCli, ["check"]);
+    }
+    if (action === "check-report") {
+      rl.close();
+      return runNodeScript(reportCli, ["doctor"]);
+    }
+    return 0;
+  } finally {
+    rl.close();
+  }
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const [cmd, ...rest] = argv;
+
+  if (cmd === "--help" || cmd === "-h" || cmd === "help") {
+    printHelp();
+    return 0;
+  }
+
+  if (!cmd) return await runMainMenu();
+
+  if (cmd === "langfuse" || cmd === "trace" || cmd === "tracing") {
+    return runNodeScript(langfuseCli, rest);
+  }
+
+  if (cmd === "report" || cmd === "ohai" || cmd === "issue") {
+    return runNodeScript(reportCli, rest);
+  }
+
+  if (cmd === "setup" || cmd === "check") {
+    return runNodeScript(langfuseCli, argv);
+  }
+
+  console.error(`Unknown command: ${cmd}`);
+  console.error("");
+  printHelp();
+  return 1;
+}
+
+main()
+  .then((code) => process.exit(code))
+  .catch((err) => {
+    console.error(err?.message || String(err));
+    process.exit(1);
+  });