AgentBoard

Preparing a release for Scoop

What is already automated

scripts/package-scoop.ps1 -Version X.Y.Z runs npm ci, builds the frontend, runs go test ./..., builds the versioned Windows agentboard.exe, creates a ZIP and calculates its SHA-256. From the same ZIP it creates release/agentboard.json with the URL, hash, MIT license, CLI shim, shortcut, checkver and autoupdate. The ZIP and installer include LICENSE. The database lives outside the installation directory, so the manifest does not need persist.

.github/workflows/release.yml on the vX.Y.Z tag runs the same packaging in the Windows runner, builds the Inno Setup installer and attaches the ZIP, installer and manifest to the GitHub Release. Manually running a workflow only creates an artifact for testing, without publishing a release.

Posting order for maintainer

  1. Check that the code, documentation, version number and LICENSE file are ready.
  2. Run ./scripts/package-scoop.ps1 -Version X.Y.Z locally. Check release/agentboard-X.Y.Z-windows-amd64.zip, release/agentboard.json and the output of agentboard version after extracting. Do not change the ZIP after the hash has been calculated.
  3. Create and submit the vX.Y.Z tag. GitHub Actions will publish a Release with a ZIP, agentboard-X.Y.Z-windows-amd64-setup.exe and manifest. Check all three files on the Release page and the SHA-256 ZIP from manifest.
  4. On a clean Windows machine with Scoop, run scoop install https://github.com/bogdanovandreycode/AgentBoard/releases/latest/download/agentboard.json, then agentboard version, agentboard init and agentboard open in the test folder.
  5. For a permanent update feed, place the generated agentboard.json in your own Scoop bucket or offer it in a suitable public bucket. Check scoop update agentboard after the next release. The installation command from a URL is suitable for the first acquaintance, while the bucket is more convenient for updates.

Do not manually substitute a random hash value: Scoop checks the contents of the downloaded ZIP.

For manifest checks, refer to Scoop format, creating manifest and autoupdate.