@haposoft/cafekit 0.11.8 → 0.11.10

package/bin/lib/skill-deps.js

@@ -13,11 +13,11 @@
 
 const fs = require('fs');
 const path = require('path');
-const { spawnSync } = require('child_process');
+const { spawnSync, spawn } = require('child_process');
 
 const isWindows = process.platform === 'win32';
 
-/** Run a command, return { ok, stdout, stderr, status }. Never throws. */
+/** Run a command synchronously, return { ok, stdout, stderr, status }. Never throws. */
 function run(cmd, args, opts = {}) {
   const r = spawnSync(cmd, args, { encoding: 'utf8', ...opts });
   return {
@@ -28,6 +28,31 @@ function run(cmd, args, opts = {}) {
   };
 }
 
+/**
+ * Run a command asynchronously — keeps the event loop alive so spinners can animate.
+ * Returns a Promise<{ ok, stdout, stderr, status }>. Never rejects.
+ */
+function runAsync(cmd, args, opts = {}) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: 'pipe', ...opts });
+    let stdout = '';
+    let stderr = '';
+    if (child.stdout) child.stdout.on('data', (d) => { stdout += d.toString(); });
+    if (child.stderr) child.stderr.on('data', (d) => { stderr += d.toString(); });
+    child.on('close', (code) => {
+      resolve({
+        ok: code === 0,
+        status: code,
+        stdout,
+        stderr
+      });
+    });
+    child.on('error', (err) => {
+      resolve({ ok: false, status: null, stdout, stderr: stderr || err.message });
+    });
+  });
+}
+
 /** Is a command available on PATH? */
 function hasCmd(name) {
   const probe = isWindows ? run('where', [name]) : run('which', [name]);
@@ -57,54 +82,59 @@ function venvValid(skillsDir) {
   return fs.existsSync(venvPython(skillsDir));
 }
 
-/** Create the venv (idempotent: skips if already valid). Returns true on success. */
-function createVenv(skillsDir, py) {
+/** Create the venv (idempotent: skips if already valid). Async — keeps spinner alive. */
+async function createVenv(skillsDir, py) {
   if (venvValid(skillsDir)) return true;
   fs.mkdirSync(skillsDir, { recursive: true });
-  return run(py, ['-m', 'venv', venvDir(skillsDir)]).ok;
+  const r = await runAsync(py, ['-m', 'venv', venvDir(skillsDir)]);
+  return r.ok;
 }
 
-/** Upgrade pip inside the venv (best-effort). */
-function pipUpgrade(skillsDir) {
-  return run(venvPython(skillsDir), ['-m', 'pip', 'install', '--upgrade', 'pip', '--prefer-binary']).ok;
+/** Upgrade pip inside the venv (best-effort). Async — keeps spinner alive. */
+async function pipUpgrade(skillsDir) {
+  const r = await runAsync(venvPython(skillsDir), ['-m', 'pip', 'install', '--upgrade', 'pip', '--prefer-binary']);
+  return r.ok;
 }
 
-/** Install or upgrade pip requirements in the venv. */
-function pipInstall(skillsDir, requirementsPath, upgrade = false) {
+/** Install or upgrade pip requirements in the venv. Async — keeps spinner alive. */
+async function pipInstall(skillsDir, requirementsPath, upgrade = false) {
   const args = ['-m', 'pip', 'install', '-r', requirementsPath, '--prefer-binary'];
   if (upgrade) args.push('--upgrade');
-  return run(venvPython(skillsDir), args).ok;
+  const r = await runAsync(venvPython(skillsDir), args);
+  return r.ok;
 }
 
-/** `npm install` (fresh) or `npm update` (existing) in a skill scripts dir. */
-function npmInstall(dir, upgrade = false, extraEnv = {}) {
+/** `npm install` (fresh) or `npm update` (existing) in a skill scripts dir. Async — keeps spinner alive. */
+async function npmInstall(dir, upgrade = false, extraEnv = {}) {
   const args = upgrade ? ['update', '--no-audit', '--no-fund'] : ['install', '--no-audit', '--no-fund'];
   const env = { ...process.env, ...extraEnv };
-  return run('npm', args, { cwd: dir, env }).ok;
+  const r = await runAsync('npm', args, { cwd: dir, env });
+  return r.ok;
 }
 
 /**
  * Download the Puppeteer Chromium browser for chrome-devtools.
  * Prefer puppeteer's own install script (cache-aware, same as its postinstall);
- * fall back to the bundled @puppeteer/browsers CLI. `npx puppeteer ...` is
- * avoided — puppeteer ships no `puppeteer` bin under that invocation and `--yes`
- * would refetch from the registry.
+ * fall back to the bundled @puppeteer/browsers CLI.
  *
- * When `interactive` is true, stdio is inherited so the native progress bar
- * renders directly on the user's terminal (TTY-only, no pipe capture).
+ * Non-interactive (default): async — keeps spinner alive during download.
+ * Interactive: sync with stdio inherit — native progress bar renders in TTY.
  */
-function installChromium(scriptsDir, interactive = false) {
-  const stdioOpt = interactive ? 'inherit' : 'pipe';
+async function installChromium(scriptsDir, interactive = false) {
   // Absolute path so it resolves regardless of the child process cwd.
   const installMjs = path.resolve(scriptsDir, 'node_modules', 'puppeteer', 'install.mjs');
   if (fs.existsSync(installMjs)) {
-    const opts = { cwd: scriptsDir, stdio: stdioOpt };
-    if (interactive) opts.encoding = 'utf8';
-    return run('node', [installMjs], opts).ok;
+    if (interactive) {
+      return run('node', [installMjs], { cwd: scriptsDir, stdio: 'inherit' }).ok;
+    }
+    const r = await runAsync('node', [installMjs], { cwd: scriptsDir });
+    return r.ok;
+  }
+  if (interactive) {
+    return run('npx', ['--yes', '@puppeteer/browsers', 'install', 'chrome'], { cwd: scriptsDir, stdio: 'inherit' }).ok;
   }
-  const opts = { cwd: scriptsDir, stdio: stdioOpt };
-  if (interactive) opts.encoding = 'utf8';
-  return run('npx', ['--yes', '@puppeteer/browsers', 'install', 'chrome'], opts).ok;
+  const r = await runAsync('npx', ['--yes', '@puppeteer/browsers', 'install', 'chrome'], { cwd: scriptsDir });
+  return r.ok;
 }
 
 /** Does a skill scripts dir declare a given npm dependency? */
@@ -117,9 +147,10 @@ function pkgHasDep(scriptsDir, name) {
   }
 }
 
-/** Download the Playwright Chromium browser (for the pptx html2pptx workflow). */
-function installPlaywrightBrowser(scriptsDir) {
-  return run('npx', ['--yes', 'playwright', 'install', 'chromium'], { cwd: scriptsDir }).ok;
+/** Download the Playwright Chromium browser (for the pptx html2pptx workflow). Async — keeps spinner alive. */
+async function installPlaywrightBrowser(scriptsDir) {
+  const r = await runAsync('npx', ['--yes', 'playwright', 'install', 'chromium'], { cwd: scriptsDir });
+  return r.ok;
 }
 
 /**

package/bin/phases/skills-setup.js

@@ -31,7 +31,7 @@ async function shouldRun(ctx) {
 }
 
 /** Provision or upgrade Python venv + pip requirements for a platform's skills. */
-function setupPython(ctx, skillsDir) {
+async function setupPython(ctx, skillsDir) {
   const reqs = dep.collectRequirements(skillsDir);
   if (reqs.length === 0) return;
 
@@ -43,19 +43,20 @@ function setupPython(ctx, skillsDir) {
 
   const alreadyExists = dep.venvValid(skillsDir);
   ctx.ui.startSpinner(ctx.t('venvCreating'));
-  if (!dep.createVenv(skillsDir, py)) {
+  const venvOk = await dep.createVenv(skillsDir, py);
+  if (!venvOk) {
     ctx.ui.stopSpinner(ctx.t('venvFailed'));
     ctx.ui.warn(ctx.t('venvFailed'));
     return;
   }
-  dep.pipUpgrade(skillsDir);
+  await dep.pipUpgrade(skillsDir);
   ctx.ui.stopSpinner(`${ctx.t('venvReady')} (${dep.venvDir(skillsDir)})`);
 
   // Upgrade packages if venv already existed (update run), install fresh otherwise.
   const upgrade = alreadyExists;
   for (const { skill, file } of reqs) {
     ctx.ui.startSpinner(ctx.t(upgrade ? 'pipInstalling' : 'pipInstalling', { skill }));
-    const ok = dep.pipInstall(skillsDir, file, upgrade);
+    const ok = await dep.pipInstall(skillsDir, file, upgrade);
     if (ok) {
       ctx.ui.stopSpinner(ctx.t('pipInstalled', { skill }));
     } else {
@@ -65,7 +66,7 @@ function setupPython(ctx, skillsDir) {
 }
 
 /** Run skill-local npm installs/upgrades + browser binaries for a platform's skills. */
-function setupNode(ctx, skillsDir) {
+async function setupNode(ctx, skillsDir) {
   // Detect system Chrome before npm install — skip ~300MB Chromium download if found
   const chromeScripts = path.join(skillsDir, 'chrome-devtools', 'scripts');
   const hasChromePkg = fs.existsSync(path.join(chromeScripts, 'package.json'));
@@ -78,7 +79,7 @@ function setupNode(ctx, skillsDir) {
     const extraEnv = (skill === 'chrome-devtools' && systemChrome)
       ? { PUPPETEER_SKIP_DOWNLOAD: 'true' }
       : {};
-    const ok = dep.npmInstall(dir, hasNodeModules, extraEnv);
+    const ok = await dep.npmInstall(dir, hasNodeModules, extraEnv);
 
     if (ok) {
       ctx.ui.stopSpinner(ctx.t('npmInstalled', { skill }));
@@ -90,7 +91,7 @@ function setupNode(ctx, skillsDir) {
     // Skills using Playwright (e.g. pptx) also need a browser binary.
     if (dep.pkgHasDep(dir, 'playwright')) {
       ctx.ui.startSpinner(ctx.t('playwrightInstalling', { skill }));
-      const pw = dep.installPlaywrightBrowser(dir);
+      const pw = await dep.installPlaywrightBrowser(dir);
       ctx.ui.stopSpinner(pw ? ctx.t('playwrightReady', { skill }) : ctx.t('playwrightSkipped', { skill }));
     }
   }
@@ -102,7 +103,7 @@ function setupNode(ctx, skillsDir) {
       ctx.ui.info(ctx.t('chromiumSystemChromeFound', { path: systemChrome }));
     } else {
       ctx.ui.info(ctx.t('chromiumInstalling'));
-      const ok = dep.installChromium(chromeScripts, true);
+      const ok = await dep.installChromium(chromeScripts, true);
       ctx.ui.info(ok ? '✓ ' + ctx.t('chromiumReady') : ctx.t('chromiumSkipped'));
     }
   }
@@ -127,8 +128,8 @@ async function setupSkillDeps(ctx) {
   }
 
   for (const key of ctx.platforms) {
-    setupPython(ctx, PLATFORMS[key].skillsDir);
-    setupNode(ctx, PLATFORMS[key].skillsDir);
+    await setupPython(ctx, PLATFORMS[key].skillsDir);
+    await setupNode(ctx, PLATFORMS[key].skillsDir);
   }
 
   guideManual(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haposoft/cafekit",
-  "version": "0.11.8",
+  "version": "0.11.10",
   "description": "Claude Code-first spec-driven workflow for AI coding assistants. Bundles CafeKit hapo: skills, runtime hooks, agents, and installer scaffolding.",
   "author": "Haposoft <nghialt@haposoft.com>",
   "license": "MIT",