Keep the existing codewhale-tui symlink when codewhale-bin upgrades while installing codew from the consolidated archive. Pin the package-layout regression and make the Omarchy documentation match the compatibility contract.
2.9 KiB
AUR packaging for Codewhale
codewhale-bin installs the prebuilt codewhale runtime and its codew
convenience command from the same Linux archives published for each Codewhale
release. It does not compile a fork or carry a separate Codewhale version.
The AUR repository is a separate publication destination. This directory is
the upstream source of its PKGBUILD and .SRCINFO, but the files with those
final names are generated only after the matching release archives and
checksum manifests exist. Nothing here publishes to AUR.
Render a release update
From a checkout whose Cargo.toml has the released X.Y.Z workspace version,
obtain the complete, verified codewhale-release-assets directory and run:
./packaging/aur/render.sh /path/to/release-assets /tmp/codewhale-bin
The renderer:
- reads
pkgverfrom[workspace.package]rather than accepting a second product version; - requires the x64 and arm64 Linux archives under their canonical release names;
- requires both release checksum manifests to agree with each other and with the archive bytes;
- inserts real SHA-256 values for both archives and the tagged MIT license;
- rejects unresolved placeholders,
SKIP, malformed archives, and non-empty output directories; and - compares the rendered
.SRCINFOwithmakepkg --printsrcinfowhenmakepkgis available.
The initial AUR revision for each upstream release is pkgrel=1. A recipe-only
correction may use a higher Arch package revision without changing Codewhale's
semantic version:
./packaging/aur/render.sh /path/to/release-assets /tmp/codewhale-bin 2
Do not invent checksums before release artifacts exist, use SKIP, or copy
hashes from an older release.
Validate on Arch or Omarchy
Review the generated files, then validate them in an unprivileged clean build environment:
cd /tmp/codewhale-bin
makepkg --verifysource
makepkg --printsrcinfo | cmp - .SRCINFO
makepkg --cleanbuild
namcap PKGBUILD codewhale-bin-*.pkg.tar.zst
Inspect the package contents before installation. They should contain
/usr/bin/codewhale, /usr/bin/codew, the existing codewhale-tui
compatibility symlink to codewhale, and the MIT license. After a test install,
verify the canonical entrypoints report X.Y.Z and the compatibility symlink
resolves to the same runtime.
Publishing the generated files to the codewhale-bin AUR repository requires
separate authorization from an AUR maintainer. Regenerate .SRCINFO whenever
package metadata changes, and never publish this recipe before the matching
Codewhale tag, archives, and checksum manifests are public and verified.
Arch's PKGBUILD(5) contract defines architecture-specific sources and
checksums, and the AUR requires .SRCINFO to accompany metadata changes: