chandao4 0.1.0

package/dist/services/task.service.js

@@ -0,0 +1,254 @@
+"use strict";
+// Task 业务逻辑 - JSON API
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskService = void 0;
+class TaskService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** 获取当前用户的任务列表 */
+    async getMyTasks() {
+        const data = await this.client.getJson('/my-task.json');
+        const tasks = [];
+        if (data.tasks) {
+            for (const [id, t] of Object.entries(data.tasks)) {
+                tasks.push(this.mapTask({ ...t, id }));
+            }
+        }
+        tasks.sort((a, b) => b.id - a.id);
+        let total = tasks.length;
+        if (data.summary) {
+            const m = data.summary.match(/共\s*(\d+)\s*个/);
+            if (m)
+                total = parseInt(m[1], 10);
+        }
+        return { tasks, total };
+    }
+    /** 获取任务列表 */
+    async getList(projectId) {
+        const data = await this.client.getJson(`/project-task-${projectId}.json`);
+        const tasks = [];
+        if (data.tasks) {
+            for (const [id, t] of Object.entries(data.tasks)) {
+                tasks.push(this.mapTask({ ...t, id }));
+            }
+        }
+        tasks.sort((a, b) => b.id - a.id);
+        let total = tasks.length;
+        if (data.summary) {
+            const m = data.summary.match(/共\s*(\d+)\s*个/);
+            if (m)
+                total = parseInt(m[1], 10);
+        }
+        return { tasks, total };
+    }
+    /** 获取任务详情 */
+    async getDetail(taskId) {
+        const data = await this.client.getJson(`/task-view-${taskId}.json`);
+        if (!data.task)
+            return null;
+        return this.mapTask(data.task);
+    }
+    mapTask(t) {
+        return {
+            id: parseInt(t.id, 10),
+            name: t.name || '',
+            execution: parseInt(t.project, 10) || 0,
+            module: parseInt(t.module, 10) || 0,
+            type: t.type || '',
+            priority: parseInt(t.pri, 10) || 3,
+            status: t.status || 'wait',
+            assignedTo: t.assignedTo || '',
+            estimate: parseFloat(t.estimate) || 0,
+            consumed: parseFloat(t.consumed) || 0,
+            left: parseFloat(t.left) || 0,
+            deadline: t.deadline !== '0000-00-00' ? t.deadline : undefined,
+            estStarted: t.estStarted !== '0000-00-00' ? t.estStarted : undefined,
+            openedDate: t.openedDate || '',
+            desc: t.desc || '',
+            detailFields: this.buildDetailFields(t),
+        };
+    }
+    buildDetailFields(t) {
+        const f = {};
+        const priLabels = ['', '紧急', '高', '中', '低'];
+        if (t.pri)
+            f['优先级'] = priLabels[parseInt(t.pri, 10)] || t.pri;
+        if (t.status)
+            f['状态'] = t.status;
+        if (t.type)
+            f['类型'] = t.type;
+        if (t.assignedTo)
+            f['指派给'] = t.assignedTo;
+        if (t.openedBy)
+            f['创建者'] = t.openedBy;
+        if (t.openedDate)
+            f['创建日期'] = t.openedDate;
+        if (t.estimate)
+            f['预估工时'] = `${t.estimate}h`;
+        if (t.consumed)
+            f['已消耗'] = `${t.consumed}h`;
+        if (t.left)
+            f['剩余'] = `${t.left}h`;
+        if (t.deadline && t.deadline !== '0000-00-00')
+            f['截止日期'] = t.deadline;
+        if (t.desc)
+            f['描述'] = t.desc;
+        return f;
+    }
+    /** 检查操作是否成功（通过 resp 或实际状态验证） */
+    isSuccess(resp) {
+        if (resp === null || resp === undefined)
+            return false;
+        if (typeof resp === 'object') {
+            if (resp.result === 'success' || resp.status === 'success')
+                return true;
+            // JS locate string 被 JSON 包装后 data 是字符串
+            if (resp.data && typeof resp.data === 'string' && resp.data.includes('location'))
+                return true;
+        }
+        // die(js::locate(...)) 返回原始 JS 字符串
+        if (typeof resp === 'string' && resp.includes('location'))
+            return true;
+        return false;
+    }
+    async create(projectId, task) {
+        const data = {
+            project: String(projectId),
+            name: task.name,
+            type: task.type || 'devel',
+            pri: String(task.priority || 3),
+            'assignedTo[]': task.assignedTo || '',
+            estStarted: task.estStarted || new Date().toISOString().split('T')[0],
+        };
+        if (task.estimate)
+            data.estimate = String(task.estimate);
+        data.deadline = task.deadline || data.estStarted;
+        if (task.desc)
+            data.desc = task.desc;
+        const resp = await this.client.postJson(`/task-create-${projectId}.json`, data);
+        if (resp?.result === 'success' || resp?.status === 'success') {
+            const taskId = resp?.data ? parseInt(String(resp.data), 10) : 0;
+            if (taskId > 0) {
+                return this.getDetail(taskId);
+            }
+            const { tasks } = await this.getList(projectId);
+            if (tasks.length > 0) {
+                const byName = tasks.find(t => t.name === task.name);
+                if (byName)
+                    return byName;
+                return tasks[0];
+            }
+        }
+        if (resp?.message) {
+            console.error('创建失败:', resp.message);
+            return null;
+        }
+        return null;
+    }
+    async update(taskId, updates) {
+        const current = await this.getDetail(taskId);
+        if (!current) {
+            console.error('更新失败: 任务不存在');
+            return null;
+        }
+        const data = {};
+        if (updates.name)
+            data.name = String(updates.name);
+        if (updates.status)
+            data.status = String(updates.status);
+        if (updates.priority !== undefined)
+            data.pri = String(updates.priority);
+        if (updates.assignedTo)
+            data.assignedTo = String(updates.assignedTo);
+        if (updates.consumed !== undefined)
+            data.consumed = String(updates.consumed);
+        if (updates.left !== undefined)
+            data.left = String(updates.left);
+        if (updates.desc)
+            data.desc = String(updates.desc);
+        data.estimate = updates.estimate !== undefined
+            ? String(updates.estimate)
+            : String(current.estimate || 0);
+        data.estStarted = String(updates.estStarted || current.estStarted || '');
+        data.deadline = String(updates.deadline || current.deadline || '');
+        if (!data.estStarted || data.estStarted === '')
+            data.estStarted = new Date().toISOString().split('T')[0];
+        if (!data.deadline || data.deadline === '')
+            data.deadline = data.estStarted;
+        await this.client.postJson(`/task-edit-${taskId}.json`, data);
+        return this.getDetail(taskId);
+    }
+    /** 取消任务 */
+    async cancel(taskId, comment) {
+        // comment 字段确保 $_POST 非空，禅道以此判断是否执行取消操作
+        const data = { comment: comment || '' };
+        await this.client.postJson(`/task-cancel-${taskId}.json`, data);
+        const task = await this.getDetail(taskId);
+        if (task && task.status !== 'cancel') {
+            console.error('取消失败: 服务端未能更新任务状态，当前状态为', task.status);
+            return null;
+        }
+        return task;
+    }
+    /** 开始任务（wait/pause → doing） */
+    async start(taskId, options) {
+        const data = { comment: options?.comment || '' };
+        if (options?.consumed !== undefined)
+            data.consumed = String(options.consumed);
+        if (options?.left !== undefined)
+            data.left = String(options.left);
+        if (options?.assignedTo)
+            data.assignedTo = options.assignedTo;
+        await this.client.postJson(`/task-start-${taskId}.json`, data);
+        const task = await this.getDetail(taskId);
+        if (task && task.status !== 'doing') {
+            console.error('开始失败: 服务端未能更新任务状态，当前状态为', task.status);
+            return null;
+        }
+        return task;
+    }
+    /** 完成任务（doing → done） */
+    async finish(taskId, options) {
+        const data = { left: '0' };
+        if (options?.consumed !== undefined)
+            data.consumed = String(options.consumed);
+        if (options?.comment)
+            data.comment = options.comment;
+        await this.client.postJson(`/task-finish-${taskId}.json`, data);
+        const task = await this.getDetail(taskId);
+        if (task && task.status !== 'done') {
+            console.error('完成失败: 服务端未能更新任务状态，当前状态为', task.status);
+            return null;
+        }
+        return task;
+    }
+    /** 关闭任务（done/cancel → closed） */
+    async close(taskId, comment) {
+        const data = { comment: comment || '' };
+        await this.client.postJson(`/task-close-${taskId}.json`, data);
+        const task = await this.getDetail(taskId);
+        if (task && task.status !== 'closed') {
+            console.error('关闭失败: 服务端未能更新任务状态，当前状态为', task.status);
+            return null;
+        }
+        return task;
+    }
+    /** 激活任务（cancel/closed → wait） */
+    async activate(taskId, options) {
+        const data = { comment: options?.comment || '' };
+        if (options?.left !== undefined)
+            data.left = String(options.left);
+        await this.client.postJson(`/task-activate-${taskId}.json`, data);
+        return this.getDetail(taskId);
+    }
+    async delete(taskId, projectId) {
+        const pid = projectId || 0;
+        const resp = await this.client.getJson(`/task-delete-${pid}-${taskId}-yes.json`);
+        if (resp?.result !== 'success' && resp?.message) {
+            console.error('删除失败:', resp.message);
+        }
+    }
+}
+exports.TaskService = TaskService;

package/dist/types/api.d.ts

@@ -0,0 +1,31 @@
+import { Bug, Task, Product, Execution, User } from './models';
+export interface ZentaoListResponse<T> {
+    page: number;
+    total: number;
+    limit: number;
+    bugs?: T[];
+    tasks?: T[];
+    products?: T[];
+    executions?: T[];
+    users?: T[];
+}
+export interface ZentaoItemResponse<T> {
+    data: T;
+}
+export interface ZentaoErrorResponse {
+    errcode: number;
+    errmsg: string;
+}
+export type BugListResponse = ZentaoListResponse<Bug>;
+export type BugDetailResponse = ZentaoItemResponse<Bug>;
+export type TaskListResponse = ZentaoListResponse<Task>;
+export type TaskDetailResponse = ZentaoItemResponse<Task>;
+export type ProductListResponse = ZentaoListResponse<Product>;
+export type ProductDetailResponse = ZentaoItemResponse<Product>;
+export type ExecutionListResponse = ZentaoListResponse<Execution>;
+export type UserListResponse = ZentaoListResponse<User>;
+export interface LoginResult {
+    success: boolean;
+    zentaosid?: string;
+    error?: string;
+}

package/dist/types/api.js

@@ -0,0 +1,3 @@
+"use strict";
+// API 响应类型
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/config.d.ts

@@ -0,0 +1,18 @@
+export interface ServerConfig {
+    url: string;
+    username?: string;
+    password?: string;
+    code?: string;
+    token?: string;
+}
+export interface OutputConfig {
+    format: 'table' | 'json';
+    color: boolean;
+}
+export interface ZentaoConfig {
+    server: ServerConfig;
+    output: OutputConfig;
+}
+export interface RuntimeConfig extends ZentaoConfig {
+    authMode: 'session' | 'apikey';
+}

package/dist/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+// 配置类型定义
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/models.d.ts

@@ -0,0 +1,65 @@
+export interface Bug {
+    id: number;
+    title: string;
+    product: number;
+    module: number;
+    severity: number;
+    priority: number;
+    status: string;
+    type: string;
+    assignedTo: string;
+    openedBy: string;
+    resolvedBy?: string;
+    steps?: string;
+    deadline?: string;
+    openedDate: string;
+    resolvedDate?: string;
+    /** HTML 页面提取的所有详情字段 */
+    detailFields?: Record<string, string>;
+}
+export interface Task {
+    id: number;
+    name: string;
+    execution: number;
+    module: number;
+    type: string;
+    priority: number;
+    status: string;
+    assignedTo: string;
+    estimate: number;
+    consumed: number;
+    left: number;
+    deadline?: string;
+    estStarted?: string;
+    openedDate: string;
+    /** 描述 */
+    desc?: string;
+    /** HTML 页面提取的所有详情字段 */
+    detailFields?: Record<string, string>;
+}
+export interface Product {
+    id: number;
+    name: string;
+    code: string;
+    status: string;
+}
+export interface Execution {
+    id: number;
+    name: string;
+    code: string;
+    product: number;
+    type: string;
+    status: string;
+    begin: string;
+    end?: string;
+}
+export interface User {
+    id: number;
+    account: string;
+    realname: string;
+    role: string;
+}
+export declare const BUG_STATUS_MAP: Record<string, string>;
+export declare const BUG_SEVERITY_MAP: Record<number, string>;
+export declare const BUG_PRIORITY_MAP: Record<number, string>;
+export declare const TASK_STATUS_MAP: Record<string, string>;

package/dist/types/models.js

@@ -0,0 +1,33 @@
+"use strict";
+// 业务模型类型定义
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TASK_STATUS_MAP = exports.BUG_PRIORITY_MAP = exports.BUG_SEVERITY_MAP = exports.BUG_STATUS_MAP = void 0;
+// Bug 状态常量
+exports.BUG_STATUS_MAP = {
+    active: '激活',
+    resolved: '已解决',
+    closed: '已关闭',
+};
+// Bug 严重程度
+exports.BUG_SEVERITY_MAP = {
+    1: '致命',
+    2: '严重',
+    3: '一般',
+    4: '建议',
+};
+// Bug 优先级
+exports.BUG_PRIORITY_MAP = {
+    1: '紧急',
+    2: '高',
+    3: '中',
+    4: '低',
+};
+// Task 状态常量
+exports.TASK_STATUS_MAP = {
+    wait: '未开始',
+    doing: '进行中',
+    done: '已完成',
+    pause: '已暂停',
+    cancel: '已取消',
+    closed: '已关闭',
+};

package/dist/utils/format.d.ts

@@ -0,0 +1,38 @@
+import { Bug, Task, Product, Execution } from '../types/models';
+import { Project } from '../services/project.service';
+/**
+ * 格式化 Bug 列表为表格
+ */
+export declare function formatBugTable(bugs: Bug[]): string;
+/**
+ * 格式化 Bug 详情
+ */
+export declare function formatBugDetail(bug: Bug): string;
+/**
+ * 格式化 Task 列表为表格
+ */
+export declare function formatTaskTable(tasks: Task[]): string;
+/**
+ * 格式化 Task 详情
+ */
+export declare function formatTaskDetail(task: Task): string;
+/**
+ * 格式化 Product 列表
+ */
+export declare function formatProductTable(products: Product[]): string;
+/**
+ * 格式化 Execution 列表
+ */
+export declare function formatExecutionTable(executions: Execution[]): string;
+/**
+ * 格式化 Project 列表
+ */
+export declare function formatProjectTable(projects: Project[]): string;
+export declare function formatBugStatus(status: string): string;
+export declare function formatBugSeverity(severity: number): string;
+export declare function formatBugPriority(priority: number): string;
+export declare function formatTaskStatus(status: string): string;
+/**
+ * JSON 输出
+ */
+export declare function formatJson(data: unknown): string;

package/dist/utils/format.js

@@ -0,0 +1,201 @@
+"use strict";
+// 表格和颜色输出格式化
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBugTable = formatBugTable;
+exports.formatBugDetail = formatBugDetail;
+exports.formatTaskTable = formatTaskTable;
+exports.formatTaskDetail = formatTaskDetail;
+exports.formatProductTable = formatProductTable;
+exports.formatExecutionTable = formatExecutionTable;
+exports.formatProjectTable = formatProjectTable;
+exports.formatBugStatus = formatBugStatus;
+exports.formatBugSeverity = formatBugSeverity;
+exports.formatBugPriority = formatBugPriority;
+exports.formatTaskStatus = formatTaskStatus;
+exports.formatJson = formatJson;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const models_1 = require("../types/models");
+/**
+ * 格式化 Bug 列表为表格
+ */
+function formatBugTable(bugs) {
+    const table = new cli_table3_1.default({
+        head: ['ID', '标题', '状态', '严重程度', '优先级', '指派给'],
+        colWidths: [8, 40, 10, 10, 8, 12],
+        wordWrap: true,
+    });
+    for (const bug of bugs) {
+        table.push([
+            String(bug.id),
+            bug.title,
+            formatBugStatus(bug.status),
+            formatBugSeverity(bug.severity),
+            formatBugPriority(bug.priority),
+            bug.assignedTo || '-',
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * 格式化 Bug 详情
+ */
+function formatBugDetail(bug) {
+    const lines = [chalk_1.default.bold(`\nBug #${bug.id}: ${bug.title}\n`)];
+    const fields = bug.detailFields || {};
+    const labels = Object.keys(fields);
+    if (labels.length > 0) {
+        const maxLen = Math.max(...labels.map(l => l.length));
+        for (const [label, value] of Object.entries(fields)) {
+            if (!value || value === '-' || value === '0000-00-00' || value === '0000-00-00 00:00:00')
+                continue;
+            const display = label === '重现步骤' ? value.substring(0, 200) + (value.length > 200 ? '...' : '') : value;
+            lines.push(`${chalk_1.default.gray(label.padEnd(maxLen + 1))} ${display}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * 格式化 Task 列表为表格
+ */
+function formatTaskTable(tasks) {
+    const table = new cli_table3_1.default({
+        head: ['ID', '名称', '状态', '优先级', '指派给', '预估(h)', '已消耗(h)'],
+        colWidths: [8, 35, 10, 8, 12, 10, 10],
+        wordWrap: true,
+    });
+    for (const task of tasks) {
+        table.push([
+            String(task.id),
+            task.name,
+            formatTaskStatus(task.status),
+            formatBugPriority(task.priority),
+            task.assignedTo || '-',
+            String(task.estimate || 0),
+            String(task.consumed || 0),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * 格式化 Task 详情
+ */
+function formatTaskDetail(task) {
+    const lines = [chalk_1.default.bold(`\n任务 #${task.id}: ${task.name}\n`)];
+    const fields = task.detailFields || {};
+    const labels = Object.keys(fields);
+    if (labels.length > 0) {
+        const maxLen = Math.max(...labels.map(l => l.length));
+        for (const [label, value] of Object.entries(fields)) {
+            if (!value || value === '-' || value === '0000-00-00' || value === '0000-00-00 00:00:00' || value === '暂无')
+                continue;
+            lines.push(`${chalk_1.default.gray(label.padEnd(maxLen + 1))} ${value}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * 格式化 Product 列表
+ */
+function formatProductTable(products) {
+    const table = new cli_table3_1.default({
+        head: ['ID', '名称', '代号', '状态'],
+        colWidths: [8, 30, 20, 10],
+    });
+    for (const p of products) {
+        table.push([
+            String(p.id),
+            p.name,
+            p.code || '-',
+            p.status || '-',
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * 格式化 Execution 列表
+ */
+function formatExecutionTable(executions) {
+    const table = new cli_table3_1.default({
+        head: ['ID', '名称', '类型', '状态', '开始日期', '结束日期'],
+        colWidths: [8, 25, 10, 10, 14, 14],
+    });
+    for (const e of executions) {
+        table.push([
+            String(e.id),
+            e.name,
+            e.type || '-',
+            e.status || '-',
+            e.begin || '-',
+            e.end || '-',
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * 格式化 Project 列表
+ */
+function formatProjectTable(projects) {
+    const table = new cli_table3_1.default({
+        head: ['ID', '名称', '代号', '状态', '开始日期', '结束日期'],
+        colWidths: [8, 30, 20, 10, 14, 14],
+    });
+    for (const p of projects) {
+        table.push([
+            String(p.id),
+            p.name,
+            p.code || '-',
+            p.status || '-',
+            p.begin || '-',
+            p.end || '-',
+        ]);
+    }
+    return table.toString();
+}
+// 状态格式化函数
+function formatBugStatus(status) {
+    const label = models_1.BUG_STATUS_MAP[status] || status;
+    switch (status) {
+        case 'active': return chalk_1.default.red(label);
+        case 'resolved': return chalk_1.default.green(label);
+        case 'closed': return chalk_1.default.gray(label);
+        default: return label;
+    }
+}
+function formatBugSeverity(severity) {
+    const label = models_1.BUG_SEVERITY_MAP[severity] || String(severity);
+    if (severity <= 2)
+        return chalk_1.default.red(label);
+    if (severity === 3)
+        return chalk_1.default.yellow(label);
+    return chalk_1.default.gray(label);
+}
+function formatBugPriority(priority) {
+    const label = models_1.BUG_PRIORITY_MAP[priority] || String(priority);
+    if (priority === 1)
+        return chalk_1.default.red(label);
+    if (priority === 2)
+        return chalk_1.default.yellow(label);
+    return chalk_1.default.green(label);
+}
+function formatTaskStatus(status) {
+    const label = models_1.TASK_STATUS_MAP[status] || status;
+    switch (status) {
+        case 'doing': return chalk_1.default.blue(label);
+        case 'done': return chalk_1.default.green(label);
+        case 'closed': return chalk_1.default.gray(label);
+        case 'pause': return chalk_1.default.yellow(label);
+        case 'cancel': return chalk_1.default.red(label);
+        case 'wait': return chalk_1.default.cyan(label);
+        default: return label;
+    }
+}
+/**
+ * JSON 输出
+ */
+function formatJson(data) {
+    return JSON.stringify(data, null, 2);
+}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 询问用户确认
+ */
+export declare function confirm(message: string): Promise<boolean>;
+/**
+ * 询问用户输入
+ */
+export declare function prompt(message: string, defaultValue?: string): Promise<string>;
+/**
+ * 询问密码（不回显）
+ */
+export declare function promptPassword(message: string): Promise<string>;