@rom-weaver/cli 0.10.2 → 0.11.1

package/README.md

@@ -109,7 +109,7 @@ general speed claim.
   and the threaded WASM webapp, with line-delimited JSON output for scripting.
 
 The complete format, codec, and checksum compatibility tables are maintained
-in the [CLI guide](./docs/hosting/cli.md#supported-formats).
+in the [CLI guide](./docs/reference/formats.md).
 
 ## Notices
 
@@ -170,20 +170,42 @@ For a guided explanation, use
 [guided Apply](https://rom-weaver.com/apply?guide=apply),
 [guided Create](https://rom-weaver.com/create?guide=create), or
 [guided Bundle](https://rom-weaver.com/apply?guide=bundle).
+To run the webapp on your own host, see the
+[self-hosting guide](./docs/hosting/self-hosting.md) for the release tarball,
+Docker, and Docker Compose setups.
 
 <a name="self-host-the-webapp"></a>
 
 <details>
 <summary>Self-host the webapp</summary>
 
-The Docker source build serves the full webapp: it builds the WASM module, adds
-cross-origin isolation headers, supports client-side routes, and precompresses
-assets. The
-[self-hosting guide](./docs/hosting/self-hosting.md) covers reverse proxies, subpath
-routing, HTTPS certificates, service-worker scope, and the required COOP/COEP
-headers.
+For a quick setup, choose static files, Docker Run, or Docker Compose. The
+[full self-hosting guide](./docs/hosting/self-hosting.md) covers reverse proxies,
+subpath routing, HTTPS certificates, service-worker scope, and the required
+COOP/COEP headers.
 
-Build and start it with Docker Compose:
+Static release files:
+
+```bash
+mkdir -p rom-weaver-webapp
+curl --fail --location --proto '=https' --tlsv1.2 \
+  --output rom-weaver-webapp.tar.gz \
+  https://github.com/rom-weaver/rom-weaver/releases/latest/download/rom-weaver-webapp.tar.gz
+tar --extract --gzip --file rom-weaver-webapp.tar.gz --directory rom-weaver-webapp
+```
+
+Serve the extracted `rom-weaver-webapp` directory from an HTTPS static host.
+For a pinned release, replace `latest` in the URL with its tag.
+
+Docker Run:
+
+```bash
+docker run --detach --name rom-weaver-webapp \
+  --publish 8080:8080 \
+  ghcr.io/brandonocasey/rom-weaver-webapp:latest
+```
+
+Docker Compose, building from source:
 
 ```bash
 git clone https://github.com/rom-weaver/rom-weaver.git
@@ -230,6 +252,7 @@ scoop install rom-weaver
 
 Downloads the latest release to `~/.local/bin` and verifies its checksum.
 Override with `ROM_WEAVER_INSTALL_DIR` or pin with `ROM_WEAVER_VERSION`.
+The script also installs manpages and shell completions for the current user.
 
 ```bash
 curl --proto '=https' --tlsv1.2 -LsSf \
@@ -242,6 +265,7 @@ curl --proto '=https' --tlsv1.2 -LsSf \
 <summary>Install script (Windows)</summary>
 
 The same thing for PowerShell, installing to `%LOCALAPPDATA%\rom-weaver\bin`.
+It also installs the PowerShell completion beside the executable.
 
 ```powershell
 irm https://raw.githubusercontent.com/rom-weaver/rom-weaver/main/install.ps1 | iex
@@ -314,7 +338,7 @@ docker run --rm \
 Mount your ROM directory at `/work` and pass paths under it. `--user` matters:
 bind-mounted files keep their host ownership, so without it the container cannot
 read files it does not own and leaves anything it writes owned by an unknown uid.
-See [Run in Docker](./docs/hosting/cli.md#run-in-docker).
+See [Run in Docker](./docs/cli/install.md#run-in-docker).
 
 </details>
 
@@ -336,7 +360,7 @@ toolchain.
 </details>
 
 Hitting `Permission denied`? See
-[File permissions](./docs/hosting/cli.md#file-permissions).
+[File permissions](./docs/cli/reference.md#file-permissions).
 
 The [development guide](./docs/development/development.md) covers the full toolchain setup,
 webapp builds, and tests.