@litfamily/litopencode 1.0.30 → 1.0.32

package/skills/lit-typographic-motion/render.mjs

@@ -34,8 +34,12 @@ Usage:
   node render.mjs video  --brief <brief.json> --out <dir> [--round 1|2|3] [--viewed N]
   node render.mjs perf   --brief <brief.json> --out <dir>
   node render.mjs gate   --out <dir> [--viewed N]
+  node render.mjs scaffold --out <dir>
   node render.mjs stage  --out <dir> [--round 1|2|3] [--stills-only] [--detach]
+  node render.mjs styles --out <dir> [--format 16:9|9:16]
   node render.mjs cover  --out <dir> [--round 1|2|3] [--window t0,t1] [--detach]
+  node render.mjs assets --out <dir> --url <https link of the product> [--cover]
+  node render.mjs blender --out <dir> [--final] [--detach]
   node render.mjs sound  --out <dir>
   node render.mjs look   --out <dir> --round 1|2|3 --answers <answers.json>
 Options: --samples N (master default 4) --shutter S (default 0.5) --scale 1..4 --word-timing (Tier 3, opt-in)
@@ -524,9 +528,14 @@ async function stageMode(argv, out, viewed) {
   }
   const stillsOnly = argv.includes("--stills-only");
   const result = await stage.renderStage(out, { round, stillsOnly });
-  for (const entry of result.stills.files) console.log(`${entry.kind === "sheet" ? "contact sheet" : "still"}: ${path.join(out, entry.file)}`);
+  for (const entry of result.stills.files) console.log(`${entry.kind === "sheet" ? "contact sheet" : entry.kind === "board" ? "storyboard" : "still"}: ${path.join(out, entry.file)}`);
   if (result.stillsOnly) {
-    console.log(`stills-only: open every still and the contact sheet, record the round with \`look --round ${round}\`, make the change, then render the film.`);
+    const failed = result.board?.failed ?? [];
+    if (failed.length) {
+      console.error(`BOARD_CHECK_FAIL (${EXIT.GATE_FAIL_QA}): ${failed.map((rule) => `${rule.id} ${rule.detail}`).join("; ")}. Fix the page, render --stills-only again, then look at the storyboard ${path.join(out, "stills", "board.png")} and every file in ${path.join(out, "stills")}`);
+      return EXIT.GATE_FAIL_QA;
+    }
+    console.log(`stills-only: board check PASS; open the storyboard ${path.join(out, "stills", "board.png")}, every still and the contact sheet, record the round with \`look --round ${round}\`, make the change, then render the film.`);
     return EXIT.OK;
   }
   const gate = runGate(out, { viewed });
@@ -534,6 +543,43 @@ async function stageMode(argv, out, viewed) {
   return gate.exitCode;
 }
 
+// `scaffold`: the starting stage page from the treatment (engine/scaffold.mjs).
+async function scaffoldMode(out) {
+  const { scaffoldCommand } = await import("./engine/scaffold.mjs");
+  console.log(scaffoldCommand(out, { env: process.env }));
+  return EXIT.OK;
+}
+
+// `blender`: the offline Cycles rung (engine/blender.mjs). The final plate can take most of an hour, so
+// `--detach` runs it like a full stage render and reports through .run/.
+async function blenderMode(argv, out) {
+  const final = argv.includes("--final");
+  if (argv.includes("--detach")) {
+    const { detachStage } = await import("./engine/stage/render.mjs");
+    const detached = detachStage(out, argv.slice(1), "blender");
+    console.log(`rendering the plate in the background (pid ${detached.pid}); progress: ${detached.progressFile}; the exit code lands in ${detached.exitFile}; log: ${detached.logFile}`);
+    return EXIT.OK;
+  }
+  const { blenderCommand } = await import("./engine/blender.mjs");
+  const runDir = path.join(out, ".run");
+  const progress = (frame, frameCount) => {
+    mkdirSync(runDir, { recursive: true });
+    writeFileSync(path.join(runDir, "progress.json"), JSON.stringify({ phase: "plate", frame, frameCount, updatedAt: new Date().toISOString() }) + "\n");
+  };
+  const result = await blenderCommand({ out, final, env: process.env, log, progress: final ? progress : null });
+  console.log(result.message);
+  return result.code;
+}
+
+// `styles`: the style gallery, one board round per house style (engine/gallery.mjs).
+async function stylesMode(argv, out) {
+  const { stylesCommand } = await import("./engine/gallery.mjs");
+  const { renderStage } = await import("./engine/stage/render.mjs");
+  const result = await stylesCommand(out, { format: option(argv, "format", "16:9"), render: renderStage, log });
+  console.log(result.message);
+  return result.code;
+}
+
 // `cover`: a README cover loop (engine/cover/). Every round is a full render gated on the decoded file;
 // `--window t0,t1` re-renders only the frames around a logged defect. A detached run reports through .run/.
 async function coverMode(argv, out) {
@@ -554,10 +600,17 @@ async function coverMode(argv, out) {
   return result.code;
 }
 
+async function assetsMode(argv) {
+  const { assetsCommand } = await import("./engine/assets.mjs");
+  const result = await assetsCommand(argv);
+  process.stdout.write(`${result.message}\n`);
+  return result.code;
+}
+
 async function run(argv) {
   const mode = argv[0];
   if (!mode || mode === "--help" || argv.includes("--help")) { console.log(usage); return EXIT.OK; }
-  if (!["film", "stills", "sheet", "video", "perf", "gate", "frames", "stage", "cover", "sound", "look"].includes(mode)) { console.error(usage); return 2; }
+  if (!["film", "stills", "sheet", "video", "perf", "gate", "frames", "stage", "scaffold", "styles", "cover", "assets", "blender", "sound", "look"].includes(mode)) { console.error(usage); return 2; }
   const out = option(argv, "out") ? path.resolve(option(argv, "out")) : undefined;
   if (!out) throw new Error("--out <dir> is required");
   const viewed = argv.includes("--viewed") ? Number(option(argv, "viewed", "0")) || 0 : undefined;
@@ -567,7 +620,11 @@ async function run(argv) {
     return result.exitCode;
   }
   if (mode === "stage") return stageMode(argv, out, viewed);
+  if (mode === "scaffold") return scaffoldMode(out);
+  if (mode === "styles") return stylesMode(argv, out);
   if (mode === "cover") return coverMode(argv, out);
+  if (mode === "assets") return assetsMode(argv);
+  if (mode === "blender") return blenderMode(argv, out);
   if (mode === "sound") return soundMode(out);
   if (mode === "look") return lookMode(argv, out);
   let treatment = null;

package/skills/lit-typographic-motion/requirements-audio.txt

@@ -57,9 +57,9 @@ audioread==3.1.0 \
     --hash=sha256:1c4ab2f2972764c896a8ac61ac53e261c8d29f0c6ccd652f84e18f08a4cab190 \
     --hash=sha256:b30d1df6c5d3de5dcef0fb0e256f6ea17bdcf5f979408df0297d8a408e2971b4
     # via librosa
-certifi==2026.7.22 \
-    --hash=sha256:62f22742b58a1a33014a2b6b706588a8d7e2a88ae7bd1a6ebe8c992928483775 \
-    --hash=sha256:741e2c3b351ddf169a738da9f2c048608ff7f2c5cc02f1ebc6b118bb090d5d55
+certifi==2026.10.19 \
+    --hash=sha256:42d35340cc5b9ba78e818ddbff0c5b1c2b779de448a340fd1b989f5fa8670e1b \
+    --hash=sha256:035c1e85572b141bf1c3a3eff0e33a8eb74917522f2559075ff8d2fea780a1ae
     # via requests
 cffi==2.1.1 \
     --hash=sha256:046bfc24911b37851ee1b51aab8bffe713d89c68c6a057b09484ce9fd5f69b4e \

package/skills/lit-typographic-motion/styles/paper.json

@@ -0,0 +1,185 @@
+{
+  "schema": "litopencode.motion-style/v1",
+  "id": "paper",
+  "name": "Paper",
+  "summary": "A warm paper ground, near-black ink, one terracotta signal and one blue moment; soft springs, hand-drawn calm.",
+  "light": true,
+  "typePreset": null,
+  "palette": {
+    "ground": "#F3EEE5",
+    "surface": "#E6DED0",
+    "ink": "#1D1B18",
+    "muted": "#5B564E",
+    "signal": "#B0452A",
+    "accent": "#2B5D8E",
+    "line": "#C9BFAE"
+  },
+  "accents": [
+    {
+      "role": "growth and done",
+      "color": "#3F7D3A"
+    },
+    {
+      "role": "a second data series",
+      "color": "#7A3E7A"
+    },
+    {
+      "role": "a warning or a date",
+      "color": "#8A6418"
+    },
+    {
+      "role": "a third data series",
+      "color": "#1F6F6B"
+    }
+  ],
+  "textRoles": [
+    "ink",
+    "muted",
+    "signal",
+    "accent",
+    "ground"
+  ],
+  "faces": {
+    "display": {
+      "family": "Pretendard",
+      "weight": 700
+    },
+    "headline": {
+      "family": "Pretendard",
+      "weight": 700
+    },
+    "body": {
+      "family": "Pretendard",
+      "weight": 400
+    },
+    "label": {
+      "family": "MesloLGS NF",
+      "weight": 400
+    }
+  },
+  "scale": {
+    "16:9": {
+      "display": 112,
+      "headline": 68,
+      "body": 40,
+      "label": 26
+    },
+    "9:16": {
+      "display": 108,
+      "headline": 74,
+      "body": 46,
+      "label": 32
+    }
+  },
+  "leading": {
+    "display": 1.15,
+    "headline": 1.25,
+    "body": 1.6,
+    "label": 1.4
+  },
+  "motion": {
+    "ease": {
+      "enter": [
+        0.22,
+        1,
+        0.36,
+        1
+      ],
+      "move": [
+        0.65,
+        0,
+        0.35,
+        1
+      ],
+      "exit": [
+        0.55,
+        0,
+        1,
+        0.45
+      ]
+    },
+    "dur": {
+      "micro": 0.18,
+      "move": 0.55,
+      "hero": 0.8,
+      "exit": 0.32
+    },
+    "stagger": {
+      "letter": 0.03,
+      "word": 0.09,
+      "item": 0.1
+    },
+    "spring": {
+      "micro": {
+        "zeta": 0.85,
+        "hz": 3.5
+      },
+      "panel": {
+        "zeta": 0.8,
+        "hz": 2
+      },
+      "headline": {
+        "zeta": 0.95,
+        "hz": 2.2
+      },
+      "subject": {
+        "zeta": 0.6,
+        "hz": 1.8
+      },
+      "camera": {
+        "zeta": 1,
+        "hz": 0.5
+      }
+    },
+    "secondary": {
+      "delay": 0.15,
+      "travel": 0.6
+    },
+    "ambient": {
+      "travel": 0.04
+    },
+    "push": 0.02
+  },
+  "transitions": [
+    "cut",
+    "match",
+    "wipe",
+    "iris",
+    "push"
+  ],
+  "ground": {
+    "kind": "flat"
+  },
+  "sound": {
+    "palette": "warm",
+    "key": "F major",
+    "tempo": 96
+  },
+  "score": {
+    "genre": "garage"
+  },
+  "beds": [
+    {
+      "palette": "warm",
+      "key": "F major",
+      "tempo": 96
+    },
+    {
+      "palette": "air",
+      "key": "G major",
+      "tempo": 88
+    },
+    {
+      "palette": "glass",
+      "key": "C major",
+      "tempo": 108
+    }
+  ],
+  "bans": [
+    "drop shadows that float type",
+    "neon or glow",
+    "gradients on type",
+    "a saturated colour with no role",
+    "bouncy type"
+  ]
+}

package/skills/lit-typographic-motion/styles/swiss-signal.json

@@ -0,0 +1,188 @@
+{
+  "schema": "litopencode.motion-style/v1",
+  "id": "swiss-signal",
+  "name": "Swiss signal",
+  "summary": "Ink ground, bone type, one teal signal and one amber moment; type lands precisely and cuts hard.",
+  "light": false,
+  "typePreset": "swiss-signal",
+  "palette": {
+    "ground": "#0C0E13",
+    "surface": "#171B24",
+    "ink": "#E9EBE4",
+    "muted": "#A4A9AF",
+    "signal": "#0F7A82",
+    "accent": "#D9A441",
+    "line": "#4B5058"
+  },
+  "accents": [
+    {
+      "role": "state under review",
+      "color": "#E2725B"
+    },
+    {
+      "role": "state planned",
+      "color": "#9B8CFF"
+    },
+    {
+      "role": "state done",
+      "color": "#8FC25A"
+    },
+    {
+      "role": "state in progress",
+      "color": "#5BA8E0"
+    }
+  ],
+  "textRoles": [
+    "ink",
+    "muted",
+    "signal",
+    "accent",
+    "ground"
+  ],
+  "faces": {
+    "display": {
+      "family": "Archivo",
+      "weight": 900,
+      "stretch": "100%"
+    },
+    "headline": {
+      "family": "Archivo",
+      "weight": 700,
+      "stretch": "100%"
+    },
+    "body": {
+      "family": "Pretendard",
+      "weight": 400
+    },
+    "label": {
+      "family": "MesloLGS NF",
+      "weight": 400
+    }
+  },
+  "scale": {
+    "16:9": {
+      "display": 128,
+      "headline": 76,
+      "body": 40,
+      "label": 26
+    },
+    "9:16": {
+      "display": 120,
+      "headline": 80,
+      "body": 46,
+      "label": 32
+    }
+  },
+  "leading": {
+    "display": 1.1,
+    "headline": 1.2,
+    "body": 1.55,
+    "label": 1.4
+  },
+  "motion": {
+    "ease": {
+      "enter": [
+        0.16,
+        1,
+        0.3,
+        1
+      ],
+      "move": [
+        0.65,
+        0,
+        0.35,
+        1
+      ],
+      "exit": [
+        0.7,
+        0,
+        0.84,
+        0
+      ]
+    },
+    "dur": {
+      "micro": 0.15,
+      "move": 0.45,
+      "hero": 0.6,
+      "exit": 0.28
+    },
+    "stagger": {
+      "letter": 0.025,
+      "word": 0.07,
+      "item": 0.08
+    },
+    "spring": {
+      "micro": {
+        "zeta": 1,
+        "hz": 4
+      },
+      "panel": {
+        "zeta": 0.9,
+        "hz": 2.2
+      },
+      "headline": {
+        "zeta": 1,
+        "hz": 2.6
+      },
+      "subject": {
+        "zeta": 0.8,
+        "hz": 1.8
+      },
+      "camera": {
+        "zeta": 1,
+        "hz": 0.5
+      }
+    },
+    "secondary": {
+      "delay": 0.15,
+      "travel": 0.6
+    },
+    "ambient": {
+      "travel": 0.03
+    },
+    "push": 0.02
+  },
+  "transitions": [
+    "cut",
+    "wipe",
+    "match",
+    "push"
+  ],
+  "ground": {
+    "kind": "flat",
+    "grid": true
+  },
+  "sound": {
+    "palette": "glass",
+    "key": "A minor",
+    "tempo": 104
+  },
+  "score": {
+    "genre": "house"
+  },
+  "beds": [
+    {
+      "palette": "glass",
+      "key": "A minor",
+      "tempo": 104
+    },
+    {
+      "palette": "pulse",
+      "key": "D minor",
+      "tempo": 112
+    },
+    {
+      "palette": "warm",
+      "key": "C major",
+      "tempo": 96
+    }
+  ],
+  "bans": [
+    "glow or bloom on type",
+    "an accent colour with no role",
+    "centred fade-in as the only move",
+    "overshoot or bounce on type",
+    "particles as decoration",
+    "gradients behind type"
+  ]
+}

package/skills/lit-typographic-motion/styles/terminalcore.json

@@ -0,0 +1,182 @@
+{
+  "schema": "litopencode.motion-style/v1",
+  "id": "terminalcore",
+  "name": "Terminalcore",
+  "summary": "A navy terminal: phosphor type that appears at typing speed, one signal hue, hard cuts, nothing eases.",
+  "light": false,
+  "typePreset": "terminalcore",
+  "palette": {
+    "ground": "#05070A",
+    "surface": "#0C1116",
+    "ink": "#39FF6A",
+    "muted": "#7C8B93",
+    "signal": "#39FF6A",
+    "line": "#1E2A33"
+  },
+  "accents": [
+    {
+      "role": "a warning line",
+      "color": "#FFB23F"
+    },
+    {
+      "role": "an error line",
+      "color": "#FF6B6B"
+    },
+    {
+      "role": "a path or a link",
+      "color": "#6CA8FF"
+    }
+  ],
+  "textRoles": [
+    "ink",
+    "muted",
+    "signal",
+    "ground"
+  ],
+  "faces": {
+    "display": {
+      "family": "VT323",
+      "weight": 400
+    },
+    "headline": {
+      "family": "VT323",
+      "weight": 400
+    },
+    "body": {
+      "family": "VT323",
+      "weight": 400
+    },
+    "label": {
+      "family": "MesloLGS NF",
+      "weight": 400
+    }
+  },
+  "hangul": {
+    "family": "Galmuri9",
+    "weight": 400
+  },
+  "scale": {
+    "16:9": {
+      "display": 126,
+      "headline": 81,
+      "body": 45,
+      "label": 36
+    },
+    "9:16": {
+      "display": 117,
+      "headline": 81,
+      "body": 54,
+      "label": 36
+    }
+  },
+  "leading": {
+    "display": 1.1,
+    "headline": 1.2,
+    "body": 1.5,
+    "label": 1.4
+  },
+  "motion": {
+    "ease": {
+      "enter": [
+        0,
+        0,
+        1,
+        1
+      ],
+      "move": [
+        0,
+        0,
+        1,
+        1
+      ],
+      "exit": [
+        0,
+        0,
+        1,
+        1
+      ]
+    },
+    "dur": {
+      "micro": 0.1,
+      "move": 0.3,
+      "hero": 0.5,
+      "exit": 0.1
+    },
+    "stagger": {
+      "letter": 0.0455,
+      "word": 0.18,
+      "item": 0.25
+    },
+    "spring": {
+      "micro": {
+        "zeta": 1,
+        "hz": 6
+      },
+      "panel": {
+        "zeta": 1,
+        "hz": 4
+      },
+      "headline": {
+        "zeta": 1,
+        "hz": 4
+      },
+      "subject": {
+        "zeta": 1,
+        "hz": 3
+      },
+      "camera": {
+        "zeta": 1,
+        "hz": 1
+      }
+    },
+    "secondary": {
+      "delay": 0.1,
+      "travel": 0.6
+    },
+    "ambient": {
+      "travel": 0.02
+    },
+    "push": 0
+  },
+  "transitions": [
+    "cut",
+    "wipe"
+  ],
+  "ground": {
+    "kind": "flat",
+    "panel": "surface"
+  },
+  "sound": {
+    "palette": "pulse",
+    "key": "E minor",
+    "tempo": 120
+  },
+  "score": {
+    "genre": "tech-house"
+  },
+  "beds": [
+    {
+      "palette": "pulse",
+      "key": "E minor",
+      "tempo": 120
+    },
+    {
+      "palette": "glass",
+      "key": "B minor",
+      "tempo": 132
+    },
+    {
+      "palette": "pulse",
+      "key": "A minor",
+      "tempo": 100
+    }
+  ],
+  "bans": [
+    "falling code rain",
+    "purple-cyan neon haze",
+    "glitch running continuously",
+    "an accent hue with no role",
+    "pixel type too small to read",
+    "eased type"
+  ]
+}