@ycodium-ai/plugin-team 0.2.3158 → 0.2.3180

package/dist/index.js

@@ -6867,6 +6867,19 @@ function goalExecution(goal) {
     members: goal === null ? [] : [...goal.threads, ...goal.remoteMembers ?? []]
   };
 }
+function findGoalMember(members, identity2) {
+  return members.find(
+    (member) => "threadId" in identity2 ? "threadId" in member && member.threadId === identity2.threadId : "principalId" in member && member.principalId === identity2.principalId
+  );
+}
+
+// src/domain/goalItem.ts
+var teamGoalItemId = (projectId, goalId) => `team-goal:${projectId}:${goalId}`;
+var GOAL_ITEM_TITLE_MAX = 120;
+var goalItemTitle = (goal) => {
+  const line = (goal.titleSeed ?? goal.goal).split(/\r?\n/u, 1)[0].trim();
+  return line.length <= GOAL_ITEM_TITLE_MAX ? line : `${line.slice(0, GOAL_ITEM_TITLE_MAX - 1)}\u2026`;
+};
 
 // locales/en.json
 var en_default = {
@@ -6897,6 +6910,7 @@ var en_default = {
     retryCreate: "Retry creation",
     saving: "Saving\u2026",
     moveTo: "Move to\u2026",
+    goalItem: "Goal",
     moveItem: "Move work item #{{number}}",
     moveItemTo: "Move work item #{{number}} to {{state}}",
     assignTo: "Assign to\u2026",
@@ -6939,6 +6953,18 @@ var en_default = {
     reply: "Reply",
     replyTo: "Reply to comment {{number}}",
     newComment: "Post a comment",
+    commentHint: "To wake a member, choose it under Mention\u2026 (or type @), or choose Reply under its comment. Commenting on an open work item assigned to a remote member also wakes it.",
+    mention: "Mention\u2026",
+    mentionLabel: "Mention a member \u2014 {{comment}}",
+    mentionMember: "Mention {{name}} \u2014 {{comment}}",
+    mentionMemberSelected: "{{name}} (mentioned) \u2014 {{comment}}",
+    mentionSelected: "{{name}} (mentioned)",
+    mentionRemove: "Remove mention of {{name}} \u2014 {{comment}}",
+    mentionNone: "Start a goal to mention members.",
+    mentionNoneLabel: "Start a goal to mention members \u2014 {{comment}}",
+    mentioned: "Mentioned: {{names}}",
+    mentionSeparator: ", ",
+    notAMember: "One of the mentioned members is not in the current goal. Remove it and try again.",
     send: "Send",
     sendComment: "Send comment",
     sendReply: "Send reply to comment {{number}}",
@@ -7005,7 +7031,9 @@ var en_default = {
     invalidRequestId: "The request ID must be 1\u201364 letters, numbers, underscores, or hyphens.",
     loadFailed: "The current goal could not be loaded. Try reloading it.",
     startFailed: "The goal could not be fully started. Retry to finish creating the threads and sending the lead's brief.",
-    remoteMembers: "Remote members:"
+    remoteMembers: "Remote members:",
+    item: "Goal work item #{{number}}: {{state}}",
+    openItem: "Open details for goal work item #{{number}}"
   },
   roster: {
     title: "Roster",
@@ -7133,7 +7161,7 @@ var PERSON_MESSAGE_RULE = "Send a message to the person only when you need their
 var LEAD_SPLIT_RULE = "Use work_create_item to split the goal into a few work items: one item per task, with a clear action in the title. Members do not see this conversation or your goal, so put everything a member needs into the description: the deliverable, the constraints, and how to hand the work in. Create them without assignees.";
 var LEAD_OWN_ITEM_RULE = "If a work item for this goal is assigned to you, also record it as blocked by every item you create. When they are all done you will be told; then check the results and mark that item done with work_update_item.";
 var LEAD_SEND_BACK_RULE = "If a finished item is not acceptable, send it back: use work_update_item to set its state back to an open one (see work_list_states), and change its assignees too if someone else should redo it. Then say what is wrong in a comment with work_post_comment, mentioning the member.";
-var LEAD_NO_MEMBER_TASKS = "Do not do members' tasks yourself.";
+var LEAD_NO_MEMBER_TASKS = "Do not do members' tasks yourself, and never assign an item you create to yourself: merging, pushing and integrating the work are member tasks too.";
 var tableCell = (value) => value.replace(/\|/g, "\\|").replace(/[\r\n]/g, " ");
 function leadBrief(goal, roster) {
   const localMembers = goal.threads.filter((thread) => thread.memberId !== goal.leadMemberId).map((thread) => {
@@ -7155,6 +7183,7 @@ function leadBrief(goal, roster) {
       ...localMembers,
       ...remoteMembers
     ].join("\n"),
+    `This goal is on the board as work item "${teamGoalItemId(goal.projectId, goal.goalId)}", assigned to you so the person can see when it is finished. Do not claim it or work on it yourself.`,
     LEAD_SPLIT_RULE,
     'Then use work_add_relation with type "blocked_by" to record dependencies: the dependent workItemId is blocked by the prerequisite relatedWorkItemId.',
     LEAD_OWN_ITEM_RULE,
@@ -7350,6 +7379,14 @@ function createGoalService(ctx, rosterService, options = {}) {
         }
       });
     }
+    await ctx.work.items.create({
+      projectId: goal.projectId,
+      workItemId: teamGoalItemId(goal.projectId, goal.goalId),
+      requestId: `goal-item:${goal.projectId}:${goal.goalId}`,
+      title: goalItemTitle(goal),
+      description: goal.goal,
+      assignees: [{ kind: "agent", threadId: leadThreadId }]
+    });
     await ctx.threads.turns.start({
       requestId: `lead-turn:${goal.projectId}:${goal.goalId}`,
       threadId: leadThreadId,
@@ -7489,11 +7526,17 @@ var BoardItem = Struct({
   blockedByTotal: Number5,
   version: Number5
 });
+var BoardGoalItem = Struct({
+  workItemId: String4,
+  sequenceId: Number5,
+  state: Struct({ stateId: String4, name: String4, group: String4 })
+});
 var BoardSnapshot = Struct({
   states: ArraySchema(BoardState),
   items: ArraySchema(BoardItem),
   // 当前目标与 goal 命令同一份形状；目标栏与看板都从这里读，同一个门铃刷新。
   goal: ReadGoalResult,
+  goalItem: optionalKey2(BoardGoalItem),
   people: ArraySchema(BoardPerson),
   // 已保存名单里的成员；名字显示（含远端成员）读这里，名单编辑器的草稿另存。
   rosterMembers: ArraySchema(TeamMember),
@@ -7704,9 +7747,7 @@ var decodeRead2 = decodeUnknownSync(ReadBoardInput);
 var decodeCreate = decodeUnknownOption2(CreateItemInput);
 var decodeUpdate = decodeUnknownOption2(UpdateItemInput);
 function registerBoardCommands(ctx, goals, rosters, options = {}) {
-  const isMember2 = async (projectId, threadId) => goalExecution(await goals.read(projectId)).members.some(
-    (member) => "threadId" in member && member.threadId === threadId
-  );
+  const isMember2 = async (projectId, threadId) => findGoalMember(goalExecution(await goals.read(projectId)).members, { threadId }) !== void 0;
   ctx.command({
     name: "board",
     scope: "read",
@@ -7729,7 +7770,8 @@ function registerBoardCommands(ctx, goals, rosters, options = {}) {
         // 认出当前读者只为把作者显示成「你」：读不出来就当没有，不连累整张看板。
         invocation.viewer?.communication.people.current({}).catch(() => null)
       ]);
-      const [remoteWork, { items: rows, truncated }] = await Promise.all([
+      const goalItemId = goal === null ? null : teamGoalItemId(projectId, goal.goalId);
+      const [remoteWork, { items: rows, truncated }, goalItem] = await Promise.all([
         Promise.all(
           (roster?.members ?? []).flatMap(
             (member) => member.principal === void 0 ? [] : [
@@ -7740,7 +7782,9 @@ function registerBoardCommands(ctx, goals, rosters, options = {}) {
             ]
           )
         ),
-        readPages(ITEM_LIMIT, (page) => ctx.work.items.list({ projectId, ...page }))
+        readPages(ITEM_LIMIT, (page) => ctx.work.items.list({ projectId, ...page })),
+        // 目标那件按号单读：看板只列最新的 500 件，目标那件可能不在里面。
+        goalItemId === null ? void 0 : ctx.work.items.get({ projectId, workItemIds: [goalItemId] }).then(({ items: items2 }) => items2.find((item) => item.workItemId === goalItemId))
       ]);
       const enabled = (toolkit) => toolkitStates.toolkits.some((row) => row.toolkit === toolkit && row.enabled);
       const items = rows.map((item) => ({
@@ -7761,6 +7805,17 @@ function registerBoardCommands(ctx, goals, rosters, options = {}) {
         })).sort((a, b) => a.sequence - b.sequence),
         items,
         goal,
+        ...goalItem === void 0 ? {} : {
+          goalItem: {
+            workItemId: goalItem.workItemId,
+            sequenceId: goalItem.sequenceId,
+            state: {
+              stateId: goalItem.state.stateId,
+              name: goalItem.state.name,
+              group: goalItem.state.group
+            }
+          }
+        },
         people: people.items.map((row) => ({
           key: personKey(row.person),
           displayName: row.displayName
@@ -7854,8 +7909,17 @@ var PostCommentInput = Struct({
   workItemId: String4,
   body: String4,
   parentId: optionalKey2(String4),
+  mentions: optionalKey2(
+    ArraySchema(
+      Struct({
+        threadId: optionalKey2(String4),
+        principalId: optionalKey2(String4)
+      })
+    )
+  ),
   requestId: String4
 });
+var mentionPrincipal = (mention) => mention.threadId !== void 0 ? mention.principalId === void 0 ? { kind: "agent", threadId: mention.threadId } : null : mention.principalId !== void 0 ? { kind: "remote-agent", principalId: mention.principalId } : null;
 var PostCommentResult = Union2([
   Struct({ commentId: String4 }),
   BoardRejection
@@ -7863,6 +7927,7 @@ var PostCommentResult = Union2([
 var DetailComment = Struct({
   commentId: String4,
   author: WorkIdentity,
+  mentions: optionalKey2(ArraySchema(WorkIdentity)),
   body: NullOr(String4),
   parentId: NullOr(String4),
   createdAt: String4
@@ -7912,7 +7977,7 @@ var HISTORY_LIMIT = 200;
 var GET_BATCH_SIZE = 50;
 var decodeRead3 = decodeUnknownSync(ReadItemDetailInput);
 var decodePost = decodeUnknownOption2(PostCommentInput);
-function registerDetailCommands(ctx) {
+function registerDetailCommands(ctx, goals) {
   ctx.command({
     name: "itemDetail",
     scope: "read",
@@ -7972,6 +8037,7 @@ function registerDetailCommands(ctx) {
         comments: comments.items.map((comment) => ({
           commentId: comment.commentId,
           author: workIdentity(comment.author),
+          mentions: comment.mentions.map(workIdentity),
           body: comment.bodyState === "present" ? comment.body : null,
           parentId: comment.parentId,
           createdAt: comment.createdAt
@@ -8015,13 +8081,25 @@ function registerDetailCommands(ctx) {
     handle: async (payload, invocation) => {
       const decoded = decodePost(payload);
       if (isNone2(decoded)) return rejectWork("postComment", "invalid-payload");
-      const input = decoded.value;
+      const { mentions, ...input } = decoded.value;
       const body = commentText(input.body);
       if (body === null) return rejectWork("postComment", "invalid-body");
+      const principals = mentions?.flatMap((mention) => mentionPrincipal(mention) ?? []);
+      if (principals?.length !== mentions?.length)
+        return rejectWork("postComment", "invalid-payload");
+      if (principals !== void 0 && principals.length > 0) {
+        const members = goalExecution(await goals.read(input.projectId)).members;
+        if (principals.some((principal) => findGoalMember(members, principal) === void 0))
+          return rejectWork("postComment", "not-a-member");
+      }
       const result2 = await writeWork(
         invocation,
         "postComment",
-        (work) => work.comments.post({ ...input, body })
+        (work) => work.comments.post({
+          ...input,
+          body,
+          ...principals === void 0 ? {} : { mentions: principals }
+        })
       );
       return "code" in result2 ? result2 : { commentId: result2.result.commentId };
     }
@@ -8661,8 +8739,9 @@ var decodeRelease = decodeUnknownSync(
 );
 function callerMember(project2, caller) {
   if (caller === void 0) return void 0;
-  return goalExecution(project2.goal).members.find(
-    (member) => caller.kind === "thread" ? "threadId" in member && member.threadId === caller.threadId : "principalId" in member && member.principalId === caller.principalId
+  return findGoalMember(
+    goalExecution(project2.goal).members,
+    caller.kind === "thread" ? { threadId: caller.threadId } : { principalId: caller.principalId }
   );
 }
 var hasAcknowledged = (project2, memberId, release) => readFact(readFact(project2.acknowledgements, memberId)?.releases ?? {}, String(release)) === true;
@@ -9032,6 +9111,8 @@ function startHandbookRuntime(ctx) {
         input.projectId
       );
       if (project2 === null || project2.requiredRelease === null) return { allowed: true };
+      if (project2.goal !== null && input.workItemId === teamGoalItemId(input.projectId, project2.goal.goalId))
+        return { allowed: true };
       for (const actor of input.added) {
         const caller = actor.kind === "human" ? void 0 : actor.kind === "agent" ? { kind: "thread", threadId: actor.threadId } : actor;
         const member = callerMember(project2, caller);
@@ -9215,14 +9296,14 @@ function registerHandbookPanel(ctx, runtime) {
 // src/index.ts
 var index_default = definePlugin({
   id: "team",
-  apiVersion: 15,
+  apiVersion: 16,
   activate(ctx) {
     const rosters = createRosterService(ctx);
     registerRosterCommands(ctx, rosters);
     const goals = createGoalService(ctx, rosters);
     registerGoalCommands(ctx, goals);
     registerBoardCommands(ctx, goals, rosters);
-    registerDetailCommands(ctx);
+    registerDetailCommands(ctx, goals);
     startWakeRuntime(ctx);
     const handbook = startHandbookRuntime(ctx);
     registerHandbook(ctx, handbook);

package/locales/en.json

@@ -26,6 +26,7 @@
     "retryCreate": "Retry creation",
     "saving": "Saving…",
     "moveTo": "Move to…",
+    "goalItem": "Goal",
     "moveItem": "Move work item #{{number}}",
     "moveItemTo": "Move work item #{{number}} to {{state}}",
     "assignTo": "Assign to…",
@@ -68,6 +69,18 @@
     "reply": "Reply",
     "replyTo": "Reply to comment {{number}}",
     "newComment": "Post a comment",
+    "commentHint": "To wake a member, choose it under Mention… (or type @), or choose Reply under its comment. Commenting on an open work item assigned to a remote member also wakes it.",
+    "mention": "Mention…",
+    "mentionLabel": "Mention a member — {{comment}}",
+    "mentionMember": "Mention {{name}} — {{comment}}",
+    "mentionMemberSelected": "{{name}} (mentioned) — {{comment}}",
+    "mentionSelected": "{{name}} (mentioned)",
+    "mentionRemove": "Remove mention of {{name}} — {{comment}}",
+    "mentionNone": "Start a goal to mention members.",
+    "mentionNoneLabel": "Start a goal to mention members — {{comment}}",
+    "mentioned": "Mentioned: {{names}}",
+    "mentionSeparator": ", ",
+    "notAMember": "One of the mentioned members is not in the current goal. Remove it and try again.",
     "send": "Send",
     "sendComment": "Send comment",
     "sendReply": "Send reply to comment {{number}}",
@@ -134,7 +147,9 @@
     "invalidRequestId": "The request ID must be 1–64 letters, numbers, underscores, or hyphens.",
     "loadFailed": "The current goal could not be loaded. Try reloading it.",
     "startFailed": "The goal could not be fully started. Retry to finish creating the threads and sending the lead's brief.",
-    "remoteMembers": "Remote members:"
+    "remoteMembers": "Remote members:",
+    "item": "Goal work item #{{number}}: {{state}}",
+    "openItem": "Open details for goal work item #{{number}}"
   },
   "roster": {
     "title": "Roster",

package/locales/zh-CN.json

@@ -26,6 +26,7 @@
     "retryCreate": "重试创建",
     "saving": "保存中…",
     "moveTo": "移到…",
+    "goalItem": "目标",
     "moveItem": "移动工作项 #{{number}}",
     "moveItemTo": "将工作项 #{{number}} 移到 {{state}}",
     "assignTo": "指派给…",
@@ -68,6 +69,18 @@
     "reply": "回复",
     "replyTo": "回复第 {{number}} 条评论",
     "newComment": "发表评论",
+    "commentHint": "要叫醒成员，用「提及…」选择它（或输入 @），或在它的评论下点「回复」；在指派给远端成员、还没结束的工作项上评论也会叫醒它。",
+    "mention": "提及…",
+    "mentionLabel": "提及成员（{{comment}}）",
+    "mentionMember": "提及 {{name}}（{{comment}}）",
+    "mentionMemberSelected": "{{name}}（已提及）（{{comment}}）",
+    "mentionSelected": "{{name}}（已提及）",
+    "mentionRemove": "移除对 {{name}} 的提及（{{comment}}）",
+    "mentionNone": "先开始一个目标，才能提及成员。",
+    "mentionNoneLabel": "先开始一个目标，才能提及成员（{{comment}}）",
+    "mentioned": "提及：{{names}}",
+    "mentionSeparator": "、",
+    "notAMember": "被提及的成员里有人不在当前目标中，请移除后重试。",
     "send": "发送",
     "sendComment": "发送评论",
     "sendReply": "发送第 {{number}} 条评论的回复",
@@ -134,7 +147,9 @@
     "invalidRequestId": "请求 ID 需为 1 到 64 个字母、数字、下划线或连字符。",
     "loadFailed": "未能载入当前目标，请重新载入。",
     "startFailed": "目标未能全部开始，请重试以补齐会话并给负责人发话。",
-    "remoteMembers": "远端成员："
+    "remoteMembers": "远端成员：",
+    "item": "目标工作项 #{{number}}：{{state}}",
+    "openItem": "打开目标工作项 #{{number}} 的详情"
   },
   "roster": {
     "title": "名单",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/plugin-team",
-  "version": "0.2.3158",
+  "version": "0.2.3180",
   "description": "A project team roster with members, a lead, and goals.",
   "keywords": [
     "teams",
@@ -34,7 +34,7 @@
     "tailwindcss": "^4.0.0",
     "typescript": "~6.0.3",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.3158"
+    "@ycodium-ai/plugin-api": "0.2.3180"
   },
   "ycodium": {
     "plugin": "./dist/index.js",