reelkit-cli 0.12.3 → 0.12.4

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 What changed in each published version of `reelkit-cli`, newest first. A push to `main` publishes the version in
 `package.json` when it is not on npm yet, and it must have an entry here.
 
+## 0.12.4 - 2026-10-09
+
+- A template's timeline shows the music and its beats to the end of the film when the track repeats, not only for the track's own length.
+
 ## 0.12.3 - 2026-10-09
 
 - A template's components are tied to scenes in more of the ways compositions are written: a project's own helper that is handed a scene's id, a lookup by id, a list that pairs ids with components, a branch on a scene's id, and components the file declares for itself.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelkit-cli",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "description": "CLI and Claude skill for making short-form video with a shared asset library.",
   "license": "MIT",
   "author": "Daniel Livshin",

package/skill/SKILL.md

@@ -15,7 +15,7 @@ For image or video cutouts, editable Blender product shots, custom 3D materials,
 
 To implement a chosen style, read its row in `reference/style-recipes.md` for action, timing, sound and proof. `reference/style-components.md` maps the shared components and built-in kit to shot roles; inspect the selected source before using its props.
 
-This skill targets `reelkit-cli` 0.12.3 and its HyperFrames kit. Check the installed version with `reelkit --version`; in a source checkout, invoke its `bin/reelkit.mjs` with Node. Use the matching CLI before authoring with `reelkit/frame`.
+This skill targets `reelkit-cli` 0.12.4 and its HyperFrames kit. Check the installed version with `reelkit --version`; in a source checkout, invoke its `bin/reelkit.mjs` with Node. Use the matching CLI before authoring with `reelkit/frame`.
 
 ## What decides whether the film is accepted
 

package/src/commands/template.ts

@@ -61,7 +61,7 @@ export function filmOf(project: Project): TemplateFilm | undefined {
         ...(used.some((c) => c.scenes.includes(m.id)) ? { components: used.filter((c) => c.scenes.includes(m.id)).map((c) => cut(c.name, 80)).slice(0, 60) } : {}),
       };
     }),
-    ...(music ? { music: { title: cut(music.title, 200), seconds: music.durationSec, ...(music.bpm ? { bpm: music.bpm } : {}), beats: music.beats.filter((b) => b >= 0 && b <= seconds).slice(0, 4000), ...(music.id ? { id: cut(music.id, 128) } : {}) } } : {}),
+    ...(music ? { music: musicOf(music, manifest, seconds) } : {}),
     ...(used.length ? { components: used.slice(0, 300).map((c) => { const text = c.from === "kit" ? undefined : about(c.name); return { name: cut(c.name, 80), from: c.from, uses: c.uses, ...(text ? { about: cut(text, 400) } : {}) }; }) } : {}),
     voice: plan.voice !== "none",
     ...(manifest.captions ? { captions: manifest.captions } : {}),
@@ -69,6 +69,19 @@ export function filmOf(project: Project): TemplateFilm | undefined {
   };
 }
 
+// The music as it plays in the film. A track shorter than the film is repeated by the composition, and the manifest holds every beat
+// that falls inside the film (the repeats too), so those are the beats shown; the track then runs to the film's end. Without them the
+// track's own beats and length are used.
+function musicOf(music: MusicRecord, manifest: AssetManifest, seconds: number): NonNullable<TemplateFilm["music"]> {
+  const inFilm = (manifest.music?.beatFrames ?? []).map((f) => Math.round((f / manifest.fps) * 1000) / 1000).filter((b) => b >= 0 && b <= seconds);
+  const beats = (inFilm.length ? inFilm : music.beats.filter((b) => b >= 0 && b <= seconds)).slice(0, 4000);
+  const repeats = inFilm.length > 0 && inFilm[inFilm.length - 1]! > music.durationSec;
+  return {
+    title: music.title.slice(0, 200), seconds: repeats ? seconds : Math.min(music.durationSec, seconds), ...(music.bpm ? { bpm: music.bpm } : {}), beats,
+    ...(music.id ? { id: music.id.slice(0, 128) } : {}),
+  };
+}
+
 // The sound effects by name, from what the last render recorded (out/sounds.json): every sound that is not the music or a scene's
 // voice, with the title it has in the library when it was pulled from there, or its file name.
 function cuesOf(project: Project, manifest: AssetManifest, musicKey: string | undefined): Pick<TemplateFilm, "cues"> {