vrr/CodeNomad
2
0
Fork 0
mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-07-10 00:14:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
CodeNomad/docs/guides/winget-release-automation.md
Pascal André 37a8621063
chore: TASK-075 automate Winget updates on release (#513) 
## Summary
- add a release-published workflow that prepares and submits Winget
manifest updates automatically
- poll the GitHub Release API for the stable Windows Tauri asset and
compute its SHA-256 before submission
- document the maintainer secret and repository variables needed for the
Winget automation flow

## Validation
- `node --check "scripts/winget/resolve-release-asset.cjs"`
- `node "scripts/winget/resolve-release-asset.cjs" --help`
- dry-run resolver against the published `v0.16.0` release asset

## Notes
- skips draft and prerelease GitHub releases
- uses the maintainer fork submission flow for `microsoft/winget-pkgs`
- live PR submission still depends on configuring `WINGET_GITHUB_TOKEN`
- Fixes #462
2026-06-03 09:03:46 +02:00

1.9 KiB
Raw Blame History

Winget release automation

CodeNomad publishes Winget updates from GitHub Releases with .github/workflows/update-winget.yml.

Trigger

  • Runs on release.published.
  • Exits early for draft or prerelease releases.
  • Waits for the expected stable Windows Tauri asset because the release record can exist before all assets finish uploading.

Required configuration

Repository secret

  • WINGET_GITHUB_TOKEN: Classic GitHub PAT with public_repo scope.
    • The token owner must own the fork that submits to microsoft/winget-pkgs.
    • Komac-based submission cannot open the PR with a fine-grained token today.

Repository variables

  • WINGET_PACKAGE_IDENTIFIER (default fallback in workflow: NeuralNomadsAI.CodeNomad)
  • WINGET_FORK_OWNER (default fallback in workflow: pascalandr)
  • WINGET_WINDOWS_ASSET_NAME_TEMPLATE (default fallback in workflow: CodeNomad-Tauri-windows-x64-{version}.zip)
  • WINGET_ASSET_WAIT_TIMEOUT_SECONDS (optional, default fallback: 900)
  • WINGET_ASSET_POLL_INTERVAL_SECONDS (optional, default fallback: 15)

{version} is replaced from the release tag after trimming a leading v.

Runtime flow

  1. Resolve the release version from github.event.release.tag_name.
  2. Poll the release API until exactly one uploaded asset matches the configured Windows Tauri asset template.
  3. Download the matched asset once and compute a SHA-256 for logging and verification.
  4. Verify the PAT owner matches WINGET_FORK_OWNER and that ${WINGET_FORK_OWNER}/winget-pkgs is a fork of microsoft/winget-pkgs.
  5. Invoke vedantmgoyal9/winget-releaser@v2, which uses Komac under the hood to update the existing NeuralNomadsAI.CodeNomad manifest and open the PR.

Notes

  • The workflow does not depend on a persistent local winget-pkgs clone.
  • The current package in winget-pkgs uses the release ZIP with a nested NSIS installer, so the workflow targets the stable CodeNomad-Tauri-windows-x64-{version}.zip asset.