chandao4 0.1.0

package/.env.example

@@ -0,0 +1,10 @@
+# 禅道服务器 URL
+ZENTAO_URL=https://your-company.chandao.com
+
+# 登录凭据
+ZENTAO_USERNAME=
+ZENTAO_PASSWORD=
+
+# 可选：API Key 认证（优先于密码）
+# ZENTAO_CODE=
+# ZENTAO_TOKEN=

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# 更新日志
+
+所有显著改动按版本记录于此。
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-25
+
+### Added
+
+- 查询命令：`bug my/list/show`、`task my/list/show`、`project list/show`、`product list`、`status`
+- 写入命令：`bug create/update/delete`、`task create/update/delete`
+- 登录管理：`login` / `logout`，凭据保存到 `~/.chandao4/config.json`
+- 配置管理：`config show/set`
+- 支持禅道企业版 4.1.3+，通过 Session Cookie 认证，无需管理员后台权限
+- GitHub Actions 自动发布到 npm（基于 Trusted Publishing / OIDC）
+
+[Unreleased]: https://github.com/gaoshang212/chandao4/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/gaoshang212/chandao4/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gaoshang212
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# 禅道 CLI (chandao4)
+
+禅道命令行工具，支持 Bug、任务、项目和产品管理。适用于禅道企业版 4.1.3+。
+
+> ⚠️ **当前状态**：查询类命令（`list` / `show` / `my` / `status`）已稳定可用；写入类命令（`create` / `update` / `delete`）仍在完善中，使用时请自行验证结果。
+
+## 安装
+
+```bash
+npm install -g chandao4
+```
+
+或本地开发：
+
+```bash
+git clone <repo>
+cd chandao4
+npm install
+npm run build
+npm link
+```
+
+## 快速开始
+
+### 1. 配置
+
+**推荐：交互式登录**
+
+```bash
+chandao4 login
+```
+
+按提示输入禅道地址、用户名、密码，自动验证并保存。
+
+**或手动配置环境变量**
+
+```bash
+cp .env.example .env
+# 编辑 .env 填写你的禅道信息
+```
+
+```bash
+# .env 文件内容
+ZENTAO_URL=https://your-company.chandao.com
+ZENTAO_USERNAME=your-username
+ZENTAO_PASSWORD=your-password
+```
+
+### 2. 测试连接
+
+```bash
+chandao4 status
+```
+
+## 命令参考
+
+### 登录管理
+
+```bash
+# 交互式登录
+chandao4 login
+
+# 清除本地凭据
+chandao4 logout
+```
+
+### 项目管理
+
+```bash
+# 列出项目
+chandao4 project list
+chandao4 project list --limit 10 --page 1
+
+# 查看项目详情
+chandao4 project show 1001
+```
+
+### Bug 管理
+
+```bash
+# 获取当前账号的 Bug
+chandao4 bug my
+chandao4 bug my --limit 10 --page 1
+
+# 列出 Bug
+chandao4 bug list --product 2001
+chandao4 bug list --product 2001 --status active --limit 10
+
+# 查看 Bug 详情
+chandao4 bug show 4001
+
+# 创建 Bug
+chandao4 bug create --product 2001
+chandao4 bug create --product 2001 --title "登录页面报错" --severity 2 --priority 2
+
+# 更新 Bug
+chandao4 bug update 4001 --status resolved --assigned-to zhangsan
+
+# 删除 Bug
+chandao4 bug delete 4001
+chandao4 bug delete 4001 --force
+```
+
+### 任务管理
+
+```bash
+# 获取当前账号的任务
+chandao4 task my
+chandao4 task my --limit 10 --page 1
+
+# 列出任务
+chandao4 task list -p 1001
+chandao4 task list -p 1001 --status doing --limit 10
+
+# 查看任务详情
+chandao4 task show 3001
+
+# 创建任务
+chandao4 task create -p 1001
+chandao4 task create -p 1001 --name "实现登录接口" --priority 2 --estimate 4
+
+# 更新任务
+chandao4 task update 3001 --status doing --assigned-to lisi
+chandao4 task update 3001 --consumed 3.5 --left 4.5
+
+# 删除任务
+chandao4 task delete 3001 -p 1001
+```
+
+### 产品管理
+
+```bash
+# 列出产品
+chandao4 product list
+chandao4 product list --limit 10 --page 2
+```
+
+### JSON 输出
+
+所有命令支持 `--json` 选项用于脚本集成：
+
+```bash
+chandao4 project list --json | jq '.[] | {id, name}'
+chandao4 task list -p 1001 --json | jq '.[] | {id, name, status}'
+chandao4 bug my --json
+```
+
+### 配置管理
+
+```bash
+chandao4 config show
+chandao4 config set server.url https://your-company.chandao.com
+chandao4 config set server.username yourname
+```
+
+## 开发
+
+```bash
+npm run dev -- status
+npm run dev -- bug show 4001
+npm run dev -- task list -p 1001
+npm run build
+npm run check
+```
+
+## 技术栈
+
+- TypeScript + Commander.js
+- Axios (HTTP 客户端)
+- cli-table3 + Chalk (输出格式化)
+
+## 认证
+
+使用用户名/密码登录获取 Session Cookie，无需管理员后台权限。
+
+方案：登入 → Session Cookie → 所有后续请求携带 Cookie 认证。
+
+## 兼容性
+
+| 版本 | 认证方式 | 状态 |
+|------|---------|------|
+| 禅道企业版 4.1.3 | Session Cookie | 测试通过 |
+| 禅道开源版 12.5.3+ | Session Cookie | 理论兼容 |
+| 其他版本 | - | 未测试 |

package/dist/commands/bug.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import { BugService } from '../services/bug.service';
+export declare function createBugCommand(bugService: BugService, getUseJson: () => boolean): Command;

package/dist/commands/bug.js

@@ -0,0 +1,373 @@
+"use strict";
+// Bug 命令
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBugCommand = createBugCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const format_1 = require("../utils/format");
+const prompt_1 = require("../utils/prompt");
+const validators_1 = require("../utils/validators");
+const config_1 = require("../config/config");
+function createBugCommand(bugService, getUseJson) {
+    const bug = new commander_1.Command('bug')
+        .description('Bug 管理：查看、创建、更新、删除 Bug');
+    // bug my - 获取当前用户的 Bug
+    bug.command('my')
+        .description('获取当前账号的 Bug')
+        .option('-l, --limit <n>', '显示条数', (v) => parseInt(v, 10), 20)
+        .option('--page <n>', '页码', (v) => parseInt(v, 10), 1)
+        .action(async (options) => {
+        try {
+            const { bugs, total } = await bugService.getMyBugs({
+                limit: options.limit,
+                page: options.page,
+            });
+            if (bugs.length === 0) {
+                console.log(chalk_1.default.gray('没有找到你的 Bug'));
+            }
+            else if (getUseJson()) {
+                console.log((0, format_1.formatJson)(bugs));
+            }
+            else {
+                console.log((0, format_1.formatBugTable)(bugs));
+                const pageInfo = options.limit
+                    ? `第 ${options.page || 1} 页，共 ${total} 条`
+                    : `共 ${total} 条`;
+                console.log(chalk_1.default.gray(`\n${pageInfo}`));
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug list
+    bug.command('list')
+        .description('列出 Bug')
+        .option('-p, --product <id>', '产品 ID', (v) => parseInt(v, 10))
+        .option('-s, --status <status>', '状态过滤 (active|resolved|closed)')
+        .option('-l, --limit <n>', '显示条数', (v) => parseInt(v, 10), 20)
+        .option('--page <n>', '页码', (v) => parseInt(v, 10), 1)
+        .action(async (options) => {
+        if (!options.product) {
+            console.error(chalk_1.default.red('错误: 需要指定 --product <id>'));
+            process.exit(1);
+        }
+        if (options.status && !(0, validators_1.isValidBugStatus)(options.status)) {
+            console.error(chalk_1.default.red(`错误: 无效的状态 "${options.status}"，有效值: active, resolved, closed`));
+            process.exit(1);
+        }
+        try {
+            const { bugs, total } = await bugService.getList(options.product, {
+                status: options.status,
+                limit: options.limit,
+                page: options.page,
+            });
+            if (bugs.length === 0) {
+                console.log(chalk_1.default.gray('没有找到 Bug'));
+            }
+            else if (getUseJson()) {
+                console.log((0, format_1.formatJson)(bugs));
+            }
+            else {
+                console.log((0, format_1.formatBugTable)(bugs));
+                const pageInfo = options.limit
+                    ? `第 ${options.page || 1} 页，共 ${total} 条`
+                    : `共 ${total} 条`;
+                console.log(chalk_1.default.gray(`\n${pageInfo}`));
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug show
+    bug.command('show <id>')
+        .description('查看 Bug 详情')
+        .action(async (id) => {
+        const bugId = parseInt(id, 10);
+        if (!(0, validators_1.isValidId)(bugId)) {
+            console.error(chalk_1.default.red(`错误: 无效的 Bug ID "${id}"`));
+            process.exit(1);
+        }
+        try {
+            const bug = await bugService.getDetail(bugId);
+            if (!bug) {
+                console.error(chalk_1.default.red(`错误: Bug #${bugId} 未找到`));
+                process.exit(1);
+            }
+            if (getUseJson()) {
+                console.log((0, format_1.formatJson)(bug));
+            }
+            else {
+                console.log((0, format_1.formatBugDetail)(bug));
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug create
+    bug.command('create')
+        .description('创建 Bug（交互式）')
+        .requiredOption('-p, --product <id>', '产品 ID', (v) => parseInt(v, 10))
+        .option('-t, --title <title>', 'Bug 标题')
+        .option('-s, --severity <n>', '严重程度 (1-4)', (v) => parseInt(v, 10))
+        .option('-P, --priority <n>', '优先级 (1-4)', (v) => parseInt(v, 10))
+        .option('--type <type>', '类型', 'code')
+        .option('-a, --assigned-to <user>', '指派给（默认当前登录账号）')
+        .option('--opened-build <build>', '发现版本 (build ID，多个用逗号分隔)')
+        .option('--deadline <date>', '截止日期 (YYYY-MM-DD)')
+        .option('--steps <text>', '重现步骤')
+        .action(async (options) => {
+        try {
+            let title = options.title;
+            let severity = options.severity;
+            let priority = options.priority;
+            let assignedTo = options.assignedTo;
+            let openedBuild = options.openedBuild;
+            let deadline = options.deadline;
+            const rawCfg = (0, config_1.loadRawConfig)();
+            const today = new Date().toISOString().split('T')[0];
+            if (!title) {
+                title = await (0, prompt_1.prompt)('Bug 标题');
+                if (!title) {
+                    console.error(chalk_1.default.red('错误: Bug 标题不能为空'));
+                    process.exit(1);
+                }
+            }
+            if (!severity) {
+                const input = await (0, prompt_1.prompt)('严重程度 (1=致命, 2=严重, 3=一般, 4=建议)', '3');
+                severity = parseInt(input, 10);
+            }
+            if (!(0, validators_1.isValidSeverity)(severity)) {
+                console.error(chalk_1.default.red(`错误: 无效的严重程度 "${severity}"，有效值: 1-4`));
+                process.exit(1);
+            }
+            if (!priority) {
+                const input = await (0, prompt_1.prompt)('优先级 (1=紧急, 2=高, 3=中, 4=低)', '3');
+                priority = parseInt(input, 10);
+            }
+            if (!(0, validators_1.isValidPriority)(priority)) {
+                console.error(chalk_1.default.red(`错误: 无效的优先级 "${priority}"，有效值: 1-4`));
+                process.exit(1);
+            }
+            const defaultUser = rawCfg.server.username || '';
+            assignedTo = assignedTo || await (0, prompt_1.prompt)('指派给', defaultUser) || defaultUser;
+            openedBuild = openedBuild || await (0, prompt_1.prompt)('发现版本 (build ID，默认 trunk)', 'trunk') || 'trunk';
+            deadline = deadline || await (0, prompt_1.prompt)('截止日期 (YYYY-MM-DD)', today) || today;
+            const bug = await bugService.create(options.product, {
+                title,
+                severity,
+                priority,
+                type: options.type,
+                assignedTo,
+                openedBuild,
+                deadline,
+                steps: options.steps,
+            });
+            if (bug) {
+                console.log(chalk_1.default.green(`✓ Bug #${bug.id} 创建成功: ${bug.title}`));
+            }
+            else {
+                console.log(chalk_1.default.green('✓ Bug 创建成功'));
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug update
+    bug.command('update <id>')
+        .description('更新 Bug')
+        .option('-t, --title <title>', 'Bug 标题')
+        .option('-s, --status <status>', '状态 (active|resolved|closed)')
+        .option('--severity <n>', '严重程度 (1-4)', (v) => parseInt(v, 10))
+        .option('--priority <n>', '优先级 (1-4)', (v) => parseInt(v, 10))
+        .option('-a, --assigned-to <user>', '指派给')
+        .option('--deadline <date>', '截止日期 (YYYY-MM-DD)')
+        .option('--steps <text>', '重现步骤')
+        .action(async (id, options) => {
+        const bugId = parseInt(id, 10);
+        if (!(0, validators_1.isValidId)(bugId)) {
+            console.error(chalk_1.default.red(`错误: 无效的 Bug ID "${id}"`));
+            process.exit(1);
+        }
+        if (options.status && !(0, validators_1.isValidBugStatus)(options.status)) {
+            console.error(chalk_1.default.red(`错误: 无效的状态 "${options.status}"`));
+            process.exit(1);
+        }
+        const updates = {};
+        if (options.title)
+            updates.title = options.title;
+        if (options.status)
+            updates.status = options.status;
+        if (options.severity)
+            updates.severity = options.severity;
+        if (options.priority)
+            updates.priority = options.priority;
+        if (options.assignedTo)
+            updates.assignedTo = options.assignedTo;
+        if (options.deadline)
+            updates.deadline = options.deadline;
+        if (options.steps)
+            updates.steps = options.steps;
+        if (Object.keys(updates).length === 0) {
+            console.error(chalk_1.default.yellow('没有指定要更新的字段'));
+            process.exit(0);
+        }
+        try {
+            const bug = await bugService.update(bugId, updates);
+            if (bug) {
+                console.log(chalk_1.default.green(`✓ Bug #${bug.id} 更新成功`));
+            }
+            else {
+                console.log(chalk_1.default.green('✓ Bug 更新成功'));
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug resolve
+    bug.command('resolve <id>')
+        .description('解决 Bug（active → resolved）')
+        .option('-r, --resolution <type>', '解决方式: fixed|bydesign|duplicate|external|notrepro|postponed', 'fixed')
+        .option('--build <build>', '解决版本', 'trunk')
+        .option('-a, --assigned-to <user>', '指派给（默认回指给创建者）')
+        .option('-c, --comment <text>', '备注')
+        .option('-f, --force', '跳过确认')
+        .action(async (id, options) => {
+        const bugId = parseInt(id, 10);
+        if (!(0, validators_1.isValidId)(bugId)) {
+            console.error(chalk_1.default.red(`错误: 无效的 Bug ID "${id}"`));
+            process.exit(1);
+        }
+        const validResolutions = ['fixed', 'bydesign', 'duplicate', 'external', 'notrepro', 'postponed'];
+        if (!validResolutions.includes(options.resolution)) {
+            console.error(chalk_1.default.red(`错误: 无效的解决方式 "${options.resolution}"，有效值: ${validResolutions.join(', ')}`));
+            process.exit(1);
+        }
+        try {
+            if (!options.force) {
+                const confirmed = await (0, prompt_1.confirm)(`确定要解决 Bug #${bugId} 吗？`);
+                if (!confirmed) {
+                    console.log(chalk_1.default.gray('已取消'));
+                    return;
+                }
+            }
+            const bug = await bugService.resolve(bugId, {
+                resolution: options.resolution,
+                resolvedBuild: options.build,
+                assignedTo: options.assignedTo,
+                comment: options.comment,
+            });
+            if (bug) {
+                console.log(chalk_1.default.green(`✓ Bug #${bug.id} 已解决（${options.resolution}）`));
+            }
+            else {
+                console.error(chalk_1.default.red('解决 Bug 失败'));
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug close
+    bug.command('close <id>')
+        .description('关闭 Bug（resolved → closed）')
+        .option('-c, --comment <text>', '备注')
+        .option('-f, --force', '跳过确认')
+        .action(async (id, options) => {
+        const bugId = parseInt(id, 10);
+        if (!(0, validators_1.isValidId)(bugId)) {
+            console.error(chalk_1.default.red(`错误: 无效的 Bug ID "${id}"`));
+            process.exit(1);
+        }
+        try {
+            if (!options.force) {
+                const confirmed = await (0, prompt_1.confirm)(`确定要关闭 Bug #${bugId} 吗？`);
+                if (!confirmed) {
+                    console.log(chalk_1.default.gray('已取消'));
+                    return;
+                }
+            }
+            const bug = await bugService.close(bugId, options.comment);
+            if (bug) {
+                console.log(chalk_1.default.green(`✓ Bug #${bug.id} 已关闭`));
+            }
+            else {
+                console.error(chalk_1.default.red('关闭 Bug 失败'));
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug activate
+    bug.command('activate <id>')
+        .description('激活 Bug（resolved/closed → active）')
+        .option('-a, --assigned-to <user>', '指派给')
+        .option('-c, --comment <text>', '备注')
+        .option('-f, --force', '跳过确认')
+        .action(async (id, options) => {
+        const bugId = parseInt(id, 10);
+        if (!(0, validators_1.isValidId)(bugId)) {
+            console.error(chalk_1.default.red(`错误: 无效的 Bug ID "${id}"`));
+            process.exit(1);
+        }
+        try {
+            if (!options.force) {
+                const confirmed = await (0, prompt_1.confirm)(`确定要激活 Bug #${bugId} 吗？`);
+                if (!confirmed) {
+                    console.log(chalk_1.default.gray('已取消'));
+                    return;
+                }
+            }
+            const bug = await bugService.activate(bugId, {
+                assignedTo: options.assignedTo,
+                comment: options.comment,
+            });
+            if (bug) {
+                console.log(chalk_1.default.green(`✓ Bug #${bug.id} 已激活（状态: ${bug.status}）`));
+            }
+            else {
+                console.error(chalk_1.default.red('激活 Bug 失败'));
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    // bug delete
+    bug.command('delete <id>')
+        .description('删除 Bug')
+        .option('-f, --force', '跳过确认')
+        .action(async (id, options) => {
+        const bugId = parseInt(id, 10);
+        if (!(0, validators_1.isValidId)(bugId)) {
+            console.error(chalk_1.default.red(`错误: 无效的 Bug ID "${id}"`));
+            process.exit(1);
+        }
+        try {
+            if (!options.force) {
+                const confirmed = await (0, prompt_1.confirm)(`确定要删除 Bug #${bugId} 吗？`);
+                if (!confirmed) {
+                    console.log(chalk_1.default.gray('已取消'));
+                    return;
+                }
+            }
+            await bugService.delete(bugId);
+            console.log(chalk_1.default.green(`✓ Bug #${bugId} 已删除`));
+        }
+        catch (err) {
+            process.exit(1);
+        }
+    });
+    return bug;
+}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createConfigCommand(): Command;

package/dist/commands/config.js

@@ -0,0 +1,38 @@
+"use strict";
+// 配置管理命令
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfigCommand = createConfigCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../config/config");
+function createConfigCommand() {
+    const config = new commander_1.Command('config')
+        .description('配置管理');
+    config.command('show')
+        .description('显示当前配置')
+        .action(() => {
+        const cfg = (0, config_1.loadConfig)();
+        console.log(chalk_1.default.bold('\n当前配置:\n'));
+        console.log(`  服务器:   ${cfg.server.url || chalk_1.default.gray('(未设置)')}`);
+        if (cfg.server.username) {
+            console.log(`  用户名:   ${cfg.server.username}`);
+            console.log(`  密码:     ${chalk_1.default.gray('******')}`);
+        }
+        console.log(`  认证模式: ${cfg.authMode === 'apikey' ? 'API Key' : 'Session (用户名/密码)'}`);
+        console.log('');
+    });
+    config.command('set <key> <value>')
+        .description('设置配置项（保存到用户目录）')
+        .action(async (key, value) => {
+        const validKeys = ['server.url', 'server.username', 'server.password', 'server.code', 'server.token'];
+        if (!validKeys.includes(key)) {
+            console.error(chalk_1.default.red(`错误: 无效的配置项 "${key}"，有效值: ${validKeys.join(', ')}`));
+            process.exit(1);
+        }
+        (0, config_1.saveUserConfig)(key, value);
+    });
+    return config;
+}

package/dist/commands/login.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createLoginCommand(): Command;
+export declare function createLogoutCommand(): Command;