#!/usr/bin/env node // Writes the shot list (reel.json) for one satisfying-cut ASMR reel: three macro beats of one object // remade in one material, with the beat prompts and sounds filled in from the material menu and only // the object itself left as FILL for the agent to describe. // reel.json is the single source of truth for build-requests.mjs and assemble-reel.mjs. // // Usage: // node scripts/build-shot-list.mjs --out reel.json --object "a lemon" --material glass|frosted-glass|layered-jelly|marble-soap|chocolate|custom // [--cut yes|no] [--photo product.jpg] [--set "..."] [--keep-logo yes|no] [--resolution 720p|1080p] // // --cut no makes the "made of glass" version with no knife: a tap, a light sweep and a slow turn. // --material custom leaves locks.material, locks.inside and the sounds as FILL. // Node 18 or newer. No npm packages. Calls no API. import { existsSync, writeFileSync } from 'node:fs' const FLAGS = new Set(['out', 'object', 'material', 'cut', 'photo', 'set', 'keep-logo', 'resolution']) 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(', ')}`) const value = argv[i + 1] if (value === undefined || value.startsWith('--')) fail(`--${key} needs a value.`) opts[key] = value i++ } // The material menu. Each entry: how it looks, what the inside shows, the set that flatters it, // and one sound per beat (cut mode) or per no-cut beat. See references/materials.md. const MATERIALS = { glass: { name: 'clear glass', cut_note: 'The blade glides through as cleanly as through firm butter: no shards, no cracks.', material: 'flawless clear glass, thick and solid, with bright specular highlights, soft caustic reflections on the board and faint internal refraction', inside: 'solid clear glass all the way through, the cut face perfectly smooth and mirror bright, with fine light streaks inside', set: 'a matte charcoal slate board on a deep grey seamless backdrop', sounds: { cut: 'one crisp, glassy crunch as the blade bites and slides through, bright and close', slice: 'one clear glassy clink as the slice lands on the slate', reveal: 'one soft bright glass chime as the halves settle, then quiet', tap: 'one clear ringing glass tap that rings out softly', light: 'one soft, bright glassy ting as the light crosses the edge', turn: 'a low soft glass ring that fades away', }, }, 'frosted-glass': { name: 'frosted glass', cut_note: 'The blade glides through as cleanly as through firm butter: no shards, no cracks.', material: 'frosted satin glass with a soft milky surface, glowing gently where the light passes through, edges slightly brighter', inside: 'clear polished glass under the frosted skin, the cut face glossy and luminous against the frosted outside', set: 'a pale warm-grey stone board on a soft sand-coloured seamless backdrop', sounds: { cut: 'one soft icy crunch as the blade slides through, crisp and close', slice: 'one muted glassy tock as the slice lands on the stone', reveal: 'one soft frosted chime as the halves settle, then quiet', tap: 'one soft muffled glass tap', light: 'one soft, muted glassy ting as the light crosses the edge', turn: 'a low gentle hum that fades away', }, }, 'layered-jelly': { name: 'layered jelly', cut_note: 'The jelly wobbles slightly and holds its shape.', material: 'glossy translucent layered jelly in clean horizontal bands of colour, wobbling slightly, with a wet shine', inside: 'sharp, even jelly layers in clean bands of colour, the cut face glossy and wet, wobbling gently', set: 'a white glazed ceramic plate on a pale pastel seamless backdrop', sounds: { cut: 'one soft wet slice sound as the blade glides through the jelly, gentle and close', slice: 'one soft wet plop as the slice lands and wobbles', reveal: 'one gentle squelch as the halves settle and wobble, then quiet', tap: 'one soft wobbling jelly tap', light: 'one soft, wet glossy wobble sound as the light crosses it', turn: 'a soft gentle wobble sound that fades away', }, }, 'marble-soap': { name: 'marble soap', cut_note: 'The soap cuts smooth and dense, leaving a thin waxy curl along the blade.', material: 'smooth matte handmade soap with soft swirls of marbled colour running through it, a faint waxy sheen, tiny tool marks at the edges', inside: 'dense marbled soap with swirls of colour running through the whole cut face, smooth and waxy', set: 'a pale oak cutting board on a warm light-grey seamless backdrop', sounds: { cut: 'one crisp dry waxy scrape as the blade slices down through the soap, close and satisfying', slice: 'one soft dull tap as the slice falls flat onto the board', reveal: 'one soft waxy thud as the halves settle, then quiet', tap: 'one soft dull tap on the soap', light: 'one soft, dry hush of air across the soap', turn: 'a soft low wooden creak of the turntable that fades away', }, }, chocolate: { name: 'chocolate', cut_note: 'The shell snaps cleanly, with no crumbs scattering.', material: 'glossy tempered dark and milk chocolate with a perfect mirror shine, crisp edges and a faint cocoa dusting', inside: 'a crisp chocolate shell around a smooth glossy ganache centre, clean layers on the cut face', set: 'a dark walnut board on a warm deep-brown seamless backdrop', sounds: { cut: 'one sharp clean chocolate snap as the blade breaks through the shell, then a soft slide', slice: 'one soft crisp tap as the slice lands on the board', reveal: 'one soft crumble as the halves settle, then quiet', tap: 'one crisp hollow chocolate tap', light: 'one soft, crisp crackle of the chocolate shell settling', turn: 'a soft low wooden creak of the turntable that fades away', }, }, } const usage = 'Usage: node scripts/build-shot-list.mjs --out reel.json --object "a lemon" --material glass [--cut yes|no] [--photo product.jpg] [--set "..."] [--keep-logo no] [--resolution 720p]' for (const f of ['out', 'object', 'material']) if (!opts[f]) fail(`Missing --${f}.\n${usage}`) const materialKey = opts.material if (!(materialKey in MATERIALS) && materialKey !== 'custom') fail(`--material must be one of ${[...Object.keys(MATERIALS), 'custom'].join(', ')}, not "${materialKey}". See references/materials.md.`) const cut = (opts.cut ?? 'yes') === 'yes' if (!['yes', 'no'].includes(opts.cut ?? 'yes')) fail('--cut must be yes or no. "no" makes the made-of-glass version with no knife.') const keepLogo = opts['keep-logo'] ?? 'no' if (!['yes', 'no'].includes(keepLogo)) fail('--keep-logo must be yes or no.') const resolution = opts.resolution ?? '720p' if (!['720p', '1080p'].includes(resolution)) fail(`--resolution must be 720p or 1080p, not "${resolution}". Veo 3.1 fast charges the same for both.`) const photo = opts.photo ?? '' if (photo) { if (!existsSync(photo)) fail(`Photo not found: ${photo}`) if (!/\.(jpe?g|png|webp)$/i.test(photo)) fail(`${photo} must be a .jpg, .png or .webp photo. For a video, export one still frame first.`) } if (keepLogo === 'yes' && !photo) fail('--keep-logo yes needs --photo: the logo can only be copied from the user\'s own product photo.') // Words that mean the object is alive, a person, has a face, or is a weapon. Inanimate objects only. // Kept narrow on purpose so products such as face cream, hand wash or a PET bottle still pass. const banned = /\b(dogs?|cats?|pupp(y|ies)|kittens?|birds?|fish|hamsters?|rabbits?|bunn(y|ies)|animals?|frogs?|turtles?|ducks?|ducklings?|chicks?|insects?|bab(y|ies)|child|children|kids?|person|people|man|woman|men|women|girl|boy|human|dolls?|figurines?|teddy|plush|mascot|cartoon|emoji|smiley|skull|guns?|pistol|rifle|bullets?|grenade|knife|knives|sword)\b/i if (banned.test(opts.object)) fail(`"${opts.object}" reads as an animal, a person, a character with a face, or a weapon. This Skill only cuts inanimate objects without faces: fruit, everyday objects, the user's own product. See references/safety-and-brands.md.`) const m = MATERIALS[materialKey] const looks = 'Macro product cinematography, 100mm macro lens, shallow depth of field, soft diffused top light with a gentle rim light that traces the edges, clean true-to-life colour, crisp micro detail, calm and minimal, no HDR, no digital over-sharpening.' const hand = 'a hand in a black nitrile glove that stays cropped by the top edge of the frame (only the glove and the knife handle ever show)' // Three beats. Every clip is 6 s on Veo 3.1 fast and trimmed to about 5.9 s. const cutBeats = [ { beat: 'first-cut', angle: 'Close-up at board height, three-quarter front', keyframe_prompt: 'Close-up at board height, three-quarter front view: {{OBJECT}}, remade entirely in {{MATERIAL}}, resting whole and untouched in the middle of the frame on {{SET}}. No knife and no hands yet; the top fifth of the frame is empty background so a blade can enter from above. The object fills the middle third of the vertical frame.', // Shot 1's video starts from a poised still (the shot 1 object plus the shot 2 knife, edge just above // the cut line), made with --stage poised after shots 1 and 2 are approved. Without a knife in the first // frame, Veo invented a wide cleaver that came in flat and shaved the object (sample run, 2026-11-09). poised_prompt: 'The same scene as reference image 1, unchanged: the same {{MATERIAL_NAME}} object, whole and untouched, on the same board, same backdrop, same light, same framing and camera height. Add the same polished stainless steel chef\'s knife as in reference image 2, at the same angle as in reference image 2, held so its sharp edge hovers just above the cut line, about a finger\'s width above the surface and not yet touching it. Only the blade and the start of its spine show, entering from the top edge of the frame; no hand and no glove in frame. Nothing is cut yet.', motion_prompt: `The chef's knife already in the frame, its edge just above the cut line, keeps exactly the same angle and presses slowly straight down through the object all the way to the board in one smooth stroke, cutting one clean, thick slice off one end; at the end the slice starts to lean away from the blade. Only the blade moves; it never slides sideways. ${m?.cut_note ?? 'The cut is perfectly clean.'} The rest of the object stays perfectly still on the board. The camera is locked off with a very slight slow push-in.`, sound: m?.sounds.cut ?? 'FILL: one crisp cutting sound for this material', }, { beat: 'slice', angle: 'Extreme macro, side view at board level', keyframe_prompt: 'Extreme macro side view at board level of the same {{MATERIAL_NAME}} object as in reference image 1, on the same board: the knife blade is all the way down through it, and a thick clean slice has just begun to lean away from the blade, a thin gap of light showing between the slice and the rest of the object. The cut edge glints. Only the flat of the blade and its spine show, entering from the top edge; no hand in frame.', motion_prompt: 'The thick slice peels away from the blade and tips over slowly, falling flat onto the board with a small natural bounce; the blade lifts straight up and out of the top of the frame. The rest of the object stays still. Locked-off macro camera, slow and steady, real-time speed.', sound: m?.sounds.slice ?? 'FILL: one sound as the slice lands', }, { beat: 'reveal', angle: 'Close-up, straight on to the cut face', keyframe_prompt: 'Close-up straight on to the cut face of the same {{MATERIAL_NAME}} object as in reference image 1, on the same board and in the same light: the object has been cut cleanly in two and the halves are just starting to part, showing the inside: {{INSIDE}}. The cut slice from earlier lies flat on the board in front. No knife and no hands in frame.', motion_prompt: 'The two halves slowly fall open to either side and settle on the board, revealing the whole cut face: {{INSIDE}}. The camera pushes in very slowly on the cut face and holds still for the last second. No knife and no hands in frame.', sound: m?.sounds.reveal ?? 'FILL: one soft sound as the halves settle', }, ] const noCutBeats = [ { beat: 'tap', angle: 'Close-up at board height, three-quarter front', keyframe_prompt: 'Close-up at board height, three-quarter front view: {{OBJECT}}, remade entirely in {{MATERIAL}}, resting whole in the middle of the frame on {{SET}}. Nothing else in frame. The object fills the middle third of the vertical frame.', motion_prompt: `A small polished steel teaspoon held by ${hand} comes in from the top edge, taps the object once lightly, and lifts away out of frame. The object stays still; light glints across it after the tap. Locked-off camera with a very slight slow push-in.`, sound: m?.sounds.tap ?? 'FILL: one tap sound for this material', }, { beat: 'light', angle: 'Extreme macro across the surface', keyframe_prompt: 'Extreme macro across the surface of the same {{MATERIAL_NAME}} object as in reference image 1, on the same board: the surface texture fills most of the frame, one edge of the object curving out of focus, a soft band of light about to sweep across it. Nothing else in frame.', motion_prompt: 'A soft band of light glides slowly across the surface from left to right, making the material glow and sparkle; the camera drifts slowly sideways along the edge of the object. Calm, slow, real-time speed.', sound: m?.sounds.light ?? 'FILL: one quiet shimmer sound', }, { beat: 'turn', angle: 'Medium close-up, eye level', keyframe_prompt: 'Medium close-up at eye level of the same {{MATERIAL_NAME}} object as in reference image 1, whole, standing on a small turntable hidden under the same board surface, in the same light, centred, with calm empty space around it. Nothing else in frame.', motion_prompt: 'The object turns slowly and smoothly on the hidden turntable, about a quarter turn, light rolling across its surface; it comes to rest facing the camera for the last second. Locked-off camera.', sound: m?.sounds.turn ?? 'FILL: one soft sound that fades', }, ] const beats = cut ? cutBeats : noCutBeats const shots = beats.map((b, i) => ({ n: i + 1, id: `${String(i + 1).padStart(2, '0')}-${b.beat}`, beat: b.beat, angle: b.angle, use_first_frame_ref: i > 0, keyframe_prompt: b.keyframe_prompt, ...(b.poised_prompt ? { poised_prompt: b.poised_prompt, poised_keyframe: '' } : {}), motion_prompt: b.motion_prompt, sound: b.sound, duration: 6, keyframe: '', test_clip: '', clip: '', in: 0.1, out: 6.0, })) const reel = { schema: 'asmr-cut-reel/1', brief: { object: opts.object, material: materialKey, cut, aspect: '9:16', final_resolution: resolution, photo, keep_logo: keepLogo === 'yes', }, locks: { object: `FILL: one sentence on the object's exact shape, proportions, parts and colours${photo ? ', as in the photo (leave the label blank unless --keep-logo yes)' : ''}, without the material`, material_name: m?.name ?? 'FILL: two or three words, such as blown glass', material: m?.material ?? 'FILL: one sentence: what the material looks like (surface, colour, shine, how light passes through it)', inside: m?.inside ?? 'FILL: one sentence: what the cut face shows inside', set: opts.set ?? m?.set ?? 'FILL: the board and backdrop', look: looks, }, references: { photo }, look: { grade: 'clean', loop_tail: 0.5, audio_xfade: 0.08 }, shots, } writeFileSync(opts.out, JSON.stringify(reel, null, 2) + '\n') const gen = shots.reduce((a, s) => a + s.duration, 0) const kept = shots.reduce((a, s) => a + (s.out - s.in), 0) console.log(`${opts.out}: ${cut ? 'cut' : 'no-cut (made of the material, no knife)'} reel, ${shots.length} beats, ${gen} s generated, about ${kept.toFixed(1)} s after trims, loops.`) if (photo && cut) console.log('Product photo: cutting through a product (and its logo) may not suit every brand. Offer --cut no if in doubt (references/safety-and-brands.md).') console.log('Next: write locks.object (and any other FILL field), then run build-requests.mjs --stage estimate.')