@devinilabs/reelstack 1.2.0

package/LICENSE

@@ -0,0 +1,128 @@
+ReelStack Commercial License v1.0
+Copyright (c) 2026 Devini Labs. All rights reserved.
+
+This software is licensed, not sold. Possession of this package without a
+valid license key issued by Devini Labs does NOT grant any rights to use,
+copy, modify, distribute, or sublicense the contents.
+
+================================================================================
+SUMMARY (the legal text below is authoritative)
+================================================================================
+
+  - You may use ReelStack on a single end-user machine per license key.
+  - You may render unlimited videos for yourself, your employer, or your
+    clients with a valid license.
+  - You MAY NOT redistribute, repackage, resell, or open-source the families,
+    presets, components, templates, or CLI source contained in this package.
+  - You MAY NOT bundle ReelStack into another product offered for sale or
+    free distribution.
+  - License keys are non-transferable.
+  - Updates are included for the duration specified in your purchase.
+
+================================================================================
+GRANT
+================================================================================
+
+Subject to the terms of this License and the existence of a valid, active
+license key issued by Devini Labs (via the payment processor at
+https://devini.io/reelstack), Devini Labs ("Licensor") grants you
+("Licensee") a non-exclusive, non-transferable, revocable license to:
+
+  (a) install ReelStack on Licensee's development machines;
+  (b) use the families, presets, components, templates, and CLI to scaffold,
+      compose, and render Licensee's own video content;
+  (c) ship the rendered video output to any platform Licensee chooses, with
+      no royalty or attribution required.
+
+================================================================================
+RESTRICTIONS
+================================================================================
+
+Licensee shall NOT, without prior written consent from Devini Labs:
+
+  1. Redistribute the source files contained in this package, in whole or in
+     part, in any form, public or private.
+  2. Resell or sublicense ReelStack or any portion of it.
+  3. Use ReelStack to create a competing product (template marketplace,
+     reel builder, video-as-a-service product) that exposes the same
+     primitives, presets, or templates to third parties.
+  4. Remove, modify, or obscure copyright notices, license headers, or
+     watermarks present in the source files.
+  5. Share, post, leak, or commit license keys to any public location.
+
+================================================================================
+TERMINATION
+================================================================================
+
+This License terminates automatically upon any breach by Licensee. Upon
+termination, Licensee must delete all copies of ReelStack from their
+systems. Rendered video output created prior to termination remains owned
+by Licensee.
+
+================================================================================
+DISCLAIMER OF WARRANTY
+================================================================================
+
+REELSTACK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
+FROM, OUT OF, OR IN CONNECTION WITH REELSTACK OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+
+================================================================================
+CONTACT
+================================================================================
+
+Licensing questions: licensing@devinilabs.com
+Bug reports:        https://github.com/devinilabs/reelstack/issues (private)
+
+================================================================================
+ACKNOWLEDGMENTS
+================================================================================
+
+ReelStack v1.1+ incorporates design-discipline rules from leonxlnx/taste-skill
+(MIT-licensed, by @leonxlnx) and adopts UX patterns inspired by
+alchaincyf/huashu-design (Personal Use Only, by @AlchainHust / 花叔).
+
+The taste-skill rules are baked into ReelStack's components, palettes, and lint
+under the terms of its MIT license. The huashu-design influence is pattern-only
+— no code, text, or assets from huashu-design are copied into ReelStack;
+ReelStack reimplements equivalent UX patterns (Design Direction Advisor,
+5-dimension critique, multi-format export) against its own Remotion + CLI
+architecture, with full credit.
+
+ReelStack's "huashu" preset (Warm Signature family) is named for
+@AlchainHust's project as a credit hook.
+
+Full attribution and rule citations: docs/design-discipline.md.
+
+================================================================================
+REFERENCE REEL LICENSE (v1.1.1+)
+================================================================================
+
+ReelStack v1.1.1+ ships with reference reels at ~/.reelstack/reference/
+containing stripped-down source from Devini Labs reels that have shipped to
+Instagram, TikTok, and YouTube Shorts (GraphifyReel, ClaudeWatchReel,
+HereticReel, and 9 others). Asset imports (audio, video, brand SVGs) have
+been replaced with REFERENCE-STRIP placeholders.
+
+THE REFERENCE LICENSE GRANTS LICENSEE:
+  (a) the right to STUDY the JSX, motion choreography, BEAT structures, and
+      scene composition of every reference reel;
+  (b) the right to ADAPT motion patterns, scene transitions, and primitive
+      compositions into Licensee's own reels;
+  (c) the right to copy SHORT excerpts (a single scene, a specific motion
+      combination, a transition recipe) into Licensee's own work.
+
+THE REFERENCE LICENSE DOES NOT GRANT:
+  (d) the right to publish a reference reel verbatim as Licensee's own
+      template, free or paid;
+  (e) the right to redistribute the reference reels as a package, fork, or
+      derivative work without the rest of ReelStack;
+  (f) the right to remove REFERENCE-STRIP markers and ship the result as a
+      paid template;
+  (g) the right to use a reference reel's branding, copy, or visual identity
+      to misrepresent the resulting work as a Devini Labs production.
+
+If in doubt: pattern adaptation OK. Verbatim re-publication NOT OK.

package/README.md

@@ -0,0 +1,125 @@
+# ReelStack
+
+> Premium 9:16 Reel OS for Remotion. **5 cinematic style families. 22 production-tested presets. Audio-locked motion. IG-safe by default.**
+
+ReelStack is the toolkit behind the Devini Labs reel aesthetic — packaged as a Claude Code skill plus a companion CLI. One slash command (`/reelstack-glass`, `/reelstack-paper`, `/reelstack-dark`, `/reelstack-warm`, `/reelstack-forbidden`) scaffolds a new 9:16 reel with the right palette, primitives, motion vocabulary, BEAT skeleton, and IG safe zones already wired up. From `init` to first preview render in under 10 minutes.
+
+## What you get
+
+| Family | Vibe | Presets |
+|---|---|---|
+| **Glass Iridescent** | Light lavender-cream + iridescent particles. Caustic blobs, sonar rings, glass cards, floating glyphs. | graphify · paperclip · gstack · lilagents · jcode · claudewatch · claudewatchcta |
+| **Cream Paper** | Warm editorial paper + dark-green cards + Claude terracotta. | justdrop · opus · designreel · devini3d |
+| **Dark Cinematic** | Zinc void + drifting spotlights + Claude terracotta. Premium ad-film mood. | stitch · stitch2 · codedrop · claudedispatch · notebooklm · gpt55 · resourcescta · skills |
+| **Warm Signature** | Single-accent rule. Amber signature + emerald payoff + bento grid. | huashu · mempalace |
+| **Forbidden** | Cream-rose paper + ember + crimson + plasma. Desaturated, mysterious. | heretic |
+
+Each preset carries the **exact palette, BEAT structure, frame count, and motion vocabulary** of a real Devini Labs reel that has shipped to YouTube and Instagram.
+
+## Why pay for it
+
+- **House-style enforcement.** `reelstack lint` flags motion-floor violations, IG safe-zone breaches, hero-text overflow, and missing audio locks. Most boring AI-generated reel templates can't do this.
+- **Audio-locked everywhere.** `reelstack beats <vo.wav>` runs whisper-cli and prints frame-accurate `BEAT` constants. No more eyeball-drift across 90-second clips.
+- **GSAP vocabulary, ported.** Power4Out, expoOut, backOut — translated into Remotion `interpolate()` so motion language stays consistent.
+- **Real brand assets.** `reelstack icons <brand>` pulls genuine SVGs from Iconify (logos:react, logos:next-js, etc.) instead of asking you to hand-draw.
+- **Render presets.** `reelstack render <id> --platform=ig` ships with the right H.264, bitrate, and color flags for IG / TikTok / Shorts.
+
+## Install
+
+```bash
+# Inside an existing Remotion project — or any folder; init can bootstrap one
+npx @devinilabs/reelstack init
+```
+
+`init` runs a **4-tier readiness gate** (v1.2+) so its success banner is provable. After it exits 0, every `/reelstack-*` command works — or it exits non-zero with a clear remediation.
+
+| Tier | What it checks | If missing |
+|---|---|---|
+| 1 | Node ≥ 20 | exits with `nvm` / `fnm` / nodejs.org guidance |
+| 2 | `ffmpeg` (required) + `whisper-cpp` (soft, only for `/reelstack-beats`) | macOS+Homebrew: offers to `brew install` for you. Linux / Windows / macOS-without-brew: prints the exact command for your platform and exits so you can install + retry |
+| 3 | Remotion project + `@devinilabs/reelstack` dep | runs `npx create-video@latest --yes --blank reelstack-project` (override with `--name=…`, or skip with `--no-bootstrap`) |
+| 4 | Smoke test — scaffolds Demo.tsx, runs `npx remotion compositions`, runs `ffmpeg -version` | exits 1 with the failing step name. Skip with `--skip-smoke`. |
+
+The verified state is recorded at `~/.reelstack/state.json` so subcommands like `/reelstack-beats` can fail-fast with helpful messages instead of generic "not found" errors.
+
+Don't have a license yet? Try the free preview:
+
+```bash
+npx @devinilabs/reelstack preview
+```
+
+## First reel in 5 minutes
+
+```text
+You: /reelstack-glass
+ReelStack: Which preset? (graphify | paperclip | gstack | lilagents | jcode)
+You: graphify
+ReelStack: Reel name?
+You: MyLaunch
+ReelStack: Voiceover file? (path/.wav, or skip)
+You: ./public/launch-vo.wav
+
+✓ Created src/MyLaunchReel.tsx
+✓ Registered in src/Root.tsx (1080×1920, 30fps, 1956 frames)
+✓ Whisper transcribed → 9 BEAT constants injected
+✓ Geist fonts pre-wired
+✓ IG safe zones inlined
+→ Open Remotion Studio? (Y/n)
+```
+
+That's it. You're inside a real Devini Labs reel template, with your voiceover beats locked, your primitives imported, and Studio open at frame 0.
+
+## Slash commands
+
+```
+/reelstack-glass         Scaffold a Glass Iridescent reel
+/reelstack-paper         Scaffold a Cream Paper reel
+/reelstack-dark          Scaffold a Dark Cinematic reel
+/reelstack-warm          Scaffold a Warm Signature reel
+/reelstack-forbidden     Scaffold a Forbidden reel
+/reelstack-init          Set up ReelStack in a fresh Remotion project
+/reelstack-beats         Convert voiceover .wav → frame-accurate BEAT constants
+/reelstack-capture       Pull product screenshots into the reel via reel-capture
+/reelstack-icons         Pull real brand SVGs via better-icons (Iconify)
+/reelstack-render        Render with platform presets (ig | tiktok | shorts)
+/reelstack-lint          Validate motion floors, safe zones, audio lock, text fit
+```
+
+## Requirements
+
+| Tool | macOS | Linux | Windows |
+|---|---|---|---|
+| **Node ≥ 20** | `nvm install 20` / [nodejs.org](https://nodejs.org/) | same | same |
+| **Remotion 4** | auto-bootstrapped by `init`, or `npm create video@latest` | same | same |
+| **ffmpeg** (required) | `brew install ffmpeg` (init can run this) | `apt-get install ffmpeg` · `dnf install ffmpeg` · `pacman -S ffmpeg` | `choco install ffmpeg` · `scoop install ffmpeg` |
+| **whisper-cpp** (only `/reelstack-beats`) | `brew install whisper-cpp` (init can run this) | build from source: [github.com/ggerganov/whisper.cpp](https://github.com/ggerganov/whisper.cpp) | build from source, or `scoop install whisper.cpp` |
+| **Claude Code** | [claude.com/claude-code](https://claude.com/claude-code) | same | same |
+
+`init`'s Tier 2 detects your platform and either offers an auto-install (macOS+Homebrew) or prints the exact command for your package manager — so you don't need to know the table above by heart. If you're on Linux/Windows, install + re-run `init` once.
+
+## Pricing
+
+**₹149 INR / $3 USD** one-time on [devini.io/reelstack](https://devini.io/reelstack) — region-detected at checkout. See [devini.io/reelstack](https://devini.io/reelstack) for the live regional quote and the full docs at [devini.io/reelstack/docs](https://devini.io/reelstack/docs). Includes:
+
+- All 5 families, all 22 presets in v1.0.
+- All future v1.x preset additions for free.
+- Single end-user license. (Team/agency tier coming in v1.1.)
+
+## License
+
+ReelStack is **commercial software** licensed under the terms in [LICENSE](LICENSE). You may render unlimited content for yourself or clients with a valid license; you may not redistribute, repackage, or resell ReelStack itself.
+
+---
+
+Made by [Devini Labs](https://github.com/devinilabs). Same hands that shipped GraphifyReel, HereticReel, JustDropReel, OpusReel, ClaudeWatchReel, NotebookLMReel, HuashuReel, and 15 more — now boxed into a skill.
+
+---
+
+## Acknowledgments
+
+ReelStack v1.1+ stands on the shoulders of two outside skills:
+
+- **[leonxlnx/taste-skill](https://github.com/leonxlnx/taste-skill)** (MIT) — UI design-discipline rules. ReelStack bakes the master + per-family variant overlays directly into its components, palettes, and lint. Every scaffolded reel inherits the discipline by default.
+- **[alchaincyf/huashu-design](https://github.com/alchaincyf/huashu-design)** (Personal Use Only — pattern inspiration only, no code/text copied) — productivity-UX patterns adapted to Remotion: Design Direction Advisor, 5-dim critique, multi-format render with BGM. The Warm Signature family's `huashu` preset is named for `@AlchainHust`'s project.
+
+Full citation map at [`docs/design-discipline.md`](docs/design-discipline.md).

package/cli/beats.js

@@ -0,0 +1,124 @@
+/**
+ * `reelstack beats <vo.wav>` — converts a voiceover into BEAT constants by
+ * running ffmpeg + whisper-cli and parsing the resulting SRT.
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+const { spawnSync } = require("node:child_process");
+const { info, success, fail, warn, c, which, loadState } = require("./utils");
+
+const FPS = 30;
+
+function parseSrt(srtPath) {
+  const raw = fs.readFileSync(srtPath, "utf8");
+  const blocks = raw.split(/\r?\n\r?\n/).map((b) => b.trim()).filter(Boolean);
+  return blocks
+    .map((block) => {
+      const lines = block.split(/\r?\n/);
+      // line 0 = index, line 1 = "00:00:01,000 --> 00:00:02,400"
+      const tm = lines[1] && lines[1].match(
+        /(\d{2}):(\d{2}):(\d{2})[,.](\d{3})\s+-->\s+(\d{2}):(\d{2}):(\d{2})[,.](\d{3})/,
+      );
+      if (!tm) return null;
+      const start =
+        Number(tm[1]) * 3600 + Number(tm[2]) * 60 + Number(tm[3]) + Number(tm[4]) / 1000;
+      const text = lines.slice(2).join(" ").trim();
+      return { startSec: start, text };
+    })
+    .filter(Boolean);
+}
+
+function slugifyBeatKey(text) {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9 ]+/g, "")
+    .trim()
+    .split(/\s+/)
+    .slice(0, 3)
+    .join("_") || "beat";
+}
+
+async function run(argv) {
+  const voPath = argv.find((a) => !a.startsWith("--"));
+  if (!voPath) {
+    fail("Usage: reelstack beats <path/to/voiceover.wav>");
+    process.exit(2);
+  }
+  if (!fs.existsSync(voPath)) {
+    fail(`File not found: ${voPath}`);
+    process.exit(2);
+  }
+  const state = loadState();
+  if (state.whisperCli === "missing") {
+    fail("whisper-cli is not installed (init flagged this).");
+    console.log("  Install it now:");
+    console.log("    brew install whisper-cpp     # macOS");
+    console.log("  Then re-run: reelstack init");
+    process.exit(1);
+  }
+
+  if (!which("ffmpeg")) {
+    fail("ffmpeg not found. Install: brew install ffmpeg");
+    process.exit(2);
+  }
+  const whisperBin = which("whisper-cli") || which("whisper-cpp");
+  if (!whisperBin) {
+    fail("whisper-cli not found. Install: brew install whisper-cpp");
+    process.exit(2);
+  }
+
+  const tmpWav = path.join(os.tmpdir(), `reelstack_${process.pid}_v16k.wav`);
+  const tmpOut = path.join(os.tmpdir(), `reelstack_${process.pid}_out`);
+  const modelPath = process.env.WHISPER_MODEL || path.join(os.tmpdir(), "ggml-base.en.bin");
+  if (!fs.existsSync(modelPath)) {
+    warn(`Whisper model not found at ${modelPath}.`);
+    info(`Download: curl -L -o "${modelPath}" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin`);
+    process.exit(2);
+  }
+
+  info("Resampling voiceover to 16kHz mono PCM…");
+  spawnSync("ffmpeg", [
+    "-y", "-i", voPath, "-ar", "16000", "-ac", "1", "-c:a", "pcm_s16le", tmpWav,
+  ], { stdio: ["ignore", "ignore", "inherit"] });
+
+  info("Running whisper-cli…");
+  spawnSync(whisperBin, [
+    "-m", modelPath, "-f", tmpWav, "--output-srt", "-of", tmpOut,
+  ], { stdio: ["ignore", "ignore", "inherit"] });
+
+  const srtPath = `${tmpOut}.srt`;
+  if (!fs.existsSync(srtPath)) {
+    fail(`whisper-cli did not produce ${srtPath}.`);
+    process.exit(2);
+  }
+
+  const segments = parseSrt(srtPath);
+  if (segments.length === 0) {
+    fail("No segments parsed from SRT.");
+    process.exit(2);
+  }
+
+  console.log("");
+  console.log(c.bold("BEAT constants (paste into your reel):"));
+  console.log("");
+  console.log("const BEATS = {");
+  const seenKeys = new Set();
+  for (const seg of segments) {
+    let key = slugifyBeatKey(seg.text);
+    let i = 1;
+    while (seenKeys.has(key)) { key = `${slugifyBeatKey(seg.text)}_${i++}`; }
+    seenKeys.add(key);
+    const frame = Math.round(seg.startSec * FPS);
+    const comment = seg.text.length > 64 ? seg.text.slice(0, 64) + "…" : seg.text;
+    console.log(`  ${key.padEnd(28)} ${frame.toString().padStart(5)},  // ${seg.startSec.toFixed(2)}s — "${comment}"`);
+  }
+  console.log("} as const;");
+  console.log("");
+  warn("whisper base.en mishears tech jargon (Claude → Cloud, Remotion → Re-motion).");
+  warn("Use these timings frame-for-frame, but copy ON-SCREEN text from your script.");
+  console.log("");
+  success(`Parsed ${segments.length} segments → ${segments.length} BEAT constants.`);
+}
+
+module.exports = { run };

package/cli/bootstrap.js

@@ -0,0 +1,124 @@
+/**
+ * Tier 3: detect Remotion project state, prompt for bootstrap, run create-video.
+ *
+ * Only the pure helpers (`detectCwdState`, `buildCreateVideoArgs`) are unit-tested.
+ * The full `run()` function shells out and is exercised manually + via init-flow test.
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+const { info, success, fail, warn, c, askYesNo } = require("./utils");
+
+const PKG_NAME = require("../package.json").name;
+
+function detectCwdState(cwd) {
+  const pkgPath = path.join(cwd, "package.json");
+  if (!fs.existsSync(pkgPath)) return "no-package-json";
+
+  let pkg;
+  try {
+    pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  } catch {
+    return "corrupt-package-json";
+  }
+
+  const hasRemotion =
+    (pkg.dependencies && pkg.dependencies.remotion) ||
+    (pkg.devDependencies && pkg.devDependencies.remotion);
+
+  return hasRemotion ? "has-remotion" : "non-remotion-package";
+}
+
+function buildCreateVideoArgs(projectName) {
+  return ["create-video@latest", "--yes", "--blank", projectName];
+}
+
+function ensureReelstackDep(projectDir) {
+  const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
+  const already =
+    (pkg.dependencies && pkg.dependencies[PKG_NAME]) ||
+    (pkg.devDependencies && pkg.devDependencies[PKG_NAME]);
+
+  if (already) {
+    success(`${PKG_NAME} already present.`);
+    return true;
+  }
+
+  info(`Installing ${PKG_NAME}…`);
+  const result = spawnSync("npm", ["install", PKG_NAME], {
+    stdio: "inherit",
+    cwd: projectDir,
+  });
+  if (result.status !== 0) {
+    fail(`npm install ${PKG_NAME} failed.`);
+    return false;
+  }
+  success(`${PKG_NAME} installed.`);
+  return true;
+}
+
+/**
+ * Run Tier 3. Returns { projectDir, isNew } or exits process on
+ * unrecoverable failure. `skipped: true` when buyer declines bootstrap or
+ * --no-bootstrap was passed.
+ */
+async function run({ noBootstrap = false, projectName = "reelstack-project" } = {}) {
+  const cwd = process.cwd();
+  const state = detectCwdState(cwd);
+
+  if (state === "has-remotion") {
+    info("Remotion project detected in current directory.");
+    if (!ensureReelstackDep(cwd)) process.exit(1);
+    return { projectDir: cwd, isNew: false, skipped: false };
+  }
+
+  if (state === "corrupt-package-json") {
+    fail("Found a package.json in this folder, but it doesn't parse as valid JSON.");
+    console.log(c.gray("  Fix the file or run `reelstack init` from a different directory."));
+    process.exit(1);
+  }
+
+  if (noBootstrap) {
+    warn("No Remotion project here; --no-bootstrap was passed.");
+    console.log(c.gray("  Re-run `reelstack init` from inside a Remotion project to wire up imports."));
+    return { projectDir: null, isNew: false, skipped: true };
+  }
+
+  if (state === "non-remotion-package") {
+    warn("This folder has a non-Remotion package.json.");
+    info("Bootstrapping Remotion in a subdirectory instead so we don't muddy your project.");
+  }
+
+  console.log("");
+  const yes = await askYesNo(`Scaffold a Remotion project at ./${projectName}/?`);
+  if (!yes) {
+    warn("Skipped Remotion bootstrap.");
+    console.log(c.gray("  Re-run `reelstack init` from inside a Remotion project to wire up imports."));
+    return { projectDir: null, isNew: false, skipped: true };
+  }
+
+  const targetDir = path.join(cwd, projectName);
+  if (fs.existsSync(targetDir)) {
+    fail(`./${projectName}/ already exists. Choose a different name with --name=<dir>, or delete it first.`);
+    process.exit(1);
+  }
+
+  info(`Running: npx ${buildCreateVideoArgs(projectName).join(" ")}`);
+  const result = spawnSync("npx", buildCreateVideoArgs(projectName), {
+    stdio: "inherit",
+    cwd,
+  });
+  if (result.status !== 0) {
+    fail(`create-video did not exit cleanly (status ${result.status}).`);
+    console.log(c.gray("  Check your network connection, or try running manually:"));
+    console.log(c.gray(`    npx ${buildCreateVideoArgs(projectName).join(" ")}`));
+    process.exit(1);
+  }
+  success("Remotion project scaffolded.");
+
+  if (!ensureReelstackDep(targetDir)) process.exit(1);
+
+  return { projectDir: targetDir, isNew: true, skipped: false };
+}
+
+module.exports = { run, detectCwdState, buildCreateVideoArgs, ensureReelstackDep };

package/cli/capture.js

@@ -0,0 +1,34 @@
+/**
+ * `reelstack capture <url> [--scroll] [--name=<slug>]` — delegate to the
+ * user's `reel-capture` Claude Code skill via a stub instruction. The CLI
+ * does NOT directly drive Chrome; it prints the wiring instructions so the
+ * skill can run reel-capture in the same session.
+ */
+const path = require("node:path");
+const { info, warn, success, fail, c } = require("./utils");
+
+async function run(argv) {
+  const url = argv.find((a) => !a.startsWith("--"));
+  if (!url) {
+    fail("Usage: reelstack capture <url> [--scroll] [--name=<slug>]");
+    process.exit(2);
+  }
+  const slug = argv.find((a) => a.startsWith("--name="))?.replace("--name=", "")
+            || new URL(url).hostname.replace(/\W+/g, "-");
+  const scroll = argv.includes("--scroll");
+
+  info(`Delegating to reel-capture skill: ${url}`);
+  console.log("");
+  console.log(c.gray("In your Claude Code session, run:"));
+  console.log(`  ${c.cyan(`/reel-capture ${url}${scroll ? " --scroll" : ""}`)}`);
+  console.log("");
+  console.log(c.gray("Output will land in:"));
+  console.log(`  ${c.cyan(path.join(process.cwd(), "public", "captures", slug, scroll ? "frame_NNNN.png" : "hero.png"))}`);
+  console.log("");
+  console.log(c.gray("Then wire it into your reel:"));
+  console.log(`  ${c.cyan(`<Img src={staticFile("captures/${slug}/hero.png")} />`)}`);
+  console.log("");
+  warn("ReelStack does not auto-edit your reel — wiring is your call.");
+}
+
+module.exports = { run };

package/cli/direction.js

@@ -0,0 +1,114 @@
+/**
+ * `reelstack direction "<brief>"` — when a buyer's brief is vague, return 3
+ * differentiated family picks with reasoning.
+ *
+ * Inspired by alchaincyf/huashu-design's Design Direction Advisor pattern
+ * (no code copied; pattern only).
+ */
+const { c, info, success, fail } = require("./utils");
+
+const FAMILY_PROFILES = {
+  glass: {
+    label: "Glass Iridescent",
+    mood: "premium product reveal · underwater light · iridescent glass",
+    bestFor: ["product launch", "feature reveal", "SaaS announcement", "premium brand", "AI/ML demo"],
+    presets: ["graphify", "paperclip", "gstack", "lilagents", "jcode", "claudewatch"],
+  },
+  paper: {
+    label: "Cream Paper",
+    mood: "editorial print · warm document · card-stack hierarchy",
+    bestFor: ["thesis-driven narrative", "skill ecosystem reveal", "long-form storytelling", "design tool launch"],
+    presets: ["justdrop", "opus", "designreel", "devini3d"],
+  },
+  dark: {
+    label: "Dark Cinematic",
+    mood: "late-night ad-film · drifting spotlights · multi-brand partnership",
+    bestFor: ["partnership announcement", "integration reveal", "secret/insider drop", "dev-tool launch"],
+    presets: ["stitch", "stitch2", "codedrop", "claudedispatch", "notebooklm", "gpt55"],
+  },
+  warm: {
+    label: "Warm Signature",
+    mood: "confident product launch · single amber accent · bento grid",
+    bestFor: ["confident launch", "feature matrix reveal", "memory/learning narrative", "bento-style features"],
+    presets: ["huashu", "mempalace"],
+  },
+  forbidden: {
+    label: "Forbidden",
+    mood: "declassified document · cream-rose paper · ember/crimson/plasma",
+    bestFor: ["mysterious reveal", "unconventional tool", "open-source rebellion", "censorship-strip narrative"],
+    presets: ["heretic"],
+  },
+};
+
+const KEYWORD_MAP = {
+  glass:    ["product", "launch", "ai", "ml", "saas", "demo", "premium", "reveal", "feature", "ship"],
+  paper:    ["thesis", "essay", "skill", "ecosystem", "narrative", "design", "editorial", "story", "long"],
+  dark:     ["partnership", "integration", "secret", "insider", "cinematic", "drop", "tool", "dev", "code"],
+  warm:     ["confident", "matrix", "memory", "learning", "bento", "feature", "warm", "amber", "ship"],
+  forbidden:["mysterious", "declassified", "rebellion", "open source", "censorship", "alt", "uncommon"],
+};
+
+/**
+ * Score each family by counting matching keywords in the brief.
+ */
+function scoreFamilies(brief) {
+  const lc = brief.toLowerCase();
+  const scores = {};
+  for (const [family, keywords] of Object.entries(KEYWORD_MAP)) {
+    scores[family] = keywords.reduce((acc, kw) => acc + (lc.includes(kw) ? 1 : 0), 0);
+  }
+  return scores;
+}
+
+function pickTop3(scores) {
+  // Sort by score desc; on tie, sort alphabetically by family key for
+  // deterministic output (no Object.entries insertion-order surprises).
+  return Object.entries(scores)
+    .sort(([famA, a], [famB, b]) => (b - a) || famA.localeCompare(famB))
+    .slice(0, 3)
+    .map(([family, score]) => ({ family, score, profile: FAMILY_PROFILES[family] }));
+}
+
+/**
+ * Pure helper: scoreFamilies + pickTop3 + zero-score fallback. Returns the
+ * 3 picks the CLI's `direction` runtime would print, without touching stdout.
+ */
+function directionPicks(brief) {
+  const scores = scoreFamilies(brief);
+  const allZero = Object.values(scores).every((s) => s === 0);
+  if (allZero) {
+    return ["glass", "dark", "warm"].map((family) => ({
+      family,
+      score: 0,
+      profile: FAMILY_PROFILES[family],
+    }));
+  }
+  return pickTop3(scores);
+}
+
+async function run(argv) {
+  const brief = argv.filter((a) => !a.startsWith("--")).join(" ").trim();
+  if (!brief) {
+    fail("Usage: reelstack direction \"<brief>\"");
+    process.exit(2);
+  }
+
+  info(`Brief: "${brief}"`);
+  console.log("");
+
+  const top3 = directionPicks(brief);
+
+  console.log(c.bold("Three directions for your brief:"));
+  console.log("");
+  top3.forEach(({ family, profile }, i) => {
+    console.log(`  ${c.cyan(`${i + 1}.`)} ${c.bold(profile.label)} — ${c.gray(profile.mood)}`);
+    console.log(`     ${c.gray("best for:")} ${profile.bestFor.slice(0, 3).join(" · ")}`);
+    console.log(`     ${c.gray("presets:  ")} ${profile.presets.slice(0, 4).join(", ")}${profile.presets.length > 4 ? "…" : ""}`);
+    console.log(`     ${c.gray("trigger:  ")} /reelstack-${family}`);
+    console.log("");
+  });
+
+  console.log(c.gray("Pick one and run the matching slash command. Or pass `--family=<x>` to scaffold directly."));
+}
+
+module.exports = { run, scoreFamilies, pickTop3, directionPicks, FAMILY_PROFILES };