luckiest-co 1.0.46 → 1.0.47

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "luckiest",
       "source": "./",
       "description": "Plan, go, finish, plus bundled free Luckiest skills that work in Claude Code, web chat, and Cowork.",
-      "version": "0.1.45",
+      "version": "0.1.46",
       "author": { "name": "Luckiest" }
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "luckiest",
   "description": "Plan, go, finish. Guided planning, progress dashboards, and your luckiest.co tribe inside Claude Code.",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "author": { "name": "Luckiest" }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luckiest-co",
-  "version": "1.0.46",
+  "version": "1.0.47",
   "description": "Luckiest for Claude Code: plan, go, finish. Your luckiest.co skills and tribe, inside Claude.",
   "bin": {
     "luckiest-co": "./bin/install.js"

package/skills/video-studio/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog — luckiest-video-studio
 
+## 1.18.0 — 2026-10-13
+
+- New QA gate `node qa.mjs logo <run-dir> [--svg path] [--max 8]`: for every logo scene it takes the clip's last frame, finds the mark's box, draws the logo SVG (default `brand/logo.svg`) into the same box on the same background with HyperFrames, and fails when they differ. Enforces the "resolve frame equals the master logo" rule in the style cards' Logo construction sections.
+
 ## 1.17.3 — 2026-10-13
 
 - Logo construction on the `mosaic`, `pixel` and `flat-vector` style cards: mosaic lays stones along the mark's outline then fill and grout; pixel draws the mark into the low-res grid then steps up to the crisp SVG; flat-vector flies in the mark's own shapes with overshoot. Each resolves to the flat logo SVG (a visible difference is a Block).

package/skills/video-studio/SKILL.md

@@ -4,7 +4,7 @@ description: "Make product launch videos, product demos with motion design betwe
 license: See ATTRIBUTION.md
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
 metadata:
-  version: "1.17.3"
+  version: "1.18.0"
   listing_id: luckiest-video-studio
   author: luckiest
 ---
@@ -19,13 +19,13 @@ an MP4.
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.17.3" }`. If it returns
+`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.18.0" }`. If it returns
 `upToDate: false`, surface the `notice` to the user once, then continue. Do nothing
 further if `upToDate: true`. Never block on this check; if the tool is unavailable,
 proceed.
 
 When the skill's work is done, call the Luckiest MCP `report_usage` tool once with
-`{ listing_id: "luckiest-video-studio", skill_version: "1.17.3", matched: true, success: <true if the skill completed, false otherwise> }`.
+`{ listing_id: "luckiest-video-studio", skill_version: "1.18.0", matched: true, success: <true if the skill completed, false otherwise> }`.
 Metadata only, never prompt text. Never block on it; if the tool is unavailable,
 skip silently.
 
@@ -313,6 +313,7 @@ node <skill-dir>/scripts/qa.mjs avsync     <output-dir>/final.mp4 --expect <hero
 node <skill-dir>/scripts/qa.mjs facts      <output-dir>               # on-screen numbers not in storyboard facts, em dashes on screen
 node <skill-dir>/scripts/qa.mjs loop       <output-dir>/final.mp4     # only for looping pieces: last frame matches the first
 node <skill-dir>/scripts/qa.mjs safe       <output-dir>               # text or logo edges in each format's platform-covered margins
+node <skill-dir>/scripts/qa.mjs logo       <output-dir> [--svg <logo.svg>] # logo scenes: last frame vs the logo SVG in the same box (default brand/logo.svg)
 node <skill-dir>/scripts/qa.mjs endhold    <output-dir>/final.mp4     # end card held over 1.4 s, final shot over a quarter of the film
 node <skill-dir>/scripts/qa.mjs blankframes <output-dir>/final.mp4     # more than 3 frames of empty swatch in a row
 node <skill-dir>/scripts/qa.mjs hud        <output-dir>/composition   # HUD counters, timecodes, BPM/FPS, greetings, "label · $value"

package/skills/video-studio/scripts/qa.mjs

@@ -20,13 +20,15 @@
 //   node qa.mjs storyboard  <run-dir>                                  scene lengths, picture-only, text-led share, camera streaks, style id
 //   node qa.mjs facts       <run-dir>                                  on-screen numbers not in storyboard facts, em dashes on screen
 //   node qa.mjs safe        <run-dir> [--max 0.004] [--stills]         text or logo edges in the margins each format's platforms cover
+//   node qa.mjs logo        <run-dir> [--svg brand/logo.svg] [--max 8] last frame of each logo scene must match the logo SVG drawn in the same box
 //   node qa.mjs judge       <new.mp4> <old.mp4> [--out dir] [--cmd "claude -p --model sonnet"] [--verdicts A,B]
 //                           new vs old, asked twice with the order swapped; the new one is kept only if it wins both
 //
 // A gate that has never failed proves nothing: qa.test.mjs runs each one on a control
 // built to fail it.
 
-import { readFileSync, readdirSync, existsSync, statSync, mkdirSync, writeFileSync } from "node:fs";
+import { readFileSync, readdirSync, existsSync, statSync, mkdirSync, writeFileSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
 import { join, resolve, extname } from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
@@ -556,6 +558,65 @@ B: ${b}
 Open both images. Judge which reads better to a viewer: every card legible, the speaker's face never covered, visuals change with what is said, no empty or cluttered stretches, real evidence instead of filler, and motion that feels designed: elements arrive fast and settle instead of creeping in or popping from nothing, moves match each other in speed and easing, and nothing drifts while it is being read.
 Name the two biggest differences, then end with exactly one line: WINNER: A or WINNER: B`;
 
+// ---------- logo resolve ----------
+
+// The SVG drawn into `box` on a plain `bg` page at W x H, captured with HyperFrames (headless Chrome),
+// the same snapshot path render-scenes.mjs --stills uses. The mark is fitted by its own bounding box.
+export function rasterLogo({ svg, W, H, box, bg, out, version = "latest" }) {
+  const proj = mkdtempSync(join(tmpdir(), "qa-logo-"));
+  writeFileSync(join(proj, "index.html"), `<!doctype html><html><head><meta charset="UTF-8"><script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+<style>*{margin:0;padding:0}html,body{width:${W}px;height:${H}px;overflow:hidden;background:${bg}}#m{position:absolute;left:${box.x}px;top:${box.y}px;width:${box.w}px;height:${box.h}px}#m svg{width:100%;height:100%;display:block}</style></head>
+<body><div id="root" data-composition-id="main" data-start="0" data-duration="1" data-width="${W}" data-height="${H}"><div id="m" class="clip" data-start="0" data-duration="1" data-track-index="0">${readFileSync(svg, "utf8")}</div></div>
+<script>const s=document.querySelector("#m svg"),b=s.getBBox();s.setAttribute("viewBox",[b.x,b.y,b.width,b.height].join(" "));
+window.__timelines={main:gsap.timeline({paused:true}).to({},{duration:1})};</script></body></html>`);
+  const hf = spawnSync("hyperframes", ["--version"]).error ? ["npx", `hyperframes@${version}`] : ["hyperframes"];
+  const r = spawnSync(hf[0], [...hf.slice(1), "snapshot", proj, "--at", "0.5", "--no-end", "-o", join(proj, ".snap"), "--describe", "false"], { encoding: "utf8" });
+  const png = existsSync(join(proj, ".snap")) && readdirSync(join(proj, ".snap")).find((f) => f.startsWith("frame-"));
+  if (r.status !== 0 || !png) throw new Error(`logo snapshot failed: ${(r.stderr ?? "").trim().split("\n").pop()}`);
+  ff(["-v", "error", "-y", "-i", join(proj, ".snap", png), "-vf", `scale=${W}:${H}`, out]);
+  rmSync(proj, { recursive: true, force: true });
+  return out;
+}
+
+// Each logo scene's last frame against the logo SVG drawn at the same size and position.
+// The box is the ink that differs from the frame's corner color; any visible difference inside it is a Block.
+// ponytail: box from ink, so a caption beside the mark widens it and fails; add a scene logoBox override when a run needs it.
+export function logoResolve(runDir, { svg, max = 8, raster = rasterLogo, ink = 24 } = {}) {
+  const sb = JSON.parse(readFileSync(join(runDir, "storyboard.json"), "utf8"));
+  const logo = resolve(runDir, svg ?? sb.brand?.logo ?? "brand/logo.svg");
+  const targets = Array.isArray(sb.formats) ? sb.formats.map((f) => [f, ...FORMATS[f], join(runDir, "clips", f)]) : [[null, sb.format.width, sb.format.height, join(runDir, "clips")]];
+  const hits = [], tmp = mkdtempSync(join(tmpdir(), "qa-logo-"));
+  let checked = 0;
+  for (const [fmt, W, H, dir] of targets) {
+    const w = Math.round(W / 4), h = Math.round(H / 4);
+    sb.scenes.forEach((s, i) => {
+      if (s.kind !== "logo") return;
+      const name = `${String(i + 1).padStart(2, "0")}-${s.id}`, clip = join(dir, `${name}.mp4`), tag = { ...(fmt ? { format: fmt } : {}), scene: s.id };
+      if (!existsSync(clip)) return hits.push({ ...tag, missing: clip });
+      const last = join(tmp, `${fmt ?? "main"}-${name}.png`);
+      ff(["-v", "error", "-y", "-sseof", "-0.25", "-i", clip, "-update", "1", last]);
+      const [f] = grayFrames(last, w, h);
+      if (!f) return hits.push({ ...tag, missing: last });
+      let x0 = w, y0 = h, x1 = -1, y1 = -1;
+      for (let y = 0; y < h; y++) for (let x = 0; x < w; x++) {
+        if (Math.abs(f[y * w + x] - f[0]) > ink) { x0 = Math.min(x0, x); y0 = Math.min(y0, y); x1 = Math.max(x1, x); y1 = Math.max(y1, y); }
+      }
+      if (x1 < 0) return hits.push({ ...tag, blank: true });
+      const rgb = ff(["-v", "error", "-i", last, "-vf", "crop=1:1:0:0,format=rgb24", "-f", "rawvideo", "-"]).stdout;
+      const bg = `#${[...rgb.subarray(0, 3)].map((v) => v.toString(16).padStart(2, "0")).join("")}`;
+      const box = { x: x0 * 4, y: y0 * 4, w: (x1 - x0 + 1) * 4, h: (y1 - y0 + 1) * 4 };
+      const [ref] = grayFrames(raster({ svg: logo, W, H, box, bg, out: join(tmp, `${fmt ?? "main"}-${name}-ref.png`), version: sb.hyperframes }), w, h);
+      let sum = 0, n = 0;
+      for (let y = y0; y <= y1; y++) for (let x = x0; x <= x1; x++) { sum += Math.abs(f[y * w + x] - ref[y * w + x]); n++; }
+      const diff = Number((sum / n).toFixed(2));
+      checked++;
+      if (diff > max) hits.push({ ...tag, diff, box });
+    });
+  }
+  rmSync(tmp, { recursive: true, force: true });
+  return { ok: hits.length === 0, hits, checked, svg: logo };
+}
+
 // ---------- CLI ----------
 
 if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
@@ -563,7 +624,7 @@ if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.ur
   if (gate === "judge" && rest[0] && !rest[0].startsWith("--")) rest.unshift("--old", rest.shift());
   const opt = (n, d) => { const i = rest.indexOf(n); return i >= 0 ? rest[i + 1] : d; };
   const num = (n, d) => Number(opt(n, d));
-  if (!gate || !target) { console.error("Usage: qa.mjs <tokens|crossfade|motion|legibility|pops|deadframes|presence|beatsync|beatgrid|face|avsync|loop|endhold|blankframes|hud|facts|safe|judge> <path> [options]"); process.exit(1); }
+  if (!gate || !target) { console.error("Usage: qa.mjs <tokens|crossfade|motion|legibility|pops|deadframes|presence|beatsync|beatgrid|face|avsync|loop|endhold|blankframes|hud|facts|safe|logo|judge> <path> [options]"); process.exit(1); }
   let result;
   if (gate === "tokens") {
     const tokens = opt("--tokens") ? JSON.parse(readFileSync(opt("--tokens"), "utf8")) : DEFAULT_TOKENS;
@@ -607,6 +668,7 @@ if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.ur
   }
   else if (gate === "storyboard") result = lintStoryboard(JSON.parse(readFileSync(join(target, "storyboard.json"), "utf8")));
   else if (gate === "safe") result = safeAreas(target, { max: num("--max", 0.004), stills: rest.includes("--stills") });
+  else if (gate === "logo") result = logoResolve(target, { svg: opt("--svg"), max: num("--max", 8) });
   else if (gate === "facts") {
     const sb = JSON.parse(readFileSync(join(target, "storyboard.json"), "utf8"));
     const comp = join(target, "composition");

package/skills/video-studio/scripts/qa.test.mjs

@@ -10,7 +10,7 @@ import {
   scanTokens, scanCrossfades, scanMotion, legibility, findPops, deadFrames, presence,
   beatSync, findAnchor, cutTimes, beatGrid, grayFrames, probe,
   faceCover, pairVerdict, parseWinner, audioOnsets, avSync, visibleText, scanFacts, loopCheck,
-  fullFrameSelectors, safeAreas, endHold, blankRuns, scanHud, lintStoryboard,
+  fullFrameSelectors, safeAreas, endHold, blankRuns, scanHud, lintStoryboard, logoResolve,
 } from "./qa.mjs";
 
 const dir = mkdtempSync(join(tmpdir(), "qa-gates-"));
@@ -209,6 +209,34 @@ test("loop: last frame matching the first passes, a different end frame fails",
   assert.equal(cli("loop", ends).status, 1);
 });
 
+test("logo: a sting ending on the logo passes, one ending on a different shape fails", () => {
+  // A dark mark at 120,60 (80x60) on paper; the stand-in rasterizer draws the "logo" as that filled box.
+  const run = (name, end) => {
+    const r = join(dir, name);
+    mkdirSync(join(r, "clips"), { recursive: true });
+    const g = spawnSync("ffmpeg", ["-v", "error", "-y", "-f", "lavfi", "-i", "color=c=0xf3efe6:size=320x180:rate=30:duration=1",
+      "-vf", `drawbox=x=120:y=60:w=80:h=60:color=0x1a1a1a:t=${end},format=yuv420p`, "-c:v", "libx264", "-crf", "12", join(r, "clips", "01-sting.mp4")]);
+    assert.equal(g.status, 0, g.stderr?.toString());
+    writeFileSync(join(r, "storyboard.json"), JSON.stringify({ format: { width: 320, height: 180, fps: 30 }, scenes: [{ id: "sting", kind: "logo", duration: 1 }] }));
+    return r;
+  };
+  const raster = ({ W, H, box, bg, out }) => {
+    const g = spawnSync("ffmpeg", ["-v", "error", "-y", "-f", "lavfi", "-i", `color=c=${bg}:size=${W}x${H}`, "-vf", `drawbox=x=${box.x}:y=${box.y}:w=${box.w}:h=${box.h}:color=0x1a1a1a:t=fill`, "-frames:v", "1", out]);
+    assert.equal(g.status, 0, g.stderr?.toString());
+    return out;
+  };
+  const same = logoResolve(run("logo-same", "fill"), { raster });
+  assert.equal(same.ok, true, JSON.stringify(same));
+  assert.equal(same.checked, 1);
+  const off = logoResolve(run("logo-outline", 6), { raster });
+  assert.equal(off.ok, false);
+  assert.equal(off.hits[0].scene, "sting");
+  const missing = join(dir, "logo-missing");
+  mkdirSync(missing, { recursive: true });
+  writeFileSync(join(missing, "storyboard.json"), JSON.stringify({ format: { width: 320, height: 180, fps: 30 }, scenes: [{ id: "sting", kind: "logo", duration: 1 }] }));
+  assert.equal(cli("logo", missing).status, 1);
+});
+
 test("endhold: a 2 s static end card fails, a short resolved hold and a one-shot film pass", () => {
   const long = video("endhold-long.mp4", [["testsrc", 2], ["0x202020", 2]]);
   const r = endHold(long);