yeelight-home 0.1.4 → 0.1.6

package/DISTRIBUTION.md

@@ -7,7 +7,7 @@
 | Channel | GoReleaser role | User install path |
 | --- | --- | --- |
 | GitHub Releases | Primary release target for archives, installers, checksums, SBOMs, packages, and metadata. | `curl -fsSL https://github.com/Yeelight/yeelight-home/releases/latest/download/install.sh \| sh` |
-| Homebrew tap | Updates cask metadata in `Yeelight/homebrew-tap`. | `brew install Yeelight/tap/yeelight-home` |
+| Homebrew tap | Updates Formula compatibility metadata and Cask metadata in `Yeelight/homebrew-tap`. | `brew install Yeelight/tap/yeelight-home` |
 | Scoop bucket | Updates manifest metadata in `Yeelight/scoop-bucket`. | `scoop bucket add yeelight https://github.com/Yeelight/scoop-bucket && scoop install yeelight-home` |
 | npm wrapper | Publishes the launcher package after GoReleaser assets exist. | `npm install -g yeelight-home` |
 | Linux packages | Builds `.deb`, `.rpm`, `.apk`, and Arch package artifacts through nFPM. | Download package assets from GitHub Releases. |
@@ -15,7 +15,7 @@
 | AUR | Publishes `yeelight-home-bin` only when AUR SSH is configured. | `yay -S yeelight-home-bin` after publication. |
 | Snap | Builds/publishes only when Snapcraft credentials and store review are ready. | `sudo snap install yeelight-home` after store visibility. |
 | Docker GHCR | Publishes multi-arch images when registry credentials are available. | `docker run --rm ghcr.io/yeelight/yeelight-home:latest version` |
-| Docker Hub | Publishes multi-arch images when Docker Hub credentials are available. | `docker run --rm yeelight/yeelight-home:latest version` |
+| Docker Hub | Publishes multi-arch images when Docker Hub credentials are available. | `docker run --rm yeelightdev/yeelight-home:latest version` |
 | pkg.go.dev | Indexes public `v*` module tags. | `https://pkg.go.dev/github.com/yeelight/yeelight-home` |
 
 ## Repository Layout Policy
@@ -41,7 +41,7 @@ Reasoning:
 - It aligns with Go CLI user expectations and improves discoverability through package managers.
 - It still does not remove external gates: Winget review, AUR account/SSH, Snapcraft credentials, Docker Hub credentials, and Homebrew/Scoop write tokens are still required.
 - The public workflow automatically skips channels whose secrets are not configured, so optional channels do not block core GitHub Release assets, checksums, install scripts, npm wrapper assets and Linux package assets.
-- GoReleaser v2.16 marks Homebrew formula generation as deprecated. New automation uses Homebrew Casks; the existing Formula entry can remain as a compatibility install path if already published.
+- GoReleaser v2.16 marks Homebrew formula generation as deprecated. New automation still updates the Formula compatibility path because many users install with `brew install Yeelight/tap/yeelight-home`; it also publishes the Cask path for the recommended newer Homebrew metadata model.
 
 Scope:
 
@@ -107,14 +107,14 @@ Target artifacts:
   - `.apk`
   - Arch package artifact
 - Package-manager manifests:
-  - Homebrew cask in `Yeelight/homebrew-tap`
+  - Homebrew Formula and Cask in `Yeelight/homebrew-tap`
   - Scoop manifest in `Yeelight/scoop-bucket`
   - Winget manifest or PR flow once enabled
   - AUR `yeelight-home-bin` once AUR SSH is configured
   - Snap package once Snapcraft is configured
 - Container images:
   - `ghcr.io/yeelight/yeelight-home`
-  - `yeelight/yeelight-home`
+  - `yeelightdev/yeelight-home`
 
 ## Required Release Settings
 
@@ -130,6 +130,7 @@ GitHub Actions provides `GITHUB_TOKEN` automatically for GitHub Releases and GHC
 | `AUR_KEY` | AUR SSH private key for `yeelight-home-bin`. |
 | `SNAPCRAFT_STORE_CREDENTIALS` | Snap store publish credentials. |
 | `WINGET_GITHUB_TOKEN` | Winget manifest PR token. |
+| `YEELIGHT_HOME_RELEASE_TOKEN` | Push runtime mirror snapshots to `Yeelight/yeelight-home`. |
 
 | Repository Variable | Purpose |
 | --- | --- |
@@ -137,9 +138,20 @@ GitHub Actions provides `GITHUB_TOKEN` automatically for GitHub Releases and GHC
 | `WINGET_REPOSITORY_NAME` | Winget PR workspace fork name. |
 | `WINGET_REPOSITORY_BRANCH` | Optional Winget PR branch. Defaults to a release-specific branch. |
 | `AUR_GIT_URL` | Optional AUR Git URL override. Defaults to `ssh://aur@aur.archlinux.org/yeelight-home-bin.git`. |
+| `DOCKERHUB_IMAGE` | Optional Docker Hub image override. Defaults to `<DOCKERHUB_USERNAME>/yeelight-home`. |
 
 Only configure settings for channels that are ready to publish.
 Without Winget token and PR workspace variables, the public release workflow skips Winget and still publishes core GitHub Release artifacts.
+You can self-solve Winget by forking `microsoft/winget-pkgs` as the PR workspace and pointing the repository variables at that fork; no permanent Yeelight organization repository is required for Winget publication.
+Without `YEELIGHT_HOME_RELEASE_TOKEN`, the monorepo mirror workflow cannot push runtime-only source snapshots into the public repository.
+AUR is optional until the package repository and SSH key are available.
+Snapcraft is optional until a Linux or Ubuntu runner can execute the login/export flow and store publication.
+
+Reusable GitHub credential pattern:
+
+- One GitHub PAT can be reused for `YEELIGHT_HOME_RELEASE_TOKEN`, `HOMEBREW_TAP_GITHUB_TOKEN`, `SCOOP_BUCKET_GITHUB_TOKEN`, and `WINGET_GITHUB_TOKEN` if it has write access to the target repos or PR workspace.
+- `YEELIGHT_HOME_RELEASE_TOKEN` only needs write access to `Yeelight/yeelight-home`.
+- The package-manager tokens only need write access to their own target repositories or PR workspace.
 
 ## npm Package Model
 

package/INSTALL.md

@@ -182,7 +182,7 @@ docker run --rm ghcr.io/yeelight/yeelight-home:latest version
 Docker Hub:
 
 ```sh
-docker run --rm yeelight/yeelight-home:latest version
+docker run --rm yeelightdev/yeelight-home:latest version
 ```
 
 Persist local config and credentials:

package/README.md

@@ -216,7 +216,7 @@ One tagged public `v*` release can produce:
 
 - macOS, Linux, Windows archives for `amd64`, `arm64`, and Linux `armv7`.
 - Checksums and release metadata.
-- Homebrew tap cask automation, with existing Formula compatibility where already published.
+- Homebrew tap Formula compatibility and Cask automation.
 - Scoop bucket manifest.
 - Linux packages through nFPM: `.deb`, `.rpm`, `.apk`, and Arch package artifacts.
 - Docker/GHCR and Docker Hub multi-arch images.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yeelight-home",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Local Yeelight Home Runtime CLI installer and launcher.",
   "license": "UNLICENSED",
   "homepage": "https://github.com/Yeelight/yeelight-home#readme",