@s_s/harmonia 1.0.0 → 1.1.1

package/build/tools/update-phase.js

@@ -1,14 +1,22 @@
 /**
- * MCP Tool: update_phase
+ * MCP Tool: phase_update
  * Advance or update the status of a project phase.
- * When completing a phase, checks that all doc-type outputs exist (output guard).
+ *
+ * Guards (when completing a phase with force!=true):
+ * - Prior phases must all be completed
+ * - Required doc outputs must exist
+ * - Docs requiring review must be approved
+ * - No active (dispatched/running) dispatches in the phase
  */
 import { z } from 'zod';
 import { readState, updatePhaseStatus } from '../core/state.js';
 import { loadWorkflow } from '../core/workflow.js';
 import { listDocs } from '../core/docs.js';
-export function registerUpdatePhase(server, workflowsDir) {
-    server.tool('update_phase', 'Update the status of a project phase. When a phase is completed, the next phase is automatically started. Completing a phase checks that all required doc outputs exist.', {
+import { readReviews } from '../core/reviews.js';
+import { readDispatches } from '../core/dispatch.js';
+import { getMergedOverrides, resolveDocReview } from '../core/overrides.js';
+export function registerUpdatePhase(server, builtinDir, customDir) {
+    server.tool('phase_update', 'Update the status of a project phase. When a phase is completed, the next phase is automatically started. Completing a phase checks that all required doc outputs exist.', {
         project_name: z.string().describe('Project name'),
         phase_id: z.string().describe('Phase ID to update (e.g. clarify, design, develop, test, deliver)'),
         status: z.enum(['pending', 'in_progress', 'completed', 'blocked']).describe('New status for the phase'),
@@ -16,36 +24,93 @@ export function registerUpdatePhase(server, workflowsDir) {
         force: z.boolean().optional().describe('Force completion even if outputs are missing (default: false)'),
     }, async ({ project_name, phase_id, status, blocked_reason, force }) => {
         try {
-            // Output guard: when completing a phase, check doc outputs exist
+            // ── Completion guards ──
             if (status === 'completed' && !force) {
                 const currentState = await readState(project_name);
-                const wf = await loadWorkflow(workflowsDir, currentState.workflow);
+                const wf = await loadWorkflow(builtinDir, customDir, currentState.workflow);
                 const existingDocs = await listDocs(project_name);
                 const phaseDef = wf.definition.phases.find((p) => p.id === phase_id);
-                if (phaseDef) {
+                const phaseIndex = wf.definition.phases.findIndex((p) => p.id === phase_id);
+                const guardErrors = [];
+                // Guard 0: Scale must be set before completing any phase
+                if (currentState.scale === null) {
+                    guardErrors.push('Scale 尚未设定。请先调用 project_set_scale 设定项目规模。');
+                }
+                // Guard 1: Prior phases must all be completed
+                if (phaseIndex > 0) {
+                    const priorPhases = wf.definition.phases.slice(0, phaseIndex);
+                    const incompletePriors = priorPhases.filter((pp) => {
+                        const ps = currentState.phases.find((s) => s.id === pp.id);
+                        return !ps || ps.status !== 'completed';
+                    });
+                    if (incompletePriors.length > 0) {
+                        guardErrors.push(`前序阶段未完成: ${incompletePriors.map((p) => p.id).join(', ')}`);
+                    }
+                }
+                // Guard 2 & 3 require scale to be set
+                if (currentState.scale !== null && phaseDef) {
+                    const scale = currentState.scale;
+                    // Guard 2: Required doc outputs must exist
                     const missingDocOutputs = phaseDef.outputs.filter((o) => {
                         const docDef = wf.definition.docs[o];
                         if (!docDef)
-                            return false; // unknown output, skip
+                            return false;
                         if (docDef.external)
-                            return false; // external outputs not managed by write_doc
-                        const scaleVal = docDef.scale[currentState.scale];
+                            return false;
+                        const scaleVal = docDef.scale[scale];
                         if (scaleVal === 'skip' || scaleVal === 'optional')
-                            return false; // not required at this scale
+                            return false;
                         return !existingDocs.includes(o);
                     });
                     if (missingDocOutputs.length > 0) {
-                        return {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: `Cannot complete phase "${phase_id}" — missing doc outputs: ${missingDocOutputs.join(', ')}.\n\nProduce these documents with write_doc first, or use force=true to skip this check.`,
-                                },
-                            ],
-                            isError: true,
-                        };
+                        guardErrors.push(`缺少必需文档产出: ${missingDocOutputs.join(', ')}`);
+                    }
+                    // Guard 3: Docs requiring review must be approved
+                    const overrides = await getMergedOverrides(project_name);
+                    const reviews = await readReviews(project_name);
+                    const unapprovedDocs = phaseDef.outputs.filter((o) => {
+                        const docDef = wf.definition.docs[o];
+                        if (!docDef)
+                            return false;
+                        if (docDef.external)
+                            return false;
+                        const scaleVal = docDef.scale[scale];
+                        if (scaleVal === 'skip' || scaleVal === 'optional')
+                            return false;
+                        const needsReview = resolveDocReview(o, docDef, overrides);
+                        if (!needsReview)
+                            return false;
+                        const reviewState = reviews[o];
+                        return !reviewState || reviewState.status !== 'approved';
+                    });
+                    if (unapprovedDocs.length > 0) {
+                        guardErrors.push(`文档待审核或未通过: ${unapprovedDocs.join(', ')}`);
                     }
                 }
+                // Guard 4: No active dispatches
+                const dispatches = await readDispatches(project_name);
+                const activeDispatches = dispatches.filter((d) => d.status === 'dispatched' || d.status === 'running');
+                if (activeDispatches.length > 0) {
+                    const activeList = activeDispatches.map((d) => `${d.id} (${d.role}, ${d.status})`).join(', ');
+                    guardErrors.push(`存在进行中的 dispatch: ${activeList}`);
+                }
+                if (guardErrors.length > 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: [
+                                    `无法完成阶段 "${phase_id}"：`,
+                                    '',
+                                    ...guardErrors.map((e) => `- ${e}`),
+                                    '',
+                                    '请先解决以上问题，或使用 force=true 强制完成。',
+                                ].join('\n'),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
             }
             const state = await updatePhaseStatus(project_name, phase_id, status, blocked_reason);
             const phasesSummary = state.phases

package/build/tools/update-phase.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s_s/harmonia",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Multi-agent orchestration MCP server with pluggable workflows",
   "type": "module",
   "main": "./build/index.js",
@@ -34,6 +34,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@s_s/agent-kit": "^1.2.1",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"
   },

package/workflows/dev/roles/architect.md

@@ -62,5 +62,5 @@ capabilities:
 
 1. **代码为据**：技术决策基于实际代码分析，不凭空假设
 2. **任务可执行**：拆解出的每个任务要足够具体，开发者拿到就能开始
-3. **文档落地**：技术方案、任务拆解必须通过 write_doc 工具写入
+3. **文档落地**：技术方案、任务拆解必须通过 doc_write 工具写入
 4. **不做需求决策**：技术不确定时反馈给 PM，由 PM 与用户确认

package/workflows/dev/roles/pm.md

@@ -79,21 +79,21 @@ capabilities:
 
 ## 文档审核流程
 
-某些文档需要用户审核确认后才能继续流程。当 write_doc 工具返回"REVIEW REQUIRED"提示时：
+某些文档需要用户审核确认后才能继续流程。当 doc_write 工具返回"REVIEW REQUIRED"提示时：
 
 1. **展示文档**：将完整的文档内容展示给用户
 2. **等待确认**：询问用户是否认可，或是否需要修改
 3. **处理反馈**：
-   - 用户认可 → 调用 approve_doc 工具，然后继续流程
-   - 用户要求修改 → 根据反馈修改文档，重新调用 write_doc
-   - 用户拒绝 → 调用 approve_doc（approved=false）并附上用户的反馈
+   - 用户认可 → 调用 doc_approve 工具，然后继续流程
+   - 用户要求修改 → 根据反馈修改文档，重新调用 doc_write
+   - 用户拒绝 → 调用 doc_approve（approved=false）并附上用户的反馈
 
 **不要跳过审核流程。** 未经用户确认的文档不应作为后续阶段的输入。
 
 ## 行为规则
 
 1. **用户沟通优先**：你是唯一直接与用户对话的角色，其他角色通过你中转
-2. **文档驱动**：每个阶段的产出必须落地为文档，通过 write_doc 工具写入
+2. **文档驱动**：每个阶段的产出必须落地为文档，通过 doc_write 工具写入
 3. **状态可见**：每次阶段变更都更新 state.json
 4. **裁剪优先**：小项目不要生成不必要的文档，保持精简
 5. **不越权**：不要替架构师做技术决策，不要替开发者写代码

package/workflows/dev/roles/tester.md

@@ -40,5 +40,5 @@ capabilities:
 
 1. **需求驱动**：测试用例基于需求文档和用户故事的验收标准
 2. **客观报告**：如实报告测试结果，不掩盖问题
-3. **文档落地**：测试计划和报告必须通过 write_doc 工具写入
+3. **文档落地**：测试计划和报告必须通过 doc_write 工具写入
 4. **不修代码**：发现 bug 反馈给 PM，不自行修复

package/workflows/dev/schemas/api-design.json

@@ -0,0 +1,25 @@
+{
+    "sections": [
+        {
+            "heading": "## 端点列表",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## API Endpoints", "## 接口列表", "## Endpoints"]
+        },
+        {
+            "heading": "## 请求/响应格式",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Request/Response", "## 数据格式", "## 请求响应"]
+        },
+        {
+            "heading": "## 错误码",
+            "required": { "small": false, "medium": false, "large": true },
+            "aliases": ["## Error Codes", "## 错误处理", "## 异常码"]
+        },
+        {
+            "heading": "## 认证与授权",
+            "required": { "small": false, "medium": false, "large": true },
+            "aliases": ["## Authentication", "## Auth", "## 权限"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/data-model.json

@@ -0,0 +1,20 @@
+{
+    "sections": [
+        {
+            "heading": "## 数据模型",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Data Model", "## 数据设计", "## 数据结构"]
+        },
+        {
+            "heading": "## 实体关系",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Entity Relationships", "## ER 图", "## 关系设计"]
+        },
+        {
+            "heading": "## 字段定义",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Field Definitions", "## 字段说明", "## 表结构"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/deploy.json

@@ -0,0 +1,20 @@
+{
+    "sections": [
+        {
+            "heading": "## 部署环境",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Deployment Environment", "## 环境要求", "## 运行环境"]
+        },
+        {
+            "heading": "## 部署步骤",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Deployment Steps", "## 部署流程", "## 安装步骤"]
+        },
+        {
+            "heading": "## 配置说明",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Configuration", "## 环境配置", "## 配置项"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/fsd.json

@@ -0,0 +1,25 @@
+{
+    "sections": [
+        {
+            "heading": "## 功能概述",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Feature Overview", "## 功能说明"]
+        },
+        {
+            "heading": "## 功能规格",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Functional Specifications", "## 详细规格", "## 功能详情"]
+        },
+        {
+            "heading": "## 交互流程",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Interaction Flow", "## 用户流程", "## 交互设计"]
+        },
+        {
+            "heading": "## 边界条件",
+            "required": { "small": false, "medium": false, "large": true },
+            "aliases": ["## Edge Cases", "## 边界情况", "## 异常处理"]
+        }
+    ],
+    "minLength": 200
+}

package/workflows/dev/schemas/prd.completeness-check.json

@@ -0,0 +1,24 @@
+{
+    "jsonFields": [
+        {
+            "field": "coverage",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "object"
+        },
+        {
+            "field": "missing",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "array"
+        },
+        {
+            "field": "conflicts",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "array"
+        },
+        {
+            "field": "verdict",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "string"
+        }
+    ]
+}

package/workflows/dev/schemas/prd.draft.json

@@ -0,0 +1,15 @@
+{
+    "sections": [
+        {
+            "heading": "## 项目概述",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Project Overview", "## 概述"]
+        },
+        {
+            "heading": "## 功能需求",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Functional Requirements", "## 需求列表", "## 功能列表"]
+        }
+    ],
+    "minLength": 150
+}

package/workflows/dev/schemas/prd.final.json

@@ -0,0 +1,30 @@
+{
+    "sections": [
+        {
+            "heading": "## 项目概述",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Project Overview", "## 概述"]
+        },
+        {
+            "heading": "## 功能需求",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Functional Requirements", "## 需求列表", "## 功能列表"]
+        },
+        {
+            "heading": "## 非功能需求",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Non-Functional Requirements", "## 非功能性需求"]
+        },
+        {
+            "heading": "## 验收标准",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Acceptance Criteria", "## 验收条件"]
+        },
+        {
+            "heading": "## 约束与假设",
+            "required": { "small": false, "medium": false, "large": true },
+            "aliases": ["## Constraints and Assumptions", "## 约束条件", "## 前提假设"]
+        }
+    ],
+    "minLength": 200
+}

package/workflows/dev/schemas/prd.json

@@ -0,0 +1,30 @@
+{
+    "sections": [
+        {
+            "heading": "## 项目概述",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Project Overview", "## 概述"]
+        },
+        {
+            "heading": "## 功能需求",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Functional Requirements", "## 需求列表", "## 功能列表"]
+        },
+        {
+            "heading": "## 非功能需求",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Non-Functional Requirements", "## 非功能性需求"]
+        },
+        {
+            "heading": "## 验收标准",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Acceptance Criteria", "## 验收条件"]
+        },
+        {
+            "heading": "## 约束与假设",
+            "required": { "small": false, "medium": false, "large": true },
+            "aliases": ["## Constraints and Assumptions", "## 约束条件", "## 前提假设"]
+        }
+    ],
+    "minLength": 200
+}

package/workflows/dev/schemas/prd.requirements.json

@@ -0,0 +1,25 @@
+{
+    "jsonFields": [
+        {
+            "field": "features",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "array",
+            "minItems": 1
+        },
+        {
+            "field": "constraints",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "array"
+        },
+        {
+            "field": "priorities",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "object"
+        },
+        {
+            "field": "scope",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "string"
+        }
+    ]
+}

package/workflows/dev/schemas/project-plan.json

@@ -0,0 +1,20 @@
+{
+    "sections": [
+        {
+            "heading": "## 项目计划",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Project Plan", "## 计划概述"]
+        },
+        {
+            "heading": "## 里程碑",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Milestones", "## 关键节点"]
+        },
+        {
+            "heading": "## 时间安排",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Timeline", "## 排期", "## 时间线"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/prototype.json

@@ -0,0 +1,4 @@
+{
+    "htmlTags": ["html", "body"],
+    "minLength": 200
+}

package/workflows/dev/schemas/retrospective.json

@@ -0,0 +1,20 @@
+{
+    "sections": [
+        {
+            "heading": "## 项目总结",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Summary", "## 总结", "## 项目概要"]
+        },
+        {
+            "heading": "## 经验教训",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Lessons Learned", "## 收获与反思"]
+        },
+        {
+            "heading": "## 改进建议",
+            "required": { "small": false, "medium": false, "large": true },
+            "aliases": ["## Improvements", "## 后续改进", "## 待改进"]
+        }
+    ],
+    "minLength": 50
+}

package/workflows/dev/schemas/risk-assessment.json

@@ -0,0 +1,15 @@
+{
+    "sections": [
+        {
+            "heading": "## 风险项",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Risks", "## 风险列表", "## 风险清单"]
+        },
+        {
+            "heading": "## 缓解措施",
+            "required": { "small": false, "medium": true, "large": true },
+            "aliases": ["## Mitigation", "## 应对策略", "## 缓解方案"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/task-breakdown.coarse.json

@@ -0,0 +1,15 @@
+{
+    "jsonFields": [
+        {
+            "field": "tasks",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "array",
+            "minItems": 1
+        },
+        {
+            "field": "estimatedTotal",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "string"
+        }
+    ]
+}

package/workflows/dev/schemas/task-breakdown.dependencies.json

@@ -0,0 +1,20 @@
+{
+    "jsonFields": [
+        {
+            "field": "dependencies",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "array"
+        },
+        {
+            "field": "executionOrder",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "array",
+            "minItems": 1
+        },
+        {
+            "field": "parallelGroups",
+            "required": { "small": false, "medium": false, "large": true },
+            "type": "array"
+        }
+    ]
+}

package/workflows/dev/schemas/task-breakdown.detailed.json

@@ -0,0 +1,10 @@
+{
+    "sections": [
+        {
+            "heading": "## 任务列表",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Task List", "## 任务清单", "## Tasks"]
+        }
+    ],
+    "minLength": 80
+}

package/workflows/dev/schemas/task-breakdown.final.json

@@ -0,0 +1,10 @@
+{
+    "sections": [
+        {
+            "heading": "## 任务列表",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Task List", "## 任务清单", "## Tasks"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/task-breakdown.json

@@ -0,0 +1,10 @@
+{
+    "sections": [
+        {
+            "heading": "## 任务列表",
+            "required": { "small": true, "medium": true, "large": true },
+            "aliases": ["## Task List", "## 任务清单", "## Tasks"]
+        }
+    ],
+    "minLength": 100
+}

package/workflows/dev/schemas/tech-design.analysis.json

@@ -0,0 +1,25 @@
+{
+    "jsonFields": [
+        {
+            "field": "currentArchitecture",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "object"
+        },
+        {
+            "field": "constraints",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "array"
+        },
+        {
+            "field": "proposals",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "array",
+            "minItems": 1
+        },
+        {
+            "field": "recommendation",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "string"
+        }
+    ]
+}

package/workflows/dev/schemas/tech-design.api-contract.json

@@ -0,0 +1,20 @@
+{
+    "jsonFields": [
+        {
+            "field": "endpoints",
+            "required": { "small": true, "medium": true, "large": true },
+            "type": "array",
+            "minItems": 1
+        },
+        {
+            "field": "dataModels",
+            "required": { "small": false, "medium": true, "large": true },
+            "type": "array"
+        },
+        {
+            "field": "errorCodes",
+            "required": { "small": false, "medium": false, "large": true },
+            "type": "array"
+        }
+    ]
+}