JS-driven monthly triage and weekly issue review automation

.github/actions/triage-issues/action.yml

@@ -0,0 +1,101 @@
+name: "triage-issue"
+description: "Composite action to create monthly triage issue and optionally close previous month"
+inputs:
+  close-previous:
+    description: "Whether to close last month’s triage issue (true/false)"
+    required: false
+    default: "true"
+  label:
+    description: "Label to apply to triage issue"
+    required: false
+    default: "triage"
+  body-template:
+    description: "Custom body template (supports {{MONTH}} placeholder)"
+    required: false
+    default: |
+      ### Monthly GitHub Triage – {{MONTH}}
+
+      This automatically generated issue tracks triage activities for {{MONTH}}.
+
+      **Purpose**
+      - Collect new issues for classification.
+      - Track placeholders.
+      - Consolidate duplicates.
+
+      **Automation**
+      - Weekly summary comments (companion workflow).
+      - Future enhancements: stale detection, cross-links.
+
+      :octocat: :copilot: Created automatically.
+runs:
+  using: "composite"
+  steps:
+    - name: Compute dates
+      id: dates
+      shell: bash
+      run: |
+        CURR=$(date -u +'%Y-%m')
+        PREV=$(date -u -d "$(date -u +%Y-%m-01) -1 month" +'%Y-%m')
+        echo "curr=$CURR" >> $GITHUB_OUTPUT
+        echo "prev=$PREV" >> $GITHUB_OUTPUT
+
+    - name: Ensure triage issue
+      uses: actions/github-script@v7
+      with:
+        script: |
+          const closePrev = (process.env.INPUT_CLOSE_PREVIOUS || 'true').toLowerCase() === 'true';
+          const label = process.env.INPUT_LABEL || 'triage';
+          const bodyTemplate = process.env.INPUT_BODY_TEMPLATE;
+          const curr = '${{ steps.dates.outputs.curr }}';
+          const prev = '${{ steps.dates.outputs.prev }}';
+          const currTitle = `GitHub Triage: ${curr}`;
+          const prevTitle = `GitHub Triage: ${prev}`;
+
+          async function findIssue(title) {
+            const perPage = 100;
+            for (let page = 1; page < 50; page++) {
+              const { data } = await github.rest.issues.listForRepo({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                state: 'all',
+                per_page: perPage,
+                page
+              });
+              if (!data.length) break;
+              const hit = data.find(i => i.title === title);
+              if (hit) return hit;
+              if (data.length < perPage) break;
+            }
+            return null;
+          }
+
+          if (closePrev) {
+            const prevIssue = await findIssue(prevTitle);
+            if (prevIssue && prevIssue.state === 'open') {
+              await github.rest.issues.update({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: prevIssue.number,
+                state: 'closed'
+              });
+              core.info(`Closed previous triage issue #${prevIssue.number} (${prevTitle})`);
+            } else {
+              core.info(`Previous triage issue not open or not found (${prevTitle}).`);
+            }
+          }
+
+          const currIssue = await findIssue(currTitle);
+          if (currIssue) {
+            core.info(`Current triage issue already exists: #${currIssue.number}`);
+            return;
+          }
+
+          const body = bodyTemplate.replace(/{{MONTH}}/g, curr);
+          const created = await github.rest.issues.create({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            title: currTitle,
+            body,
+            labels: [label]
+          });
+          core.notice(`Created triage issue #${created.data.number} (${currTitle}).`);

.github/github_actions_triage-issue_action_Version6.yml

@@ -0,0 +1,15 @@
+name: "triage-issue"
+description: "Composite action to run monthly triage JS script"
+runs:
+  using: "composite"
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+    - name: Install dependencies
+      run: npm ci
+      shell: bash
+    - name: Run monthly triage script
+      run: node .github/scripts/ensureMonthlyTriage.js
+      shell: bash

.github/github_scripts_ensureMonthlyTriage.js

@@ -0,0 +1,99 @@
+// ensureMonthlyTriage.js
+const { Octokit } = require("@octokit/core");
+
+const githubToken = process.env.GITHUB_TOKEN;
+const repoOwner = process.env.REPO_OWNER;
+const repoName = process.env.REPO_NAME;
+
+if (!githubToken || !repoOwner || !repoName) {
+  console.error("Missing required env: GITHUB_TOKEN, REPO_OWNER, REPO_NAME");
+  process.exit(1);
+}
+
+const octokit = new Octokit({ auth: githubToken });
+
+function getYearMonth(offset = 0) {
+  const d = new Date();
+  d.setMonth(d.getMonth() + offset);
+  return d.toISOString().slice(0, 7); // YYYY-MM
+}
+
+async function findIssueByExactTitle(title) {
+  for (let page = 1; page < 50; page++) {
+    const resp = await octokit.request("GET /repos/{owner}/{repo}/issues", {
+      owner: repoOwner,
+      repo: repoName,
+      state: "all",
+      per_page: 100,
+      page,
+    });
+    if (!resp.data.length) break;
+    const hit = resp.data.find((i) => i.title === title);
+    if (hit) return hit;
+    if (resp.data.length < 100) break;
+  }
+  return null;
+}
+
+async function main() {
+  const currentYM = getYearMonth(0);
+  const previousYM = getYearMonth(-1);
+  const currentTitle = `GitHub Triage: ${currentYM}`;
+  const previousTitle = `GitHub Triage: ${previousYM}`;
+
+  // Close previous month issue if open
+  const prevIssue = await findIssueByExactTitle(previousTitle);
+  if (prevIssue && prevIssue.state === "open") {
+    await octokit.request(
+      "PATCH /repos/{owner}/{repo}/issues/{issue_number}",
+      {
+        owner: repoOwner,
+        repo: repoName,
+        issue_number: prevIssue.number,
+        state: "closed",
+      }
+    );
+    console.log(`Closed previous triage issue #${prevIssue.number}`);
+  } else {
+    console.log(`No open previous triage issue (title: ${previousTitle})`);
+  }
+
+  // Ensure current month issue exists
+  const currIssue = await findIssueByExactTitle(currentTitle);
+  if (currIssue) {
+    console.log(`Current triage issue already exists: #${currIssue.number}`);
+    return;
+  }
+
+  const body = `
+### Monthly GitHub Triage – ${currentYM}
+
+Automatically generated tracking issue for ${currentYM}.
+
+#### Purpose
+- Collect newly opened issues for classification.
+- Track placeholders (titles containing \`[REPLACE_WITH_MODULE_TITLE]\`).
+- Identify consolidation / closure candidates.
+
+#### Actions
+- Apply governance labels.
+- Escalate support or experience issues.
+- Prepare weekly summaries (see companion workflow).
+
+:octocat: :copilot: Created automatically.
+  `.trim();
+
+  const created = await octokit.request("POST /repos/{owner}/{repo}/issues", {
+    owner: repoOwner,
+    repo: repoName,
+    title: currentTitle,
+    body,
+    labels: ["triage"],
+  });
+  console.log(`Created new triage issue #${created.data.number}`);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

.github/github_scripts_weeklyTriageComment.js

@@ -0,0 +1,123 @@
+// weeklyTriageComment.js
+const { Octokit } = require("@octokit/core");
+
+const githubToken = process.env.GITHUB_TOKEN;
+const repoOwner = process.env.REPO_OWNER;
+const repoName = process.env.REPO_NAME;
+
+if (!githubToken || !repoOwner || !repoName) {
+  console.error("Missing required env: GITHUB_TOKEN, REPO_OWNER, REPO_NAME");
+  process.exit(1);
+}
+
+const octokit = new Octokit({ auth: githubToken });
+
+function getYearMonth(offset = 0) {
+  const d = new Date();
+  d.setMonth(d.getMonth() + offset);
+  return d.toISOString().slice(0, 7); // YYYY-MM
+}
+function getStartDate(daysBack = 7) {
+  const d = new Date();
+  d.setDate(d.getDate() - daysBack);
+  return d.toISOString().slice(0, 10); // YYYY-MM-DD
+}
+
+async function findIssue(title) {
+  for (let page = 1; page < 50; page++) {
+    const resp = await octokit.request("GET /repos/{owner}/{repo}/issues", {
+      owner: repoOwner,
+      repo: repoName,
+      state: "open",
+      per_page: 100,
+      page,
+    });
+    if (!resp.data.length) break;
+    const hit = resp.data.find((i) => i.title === title);
+    if (hit) return hit;
+    if (resp.data.length < 100) break;
+  }
+  return null;
+}
+
+async function main() {
+  const yearMonth = getYearMonth();
+  const triageTitle = `GitHub Triage: ${yearMonth}`;
+  const triageIssue = await findIssue(triageTitle);
+  if (!triageIssue) {
+    throw new Error(
+      `Current triage issue "${triageTitle}" not found. Run monthly triage workflow first.`
+    );
+  }
+
+  const startDate = getStartDate(7);
+  const q = `repo:${repoOwner}/${repoName} is:issue is:open created:>=${startDate}`;
+
+  let allItems = [];
+  for (let page = 1; page < 10; page++) {
+    const resp = await octokit.request("GET /search/issues", {
+      q,
+      per_page: 100,
+      page,
+    });
+    const items = resp.data.items || [];
+    allItems = allItems.concat(items);
+    if (items.length < 100) break;
+  }
+
+  // Categorization
+  const reTemplate = /\[REPLACE_WITH_MODULE_TITLE\]|N\/?A/i;
+  const reGrammar = /\b(grammar|spelling|typo|misspell(ed)?|proofread)\b/i;
+  const reDeprecated = /\b(deprecated|outdated|codeql|dependabot|projects?|security)\b/i;
+  const reSuggested =
+    /\b(update|improvement|improve|copilot|prompt|exercise|action|module|enterprise)\b/i;
+  const reOther =
+    /\b(broken|support|help|unable|issue|not issued|confused|experience|certificate)\b/i;
+
+  function categorize(title) {
+    if (reTemplate.test(title)) return "template";
+    if (reGrammar.test(title)) return "grammar";
+    if (reDeprecated.test(title)) return "deprecated";
+    if (!reTemplate.test(title) && reSuggested.test(title)) return "suggested";
+    if (reOther.test(title)) return "other";
+    if (/update|request/i.test(title) && !reTemplate.test(title)) return "suggested";
+    return "other";
+  }
+
+  const buckets = { grammar: [], deprecated: [], suggested: [], other: [], template: [] };
+  for (const i of allItems) buckets[categorize(i.title)].push(i);
+
+  const rep = (arr) => (arr.length ? `#${arr[0].number}` : "");
+  const todayStr = new Date().toISOString().slice(0, 10);
+  const allIssueLines = allItems.map((i) => `- #${i.number}`).join("\n");
+
+  let md = `**${yearMonth} Weekly Triage Update (Issues opened since ${startDate})**\n`;
+  md += `- Checked as of: ${todayStr} (UTC)\n\n`;
+  md += `**Counts (last 7 days):**\n`;
+  md += `- Grammar/Spelling: ${buckets.grammar.length} ${rep(buckets.grammar)}\n`;
+  md += `- Deprecated/Outdated: ${buckets.deprecated.length} ${rep(buckets.deprecated)}\n`;
+  md += `- Suggested Content Updates: ${buckets.suggested.length} ${rep(buckets.suggested)}\n`;
+  md += `- Other: ${buckets.other.length} ${rep(buckets.other)}\n`;
+  md += `- Template-Incomplete: ${buckets.template.length} ${rep(buckets.template)}\n\n`;
+  md += `_Total new issues: ${allItems.length}_\n\n`;
+  md += `**Issue References (Last 7 Days):**\n${allIssueLines}\n\n`;
+  md += `:octocat: :copilot: Mona (Copilot) has reviewed these new issues.\n`;
+  md += `<!-- Search query: repo:${repoOwner}/${repoName} is:issue is:open created:>=${startDate} -->\n`;
+
+  await octokit.request(
+    "POST /repos/{owner}/{repo}/issues/{issue_number}/comments",
+    {
+      owner: repoOwner,
+      repo: repoName,
+      issue_number: triageIssue.number,
+      body: md,
+    }
+  );
+
+  console.log(`Posted weekly triage update to #${triageIssue.number}`);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

.github/github_workflows_auto-triage-issue_Version7.yml

@@ -0,0 +1,32 @@
+name: Auto Create Monthly GitHub Triage Issue (Create + Close Previous)
+
+on:
+  schedule:
+    - cron: '5 7 1 * *'  # 07:05 UTC on the 1st day of each month
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  ensure-triage-issue:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run JS to create/close triage issue
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO_OWNER: githubpartners
+          REPO_NAME: microsoft-learn
+        run: node .github/scripts/ensureMonthlyTriage.js