zugzbot 1.0.21 → 1.0.23

package/.opencode/oh-my-design/web/scripts/sync-catalog.mjs

@@ -1,140 +0,0 @@
-#!/usr/bin/env node
-/**
- * sync-catalog.mjs — one-command SYNC phase for reference additions.
- *
- *   node web/scripts/sync-catalog.mjs [--dry-run]
- *
- * After new references/<id>/ folders pass verify-reference.mjs, this script
- * propagates them to every adjacent surface that historically drifted when
- * done by hand:
- *
- *   1. web/src/data/registry.generated.ts   (build-registry)
- *   2. data/reference-fingerprints.json ×3  (append missing ids, count, mirrors)
- *   3. design-md/ mirror                    (byte-identical re-copy)
- *   4. README ×4 / llms.txt / app layouts   (old count → new count strings)
- *   5. llms.txt Examples line               (append missing display names)
- *   6. npm test                             (catalog-integrity must be green)
- *
- * NOT done here (still the orchestrator's call): CHANGELOG entry, package.json
- * version bump, git commit.
- */
-import { readFileSync, writeFileSync, existsSync, readdirSync, cpSync, rmSync } from 'node:fs';
-import { join, dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { execSync } from 'node:child_process';
-import yaml from 'js-yaml';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const WEB = resolve(__dirname, '..');
-const ROOT = resolve(WEB, '..');
-const REFS = join(WEB, 'references');
-const DRY = process.argv.includes('--dry-run');
-
-const FP_PATHS = [
-  join(ROOT, 'data', 'reference-fingerprints.json'),
-  join(ROOT, '.claude', 'data', 'reference-fingerprints.json'),
-  join(ROOT, '.codex', 'data', 'reference-fingerprints.json'),
-];
-// Every file that carries the literal reference count. Word-boundary replace
-// of oldCount → newCount; keep this list explicit so an unrelated number is
-// never touched.
-const COUNT_SURFACES = [
-  'README.md', 'README.ko.md', 'README.ja.md', 'README.zh-TW.md',
-  'web/public/llms.txt',
-  'web/src/app/layout.tsx', 'web/src/app/docs/layout.tsx', 'web/src/app/docs/page.tsx',
-  'web/src/app/builder/layout.tsx', 'web/src/app/design-systems/layout.tsx',
-].map(p => join(ROOT, p));
-
-const TONE_LEXICON = ['clean', 'bold', 'warm', 'dark', 'playful', 'minimal', 'dense', 'flat', 'editorial', 'calm', 'energetic', 'trustworthy', 'friendly', 'modern', 'vivid', 'systematic', 'utilitarian', 'premium', 'approachable', 'confident', 'cinematic', 'immersive', 'organic', 'human'];
-
-function frontmatter(id) {
-  const md = readFileSync(join(REFS, id, 'DESIGN.md'), 'utf-8');
-  const close = md.indexOf('\n---\n', 4);
-  return { fm: yaml.load(md.slice(4, close)), md };
-}
-
-function sec1Prose(md) {
-  const sec1 = md.split('## 1. Visual Theme & Atmosphere', 2)[1] || '';
-  return (sec1.split('\n').map(l => l.trim()).find(l => l.length > 0) || '').slice(0, 260);
-}
-
-const ids = readdirSync(REFS, { withFileTypes: true })
-  .filter(d => d.isDirectory() && existsSync(join(REFS, d.name, 'DESIGN.md')))
-  .map(d => d.name).sort();
-
-// ── 1. registry ────────────────────────────────────────────────────────
-if (!DRY) execSync('node scripts/build-registry.mjs', { cwd: WEB, stdio: 'inherit' });
-
-// ── 2. fingerprints ×3 ─────────────────────────────────────────────────
-const fp = JSON.parse(readFileSync(FP_PATHS[0], 'utf-8'));
-const oldCount = fp.count;
-const have = new Set(fp.items.map(i => i.id));
-const missing = ids.filter(i => !have.has(i));
-for (const rid of missing) {
-  const { fm, md } = frontmatter(rid);
-  const prose = sec1Prose(md);
-  const lower = (md.split('## 4.')[0] || '').toLowerCase();
-  const tones = TONE_LEXICON.filter(t => lower.includes(t)).slice(0, 4);
-  fp.items.push({
-    id: rid,
-    primary_color_hex: fm.primary_color,
-    category: fm.category,
-    visual_theme: prose,
-    voice_fingerprint: { register: fm.category, sentence_length: 'medium declarative', metaphor_density: 'low', vocabulary_register: 'brand-appropriate' },
-    tone_keywords: tones.length ? tones : ['brand-appropriate'],
-    antipatterns: ['off-brand'],
-    signature_motion: 'See §15 Motion.',
-    has_personas: true,
-    category_raw: fm.category,
-  });
-  console.log(`[fingerprints] + ${rid} (tone: ${tones.join(', ') || 'default'}) — refine keywords by hand if needed`);
-}
-fp.items.sort((a, b) => a.id.localeCompare(b.id));
-fp.count = fp.items.length;
-fp.generated_at = new Date().toISOString().slice(0, 10) + 'T00:00:00Z';
-if (!DRY && missing.length) {
-  const body = JSON.stringify(fp, null, 1) + '\n';
-  for (const p of FP_PATHS) writeFileSync(p, body);
-}
-console.log(`[fingerprints] count ${oldCount} -> ${fp.count} (${missing.length} added, mirrors x${FP_PATHS.length})`);
-
-// ── 3. design-md mirror ────────────────────────────────────────────────
-if (!DRY) {
-  rmSync(join(ROOT, 'design-md'), { recursive: true, force: true });
-  cpSync(REFS, join(ROOT, 'design-md'), { recursive: true, dereference: true });
-}
-console.log('[mirror] design-md re-synced');
-
-// ── 4. count strings ───────────────────────────────────────────────────
-if (oldCount !== fp.count) {
-  const re = new RegExp(`\\b${oldCount}\\b`, 'g');
-  for (const p of COUNT_SURFACES) {
-    if (!existsSync(p)) { console.warn(`[count] skip missing ${p}`); continue; }
-    const txt = readFileSync(p, 'utf-8');
-    const n = (txt.match(re) || []).length;
-    if (n && !DRY) writeFileSync(p, txt.replace(re, String(fp.count)));
-    if (n) console.log(`[count] ${p.replace(ROOT + '/', '')}: ${n} x ${oldCount} -> ${fp.count}`);
-  }
-}
-
-// ── 5. llms.txt Examples ───────────────────────────────────────────────
-const llmsPath = join(WEB, 'public', 'llms.txt');
-if (existsSync(llmsPath) && missing.length) {
-  let txt = readFileSync(llmsPath, 'utf-8');
-  const line = txt.match(/^Examples:.*$/m)?.[0] || '';
-  const adds = [];
-  for (const rid of missing) {
-    const { fm } = frontmatter(rid);
-    const display = fm.display_name_kr ? `${fm.name} (${fm.display_name_kr})` : fm.name;
-    if (!line.includes(fm.name)) adds.push(display);
-  }
-  if (adds.length && !DRY) {
-    txt = txt.replace(/^(Examples:.*)$/m, `$1 · ${adds.join(' · ')}`);
-    writeFileSync(llmsPath, txt);
-  }
-  if (adds.length) console.log(`[llms.txt] Examples += ${adds.join(' · ')}`);
-}
-
-// ── 6. tests ───────────────────────────────────────────────────────────
-if (!DRY) execSync('npm test --silent', { cwd: WEB, stdio: 'inherit' });
-console.log(`\n[sync-catalog] done — ${fp.count} references${DRY ? ' (dry-run, nothing written)' : ''}. Remaining manual: CHANGELOG entry + package.json bump.`);

package/.opencode/oh-my-design/web/scripts/token-sheet.mjs

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-/**
- * Render a reference's `tokens:` block to a visual review sheet (PNG).
- * Mirrors getdesign.md depth: colors, typography table (with `use`), rounded,
- * spacing, elevation, components. Used to eyeball a backfill/new-ref result.
- *
- *   GLOBAL_ROOT=$(npm root -g) node scripts/token-sheet.mjs <ref-id> [--out path.png]
- *
- * Requires global playwright (GLOBAL_ROOT). Writes to /tmp/<id>-token-sheet.png
- * by default. Exits non-zero if the ref has no tokens block.
- */
-import { readFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import yaml from 'js-yaml';
-
-const id = process.argv[2];
-if (!id || id.startsWith('--')) {
-  console.error('usage: GLOBAL_ROOT=$(npm root -g) node scripts/token-sheet.mjs <ref-id> [--out path]');
-  process.exit(2);
-}
-const outFlag = process.argv.indexOf('--out');
-const out = outFlag !== -1 ? process.argv[outFlag + 1] : `/tmp/${id}-token-sheet.png`;
-const GLOBAL_ROOT = process.env.GLOBAL_ROOT;
-if (!GLOBAL_ROOT) { console.error('set GLOBAL_ROOT=$(npm root -g) for global playwright'); process.exit(2); }
-
-const REFS = join(dirname(fileURLToPath(import.meta.url)), '..', 'references');
-const md = readFileSync(join(REFS, id, 'DESIGN.md'), 'utf8');
-const fm = yaml.load(md.slice(4, md.indexOf('\n---', 4)));
-const t = fm.tokens;
-if (!t) { console.error(`${id}: no tokens block`); process.exit(1); }
-
-const accent = (t.colors?.primary || t.colors?.brand || fm.primary_color || '#444').toString();
-const esc = s => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;');
-
-const swatch = (name, hex) =>
-  `<div style="display:flex;align-items:center;gap:10px;margin:3px 0"><div style="width:34px;height:34px;border-radius:8px;background:${hex};box-shadow:inset 0 0 0 1px rgba(0,0,0,.1)"></div><code style="font:12px ui-monospace">${esc(name)}</code><span style="color:#7d818a;font:12px ui-monospace">${esc(hex)}</span></div>`;
-const colors = Object.entries(t.colors || {}).map(([k, v]) => swatch(k, v)).join('');
-
-const typo = t.typography || {};
-const typeRows = Object.entries(typo).filter(([k]) => k !== 'family').map(([k, v]) =>
-  `<tr><td style="padding:5px 12px 5px 0"><code>${esc(k)}</code></td><td style="padding:5px 12px"><span style="font-size:${Math.min(v.size || 16, 40)}px;font-weight:${v.weight || 400};line-height:1.1">Aa</span></td><td style="padding:5px 12px;color:#555;font:12px ui-monospace">${v.size || '?'}/${v.weight || '?'}/${v.lineHeight ?? '?'}</td><td style="padding:5px 12px;color:#7d818a;font-size:12px">${esc(v.use || '')}</td></tr>`).join('');
-const family = typo.family ? Object.values(typo.family).join(' · ') : '';
-
-const rnd = t.rounded || {};
-const round = Object.entries(rnd).map(([k, v]) =>
-  `<div style="text-align:center"><div style="width:56px;height:56px;background:${accent};border-radius:${v > 1000 ? 28 : v}px"></div><code style="font-size:11px">${esc(k)} ${v}</code></div>`).join('');
-
-const sp = t.spacing || {};
-const spaceEntries = Array.isArray(sp) ? sp.map((v, i) => [i, v]) : Object.entries(sp);
-const space = spaceEntries.map(([k, v]) =>
-  `<div style="text-align:center"><div style="width:${Math.min(v, 96)}px;height:18px;background:${accent};border-radius:3px"></div><code style="font-size:10px">${esc(k)}<br>${v}</code></div>`).join('');
-
-const comps = Object.entries(t.components || {}).map(([k, v]) =>
-  `<div style="margin:4px 0"><code style="color:${accent}">${esc(k)}</code> <span style="color:#444;font-size:13px">${esc(v)}</span></div>`).join('');
-
-const html = `<html><head><style>body{font-family:-apple-system,system-ui,sans-serif;margin:0;background:#fff;color:#101214}h1{font-size:30px;margin:0}h2{font-size:13px;text-transform:uppercase;letter-spacing:.08em;color:#7d818a;margin:26px 0 8px;border-bottom:1px solid #eee;padding-bottom:5px}.wrap{padding:36px 44px;width:880px}.grid{display:grid;grid-template-columns:1fr 1fr;gap:0 40px}.row{display:flex;gap:18px;align-items:flex-end;flex-wrap:wrap}table{border-collapse:collapse;font-size:14px}</style></head><body><div class="wrap">
-<div style="display:flex;align-items:center;gap:14px"><div style="width:46px;height:46px;border-radius:10px;background:${accent}"></div><div><h1>${esc(fm.name || id)}</h1><span style="color:#7d818a;font:13px ui-monospace">source: ${esc(t.source || '?')} · extracted ${esc(t.extracted || '?')} · primary ${esc(accent)}</span></div></div>
-<div class="grid"><div><h2>Colors (${Object.keys(t.colors || {}).length})</h2>${colors}</div><div><h2>Typography ${family ? '— ' + esc(family) : ''}</h2><table>${typeRows}</table>
-${round ? `<h2>Rounded</h2><div class="row">${round}</div>` : ''}
-${space ? `<h2>Spacing</h2><div class="row" style="align-items:flex-start">${space}</div>` : ''}</div></div>
-${comps ? `<h2>Components</h2>${comps}` : ''}
-</div></body></html>`;
-
-const pw = await import(pathToFileURL(join(GLOBAL_ROOT, 'playwright', 'index.js')).href);
-const chromium = pw.chromium ?? pw.default?.chromium;
-const b = await chromium.launch();
-const p = await b.newPage({ viewport: { width: 880, height: 100 }, deviceScaleFactor: 2 });
-await p.setContent(html, { waitUntil: 'networkidle' });
-await p.screenshot({ path: out, fullPage: true });
-await b.close();
-console.log(`written ${out}`);

package/.opencode/oh-my-design/web/scripts/token-status.mjs

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-/**
- * Catalog TRACKER — the live checklist. Scans every reference and reports, per ref:
- *   - token backfill: has a `tokens:` block (done) vs. still needs one (pending),
- *     the token `source`, and a consistency probe (colors grounded in prose).
- *   - component depth: how many `tokens.components` are documented, and whether a
- *     component-harvest pass has been run (`tokens.components_harvested: true`).
- * Source of truth is the files themselves, so it never drifts.
- *
- *   node web/scripts/token-status.mjs            # summary + pending / harvest lists
- *   node web/scripts/token-status.mjs --md       # markdown checklist (for a doc)
- *   node web/scripts/token-status.mjs --done      # list only token-completed
- *   node web/scripts/token-status.mjs --components # focus the component-depth view
- *
- * Component philosophy: we DON'T force richness. A source-limited ref (e.g. a
- * landing-page-only mobile app) is legitimately "done" once harvested even with
- * few components — the harvest pass marks `components_harvested: true` so it stops
- * showing up as a candidate. The list only nags refs we haven't *tried* yet.
- */
-import { readFileSync, readdirSync, existsSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import yaml from 'js-yaml';
-
-const REFS = join(dirname(fileURLToPath(import.meta.url)), '..', 'references');
-const asMd = process.argv.includes('--md');
-const onlyDone = process.argv.includes('--done');
-const compView = process.argv.includes('--components');
-
-const RICH = 10; // >= this many tokens.components reads as "rich"
-
-const ids = readdirSync(REFS, { withFileTypes: true })
-  .filter(d => d.isDirectory() && existsSync(join(REFS, d.name, 'DESIGN.md')))
-  .map(d => d.name).sort();
-
-const rows = ids.map(id => {
-  const md = readFileSync(join(REFS, id, 'DESIGN.md'), 'utf8');
-  let tokens = null;
-  if (/^tokens:/m.test(md.slice(0, md.indexOf('\n---', 4) + 1))) {
-    try { tokens = yaml.load(md.slice(4, md.indexOf('\n---', 4))).tokens; } catch { tokens = { _bad: true }; }
-  }
-  if (!tokens) return { id, status: 'pending', source: '-', colors: 0, ground: '-', comp: 0, cstatus: 'no-tokens' };
-  if (tokens._bad) return { id, status: 'error', source: 'bad-yaml', colors: 0, ground: '-', comp: 0, cstatus: 'no-tokens' };
-  const colorObj = tokens.colors || tokens.color || {};
-  const ground = md.replace(/\ntokens:\n(?:[ \t].*(?:\n|$))*/, '\n').toLowerCase();
-  const ungrounded = Object.entries(colorObj).filter(([, h]) => !ground.includes(String(h).toLowerCase())).map(([k]) => k);
-  // Component depth
-  const comp = Object.keys(tokens.components || {}).length;
-  const harvested = tokens.components_harvested === true;
-  const cstatus = harvested ? 'harvested' : comp >= RICH ? 'rich' : comp >= 1 ? 'baseline' : 'none';
-  return {
-    id,
-    status: ungrounded.length ? 'check' : 'done',
-    source: tokens.source || '?',
-    colors: Object.keys(colorObj).length,
-    ground: ungrounded.length ? `ungrounded:${ungrounded.join(',')}` : 'ok',
-    comp, harvested, cstatus,
-  };
-});
-
-const done = rows.filter(r => r.status === 'done');
-const pending = rows.filter(r => r.status === 'pending');
-const flagged = rows.filter(r => r.status === 'check' || r.status === 'error');
-
-// Component view: a "harvest candidate" is a tokenized ref we haven't run the
-// harvest pass on AND whose component map is still below rich. Harvested refs
-// (rich OR honestly-capped) drop off — we don't nag source-limited refs.
-const withTokens = rows.filter(r => r.cstatus !== 'no-tokens');
-const harvested = withTokens.filter(r => r.harvested);
-const rich = withTokens.filter(r => !r.harvested && r.cstatus === 'rich');
-const candidates = withTokens.filter(r => !r.harvested && r.comp < RICH);
-
-if (asMd) {
-  console.log(`# Catalog checklist\n`);
-  console.log(`**Tokens** — done ${done.length}/${rows.length} · pending ${pending.length} · needs-attention ${flagged.length}`);
-  console.log(`**Components** — harvested ${harvested.length} · rich(unmarked) ${rich.length} · candidates ${candidates.length}\n`);
-  console.log(`## Tokens — Done\n${done.map(r => `- [x] ${r.id} \`${r.source}\` (${r.colors} colors, ${r.comp} comp)`).join('\n') || '- none'}\n`);
-  if (flagged.length) console.log(`## Tokens — Needs attention\n${flagged.map(r => `- [ ] ${r.id} — ${r.status} (${r.ground})`).join('\n')}\n`);
-  console.log(`## Tokens — Pending\n${pending.map(r => `- [ ] ${r.id}`).join('\n') || '- none'}\n`);
-  console.log(`## Components — Harvested (done, incl. honestly-capped)\n${harvested.map(r => `- [x] ${r.id} (${r.comp} comp)`).join('\n') || '- none'}\n`);
-  console.log(`## Components — Harvest candidates (tokenized, <${RICH} comp, not yet harvested)\n${candidates.map(r => `- [ ] ${r.id} (${r.comp} comp)`).join('\n') || '- none'}`);
-} else if (onlyDone) {
-  done.forEach(r => console.log(`${r.id}\t${r.source}\t${r.colors}c\t${r.comp}comp${r.harvested ? '\tharvested' : ''}`));
-} else if (compView) {
-  console.log(`components: harvested ${harvested.length} · rich(unmarked) ${rich.length} · candidates ${candidates.length} · no-tokens ${rows.length - withTokens.length}\n`);
-  console.log('HARVESTED:', harvested.map(r => `${r.id}(${r.comp})`).join(' ') || '(none)');
-  console.log(`\nCANDIDATES (${candidates.length}, tokenized & <${RICH} comp):`, candidates.map(r => `${r.id}(${r.comp})`).join(' ') || '(none)');
-} else {
-  console.log(`tokens: done ${done.length}/${rows.length} · pending ${pending.length} · needs-attention ${flagged.length}`);
-  console.log(`components: harvested ${harvested.length} · rich(unmarked) ${rich.length} · candidates ${candidates.length}\n`);
-  if (flagged.length) { console.log('NEEDS ATTENTION:'); flagged.forEach(r => console.log(`  ${r.id.padEnd(14)} ${r.status} ${r.ground}`)); console.log(''); }
-  console.log('DONE:', done.map(r => r.id).join(' ') || '(none)');
-  console.log(`\nPENDING (${pending.length}):`, pending.map(r => r.id).join(' '));
-}

package/.opencode/oh-my-design/web/scripts/verify-reference.mjs

@@ -1,185 +0,0 @@
-#!/usr/bin/env node
-/**
- * verify-reference.mjs — standalone per-reference gate.
- *
- *   node web/scripts/verify-reference.mjs <id> [--no-net]
- *
- * Runs every per-ref assertion from web/__tests__/catalog-integrity.test.ts
- * WITHOUT needing the registry to be rebuilt, plus the failure classes that
- * historically slipped past authoring agents and only surfaced later:
- *
- *   - strict-YAML frontmatter parse (the build-registry crash class)
- *   - logo liveness: favicon slug must be a fetchable image URL (not a bare
- *     domain — logos.ts renders the slug verbatim), simpleicons/github slugs
- *     must resolve 200, and the favicon must not be Google's generic globe
- *   - §10–15 presence, §7 Do/Don't parseable markers
- *
- * Exit 0 = every gate green (safe to hand to SYNC). Exit 1 = itemized FAILs.
- * Designed so an authoring sub-agent can self-verify with ONE command and an
- * orchestrator can trust `status: OK` without re-reading the files.
- */
-import { readFileSync, existsSync } from 'node:fs';
-import { join, dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import yaml from 'js-yaml';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const REFS = resolve(__dirname, '..', 'references');
-
-const id = process.argv[2];
-const NO_NET = process.argv.includes('--no-net');
-if (!id) { console.error('usage: verify-reference.mjs <id> [--no-net]'); process.exit(1); }
-
-const VALID_COUNTRIES = ['KR', 'US', 'JP', 'TW', 'CN', 'UK', 'DE', 'FR', 'IT'];
-const VALID_LOGO_TYPES = ['favicon', 'simpleicons', 'github'];
-const VALID_CATEGORIES = ['ecommerce', 'fintech', 'saas', 'ai', 'consumer-tech', 'education', 'productivity', 'developer-tools', 'design-tools', 'backend-devops', 'automotive', 'marketing', 'government', 'healthcare'];
-const RENDER_TYPES = ['button', 'input', 'card', 'badge', 'tab', 'toggle', 'toast', 'dialog', 'listItem', 'avatar'];
-const PROOF_GATE_CUTOFF = '2026-06-01';
-const NON_REGIONAL_HOSTS = /getdesign\.md|refero\.design|google\.com\/s2/i;
-// Keep in sync with FIELD_ALIASES in src/lib/extract-tokens.ts (subset is fine —
-// these are the keys the slash-multi-field parser bug actually swallows).
-const KNOWN_FIELDS = ['background', 'bg', 'text', 'color', 'fg', 'border', 'radius', 'corner', 'padding', 'height', 'font', 'shadow', 'hover', 'pressed', 'focus', 'active', 'disabled', 'use', 'state', 'states', 'icon', 'width'];
-
-const results = [];
-const pass = (name, detail = '') => results.push({ ok: true, name, detail });
-const fail = (name, detail = '') => results.push({ ok: false, name, detail });
-
-const dir = join(REFS, id);
-const mdPath = join(dir, 'DESIGN.md');
-if (!existsSync(mdPath)) { console.error(`FAIL: ${mdPath} does not exist`); process.exit(1); }
-const md = readFileSync(mdPath, 'utf-8');
-
-// ── 1. Frontmatter: strict YAML + required keys ────────────────────────
-let fm = null;
-let fmClose = -1;
-if (!md.startsWith('---\n')) fail('frontmatter-open', 'file must start with ---');
-else {
-  fmClose = md.indexOf('\n---\n', 4);
-  if (fmClose < 0) fail('frontmatter-close', 'no closing ---');
-  else {
-    const raw = md.slice(4, fmClose);
-    try { fm = yaml.load(raw); pass('yaml-strict-parse'); }
-    catch (e) { fail('yaml-strict-parse', `frontmatter is not valid YAML (build-registry will reject it): ${e.message.split('\n')[0]}`); }
-    // markdown leak (heading / col-0 bullet outside the tokens block)
-    const fmRegion = raw.replace(/^tokens:\n(?:(?:[ \t].*)?\n)*/m, '');
-    if (/^#{1,6}\s/m.test(fmRegion) || /^- /m.test(fmRegion)) fail('frontmatter-leak', 'markdown heading/bullet leaked into frontmatter');
-    else pass('frontmatter-leak');
-  }
-}
-
-if (fm) {
-  if (fm.id === id) pass('fm-id'); else fail('fm-id', `frontmatter id "${fm.id}" != dir "${id}"`);
-  if (typeof fm.name === 'string' && fm.name.length) pass('fm-name'); else fail('fm-name');
-  if (VALID_COUNTRIES.includes(fm.country)) pass('fm-country'); else fail('fm-country', String(fm.country));
-  if (VALID_CATEGORIES.includes(fm.category)) pass('fm-category'); else fail('fm-category', `"${fm.category}" not in canonical enum`);
-  if (/^https?:\/\//.test(fm.homepage || '')) pass('fm-homepage'); else fail('fm-homepage', String(fm.homepage));
-  if (/^#[0-9a-fA-F]{6}$/.test(fm.primary_color || '')) pass('fm-primary-color'); else fail('fm-primary-color', String(fm.primary_color));
-  if (/^\d{4}-\d{2}-\d{2}$/.test(String(fm.verified || ''))) pass('fm-verified'); else fail('fm-verified', String(fm.verified));
-  const logo = fm.logo || {};
-  if (!VALID_LOGO_TYPES.includes(logo.type)) fail('logo-type', String(logo.type));
-  else if (logo.type === 'favicon' && !/^https?:\/\//.test(logo.slug || '')) {
-    // logos.ts getLogoUrl returns the slug VERBATIM for favicon — a bare domain renders a broken <img>.
-    fail('logo-favicon-url', `favicon slug must be a full image URL, got "${logo.slug}" (use https://www.google.com/s2/favicons?domain=<domain>&sz=128 or a brand CDN icon URL)`);
-  } else pass('logo-schema', `${logo.type}/${String(logo.slug).slice(0, 60)}`);
-}
-
-// ── 2. §1 canonical header + prose-first ───────────────────────────────
-if (/^## 1\. Visual Theme & Atmosphere/m.test(md)) pass('sec1-header');
-else fail('sec1-header', 'must be exactly "## 1. Visual Theme & Atmosphere"');
-const sec1 = md.split(/^## 1\. Visual Theme & Atmosphere[^\n]*\n/m)[1] || '';
-if (sec1.startsWith('\n')) pass('sec1-blank-line'); else fail('sec1-blank-line', 'blank line required after §1 header');
-const firstLine = sec1.split('\n').map(l => l.trim()).find(l => l.length > 0) || '';
-const nonProse = /^#{1,6}(\s|$)/.test(firstLine) || firstLine.startsWith('|') || /^[-+]\s/.test(firstLine) || /^\*\s(?!\*)/.test(firstLine) || /^\d+\.\s/.test(firstLine);
-if (nonProse) fail('sec1-prose-first', firstLine.slice(0, 60)); else pass('sec1-prose-first');
-
-// ── 3. §4 slash-multi-field + placeholder lint ─────────────────────────
-const sec4 = md.match(/## 4\. Component[\s\S]*?(?=\n## 5\.|$)/i)?.[0] ?? '';
-if (!sec4) fail('sec4-present', 'no "## 4. Component..." section');
-const fieldBullets = sec4.split('\n').filter(l => /^[-*]\s+(?!\*\*)[A-Za-z]/.test(l));
-const slashRe = new RegExp(` / \\*{0,2}(?:${KNOWN_FIELDS.join('|')})\\*{0,2}\\s*[:：]`, 'i');
-const slashOffenders = fieldBullets.filter(l => { const c = l.indexOf(':'); return c !== -1 && slashRe.test(l.slice(c + 1)); });
-if (slashOffenders.length) fail('sec4-slash-multifield', slashOffenders[0]); else pass('sec4-slash-multifield');
-const placeholderOffenders = fieldBullets.filter(l => { const c = l.indexOf(':'); if (c === -1) return false; return /^(not\s+(measured|specified|applicable|available)|n\/a|unknown|tbd)\b/i.test(l.slice(c + 1).trim()); });
-if (placeholderOffenders.length) fail('sec4-placeholder', placeholderOffenders[0]); else pass('sec4-placeholder');
-
-// ── 4. Footer + proof gate + KR/TW regional rule ───────────────────────
-const gated = fm && String(fm.verified) >= PROOF_GATE_CUTOFF;
-const tier1Line = md.match(/^\*\*Tier 1 sources:\*\*\s*(.+)$/m)?.[1] ?? '';
-const tier1Urls = tier1Line.match(/https?:\/\/[^\s,)]+/g) ?? [];
-if (gated) {
-  if (/^\*\*Verified:\*\*/m.test(md)) pass('footer-verified'); else fail('footer-verified', 'missing **Verified:** footer');
-  if (tier1Urls.length >= 1) pass('footer-tier1-url', `${tier1Urls.length} URL(s)`); else fail('footer-tier1-url', '§4 footer "Tier 1 sources" lists no URL');
-  if (fm && (fm.country === 'KR' || fm.country === 'TW')) {
-    const regional = tier1Urls.filter(u => !NON_REGIONAL_HOSTS.test(u));
-    if (regional.length >= 2) pass('kr-tw-regional', `${regional.length} brand-owned`);
-    else fail('kr-tw-regional', `KR/TW needs >= 2 brand-owned Tier-1 sources, got ${regional.length}`);
-  }
-  const proofPath = join(dir, '.verification.md');
-  if (!existsSync(proofPath)) fail('proof-file', '.verification.md missing');
-  else {
-    const proof = readFileSync(proofPath, 'utf-8');
-    if (/^##\s+Proof/m.test(proof)) pass('proof-block'); else fail('proof-block', 'needs a "## Proof" heading');
-    const rawSamples = (proof.match(/rgb\(|#[0-9a-fA-F]{6}\b|\b\d+px\b/g) ?? []).length;
-    if (rawSamples >= 5) pass('proof-samples', `${rawSamples}`); else fail('proof-samples', `only ${rawSamples} raw samples (need >= 5)`);
-    if (/https?:\/\//.test(proof)) pass('proof-url'); else fail('proof-url', 'proof needs >= 1 source URL');
-  }
-}
-
-// ── 5. Token ↔ prose grounding + structured components ─────────────────
-const tokens = fm?.tokens;
-if (tokens) {
-  const grounding = md.replace(/\ntokens:\n(?:[ \t].*(?:\n|$))*/, '\n').toLowerCase();
-  const tokenColors = tokens.colors ?? tokens.color ?? {};
-  const ungrounded = Object.entries(tokenColors).filter(([, hex]) => !grounding.includes(String(hex).toLowerCase()));
-  if (ungrounded.length) fail('token-color-grounding', ungrounded.map(([r, h]) => `${r}=${h}`).join(' '));
-  else pass('token-color-grounding', `${Object.keys(tokenColors).length} colors`);
-  const comps = tokens.components;
-  if (!comps || typeof comps !== 'object') fail('token-components', 'tokens.components missing or not structured');
-  else {
-    if (typeof tokens.components_harvested !== 'boolean') fail('components-harvested', 'components_harvested must be a boolean');
-    else pass('components-harvested');
-    let compFail = false;
-    for (const [cname, c] of Object.entries(comps)) {
-      if (typeof c !== 'object' || c === null) { fail('component-structured', `'${cname}' is a flat string`); compFail = true; continue; }
-      if (!RENDER_TYPES.includes(c.type)) { fail('component-type', `'${cname}' type '${c.type}' not in 10 render types`); compFail = true; }
-      for (const k of ['bg', 'fg', 'border']) {
-        for (const hex of String(c[k] ?? '').match(/#[0-9a-fA-F]{6}/g) ?? []) {
-          if (!grounding.includes(hex.toLowerCase())) { fail('component-hex-grounding', `${cname}.${k} ${hex} not grounded`); compFail = true; }
-        }
-      }
-    }
-    if (!compFail) pass('components-structured', `${Object.keys(comps).length} components`);
-  }
-} else fail('tokens-block', 'frontmatter has no tokens: block');
-
-// ── 6. §7 Do/Don't markers + §10–15 presence ───────────────────────────
-const GUIDELINE_MARKER = /^###\s+Do(?:['’]?s)?\b|^###\s+Don['’]?t|^[-*]\s+\*\*DO(?:N['’]?T)?\*\*/im;
-if (GUIDELINE_MARKER.test(md)) pass('guideline-markers'); else fail('guideline-markers', '§7 needs "### Do" / "### Don\'t" headers (or - **DO** bullets)');
-const philSections = (md.match(/^## 1[0-5]\. /gm) ?? []).length;
-if (philSections === 6) pass('sections-10-15'); else fail('sections-10-15', `found ${philSections}/6 philosophy sections`);
-
-// ── 7. Logo liveness (network) ─────────────────────────────────────────
-if (!NO_NET && fm?.logo && VALID_LOGO_TYPES.includes(fm.logo.type)) {
-  const { type, slug } = fm.logo;
-  const url = type === 'github' ? `https://github.com/${slug}.png?size=64`
-    : type === 'simpleicons' ? `https://cdn.simpleicons.org/${slug}`
-    : slug;
-  try {
-    const res = await fetch(url, { redirect: 'follow', signal: AbortSignal.timeout(15000) });
-    const buf = res.ok ? Buffer.from(await res.arrayBuffer()) : Buffer.alloc(0);
-    const ctype = res.headers.get('content-type') || '';
-    if (!res.ok) fail('logo-live', `HTTP ${res.status} for ${url}`);
-    else if (!/image|svg|octet/.test(ctype)) fail('logo-live', `content-type "${ctype}" is not an image (${url})`);
-    else if (type === 'favicon' && /google\.com\/s2/.test(url) && buf.length < 450) fail('logo-live', `favicon is ${buf.length}B — likely Google's generic globe; pick a brand CDN icon / simpleicons / github org instead`);
-    else pass('logo-live', `${buf.length}B ${ctype.split(';')[0]}`);
-  } catch (e) { fail('logo-live', `fetch error: ${e.message}`); }
-}
-
-// ── Report ─────────────────────────────────────────────────────────────
-let failed = 0;
-for (const r of results) {
-  if (!r.ok) failed++;
-  console.log(`${r.ok ? 'PASS' : 'FAIL'}  ${r.name}${r.detail ? `  — ${r.detail}` : ''}`);
-}
-console.log(`\n${id}: ${results.length - failed}/${results.length} gates green${failed ? ` — ${failed} FAILING` : ''}`);
-process.exit(failed ? 1 : 0);