#!/usr/bin/env node // Generates shared/game/card-data.ts from council-data's frozen files (docs/game/*.json). // The engine does no I/O, so the data is embedded as constants. Rerun after the JSON changes: // node scripts/game-card-data.mjs import { readFileSync, writeFileSync } from 'node:fs'; const root = new URL('../', import.meta.url); const sample = JSON.parse(readFileSync(new URL('docs/game/card-sample.json', root), 'utf8')); const starter = JSON.parse(readFileSync(new URL('docs/game/starter-cards.json', root), 'utf8')); // DESIGN §1.1: 99 ascending cut points per stat. Cut k (1..99) is the value at rank floor(k·n/100) // of the sample's sorted scores; null attention is excluded from its table. function cuts(values) { const sorted = values.filter(v => typeof v === 'number').sort((a, b) => a - b); if (sorted.length < 2) throw new Error('sample too small'); return Array.from({ length: 99 }, (_, i) => sorted[Math.min(sorted.length - 1, Math.floor((i + 1) * sorted.length / 100))]); } // Prefer council-data's published table (card-sample.json `percentiles`); fall back to computing it. const official = sample.percentiles && ['attention', 'depth', 'reach'].every(stat => sample.percentiles[stat]?.length === 99); const table = official ? { attention: sample.percentiles.attention, depth: sample.percentiles.depth, reach: sample.percentiles.reach } : Object.fromEntries(['attention', 'depth', 'reach'].map(stat => [stat, cuts(sample.cards.map(c => c.stats?.[stat]))])); const method = official ? sample.percentilesMethod : 'computed here: value at rank floor(k*n/100)'; const daysIn = month => { const [y, m] = month.split('-').map(Number); return new Date(Date.UTC(y, m, 0)).getUTCDate(); }; const pool = starter.cards.map(c => ({ pageId: c.pageId, title: c.title, category: c.category, stats: { attention: c.stats.attention ?? null, depth: c.stats.depth, reach: c.stats.reach }, trendPercent: c.trendPercent ?? null, dailyAverage: typeof c.monthlyViews === 'number' && c.latestMonth ? Math.round(c.monthlyViews / daysIn(c.latestMonth) * 100) / 100 : null, })); const out = `// GENERATED by scripts/game-card-data.mjs from docs/game/card-sample.json (${sample.cards.length} cards, // generated ${sample.generatedAt}) and docs/game/starter-cards.json (frozen ${starter.frozenAt}). Do not edit by hand. // Percentiles: ${method} import type { PercentileTable } from './derive.ts'; import type { Faction } from './types.ts'; /** DESIGN §1.1 reference table "card-sample-2026-11-16": 99 cut points per stat. */ export const CARD_SAMPLE_PERCENTILES: PercentileTable = ${JSON.stringify(table)}; export interface LoanerSnapshot { pageId: number; title: string; category: Faction; stats: { attention: number | null; depth: number; reach: number }; trendPercent: number | null; dailyAverage: number | null; } /** Frozen loaner pool (§2): real snapshots of random articles, for filling deck slots and draft modes. */ export const LOANER_SNAPSHOTS: readonly LoanerSnapshot[] = ${JSON.stringify(pool, null, 1).replace(/\n\s*/g, ' ')}; `; writeFileSync(new URL('shared/game/card-data.ts', root), out); console.log(`card-data.ts: ${pool.length} loaners, percentile tables from ${sample.cards.length} sample cards`);