#!/usr/bin/env node // Writes series.json, the plan for one set of covers: the series name, one look for every cover, the title style // and one entry per cover with its exact title. Each cover's "subject" is left as FILL: for you to write. // It calls no API. // // Usage: // node scripts/new-series.mjs --out series.json --name "10-Minute Dinners" \ // --titles "Lemon garlic orzo|Crispy gnocchi traybake|Miso butter noodles|Charred corn tacos|Green shakshuka|Peanut chilli rice" \ // (--preset bold-flat|moody-film|soft-pastel|paper-collage|risograph | --look "one sentence" [--palette "red|yellow"]) // [--kicker "EP {{n}}"] [--position top|middle|bottom] [--treatment block|shadow|plain] [--align left|center] // [--case as-written|upper] [--ink #hex] [--accent #hex] [--font "Helvetica Neue"] [--font-file brand.ttf] // [--stills "ep1.jpg||ep3.jpg"] [--people none|fictional|real-with-consent] [--force] // // --titles: 3, 6 or 9 titles separated by | (full rows of the 3-column profile grid; 6 is the default set). // --stills: optional frames from the creator's own videos, one slot per cover, separated by | (leave a slot empty). // --palette: colours cycled across the covers; the look must contain {{colour}} where the colour goes. // --kicker: a small line above every title; {{n}} becomes the cover number, {{nn}} the number with two digits. // Node 18 or newer. No npm packages. import { existsSync, readFileSync, writeFileSync } from 'node:fs' import { dirname, isAbsolute, relative, resolve } from 'node:path' const FLAGS = new Set([ 'out', 'name', 'titles', 'preset', 'look', 'palette', 'kicker', 'position', 'treatment', 'align', 'case', 'ink', 'accent', 'font', 'font-file', 'stills', 'people', 'force', ]) const SWITCHES = new Set(['force']) function fail(message) { console.error(message) process.exit(1) } const opts = {} const argv = process.argv.slice(2) for (let i = 0; i < argv.length; i++) { const a = argv[i] if (!a.startsWith('--')) fail(`Unexpected argument "${a}". Flags look like --name value.`) const key = a.slice(2) if (!FLAGS.has(key)) fail(`Unknown flag --${key}. Allowed: ${[...FLAGS].map((f) => `--${f}`).join(', ')}`) if (SWITCHES.has(key)) { opts[key] = true; continue } const value = argv[i + 1] if (value === undefined || value.startsWith('--')) fail(`--${key} needs a value.`) opts[key] = value i++ } const usage = 'Usage: node scripts/new-series.mjs --out series.json --name "Series name" --titles "t1|t2|t3|t4|t5|t6" (--preset bold-flat | --look "...") [--kicker "EP {{n}}"] [--stills "a.jpg||c.jpg"] [--people none|fictional|real-with-consent]' if (!opts.out || !opts.name || !opts.titles) fail(usage) if (existsSync(opts.out) && !opts.force) fail(`${opts.out} already exists. Pick another --out, or pass --force to replace it.`) const gen = JSON.parse(readFileSync(new URL('../assets/generation-input.json', import.meta.url), 'utf8')) const preset = opts.preset ? gen.presets[opts.preset] : undefined if (opts.preset && !preset) fail(`--preset must be one of: ${Object.keys(gen.presets).join(', ')}`) if (!preset && !opts.look) fail(`Give --preset or --look, so the set has one art direction.\n${usage}`) const titles = opts.titles.split('|').map((t) => t.trim().replace(/\s+/g, ' ')) if (![3, 6, 9].includes(titles.length)) fail(`--titles has ${titles.length} titles. Give 3, 6 or 9 (full rows of the profile grid); 6 is the usual set.`) titles.forEach((t, i) => { const words = t.split(' ').filter(Boolean) if (!t) fail(`Title ${i + 1} is empty.`) if (words.length > 6) fail(`Title ${i + 1} "${t}" has ${words.length} words. Keep each title to 6 words or fewer so it reads on a grid tile.`) if (t.length > 32) fail(`Title ${i + 1} "${t}" is ${t.length} characters. Keep each title to 32 or fewer.`) if (/[<>]/.test(t)) fail(`Title ${i + 1} cannot contain < or >.`) }) const dupes = titles.filter((t, i) => titles.findIndex((x) => x.toLowerCase() === t.toLowerCase()) !== i) if (dupes.length) fail(`Two covers share the title "${dupes[0]}". Each cover needs its own title.`) const pick = (name, value, allowed, fallback) => { const v = value ?? fallback if (!allowed.includes(v)) fail(`--${name} must be ${allowed.join(', ')}, not "${v}".`) return v } const hex = (name, value, fallback) => { const v = value ?? fallback if (!/^#[0-9a-fA-F]{6}$/.test(v)) fail(`--${name} must be a #hex colour like #141414.`) return v.toLowerCase() } const presetStyle = preset?.style ?? {} const look = opts.look ?? preset.look const palette = opts.palette ? opts.palette.split('|').map((c) => c.trim()).filter(Boolean) : opts.look ? [] : preset.palette if (palette.length && !look.includes('{{colour}}')) fail('--palette needs a {{colour}} placeholder in --look, where the colour of each cover goes.') if (!palette.length && look.includes('{{colour}}')) fail('The look has {{colour}} but there is no --palette. Give --palette "colour 1|colour 2", or write one colour into the look.') const kicker = opts.kicker ?? '' if (kicker.replace(/\{\{nn?\}\}/g, '00').length > 26) fail('--kicker is over 26 characters. Keep it short: the series name or "EP {{n}}".') const people = pick('people', opts.people, ['none', 'fictional', 'real-with-consent'], 'none') const outDir = dirname(resolve(opts.out)) const stills = (opts.stills ?? '').split('|').map((s) => s.trim()) if (opts.stills && stills.length > titles.length) fail(`--stills has ${stills.length} slots but there are ${titles.length} covers.`) const stillPaths = titles.map((_, i) => { const s = stills[i] if (!s) return '' const abs = isAbsolute(s) ? s : resolve(s) if (!existsSync(abs)) fail(`Still for cover ${i + 1} not found: ${abs}`) if (!/\.(jpe?g|png|webp)$/i.test(abs)) fail(`Still for cover ${i + 1} must be a .jpg, .png or .webp frame. For a video, export one frame first.`) return relative(outDir, abs) }) const plan = { schema: 'reel-cover-set/1', series: { name: opts.name.trim(), platform: 'both', people, consent_confirmed: false, preset: opts.preset ?? '', }, look, palette, style: { font: opts.font ?? 'Helvetica Neue', font_file: opts['font-file'] ? relative(outDir, resolve(opts['font-file'])) : '', ink: hex('ink', opts.ink, presetStyle.ink ?? '#ffffff'), accent: hex('accent', opts.accent, presetStyle.accent ?? '#141414'), treatment: pick('treatment', opts.treatment, ['block', 'shadow', 'plain'], presetStyle.treatment ?? 'shadow'), position: pick('position', opts.position, ['top', 'middle', 'bottom'], presetStyle.position ?? 'top'), align: pick('align', opts.align, ['left', 'center'], presetStyle.align ?? 'left'), case: pick('case', opts.case, ['as-written', 'upper'], 'as-written'), kicker, }, references: { anchor: '' }, covers: titles.map((title, i) => ({ n: i + 1, title, kicker: '', subject: 'FILL: what this cover shows, in one sentence (the episode\'s hero thing, its angle and props), with no text in it', still: stillPaths[i], still_has_person: false, draft: '', art: '', })), } writeFileSync(opts.out, `${JSON.stringify(plan, null, 2)}\n`) console.log(`Wrote ${opts.out}: ${titles.length} covers for "${plan.series.name}", look ${opts.preset ? `preset ${opts.preset}` : 'your own'}${palette.length ? `, palette ${palette.join(' / ')}` : ''}.`) console.log('Next: write each cover\'s "subject" (references/prompt-patterns.md). If a still shows a person, set its still_has_person to true and read the people rules in SKILL.md first.') if (people === 'real-with-consent') console.log('people is real-with-consent: set series.consent_confirmed to true only after the person (or everyone shown) has said yes in plain words.')