@nightrunners/nightmaxxing 0.1.0 → 0.1.2

package/README.md

@@ -2,9 +2,10 @@
 
 CLI for [nightmaxxing](https://maxxing.nrght.eu) — the social leaderboard
 for LLM token usage. Parses your local agent usage (Claude Code, Codex,
-OpenCode, Gemini CLI, Copilot CLI, Hermes, Pi) via
-[ccusage](https://github.com/ryoppippi/ccusage) and pushes daily aggregates
-to your public profile.
+OpenCode, Gemini CLI, Copilot CLI, Hermes, Pi, Oh My Pi, Grok Build CLI,
+Antigravity, ZCode, Amp, Qwen Code, Kimi CLI, Kilo Code, Goose, Droid,
+Codebuff, OpenClaw) via [ccusage](https://github.com/ryoppippi/ccusage) and
+pushes daily aggregates to your public profile.
 
 ## Usage
 
@@ -23,13 +24,28 @@ You can also install globally with `bun add -g --trust @nightrunners/nightmaxxin
 The background service uses the global `nightmaxxing` binary and syncs every
 5 minutes. It auto-updates through the package manager that installed the
 global binary (bun, npm, pnpm, or yarn) when that package manager can be
-detected.
+detected. Custom log roots (`CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `HERMES_HOME`,
+the other agents' data-directory variables such as `OPENCODE_DATA_DIR`,
+`GEMINI_DATA_DIR`, `COPILOT_HOME`, `PI_AGENT_DIR`, `GROK_HOME` or
+`AMP_DATA_DIR`, and `XDG_DATA_HOME`/`XDG_CONFIG_HOME`) are captured at
+`nightmaxxing service install` or `nightmaxxing service repair`; rerun one of
+those after changing them. Without `HERMES_HOME`, Hermes usage includes every
+named profile under `~/.hermes/profiles/`.
 Use `nightmaxxing service status` for the last run and `nightmaxxing service
 doctor` to inspect scheduler files, auth, auto-update, locks, and recent logs.
+Each doctor check is `OK`, `INFO` (fine, but worth knowing: never synced yet, a
+sync running right now), `WARN` (syncs still run, but something is off) or
+`FAIL` (scheduled syncs can't happen); every `WARN` and `FAIL` line ends with
+the command that fixes it. `service doctor` exits 1 when any check is `WARN` or
+`FAIL` and 0 otherwise, so scripts and CI can gate on it. With `--json`, the
+report's `health` is `ok`, `warn` or `fail` (`status` only says the doctor ran).
 
 Run `sync` as often as you like, from as many machines as you like —
 profiles aggregate across devices. Useful flags: `--dry-run`,
-`--since YYYY-MM-DD`, `--sources claude,codex`, `--json`.
+`--since YYYY-MM-DD`, `--sources claude,codex`, `--json`. `sync` exits
+non-zero when no agent's usage could be collected; if only some agents fail,
+it still uploads the rest and exits 0 with `"status": "partial"` in `--json`
+output.
 
 ### What gets uploaded (privacy)
 

package/bin/{nightmaxxing.exe → nightmaxxing}

@@ -25,6 +25,11 @@ function detectArch(value = os.arch()) {
   );
 }
 
+// The published package's `bin` points at bin/nightmaxxing, a copy of this
+// launcher. Preinstall caches the verified native binary beside it under this
+// name so the launcher can exec it without re-running CPU detection.
+const CACHED_BINARY_NAME = "nightmaxxing.exe";
+
 function binaryName(platform = detectPlatform()) {
   platform = detectPlatform(platform);
   return platform === "windows" ? "nightmaxxing.exe" : "nightmaxxing";
@@ -168,6 +173,24 @@ function resolveBinary(packageName, sourceBinary = binaryName(), options = {}) {
   return binaryPath;
 }
 
+function cachedBinaryPaths(packageDir = __dirname) {
+  return [
+    path.join(packageDir, "bin", CACHED_BINARY_NAME),
+    path.join(packageDir, CACHED_BINARY_NAME),
+  ];
+}
+
+function findCachedBinary(packageDir = __dirname) {
+  for (const binaryPath of cachedBinaryPaths(packageDir)) {
+    try {
+      if (fs.statSync(binaryPath).isFile()) return binaryPath;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
 function findNativeBinary(options = {}) {
   const packages = options.packages ?? nativePackageNames(options);
   const sourceBinary = options.sourceBinary ?? binaryName(options.platform);
@@ -206,16 +229,52 @@ function recoveryMessage(options = {}) {
   ].join("\n");
 }
 
+function relayedSignals(platform = detectPlatform()) {
+  // Windows delivers console Ctrl+C/Ctrl+Break to every process attached to the
+  // console, and ChildProcess#kill there is TerminateProcess, so the launcher
+  // only stays alive and lets the native binary handle the event itself.
+  return platform === "windows"
+    ? { forward: false, signals: ["SIGINT", "SIGBREAK"] }
+    : { forward: true, signals: ["SIGHUP", "SIGINT", "SIGQUIT", "SIGTERM"] };
+}
+
 function runBinary(target, argv = process.argv.slice(2)) {
-  const result = childProcess.spawnSync(target, argv, {
+  // Listen before spawning: the child can be up and visible to a supervisor
+  // before spawn() returns, and a signal that lands before process.on() would
+  // kill the launcher with the default action instead of reaching the child.
+  // Listeners run on a later tick, so `child` is always assigned by then.
+  let child;
+  const { forward, signals } = relayedSignals();
+  const listeners = signals.map((signal) => {
+    const listener = () => {
+      if (forward) child.kill(signal);
+    };
+    process.on(signal, listener);
+    return [signal, listener];
+  });
+  child = childProcess.spawn(target, argv, {
     stdio: "inherit",
     windowsHide: true,
   });
-  if (result.error) {
-    console.error(result.error.message);
+  const removeListeners = () => {
+    for (const [signal, listener] of listeners) process.removeListener(signal, listener);
+  };
+
+  child.on("error", (error) => {
+    removeListeners();
+    console.error(error.message);
     process.exit(1);
-  }
-  process.exit(typeof result.status === "number" ? result.status : 1);
+  });
+  child.on("exit", (code, signal) => {
+    removeListeners();
+    if (signal !== null) {
+      // Die the same way so shells and supervisors see the real signal.
+      process.kill(process.pid, signal);
+      setTimeout(() => process.exit(128 + (os.constants.signals[signal] ?? 0)), 100);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
 }
 
 function runNativeBinary(options = {}) {
@@ -225,6 +284,12 @@ function runNativeBinary(options = {}) {
     return;
   }
 
+  const cachedBinary = findCachedBinary(options.packageDir);
+  if (cachedBinary !== null) {
+    runBinary(cachedBinary, options.argv);
+    return;
+  }
+
   const nativeBinary = findNativeBinary(options);
   if (nativeBinary === null) {
     console.error(recoveryMessage(options));
@@ -238,15 +303,19 @@ if (require.main === module) {
 }
 
 module.exports = {
+  CACHED_BINARY_NAME,
   binaryName,
+  cachedBinaryPaths,
   detectArch,
   detectPlatform,
+  findCachedBinary,
   findNativeBinary,
   isMusl,
   nativePackageNames,
   packageJsonPaths,
   readPackageJson,
   recoveryMessage,
+  relayedSignals,
   resolveBinary,
   runNativeBinary,
   supportsAvx2,

package/install-native.mjs

@@ -12,6 +12,7 @@ const require = createRequire(import.meta.url);
 const launcher = require("./native-bin-launcher.cjs");
 
 const {
+  CACHED_BINARY_NAME,
   binaryName,
   detectArch,
   detectPlatform,
@@ -22,7 +23,9 @@ const {
   supportsAvx2,
 } = launcher;
 
-const targetBinary = path.join(__dirname, "bin", "nightmaxxing.exe");
+const targetBinary = path.join(__dirname, "bin", CACHED_BINARY_NAME);
+const launcherBinary = path.join(__dirname, "bin", "nightmaxxing");
+const launcherSource = path.join(__dirname, "native-bin-launcher.cjs");
 let packageJsonCache;
 
 function copyBinary(source, target = targetBinary) {
@@ -91,21 +94,58 @@ function verifyBinary(target = targetBinary) {
   return result.status === 0;
 }
 
+// npm and bun link POSIX bins as symlinks, so replacing the JS launcher behind
+// the link makes every call exec the native binary directly. Everywhere else the
+// link is a generated shim that pins the runtime by reading the file when it is
+// linked (Windows cmd/ps1/.bunx shims, pnpm's shell shims) — often before this
+// script runs — and would then run node on a native binary. Those keep the JS
+// launcher, which execs the cached binary.
+function canReplaceLauncher(
+  platform = detectPlatform(),
+  userAgent = process.env.npm_config_user_agent ?? "",
+) {
+  return platform !== "windows" && /^(npm|bun)\//.test(userAgent);
+}
+
+function replaceLauncher(source = targetBinary, target = launcherBinary) {
+  try {
+    copyBinary(source, target);
+    if (verifyBinary(target)) return true;
+  } catch {
+    // Fall through and restore the launcher.
+  }
+  try {
+    fs.rmSync(target, { force: true });
+    fs.copyFileSync(launcherSource, target);
+    fs.chmodSync(target, 0o755);
+  } catch {
+    // Leave whatever is there; the cached binary is still in place.
+  }
+  return false;
+}
+
 function installNativeBinary() {
   const packages = nativePackageNames();
   const sourceBinary = binaryName();
 
   for (const packageName of packages) {
+    let installed = false;
     try {
       copyBinary(resolveBinary(packageName, sourceBinary, { packageDir: __dirname }));
-      if (verifyBinary()) return;
+      installed = verifyBinary();
     } catch {
-      if (installPackage(packageName, sourceBinary) && verifyBinary()) return;
+      installed = installPackage(packageName, sourceBinary) && verifyBinary();
+    }
+    if (installed) {
+      if (canReplaceLauncher()) replaceLauncher();
+      return;
     }
+    // The launcher trusts whatever is cached, so never leave a binary that failed.
+    fs.rmSync(targetBinary, { force: true });
   }
 
   throw new Error(
-    `It seems your package manager failed to install the right Nightmaxxing native package. Try manually installing ${packages
+    `It seems your package manager failed to install the right nightmaxxing native package. Try manually installing ${packages
       .map((packageName) => JSON.stringify(packageName))
       .join(" or ")}.`,
   );
@@ -126,6 +166,7 @@ if (isMainModule()) {
 
 export {
   binaryName,
+  canReplaceLauncher,
   copyBinary,
   detectArch,
   detectPlatform,
@@ -134,6 +175,7 @@ export {
   isMusl,
   nativePackageNames,
   readPackageJson,
+  replaceLauncher,
   supportsAvx2,
   verifyBinary,
 };

package/native-bin-launcher.cjs

@@ -25,6 +25,11 @@ function detectArch(value = os.arch()) {
   );
 }
 
+// The published package's `bin` points at bin/nightmaxxing, a copy of this
+// launcher. Preinstall caches the verified native binary beside it under this
+// name so the launcher can exec it without re-running CPU detection.
+const CACHED_BINARY_NAME = "nightmaxxing.exe";
+
 function binaryName(platform = detectPlatform()) {
   platform = detectPlatform(platform);
   return platform === "windows" ? "nightmaxxing.exe" : "nightmaxxing";
@@ -168,6 +173,24 @@ function resolveBinary(packageName, sourceBinary = binaryName(), options = {}) {
   return binaryPath;
 }
 
+function cachedBinaryPaths(packageDir = __dirname) {
+  return [
+    path.join(packageDir, "bin", CACHED_BINARY_NAME),
+    path.join(packageDir, CACHED_BINARY_NAME),
+  ];
+}
+
+function findCachedBinary(packageDir = __dirname) {
+  for (const binaryPath of cachedBinaryPaths(packageDir)) {
+    try {
+      if (fs.statSync(binaryPath).isFile()) return binaryPath;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
 function findNativeBinary(options = {}) {
   const packages = options.packages ?? nativePackageNames(options);
   const sourceBinary = options.sourceBinary ?? binaryName(options.platform);
@@ -206,16 +229,52 @@ function recoveryMessage(options = {}) {
   ].join("\n");
 }
 
+function relayedSignals(platform = detectPlatform()) {
+  // Windows delivers console Ctrl+C/Ctrl+Break to every process attached to the
+  // console, and ChildProcess#kill there is TerminateProcess, so the launcher
+  // only stays alive and lets the native binary handle the event itself.
+  return platform === "windows"
+    ? { forward: false, signals: ["SIGINT", "SIGBREAK"] }
+    : { forward: true, signals: ["SIGHUP", "SIGINT", "SIGQUIT", "SIGTERM"] };
+}
+
 function runBinary(target, argv = process.argv.slice(2)) {
-  const result = childProcess.spawnSync(target, argv, {
+  // Listen before spawning: the child can be up and visible to a supervisor
+  // before spawn() returns, and a signal that lands before process.on() would
+  // kill the launcher with the default action instead of reaching the child.
+  // Listeners run on a later tick, so `child` is always assigned by then.
+  let child;
+  const { forward, signals } = relayedSignals();
+  const listeners = signals.map((signal) => {
+    const listener = () => {
+      if (forward) child.kill(signal);
+    };
+    process.on(signal, listener);
+    return [signal, listener];
+  });
+  child = childProcess.spawn(target, argv, {
     stdio: "inherit",
     windowsHide: true,
   });
-  if (result.error) {
-    console.error(result.error.message);
+  const removeListeners = () => {
+    for (const [signal, listener] of listeners) process.removeListener(signal, listener);
+  };
+
+  child.on("error", (error) => {
+    removeListeners();
+    console.error(error.message);
     process.exit(1);
-  }
-  process.exit(typeof result.status === "number" ? result.status : 1);
+  });
+  child.on("exit", (code, signal) => {
+    removeListeners();
+    if (signal !== null) {
+      // Die the same way so shells and supervisors see the real signal.
+      process.kill(process.pid, signal);
+      setTimeout(() => process.exit(128 + (os.constants.signals[signal] ?? 0)), 100);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
 }
 
 function runNativeBinary(options = {}) {
@@ -225,6 +284,12 @@ function runNativeBinary(options = {}) {
     return;
   }
 
+  const cachedBinary = findCachedBinary(options.packageDir);
+  if (cachedBinary !== null) {
+    runBinary(cachedBinary, options.argv);
+    return;
+  }
+
   const nativeBinary = findNativeBinary(options);
   if (nativeBinary === null) {
     console.error(recoveryMessage(options));
@@ -238,15 +303,19 @@ if (require.main === module) {
 }
 
 module.exports = {
+  CACHED_BINARY_NAME,
   binaryName,
+  cachedBinaryPaths,
   detectArch,
   detectPlatform,
+  findCachedBinary,
   findNativeBinary,
   isMusl,
   nativePackageNames,
   packageJsonPaths,
   readPackageJson,
   recoveryMessage,
+  relayedSignals,
   resolveBinary,
   runNativeBinary,
   supportsAvx2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightrunners/nightmaxxing",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI for Nightmaxxing — sync your LLM token usage to the leaderboard.",
   "keywords": [
     "ccusage",
@@ -17,7 +17,7 @@
     "directory": "apps/cli"
   },
   "bin": {
-    "nightmaxxing": "./bin/nightmaxxing.exe"
+    "nightmaxxing": "./bin/nightmaxxing"
   },
   "scripts": {
     "preinstall": "bun ./install-native.mjs || node ./install-native.mjs"
@@ -42,17 +42,17 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@nightrunners/nightmaxxing-linux-arm64": "0.1.0",
-    "@nightrunners/nightmaxxing-linux-x64": "0.1.0",
-    "@nightrunners/nightmaxxing-linux-x64-baseline": "0.1.0",
-    "@nightrunners/nightmaxxing-linux-arm64-musl": "0.1.0",
-    "@nightrunners/nightmaxxing-linux-x64-musl": "0.1.0",
-    "@nightrunners/nightmaxxing-linux-x64-baseline-musl": "0.1.0",
-    "@nightrunners/nightmaxxing-darwin-arm64": "0.1.0",
-    "@nightrunners/nightmaxxing-darwin-x64": "0.1.0",
-    "@nightrunners/nightmaxxing-darwin-x64-baseline": "0.1.0",
-    "@nightrunners/nightmaxxing-windows-arm64": "0.1.0",
-    "@nightrunners/nightmaxxing-windows-x64": "0.1.0",
-    "@nightrunners/nightmaxxing-windows-x64-baseline": "0.1.0"
+    "@nightrunners/nightmaxxing-linux-arm64": "0.1.2",
+    "@nightrunners/nightmaxxing-linux-x64": "0.1.2",
+    "@nightrunners/nightmaxxing-linux-x64-baseline": "0.1.2",
+    "@nightrunners/nightmaxxing-linux-arm64-musl": "0.1.2",
+    "@nightrunners/nightmaxxing-linux-x64-musl": "0.1.2",
+    "@nightrunners/nightmaxxing-linux-x64-baseline-musl": "0.1.2",
+    "@nightrunners/nightmaxxing-darwin-arm64": "0.1.2",
+    "@nightrunners/nightmaxxing-darwin-x64": "0.1.2",
+    "@nightrunners/nightmaxxing-darwin-x64-baseline": "0.1.2",
+    "@nightrunners/nightmaxxing-windows-arm64": "0.1.2",
+    "@nightrunners/nightmaxxing-windows-x64": "0.1.2",
+    "@nightrunners/nightmaxxing-windows-x64-baseline": "0.1.2"
   }
 }