tokenmaxxing 1.72.0 → 1.74.0

package/DESIGN.md

@@ -42,7 +42,7 @@ It is a process manager only - spawn with inherited stdio (stdin through a relay
   - `sessions/<sid>.json`, `onboard/`, `hub-key`, `update.json`, `spawnrate.json`, `tokenmaxxing.log`, the codex `codex-onboard/`, `codex-respawn/`, and `codex-live/`, and the `grok-*` and `opencode-go-*` state of the status-only pools: the full table is in [State directory layout](docs/content/docs/state-directory.mdx).
 - Per-account **credential stores** follow the platform's Claude Code store: macOS = a login-keychain item keyed by the store path (never plaintext on disk); Linux = a 0600 `.credentials.json` inside the 0700 store directory (the same plaintext model claude itself uses - its Linux build has no keyring path at all, binary-verified 2.1.205). One `credstore` facade dispatches on a `{kind: keychain|file}` target; call sites never branch on platform. tokenmaxxing writes a store once, at onboarding; Claude Code's own refresh is the only writer afterwards.
 
-- A periodic check job (`com.tokenmaxxing.check` launchd agent on macOS, `tokenmaxxing-check.timer` systemd user timer on Linux) running `tokenmaxxing check` once per tick (`policy.checkIntervalMs`, 60s by default): it runs the decision with no seat (nothing moves), folds fresh tees into the index, samples up to three accounts whose last sample attempt is oldest (the direct no-spend usage GET), deletes leftover dead state files at the state root, and on a Bun global install checks npm for a newer version once a day, so the cached figures every placement reads stay fresh.
+- A periodic check job (`com.tokenmaxxing.check` launchd agent on macOS, `tokenmaxxing-check.timer` systemd user timer on Linux) running `tokenmaxxing check` once per tick (`policy.checkIntervalMs`, 60s by default): it runs the decision with no seat (nothing moves), folds fresh tees into the index, samples up to three accounts whose last sample attempt is oldest (the direct no-spend usage GET), deletes leftover atomic-write temp files under the state root, and on a Bun global install checks npm for a newer version once a day, so the cached figures every placement reads stay fresh.
 - A usage hub service (`com.tokenmaxxing.hub` launchd agent on macOS, `tokenmaxxing-hub.service` systemd user service on Linux) running `tokenmaxxing serve`, so the [usage hub](docs/content/docs/hub.mdx) is up in the background beside the check timer.
 
 The switching path runs no long-lived daemon. The statusline pushes usage. Hooks and the supervisor react. The periodic check job above is the only recurring process in the switching path. The [usage hub](docs/content/docs/hub.mdx) that answers the CLIProxyAPI management subset for a dashboard from the cached figures runs outside the switching path, as a background service beside the check timer (`tokenmaxxing serve` runs the same server in the foreground). The `claude` binary, `~/.claude.json`, and Claude Code's default credential store are untouched; inside `~/.claude` only `settings.json` gets the five entries.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmaxxing",
-  "version": "1.72.0",
+  "version": "1.74.0",
   "description": "Automatic Claude Code account switching: pool multiple accounts, start each session on its own account, and resume a session on a fresher account when quota fills.",
   "type": "module",
   "license": "MIT",

package/src/entries/codexstophook.ts

@@ -1,5 +1,4 @@
 import { join } from "node:path";
-import { mkdirSync } from "node:fs";
 import type { z } from "zod";
 import { codexPaths, optionalEnv } from "../lib/paths.ts";
 import { writeFileAtomic } from "../lib/atomic.ts";
@@ -50,7 +49,6 @@ async function handleCodexStop(rawStdin: string): Promise<void> {
     await compactBeforeMove({ sessionId, now });
     const decision = await evaluateAndMaybeSwap(codex, now);
     if (decision.swapped && decision.account) {
-      mkdirSync(codexPaths.respawnDir, { recursive: true });
       const payload: z.infer<typeof CodexRespawnMarkerSchema> = { accountId: decision.account.id, sessionId, ts: Date.now() };
       writeFileAtomic(join(codexPaths.respawnDir, supervisorId), JSON.stringify(payload));
       log("codexstop.marker", { supervisorId: supervisorId.slice(0, 8) });

package/src/lib/claudebin.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { uniq } from "es-toolkit";
 import { z } from "zod";
@@ -30,7 +30,6 @@ export function wrapperEntryRateTripped(now: number): boolean {
   entries = entries.filter((t) => now - t < WRAP_RATE_WINDOW_MS);
   entries.push(now);
   try {
-    mkdirSync(paths.home, { recursive: true });
     writeFileAtomic(file, JSON.stringify({ entries }));
   } catch {  }
   return entries.length > WRAP_RATE_MAX;

package/src/lib/codex.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, rmSync } from "node:fs";
+import { existsSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { writeFileAtomic } from "./atomic.ts";
 import { MAX_WRAP_DEPTH, WRAP_DEPTH_ENV } from "./claudebin.ts";
@@ -116,7 +116,6 @@ async function login(): Promise<Harvest | null> {
   const real = resolveRealCodex();
   const onboardDir = codexPaths.onboardDir;
   rmSync(onboardDir, { recursive: true, force: true });
-  mkdirSync(onboardDir, { recursive: true });
   writeFileAtomic(join(onboardDir, "config.toml"), 'cli_auth_credentials_store = "file"\n');
 
   const savedTermios = saveTermios();

package/src/lib/codexauth.ts

@@ -32,7 +32,6 @@ export function codexStoreUsable(accountId: string): boolean {
 }
 
 export function writeCodexStoreAuth(accountId: string, auth: CodexAuthJson): void {
-  mkdirSync(codexStoreDirFor(accountId), { recursive: true });
   writeFileAtomic(codexAuthJsonFor(accountId), JSON.stringify(CodexAuthJsonSchema.parse(auth), null, 2), 0o600);
 }
 

package/src/lib/grok.ts

@@ -1,4 +1,4 @@
-import { mkdirSync, readFileSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { z } from "zod";
 import { writeFileAtomic } from "./atomic.ts";
@@ -31,7 +31,6 @@ function harvestOf(id: string, key: string, entry: GrokAuthEntry): Harvest {
     tier: null,
     sample: null,
     park: async () => {
-      mkdirSync(grokStoreDirFor(id), { recursive: true });
       writeFileAtomic(grokAuthJsonFor(id), JSON.stringify({ [key]: entry }, null, 2), 0o600);
     },
   };

package/src/lib/install.ts

@@ -1,4 +1,4 @@
-import { accessSync, appendFileSync, constants, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync } from "node:fs";
+import { accessSync, appendFileSync, constants, existsSync, readFileSync, realpathSync, rmSync, statSync } from "node:fs";
 import { userInfo } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
 import { escape } from "es-toolkit";
@@ -89,7 +89,6 @@ exec ${JSON.stringify(bun)} --no-env-file run ${JSON.stringify(entry)} "$@"
 }
 
 export function installSupervisor(): InstallOutcome {
-  mkdirSync(paths.binDir, { recursive: true });
   const target = installedBin();
   const entry = realpathSync(Bun.main);
   if (isNixPackaged()) {
@@ -147,7 +146,6 @@ export function installCodexStopHook(): void {
       ],
     },
   };
-  mkdirSync(codexPaths.home, { recursive: true });
   writeFileAtomic(codexPaths.hooksJson, JSON.stringify(next, null, 2) + "\n");
 }
 
@@ -198,7 +196,6 @@ export function codexSupervisorLink(): string {
 }
 
 export function installCodexSupervisor(): void {
-  mkdirSync(paths.binDir, { recursive: true });
   writeFileAtomic(codexSupervisorLink(), `#!/bin/sh\nexec ${JSON.stringify(installedBin())} __supervise-codex "$@"\n`, 0o755);
   installCodexStopHook();
 }

package/src/lib/opencodego.ts

@@ -1,4 +1,4 @@
-import { mkdirSync, readFileSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { z } from "zod";
 import { writeFileAtomic } from "./atomic.ts";
@@ -29,7 +29,6 @@ function harvestOf(key: string): Harvest {
     tier: "go",
     sample: null,
     park: async () => {
-      mkdirSync(opencodeGoStoreDirFor(id), { recursive: true });
       writeFileAtomic(opencodeGoAuthJsonFor(id), JSON.stringify({ "opencode-go": { type: "api", key } }, null, 2), 0o600);
     },
   };

package/src/lib/presence.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { z } from "zod";
 import { writeFileAtomic } from "./atomic.ts";
@@ -14,7 +14,6 @@ const PresenceSchema = z.object({
 export function writePresence(input: { dir: string; id: string; accountId: string; pid: number }): void {
   const startedAt = pidStartTime(input.pid);
   if (startedAt == null) throw new Error(`could not read pid ${input.pid}'s start time (ps lstart) - refusing to write an unverifiable presence file`);
-  mkdirSync(input.dir, { recursive: true });
   writeFileAtomic(join(input.dir, input.id), JSON.stringify(PresenceSchema.parse({ accountId: input.accountId, pid: input.pid, startedAt })));
 }
 

package/src/lib/sessions.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, type Dirent } from "node:fs";
+import { existsSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, type Dirent } from "node:fs";
 import { basename, join, sep } from "node:path";
 import { z } from "zod";
 import { errorMessage, log } from "./log.ts";
@@ -19,7 +19,6 @@ function sessionFile(sid: string): string {
 }
 
 export function saveSessionFlags(sid: string, flags: string[], cwd: string): void {
-  mkdirSync(sessionsDir(), { recursive: true });
   writeFileAtomic(sessionFile(sid), JSON.stringify({ flags, cwd }));
 }
 
@@ -39,28 +38,9 @@ export function liveSessionId(sid: string): string {
 
 function recordLiveSession(sid: string, current: string): void {
   const session = loadSession(sid);
-  mkdirSync(sessionsDir(), { recursive: true });
   writeFileAtomic(sessionFile(sid), JSON.stringify({ flags: session?.flags ?? [], cwd: session?.cwd ?? process.cwd(), current }));
 }
 
-const DEAD_STATE_ENTRIES = [
-  "model-usage.json",
-  "accounts.json.v1-backup",
-  "codex-accounts.json.v1-backup",
-  "nextcheck.json",
-  "usage.json",
-  "lastswap.json",
-  "depleted.json",
-  "codex-lastswap.json",
-  "creds",
-  "codex-creds",
-  "codex-reconcile",
-  "sample",
-  "setup-tokens.json",
-  "setup-token",
-  "cloud",
-];
-
 const TMP_MARKER = ".tmp.";
 const TMP_GRACE_MS = 3600 * 1000;
 
@@ -88,14 +68,7 @@ function tmpSweepDirs(root: string): string[] {
   return dirs;
 }
 
-function pruneDeadState(now: number, root: string): void {
-  for (const name of DEAD_STATE_ENTRIES) {
-    try {
-      rmSync(join(paths.home, name), { recursive: true, force: true });
-    } catch (e) {
-      log("state.dead_entry_failed", { name, err: errorMessage(e) });
-    }
-  }
+function pruneTmpFiles(now: number, root: string): void {
   for (const dir of tmpSweepDirs(root)) {
     for (const f of listDir(dir, root)) {
       if (!f.isFile() || !f.name.includes(TMP_MARKER)) continue;
@@ -115,7 +88,7 @@ export function pruneStaleSessions(now: number): void {
   } catch {
     return;
   }
-  pruneDeadState(now, root);
+  pruneTmpFiles(now, root);
   const dir = sessionsDir();
   for (const f of listDir(dir, root)) {
     const p = join(dir, f.name);
@@ -151,7 +124,6 @@ export function adoptLiveSession(session: SupervisedSession, stdinSid: string |
 }
 
 export function writeRespawnMarker(input: { session: SupervisedSession; accountId: string; waitUntil: number; compact: boolean }): void {
-  mkdirSync(paths.respawnDir, { recursive: true });
   const payload: z.infer<typeof RespawnMarkerSchema> = {
     accountId: input.accountId,
     ts: Date.now(),