@galda/cli 0.10.38 → 0.10.39

package/engine/shot.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// Manager for AI — the worker's camera.
+//
+// One job: take a URL or a local HTML file and write a PNG, in headless Chrome,
+// without ever coming to the front. It is handed to the worker (see SHOT_CLI in
+// lib.mjs) so that a request like "3案見せて" can come back as pictures of the
+// thing that was actually built.
+//
+// It decides nothing. It does not know what a UI change is, does not pick what
+// to shoot, and is never invoked by the Manager on the worker's behalf — the
+// agent that did the work aims the camera. Staging the photo ourselves is the
+// bug this replaces, not a feature to re-add here.
+//
+//   node engine/shot.mjs <url|file> <out.png> [--width N] [--height N]
+//                        [--full] [--wait MS] [--wait-for SELECTOR]
+//
+// Exit 0 prints the absolute path written; any failure exits 1 with one line
+// the worker can act on (a half-written PNG is worse than a clear error).
+
+import { existsSync, mkdirSync, statSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { parseShotArgs, shotTargetUrl, pickChromePath } from './lib.mjs';
+
+const require = createRequire(import.meta.url);
+
+function die(msg) {
+  console.error(`shot: ${msg}`);
+  process.exit(1);
+}
+
+const opt = parseShotArgs(process.argv.slice(2));
+if (opt.error) die(opt.error);
+
+// A local target that does not exist is the common typo, and Chrome would
+// happily screenshot its own "file not found" page — a picture of nothing.
+if (!/^(https?|file):\/\//i.test(opt.target) && !existsSync(resolve(process.cwd(), opt.target))) {
+  die(`no such file: ${opt.target}`);
+}
+
+const url = shotTargetUrl(opt.target, (p) => resolve(process.cwd(), p));
+const out = resolve(process.cwd(), opt.out);
+const chrome = pickChromePath(process.env, existsSync);
+if (!chrome) die('Chrome not found — install Google Chrome or set CHROME_PATH to the binary');
+
+let puppeteer;
+try {
+  puppeteer = require('puppeteer-core');
+} catch {
+  die('puppeteer-core is not installed next to the Manager — run npm install in the Manager directory');
+}
+
+mkdirSync(dirname(out), { recursive: true });
+
+// Failures inside the block below are recorded, not exited on: process.exit()
+// skips `finally`, and that would leave a headless Chrome running on the user's
+// machine for every mistyped selector.
+let browser, failure = null;
+try {
+  browser = await puppeteer.launch({
+    executablePath: chrome,
+    // headless: no window exists, so it cannot steal focus from the human whose
+    // machine this is running on (a standing rule for every browser we launch).
+    headless: 'new',
+    args: ['--no-sandbox', '--hide-scrollbars', '--force-color-profile=srgb'],
+    defaultViewport: { width: opt.width, height: opt.height, deviceScaleFactor: 2 },
+  });
+  const page = await browser.newPage();
+  // domcontentloaded, not networkidle: a live page that polls never settles, and
+  // a screenshot that times out is a picture nobody gets (see the same trap in
+  // the verification core).
+  await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+  if (opt.waitFor) {
+    try {
+      await page.waitForSelector(opt.waitFor, { timeout: 15000 });
+    } catch {
+      throw new Error(`--wait-for never matched: ${opt.waitFor}`);
+    }
+  }
+  if (opt.wait) await new Promise((r) => setTimeout(r, opt.wait));
+  await page.screenshot({ path: out, fullPage: opt.full });
+} catch (e) {
+  failure = String(e?.message ?? e).split('\n')[0];
+} finally {
+  // disconnect + kill rather than close(): close() has hung for minutes on this
+  // transport, and a camera that never returns blocks the whole task.
+  try {
+    const proc = browser?.process?.();
+    await browser?.disconnect?.();
+    proc?.kill('SIGKILL');
+  } catch { /* the browser is already gone — nothing to clean up */ }
+}
+
+if (failure) die(failure);
+if (!existsSync(out) || statSync(out).size === 0) die('no image was written');
+console.log(out);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galda/cli",
-  "version": "0.10.38",
+  "version": "0.10.39",
   "type": "module",
   "description": "Galda - hand off work to Claude Code or Codex, get proof back. Runs on your existing subscription, no extra API cost.",
   "scripts": {