@plainconceptsplatform/workflows 0.1.2 → 0.1.5

package/loops/actions/stale-recovery/action.yml

@@ -1,287 +1,288 @@
-name: Recover stale agent work
-description: Reconcile Refine, Implement, and Merge Gate claims whose bot-working label has outlived the staleness threshold, and dispatch merge-gate for bot PRs with failed CI.
-inputs:
-  token:
-    description: GitHub token with issues write and pull-requests read access.
-    required: true
-  stale-threshold-hours:
-    description: Hours after which a bot-working claim is stale. Invalid or empty values use 2.
-    required: false
-    default: ''
-  refine-marker:
-    description: Marker identifying the comment a Refine run posts when it asks the author a question.
-    required: false
-    default: '<!-- agent-refine -->'
-  working-label:
-    description: Label marking an issue the bot currently owns.
-    required: false
-    default: bot-working
-  refine-label:
-    description: Label marking an issue queued for refinement.
-    required: false
-    default: refine
-  direct-label:
-    description: Label marking an issue with a free-form direct instruction.
-    required: false
-    default: direct
-  implement-label:
-    description: Label marking an issue queued for implementation.
-    required: false
-    default: implement
-  review-label:
-    description: Label marking an issue that needs a human.
-    required: false
-    default: review
-  ci-workflow-name:
-    description: Name of the CI workflow whose failure should trigger a merge-gate dispatch.
-    required: false
-    default: 'App: CI'
-  router-workflow-name:
-    description: Name of the work router workflow to dispatch.
-    required: false
-    default: 'All Work Router'
-runs:
-  using: composite
-  steps:
-    - name: Reconcile stale claims
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        STALE_THRESHOLD_HOURS: ${{ inputs.stale-threshold-hours }}
-        REFINE_MARKER: ${{ inputs.refine-marker }}
-        WORKING_LABEL: ${{ inputs.working-label }}
-        REFINE_LABEL: ${{ inputs.refine-label }}
-        DIRECT_LABEL: ${{ inputs.direct-label }}
-        IMPLEMENT_LABEL: ${{ inputs.implement-label }}
-        REVIEW_LABEL: ${{ inputs.review-label }}
-        CI_WORKFLOW_NAME: ${{ inputs.ci-workflow-name }}
-        ROUTER_WORKFLOW_NAME: ${{ inputs.router-workflow-name }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const WORKING = process.env.WORKING_LABEL;
-          const REVIEW = process.env.REVIEW_LABEL;
-          const MARKER = process.env.REFINE_MARKER;
-          const CI_WORKFLOW_NAME = process.env.CI_WORKFLOW_NAME;
-          const ROUTER_WORKFLOW_NAME = process.env.ROUTER_WORKFLOW_NAME;
-
-          const parsedHours = Number.parseInt(process.env.STALE_THRESHOLD_HOURS, 10);
-          const hours = Number.isInteger(parsedHours) && parsedHours > 0 ? parsedHours : 2;
-          const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000);
-
-          core.info(`Stale threshold: ${hours}h (cutoff ${cutoff.toISOString()})`);
-
-          const staleIssuesLabelled = async (label) => {
-            const issues = await github.paginate(github.rest.issues.listForRepo, {
-              ...context.repo,
-              state: 'open',
-              labels: `${WORKING},${label}`,
-              per_page: 100,
-            });
-
-            return issues.filter((issue) => new Date(issue.updated_at) < cutoff);
-          };
-
-          const removeWorking = async (issueNumber) => {
-            try {
-              await github.rest.issues.removeLabel({
-                ...context.repo,
-                issue_number: issueNumber,
-                name: WORKING,
-              });
-            } catch (error) {
-              if (error.status !== 404) throw error;
-            }
-          };
-
-          // Open bot pull requests keep work in flight. GraphQL exposes authorship and closing
-          // references together, so use `__typename` instead of matching a login.
-          const openPullRequests = [];
-
-          for (let cursor = null; ; ) {
-            const page = await github.graphql(
-              `query($owner: String!, $name: String!, $cursor: String) {
-                repository(owner: $owner, name: $name) {
-                  pullRequests(states: OPEN, first: 100, after: $cursor) {
-                    pageInfo { hasNextPage endCursor }
-                    nodes {
-                      number
-                      updatedAt
-                      author { __typename }
-                      closingIssuesReferences(first: 10) {
-                        nodes { number labels(first: 20) { nodes { name } } }
-                      }
-                    }
-                  }
-                }
-              }`,
-              { owner: context.repo.owner, name: context.repo.repo, cursor },
-            );
-
-            const { nodes, pageInfo } = page.repository.pullRequests;
-            openPullRequests.push(...nodes);
-
-            if (!pageInfo.hasNextPage) break;
-            cursor = pageInfo.endCursor;
-          }
-
-          const botPullRequests = openPullRequests.filter(
-            (pr) => pr.author?.__typename === 'Bot',
-          );
-
-          const issuesWithOpenBotPr = new Set(
-            botPullRequests.flatMap((pr) => pr.closingIssuesReferences.nodes.map((n) => n.number)),
-          );
-
-          const summary = {
-            refineEscalated: 0,
-            refineAwaitingAuthor: 0,
-            implementReleased: 0,
-            directReleased: 0,
-            mergeGateReleased: 0,
-            mergeGateDispatched: 0,
-          };
-
-          for (const issue of await staleIssuesLabelled(process.env.REFINE_LABEL)) {
-            const comments = await github.paginate(github.rest.issues.listComments, {
-              ...context.repo,
-              issue_number: issue.number,
-              per_page: 100,
-            });
-
-            const lastMarker = comments.filter((c) => (c.body ?? '').includes(MARKER)).pop();
-            const lastHuman = comments.filter((c) => c.user?.type !== 'Bot').pop();
-
-            // The bot asked a question nobody has answered yet. Escalating would drop the
-            // question on the floor, so leave the claim in place.
-            if (lastMarker && !(lastHuman && new Date(lastHuman.created_at) > new Date(lastMarker.created_at))) {
-              core.info(`#${issue.number}: awaiting author reply, left alone`);
-              summary.refineAwaitingAuthor += 1;
-              continue;
-            }
-
-            await removeWorking(issue.number);
-            await github.rest.issues.addLabels({
-              ...context.repo,
-              issue_number: issue.number,
-              labels: [REVIEW],
-            });
-
-            core.info(`#${issue.number}: escalated to ${REVIEW}`);
-            summary.refineEscalated += 1;
-          }
-
-          for (const issue of await staleIssuesLabelled(process.env.IMPLEMENT_LABEL)) {
-            if (issuesWithOpenBotPr.has(issue.number)) {
-              core.info(`#${issue.number}: open bot pull request still in flight, left alone`);
-              continue;
-            }
-
-            await removeWorking(issue.number);
-            core.info(`#${issue.number}: released`);
-            summary.implementReleased += 1;
-          }
-
-          for (const issue of await staleIssuesLabelled(process.env.DIRECT_LABEL)) {
-            if (issuesWithOpenBotPr.has(issue.number)) {
-              core.info(`#${issue.number}: open bot pull request still in flight, left alone`);
-              continue;
-            }
-
-            await removeWorking(issue.number);
-            await github.rest.issues.addLabels({
-              ...context.repo,
-              issue_number: issue.number,
-              labels: [REVIEW],
-            });
-            core.info(`#${issue.number}: direct released, escalated to ${REVIEW}`);
-            summary.directReleased += 1;
-          }
-
-          for (const pr of botPullRequests.filter((p) => new Date(p.updatedAt) < cutoff)) {
-            for (const issue of pr.closingIssuesReferences.nodes) {
-              if (!issue.labels.nodes.some((label) => label.name === WORKING)) {
-                continue;
-              }
-
-              await removeWorking(issue.number);
-              core.info(`PR #${pr.number} / issue #${issue.number}: released`);
-              summary.mergeGateReleased += 1;
-            }
-          }
-
-          // The workflow_run trigger does not fire for PR-triggered CI completions on
-          // feature branches. This polls every stale-recovery cycle (2h) for bot PRs
-          // whose CI concluded failure and dispatches the merge-gate, which is the same
-          // thing the workflow_run trigger would have done. A run already in progress
-          // for the same PR is skipped by the router's concurrency group.
-          const ciWorkflow = await github.rest.actions.getRepoWorkflow({
-            ...context.repo,
-            workflow_id: CI_WORKFLOW_NAME,
-          }).catch(() => null);
-
-          if (ciWorkflow) {
-            for (const pr of botPullRequests) {
-              const runs = await github.rest.actions.listWorkflowRuns({
-                ...context.repo,
-                workflow_id: CI_WORKFLOW_NAME,
-                branch: pr.number.toString(),
-                status: 'completed',
-                per_page: 1,
-              }).catch(() => ({ data: { workflow_runs: [] } }));
-
-              const latestRun = runs.data.workflow_runs[0];
-              if (!latestRun || latestRun.conclusion !== 'failure') continue;
-
-              // Skip if the issue already carries review (the agent already gave up).
-              const issueNumbers = pr.closingIssuesReferences.nodes.map((n) => n.number);
-              const hasReview = await Promise.all(
-                issueNumbers.map(async (n) => {
-                  const labels = await github.rest.issues.listLabelsOnIssue({
-                    ...context.repo,
-                    issue_number: n,
-                  }).catch(() => ({ data: [] }));
-                  return labels.data.some((l) => l.name === REVIEW);
-                }),
-              );
-              if (hasReview.some(Boolean)) continue;
-
-              const routerWorkflow = await github.rest.actions.getRepoWorkflow({
-                ...context.repo,
-                workflow_id: ROUTER_WORKFLOW_NAME,
-              }).catch(() => null);
-
-              if (routerWorkflow) {
-                // Resolve the linked issue number for the dispatch.
-                const linkedIssue = issueNumbers[0];
-                if (!linkedIssue) continue;
-
-                await github.rest.actions.createWorkflowDispatch({
-                  ...context.repo,
-                  workflow_id: ROUTER_WORKFLOW_NAME,
-                  ref: 'main',
-                  inputs: {
-                    operation: 'merge-gate',
-                    'pr-number': pr.number.toString(),
-                    'ci-conclusion': 'failure',
-                    'ci-run-id': latestRun.id.toString(),
-                  },
-                });
-
-                core.info(`PR #${pr.number}: dispatched merge-gate for failed CI (run ${latestRun.id})`);
-                summary.mergeGateDispatched += 1;
-              }
-            }
-          }
-
-          await core.summary
-            .addHeading('Stale recovery', 2)
-            .addList([
-              `Threshold: ${hours} hours (cutoff ${cutoff.toISOString()})`,
-              `Refine escalated to ${REVIEW}: ${summary.refineEscalated}`,
-              `Refine awaiting author: ${summary.refineAwaitingAuthor}`,
-              `Implement released: ${summary.implementReleased}`,
-              `Direct released: ${summary.directReleased}`,
-              `Merge Gate released: ${summary.mergeGateReleased}`,
-              `Merge Gate dispatched for failed CI: ${summary.mergeGateDispatched}`,
-            ])
-            .write();
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/stale-recovery/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Recover stale agent work
+description: Reconcile Refine, Implement, and Merge Gate claims whose bot-working label has outlived the staleness threshold, and dispatch merge-gate for bot PRs with failed CI.
+inputs:
+  token:
+    description: GitHub token with issues write and pull-requests read access.
+    required: true
+  stale-threshold-hours:
+    description: Hours after which a bot-working claim is stale. Invalid or empty values use 2.
+    required: false
+    default: ''
+  refine-marker:
+    description: Marker identifying the comment a Refine run posts when it asks the author a question.
+    required: false
+    default: '<!-- agent-refine -->'
+  working-label:
+    description: Label marking an issue the bot currently owns.
+    required: false
+    default: bot-working
+  refine-label:
+    description: Label marking an issue queued for refinement.
+    required: false
+    default: refine
+  direct-label:
+    description: Label marking an issue with a free-form direct instruction.
+    required: false
+    default: direct
+  implement-label:
+    description: Label marking an issue queued for implementation.
+    required: false
+    default: implement
+  review-label:
+    description: Label marking an issue that needs a human.
+    required: false
+    default: review
+  ci-workflow-name:
+    description: Name of the CI workflow whose failure should trigger a merge-gate dispatch.
+    required: false
+    default: 'App: CI'
+  router-workflow-name:
+    description: Name of the work router workflow to dispatch.
+    required: false
+    default: 'All Work Router'
+runs:
+  using: composite
+  steps:
+    - name: Reconcile stale claims
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        STALE_THRESHOLD_HOURS: ${{ inputs.stale-threshold-hours }}
+        REFINE_MARKER: ${{ inputs.refine-marker }}
+        WORKING_LABEL: ${{ inputs.working-label }}
+        REFINE_LABEL: ${{ inputs.refine-label }}
+        DIRECT_LABEL: ${{ inputs.direct-label }}
+        IMPLEMENT_LABEL: ${{ inputs.implement-label }}
+        REVIEW_LABEL: ${{ inputs.review-label }}
+        CI_WORKFLOW_NAME: ${{ inputs.ci-workflow-name }}
+        ROUTER_WORKFLOW_NAME: ${{ inputs.router-workflow-name }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const WORKING = process.env.WORKING_LABEL;
+          const REVIEW = process.env.REVIEW_LABEL;
+          const MARKER = process.env.REFINE_MARKER;
+          const CI_WORKFLOW_NAME = process.env.CI_WORKFLOW_NAME;
+          const ROUTER_WORKFLOW_NAME = process.env.ROUTER_WORKFLOW_NAME;
+
+          const parsedHours = Number.parseInt(process.env.STALE_THRESHOLD_HOURS, 10);
+          const hours = Number.isInteger(parsedHours) && parsedHours > 0 ? parsedHours : 2;
+          const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000);
+
+          core.info(`Stale threshold: ${hours}h (cutoff ${cutoff.toISOString()})`);
+
+          const staleIssuesLabelled = async (label) => {
+            const issues = await github.paginate(github.rest.issues.listForRepo, {
+              ...context.repo,
+              state: 'open',
+              labels: `${WORKING},${label}`,
+              per_page: 100,
+            });
+
+            return issues.filter((issue) => new Date(issue.updated_at) < cutoff);
+          };
+
+          const removeWorking = async (issueNumber) => {
+            try {
+              await github.rest.issues.removeLabel({
+                ...context.repo,
+                issue_number: issueNumber,
+                name: WORKING,
+              });
+            } catch (error) {
+              if (error.status !== 404) throw error;
+            }
+          };
+
+          // Open bot pull requests keep work in flight. GraphQL exposes authorship and closing
+          // references together, so use `__typename` instead of matching a login.
+          const openPullRequests = [];
+
+          for (let cursor = null; ; ) {
+            const page = await github.graphql(
+              `query($owner: String!, $name: String!, $cursor: String) {
+                repository(owner: $owner, name: $name) {
+                  pullRequests(states: OPEN, first: 100, after: $cursor) {
+                    pageInfo { hasNextPage endCursor }
+                    nodes {
+                      number
+                      updatedAt
+                      author { __typename }
+                      closingIssuesReferences(first: 10) {
+                        nodes { number labels(first: 20) { nodes { name } } }
+                      }
+                    }
+                  }
+                }
+              }`,
+              { owner: context.repo.owner, name: context.repo.repo, cursor },
+            );
+
+            const { nodes, pageInfo } = page.repository.pullRequests;
+            openPullRequests.push(...nodes);
+
+            if (!pageInfo.hasNextPage) break;
+            cursor = pageInfo.endCursor;
+          }
+
+          const botPullRequests = openPullRequests.filter(
+            (pr) => pr.author?.__typename === 'Bot',
+          );
+
+          const issuesWithOpenBotPr = new Set(
+            botPullRequests.flatMap((pr) => pr.closingIssuesReferences.nodes.map((n) => n.number)),
+          );
+
+          const summary = {
+            refineEscalated: 0,
+            refineAwaitingAuthor: 0,
+            implementReleased: 0,
+            directReleased: 0,
+            mergeGateReleased: 0,
+            mergeGateDispatched: 0,
+          };
+
+          for (const issue of await staleIssuesLabelled(process.env.REFINE_LABEL)) {
+            const comments = await github.paginate(github.rest.issues.listComments, {
+              ...context.repo,
+              issue_number: issue.number,
+              per_page: 100,
+            });
+
+            const lastMarker = comments.filter((c) => (c.body ?? '').includes(MARKER)).pop();
+            const lastHuman = comments.filter((c) => c.user?.type !== 'Bot').pop();
+
+            // The bot asked a question nobody has answered yet. Escalating would drop the
+            // question on the floor, so leave the claim in place.
+            if (lastMarker && !(lastHuman && new Date(lastHuman.created_at) > new Date(lastMarker.created_at))) {
+              core.info(`#${issue.number}: awaiting author reply, left alone`);
+              summary.refineAwaitingAuthor += 1;
+              continue;
+            }
+
+            await removeWorking(issue.number);
+            await github.rest.issues.addLabels({
+              ...context.repo,
+              issue_number: issue.number,
+              labels: [REVIEW],
+            });
+
+            core.info(`#${issue.number}: escalated to ${REVIEW}`);
+            summary.refineEscalated += 1;
+          }
+
+          for (const issue of await staleIssuesLabelled(process.env.IMPLEMENT_LABEL)) {
+            if (issuesWithOpenBotPr.has(issue.number)) {
+              core.info(`#${issue.number}: open bot pull request still in flight, left alone`);
+              continue;
+            }
+
+            await removeWorking(issue.number);
+            core.info(`#${issue.number}: released`);
+            summary.implementReleased += 1;
+          }
+
+          for (const issue of await staleIssuesLabelled(process.env.DIRECT_LABEL)) {
+            if (issuesWithOpenBotPr.has(issue.number)) {
+              core.info(`#${issue.number}: open bot pull request still in flight, left alone`);
+              continue;
+            }
+
+            await removeWorking(issue.number);
+            await github.rest.issues.addLabels({
+              ...context.repo,
+              issue_number: issue.number,
+              labels: [REVIEW],
+            });
+            core.info(`#${issue.number}: direct released, escalated to ${REVIEW}`);
+            summary.directReleased += 1;
+          }
+
+          for (const pr of botPullRequests.filter((p) => new Date(p.updatedAt) < cutoff)) {
+            for (const issue of pr.closingIssuesReferences.nodes) {
+              if (!issue.labels.nodes.some((label) => label.name === WORKING)) {
+                continue;
+              }
+
+              await removeWorking(issue.number);
+              core.info(`PR #${pr.number} / issue #${issue.number}: released`);
+              summary.mergeGateReleased += 1;
+            }
+          }
+
+          // The workflow_run trigger does not fire for PR-triggered CI completions on
+          // feature branches. This polls every stale-recovery cycle (2h) for bot PRs
+          // whose CI concluded failure and dispatches the merge-gate, which is the same
+          // thing the workflow_run trigger would have done. A run already in progress
+          // for the same PR is skipped by the router's concurrency group.
+          const ciWorkflow = await github.rest.actions.getWorkflow({
+            ...context.repo,
+            workflow_id: CI_WORKFLOW_NAME,
+          }).catch(() => null);
+
+          if (ciWorkflow) {
+            for (const pr of botPullRequests) {
+              const runs = await github.rest.actions.listWorkflowRuns({
+                ...context.repo,
+                workflow_id: CI_WORKFLOW_NAME,
+                branch: pr.number.toString(),
+                status: 'completed',
+                per_page: 1,
+              }).catch(() => ({ data: { workflow_runs: [] } }));
+
+              const latestRun = runs.data.workflow_runs[0];
+              if (!latestRun || latestRun.conclusion !== 'failure') continue;
+
+              // Skip if the issue already carries review (the agent already gave up).
+              const issueNumbers = pr.closingIssuesReferences.nodes.map((n) => n.number);
+              const hasReview = await Promise.all(
+                issueNumbers.map(async (n) => {
+                  const labels = await github.rest.issues.listLabelsOnIssue({
+                    ...context.repo,
+                    issue_number: n,
+                  }).catch(() => ({ data: [] }));
+                  return labels.data.some((l) => l.name === REVIEW);
+                }),
+              );
+              if (hasReview.some(Boolean)) continue;
+
+              const routerWorkflow = await github.rest.actions.getWorkflow({
+                ...context.repo,
+                workflow_id: ROUTER_WORKFLOW_NAME,
+              }).catch(() => null);
+
+              if (routerWorkflow) {
+                // Resolve the linked issue number for the dispatch.
+                const linkedIssue = issueNumbers[0];
+                if (!linkedIssue) continue;
+
+                await github.rest.actions.createWorkflowDispatch({
+                  ...context.repo,
+                  workflow_id: ROUTER_WORKFLOW_NAME,
+                  ref: 'main',
+                  inputs: {
+                    operation: 'merge-gate',
+                    'pr-number': pr.number.toString(),
+                    'ci-conclusion': 'failure',
+                    'ci-run-id': latestRun.id.toString(),
+                  },
+                });
+
+                core.info(`PR #${pr.number}: dispatched merge-gate for failed CI (run ${latestRun.id})`);
+                summary.mergeGateDispatched += 1;
+              }
+            }
+          }
+
+          await core.summary
+            .addHeading('Stale recovery', 2)
+            .addList([
+              `Threshold: ${hours} hours (cutoff ${cutoff.toISOString()})`,
+              `Refine escalated to ${REVIEW}: ${summary.refineEscalated}`,
+              `Refine awaiting author: ${summary.refineAwaitingAuthor}`,
+              `Implement released: ${summary.implementReleased}`,
+              `Direct released: ${summary.directReleased}`,
+              `Merge Gate released: ${summary.mergeGateReleased}`,
+              `Merge Gate dispatched for failed CI: ${summary.mergeGateDispatched}`,
+            ])
+            .write();