chandao4 0.1.0

package/dist/core/errors.d.ts

@@ -0,0 +1,17 @@
+import { ZentaoErrorResponse } from '../types/api';
+/**
+ * API 错误类
+ */
+export declare class ZentaoApiError extends Error {
+    errcode: number;
+    errmsg: string;
+    constructor(errcode: number, errmsg: string);
+}
+/**
+ * 格式化 API 错误信息
+ */
+export declare function formatApiError(err: unknown): string;
+/**
+ * 判断是否为 Zentao API 错误响应
+ */
+export declare function isZentaoError(data: unknown): data is ZentaoErrorResponse;

package/dist/core/errors.js

@@ -0,0 +1,61 @@
+"use strict";
+// 错误处理
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZentaoApiError = void 0;
+exports.formatApiError = formatApiError;
+exports.isZentaoError = isZentaoError;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * API 错误类
+ */
+class ZentaoApiError extends Error {
+    errcode;
+    errmsg;
+    constructor(errcode, errmsg) {
+        super(errmsg);
+        this.name = 'ZentaoApiError';
+        this.errcode = errcode;
+        this.errmsg = errmsg;
+    }
+}
+exports.ZentaoApiError = ZentaoApiError;
+/**
+ * 格式化 API 错误信息
+ */
+function formatApiError(err) {
+    if (err instanceof ZentaoApiError) {
+        switch (err.errcode) {
+            case 401:
+                return chalk_1.default.red('认证失败: 请检查用户名/密码，或 code/token 是否正确');
+            case 403:
+                return chalk_1.default.red('没有权限执行此操作');
+            case 404:
+                return chalk_1.default.yellow('资源不存在');
+            default:
+                return chalk_1.default.red(`API 错误 [${err.errcode}]: ${err.errmsg}`);
+        }
+    }
+    if (err instanceof Error) {
+        if (err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND') {
+            return chalk_1.default.red('无法连接到禅道服务器，请检查 URL 和网络');
+        }
+        if (err.code === 'ETIMEDOUT' || err.code === 'ECONNABORTED') {
+            return chalk_1.default.red('请求超时，请检查网络或服务器状态');
+        }
+        return chalk_1.default.red(`错误: ${err.message}`);
+    }
+    return chalk_1.default.red('未知错误');
+}
+/**
+ * 判断是否为 Zentao API 错误响应
+ */
+function isZentaoError(data) {
+    if (typeof data === 'object' && data !== null) {
+        const obj = data;
+        return typeof obj.errcode === 'number' && typeof obj.errmsg === 'string';
+    }
+    return false;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+"use strict";
+// 禅道 CLI - 主入口
+// Web HTML 解析模式 - 无需 REST API 权限
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("./config/config");
+const auth_1 = require("./core/auth");
+const api_client_1 = require("./core/api-client");
+const bug_service_1 = require("./services/bug.service");
+const task_service_1 = require("./services/task.service");
+const product_service_1 = require("./services/product.service");
+const project_service_1 = require("./services/project.service");
+const bug_1 = require("./commands/bug");
+const task_1 = require("./commands/task");
+const product_1 = require("./commands/product");
+const project_1 = require("./commands/project");
+const config_2 = require("./commands/config");
+const login_1 = require("./commands/login");
+const format_1 = require("./utils/format");
+// 加载 .env 文件
+dotenv_1.default.config();
+// 懒初始化服务（只在需要网络请求时才校验配置）
+let _services = null;
+function createServices() {
+    const config = (0, config_1.loadConfig)();
+    const auth = new auth_1.AuthManager(config);
+    const apiClient = new api_client_1.ApiClient(config, auth);
+    return {
+        config,
+        auth,
+        apiClient,
+        bugService: new bug_service_1.BugService(apiClient),
+        taskService: new task_service_1.TaskService(apiClient),
+        productService: new product_service_1.ProductService(apiClient),
+        projectService: new project_service_1.ProjectService(apiClient),
+    };
+}
+function getServices() {
+    if (!_services) {
+        _services = createServices();
+        _services.apiClient.setDebug(getDebug());
+    }
+    return _services;
+}
+const program = new commander_1.Command();
+program
+    .name('chandao4')
+    .description('禅道命令行工具 - Bug、任务、项目和产品管理')
+    .version('0.1.0')
+    .option('--json', '以 JSON 格式输出')
+    .option('--debug', '打印详细的请求和响应信息');
+function getUseJson() {
+    return program.opts().json || false;
+}
+function getDebug() {
+    return program.opts().debug || false;
+}
+// ---- status 命令 ----
+program.command('status')
+    .description('检查禅道服务器连接状态')
+    .action(async () => {
+    const spinner = (0, ora_1.default)('正在连接禅道服务器...').start();
+    try {
+        const { config, auth, productService, projectService } = getServices();
+        spinner.text = '正在登录...';
+        const authed = await auth.ensureAuth();
+        if (!authed) {
+            spinner.fail('连接失败');
+            console.log(chalk_1.default.red('\n认证失败。请检查:'));
+            console.log('  1. 服务器 URL 是否正确');
+            console.log('  2. 用户名密码是否正确');
+            console.log('  3. 网络是否能访问禅道服务器');
+            console.log(chalk_1.default.gray('\n💡 运行 chandao4 login 重新配置'));
+            process.exit(1);
+        }
+        spinner.text = '正在获取数据...';
+        const { products, total: pTotal } = await productService.getList();
+        const { projects, total: prjTotal } = await projectService.getList();
+        spinner.succeed('连接成功');
+        console.log(chalk_1.default.green(`\n✓ 禅道服务器: ${config.server.url}`));
+        console.log(chalk_1.default.green(`✓ 认证模式: ${auth.getAuthMode() === 'apikey' ? 'API Key' : 'Session (用户名/密码)'}`));
+        console.log(chalk_1.default.green(`✓ 账户: ${config.server.username}`));
+        if (!getUseJson()) {
+            if (projects.length > 0) {
+                console.log(chalk_1.default.bold(`\n项目 (${prjTotal}):\n`));
+                console.log((0, format_1.formatProjectTable)(projects.slice(0, 10)));
+                if (prjTotal > 10)
+                    console.log(chalk_1.default.gray(`  ... 还有 ${prjTotal - 10} 个项目，用 chandao4 project list 查看全部`));
+            }
+            if (products.length > 0) {
+                console.log(chalk_1.default.bold(`\n产品 (${pTotal}):\n`));
+                console.log((0, format_1.formatProductTable)(products.slice(0, 10)));
+                if (pTotal > 10)
+                    console.log(chalk_1.default.gray(`  ... 还有 ${pTotal - 10} 个产品，用 chandao4 product list 查看全部`));
+            }
+        }
+    }
+    catch (err) {
+        spinner.fail('连接失败');
+        console.error(String(err));
+        process.exit(1);
+    }
+});
+// 注册子命令
+program.addCommand((0, login_1.createLoginCommand)());
+program.addCommand((0, login_1.createLogoutCommand)());
+program.addCommand((0, config_2.createConfigCommand)());
+// 需要网络访问的命令通过 getter 懒加载
+program.addCommand((0, project_1.createProjectCommand)(new Proxy({}, { get(_, p) { return getServices().projectService[p]; } }), getUseJson));
+program.addCommand((0, product_1.createProductCommand)(new Proxy({}, { get(_, p) { return getServices().productService[p]; } }), getUseJson));
+program.addCommand((0, bug_1.createBugCommand)(new Proxy({}, { get(_, p) { return getServices().bugService[p]; } }), getUseJson));
+program.addCommand((0, task_1.createTaskCommand)(new Proxy({}, { get(_, p) { return getServices().taskService[p]; } }), getUseJson));
+// 启动
+program.parse(process.argv);
+// 无参数时显示帮助
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/dist/services/bug.service.d.ts

@@ -0,0 +1,59 @@
+import { ApiClient } from '../core/api-client';
+import { Bug } from '../types/models';
+export declare class BugService {
+    private client;
+    constructor(client: ApiClient);
+    /** 获取当前用户的 Bug 列表 */
+    getMyBugs(options?: {
+        limit?: number;
+        page?: number;
+    }): Promise<{
+        bugs: Bug[];
+        total: number;
+    }>;
+    /** 获取 Bug 列表 */
+    getList(productId: number, options?: {
+        status?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<{
+        bugs: Bug[];
+        total: number;
+    }>;
+    private myBugPath;
+    private bugBrowsePath;
+    /** 获取 Bug 详情 */
+    getDetail(bugId: number): Promise<Bug | null>;
+    private mapBug;
+    private buildDetailFields;
+    create(productId: number, bug: {
+        title: string;
+        severity: number;
+        priority: number;
+        type?: string;
+        module?: number;
+        assignedTo?: string;
+        steps?: string;
+        openedBuild?: string;
+        deadline?: string;
+    }): Promise<Bug | null>;
+    update(bugId: number, updates: Record<string, unknown>): Promise<Bug | null>;
+    /**
+     * 解决 Bug（active/reopened → resolved）
+     * resolution: fixed | bydesign | duplicate | external | notrepro | postponed
+     */
+    resolve(bugId: number, options: {
+        resolution: string;
+        resolvedBuild?: string;
+        comment?: string;
+        assignedTo?: string;
+    }): Promise<Bug | null>;
+    /** 关闭 Bug（resolved → closed） */
+    close(bugId: number, comment?: string): Promise<Bug | null>;
+    /** 激活 Bug（resolved/closed → active） */
+    activate(bugId: number, options?: {
+        assignedTo?: string;
+        comment?: string;
+    }): Promise<Bug | null>;
+    delete(bugId: number): Promise<void>;
+}

package/dist/services/bug.service.js

@@ -0,0 +1,232 @@
+"use strict";
+// Bug 业务逻辑 - JSON API
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BugService = void 0;
+class BugService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** 获取当前用户的 Bug 列表 */
+    async getMyBugs(options) {
+        const data = await this.client.getJson(this.myBugPath(options));
+        const rawBugs = data.bugs || data;
+        const bugs = [];
+        if (Array.isArray(rawBugs)) {
+            for (const b of rawBugs)
+                bugs.push(this.mapBug(b));
+        }
+        else if (typeof rawBugs === 'object') {
+            for (const [id, b] of Object.entries(rawBugs)) {
+                if (b && typeof b === 'object')
+                    bugs.push(this.mapBug({ ...b, id }));
+            }
+        }
+        bugs.sort((a, b) => b.id - a.id);
+        let total = bugs.length;
+        if (data.summary) {
+            const m = data.summary.match(/共\s*(\d+)\s*个/);
+            if (m)
+                total = parseInt(m[1], 10);
+        }
+        return { bugs, total };
+    }
+    /** 获取 Bug 列表 */
+    async getList(productId, options) {
+        const data = await this.client.getJson(this.bugBrowsePath(productId, { limit: options?.limit, page: options?.page }));
+        const rawBugs = data.bugs || data;
+        const bugs = [];
+        if (Array.isArray(rawBugs)) {
+            for (const b of rawBugs)
+                bugs.push(this.mapBug(b));
+        }
+        else if (typeof rawBugs === 'object') {
+            for (const [id, b] of Object.entries(rawBugs)) {
+                if (b && typeof b === 'object')
+                    bugs.push(this.mapBug({ ...b, id }));
+            }
+        }
+        bugs.sort((a, b) => b.id - a.id);
+        let total = bugs.length;
+        if (data.summary) {
+            const m = data.summary.match(/共\s*(\d+)\s*个/);
+            if (m)
+                total = parseInt(m[1], 10);
+        }
+        return { bugs, total };
+    }
+    // 禅道 PATH_INFO 路由：要传 recPerPage 必须把前面参数段都补齐。query string 不被识别。
+    myBugPath(opts) {
+        if (!opts?.limit || opts.limit <= 0)
+            return '/my-bug.json';
+        const page = opts.page && opts.page > 0 ? opts.page : 1;
+        // my-bug-{type}-{orderBy}-{recTotal}-{recPerPage}-{pageID}
+        return `/my-bug-assignedTo-id_desc-0-${opts.limit}-${page}.json`;
+    }
+    bugBrowsePath(productId, opts) {
+        if (!opts?.limit || opts.limit <= 0)
+            return `/bug-browse-${productId}.json`;
+        const page = opts.page && opts.page > 0 ? opts.page : 1;
+        // bug-browse-{productID}-{branch}-{browseType}-{param}-{orderBy}-{recTotal}-{recPerPage}-{pageID}
+        return `/bug-browse-${productId}-0-all-0-id_desc-0-${opts.limit}-${page}.json`;
+    }
+    /** 获取 Bug 详情 */
+    async getDetail(bugId) {
+        const data = await this.client.getJson(`/bug-view-${bugId}.json`);
+        if (!data.bug)
+            return null;
+        return this.mapBug(data.bug);
+    }
+    mapBug(b) {
+        return {
+            id: parseInt(b.id, 10),
+            title: b.title || '',
+            product: parseInt(b.product, 10) || 0,
+            module: parseInt(b.module, 10) || 0,
+            severity: parseInt(b.severity, 10) || 3,
+            priority: parseInt(b.pri, 10) || 3,
+            status: b.status || 'active',
+            type: b.type || '',
+            assignedTo: b.assignedTo || '',
+            openedBy: b.openedBy || '',
+            resolvedBy: b.resolvedBy || undefined,
+            deadline: b.deadline !== '0000-00-00' ? b.deadline : undefined,
+            steps: b.steps || '',
+            openedDate: b.openedDate || '',
+            resolvedDate: b.resolvedDate || undefined,
+            detailFields: this.buildDetailFields(b),
+        };
+    }
+    buildDetailFields(b) {
+        const f = {};
+        if (b.severity)
+            f['严重程度'] = ['', '致命', '严重', '一般', '建议'][parseInt(b.severity, 10)] || b.severity;
+        if (b.pri)
+            f['优先级'] = ['', '紧急', '高', '中', '低'][parseInt(b.pri, 10)] || b.pri;
+        if (b.status)
+            f['状态'] = b.status;
+        if (b.type)
+            f['类型'] = b.type;
+        if (b.assignedTo)
+            f['指派给'] = b.assignedTo;
+        if (b.openedBy)
+            f['创建者'] = b.openedBy;
+        if (b.openedDate)
+            f['创建日期'] = b.openedDate;
+        if (b.resolvedBy)
+            f['解决者'] = b.resolvedBy;
+        if (b.resolvedDate)
+            f['解决日期'] = b.resolvedDate;
+        if (b.deadline && b.deadline !== '0000-00-00')
+            f['截止日期'] = b.deadline;
+        if (b.steps)
+            f['重现步骤'] = b.steps.replace(/<[^>]+>/g, '\n').replace(/\n+/g, '\n').trim();
+        return f;
+    }
+    async create(productId, bug) {
+        const data = {
+            title: bug.title, severity: String(bug.severity),
+            pri: String(bug.priority), type: bug.type || 'codeerror',
+            product: String(productId), module: String(bug.module || 0),
+            'openedBuild[]': bug.openedBuild || 'trunk',
+        };
+        if (bug.assignedTo)
+            data.assignedTo = bug.assignedTo;
+        if (bug.steps)
+            data.steps = bug.steps;
+        data.deadline = bug.deadline || new Date().toISOString().split('T')[0];
+        const resp = await this.client.postJson(`/bug-create-${productId}.json`, data);
+        if (resp?.result === 'success' || resp?.status === 'success') {
+            const bugId = resp?.data ? parseInt(String(resp.data), 10) : 0;
+            if (bugId > 0) {
+                return this.getDetail(bugId);
+            }
+            const { bugs } = await this.getList(productId);
+            const created = bugs.find(b => b.title === bug.title) || (bugs.length > 0 ? bugs.reduce((a, b) => a.id > b.id ? a : b) : null);
+            if (created)
+                return created;
+        }
+        if (resp?.message) {
+            console.error('创建失败:', resp.message);
+            return null;
+        }
+        return null;
+    }
+    async update(bugId, updates) {
+        const current = await this.getDetail(bugId);
+        if (!current) {
+            console.error('更新失败: Bug 不存在');
+            return null;
+        }
+        const data = {};
+        if (updates.title)
+            data.title = String(updates.title);
+        if (updates.status)
+            data.status = String(updates.status);
+        if (updates.severity !== undefined)
+            data.severity = String(updates.severity);
+        if (updates.priority !== undefined)
+            data.pri = String(updates.priority);
+        if (updates.assignedTo)
+            data.assignedTo = String(updates.assignedTo);
+        if (updates.steps)
+            data.steps = String(updates.steps);
+        if (!data.title)
+            data.title = current.title;
+        data.deadline = String(updates.deadline || current.deadline || '');
+        await this.client.postJson(`/bug-edit-${bugId}.json`, data);
+        return this.getDetail(bugId);
+    }
+    /**
+     * 解决 Bug（active/reopened → resolved）
+     * resolution: fixed | bydesign | duplicate | external | notrepro | postponed
+     */
+    async resolve(bugId, options) {
+        const data = {
+            resolution: options.resolution,
+            'resolvedBuild[]': options.resolvedBuild || 'trunk',
+        };
+        if (options.assignedTo)
+            data.assignedTo = options.assignedTo;
+        if (options.comment)
+            data.comment = options.comment;
+        await this.client.postJson(`/bug-resolve-${bugId}.json`, data);
+        const bug = await this.getDetail(bugId);
+        if (bug && bug.status !== 'resolved') {
+            console.error('解决失败: 服务端未能更新 Bug 状态，当前状态为', bug.status);
+            return null;
+        }
+        return bug;
+    }
+    /** 关闭 Bug（resolved → closed） */
+    async close(bugId, comment) {
+        const data = { comment: comment || '' };
+        await this.client.postJson(`/bug-close-${bugId}.json`, data);
+        const bug = await this.getDetail(bugId);
+        if (bug && bug.status !== 'closed') {
+            console.error('关闭失败: 服务端未能更新 Bug 状态，当前状态为', bug.status);
+            return null;
+        }
+        return bug;
+    }
+    /** 激活 Bug（resolved/closed → active） */
+    async activate(bugId, options) {
+        const data = { comment: options?.comment || '' };
+        if (options?.assignedTo)
+            data.assignedTo = options.assignedTo;
+        await this.client.postJson(`/bug-activate-${bugId}.json`, data);
+        const bug = await this.getDetail(bugId);
+        if (bug && bug.status !== 'active') {
+            console.error('激活失败: 服务端未能更新 Bug 状态，当前状态为', bug.status);
+            return null;
+        }
+        return bug;
+    }
+    async delete(bugId) {
+        const resp = await this.client.getJson(`/bug-delete-${bugId}-yes.json`);
+        if (resp?.result !== 'success' && resp?.message) {
+            console.error('删除失败:', resp.message);
+        }
+    }
+}
+exports.BugService = BugService;

package/dist/services/product.service.d.ts

@@ -0,0 +1,12 @@
+import { ApiClient } from '../core/api-client';
+import { Product } from '../types/models';
+export declare class ProductService {
+    private client;
+    constructor(client: ApiClient);
+    /** 获取产品列表 */
+    getList(): Promise<{
+        products: Product[];
+        total: number;
+    }>;
+    getDetail(id: number): Promise<Product | null>;
+}

package/dist/services/product.service.js

@@ -0,0 +1,43 @@
+"use strict";
+// Product 业务逻辑 - JSON API
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductService = void 0;
+class ProductService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** 获取产品列表 */
+    async getList() {
+        const data = await this.client.getJson('/product-all.json');
+        const products = [];
+        if (data.products) {
+            for (const [id, name] of Object.entries(data.products)) {
+                products.push({ id: parseInt(id, 10), name: name, code: '', status: '' });
+            }
+        }
+        // productStats 有更详细的信息
+        if (data.productStats) {
+            for (const p of data.productStats) {
+                const existing = products.find(x => x.id === parseInt(p.id, 10));
+                if (existing) {
+                    existing.code = p.code || '';
+                    existing.status = p.status || '';
+                }
+            }
+        }
+        return { products, total: products.length };
+    }
+    async getDetail(id) {
+        const data = await this.client.getJson(`/product-view-${id}.json`);
+        if (!data.product)
+            return null;
+        return {
+            id: parseInt(data.product.id, 10),
+            name: data.product.name,
+            code: data.product.code || '',
+            status: data.product.status || '',
+        };
+    }
+}
+exports.ProductService = ProductService;

package/dist/services/project.service.d.ts

@@ -0,0 +1,18 @@
+import { ApiClient } from '../core/api-client';
+export interface Project {
+    id: number;
+    name: string;
+    code: string;
+    status: string;
+    begin: string;
+    end: string;
+}
+export declare class ProjectService {
+    private client;
+    constructor(client: ApiClient);
+    getList(): Promise<{
+        projects: Project[];
+        total: number;
+    }>;
+    getDetail(id: number): Promise<Project | null>;
+}

package/dist/services/project.service.js

@@ -0,0 +1,35 @@
+"use strict";
+// Project 业务逻辑 - JSON API
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectService = void 0;
+class ProjectService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getList() {
+        const data = await this.client.getJson('/project-all.json');
+        const projects = [];
+        if (data.projects) {
+            for (const [id, name] of Object.entries(data.projects)) {
+                projects.push({ id: parseInt(id, 10), name: name, code: '', status: '', begin: '', end: '' });
+            }
+        }
+        return { projects, total: projects.length };
+    }
+    async getDetail(id) {
+        const data = await this.client.getJson(`/project-view-${id}.json`);
+        if (!data.project)
+            return null;
+        const p = data.project;
+        return {
+            id: parseInt(p.id, 10),
+            name: p.name,
+            code: p.code || '',
+            status: p.status || '',
+            begin: p.begin || '',
+            end: p.end || '',
+        };
+    }
+}
+exports.ProjectService = ProjectService;

package/dist/services/task.service.d.ts

@@ -0,0 +1,55 @@
+import { ApiClient } from '../core/api-client';
+import { Task } from '../types/models';
+export declare class TaskService {
+    private client;
+    constructor(client: ApiClient);
+    /** 获取当前用户的任务列表 */
+    getMyTasks(): Promise<{
+        tasks: Task[];
+        total: number;
+    }>;
+    /** 获取任务列表 */
+    getList(projectId: number): Promise<{
+        tasks: Task[];
+        total: number;
+    }>;
+    /** 获取任务详情 */
+    getDetail(taskId: number): Promise<Task | null>;
+    private mapTask;
+    private buildDetailFields;
+    /** 检查操作是否成功（通过 resp 或实际状态验证） */
+    private isSuccess;
+    create(projectId: number, task: {
+        name: string;
+        type?: string;
+        priority?: number;
+        estimate?: number;
+        deadline?: string;
+        estStarted?: string;
+        assignedTo?: string;
+        desc?: string;
+    }): Promise<Task | null>;
+    update(taskId: number, updates: Record<string, unknown>): Promise<Task | null>;
+    /** 取消任务 */
+    cancel(taskId: number, comment?: string): Promise<Task | null>;
+    /** 开始任务（wait/pause → doing） */
+    start(taskId: number, options?: {
+        consumed?: number;
+        left?: number;
+        assignedTo?: string;
+        comment?: string;
+    }): Promise<Task | null>;
+    /** 完成任务（doing → done） */
+    finish(taskId: number, options?: {
+        consumed?: number;
+        comment?: string;
+    }): Promise<Task | null>;
+    /** 关闭任务（done/cancel → closed） */
+    close(taskId: number, comment?: string): Promise<Task | null>;
+    /** 激活任务（cancel/closed → wait） */
+    activate(taskId: number, options?: {
+        left?: number;
+        comment?: string;
+    }): Promise<Task | null>;
+    delete(taskId: number, projectId?: number): Promise<void>;
+}