@zzp123/mcp-zentao 1.7.1 → 1.7.2

package/CHANGELOG.md

@@ -5,6 +5,39 @@ 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.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

@@ -464,14 +464,47 @@ server.tool("getProjects", {
 server.tool("updateStory", {
     storyId: z.number(),
     update: 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(),
-        pri: z.number().optional(),
+        // 分类与优先级
         category: z.string().optional(),
+        pri: z.number().optional(),
         estimate: z.number().optional(),
-        keywords: z.string().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()
+    }).describe("需求更新字段 - 根据API文档支持29个可编辑字段")
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");

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.2",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",