reelkit-cli 0.10.3 → 0.10.5

package/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+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.10.5 - 2026-10-09
+
+- Fixes 0.10.4, which was published without the `reelkit` command. Use this version instead.
+
+## 0.10.4 - 2026-10-09
+
+- The public library listing can be sorted by when items were added: `sort=new` or `sort=old`.
+- This changelog ships with the package, and a push to `main` publishes a new version to npm.
+
+## 0.10.3 - 2026-10-07
+
+- The library has a new kind, `prompt`: prompts people used to make motion videos, kept as references. Search and pull them with `--kind prompt`.
+
+## 0.10.2 - 2026-10-07
+
+- The skill carries a studio pane for Claude Code: a live view of the project's timeline and player beside the conversation.
+
+## 0.10.0 - 2026-10-06
+
+- Videos are built and rendered with HyperFrames. Remotion is gone; compositions import from `reelkit/frame`.
+- Fifteen art styles, each with its own components and an example film, from flat vector and line art to synthwave, pixel and collage.
+- 3D: `Assemble3D`, `Particles3D`, `Hero3D`, `Screen3D`, `Warp3D`, scene moods, and branded 3D transforms. 3D now fits the frame with true camera numbers.
+- Pictures in layers: `reelkit assets layers` cuts the subject out of a picture, and `ImageLayers` and `TextOnImage` use the result.
+- Product-surface components: `PromptBox`, `TerminalLog`, `NamedCursor`, `GlassPanel`, `ChapterFrame`, `Headline`, `CounterRoll`, `HudOverlay`, `BrowserFrame`.
+- Five more transitions: `color-push`, `rgb-whip`, `flash`, `ring`, `flip`.
+- Sound: `cuesFor` places cues on interface events, music holds steady under narration, and `reelkit sound` measures the voice against the music.
+- Timing: word anchors (`wordFrame`, `onWord`, `onWordBeat`, `sceneById`), tighter gaps between narrated scenes, and a real length estimate in `plan check`.
+- Preview writes a labelled contact sheet and shows the frame after each word.
+- `reelkit init --private` keeps generated images, clips and graphics out of the shared library.
+- Three narrator voices to choose from.
+
+## 0.8.0 - 2026-10-06
+
+- Videos with no voice: `voice: none` in the plan, scenes timed in seconds on a beat grid, and `SoundCues` in the kit.
+- A 3D layer on three.js, scene transitions, camera punches and `zoomTo`.
+- Moving grounds, background assets and generated SVG graphics (`reelkit assets gen svg`).
+- `reelkit sound` measures the sound of a finished film, and music can dip.
+- `reelkit ref download` handles Instagram and other links whose length is not known in advance.
+- A component that carries any of the video's own words, or a written-in sentence, is not shared.
+- A second slash command for the voiceless launch film.
+
+## 0.6.0 - 2026-10-05
+
+- New components the agent writes are shared with the library for review, by default. Say no with `reelkit init --private`, `reelkit render --no-share` or `REELKIT_NO_SHARE=1`.
+- Music: a track, scene changes on its beat, a `Music` component and beat helpers.
+- Captions are a choice: none, a word at a time, or phrases grouped as they are spoken.
+- Every pulled sound is levelled and the render is mastered to -14 LUFS.
+
+## 0.5.0 - 2026-10-05
+
+- `Carry` and `Camera` in the kit hold one element or one camera through several scenes.
+- `reelkit ref analyze` measures how still a video is and how uneven its shots are.
+- `plan check` says when the scenes are all about the same length, and preview reports which scene changes carry something across.
+- The skill teaches continuity, rhythm and script writing, and offers three concepts before a plan.
+
+## 0.4.0 - 2026-10-05
+
+- Reference videos: `reelkit ref download`, `audio`, `analyze` and `list`, with a transcript and a local beat and tempo analysis.
+- A plan can name its reference, and `plan check` looks at it.
+- A generated green-screen clip that is too dull to key is cut out on the server instead.
+
+## 0.3.1 - 2026-10-05
+
+- The CLI talks to reelkit.cc by default.
+
+## 0.3.0 - 2026-10-05
+
+- Cut the subject out of any video on the server: `reelkit assets upload --cutout` and `reelkit assets gen clip --cutout`.
+- Key your own green-screen footage; the key colour is read from the frame.
+
+## 0.2.0 - 2026-10-05
+
+- Generated clips: `reelkit assets gen clip`, with green-screen keying, clip scenes in the plan, and the `ClipLayer` and `KeyedClip` components.
+
+## 0.1.3 - 2026-10-05
+
+- The looks catalogue is rebuilt around the kit and the shared library.
+- The skill chooses a look, handles Hebrew on screen and applies what editing real footage teaches.
+
+## 0.1.2 - 2026-10-05
+
+- `reelkit --version`.
+- Preview shows two frames per scene, and `plan check` always reports the estimated length.
+- The first preview or render says when the rendering browser is being downloaded.
+
+## 0.1.1 - 2026-10-05
+
+- Node 22.12 or later is required.
+
+## 0.1.0 - 2026-10-05
+
+- First release: `reelkit init`, `plan check`, asset upload, search and pull, voiceover and image generation, `check`, `preview` and `render`, device login, and the skill for coding agents.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelkit-cli",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "description": "CLI and Claude skill for making short-form video with a shared asset library.",
   "license": "MIT",
   "author": "Daniel Livshin",
@@ -18,7 +18,7 @@
   ],
   "type": "module",
   "bin": {
-    "reelkit": "./bin/reelkit.mjs"
+    "reelkit": "bin/reelkit.mjs"
   },
   "exports": {
     ".": "./src/contract/index.ts",
@@ -39,7 +39,8 @@
   "files": [
     "bin",
     "src",
-    "skill"
+    "skill",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.12"

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.10.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.10.5 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`.
 
 Every command takes `--json` for machine-readable output and exits non-zero with a one-line reason when something is wrong. Read the reason and act on it.
 

package/src/contract/index.ts

@@ -259,7 +259,9 @@ export const routes = {
     z.object({ id: ItemId }),
     z.object({ id: z.string(), text: z.string(), language: z.string().optional(), segments: z.array(TranscriptSegmentSchema), durationSec: z.number().positive() })),
   publicLibrary: route("GET", "/public/library", false,
-    z.object({ q: text(200).optional(), kind: LibraryKindSchema.optional(), page: z.coerce.number().int().min(1).max(10000).optional() }),
+    // `sort` orders a listing without words by when each item was added: "new" is newest first, "old" is oldest first. Without it the
+    // server chooses (newest first within a kind; the kinds take turns when none is named). It does not reorder a search by words.
+    z.object({ q: text(200).optional(), kind: LibraryKindSchema.optional(), page: z.coerce.number().int().min(1).max(10000).optional(), sort: z.enum(["new", "old"]).optional() }),
     // With `q` the items are the best matches by meaning, best first, each with `match` (0..1), in one page (`hasMore` false). Under heavy
     // use, or when ranking fails, the server answers the plain text listing instead (no `match`), so a client must accept both.
     z.object({ items: z.array(LibraryItemSchema.extend({ previewUrl: z.string().optional(), match: z.number().min(0).max(1).optional() })), page: z.number(), hasMore: z.boolean() })),

package/src/testing/fake-api.ts

@@ -323,14 +323,14 @@ export async function startFakeApi(opts: { voiceoverCharLimit?: number; imageLim
       };
       return job.result;
     },
-    publicLibrary: ({ q, kind, page }) => {
-      // Published items only. Newest first; with a query, best match first and equal matches newest first.
+    publicLibrary: ({ q, kind, page, sort }) => {
+      // Published items only. Newest first, or oldest first when asked; with a query, best match first and equal matches newest first.
       const want = q ? words(q) : undefined;
       const score = (i: LibraryItem) => (want ? [...want].filter((w) => words(`${i.title} ${i.description} ${i.tags.join(" ")}`).has(w)).length : 0);
       const all = [...store.values()]
         .map((s, order) => ({ s, order, score: score(s.item) }))
         .filter((x) => x.s.item.visibility === "published" && (!kind || x.s.item.kind === kind) && (!want || x.score > 0))
-        .sort((a, b) => b.score - a.score || b.order - a.order).map((x) => x.s);
+        .sort((a, b) => b.score - a.score || (sort === "old" && !want ? a.order - b.order : b.order - a.order)).map((x) => x.s);
       const p = page ?? 1, size = 24;
       const items = all.slice((p - 1) * size, p * size).map((s) => (s.file && (PREVIEW_OF_ORIGINAL.includes(s.item.kind) || shortClip(s.item)) ? { ...s.item, previewUrl: fileUrl(s.file) } : s.item));
       return { items, page: p, hasMore: all.length > p * size };