feat(freebsd): publish runner-bin port + .pkg release channel

[kjanat]

Adds a FreeBSD distribution channel alongside crates.io, npm, and the AUR.

The release matrix already builds and uploads *-unknown-freebsd tarballs, so this reuses them (mirroring the AUR runner-run-bin package) rather than recompiling.

What's here

Path	Role
freebsd/runner/{Makefile,distinfo,pkg-descr}	Prebuilt FreeBSD port runner-bin (amd64 + aarch64): installs runner/run + bash/zsh/fish/pwsh completions into the canonical ${LOCALBASE} autoload dirs. Checked-in values are a real v0.12.0 reference snapshot; CI overwrites them per release.
.github/scripts/publish/freebsd-prepare.sh	Bumps DISTVERSION and regenerates distinfo (per-arch SHA256 + SIZE) from the release's published .sha256 assets + asset metadata. amd64 is mandatory; the experimental aarch64 build is skipped with a warning when absent. Strict semver guard before any sed runs.
.github/workflows/freebsd-release.yml	On release: published (and manual workflow_dispatch + dry-run) builds the port the canonical way inside a FreeBSD VM (make stage check-plist package) against a blobless sparse checkout of the ports Mk/ tree, then attaches runner-freebsd-amd64.pkg (+ .sha256) to the release. Third-party uses: pinned to commit SHAs.
README / freebsd/README.md / CHANGELOG	Docs + pkg add one-liner.

Design notes

• No recompile — the port fetches the existing release tarballs (binary port, the AUR -bin parallel).
• FreeBSD has no AUR-style push-to-git remote, so the installable artifact is a .pkg on the GitHub release: pkg add https://github.com/kjanat/runner/releases/latest/download/runner-freebsd-amd64.pkg (version-less asset name → latest/download always resolves).
• Resilience: aarch64 is the tier-3 experimental build, so it's skipped-with-warning if its asset is missing; amd64 (tier-2) is mandatory.

Validation done locally

• freebsd-prepare.sh: bash syntax + both paths (full + aarch64-missing) tested with a stubbed gh — Makefile bump and distinfo regen are byte-correct.
• Workflow YAML parses; dprint check clean; all Makefile recipe lines are real tabs.
• CI runs make stage check-plist package, so plist drift in either direction fails the build (can't silently ship a broken completions split).

Couldn't verify locally

The actual make package runs inside a FreeBSD VM. Before a real release, run Actions → freebsd-release → Run workflow with a tag + dry-run ticked to exercise the full VM build (fetch / stage / check-plist / package) without uploading.

Supersedes #38 (same commit, moved off the claude/* branch).

---

Generated by Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	runner	f7eebfe	Commit Preview URL Branch Preview URL	Sep 28 2026, 10:30 AM

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

• cr:review

🚫 Excluded labels (none allowed) (2)

• wip
• cr:skip

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: b69d0410-1648-432a-b912-b70235967d99

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}

[kjanat]

Goal: an installable FreeBSD package.

Already on master: FreeBSD x86_64 and aarch64 binaries on every release (linked against the FreeBSD 12 libc since #154), FreeBSD support in install.sh, and the npm freebsd-x64 package. No pkg package.

Carries over: the port Makefile, pkg-descr, and the distinfo prepare script. The install and completion recipe matches master's AUR runner-run-bin package, and the asset names match v0.27.0. To fit master:

• Run from release.yml via workflow_call, like the other channels.
• Port under packaging/freebsd/, script as .github/scripts/freebsd.sh prepare.
• Ship man pages.
• Publish the bumped distinfo somewhere users can fetch it.

Open decision: a self-hosted .pkg attached to releases (the workflow builds amd64 only), or a source port (USES=cargo) aimed at the official ports tree. Untested: whether one .pkg built in the VM installs across FreeBSD major versions.