alanbox 0.1.3 → 0.1.4

package/1swarmer/src/runner/AGENTS.md

@@ -16,6 +16,7 @@
 - 不要把个人 Antigravity cockpit 路径、全局 npm 安装路径或本机私有 home 写成通用默认配置。
 - `info` 输出可以展示 `<native>`、`<not inherited>`、command、commandArgs 这类排查信息，但不要打印 secret。
 - Windows `.cmd`、`.bat`、`.ps1`、PowerShell 路径和 Node `spawn` 参数需要实际考虑；provider 裸命令应通过 PATH/PATHEXT 解析后再启动，不要把用户本机 npm shim 绝对路径写进默认配置。
+- Windows 超时清理必须结束完整 provider 进程树；`codex.CMD` 可能继续派生 `node` 和 `codex.exe`，只杀父进程会导致 review-file 或 swarm 卡住。
 
 ### Verification
 

package/1swarmer/src/runner/codex-runner.js

@@ -213,6 +213,9 @@ function summarizePromptTransport(invocation) {
 
 function buildClaudePrintArgs(config, options) {
   const args = ['-p'];
+  if (Array.isArray(options.claudeArgs) && options.claudeArgs.length > 0) {
+    args.push(...options.claudeArgs);
+  }
   const model = options.model || config.defaultModel;
   if (model) {
     args.push('--model', model);
@@ -277,7 +280,7 @@ function runCodex(args, options = {}) {
     const timer = timeoutMs > 0
       ? setTimeout(() => {
           timedOut = true;
-          child.kill('SIGTERM');
+          killProcessTree(child.pid);
         }, timeoutMs)
       : null;
 
@@ -332,6 +335,24 @@ function writeStreamChunk(stream, text, prefix = '') {
   }
 }
 
+function killProcessTree(pid) {
+  if (!pid) return;
+  if (process.platform === 'win32') {
+    const killer = spawn('taskkill.exe', ['/pid', String(pid), '/t', '/f'], {
+      stdio: 'ignore',
+      windowsHide: true,
+    });
+    killer.on('error', () => {});
+    return;
+  }
+
+  try {
+    process.kill(pid, 'SIGTERM');
+  } catch {
+    // Process may already be gone.
+  }
+}
+
 async function execPrompt(prompt, options = {}) {
   if (!prompt || !prompt.trim()) {
     throw new Error('prompt is required');
@@ -513,7 +534,6 @@ module.exports = {
   buildLaunch,
   resolveCommandArgs,
   writeStreamChunk,
+  killProcessTree,
 };
 
-
-

package/2designer/README.md

@@ -5,6 +5,7 @@ Runtime UI measurement CLI for AI agents. The active command surface is intentio
 - `measure` — read element bbox, computed CSS, and optional child layout as JSON.
 - `screenshot` — capture a full page or selected element as PNG.
 - `overlay` — tint a design screenshot magenta and composite it over the runtime page.
+- `changelist` — output changed-region JSON and side-by-side comparison PNGs from design/runtime screenshots.
 
 The CLI is bundled through `alanbox` as both `designer` and `alanbox designer ...`.
 
@@ -14,6 +15,7 @@ The CLI is bundled through `alanbox` as both `designer` and `alanbox designer ..
 designer measure --url "http://localhost:3000" --selector ".dialog"
 designer screenshot --url "http://localhost:3000" --selector ".dialog" --output runtime.png
 designer overlay --design design.png --url "http://localhost:3000" --selector ".dialog" --output overlay.png
+designer changelist --design design.png --runtime runtime.png --output changes.json --annotated changes.png --regions-dir regions
 ```
 
 For Axure or iframe-based designs:
@@ -26,6 +28,7 @@ designer measure --url "http://127.0.0.1:32767/start.html" --frame "#mainFrame"
 
 - `src/` — active implementation.
 - `dist/` — built runtime shipped by `alanbox`.
+- `res/overlay/` — archived interactive overlay UI, not part of the active CLI.
 - `res/designer-main-legacy/` — archived old commands and references, not part of the active CLI.
 
 ## Development

package/2designer/dist/{cdp-engine-JK2XVDHK.js → cdp-engine-4AIWSWXO.js}

@@ -271,7 +271,7 @@ var CdpEngine = class _CdpEngine {
     return result.value;
   }
   async injectOverlay(params) {
-    const { tintDesignImage } = await import("./tint-I3FTT23O.js");
+    const { tintDesignImage } = await import("./tint-YN63MLVN.js");
     const tintedBuf = await tintDesignImage(params.designImagePath);
     const base64 = tintedBuf.toString("base64");
     const js = `
@@ -311,4 +311,4 @@ export {
   CdpEngine,
   buildClip
 };
-//# sourceMappingURL=cdp-engine-JK2XVDHK.js.map
+//# sourceMappingURL=cdp-engine-4AIWSWXO.js.map

package/2designer/dist/{cdp-engine-A5WTMTVF.js → cdp-engine-SG4K2BCX.js}

@@ -1,10 +1,10 @@
 import {
   CdpEngine,
   buildClip
-} from "./chunk-JVF26NXD.js";
+} from "./chunk-DPOWNFOH.js";
 import "./chunk-UVKSRKXR.js";
 export {
   CdpEngine,
   buildClip
 };
-//# sourceMappingURL=cdp-engine-A5WTMTVF.js.map
+//# sourceMappingURL=cdp-engine-SG4K2BCX.js.map

package/2designer/dist/{chunk-NQ3ASZUE.js → chunk-7X7PTLZH.js}

@@ -143,7 +143,7 @@ var PlaywrightEngine = class _PlaywrightEngine {
     return this.page.evaluate(expression);
   }
   async injectOverlay(params) {
-    const { tintDesignImage } = await import("./tint-RUSSUAWA.js");
+    const { tintDesignImage } = await import("./tint-UD4CJ7S2.js");
     const tintedBuf = await tintDesignImage(params.designImagePath);
     const base64 = tintedBuf.toString("base64");
     await this.page.evaluate(
@@ -182,4 +182,4 @@ var PlaywrightEngine = class _PlaywrightEngine {
 export {
   PlaywrightEngine
 };
-//# sourceMappingURL=chunk-NQ3ASZUE.js.map
+//# sourceMappingURL=chunk-7X7PTLZH.js.map

package/2designer/dist/{chunk-JVF26NXD.js → chunk-DPOWNFOH.js}

@@ -269,7 +269,7 @@ var CdpEngine = class _CdpEngine {
     return result.value;
   }
   async injectOverlay(params) {
-    const { tintDesignImage } = await import("./tint-RUSSUAWA.js");
+    const { tintDesignImage } = await import("./tint-UD4CJ7S2.js");
     const tintedBuf = await tintDesignImage(params.designImagePath);
     const base64 = tintedBuf.toString("base64");
     const js = `
@@ -310,4 +310,4 @@ export {
   buildClip,
   CdpEngine
 };
-//# sourceMappingURL=chunk-JVF26NXD.js.map
+//# sourceMappingURL=chunk-DPOWNFOH.js.map

package/2designer/dist/{chunk-SKEIVBOU.js → chunk-ISUUIOO7.js}

@@ -55,4 +55,4 @@ function tintGhost(pixels, info, opacity) {
 export {
   tintDesignImage
 };
-//# sourceMappingURL=chunk-SKEIVBOU.js.map
+//# sourceMappingURL=chunk-ISUUIOO7.js.map

package/2designer/dist/chunk-ISUUIOO7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/overlay/tint.ts"],"sourcesContent":["import sharp from 'sharp'\r\n\r\nexport type TintMode = 'magenta' | 'ghost' | 'difference'\r\n\r\n/**\n * 处理设计稿截图，生成适合叠到运行页上的 PNG 重影。\n *\n * 模式说明：\n * - 'magenta': 把非白色像素染成品红，适合白底或浅色背景的设计稿。\n * - 'ghost': 只统一降低透明度，适合背景不是纯白的截图。\n * - 'difference': 不预处理，由调用方使用 difference 混合模式。\n *\n * 返回带 alpha 通道的 PNG buffer。\n */\nexport async function tintDesignImage(\n  imagePath: string,\r\n  mode: TintMode = 'auto' as any,\r\n): Promise<Buffer> {\r\n  const { data, info } = await sharp(imagePath)\r\n    .ensureAlpha()\r\n    .raw()\r\n    .toBuffer({ resolveWithObject: true })\r\n\r\n  const pixels = new Uint8Array(data.buffer)\r\n\r\n  // 自动模式只粗略判断背景亮度：白底走品红染色，深色/复杂背景走 ghost。\n  const resolvedMode = mode === ('auto' as any) ? detectMode(pixels) : mode\n\r\n  if (resolvedMode === 'magenta') {\r\n    return tintMagenta(pixels, info)\r\n  }\n\n  if (resolvedMode === 'difference') {\n    // difference 模式需要保留原图颜色，混合策略交给调用方处理。\n    return sharp(imagePath).ensureAlpha().png().toBuffer()\n  }\n\n  // ghost 模式不改颜色，只统一压低 alpha，避免覆盖运行页细节。\n  return tintGhost(pixels, info, 0.4)\n}\n\nfunction detectMode(pixels: Uint8Array): TintMode {\n  // 采样前若干像素估算背景亮度；当前目标是快速区分浅底和非浅底，不做精确抠图。\n  let brightCount = 0\n  const sampleSize = Math.min(pixels.length / 4, 1000)\r\n  const step = Math.floor(pixels.length / 4 / sampleSize)\r\n\r\n  for (let i = 0; i < sampleSize; i++) {\r\n    const idx = i * step * 4\r\n    const brightness = (pixels[idx] + pixels[idx + 1] + pixels[idx + 2]) / 3\r\n    if (brightness > 220) brightCount++\r\n  }\r\n\r\n  return (brightCount / sampleSize) > 0.5 ? 'magenta' : 'ghost'\r\n}\r\n\r\nconst LIGHT_THRESHOLD = 230\nconst MAGENTA: [number, number, number] = [220, 40, 160]\n\r\nfunction tintMagenta(\r\n  pixels: Uint8Array,\r\n  info: { width: number; height: number },\r\n): Promise<Buffer> {\r\n  for (let i = 0; i < pixels.length; i += 4) {\n    const r = pixels[i], g = pixels[i + 1], b = pixels[i + 2]\n    const brightness = (r + g + b) / 3\n\n    if (brightness > LIGHT_THRESHOLD) {\n      // 浅色背景直接透明化，避免白底盖住运行页。\n      pixels[i + 3] = 0\n    } else {\n      // 像素越暗说明设计内容越明显，叠层 alpha 越高，便于观察 1-2px 偏差。\n      const darkness = 1 - brightness / 255\n      pixels[i] = MAGENTA[0]\n      pixels[i + 1] = MAGENTA[1]\r\n      pixels[i + 2] = MAGENTA[2]\r\n      pixels[i + 3] = Math.round(darkness * 200)\r\n    }\r\n  }\r\n\r\n  return sharp(Buffer.from(pixels.buffer), {\r\n    raw: { width: info.width, height: info.height, channels: 4 },\r\n  })\r\n    .png()\r\n    .toBuffer()\r\n}\r\n\r\nfunction tintGhost(\r\n  pixels: Uint8Array,\r\n  info: { width: number; height: number },\r\n  opacity: number,\r\n): Promise<Buffer> {\n  for (let i = 0; i < pixels.length; i += 4) {\n    // 仅缩放 alpha，保留原图色相，用于非白底设计稿的低侵入叠加。\n    pixels[i + 3] = Math.round(pixels[i + 3] * opacity)\n  }\n\r\n  return sharp(Buffer.from(pixels.buffer), {\r\n    raw: { width: info.width, height: info.height, channels: 4 },\r\n  })\r\n    .png()\r\n    .toBuffer()\r\n}\r\n"],"mappings":";AAAA,OAAO,WAAW;AAclB,eAAsB,gBACpB,WACA,OAAiB,QACA;AACjB,QAAM,EAAE,MAAM,KAAK,IAAI,MAAM,MAAM,SAAS,EACzC,YAAY,EACZ,IAAI,EACJ,SAAS,EAAE,mBAAmB,KAAK,CAAC;AAEvC,QAAM,SAAS,IAAI,WAAW,KAAK,MAAM;AAGzC,QAAM,eAAe,SAAU,SAAiB,WAAW,MAAM,IAAI;AAErE,MAAI,iBAAiB,WAAW;AAC9B,WAAO,YAAY,QAAQ,IAAI;AAAA,EACjC;AAEA,MAAI,iBAAiB,cAAc;AAEjC,WAAO,MAAM,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS;AAAA,EACvD;AAGA,SAAO,UAAU,QAAQ,MAAM,GAAG;AACpC;AAEA,SAAS,WAAW,QAA8B;AAEhD,MAAI,cAAc;AAClB,QAAM,aAAa,KAAK,IAAI,OAAO,SAAS,GAAG,GAAI;AACnD,QAAM,OAAO,KAAK,MAAM,OAAO,SAAS,IAAI,UAAU;AAEtD,WAAS,IAAI,GAAG,IAAI,YAAY,KAAK;AACnC,UAAM,MAAM,IAAI,OAAO;AACvB,UAAM,cAAc,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK;AACvE,QAAI,aAAa,IAAK;AAAA,EACxB;AAEA,SAAQ,cAAc,aAAc,MAAM,YAAY;AACxD;AAEA,IAAM,kBAAkB;AACxB,IAAM,UAAoC,CAAC,KAAK,IAAI,GAAG;AAEvD,SAAS,YACP,QACA,MACiB;AACjB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC;AACxD,UAAM,cAAc,IAAI,IAAI,KAAK;AAEjC,QAAI,aAAa,iBAAiB;AAEhC,aAAO,IAAI,CAAC,IAAI;AAAA,IAClB,OAAO;AAEL,YAAM,WAAW,IAAI,aAAa;AAClC,aAAO,CAAC,IAAI,QAAQ,CAAC;AACrB,aAAO,IAAI,CAAC,IAAI,QAAQ,CAAC;AACzB,aAAO,IAAI,CAAC,IAAI,QAAQ,CAAC;AACzB,aAAO,IAAI,CAAC,IAAI,KAAK,MAAM,WAAW,GAAG;AAAA,IAC3C;AAAA,EACF;AAEA,SAAO,MAAM,OAAO,KAAK,OAAO,MAAM,GAAG;AAAA,IACvC,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE;AAAA,EAC7D,CAAC,EACE,IAAI,EACJ,SAAS;AACd;AAEA,SAAS,UACP,QACA,MACA,SACiB;AACjB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AAEzC,WAAO,IAAI,CAAC,IAAI,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,OAAO;AAAA,EACpD;AAEA,SAAO,MAAM,OAAO,KAAK,OAAO,MAAM,GAAG;AAAA,IACvC,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE;AAAA,EAC7D,CAAC,EACE,IAAI,EACJ,SAAS;AACd;","names":[]}