@ignix-social/editor 0.1.14 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignix-social/editor",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Ignix Editor: render HTML video compositions (reels, edits, clips) on your own computer. Based on HyperFrames.",
   "license": "Apache-2.0",
   "type": "module",

package/skills/ignix-editor/SKILL.md

@@ -7,14 +7,14 @@ description: Build and render videos with Ignix Editor (HTML + GSAP compositions
 
 Ignix Editor turns an HTML page into an MP4. You write `index.html` (layout in HTML/CSS, motion in JS), the editor renders it frame by frame in a headless browser and encodes it with ffmpeg. The Ignix playbooks say WHAT to make; this skill says HOW to write it so that what you write is what renders.
 
-Commands (`npx @ignix-social/editor <cmd>` if `ignix-editor` is not on the PATH):
+Commands. `ignix-editor` means the copy the Ignix playbook installed: `~/.ignix-editor/cli/node_modules/.bin/ignix-editor` (Windows PowerShell: `& "$env:USERPROFILE\.ignix-editor\cli\node_modules\.bin\ignix-editor.cmd"`; PowerShell blocks `.ps1` scripts by default, so use the `.cmd` and `npm.cmd`, and `$env:USERPROFILE` instead of `~`). Do not use `npx`: it may fetch another version.
 
 | Command | What it does |
 |---|---|
 | `ignix-editor doctor` | Node 22+ and the H.264 encoder; downloads its own ffmpeg and whisper the first time. Run it first. |
 | `ignix-editor init <name>` | Creates `~/ignix-videos/<name>` with a working skeleton, GSAP, local fonts and `ignix-frame.js`. |
 | `ignix-editor transcribe <file> --lang es [--script "…"] -o words.json` | Words with start/end seconds, on this machine. |
-| `ignix-editor faces <video> -o work/faces.json` | Where the face is over time (macOS, Apple Vision): a smoothed path `{t, cx, cy, size}` (0–1, top-left origin) to frame the person. |
+| `ignix-editor faces <video> -o work/faces.json` | Where the face is over time (macOS and Windows; the first run downloads the face detector): a smoothed path `{t, cx, cy, size}` (0–1, top-left origin) to frame the person. |
 | `ignix-editor check [dir]` | HTML well-formed, no network assets, media rules, layout/contrast/motion audit. |
 | `ignix-editor snapshot [dir] --at 0,1.5,3` | PNG frames into `<dir>/snapshots/` to LOOK at. `[dir]` defaults to the current folder. |
 | `ignix-editor render [dir] [-o out.mp4]` | Renders to `<dir>/renders/<dir>.mp4`, audio normalised to −14 LUFS. |
@@ -147,4 +147,4 @@ Only if the app offers no way, give the user ONE line to paste into Terminal, e.
 
 1. `ignix-editor check` → 0 errors.
 2. `ignix-editor snapshot --at <every ~0.5 s and every cue>` and LOOK at the frames (or tile them: `ignix-editor ffmpeg -pattern_type glob -i 'snapshots/frame-*.png' -vf "scale=270:480,tile=8x2" sheet.jpg`). Check: hook readable at frame 0, nothing still for >1.5 s, every named thing pointed at on its word, captions never over what is pointed at, nothing outside the safe zone.
-3. `ignix-editor render` → it reviews the MP4 by itself and prints `✓ Review: ready to show` or `✗ Review: NOT READY` with what to fix and where (stretches where nothing on the stage moves, a mostly empty frame, silences between voice lines, no change of scene, no sound effects). NOT READY means it is not finished: fix every ✗, render again, and only then show it. The `!` lines are worth fixing too when it is quick. (`ignix-editor review <mp4>` runs the same check on any video.) Then open the MP4's first frame and a few cues again, and deliver as the playbook says.
+3. `ignix-editor render` → it reviews the MP4 by itself and prints `✓ Review: ready to show` or `✗ Review: NOT READY` with what to fix and where (stretches where nothing on the stage moves, a mostly empty frame, silences between voice lines, no change of scene). NOT READY means it is not finished: fix every ✗, render again, and only then show it. The `!` lines are worth fixing too when it is quick. (`ignix-editor review <mp4>` runs the same check on any video.) Then open the MP4's first frame and a few cues again, and deliver as the playbook says.

package/src/analysis/review.mjs

@@ -13,7 +13,7 @@ import { measureVideo } from './style.mjs';
 //              encenderse. Los subtítulos solos NO cuentan como movimiento.
 //   lleno    — qué parte de la zona segura ocupa algo distinto del fondo.
 //   huecos   — silencios entre frases de la voz.
-//   cortes y efectos — los de `style measure` (cambios de escena, efectos oídos).
+//   cortes — los de `style measure` (cambios de escena).
 
 const FPS = 10;
 /** Fracción de píxeles que tiene que cambiar entre dos fotogramas para contar como movimiento. */
@@ -212,10 +212,10 @@ export async function reviewVideo({ ffmpeg, ffprobe, path, log = () => {} }) {
   if (m?.shots?.cutsPerMinute === 0 && info.duration > 10) {
     issues.push({ level: 'warn', code: 'no_cuts', text: 'No real change of scene anywhere: it plays as one slow sequence of fades. Change scene with cuts or quick whips, and move a camera inside each scene.' });
   }
-  const sfx = m?.audio?.sound?.sfxPerMinute;
-  if (sfx === 0 && info.duration > 8 && !wide) {
-    issues.push({ level: 'warn', code: 'no_sfx', text: 'No sound effect is heard. A 20 s reel usually needs 4-8, on the moments that matter (hook, scene change, the key click or reveal, the CTA).' });
-  }
+  // Sin aviso de efectos de sonido (2026-10-07): bajo una voz continua no se
+  // distinguen. En un reel de Claude con 8 efectos dijo «no se oye ninguno»
+  // (estaban, a −18,6 dB en los huecos). Un aviso que falla en lo bueno enseña
+  // al agente a ignorar la revisión; los efectos siguen en el manual.
   return {
     path,
     durationSec: r1(info.duration),
@@ -225,7 +225,6 @@ export async function reviewVideo({ ffmpeg, ffprobe, path, log = () => {} }) {
       longestStillSec: r1(Math.max(0, ...stillRuns(steps, 0).map((s) => s.end - s.start))),
       fill: fill === null ? null : Math.round(fill * 100) / 100,
       textSize: m?.captions?.size ?? null,
-      sfxPerMinute: sfx ?? null,
       cutsPerMinute: m?.shots?.cutsPerMinute ?? null,
     },
     issues,

package/src/binaries.mjs

@@ -4,7 +4,7 @@
 // (descarga oficial de Google la primera vez).
 import { createHash } from 'node:crypto';
 import { chmodSync, createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
-import { Readable } from 'node:stream';
+import { Readable, Transform } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
@@ -75,9 +75,40 @@ export async function ensureWhisperModel(model = 'medium', log = () => {}) {
   if (existsSync(dest)) return dest;
   mkdirSync(dir, { recursive: true });
   log(`Downloading the ${model} transcription model (${(m.size / 1e9).toFixed(1)} GB, first time only)…`);
-  const res = await fetch(`https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${m.file}`);
-  if (!res.ok) throw new Error(`Could not download the ${model} model: ${res.status}`);
-  await pipeline(Readable.fromWeb(res.body), createWriteStream(`${dest}.part`));
+  // Con avance y con freno (2026-10-07): en las pruebas de Windows esta descarga tardó 52 min
+  // sin decir nada, y un agente que no ve avance cree que se ha colgado y la corta. Se avisa
+  // cada 10 % y, si en 2 min no llega ni un byte, se para con un error claro.
+  const ctrl = new AbortController();
+  const STALL_MS = 120_000;
+  let stall = setTimeout(() => ctrl.abort(), STALL_MS);
+  let got = 0;
+  let next = 10;
+  const progress = new Transform({
+    transform(chunk, _enc, cb) {
+      clearTimeout(stall);
+      stall = setTimeout(() => ctrl.abort(), STALL_MS);
+      got += chunk.length;
+      const pct = Math.floor((got / m.size) * 100);
+      if (pct >= next && pct < 100) {
+        log(`  ${pct} % (${Math.round(got / 1e6)} of ${Math.round(m.size / 1e6)} MB)`);
+        next = Math.floor(pct / 10) * 10 + 10;
+      }
+      cb(null, chunk);
+    },
+  });
+  try {
+    const res = await fetch(`https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${m.file}`, { signal: ctrl.signal });
+    if (!res.ok) throw new Error(`Could not download the ${model} model: ${res.status}`);
+    await pipeline(Readable.fromWeb(res.body), progress, createWriteStream(`${dest}.part`));
+  } catch (err) {
+    rmSync(`${dest}.part`, { force: true });
+    if (ctrl.signal.aborted) {
+      throw new Error(`The ${model} transcription model download stalled (no data for 2 minutes). Check the internet connection and run the command again; it starts over.`);
+    }
+    throw err;
+  } finally {
+    clearTimeout(stall);
+  }
   // El sha256 es el que publica Hugging Face para ese fichero (su oid de LFS).
   const h = createHash('sha256');
   await pipeline(createReadStream(`${dest}.part`), h);