Skip to content

feat: winget, Scoop and Homebrew manifests made from each release, and installed with - #70

Merged
blockmandev merged 2 commits into
mainfrom
feat/package-manifests
Oct 24, 2026
Merged

blockmandev merged 2 commits into
mainfrom
feat/package-manifests

Conversation

@blockmandev

Copy link
Copy Markdown
Member

From #56, "Package managers" (Homebrew, winget and Scoop manifests from the release archives and SHA256SUMS).

What it adds

  • scripts/package_manifests.py (standard library only): from a release tag and that release's SHA256SUMS, it writes:

    • winget: version, installer and locale files, for a zip holding two portable commands, incode and sbx;
    • Scoop: a manifest, with checkver/autoupdate so a bucket can follow new releases;
    • Homebrew: a formula for macOS and Linux on Intel and ARM, whose test checks that both programs report the formula's version.

    It refuses pre-release tags, and a missing archive or a malformed sum line is an error, not skipped.

  • .github/workflows/package-check.yml: makes the manifests for a tag, then installs with each one, as a user would:

    • winget: winget validate, then installs the local manifest, on Windows;
    • Scoop: installs on Windows;
    • Homebrew: installs from a local tap on macOS and Linux.

    Both programs must then report the tag's version. The manifests are uploaded as the package-manifests artifact, ready to submit.

  • release.yml: runs it after the install check, for release tags only. A PR that changes the generator runs it against the latest release (this PR runs it on v0.1.0).

Verified locally

  • Unit tests: 10 pass (python -m unittest discover -s scripts/tests).
  • winget: for v0.1.0, the generated manifest passes winget validate (winget 1.29).
  • Hashes: the downloaded archives' sha256 match the release's SHA256SUMS.

Scoop and Homebrew aren't installed on this machine, so their real installs are this PR's CI.

Not done here (needs the owner)

  • winget: a pull request to microsoft/winget-pkgs, under manifests/i/IncordAI/Incode/<version>/.
  • Scoop and Homebrew: a bucket repo and a tap repo, such as incordai/scoop-bucket and incordai/homebrew-tap.
  • Names: the package identifier IncordAI.Incode and publisher name Incord AI are my defaults (constants at the top of the script), so change them if you want different ones.

…d installed with (refs #56)

Package managers need a manifest per release naming each archive and its
sha256. Written by hand they drift from what was published, so they are
made from the release's own SHA256SUMS:

- scripts/package_manifests.py (standard library only) renders the winget
  version/installer/locale files (a zip of two portable commands), a Scoop
  manifest with checkver/autoupdate, and a Homebrew formula for macOS and
  Linux on Intel and ARM whose test checks both programs' versions.
  Pre-release tags are refused; a missing archive or a malformed sum line
  is an error, not skipped.
- .github/workflows/package-check.yml makes them for a tag and installs
  with each, as a user would: winget (validate, then install the local
  manifest) and Scoop on Windows, Homebrew from a local tap on macOS and
  Linux; both programs must report the tag's version. The manifests are
  uploaded as an artifact, ready to submit.
- release.yml runs it after the install check, for release tags only.
  A pull request that changes the generator runs it against the latest
  release.

Submitting (a winget-pkgs pull request, a Scoop bucket, a Homebrew tap)
needs the owner's accounts and is not done here.

Tested: 10 unit tests (scripts/tests); for v0.1.0 the generated winget
manifest passes `winget validate` (winget 1.29) and the downloaded
archives' hashes match the release's SHA256SUMS.
Root cause: given a relative manifests/scoop/incode.json, Scoop parses it as <bucket>/<app>, reports the manifest not found and exits 0; the version check caught it. An absolute path is read as a manifest file.
@blockmandev
blockmandev merged commit 1da6b05 into main Oct 24, 2026
17 checks passed
@blockmandev
blockmandev deleted the feat/package-manifests branch October 24, 2026 16:33
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