feat: add blocked sync notification builder

.claude/skills/sync-nowai-leaderboard/lib/blocked-notify.mjs

@@ -0,0 +1,53 @@
+const REASON_LABELS = {
+  'dirty-worktree': 'Worktree has uncommitted files',
+  'wrong-branch': 'Current branch is not main',
+  'fetch-failed': 'git fetch origin main failed',
+  'behind-or-diverged': 'Local main is behind or diverged from origin/main',
+};
+
+export function blockedSubtitle(now = new Date()) {
+  return 'NowAI-Bench Sync · ' + now.toISOString().replace('T', ' ').slice(0, 16) + ' UTC';
+}
+
+export function buildBlockedNotification({ reason, facts = [], now = new Date() }) {
+  const label = REASON_LABELS[reason];
+  if (!label) throw new Error(`Unknown blocked reason: ${reason}`);
+
+  return {
+    kind: 'warning',
+    title: '⚠️ Leaderboard sync blocked',
+    subtitle: blockedSubtitle(now),
+    facts: [['Reason', label], ...facts],
+  };
+}
+
+export function parseBlockedCliArgs(argv) {
+  const facts = [];
+  let reason;
+
+  for (let i = 0; i < argv.length; i++) {
+    const token = argv[i];
+
+    if (token === '--reason') {
+      reason = argv[++i];
+      continue;
+    }
+
+    if (token === '--fact') {
+      const raw = argv[++i] ?? '';
+      const eq = raw.indexOf('=');
+      if (eq <= 0) throw new Error(`Invalid --fact, expected key=value: ${raw}`);
+      facts.push([raw.slice(0, eq), raw.slice(eq + 1)]);
+      continue;
+    }
+
+    throw new Error(`Unknown argument: ${token}`);
+  }
+
+  if (!reason) throw new Error('Missing required --reason');
+
+  // Reuse payload validation so the CLI parser and notifier stay in lockstep.
+  buildBlockedNotification({ reason, facts, now: new Date(0) });
+
+  return { reason, facts };
+}

.claude/skills/sync-nowai-leaderboard/test/blocked-notify.test.mjs

@@ -0,0 +1,53 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import {
+  buildBlockedNotification,
+  parseBlockedCliArgs,
+} from '../lib/blocked-notify.mjs';
+
+test('buildBlockedNotification maps dirty-worktree to a warning card payload', () => {
+  const out = buildBlockedNotification({
+    reason: 'dirty-worktree',
+    facts: [['Branch', 'main'], ['Files', '3']],
+    now: new Date('2026-07-01T21:00:00Z'),
+  });
+
+  assert.equal(out.kind, 'warning');
+  assert.equal(out.title, '⚠️ Leaderboard sync blocked');
+  assert.equal(out.subtitle, 'NowAI-Bench Sync · 2026-07-01 21:00 UTC');
+  assert.deepEqual(out.facts, [
+    ['Reason', 'Worktree has uncommitted files'],
+    ['Branch', 'main'],
+    ['Files', '3'],
+  ]);
+});
+
+test('parseBlockedCliArgs accepts repeated --fact pairs', () => {
+  const out = parseBlockedCliArgs([
+    '--reason', 'behind-or-diverged',
+    '--fact', 'Branch=main',
+    '--fact', 'RemoteAhead=2',
+    '--fact', 'LocalAhead=0',
+  ]);
+
+  assert.equal(out.reason, 'behind-or-diverged');
+  assert.deepEqual(out.facts, [
+    ['Branch', 'main'],
+    ['RemoteAhead', '2'],
+    ['LocalAhead', '0'],
+  ]);
+});
+
+test('parseBlockedCliArgs rejects unknown blocked reasons', () => {
+  assert.throws(
+    () => parseBlockedCliArgs(['--reason', 'mystery-reason']),
+    /Unknown blocked reason: mystery-reason/,
+  );
+});
+
+test('parseBlockedCliArgs rejects malformed fact entries', () => {
+  assert.throws(
+    () => parseBlockedCliArgs(['--reason', 'wrong-branch', '--fact', 'Branch']),
+    /Invalid --fact, expected key=value: Branch/,
+  );
+});