@plainconceptsplatform/workflows 0.1.1 → 0.1.5

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.
 #

package/loops/actions/cleanup-artifacts/action.yml

@@ -1,64 +1,65 @@
-name: Clean up artifacts
-description: Delete workflow artifacts older than the configured retention period.
-inputs:
-  token:
-    description: GitHub token with actions write access.
-    required: true
-  artifact-retention-days:
-    description: Retention period in days. Invalid or empty values use 3.
-    required: false
-    default: ''
-runs:
-  using: composite
-  steps:
-    - name: Delete expired artifacts
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        ARTIFACT_RETENTION_DAYS: ${{ inputs.artifact-retention-days }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const parsedDays = Number.parseInt(process.env.ARTIFACT_RETENTION_DAYS, 10);
-          const days = Number.isInteger(parsedDays) && parsedDays > 0 ? parsedDays : 3;
-          const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
-
-          core.info(`Retention: ${days} days (cutoff ${cutoff.toISOString()})`);
-
-          const artifacts = await github.paginate(github.rest.actions.listArtifactsForRepo, {
-            ...context.repo,
-            per_page: 100,
-          });
-
-          const expired = artifacts.filter((artifact) => new Date(artifact.created_at) < cutoff);
-
-          let deleted = 0;
-          const failed = [];
-
-          for (const artifact of expired) {
-            try {
-              await github.rest.actions.deleteArtifact({
-                ...context.repo,
-                artifact_id: artifact.id,
-              });
-
-              core.info(`Deleted ${artifact.name} (created ${artifact.created_at})`);
-              deleted += 1;
-            } catch (error) {
-              core.warning(`Could not delete ${artifact.name} (${artifact.id}): ${error.message}`);
-              failed.push(artifact.name);
-            }
-          }
-
-          await core.summary
-            .addHeading('Artifact cleanup', 2)
-            .addList([
-              `Retention: ${days} days (cutoff ${cutoff.toISOString()})`,
-              `Deleted: ${deleted}`,
-              `Failed to delete: ${failed.length}`,
-              `Within retention: ${artifacts.length - expired.length}`,
-            ])
-            .write();
-
-          if (failed.length > 0) {
-            core.setFailed(`${failed.length} artifact(s) could not be deleted: ${failed.join(', ')}`);
-          }
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/cleanup-artifacts/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Clean up artifacts
+description: Delete workflow artifacts older than the configured retention period.
+inputs:
+  token:
+    description: GitHub token with actions write access.
+    required: true
+  artifact-retention-days:
+    description: Retention period in days. Invalid or empty values use 3.
+    required: false
+    default: ''
+runs:
+  using: composite
+  steps:
+    - name: Delete expired artifacts
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        ARTIFACT_RETENTION_DAYS: ${{ inputs.artifact-retention-days }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const parsedDays = Number.parseInt(process.env.ARTIFACT_RETENTION_DAYS, 10);
+          const days = Number.isInteger(parsedDays) && parsedDays > 0 ? parsedDays : 3;
+          const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+
+          core.info(`Retention: ${days} days (cutoff ${cutoff.toISOString()})`);
+
+          const artifacts = await github.paginate(github.rest.actions.listArtifactsForRepo, {
+            ...context.repo,
+            per_page: 100,
+          });
+
+          const expired = artifacts.filter((artifact) => new Date(artifact.created_at) < cutoff);
+
+          let deleted = 0;
+          const failed = [];
+
+          for (const artifact of expired) {
+            try {
+              await github.rest.actions.deleteArtifact({
+                ...context.repo,
+                artifact_id: artifact.id,
+              });
+
+              core.info(`Deleted ${artifact.name} (created ${artifact.created_at})`);
+              deleted += 1;
+            } catch (error) {
+              core.warning(`Could not delete ${artifact.name} (${artifact.id}): ${error.message}`);
+              failed.push(artifact.name);
+            }
+          }
+
+          await core.summary
+            .addHeading('Artifact cleanup', 2)
+            .addList([
+              `Retention: ${days} days (cutoff ${cutoff.toISOString()})`,
+              `Deleted: ${deleted}`,
+              `Failed to delete: ${failed.length}`,
+              `Within retention: ${artifacts.length - expired.length}`,
+            ])
+            .write();
+
+          if (failed.length > 0) {
+            core.setFailed(`${failed.length} artifact(s) could not be deleted: ${failed.join(', ')}`);
+          }

package/loops/actions/close-agent-issues/action.yml

@@ -1,42 +1,43 @@
-name: Close agent issues
-description: Close every close_issue item from agent_output.json.
-inputs:
-  output-file:
-    description: Path to agent_output.json.
-    required: true
-  token:
-    description: GitHub token with issues:write.
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Close issues
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
-        OUTPUT_FILE: ${{ inputs.output-file }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
-          const items = readAgentItems(process.env.OUTPUT_FILE, 'close_issue');
-
-          let closed = 0;
-
-          for (const item of items) {
-            if (!item.item_number) {
-              core.warning(`close_issue item has no item_number, skipping: ${JSON.stringify(item)}`);
-              continue;
-            }
-
-            await github.rest.issues.update({
-              ...context.repo,
-              issue_number: Number(item.item_number),
-              state: 'closed',
-              state_reason: item.state_reason === 'not_planned' ? 'not_planned' : 'completed',
-            });
-
-            closed += 1;
-          }
-
-          core.info(`Closed ${closed} issue(s).`);
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/close-agent-issues/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Close agent issues
+description: Close every close_issue item from agent_output.json.
+inputs:
+  output-file:
+    description: Path to agent_output.json.
+    required: true
+  token:
+    description: GitHub token with issues:write.
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Close issues
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
+        OUTPUT_FILE: ${{ inputs.output-file }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
+          const items = readAgentItems(process.env.OUTPUT_FILE, 'close_issue');
+
+          let closed = 0;
+
+          for (const item of items) {
+            if (!item.item_number) {
+              core.warning(`close_issue item has no item_number, skipping: ${JSON.stringify(item)}`);
+              continue;
+            }
+
+            await github.rest.issues.update({
+              ...context.repo,
+              issue_number: Number(item.item_number),
+              state: 'closed',
+              state_reason: item.state_reason === 'not_planned' ? 'not_planned' : 'completed',
+            });
+
+            closed += 1;
+          }
+
+          core.info(`Closed ${closed} issue(s).`);

package/loops/actions/create-agent-issues/action.yml

@@ -1,51 +1,52 @@
-name: Create agent issues
-description: Create every create_issue item from agent_output.json.
-inputs:
-  output-file:
-    description: Path to agent_output.json.
-    required: true
-  token:
-    description: GitHub token with issues:write.
-    required: true
-outputs:
-  created-count:
-    description: Number of issues created.
-    value: ${{ steps.create.outputs.created-count }}
-  first-issue-number:
-    description: Issue number of the first issue created, or empty.
-    value: ${{ steps.create.outputs.first-issue-number }}
-runs:
-  using: composite
-  steps:
-    - name: Create issues
-      id: create
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
-        OUTPUT_FILE: ${{ inputs.output-file }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
-          const items = readAgentItems(process.env.OUTPUT_FILE, 'create_issue');
-
-          const created = [];
-
-          for (const item of items) {
-            if (!item.title) {
-              core.warning(`create_issue item has no title, skipping: ${JSON.stringify(item)}`);
-              continue;
-            }
-
-            const { data } = await github.rest.issues.create({
-              ...context.repo,
-              title: item.title,
-              body: item.body ?? '',
-            });
-
-            created.push(data.number);
-            core.info(`Created #${data.number}: ${item.title}`);
-          }
-
-          core.setOutput('created-count', String(created.length));
-          core.setOutput('first-issue-number', created.length > 0 ? String(created[0]) : '');
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/create-agent-issues/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Create agent issues
+description: Create every create_issue item from agent_output.json.
+inputs:
+  output-file:
+    description: Path to agent_output.json.
+    required: true
+  token:
+    description: GitHub token with issues:write.
+    required: true
+outputs:
+  created-count:
+    description: Number of issues created.
+    value: ${{ steps.create.outputs.created-count }}
+  first-issue-number:
+    description: Issue number of the first issue created, or empty.
+    value: ${{ steps.create.outputs.first-issue-number }}
+runs:
+  using: composite
+  steps:
+    - name: Create issues
+      id: create
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
+        OUTPUT_FILE: ${{ inputs.output-file }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
+          const items = readAgentItems(process.env.OUTPUT_FILE, 'create_issue');
+
+          const created = [];
+
+          for (const item of items) {
+            if (!item.title) {
+              core.warning(`create_issue item has no title, skipping: ${JSON.stringify(item)}`);
+              continue;
+            }
+
+            const { data } = await github.rest.issues.create({
+              ...context.repo,
+              title: item.title,
+              body: item.body ?? '',
+            });
+
+            created.push(data.number);
+            core.info(`Created #${data.number}: ${item.title}`);
+          }
+
+          core.setOutput('created-count', String(created.length));
+          core.setOutput('first-issue-number', created.length > 0 ? String(created[0]) : '');

package/loops/actions/create-issue-comment/action.yml

@@ -1,28 +1,29 @@
-name: Create issue comment
-description: Create a comment on an issue or pull request.
-inputs:
-  token:
-    description: GitHub token used by github-script.
-    required: true
-  issue-number:
-    description: Issue or pull request number.
-    required: true
-  body:
-    description: Complete Markdown comment body.
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Create comment
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        ISSUE_NUMBER: ${{ inputs.issue-number }}
-        BODY: ${{ inputs.body }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          await github.rest.issues.createComment({
-            ...context.repo,
-            issue_number: Number(process.env.ISSUE_NUMBER),
-            body: process.env.BODY,
-          });
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/create-issue-comment/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Create issue comment
+description: Create a comment on an issue or pull request.
+inputs:
+  token:
+    description: GitHub token used by github-script.
+    required: true
+  issue-number:
+    description: Issue or pull request number.
+    required: true
+  body:
+    description: Complete Markdown comment body.
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Create comment
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        ISSUE_NUMBER: ${{ inputs.issue-number }}
+        BODY: ${{ inputs.body }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          await github.rest.issues.createComment({
+            ...context.repo,
+            issue_number: Number(process.env.ISSUE_NUMBER),
+            body: process.env.BODY,
+          });