creator-editing-studio 1.3.7 → 1.4.0

package/bin/finish.mjs

@@ -0,0 +1,132 @@
+/**
+ * What an install or update does AFTER the files land — shared by init.mjs and update.mjs.
+ *
+ *   newestPublished()  the newest release on npm, so an update run with an old version number (an
+ *                      assistant reading a version from a chat opened before a release) runs the newest one
+ *   copyMedia()        the demo footage. It is binary, so it cannot travel with the text files (those are
+ *                      hashed as text and also built into the server); it ships in media/ and is copied
+ *                      in whenever it is missing or different. Nobody edits it, so there is nothing to merge.
+ *   finishSteps()      what is still missing on this machine, printed as a checklist the assistant acts on —
+ *                      one recommended choice for the person, not a line they have to notice.
+ */
+import {spawnSync} from 'node:child_process';
+import {copyFileSync, existsSync, mkdirSync, readdirSync, statSync} from 'node:fs';
+import {dirname, join, relative} from 'node:path';
+
+const newer = (a, b) => {
+  const pa = String(a).split('.').map(Number);
+  const pb = String(b).split('.').map(Number);
+  for (let i = 0; i < 3; i++) if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) > (pb[i] || 0);
+  return false;
+};
+
+/** The newest published version, or null when npm cannot be reached in a few seconds (then: carry on). */
+export async function newestPublished(current) {
+  try {
+    const r = await fetch('https://registry.npmjs.org/creator-editing-studio/latest', {signal: AbortSignal.timeout(6000)});
+    if (!r.ok) return null;
+    const {version} = await r.json();
+    return version && newer(version, current) ? version : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Run the same command with a newer release. Returns its exit code. */
+export function runNewer(version, args) {
+  const win = process.platform === 'win32';
+  const q = (s) => (win && /\s/.test(s) ? `"${s}"` : s);
+  const r = spawnSync(win ? 'npx.cmd' : 'npx', ['-y', `creator-editing-studio@${version}`, ...args].map(q), {
+    stdio: 'inherit',
+    shell: win,
+    env: {...process.env, CREATOR_STUDIO_NO_REDIRECT: '1'},
+  });
+  return r.status ?? 1;
+}
+
+const walk = (d) =>
+  existsSync(d)
+    ? readdirSync(d, {withFileTypes: true}).flatMap((e) => {
+        const p = join(d, e.name);
+        return e.isDirectory() ? walk(p) : [p];
+      })
+    : [];
+
+/** Copy the package's media/ into the studio (same relative paths). Returns the paths it copied. */
+export function copyMedia(pkg, studio, dry = false) {
+  const root = join(pkg, 'media');
+  const copied = [];
+  for (const file of walk(root)) {
+    const rel = relative(root, file).split('\\').join('/');
+    const to = join(studio, rel);
+    if (existsSync(to) && statSync(to).size === statSync(file).size) continue;
+    if (!dry) {
+      mkdirSync(dirname(to), {recursive: true});
+      copyFileSync(file, to);
+    }
+    copied.push(rel);
+  }
+  return copied;
+}
+
+/**
+ * The checklist printed after an update. Written for the assistant running the command — it is the one
+ * that acts on it — and it tells it to ask with a choice box, because a "want me to install it?" at the
+ * end of a paragraph is a question nobody answers.
+ */
+export function finishSteps(studio, version, {depsChanged}) {
+  const missing = [];
+  const venv = existsSync(join(studio, '.venv'));
+  if (depsChanged || !existsSync(join(studio, 'node_modules'))) missing.push('npm install');
+  if (!venv || !existsSync(join(studio, 'studio.config.json'))) missing.push('language and models');
+  const lines = [
+    '',
+    '================================================================================',
+    `FINISH SETTING UP ${version}  —  for the assistant that ran this command`,
+    '================================================================================',
+    '',
+  ];
+  if (missing.length) {
+    lines.push(
+      'Some of this release is not installed on this machine yet:',
+      ...missing.map((m) => `  - ${m}`),
+      '',
+      'ASK THE PERSON ONCE, WITH A CHOICE BOX (Claude Code: the AskUserQuestion tool; elsewhere a',
+      'numbered choice) — never as a sentence at the end of your summary:',
+      '',
+      `  Question: "Finish setting up the new version?"`,
+      '  1. Install now (Recommended) — the live preview, motion tracking and word-timed captions.',
+      '     One time, about 1 GB for English (3–5 GB for an Indian language), roughly 5–15 minutes.',
+      '  2. Later — the studio still works; these effects will not until it is done.',
+      '',
+      'If they choose Install now, do every step without asking again:',
+    );
+    if (missing.includes('npm install')) lines.push('  a. npm install');
+    if (missing.includes('language and models')) {
+      lines.push(
+        '  b. Ask, again as a choice box, what language their videos are in: English (Recommended),',
+        '     Hindi, Hinglish, Malayalam, Telugu (more: Tamil, Kannada, Marathi, Bengali — type it in "Other").',
+        `  c. ${venv ? '' : 'Create .venv with Python 3.11 or 3.12, then '}with the studio's Python: pip install -r requirements.txt`,
+        '     then: python scripts/setup_models.py --language <code>',
+      );
+    }
+  } else {
+    lines.push('Everything this release needs is already installed.', '');
+  }
+  lines.push(
+    '',
+    'THE LIVE PREVIEW — check `claude mcp list` (Codex: `codex mcp list`). If live-preview is not there:',
+    `  claude mcp add live-preview --scope user -- node "${join(studio, 'preview', 'server.mjs')}"`,
+    '  It appears from the NEXT chat. Tell them so in one plain sentence.',
+    '',
+    'THEN SHOW WHAT IS NEW — do not describe it in a list. Open the demo in the preview:',
+    '  preview_edit({video: "whats-new"})',
+    '  A 25-second clip, one new effect per beat, each named on screen. Tell them to try the buttons',
+    '  under each beat (Size, Move, Timing, Follow head) — it is a demo, nothing of theirs changes.',
+    '  If the preview only arrives next chat, say: "Open a new chat and type: show me what\'s new".',
+    '',
+    `FINALLY call editing_os_update({installed: "${version}"}) once, so the update is recorded.`,
+    '================================================================================',
+  );
+  return lines.join('\n');
+}

package/bin/init.mjs

@@ -65,12 +65,16 @@ for (const rel of files) {
   written.push(rel);
 }
 
+// The demo footage (binary, so it ships beside the template rather than in it).
+const {copyMedia} = await import('./finish.mjs');
+const media = copyMedia(resolve(HERE, '..'), target);
+
 const kb = (n) => `${Math.round(n / 1024)} KB`;
 const bytes = written.reduce((sum, rel) => sum + statSync(join(target, rel)).size, 0);
 
 console.log(`\nCreator Editing OS — studio files\n`);
 console.log(`  into   ${target}`);
-console.log(`  wrote  ${written.length} files (${kb(bytes)})`);
+console.log(`  wrote  ${written.length} files (${kb(bytes)})${media.length ? ` + ${media.length} demo footage file(s)` : ''}`);
 if (skipped.length) {
   console.log(`  kept   ${skipped.length} existing file(s) — nothing was overwritten`);
   console.log(`         (use --force to replace them)`);

package/bin/update.mjs

@@ -28,6 +28,7 @@ import {createHash} from 'node:crypto';
 import {copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync} from 'node:fs';
 import {dirname, join, relative, resolve} from 'node:path';
 import {fileURLToPath} from 'node:url';
+import {copyMedia, finishSteps, newestPublished, runNewer} from './finish.mjs';
 
 const HERE = dirname(fileURLToPath(import.meta.url));
 const PKG = resolve(HERE, '..');
@@ -39,6 +40,20 @@ const args = process.argv.slice(2).filter((a) => a !== 'update');
 const dry = args.includes('--dry-run');
 const studio = resolve(process.cwd(), args.find((a) => !a.startsWith('--')) || '.');
 
+/**
+ * Always the newest release. An assistant reads the version to ask for from its chat, and a chat opened
+ * before a release still remembers the old number — on 2026-10-19 a customer's Claude installed 1.3.6 and
+ * called it the latest after 1.3.7 had shipped. So whatever version was asked for, if npm has a newer one,
+ * that one runs instead. (CREATOR_STUDIO_NO_REDIRECT stops it asking twice.)
+ */
+if (!process.env.CREATOR_STUDIO_NO_REDIRECT) {
+  const newest = await newestPublished(LATEST);
+  if (newest) {
+    console.log(`This is ${LATEST}, but ${newest} is out — running ${newest} instead.\n`);
+    process.exit(runNewer(newest, ['update', studio, ...args.filter((a) => a.startsWith('--'))]));
+  }
+}
+
 /** Must match mcp/studio-hash.mjs exactly. */
 const sha = (body) => createHash('sha256').update(body.replace(/\r\n/g, '\n')).digest('hex').slice(0, 16);
 const read = (p) => readFileSync(p, 'utf8');
@@ -106,6 +121,7 @@ for (const p of shippedNow) {
   else result.merge.push(p);
 }
 
+const media = copyMedia(PKG, studio, dry);
 if (!dry) {
   for (const p of [...result.added, ...result.replaced]) {
     const to = join(studio, p);
@@ -143,4 +159,6 @@ if (result.merge.length) {
   );
 }
 const deps = [...result.added, ...result.replaced, ...result.merge].includes('package.json');
+list(dry ? 'Demo footage to add' : 'Demo footage added', media);
 console.log(`\nThen run: ${deps ? 'npm install && ' : ''}npm run check`);
+if (!dry) console.log(finishSteps(studio, LATEST, {depsChanged: deps}));