@zentao-hub/mcp 0.3.0

package/dist/tools/stories.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import { STORY_SUMMARY_KEYS, defineTool, extractList, extractTotal, paginationShape, pickDefined, summarize, } from "./helpers.js";
+const STORY_SOURCES = ["customer", "user", "po", "market", "research", "competitor", "company", "other"];
+const STORY_CLOSE_REASONS = [
+    "done",
+    "subdivided",
+    "duplicate",
+    "postponed",
+    "willnotdo",
+    "cancel",
+    "bydesign",
+];
+export function buildStoryTools(ctx) {
+    const { client } = ctx;
+    return {
+        list_product_stories: defineTool({
+            description: "List stories in a product. Filter by status or assignee. Stories drive feature scope in ZenTao.",
+            schema: z.object({
+                productId: z.number().int().positive(),
+                status: z.enum(["active", "changed", "draft", "closed", "all"]).optional(),
+                assignedTo: z.string().optional(),
+                ...paginationShape,
+            }),
+            handler: async (args) => {
+                const payload = await client.stories.listByProduct(args.productId, {
+                    status: args.status,
+                    assignedTo: args.assignedTo,
+                    limit: args.limit ?? 20,
+                    page: args.page,
+                });
+                const stories = extractList(payload).map((s) => summarize(s, STORY_SUMMARY_KEYS));
+                return { total: extractTotal(payload) ?? stories.length, stories };
+            },
+        }),
+        get_story: defineTool({
+            description: "Fetch full details of a story (spec, verification criteria, linked cases, …).",
+            schema: z.object({ storyId: z.number().int().positive() }),
+            handler: async (args) => client.stories.get(args.storyId),
+        }),
+        create_story: defineTool({
+            description: "Create a new story in a product. Required: productId, title. spec / verify are HTML.",
+            schema: z.object({
+                productId: z.number().int().positive(),
+                title: z.string().min(1),
+                branch: z.number().int().optional(),
+                module: z.number().int().optional(),
+                plan: z.number().int().optional(),
+                source: z.enum(STORY_SOURCES).optional(),
+                pri: z.union([z.literal(0), z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+                estimate: z.number().nonnegative().optional().describe("Estimated hours."),
+                spec: z.string().optional().describe("Specification (HTML allowed)."),
+                verify: z.string().optional().describe("Verification criteria (HTML allowed)."),
+                keywords: z.string().optional(),
+                assignedTo: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { productId, ...rest } = args;
+                return client.stories.create(productId, pickDefined(rest));
+            },
+        }),
+        update_story: defineTool({
+            description: "Update a story's editable fields. Use change_story for spec/verify revisions that need a change record.",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                title: z.string().optional(),
+                pri: z.union([z.literal(0), z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+                estimate: z.number().nonnegative().optional(),
+                module: z.number().int().optional(),
+                plan: z.number().int().optional(),
+                keywords: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { storyId, ...rest } = args;
+                return client.stories.update(storyId, pickDefined(rest));
+            },
+        }),
+        change_story: defineTool({
+            description: "Submit a change to spec / verify. Creates a story-change record and bumps the story version.",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                spec: z.string().optional(),
+                verify: z.string().optional(),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { storyId, ...rest } = args;
+                return client.stories.change(storyId, pickDefined(rest));
+            },
+        }),
+        review_story: defineTool({
+            description: "Review a draft / changed story (pass / revert / clarify / reject).",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                result: z.enum(["pass", "revert", "clarify", "reject"]),
+                preVersion: z.number().int().optional().describe("Story version being reviewed; defaults to current."),
+                comment: z.string().optional(),
+                closedReason: z.enum(STORY_CLOSE_REASONS).optional().describe("Required when result='reject'."),
+            }),
+            handler: async (args) => {
+                const { storyId, ...rest } = args;
+                return client.stories.review(storyId, pickDefined(rest));
+            },
+        }),
+        close_story: defineTool({
+            description: "Close a story with a reason.",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                closedReason: z.enum(STORY_CLOSE_REASONS),
+                duplicateStory: z.number().int().positive().optional().describe("Required when closedReason='duplicate'."),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => {
+                if (args.closedReason === "duplicate" && !args.duplicateStory) {
+                    throw new Error("closedReason='duplicate' requires duplicateStory to be set");
+                }
+                const { storyId, ...rest } = args;
+                return client.stories.close(storyId, pickDefined(rest));
+            },
+        }),
+        activate_story: defineTool({
+            description: "Re-activate a closed story.",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                assignedTo: z.string().optional(),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => client.stories.activate(args.storyId, pickDefined({ assignedTo: args.assignedTo, comment: args.comment })),
+        }),
+        assign_story: defineTool({
+            description: "Reassign a story to another account.",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                assignedTo: z.string().min(1),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => client.stories.assignTo(args.storyId, pickDefined({ assignedTo: args.assignedTo, comment: args.comment })),
+        }),
+        delete_story: defineTool({
+            description: "Delete a story. Irreversible.",
+            schema: z.object({ storyId: z.number().int().positive() }),
+            handler: async (args) => client.stories.delete(args.storyId),
+        }),
+        add_story_comment: defineTool({
+            description: "Append a comment to a story.",
+            schema: z.object({
+                storyId: z.number().int().positive(),
+                comment: z.string().min(1),
+            }),
+            handler: async (args) => client.stories.addComment(args.storyId, args.comment),
+        }),
+    };
+}
+//# sourceMappingURL=stories.js.map

package/dist/tools/stories.js.map

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

package/dist/tools/tasks.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef, type ToolFactoryCtx } from "./helpers.js";
+export declare function buildTaskTools(ctx: ToolFactoryCtx): Record<string, ToolDef>;

package/dist/tools/tasks.js

@@ -0,0 +1,205 @@
+import { z } from "zod";
+import { TASK_SUMMARY_KEYS, defineTool, extractList, extractTotal, pickDefined, summarize, } from "./helpers.js";
+const TASK_TYPES = [
+    "design",
+    "devel",
+    "test",
+    "study",
+    "discuss",
+    "ui",
+    "affair",
+    "misc",
+    "review",
+];
+const TASK_CLOSE_REASONS = ["done", "cancel", "bydesign", "duplicate", "postponed", "willnotdo"];
+export function buildTaskTools(ctx) {
+    const { client } = ctx;
+    return {
+        get_task: defineTool({
+            description: "Fetch full details for a task (subtasks, estimate / consumed / left, effort logs).",
+            schema: z.object({ taskId: z.number().int().positive() }),
+            handler: async (args) => client.tasks.get(args.taskId),
+        }),
+        list_my_tasks: defineTool({
+            description: "List tasks assigned to the authenticated user within ONE execution. Mirrors list_my_bugs.",
+            schema: z.object({
+                executionId: z.number().int().positive(),
+                status: z.enum(["wait", "doing", "done", "pause", "cancel", "closed", "all"]).optional(),
+                limit: z.number().int().min(1).max(200).optional(),
+                maxScan: z.number().int().min(50).max(10000).optional(),
+            }),
+            handler: async (args) => {
+                const account = await client.getAccount();
+                const statusArg = args.status ?? "doing";
+                const wantStatus = statusArg === "all" ? undefined : statusArg;
+                const limit = args.limit ?? 20;
+                const maxScan = args.maxScan ?? 1000;
+                const pageSize = 200;
+                const matched = [];
+                let scanned = 0;
+                let totalInExec = 0;
+                for (let page = 1; scanned < maxScan; page++) {
+                    const payload = await client.tasks.listByExecution(args.executionId, {
+                        limit: pageSize,
+                        page,
+                    });
+                    const batch = extractList(payload).map((t) => t);
+                    totalInExec = extractTotal(payload) ?? totalInExec;
+                    if (batch.length === 0)
+                        break;
+                    scanned += batch.length;
+                    for (const t of batch) {
+                        const at = t.assignedTo;
+                        const atAccount = typeof at === "string" ? at : at && typeof at === "object" ? at.account : undefined;
+                        if (atAccount !== account)
+                            continue;
+                        if (wantStatus && t.status !== wantStatus)
+                            continue;
+                        matched.push(summarize(t, TASK_SUMMARY_KEYS));
+                        if (matched.length >= limit)
+                            break;
+                    }
+                    if (matched.length >= limit)
+                        break;
+                    if (batch.length < pageSize)
+                        break;
+                }
+                return {
+                    total: matched.length,
+                    tasks: matched,
+                    scanned,
+                    totalInExec,
+                    account,
+                    truncated: scanned >= maxScan && matched.length < limit,
+                };
+            },
+        }),
+        create_task: defineTool({
+            description: "Create a task in an execution.",
+            schema: z.object({
+                executionId: z.number().int().positive(),
+                name: z.string().min(1),
+                type: z.enum(TASK_TYPES).optional(),
+                story: z.number().int().optional().describe("Linked story ID."),
+                module: z.number().int().optional(),
+                assignedTo: z.union([z.string(), z.array(z.string())]).optional().describe("Single account or multiple for team task."),
+                pri: z.union([z.literal(0), z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+                estimate: z.number().nonnegative().optional(),
+                desc: z.string().optional(),
+                deadline: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+            }),
+            handler: async (args) => {
+                const { executionId, ...rest } = args;
+                return client.tasks.create(executionId, pickDefined(rest));
+            },
+        }),
+        update_task: defineTool({
+            description: "Update task fields. Use start_task / finish_task / close_task / pause_task / activate_task for state transitions.",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                name: z.string().optional(),
+                type: z.enum(TASK_TYPES).optional(),
+                pri: z.union([z.literal(0), z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+                estimate: z.number().nonnegative().optional(),
+                left: z.number().nonnegative().optional(),
+                consumed: z.number().nonnegative().optional(),
+                desc: z.string().optional(),
+                deadline: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+            }),
+            handler: async (args) => {
+                const { taskId, ...rest } = args;
+                return client.tasks.update(taskId, pickDefined(rest));
+            },
+        }),
+        start_task: defineTool({
+            description: "Start a task (wait → doing).",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                consumed: z.number().nonnegative().optional(),
+                left: z.number().nonnegative().optional(),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { taskId, ...rest } = args;
+                return client.tasks.start(taskId, pickDefined(rest));
+            },
+        }),
+        finish_task: defineTool({
+            description: "Mark a task finished (doing → done).",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                consumed: z.number().nonnegative().optional(),
+                currentConsumed: z.number().nonnegative().optional().describe("Hours logged for this finish action."),
+                assignedTo: z.string().optional(),
+                comment: z.string().optional(),
+                finishedDate: z.string().regex(/^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}:\d{2})?$/).optional(),
+            }),
+            handler: async (args) => {
+                const { taskId, ...rest } = args;
+                return client.tasks.finish(taskId, pickDefined(rest));
+            },
+        }),
+        pause_task: defineTool({
+            description: "Pause an in-flight task.",
+            schema: z.object({ taskId: z.number().int().positive(), comment: z.string().optional() }),
+            handler: async (args) => client.tasks.pause(args.taskId, pickDefined({ comment: args.comment })),
+        }),
+        activate_task: defineTool({
+            description: "Re-activate a paused / closed / cancelled task.",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                left: z.number().nonnegative().optional(),
+                assignedTo: z.string().optional(),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { taskId, ...rest } = args;
+                return client.tasks.activate(taskId, pickDefined(rest));
+            },
+        }),
+        close_task: defineTool({
+            description: "Close a task with a reason.",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                closedReason: z.enum(TASK_CLOSE_REASONS).optional(),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { taskId, ...rest } = args;
+                return client.tasks.close(taskId, pickDefined(rest));
+            },
+        }),
+        cancel_task: defineTool({
+            description: "Cancel a task.",
+            schema: z.object({ taskId: z.number().int().positive(), comment: z.string().optional() }),
+            handler: async (args) => client.tasks.cancel(args.taskId, pickDefined({ comment: args.comment })),
+        }),
+        assign_task: defineTool({
+            description: "Reassign a task.",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                assignedTo: z.string().min(1),
+                left: z.number().nonnegative().optional(),
+                comment: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const { taskId, ...rest } = args;
+                return client.tasks.assignTo(taskId, pickDefined(rest));
+            },
+        }),
+        delete_task: defineTool({
+            description: "Delete a task. Irreversible.",
+            schema: z.object({ taskId: z.number().int().positive() }),
+            handler: async (args) => client.tasks.delete(args.taskId),
+        }),
+        add_task_comment: defineTool({
+            description: "Append a comment to a task.",
+            schema: z.object({
+                taskId: z.number().int().positive(),
+                comment: z.string().min(1),
+            }),
+            handler: async (args) => client.tasks.addComment(args.taskId, args.comment),
+        }),
+    };
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

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

package/dist/tools/testreports.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef, type ToolFactoryCtx } from "./helpers.js";
+export declare function buildTestReportTools(ctx: ToolFactoryCtx): Record<string, ToolDef>;

package/dist/tools/testreports.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { defineTool, extractList, extractTotal, paginationShape, pickDefined, } from "./helpers.js";
+export function buildTestReportTools(ctx) {
+    const { client } = ctx;
+    return {
+        list_product_testreports: defineTool({
+            description: "List test reports of a product.",
+            schema: z.object({ productId: z.number().int().positive(), ...paginationShape }),
+            handler: async (args) => {
+                const payload = await client.testreports.listByProduct(args.productId, {
+                    limit: args.limit ?? 20,
+                    page: args.page,
+                });
+                return { total: extractTotal(payload) ?? extractList(payload).length, testreports: extractList(payload) };
+            },
+        }),
+        get_testreport: defineTool({
+            description: "Fetch a test report's full details.",
+            schema: z.object({ testreportId: z.number().int().positive() }),
+            handler: async (args) => client.testreports.get(args.testreportId),
+        }),
+        create_testreport: defineTool({
+            description: "Create a test report under a product.",
+            schema: z.object({
+                productId: z.number().int().positive(),
+                title: z.string().min(1),
+                begin: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+                end: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+                owner: z.string().optional(),
+                report: z.string().optional().describe("Report body (HTML allowed)."),
+                execution: z.number().int().optional(),
+                builds: z.array(z.number().int().positive()).optional(),
+                stories: z.array(z.number().int().positive()).optional(),
+            }),
+            handler: async (args) => {
+                const { productId, ...rest } = args;
+                return client.testreports.create(productId, pickDefined(rest));
+            },
+        }),
+        delete_testreport: defineTool({
+            description: "Delete a test report. Irreversible.",
+            schema: z.object({ testreportId: z.number().int().positive() }),
+            handler: async (args) => client.testreports.delete(args.testreportId),
+        }),
+    };
+}
+//# sourceMappingURL=testreports.js.map

package/dist/tools/testreports.js.map

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

package/dist/tools/todos.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef, type ToolFactoryCtx } from "./helpers.js";
+export declare function buildTodoTools(ctx: ToolFactoryCtx): Record<string, ToolDef>;

package/dist/tools/todos.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { defineTool, extractList, extractTotal, paginationShape, pickDefined, } from "./helpers.js";
+const TODO_TYPES = ["custom", "bug", "task", "story", "feedback", "review"];
+export function buildTodoTools(ctx) {
+    const { client } = ctx;
+    return {
+        list_todos: defineTool({
+            description: "List the authenticated user's personal todos.",
+            schema: z.object({
+                status: z.enum(["wait", "doing", "done", "closed", "all"]).optional(),
+                date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+                ...paginationShape,
+            }),
+            handler: async (args) => {
+                const payload = await client.todos.list({
+                    status: args.status,
+                    date: args.date,
+                    limit: args.limit ?? 20,
+                    page: args.page,
+                });
+                return { total: extractTotal(payload) ?? extractList(payload).length, todos: extractList(payload) };
+            },
+        }),
+        get_todo: defineTool({
+            description: "Fetch a single todo.",
+            schema: z.object({ todoId: z.number().int().positive() }),
+            handler: async (args) => client.todos.get(args.todoId),
+        }),
+        create_todo: defineTool({
+            description: "Create a personal todo.",
+            schema: z.object({
+                name: z.string().min(1),
+                type: z.enum(TODO_TYPES).optional().describe("Defaults to 'custom'."),
+                pri: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+                date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+                begin: z.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).optional(),
+                end: z.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).optional(),
+                desc: z.string().optional(),
+                objectID: z.number().int().positive().optional().describe("Linked object ID when type is bug/task/story."),
+            }),
+            handler: async (args) => client.todos.create(pickDefined(args)),
+        }),
+        update_todo: defineTool({
+            description: "Update a todo.",
+            schema: z.object({
+                todoId: z.number().int().positive(),
+                name: z.string().optional(),
+                pri: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+                date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+                desc: z.string().optional(),
+                status: z.enum(["wait", "doing", "done", "closed"]).optional(),
+            }),
+            handler: async (args) => {
+                const { todoId, ...rest } = args;
+                return client.todos.update(todoId, pickDefined(rest));
+            },
+        }),
+        finish_todo: defineTool({
+            description: "Mark a todo as done.",
+            schema: z.object({ todoId: z.number().int().positive() }),
+            handler: async (args) => client.todos.finish(args.todoId),
+        }),
+        delete_todo: defineTool({
+            description: "Delete a todo. Irreversible.",
+            schema: z.object({ todoId: z.number().int().positive() }),
+            handler: async (args) => client.todos.delete(args.todoId),
+        }),
+    };
+}
+//# sourceMappingURL=todos.js.map

package/dist/tools/todos.js.map

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

package/dist/tools/users.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef, type ToolFactoryCtx } from "./helpers.js";
+export declare function buildUserTools(ctx: ToolFactoryCtx): Record<string, ToolDef>;

package/dist/tools/users.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { USER_SUMMARY_KEYS, defineTool, extractList, extractTotal, paginationShape, summarize, } from "./helpers.js";
+export function buildUserTools(ctx) {
+    const { client } = ctx;
+    return {
+        whoami: defineTool({
+            description: "Return the account name the server is acting as (from ZENTAO_USERNAME, or auto-detected via /user when only ZENTAO_TOKEN is set). Useful for debugging assignment filters.",
+            schema: z.object({}),
+            handler: async () => {
+                const account = await client.getAccount();
+                return { account };
+            },
+        }),
+        list_users: defineTool({
+            description: "List all users in the ZenTao instance.",
+            schema: z.object({
+                dept: z.number().int().optional().describe("Filter by department ID."),
+                ...paginationShape,
+            }),
+            handler: async (args) => {
+                const payload = await client.users.list({
+                    dept: args.dept,
+                    limit: args.limit ?? 50,
+                    page: args.page,
+                });
+                const users = extractList(payload).map((u) => summarize(u, USER_SUMMARY_KEYS));
+                return { total: extractTotal(payload) ?? users.length, users };
+            },
+        }),
+        get_user: defineTool({
+            description: "Fetch one user's profile by account name.",
+            schema: z.object({ account: z.string().min(1).describe("ZenTao account name (not numeric ID).") }),
+            handler: async (args) => client.users.get(args.account),
+        }),
+        list_departments: defineTool({
+            description: "List organizational departments.",
+            schema: z.object({ ...paginationShape }),
+            handler: async (args) => {
+                const payload = await client.users.listDepartments({
+                    limit: args.limit ?? 50,
+                    page: args.page,
+                });
+                return { total: extractTotal(payload) ?? extractList(payload).length, departments: extractList(payload) };
+            },
+        }),
+        list_department_users: defineTool({
+            description: "List users in one department.",
+            schema: z.object({ departmentId: z.number().int().positive(), ...paginationShape }),
+            handler: async (args) => {
+                const payload = await client.users.listByDepartment(args.departmentId, {
+                    limit: args.limit ?? 50,
+                    page: args.page,
+                });
+                return { total: extractTotal(payload) ?? extractList(payload).length, users: extractList(payload) };
+            },
+        }),
+    };
+}
+//# sourceMappingURL=users.js.map

package/dist/tools/users.js.map

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