@cvtoolman/pingcode-cli 0.2.0

package/dist/cli/config-store.js

@@ -0,0 +1,55 @@
+/**
+ * 全局配置管理器
+ *
+ * 配置文件存储在 ~/.pingcode/config.json
+ * 用于存储 API 地址、客户端凭证等信息，让用户无需手动编辑 .env
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CONFIG_DIR = path.join(os.homedir(), '.pingcode');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export function loadGlobalConfig() {
+    try {
+        if (!fs.existsSync(CONFIG_FILE))
+            return {};
+        return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveGlobalConfig(config) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+export function getGlobalConfigPath() {
+    return CONFIG_FILE;
+}
+/**
+ * 将全局配置注入到 process.env 中（仅填充未设置的变量）
+ * 优先级：环境变量 / .env > 全局配置
+ */
+export function applyGlobalConfigToEnv() {
+    const config = loadGlobalConfig();
+    // 设置全局 token 文件路径（如果未指定）
+    if (!process.env.PINGCODE_TOKEN_FILE) {
+        process.env.PINGCODE_TOKEN_FILE = path.join(CONFIG_DIR, 'token.json');
+    }
+    const mapping = [
+        ['apiRoot', 'PINGCODE_API_ROOT'],
+        ['authMode', 'PINGCODE_AUTH_MODE'],
+        ['clientId', 'PINGCODE_CLIENT_ID'],
+        ['clientSecret', 'PINGCODE_CLIENT_SECRET'],
+        ['userClientId', 'PINGCODE_USER_CLIENT_ID'],
+        ['userClientSecret', 'PINGCODE_USER_CLIENT_SECRET'],
+        ['orgId', 'PINGCODE_ORG_ID'],
+        ['productId', 'PINGCODE_PRODUCT_ID'],
+    ];
+    for (const [key, envKey] of mapping) {
+        if (config[key] && !process.env[envKey]) {
+            process.env[envKey] = config[key];
+        }
+    }
+}
+//# sourceMappingURL=config-store.js.map

package/dist/cli/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/cli/config-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAazB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAElC,yBAAyB;IACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAmC;QAC9C,CAAC,SAAS,EAAE,mBAAmB,CAAC;QAChC,CAAC,UAAU,EAAE,oBAAoB,CAAC;QAClC,CAAC,UAAU,EAAE,oBAAoB,CAAC;QAClC,CAAC,cAAc,EAAE,wBAAwB,CAAC;QAC1C,CAAC,cAAc,EAAE,yBAAyB,CAAC;QAC3C,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;QACnD,CAAC,OAAO,EAAE,iBAAiB,CAAC;QAC5B,CAAC,WAAW,EAAE,qBAAqB,CAAC;KACrC,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAW,CAAC;QAC9C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * PingCode CLI 入口
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/cli/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * PingCode CLI 入口
+ */
+import { Command } from 'commander';
+import { applyGlobalConfigToEnv } from './config-store.js';
+import { ensureAuthorized, interactiveSetup } from './setup.js';
+import { authCommand } from './commands/auth.js';
+import { userCommand } from './commands/user.js';
+import { workItemCommand } from './commands/work-item.js';
+import { sprintCommand } from './commands/sprint.js';
+import { wikiCommand } from './commands/wiki.js';
+import { projectCommand } from './commands/project.js';
+// 将全局配置（~/.pingcode/config.json）注入环境变量
+applyGlobalConfigToEnv();
+const program = new Command('pingcode-cli')
+    .description('PingCode CLI - 命令行操作 PingCode')
+    .version('0.1.0');
+program.addCommand(authCommand);
+program.addCommand(userCommand);
+program.addCommand(workItemCommand);
+program.addCommand(sprintCommand);
+program.addCommand(wikiCommand);
+program.addCommand(projectCommand);
+// auth 相关子命令不需要预检查授权（避免死循环）
+const AUTH_COMMANDS = ['auth', 'help', '--help', '-h', '--version', '-V'];
+async function main() {
+    const args = process.argv.slice(2);
+    const firstArg = args[0];
+    // 无参数时：进入交互式引导流程，不打印帮助
+    if (!firstArg) {
+        try {
+            await interactiveSetup();
+        }
+        catch (e) {
+            console.error(`配置失败: ${e.message}`);
+            process.exit(1);
+        }
+        return;
+    }
+    // 非 auth/help 命令时，先检查授权状态
+    if (!AUTH_COMMANDS.includes(firstArg)) {
+        try {
+            await ensureAuthorized();
+        }
+        catch (e) {
+            console.error(`授权检查失败: ${e.message}`);
+            process.exit(1);
+        }
+    }
+    program.parse();
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,uCAAuC;AACvC,sBAAsB,EAAE,CAAC;AAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC;KACxC,WAAW,CAAC,+BAA+B,CAAC;KAC5C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AAEnC,4BAA4B;AAC5B,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AAE1E,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzB,uBAAuB;IACvB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,gBAAgB,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,gBAAgB,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/cli/output.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI 输出格式化工具
+ */
+export declare function printJson(data: any): void;
+export declare function printTable(items: Record<string, any>[], columns?: string[]): void;
+export declare function printKeyValue(data: Record<string, any>): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAEzC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAajF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAI7D"}

package/dist/cli/output.js

@@ -0,0 +1,29 @@
+/**
+ * CLI 输出格式化工具
+ */
+export function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+export function printTable(items, columns) {
+    if (!items.length) {
+        console.log('无数据');
+        return;
+    }
+    const cols = columns || Object.keys(items[0]);
+    const widths = cols.map(c => Math.max(c.length, ...items.map(i => String(i[c] ?? '').length)));
+    const header = cols.map((c, i) => c.padEnd(widths[i])).join('  ');
+    const sep = cols.map((_, i) => '-'.repeat(widths[i])).join('  ');
+    console.log(header);
+    console.log(sep);
+    for (const item of items) {
+        const row = cols.map((c, i) => String(item[c] ?? '').padEnd(widths[i])).join('  ');
+        console.log(row);
+    }
+}
+export function printKeyValue(data) {
+    for (const [k, v] of Object.entries(data)) {
+        if (v !== null && v !== undefined)
+            console.log(`${k}: ${typeof v === 'object' ? JSON.stringify(v) : v}`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA4B,EAAE,OAAkB;IACzE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE/F,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAyB;IACrD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 首次使用引导 & 授权检查
+ *
+ * 在 CLI 启动时检查是否已完成配置和授权，
+ * 未完成则交互式引导用户完成。
+ */
+declare const GLOBAL_TOKEN_FILE: string;
+export declare function prompt(question: string): Promise<string>;
+/**
+ * CLI 启动时的授权检查入口
+ *
+ * 如果已有有效令牌，直接跳过。
+ * 否则引导用户选择认证模式并完成授权。
+ */
+export declare function ensureAuthorized(): Promise<void>;
+/**
+ * 交互式引导入口（用户直接输入 pingcode-cli 不带参数时调用）
+ *
+ * 与 ensureAuthorized 不同：
+ * - 始终显示欢迎信息和当前配置状态
+ * - 已配置的项跳过，未配置的项引导配置
+ * - 已有有效令牌时提示当前状态，询问是否重新配置
+ */
+export declare function interactiveSetup(): Promise<void>;
+export { GLOBAL_TOKEN_FILE };
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,QAAA,MAAM,iBAAiB,QAAqD,CAAC;AAE7E,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxD;AA6HD;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBtD;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8CtD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/cli/setup.js

@@ -0,0 +1,216 @@
+/**
+ * 首次使用引导 & 授权检查
+ *
+ * 在 CLI 启动时检查是否已完成配置和授权，
+ * 未完成则交互式引导用户完成。
+ */
+import readline from 'node:readline';
+import path from 'node:path';
+import os from 'node:os';
+import { PingCodeAuth, TokenStore } from '../client/index.js';
+import { loadGlobalConfig, saveGlobalConfig, getGlobalConfigPath } from './config-store.js';
+const GLOBAL_TOKEN_FILE = path.join(os.homedir(), '.pingcode', 'token.json');
+export function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * 选择菜单：让用户输入数字选择
+ */
+async function promptChoice(question, choices) {
+    console.log(question);
+    choices.forEach((c, i) => console.log(`  ${i + 1}. ${c}`));
+    const answer = await prompt('\n请输入选项编号: ');
+    const num = parseInt(answer, 10);
+    if (isNaN(num) || num < 1 || num > choices.length) {
+        console.log('无效选项，请重新选择\n');
+        return promptChoice(question, choices);
+    }
+    return num;
+}
+/**
+ * 检查是否有有效的令牌
+ * 会同时验证令牌的 auth_mode 与当前配置的 authMode 是否匹配
+ */
+function hasValidToken() {
+    const store = new TokenStore(GLOBAL_TOKEN_FILE);
+    const data = store.load();
+    if (!data || !data.access_token)
+        return false;
+    // 检查是否过期（提前 1 天判定为过期）
+    if (data.expires_at && Date.now() / 1000 >= data.expires_at - 86400)
+        return false;
+    // 检查 auth_mode 是否与当前配置匹配（与 PingCodeAuth._loadTokens 逻辑一致）
+    const config = loadGlobalConfig();
+    const currentMode = config.authMode || process.env.PINGCODE_AUTH_MODE || 'client';
+    if (data.auth_mode && data.auth_mode !== currentMode)
+        return false;
+    return true;
+}
+/**
+ * 检查是否有凭证配置（全局配置或环境变量）
+ */
+function hasCredentials() {
+    const config = loadGlobalConfig();
+    return {
+        hasClient: !!(config.clientId || process.env.PINGCODE_CLIENT_ID),
+        hasUser: !!(config.userClientId || process.env.PINGCODE_USER_CLIENT_ID),
+    };
+}
+/**
+ * 引导用户配置 API 地址（如果尚未配置）
+ */
+async function ensureApiRoot() {
+    const config = loadGlobalConfig();
+    if (config.apiRoot || process.env.PINGCODE_API_ROOT)
+        return;
+    console.log('');
+    const apiRoot = await prompt('请输入 PingCode API 地址 (直接回车使用默认 https://open.pingcode.com): ');
+    if (apiRoot) {
+        config.apiRoot = apiRoot;
+        saveGlobalConfig(config);
+        process.env.PINGCODE_API_ROOT = apiRoot;
+    }
+}
+/**
+ * 客户端凭证模式引导
+ */
+async function setupClientCredentials() {
+    const config = loadGlobalConfig();
+    if (!config.clientId && !process.env.PINGCODE_CLIENT_ID) {
+        console.log('\n请输入客户端凭证信息：\n');
+        const clientId = await prompt('Client ID: ');
+        const clientSecret = await prompt('Client Secret: ');
+        if (!clientId || !clientSecret) {
+            console.error('Client ID 和 Client Secret 不能为空');
+            process.exit(1);
+        }
+        config.authMode = 'client';
+        config.clientId = clientId;
+        config.clientSecret = clientSecret;
+        saveGlobalConfig(config);
+        process.env.PINGCODE_CLIENT_ID = clientId;
+        process.env.PINGCODE_CLIENT_SECRET = clientSecret;
+        console.log(`\n配置已保存到 ${getGlobalConfigPath()}`);
+    }
+    console.log('\n正在获取令牌...');
+    const auth = new PingCodeAuth({ authMode: 'client', tokenFile: GLOBAL_TOKEN_FILE });
+    await auth.getClientToken();
+    console.log('客户端令牌获取成功 ✓\n');
+}
+/**
+ * 授权码模式引导
+ */
+async function setupAuthorizationCode() {
+    const config = loadGlobalConfig();
+    if (!config.userClientId && !process.env.PINGCODE_USER_CLIENT_ID) {
+        console.log('\n请输入授权码模式的凭证信息：\n');
+        const userClientId = await prompt('User Client ID: ');
+        const userClientSecret = await prompt('User Client Secret: ');
+        if (!userClientId || !userClientSecret) {
+            console.error('Client ID 和 Client Secret 不能为空');
+            process.exit(1);
+        }
+        config.authMode = 'user';
+        config.userClientId = userClientId;
+        config.userClientSecret = userClientSecret;
+        saveGlobalConfig(config);
+        process.env.PINGCODE_USER_CLIENT_ID = userClientId;
+        process.env.PINGCODE_USER_CLIENT_SECRET = userClientSecret;
+        console.log(`\n配置已保存到 ${getGlobalConfigPath()}`);
+    }
+    const auth = new PingCodeAuth({ authMode: 'user', tokenFile: GLOBAL_TOKEN_FILE });
+    const url = auth.getAuthorizeUrl();
+    console.log(`\n请在浏览器中打开以下链接完成授权：\n  ${url}\n`);
+    const code = await prompt('请输入授权码: ');
+    if (!code) {
+        console.error('授权码不能为空');
+        process.exit(1);
+    }
+    await auth.getUserToken(code);
+    console.log('用户令牌获取成功 ✓\n');
+}
+/**
+ * CLI 启动时的授权检查入口
+ *
+ * 如果已有有效令牌，直接跳过。
+ * 否则引导用户选择认证模式并完成授权。
+ */
+export async function ensureAuthorized() {
+    if (hasValidToken())
+        return;
+    console.log('╔══════════════════════════════════════╗');
+    console.log('║     欢迎使用 PingCode CLI 工具       ║');
+    console.log('╚══════════════════════════════════════╝');
+    console.log('\n检测到尚未授权，需要先完成认证配置。\n');
+    // 先确保 API 地址已配置
+    await ensureApiRoot();
+    // 让用户选择认证模式
+    const choice = await promptChoice('请选择认证方式：', [
+        '客户端凭证模式 — 使用 Client ID / Secret 直接获取令牌（推荐）',
+        '授权码模式 — 通过浏览器授权获取用户级令牌',
+    ]);
+    if (choice === 1) {
+        await setupClientCredentials();
+    }
+    else {
+        await setupAuthorizationCode();
+    }
+}
+/**
+ * 交互式引导入口（用户直接输入 pingcode-cli 不带参数时调用）
+ *
+ * 与 ensureAuthorized 不同：
+ * - 始终显示欢迎信息和当前配置状态
+ * - 已配置的项跳过，未配置的项引导配置
+ * - 已有有效令牌时提示当前状态，询问是否重新配置
+ */
+export async function interactiveSetup() {
+    console.log('╔══════════════════════════════════════╗');
+    console.log('║     欢迎使用 PingCode CLI 工具       ║');
+    console.log('╚══════════════════════════════════════╝');
+    const config = loadGlobalConfig();
+    const tokenValid = hasValidToken();
+    const creds = hasCredentials();
+    // 显示当前配置状态
+    console.log('\n当前配置状态：');
+    const apiRoot = config.apiRoot || process.env.PINGCODE_API_ROOT;
+    console.log(`  API 地址:   ${apiRoot ? `${apiRoot} ✓` : '未配置'}`);
+    console.log(`  客户端凭证: ${creds.hasClient ? '已配置 ✓' : '未配置'}`);
+    console.log(`  用户凭证:   ${creds.hasUser ? '已配置 ✓' : '未配置'}`);
+    console.log(`  认证令牌:   ${tokenValid ? '有效 ✓' : '无效或未获取'}`);
+    // 如果已经完全配置好，询问是否重新配置
+    if (tokenValid) {
+        console.log('\n当前认证状态正常，可以直接使用 CLI 命令。');
+        console.log('运行 pingcode-cli --help 查看可用命令。\n');
+        const answer = await prompt('是否要重新配置？(y/N): ');
+        if (answer.toLowerCase() !== 'y') {
+            return;
+        }
+        console.log('');
+    }
+    else {
+        console.log('');
+    }
+    // 引导 API 地址配置（已配置则跳过）
+    await ensureApiRoot();
+    // 选择认证方式
+    const choice = await promptChoice('请选择认证方式：', [
+        '客户端凭证模式 — 使用 Client ID / Secret 直接获取令牌（推荐）',
+        '授权码模式 — 通过浏览器授权获取用户级令牌',
+    ]);
+    if (choice === 1) {
+        await setupClientCredentials();
+    }
+    else {
+        await setupAuthorizationCode();
+    }
+    console.log('配置完成！运行 pingcode-cli --help 查看可用命令。');
+}
+export { GLOBAL_TOKEN_FILE };
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/client/api/comments.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PingCode 评论相关 API
+ */
+import type { PingCodeClient } from '../client.js';
+import type { CreateCommentOptions, PaginatedResponse } from '../types.js';
+export declare class CommentsAPI {
+    private client;
+    constructor(client: PingCodeClient);
+    listComments(principalType: string, principalId?: string, reviewId?: string, pageIndex?: number, pageSize?: number): Promise<PaginatedResponse>;
+    createComment(options: CreateCommentOptions): Promise<any>;
+}
+//# sourceMappingURL=comments.d.ts.map

package/dist/client/api/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/client/api/comments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE3E,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAEpC,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWtI,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC;CAWjE"}

package/dist/client/api/comments.js

@@ -0,0 +1,37 @@
+/**
+ * PingCode 评论相关 API
+ */
+export class CommentsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async listComments(principalType, principalId, reviewId, pageIndex = 0, pageSize = 30) {
+        const params = {
+            principal_type: principalType,
+            page_index: pageIndex,
+            page_size: Math.min(pageSize, 100),
+        };
+        if (principalId)
+            params.principal_id = principalId;
+        if (reviewId)
+            params.review_id = reviewId;
+        return this.client.get('/v1/comments', params);
+    }
+    async createComment(options) {
+        const data = {
+            principal_type: options.principalType,
+            content: options.content,
+        };
+        if (options.principalId)
+            data.principal_id = options.principalId;
+        if (options.reviewId)
+            data.review_id = options.reviewId;
+        if (options.createdAt)
+            data.created_at = options.createdAt;
+        if (options.createdBy)
+            data.created_by = options.createdBy;
+        return this.client.post('/v1/comments', data);
+    }
+}
+//# sourceMappingURL=comments.js.map

package/dist/client/api/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/client/api/comments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAE9C,KAAK,CAAC,YAAY,CAAC,aAAqB,EAAE,WAAoB,EAAE,QAAiB,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE;QAC7G,MAAM,MAAM,GAAwB;YAClC,cAAc,EAAE,aAAa;YAC7B,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC;SACnC,CAAC;QACF,IAAI,WAAW;YAAE,MAAM,CAAC,YAAY,GAAG,WAAW,CAAC;QACnD,IAAI,QAAQ;YAAE,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAA6B;QAC/C,MAAM,IAAI,GAAwB;YAChC,cAAc,EAAE,OAAO,CAAC,aAAa;YACrC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACF,IAAI,OAAO,CAAC,WAAW;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QACjE,IAAI,OAAO,CAAC,QAAQ;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QACxD,IAAI,OAAO,CAAC,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QAC3D,IAAI,OAAO,CAAC,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/client/api/deliverables.d.ts

@@ -0,0 +1,14 @@
+/**
+ * PingCode 交付目标（Deliverables）相关 API
+ */
+import type { PingCodeClient } from '../client.js';
+import type { CreateDeliverableOptions, UpdateDeliverableOptions, PaginatedResponse } from '../types.js';
+export declare class DeliverablesAPI {
+    private client;
+    constructor(client: PingCodeClient);
+    createDeliverable(options: CreateDeliverableOptions): Promise<any>;
+    updateDeliverable(deliverableId: string, options: UpdateDeliverableOptions): Promise<any>;
+    deleteDeliverable(deliverableId: string): Promise<any>;
+    listDeliverables(workItemId: string, pageIndex?: number, pageSize?: number): Promise<PaginatedResponse>;
+}
+//# sourceMappingURL=deliverables.d.ts.map

package/dist/client/api/deliverables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliverables.d.ts","sourceRoot":"","sources":["../../../src/client/api/deliverables.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEzG,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAEpC,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC;IASlE,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC;IASzF,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAItD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAKrG"}

package/dist/client/api/deliverables.js

@@ -0,0 +1,38 @@
+/**
+ * PingCode 交付目标（Deliverables）相关 API
+ */
+export class DeliverablesAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async createDeliverable(options) {
+        return this.client.post('/v1/project/deliverables', {
+            work_item_id: options.workItemId,
+            name: options.name,
+            content_type: options.contentType,
+            content: options.content,
+        });
+    }
+    async updateDeliverable(deliverableId, options) {
+        const data = {};
+        if (options.workItemId)
+            data.work_item_id = options.workItemId;
+        if (options.name)
+            data.name = options.name;
+        if (options.contentType)
+            data.content_type = options.contentType;
+        if (options.content)
+            data.content = options.content;
+        return this.client.patch(`/v1/project/deliverables/${deliverableId}`, data);
+    }
+    async deleteDeliverable(deliverableId) {
+        return this.client.delete(`/v1/project/deliverables/${deliverableId}`);
+    }
+    async listDeliverables(workItemId, pageIndex = 0, pageSize = 30) {
+        return this.client.get(`/v1/project/work_items/${workItemId}/deliverables`, {
+            page_index: pageIndex, page_size: Math.min(pageSize, 100),
+        });
+    }
+}
+//# sourceMappingURL=deliverables.js.map

package/dist/client/api/deliverables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliverables.js","sourceRoot":"","sources":["../../../src/client/api/deliverables.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAE9C,KAAK,CAAC,iBAAiB,CAAC,OAAiC;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YAClD,YAAY,EAAE,OAAO,CAAC,UAAU;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,WAAW;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,aAAqB,EAAE,OAAiC;QAC9E,MAAM,IAAI,GAAwB,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,UAAU;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;QAC/D,IAAI,OAAO,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3C,IAAI,OAAO,CAAC,WAAW;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QACjE,IAAI,OAAO,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,aAAqB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,4BAA4B,aAAa,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE;QACrE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0BAA0B,UAAU,eAAe,EAAE;YAC1E,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC;SAC1D,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/client/api/myself.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PingCode 个人信息相关 API
+ */
+import type { PingCodeClient } from '../client.js';
+export declare class MyselfAPI {
+    private client;
+    constructor(client: PingCodeClient);
+    getMyself(): Promise<any>;
+}
+//# sourceMappingURL=myself.d.ts.map

package/dist/client/api/myself.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"myself.d.ts","sourceRoot":"","sources":["../../../src/client/api/myself.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAEpC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;CAGhC"}

package/dist/client/api/myself.js

@@ -0,0 +1,13 @@
+/**
+ * PingCode 个人信息相关 API
+ */
+export class MyselfAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getMyself() {
+        return this.client.get('/v1/myself');
+    }
+}
+//# sourceMappingURL=myself.js.map

package/dist/client/api/myself.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"myself.js","sourceRoot":"","sources":["../../../src/client/api/myself.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAE9C,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/client/api/sprints.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PingCode 迭代（Sprint）相关 API
+ */
+import type { PingCodeClient } from '../client.js';
+import type { ListSprintsOptions, CreateSprintOptions, UpdateSprintOptions, PaginatedResponse } from '../types.js';
+export declare class SprintsAPI {
+    private client;
+    constructor(client: PingCodeClient);
+    listSprints(options: ListSprintsOptions): Promise<PaginatedResponse>;
+    getSprint(projectId: string, sprintId: string): Promise<any>;
+    createSprint(options: CreateSprintOptions): Promise<any>;
+    updateSprint(projectId: string, sprintId: string, options: UpdateSprintOptions): Promise<any>;
+    deleteSprint(projectId: string, sprintId: string): Promise<any>;
+}
+//# sourceMappingURL=sprints.d.ts.map

package/dist/client/api/sprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprints.d.ts","sourceRoot":"","sources":["../../../src/client/api/sprints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnH,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAEpC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAYpE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI5D,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC;IAaxD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC;IAY7F,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAGtE"}