@plainconceptsplatform/workflows 0.1.2 → 0.1.5

package/loops/actions/apply-agent-output/action.yml

@@ -1,107 +1,108 @@
-name: Apply agent output
-description: Download the agent artifact and apply its safe outputs in one fixed order, so every worker concludes the same way.
-inputs:
-  token:
-    description: GitHub token the writes are made with.
-    required: true
-  artifact-name:
-    description: >-
-      Name of the agent artifact. Callers pass the activation job's artifact_prefix output
-      followed by "agent"; gh-aw derives that prefix from the workflow's inputs, so it is
-      non-empty for every workflow_call worker and the bare name never resolves.
-    required: true
-  merge-pull-request:
-    description: Apply merge_pull_request items.
-    required: false
-    default: 'false'
-  push-to-branch:
-    description: Apply push_to_pull_request_branch items.
-    required: false
-    default: 'false'
-  close-issues:
-    description: Apply close_issue items.
-    required: false
-    default: 'false'
-  create-issues:
-    description: Apply create_issue items.
-    required: false
-    default: 'false'
-  update-issues:
-    description: Apply update_issue items.
-    required: false
-    default: 'false'
-  apply-labels:
-    description: Apply add_labels and remove_labels items.
-    required: false
-    default: 'true'
-  fallback-issue-number:
-    description: Issue an update_issue item targets when it names none.
-    required: false
-    default: ''
-outputs:
-  item-count:
-    description: Number of items the agent produced.
-    value: ${{ steps.output.outputs.item-count }}
-  first-issue-number:
-    description: Issue number of the first issue created, or empty.
-    value: ${{ steps.create-issues.outputs.first-issue-number }}
-runs:
-  using: composite
-  steps:
-    - name: Download agent output
-      id: output
-      uses: ./.github/actions/download-agent-output
-      with:
-        artifact-name: ${{ inputs.artifact-name }}
-
-    - name: Merge pull request
-      if: inputs.merge-pull-request == 'true' && steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/merge-agent-pr
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        token: ${{ inputs.token }}
-
-    - name: Push to pull request branch
-      if: inputs.push-to-branch == 'true' && steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/push-agent-branch
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        bundle-file: ${{ steps.output.outputs.bundle-file }}
-        token: ${{ inputs.token }}
-
-    - name: Close issues
-      if: inputs.close-issues == 'true' && steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/close-agent-issues
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        token: ${{ inputs.token }}
-
-    - name: Update issues
-      if: inputs.update-issues == 'true' && steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/update-agent-issues
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        token: ${{ inputs.token }}
-        fallback-issue-number: ${{ inputs.fallback-issue-number }}
-
-    - name: Create issues
-      id: create-issues
-      if: inputs.create-issues == 'true' && steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/create-agent-issues
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        token: ${{ inputs.token }}
-
-    - name: Post agent comments
-      if: steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/apply-agent-comments
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        token: ${{ inputs.token }}
-
-    - name: Apply agent label changes
-      if: inputs.apply-labels == 'true' && steps.output.outputs.item-count != '0'
-      uses: ./.github/actions/apply-agent-labels
-      with:
-        output-file: ${{ steps.output.outputs.output-file }}
-        token: ${{ inputs.token }}
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/apply-agent-output/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Apply agent output
+description: Download the agent artifact and apply its safe outputs in one fixed order, so every worker concludes the same way.
+inputs:
+  token:
+    description: GitHub token the writes are made with.
+    required: true
+  artifact-name:
+    description: >-
+      Name of the agent artifact. Callers pass the activation job's artifact_prefix output
+      followed by "agent"; gh-aw derives that prefix from the workflow's inputs, so it is
+      non-empty for every workflow_call worker and the bare name never resolves.
+    required: true
+  merge-pull-request:
+    description: Apply merge_pull_request items.
+    required: false
+    default: 'false'
+  push-to-branch:
+    description: Apply push_to_pull_request_branch items.
+    required: false
+    default: 'false'
+  close-issues:
+    description: Apply close_issue items.
+    required: false
+    default: 'false'
+  create-issues:
+    description: Apply create_issue items.
+    required: false
+    default: 'false'
+  update-issues:
+    description: Apply update_issue items.
+    required: false
+    default: 'false'
+  apply-labels:
+    description: Apply add_labels and remove_labels items.
+    required: false
+    default: 'true'
+  fallback-issue-number:
+    description: Issue an update_issue item targets when it names none.
+    required: false
+    default: ''
+outputs:
+  item-count:
+    description: Number of items the agent produced.
+    value: ${{ steps.output.outputs.item-count }}
+  first-issue-number:
+    description: Issue number of the first issue created, or empty.
+    value: ${{ steps.create-issues.outputs.first-issue-number }}
+runs:
+  using: composite
+  steps:
+    - name: Download agent output
+      id: output
+      uses: ./.github/actions/download-agent-output
+      with:
+        artifact-name: ${{ inputs.artifact-name }}
+
+    - name: Merge pull request
+      if: inputs.merge-pull-request == 'true' && steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/merge-agent-pr
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        token: ${{ inputs.token }}
+
+    - name: Push to pull request branch
+      if: inputs.push-to-branch == 'true' && steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/push-agent-branch
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        bundle-file: ${{ steps.output.outputs.bundle-file }}
+        token: ${{ inputs.token }}
+
+    - name: Close issues
+      if: inputs.close-issues == 'true' && steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/close-agent-issues
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        token: ${{ inputs.token }}
+
+    - name: Update issues
+      if: inputs.update-issues == 'true' && steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/update-agent-issues
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        token: ${{ inputs.token }}
+        fallback-issue-number: ${{ inputs.fallback-issue-number }}
+
+    - name: Create issues
+      id: create-issues
+      if: inputs.create-issues == 'true' && steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/create-agent-issues
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        token: ${{ inputs.token }}
+
+    - name: Post agent comments
+      if: steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/apply-agent-comments
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        token: ${{ inputs.token }}
+
+    - name: Apply agent label changes
+      if: inputs.apply-labels == 'true' && steps.output.outputs.item-count != '0'
+      uses: ./.github/actions/apply-agent-labels
+      with:
+        output-file: ${{ steps.output.outputs.output-file }}
+        token: ${{ inputs.token }}

package/loops/actions/audit-close/action.yml

@@ -1,103 +1,104 @@
-name: Close audit reports
-description: Close open audit reports once every issue they reference is closed.
-inputs:
-  token:
-    description: GitHub token with issues write access.
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Close every report whose referenced issues are all closed
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const reports = await github.paginate(github.rest.issues.listForRepo, {
-            ...context.repo,
-            state: 'open',
-            labels: 'audit',
-            per_page: 100,
-          });
-
-          if (reports.length === 0) {
-            core.info('No open audit reports.');
-            return;
-          }
-
-          // Skip `owner/repo#12` and `abc#12`: only a bare `#12` references this repository.
-          const referencedIssues = (body) => {
-            const matches = (body ?? '').matchAll(/(?:^|[^A-Za-z0-9_/])#(\d+)/g);
-            return [...new Set([...matches].map((match) => Number(match[1])))];
-          };
-
-          let closed = 0;
-          let keptOpen = 0;
-
-          for (const report of reports.sort((a, b) => a.number - b.number)) {
-            const refs = referencedIssues(report.body).filter((n) => n !== report.number);
-
-            const stillOpen = [];
-            const unknown = [];
-            let closedRefs = 0;
-            let resolved = 0;
-
-            for (const ref of refs) {
-              let state;
-
-              try {
-                ({ data: { state } } = await github.rest.issues.get({
-                  ...context.repo,
-                  issue_number: ref,
-                }));
-              } catch (error) {
-                if (error.status === 404) {
-                  core.info(`#${report.number}: ignoring #${ref}, not an issue in this repository`);
-                  continue;
-                }
-                unknown.push(ref);
-                resolved += 1;
-                continue;
-              }
-
-              resolved += 1;
-              if (state === 'closed') closedRefs += 1;
-              else stillOpen.push(ref);
-            }
-
-            if (stillOpen.length > 0) {
-              core.info(`#${report.number}: kept open, still-open references: ${stillOpen.join(', ')}`);
-              keptOpen += 1;
-              continue;
-            }
-
-            if (unknown.length > 0) {
-              core.info(`#${report.number}: kept open, undetermined references: ${unknown.join(', ')}`);
-              keptOpen += 1;
-              continue;
-            }
-
-            const reason = resolved === 0
-              ? 'This report references no issues.'
-              : `All ${closedRefs} referenced issue(s) are closed.`;
-
-            await github.rest.issues.createComment({
-              ...context.repo,
-              issue_number: report.number,
-              body: `Closed automatically by \`Work Router: audit-close\`. ${reason}`,
-            });
-
-            await github.rest.issues.update({
-              ...context.repo,
-              issue_number: report.number,
-              state: 'closed',
-              state_reason: 'completed',
-            });
-
-            core.info(`#${report.number}: closed. ${reason}`);
-            closed += 1;
-          }
-
-          await core.summary
-            .addHeading('Audit close', 2)
-            .addList([`Reports closed: ${closed}`, `Reports left open: ${keptOpen}`])
-            .write();
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/audit-close/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Close audit reports
+description: Close open audit reports once every issue they reference is closed.
+inputs:
+  token:
+    description: GitHub token with issues write access.
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Close every report whose referenced issues are all closed
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const reports = await github.paginate(github.rest.issues.listForRepo, {
+            ...context.repo,
+            state: 'open',
+            labels: 'audit',
+            per_page: 100,
+          });
+
+          if (reports.length === 0) {
+            core.info('No open audit reports.');
+            return;
+          }
+
+          // Skip `owner/repo#12` and `abc#12`: only a bare `#12` references this repository.
+          const referencedIssues = (body) => {
+            const matches = (body ?? '').matchAll(/(?:^|[^A-Za-z0-9_/])#(\d+)/g);
+            return [...new Set([...matches].map((match) => Number(match[1])))];
+          };
+
+          let closed = 0;
+          let keptOpen = 0;
+
+          for (const report of reports.sort((a, b) => a.number - b.number)) {
+            const refs = referencedIssues(report.body).filter((n) => n !== report.number);
+
+            const stillOpen = [];
+            const unknown = [];
+            let closedRefs = 0;
+            let resolved = 0;
+
+            for (const ref of refs) {
+              let state;
+
+              try {
+                ({ data: { state } } = await github.rest.issues.get({
+                  ...context.repo,
+                  issue_number: ref,
+                }));
+              } catch (error) {
+                if (error.status === 404) {
+                  core.info(`#${report.number}: ignoring #${ref}, not an issue in this repository`);
+                  continue;
+                }
+                unknown.push(ref);
+                resolved += 1;
+                continue;
+              }
+
+              resolved += 1;
+              if (state === 'closed') closedRefs += 1;
+              else stillOpen.push(ref);
+            }
+
+            if (stillOpen.length > 0) {
+              core.info(`#${report.number}: kept open, still-open references: ${stillOpen.join(', ')}`);
+              keptOpen += 1;
+              continue;
+            }
+
+            if (unknown.length > 0) {
+              core.info(`#${report.number}: kept open, undetermined references: ${unknown.join(', ')}`);
+              keptOpen += 1;
+              continue;
+            }
+
+            const reason = resolved === 0
+              ? 'This report references no issues.'
+              : `All ${closedRefs} referenced issue(s) are closed.`;
+
+            await github.rest.issues.createComment({
+              ...context.repo,
+              issue_number: report.number,
+              body: `Closed automatically by \`Work Router: audit-close\`. ${reason}`,
+            });
+
+            await github.rest.issues.update({
+              ...context.repo,
+              issue_number: report.number,
+              state: 'closed',
+              state_reason: 'completed',
+            });
+
+            core.info(`#${report.number}: closed. ${reason}`);
+            closed += 1;
+          }
+
+          await core.summary
+            .addHeading('Audit close', 2)
+            .addList([`Reports closed: ${closed}`, `Reports left open: ${keptOpen}`])
+            .write();

package/loops/actions/classify-route/action.yml

@@ -1,90 +1,91 @@
-name: Classify route
-description: Classify the triggering event into exactly one route, and resolve the issue a gated pull request closes.
-inputs:
-  token:
-    description: GitHub token with pull-requests read access.
-    required: true
-outputs:
-  route:
-    description: The single route this event selects, or `none`.
-    value: ${{ steps.classify.outputs.route }}
-  issue-number:
-    description: Issue number the route operates on.
-    value: ${{ steps.classify.outputs.issue-number }}
-  pr-number:
-    description: Pull request number the route operates on.
-    value: ${{ steps.classify.outputs.pr-number }}
-  linked-issue:
-    description: Issue the pull request closes. Empty for routes that do not target one.
-    value: ${{ steps.linked-issue.outputs.issue }}
-  ci-conclusion:
-    description: Conclusion reported by the CI run that triggered a merge-gate route.
-    value: ${{ steps.classify.outputs.ci-conclusion }}
-  ci-run-id:
-    description: Workflow run ID of that CI run.
-    value: ${{ steps.classify.outputs.ci-run-id }}
-  refine-mode:
-    description: first or rerefine.
-    value: ${{ steps.classify.outputs.refine-mode }}
-  direct-mode:
-    description: first or continue.
-    value: ${{ steps.classify.outputs.direct-mode }}
-  trigger-kind:
-    description: scheduled or manual.
-    value: ${{ steps.classify.outputs.trigger-kind }}
-runs:
-  using: composite
-  steps:
-    - name: Classify the event
-      id: classify
-      shell: bash
-      env:
-        EVENT: ${{ github.event_name }}
-        ACTION: ${{ github.event.action }}
-        LABEL: ${{ github.event.label.name }}
-        ISSUE_LABELS: ${{ toJSON(github.event.issue.labels.*.name) }}
-        EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }}
-        EVENT_PR_NUMBER: ${{ github.event.pull_request.number }}
-        COMMENT_ON_PR: ${{ github.event.issue.pull_request != '' }}
-        COMMENT_SENDER_TYPE: ${{ github.event.comment.user.type }}
-        RUN_PR_NUMBER: ${{ github.event.workflow_run.pull_requests[0].number }}
-        RUN_CONCLUSION: ${{ github.event.workflow_run.conclusion }}
-        RUN_ID: ${{ github.event.workflow_run.id }}
-        SCHEDULE: ${{ github.event.schedule }}
-        OPERATION: ${{ github.event.inputs.operation }}
-        INPUT_ISSUE_NUMBER: ${{ github.event.inputs.issue-number }}
-        INPUT_PR_NUMBER: ${{ github.event.inputs.pr-number }}
-        INPUT_MODE: ${{ github.event.inputs.mode }}
-        INPUT_CI_CONCLUSION: ${{ github.event.inputs.ci-conclusion }}
-        INPUT_CI_RUN_ID: ${{ github.event.inputs.ci-run-id }}
-        INPUT_TRIGGER_KIND: ${{ github.event.inputs.trigger-kind }}
-      run: |
-        set -euo pipefail
-
-        bash "${GITHUB_ACTION_PATH}/classify-route.sh" | tee "$RUNNER_TEMP/route.env"
-        cat "$RUNNER_TEMP/route.env" >> "$GITHUB_OUTPUT"
-
-        route="$(sed -n 's/^route=//p' "$RUNNER_TEMP/route.env")"
-        reason="$(sed -n 's/^error=//p' "$RUNNER_TEMP/route.env")"
-
-        if [ "$route" = "none" ] && [ -n "$reason" ]; then
-          echo "::notice::No route for this event: $reason"
-        fi
-
-    - name: Resolve the issue the pull request closes
-      id: linked-issue
-      if: steps.classify.outputs.route == 'merge-gate' || steps.classify.outputs.route == 'apply-review'
-      shell: bash
-      env:
-        GH_TOKEN: ${{ inputs.token }}
-        REPO: ${{ github.repository }}
-        PR_NUMBER: ${{ steps.classify.outputs.pr-number }}
-      run: |
-        set -euo pipefail
-
-        issue="$(gh pr view "$PR_NUMBER" --repo "$REPO" \
-          --json closingIssuesReferences \
-          --jq '.closingIssuesReferences[0].number // empty')"
-
-        echo "issue=${issue}" >> "$GITHUB_OUTPUT"
-        echo "Pull request #${PR_NUMBER} closes issue #${issue:-<none>}"
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/classify-route/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Classify route
+description: Classify the triggering event into exactly one route, and resolve the issue a gated pull request closes.
+inputs:
+  token:
+    description: GitHub token with pull-requests read access.
+    required: true
+outputs:
+  route:
+    description: The single route this event selects, or `none`.
+    value: ${{ steps.classify.outputs.route }}
+  issue-number:
+    description: Issue number the route operates on.
+    value: ${{ steps.classify.outputs.issue-number }}
+  pr-number:
+    description: Pull request number the route operates on.
+    value: ${{ steps.classify.outputs.pr-number }}
+  linked-issue:
+    description: Issue the pull request closes. Empty for routes that do not target one.
+    value: ${{ steps.linked-issue.outputs.issue }}
+  ci-conclusion:
+    description: Conclusion reported by the CI run that triggered a merge-gate route.
+    value: ${{ steps.classify.outputs.ci-conclusion }}
+  ci-run-id:
+    description: Workflow run ID of that CI run.
+    value: ${{ steps.classify.outputs.ci-run-id }}
+  refine-mode:
+    description: first or rerefine.
+    value: ${{ steps.classify.outputs.refine-mode }}
+  direct-mode:
+    description: first or continue.
+    value: ${{ steps.classify.outputs.direct-mode }}
+  trigger-kind:
+    description: scheduled or manual.
+    value: ${{ steps.classify.outputs.trigger-kind }}
+runs:
+  using: composite
+  steps:
+    - name: Classify the event
+      id: classify
+      shell: bash
+      env:
+        EVENT: ${{ github.event_name }}
+        ACTION: ${{ github.event.action }}
+        LABEL: ${{ github.event.label.name }}
+        ISSUE_LABELS: ${{ toJSON(github.event.issue.labels.*.name) }}
+        EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }}
+        EVENT_PR_NUMBER: ${{ github.event.pull_request.number }}
+        COMMENT_ON_PR: ${{ github.event.issue.pull_request != '' }}
+        COMMENT_SENDER_TYPE: ${{ github.event.comment.user.type }}
+        RUN_PR_NUMBER: ${{ github.event.workflow_run.pull_requests[0].number }}
+        RUN_CONCLUSION: ${{ github.event.workflow_run.conclusion }}
+        RUN_ID: ${{ github.event.workflow_run.id }}
+        SCHEDULE: ${{ github.event.schedule }}
+        OPERATION: ${{ github.event.inputs.operation }}
+        INPUT_ISSUE_NUMBER: ${{ github.event.inputs.issue-number }}
+        INPUT_PR_NUMBER: ${{ github.event.inputs.pr-number }}
+        INPUT_MODE: ${{ github.event.inputs.mode }}
+        INPUT_CI_CONCLUSION: ${{ github.event.inputs.ci-conclusion }}
+        INPUT_CI_RUN_ID: ${{ github.event.inputs.ci-run-id }}
+        INPUT_TRIGGER_KIND: ${{ github.event.inputs.trigger-kind }}
+      run: |
+        set -euo pipefail
+
+        bash "${GITHUB_ACTION_PATH}/classify-route.sh" | tee "$RUNNER_TEMP/route.env"
+        cat "$RUNNER_TEMP/route.env" >> "$GITHUB_OUTPUT"
+
+        route="$(sed -n 's/^route=//p' "$RUNNER_TEMP/route.env")"
+        reason="$(sed -n 's/^error=//p' "$RUNNER_TEMP/route.env")"
+
+        if [ "$route" = "none" ] && [ -n "$reason" ]; then
+          echo "::notice::No route for this event: $reason"
+        fi
+
+    - name: Resolve the issue the pull request closes
+      id: linked-issue
+      if: steps.classify.outputs.route == 'merge-gate' || steps.classify.outputs.route == 'apply-review'
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.token }}
+        REPO: ${{ github.repository }}
+        PR_NUMBER: ${{ steps.classify.outputs.pr-number }}
+      run: |
+        set -euo pipefail
+
+        issue="$(gh pr view "$PR_NUMBER" --repo "$REPO" \
+          --json closingIssuesReferences \
+          --jq '.closingIssuesReferences[0].number // empty')"
+
+        echo "issue=${issue}" >> "$GITHUB_OUTPUT"
+        echo "Pull request #${PR_NUMBER} closes issue #${issue:-<none>}"

package/loops/actions/classify-route/classify-route.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/classify-route/classify-route.sh. Update with `workflows update --force`; consumer edits may be overwritten.
 # Classify one GitHub event into exactly one route. Pure: no network, no gh calls, so
 # verify-route-matrix.sh can source this file and exercise the same code the router runs.
 #