release.yml

# Creates the GitHub Release page for a version tag.
#
# The notes are composed by the shared workflow in
# imqueue/.github/.github/workflows/release.yml: a CHANGELOG.md section for the exact
# version when one exists, otherwise GitHub's PR-derived notes, always followed by a
# standard About + links block.
#
# This fires on `git push --follow-tags` after `npm version`, so it needs no change to
# the existing release habit. workflow_dispatch is for backfilling a tag that already
# exists, and defaults to a dry run so the notes can be read before anything is created.

name: Release

on:
  push:
    tags: ['v*']
  workflow_dispatch:
    inputs:
      tag:
        description: 'Existing tag to compose notes for, e.g. v1.2.3'
        required: true
        type: string
      dry-run:
        description: 'Only print the notes; do not create or update the release'
        required: false
        type: boolean
        default: true

jobs:
  release:
    uses: imqueue/.github/.github/workflows/release.yml@master
    # A called workflow can hold no more permission than its caller grants, so this is
    # required even though the shared workflow declares it too.
    permissions:
      contents: write
    with:
      package: '@imqueue/cli'
      tag: ${{ inputs.tag || '' }}
      dry-run: ${{ inputs.dry-run || false }}
      blurb: >-
        `@imqueue/cli` (`imq`) scaffolds @imqueue services and orchestrates them: create a service
        and its CI/registry wiring in one command, generate typed clients (`imq client generate
        <Service>`), run a local fleet, and coordinate fleet-wide version bumps (`imq service
        update-version --bump`).