@xn-intenton-z2a/agentic-lib 7.1.6

package/src/workflows/ci-automerge.yml

@@ -0,0 +1,544 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/ci-automerge.yml
+#
+# This file is part of the example suite for `agentic-lib` see: https://github.com/xn-intenton-z2a/agentic-lib
+# This file is licensed under the MIT License. For details, see LICENSE-MIT
+
+name: ci-automerge
+concurrency: agentic-lib-merge-main
+run-name: "ci-automerge [${{ github.ref_name }}]"
+
+on:
+  pull_request:
+  check_suite:
+  workflow_dispatch:
+  workflow_call:
+    inputs:
+      workflow:
+        description: 'Was this workflow called by another workflow?, e.g. "true"'
+        type: string
+        required: false
+        default: "true"
+  schedule:
+    - cron: '53 */4 * * *'
+
+env:
+  pullRequestLabel: "automerge"
+  branchPrefix: "agentic-lib-issue-"
+  copilotBranchPrefix: "copilot/"
+
+jobs:
+  label:
+    runs-on: ubuntu-latest
+    steps:
+      - name: echo
+        shell: bash
+        run: |
+          echo "Label: ${{ env.pullRequestLabel }}"
+    outputs:
+      pullRequestLabel: ${{ env.pullRequestLabel }}
+
+  pr:
+    needs: label
+    if: github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, needs.label.outputs.pullRequestLabel)
+    runs-on: ubuntu-latest
+    steps:
+      - name: check-pr
+        id: check-pr
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const pullNumber = pr.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            let shouldSkipMerge;
+            let prMerged;
+
+            const { data: pullRequest } = await github.rest.pulls.get({
+              owner,
+              repo,
+              pull_number: pullNumber,
+            });
+            core.info(`Found pull request #${pullRequest.number} with state: ${pullRequest.state}, mergeable: ${pullRequest.mergeable}`);
+
+            if (pullRequest.state === "closed") {
+              core.info(`PR #${pullNumber} is already closed.`);
+              shouldSkipMerge = 'true';
+              prMerged = 'true';
+            } else if (pullRequest.state !== "open") {
+              core.info(`PR #${pullNumber} is not open, it is ${pullRequest.state}.`);
+              shouldSkipMerge = 'true';
+              prMerged = 'false';
+            } else if (pullRequest.mergeable === true) {
+              core.info(`PR #${pullNumber} is mergeable.`);
+              shouldSkipMerge = 'false';
+              prMerged = 'false';
+            } else if (pullRequest.mergeable === false) {
+              core.info(`PR #${pullNumber} is not mergeable.`);
+              shouldSkipMerge = 'true';
+              prMerged = 'false';
+            } else {
+              core.info(`PR #${pullNumber} mergeability is ${pullRequest.mergeable}.`);
+              shouldSkipMerge = 'true';
+              prMerged = 'false';
+            }
+
+            core.setOutput('pullNumber', pullNumber ? pullNumber.toString() : '');
+            core.setOutput('shouldSkipMerge', shouldSkipMerge);
+            core.setOutput('prMerged', prMerged);
+    outputs:
+      pullNumber: ${{ steps.check-pr.outputs.pullNumber }}
+      shouldSkipMerge: ${{ steps.check-pr.outputs.shouldSkipMerge }}
+      prMerged: ${{ steps.check-pr.outputs.prMerged }}
+
+  cs:
+    if: github.event_name == 'check_suite' && github.event.check_suite.conclusion == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - name: find-pr
+        id: find-pr
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const checkSuite = context.payload.check_suite;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const headSha = checkSuite.head_sha;
+            let pullNumber;
+            let shouldSkipMerge;
+            let prMerged;
+
+            const { data: prs } = await github.rest.repos.listPullRequestsAssociatedWithCommit({
+              owner,
+              repo,
+              commit_sha: headSha,
+            });
+
+            if (!prs || prs.length === 0) {
+              core.info('No pull requests associated with this check suite.');
+              pullNumber = '';
+              shouldSkipMerge = 'true';
+              prMerged = 'false';
+            } else {
+              const openPRs = prs.filter(pr => pr.state === 'open');
+              const prWithAutomerge = openPRs.find(pr => pr.labels.some(label => label.name === 'automerge'));
+
+              if (!prWithAutomerge) {
+                core.info('No open pull requests with the "automerge" label.');
+                pullNumber = '';
+                shouldSkipMerge = 'true';
+                prMerged = 'false';
+              } else {
+                core.info(`Open pull request with "automerge" label: #${prWithAutomerge.number}`);
+                pullNumber = prWithAutomerge.number;
+                shouldSkipMerge = 'false';
+                prMerged = 'false';
+              }
+            }
+
+            core.setOutput('pullNumber', pullNumber ? pullNumber.toString() : '');
+            core.setOutput('shouldSkipMerge', shouldSkipMerge);
+            core.setOutput('prMerged', prMerged);
+    outputs:
+      pullNumber: ${{ steps.find-pr.outputs.pullNumber }}
+      shouldSkipMerge: ${{ steps.find-pr.outputs.shouldSkipMerge }}
+      prMerged: ${{ steps.find-pr.outputs.prMerged }}
+
+  ls:
+    needs: label
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' || inputs.workflow == 'true' || github.event_name == 'workflow_call' || github.event_name == 'workflow_run'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Determine pull request number
+        id: get-pull
+        uses: actions/github-script@v7
+        env:
+          pullRequestLabel: ${{ needs.label.outputs.pullRequestLabel }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const branchPrefix = process.env.branchPrefix;
+            const pullRequestLabel = process.env.pullRequestLabel;
+            let pullNumber = ''
+            let branchName = '';
+            let issueNumber = '';
+            const { data: pullRequests } = await github.rest.pulls.list({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              per_page: 1,
+              sort: 'created',
+              direction: 'asc'
+            });
+            if (pullRequests.length > 0) {
+              const filteredPRs = pullRequests
+                .filter(pr => pr.labels.some(label => label.name === pullRequestLabel ))
+                .filter(pr => pr.head.ref.startsWith(branchPrefix));
+              if (filteredPRs.length > 0) {
+                const pullRequest = filteredPRs[0];
+                pullNumber = pullRequest.number;
+                core.info(`Found open pull request with label ${pullRequestLabel}: #${pullRequest.number} and branch name ${pullRequest.head.ref}`);
+                core.info(JSON.stringify(pullRequest));
+              } else {
+                core.info(`No open pull request found with label ${pullRequestLabel}.`);
+                pullNumber = '';
+              }
+            } else {
+              pullNumber = '';
+              core.info('No open pull requests found.');
+            }
+            core.info(`pullNumber: ${pullNumber}`);
+            core.setOutput('pullNumber', pullNumber);
+          result-encoding: string
+    outputs:
+      pullNumber: ${{ steps.get-pull.outputs.pullNumber }}
+
+  merge-check:
+    if: ${{ !cancelled() }}
+    needs:
+      - pr
+      - cs
+      - ls
+    runs-on: ubuntu-latest
+    steps:
+      - name: get-pull
+        id: get-pull
+        uses: actions/github-script@v7
+        env:
+          prMerged: ${{ needs.pr.outputs.prMerged || 'false' }}
+          pullNumber: ${{ needs.pr.outputs.pullNumber || needs.cs.outputs.pullNumber || needs.ls.outputs.pullNumber || ''}}
+          shouldSkipMerge: ${{ needs.pr.outputs.shouldSkipMerge || 'false' }}
+        with:
+          script: |
+            // Merge outputs from pr-check, cs-check, and determine-ls.
+            // Only one of pr-check or cs-check should have run.
+            const prMerged = process.env.prMerged;
+            const pullNumber = process.env.pullNumber;
+            const branchPrefix = process.env.branchPrefix;
+            const shouldSkipMerge = process.env.shouldSkipMerge;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            core.setOutput('prMerged', `${prMerged}`);
+            core.setOutput('pullNumber', `${pullNumber}`);
+            core.setOutput('shouldSkipMerge', `${shouldSkipMerge}`);
+            core.info(`prMerged: '${prMerged}'`);
+            core.info(`pullNumber: '${pullNumber}'`);
+            core.info(`shouldSkipMerge: '${shouldSkipMerge}'`);
+            core.info(`branchPrefix '${branchPrefix}'`);
+
+            let branchName = '';
+            let issueNumber = '';
+            if( pullNumber) {
+              const { data: pullRequest } = await github.rest.pulls.get({
+                owner,
+                repo,
+                pull_number: pullNumber
+              });
+              branchName = pullRequest.head.ref;
+              core.info(`branchName '${branchName}'`);
+
+              // Extract issue number from branch name (supports agentic-lib-issue-* and copilot/* prefixes)
+              let issueNumberMatch = '';
+              if (branchName.startsWith(branchPrefix)) {
+                issueNumberMatch = branchName.replace(branchPrefix, '');
+              } else if (branchName.startsWith('copilot/')) {
+                // Copilot branches may contain issue number in the name, e.g. copilot/fix-123
+                const match = branchName.match(/(\d+)/);
+                issueNumberMatch = match ? match[1] : '';
+              }
+              if (parseInt(issueNumberMatch)) {
+                issueNumber = `${parseInt(issueNumberMatch)}`;
+              } else {
+                issueNumber = '';
+              }
+            }
+
+            core.setOutput('branchName', branchName);            
+            core.info(`branchName '${branchName}'`);
+            core.setOutput('issueNumber', issueNumber);
+            core.info(`issueNumber '${issueNumber}'`);
+          result-encoding: string
+    outputs:
+      prMerged: ${{ steps.get-pull.outputs.prMerged }}
+      pullNumber: ${{ steps.get-pull.outputs.pullNumber }}
+      shouldSkipMerge: ${{ steps.get-pull.outputs.shouldSkipMerge }}
+      branchName: ${{ steps.get-pull.outputs.branchName }}
+      issueNumber: ${{ steps.get-pull.outputs.issueNumber }}
+
+  automerge:
+    needs:
+      - merge-check
+    if: ${{ !cancelled() && needs.merge-check.outputs.shouldSkipMerge != 'true' && needs.merge-check.outputs.pullNumber != '' }}
+    permissions:
+      contents: write
+      pull-requests: write
+      checks: write
+    runs-on: ubuntu-latest
+    env:
+      pullNumber: ${{ needs.merge-check.outputs.pullNumber }}
+    steps:
+      - name: trigger-checks
+        id: trigger-checks
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pullNumber = parseInt(process.env.pullNumber);
+            if (!pullNumber) return;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            const { data: pullRequest } = await github.rest.pulls.get({
+              owner, repo, pull_number: pullNumber,
+            });
+            core.info(`PR #${pullNumber} state: ${pullRequest.state}, mergeable: ${pullRequest.mergeable}`);
+
+            if (pullRequest.state === "closed") {
+              core.info(`PR #${pullNumber} is already closed.`);
+            } else if (pullRequest.mergeable === null) {
+              core.info(`PR #${pullNumber} mergeability unknown, triggering check re-runs.`);
+              const ref = pullRequest.head.sha;
+              const { data: checkSuites } = await github.rest.checks.listSuitesForRef({ owner, repo, ref });
+              for (const suite of checkSuites.check_suites) {
+                try {
+                  await github.rest.checks.rerequestSuite({ owner, repo, check_suite_id: suite.id });
+                } catch (error) {
+                  core.info(`Failed to re-request check suite: ${error.message}`);
+                }
+              }
+            }
+
+      - name: Wait for checks
+        run: sleep 5
+
+      - name: auto-merge-pr
+        id: auto-merge-pr
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pullNumber = parseInt(process.env.pullNumber);
+            if (!pullNumber) { core.setOutput('prMerged', 'false'); core.setOutput('message', 'No PR number'); return; }
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            let prMerged;
+            let message = '';
+
+            const { data: pullRequest } = await github.rest.pulls.get({
+              owner, repo, pull_number: pullNumber,
+            });
+            core.info(`PR #${pullNumber} state: ${pullRequest.state}, mergeable_state: ${pullRequest.mergeable_state}`);
+
+            if (pullRequest.state === "closed") {
+              if (pullRequest.merged) {
+                message = `PR #${pullNumber} is closed and merged.`;
+                prMerged = 'true';
+              } else {
+                message = `PR #${pullNumber} is closed but not merged.`;
+                prMerged = 'false';
+              }
+            } else if (pullRequest.mergeable && pullRequest.mergeable_state === 'clean') {
+              await github.rest.pulls.merge({ owner, repo, pull_number: pullNumber, merge_method: 'squash' });
+              core.info(`PR #${pullNumber} merged successfully.`);
+              const branchRef = `heads/${pullRequest.head.ref}`;
+              await github.rest.git.deleteRef({ owner, repo, ref: branchRef });
+              message = `Branch '${pullRequest.head.ref}' deleted.`;
+              prMerged = 'true';
+            } else if (pullRequest.mergeable_state === 'dirty' || pullRequest.mergeable === false) {
+              message = `PR #${pullNumber} has conflicts. Closing.`;
+              await github.rest.issues.createComment({
+                owner, repo, issue_number: pullNumber,
+                body: `This pull request is being closed due to conflicts (mergeable_state: ${pullRequest.mergeable_state}, mergeable: ${pullRequest.mergeable}).`,
+              });
+              await github.rest.pulls.update({ owner, repo, pull_number: pullNumber, state: "closed" });
+              try {
+                await github.rest.git.deleteRef({ owner, repo, ref: `heads/${pullRequest.head.ref}` });
+                message += ` Branch '${pullRequest.head.ref}' deleted.`;
+              } catch (error) {
+                message += ` Failed to delete branch: ${error.message}`;
+              }
+              prMerged = 'false';
+            } else if (pullRequest.mergeable === null) {
+              message = `PR #${pullNumber} does not yet have a value for mergeability.`;
+              prMerged = 'false';
+            } else {
+              message = `PR #${pullNumber} is in an unexpected state: ${pullRequest.mergeable_state}.`;
+              prMerged = 'false';
+            }
+
+            core.setOutput('prMerged', prMerged);
+            core.setOutput('message', message);
+    outputs:
+      prMerged: ${{ steps.auto-merge-pr.outputs.prMerged }}
+      message: ${{ steps.auto-merge-pr.outputs.message }}
+
+  validate-issue-number:
+    needs:
+      - merge-check
+    if: ${{ !cancelled() }}
+    runs-on: ubuntu-latest
+    steps:
+      - id: validate-issue-number
+        run: |
+          issueNumber="${{ needs.merge-check.outputs.issueNumber }}"
+          if [[ -n "$issueNumber" && "$issueNumber" =~ [0-9] ]]; then
+            echo "[$issueNumber] is a valid issue number."
+            echo "isValid=true" >> $GITHUB_OUTPUT
+          else
+            echo "[$issueNumber] is not a valid issue number."
+            echo "isValid=false" >> $GITHUB_OUTPUT
+          fi
+    outputs:
+      isValid: ${{ steps.validate-issue-number.outputs.isValid }}
+
+  label-issue-after-automerge:
+    needs:
+      - merge-check
+      - automerge
+      - validate-issue-number
+    if: ${{ !cancelled() && ( needs.automerge.outputs.prMerged == 'true' && needs.merge-check.outputs.pullNumber != '' && needs.validate-issue-number.outputs.isValid == 'true' ) }}
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: read
+    runs-on: ubuntu-latest
+    env:
+      pullNumber: ${{ needs.automerge.outputs.prMerged == 'true' && needs.merge-check.outputs.pullNumber || '' }}
+      issueNumber: ${{ needs.merge-check.outputs.issueNumber }}
+    steps:
+      - name: Label issue after merge
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pullNumber = parseInt(process.env.pullNumber);
+            const issueNumber = parseInt(process.env.issueNumber);
+            if (!pullNumber || !issueNumber) return;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            const { data: pullRequest } = await github.rest.pulls.get({
+              owner, repo, pull_number: pullNumber,
+            });
+            const branchName = pullRequest.head.ref;
+
+            const { data: issue } = await github.rest.issues.get({
+              owner, repo, issue_number: issueNumber,
+            });
+            const hasMergedLabel = issue.labels.some(label => label.name === 'merged');
+            const hasInProgressLabel = issue.labels.some(label => label.name === 'in-progress');
+
+            if (!hasMergedLabel) {
+              core.info(`Adding "merged" label to issue #${issueNumber}.`);
+              await github.rest.issues.addLabels({
+                owner, repo, issue_number: issueNumber, labels: ['merged'],
+              });
+              await github.rest.issues.createComment({
+                owner, repo, issue_number: issueNumber,
+                body: `The feature branch has been merged: ${branchName}`,
+              });
+            }
+
+            if (hasInProgressLabel) {
+              core.info(`Removing "in-progress" label from issue #${issueNumber}.`);
+              await github.rest.issues.removeLabel({
+                owner, repo, issue_number: issueNumber, name: 'in-progress',
+              });
+            }
+
+  log-intention-activity-merge-pr:
+    needs:
+      - merge-check
+      - automerge
+    if: ${{ !cancelled() && needs.merge-check.outputs.shouldSkipMerge != 'true' && needs.merge-check.outputs.pullNumber != '' }}
+    runs-on: ubuntu-latest
+    env:
+      gitUserEmail: "action@github.com"
+      gitUserName: "GitHub Actions[bot]"
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.ref }}
+
+      - name: Load config
+        id: config
+        run: |
+          CONFIG="${{ vars.configPath || '.github/agentic-lib/agents/agentic-lib.yml' }}"
+          echo "intentionFilepath=$(yq -r '.intentionBot.intentionFilepath // "intentïon.md"' "$CONFIG")" >> $GITHUB_OUTPUT
+
+      - name: Get latest from remote
+        run: |
+          git config --local user.email '${{ env.gitUserEmail }}'
+          git config --local user.name '${{ env.gitUserName }}'
+          git config --local pull.ff     false       # never fast-forward
+          git config --local pull.rebase false       # never rebase on pull
+          git fetch origin ${{ github.ref_name }}
+          git merge origin/${{ github.ref_name }} --no-ff --no-edit --strategy=recursive --strategy-option=ours
+
+      - name: log-intention-activity
+        id: log-intention-activity
+        uses: actions/github-script@v7
+        env:
+          pullNumber: ${{ needs.merge-check.outputs.pullNumber }}
+          shouldSkipMerge: ${{ needs.merge-check.outputs.shouldSkipMerge }}
+          branchName: ${{ needs.merge-check.outputs.branchName }}
+          issueNumber: ${{ needs.merge-check.outputs.issueNumber }}
+          prMerged: ${{ needs.automerge.outputs.prMerged }}
+          message: ${{ needs.automerge.outputs.message }}
+          outcome: ${{ needs.automerge.result }}
+          intentionFilepath: ${{ steps.config.outputs.intentionFilepath }}
+        with:
+          script: |
+            const pullNumber = process.env.pullNumber;
+            const shouldSkipMerge = process.env.shouldSkipMerge;
+            const branchName = process.env.branchName;
+            const issueNumber = process.env.issueNumber;
+            const prMerged = process.env.prMerged;
+            const message = process.env.message;
+            const outcome = process.env.outcome;
+            const intentionFilepath = process.env.intentionFilepath;
+
+            const activity = `When attempting to merge PR #${pullNumber} for branch name "${branchName}" to resolve issue number "${issueNumber}" the decision to skip merge was "${shouldSkipMerge}":
+
+            then the PR was merged "${prMerged}"
+
+            with message: "${message}"
+
+            with outcome "${outcome}".`;
+
+            core.info(`Activity: ${activity}`);
+            core.info(`Seed discussion filepath: ${intentionFilepath}`);
+
+            const fs = require('fs');
+            const path = require('path');
+
+            // Create trace file and the parent directory of intentionFilepath if it doesn't exist
+            if (!fs.existsSync(path.dirname(intentionFilepath))) {
+              fs.mkdirSync(path.dirname(intentionFilepath), { recursive: true });
+            }
+            const isoDate = new Date().toISOString();
+            const activityLogContent = `\n## Merge PR activity at ${isoDate}
+
+            ${activity}
+
+            ---
+            `;
+            if (fs.existsSync(intentionFilepath)) {
+              fs.appendFileSync(intentionFilepath, activityLogContent);
+            } else {
+              fs.writeFileSync(intentionFilepath, activityLogContent);
+            }
+            core.info(`Activity logged to ${intentionFilepath}`);
+
+      - name: Commit changes
+        run: |
+          git config --local user.email '${{ env.gitUserEmail }}'
+          git config --local user.name '${{ env.gitUserName }}'
+          git config --local pull.ff     false       # never fast-forward
+          git config --local pull.rebase false       # never rebase on pull
+          git add  ${{ steps.config.outputs.intentionFilepath }}
+          git commit -m "Activity logged by ci-automerge.yml" || echo "No changes to commit"
+          git fetch origin ${{ github.ref_name }}
+          git merge origin/${{ github.ref_name }} --no-ff --no-edit --strategy=recursive --strategy-option=ours
+          git push -v origin ${{ github.ref_name }}

package/src/workflows/ci-init.yml

@@ -0,0 +1,63 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/ci-init.yml
+#
+# Pulls the latest agentic-lib infrastructure into this repository.
+# Can optionally reset source files to the seed template state.
+
+name: ci-init
+run-name: "ci-init [${{ github.ref_name }}]"
+
+on:
+  workflow_dispatch:
+    inputs:
+      purge:
+        description: "Reset source files to seed template state"
+        type: boolean
+        default: false
+      version:
+        description: "agentic-lib version to install (default: latest)"
+        type: string
+        default: "latest"
+
+permissions:
+  contents: write
+
+jobs:
+  init:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install agentic-lib
+        run: npm install @xn-intenton-z2a/agentic-lib@${{ inputs.version }}
+
+      - name: Run agentic-lib init
+        run: |
+          PURGE_FLAG=""
+          if [ "${{ inputs.purge }}" = "true" ]; then
+            PURGE_FLAG="--purge"
+          fi
+          npx agentic-lib init $PURGE_FLAG
+
+      - name: Install dependencies after init
+        if: inputs.purge == true
+        run: npm install
+
+      - name: Install agentic-step dependencies
+        run: |
+          cd .github/agentic-lib/actions/agentic-step
+          npm ci
+
+      - name: Verify tests pass
+        run: npm test
+
+      - name: Commit changes
+        uses: ./.github/agentic-lib/actions/commit-if-changed
+        with:
+          commit-message: "agentic-lib init${{ inputs.purge == true && ' --purge' || '' }} (v${{ inputs.version }})"
+          push-ref: ${{ github.ref_name }}