cli-swarm 0.1.0 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cli-swarm",
-  "version": "0.1.0",
-  "description": "swarm + blueprint + calctool 多 IDE 安装器：从 cli.tax 自动拉取并分发到本机所有已装 IDE（Codex/DSH/Claude/Cursor/…）。支持 check 更新检测。",
+  "version": "0.2.0",
+  "description": "swarm 智能体蜂群编排多 IDE 安装器：从 cli.tax 自动拉取并分发到本机所有已装 IDE。支持 check 更新检测。",
   "type": "module",
   "bin": {
     "cli-swarm": "install.mjs"

package/skills/calctool/SKILL.md

@@ -18,8 +18,10 @@ description: '按需生成「万能计算工具」：用户输入一个领域需
 2. 情报蜂群（research）        —— 自动派情报智能体搜索行业标准/抓指定地址，
    产出可溯源参考包（老板说"电商"等关键词时自动触发）
   ↓
-3. 蜂群执行（brain-invoke/complete）—— 需求自动拆解为 fields/formulas/rules/
-   imports/reports/pages 任务，依赖图驱动并行，独立复核，确定性合并
+3. 蜂群编排（swarm-orchestrate）—— 需求自动拆解为 fields/formulas/rules/
+   imports/reports/pages 项目 JSON，交给 swarm 大脑编排：企业组织架构派单 →
+   认领 → 执行 → 回传 → 红绿灯监控 → 固定运维（心跳/回收/接替/继承）
+   → 安全守卫（注入检测），确定性合并
   ↓
 4. 编译工具（compile-tool）    —— 引擎定义 → 可运行工程文件清单
    （App 壳/公式引擎/存储/构建，页面自动生成：录入/指标卡/报告）
@@ -109,29 +111,28 @@ defaultLocale: zh-CN
 - 发布为版本化引擎，任何公式/字段/阈值变化都创建新版本，不原地修改
 - 输出：可运行的在线工具 + 引擎定义包 + 验收报告 + 完成前门禁结论
 
-## 多智能体蜂群模式（大脑协同，推荐复杂工具用）
+## 多智能体蜂群模式（接入 swarm 编排，推荐复杂工具用）
 
-单智能体 `compile-inline` 适合简单工具；复杂工具（多字段 + 多公式 + 规则 + 导入 + 报告）用**蜂群协同**，多智能体并行生成、独立复核、确定性合并——准确率更高、产出更强。
+单智能体 `compile-inline` 适合简单工具；复杂工具（多字段 + 多公式 + 规则 + 导入 + 报告）用**蜂群编排（swarm）**：通过智能体大脑调度创建 N 个子智能体，企业级组织架构规则 + 项目 JSON 任务派单/认领/回传 + 红绿灯 + 固定运维与安全守卫——准确率更高、产出更强、可观测可自治。
 
-### 大脑模式（brain-handshake）
-- `ide`：用当前 IDE 的多智能体（subagent）执行蜂群（默认）
-- `hermes_local`：用用户本地安装的 Hermes 执行蜂群
+### 接入方式（swarm-orchestrate）
 
-### 蜂群流程（协议 calctool.coordinator.run-plan/1.0）
-
-1. **brain-handshake**：协商大脑模式（ide/hermes_local），返回蜂群能力
-2. **brain-invoke**：传需求 → **自动拆解**为蜂群任务（按需派发，需要几个派几个）：
+1. **swarm-orchestrate**：传需求 → calctool **自动拆解**为项目 JSON（需要几个派几个）：
+   - `research` 情报收集（有领域关键词才派）
    - `fields` 字段目录（入口，总是有）
    - `formulas` 公式图（有公式才派）· 独立复核
    - `rules` 规则包（有规则才派）· 独立复核
    - `imports` 导入映射（有导入才派）
    - `reports` 报告模板（有报告才派）
    - `pages` 页面规格（总是有）
-   依赖图驱动：fields 先 → formulas/imports 并行 → reports → pages；maxParallel 控制并发
-3. **brain-invoke 批量派发**：每个就绪 work item 派给一个独立智能体，收集产物
-4. **brain-events / brain-status**：流式收集事件、查询蜂群状态（就绪/运行/阻塞）
-5. **brain-complete**：提交全部产物 → **确定性合并**为引擎定义 → 校验 → 发布
-6. **brain-cancel**：随时取消蜂群
+2. **swarm 大脑编排**：项目 JSON 交给 swarm 运行时（https://cli.tax/zj7fTPVh4p）：
+   - `org-chart`：按企业组织架构创建 N 个子智能体（board/dispatcher/ops/security-guard/workers）
+   - `dispatch`：依赖图驱动派单（fields 先 → formulas/imports 并行 → reports → pages）
+   - `claim`：worker 认领任务；`report`：回传结果
+   - `traffic-light`：每任务/智能体实时绿/黄/红状态 + 进度/错误汇报
+   - `ops`：固定运维——心跳检测，卡死/死亡自动回收，派新智能体继承任务续跑
+   - `security-guard`：固定安全守卫——注入/危险指令检测、异常警报
+3. **确定性合并**：收集全部 worker 回传 → 合并为引擎定义 → 校验 → 发布
 
 ### 准确率与用户控制
 - **准确率**：合并后引擎定义必须通过确定性校验（引用闭合/公式链/单位/Decimal/无环），0 findings 才发布
@@ -159,6 +160,11 @@ defaultLocale: zh-CN
 - `references/import-ocr.md` —— 导入与 OCR（Excel 映射/图片识别/草稿确认）
 - `references/finance-example.md` —— 经营健康诊断完整范例（50 字段 → 10 指标 → 报告）
 
+### Blueprint 协同（可选）
+`brain-handshake` 时可选择 `blueprintEnabled`：生成引擎定义后，先交给 Blueprint 技能规划工具开发蓝图
+（`blueprint-orchestrate` → `https://cli.tax/wvz6zmRWmX`，operation `compile-inline`），
+再回到蜂群执行开发任务，验收标准全部可追溯。不开启时直接蜂群生成，全程框架一致。
+
 ## 安全规则
 
 - 不执行任意 JavaScript；公式只走受控 AST

package/skills/swarm/SKILL.md

@@ -39,9 +39,17 @@ description: '通过智能体大脑调度创建 N 个子智能体，用企业级
 - 用户需要企业级分工、任务认领回传、进度红绿灯的可观测协作
 - 用户需要自动回收卡死智能体并让继任者继承任务的自治能力
 - 用户需要内置安全守卫（防注入、异常警报）的多智能体系统
+- 用户希望任务先由 Blueprint 技能规划为可追溯蓝图，再交给蜂群执行（可选协同）
 
 不要用于：单智能体就能完成的简单任务（用单 agent 即可）；与任务编排无关的纯计算。
 
+## Blueprint 协同（可选）
+
+intake 时可选择 `blueprintEnabled`：任务先交给 Blueprint 技能规划为可追溯的工程蓝图
+（结构/引用/验收全部闭合），再回到蜂群派单执行。开启后 org-chart 的下一步是 `blueprint-bridge`，
+由它生成 blueprint 请求负载（`https://cli.tax/wvz6zmRWmX`，operation `compile-inline`），
+拿到蓝图后继续 `dispatch → claim → report`，红绿灯与运维/安全守卫保持不变。
+
 ## 核心原则
 
 1. **组织即规则**：协作结构 = 企业级组织架构（决策/管理/执行三层），派单、审批、汇报都遵循层级规则。

package/skills/swarm/swarm-runtime.mjs

@@ -1,4 +1,4 @@
-// swarm runtime v0.1.0 — 智能体蜂群编排的确定性运行时
+// swarm runtime v0.2.0 — 智能体蜂群编排的确定性运行时（可选 Blueprint 协同规划）
 // 自包含、无外部依赖。通过组织架构规则调度 N 个子智能体，
 // 围绕项目 JSON 完成 派单/认领/回传，红绿灯状态 + 进度/错误汇报，
 // 固定 运维智能体（心跳/回收/接替/继承）与 安全守卫智能体（注入/危险指令检测）。
@@ -8,10 +8,10 @@ const ERROR_SCHEMA = "swarm.skill.error/1.0";
 const ORG_SCHEMA = "swarm.org-chart/1.0";
 const TASK_SCHEMA = "swarm.tasks/1.0";
 const COMPILER_NAME = "swarm";
-const COMPILER_VERSION = "0.1.0";
+const COMPILER_VERSION = "0.2.0";
 
 const PURE_OPERATIONS = new Set([
-  "capabilities", "help", "intake", "org-chart", "dispatch", "claim",
+  "capabilities", "help", "intake", "org-chart", "blueprint-bridge", "dispatch", "claim",
   "report", "swarm-status", "traffic-light", "security-check", "validate-json",
 ]);
 
@@ -367,13 +367,20 @@ const INTAKE_QUESTIONS = [
     required: false,
     example: "strict",
   },
+  {
+    id: "blueprintEnabled",
+    prompt: "Use Blueprint to plan tasks before dispatch? (yes: tasks are planned by the Blueprint skill for traceable acceptance; no: direct dispatch)",
+    required: false,
+    example: "no",
+  },
 ];
 
 const OPERATION_CATALOG = Object.freeze([
   { operation: "capabilities", summary: "Discover swarm capabilities and operations.", input: {}, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-1", operation: "capabilities", input: {} } },
   { operation: "help", summary: "Return the usage guide and operation catalog.", input: {}, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-2", operation: "help", input: {} } },
   { operation: "intake", summary: "Return the intake questions before orchestrating a swarm.", input: {}, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-3", operation: "intake", input: {} } },
-  { operation: "org-chart", summary: "Build the enterprise org-chart (board/management/execution).", input: { workerCount: "number of workers", projectName: "string" }, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-4", operation: "org-chart", input: { workerCount: 6 } } },
+  { operation: "org-chart", summary: "Build the enterprise org-chart (board/management/execution).", input: { workerCount: "number of workers", projectName: "string", blueprintEnabled: "use Blueprint to plan tasks" }, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-4", operation: "org-chart", input: { workerCount: 6, blueprintEnabled: false } } },
+  { operation: "blueprint-bridge", summary: "Plan project JSON into a traceable blueprint, then dispatch its tasks to the swarm.", input: { projectName: "string", tasks: "task array" }, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-4b", operation: "blueprint-bridge", input: { projectName: "swarm-run", tasks: [] } } },
   { operation: "dispatch", summary: "Dispatch a backlog task to a worker.", input: { tasks: "task array", taskId: "string", workerId: "string", actorRole: "dispatcher|board" }, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-5", operation: "dispatch", input: { tasks: [], taskId: "task-0001", workerId: "worker-001", actorRole: "dispatcher" } } },
   { operation: "claim", summary: "Worker claims an assigned task.", input: { tasks: "task array", taskId: "string", workerId: "string" }, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-6", operation: "claim", input: { tasks: [], taskId: "task-0001", workerId: "worker-001" } } },
   { operation: "report", summary: "Worker reports a result back.", input: { tasks: "task array", taskId: "string", workerId: "string", report: "object" }, example: { schemaVersion: REQUEST_SCHEMA, requestId: "demo-7", operation: "report", input: { tasks: [], taskId: "task-0001", workerId: "worker-001", report: { output: "done" } } } },
@@ -428,7 +435,7 @@ export async function run(request) {
   if (operation === "intake") {
     return okResponse(requestId, {
       questions: INTAKE_QUESTIONS,
-      nextStep: { operation: "org-chart", instruction: "Turn the answers into an org-chart, then dispatch the project tasks." },
+      nextStep: { operation: "org-chart", instruction: "Turn the answers into an org-chart; optionally plan tasks with Blueprint (input.blueprintEnabled), then dispatch the project tasks." },
     });
   }
 
@@ -436,11 +443,60 @@ export async function run(request) {
     const org = buildOrgChart(input);
     const findings = validateOrgChart(org);
     if (findings.length) return blockedResponse(requestId, request, findings);
+    const blueprintEnabled = input.blueprintEnabled === true || text(input.blueprintEnabled).toLowerCase() === "yes";
     return okResponse(requestId, {
       org,
+      blueprintEnabled,
       fixedAgents: ["board", "dispatcher", "ops", "security-guard"],
       workerCount: org.layers.execution.length,
-      nextStep: { operation: "dispatch", instruction: "Feed the project JSON; dispatch backlog tasks to workers by dependency order." },
+      nextStep: blueprintEnabled
+        ? { operation: "blueprint-bridge", instruction: "Blueprint is enabled: call blueprint-bridge to plan the project JSON into a traceable blueprint, then dispatch its tasks to the swarm." }
+        : { operation: "dispatch", instruction: "Feed the project JSON; dispatch backlog tasks to workers by dependency order." },
+    });
+  }
+
+  // blueprint 协同桥：把项目 JSON 转为 blueprint 请求（与 calctool 的 blueprint-orchestrate 对称）。
+  // 用户选择 blueprintEnabled 后调用，由 blueprint 技能规划可追溯任务，再回到 swarm 派单执行。
+  if (operation === "blueprint-bridge") {
+    const projectName = text(input.projectName || "swarm-run");
+    const tasks = Array.isArray(input.tasks) ? input.tasks : [];
+    const blueprintRequest = {
+      schemaVersion: REQUEST_SCHEMA,
+      requestId: text(input.requestId || "swarm-bp-1"),
+      operation: "blueprint-bridge",
+      input: {
+        schemaVersion: "blueprint.skill.request/1.0",
+        operation: "compile-inline",
+        input: {
+          goal: projectName,
+          blueprint: {
+            schemaVersion: "blueprint.ir/1.0",
+            blueprintId: `swarm-${projectName}`,
+            requirements: [
+              { id: "fact-goal", status: "confirmed", statement: `蜂群目标：${projectName}` },
+              { id: "fact-tasks", status: "confirmed", statement: `任务清单：${tasks.length} 项` },
+            ],
+            modules: [],
+            nodes: tasks.map((task, index) => ({
+              id: `task-${index + 1}`,
+              moduleId: "swarm-tasks",
+              title: text(task.title || task.taskId || `任务 ${index + 1}`),
+              inputs: [],
+              outputs: [{ name: "done", exposed: true }],
+              requirementRefs: ["fact-goal", "fact-tasks"],
+            })),
+            edges: [],
+            acceptance: tasks.map((task, index) => ({ id: `acc-${index + 1}`, text: `任务 ${index + 1} 回传并被验收`, nodeRef: `task-${index + 1}` })),
+          },
+        },
+      },
+    };
+    return okResponse(requestId, {
+      status: "planned",
+      blueprintEnabled: true,
+      blueprintEndpoint: "https://cli.tax/wvz6zmRWmX",
+      blueprintRequest,
+      nextStep: { operation: "dispatch", instruction: "POST the blueprintRequest to https://cli.tax/wvz6zmRWmX (operation compile-inline) to get the traceable blueprint, then dispatch its tasks to the swarm workers." },
     });
   }
 

package/README.md

@@ -1,36 +0,0 @@
-# cli-swarm
-
-**智能体蜂群编排 skill 多 IDE 安装器** —— 大脑调度 N 个子智能体，企业级组织架构规则 + 项目 JSON 任务派单/认领/回传 + 红绿灯状态 + 固定运维（心跳/回收/接替/继承）与安全守卫（注入检测/警报）。
-
-- **CLI.Tax 源**: `https://cli.tax/zj7fTPVh4p`（`swarm.skill.request/1.0`）
-- **多 IDE 安装器**: 检测本机已装 IDE（Codex/DSH/Claude/Cursor/…），把 skill 分发到各 IDE 用户级根
-- **更新感知**: 每次 install 对比 cli.tax 最新版本并提示 ⤴；`check` 子命令主动检查
-
-## 一键安装（npm）
-
-```bash
-npx cli-swarm@latest install
-```
-
-自动完成：从 cli.tax 拉取 swarm + blueprint + calctool → 检测本机已装 IDE → 分发到每个 IDE。
-更新：同一命令（`@latest` 自动拉新版），且每次 install 会对比 cli.tax 最新版本并提示 ⤴。
-
-## 从本仓库安装
-
-```bash
-git clone https://github.com/88208555/swarm.git
-cd swarm
-node install.mjs install        # 自动检测本机已装 IDE 并分发
-node install.mjs check          # 检查已安装 skill 是否有新版本
-node install.mjs update         # 幂等覆盖更新
-```
-
-## 更新感知（check）
-
-安装器写入 `install-meta.json`（来源/版本/时间）到每个 skill 目录；SKILL.md 注入版本横幅，
-IDE 每次读取即可见版本与更新入口。主动检查：
-
-```bash
-node install.mjs check               # 遍历本机已装 IDE，对比 cli.tax 最新版本
-npx cli-swarm@latest check           # 单包检查
-```