@s_s/harmonia 1.0.0 → 1.1.1

package/build/tools/doc-tools.js

@@ -1,27 +1,115 @@
 /**
- * MCP Tools: write_doc / read_doc / list_docs
+ * MCP Tools: doc_write / doc_read / doc_list
  * Read and write project documents under <data_dir>/<project_name>/docs/
  *
- * write_doc checks review configuration and auto-submits for review if needed.
+ * doc_write validates content against document schemas and checks review
+ * configuration. If validation fails, the write is rejected with specific
+ * error details. If review is required, the document is submitted for
+ * user approval.
+ *
+ * Sequential mode (P3): When a document has `steps` defined in workflow.json
+ * and the project scale is >= medium, doc_write requires a `step` parameter.
+ * Each step is validated independently, and the final step automatically
+ * writes the formal document and triggers the review flow.
  */
 import { z } from 'zod';
-import { writeDoc, readDoc, listDocs } from '../core/docs.js';
+import { writeDoc, readDoc, listDocs, writeStepArtifact } from '../core/docs.js';
 import { readState } from '../core/state.js';
 import { loadWorkflow } from '../core/workflow.js';
 import { getMergedOverrides, resolveDocReview } from '../core/overrides.js';
 import { submitForReview } from '../core/reviews.js';
-export function registerDocTools(server, workflowsDir) {
-    server.tool('write_doc', 'Write or update a project document. Automatically checks review configuration — if review is required, the document is submitted for user approval and you MUST present it to the user for confirmation before proceeding.', {
+import { loadDocSchema, validateDoc, formatValidationErrors } from '../core/schema.js';
+import { getDocStepState, getCompletedStepIds, recordStepCompletion, markFinalized } from '../core/steps.js';
+/** Scales that activate sequential mode (medium and above) */
+const SEQUENTIAL_SCALES = new Set(['medium', 'large']);
+/**
+ * Check if sequential mode is active for a given doc definition and scale.
+ * Returns false when scale is null (not yet set).
+ */
+function isSequentialActive(docDef, scale) {
+    return scale !== null && !!docDef.steps?.length && SEQUENTIAL_SCALES.has(scale);
+}
+export function registerDocTools(server, builtinDir, customDir) {
+    server.tool('doc_write', 'Write or update a project document. For documents with sequential steps (PRD, tech-design, task-breakdown) at medium/large scale, you MUST specify the step parameter. Automatically checks review configuration — if review is required, the document is submitted for user approval.', {
         project_name: z.string().describe('Project name'),
         doc_id: z
             .string()
             .describe('Document ID (e.g. prd, user-stories, fsd, prototype, tech-design, task-breakdown, etc.)'),
-        content: z.string().describe('Document content (markdown or HTML depending on doc type)'),
-    }, async ({ project_name, doc_id, content }) => {
+        content: z.string().describe('Document content (markdown, HTML, or JSON depending on doc type and step)'),
+        step: z
+            .string()
+            .optional()
+            .describe('Sequential step ID (required for docs with steps at medium/large scale). Use project_status to see available steps.'),
+    }, async ({ project_name, doc_id, content, step }) => {
         // Load workflow to get doc definition (format, review defaults)
         const state = await readState(project_name);
-        const wf = await loadWorkflow(workflowsDir, state.workflow);
+        const wf = await loadWorkflow(builtinDir, customDir, state.workflow);
         const docDef = wf.definition.docs[doc_id];
+        const isHtml = docDef?.format === 'html';
+        // Guard: doc_id must be defined in workflow
+        if (!docDef) {
+            const validIds = Object.keys(wf.definition.docs)
+                .filter((id) => !wf.definition.docs[id].external)
+                .join(', ');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `文档类型 "${doc_id}" 未在工作流中定义。可用的文档类型: ${validIds}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Guard: reject external doc types (should be produced outside doc_write)
+        if (docDef.external) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `文档 "${doc_id}" 是外部产出类型，不应通过 doc_write 写入。`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Guard: empty content
+        if (!content.trim()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: '文档内容为空，请提供实际内容后重新提交。',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // ─── Sequential Mode ───
+        if (isSequentialActive(docDef, state.scale)) {
+            return handleSequentialWrite(builtinDir, customDir, state.workflow, project_name, doc_id, content, step, docDef, state.scale);
+        }
+        // ─── Normal Mode (no steps or small scale) ───
+        // If step was passed but sequential is not active, warn but proceed
+        if (step) {
+            // Ignore step parameter for non-sequential docs
+        }
+        // Schema validation — reject write if content doesn't meet requirements
+        const schema = await loadDocSchema(builtinDir, customDir, state.workflow, doc_id);
+        if (schema) {
+            const result = validateDoc(content, schema, state.scale, isHtml);
+            if (!result.valid) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatValidationErrors(result.errors),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
         // Write the document with correct extension
         const filePath = await writeDoc(project_name, doc_id, content, docDef);
         // Check if review is required
@@ -40,8 +128,8 @@ export function registerDocTools(server, workflowsDir) {
                             `** REVIEW REQUIRED **`,
                             `This document requires user approval before the workflow can proceed.`,
                             `Please present the document content to the user and ask for their confirmation.`,
-                            `After user approval, call approve_doc with project_name="${project_name}" and doc_id="${doc_id}".`,
-                            `If the user requests changes, revise the document and call write_doc again.`,
+                            `After user approval, call doc_approve with project_name="${project_name}" and doc_id="${doc_id}".`,
+                            `If the user requests changes, revise the document and call doc_write again.`,
                         ].join('\n'),
                     },
                 ],
@@ -56,7 +144,7 @@ export function registerDocTools(server, workflowsDir) {
             ],
         };
     });
-    server.tool('read_doc', 'Read a project document from the project docs directory.', {
+    server.tool('doc_read', 'Read a project document from the project docs directory.', {
         project_name: z.string().describe('Project name'),
         doc_id: z.string().describe('Document ID to read'),
     }, async ({ project_name, doc_id }) => {
@@ -76,14 +164,14 @@ export function registerDocTools(server, workflowsDir) {
                 content: [
                     {
                         type: 'text',
-                        text: `Document "${doc_id}" not found. Use list_docs to see available documents.`,
+                        text: `Document "${doc_id}" not found. Use doc_list to see available documents.`,
                     },
                 ],
                 isError: true,
             };
         }
     });
-    server.tool('list_docs', 'List all project documents in the project docs directory.', {
+    server.tool('doc_list', 'List all project documents in the project docs directory.', {
         project_name: z.string().describe('Project name'),
     }, async ({ project_name }) => {
         const docs = await listDocs(project_name);
@@ -99,4 +187,160 @@ export function registerDocTools(server, workflowsDir) {
         };
     });
 }
+async function handleSequentialWrite(builtinDir, customDir, workflowName, projectName, docId, content, step, docDef, scale) {
+    const steps = docDef.steps;
+    const stepIds = steps.map((s) => s.id);
+    const stepNames = steps.map((s) => `${s.id} (${s.name})`).join(', ');
+    // Guard: step parameter is required in sequential mode
+    if (!step) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `文档 "${docId}" 在 ${scale} 规模项目中需要分步写入。`,
+                        `请指定 step 参数。可用的步骤: ${stepNames}`,
+                        ``,
+                        `步骤说明:`,
+                        ...steps.map((s, i) => `  ${i + 1}. ${s.id} — ${s.description}`),
+                    ].join('\n'),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Guard: step must be valid
+    const stepDef = steps.find((s) => s.id === step);
+    if (!stepDef) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `未知的步骤 "${step}"。可用的步骤: ${stepNames}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const stepIndex = stepIds.indexOf(step);
+    const stepState = await getDocStepState(projectName, docId);
+    const completedIds = getCompletedStepIds(stepState);
+    // Guard: prerequisite steps must be completed (hard enforcement)
+    for (let i = 0; i < stepIndex; i++) {
+        if (!completedIds.has(stepIds[i])) {
+            const missingStep = steps[i];
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `无法写入步骤 "${step}"：前置步骤 "${missingStep.id}" (${missingStep.name}) 尚未完成。请先完成该步骤。`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Step schema validation
+    const isJson = stepDef.format === 'json';
+    const stepSchemaId = `${docId}.${step}`;
+    const stepSchema = await loadDocSchema(builtinDir, customDir, workflowName, stepSchemaId);
+    if (stepSchema) {
+        const result = validateDoc(content, stepSchema, scale, false, isJson);
+        if (!result.valid) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatValidationErrors(result.errors),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Write the step artifact
+    const artifactPath = await writeStepArtifact(projectName, docId, step, content, stepDef.format);
+    // Record step completion (handles rollback if overwriting)
+    await recordStepCompletion(projectName, docId, step, artifactPath, stepIds);
+    const isLastStep = stepIndex === steps.length - 1;
+    if (isLastStep) {
+        // Auto-merge: validate against final doc schema, write formal doc, trigger review
+        return handleFinalStep(builtinDir, customDir, workflowName, projectName, docId, content, docDef, scale, stepDef);
+    }
+    // Not the last step — return progress info
+    const nextStep = steps[stepIndex + 1];
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `步骤 "${step}" (${stepDef.name}) 完成，产物已写入 ${artifactPath}`,
+                    ``,
+                    `下一步: ${nextStep.id} — ${nextStep.description}`,
+                    `请调用 doc_write(project_name="${projectName}", doc_id="${docId}", step="${nextStep.id}", content=...)`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+async function handleFinalStep(builtinDir, customDir, workflowName, projectName, docId, content, docDef, scale, stepDef) {
+    const isHtml = docDef.format === 'html';
+    // Validate against the final document schema (e.g. prd.json)
+    const finalSchema = await loadDocSchema(builtinDir, customDir, workflowName, docId);
+    if (finalSchema) {
+        const isJson = stepDef.format === 'json';
+        const result = validateDoc(content, finalSchema, scale, isHtml, isJson);
+        if (!result.valid) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            '最终文档校验失败:',
+                            formatValidationErrors(result.errors),
+                            '',
+                            `请修正后重新提交步骤 "${stepDef.id}"。`,
+                        ].join('\n'),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Write the formal document
+    const filePath = await writeDoc(projectName, docId, content, docDef);
+    // Mark as finalized
+    await markFinalized(projectName, docId);
+    // Check if review is required
+    const overrides = await getMergedOverrides(projectName);
+    const needsReview = resolveDocReview(docId, docDef, overrides);
+    if (needsReview) {
+        await submitForReview(projectName, docId);
+        const docName = docDef.name ?? docId;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `所有步骤完成！文档 "${docId}" (${docName}) 已写入 ${filePath}`,
+                        ``,
+                        `** REVIEW REQUIRED **`,
+                        `This document requires user approval before the workflow can proceed.`,
+                        `Please present the document content to the user and ask for their confirmation.`,
+                        `After user approval, call doc_approve with project_name="${projectName}" and doc_id="${docId}".`,
+                        `If the user requests changes, revise the document and call doc_write again with the appropriate step.`,
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `所有步骤完成！文档 "${docId}" 已写入 ${filePath}`,
+            },
+        ],
+    };
+}
 //# sourceMappingURL=doc-tools.js.map

package/build/tools/doc-tools.js.map

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

package/build/tools/get-project-status.d.ts

@@ -1,8 +1,10 @@
 /**
- * MCP Tool: get_project_status
+ * MCP Tool: project_status
  * Read the current project status with rich context for PM decision-making.
  * Includes phase progress, documents, pending reviews, dispatch records,
  * active sessions, and intelligent next-step suggestions.
+ *
+ * When called without project_name, returns a summary list of all projects.
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerGetProjectStatus(server: McpServer, workflowsDir: string): void;
+export declare function registerGetProjectStatus(server: McpServer, builtinDir: string, customDir: string): void;