alanbox 0.1.2 → 0.1.3

package/2designer/dist/tint-I3FTT23O.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/**\r\n * Process a design image for overlay compositing.\r\n *\r\n * Modes:\r\n * - 'magenta': Tint non-white pixels magenta (best for white/light backgrounds)\r\n * - 'ghost': Reduce opacity uniformly (works on any background color)\r\n * - 'difference': No preprocessing — caller should use 'difference' blend mode\r\n *\r\n * Returns a PNG buffer with alpha channel.\r\n */\r\nexport async function tintDesignImage(\r\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  // Auto-detect: check if background is white/light\r\n  const resolvedMode = mode === ('auto' as any) ? detectMode(pixels) : mode\r\n\r\n  if (resolvedMode === 'magenta') {\r\n    return tintMagenta(pixels, info)\r\n  }\r\n\r\n  if (resolvedMode === 'difference') {\r\n    // Return as-is for difference blend\r\n    return sharp(imagePath).ensureAlpha().png().toBuffer()\r\n  }\r\n\r\n  // ghost mode: uniform opacity reduction\r\n  return tintGhost(pixels, info, 0.4)\r\n}\r\n\r\nfunction detectMode(pixels: Uint8Array): TintMode {\r\n  // Sample corners + edges to detect background color\r\n  // If most sampled pixels are bright (>220), use magenta mode\r\n  // Otherwise use ghost mode\r\n  let brightCount = 0\r\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\r\nconst MAGENTA: [number, number, number] = [220, 40, 160]\r\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) {\r\n    const r = pixels[i], g = pixels[i + 1], b = pixels[i + 2]\r\n    const brightness = (r + g + b) / 3\r\n\r\n    if (brightness > LIGHT_THRESHOLD) {\r\n      pixels[i + 3] = 0\r\n    } else {\r\n      const darkness = 1 - brightness / 255\r\n      pixels[i] = MAGENTA[0]\r\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> {\r\n  for (let i = 0; i < pixels.length; i += 4) {\r\n    pixels[i + 3] = Math.round(pixels[i + 3] * opacity)\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"],"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;AAIhD,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;AAChC,aAAO,IAAI,CAAC,IAAI;AAAA,IAClB,OAAO;AACL,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;AACzC,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":[]}

package/2designer/dist/tint-RUSSUAWA.js

@@ -0,0 +1,7 @@
+import {
+  tintDesignImage
+} from "./chunk-SKEIVBOU.js";
+export {
+  tintDesignImage
+};
+//# sourceMappingURL=tint-RUSSUAWA.js.map

package/2designer/dist/tint-RUSSUAWA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/2designer/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "designer",
+  "version": "0.1.0",
+  "description": "Runtime UI measurement CLI for AI agents.",
+  "type": "module",
+  "bin": {
+    "designer": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "design",
+    "verification",
+    "css",
+    "figma",
+    "overlay",
+    "ai"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Fzhiyu1/designer.git"
+  },
+  "packageManager": "pnpm@10.28.2",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "sharp": "^0.34.5",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@types/ws": "^8.18.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.4"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.59.1"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "sharp"
+    ]
+  }
+}

package/README.md

@@ -1,8 +1,8 @@
 # alanbox
 
-`alanbox` is a local worker orchestration CLI for running isolated Codex or Claude child workers.
+`alanbox` is a local AI-tool command package. It routes package resource commands to `0boxer`, worker orchestration to `1swarmer`, and runtime UI measurement to `2designer`.
 
-The current stable workflow is `swam` / `swarm` from `0commondflowv1`.
+The stable worker workflow is still `swarmer` / `swarm` from `1swarmer`.
 
 ## Install
 
@@ -13,21 +13,24 @@ npm install -g alanbox
 ## Commands
 
 ```powershell
-alanbox info
+swarmer info
 alanbox doctor
 alanbox init
 alanbox update
 alanbox install --target codex
 alanbox install --target claude
 alanbox install --target both
-swam --namespace run-name --worker "codex:reviewer:检查当前改动"
-swam --namespace run-name --worker "claude:reviewer:检查当前改动"
+alanbox designer measure --url "http://localhost:3000" --selector ".dialog"
+designer screenshot --url "http://localhost:3000" --output page.png
+swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+swarmer --namespace run-name --worker "claude:reviewer:检查当前改动"
 ```
 
-`alanbox init` and `alanbox update` prompt you to choose Codex, Claude, or both. The package also exposes `swam` as a direct bin, so worker runs do not need the `alanbox` prefix. `multirunagent` remains available as a compatibility bin name.
+`alanbox init` and `alanbox update` prompt you to choose Codex, Claude, or both. The package also exposes `swarmer` and `designer` as direct bins, so those flows do not need the `alanbox` prefix.
 
 ## Notes
 
 - `init`, `update`, and `install` explicitly copy bundled skills, hooks, scripts, and MCP resource placeholders to Codex and/or Claude homes.
-- `1uiflowv1` measure and `2apiflowv1` getapi are not exposed by this npm package yet.
-- `swam` is a compatibility alias for `swarm`.
+- `cli.js` is the package-level command router. Keep package resource command parsing inside `0boxer/src/cli.js`, worker parsing inside `1swarmer/src/cli.js`, and UI parsing inside `2designer/dist/cli.js`.
+- `aibox/skills` is the package-level skill installation source. It can include `2designer` workflow guidance. `designer` is now bundled as a direct bin and as `alanbox designer ...`. `3apiflower` getapi is not exposed by this npm package yet.
+- `swarmer` is a compatibility alias for `swarm`.

package/bin/alanbox.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+/**
+ * alanbox package command entry.
+ * Keep bin launchers thin and route command handling to package-level cli.js.
+ */
+
+require('../cli').main().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = 1;
+});

package/bin/designer.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+/**
+ * Direct designer bin bundled through alanbox.
+ */
+
+require('../cli').runDesigner().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = error.exitCode || 1;
+});

package/bin/swarmer.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+/**
+ * Direct swarmer bin.
+ * Keep it mapped to 1swarmer swarm behavior.
+ */
+
+require('../cli').runSwarmer().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = error.exitCode || 1;
+});

package/cli.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+/**
+ * alanbox 包级命令路由器。
+ * 这里只判断进入哪个子流程；各子流程自己的参数解析留在各自实现里。
+ */
+
+const { existsSync } = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const BOXER_COMMANDS = new Set(['install', 'init', 'update']);
+const SWARMER_COMMANDS = new Set(['swarm', 'doctor']);
+const DESIGNER_COMMANDS = new Set(['designer']);
+
+async function main(argv = process.argv.slice(2)) {
+  const command = argv[0] && !argv[0].startsWith('-') ? argv[0] : '';
+
+  if (!command) {
+    if (argv.includes('-h') || argv.includes('--help')) {
+      printUsage();
+      return;
+    }
+
+    await runCommonFlow(argv);
+    return;
+  }
+
+  if (command === 'help') {
+    printUsage();
+    return;
+  }
+
+  if (command === 'swarmer') {
+    await runSwarmer(argv.slice(1));
+    return;
+  }
+
+  if (BOXER_COMMANDS.has(command)) {
+    await runBoxer(argv);
+    return;
+  }
+
+  if (SWARMER_COMMANDS.has(command)) {
+    await runSwarmerFlow(argv);
+    return;
+  }
+
+  if (DESIGNER_COMMANDS.has(command)) {
+    await runDesigner(argv.slice(1));
+    return;
+  }
+
+  throw new Error(`unknown alanbox command: ${command}`);
+}
+
+async function runSwarmer(argv = process.argv.slice(2)) {
+  if (argv[0] === 'info' || argv[0] === 'doctor') {
+    await runSwarmerFlow(argv);
+    return;
+  }
+
+  await runSwarmerFlow(['swarm', ...argv]);
+}
+
+async function runBoxer(argv) {
+  await require('./0boxer/src/cli').main(argv);
+}
+
+async function runSwarmerFlow(argv) {
+  await require('./1swarmer/src/cli').main(argv);
+}
+
+async function runCommonFlow(argv) {
+  await runSwarmerFlow(argv);
+}
+
+async function runDesigner(argv = process.argv.slice(2)) {
+  const cliPath = path.join(__dirname, '2designer', 'dist', 'cli.js');
+  if (!existsSync(cliPath)) {
+    throw new Error(
+      'designer dist/cli.js not found. Build it from 2designer before running this command.',
+    );
+  }
+
+  await runNodeCli(cliPath, argv);
+}
+
+function runNodeCli(cliPath, argv) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [cliPath, ...argv], {
+      stdio: 'inherit',
+      env: process.env,
+    });
+
+    child.on('error', reject);
+    child.on('exit', (code, signal) => {
+      if (signal) {
+        reject(new Error(`designer exited with signal ${signal}`));
+        return;
+      }
+
+      if (code && code !== 0) {
+        const error = new Error(`designer exited with code ${code}`);
+        error.exitCode = code;
+        reject(error);
+        return;
+      }
+
+      resolve();
+    });
+  });
+}
+
+function printUsage() {
+  console.log(`
+alanbox command router
+
+Usage:
+  alanbox doctor
+  alanbox install --target codex|claude|both
+  swarmer info
+  swarmer doctor
+  alanbox swarmer [options] --worker "codex:<role>:<prompt>"
+  alanbox swarm [options] --worker "codex:<role>:<prompt>"
+  swarmer [options] --worker "codex:<role>:<prompt>"
+  alanbox designer <command> [options]
+  designer <command> [options]
+
+Command groups:
+  install, init, update          0boxer package/resource commands
+  swarmer, swarm, doctor         1swarmer worker orchestration and provider diagnostics
+  swarmer info                   1swarmer worker execution config check
+  designer                       2designer runtime UI measurement CLI
+
+Examples:
+  swarmer info
+  swarmer doctor
+  swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+  alanbox designer measure --url http://localhost:3000 --selector ".dialog"
+  alanbox designer screenshot --url http://localhost:3000 --output page.png
+`);
+}
+
+module.exports = {
+  main,
+  printUsage,
+  runBoxer,
+  runCommonFlow,
+  runSwarmerFlow,
+  runSwarmer,
+  runDesigner,
+};

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Optional Codex hook examples for multirunagent. Keep disabled unless the local Codex hook schema is explicitly configured.",
+  "description": "Optional Codex hook examples for alanbox. Keep disabled unless the local Codex hook schema is explicitly configured.",
   "hooks": {
     "SessionStart": [
       {

package/package.json

@@ -1,16 +1,21 @@
 {
   "name": "alanbox",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Run isolated child Codex or Claude workers with serial, parallel, and auto swarm orchestration.",
-  "main": "0commondflowv1/src/cli.js",
+  "main": "cli.js",
   "bin": {
-    "alanbox": "bin/multirunagent.js",
-    "multirunagent": "bin/multirunagent.js",
-    "swam": "bin/multirunagent.js"
+    "alanbox": "bin/alanbox.js",
+    "swarmer": "bin/swarmer.js",
+    "designer": "bin/designer.js"
   },
   "files": [
+    "cli.js",
     "bin/**",
-    "0commondflowv1/**",
+    "shared/**",
+    "0boxer/**",
+    "1swarmer/**",
+    "2designer/package.json",
+    "2designer/dist/**",
     "skills/**",
     "plugin/**",
     "hooks/**",
@@ -20,10 +25,11 @@
     "LICENSE"
   ],
   "scripts": {
-    "swarm": "node bin/multirunagent.js swarm",
-    "doctor": "node bin/multirunagent.js doctor",
-    "test": "node bin/multirunagent.js --help && node bin/multirunagent.js info",
-    "validate": "node bin/multirunagent.js info"
+    "swarm": "node bin/swarmer.js",
+    "doctor": "node bin/alanbox.js doctor",
+    "designer": "node bin/designer.js",
+    "test": "node bin/alanbox.js --help && node bin/alanbox.js swarmer info && node bin/swarmer.js info && node bin/swarmer.js doctor --help && node bin/designer.js --help",
+    "validate": "node bin/swarmer.js info && node bin/designer.js --help"
   },
   "keywords": [
     "codex",
@@ -41,6 +47,13 @@
   },
   "engines": {
     "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "sharp": "^0.34.5",
+    "ws": "^8.20.0"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.59.1"
   }
 }
-

package/plugin/AGENTS.md

@@ -1,12 +1,12 @@
 ## alanbox plugin
 
-`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\plugin` 存放源码侧 Codex plugin manifest。安装时 `0commondflowv1/src/commands/install.js` 会把本目录复制到用户插件目录的 `plugins/alanbox/.codex-plugin/`，所以源码目录名是 `plugin/`，安装目标目录名才是 `.codex-plugin/`。
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\plugin` 存放源码侧 Codex plugin manifest。安装时 `0boxer/src/commands/install.js` 会把本目录复制到用户插件目录的 `plugins/alanbox/.codex-plugin/`，所以源码目录名是 `plugin/`，安装目标目录名才是 `.codex-plugin/`。
 
 **Important:** 这里是 Codex 插件展示与 skill 发现配置，不是 Claude 配置。Claude 侧只复用 `skills/`、`hooks/`、`scripts/`、`mcp/` 资源，不读取 `plugin.json`。
 
 ### Important files
 
-- `plugin.json` — Codex plugin manifest；`skills` 必须继续指向 `./skills/`，默认提示词应只描述当前真实入口 `swam`/`swarm`、`info`、`doctor`。
+- `plugin.json` — Codex plugin manifest；`skills` 必须继续指向 `./skills/`，默认提示词应只描述当前真实入口 `aitool`、`swarmer`/`swarm`、`info`、`doctor` 和 `designer`。
 
 ### Implementation notes
 

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "alanbox",
-  "version": "0.1.1",
-  "description": "Codex skills for using alanbox to run isolated Codex or Claude child workers.",
+  "version": "0.1.2",
+  "description": "Codex skills for using alanbox AI tools, swarmer worker orchestration, and designer UI measurement.",
   "author": {
     "name": "local"
   },
@@ -16,8 +16,8 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "alanbox",
-    "shortDescription": "Use alanbox swam/swarm to run child Codex or Claude workers.",
-    "longDescription": "Provides concise skills that explain how to call alanbox for swam/swarm, parallel worker scheduling, auto workflow, and doctor checks.",
+    "shortDescription": "Use alanbox for swarmer workers, diagnostics, and designer UI measurement.",
+    "longDescription": "Provides concise skills that explain how to choose alanbox tools, call swarmer/swarm for child workers, run parallel or auto workflows, diagnose with info/doctor, and use designer for UI measurement.",
     "developerName": "local",
     "category": "Productivity",
     "capabilities": [
@@ -25,9 +25,9 @@
       "Automation"
     ],
     "defaultPrompt": [
-      "Use alanbox swam to run one child Codex worker.",
-      "Use alanbox swam to run one child Claude worker.",
-      "Plan a serial swam workflow for this task."
+      "Choose the correct alanbox tool for this task.",
+      "Use swarmer to run child Codex or Claude workers.",
+      "Use designer to measure or compare runtime UI when needed."
     ]
   }
 }

package/shared/AGENTS.md

@@ -0,0 +1,15 @@
+## shared
+
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\shared` 存放 `alanbox` 包级共享工具。这里的代码可以被 `0boxer`、根 CLI 或其他流程复用，但必须保持轻量、无副作用，不应放具体业务流程的 runner、安装写入逻辑或 provider 调用。
+
+**Important:** 共享工具被发布包使用时，必须确认 `package.json.files` 包含 `shared/**`。不要把 `1swarmer` 的 worker/swarm 参数解析搬到这里，除非后续明确要做跨流程统一参数模型。
+
+### Important files
+
+- `package-args.js` — 包级资源命令参数解析器；当前服务 `0boxer` 的 `install/init/update`，只解析 target 相关选项。
+
+### Implementation notes
+
+- 共享模块不要在 require 时读写用户目录、启动 provider、读取个人配置或修改环境变量。
+- 新增共享工具时，优先让命名表达所属语义，例如 `package-*`、`path-*`，避免和 `1swarmer/src/args.js` 这种流程专属模块混淆。
+- 修改共享模块后，从包根目录运行 `npm test` 和 `npm run validate`；涉及发布包内容时再跑 `npm pack --json --dry-run`。

package/shared/package-args.js

@@ -0,0 +1,68 @@
+/**
+ * Package-resource command argument parser.
+ * This parser is intentionally separate from 1swarmer worker/swarm args.
+ */
+
+const VALUE_FLAGS = new Set(['target', 'to', 'platform']);
+const BOOLEAN_FLAGS = new Set(['codex', 'claude', 'both']);
+
+function parsePackageArgs(argv = []) {
+  const result = { _: [] };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+
+    if (arg === '--') {
+      result._.push(...argv.slice(i + 1));
+      break;
+    }
+
+    if (!arg.startsWith('-') || arg === '-') {
+      result._.push(arg);
+      continue;
+    }
+
+    const { key, inlineValue } = splitFlag(arg);
+
+    if (BOOLEAN_FLAGS.has(key)) {
+      if (inlineValue !== undefined) {
+        throw new Error(`${formatFlag(key)} does not take a value`);
+      }
+
+      result[key] = true;
+      continue;
+    }
+
+    if (VALUE_FLAGS.has(key)) {
+      const value = inlineValue !== undefined ? inlineValue : argv[i + 1];
+      if (inlineValue === undefined) i += 1;
+
+      if (!value || String(value).startsWith('-')) {
+        throw new Error(`missing value for ${formatFlag(key)}`);
+      }
+
+      result[key] = value;
+      continue;
+    }
+
+    throw new Error(`unknown package option: ${arg}`);
+  }
+
+  return result;
+}
+
+function splitFlag(arg) {
+  const [keyPart, inlineValue] = arg.split('=', 2);
+  return {
+    key: keyPart.replace(/^--?/, ''),
+    inlineValue,
+  };
+}
+
+function formatFlag(key) {
+  return `--${key}`;
+}
+
+module.exports = {
+  parsePackageArgs,
+};

package/skills/AGENTS.md

@@ -1,17 +1,21 @@
 ## aibox skills
 
-`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills。当前只描述 `0commondflowv1` 的 `swam`/`swarm`、`info` 和 `doctor` 用法；不要在这里接入 `1uiflowv1` 的 measure 或 `2apiflowv1` 的 getapi，除非用户重新明确要求。
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills，按 `0boxer` 的安装命令作为统一安装源。当前用 `swarmer` 承载 `1swarmer` 的 `swarmer`/`swarm`、`info` 用法，用 `aitool` 作为 alanbox 总入口说明，并保留用户明确要求接入的 `2designer` UI 高精度还原 workflow；不要在这里接入 `3apiflower` 的 getapi，除非用户重新明确要求。
 
-**Important:** skills 只写调用 workflow，不实现业务逻辑。worker 执行示例优先使用裸 `swam ...`；初始化和资源更新使用 `alanbox init` / `alanbox update`；本地源码调试才使用 `node bin/multirunagent.js ...`。
+**Important:** skills 只写调用 workflow，不实现业务逻辑。worker 执行示例优先使用裸 `swarmer ...`；初始化和资源更新使用 `alanbox init` / `alanbox update`；本地源码调试才使用 `node bin/alanbox.js ...`。
+
+**Important:** 本目录是 `alanbox install/init/update` 的安装源；`2designer` 不再维护 standalone skill 发布入口。`designer` 相关 agent workflow 以本目录 `desginer/SKILL.md` 为准。
 
 ### Important files
 
-- `aibox-swam/SKILL.md` — 通用 swam workflow skill；同时适用于 Codex 和 Claude，示例应覆盖 `codex:` 与 `claude:` worker。
-- `sub-codex-swarm/SKILL.md` — 兼容旧触发名的 swarm skill；保留但内容必须和当前 `swam`/`swarm` CLI 行为一致。
-- `sub-codex-doctor/SKILL.md` — 诊断 skill；只指导调用 `info` 和 `doctor`。
+- `aitool/SKILL.md` — `alanbox` 总入口 skill；用于在 `swarmer`、`designer` 和安装/更新命令之间选择正确入口。
+- `swarmer/SKILL.md` — 合并后的 worker 编排、配置检查与 provider 诊断 skill；同时覆盖 `codex:`、`claude:` worker、串行/并行/auto workflow、`info` 和 `doctor`。
+- `desginer/SKILL.md` — `2designer` 的 UI 高精度还原 workflow；目录名当前按现状保留，内容通过 `designer` 的 `measure` / `screenshot` / `overlay` 命令做设计稿网站与运行页的像素级对比。
 
 ### Implementation notes
 
 - 新增或修改 CLI 参数时，同步检查对应 `SKILL.md` 示例。
 - `install` 会把本目录中含 `SKILL.md` 的子目录安装到 Codex 的 `~/.codex/skills`，以及 Claude 的 `~/.claude/skill`。
+- `desginer` 调用的是 `designer` CLI；更新 `2designer` 的命令名、参数或产物路径约定时，同步更新本目录同名 skill。
+- `aibox-swarmer`、`sub-codex-swarmer`、`sub-codex-doctor` 已合并进 `swarmer`；安装/更新逻辑会清理这些旧 skill 名，避免用户环境里出现重复入口。
 - 不要把一次性本机 runId、账号、token、私有服务地址写进 skill。

package/skills/aitool/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: aitool
+description: 当需要使用 alanbox 这个本地 AI 工具包，并需要在 swarmer worker 编排、designer UI 测量或安装/更新资源之间选择正确入口时使用。
+---
+
+# aitool
+
+`alanbox` 是本机 AI 工具包的总入口。先判断任务属于哪一类，再调用对应 CLI 或 skill；不要把所有参数解析都塞到一个命令里。
+
+## 入口选择
+
+- 子 worker 编排、串行/并行复核、自动 workflow 和 `info` 配置检查：使用 `swarmer` skill 和 `swarmer` / `alanbox swarm` 命令。
+- provider 健康检查：使用 `alanbox doctor` 或 `swarmer doctor`，该命令归 `1swarmer`。
+- UI 高精度还原、运行页测量、截图、overlay 对比：使用 `designer` CLI；如果任务是按设计稿精修页面，优先使用当前安装的 UI 还原 skill。
+- 安装或更新 Codex/Claude 资源：使用 `alanbox init`、`alanbox update` 或 `alanbox install --target codex|claude|both`。
+- `3apiflower` API flow 当前不作为 `alanbox` npm 包公开命令；除非用户明确要求，不要把它接进 skills 或默认入口。
+
+## 常用命令
+
+```powershell
+alanbox --help
+swarmer info
+alanbox doctor
+alanbox install --target codex
+alanbox install --target claude
+swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+designer measure --url "http://localhost:3000" --selector ".dialog"
+designer screenshot --url "http://localhost:3000" --output page.png
+```
+
+## 维护边界
+
+- CLI 负责真实执行；skills 只负责指导调用。
+- `swarmer` 是 worker 编排稳定入口；内部 `swarm` 是同一条执行链路。
+- `designer` 只采集运行时 UI 数据和图片，不替 agent 做判断。
+- 安装命令会复制 bundled skills、hooks、scripts 和 MCP 占位资源；普通 `npm install` / `npx` 不应隐式注入用户 agent skills。