@zzp123/mcp-zentao 1.7.1 → 1.7.3

package/CHANGELOG.md

@@ -5,6 +5,51 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.3] - 2025-11-06
+
+### Fixed
+- **updateStory 工具参数格式优化**
+  - 修复 `update` 参数只能接受对象格式的问题
+  - 现在同时支持对象格式和 JSON 字符串格式
+  - 自动解析 JSON 字符串并提供友好的错误提示
+
+### Changed
+- `update` 参数使用 `z.union()` 同时接受对象和字符串格式
+- 添加 JSON 字符串解析逻辑，提升工具兼容性
+
+## [1.7.2] - 2025-11-06
+
+### Added
+- **updateStory 工具重大增强**
+  - 新增29个可编辑字段支持，��全对接禅道最新API文档
+  - 支持需求基本信息编辑：title, product, parent, module, branch, plan, type
+  - 支持来源信息编辑：source, sourceNote（支持8种来源类型）
+  - 支持分类与优先级：category, pri, estimate
+  - 支持状态与阶段：stage, status
+  - 支持关键词与标识：keywords, color, grade
+  - 支持人员相关：mailto, reviewer, assignedTo, closedBy, feedbackBy
+  - 支持关闭相关：closedReason, duplicateStory（7种关闭原因）
+  - 支持评审相关：needNotReview
+  - 支持通知相关：notifyEmail
+  - 支持描述内容：spec, verify（HTML格式）
+  - 支持备注：comment
+
+### Changed
+- `UpdateStoryRequest` 接口完全重构，从7个字段扩展到29个字段
+- `updateStory` MCP 工具参数完全重新定义，支持所有新字段
+- 添加了详细的字段注释和类型定义，提升开发体验
+
+### Technical
+- 所有字段均为可选参数，支持部分更新
+- `plan` 字段支持单个ID或数组格式
+- `closedReason` 使用枚举类型确保数据正确性
+- `mailto` 和 `reviewer` 字段支持数组格式
+
+### Benefits
+- **功能完整性**：支持禅道需求管理的所有常用编辑功能
+- **灵活性**：可以批量更新多个字段，也可以单独更新单个字段
+- **类型安全**：完整的 TypeScript 类型定义，减少运行时错误
+
 ## [1.7.1] - 2025-11-06
 
 ### Fixed

package/dist/index.js

@@ -463,19 +463,68 @@ server.tool("getProjects", {
 // Add updateStory tool
 server.tool("updateStory", {
     storyId: z.number(),
-    update: z.object({
-        module: z.number().optional(),
-        source: z.string().optional(),
-        sourceNote: z.string().optional(),
-        pri: z.number().optional(),
-        category: z.string().optional(),
-        estimate: z.number().optional(),
-        keywords: z.string().optional()
-    })
+    update: z.union([
+        z.object({
+            // 基本信息
+            title: z.string().optional(),
+            product: z.number().optional(),
+            parent: z.number().optional(),
+            module: z.number().optional(),
+            branch: z.number().optional(),
+            plan: z.union([z.number(), z.array(z.number())]).optional(),
+            type: z.string().optional(),
+            // 来源信息
+            source: z.string().optional(),
+            sourceNote: z.string().optional(),
+            // 分类与优先级
+            category: z.string().optional(),
+            pri: z.number().optional(),
+            estimate: z.number().optional(),
+            // 状态与阶段
+            stage: z.string().optional(),
+            status: z.string().optional(),
+            // 关键词与标识
+            keywords: z.string().optional(),
+            color: z.string().optional(),
+            grade: z.number().optional(),
+            // 人员相关
+            mailto: z.array(z.string()).optional(),
+            reviewer: z.array(z.string()).optional(),
+            assignedTo: z.string().optional(),
+            closedBy: z.string().optional(),
+            feedbackBy: z.string().optional(),
+            // 关闭相关
+            closedReason: z.enum(['done', 'subdivided', 'duplicate', 'postponed', 'willnotdo', 'cancel', 'bydesign']).optional(),
+            duplicateStory: z.number().optional(),
+            // 评审相关
+            needNotReview: z.boolean().optional(),
+            // 通知相关
+            notifyEmail: z.string().optional(),
+            // 描述内容
+            spec: z.string().optional(),
+            verify: z.string().optional(),
+            // 备注
+            comment: z.string().optional()
+        }),
+        z.string()
+    ]).describe("需求更新字段 - 支持对象或JSON字符串格式")
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const story = await zentaoApi.updateStory(storyId, update);
+    // 如果 update 是字符串，尝试解析为对象
+    let updateData;
+    if (typeof update === 'string') {
+        try {
+            updateData = JSON.parse(update);
+        }
+        catch (error) {
+            throw new Error(`Invalid JSON string: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    else {
+        updateData = update;
+    }
+    const story = await zentaoApi.updateStory(storyId, updateData);
     return {
         content: [{ type: "text", text: JSON.stringify(story, null, 2) }]
     };

package/dist/types/zentao.d.ts

@@ -257,13 +257,35 @@ export interface Project {
     progress: number;
 }
 export interface UpdateStoryRequest {
+    title?: string;
+    product?: number;
+    parent?: number;
     module?: number;
+    branch?: number;
+    plan?: number | number[];
+    type?: string;
     source?: string;
     sourceNote?: string;
-    pri?: number;
     category?: string;
+    pri?: number;
     estimate?: number;
+    stage?: string;
+    status?: string;
     keywords?: string;
+    color?: string;
+    grade?: number;
+    mailto?: string[];
+    reviewer?: string[];
+    assignedTo?: string;
+    closedBy?: string;
+    feedbackBy?: string;
+    closedReason?: 'done' | 'subdivided' | 'duplicate' | 'postponed' | 'willnotdo' | 'cancel' | 'bydesign';
+    duplicateStory?: number;
+    needNotReview?: boolean;
+    notifyEmail?: string;
+    spec?: string;
+    verify?: string;
+    comment?: string;
 }
 export interface CreateProgramRequest {
     name?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.7.1",
+    "version": "1.7.3",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",