Add quarter label auto-update to leaderboard sync

Sync now detects when index.html header quarter (e.g. 2026Q2) is behind
the current calendar quarter and updates it as part of the same commit+push
flow. Quarter-only runs get a distinct Teams notification title and a note
that no ranking changes were involved.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.claude/skills/sync-nowai-leaderboard/sync.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Orchestrator for the leaderboard sync. Side effects only; pure logic in lib/transform.mjs.
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { createHash } from 'node:crypto';
 import { execFileSync } from 'node:child_process';
 import { join, dirname } from 'node:path';
@@ -58,6 +58,35 @@ function git(root, args) {
   return execFileSync('git', args, { cwd: root, encoding: 'utf8' });
 }
 
+// Quarter helpers ─────────────────────────────────────────────────────────────
+
+function quarterForDate(d) {
+  return `${d.getUTCFullYear()}Q${Math.floor(d.getUTCMonth() / 3) + 1}`;
+}
+
+// Read index.html, extract the year+quarter label, compare to today's quarter.
+// Returns { needsUpdate, current, expected, html, htmlPath }.
+function detectQuarterLabel(root) {
+  const htmlPath = join(root, 'index.html');
+  const html = readFileSync(htmlPath, 'utf8');
+  const RE = /(\d{4})<span class="text-on-surface-variant text-base font-medium ml-1">(Q[1-4])<\/span>/;
+  const m = html.match(RE);
+  if (!m) return { needsUpdate: false };
+  const current = `${m[1]}${m[2]}`;
+  const expected = quarterForDate(new Date());
+  return { needsUpdate: current !== expected, current, expected, html, htmlPath };
+}
+
+function applyQuarterLabel({ html, htmlPath, expected }) {
+  const year = expected.slice(0, 4);
+  const q = expected.slice(4);
+  const updated = html.replace(
+    /(\d{4})<span class="text-on-surface-variant text-base font-medium ml-1">(Q[1-4])<\/span>/,
+    `${year}<span class="text-on-surface-variant text-base font-medium ml-1">${q}</span>`,
+  );
+  writeFileSync(htmlPath, updated);
+}
+
 async function main() {
   const args = new Set(process.argv.slice(2));
   const mode = args.has('--push') ? 'push' : args.has('--apply') ? 'apply' : 'check';
@@ -105,8 +134,16 @@ async function main() {
     }
   }
 
+  // 3.5. Detect quarter label mismatch in index.html.
+  const quarterInfo = detectQuarterLabel(root);
+  if (quarterInfo.needsUpdate) {
+    console.log(`[sync] quarter label: ${quarterInfo.current} → ${quarterInfo.expected}`);
+  }
+
   // 4. Change detection.
-  if (!hasChanges(oldData, newData)) {
+  const leaderboardChanged = hasChanges(oldData, newData);
+
+  if (!leaderboardChanged && !quarterInfo.needsUpdate) {
     console.log('[sync] no display changes. Done.');
     // Friday heartbeat: post a card so the Teams channel confirms the job is alive
     // even during quiet weeks with no ranking changes.
@@ -129,21 +166,28 @@ async function main() {
     }
     return;
   }
-  const changeLines = diffBoards(oldData, newData);
-  console.log('[sync] changes detected:\n' + changeLines.join('\n'));
-
-  // 5. Sanity gates.
-  const issues = validate(newData, oldData);
-  if (issues.length) {
-    console.error('[sync] sanity gates failed:\n - ' + issues.join('\n - '));
-    await notifyFailure(
-      [['Reason', 'sanity gates failed'], ...issues.map((s, i) => [`Issue ${i + 1}`, s])],
-      'warning',
-    );
-    process.exit(2);
+
+  let changeLines = [];
+  if (leaderboardChanged) {
+    changeLines = diffBoards(oldData, newData);
+    console.log('[sync] changes detected:\n' + changeLines.join('\n'));
+
+    // 5. Sanity gates (only when leaderboard data changes).
+    const issues = validate(newData, oldData);
+    if (issues.length) {
+      console.error('[sync] sanity gates failed:\n - ' + issues.join('\n - '));
+      await notifyFailure(
+        [['Reason', 'sanity gates failed'], ...issues.map((s, i) => [`Issue ${i + 1}`, s])],
+        'warning',
+      );
+      process.exit(2);
+    }
   }
 
   if (mode === 'check') {
+    if (quarterInfo.needsUpdate) {
+      console.log(`[sync] header quarter: ${quarterInfo.current} → ${quarterInfo.expected}`);
+    }
     console.log('[sync] --check: no writes. Re-run with --apply (commit) or --push (commit + staging).');
     return;
   }
@@ -162,11 +206,23 @@ async function main() {
     }
   }
 
-  await mkdir(dirname(dataPath), { recursive: true });
-  await writeFile(dataPath, JSON.stringify(newData, null, 2) + '\n');
-  git(root, ['add', dataPath]);
+  if (leaderboardChanged) {
+    await mkdir(dirname(dataPath), { recursive: true });
+    await writeFile(dataPath, JSON.stringify(newData, null, 2) + '\n');
+    git(root, ['add', dataPath]);
+  }
+
+  if (quarterInfo.needsUpdate) {
+    applyQuarterLabel(quarterInfo);
+    git(root, ['add', join(root, 'index.html')]);
+  }
+
   const today = new Date().toISOString().slice(0, 10);
-  const msg = `Sync leaderboard: EOG + EVA ${today}\n\n${changeLines.join('\n')}`;
+  const parts = [];
+  if (leaderboardChanged) parts.push('EOG + EVA');
+  if (quarterInfo.needsUpdate) parts.push(`header → ${quarterInfo.expected}`);
+  const commitDetail = leaderboardChanged ? '\n\n' + changeLines.join('\n') : '';
+  const msg = `Sync leaderboard: ${parts.join(', ')} ${today}${commitDetail}`;
   git(root, ['commit', '-m', msg]);
   console.log('[sync] committed.');
 
@@ -175,15 +231,23 @@ async function main() {
     try {
       git(root, ['push', 'origin', 'HEAD:main']);
       console.log('[sync] pushed to origin (staging).');
+      const noticeFacts = [];
+      if (leaderboardChanged) {
+        noticeFacts.push(['Boards changed', String(changeLines.length)]);
+        noticeFacts.push(['Detail', changeLines.join(' · ')]);
+      }
+      if (quarterInfo.needsUpdate) {
+        noticeFacts.push(['Header updated', `${quarterInfo.current} → ${quarterInfo.expected}`]);
+      }
+      if (!leaderboardChanged) {
+        noticeFacts.push(['Note', 'Quarter label only — no ranking changes']);
+      }
+      noticeFacts.push(['Next', 'Review staging, then promote to prod']);
       await postTeams({
         kind: 'success',
-        title: '✅ Staging ready for review',
+        title: leaderboardChanged ? '✅ Staging ready for review' : '📅 Header updated — staging ready',
         subtitle: subtitle(),
-        facts: [
-          ['Boards changed', String(changeLines.length)],
-          ['Detail', changeLines.join(' · ')],
-          ['Next', 'Review staging, then promote to prod'],
-        ],
+        facts: noticeFacts,
         openUrl: STAGING_URL,
       });
     } catch (e) {