Stage Assets

1#!/usr/bin/env node
2// stage-assets.mjs — copy each frame's named asset_candidates from capture/ into
3// assets/ so Step 5 frame workers reference real files and the live preview
4// (Step 3 / Step 6) shows them. Runs at Step 4 close, once visual design is
5// locked. assemble-index.mjs re-runs the same staging idempotently as a backstop.
6//
7// Reads:  --storyboard STORYBOARD.md, --hyperframes <project root>.
8// Writes: assets/<basename> for each named, found asset.
9// Exit 0 always once the storyboard parses — a missing asset is a non-fatal
10// anomaly (the frame would 404 it), not a contract break.
11
12import { existsSync, readFileSync } from "node:fs";
13import { join, resolve } from "node:path";
14import { parseStoryboard } from "./lib/storyboard.mjs";
15import { stageAssets } from "./lib/assets.mjs";
16
17const argv = process.argv.slice(2);
18const flag = (name, def) => {
19  const i = argv.indexOf(`--${name}`);
20  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : def;
21};
22function die(msg) {
23  console.error(`✗ stage-assets.mjs: ${msg}`);
24  process.exit(1);
25}
26
27const hyperframesDir = resolve(flag("hyperframes", "."));
28const storyboardPath = resolve(flag("storyboard", join(hyperframesDir, "STORYBOARD.md")));
29
30if (!existsSync(storyboardPath)) die(`STORYBOARD.md not found at ${storyboardPath}`);
31const manifest = parseStoryboard(readFileSync(storyboardPath, "utf8"));
32
33const { staged, wanted, anomalies } = stageAssets({ hyperframesDir, frames: manifest.frames });
34
35console.log(`✓ staged ${staged}/${wanted.size} asset(s) into assets/`);
36if (anomalies.length) {
37  console.log(`\nanomalies (non-fatal):`);
38  for (const a of anomalies) console.log(`  - ${a}`);
39}