cxstatusline 0.4.0 → 0.4.1

package/README.md

@@ -101,66 +101,20 @@ cxstatusline
 The bare command opens the configuration TUI in an interactive terminal. Choose widgets, colors
 and themes, preview, then save explicitly or press Ctrl+S. Settings live at
 `~/.config/cxstatusline/settings.json` (or your XDG config location).
-Claude-only widgets without a Codex data source are not included; see the widget inventory in the
-project notes for the full list and reasons.
 
 For scripts, `cxstatusline render` reads a versioned JSON payload on stdin and prints ANSI rows;
 it never opens the TUI.
 
-## Custom widgets
-
-Three widgets show your own content, with the same settings fields as ccstatusline so presets import unchanged:
-
-| Widget | Field | Shows |
-|---|---|---|
-| Custom Text | `customText` | A fixed label such as `[PROD]` |
-| Custom Symbol | `customSymbol` | One glyph or emoji such as `⚡` |
-| Custom Command | `commandPath` | The first line a shell command prints |
-
-### Custom Command execution and caching
-
-Custom Command runs `commandPath` through your shell (`/bin/sh -c`) with Codex's environment, in
-the session's working directory. It receives the Codex status payload as JSON on stdin plus `terminal_width`.
-Only the first non-empty line is shown; stderr is discarded. Set `preserveColors` (key `p`) to keep
-the command's own colour codes; other escape sequences and control characters are always removed. Configured
-background colours apply in both render modes and survive resets within the command output. `maxWidth`
-(key `w`) truncates with an ellipsis. The TUI preview never runs commands. Imported presets list their
-commands before you confirm.
-
-#### Synchronous execution (default)
-
-When `refreshMs` is unset (or `0`), commands run synchronously on **every footer redraw** (up to five
-times a second while Codex streams).
-
-Codex kills the whole statusline renderer after one second and keeps the previous frame, so
-cxstatusline caps each synchronous command at **300 ms by default, 600 ms maximum** (`timeout`, editor key
-`t`), and all commands on a render share a 600 ms budget. Over budget shows `[Budget]`; a slow
-command shows `[Timeout]`, a failing one `[Exit: N]` or `[Cmd not found]`. Commands terminated by
-external signals before the deadline report `[Signal: <name>]` rather than `[Timeout]`. Keep synchronous
-commands cheap and local: `git status -s | wc -l` and `date +%H:%M` are good fits; network calls are not.
-
-#### Background caching (`refreshMs`)
-
-For commands that take longer or should not run on every redraw, configure `refreshMs` (key `f`).
-
-- **Background refresh:** When `refreshMs` is set, rendering reads the latest result from disk and never
-  blocks the statusline or consumes renderer timeout budget. When an entry is due for an update,
-  cxstatusline spawns a detached background process to refresh it; the refresh outlives the render.
-- **Cold start:** On the very first render before the initial background run completes, the widget shows
-  `[Loading]`.
-- **Failures and timeouts:** A failing background command caches its exit code or error token; if a
-  background refresh stays outstanding or fails beyond 60 seconds, the widget settles on `[Error]` and
-  keeps showing `[Error]` across subsequent renders until a refresh succeeds.
-- **Cache location:** Cached documents live under `~/.cache/cxstatusline/commands/` (or
-  `$XDG_CACHE_HOME/cxstatusline/commands/`). Deleting this cache directory at any time is completely
-  safe; entries are re-created automatically.
-- **Eviction:** Cache entries and temporary files expire and are automatically evicted after 7 days.
-- **Session sharing constraint:** The cache key is derived from `(command, cwd)`, so every Codex
-  session running in the same working directory shares one cache entry and one payload (the payload
-  written by whichever session triggered the refresh). `refreshMs` is intended for commands whose
-  output does not depend on specific session payload details.
-- **Pipeline processes:** As with synchronous mode, `shell: true` terminates `/bin/sh` on timeout,
-  so child processes spawned inside a shell pipeline can outlive the cap. Avoid long-running pipelines.
+## Widgets
+
+34 widgets: model and thinking effort, Git branch and changes, context and token counts, token speed,
+weekly usage and reset, session clock and name, working directory, terminal width, memory, plus three
+custom widgets that show your own text, symbol, or the output of a shell command.
+
+Type IDs match ccstatusline's, so a ccstatusline preset imports without translation.
+
+👉 The full catalog, and how Custom Command handles timeouts, colours and background caching, are in
+the **[Usage guide](docs/usage.md)**.
 
 ## Update
 

package/dist/cxstatusline.js

@@ -55203,6 +55203,47 @@ class GitBranchWidget {
     return true;
   }
 }
+// src/utils/git.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+function parseDiffShortStat(stat) {
+  const insertMatch = /(\d+)\s+insertions?/.exec(stat);
+  const deleteMatch = /(\d+)\s+deletions?/.exec(stat);
+  return {
+    additions: insertMatch?.[1] ? parseInt(insertMatch[1], 10) : 0,
+    deletions: deleteMatch?.[1] ? parseInt(deleteMatch[1], 10) : 0
+  };
+}
+var defaultGitRunner = (args, cwd2) => {
+  const result2 = spawnSync2("git", args, {
+    cwd: cwd2,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"],
+    timeout: 300,
+    env: { ...process.env, GIT_OPTIONAL_LOCKS: "0" },
+    windowsHide: true
+  });
+  if (result2.error || result2.status !== 0) {
+    throw result2.error ?? new Error(`git exited with status ${result2.status}`);
+  }
+  return result2.stdout ?? "";
+};
+function getGitDiffChanges(cwd2, runner = defaultGitRunner) {
+  if (!cwd2)
+    return null;
+  try {
+    const unstaged = runner(["diff", "--no-ext-diff", "--shortstat"], cwd2);
+    const staged = runner(["diff", "--cached", "--no-ext-diff", "--shortstat"], cwd2);
+    const unstagedCounts = parseDiffShortStat(unstaged);
+    const stagedCounts = parseDiffShortStat(staged);
+    return {
+      additions: unstagedCounts.additions + stagedCounts.additions,
+      deletions: unstagedCounts.deletions + stagedCounts.deletions
+    };
+  } catch {
+    return null;
+  }
+}
+
 // src/widgets/GitChanges.ts
 class GitChangesWidget {
   getDefaultColor() {
@@ -55226,7 +55267,10 @@ class GitChangesWidget {
   render(item, context, _settings) {
     if (context.isPreview)
       return "(+42,-10)";
-    const changes2 = context.data.git?.changes;
+    const cwd2 = context.data.session?.cwd ?? context.data.session?.project_root;
+    const shouldCheckLive = Boolean(context.commandCacheDir || context.liveGit || !context.data.git?.changes);
+    const liveChanges = shouldCheckLive ? getGitDiffChanges(cwd2) : null;
+    const changes2 = liveChanges ?? context.data.git?.changes;
     if (!changes2)
       return isHideStateEnabled(item, NO_GIT_HIDEABLE_STATE) ? null : "(no git)";
     return "(+" + changes2.additions + ",-" + changes2.deletions + ")";
@@ -58152,19 +58196,19 @@ function runRefreshCommand(cacheKey2, deps) {
   return 0;
 }
 // src/version-info.ts
-var VERSION = "0.4.0";
-var SOURCE_COMMIT = /^[0-9a-f]{40}$/.test("d65580953bb20c0d4c11c817bb55070de49c66e3") ? "d65580953bb20c0d4c11c817bb55070de49c66e3" : null;
+var VERSION = "0.4.1";
+var SOURCE_COMMIT = /^[0-9a-f]{40}$/.test("d5cfa7430d7fdb52a032c51c289131d04f714dd4") ? "d5cfa7430d7fdb52a032c51c289131d04f714dd4" : null;
 var SOURCE_DIRTY = false;
 
 // src/context.ts
 import { existsSync as existsSync3, realpathSync } from "node:fs";
-import { spawnSync as spawnSync3 } from "node:child_process";
+import { spawnSync as spawnSync4 } from "node:child_process";
 import { dirname as dirname5, join as join7 } from "node:path";
 
 // src/patch/preflight.ts
 import { accessSync, constants as constants2, existsSync as existsSync2, statfsSync } from "node:fs";
 import { dirname as dirname4, join as join6 } from "node:path";
-import { spawnSync as spawnSync2 } from "node:child_process";
+import { spawnSync as spawnSync3 } from "node:child_process";
 var MIN_FREE_BYTES = 20 * 1024 ** 3;
 var MIN_STAGING_FREE_BYTES = 2 * 1024 ** 3;
 var REQUIRED_TOOLCHAIN = "1.95.0";
@@ -58246,7 +58290,7 @@ function realDeps() {
   return {
     which: whichReal,
     run: (cmd, args, opts) => {
-      const r = spawnSync2(cmd, args, { encoding: "utf8", cwd: opts?.cwd });
+      const r = spawnSync3(cmd, args, { encoding: "utf8", cwd: opts?.cwd });
       return { status: r.status, stdout: r.stdout ?? "", stderr: r.stderr ?? "" };
     },
     freeBytes: (path) => {
@@ -58268,7 +58312,7 @@ function realContext(env3, io) {
   const sccache = deps.which("sccache");
   const run = (cmd, args, opts) => {
     const baseEnv = opts?.env ? { ...process.env, ...opts.env } : process.env;
-    const r = spawnSync3(cmd, args, {
+    const r = spawnSync4(cmd, args, {
       encoding: "utf8",
       cwd: opts?.cwd,
       stdio: opts?.interactive ? "inherit" : "pipe",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cxstatusline",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Customizable statusline for OpenAI Codex CLI",
   "license": "MIT",
   "repository": {