@chorus-aidlc/chorus-openclaw-plugin 0.1.7 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chorus-aidlc/chorus-openclaw-plugin",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "OpenClaw plugin for Chorus AI-DLC collaboration platform — SSE real-time events + MCP tool integration",
   "license": "MIT",
   "type": "module",

package/src/event-router.ts

@@ -120,6 +120,12 @@ export class ChorusEventRouter {
         case "idea_claimed":
           this.handleIdeaClaimed(notification);
           break;
+        case "task_verified":
+          this.handleTaskVerified(notification);
+          break;
+        case "task_reopened":
+          this.handleTaskReopened(notification);
+          break;
         default:
           this.logger.info(`Unhandled notification action: "${notification.action}"`);
           break;
@@ -217,6 +223,24 @@ export class ChorusEventRouter {
     );
   }
 
+  private handleTaskVerified(n: NotificationDetail): void {
+    this.triggerAgent(
+      `[Chorus] Task '${n.entityTitle}' has been verified and is now done (taskUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). ` +
+      `Check if this unblocks other tasks: use chorus_get_unblocked_tasks with projectUuid "${n.projectUuid}" to find tasks that are now ready to start.`,
+      { notificationUuid: n.uuid, action: "task_verified", entityUuid: n.entityUuid, projectUuid: n.projectUuid }
+    );
+  }
+
+  private handleTaskReopened(n: NotificationDetail): void {
+    const mentionGuidance = this.buildMentionGuidance(n, "task");
+
+    this.triggerAgent(
+      `[Chorus] Task '${n.entityTitle}' has been reopened and needs rework (taskUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). ` +
+      `Use chorus_get_task to review the task and chorus_get_comments to see verification feedback, then fix the issues.\n${mentionGuidance}`,
+      { notificationUuid: n.uuid, action: "task_reopened", entityUuid: n.entityUuid, projectUuid: n.projectUuid }
+    );
+  }
+
   private handleElaborationAnswered(n: NotificationDetail): void {
     const mentionGuidance = this.buildMentionGuidance(n, "idea");
 

package/src/tools/common-tools.ts

@@ -260,7 +260,7 @@ export function registerCommonTools(api: any, mcpClient: ChorusMcpClient) {
 
   api.registerTool({
     name: "chorus_get_unblocked_tasks",
-    description: "Get tasks that are ready to start — status is open/assigned and all dependencies are resolved (done/to_verify).",
+    description: "Get tasks that are ready to start — status is open/assigned and all dependencies are resolved (done/closed). Note: to_verify is NOT considered resolved.",
     parameters: {
       type: "object",
       properties: {

package/src/tools/dev-tools.ts

@@ -21,7 +21,7 @@ export function registerDevTools(api: any, mcpClient: ChorusMcpClient) {
 
   api.registerTool({
     name: "chorus_update_task",
-    description: "Update task status (only the assignee can operate)",
+    description: "Update task status (only the assignee can operate). Moving to in_progress requires all dependsOn tasks to be done or closed — otherwise the request is rejected with blocker details. Use chorus_get_unblocked_tasks to find tasks ready to start.",
     parameters: {
       type: "object",
       properties: {
@@ -82,4 +82,64 @@ export function registerDevTools(api: any, mcpClient: ChorusMcpClient) {
       return JSON.stringify(result, null, 2);
     },
   });
+
+  api.registerTool({
+    name: "chorus_report_criteria_self_check",
+    description: "Report self-check results on acceptance criteria for a task you're working on. For required criteria, keep working until all pass. Only mark optional criteria as failed if out of scope.",
+    parameters: {
+      type: "object",
+      properties: {
+        taskUuid: { type: "string", description: "Task UUID" },
+        criteria: {
+          type: "array",
+          description: "Array of { uuid, devStatus: 'passed'|'failed', devEvidence?: string }",
+          items: {
+            type: "object",
+            properties: {
+              uuid: { type: "string", description: "AcceptanceCriterion UUID" },
+              devStatus: { type: "string", description: "Self-check result: passed | failed" },
+              devEvidence: { type: "string", description: "Optional evidence/notes" },
+            },
+            required: ["uuid", "devStatus"],
+          },
+        },
+      },
+      required: ["taskUuid", "criteria"],
+      additionalProperties: false,
+    },
+    async execute(_id: string, { taskUuid, criteria }: { taskUuid: string; criteria: Array<{ uuid: string; devStatus: string; devEvidence?: string }> }) {
+      const result = await mcpClient.callTool("chorus_report_criteria_self_check", { taskUuid, criteria });
+      return JSON.stringify(result, null, 2);
+    },
+  });
+
+  api.registerTool({
+    name: "chorus_mark_acceptance_criteria",
+    description: "Mark acceptance criteria as passed or failed (admin verification). Blocked criteria prevent task from being verified (to_verify -> done).",
+    parameters: {
+      type: "object",
+      properties: {
+        taskUuid: { type: "string", description: "Task UUID" },
+        criteria: {
+          type: "array",
+          description: "Array of { uuid, status: 'passed'|'failed', evidence?: string }",
+          items: {
+            type: "object",
+            properties: {
+              uuid: { type: "string", description: "AcceptanceCriterion UUID" },
+              status: { type: "string", description: "Verification result: passed | failed" },
+              evidence: { type: "string", description: "Optional evidence/notes" },
+            },
+            required: ["uuid", "status"],
+          },
+        },
+      },
+      required: ["taskUuid", "criteria"],
+      additionalProperties: false,
+    },
+    async execute(_id: string, { taskUuid, criteria }: { taskUuid: string; criteria: Array<{ uuid: string; status: string; evidence?: string }> }) {
+      const result = await mcpClient.callTool("chorus_mark_acceptance_criteria", { taskUuid, criteria });
+      return JSON.stringify(result, null, 2);
+    },
+  });
 }

package/src/tools/pm-tools.ts

@@ -108,7 +108,7 @@ export function registerPmTools(api: any, mcpClient: ChorusMcpClient) {
         inputUuids: { type: "array", description: "Array of input UUIDs", items: { type: "string" } },
         description: { type: "string", description: "Proposal description" },
         documentDrafts: { type: "array", description: "Array of { type, title, content }", items: { type: "object" } },
-        taskDrafts: { type: "array", description: "Array of { title, description?, priority?, storyPoints?, acceptanceCriteria?, dependsOnDraftUuids? }", items: { type: "object" } },
+        taskDrafts: { type: "array", description: "Array of { title, description?, priority?, storyPoints?, acceptanceCriteriaItems?, dependsOnDraftUuids? }", items: { type: "object" } },
       },
       required: ["projectUuid", "title", "inputType", "inputUuids"],
       additionalProperties: false,
@@ -158,20 +158,20 @@ export function registerPmTools(api: any, mcpClient: ChorusMcpClient) {
         description: { type: "string", description: "Task description" },
         priority: { type: "string", description: 'Priority: "low", "medium", or "high"' },
         storyPoints: { type: "number", description: "Effort estimate in agent hours" },
-        acceptanceCriteria: { type: "string", description: "Acceptance criteria in Markdown" },
+        acceptanceCriteriaItems: { type: "array", description: "Structured acceptance criteria: [{ description, required? }]", items: { type: "object", properties: { description: { type: "string" }, required: { type: "boolean" } }, required: ["description"] } },
         dependsOnDraftUuids: { type: "array", description: "Dependent task draft UUIDs", items: { type: "string" } },
       },
       required: ["proposalUuid", "title"],
       additionalProperties: false,
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async execute(_id: string, { proposalUuid, title, description, priority, storyPoints, acceptanceCriteria, dependsOnDraftUuids }: any) {
+    async execute(_id: string, { proposalUuid, title, description, priority, storyPoints, acceptanceCriteriaItems, dependsOnDraftUuids }: any) {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       const args: Record<string, any> = { proposalUuid, title };
       if (description !== undefined) args.description = description;
       if (priority !== undefined) args.priority = priority;
       if (storyPoints !== undefined) args.storyPoints = storyPoints;
-      if (acceptanceCriteria !== undefined) args.acceptanceCriteria = acceptanceCriteria;
+      if (acceptanceCriteriaItems !== undefined) args.acceptanceCriteriaItems = acceptanceCriteriaItems;
       if (dependsOnDraftUuids !== undefined) args.dependsOnDraftUuids = dependsOnDraftUuids;
       const result = await mcpClient.callTool("chorus_pm_add_task_draft", args);
       return JSON.stringify(result, null, 2);
@@ -237,21 +237,21 @@ export function registerPmTools(api: any, mcpClient: ChorusMcpClient) {
         description: { type: "string", description: "New task description" },
         priority: { type: "string", description: 'Priority: "low", "medium", or "high"' },
         storyPoints: { type: "number", description: "Effort estimate in agent hours" },
-        acceptanceCriteria: { type: "string", description: "Acceptance criteria in Markdown" },
+        acceptanceCriteriaItems: { type: "array", description: "Structured acceptance criteria: [{ description, required? }]", items: { type: "object", properties: { description: { type: "string" }, required: { type: "boolean" } }, required: ["description"] } },
         dependsOnDraftUuids: { type: "array", description: "Task draft UUIDs this task depends on (sets execution order)", items: { type: "string" } },
       },
       required: ["proposalUuid", "draftUuid"],
       additionalProperties: false,
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async execute(_id: string, { proposalUuid, draftUuid, title, description, priority, storyPoints, acceptanceCriteria, dependsOnDraftUuids }: any) {
+    async execute(_id: string, { proposalUuid, draftUuid, title, description, priority, storyPoints, acceptanceCriteriaItems, dependsOnDraftUuids }: any) {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       const args: Record<string, any> = { proposalUuid, draftUuid };
       if (title !== undefined) args.title = title;
       if (description !== undefined) args.description = description;
       if (priority !== undefined) args.priority = priority;
       if (storyPoints !== undefined) args.storyPoints = storyPoints;
-      if (acceptanceCriteria !== undefined) args.acceptanceCriteria = acceptanceCriteria;
+      if (acceptanceCriteriaItems !== undefined) args.acceptanceCriteriaItems = acceptanceCriteriaItems;
       if (dependsOnDraftUuids !== undefined) args.dependsOnDraftUuids = dependsOnDraftUuids;
       const result = await mcpClient.callTool("chorus_pm_update_task_draft", args);
       return JSON.stringify(result, null, 2);