@s_s/harmonia 1.3.0 → 1.4.0

package/build/tools/{approve-doc.js → artifact-approve.js}

@@ -1,29 +1,37 @@
 /**
- * MCP Tool: doc_approve / review_list
- * Approve or reject a document that is pending review.
+ * MCP Tool: artifact_approve / review_list
+ * Approve or reject an artifact that is pending review.
+ *
+ * After approval, triggers engine event `artifact_approved` to evaluate gates.
  */
 import { z } from 'zod';
 import { resolveReview, getPendingReviews } from '../core/reviews.js';
 import { resolveActive, isError } from './utils.js';
-export function registerApproveDoc(server) {
-    server.tool('doc_approve', 'Approve or reject a document pending review. Call this after the user has reviewed the document and confirmed (or requested changes).', {
+import { processWorkflowEvent, formatNextAction } from './engine-helpers.js';
+export function registerApproveArtifact(server, workflowsDir) {
+    server.tool('artifact_approve', 'Approve or reject an artifact pending review. Call this after the user has reviewed the artifact and confirmed (or requested changes).', {
         project_name: z.string().describe('Project name'),
-        doc_id: z.string().describe('Document ID to approve/reject'),
+        artifact_id: z.string().describe('Artifact ID to approve/reject'),
         approved: z.boolean().describe('true = approved, false = rejected (needs revision)'),
         comment: z.string().optional().describe('Optional comment — user feedback or reason for rejection'),
-    }, async ({ project_name, doc_id, approved, comment }) => {
+    }, async ({ project_name, artifact_id, approved, comment }) => {
         try {
             const ctx = await resolveActive(project_name);
             if (isError(ctx))
                 return ctx;
             const status = approved ? 'approved' : 'rejected';
-            const review = await resolveReview(project_name, ctx.number, doc_id, status, comment);
+            await resolveReview(project_name, ctx.number, artifact_id, status, comment, ctx.dir);
             if (approved) {
+                // Trigger engine event: artifact_approved
+                const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+                    type: 'artifact_approved',
+                    artifactId: artifact_id,
+                });
                 return {
                     content: [
                         {
                             type: 'text',
-                            text: `Document "${doc_id}" approved. You may proceed with the workflow.`,
+                            text: `Artifact "${artifact_id}" approved.` + formatNextAction(engineResult.nextAction),
                         },
                     ],
                 };
@@ -34,9 +42,9 @@ export function registerApproveDoc(server) {
                         {
                             type: 'text',
                             text: [
-                                `Document "${doc_id}" rejected.`,
+                                `Artifact "${artifact_id}" rejected.`,
                                 comment ? `User feedback: ${comment}` : '',
-                                `Please revise the document based on the feedback and call doc_write again.`,
+                                `Please revise the artifact based on the feedback and call artifact_write again.`,
                             ].join('\n'),
                         },
                     ],
@@ -55,32 +63,32 @@ export function registerApproveDoc(server) {
             };
         }
     });
-    server.tool('review_list', 'List all documents currently pending user review.', {
+    server.tool('review_list', 'List all artifacts currently pending user review.', {
         project_name: z.string().describe('Project name'),
     }, async ({ project_name }) => {
         const ctx = await resolveActive(project_name);
         if (isError(ctx))
             return ctx;
-        const pending = await getPendingReviews(project_name, ctx.number);
+        const pending = await getPendingReviews(project_name, ctx.number, ctx.dir);
         if (pending.length === 0) {
             return {
                 content: [
                     {
                         type: 'text',
-                        text: 'No documents pending review.',
+                        text: 'No artifacts pending review.',
                     },
                 ],
             };
         }
-        const list = pending.map((r) => `- ${r.docId} (submitted: ${r.submittedAt})`).join('\n');
+        const list = pending.map((r) => `- ${r.artifactId} (submitted: ${r.submittedAt})`).join('\n');
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Documents pending review:\n${list}`,
+                    text: `Artifacts pending review:\n${list}`,
                 },
             ],
         };
     });
 }
-//# sourceMappingURL=approve-doc.js.map
+//# sourceMappingURL=artifact-approve.js.map

package/build/tools/artifact-approve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-approve.js","sourceRoot":"","sources":["../../src/tools/artifact-approve.ts"],"names":[],"mappings":"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"}

package/build/tools/artifact-schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Tool: artifact_schema
+ *
+ * Query artifact structure requirements and writing guidance before writing.
+ * Returns human-readable schema guidance including required sections/fields,
+ * content boundaries, format requirements, and step-by-step constraints.
+ *
+ * Primarily used by coordinator (who is not dispatched and thus doesn't receive
+ * Artifact Requirements automatically via role_dispatch).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerArtifactSchema(server: McpServer, workflowsDir: string): void;

package/build/tools/artifact-schema.js

@@ -0,0 +1,148 @@
+/**
+ * MCP Tool: artifact_schema
+ *
+ * Query artifact structure requirements and writing guidance before writing.
+ * Returns human-readable schema guidance including required sections/fields,
+ * content boundaries, format requirements, and step-by-step constraints.
+ *
+ * Primarily used by coordinator (who is not dispatched and thus doesn't receive
+ * Artifact Requirements automatically via role_dispatch).
+ */
+import { z } from 'zod';
+import { loadArtifactSchema, formatSchemaGuidance } from '../core/schema.js';
+import { loadWorkflowForContext } from './engine-helpers.js';
+import { resolveActive, isError } from './utils.js';
+export function registerArtifactSchema(server, workflowsDir) {
+    server.tool('artifact_schema', 'Query artifact structure requirements and writing guidance. Call this before writing an artifact to understand required sections, content boundaries, and format constraints.', {
+        project_name: z.string().describe('Project name'),
+        artifact_id: z
+            .string()
+            .describe('Artifact ID (e.g. prd, user-stories, fsd, prototype, tech-design, task-breakdown, etc.)'),
+        step: z
+            .string()
+            .optional()
+            .describe("Step ID (e.g. requirements, draft, final). If specified, returns only that step's schema. If omitted, returns the full artifact schema including all steps."),
+    }, async ({ project_name, artifact_id, step }) => {
+        try {
+            const ctx = await resolveActive(project_name);
+            if (isError(ctx))
+                return ctx;
+            const { wf, state } = await loadWorkflowForContext(workflowsDir, project_name, ctx);
+            // Validate artifact_id exists in workflow
+            const artifactDef = wf.artifactDefinitions[artifact_id];
+            if (!artifactDef) {
+                const available = Object.keys(wf.artifactDefinitions).join(', ');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Artifact "${artifact_id}" not found in workflow. Available: ${available}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // If a specific step is requested, return only that step's schema
+            if (step) {
+                // Validate step exists in artifact definition
+                if (!artifactDef.steps || !artifactDef.steps.find((s) => s.id === step)) {
+                    const availableSteps = artifactDef.steps?.map((s) => s.id).join(', ') ?? '(无分步)';
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Step "${step}" not found for artifact "${artifact_id}". Available steps: ${availableSteps}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const stepSchema = await loadArtifactSchema(workflowsDir, state.workflow, `${artifact_id}.${step}`);
+                const stepDefFound = artifactDef.steps.find((s) => s.id === step);
+                const lines = [];
+                lines.push(`## Step 要求: ${artifact_id}.${step}（${stepDefFound.name}）`);
+                lines.push('');
+                lines.push(`格式: ${stepDefFound.format === 'json' ? 'JSON' : 'Markdown'}`);
+                lines.push(`描述: ${stepDefFound.description}`);
+                if (stepSchema) {
+                    if (stepSchema.guidance) {
+                        lines.push(`内容指引: ${stepSchema.guidance}`);
+                    }
+                    if (stepSchema.minLength) {
+                        lines.push(`最小长度: ${stepSchema.minLength} 字符`);
+                    }
+                    if (stepSchema.jsonFields) {
+                        const reqFields = stepSchema.jsonFields.filter((f) => f.required);
+                        if (reqFields.length > 0) {
+                            lines.push('');
+                            lines.push('### 必需 JSON 字段');
+                            for (const field of reqFields) {
+                                let desc = `- ${field.field}`;
+                                if (field.type)
+                                    desc += ` (${field.type})`;
+                                if (field.minItems)
+                                    desc += `, ≥${field.minItems} 项`;
+                                lines.push(desc);
+                            }
+                        }
+                    }
+                    if (stepSchema.sections) {
+                        const reqSections = stepSchema.sections.filter((s) => s.required);
+                        if (reqSections.length > 0) {
+                            lines.push('');
+                            lines.push('### 必需章节');
+                            for (const section of reqSections) {
+                                const heading = section.heading.replace(/^#+\s*/, '');
+                                lines.push(`- ${heading}`);
+                            }
+                        }
+                    }
+                }
+                else {
+                    lines.push('');
+                    lines.push('（此 step 无 schema 约束）');
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                };
+            }
+            // Full artifact schema
+            const schema = await loadArtifactSchema(workflowsDir, state.workflow, artifact_id);
+            // Load step schemas if artifact has steps
+            let stepSchemas;
+            if (artifactDef.steps && artifactDef.steps.length > 0) {
+                stepSchemas = [];
+                for (const s of artifactDef.steps) {
+                    const stepSchema = await loadArtifactSchema(workflowsDir, state.workflow, `${artifact_id}.${s.id}`);
+                    stepSchemas.push({ step: s, schema: stepSchema });
+                }
+            }
+            if (!schema && (!stepSchemas || stepSchemas.every((s) => !s.schema))) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Artifact "${artifact_id}" 无 schema 定义。`,
+                        },
+                    ],
+                };
+            }
+            const guidance = formatSchemaGuidance(artifact_id, artifactDef, schema, stepSchemas);
+            return {
+                content: [{ type: 'text', text: guidance }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=artifact-schema.js.map

package/build/tools/artifact-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-schema.js","sourceRoot":"","sources":["../../src/tools/artifact-schema.ts"],"names":[],"mappings":"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"}

package/build/tools/artifact-tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Tools: artifact_write / artifact_read / artifact_list
+ * Read and write project artifacts. Output paths are resolved per artifact
+ *
+ * artifact_write validates content against artifact schemas and checks review
+ * configuration. If validation fails, the write is rejected with specific
+ * error details. If review is required, the artifact is submitted for
+ * user approval.
+ *
+ * Sequential mode: When an artifact has `steps` defined in workflow.json,
+ * artifact_write requires a `step` parameter. Each step is validated
+ * independently, and the final step automatically writes the formal
+ * artifact and triggers the review flow.
+ *
+ * After writing, triggers engine event `artifact_written` to evaluate gates.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerArtifactTools(server: McpServer, workflowsDir: string): void;