zerobyte/.github/workflows/request-docs-version-update.yml

name: Request docs version update

on:
  workflow_dispatch:
    inputs:
      release_tag:
        description: Minor release tag, for example v0.35.0
        required: true
        type: string
      base_branch:
        description: Branch Copilot should branch from
        required: false
        default: main
        type: string
  workflow_call:
    inputs:
      release_tag:
        required: true
        type: string
      base_branch:
        required: false
        default: main
        type: string
    secrets:
      COPILOT_ASSIGNMENT_TOKEN:
        required: true

permissions:
  contents: read

jobs:
  request-docs-version-update:
    runs-on: ubuntu-latest
    steps:
      - name: Create Copilot issue
        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9
        with:
          github-token: ${{ secrets.COPILOT_ASSIGNMENT_TOKEN }}
          script: |
            if (!process.env.COPILOT_ASSIGNMENT_TOKEN) {
              core.setFailed("COPILOT_ASSIGNMENT_TOKEN is required to assign issues to GitHub Copilot.");
              return;
            }

            const releaseTag = process.env.RELEASE_TAG;
            const baseBranch = process.env.BASE_BRANCH;
            const minorRelease = releaseTag.match(/^(v\d+\.\d+)\.0$/);
            if (!minorRelease) {
              core.setFailed(`Docs version updates only run for minor release tags like v0.35.0. Received: ${releaseTag}`);
              return;
            }

            const docsVersion = minorRelease[1];
            const { owner, repo } = context.repo;
            const targetRepo = `${owner}/${repo}`;
            const releaseUrl = `https://github.com/${targetRepo}/releases/tag/${releaseTag}`;
            const title = `Update Docker Compose examples to ${docsVersion}`;
            const bodyLines = [
              `A new Zerobyte release was published: ${releaseTag}`,
              "",
              `Release: ${releaseUrl}`,
              "",
              "Please create a pull request that updates Docker Compose documentation examples to use:",
              "",
              "```yaml",
              `image: ghcr.io/nicotsx/zerobyte:${docsVersion}`,
              "```",
              "",
              "Scope:",
              "",
              "- Update Docker image tags in `README.md`.",
              "- Update Docker image tags in `apps/docs/`.",
              "- Only update Zerobyte image versions in Docker Compose examples.",
              "- Do not change unrelated prose, formatting, or code.",
              "",
              "Verification:",
              "",
              "- Search for stale `ghcr.io/nicotsx/zerobyte:v...` references in `README.md` and `apps/docs/`.",
              "- Run any formatting or documentation checks that are appropriate for the touched files.",
            ];

            const issue = await github.rest.issues.create({
              owner,
              repo,
              title,
              body: bodyLines.join("\n"),
            });

            await github.rest.issues.update({
              owner,
              repo,
              issue_number: issue.data.number,
              body: [
                ...bodyLines,
                "",
                "Pull request requirement:",
                "",
                `- Include \`Closes #${issue.data.number}\` in the pull request body.`,
              ].join("\n"),
            });

            await github.request("POST /repos/{owner}/{repo}/issues/{issue_number}/assignees", {
              owner,
              repo,
              issue_number: issue.data.number,
              assignees: ["copilot-swe-agent[bot]"],
              agent_assignment: {
                target_repo: targetRepo,
                base_branch: baseBranch,
                custom_instructions: "Create a focused documentation-only PR for the release version update.",
                custom_agent: "",
                model: "",
              },
              headers: {
                accept: "application/vnd.github+json",
                "X-GitHub-Api-Version": "2022-11-28",
              },
            });
        env:
          RELEASE_TAG: ${{ inputs.release_tag }}
          BASE_BRANCH: ${{ inputs.base_branch }}
          COPILOT_ASSIGNMENT_TOKEN: ${{ secrets.COPILOT_ASSIGNMENT_TOKEN }}