@cloudglab/zentao-cli 0.1.3

package/dist/core/write-guard.d.ts

@@ -0,0 +1,25 @@
+export interface WriteGuardInput {
+    action: string;
+    confirm?: boolean;
+    payload: unknown;
+}
+export interface WritePreview {
+    ok: false;
+    preview: true;
+    reason: string;
+    action: string;
+    payload: unknown;
+}
+export interface UnsupportedWriteDiagnostic {
+    ok: false;
+    supported: false;
+    error: string;
+    action: string;
+    diagnostic: string;
+    payload: unknown;
+}
+export declare function isWriteEnabled(): boolean;
+export declare function getWritePreview(input: WriteGuardInput, reason: string): WritePreview;
+export declare function getUnsupportedWriteDiagnostic(input: WriteGuardInput, diagnostic: string): UnsupportedWriteDiagnostic;
+export declare function assertWriteAllowed(input: WriteGuardInput): void;
+export declare function previewOrAssertWriteAllowed(input: WriteGuardInput): WritePreview | UnsupportedWriteDiagnostic | null;

package/dist/core/write-guard.js

@@ -0,0 +1,53 @@
+const UNSUPPORTED_WRITE_ACTIONS = {
+    updateExecution: '禅道 18.5 v1 executionEntry::put() 在启用迭代代号时存在字段拼接缺逗号问题，code 不会进入服务端 $_POST，客户端无法稳定绕过。',
+    updateTestTask: '禅道 18.5 v1 testtaskEntry 只有 get/delete，没有 put 更新入口。',
+    addComment: '禅道 18.5 v1 没有 comment/comments API entry；只能通过对象详情 actions 读取评论，不能用 REST v1 新增评论。',
+};
+export function isWriteEnabled() {
+    return process.env.ZENTAO_ENABLE_WRITE === 'true';
+}
+export function getWritePreview(input, reason) {
+    return {
+        ok: false,
+        preview: true,
+        reason,
+        action: input.action,
+        payload: input.payload,
+    };
+}
+export function getUnsupportedWriteDiagnostic(input, diagnostic) {
+    return {
+        ok: false,
+        supported: false,
+        error: `写操作 ${input.action} 当前不能真实执行`,
+        action: input.action,
+        diagnostic,
+        payload: input.payload,
+    };
+}
+export function assertWriteAllowed(input) {
+    const unsupportedReason = UNSUPPORTED_WRITE_ACTIONS[input.action];
+    if (unsupportedReason) {
+        throw new Error(`写操作 ${input.action} 当前不支持真实执行：${unsupportedReason}`);
+    }
+    if (!isWriteEnabled()) {
+        throw new Error(`写操作已禁用。若要执行 ${input.action}，需要设置 ZENTAO_ENABLE_WRITE=true。`);
+    }
+    if (input.confirm !== true) {
+        throw new Error(`写操作缺少确认。若要执行 ${input.action}，需要传入 confirm: true。`);
+    }
+}
+export function previewOrAssertWriteAllowed(input) {
+    const unsupportedReason = UNSUPPORTED_WRITE_ACTIONS[input.action];
+    if (unsupportedReason) {
+        return getUnsupportedWriteDiagnostic(input, unsupportedReason);
+    }
+    if (!isWriteEnabled()) {
+        return getWritePreview(input, `写操作已禁用。若要执行 ${input.action}，需要设置 ZENTAO_ENABLE_WRITE=true。`);
+    }
+    if (input.confirm !== true) {
+        return getWritePreview(input, `写操作缺少确认。若要执行 ${input.action}，需要传入 confirm: true。`);
+    }
+    return null;
+}
+//# sourceMappingURL=write-guard.js.map

package/dist/core/write-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-guard.js","sourceRoot":"","sources":["../../src/core/write-guard.ts"],"names":[],"mappings":"AAuBA,MAAM,yBAAyB,GAA2B;IACxD,eAAe,EAAE,qFAAqF;IACtG,cAAc,EAAE,qDAAqD;IACrE,UAAU,EAAE,kFAAkF;CAC/F,CAAC;AAEF,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAsB,EAAE,MAAc;IACpE,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,IAAI;QACb,MAAM;QACN,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAsB,EAAE,UAAkB;IACtF,OAAO;QACL,EAAE,EAAE,KAAK;QACT,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,WAAW;QACrC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU;QACV,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,MAAM,cAAc,iBAAiB,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,MAAM,iCAAiC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,MAAM,sBAAsB,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAsB;IAChE,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,6BAA6B,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO,eAAe,CAAC,KAAK,EAAE,eAAe,KAAK,CAAC,MAAM,iCAAiC,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC,KAAK,EAAE,gBAAgB,KAAK,CAAC,MAAM,sBAAsB,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ZentaoApi } from './api/index.js';
+export { runCli } from './cli.js';
+export type { Role, ZentaoConfig } from './types/common.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ZentaoApi } from './api/index.js';
+export { runCli } from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/tools/bug.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerBugTools(server: CliRegistry): void;

package/dist/tools/bug.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { previewOrAssertWriteAllowed } from '../core/write-guard.js';
+import { jsonResult } from './shared.js';
+export function registerBugTools(server) {
+    server.tool('getMyBugs', {
+        productId: z.number().int().positive().optional().describe('可选。禅道产品 ID。不传时默认查询跨所有产品“指派给我的 Bug”；传入时只查该产品内我的 Bug。若用户问的是业务产品的线上 / 生产 / 客户反馈 / 售后反馈问题，不要直接把业务产品名当成这里的 productId。'),
+        page: z.number().int().positive().optional(),
+        limit: z.number().int().positive().max(100).optional(),
+        branch: z.string().optional(),
+        order: z.string().optional(),
+    }, async (input) => jsonResult(await getApi().bug.getMyBugs(input)));
+    server.tool('getProductBugs', {
+        productId: z.number().int().positive().describe('禅道产品 ID。仅用于查询某个禅道产品下的 Bug。若用户问的是某业务产品的线上 Bug / 生产问题 / 客户反馈问题，先查固定禅道产品“市场和售后问题跟踪”，再按模块匹配真实业务产品，不要直接把业务产品名映射成这里的 productId。'),
+        page: z.number().int().positive().optional(),
+        limit: z.number().int().positive().max(100).optional(),
+        status: z.string().optional().default('all'),
+        branch: z.string().optional(),
+        order: z.string().optional(),
+    }, async (input) => jsonResult(await getApi().bug.getProductBugs(input)));
+    server.tool('getBugDetail', {
+        bugId: z.number().int().positive(),
+    }, async ({ bugId }) => jsonResult(await getApi().bug.getBugDetail(bugId)));
+    server.tool('resolveBug', {
+        bugId: z.number().int().positive(),
+        resolution: z.enum(['fixed', 'bydesign', 'duplicate', 'external', 'notrepro', 'postponed', 'willnotfix']),
+        resolvedBuild: z.string().optional(),
+        resolvedDate: z.string().optional().describe('解决日期/时间，禅道 18.5 bugresolve 支持该字段'),
+        assignedTo: z.string().optional(),
+        comment: z.string().optional(),
+        duplicateBug: z.number().int().positive().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ bugId, confirm, ...resolution }) => {
+        const payload = { bugId, resolution };
+        const preview = previewOrAssertWriteAllowed({ action: 'resolveBug', confirm, payload });
+        if (preview)
+            return jsonResult(preview);
+        return jsonResult(await getApi().bug.resolveBug(bugId, resolution));
+    });
+}
+//# sourceMappingURL=bug.js.map

package/dist/tools/bug.js.map

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

package/dist/tools/build.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerBuildTools(server: CliRegistry): void;

package/dist/tools/build.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { jsonResult } from './shared.js';
+export function registerBuildTools(server) {
+    server.tool('getProjectBuilds', { projectId: z.number().int().positive() }, async ({ projectId }) => jsonResult(await getApi().build.getProjectBuilds(projectId)));
+    server.tool('getBuildDetail', { buildId: z.number().int().positive() }, async ({ buildId }) => jsonResult(await getApi().build.getBuildDetail(buildId)));
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACnK,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3J,CAAC"}

package/dist/tools/comment.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerCommentTools(server: CliRegistry): void;

package/dist/tools/comment.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { previewOrAssertWriteAllowed } from '../core/write-guard.js';
+import { jsonResult } from './shared.js';
+const objectTypeSchema = z.enum(['task', 'bug', 'story', 'product', 'project', 'execution']);
+export function registerCommentTools(server) {
+    server.tool('getComments', {
+        objectType: objectTypeSchema,
+        objectID: z.number().int().positive(),
+    }, async ({ objectType, objectID }) => jsonResult(await getApi().comment.getComments(objectType, objectID)));
+    server.tool('addComment', {
+        objectType: objectTypeSchema,
+        objectID: z.number().int().positive(),
+        comment: z.string().min(1),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ confirm, ...input }) => {
+        const preview = previewOrAssertWriteAllowed({ action: 'addComment', confirm, payload: input });
+        if (preview)
+            return jsonResult(preview);
+        return jsonResult(await getApi().comment.addComment(input));
+    });
+}
+//# sourceMappingURL=comment.js.map

package/dist/tools/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../src/tools/comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAE7F,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,MAAM,CAAC,IAAI,CACT,aAAa,EACb;QACE,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACtC,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CACzG,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,YAAY,EACZ;QACE,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KAC/C,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,2BAA2B,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/F,IAAI,OAAO;YAAE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9D,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/context.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerContextTools(server: CliRegistry): void;

package/dist/tools/context.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { jsonResult } from './shared.js';
+export function registerContextTools(server) {
+    server.tool('getDevelopmentContext', {
+        entityType: z.enum(['story', 'bug']),
+        entityId: z.number().int().positive(),
+        productId: z.number().int().positive().optional().describe('可选。story 上下文查询关联 Bug 时可用于兜底过滤。'),
+    }, async (input) => jsonResult(await getApi().developmentContext.getDevelopmentContext(input)));
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB;QACE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;KAC7F,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAC5F,CAAC;AACJ,CAAC"}

package/dist/tools/execution.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerExecutionTools(server: CliRegistry): void;

package/dist/tools/execution.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { jsonResult } from './shared.js';
+export function registerExecutionTools(server) {
+    server.tool('getExecutionDetail', {
+        executionId: z.number().int().positive(),
+    }, async ({ executionId }) => jsonResult(await getApi().execution.getExecutionDetail(executionId)));
+    server.tool('getProjectExecutions', {
+        projectId: z.number().int().positive(),
+    }, async ({ projectId }) => jsonResult(await getApi().execution.getProjectExecutions(projectId)));
+    server.tool('getExecutionBuilds', {
+        executionId: z.number().int().positive(),
+    }, async ({ executionId }) => jsonResult(await getApi().execution.getExecutionBuilds(executionId)));
+    server.tool('getExecutionBugs', {
+        executionId: z.number().int().positive(),
+        page: z.number().int().positive().optional(),
+        limit: z.number().int().positive().max(100).optional(),
+        status: z.string().optional().describe('可选，按禅道接口支持的状态过滤'),
+    }, async ({ executionId, page, limit, status }) => jsonResult(await getApi().execution.getExecutionBugs(executionId, { page, limit, status })));
+}
+//# sourceMappingURL=execution.js.map

package/dist/tools/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/tools/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACzC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAChG,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAC9F,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACzC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAChG,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAC1D,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAC5I,CAAC;AACJ,CAAC"}

package/dist/tools/init.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerInitTools(server: CliRegistry): void;

package/dist/tools/init.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { ZentaoApi } from '../api/index.js';
+import { loadConfig, maskConfig, normalizeConfig, saveConfig } from '../core/config.js';
+import { setApi } from '../core/api-provider.js';
+import { jsonResult } from './shared.js';
+export function registerInitTools(server) {
+    server.tool('initZentao', {
+        url: z.string().optional().describe('禅道根域名，例如 https://zentao.cloudglab.cn，不要带 /zentao'),
+        username: z.string().optional().describe('禅道账号'),
+        password: z.string().optional().describe('禅道密码'),
+        apiVersion: z.string().optional().default('v1').describe('API 版本，默认 v1'),
+        apiBaseUrl: z.string().optional().describe('可选。完整 API 基础地址，例如 https://host/custom/api.php/v1；不传则默认拼接 /zentao/api.php/{apiVersion}'),
+        save: z.boolean().optional().default(false).describe('是否写入 ~/.zentao/config.json。默认 false，仅当前会话生效'),
+    }, async (input) => {
+        const config = input.url || input.username || input.password || input.apiBaseUrl
+            ? normalizeConfig(input)
+            : loadConfig();
+        if (!config)
+            throw new Error('未找到禅道配置。');
+        if (input.save)
+            saveConfig(config);
+        const api = new ZentaoApi(config);
+        await api.getToken();
+        setApi(api);
+        return jsonResult({ ok: true, saved: Boolean(input.save), config: maskConfig(config) });
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/tools/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/tools/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,CAAC,IAAI,CACT,YAAY,EACZ;QACE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACvF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;QACnI,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KACpG,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,UAAU;YAC9E,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;YACxB,CAAC,CAAC,UAAU,EAAE,CAAC;QAEjB,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAEzC,IAAI,KAAK,CAAC,IAAI;YAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnC,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC;QAEZ,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/phase3a.d.ts

@@ -0,0 +1,4 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerStoryWriteTools(server: CliRegistry): void;
+export declare function registerTaskDerivedTools(server: CliRegistry): void;
+export declare function registerPlanRelationTools(server: CliRegistry): void;

package/dist/tools/phase3a.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { previewOrAssertWriteAllowed } from '../core/write-guard.js';
+import { jsonResult } from './shared.js';
+async function runPreviewed(action, confirm, payload, runner) {
+    const preview = previewOrAssertWriteAllowed({ action, confirm, payload });
+    if (preview)
+        return jsonResult(preview);
+    return jsonResult(await runner());
+}
+export function registerStoryWriteTools(server) {
+    server.tool('updateStory', {
+        storyId: z.number().int().positive(),
+        title: z.string().optional(),
+        product: z.number().int().positive().optional(),
+        parent: z.number().int().nonnegative().optional(),
+        reviewer: z.string().optional(),
+        type: z.string().optional(),
+        plan: z.number().int().nonnegative().optional(),
+        module: z.number().int().nonnegative().optional(),
+        source: z.string().optional(),
+        sourceNote: z.string().optional(),
+        pri: z.number().optional(),
+        estimate: z.number().optional(),
+        category: z.string().optional(),
+        mailto: z.array(z.string()).optional(),
+        keywords: z.string().optional(),
+        stage: z.string().optional(),
+        notifyEmail: z.array(z.string()).optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ storyId, confirm, ...update }) => runPreviewed('updateStory', confirm, { storyId, update }, () => getApi().story.updateStory(storyId, update)));
+    server.tool('changeStory', {
+        storyId: z.number().int().positive(),
+        title: z.string().min(1).describe('禅道 18.5 change story 必填'),
+        spec: z.string().optional(),
+        verify: z.string().optional(),
+        reviewer: z.string().optional(),
+        comment: z.string().optional(),
+        executions: z.array(z.number().int().positive()).optional(),
+        bugs: z.array(z.number().int().positive()).optional(),
+        cases: z.array(z.number().int().positive()).optional(),
+        tasks: z.array(z.number().int().positive()).optional(),
+        reviewedBy: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ storyId, confirm, ...update }) => runPreviewed('changeStory', confirm, { storyId, update }, () => getApi().story.changeStory(storyId, update)));
+}
+export function registerTaskDerivedTools(server) {
+    server.tool('createTaskFromStory', {
+        storyId: z.number().int().positive(),
+        execution: z.number().int().positive(),
+        taskName: z.string().min(1),
+        type: z.string().optional().default('devel'),
+        assignedTo: z.string().min(1).describe('指派人账号。禅道 18.5 创建任务必填'),
+        estimate: z.number().optional(),
+        estStarted: z.string().min(1).describe('预计开始日期。禅道 18.5 创建任务必填，格式 YYYY-MM-DD'),
+        deadline: z.string().min(1).describe('截止日期。禅道 18.5 创建任务必填，格式 YYYY-MM-DD'),
+        desc: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ storyId, execution, taskName, type, assignedTo, estimate, estStarted, deadline, desc, confirm }) => {
+        const story = await getApi().story.getStoryDetail(storyId);
+        const payload = {
+            execution,
+            name: taskName,
+            type,
+            assignedTo,
+            estimate,
+            estStarted,
+            deadline,
+            story: storyId,
+            desc: desc ?? `基于需求 #${storyId}: ${story.title}`,
+        };
+        return runPreviewed('createTaskFromStory', confirm, payload, () => getApi().task.createTask(payload));
+    });
+    server.tool('createTaskFromBug', {
+        bugId: z.number().int().positive(),
+        execution: z.number().int().positive(),
+        taskName: z.string().optional(),
+        type: z.string().optional().default('devel'),
+        assignedTo: z.string().min(1).describe('指派人账号。禅道 18.5 创建任务必填'),
+        estimate: z.number().optional(),
+        estStarted: z.string().min(1).describe('预计开始日期。禅道 18.5 创建任务必填，格式 YYYY-MM-DD'),
+        deadline: z.string().min(1).describe('截止日期。禅道 18.5 创建任务必填，格式 YYYY-MM-DD'),
+        desc: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ bugId, execution, taskName, type, assignedTo, estimate, estStarted, deadline, desc, confirm }) => {
+        const bug = await getApi().bug.getBugDetail(bugId);
+        const payload = {
+            execution,
+            name: taskName ?? `修复Bug #${bugId}: ${bug.title}`,
+            type,
+            assignedTo,
+            estimate,
+            estStarted,
+            deadline,
+            fromBug: bugId,
+            desc: desc ?? `修复Bug #${bugId}: ${bug.title}\n\n复现步骤:\n${String(bug.steps ?? '无')}`,
+        };
+        return runPreviewed('createTaskFromBug', confirm, payload, () => getApi().task.createTask(payload));
+    });
+}
+export function registerPlanRelationTools(server) {
+    server.tool('linkStoriesToPlan', {
+        planId: z.number().int().positive(),
+        storyIds: z.array(z.number().int().positive()).min(1).max(20),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ planId, storyIds, confirm }) => runPreviewed('linkStoriesToPlan', confirm, { planId, storyIds }, () => getApi().plan.linkStoriesToPlan(planId, storyIds)));
+    server.tool('unlinkStoriesFromPlan', {
+        planId: z.number().int().positive(),
+        storyIds: z.array(z.number().int().positive()).min(1).max(20),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ planId, storyIds, confirm }) => runPreviewed('unlinkStoriesFromPlan', confirm, { planId, storyIds }, () => getApi().plan.unlinkStoriesFromPlan(planId, storyIds)));
+    server.tool('linkBugsToPlan', {
+        planId: z.number().int().positive(),
+        bugIds: z.array(z.number().int().positive()).min(1).max(20),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ planId, bugIds, confirm }) => runPreviewed('linkBugsToPlan', confirm, { planId, bugIds }, () => getApi().plan.linkBugsToPlan(planId, bugIds)));
+    server.tool('unlinkBugsFromPlan', {
+        planId: z.number().int().positive(),
+        bugIds: z.array(z.number().int().positive()).min(1).max(20),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ planId, bugIds, confirm }) => runPreviewed('unlinkBugsFromPlan', confirm, { planId, bugIds }, () => getApi().plan.unlinkBugsFromPlan(planId, bugIds)));
+}
+//# sourceMappingURL=phase3a.js.map

package/dist/tools/phase3a.js.map

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

package/dist/tools/phase3b.d.ts

@@ -0,0 +1,5 @@
+import type { CliRegistry } from '../core/cli-registry.js';
+export declare function registerExecutionWriteTools(server: CliRegistry): void;
+export declare function registerBuildWriteTools(server: CliRegistry): void;
+export declare function registerTestCaseWriteTools(server: CliRegistry): void;
+export declare function registerTestTaskWriteTools(server: CliRegistry): void;

package/dist/tools/phase3b.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { getApi } from '../core/api-provider.js';
+import { previewOrAssertWriteAllowed } from '../core/write-guard.js';
+import { jsonResult } from './shared.js';
+async function runPreviewed(action, confirm, payload, runner) {
+    const preview = previewOrAssertWriteAllowed({ action, confirm, payload });
+    if (preview)
+        return jsonResult(preview);
+    return jsonResult(await runner());
+}
+export function registerExecutionWriteTools(server) {
+    server.tool('updateExecution', {
+        executionId: z.number().int().positive(),
+        project: z.number().int().positive().optional().describe('所属项目 ID。禅道官方文档标为必填，建议从 getExecutionDetail 读回后原样传入'),
+        name: z.string().optional(),
+        code: z.string().optional().describe('迭代代号，实机验证发现当前实例更新执行时通常必填'),
+        desc: z.string().optional(),
+        begin: z.string().optional().describe('格式 YYYY-MM-DD'),
+        end: z.string().optional().describe('格式 YYYY-MM-DD'),
+        days: z.number().int().positive().optional().describe('可用工作日'),
+        lifetime: z.string().optional().describe('类型：short | long | ops'),
+        PO: z.string().optional().describe('产品负责人禅道账号'),
+        PM: z.string().optional().describe('负责人禅道账号'),
+        QD: z.string().optional().describe('测试负责人禅道账号'),
+        RD: z.string().optional().describe('发布负责人禅道账号'),
+        teamMembers: z.array(z.string()).optional().describe('团队成员账号数组'),
+        acl: z.string().optional().describe('访问控制：private | open'),
+        whitelist: z.array(z.string()).optional().describe('白名单账号数组'),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ executionId, confirm, ...update }) => runPreviewed('updateExecution', confirm, { executionId, update }, () => getApi().execution.updateExecution(executionId, update)));
+    server.tool('startExecution', {
+        executionId: z.number().int().positive(),
+        realBegan: z.string().optional().describe('格式 YYYY-MM-DD'),
+        comment: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ executionId, confirm, ...payload }) => runPreviewed('startExecution', confirm, { executionId, payload }, () => getApi().execution.startExecution(executionId, payload)));
+    server.tool('closeExecution', {
+        executionId: z.number().int().positive(),
+        realEnd: z.string().optional().describe('格式 YYYY-MM-DD'),
+        comment: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ executionId, confirm, ...payload }) => runPreviewed('closeExecution', confirm, { executionId, payload }, () => getApi().execution.closeExecution(executionId, payload)));
+    server.tool('suspendExecution', {
+        executionId: z.number().int().positive(),
+        comment: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ executionId, confirm, ...payload }) => runPreviewed('suspendExecution', confirm, { executionId, payload }, () => getApi().execution.suspendExecution(executionId, payload)));
+    server.tool('activateExecution', {
+        executionId: z.number().int().positive(),
+        comment: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ executionId, confirm, ...payload }) => runPreviewed('activateExecution', confirm, { executionId, payload }, () => getApi().execution.activateExecution(executionId, payload)));
+    server.tool('putoffExecution', {
+        executionId: z.number().int().positive(),
+        days: z.number().int().positive(),
+        comment: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ executionId, confirm, ...payload }) => runPreviewed('putoffExecution', confirm, { executionId, payload }, () => getApi().execution.putoffExecution(executionId, payload)));
+}
+export function registerBuildWriteTools(server) {
+    server.tool('createBuild', {
+        project: z.number().int().positive(),
+        execution: z.number().int().positive(),
+        product: z.number().int().positive(),
+        branch: z.number().int().nonnegative().optional(),
+        name: z.string().min(1),
+        builder: z.string().min(1),
+        date: z.string().optional().describe('格式 YYYY-MM-DD'),
+        desc: z.string().optional(),
+        scmPath: z.string().optional(),
+        filePath: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ confirm, ...payload }) => runPreviewed('createBuild', confirm, payload, () => getApi().build.createBuild(payload)));
+    server.tool('updateBuild', {
+        buildId: z.number().int().positive(),
+        execution: z.number().int().positive().optional(),
+        product: z.number().int().positive().optional(),
+        name: z.string().optional(),
+        builder: z.string().optional(),
+        date: z.string().optional().describe('格式 YYYY-MM-DD'),
+        desc: z.string().optional(),
+        scmPath: z.string().optional(),
+        filePath: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ buildId, confirm, ...update }) => runPreviewed('updateBuild', confirm, { buildId, update }, () => getApi().build.updateBuild(buildId, update)));
+}
+const testCaseStepSchema = z.object({
+    desc: z.string().min(1),
+    expect: z.string().min(1),
+    type: z.enum(['step', 'item', 'group']).optional().describe('禅道 18.5 支持 step/item/group，默认 step'),
+});
+export function registerTestCaseWriteTools(server) {
+    server.tool('createTestCase', {
+        productId: z.number().int().positive(),
+        title: z.string().min(1),
+        type: z.string().min(1),
+        steps: z.array(testCaseStepSchema).min(1),
+        branch: z.number().int().nonnegative().optional(),
+        module: z.number().int().nonnegative().optional(),
+        story: z.number().int().nonnegative().optional(),
+        stage: z.string().optional(),
+        precondition: z.string().optional(),
+        script: z.string().optional(),
+        pri: z.number().int().optional(),
+        keywords: z.string().optional().describe('禅道 18.5 REST v1 创建用例不接收该字段，传入会被忽略'),
+        project: z.number().int().positive().optional().describe('禅道 18.5 REST v1 创建产品用例不绑定项目，传入会被忽略'),
+        execution: z.number().int().positive().optional().describe('禅道 18.5 REST v1 创建产品用例不绑定执行，传入会被忽略'),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ productId, confirm, ...payload }) => runPreviewed('createTestCase', confirm, { productId, ...payload }, () => getApi().testcase.createTestCase(productId, payload)));
+    server.tool('updateTestCase', {
+        testCaseId: z.number().int().positive(),
+        branch: z.number().int().nonnegative().optional(),
+        module: z.number().int().nonnegative().optional(),
+        story: z.number().int().nonnegative().optional(),
+        title: z.string().optional(),
+        type: z.string().optional(),
+        stage: z.string().optional(),
+        precondition: z.string().optional(),
+        script: z.string().optional(),
+        pri: z.number().int().optional(),
+        steps: z.array(testCaseStepSchema).min(1).optional(),
+        keywords: z.string().optional().describe('禅道 18.5 REST v1 更新用例不接收该字段，传入会被忽略'),
+        project: z.number().int().positive().optional().describe('禅道 18.5 REST v1 更新用例不接收该字段，传入会被忽略'),
+        execution: z.number().int().positive().optional().describe('禅道 18.5 REST v1 更新用例不接收该字段，传入会被忽略'),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ testCaseId, confirm, ...update }) => runPreviewed('updateTestCase', confirm, { testCaseId, update }, () => getApi().testcase.updateTestCase(testCaseId, update)));
+}
+export function registerTestTaskWriteTools(server) {
+    server.tool('createTestTask', {
+        project: z.number().int().positive().describe('所属项目 ID，实机验证发现当前实例创建测试单时必填'),
+        productID: z.number().int().positive(),
+        name: z.string().min(1),
+        build: z.union([z.number().int().positive(), z.string().min(1)]),
+        begin: z.string().min(1).describe('格式 YYYY-MM-DD'),
+        end: z.string().min(1).describe('格式 YYYY-MM-DD'),
+        execution: z.number().int().positive().optional(),
+        type: z.array(z.string()).optional(),
+        owner: z.string().optional(),
+        status: z.string().optional(),
+        pri: z.number().int().optional(),
+        desc: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ confirm, ...payload }) => runPreviewed('createTestTask', confirm, payload, () => getApi().testtask.createTestTask(payload)));
+    server.tool('updateTestTask', {
+        testTaskId: z.number().int().positive(),
+        project: z.number().int().positive().optional(),
+        productID: z.number().int().positive().optional(),
+        name: z.string().optional(),
+        build: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+        execution: z.number().int().positive().optional(),
+        type: z.array(z.string()).optional(),
+        owner: z.string().optional(),
+        status: z.string().optional(),
+        pri: z.number().int().optional(),
+        begin: z.string().optional().describe('格式 YYYY-MM-DD'),
+        end: z.string().optional().describe('格式 YYYY-MM-DD'),
+        desc: z.string().optional(),
+        confirm: z.boolean().optional().default(false),
+    }, async ({ testTaskId, confirm, ...update }) => runPreviewed('updateTestTask', confirm, { testTaskId, update }, () => getApi().testtask.updateTestTask(testTaskId, update)));
+}
+//# sourceMappingURL=phase3b.js.map