alanbox 0.1.2 → 0.1.3

package/0boxer/AGENTS.md

@@ -0,0 +1,25 @@
+## 0boxer
+
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\0boxer` 是 `alanbox` 的包级资源命令层，负责 aibox 自身资源安装、初始化和更新。`1swarmer` 负责 worker/swarm 执行和 provider 诊断；不要把 `init`、`update`、`install` 这类 aibox 资源命令写回 `1swarmer`。
+
+**Important:** `install`、`init`、`update` 会真实复制 Codex/Claude skills、hooks、mcp、scripts 和 Codex plugin manifest。修改或验证前确认目标目录，避免误写用户环境。
+
+### Important files
+
+- `src/cli.js` — 0boxer 命令分发器；当前只处理 `install`、`init`、`update`。
+- `../shared/package-args.js` — 包级资源命令参数解析器；只解析安装 target 相关选项，不依赖 `1swarmer/src/args.js`。
+- `src/commands/install.js` — 安装或更新 Codex/Claude 资源；Codex 额外维护 plugin manifest 和 marketplace entry。
+
+### Implementation notes
+
+- `init` 和 `update` 当前是 `install` 的别名，用来安装或刷新 bundled skills/hooks/mcp/scripts。
+- `--target codex|claude|both` 可跳过询问；未传 target 且在交互终端运行时会询问安装到 Codex、Claude 还是两者，非交互模式必须显式传 target。
+- `0boxer` 不复用 `1swarmer` 的参数解析；新增资源命令选项时维护 `../shared/package-args.js`，避免把 worker/swarm 参数带进包级安装命令。
+- 重命名或合并 skill 时，同步维护 `install.js` 的废弃 skill 清理名单，避免用户目录残留重复入口。
+- aibox 资源命令优先挂在 `0boxer/src/cli.js` 和根 `cli.js`；worker/provider 命令归 `1swarmer`。
+
+### Verification
+
+- 从包根目录运行：`npm test`
+- 轻量检查包级帮助：`node bin/alanbox.js init --help`
+- 安装命令需要真实复制资源：`node bin/alanbox.js install --target codex`、`--target claude` 或 `--target both`

package/0boxer/src/AGENTS.md

@@ -0,0 +1,16 @@
+## 0boxer src
+
+`0boxer/src` 是 `alanbox` 包级资源命令源码目录。这里维护 aibox 自身的资源安装、初始化和更新；worker 执行、provider 诊断、handoff、storage、runner 配置仍归 `1swarmer/src`。
+
+**Important:** 这里通过 `../../shared/package-args.js` 使用包级资源命令参数解析，不要依赖 `1swarmer` 的参数解析或 runner；provider 诊断命令归 `1swarmer`。
+
+### Important files
+
+- `cli.js` — 包级资源命令分发器；只处理 `install`、`init`、`update`。
+- `commands/install.js` — 复制 bundled resources 到 Codex/Claude 用户目录。
+
+### Implementation notes
+
+- 安装命令必须显式触发；不要让 `npm install`、`npx` 或普通 require 隐式写用户目录。
+- 不要从 `1swarmer/src/args.js` 引入 worker 参数解析；`0boxer` 只使用 `shared/package-args.js` 的包级资源命令选项集。
+- 新增 aibox 包级资源命令时，同步更新根 `cli.js`、README、skills 和 `0boxer/AGENTS.md`。

package/0boxer/src/cli.js

@@ -0,0 +1,53 @@
+/**
+ * aibox 包级命令分发器。
+ * 负责 install/init/update 资源安装更新。
+ */
+
+const { parsePackageArgs } = require('../../shared/package-args');
+const { runInstall } = require('./commands/install');
+
+async function main(argv = process.argv.slice(2)) {
+  if (argv.includes('-h') || argv.includes('--help') || argv[0] === 'help') {
+    printUsage();
+    return;
+  }
+
+  const command = argv[0] && !argv[0].startsWith('-') ? argv.shift() : '';
+  if (!command) {
+    printUsage();
+    return;
+  }
+
+  const args = parsePackageArgs(argv, command);
+  const context = { args };
+
+  if (command === 'install' || command === 'init' || command === 'update') {
+    await runInstall(context);
+    return;
+  }
+
+  throw new Error(`unknown aibox command: ${command}`);
+}
+
+function printUsage() {
+  console.log(`
+aibox package commands
+
+Usage:
+  alanbox install --target codex|claude|both
+  alanbox init
+  alanbox update
+
+Install options:
+  --target <target>          codex | claude | both. If omitted, install asks interactively.
+  --codex                    Install only Codex resources
+  --claude                   Install only Claude resources
+  --both                     Install Codex and Claude resources
+  init/update                Aliases of install; use them when you want an interactive target choice.
+`);
+}
+
+module.exports = {
+  main,
+  printUsage,
+};

package/0boxer/src/commands/AGENTS.md

@@ -0,0 +1,15 @@
+## 0boxer commands
+
+`0boxer/src/commands` 存放 `alanbox` 包级资源命令处理器。这里的命令面向 aibox 自身资源安装和更新，不直接执行 swarm worker，也不做 provider 诊断。
+
+**Important:** `install` 会写入用户 Codex/Claude 目录；新增验证命令时不要默认运行真实安装，除非用户明确要求或已确认目标。
+
+### Important files
+
+- `install.js` — 安装或更新 Codex/Claude skills、hooks、mcp、scripts；Codex 额外安装 plugin manifest 和 marketplace entry。
+
+### Implementation notes
+
+- `init`、`update` 通过 `0boxer/src/cli.js` 进入 `install.js`，语义是安装或刷新 aibox bundled resources。
+- 安装 target 必须是 `codex`、`claude` 或 `both`；非交互模式必须显式传 target。
+- 废弃 skill 名清理名单和 `skills/AGENTS.md` 要保持同步。

package/{0commondflowv1 → 0boxer}/src/commands/install.js

@@ -3,6 +3,7 @@ const path = require('path');
 const readline = require('readline');
 
 const INSTALL_TARGETS = new Set(['codex', 'claude', 'both']);
+const DEPRECATED_SKILL_NAMES = ['aibox-swarmer', 'sub-codex-doctor', 'sub-codex-swarmer'];
 
 async function runInstall(context = {}) {
   const packageRoot = path.resolve(__dirname, '..', '..', '..');
@@ -51,6 +52,7 @@ function installCodex({ home, packageRoot }) {
   replaceDir(packageScriptsRoot, path.join(pluginRoot, 'scripts'));
   replaceDir(packageMcpRoot, path.join(pluginRoot, 'mcp'));
   copyOptionalFile(path.join(packageRoot, 'README.md'), path.join(pluginRoot, 'README.md'));
+  pruneDeprecatedSkills(codexSkillsRoot);
   installSkills(packageSkillsRoot, codexSkillsRoot);
   installResourceDir(packageHooksRoot, path.join(codexHome, 'hooks', pluginName));
   installResourceDir(packageMcpRoot, path.join(codexHome, 'mcp', pluginName));
@@ -83,6 +85,7 @@ function installClaude({ home, packageRoot }) {
   replaceDir(packageScriptsRoot, path.join(pluginRoot, 'scripts'));
   replaceDir(packageMcpRoot, path.join(pluginRoot, 'mcp'));
   copyOptionalFile(path.join(packageRoot, 'README.md'), path.join(pluginRoot, 'README.md'));
+  pruneDeprecatedSkills(claudeSkillsRoot);
   installSkills(packageSkillsRoot, claudeSkillsRoot);
   installResourceDir(packageHooksRoot, path.join(claudeHome, 'hooks', pluginName));
   installResourceDir(packageMcpRoot, path.join(claudeHome, 'mcp', pluginName));
@@ -196,6 +199,12 @@ function installSkills(srcRoot, dstRoot) {
   }
 }
 
+function pruneDeprecatedSkills(dstRoot) {
+  for (const name of DEPRECATED_SKILL_NAMES) {
+    removeDir(path.join(dstRoot, name));
+  }
+}
+
 function removeDir(target) {
   if (!fs.existsSync(target)) return;
   fs.rmSync(target, { recursive: true, force: true });

package/{0commondflowv1 → 1swarmer}/AGENTS.md

@@ -1,21 +1,20 @@
-## 0commondflowv1
+## 1swarmer
 
-`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\0commondflowv1` 是 `alanbox` 当前主实现层，承接 CLI 命令、参数解析、Codex/Claude 子进程 runner、worker 编排、handoff、用户级 `.multirunagent` 存储、prompt 构造和 Codex/Claude 资源安装。根目录 `bin/multirunagent.js` 和 `index.js` 只负责转发到 `0commondflowv1/src/cli.js`。
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\1swarmer` 是 `alanbox` 的 worker flow 实现层，承接 `swarmer` / `swarm`、`doctor`、`info`、参数解析、Codex/Claude 子进程 runner、worker 编排、handoff、用户级 `.multirunagent` 存储和 prompt 构造。包根 `cli.js` 负责流程级路由，`bin/alanbox.js` 和 `bin/swarmer.js` 转发到包根 `cli.js`，再由包根转入本目录。
 
-**Important:** `0commondflowv1` 是当前稳定入口；npm 包名是 `alanbox`，CLI bin 暴露 `alanbox`、裸 `swam` 和兼容名 `multirunagent`。不要在没有迁移计划的情况下重命名用户级 `.multirunagent` 存储目录。
+**Important:** `1swarmer` 是 worker 编排和 provider 诊断稳定入口，不是包级资源安装入口。`install`、`init`、`update` 归 `0boxer`；新增 `2designer` / `3apiflower` 这类流程时挂到包根 `cli.js`，不要把非 worker flow 的参数解析塞进这里。
 
 **Important:** `src/runner/config.json` 默认 provider 是系统 `codex` CLI；Claude CLI 只能作为可选 provider/worker 配置启用。不要把个人 Antigravity cockpit 路径、全局 npm 安装路径或私有 home 写成通用默认配置。
 
 ### Important files
 
-- `src/cli.js` — 0commondflowv1 主命令分发器；加载配置、解析运行上下文，并路由到 `doctor`、`info`、`install/init/update`、`swarm`；`swam` 是 `swarm` 的兼容别名，也作为 npm 独立 bin 暴露。
+- `src/cli.js` — 1swarmer worker 命令分发器；加载配置、解析运行上下文，并路由到 `doctor`、`info`、`swarm`；`swarmer` 是 `swarm` 的兼容别名，也作为 npm 独立 bin 暴露。
 - `src/args.js` — CLI 参数解析器；新增 flag 或命令参数时优先在这里统一处理。
 - `src/commands/swarm/index.js` — `swarm` 命令入口与路由；`cli.js` 通过 `require('./commands/swarm')` 解析到此，`--auto` / `--resume` 委托 `swarm/auto.js`，否则走 `swarm/custom.js`。
 - `src/commands/swarm/custom.js` — 多 worker 编排主流程；负责 worker spec 执行。
 - `src/commands/swarm/auto.js` — auto workflow 状态机；负责 GOAP 推荐、确认门、pending/resume、执行、失败重规划。
-- `src/commands/doctor.js` — 子 Codex 环境和账号健康检查。
 - `src/commands/info.js` — 输出当前配置、worker 和命令信息。
-- `src/commands/install.js` — 显式安装 Codex/Claude skills、hooks、mcp、scripts；Codex 额外安装 plugin manifest 和 marketplace entry。
+- `src/commands/doctor.js` — swarm/provider 健康检查。
 - `src/runner/codex-runner.js` — Codex 子进程执行层；负责读取配置、设置 `CODEX_HOME`、spawn `codex exec/login/doctor`。
 - `src/runner/config.json` — 当前内置最小配置来源；默认只声明 `providers.codex`、可选 `providers.claude` 和 `timeoutMs`，不预设 worker/account，默认使用各 CLI 的原生 home 和登录态。
 - `src/core/workers.js` — worker spec 解析、分组并行阶段解析、worker 名称归一化和依赖层构建。
@@ -29,11 +28,12 @@
 
 ### Implementation notes
 
-- `swam`/`swarm` 是 worker 执行的唯一业务入口；单 worker 使用一个 `--worker`，需要全并行时使用 `swarm --parallel-workers`，需要混合串行/并行时用 `--worker "[spec1,spec2]"` 表示同一阶段并行。不要恢复独立 `exec` 或 `parallel` 命令。
+- `swarmer`/`swarm` 是 worker 执行的唯一业务入口；单 worker 使用一个 `--worker`，需要全并行时使用 `swarm --parallel-workers`，需要混合串行/并行时用 `--worker "[spec1,spec2]"` 表示同一阶段并行。不要恢复独立 `exec` 或 `parallel` 命令。
+- `1swarmer/src/cli.js` 只维护 worker/common 命令；包级命令组、`designer`、未来 `3apiflower` 入口应维护在 `aibox/cli.js` 和专用 `bin/*.js`。
 - CLI 的 `--worker` 输入和未来 workflow JSON 最终都应转换为统一 task 数组，再交给同一个执行器处理。
 - 调整参数解析时，同步检查 `src/cli.js` 的 usage 文案、README 命令示例和相关 skills。
-- 调整 worker/handoff/storage 协议时，同步检查根目录 `skills/aibox-swam` 和 `skills/sub-codex-*` 的说明，避免 skill 仍指导旧参数或旧输出格式。
-- `install`、`init`、`update` 都会安装或更新 agent 资源；`--target codex|claude|both` 可跳过询问，未传 target 时只在交互终端询问，非交互模式必须显式传 target，避免误写用户目录。
+- 调整 worker/handoff/storage 协议时，同步检查根目录 `skills/swarmer` 的说明，避免 skill 仍指导旧参数或旧输出格式。
+- `install`、`init`、`update` 都是 aibox 包级资源命令，归 `0boxer` 维护；不要在本目录重新接回这些命令。`doctor` 是 provider 诊断命令，归本目录。
 - `%USERPROFILE%\.multirunagent\<namespace>` 是运行结果和 handoff 的持久化位置；改写存储格式前要考虑旧 run 的读取兼容。项目内 `.sub-codex` 是旧位置，不应再作为默认输出目录。
 - scheduler、retry、resume、workflow JSON 等能力如果新增，应先复用现有 `swarm` 执行链路，再扩展状态机；当前 `swarm --auto` 已通过 `swarm/auto.js` + `swarm-executor.js` 复用普通 swarm 执行链路。
 - 默认不隔离 CLI home：不设置 `CODEX_HOME` / `CLAUDE_CONFIG_DIR`，让 Codex/Claude 使用原生登录态；只有显式配置 `accountsDir`、worker account 或 home 时才启用隔离。
@@ -45,7 +45,6 @@
 
 - 从包根目录运行烟雾检查：`npm test`
 - 从包根目录运行轻量验证：`npm run validate`
-- 直接查看信息：`node bin/multirunagent.js info`
-- 直接检查环境：`node bin/multirunagent.js doctor`
-- 检查安装参数解析：`node bin/multirunagent.js install --target codex` 或 `--target claude`（会真实复制资源，确认目标目录后再运行）
+- 直接查看信息：`node bin/swarmer.js info`
+- 直接检查 provider 环境：`node bin/alanbox.js doctor` 或 `node bin/swarmer.js doctor`
 - 注意：`--dry-run` 已移除，swarm/auto 不再有离线预览，运行即调用真实 provider；确认参数与命令构造请用 `info`。

package/{0commondflowv1 → 1swarmer}/src/AGENTS.md

@@ -1,12 +1,12 @@
-## 0commondflowv1 src
+## 1swarmer src
 
-`0commondflowv1/src` 是 `alanbox` 的当前主源码目录，负责 CLI 参数解析、命令分发、worker 编排、runner 执行、handoff、存储和 prompt 构造。入口由包根 `bin/multirunagent.js` / `index.js` 转发到 `cli.js`，npm 发布后同时暴露 `alanbox` 和兼容 bin `multirunagent`。
+`1swarmer/src` 是 `alanbox` 的 worker flow 源码目录，负责 `swarmer` / `swarm`、`doctor`、`info`、worker 编排、runner 执行、handoff、存储和 prompt 构造。入口由包根 `cli.js` 做流程级路由后进入这里，npm 发布后暴露 `alanbox`、裸 `swarmer` 和裸 `designer`。
 
-**Important:** 这里是 0commondflowv1 的稳定实现层。新增命令、flag、provider、worker 协议或存储行为时，要同步检查 `0commondflowv1/AGENTS.md`、README、skills 说明和 `alanbox info` / `--help` 输出；本地源码验证仍可用 `node bin/multirunagent.js ...`。
+**Important:** 这里是 1swarmer 的稳定实现层。新增命令、flag、provider、worker 协议或存储行为时，要同步检查 `1swarmer/AGENTS.md`、README、skills 说明和 `swarmer info` / `--help` 输出；本地源码验证使用 `node bin/alanbox.js ...` 或 `node bin/swarmer.js ...`。
 
 ### Important files
 
-- `cli.js` — CLI 主分发器；命令入口和 usage 文案在这里维护。
+- `cli.js` — 1swarmer worker CLI 分发器；`swarm`、`doctor`、`info` 的入口和 usage 文案在这里维护。aibox 包级 `install/init/update` 归 `0boxer`。
 - `args.js` — 通用参数解析；新增 flag 时优先在这里统一处理。
 - `commands/` — 具体 CLI 命令实现；`swarm` 拆分为 `commands/swarm/`（`index.js` 路由、`custom.js` 手动 worker、`auto.js` 推荐/确认/恢复流程），修改前先读 `commands/AGENTS.md`。
 - `core/` — worker、handoff、storage、prompt 构造等核心协议；修改前先读 `core/AGENTS.md`。
@@ -16,6 +16,7 @@
 ### Implementation notes
 
 - `swarm` 是 worker 执行的唯一业务入口；单 worker 使用一个 `--worker`，全并行多 worker 走 `swarm --parallel-workers`，混合串行/并行用 `--worker "[spec1,spec2]"` 表达同一阶段并行，不要复制出独立 `exec` 或 `parallel` 命令。
+- 包级流程路由不在本目录维护；`install/init/update` 归 `0boxer`，`designer` 和未来其他 flow 入口应挂在 `aibox/cli.js`，避免本文件重新变成所有流程混杂的总入口。
 - 默认使用原生 CLI 登录态；只有显式配置隔离 home 时才设置 `CODEX_HOME` 或 `CLAUDE_CONFIG_DIR`。
 - 多 worker 输出默认写入 `%USERPROFILE%\.multirunagent\<namespace>`，不要重新写回项目内 `.sub-codex`。
 - Windows 兼容是长期约束；路径拼接使用 Node `path`，命令文案和示例要考虑 PowerShell。
@@ -23,4 +24,4 @@
 ### Verification
 
 - 从包根目录运行：`npm run validate`
-- 直接检查配置与参数解析：`node bin/multirunagent.js info`
+- 直接检查配置与参数解析：`node bin/swarmer.js info`

package/{0commondflowv1 → 1swarmer}/src/args.js

@@ -1,5 +1,5 @@
 /**
- * multirunagent 的 CLI 参数解析器。
+ * alanbox common flow 的 CLI 参数解析器。
  * 统一处理 flag、位置 prompt 和多 worker 任务规格。
  */
 

package/{0commondflowv1 → 1swarmer}/src/cli.js

@@ -7,7 +7,6 @@ const { loadConfig } = require('./runner/codex-runner');
 const { parseArgs } = require('./args');
 const { runDoctor } = require('./commands/doctor');
 const { runInfo } = require('./commands/info');
-const { runInstall } = require('./commands/install');
 const { runSwarm } = require('./commands/swarm');
 
 async function main(argv = process.argv.slice(2)) {
@@ -17,9 +16,9 @@ async function main(argv = process.argv.slice(2)) {
   }
 
   let command = argv[0] && !argv[0].startsWith('-') ? argv.shift() : 'swarm';
-  if (command === 'swam') {
+  if (command === 'swarmer') {
     command = 'swarm';
-    console.error('[alanbox] `swam` 已按 `swarm` 兼容处理。');
+    console.error('[alanbox] `swarmer` 已按 `swarm` 兼容处理。');
   }
 
   if (command === 'help') {
@@ -46,11 +45,6 @@ async function main(argv = process.argv.slice(2)) {
     return;
   }
 
-  if (command === 'install' || command === 'init' || command === 'update') {
-    await runInstall(context);
-    return;
-  }
-
   if (command === 'swarm') {
     await runSwarm(context);
     return;
@@ -64,16 +58,13 @@ function printUsage() {
 alanbox CLI runner
 
 Usage:
-  node index.js info [--account 30428]
   node index.js doctor [--account 30428]
-  node index.js install [--target codex|claude|both]
-  node index.js init
-  node index.js update
+  node index.js info [--account 30428]
   node index.js swarm [options] --worker "codex:<role>:<prompt>" --worker "claude:<role>:<prompt>"
-  node index.js swam [options] --worker "codex:<role>:<prompt>"
+  node index.js swarmer [options] --worker "codex:<role>:<prompt>"
   node index.js swarm --worker "codex:a:先做 A" --worker "[codex:c:并行 C,codex:d:并行 D]" --worker "codex:e:最后汇总"
   node index.js swarm --auto "<goal>" -a "codex:reviewer:复核代码" -p "最好每个子文件夹一个子agent并行"
-  node index.js swam --auto "<goal>" -a "codex:reviewer:复核代码"
+  node index.js swarmer --auto "<goal>" -a "codex:reviewer:复核代码"
   node index.js swarm --resume <runId> --namespace <name> -y
 
 Options:
@@ -96,13 +87,6 @@ Options:
   --task <spec>              Backward-compatible alias for --worker in swarm mode
   --parallel-workers         Run swarm workers in parallel instead of dependency order
 
-Install options:
-  --target <target>          codex | claude | both. If omitted, install asks interactively.
-  --codex                    Install only Codex resources
-  --claude                   Install only Claude resources
-  --both                     Install Codex and Claude resources
-  init/update                Aliases of install; use them when you want an interactive target choice.
-
 Auto workflow options:
   --auto                     Let GOAP planner recommend workflow before execution
   --agent, -a <spec>         Repeatable auto agent spec. Example: codex:reviewer:复核 src 代码

package/{0commondflowv1 → 1swarmer}/src/commands/AGENTS.md

@@ -1,6 +1,6 @@
 ## commands
 
-`0commondflowv1/src/commands` 存放 `alanbox` 的具体 CLI 命令处理器。每个文件只负责一个命令的行为编排，底层 worker 解析、runner 执行、handoff 和 storage 应复用 `core/`、`runner/`、`prompt/`。
+`1swarmer/src/commands` 存放 `alanbox` 的 worker 和 provider 诊断命令处理器。每个文件只负责本 flow 相关命令的行为编排，底层 worker 解析、runner 执行、handoff 和 storage 应复用 `core/`、`runner/`、`prompt/`。
 
 **Important:** 新增或修改命令参数时，必须同步检查 `src/args.js`、`src/cli.js` usage 文案、README 和相关 skills，避免 CLI 行为和说明不一致。
 
@@ -9,21 +9,20 @@
 - `swarm/index.js` — `swarm` 命令入口与路由；`--auto` / `--resume` 委托 `swarm/auto.js`，否则走 `swarm/custom.js`。`cli.js` 通过 `require('./commands/swarm')` 解析到此目录。
 - `swarm/custom.js` — 多 worker 串行/依赖层编排；解析 worker specs 后复用共享 executor。
 - `swarm/auto.js` — `swarm --auto` 状态机；负责 GOAP workflow 推荐、确认门、pending/resume、执行和失败重规划。
-- `doctor.js` — 环境和 provider 健康检查；用于诊断 CLI 命令、home、认证和 dry-run。
 - `info.js` — 输出当前配置和运行信息；应避免泄露 secret 或本机敏感路径之外的无关细节。
-- `install.js` — 显式安装或更新 Codex/Claude skills、hooks、mcp 和 scripts；`install`、`init`、`update` 都会进入这里，Codex 额外维护 plugin manifest 与 marketplace。不要让普通包加载隐式安装资源。
+- `doctor.js` — provider 健康检查；用于诊断 CLI 命令、home、认证和运行环境。
 
 ### Implementation notes
 
 - `swarm` 的 runDir 应来自 `core/storage.js`，默认在 `%USERPROFILE%\.multirunagent\<namespace>`；auto workflow run 使用 `%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>`。
 - `swarm --auto` 中 `-a` 表示 repeatable agent spec、`-p` 表示 plan hint；非 auto 命令仍保持旧 account/profile 语义，文档和 usage 必须同步说明。
-- worker 执行统一通过 `swam`/`swarm` 开启；单 worker 使用一个 `--worker`，全并行多 worker 使用 `swarm --parallel-workers`，混合串行/并行用 `--worker "[spec1,spec2]"` 表达同一阶段并行。不要恢复独立 `exec` / `parallel` 命令或复制执行链路。
-- `install`、`init`、`update` 支持 `--target codex|claude|both`、`--codex`、`--claude`、`--both`；未传目标时只在交互终端询问，脚本/CI 中必须显式传目标。
-- `alanbox info` 输出解析后的 provider、command、env 和 worker 配置，是用户排查的重要依据；改动 provider、env、args 解析时要实际运行 `info` 检查（本地源码可用 `node bin/multirunagent.js info`，`--dry-run` 预览已移除）。
+- worker 执行统一通过 `swarmer`/`swarm` 开启；单 worker 使用一个 `--worker`，全并行多 worker 使用 `swarm --parallel-workers`，混合串行/并行用 `--worker "[spec1,spec2]"` 表达同一阶段并行。不要恢复独立 `exec` / `parallel` 命令或复制执行链路。
+- `install`、`init`、`update` 归 `0boxer/src/commands`；不要在本目录新增或恢复这些包级资源命令。
+- `swarmer info` 输出解析后的 provider、command、env 和 worker 配置，是用户排查的重要依据；改动 provider、env、args 解析时要实际运行 `info` 检查（本地源码可用 `node bin/swarmer.js info`，`--dry-run` 预览已移除）。
 
 ### Verification
 
 - 从包根目录运行：`npm run validate`
-- 修改命令参数或 provider/env 展示后：`node bin/multirunagent.js info`
+- 修改命令参数或 provider/env 展示后：`node bin/swarmer.js info`
+- 修改 provider 诊断后：`node bin/swarmer.js doctor`
 - 修改 auto workflow、planner 或模板后，需实际运行一次 `swarm --auto`（已无 dry-run/JSON 离线预览）验证。
-- 修改安装命令后额外检查：`node bin/multirunagent.js install --target codex`、`--target claude` 或 `--target both`（会真实复制资源，确认目标目录后再运行）。

package/{0commondflowv1 → 1swarmer}/src/commands/doctor.js

@@ -1,6 +1,6 @@
 /**
- * doctor 命令处理器。
- * 把环境和 Codex CLI 诊断委托给 0commondflowv1/src/runner/codex-runner。
+ * swarm doctor 命令处理器。
+ * 把环境和 provider 诊断委托给 1swarmer/src/runner/codex-runner。
  */
 
 const { doctor } = require('../runner/codex-runner');

package/{0commondflowv1 → 1swarmer}/src/core/AGENTS.md

@@ -1,6 +1,6 @@
 ## core
 
-`0commondflowv1/src/core` 存放 worker 编排协议、handoff 协议、prompt 构造和本地结果存储辅助函数，是 `swarm` 使用的核心逻辑。
+`1swarmer/src/core` 存放 worker 编排协议、handoff 协议、prompt 构造和本地结果存储辅助函数，是 `swarm` 使用的核心逻辑。
 
 **Important:** 这里的输出格式、prompt 协议和路径会被命令、skills、README 和用户历史 run 依赖。改协议或存储结构前，要考虑旧结果读取兼容，并同步更新说明文档。
 
@@ -10,7 +10,7 @@
 - `swarm-executor.js` — 普通 swarm 和 auto workflow 共用的 task graph 执行器；负责 runner 调用、结果写入和 handoff 汇总，`swarm --parallel-workers` 也走这里。
 - `workflow-planner.js` — 本地最小 GOAP planner；把自然语言目标、`-a` agent spec 和 `-p` plan hint 转成 phases/actions/dependencies。
 - `workflow-storage.js` — auto workflow 的 AgentDB-lite 文件存储；写入 run/plan/state/steps JSON，不替代旧 swarm results/memory。
-- `prompt-templates.js` — 从 `0commondflowv1/src/prompt/<role>.md` 读取 auto workflow role 模板并安全 fallback。
+- `prompt-templates.js` — 从 `1swarmer/src/prompt/<role>.md` 读取 auto workflow role 模板并安全 fallback。
 - `handoff.js` — 构造 prior results context，并解析 / 生成 `HANDOFF_JSON`。
 - `prompt-builder.js` — 构造 role、worker、platform、namespace、context、skill 和 task 的最终 prompt。
 - `storage.js` — 写入 worker markdown 输出和 memory JSON；默认根目录是 `%USERPROFILE%\.multirunagent`。

package/{0commondflowv1 → 1swarmer}/src/core/prompt-templates.js

@@ -1,6 +1,6 @@
 /**
  * Auto workflow prompt 模板辅助函数。
- * 模板位于 0commondflowv1/src/prompt/<role>.md，role 会先清洗，找不到时回退到 default.md 或内联模板。
+ * 模板位于 1swarmer/src/prompt/<role>.md，role 会先清洗，找不到时回退到 default.md 或内联模板。
  */
 
 const fs = require('fs');

package/{0commondflowv1 → 1swarmer}/src/core/storage.js

@@ -73,7 +73,7 @@ function updateMemoryIndex(memoryDir, entry) {
 function getUserStateRoot() {
   const homeDir = process.env.USERPROFILE || process.env.HOME;
   if (!homeDir) {
-    throw new Error('cannot resolve user home directory for multirunagent state');
+    throw new Error('cannot resolve user home directory for alanbox state');
   }
   return path.join(homeDir, '.multirunagent');
 }

package/{0commondflowv1 → 1swarmer}/src/prompt/AGENTS.md

@@ -1,6 +1,6 @@
 ## prompt
 
-`0commondflowv1/src/prompt` 存放随源码维护的可复用提示词模板
+`1swarmer/src/prompt` 存放随源码维护的可复用提示词模板
 
 ### Important files
 

package/{0commondflowv1 → 1swarmer}/src/prompt/default.md

@@ -1,6 +1,6 @@
 # Default Agent Prompt
 
-你是 multirunagent auto workflow 中的 {{role}} agent。
+你是 alanbox auto workflow 中的 {{role}} agent。
 
 ## 目标
 

package/{0commondflowv1 → 1swarmer}/src/prompt/synthesizer.md

@@ -1,6 +1,6 @@
 # Synthesizer Prompt
 
-你是 multirunagent auto workflow 的汇总 agent。
+你是 alanbox auto workflow 的汇总 agent。
 
 ## 总目标
 

package/{0commondflowv1 → 1swarmer}/src/prompt/verifier.md

@@ -1,6 +1,6 @@
 # Verifier Prompt
 
-你是 multirunagent auto workflow 的验证 agent。
+你是 alanbox auto workflow 的验证 agent。
 
 ## 总目标
 

package/{0commondflowv1 → 1swarmer}/src/runner/AGENTS.md

@@ -1,6 +1,6 @@
 ## runner
 
-`0commondflowv1/src/runner` 负责读取 provider 配置、解析 CLI 命令参数，并通过子进程启动 Codex 或 Claude。这里决定是否使用原生 CLI home，或在显式配置时启用隔离 home。
+`1swarmer/src/runner` 负责读取 provider 配置、解析 CLI 命令参数，并通过子进程启动 Codex 或 Claude。这里决定是否使用原生 CLI home，或在显式配置时启用隔离 home。
 
 **Important:** 默认必须使用原生 Codex / Claude CLI 登录态，不设置 `CODEX_HOME` 或 `CLAUDE_CONFIG_DIR`。只有显式配置 `accountsDir`、worker account 或 home 时才启用隔离。
 
@@ -19,6 +19,6 @@
 
 ### Verification
 
-- 从包根目录运行：`node bin/multirunagent.js doctor`
-- 检查默认 provider：`node bin/multirunagent.js info`
+- 从包根目录运行：`node bin/alanbox.js doctor` 或 `node bin/swarmer.js doctor`
+- 检查默认 provider：`node bin/swarmer.js info`
 - 注意：`--dry-run` 已移除，检查子 worker 命令构造请用 `info`（已无 swarm dry-run 预览）。

package/2designer/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhiyu Fang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/2designer/README.md

@@ -0,0 +1,39 @@
+# designer
+
+Runtime UI measurement CLI for AI agents. The active command surface is intentionally small:
+
+- `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.
+
+The CLI is bundled through `alanbox` as both `designer` and `alanbox designer ...`.
+
+## Commands
+
+```bash
+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
+```
+
+For Axure or iframe-based designs:
+
+```bash
+designer measure --url "http://127.0.0.1:32767/start.html" --frame "#mainFrame" --selector "#u0" --depth 0 --cdp 127.0.0.1:8000
+```
+
+## Structure
+
+- `src/` — active implementation.
+- `dist/` — built runtime shipped by `alanbox`.
+- `res/designer-main-legacy/` — archived old commands and references, not part of the active CLI.
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+```
+
+The active workflow is guided by `../skills/desginer/SKILL.md`; keep command options there in sync with `src/cli.ts`.

package/2designer/dist/cdp-engine-A5WTMTVF.js

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

package/2designer/dist/cdp-engine-A5WTMTVF.js.map

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