Skip to content

Pin the CLI and plugin defaults to a matched 1.2.0-rc29 - #4

Open
asgeirf wants to merge 1 commit into
mainfrom
pin-matched-cli-and-plugin
Open

Pin the CLI and plugin defaults to a matched 1.2.0-rc29#4
asgeirf wants to merge 1 commit into
mainfrom
pin-matched-cli-and-plugin

Conversation

@asgeirf

@asgeirf asgeirf commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

The documented one-line adoption path could not push. Both reusable workflows installed a client that bowrain.cloud stopped serving on 21 August.

Two defaults, wrong in different ways

plugins: "bowrain" named no version. setup-kapi adds --channel beta only when a ref carries a prerelease constraint, so a bare name resolves on stable, and the newest stable bowrain plugin is 1.1.0 (17 June). 1.1.0 POSTs <stream>/push/diff, which neokapi#2136 retired along with the server route. Every run failed on its first file.

kapi-version: "1.2.0-rc14" was a hard-coded version from July. A stable promotion would not have moved it, so it needed a bump whatever happened to the channel.

Both now name 1.2.0-rc29, so the CLI and the plugin come from one release rather than two versions that never met. The @1.2.0-rc29 on the plugin is what routes setup-kapi to the beta channel.

Verified

stable resolves to 1.1.0 registry manifest-plugins.json: every 1.2.0-rc is channel: beta, newest stable is 1.1.0
1.1.0 calls the retired route bowrain/core/client/push.go:302 at tag v1.1.0
the server does not serve it bowrain/server/server.go routes init/uploads/commit/chunks and GET /tree, and nothing else
rc29 calls only routed endpoints /pull, /status, /blocks, /push/init, /push/commit, /tree
both files parse and lint actionlint clean; defaults re-read from parsed YAML

Follow-up

When 1.2.0 ships stable, both defaults can move to 1.2.0 and the plugin ref can drop its channel constraint.

Separately, neokapi now answers the retired endpoint with 426 and an upgrade message instead of a bare 404, so a client pinned to an old version says why it failed rather than blaming the first file it sent.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LSYPKgw58EVNrcE3fs5eV4

`plugins: "bowrain"` carried no version, and setup-kapi adds `--channel beta`
only when a ref names a prerelease, so it resolved on stable. The newest stable
plugin is 1.1.0 from June, which sends the push protocol bowrain.cloud retired
in August: every run of the documented path failed its first push.

`kapi-version` was a stale 1.2.0-rc14 that a stable release would not have
moved, so it needed pinning either way. Both now name 1.2.0-rc29, which is one
released pair rather than two versions that never met.

Revisit when 1.2.0 ships stable: both defaults can move to 1.2.0, and the plugin
ref can drop its channel constraint.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LSYPKgw58EVNrcE3fs5eV4
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant