Pkg Update

Package Update Workflow

When updating a package to a new upstream version:

1. Run the sync script:

   bash scripts/sync-package.sh <pkgname> <version>
   

   This performs the hybrid merge with upstream, applies update.sh, and updates hashes.

2. Lint the result:

   namcap PKGBUILD
   

   Fix any issues before proceeding.

3. Regenerate metadata:

   makepkg --printsrcinfo > .SRCINFO
   

4. Build in a clean chroot:

   pkgctl build
   

   This verifies the package compiles and passes check() in an isolated environment.

5. Sanity check the payload:

   pkgctl diff --list
   

   Verify the primary binary, license file, and directory structure are intact. A payload size deviation of >10% or disappearance of /usr/bin/ targets must be investigated.

6. Acknowledge the update:

   nvtake <pkgname>
   

   Refer to the Debian nvtake manual for flags. Do not hallucinate options.

7. Commit PKGBUILD and .SRCINFO together in a single commit. Use the format <pkgname>: update to <version>.

Gotchas

• pkgctl build may require a pre-configured chroot. If missing, set up with mkarchroot.
• If updpkgsums fails due to a re-rolled upstream tarball, verify the file content before accepting new hashes.
• If the sync-package.sh merge produces conflicts, manual intervention is required. Hybrid merge conflict recovery is not yet automated (see docs/TODO.md).