Something went wrong. Try again.
Monorepo for Aesthetic.Computer aesthetic.computer
Something went wrong. Try again.
JavaScript
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886#!/usr/bin/env node// papers cli — build, deploy, and track all AC papers//// Usage:// node papers/cli.mjs build [lang] Build PDFs (all langs, or: en, da, es, zh)// node papers/cli.mjs build --force Rebuild everything (skip mtime check)// node papers/cli.mjs deploy Copy built PDFs to site directory// node papers/cli.mjs publish Build all + deploy + update index// node papers/cli.mjs publish --force Full pipeline, force-rebuilding everything// node papers/cli.mjs status Show build status for all papers// node papers/cli.mjs log Show build log//// Builds are incremental: a paper is only rebuilt when its source files (.tex,// .bib, .sty, figures/*) are newer than the output PDF. Pass --force to bypass.//// Examples:// node papers/cli.mjs build Build changed papers (en + da + es + zh)// node papers/cli.mjs build en Build changed English PDFs only// node papers/cli.mjs build --force Rebuild everything// node papers/cli.mjs publish Full incremental pipeline
import { execSync } from "child_process";import { existsSync, copyFileSync, mkdirSync, readFileSync, writeFileSync, statSync, readdirSync,} from "fs";import { join, basename } from "path";
const PAPERS_DIR = new URL(".", import.meta.url).pathname;const SITE_DIR = join( PAPERS_DIR, "../system/public/papers.aesthetic.computer",);const THUMBS_DIR = join(SITE_DIR, "thumbs");const BUILDLOG = join(PAPERS_DIR, "BUILDLOG.md");const METADATA_PATH = join(PAPERS_DIR, "metadata.json");const LANGS = ["en", "da", "es", "zh", "ja", "ru"];
// Papers that have a spoken-word reading (podcast) on the asset CDN at// assets.aesthetic.computer/podcast/{siteName}.mp3. Add a siteName here when// an episode is produced + uploaded (marketing/podcast lane).const PODCASTS = new Set([ "aesthetic-may-26-essay", "aesthetic-june-26-essay", "aesthetic-july-4-26-essay", "aesthetic-july-10-26-essay", "the-record-is-a-better-interface-essay", "the-console-has-a-browser-essay", "a-record-in-the-mail-essay",]);const LANG_NAMES = { en: "English", da: "Danish", es: "Spanish", zh: "Chinese", ja: "Japanese", ru: "Russian" };
function loadMetadata() { if (!existsSync(METADATA_PATH)) return {}; return JSON.parse(readFileSync(METADATA_PATH, "utf8"));}
function saveMetadata(meta) { writeFileSync(METADATA_PATH, JSON.stringify(meta, null, 2) + "\n", "utf8");}
// Translation key from paper dir (matches keys in index.html inline translations)function translationKey(dir) { const key = dir.replace("arxiv-", ""); const overrides = { "kidlisp-reference": "kidlisp-ref", "sustainability": "who-pays" }; return overrides[key] || key;}
// Map paper dir → tex base name + site PDF nameconst PAPER_MAP = { "arxiv-stack-summer-26": { base: "stack-summer-26", siteName: "stack-of-the-summer-26-arxiv", title: "Stack of the Summer '26", }, "arxiv-ac": { base: "ac", siteName: "aesthetic-computer-26-arxiv", title: "Aesthetic Computer '26", }, "arxiv-aesthinema": { base: "aesthinema", siteName: "aesthinema-26-arxiv", title: "Aesthinema", }, "arxiv-api": { base: "api", siteName: "piece-api-26-arxiv", title: "From setup() to boot()", }, "arxiv-archaeology": { base: "archaeology", siteName: "repo-archaeology-26-arxiv", title: "Repository Archaeology", }, "arxiv-hand-and-loop": { base: "handloop", siteName: "hand-and-loop-26-arxiv", title: "The Hand and the Loop", }, "arxiv-dead-ends": { base: "dead-ends", siteName: "dead-ends-26-arxiv", title: "Vestigial Features", }, "arxiv-diversity": { base: "diversity", siteName: "citation-diversity-audit-26", title: "Citation Diversity Audit", }, "arxiv-goodiepal": { base: "goodiepal", siteName: "radical-computer-art-26-arxiv", title: "Radical Computer Art", }, "arxiv-pals": { base: "pals", siteName: "pals-mark-26-arxiv", title: "The Pals Mark", }, "arxiv-kidlisp": { base: "kidlisp", siteName: "kidlisp-26-arxiv", title: "KidLisp '26", }, "arxiv-hott-kidlisp": { base: "hott-kidlisp", siteName: "hott-kidlisp-26-arxiv", title: "Equal Enough to Draw", }, "arxiv-kidlisp-reference": { base: "kidlisp-reference", siteName: "kidlisp-reference-26-arxiv", title: "KidLisp Language Reference", }, "arxiv-keymaps": { base: "keymaps", siteName: "keymaps-social-software-26-arxiv", title: "Keymaps as Social Software", }, "arxiv-network-audit": { base: "network-audit", siteName: "network-audit-26-arxiv", title: "Network Audit", }, "arxiv-notepat": { base: "notepat", siteName: "notepat-26-arxiv", title: "notepat.com", }, "arxiv-os": { base: "os", siteName: "ac-native-os-26-arxiv", title: "AC Native OS", }, "arxiv-pieces": { base: "pieces", siteName: "pieces-not-programs-26-arxiv", title: "Pieces Not Programs", }, "arxiv-sustainability": { base: "sustainability", siteName: "who-pays-for-creative-tools-26-arxiv", title: "Who Pays for Creative Tools?", }, "arxiv-whistlegraph": { base: "whistlegraph", siteName: "whistlegraph-26-arxiv", title: "Whistlegraph", }, "arxiv-plork": { base: "plork", siteName: "plorking-the-planet-26-arxiv", title: "PLOrk'ing the Planet", }, "arxiv-folk-songs": { base: "folk-songs", siteName: "folk-songs-26-arxiv", title: "Playable Folk Songs", }, "arxiv-complex": { base: "complex", siteName: "sucking-on-the-complex-26-arxiv", title: "Sucking on the Complex", }, "arxiv-kidlisp-cards": { base: "kidlisp-cards", siteName: "kidlisp-cards-26-arxiv", title: "KidLisp Cards", }, "arxiv-score-analysis": { base: "score-analysis", siteName: "reading-the-score-26-arxiv", title: "Reading the Score", }, "arxiv-calarts": { base: "calarts", siteName: "calarts-callouts-papers-26-arxiv", title: "CalArts, Callouts, and Papers", psycho: true, }, "arxiv-open-schools": { base: "open-schools", siteName: "open-schools-26-arxiv", title: "Get Closed Source Out of Schools", }, "arxiv-futures": { base: "futures", siteName: "five-years-from-now-26-arxiv", title: "Five Years from Now", }, "essay-may-26": { base: "may-26", siteName: "aesthetic-may-26-essay", title: "Aesthetic May '26", format: "essay", }, "essay-june-26": { base: "june-26", siteName: "aesthetic-june-26-essay", title: "Aesthetic June '26", format: "essay", }, "essay-july-4-26": { base: "july-4-26", siteName: "aesthetic-july-4-26-essay", title: "Aesthetic July 4 '26", format: "essay", }, "essay-july-10-26": { base: "july-10-26", siteName: "aesthetic-july-10-26-essay", title: "'Sup w/ July 10?", format: "essay", }, "essay-granularity": { base: "granularity", siteName: "the-record-is-a-better-interface-essay", title: "The Record Is a Better Interface", format: "essay", }, "essay-console-browser": { base: "console-browser", siteName: "the-console-has-a-browser-essay", title: "The Console Has a Browser", format: "essay", }, "essay-physical-mail": { base: "physical-mail", siteName: "a-record-in-the-mail-essay", title: "A Record in the Mail", format: "essay", }, "essay-keymap-score": { base: "keymap-score", siteName: "the-keymap-is-the-score-essay", title: "The Keymap Is the Score", format: "essay", }, "deck-media-estate": { base: "media-estate", siteName: "media-estate-26-deck", title: "The Media Estate", format: "deck", }, "nopaint-3-full-shape": { base: "nopaint-3-full-shape", siteName: "nopaint-3-full-shape-2026", title: "No Paint 3.0: The Full Shape", format: "briefing", hidden: true, }, "arxiv-identity": { base: "identity", siteName: "handle-identity-atproto-26-arxiv", title: "Handle Identity on the AT Protocol", }, "arxiv-ucla-arts": { base: "ucla-arts", siteName: "ucla-arts-funding-26-arxiv", title: "Two Departments, One Building", }, "arxiv-holden": { base: "holden", siteName: "potter-and-prompt-26-arxiv", title: "The Potter and the Prompt", }, "arxiv-url-tradition": { base: "url-tradition", siteName: "url-tradition-26-arxiv", title: "The URL Tradition", }, "arxiv-latency": { base: "latency", siteName: "where-the-microseconds-go-26-arxiv", title: "Where the Microseconds Go", }, "arxiv-oskiewar": { base: "oskiewar", siteName: "oskiewar-26-arxiv", title: "oskiewar", }, "arxiv-oskiewar-store": { base: "store", siteName: "oskiewar-store-26-arxiv", title: "The Door Is Shut: oskiewar and the Retail Xbox Store", }, "arxiv-penrose": { base: "penrose", siteName: "diagrams-from-data-26-arxiv", title: "Diagrams from Data", }, "arxiv-nom": { base: "nom", siteName: "nom-games-26-arxiv", title: "The nom Games", }, "arxiv-granularity": { base: "granularity", siteName: "gaps-in-granularity-26-arxiv", title: "Gaps in Granularity", }, "arxiv-cal": { base: "cal", siteName: "cal-aesthetical-26-arxiv", title: "AesthetiCal: A URL-Addressable Calendar", }, "cv": { base: "cv", siteName: "jeffrey-alan-scudder-cv", title: "Jeffrey Alan Scudder — CV", hidden: true, }, "arxiv-rhizome": { base: "rhizome", siteName: "rhizome-dossier-26-arxiv", title: "Rhizome.org — A Dossier", }, "arxiv-sfpc": { base: "sfpc", siteName: "sfpc-dossier-26-arxiv", title: "School for Poetic Computation — A Dossier", }, "arxiv-eyebeam": { base: "eyebeam", siteName: "eyebeam-dossier-26-arxiv", title: "Eyebeam — A Dossier", }, "arxiv-recurse": { base: "recurse", siteName: "recurse-dossier-26-arxiv", title: "Recurse Center — A Dossier", }, "arxiv-internet-archive": { base: "internet-archive", siteName: "internet-archive-dossier-26-arxiv", title: "Internet Archive — A Dossier", }, "arxiv-mellon": { base: "mellon", siteName: "mellon-dossier-26-arxiv", title: "Mellon Foundation — A Dossier", }, "arxiv-pioneer-works": { base: "pioneer-works", siteName: "pioneer-works-dossier-26-arxiv", title: "Pioneer Works — A Dossier", }, "arxiv-fraserin": { base: "fraserin", siteName: "fraserin-essay-26-arxiv", title: "A Fraserin' Art + Tech", }, "arxiv-comp-strats": { base: "comp-strats", siteName: "comp-strats-26-arxiv", title: "Comp Strats", }, "arxiv-microvision": { base: "microvision", siteName: "microvision-dossier-26-arxiv", title: "MicroVision — A Dossier", }, "arxiv-calarts-news": { base: "calarts-news", siteName: "whats-new-calarts-26-arxiv", title: "What's New CalArts!? — A Dossier", }, "arxiv-new-inc": { base: "new-inc", siteName: "new-inc-dossier-26-arxiv", title: "NEW INC — A Dossier", }, "arxiv-studio-museum": { base: "studio-museum", siteName: "studio-museum-dossier-26-arxiv", title: "Studio Museum in Harlem — A Dossier", }, "arxiv-hathitrust": { base: "hathitrust", siteName: "hathitrust-dossier-26-arxiv", title: "HathiTrust — A Dossier", }, "arxiv-the-kitchen": { base: "the-kitchen", siteName: "the-kitchen-dossier-26-arxiv", title: "The Kitchen — A Dossier", }, "arxiv-machine-project": { base: "machine-project", siteName: "machine-project-dossier-26-arxiv", title: "Machine Project — A Dossier", }, "arxiv-heavy-manners-library": { base: "heavy-manners-library", siteName: "heavy-manners-library-dossier-26-arxiv", title: "Heavy Manners Library — A Dossier", }, "arxiv-creative-time": { base: "creative-time", siteName: "creative-time-dossier-26-arxiv", title: "Creative Time — A Dossier", }, "arxiv-creative-capital": { base: "creative-capital", siteName: "creative-capital-dossier-26-arxiv", title: "Creative Capital — A Dossier", }, "arxiv-propublica": { base: "propublica", siteName: "propublica-dossier-26-arxiv", title: "ProPublica — A Dossier", },};
// Dossier swimlane — rendered in their own "dossiers;" section on the// index, separate from the argumentative papers. Order here is the// display order within that section.const DOSSIER_DIRS = [ "arxiv-rhizome", "arxiv-sfpc", "arxiv-eyebeam", "arxiv-recurse", "arxiv-internet-archive", "arxiv-mellon", "arxiv-pioneer-works", "arxiv-new-inc", "arxiv-studio-museum", "arxiv-hathitrust", "arxiv-the-kitchen", "arxiv-machine-project", "arxiv-heavy-manners-library", "arxiv-creative-time", "arxiv-creative-capital", "arxiv-propublica", "arxiv-microvision", "arxiv-calarts-news",];const dossierRank = (dir) => { const i = DOSSIER_DIRS.indexOf(dir); return i === -1 ? 99 : i;};
// Top-level index categories. Every listed (non-hidden, non-archived)// paper resolves to exactly one. Order here is the page order. The// "software" lane is populated from the `extras` array (JOSS/ELS), not// from PAPER_MAP, so its `dirs` stays empty. Lists flagged `nosort` keep// their curated DOM order and are skipped by the client-side sort bar.const CATEGORIES = [ { key: "platform", title: "Platform & Language", sub: "The runtime, the language, and the surfaces you actually touch.", dirs: [ "arxiv-stack-summer-26", "arxiv-ac", "arxiv-kidlisp", "arxiv-hott-kidlisp", "arxiv-os", "arxiv-api", "arxiv-pieces", "arxiv-notepat", "arxiv-oskiewar", "arxiv-oskiewar-store", "arxiv-cal", "arxiv-kidlisp-reference", "arxiv-kidlisp-cards", "arxiv-keymaps", "arxiv-url-tradition", "arxiv-latency", "arxiv-penrose", "arxiv-identity", ], }, { key: "essays", title: "Essays & Criticism", sub: "Arguments about creative computing — its lineage, its players, and its discontents.", dirs: [ "arxiv-plork", "arxiv-sustainability", "arxiv-goodiepal", "arxiv-whistlegraph", "arxiv-complex", "arxiv-dead-ends", "arxiv-folk-songs", "arxiv-futures", "arxiv-holden", "arxiv-fraserin", "arxiv-score-analysis", "arxiv-comp-strats", "arxiv-nom", "arxiv-granularity", "essay-may-26", "essay-june-26", "essay-july-4-26", "essay-july-10-26", "essay-granularity", "essay-console-browser", "essay-physical-mail", "essay-keymap-score", ], }, { key: "audits", title: "Audits & Field Studies", sub: "Data turned back on the project itself — who uses it, what it cites, where it came from.", dirs: [ "arxiv-archaeology", "arxiv-hand-and-loop", "arxiv-network-audit", "arxiv-diversity", "arxiv-open-schools", ], }, { key: "decks", title: "Decks", sub: "Slide overviews — the papers register at presentation altitude, one page per slide.", dirs: ["deck-media-estate"], }, { key: "dossiers", title: "Dossiers", sub: "What's publicly recoverable about art-and-tech institutions and their largest funders — fact-surfacing, not argument.", nosort: true, dirs: [...DOSSIER_DIRS, "arxiv-ucla-arts"], }, { key: "software", title: "Software Papers", sub: "Conventional software-paper summaries, for archival and citation.", dirs: [], // populated from the `extras` array (JOSS / ELS) },];
// Papers retired to the quiet Archive section at the very bottom of the// page, regardless of their category. Keyed by `dir`.const ARCHIVE_DIRS = new Set(["arxiv-calarts"]);
// dir -> category key (dossiers included; archived + software handled separately)const CATEGORY_OF = {};for (const c of CATEGORIES) for (const d of c.dirs) CATEGORY_OF[d] = c.key;const categoryOf = (dir) => CATEGORY_OF[dir] || "essays";
function texName(base, lang) { return lang === "en" ? base : `${base}-${lang}`;}
function sitePdfName(siteName, lang) { return lang === "en" ? `${siteName}.pdf` : `${siteName}-${lang}.pdf`;}
function findAll(langFilter) { const results = []; for (const [dir, info] of Object.entries(PAPER_MAP)) { const paperDir = join(PAPERS_DIR, dir); if (!existsSync(paperDir)) continue; const langs = langFilter ? [langFilter] : LANGS; for (const lang of langs) { const tex = texName(info.base, lang); const texFile = join(paperDir, `${tex}.tex`); const pdfFile = join(paperDir, `${tex}.pdf`); const sitePdf = join(SITE_DIR, sitePdfName(info.siteName, lang)); results.push({ dir, lang, base: info.base, title: info.title, siteName: info.siteName, psycho: !!info.psycho, hidden: !!info.hidden, texFile, pdfFile, texExists: existsSync(texFile), pdfExists: existsSync(pdfFile), sitePdf, sitePdfExists: existsSync(sitePdf), }); } // Auto-detect cards version: if {base}-cards.tex exists, add it as a build entry if (!langFilter || langFilter === "en") { const cardsTex = join(paperDir, `${info.base}-cards.tex`); const cardsPdf = join(paperDir, `${info.base}-cards.pdf`); const cardsSitePdf = join(SITE_DIR, `${info.siteName}-cards.pdf`); if (existsSync(cardsTex)) { results.push({ dir, lang: "cards", base: info.base, title: info.title, siteName: info.siteName, psycho: !!info.psycho, texFile: cardsTex, pdfFile: cardsPdf, texExists: true, pdfExists: existsSync(cardsPdf), sitePdf: cardsSitePdf, sitePdfExists: existsSync(cardsSitePdf), }); } } } return results;}
// Shared style files at the papers/ root — changes here affect all papers.const SHARED_STY = [ join(PAPERS_DIR, "ac-paper-layout.sty"), join(PAPERS_DIR, "ac-paper-cards.sty"),].filter(existsSync);
// Collect mtimes of all source files that could affect a paper's output.// Returns the most recent mtime (ms), or Infinity if any file is missing.function sourcesMtime(entry) { const paperDir = join(PAPERS_DIR, entry.dir); const sources = [];
// The .tex file itself sources.push(entry.texFile);
// All .bib and .sty files in the paper directory try { for (const f of readdirSync(paperDir)) { if (f.endsWith(".bib") || f.endsWith(".sty")) { sources.push(join(paperDir, f)); } } } catch {}
// Figures directory (all files) const figDir = join(paperDir, "figures"); try { for (const f of readdirSync(figDir)) { sources.push(join(figDir, f)); } } catch {}
// Shared style files sources.push(...SHARED_STY);
let newest = 0; for (const src of sources) { try { const mt = statSync(src).mtimeMs; if (mt > newest) newest = mt; } catch { return Infinity; // missing source → must rebuild } } return newest;}
// Sniff the xelatex .log next to a built PDF for the silent-failure signature:// fontspec couldn't load a requested font, so the run fell back to `nullfont`// and still emitted a small stub PDF (xelatex exits 0). Same shape as// the cards-convert bug — a stub passes the mtime check forever.function logShowsBrokenBuild(pdfFile) { const logFile = pdfFile.replace(/\.pdf$/, ".log"); if (!existsSync(logFile)) return false; try { const log = readFileSync(logFile, "utf8"); return log.includes("! Package fontspec Error") || log.includes("nullfont"); } catch { return false; }}
// Returns true if the paper needs rebuilding (source newer than PDF, or no PDF).function needsRebuild(entry) { if (!entry.pdfExists) return true; try { const pdfMtime = statSync(entry.pdfFile).mtimeMs; if (sourcesMtime(entry) > pdfMtime) return true; if (logShowsBrokenBuild(entry.pdfFile)) return true; return false; } catch { return true; }}
// Stamp figures/version.tex (and a bare version.tex) from git + metadata so// a paper that does `\input{version}` always carries the commit it was cut// from. No-op unless the paper's .tex actually inputs version. The hash gets// a "+" suffix when the working tree is dirty, matching `git describe --dirty`// convention — a clean release build (e.g. the oven) stamps a bare hash.function stampVersion(entry, paperDir) { const tex = texName(entry.base, entry.lang); const texPath = join(paperDir, `${tex}.tex`); let src = ""; try { src = readFileSync(texPath, "utf8"); } catch { return; } if (!src.includes("{version}")) return; // paper opts in via \input/\InputIfFileExists{version}
let hash = "unknown"; let dirty = ""; try { hash = execSync("git rev-parse --short HEAD", { cwd: paperDir, stdio: ["ignore", "pipe", "ignore"] }) .toString() .trim(); // Dirty flag reflects THIS paper's own directory only (gitignored // version.tex/history.tex/*.pdf excluded), not unrelated repo changes, // so a committed paper stamps a clean edition hash. const porcelain = execSync('git status --porcelain -- .', { cwd: paperDir, stdio: ["ignore", "pipe", "ignore"] }) .toString() .trim(); if (porcelain) dirty = "+"; } catch { /* not a git checkout — leave hash as "unknown" */ }
const meta = loadMetadata(); const rev = meta?.[entry.dir]?.revisions ?? "?";
const body = `% auto-generated by papers/cli.mjs at build time — do not edit\n` + `\\newcommand{\\paperhash}{${hash}${dirty}}\n` + `\\newcommand{\\paperrev}{${rev}}\n`; try { writeFileSync(join(paperDir, "version.tex"), body); } catch { /* read-only tree — leave any committed version.tex in place */ }
// history.tex: a \paperhistory macro built from the git log of the // paper's own .tex (date + commit subject), for an in-PDF changelog. // Only written if the paper inputs {history}. if (src.includes("{history}")) { let hist = ""; try { const raw = execSync( `git log --format=%ad%x09%s --date=short -- "${tex}.tex"`, { cwd: paperDir, stdio: ["ignore", "pipe", "ignore"] }, ).toString().trim(); const esc = (s) => s.replace(/\\/g, "").replace(/([&_#%$])/g, "\\$1").replace(/—/g, "---"); // Strip the redundant repeated "<dir>:" / "papers:" commit prefix. const stripPrefix = (m) => m.replace(/^(papers\/[\w-]+|arxiv-[\w-]+|papers|[\w-]+):\s*/i, ""); const rows = raw.split("\n").filter(Boolean).map((line) => { const tab = line.indexOf("\t"); const date = esc(line.slice(0, tab)); let msg = esc(stripPrefix(line.slice(tab + 1))); if (msg.length > 58) msg = msg.slice(0, 56) + "\\,\\ldots"; return `{\\color{acgray}${date}}~~${msg}\\\\`; }); // One entry per line, left-aligned. hist = rows.join("\n"); } catch { /* no git log — empty history */ } const histBody = `% auto-generated by papers/cli.mjs at build time — do not edit\n` + `\\newcommand{\\paperhistory}{%\n${hist}\n}\n`; try { writeFileSync(join(paperDir, "history.tex"), histBody); } catch { /* read-only tree */ } }}
function buildOne(entry) { if (!entry.texExists) { console.log(` SKIP ${entry.dir}/${texName(entry.base, entry.lang)}.tex (not found)`); return false; } const paperDir = join(PAPERS_DIR, entry.dir); const tex = texName(entry.base, entry.lang); console.log(` BUILD ${entry.dir}/${tex}.tex ...`);
// Stamp the version macros from git before xelatex runs. stampVersion(entry, paperDir);
// Deterministic PDFs: derive SOURCE_DATE_EPOCH from the newest source mtime. // xelatex + xdvipdfmx honor this for /CreationDate, /ModDate, and the /ID // trailer, so identical input bytes produce identical output bytes — which // stops the oven auto-build commit loop on the 2 PDFs whose only diff // between runs was wall-clock metadata baked into the trailer. const newestMs = sourcesMtime(entry); const sourceDateEpoch = Number.isFinite(newestMs) ? Math.floor(newestMs / 1000).toString() : Math.floor(Date.now() / 1000).toString();
try { // Run xelatex 3-pass with bibtex. Use semicolons (not &&) so bibtex // warnings don't kill the chain. Check for PDF existence, not exit code. execSync( `cd "${paperDir}" && xelatex -interaction=nonstopmode "${tex}.tex"; bibtex "${tex}" 2>/dev/null; xelatex -interaction=nonstopmode "${tex}.tex"; xelatex -interaction=nonstopmode "${tex}.tex"`, { stdio: "pipe", timeout: 180000, env: { ...process.env, SOURCE_DATE_EPOCH: sourceDateEpoch, FORCE_SOURCE_DATE: "1", }, }, ); } catch (e) { // xelatex may return non-zero on warnings but still produce a PDF. // Only log as warning, don't fail yet. } // Check if PDF was actually produced (the real success criterion). const pdfPath = join(paperDir, `${tex}.pdf`); if (existsSync(pdfPath)) { console.log(` OK ${tex}.pdf`); return true; } else { console.error(` FAIL ${tex}.tex — no PDF produced`); try { const log = execSync(`tail -20 "${join(paperDir, tex + ".log")}"`, { encoding: "utf8", }); console.error(` LOG:\n${log}`); } catch (_) {} return false; }}
function deployOne(entry) { if (!entry.pdfExists) return false; mkdirSync(SITE_DIR, { recursive: true }); copyFileSync(entry.pdfFile, entry.sitePdf); console.log(` DEPLOY ${basename(entry.sitePdf)}`); return true;}
// Render page 1 of a deployed PDF as a JPEG thumbnail. Lazy: skip if the// thumb is newer than the PDF. Returns true if a thumb exists after the call.function genThumbnail(pdfPath, siteName) { if (!existsSync(pdfPath)) return false; mkdirSync(THUMBS_DIR, { recursive: true }); const out = join(THUMBS_DIR, `${siteName}.jpg`); if (existsSync(out)) { const pdfM = statSync(pdfPath).mtimeMs; const thumbM = statSync(out).mtimeMs; if (thumbM >= pdfM) return true; } const tmpPrefix = join(THUMBS_DIR, `${siteName}.tmp`); try { // Cards are physically small (4x6in), so render them at a higher DPI to // keep the cover crisp; full pages stay at a lighter resolution. const dpi = /-cards\.pdf$/.test(pdfPath) ? 110 : 72; execSync( `pdftoppm -jpeg -jpegopt quality=75,progressive=y -r ${dpi} -f 1 -l 1 "${pdfPath}" "${tmpPrefix}"`, { stdio: "pipe", timeout: 30000 }, ); // pdftoppm appends -1 (or -01) for single page output const candidates = [`${tmpPrefix}-1.jpg`, `${tmpPrefix}-01.jpg`]; const produced = candidates.find((p) => existsSync(p)); if (!produced) { console.warn(` THUMB miss ${siteName} (no pdftoppm output)`); return false; } if (existsSync(out)) execSync(`rm "${out}"`); execSync(`mv "${produced}" "${out}"`); return true; } catch (e) { console.warn(` THUMB fail ${siteName}: ${String(e.message).slice(0, 120)}`); return false; }}
// Square illustration tile straight from the paper's cover art — the index// is a cover-and-title gallery, so the tile is the standalone emblem/illy,// not the full first page. Lazy: skip if the tile is newer than the source.function genCoverTile(coverPath, siteName) { if (!existsSync(coverPath)) return false; mkdirSync(THUMBS_DIR, { recursive: true }); const out = join(THUMBS_DIR, `${siteName}.jpg`); if (existsSync(out) && statSync(out).mtimeMs >= statSync(coverPath).mtimeMs) { return true; } try { execSync( `magick "${coverPath}" -resize 520x520^ -gravity center -extent 520x520 -quality 84 "${out}"`, { stdio: "pipe", timeout: 30000 }, ); return true; } catch (e) { console.warn(` TILE fail ${siteName}: ${String(e.message).slice(0, 120)}`); return false; }}
// siteName → its paper's cover.png, from PAPER_MAP.function coverTileSources() { const map = {}; for (const [dir, info] of Object.entries(PAPER_MAP)) { const cover = join(PAPERS_DIR, dir, "figures", "cover.png"); if (existsSync(cover)) map[info.siteName] = cover; } return map;}
// Generate thumbs for every PDF in SITE_DIR (covers PAPER_MAP papers, JOSS// extras, ELS, guest PDFs — anything published). Prefer the cover-art tile;// fall back to the PDF first page for anything without a cover.png (JOSS, etc.).function genAllThumbnails() { if (!existsSync(SITE_DIR)) return 0; let count = 0; const tiles = coverTileSources(); const pdfs = readdirSync(SITE_DIR).filter((n) => n.endsWith(".pdf")); for (const name of pdfs) { const siteName = name.slice(0, -4); if (siteName.endsWith("-cards")) continue; const ok = tiles[siteName] ? genCoverTile(tiles[siteName], siteName) : genThumbnail(join(SITE_DIR, name), siteName); if (ok) count++; } return count;}
function now() { return new Date().toISOString().replace("T", " ").slice(0, 16);}
function appendBuildLog(built, failed) { const stamp = now(); const lines = [`\n## ${stamp}\n`]; if (built.length) { lines.push("Built:"); for (const e of built) lines.push(`- ${e.title} [${e.lang}] → ${basename(e.sitePdf)}`); } if (failed.length) { lines.push("\nFailed:"); for (const e of failed) lines.push(`- ${e.title} [${e.lang}]`); } lines.push("");
if (!existsSync(BUILDLOG)) { writeFileSync( BUILDLOG, `# Papers Build Log\n\nGeneration history for all AC paper PDFs.\n${lines.join("\n")}`, ); } else { const existing = readFileSync(BUILDLOG, "utf8"); writeFileSync(BUILDLOG, existing + lines.join("\n")); } console.log(`\n Build log updated: ${BUILDLOG}`);}
function updateIndex(entries) { const indexPath = join(SITE_DIR, "index.html"); if (!existsSync(indexPath)) { console.log(" SKIP index update (index.html not found)"); return; }
const meta = loadMetadata();
// Importance ranking — curated order for 2026 impact const IMPORTANCE = { "stack-of-the-summer-26-arxiv": 0.25, "keymaps-social-software-26-arxiv": 0.5, "aesthetic-computer-26-arxiv": 1, "kidlisp-26-arxiv": 2, "hott-kidlisp-26-arxiv": 2.5, "plorking-the-planet-26-arxiv": 3, "ac-native-os-26-arxiv": 4, "piece-api-26-arxiv": 5, "who-pays-for-creative-tools-26-arxiv": 6, "pieces-not-programs-26-arxiv": 7, "notepat-26-arxiv": 8, "radical-computer-art-26-arxiv": 9, "whistlegraph-26-arxiv": 10, "sucking-on-the-complex-26-arxiv": 11, "gaps-in-granularity-26-arxiv": 11.5, "dead-ends-26-arxiv": 12, "folk-songs-26-arxiv": 13, "repo-archaeology-26-arxiv": 14, "hand-and-loop-26-arxiv": 14.5, "network-audit-26-arxiv": 15, "kidlisp-reference-26-arxiv": 16, "citation-diversity-audit-26": 17, "open-schools-26-arxiv": 18, "five-years-from-now-26-arxiv": 19, "aesthetic-may-26-essay": 19.5, "aesthetic-june-26-essay": 19.6, "aesthetic-july-4-26-essay": 19.7, "aesthetic-july-10-26-essay": 19.8, "calarts-callouts-papers-26-arxiv": 20, "handle-identity-atproto-26-arxiv": 21, "ucla-arts-funding-26-arxiv": 22, "potter-and-prompt-26-arxiv": 23, };
// Collect deployed English PDFs sorted by importance const papers = []; for (const e of entries.filter((e) => e.lang === "en" && e.sitePdfExists)) { const stat = statSync(e.sitePdf); const m = meta[e.dir] || {}; const rank = IMPORTANCE[e.siteName] || 99; // Prefer stored updated timestamp over file mtime (deploy copies all PDFs, clobbering mtime) const updated = m.updated ? new Date(m.updated) : stat.mtime; papers.push({ ...e, mtime: updated, created: m.created || null, revisions: m.revisions || 0, rank }); } papers.sort((a, b) => a.rank - b.rank);
// Also include JOSS/ELS papers that aren't in PAPER_MAP const extraPdfs = [ { file: "aesthetic-computer-26-joss.pdf", title: "Aesthetic Computer '26", detail: "JOSS Summary · 2pp", abstract: "A compact JOSS summary of Aesthetic Computer for archival and citation purposes. It distills the platform into a conventional software paper format.", metaKey: "joss-ac", }, { file: "kidlisp-26-joss.pdf", title: "KidLisp '26", detail: "JOSS Summary · 3pp", abstract: "A compact JOSS summary of KidLisp for archival and citation purposes. It frames the language as a small but expressive tool for generative art.", metaKey: "joss-kidlisp", }, { file: "kidlisp-els-2026.pdf", title: "KidLisp (ELS 2026)", detail: "A Minimal Lisp for Generative Art with Social Composition · ELS ACM SIGS 4pp", abstract: "An ELS conference version of KidLisp that emphasizes social composition. It positions the language as a shared practice rather than a solo scripting environment.", metaKey: "els-kidlisp", }, ];
// Guest papers were moved to platter readings (OCR'd text files); the // lane is retired, so only the JOSS/ELS extras remain. const extras = []; for (const ex of extraPdfs) { const fp = join(SITE_DIR, ex.file); if (existsSync(fp)) { const stat = statSync(fp); const m = meta[ex.metaKey] || {}; const updated = m.updated ? new Date(m.updated) : stat.mtime; extras.push({ ...ex, mtime: updated, created: m.created || null, revisions: m.revisions || 0 }); } } extras.sort((a, b) => b.mtime - a.mtime);
// Paper detail descriptions and short previews, keyed by siteName. const PAPER_COPY = { "stack-of-the-summer-26-arxiv": { detail: "A Nine-Vector Platform Report · arXiv-style · Summer 2026", abstract: "Stack of the Summer '26 cuts through Aesthetic Computer's living platform: the piece lifecycle and creative runtime, user data and backend choices, realtime and deployment, KidLisp publishing, shared services, desktop and bare-metal embodiments, engineering quality, privacy boundaries, and architectural history. It distinguishes canonical, transitional, and experimental layers, then names the priorities that can thicken the platform without losing its narrow creative waist.", }, "a-record-in-the-mail-essay": { detail: "An essay on API-made vinyl and cassette fulfillment · podcast", abstract: "A podcast asks to become an object. This essay maps two routes from an Aesthetic Computer episode to the mailbox: Kunaki's product-and-order API for one-off vinyl, and Tape On Demand's more human cassette workflow. It argues for a shared physical-release manifest, a deliberate payment gate, and a side B that can turn physical media into correspondence.", }, "the-keymap-is-the-score-essay": { detail: "A plain-spoken companion to Keymaps as Social Software · essay", abstract: "A keymap is more than a hidden preference table: it is an agreement that travels between people, programs, and machines. This essay names the inherited AWSED piano layout, introduces notepat's notes-that-name-themselves alternative, and follows that argument into the hand-assembled Scores for Social Software edition at UCLA.", }, "the-record-is-a-better-interface-essay": { detail: "An essay on expressive playback · podcast", abstract: "A turntable lets a listener hold recorded sound directly, while streaming apps reduce playback to a menu of approved speeds. This essay asks why production tools remain instruments while consumer players became transport controls, and argues for audible, continuous scrubbing that gives the recording back to the hand.", }, "gaps-in-granularity-26-arxiv": { detail: "Expressive Control and the Impoverishment of Consumer Playback · arXiv 10pp", abstract: "A record scratch gives you continuous, gestural, real-time control over a recording; YouTube and Spotify give you a dropdown of round speeds, and some give nothing at all. This paper names that gap 'granularity,' grounds it in the theory of directness and the mature craft of turntablism and elastic audio, and shows that Aesthetic Computer already ships the alternative across its players. The real opening is not that the instrument is impossible, but that it lives everywhere except the default transport of the apps you actually listen and watch through.", }, "media-estate-26-deck": { detail: "One Funnel, Nine Surfaces · 16:9 deck 10pp", abstract: "An overview deck of the Aesthetic Computer and whistlegraph media estate: twelve accounts across nine surfaces, which can be posted to by script today, and the build-out plan. The whistlegraph archive still moves tens of thousands of views a day; the deck argues the work is connecting that audience to the new instrument, starting with Instagram.", }, "aesthetic-computer-26-arxiv": { detail: "A Mobile-First Runtime for Creative Computing · arXiv 5pp", abstract: "Aesthetic Computer is presented as a mobile-first creative computing runtime where the interface, publishing flow, and community feedback loop are part of the medium. The paper argues that small pieces can make software feel more social, more portable, and easier to share.", }, "kidlisp-26-arxiv": { detail: "A Minimal Lisp for Generative Art on a Social Platform · arXiv 6pp", abstract: "KidLisp is the platform's tiny Lisp for building visual and musical pieces in the browser. The paper shows how a minimal language can stay approachable while still supporting generative art and composition.", }, "hott-kidlisp-26-arxiv": { detail: "Paths, Equivalence, and Evidence in a Tiny Creative Language · arXiv 7pp", abstract: "Equal Enough to Draw studies what homotopy type theory can honestly contribute to KidLisp without pretending the live language is a proof assistant. It separates source, AST, render, trace, contextual, and type-level identity; defines bounded observational equivalence over a host, input trace, frame horizon, and tolerance; and proposes content-addressed path certificates beside the permissive paint loop.", }, "plorking-the-planet-26-arxiv": { detail: "Laptop Orchestras, PLOrk Heritage, and Aesthetic Computer · arXiv", abstract: "This paper connects Aesthetic Computer to laptop orchestras and the collaborative traditions of PLOrk. It treats the browser as a place for ensemble practice, not just solo desktop programming.", }, "ac-native-os-26-arxiv": { detail: "A Bare-Metal Creative Computing Operating System · arXiv 5pp", abstract: "AC Native OS describes a bare-metal runtime for creative computing. It focuses on boot-time simplicity and the idea that the operating system itself can be a programmable art surface.", }, "piece-api-26-arxiv": { detail: "Processing at the Core of the Piece API · arXiv 7pp", abstract: "The Piece API rethinks creative software around composable pieces instead of monolithic apps. It uses Processing's lineage to connect setup(), boot(), and the act of publishing.", }, "who-pays-for-creative-tools-26-arxiv": { detail: "Funding, Burnout, and Survival in Open-Source Creative Computing · arXiv 5pp", abstract: "A short look at who supports open-source creative tools and what that labor costs. The paper connects funding, burnout, and long-term maintenance to the life of artistic software.", }, "pieces-not-programs-26-arxiv": { detail: "The Piece as a Unit of Creative Cognition · arXiv 4pp", abstract: "A piece is treated here as the basic unit of creative cognition in AC. The paper argues that smaller, shareable pieces encourage composition, remix, and publication.", }, "notepat-26-arxiv": { detail: "From Keyboard Toy to System Front Door · arXiv 5pp", abstract: "notepat.com is framed as a keyboard-first front door to the system. The paper follows the toy-like input surface as it grows into a fuller creative interface.", }, "cal-aesthetical-26-arxiv": { detail: "A URL-Addressable Calendar for Aesthetic Computer · arXiv 6pp", abstract: "AesthetiCal adds time to Aesthetic Computer as a piece, not a second app: month/week/day views and a DateWizard share a per-handle synced store, addressable by permahandle and interchangeable as standard iCalendar. The paper describes the shipped v1 and sketches the next phase — bookable shows, invites, and the Aestheticks ticketing tie-in.", }, "radical-computer-art-26-arxiv": { detail: "Goodiepalian Approaches in Aesthetic Computer · arXiv 5pp", abstract: "This paper treats Goodiepalian practice as a model for radical computer art. It emphasizes play, notation, and the social life of systems over polished product design.", }, "whistlegraph-26-arxiv": { detail: "Drawing, Singing, and the Graphic Score as Viral Form · arXiv 4pp", abstract: "Whistlegraph explores drawing, singing, and score-making as forms that can spread like software. The paper links graphic notation to performance, remix, and browser-native sharing.", }, "sucking-on-the-complex-26-arxiv": { detail: "Platform Hegemony, Critique-as-Content, and Anti-Environments · arXiv 5pp", abstract: "Sucking on the Complex critiques platform hegemony and the way critique becomes content. It looks for anti-environments that stay messy, resistant, and alive.", }, "dead-ends-26-arxiv": { detail: "Dormant Paths, Evolutionary Branches, and Abandoned Approaches · arXiv 4pp", abstract: "The paper catalogs dormant branches, abandoned experiments, and paths that never became default. It treats dead ends as useful history rather than failure.", }, "folk-songs-26-arxiv": { detail: "Oral Tradition Meets the Browser Keyboard · arXiv", abstract: "Playable Folk Songs brings oral tradition into the browser keyboard. The paper asks how simple interaction can carry collective memory and repetition.", }, "repo-archaeology-26-arxiv": { detail: 'Tracing the Evolution of AC Through Its Git History · arXiv 3pp · <a href="/ac-repo-archaeology">interactive timeline</a>', abstract: "Repository Archaeology traces the project through its git history. The paper shows how version control can become a narrative medium for design evolution.", }, "hand-and-loop-26-arxiv": { detail: "Three Eras of My Own Code: Hand-Written, GPT-Grafted, Agentic · arXiv 4pp", abstract: "The Hand and the Loop reads AC's git history across three eras — hand-written, GPT-grafted, and fully agentic — and asks honestly whether the codebase is better off. It weighs 5x velocity and five new subsystems against the loss of instrument-like minimalism, and argues for keeping the loop in the leaves while a human hand carves the foundational libraries.", }, "network-audit-26-arxiv": { detail: "Who Uses Aesthetic Computer and What Do They Make? · arXiv 4pp", abstract: "Network Audit asks who uses Aesthetic Computer and what they make with it. The paper turns usage patterns into a portrait of a community in motion.", }, "kidlisp-reference-26-arxiv": { detail: "118 Built-ins in 12 Categories · arXiv 4pp", abstract: "The KidLisp reference compresses the language into a usable field guide. It groups 118 built-ins into 12 categories for quick browsing and recall.", }, "citation-diversity-audit-26": { detail: "Diversity and Inclusion in AC Paper Citations · 4pp", abstract: "Citation Diversity Audit looks at who gets cited in the papers and where the archive is thin. The paper uses citation patterns as a proxy for inclusion and intellectual range.", }, "open-schools-26-arxiv": { detail: "", abstract: "Get Closed Source Out of Schools makes the case that creative computing should be teachable, inspectable, and modifiable. The paper argues for open tools as infrastructure for learning.", }, "five-years-from-now-26-arxiv": { detail: "", abstract: "Five Years from Now is a projection paper about where the project could go if current habits continue. It uses the near future to test the consequences of today's decisions.", }, "nom-games-26-arxiv": { detail: "Muncher Arcade for Aesthetic Computer · arXiv", abstract: "The nom games rebuild MECC's Word and Number Munchers as Aesthetic Computer pieces --- numbnom, engnom, mexinom, and notenom. The paper shows how one shared engine and a reusable virtual synth controller turn each new subject or language into a content table rather than a new game, with the answer key in notenom doubling as a playable instrument.", }, "aesthetic-may-26-essay": { detail: "Essay · ~5pp", abstract: "Aesthetic May '26 is a magazine-style essay companion to Five Years from Now. May is both the month and the modal verb of possibility; the essay reads the present as a field of branching maybes rather than a line of probabilities --- where the music lane may go, what jeffrey may do, what may not happen this year, and the weather acting on all of it. First entry in the essay-* lane.", }, "aesthetic-june-26-essay": { detail: "Essay · ~3pp · podcast", abstract: "Aesthetic June '26 is the storytelling companion to May. Where May was the modal mood, June is the answer, delivered as four hundred and fifty-seven commits --- the word carrying both its meanings, version control and Juno's oath. Told as scenes: the songs that caught up, the whistle found a perfect fifth sharp, the ring of native wizards learning one sign-in, and a Danish learn-the-clock community getting its own front door on the chat. Also available as a spoken reading in @jeffrey's voice.", }, "aesthetic-july-4-26-essay": { detail: "Essay · ~4pp · Independence Day special", abstract: "An Independence Day special between the June and July essays, written on the Declaration's 250th anniversary. Independence is a hanging word --- in + dependere, not to hang from --- and the essay follows it in the abstract: declarations versus definitions in C and in Philadelphia, the personal computer as an independence movement the cloud quietly reversed, artists who built their own rooms (a library in a church, folk songs as open-source software, an artwork designed to scan badly), and an honest ledger of which way one small platform hangs --- a podcast hung from a host, Menuband submitted to App Store review on the holiday weekend itself, and the CNAME record as infrastructure's most truthful sentence.", }, "aesthetic-july-10-26-essay": { detail: "Essay · ~2pp · mid-month postcard · podcast", abstract: "A mid-month postcard from July 10th --- not the monthly essay but a check-in written because someone asked how it was going. The answer: living in two times at once. Told as three scenes: excavating Whistlegraph, an artform made years ago with a friend, now counted (963 videos transcribed, 424 songs clustered, ~1.72 billion views) and given a hand-lettered legal-pad home at whistlegraph.org; a brand-new fighting game, fight, born in two days with its rollback safety net built before its network floor; and Menuband bounced from App Store review for naming macOS in its subtitle, then let through after learning to say one word less. Also available as a spoken reading in @jeffrey's voice.", }, "calarts-callouts-papers-26-arxiv": { detail: "", abstract: "CalArts, Callouts, and Papers turns a local institutional context into a study of friction, attention, and production. The paper leans into psycho style to show how academic labor is staged and performed.", }, "handle-identity-atproto-26-arxiv": { detail: "", abstract: "Handle Identity on the AT Protocol treats naming as a social and technical problem. The paper explores how handles, identity, and publishing can be tied together without losing portability.", }, "ucla-arts-funding-26-arxiv": { detail: "", abstract: "Two Departments, One Building examines how funding and infrastructure shape creative work in shared spaces. The paper looks at administrative boundaries as part of the artistic system.", }, "kidlisp-cards-26-arxiv": { detail: "", abstract: "KidLisp Cards condenses the language into a pocketable card format. It is meant to make the language easier to browse, teach, and carry.", }, "reading-the-score-26-arxiv": { detail: "", abstract: "Reading the Score looks at the graphic score as an interface for interpretation and collaboration. The paper treats notation as a computational and social object.", }, "potter-and-prompt-26-arxiv": { detail: "John Holden's Proto-Cognitive Music Theory and Aesthetic Computer · arXiv 7pp", abstract: "The Potter and the Prompt argues that AC independently converges on the core principles of John Holden's 1770 proto-cognitive music theory. It proposes AC as a computational laboratory for advancing Holden's unfinished program on grouping, attention, and the module.", }, "url-tradition-26-arxiv": { detail: "Addressable Creative Computing from Lovelace's Footnotes to Aesthetic Computer · arXiv", abstract: "The URL Tradition traces address-thinking from Lovelace's footnotes, Bush's trails, Xanadu, and the Negro Motorist Green Book through net.art, single-serving sites, the tilde, Glitch, and Aesthetic Computer's prompt-as-address-bar. It argues the URL is not a feature but a medium property that reshapes authorship, distribution, pedagogy, performance, and political claim.", },
// --- Dossiers (fact-surfacing lane; rendered in the dossiers section) --- "rhizome-dossier-26-arxiv": { detail: "501(c)(3) digital-arts recipient · IRS 990 pipeline · arXiv", abstract: "What is publicly recoverable about Rhizome.org: governance, finances, and named grants reconstructed from IRS 990 filings and masthead snapshots. The dossier records the documentary record and stops where the facts run out.", }, "sfpc-dossier-26-arxiv": { detail: "School for Poetic Computation · LLC, public finance repo · arXiv", abstract: "What is publicly recoverable about the School for Poetic Computation: an LLC that publishes its own finances to a public GitHub repository, read alongside programs and people. Fact-surfacing, not argument.", }, "eyebeam-dossier-26-arxiv": { detail: "501(c)(3) art-and-technology recipient · IRS 990 pipeline · arXiv", abstract: "What is publicly recoverable about Eyebeam: financials, governance, residencies, and named grants pulled from IRS 990 XML. The dossier surfaces the record without interpreting it.", }, "recurse-dossier-26-arxiv": { detail: "Recurse Center · for-profit, recruiting-funded model · arXiv", abstract: "What is publicly recoverable about the Recurse Center: a for-profit programmers' retreat funded by a recruiting model, read through founder interviews and public statements. Fact-surfacing, not argument.", }, "internet-archive-dossier-26-arxiv": { detail: "501(c)(3) recipient · IRS 990 + litigation track · arXiv", abstract: "What is publicly recoverable about the Internet Archive: finances and governance from IRS 990 filings, plus a litigation track from public court records. The dossier records both and stops at the facts.", }, "mellon-dossier-26-arxiv": { detail: "The funder flip · 990-PF + grants database · arXiv", abstract: "The funder side: what is publicly recoverable about the Mellon Foundation from its 990-PF and grants database — the Form 990-PF that paid for nontrivial chunks of the other dossiers. Fact-surfacing, not argument.", }, "pioneer-works-dossier-26-arxiv": { detail: "501(c)(3) recipient · founder-as-funder · arXiv", abstract: "What is publicly recoverable about Pioneer Works: finances, governance, and a founder-as-funder structure reconstructed from IRS 990 filings and public record. The dossier surfaces the record without interpreting it.", }, "new-inc-dossier-26-arxiv": { detail: "Embedded in the New Museum's 990 · arXiv", abstract: "What is publicly recoverable about NEW INC, the New Museum's incubator: finances and governance read out of the parent museum's IRS 990, where the program is embedded rather than separately filed. Fact-surfacing, not argument.", }, "studio-museum-dossier-26-arxiv": { detail: "501(c)(3) recipient · capital campaign · arXiv", abstract: "What is publicly recoverable about the Studio Museum in Harlem: finances, governance, and a capital campaign reconstructed from IRS 990 filings and public documents. The dossier records the documentary record.", }, "hathitrust-dossier-26-arxiv": { detail: "UMich library service · no separate 990 · arXiv", abstract: "What is publicly recoverable about HathiTrust: a University of Michigan library service with no separate IRS 990, surfaced instead through host-institution disclosures and public reports. Fact-surfacing, not argument.", }, "the-kitchen-dossier-26-arxiv": { detail: "501(c)(3) recipient · a 50-plus-year arc · arXiv", abstract: "What is publicly recoverable about The Kitchen: a half-century of finances and governance reconstructed from IRS 990 filings and public record across the organization's long arc. The dossier stops where the facts run out.", }, "machine-project-dossier-26-arxiv": { detail: "501(c)(3) recipient (until 2018) · Echo Park · arXiv", abstract: "What is publicly recoverable about Machine Project: the Echo Park space's finances and governance from IRS 990 filings through its 2018 wind-down. Fact-surfacing, not argument.", }, "heavy-manners-library-dossier-26-arxiv": { detail: "Small space · status undisclosed · arXiv", abstract: "What is publicly recoverable about Heavy Manners Library: a small space whose legal status is undisclosed, surfaced through what little public record exists. The dossier records the gaps as part of the record.", }, "microvision-dossier-26-arxiv": { detail: "The public-company flip · SEC EDGAR + 11-year archive · arXiv", abstract: "The public-company side: what is publicly recoverable about MicroVision (NASDAQ: MVIS) from SEC EDGAR and an eleven-year family archive of filings. Fact-surfacing, not argument.", }, "whats-new-calarts-26-arxiv": { detail: "CalArts · a dossier in news format · arXiv", abstract: "What's New CalArts!? surfaces what is publicly recoverable about CalArts in a news-format dossier: programs, finances, and governance from public documents. The dossier records the record and stops at the facts.", }, "creative-time-dossier-26-arxiv": { detail: "501(c)(3) public-art commissioner · IRS 990 pipeline · arXiv", abstract: "What is publicly recoverable about Creative Time, the New York public-art nonprofit (1974–): structure, programs, people, and money from the IRS 990 series and its program archive. Scaffold revision — figures pending the data pass; fact-surfacing, not argument.", }, "creative-capital-dossier-26-arxiv": { detail: "501(c)(3) artist-grant funder · 990 + grantee record · arXiv", abstract: "What is publicly recoverable about Creative Capital, the New York nonprofit (1999–) that regrants to individual artists: structure, the award, people, and money from the IRS 990 series and the public grantee record. Scaffold revision — figures pending; fact-surfacing, not argument.", }, "propublica-dossier-26-arxiv": { detail: "501(c)(3) investigative newsroom · IRS 990 + accountability record · arXiv", abstract: "What is publicly recoverable about ProPublica: origin, nonprofit structure, newsroom and partner network, data tools, people, money, reach, awards, corrections, and disputed work. Fact-surfacing, not argument.", }, };
function fmtTime(d) { const m = d.toLocaleString("en-US", { month: "short", timeZone: "America/Los_Angeles" }); const day = d.getDate(); const h = String(d.getHours()).padStart(2, "0"); const min = String(d.getMinutes()).padStart(2, "0"); return `${m} ${day} ${h}:${min}`; }
function fmtDate(d) { return `${d.slice(5, 7)}/${d.slice(8, 10)}`; }
function paperCopy(key) { return PAPER_COPY[key] || {}; }
// Render one paper card (shared by the papers list and dossiers section) function renderPaper(p) { const copy = paperCopy(p.siteName); const detail = copy.detail || ""; const abstract = copy.abstract || ""; const hasCards = existsSync(join(SITE_DIR, `${p.siteName}-cards.pdf`)); const createdStr = p.created ? fmtDate(p.created) : ""; const tKey = translationKey(p.dir); const updatedISO = p.mtime.toISOString(); const thumbName = `${p.siteName}.jpg`; const thumbExists = existsSync(join(THUMBS_DIR, thumbName)); const thumbHtml = thumbExists ? `<a class="thumb" href="/${p.siteName}.pdf" tabindex="-1" aria-hidden="true"><img src="/thumbs/${thumbName}" alt="" loading="lazy" decoding="async"></a>` : ""; // Links under the illustration: cards format + any translated editions. const cardsTl = hasCards ? `<a class="tl tl-cards" href="/${p.siteName}-cards.pdf" title="Mobile-friendly cards format">cards</a>` : ""; const langTl = LANGS.filter((l) => l !== "en") .filter((l) => existsSync(join(SITE_DIR, `${p.siteName}-${l}.pdf`))) .map((l) => `<a class="tl tl-lang" href="/${p.siteName}-${l}.pdf" title="${LANG_NAMES[l]}">${l.toUpperCase()}</a>`) .join(""); // Podcast format — a spoken reading in @jeffrey's voice. Audio is hosted // on the asset CDN (like pop), not in git; PODCASTS lists which papers // have an episode at assets.aesthetic.computer/podcast/{siteName}.mp3. const podcastTl = PODCASTS.has(p.siteName) ? `<a class="tl tl-podcast" href="https://assets.aesthetic.computer/podcast/${p.siteName}.mp3" title="Listen — a reading in @jeffrey's voice">podcast</a>` : ""; const thumbLinks = cardsTl || podcastTl || langTl ? `<div class="thumb-links">${cardsTl}${podcastTl}${langTl}</div>` : ""; const thumbCol = thumbHtml || thumbLinks ? `<div class="thumb-col">${thumbHtml}${thumbLinks}</div>` : ""; return ` <div class="p" data-paper-id="${tKey}"${hasCards ? "" : ` data-no-cards="1"`}${p.psycho ? ` data-psycho="1"` : ""}${p.deprecated ? ` data-deprecated="1"` : ""} data-created="${p.created || ""}" data-updated="${updatedISO}"> ${thumbCol}<div class="body"> <div class="title"><a href="/${p.siteName}.pdf" data-base="/${p.siteName}">${p.title}</a></div> <div class="detail">${detail}</div> <div class="abstract">${abstract}</div> <div class="meta-row"><span class="author">@jeffrey</span>${createdStr ? `<span class="created" title="Created">${createdStr}</span>` : ""}<span class="revisions" title="Revision count">revision ${p.revisions || 1}</span><span class="updated" title="Last updated">${fmtTime(p.mtime)}</span></div> </div> </div>\n`; }
// Render one JOSS/ELS "software paper" card from the extras array. function renderExtra(ex) { const createdStr = ex.created ? fmtDate(ex.created) : ""; const revStr = ex.revisions > 0 ? `r${ex.revisions}` : ""; const exKey = { "joss-ac": "joss-ac", "joss-kidlisp": "joss-kidlisp", "els-kidlisp": "els" }[ex.metaKey] || ex.metaKey; const exSiteName = ex.file.replace(/\.pdf$/, ""); const exThumbExists = existsSync(join(THUMBS_DIR, `${exSiteName}.jpg`)); const exThumbHtml = exThumbExists ? `<a class="thumb" href="/${ex.file}" tabindex="-1" aria-hidden="true"><img src="/thumbs/${exSiteName}.jpg" alt="" loading="lazy" decoding="async"></a>` : ""; return ` <div class="p" data-paper-id="${exKey}"> ${exThumbHtml}<div class="body"> <div class="title"><a href="/${ex.file}">${ex.title}</a></div> <div class="detail">${ex.detail}</div> <div class="abstract">${ex.abstract}</div> <div class="meta-row"><span class="created" title="Created">${createdStr}</span><span class="revisions" title="Revisions">${revStr}</span><span class="updated" title="Last updated">${fmtTime(ex.mtime)}</span></div> </div> </div>\n`; }
// Wrap a category's cards in a labeled <section>. `count` is the number // of cards; `nosort`/extra modifiers control the client-side sort. function renderSection({ key, title, sub, nosort }, cardsHtml, count, archive = false) { if (!cardsHtml) return ""; const cls = `cat${archive ? " cat--archive" : ""} collapsed`; const nosortAttr = nosort || archive ? " data-nosort" : ""; return ` <section class="${cls}" data-cat="${key}"> <div class="cat-head" role="button" tabindex="0" aria-expanded="false"><span class="cat-chevron" aria-hidden="true">▾</span><span class="cat-name">${title}</span><span class="cat-count">${count}</span></div> <div class="cat-sub">${sub}</div> <div class="cat-list"${nosortAttr}>${cardsHtml} </div> </section>\n`; }
// Bucket every listed paper into exactly one category; archived papers // are pulled out to their own quiet section at the bottom. const buckets = {}; for (const c of CATEGORIES) buckets[c.key] = []; const archived = []; for (const p of papers) { if (p.hidden) continue; // built + tracked, but not listed publicly if (ARCHIVE_DIRS.has(p.dir)) { archived.push({ ...p, deprecated: true, psycho: false }); continue; } buckets[categoryOf(p.dir)].push(p); } // Dossiers keep their curated order; other lanes keep importance rank. buckets.dossiers.sort((a, b) => dossierRank(a.dir) - dossierRank(b.dir));
const uncategorized = papers.filter( (p) => !p.hidden && !ARCHIVE_DIRS.has(p.dir) && !CATEGORY_OF[p.dir], ); if (uncategorized.length) { console.log( ` WARN ${uncategorized.length} uncategorized paper(s) → essays: ${uncategorized.map((p) => p.dir).join(", ")}`, ); }
// Build the full categorized block (all sections, in page order). let papersHtml = ""; for (const c of CATEGORIES) { if (c.key === "software") { const cards = extras.map(renderExtra).join(""); papersHtml += renderSection(c, cards, extras.length); } else { const list = buckets[c.key]; papersHtml += renderSection(c, list.map(renderPaper).join(""), list.length); } } if (archived.length) { papersHtml += renderSection( { key: "archive", title: "Archive", sub: "Deprecated — kept for the record, no longer actively maintained.", }, archived.map(renderPaper).join(""), archived.length, true, ); }
// Read current index, replace the categorized block between markers. let html = readFileSync(indexPath, "utf8"); const startMarker = "<!-- papers-start -->"; const endMarker = "<!-- papers-end -->";
if (html.includes(startMarker)) { const before = html.slice(0, html.indexOf(startMarker) + startMarker.length); const after = html.slice(html.indexOf(endMarker)); html = before + "\n" + papersHtml + "\n " + after; } else { // Add markers on first run — replace from first .p div to footer const firstP = html.indexOf('<div class="p">'); const footer = html.indexOf('<div class="footer">'); if (firstP !== -1 && footer !== -1) { html = html.slice(0, firstP) + startMarker + "\n" + papersHtml + "\n " + endMarker + "\n\n " + html.slice(footer); } }
writeFileSync(indexPath, html); const sectionCounts = CATEGORIES.map((c) => c.key === "software" ? `${c.key} ${extras.length}` : `${c.key} ${buckets[c.key].length}`, ).join(", "); console.log( ` INDEX updated: ${papers.length + extras.length} papers across ${CATEGORIES.length} categories (${sectionCounts}${archived.length ? `, archive ${archived.length}` : ""}).`, );
writeFeed(papers, extras, PAPER_COPY);}
// Escape a string for inclusion in an XML text node or attribute.function xmlEscape(s) { return String(s ?? "") .replace(/&/g, "&") .replace(/</g, "<") .replace(/>/g, ">") .replace(/"/g, """) .replace(/'/g, "'");}
// Convert HTML-flavored fragments (entities, anchor tags) to plain text,// so the string can be safely XML-escaped into a feed summary.function htmlToText(s) { return String(s ?? "") .replace(/<a\b[^>]*>([\s\S]*?)<\/a>/gi, "$1") .replace(/<[^>]+>/g, "") .replace(/·/g, "·") .replace(/×/g, "×") .replace(/—/g, "—") .replace(/–/g, "–") .replace(/…/g, "…") .replace(/ /g, " ") .replace(/&/g, "&") .replace(/"/g, '"') .replace(/'/g, "'") .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(parseInt(n, 10))) .replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCodePoint(parseInt(n, 16))) .replace(/\s+/g, " ") .trim();}
// Build an Atom feed of all papers and write feed.xml + rss.xml to SITE_DIR.// Papers are sorted newest first by mtime. Both files share the same Atom// content so that /feed.xml and /rss.xml both resolve to a valid feed.function writeFeed(papers, extras, PAPER_COPY) { const FEED_TITLE = "papers · Aesthetic Computer"; const FEED_SUBTITLE = "Academic papers on Aesthetic Computer, KidLisp, and creative computing."; const SITE_URL = "https://papers.aesthetic.computer"; const FEED_URL = `${SITE_URL}/feed.xml`; const AUTHOR_NAME = "@jeffrey"; const AUTHOR_URI = "https://prompt.ac/@jeffrey";
const entries = []; for (const p of papers) { const copy = (PAPER_COPY || {})[p.siteName] || {}; entries.push({ id: `${SITE_URL}/${p.siteName}.pdf`, url: `${SITE_URL}/${p.siteName}.pdf`, title: p.title, detail: copy.detail || "", summary: copy.abstract || "", updated: p.mtime instanceof Date ? p.mtime : new Date(p.mtime), published: p.created ? new Date(`${p.created}T00:00:00Z`) : null, category: "arXiv", }); } for (const ex of extras) { entries.push({ id: `${SITE_URL}/${ex.file}`, url: `${SITE_URL}/${ex.file}`, title: ex.title, detail: ex.detail || "", summary: ex.abstract || "", updated: ex.mtime instanceof Date ? ex.mtime : new Date(ex.mtime), published: ex.created ? new Date(`${ex.created}T00:00:00Z`) : null, category: ex.metaKey && ex.metaKey.startsWith("joss") ? "JOSS" : "ELS", }); } entries.sort((a, b) => b.updated - a.updated);
const feedUpdated = entries.length > 0 ? entries[0].updated : new Date();
let xml = `<?xml version="1.0" encoding="utf-8"?>\n`; xml += `<feed xmlns="http://www.w3.org/2005/Atom">\n`; xml += ` <title>${xmlEscape(FEED_TITLE)}</title>\n`; xml += ` <subtitle>${xmlEscape(FEED_SUBTITLE)}</subtitle>\n`; xml += ` <link rel="alternate" type="text/html" href="${SITE_URL}/"/>\n`; xml += ` <link rel="self" type="application/atom+xml" href="${FEED_URL}"/>\n`; xml += ` <id>${SITE_URL}/</id>\n`; xml += ` <updated>${feedUpdated.toISOString()}</updated>\n`; xml += ` <author>\n`; xml += ` <name>${xmlEscape(AUTHOR_NAME)}</name>\n`; xml += ` <uri>${AUTHOR_URI}</uri>\n`; xml += ` </author>\n`; xml += ` <icon>${SITE_URL}/papers-og.jpg</icon>\n`; xml += ` <rights>CC BY 4.0 unless noted otherwise.</rights>\n`;
for (const e of entries) { const cleanDetail = htmlToText(e.detail); const cleanSummary = htmlToText(e.summary); const summary = [cleanDetail, cleanSummary].filter(Boolean).join(" — "); xml += ` <entry>\n`; xml += ` <title>${xmlEscape(htmlToText(e.title))}</title>\n`; xml += ` <link rel="alternate" type="application/pdf" href="${xmlEscape(e.url)}"/>\n`; xml += ` <id>${xmlEscape(e.id)}</id>\n`; xml += ` <updated>${e.updated.toISOString()}</updated>\n`; if (e.published) { xml += ` <published>${e.published.toISOString()}</published>\n`; } xml += ` <category term="${xmlEscape(e.category)}"/>\n`; xml += ` <author><name>${xmlEscape(AUTHOR_NAME)}</name></author>\n`; if (summary) { xml += ` <summary type="text">${xmlEscape(summary)}</summary>\n`; } xml += ` </entry>\n`; } xml += `</feed>\n`;
writeFileSync(join(SITE_DIR, "feed.xml"), xml); // Mirror the Atom feed at /rss.xml so readers probing either path succeed. writeFileSync(join(SITE_DIR, "rss.xml"), xml); console.log(` FEED updated: feed.xml + rss.xml (${entries.length} entries).`);}
function verify() { const indexPath = join(SITE_DIR, "index.html"); if (!existsSync(indexPath)) { console.log(" SKIP verify (index.html not found)"); return true; } const html = readFileSync(indexPath, "utf8");
// Extract all href links to PDFs from the generated paper entries const hrefRe = /href="\/([^"]+\.pdf)"/g; let match; const linked = new Set(); while ((match = hrefRe.exec(html)) !== null) { linked.add(match[1]); }
// Also check cards links — only for papers that have cards (no data-no-cards attr) const paperBlockRe = /<div class="p"(?:(?!data-no-cards)[^>])*>[\s\S]*?data-base="\/([^"]+)"[\s\S]*?<\/div>\s*<\/div>/g; while ((match = paperBlockRe.exec(html)) !== null) { linked.add(`${match[1]}-cards.pdf`); }
let ok = 0; let broken = 0; for (const pdf of [...linked].sort()) { const fp = join(SITE_DIR, pdf); if (existsSync(fp)) { ok++; } else { console.log(` BROKEN /${pdf}`); broken++; } } console.log(` ${ok} OK, ${broken} broken link${broken !== 1 ? "s" : ""}`); if (broken > 0) { console.log( "\n ⚠ Some papers have broken PDF links. Build cards or remove dead links.", ); } return broken === 0;}
// --- CLI ---const args = process.argv.slice(2);const force = args.includes("--force");const positional = args.filter((a) => !a.startsWith("--"));const [cmd, langFilter] = positional;
if (cmd === "status" || !cmd) { const files = findAll(); console.log("\nPapers Build Status\n"); console.log( "Paper".padEnd(32) + LANGS.map((l) => LANG_NAMES[l].padEnd(12)).join(""), ); console.log("-".repeat(32 + LANGS.length * 12)); let currentDir = ""; for (const f of files) { if (f.dir !== currentDir) { currentDir = f.dir; process.stdout.write(f.dir.padEnd(32)); } const hasTex = f.texExists; const hasPdf = f.sitePdfExists; const status = hasPdf ? "OK" : hasTex ? "tex" : "---"; process.stdout.write(status.padEnd(12)); if (LANGS.indexOf(f.lang) === LANGS.length - 1) process.stdout.write("\n"); } console.log();} else if (cmd === "build") { const filter = langFilter && LANGS.includes(langFilter) ? langFilter : null; const files = findAll(filter); const candidates = files.filter((f) => f.texExists); const toBuild = force ? candidates : candidates.filter(needsRebuild); const skipped = candidates.length - toBuild.length; const mode = force ? " (forced)" : ""; console.log( `\nBuilding ${toBuild.length} paper${toBuild.length !== 1 ? "s" : ""}${filter ? ` (${LANG_NAMES[filter]})` : " (all languages)"}${mode}...`, ); if (skipped > 0) console.log(` (${skipped} up-to-date, skipped)`); console.log(); const built = []; const failed = []; for (const entry of toBuild) { if (buildOne(entry)) built.push(entry); else failed.push(entry); } console.log(`\nDone: ${built.length} built, ${skipped} skipped, ${failed.length} failed.\n`); if (built.length) appendBuildLog(built, failed);} else if (cmd === "deploy") { const files = findAll(); const toDeploy = files.filter((f) => f.pdfExists); console.log( `\nDeploying ${toDeploy.length} PDF${toDeploy.length !== 1 ? "s" : ""}...\n`, ); for (const entry of toDeploy) { deployOne(entry); } console.log("\nGenerating thumbnails...\n"); const thumbCount = genAllThumbnails(); console.log(` THUMBS ${thumbCount} JPEG previews in thumbs/.\n`); console.log("Done.\n");} else if (cmd === "thumbs") { console.log("\nGenerating thumbnails for every deployed PDF...\n"); const thumbCount = genAllThumbnails(); console.log(`\nDone. ${thumbCount} thumbs in thumbs/.\n`);} else if (cmd === "publish") { // Full pipeline: build (incremental) → deploy → update index → verify const mode = force ? " (forced)" : " (incremental)"; console.log(`\n=== PUBLISH${mode}: build → deploy → update index → verify ===\n`);
const files = findAll(); const candidates = files.filter((f) => f.texExists); const toBuild = force ? candidates : candidates.filter(needsRebuild); const skipped = candidates.length - toBuild.length; console.log(`Building ${toBuild.length} papers (all languages)...`); if (skipped > 0) console.log(` (${skipped} up-to-date, skipped)`); console.log(); const built = []; const failed = []; for (const entry of toBuild) { if (buildOne(entry)) built.push(entry); else failed.push(entry); } console.log(`\nBuild: ${built.length} OK, ${skipped} skipped, ${failed.length} failed.\n`);
// Re-scan after build to pick up new PDFs const deployFiles = findAll(); const toDeploy = deployFiles.filter((f) => f.pdfExists); console.log(`Deploying ${toDeploy.length} PDFs...\n`); for (const entry of toDeploy) { deployOne(entry); }
// Increment revisions in metadata for all built papers (English only to avoid double-counting) const meta = loadMetadata(); const now = new Date().toISOString(); const builtDirs = new Set(built.filter((e) => e.lang === "en").map((e) => e.dir)); for (const dir of builtDirs) { if (!meta[dir]) meta[dir] = { created: now.slice(0, 10), revisions: 0 }; meta[dir].revisions = (meta[dir].revisions || 0) + 1; meta[dir].updated = now; } saveMetadata(meta); console.log(` METADATA updated (${builtDirs.size} papers incremented).\n`);
// Page-1 JPEG thumbnails for the index console.log("Generating thumbnails...\n"); const thumbCount = genAllThumbnails(); console.log(` THUMBS ${thumbCount} JPEG previews in thumbs/.\n`);
// Update index console.log("Updating index...\n"); const indexEntries = findAll(); // Refresh sitePdfExists after deploy for (const e of indexEntries) { e.sitePdfExists = existsSync(e.sitePdf); } updateIndex(indexEntries);
if (built.length) appendBuildLog(built, failed);
// Verify all linked PDFs exist console.log("\n=== VERIFY ===\n"); verify();
console.log("\nPublish complete.\n");} else if (cmd === "index") { console.log("\nUpdating index...\n"); const indexEntries = findAll(); for (const e of indexEntries) { e.sitePdfExists = existsSync(e.sitePdf); } updateIndex(indexEntries); console.log("\nDone.\n");} else if (cmd === "check") { // Column-overflow gate: fail loudly if any paper spills past its measure // (long code identifiers/paths/tokens breaking the columnar arrangement). // Reads each paper's xelatex .log; pass --build to regenerate first. const checker = join(PAPERS_DIR, "tools", "check-columns.mjs"); const passthru = args.filter((a) => a !== "check"); try { execSync( `node "${checker}" ${passthru.map((a) => `"${a}"`).join(" ")}`.trim(), { stdio: "inherit" }, ); } catch { process.exit(1); }} else if (cmd === "verify") { console.log("\n=== VERIFY: checking all linked PDFs ===\n"); const allOk = verify(); process.exit(allOk ? 0 : 1);} else if (cmd === "log") { if (existsSync(BUILDLOG)) { console.log(readFileSync(BUILDLOG, "utf8")); } else { console.log("No build log yet. Run 'build' or 'publish' first."); }} else { console.log(`papers cli — build, deploy, and track all AC papers
Usage: node papers/cli.mjs build [lang] Build changed PDFs (all langs, or: en, da, es, zh) node papers/cli.mjs build --force Rebuild all PDFs (skip mtime check) node papers/cli.mjs deploy Copy built PDFs to site directory node papers/cli.mjs publish Incremental build + deploy + update index + verify node papers/cli.mjs publish --force Full rebuild + deploy + update index + verify node papers/cli.mjs status Show build status for all papers node papers/cli.mjs verify Check all linked PDFs exist node papers/cli.mjs check [dirs] Column-overflow gate (Overfull \\hbox); fails loudly node papers/cli.mjs check --build Rebuild first, then gate on column overflow node papers/cli.mjs log Show build log
Builds are incremental by default — only papers with source files newer thantheir output PDF are rebuilt. Use --force to bypass.`);}