@mclawnet/swarm 0.1.11 → 0.1.12

package/roles/queen.md

@@ -92,6 +92,32 @@ protocol:
 6. 所有任务完成后，让 reviewer 审查（如果有），然后汇总报告
 7. **最终汇报**：确认所有工作完成后，**必须**通过 `mcp__clawnet-mcp__task_set_status` 把根任务状态标为 `completed` 或 `failed`，并用自然语言对用户做一段简短总结后保持沉默，等待下一条 inbox 消息。蜂群目前**不会自动回收资源**——是否销毁蜂群由用户主动操作；你不需要、也不应该输出任何"等待系统回收""资源已释放"之类的文字。
 
+### plan↔task 外键约定（强制）
+
+当你从 plan 派生任务时，**必须**在 `mcp__clawnet-mcp__task_create` / `mcp__clawnet-mcp__task_create_from_message` 调用中传入 `planTaskId` 参数，值为 plan 中该任务的 id（例如 `"t1"`、`"t2.5"`）。这是 UI 显示 plan 进度的唯一依据——遗漏会导致对应的 plan 节点永远显示 `pending`，即使 live task 已经 `completed`。
+
+只有不来自任何 plan 节点的临时任务（极少见）才可以省略 `planTaskId`。
+
+#### 派生 plan 任务前必做（不可省略）
+
+每次准备调用 `task_create` / `task_create_from_message` 派生 plan 中的任务前，**必须先在对话中输出一段映射说明**，让用户/审查者能核对你做的关联：
+
+```
+[plan-mapping]
+- t1 → 即将创建 live task "扫描目录现状"
+- t2.1 → 即将创建 live task "实现星空 Canvas"
+[/plan-mapping]
+```
+
+然后**每次 `task_create` 调用都必须传 `planTaskId` 参数**，值为对应的 plan 节点 id。
+
+为了进一步降低遗漏概率，工具会在两种情况下返回提示，请你认真阅读返回内容：
+
+1. **`ℹ 已从 subject 推断 planTaskId='tX'`** — 你忘了显式传 `planTaskId`，但服务器从 subject 的 `t1: ...` / `[t2.5] ...` 前缀里推断出了一个。请核对推断是否正确；不对就再调一次显式传 `planTaskId`，**或** `mcp__clawnet-mcp__task_set_status` 取消错误任务后重建。
+2. **`⚠ Plan link warning: ...`** — swarm 已有 plan，但本次创建的 task 没能关联到 plan 节点（缺 `planTaskId` 或拼写错误）。如果是 plan 派生任务**必须**补传 `planTaskId`；如果确实是临时调试任务可以忽略该 warning。
+
+不要把 `[plan-mapping]` 说明和上述提示混淆——映射说明是你**事前**输出，提示是工具**事后**返回。
+
 ### 输出格式约束（重要）
 
 - ✅ 用自然语言（中文）对用户讲话，必要时穿插 markdown。

package/dist/message-router.d.ts

@@ -1,37 +0,0 @@
-import type { SessionAdapter } from "./types.js";
-import type { SwarmMessage, RouteEndpoint } from "./types.js";
-export interface DeliveryResult {
-    delivered: boolean;
-    reason?: string;
-}
-/**
- * Abstract message router — decouples communication from transport.
- * LocalMessageRouter uses stdin/stdout via SessionAdapter.
- * Future RemoteMessageRouter can use Hub WebSocket relay.
- */
-export interface MessageRouter {
-    /** Send a message to a specific role instance */
-    send(targetInstanceId: string, message: SwarmMessage): DeliveryResult;
-    /** Broadcast a message to all active role instances */
-    broadcast(message: SwarmMessage, excludeInstanceId?: string): void;
-    /** Register a role instance in the routing table */
-    register(instanceId: string, endpoint: RouteEndpoint): void;
-    /** Unregister a role instance */
-    unregister(instanceId: string): void;
-    /** Check if a route exists */
-    has(instanceId: string): boolean;
-}
-/**
- * Routes messages to local Claude CLI processes via SessionAdapter.sendInput().
- */
-export declare class LocalMessageRouter implements MessageRouter {
-    private sessionAdapter;
-    private routes;
-    constructor(sessionAdapter: SessionAdapter);
-    send(targetInstanceId: string, message: SwarmMessage): DeliveryResult;
-    broadcast(message: SwarmMessage, excludeInstanceId?: string): void;
-    register(instanceId: string, endpoint: RouteEndpoint): void;
-    unregister(instanceId: string): void;
-    has(instanceId: string): boolean;
-}
-//# sourceMappingURL=message-router.d.ts.map

package/dist/message-router.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-router.d.ts","sourceRoot":"","sources":["../src/message-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO9D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,cAAc,CAAC;IAEtE,uDAAuD;IACvD,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnE,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAE5D,iCAAiC;IACjC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,8BAA8B;IAC9B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAID;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAG1C,OAAO,CAAC,cAAc;IAFlC,OAAO,CAAC,MAAM,CAAoC;gBAE9B,cAAc,EAAE,cAAc;IAElD,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,cAAc;IAuBrE,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI;IAQlE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI3D,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAGjC"}

package/dist/message-router.js

@@ -1,60 +0,0 @@
-import { createLogger } from "@mclawnet/logger";
-const log = createLogger({ module: "swarm/router" });
-// ── Local Implementation ────────────────────────────────────────────
-/**
- * Routes messages to local Claude CLI processes via SessionAdapter.sendInput().
- */
-export class LocalMessageRouter {
-    sessionAdapter;
-    routes = new Map();
-    constructor(sessionAdapter) {
-        this.sessionAdapter = sessionAdapter;
-    }
-    send(targetInstanceId, message) {
-        const endpoint = this.routes.get(targetInstanceId);
-        if (!endpoint) {
-            log.warn({ targetInstanceId }, "no route found");
-            return { delivered: false, reason: "no_route" };
-        }
-        if (endpoint.kind === "local") {
-            try {
-                const formatted = formatMessageForClaude(message);
-                this.sessionAdapter.sendInput(endpoint.roleSessionId, formatted);
-                return { delivered: true };
-            }
-            catch (err) {
-                log.warn({ targetInstanceId, err }, "stdin write failed");
-                return { delivered: false, reason: "write_failed" };
-            }
-        }
-        // Remote routing — not yet implemented
-        log.warn({ targetInstanceId }, "remote routing not yet implemented");
-        return { delivered: false, reason: "remote_not_implemented" };
-    }
-    broadcast(message, excludeInstanceId) {
-        for (const [instanceId] of this.routes) {
-            if (instanceId !== excludeInstanceId) {
-                this.send(instanceId, message);
-            }
-        }
-    }
-    register(instanceId, endpoint) {
-        this.routes.set(instanceId, endpoint);
-    }
-    unregister(instanceId) {
-        this.routes.delete(instanceId);
-    }
-    has(instanceId) {
-        return this.routes.has(instanceId);
-    }
-}
-// ── Formatting ──────────────────────────────────────────────────────
-function formatMessageForClaude(message) {
-    const parts = [];
-    parts.push(`[来自 ${message.from}]`);
-    if (message.taskId)
-        parts.push(`(任务: ${message.taskId})`);
-    parts.push(message.data);
-    return parts.join(" ");
-}
-//# sourceMappingURL=message-router.js.map

package/dist/message-router.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-router.js","sourceRoot":"","sources":["../src/message-router.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAiCrD,uEAAuE;AAEvE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAGT;IAFZ,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAElD,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,IAAI,CAAC,gBAAwB,EAAE,OAAqB;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,gBAAgB,CAAC,CAAC;YACjD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAClD,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;gBACjE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC7B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;gBAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YACtD,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,oCAAoC,CAAC,CAAC;QACrE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAChE,CAAC;IAED,SAAS,CAAC,OAAqB,EAAE,iBAA0B;QACzD,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,UAAkB,EAAE,QAAuB;QAClD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,UAAkB;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;CACF;AAED,uEAAuE;AAEvE,SAAS,sBAAsB,CAAC,OAAqB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}