From 097d2afd7ad0f1941b8f51155535c1822b619c95 Mon Sep 17 00:00:00 2001 From: James Reilly Date: Fri, 20 Nov 2026 03:25:48 +0000 Subject: [PATCH 1/3] ci(lint): tighten the markdownlint budget to 966 and make the STE budget a ratchet The markdownlint budget had 534 findings of slack (1500 vs 966 with markdownlint-cli 0.49.1). Set it to the current count. The STE budget already matches its count (5); turn on the reusable workflow's ratchet mode so it stays exact. Co-Authored-By: Claude Opus 5.5 Signed-off-by: James Reilly --- .github/workflows/lint.yml | 9 ++++++++- .markdownlint-budget | 2 +- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index 1606b239..b0aaa3ab 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -17,6 +17,8 @@ name: Lint # used to report a no-op `Markdown Lint` on every other pull request. on: pull_request: + # labeled/unlabeled: the ste job's ratchet-raise label must re-run it. + types: [opened, synchronize, reopened, labeled, unlabeled] push: branches: [main] workflow_dispatch: @@ -228,7 +230,12 @@ jobs: # is reverted by the next sync, and the author is another repository), so # that prose is only ever checked where it is written. Same rules, applied # at the source. - uses: tuna-os/.github/.github/workflows/ste-lint.yml@4078f531ac74703f203bde835ef6c25e9321b97b # main # zizmor: ignore[ref-version-mismatch] pinned to a reviewed main commit; Renovate bumps the digest, so main may be ahead + uses: tuna-os/.github/.github/workflows/ste-lint.yml@8ecf20e5800fd80bde03d572ab1e3bbcb5b2cf17 # main # zizmor: ignore[ref-version-mismatch] pinned to a reviewed main commit; Renovate bumps the digest, so main may be ahead + # ratchet: the budget is exact. A count under it fails and names the new + # number for .ste-budget; a pull request that raises it needs the + # `ratchet-raise` label (labeled/unlabeled above re-run the check). + with: + ratchet: true link-check: needs: changes diff --git a/.markdownlint-budget b/.markdownlint-budget index 3d86ec64..0b8de634 100644 --- a/.markdownlint-budget +++ b/.markdownlint-budget @@ -1 +1 @@ -1500 +966 From b55f1f94729e2648dc3b02e0c735e1093b7017a3 Mon Sep 17 00:00:00 2001 From: James Reilly Date: Fri, 20 Nov 2026 03:45:04 +0000 Subject: [PATCH 2/3] ci(ste): pin ste-lint.yml to d9ad7fd so ratchet mode runs 8ecf20e's reusable workflow resolved the ste-lint action at an older locked commit, which ignored the ratchet input (tuna-os/.github#390). Co-Authored-By: Claude Opus 5.5 Signed-off-by: James Reilly --- .github/workflows/lint.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index b0aaa3ab..1c3c353e 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -230,7 +230,7 @@ jobs: # is reverted by the next sync, and the author is another repository), so # that prose is only ever checked where it is written. Same rules, applied # at the source. - uses: tuna-os/.github/.github/workflows/ste-lint.yml@8ecf20e5800fd80bde03d572ab1e3bbcb5b2cf17 # main # zizmor: ignore[ref-version-mismatch] pinned to a reviewed main commit; Renovate bumps the digest, so main may be ahead + uses: tuna-os/.github/.github/workflows/ste-lint.yml@d9ad7fd18176220c56fbf13a36eaf11de00c12a5 # main # zizmor: ignore[ref-version-mismatch] pinned to a reviewed main commit; Renovate bumps the digest, so main may be ahead # ratchet: the budget is exact. A count under it fails and names the new # number for .ste-budget; a pull request that raises it needs the # `ratchet-raise` label (labeled/unlabeled above re-run the check). From 9bb21ca032ae8d7e9a800583d3fb7df0b1e57b3f Mon Sep 17 00:00:00 2001 From: hanthor Date: Fri, 20 Nov 2026 03:51:30 +0000 Subject: [PATCH 3/3] docs(bluefin-cli): point Homebrew install at tuna-os/tap The formula is published in tuna-os/homebrew-tap; the ublue-os/homebrew-experimental-tap copy no longer exists, which turned the install-command check red on main and on this PR. Co-Authored-By: Claude Sonnet 5.5 Signed-off-by: hanthor --- docs/bluefin-cli/index.md | 17 +++-------------- docs/bluefin-cli/setup-linux.md | 2 +- docs/bluefin-cli/setup-macos.md | 2 +- 3 files changed, 5 insertions(+), 16 deletions(-) diff --git a/docs/bluefin-cli/index.md b/docs/bluefin-cli/index.md index 74439d58..d6d430d3 100644 --- a/docs/bluefin-cli/index.md +++ b/docs/bluefin-cli/index.md @@ -76,25 +76,14 @@ bluefin-cli shell powershell on ### Homebrew (Linux / macOS) -The preview formula is available from `ublue-os/homebrew-experimental-tap`, -synced from the source-build formula in -[`contrib/homebrew/bluefin-cli.rb`](https://github.com/tuna-os/bluefin-cli/blob/main/contrib/homebrew/bluefin-cli.rb): +The formula is published in [`tuna-os/homebrew-tap`](https://github.com/tuna-os/homebrew-tap), +built from the GoReleaser configuration on each release: ```bash -brew tap ublue-os/homebrew-experimental-tap +brew tap tuna-os/tap brew install bluefin-cli ``` -> **Status (2026-10-17):** use `ublue-os/homebrew-experimental-tap` above. -> The primary tap [`tuna-os/homebrew-tap`](https://github.com/tuna-os/homebrew-tap) -> is not available yet. The GoReleaser configuration includes the Homebrew -> publisher. It pushes to the tap with the `HOMEBREW_TAP_SSH_KEY` deploy key, -> but the team has not verified a publication yet -> ([#295](https://github.com/tuna-os/bluefin-cli/issues/295)). For maintainer -> key and setup details, see -> [`docs/release-publishing.md`](https://github.com/tuna-os/bluefin-cli/blob/main/docs/release-publishing.md). Once published, -> `brew tap tuna-os/tap && brew install bluefin-cli` will be the primary path. - ### Winget (Windows) ```powershell diff --git a/docs/bluefin-cli/setup-linux.md b/docs/bluefin-cli/setup-linux.md index 3b9bc1a7..dda38c40 100644 --- a/docs/bluefin-cli/setup-linux.md +++ b/docs/bluefin-cli/setup-linux.md @@ -17,7 +17,7 @@ This guide shows how to install and set up `bluefin-cli` on Linux. - Homebrew on Linux: ```bash - brew tap ublue-os/homebrew-experimental-tap + brew tap tuna-os/tap brew install bluefin-cli ``` diff --git a/docs/bluefin-cli/setup-macos.md b/docs/bluefin-cli/setup-macos.md index a42d44ac..7e0cafdf 100644 --- a/docs/bluefin-cli/setup-macos.md +++ b/docs/bluefin-cli/setup-macos.md @@ -10,7 +10,7 @@ This guide shows how to install and set up `bluefin-cli` on macOS. - Homebrew: ```bash - brew tap ublue-os/homebrew-experimental-tap + brew tap tuna-os/tap brew install bluefin-cli ```