Submit Winget package to microsoft/winget-pkgs

Summary

The Winget manifest templates were created in #72 / #76, but haven't been submitted yet. This issue tracks the actual submission to microsoft/winget-pkgs.

Prerequisites

feat: add Winget manifest templates for Windows distribution #76 merged (manifest templates)
A release exists on GitHub (need real version number and checksums)

Steps to Submit

Option 1: Manual PR

Get release info from GitHub:

Version: X.Y.Z
x64 URL: https://github.com/open-cli-collective/confluence-cli/releases/download/vX.Y.Z/cfl_X.Y.Z_windows_amd64.zip
arm64 URL: https://github.com/open-cli-collective/confluence-cli/releases/download/vX.Y.Z/cfl_X.Y.Z_windows_arm64.zip

Get SHA256 checksums from checksums.txt in the release.

Update manifest templates:
- Copy files from packaging/winget/
- Replace 0.0.0 with actual version
- Replace placeholder checksums with real SHA256 values

Validate locally:

winget validate --manifest <path-to-manifests>

Fork microsoft/winget-pkgs

Create folder structure:

manifests/o/OpenCLICollective/cfl/X.Y.Z/
├── OpenCLICollective.cfl.yaml
├── OpenCLICollective.cfl.installer.yaml
└── OpenCLICollective.cfl.locale.en-US.yaml

Submit PR to microsoft/winget-pkgs

Option 2: Using wingetcreate

# Install
winget install Microsoft.WingetCreate

# Create/update manifest interactively
wingetcreate new <x64_url>

# Or update existing
wingetcreate update OpenCLICollective.cfl --version X.Y.Z --urls <x64_url> <arm64_url> --submit

After Approval

Add Winget installation instructions to README.md:

### Winget (Windows)

```powershell
winget install OpenCLICollective.cfl

References

Submit packages to Windows Package Manager
wingetcreate tool
Manifest templates: packaging/winget/

Implementation Plan

Overview

Create both manual and automated Winget submission workflows using wingetcreate.

1. Manual Workflow: `.github/workflows/winget-publish.yml`

For initial submission and retries.

name: Publish to Winget

on:
  workflow_dispatch:
    inputs:
      version:
        description: 'Version to publish (e.g., 0.9.9)'
        required: true
        type: string

jobs:
  publish:
    runs-on: windows-latest
    steps:
      - name: Install wingetcreate
        shell: pwsh
        run: |
          iwr https://aka.ms/wingetcreate/latest -OutFile wingetcreate.exe

      - name: Validate release exists
        shell: pwsh
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          gh release view "v${{ inputs.version }}" --repo open-cli-collective/confluence-cli
          if ($LASTEXITCODE -ne 0) { exit 1 }

      - name: Submit to Winget
        shell: pwsh
        run: |
          $version = "${{ inputs.version }}"
          $x64 = "https://github.com/open-cli-collective/confluence-cli/releases/download/v$version/cfl_${version}_windows_amd64.zip"
          $arm64 = "https://github.com/open-cli-collective/confluence-cli/releases/download/v$version/cfl_${version}_windows_arm64.zip"
          
          ./wingetcreate.exe update OpenCLICollective.cfl --version $version --urls $x64 $arm64 --submit --token ${{ secrets.WINGET_GITHUB_TOKEN }}

2. Add to Release Workflow: `.github/workflows/release.yml`

Add a winget job after GoReleaser:

  winget:
    needs: goreleaser
    runs-on: windows-latest
    steps:
      - name: Install wingetcreate
        shell: pwsh
        run: iwr https://aka.ms/wingetcreate/latest -OutFile wingetcreate.exe

      - name: Submit to Winget
        shell: pwsh
        run: |
          $version = "${{ github.ref_name }}".TrimStart('v')
          $x64 = "https://github.com/open-cli-collective/confluence-cli/releases/download/${{ github.ref_name }}/cfl_${version}_windows_amd64.zip"
          $arm64 = "https://github.com/open-cli-collective/confluence-cli/releases/download/${{ github.ref_name }}/cfl_${version}_windows_arm64.zip"
          
          ./wingetcreate.exe update OpenCLICollective.cfl --version $version --urls $x64 $arm64 --submit --token ${{ secrets.WINGET_GITHUB_TOKEN }}

3. Update Documentation

CLAUDE.md - Update packaging section:

- **Winget**: Automated via release workflow, requires `WINGET_GITHUB_TOKEN` secret (PAT with `public_repo` scope)

packaging/winget/README.md - Add automation section similar to Chocolatey README.

Required Setup

Create GitHub PAT with public_repo scope at https://github.com/settings/tokens
Add as org/repo secret named WINGET_GITHUB_TOKEN

Files Changed

File	Change
`.github/workflows/winget-publish.yml`	New manual workflow
`.github/workflows/release.yml`	Add winget job
`CLAUDE.md`	Update Winget entry in packaging section
`packaging/winget/README.md`	Add automation section

First Submission

After merging:

Add WINGET_GITHUB_TOKEN secret
Go to Actions → "Publish to Winget"
Enter 0.9.9 as version
Workflow creates PR to microsoft/winget-pkgs
Wait for Microsoft's automated validation + merge

feat: automate Winget package submission

feat: automate Winget package submission (#86)

fix: handle initial Winget submission when manifest doesn't exist

fix: handle initial Winget submission when manifest doesn't exist (#87)

fix: use .NET regex for single replacement in PowerShell

fix: use .NET regex for single replacement in PowerShell (#88)

Follow-up: Improve Winget Manifest Validation

Based on the microsoft/winget-pkgs PR checklist, we should improve our validation:

Changes

Update schema version from 1.6.0 → 1.10.0
- packaging/winget/OpenCLICollective.cfl.yaml
- packaging/winget/OpenCLICollective.cfl.installer.yaml
- packaging/winget/OpenCLICollective.cfl.locale.en-US.yaml
- .github/workflows/test-winget.yml
Update test workflow to validate actual templates
- Instead of hardcoded manifests, read our actual template files and substitute placeholders
Add validation step to publish workflows
- Run winget validate --manifest before submitting to catch issues early

Files to Modify

File	Change
`packaging/winget/*.yaml`	Update ManifestVersion to 1.10.0
`.github/workflows/test-winget.yml`	Use actual templates instead of hardcoded
`.github/workflows/winget-publish.yml`	Add validation before submit
`.github/workflows/release.yml`	Add validation before submit (winget job)

feat: improve Winget manifest validation

microsoft/winget-pkgs#331321

winget distribution ✅

Navigation Menu

Repository navigation

Submit Winget package to microsoft/winget-pkgs #77

Summary

Prerequisites

Steps to Submit

Option 1: Manual PR

Option 2: Using wingetcreate

After Approval

References

Implementation Plan

Overview

1. Manual Workflow: `.github/workflows/winget-publish.yml`

2. Add to Release Workflow: `.github/workflows/release.yml`

3. Update Documentation

Required Setup

Files Changed

First Submission

Follow-up: Improve Winget Manifest Validation

Changes

Files to Modify

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Submit Winget package to microsoft/winget-pkgs #77

Description

Summary

Prerequisites

Steps to Submit

Option 1: Manual PR

Option 2: Using wingetcreate

After Approval

References

Activity

rianjs commented on Jan 17, 2026

Implementation Plan

Overview

1. Manual Workflow: .github/workflows/winget-publish.yml

2. Add to Release Workflow: .github/workflows/release.yml

3. Update Documentation

Required Setup

Files Changed

First Submission

rianjs commented on Jan 17, 2026

Follow-up: Improve Winget Manifest Validation

Changes

Files to Modify

rianjs commented on Jan 17, 2026

rianjs commented on Jan 23, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

1. Manual Workflow: `.github/workflows/winget-publish.yml`

2. Add to Release Workflow: `.github/workflows/release.yml`