@chorus-aidlc/chorus-openclaw-plugin 0.1.8 → 0.2.1

package/package.json

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

package/src/index.ts

@@ -8,6 +8,7 @@ import { ChorusEventRouter } from "./event-router.js";
 import { registerPmTools } from "./tools/pm-tools.js";
 import { registerDevTools } from "./tools/dev-tools.js";
 import { registerCommonTools } from "./tools/common-tools.js";
+import { registerAdminTools } from "./tools/admin-tools.js";
 import { registerChorusCommands } from "./commands.js";
 
 /**
@@ -134,6 +135,7 @@ const plugin = {
     registerPmTools(api, mcpClient);
     registerDevTools(api, mcpClient);
     registerCommonTools(api, mcpClient);
+    registerAdminTools(api, mcpClient);
 
     // --- Commands ---
     registerChorusCommands(api, mcpClient, () => sseListener?.status ?? "disconnected");

package/src/tools/admin-tools.ts

@@ -0,0 +1,76 @@
+import type { ChorusMcpClient } from "../mcp-client.js";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function registerAdminTools(api: any, mcpClient: ChorusMcpClient) {
+  api.registerTool({
+    name: "chorus_admin_create_project",
+    description: "Create a new project. Call chorus_get_project_groups first to find the right groupUuid.",
+    parameters: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Project name" },
+        description: { type: "string", description: "Project description" },
+        groupUuid: { type: "string", description: "Project group UUID (optional, use chorus_get_project_groups to list groups)" },
+      },
+      required: ["name"],
+      additionalProperties: false,
+    },
+    async execute(_id: string, { name, description, groupUuid }: { name: string; description?: string; groupUuid?: string }) {
+      const args: Record<string, unknown> = { name };
+      if (description) args.description = description;
+      if (groupUuid) args.groupUuid = groupUuid;
+      const result = await mcpClient.callTool("chorus_admin_create_project", args);
+      return JSON.stringify(result, null, 2);
+    },
+  });
+
+  api.registerTool({
+    name: "chorus_admin_create_project_group",
+    description: "Create a new project group for organizing projects.",
+    parameters: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Group name" },
+        description: { type: "string", description: "Group description" },
+      },
+      required: ["name"],
+      additionalProperties: false,
+    },
+    async execute(_id: string, { name, description }: { name: string; description?: string }) {
+      const args: Record<string, unknown> = { name };
+      if (description) args.description = description;
+      const result = await mcpClient.callTool("chorus_admin_create_project_group", args);
+      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/common-tools.ts

@@ -351,26 +351,35 @@ export function registerCommonTools(api: any, mcpClient: ChorusMcpClient) {
     },
   });
 
-  // --- Admin tools ---
+  // --- Project group tools ---
 
   api.registerTool({
-    name: "chorus_admin_create_project",
-    description: "Create a new project. Call chorus_get_project_groups first to find the right groupUuid.",
+    name: "chorus_get_project_groups",
+    description: "List all project groups. Returns groups with project counts and completion rates.",
+    parameters: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+    async execute() {
+      const result = await mcpClient.callTool("chorus_get_project_groups", {});
+      return JSON.stringify(result, null, 2);
+    },
+  });
+
+  api.registerTool({
+    name: "chorus_get_project_group",
+    description: "Get a single project group with its projects and stats.",
     parameters: {
       type: "object",
       properties: {
-        name: { type: "string", description: "Project name" },
-        description: { type: "string", description: "Project description" },
-        groupUuid: { type: "string", description: "Project group UUID (optional, use chorus_get_project_groups to list groups)" },
+        groupUuid: { type: "string", description: "Project group UUID" },
       },
-      required: ["name"],
+      required: ["groupUuid"],
       additionalProperties: false,
     },
-    async execute(_id: string, { name, description, groupUuid }: { name: string; description?: string; groupUuid?: string }) {
-      const args: Record<string, unknown> = { name };
-      if (description) args.description = description;
-      if (groupUuid) args.groupUuid = groupUuid;
-      const result = await mcpClient.callTool("chorus_admin_create_project", args);
+    async execute(_id: string, { groupUuid }: { groupUuid: string }) {
+      const result = await mcpClient.callTool("chorus_get_project_group", { groupUuid });
       return JSON.stringify(result, null, 2);
     },
   });

package/src/tools/dev-tools.ts

@@ -82,4 +82,35 @@ 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);
+    },
+  });
+
 }

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);