Merge branch 'ArmDeveloperEcosystem:main' into FTLLM_New

Author: parichaydas

.github/copilot-instructions.md

@@ -0,0 +1,125 @@
+name: Last Reviewed Date Backfill (One Time)
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Log actions only (no writes)"
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+  pull-requests: read
+  repository-projects: write
+
+jobs:
+  backfill:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Backfill Last Reviewed Date
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.PROJECT_TOKEN }}
+          script: |
+            const dryRun = core.getInput('dry_run') === 'true';
+
+            const orgLogin = 'ArmDeveloperEcosystem';
+            const projectNumber = 4;
+
+            const ISO_CUTOFF = '2024-12-31';
+            const toDate = (iso) => new Date(iso + 'T00:00:00.000Z');
+
+            // 1) project
+            const proj = await github.graphql(
+              `query($org:String!,$num:Int!){ organization(login:$org){ projectV2(number:$num){ id } } }`,
+              { org: orgLogin, num: projectNumber }
+            );
+            const projectId = proj.organization?.projectV2?.id;
+            if (!projectId) throw new Error('Project not found');
+
+            // 2) fields
+            const fields = (await github.graphql(
+              `query($id:ID!){ node(id:$id){ ... on ProjectV2 {
+                fields(first:50){ nodes{
+                  __typename
+                  ... on ProjectV2Field{ id name dataType }
+                  ... on ProjectV2SingleSelectField{ id name options{ id name } }
+                } } } } }`, { id: projectId }
+            )).node.fields.nodes;
+
+            const dateFieldId = (n)=>fields.find(f=>f.__typename==='ProjectV2Field'&&f.name===n&&f.dataType==='DATE')?.id||null;
+            const statusField = fields.find(f=>f.__typename==='ProjectV2SingleSelectField' && f.name==='Status');
+            const statusFieldId = statusField?.id;
+            const publishId = dateFieldId('Publish Date');
+            const lrdId = dateFieldId('Last Reviewed Date');
+
+            if (!statusFieldId || !lrdId) throw new Error('Missing Status or Last Reviewed Date field');
+
+            // writers
+            const setDate = async (itemId, fieldId, iso) => {
+              if (dryRun) return console.log(`[DRY RUN] setDate item=${itemId} -> ${iso}`);
+              const m = `mutation($p:ID!,$i:ID!,$f:ID!,$d:Date!){
+                updateProjectV2ItemFieldValue(input:{projectId:$p,itemId:$i,fieldId:$f,value:{date:$d}}){
+                  projectV2Item{ id }
+                }}`;
+              await github.graphql(m, { p: projectId, i: itemId, f: fieldId, d: iso });
+            };
+
+            // helpers
+            const getDate = (item,id)=>item.fieldValues.nodes.find(n=>n.__typename==='ProjectV2ItemFieldDateValue'&&n.field?.id===id)?.date||null;
+            const getStatus = (item)=>{ const n=item.fieldValues.nodes.find(n=>n.__typename==='ProjectV2ItemFieldSingleSelectValue'&&n.field?.id===statusFieldId); return n?.name||null; };
+
+            // iterate
+            async function* items(){ let cursor=null; for(;;){
+              const r=await github.graphql(
+                `query($org:String!,$num:Int!,$after:String){
+                  organization(login:$org){ projectV2(number:$num){
+                    items(first:100, after:$after){
+                      nodes{
+                        id
+                        content{ __typename ... on PullRequest{ number repository{ name } } }
+                        fieldValues(first:50){ nodes{
+                          __typename
+                          ... on ProjectV2ItemFieldDateValue{ field{ ... on ProjectV2Field{ id name } } date }
+                          ... on ProjectV2ItemFieldSingleSelectValue{ field{ ... on ProjectV2SingleSelectField{ id name } } name optionId }
+                        } }
+                      }
+                      pageInfo{ hasNextPage endCursor }
+                    }
+                  } } }`,
+                { org: orgLogin, num: projectNumber, after: cursor }
+              );
+              const page=r.organization.projectV2.items;
+              for(const n of page.nodes) yield n;
+              if(!page.pageInfo.hasNextPage) break;
+              cursor=page.pageInfo.endCursor;
+            } }
+
+            let updates=0;
+            for await (const item of items()){
+              if (item.content?.__typename !== 'PullRequest') continue;
+
+              const status = getStatus(item);
+              if (status !== 'Done' && status !== 'Maintenance') continue;
+
+              const lrd = getDate(item, lrdId);
+              if (lrd) continue; // already has a value
+
+              if (status === 'Done') {
+                const publish = publishId ? getDate(item, publishId) : null;
+                if (publish) {
+                  await setDate(item.id, lrdId, publish);
+                  updates++; console.log(`[Backfill][Done] Set LRD=${publish}`);
+                } else {
+                  console.log(`[Skip][Done] No Publish Date; not setting LRD`);
+                }
+              }
+
+              if (status === 'Maintenance') {
+                await setDate(item.id, lrdId, ISO_CUTOFF);
+                updates++; console.log(`[Backfill][Maintenance] Set LRD=${ISO_CUTOFF}`);
+              }
+            }
+
+            console.log(`Backfill complete. Items updated: ${updates}. Dry run: ${dryRun}`);

.github/workflows/last-reviewed-backfill.yml

@@ -0,0 +1,255 @@
+name: Last Reviewed Cron
+
+on:
+  schedule:
+    - cron: "0 9 * * *"  # daily at 09:00 UTC
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Log actions only (no writes)"
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+  pull-requests: read
+  repository-projects: write
+
+jobs:
+  sweep:
+    if: github.repository == 'ArmDeveloperEcosystem/arm-learning-paths'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Move items based on Last Reviewed Date
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.PROJECT_TOKEN }}
+          script: |
+            // Inputs
+            const dryRun = core.getInput('dry_run') === 'true';
+
+            // ---- Config (edit if needed) ----
+            const orgLogin = 'ArmDeveloperEcosystem';
+            const projectNumber = 4;
+            const STATUS_FIELD_NAME = 'Status';
+            const STATUS_DONE = 'Done';
+            const STATUS_MAINT = 'Maintenance';
+            const LRD_FIELD_NAME = 'Last Reviewed Date';
+            const PUBLISHED_URL_FIELD_NAME = 'Published URL';
+            // ----------------------------------
+
+            // Dates
+            const TODAY = new Date();
+            const sixMonthsAgoISO = (() => {
+              const d = new Date(TODAY);
+              d.setUTCMonth(d.getUTCMonth() - 6);
+              return d.toISOString().split('T')[0];
+            })();
+            const toDate = (iso) => new Date(iso + 'T00:00:00.000Z');
+
+            // Project
+            const proj = await github.graphql(
+              `query($org:String!,$num:Int!){
+                organization(login:$org){
+                  projectV2(number:$num){ id }
+                }
+              }`,
+              { org: orgLogin, num: projectNumber }
+            );
+            const projectId = proj.organization?.projectV2?.id;
+            if (!projectId) throw new Error('Project not found');
+
+            // Fields
+            const fields = (await github.graphql(
+              `query($id:ID!){
+                node(id:$id){
+                  ... on ProjectV2 {
+                    fields(first:50){
+                      nodes{
+                        __typename
+                        ... on ProjectV2Field { id name dataType }
+                        ... on ProjectV2SingleSelectField { id name options { id name } }
+                      }
+                    }
+                  }
+                }
+              }`, { id: projectId }
+            )).node.fields.nodes;
+
+            const findDateFieldId = (name) =>
+              fields.find(f => f.__typename === 'ProjectV2Field' && f.name === name && f.dataType === 'DATE')?.id || null;
+
+            const findTextFieldId = (name) => {
+              const exact = fields.find(f => f.__typename === 'ProjectV2Field' && f.name === name && f.dataType === 'TEXT');
+              if (exact) return exact.id;
+              const ci = fields.find(f => f.__typename === 'ProjectV2Field' && (f.name?.toLowerCase?.() === name.toLowerCase()) && f.dataType === 'TEXT');
+              return ci?.id || null;
+            };
+            
+            const statusField = fields.find(f => f.__typename === 'ProjectV2SingleSelectField' && f.name === STATUS_FIELD_NAME);
+            const statusFieldId = statusField?.id || null;
+            const doneId  = statusField?.options?.find(o => o.name === STATUS_DONE)?.id || null;
+            const maintId = statusField?.options?.find(o => o.name === STATUS_MAINT)?.id || null;
+
+            const lrdId = findDateFieldId(LRD_FIELD_NAME);
+            const publishedUrlFieldId = findTextFieldId(PUBLISHED_URL_FIELD_NAME);
+
+            if (!statusFieldId || !doneId || !maintId || !lrdId) {
+              throw new Error('Missing required project fields/options: Status/Done/Maintenance or Last Reviewed Date.');
+            }
+
+            // Helpers
+            const getDate = (item, fieldId) =>
+              item.fieldValues.nodes.find(n =>
+                n.__typename === 'ProjectV2ItemFieldDateValue' && n.field?.id === fieldId
+              )?.date || null;
+
+            const getText = (item, fieldId) =>
+              item.fieldValues.nodes.find(n =>
+                n.__typename === 'ProjectV2ItemFieldTextValue' && n.field?.id === fieldId
+              )?.text || null;
+              
+            const getStatusName = (item) => {
+              const n = item.fieldValues.nodes.find(n =>
+                n.__typename === 'ProjectV2ItemFieldSingleSelectValue' && n.field?.id === statusFieldId
+              );
+              return n?.name || null;
+            };
+
+            const setStatus = async (itemId, fieldId, optionId) => {
+              if (dryRun) {
+                console.log(`[DRY RUN] setStatus item=${itemId} -> option=${optionId}`);
+                return;
+              }
+              const m = `
+                mutation($p:ID!,$i:ID!,$f:ID!,$o:String!){
+                  updateProjectV2ItemFieldValue(input:{
+                    projectId:$p, itemId:$i, fieldId:$f, value:{ singleSelectOptionId:$o }
+                  }){
+                    projectV2Item { id }
+                  }
+                }`;
+              await github.graphql(m, { p: projectId, i: itemId, f: fieldId, o: optionId });
+            };
+
+            async function* iterItems() {
+              let cursor = null;
+              for (;;) {
+                const r = await github.graphql(
+                  `query($org:String!,$num:Int!,$after:String){
+                    organization(login:$org){
+                      projectV2(number:$num){
+                        items(first:100, after:$after){
+                          nodes{
+                            id
+                            content{
+                              __typename
+                              ... on PullRequest {
+                                number
+                                repository { name }
+                              }
+                            }
+                            fieldValues(first:100){
+                              nodes{
+                                __typename
+                                ... on ProjectV2ItemFieldDateValue {
+                                  field { ... on ProjectV2Field { id name } }
+                                  date
+                                }
+                                ... on ProjectV2ItemFieldTextValue {
+                                  field { ... on ProjectV2Field { id name } }
+                                  text
+                                }
+                                ... on ProjectV2ItemFieldSingleSelectValue {
+                                  field { ... on ProjectV2SingleSelectField { id name } }
+                                  name
+                                  optionId
+                                }
+                              }
+                            }
+                          }
+                          pageInfo {
+                            hasNextPage
+                            endCursor
+                          }
+                        }
+                      }
+                    }
+                  }`,
+                  { org: orgLogin, num: projectNumber, after: cursor }
+                );
+            
+                const page = r.organization.projectV2.items;
+                for (const n of page.nodes) yield n;
+                if (!page.pageInfo.hasNextPage) break;
+                cursor = page.pageInfo.endCursor;
+              }
+            }
+
+            const lastTwoFromUrl = (url) => {
+              if (!url) return '';
+              try {
+                const u = new URL(url);
+                const segs = u.pathname.split('/').filter(Boolean);
+                if (segs.length >= 2) return `${segs[segs.length - 2]}/${segs[segs.length - 1]}/`;
+                if (segs.length === 1) return `${segs[0]}/`;
+                return '';
+              } catch { return ''; }
+            };
+
+            // Movement counters & log
+            let movedDoneToMaint = 0;
+            let movedMaintToDone = 0;
+            const moveLog = [];
+
+            // Sweep
+            for await (const item of iterItems()) {
+              if (item.content?.__typename !== 'PullRequest') continue; // PRs only
+
+              const itemId = item.id;
+              const status = getStatusName(item);
+              const lrd = getDate(item, lrdId);
+              if (!status || !lrd) continue; // only move when LRD exists
+              
+              const prNumber = item.content.number;
+              const repoName = item.content.repository.name;
+
+              const publishedUrl = publishedUrlFieldId ? getText(item, publishedUrlFieldId) : null;
+              const lastTwoSegments = lastTwoFromUrl(publishedUrl) || '(no-published-url)';
+
+              // Done -> Maintenance: LRD older/equal than 6 months ago
+              if (status === STATUS_DONE && toDate(lrd) <= toDate(sixMonthsAgoISO)) {
+                await setStatus(itemId, statusFieldId, maintId);
+                movedDoneToMaint++;
+                const line = `[Cron] Moved ${lastTwoSegments} → Maintenance (LRD ${lrd} ≤ ${sixMonthsAgoISO})`;
+                console.log(line);
+                moveLog.push(line);
+                continue; // skip second rule for same item
+              }
+
+              // Maintenance -> Done: LRD within last 6 months (strictly newer than threshold)
+              if (status === STATUS_MAINT && toDate(lrd) > toDate(sixMonthsAgoISO)) {
+                await setStatus(itemId, statusFieldId, doneId);
+                movedMaintToDone++;
+                const line = `[Cron] Moved ${lastTwoSegments} → Done (LRD ${lrd} > ${sixMonthsAgoISO})`;
+                console.log(line);
+                moveLog.push(line);
+              }
+            }
+
+            // Summary
+            const totalMoves = movedDoneToMaint + movedMaintToDone;
+            console.log(`Cron complete. Moved Done→Maintenance: ${movedDoneToMaint}, Maintenance→Done: ${movedMaintToDone}, Total: ${totalMoves}. Dry run: ${dryRun}`);
+
+            // Nice Job Summary in the Actions UI
+            await core.summary
+              .addHeading('Last Reviewed Cron Summary')
+              .addTable([
+                [{ data: 'Direction', header: true }, { data: 'Count', header: true }],
+                ['Done → Maintenance', String(movedDoneToMaint)],
+                ['Maintenance → Done', String(movedMaintToDone)],
+                ['Total moves', String(totalMoves)],
+              ])
+              .addHeading('Details', 2)
+              .addCodeBlock(moveLog.join('\n') || 'No moves', 'text')
+              .write();