@xerg/cli 0.5.1 → 0.5.3

package/README.md

@@ -1,6 +1,6 @@
 # xerg
 
-Audit OpenClaw and Hermes workflows in dollars, compare fixes, and optionally connect hosted follow-up after the first local result.
+Audit OpenClaw, Hermes, and Cursor spend in dollars, surface provenance-aware waste findings, compare fixes, and optionally connect hosted follow-up after the first local result.
 
 Xerg runs locally by default. Local audits and `--compare` are free. No account is required for local value, and no data leaves your machine unless you explicitly push results to Xerg Cloud.
 
@@ -16,7 +16,7 @@ npx @xerg/cli init
 
 - detects local OpenClaw or Hermes data
 - runs a first audit and stores the local snapshot
-- prints the standard terminal summary
+- prints the provenance-aware terminal summary
 - offers optional hosted follow-up with `connect` and `mcp-setup`
 
 Prefer a global install?
@@ -34,6 +34,7 @@ If you already know what you want, skip `init` and use the direct flows:
 npx @xerg/cli doctor
 npx @xerg/cli audit
 npx @xerg/cli audit --compare
+npx @xerg/cli audit --cursor-usage-csv ./cursor-usage.csv
 npx @xerg/cli audit --json
 npx @xerg/cli audit --markdown
 ```
@@ -109,7 +110,7 @@ xerg push
 
 ## Works where your agent data lives
 
-- Local machine: yes
+- Local machine: OpenClaw, Hermes, and explicit Cursor usage CSV exports
 - VPS or remote server: OpenClaw only in this phase
 - If OpenClaw runs remotely, you can audit it from your local machine with `xerg audit --remote user@host`
 - Or point Xerg at exported files directly with flags
@@ -135,6 +136,7 @@ xerg audit --runtime openclaw --log-file /path/to/openclaw.log
 xerg audit --runtime openclaw --sessions-dir /path/to/sessions
 xerg audit --runtime hermes --log-file ~/.hermes/logs/agent.log
 xerg audit --runtime hermes --sessions-dir ~/.hermes/sessions
+xerg audit --cursor-usage-csv ./cursor-usage.csv
 ```
 
 If only one supported local runtime is present, Xerg auto-selects it. If both OpenClaw and Hermes are present locally, rerun with `--runtime openclaw` or `--runtime hermes`.
@@ -191,10 +193,13 @@ Example `~/.xerg/config.json`:
 - Total spend by workflow and model, in dollars
 - Daily spend and confirmed waste rollups in UTC
 - Observed vs. estimated cost (always labeled)
-- Confirmed waste: retry, loop, cache carryover where applicable
+- Confirmed waste: retry and loop findings when the required source structure is present
+- Provenance-aware waste rollups by observed, inferred, declared, or unknown signal source
 - Savings opportunities: context bloat, downgrade candidates, idle, max mode concentration where applicable
 - Ranked recommendations with where-to-change guidance and compare validation steps
-- Before/after deltas on re-audit
+- Before/after normalized rates on re-audit, including waste per run and waste per 1k calls
+
+Local JSON findings may include `signalSource`, `ruleId`, and evidence references so agents can distinguish observed signals from inferred or legacy unknown provenance. These local provenance fields are not part of the pushed v2 wire payload.
 
 ## Privacy
 
@@ -209,7 +214,7 @@ Xerg v0 stores economic metadata and audit summaries locally. It does not store
 
 ## Troubleshooting
 
-- `better-sqlite3` is a native dependency. If install fails, retry on a supported Node version and make sure standard native build tooling is available for your platform.
+- If install fails with an unsupported engine warning, retry with Node 22 or 24.
 - `xerg init` is interactive in v1. Use direct `doctor` / `audit` commands when you need non-interactive control.
 - `--verbose` prints progress updates to stderr for `xerg doctor` and `xerg audit`, which helps distinguish package install time from CLI runtime.
 - If `xerg audit --remote ...` fails before pulling files, verify that both `ssh` and `rsync` are installed and reachable on your `PATH`.

package/dist/browser.js

@@ -0,0 +1,3 @@
+// src/browser.ts
+throw new Error("@xerg/cli is a Node.js CLI and cannot run in browser bundles.");
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser.ts"],"sourcesContent":["throw new Error('@xerg/cli is a Node.js CLI and cannot run in browser bundles.');\n"],"mappings":";AAAA,MAAM,IAAI,MAAM,+DAA+D;","names":[]}