@buildinternet/releases 0.41.0 → 0.43.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -9
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
[](./LICENSE)
|
|
7
7
|
[](https://skills.sh/buildinternet/releases-cli)
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
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.
|
|
10
10
|
|
|
11
11
|
The CLI talks to the hosted registry at `api.releases.sh`. Reader commands work out of the box with no configuration.
|
|
12
12
|
|
|
@@ -40,7 +40,7 @@ Always include the `@latest` tag — bare `npx @buildinternet/releases` caches t
|
|
|
40
40
|
curl -fsSL https://releases.sh/install | bash
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
Downloads the matching platform binary from npm. Respects `
|
|
43
|
+
Downloads the matching platform binary from npm. Respects `RELEASES_INSTALL_DIR` (default: `/usr/local/bin`). Windows users should use npm or the GitHub Releases archive below.
|
|
44
44
|
|
|
45
45
|
### Precompiled binaries (GitHub Releases)
|
|
46
46
|
|
|
@@ -48,7 +48,7 @@ Every version publishes signed archives for each platform on the [Releases page]
|
|
|
48
48
|
|
|
49
49
|
### Shell completion
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
**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:
|
|
52
52
|
|
|
53
53
|
```bash
|
|
54
54
|
releases completion install # auto-detects $SHELL
|
|
@@ -61,7 +61,7 @@ releases completion install zsh # or pick explicitly
|
|
|
61
61
|
releases completion zsh > /path/to/_releases
|
|
62
62
|
```
|
|
63
63
|
|
|
64
|
-
Set `RELEASES_NO_COMPLETION_HINT=1` to silence
|
|
64
|
+
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.
|
|
65
65
|
|
|
66
66
|
## Usage
|
|
67
67
|
|
|
@@ -158,7 +158,7 @@ Use this path when you only want the skill behavior (auto-triggering on release/
|
|
|
158
158
|
|
|
159
159
|
## Authentication
|
|
160
160
|
|
|
161
|
-
Admin commands require an API token. You can store one persistently using the `auth` command namespace so you don't need to set `
|
|
161
|
+
Admin commands require an API token. You can store one persistently using the `auth` command namespace so you don't need to set `RELEASES_API_KEY` in your shell every time.
|
|
162
162
|
|
|
163
163
|
```bash
|
|
164
164
|
releases auth login # interactive prompt (masked input)
|
|
@@ -178,7 +178,7 @@ releases auth logout # remove the stored token
|
|
|
178
178
|
|
|
179
179
|
`whoami` is an alias for `auth status`.
|
|
180
180
|
|
|
181
|
-
**Credential precedence:** if `
|
|
181
|
+
**Credential precedence:** if `RELEASES_API_KEY` is set in the environment it takes priority over any stored credential — useful for CI or per-command overrides.
|
|
182
182
|
|
|
183
183
|
**Storage:** credentials are written to `~/.releases/credentials` with `0600` permissions (owner read/write, rw-------). The file is JSON and contains the token, name, scopes, the API URL the token was verified against, and a `savedAt` timestamp.
|
|
184
184
|
|
|
@@ -186,9 +186,9 @@ releases auth logout # remove the stored token
|
|
|
186
186
|
|
|
187
187
|
Nothing is required for reader access. For admin operations (closed beta — see above):
|
|
188
188
|
|
|
189
|
-
- `
|
|
190
|
-
- `
|
|
191
|
-
- `
|
|
189
|
+
- `RELEASES_API_KEY` — Bearer token for write endpoints. Overrides any stored credential from `releases auth login`. Required for any `releases admin …` command that mutates state if no stored credential is present. Keys are not self-serve right now.
|
|
190
|
+
- `RELEASES_API_URL` — Override the default `https://api.releases.sh` endpoint (useful for staging).
|
|
191
|
+
- `RELEASES_TELEMETRY_DISABLED=1` — Opt out of anonymous usage pings. `DO_NOT_TRACK=1` is also honored.
|
|
192
192
|
- `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.
|
|
193
193
|
- `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.
|
|
194
194
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@buildinternet/releases",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.43.0",
|
|
4
|
+
"description": "The changelog & release-notes registry for developers and AI agents",
|
|
5
5
|
"bin": {
|
|
6
6
|
"releases": "bin/releases"
|
|
7
7
|
},
|
|
@@ -13,11 +13,11 @@
|
|
|
13
13
|
"README.md"
|
|
14
14
|
],
|
|
15
15
|
"optionalDependencies": {
|
|
16
|
-
"@buildinternet/releases-darwin-arm64": "0.
|
|
17
|
-
"@buildinternet/releases-darwin-x64": "0.
|
|
18
|
-
"@buildinternet/releases-linux-x64": "0.
|
|
19
|
-
"@buildinternet/releases-linux-arm64": "0.
|
|
20
|
-
"@buildinternet/releases-windows-x64": "0.
|
|
16
|
+
"@buildinternet/releases-darwin-arm64": "0.43.0",
|
|
17
|
+
"@buildinternet/releases-darwin-x64": "0.43.0",
|
|
18
|
+
"@buildinternet/releases-linux-x64": "0.43.0",
|
|
19
|
+
"@buildinternet/releases-linux-arm64": "0.43.0",
|
|
20
|
+
"@buildinternet/releases-windows-x64": "0.43.0"
|
|
21
21
|
},
|
|
22
22
|
"keywords": [
|
|
23
23
|
"changelog",
|