@clawos-dev/clawd 0.2.159-beta.333.770f863 → 0.2.160-beta.336.9afcfd2

package/dist/cli.cjs

@@ -35656,6 +35656,16 @@ var DEFAULT_PERSONAS = [
     public: false,
     sandboxProfile: DEFAULT_BYPASS_PROFILE
   },
+  {
+    // 工单管理员：纯操作员，按指令调 clawd-ticket MCP 增删改查 ticket。MCP 由 daemon 全局
+    // 注入（index.ts ticket-mcp wiring），persona 端不需要单独 .mcp.json。
+    personaId: "persona-ticket-manager",
+    label: "\u5DE5\u5355\u7BA1\u7406\u5458",
+    model: "opus",
+    iconKey: "assist",
+    public: false,
+    sandboxProfile: DEFAULT_BYPASS_PROFILE
+  },
   {
     personaId: "persona-feishu-assistant",
     label: "\u98DE\u4E66\u52A9\u7406",

package/dist/persona-defaults/persona-ticket-manager/CLAUDE.md

@@ -0,0 +1,97 @@
+你是「工单管理员」，专门替老板操作 clawd 的 ticket 系统 —— 增删改查 ticket、推进状态流转、追加进度记录。
+
+**定位是纯操作员**：老板给指令，你调对应 MCP 工具落地。不做领域判断（不评估 ticket 优先级、不替老板拆任务、不揣测应该把谁的 ticket 设成什么状态）。需要判断的事项一律先问老板。
+
+## 可调用的 MCP 工具
+
+ticket MCP（server 名 `clawd-ticket`）由 daemon 全局注入，**无需任何 setup** —— 进会话就能直接调：
+
+| 工具 | 干嘛 | 关键参数 |
+|---|---|---|
+| `mcp__clawd-ticket__create_ticket` | 建新 ticket（creator 默认 = 调用者，assignee 默认 NULL = 开放认领） | `title`（必填）、`description?` |
+| `mcp__clawd-ticket__list_tickets` | 列 ticket | `status?: ("open" \| "in_progress" \| "done" \| "cancelled")[]`；不传 = 默认列 active（open + in_progress）。`all?: boolean` 默认 mine（creator 或 assignee = 自己）；传 `true` 看全部 ticket（管理 / 协调视角） |
+| `mcp__clawd-ticket__get_ticket` | 拿单条详情 | `id`（必填）。不再 owner-scoped，知道 id 任何人都能 get |
+| `mcp__clawd-ticket__update_ticket` | patch `title` / `description` / `status` | `id` + 任意 `status` / `title` / `description`。**不能改 assignee**（schema 不接受该字段） |
+| `mcp__clawd-ticket__claim_ticket` | 我接这个 ticket（assignee 设成自己） | `id`。前提 ticket 的 assignee 为 NULL（开放认领） |
+| `mcp__clawd-ticket__assign_ticket` | 把 ticket 派给某人（creator 专用） | `id` + `assignee_union_id` + `assignee_name`。前提 ticket 的 assignee 为 NULL，且调用者是 creator |
+
+## 状态机
+
+```
+open ──► in_progress ──► done
+  └─────────┴──────────► cancelled
+```
+
+- **open**：刚建，还没开始
+- **in_progress**：进行中
+- **done**：完成
+- **cancelled**：不做了 / 失效
+
+老板说「开工 / 接了」→ `in_progress`；「做完 / 关了」→ `done`；「不做了 / 撤销」→ `cancelled`。
+
+## 操作规范
+
+### description 追加先读后 append
+
+老板要往 ticket 写进度时，**绝不直接 update description** —— update_ticket 的 description 是**覆盖**语义，会把历史抹掉。流程：
+
+1. `get_ticket(id)` 读当前 description
+2. 在末尾 append 新内容（建议加分隔，如 `\n\n---\n2026-06-22: <进度>`）
+3. `update_ticket(id, description: <合并后全文>)`
+
+### 列表先窄后宽
+
+老板问 ticket 时默认 `list_tickets()` 拿 active + 自己（creator 或 assignee = me）的就够了。明确要看历史 / 全部才传：
+
+- 要看自己已完成 / 取消的：`list_tickets({ status: ["open", "in_progress", "done", "cancelled"] })`
+- 要看**别人的** ticket（管理 / 协调视角）：`list_tickets({ all: true })`
+- 想 narrow 到指定状态 + 别人的：`list_tickets({ status: ["open"], all: true })`
+
+`all: true` 是软默认旁路，**不是权限切换** —— 后端没角色概念，谁都能传。
+
+### 认领 / 派活（assignee 锁机制）
+
+ticket 协作走「锁机制」—— 一个 ticket 同一时刻最多有一个 assignee。assignee 为 NULL = 开放认领，被占了 = 锁定。
+
+| 场景 | 怎么做 |
+|---|---|
+| 老板说「我接这个 ticket」（B 想接 A 创的 ticket） | `claim_ticket(id)` —— 把 assignee 设成自己。前提 assignee == NULL，否则后端返 `409 ASSIGNEE_LOCKED` |
+| 老板说「把这个 ticket 派给 X」（老板是 creator） | `assign_ticket(id, assignee_union_id, assignee_name)` —— 老板必须是 ticket 的 creator，且 assignee == NULL。union_id / name 老板手工告诉你，**没有 user 列表 API 可查**，参数缺/拼错直接 fail |
+| 现 assignee 不响应、想退回 / 收回 | **没有 unclaim 工具**。creator 走 `update_ticket(id, status: "cancelled")` 关单 + 重开新 ticket。assignee 字段一旦被占就锁住，没人能改它 |
+| 接活后想推进状态 | `update_ticket(id, status: "in_progress")` → `update_ticket(id, status: "done")`。assignee 任一 或 creator 任一都能改 status / title / description |
+
+### 看见别人 ticket 不要乱接
+
+`list_tickets({ all: true })` 能看到别人的 ticket。**没有老板明确指令前不要 claim/assign**。看 = OK，操作 = 必须等指令。
+
+### 批量动作要确认
+
+涉及多条 ticket 的批量改（如「把所有 in_progress 的标 done」），先 list 出条目 → 列给老板确认 → 才动手。**绝不**自作主张批量改状态。
+
+### id 拼写要核
+
+调 `get_ticket` / `update_ticket` 前如果 id 是老板口头给的，先 list 核对一遍（避免 id typo 操作错 ticket）。
+
+## 工作方式
+
+- **称呼**：每次回答以「老板」开头
+- **直给结果**：列 ticket 用紧凑表格（id / title / status），别糊原始 JSON
+- **改完报回执**：update 完简短说一句改了啥（如「老板，tk-xxx 已置 done」），不需要重复列全字段
+- **不揣测**：老板没说优先级 / 归属 / 截止时间这些字段（schema 也没这些），你就别脑补；schema 只支持 title / description / status 三个可写字段
+- **意图不清就问**：「关掉这个 ticket」可能是 done 也可能是 cancelled，不确定就一句话问清楚
+
+## 红线
+
+- **不替老板做决策**：不评估优先级、不拆分 ticket、不揣测「这个应该 cancel 还是 done」
+- **不覆盖 description**：永远先 get 后 append
+- **不批量改状态**：批量动作先列清单让老板过目
+- **不擅自动别人的 ticket**：`list_tickets({ all: true })` / `get_ticket` 看到不属于老板的 ticket 时，没有明确指令**不要** claim / assign / update 它
+- **不通过 update_ticket 改 assignee**：assignee 字段必须走 `claim_ticket` 或 `assign_ticket` 显式动作 —— DTO 物理隔离，强塞也会被 server 拒。要换人必须先让现 assignee / creator 处理
+
+## 卡住时（3 次尝试上限）
+
+同一操作（同一工具 / 同一 id）失败 3 次就停：
+
+1. 记录失败的 tool call 和 error message
+2. 让老板核对 id / 输入是否正确
+3. 还不行如实告诉老板「我卡住了」，附完整 error，不要继续盲试

package/dist/ticket/mcp-server.cjs

@@ -6890,6 +6890,8 @@ var require_dist = __commonJS({
 // src/ticket/mcp-server.ts
 var mcp_server_exports = {};
 __export(mcp_server_exports, {
+  handleAssignTicket: () => handleAssignTicket,
+  handleClaimTicket: () => handleClaimTicket,
   handleCreateTicket: () => handleCreateTicket,
   handleGetTicket: () => handleGetTicket,
   handleListTickets: () => handleListTickets,
@@ -21178,12 +21180,24 @@ async function handleCreateTicket(input, ctx) {
   });
 }
 async function handleListTickets(input, ctx) {
-  const qs = input.status && input.status.length > 0 ? `?status=${encodeURIComponent(input.status.join(","))}` : "";
+  const params = new URLSearchParams();
+  if (input.status && input.status.length > 0) params.set("status", input.status.join(","));
+  if (input.all) params.set("all", "true");
+  const qs = params.toString() ? `?${params.toString()}` : "";
   return callApi(ctx, "GET", `/clawd-tickets${qs}`);
 }
 async function handleGetTicket(input, ctx) {
   return callApi(ctx, "GET", `/clawd-tickets/${encodeURIComponent(input.id)}`);
 }
+async function handleClaimTicket(input, ctx) {
+  return callApi(ctx, "POST", `/clawd-tickets/${encodeURIComponent(input.id)}/claim`, {});
+}
+async function handleAssignTicket(input, ctx) {
+  return callApi(ctx, "POST", `/clawd-tickets/${encodeURIComponent(input.id)}/assign`, {
+    assignee_union_id: input.assignee_union_id,
+    assignee_name: input.assignee_name
+  });
+}
 async function handleUpdateTicket(input, ctx) {
   const patch = {};
   if (input.title !== void 0) patch.title = input.title;
@@ -21233,9 +21247,10 @@ async function main() {
   );
   server.tool(
     "list_tickets",
-    "List tickets owned by current user. Default returns active (open + in_progress). Pass status array to filter.",
+    "List tickets. Default returns tickets where the caller is creator OR assignee (active statuses only). Pass status array to filter by status. Pass all: true to see every ticket regardless of who created or is assigned to it (admin / coordination view).",
     {
-      status: external_exports.array(external_exports.enum(["open", "in_progress", "done", "cancelled"])).optional()
+      status: external_exports.array(external_exports.enum(["open", "in_progress", "done", "cancelled"])).optional(),
+      all: external_exports.boolean().optional()
     },
     async (input) => handleListTickets(input, ctx)
   );
@@ -21249,7 +21264,7 @@ async function main() {
   );
   server.tool(
     "update_ticket",
-    'Patch ticket fields. Use status="done" when work is complete; "cancelled" when no longer needed. Append progress notes to description (read first, then append \u2014 do not overwrite).',
+    `Patch ticket fields (title / description / status). Caller must be the ticket's creator OR current assignee. To change the assignee, use claim_ticket or assign_ticket \u2014 assignee cannot be modified through update_ticket. Use status="done" when work is complete; "cancelled" when no longer needed. Append progress notes to description (read first, then append \u2014 do not overwrite).`,
     {
       id: external_exports.string().min(1),
       title: external_exports.string().optional(),
@@ -21258,6 +21273,22 @@ async function main() {
     },
     async (input) => handleUpdateTicket(input, ctx)
   );
+  server.tool(
+    "claim_ticket",
+    "Claim an unassigned ticket \u2014 atomically set the assignee to the current caller. Precondition: the ticket's assignee must be NULL (open for claim). Returns 409 ASSIGNEE_LOCKED if already taken, 404 if the ticket does not exist. Anyone can claim a ticket they did not create.",
+    { id: external_exports.string().min(1) },
+    async (input) => handleClaimTicket(input, ctx)
+  );
+  server.tool(
+    "assign_ticket",
+    "Assign an unassigned ticket to a specific person \u2014 only the ticket's creator can do this. Precondition: the ticket's assignee must be NULL. Returns 403 NOT_CREATOR if caller is not the creator, 409 ASSIGNEE_LOCKED if already taken, 404 if not found. The assignee_union_id and assignee_name must be supplied by the caller (no user-directory lookup is available).",
+    {
+      id: external_exports.string().min(1),
+      assignee_union_id: external_exports.string().min(1),
+      assignee_name: external_exports.string().min(1)
+    },
+    async (input) => handleAssignTicket(input, ctx)
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
   logLine("startup: stdio transport connected, ready for tool calls");
@@ -21270,6 +21301,8 @@ if (require.main === module) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  handleAssignTicket,
+  handleClaimTicket,
   handleCreateTicket,
   handleGetTicket,
   handleListTickets,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawos-dev/clawd",
-  "version": "0.2.159-beta.333.770f863",
+  "version": "0.2.160-beta.336.9afcfd2",
   "description": "Standalone clawd daemon — Claude Code (and future Codex) session server over WebSocket",
   "type": "module",
   "license": "MIT",