@kerrshift/agentdiff 0.0.0-stage → 0.7.0

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# @kerrshift/agentdiff
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**See what your AI coding agent actually did, and what it cost.**
+
+```bash
+npx @kerrshift/agentdiff
+```
+
+Reads the Claude Code session logs already on your machine and shows where the
+money went and what was avoidable: long context re-sent every turn, prompt
+caches rebuilt after breaks, stuck retries. No config, no API key, nothing
+uploaded.
+
+```bash
+npx @kerrshift/agentdiff --since 30d        # 24h, 7d, 30d, 12w … or all
+npx @kerrshift/agentdiff --project api      # only projects whose name contains "api"
+npx @kerrshift/agentdiff --json             # machine-readable
+```
+
+Install it with `npm i -g @kerrshift/agentdiff`; the command is `agentdiff`.
+
+This npm package is a thin launcher for the Python CLI
+([`agent-trajectory-diff`](https://pypi.org/project/agent-trajectory-diff/))
+at the same version. It uses `uvx` if you have uv, else `pipx`, else builds a
+private virtualenv once with any Python 3.10+.
+
+Docs and the Claude Code plugin: [agentdiff.app](https://agentdiff.app) ·
+[GitHub](https://github.com/kerrshift/agentdiff). MIT licensed.

package/bin/agentdiff.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+// `npx @kerrshift/agentdiff` — runs the AgentDiff Python CLI (PyPI: agent-trajectory-diff)
+// at the same version as this npm package, using whichever Python runner the
+// machine already has: uvx, then pipx, then a private virtualenv built once
+// with any Python 3.10+. No runtime dependencies.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const { version } = require("../package.json");
+
+const SPEC = `agent-trajectory-diff==${version}`;
+const IS_WIN = process.platform === "win32";
+
+function which(cmd) {
+  const exts = IS_WIN ? (process.env.PATHEXT || ".EXE;.CMD;.BAT").split(";") : [""];
+  for (const dir of (process.env.PATH || "").split(path.delimiter)) {
+    if (!dir) continue;
+    for (const ext of exts) {
+      const candidate = path.join(dir, cmd + ext);
+      try {
+        if (fs.statSync(candidate).isFile()) {
+          fs.accessSync(candidate, fs.constants.X_OK);
+          return candidate;
+        }
+      } catch {
+        // not here
+      }
+    }
+  }
+  return null;
+}
+
+function run(cmd, args) {
+  const result = spawnSync(cmd, args, { stdio: "inherit" });
+  if (result.error) {
+    console.error(`agentdiff: could not start ${cmd}: ${result.error.message}`);
+    return 1;
+  }
+  if (result.signal) process.kill(process.pid, result.signal);
+  return result.status ?? 1;
+}
+
+function quiet(cmd, args) {
+  const result = spawnSync(cmd, args, { stdio: "ignore" });
+  return result.error ? 1 : result.status ?? 1;
+}
+
+function findPython() {
+  for (const name of ["python3", "python"]) {
+    const exe = which(name);
+    if (exe && quiet(exe, ["-c", "import sys; sys.exit(sys.version_info < (3, 10))"]) === 0) {
+      return exe;
+    }
+  }
+  return null;
+}
+
+function cacheDir() {
+  if (process.env.AGENTDIFF_CACHE_DIR) return process.env.AGENTDIFF_CACHE_DIR;
+  if (IS_WIN) {
+    return path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"), "agentdiff");
+  }
+  return path.join(process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache"), "agentdiff");
+}
+
+function viaVirtualenv(python, args) {
+  const venv = path.join(cacheDir(), `venv-${version}`);
+  const binDir = path.join(venv, IS_WIN ? "Scripts" : "bin");
+  const agentdiff = path.join(binDir, IS_WIN ? "agentdiff.exe" : "agentdiff");
+  if (!fs.existsSync(agentdiff)) {
+    console.error(`Setting up AgentDiff ${version} in ${venv} (first run only)...`);
+    const venvPython = path.join(binDir, IS_WIN ? "python.exe" : "python");
+    if (
+      quiet(python, ["-m", "venv", venv]) !== 0 ||
+      quiet(venvPython, ["-m", "pip", "install", "--quiet", SPEC]) !== 0
+    ) {
+      console.error(`agentdiff: could not install ${SPEC} with ${python}.`);
+      console.error(`Try: pip install "${SPEC}"`);
+      return 1;
+    }
+  }
+  return run(agentdiff, args);
+}
+
+function main(args) {
+  const uvx = which("uvx");
+  if (uvx) return run(uvx, ["-q", "--from", SPEC, "agentdiff", ...args]);
+
+  const pipx = which("pipx");
+  if (pipx) {
+    // Warm pipx's cache silently so its setup chatter stays out of the output.
+    quiet(pipx, ["run", "--spec", SPEC, "agentdiff", "--help"]);
+    return run(pipx, ["run", "--spec", SPEC, "agentdiff", ...args]);
+  }
+
+  const python = findPython();
+  if (python) return viaVirtualenv(python, args);
+
+  console.error(
+    [
+      "agentdiff needs Python 3.10+ (or uv) and none was found.",
+      "  uv:      https://docs.astral.sh/uv/getting-started/installation/",
+      "  Python:  https://www.python.org/downloads/",
+    ].join("\n"),
+  );
+  return 1;
+}
+
+process.exitCode = main(process.argv.slice(2));

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@kerrshift/agentdiff",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.7.0",
+  "description": "See what your AI coding agent actually did, and what it cost. Local spend report for Claude Code sessions.",
+  "keywords": [
+    "claude-code",
+    "cost",
+    "usage",
+    "tokens",
+    "prompt-caching",
+    "ai-agents",
+    "cli"
+  ],
+  "homepage": "https://agentdiff.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kerrshift/agentdiff.git",
+    "directory": "npm"
+  },
+  "bugs": "https://github.com/kerrshift/agentdiff/issues",
+  "license": "MIT",
+  "bin": {
+    "agentdiff": "bin/agentdiff.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  }
+}