higherdata 0.3.0 → 0.4.0

package/README.md

@@ -213,9 +213,8 @@ Formats follow the current [Claude Code MCP](https://code.claude.com/docs/en/mcp
 ## Compatibility
 
 The CLI reads public `/api/v1/meta` once per day per API origin and caches the
-policy beside its config file. Updates are announced on stderr so JSON output
-stays machine-readable. Versions below the server's minimum refuse commands
-with `npm install --global higherdata@latest` as the upgrade command. `login`,
+policy beside its config file. Update notices are written to stderr only during interactive invocations.
+Versions below the server's minimum refuse commands and suggest `higherdata update`. `update`, `login`,
 `--help` and `--version` remain available without a compatibility check.
 
 The metadata request times out after three seconds. On network failure the CLI
@@ -224,3 +223,31 @@ checks are cached for a day too. A read-only cache directory allows commands but
 cannot persist the daily check, so subsequent invocations may check again.
 
 Download the loaded search page to a new file with `higherdata search companies --country-code CA --out results.csv`. Add `--all` to download up to 5,000 rows, or use a `.jsonl` destination for JSON Lines. The interactive results screen offers "This page" and "All results" when you press `d`. For larger sets, save the search to a list and export the list. Existing files are never overwritten.
+
+## Updates
+
+Run `higherdata update` (alias `higherdata upgrade`) to check npm and install the
+latest stable release. The CLI installs the exact version it checked and prints
+the old and new versions. A permission failure prints npm's error summary and
+the manual command. It never retries with sudo.
+
+Interactive npm global installs check npm on every run with a 1.5-second timeout, then
+automatically install a newer release and restart the same command with the
+same arguments. Failed installs print a manual command and continue on the
+current version. Timeouts and network failures continue silently. There is no
+cache for this npm release check.
+
+Automatic updates are skipped when either stdin or stdout is not a TTY, `CI`
+is set, `--json` or `--jsonl` is used, for MCP or stdio protocols, and for `npx`
+or non-global installs. To opt out for an invocation, set
+`HIGHERDATA_NO_AUTO_UPDATE=1`. To persist the preference, run:
+
+```sh
+higherdata config set auto-update false
+# Re-enable automatic updates
+higherdata config set auto-update true
+```
+
+Explicit `higherdata update` remains available with an opt-out or a server
+minimum-version refusal. Users on 0.3.0 must reinstall once to obtain the update
+command: `npm install --global higherdata@latest`.