@ivan-murzak/runner-manager-linux-x64 0.0.0-bootstrap.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ivan Murzak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,9 +1,102 @@
-# @ivan-murzak/runner-manager-linux-x64
+# @ivan-murzak/runner-manager (npm wrapper)
 
-Placeholder. This version exists only so that npm trusted publishing can be configured for
-this package name; npm cannot attach a trusted publisher to a package that does not exist.
+Local-first autoscaling manager for ephemeral GitHub Actions self-hosted
+runners, with a CLI and a Ratatui TUI.
 
-It carries no binary and is published under the `bootstrap` dist-tag, so it is not what
-`npm install` resolves. The first real release replaces it.
+> **Read this before you install.** Using this tool means installing the
+> project's published GitHub App, which declares **Repository → Administration:
+> Read and write** — a permission that also allows deleting, renaming and
+> transferring the repository, and adding or removing collaborators. It applies
+> even if you only ever use `runner-manager` as a read-only dashboard. The full
+> permission set and the narrower organization-scoped alternative are in
+> [What you are granting](#what-you-are-granting) below.
 
-Project: <https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI>
+```sh
+npm i -g @ivan-murzak/runner-manager
+runner-manager --version
+```
+
+This package is a thin wrapper. The binary itself lives in one of five
+per-platform packages, declared here as `optionalDependencies`, so npm installs
+only the one that matches your OS and CPU:
+
+| Platform package | os / cpu | Rust target |
+|---|---|---|
+| `@ivan-murzak/runner-manager-win32-x64` | `win32` / `x64` | `x86_64-pc-windows-msvc` |
+| `@ivan-murzak/runner-manager-darwin-arm64` | `darwin` / `arm64` | `aarch64-apple-darwin` |
+| `@ivan-murzak/runner-manager-darwin-x64` | `darwin` / `x64` | `x86_64-apple-darwin` |
+| `@ivan-murzak/runner-manager-linux-x64` | `linux` / `x64` | `x86_64-unknown-linux-gnu` |
+| `@ivan-murzak/runner-manager-linux-arm64` | `linux` / `arm64` | `aarch64-unknown-linux-gnu` |
+
+Each platform package records, in its `package.json`, the release archive its
+binary was taken from and that archive's published SHA-256 — the same digest
+listed in the release's `SHA256SUMS`.
+
+## Read this before `service install`
+
+**An `npm i -g` binary does not have a fixed home, and this product records an
+absolute path.**
+
+`npm i -g` installs into the *active* Node installation's global prefix. If you
+manage Node with `nvm`, `fnm`, `volta`, `asdf`, Homebrew, or a Windows
+installer upgrade, that prefix is different for every Node version — something
+like:
+
+```text
+~/.nvm/versions/node/v20.11.0/bin/runner-manager
+~/.nvm/versions/node/v22.3.0/bin/runner-manager      <- after `nvm install 22`
+```
+
+`runner-manager service install` resolves and records the **absolute** path of
+the binary at the moment you run it. So switching Node versions after
+installing the service leaves the service pointing at a path that no longer
+exists, and nothing tells you until the next unattended boot, when the agent
+does not come up.
+
+`runner-manager service status` detects this and reports the recorded path as
+**stale** rather than reporting the service as healthy. If you see that:
+
+```sh
+npm i -g @ivan-murzak/runner-manager   # into the Node version you are now using
+runner-manager service install        # re-records the new absolute path
+```
+
+**If you want a boot-start service, prefer the install script.** It installs to
+`~/.local/bin` (macOS, Linux) or `%LOCALAPPDATA%\Programs\runner-manager`
+(Windows), neither of which moves when a toolchain moves:
+
+```sh
+curl -fsSL https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI/releases/latest/download/install.sh | sh
+```
+
+```powershell
+irm https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI/releases/latest/download/install.ps1 | iex
+```
+
+This package is the right choice when you already manage tooling with npm and
+you run `runner-manager` interactively or from a script, rather than as a
+boot-start service.
+
+## Windows on ARM
+
+npm will not install an `"cpu": ["x64"]` package onto an arm64 host, and no
+arm64 Windows build is published, so this package cannot serve Windows on ARM.
+The install script can: it uses the x64 build through the built-in emulation
+layer.
+
+## What you are granting
+
+Using this tool means installing the project's published GitHub App, and that
+App declares **Repository → Administration: Read and write**. That permission
+also allows deleting, renaming and transferring the repository, and adding or
+removing collaborators. It applies even if you only ever use `runner-manager`
+as a read-only dashboard.
+
+The full permission table, why the grant is unavoidable at repository scope,
+and why organization scope is materially narrower are in the
+[repository README](https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI#what-you-are-granting).
+Read it before you run `auth login`.
+
+## Licence
+
+MIT. Source: <https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI>

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@ivan-murzak/runner-manager-linux-x64",
-  "version": "0.0.0-bootstrap.1",
-  "description": "Placeholder so trusted publishing can be configured. Not a release; see the repository.",
+  "version": "0.1.3",
+  "description": "The x86_64-unknown-linux-gnu binary for runner-manager.",
   "license": "MIT",
   "author": "Ivan Murzak (https://github.com/IvanMurzak)",
   "homepage": "https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI",
   "repository": { "type": "git", "url": "git+https://github.com/IvanMurzak/GitHub-Runner-Scaler-UI.git" },
-  "files": [ "README.md" ]
+  "os": [ "linux" ],
+  "cpu": [ "x64" ],
+  "files": [ "bin/" ],
+  "runnerManager": {
+    "target": "x86_64-unknown-linux-gnu",
+    "binary": "runner-manager",
+    "asset": "runner-manager-0.1.3-x86_64-unknown-linux-gnu.tar.gz",
+    "sha256": "836730dd3e477b5b9625f3efd0cba3279f1c4acd4bd5deff123bbd4bb63e429a"
+  }
 }