@buildinternet/releases 0.40.1 → 0.42.0

package/README.md

@@ -6,7 +6,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![skills.sh](https://skills.sh/b/buildinternet/releases-cli)](https://skills.sh/buildinternet/releases-cli)
 
-Changelog registry for AI agents and developers. A lean HTTP client for [releases.sh](https://releases.sh) — search and browse release notes from GitHub, RSS/Atom/JSON feeds, and product changelog pages without any local infrastructure.
+The changelog & release-notes registry for developers and AI agents. A lean HTTP client for [releases.sh](https://releases.sh) — search and browse release notes from GitHub, RSS/Atom/JSON feeds, and product changelog pages without any local infrastructure.
 
 The CLI talks to the hosted registry at `api.releases.sh`. Reader commands work out of the box with no configuration.
 
@@ -48,7 +48,7 @@ Every version publishes signed archives for each platform on the [Releases page]
 
 ### Shell completion
 
-Once the matching tap formula update rolls out, Homebrew will install bash, zsh, and fish completions automatically. Until then, and for all non-Homebrew install paths, run:
+**Homebrew installs bash, zsh, and fish completions automatically** — nothing extra to do. For every other install path (npm, the `curl | bash` installer, and the raw GitHub binaries), enable completions once:
 
 ```bash
 releases completion install          # auto-detects $SHELL
@@ -61,7 +61,7 @@ releases completion install zsh      # or pick explicitly
 releases completion zsh > /path/to/_releases
 ```
 
-Set `RELEASES_NO_COMPLETION_HINT=1` to silence the first-run completion hint.
+On an interactive terminal, a persistent, self-resolving notice on the landing screen and `--help` reminds you to run this until shell completion is detected — and stops on its own once completions are set up (including the automatic Homebrew install). Set `RELEASES_NO_COMPLETION_HINT=1` to silence it.
 
 ## Usage
 
@@ -190,6 +190,7 @@ Nothing is required for reader access. For admin operations (closed beta — see
 - `RELEASED_API_URL` — Override the default `https://api.releases.sh` endpoint (useful for staging).
 - `RELEASED_TELEMETRY_DISABLED=1` — Opt out of anonymous usage pings. `DO_NOT_TRACK=1` is also honored.
 - `RELEASES_DISABLE_SKILL_UPDATE_CHECK=1` — Silence the "skills are behind, run `releases skills install`" stderr nag that fires (at most once per 24h) when the GitHub `skills/` tree has moved since your last install.
+- `RELEASES_RUN_DIR` — When set, every `releases admin …` write appends one JSONL line (`{timestamp, command, target, result}`) to `$RELEASES_RUN_DIR/mutations.jsonl` — an audit trail for agent-driven maintenance batches. Unset → no-op. Also the default destination for managed-session traces (`--trace-dir` / `--save` override it). Part of the `~/.releases/work/` maintenance workspace.
 
 Copy `.env.example` to `.env` to configure these locally.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@buildinternet/releases",
-  "version": "0.40.1",
-  "description": "Changelog indexer and registry for AI agents and developers",
+  "version": "0.42.0",
+  "description": "The changelog & release-notes registry for developers and AI agents",
   "bin": {
     "releases": "bin/releases"
   },
@@ -13,11 +13,11 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "@buildinternet/releases-darwin-arm64": "0.40.1",
-    "@buildinternet/releases-darwin-x64": "0.40.1",
-    "@buildinternet/releases-linux-x64": "0.40.1",
-    "@buildinternet/releases-linux-arm64": "0.40.1",
-    "@buildinternet/releases-windows-x64": "0.40.1"
+    "@buildinternet/releases-darwin-arm64": "0.42.0",
+    "@buildinternet/releases-darwin-x64": "0.42.0",
+    "@buildinternet/releases-linux-x64": "0.42.0",
+    "@buildinternet/releases-linux-arm64": "0.42.0",
+    "@buildinternet/releases-windows-x64": "0.42.0"
   },
   "keywords": [
     "changelog",