@meet-im/lxcli 0.0.4 → 0.0.6

package/dist/commands/generate-skills.js

@@ -4,7 +4,7 @@ import * as path from 'path';
 import { outputCliError } from '../core/error.js';
 import { logger } from '../core/logger.js';
 import { PARAM_DEFS, METHOD_DESCRIPTIONS } from './services/kb/descriptions.js';
-import { METHOD_SKILL_METADATA } from './services/kb/skill-metadata.js';
+import { METHOD_SHORTCUT_PARAMS, METHOD_SKILL_METADATA } from './services/kb/skill-metadata.js';
 const API_ROOT = path.resolve('api');
 const DEFAULT_SKILLS_DIR = path.resolve('api/skills');
 const DEFAULT_OUTPUT = 'api/docs/skills.md';
@@ -155,41 +155,51 @@ async function readPackageVersion() {
     const packageJson = JSON.parse(await fs.readFile(PACKAGE_JSON_PATH, 'utf-8'));
     return packageJson.version || '1.0.0';
 }
+function buildParamsExample(params) {
+    const paramsExample = {};
+    for (const p of params) {
+        if (p.type === 'array<integer>') {
+            paramsExample[p.name] = [1, 2];
+        }
+        else if (p.type === 'array<string>') {
+            paramsExample[p.name] = ['id1', 'id2'];
+        }
+        else if (p.type === 'integer') {
+            paramsExample[p.name] = 123;
+        }
+        else if (p.type === 'object') {
+            paramsExample[p.name] = {};
+        }
+        else {
+            paramsExample[p.name] = 'value';
+        }
+    }
+    return paramsExample;
+}
 function renderSkillMd(method, version) {
     const description = METHOD_DESCRIPTIONS[method];
     const params = PARAM_DEFS[method] || [];
     const metadata = METHOD_SKILL_METADATA[method];
     const skillName = `lxcli-kb-${method}`;
     const hasParams = params.length > 0;
-    // 快捷参数列表
-    const shortcuts = params.filter(p => p.required).map(p => `--${p.name} <${p.type === 'integer' ? 'ID' : 'VALUE'}>`);
+    // 快捷参数列表（显式配置，不从 required 自动推断）
+    const shortcutParams = METHOD_SHORTCUT_PARAMS[method] || [];
+    const shortcuts = shortcutParams.map((name) => {
+        const param = params.find((p) => p.name === name);
+        if (!param) {
+            return `--${name} <VALUE>`;
+        }
+        return `--${param.name} <${param.type === 'integer' ? 'ID' : 'VALUE'}>`;
+    });
     const shortcutUsage = shortcuts.length > 0 ? `lxcli kb ${method} ${shortcuts.join(' ')}` : '';
+    const paramsUsage = hasParams ? `lxcli kb ${method} --params '${JSON.stringify(buildParamsExample(params))}'` : '';
     // Usage 部分
     const usageLines = ['## Usage', '', '```bash'];
     if (hasParams) {
         if (shortcutUsage) {
             usageLines.push(shortcutUsage);
         }
-        // 生成 --params 示例
-        const paramsExample = {};
-        for (const p of params) {
-            if (p.type === 'array<integer>') {
-                paramsExample[p.name] = [1, 2];
-            }
-            else if (p.type === 'array<string>') {
-                paramsExample[p.name] = ['id1', 'id2'];
-            }
-            else if (p.type === 'integer') {
-                paramsExample[p.name] = 123;
-            }
-            else if (p.type === 'object') {
-                paramsExample[p.name] = {};
-            }
-            else {
-                paramsExample[p.name] = 'value';
-            }
-        }
-        usageLines.push(`lxcli kb ${method} --params '${JSON.stringify(paramsExample)}'`);
+        usageLines.push(paramsUsage);
     }
     else {
         usageLines.push(`lxcli kb ${method}`);
@@ -224,7 +234,7 @@ metadata:
     if (hasParams) {
         lines.push(renderParamsTable(params));
     }
-    lines.push('## Examples', '', '```bash', shortcutUsage || `lxcli kb ${method}`, '```', '');
+    lines.push('## Examples', '', '```bash', shortcutUsage || paramsUsage || `lxcli kb ${method}`, '```', '');
     if (metadata?.notes?.length) {
         lines.push('## Notes', '', ...metadata.notes.map((note) => `- ${note}`), '');
     }

package/dist/commands/services/kb/descriptions.js

@@ -17,6 +17,7 @@ export const METHOD_DESCRIPTIONS = {
     createSubtask: '创建子任务',
     updateTask: '修改需求',
     updateSubtask: '更新子任务',
+    moveTaskPosition: '移动需求状态列',
     getAllComments: '获取评论列表',
     createComment: '对需求增加评论',
     createProjectFile: '上传附件到项目',

package/dist/commands/services/kb/params.js

@@ -90,4 +90,11 @@ export const PARAM_DEFS = {
     downloadTaskFile: [
         { name: 'file_id', type: 'integer', required: true, description: '需求附件 ID' },
     ],
+    moveTaskPosition: [
+        { name: 'project_id', type: 'integer', required: true, description: '项目 ID。必须是任务所属项目。' },
+        { name: 'task_id', type: 'integer', required: true, description: '需求/bug ID' },
+        { name: 'column_id', type: 'integer', required: false, description: '目标状态列 ID。未传时保留当前状态列' },
+        { name: 'position', type: 'integer', required: false, description: '目标列内排序位置，必须 >= 1。未传时保留当前排序值' },
+        { name: 'swimlane_id', type: 'integer', required: false, description: '目标泳道 ID。未传或传 0 保留当前泳道' },
+    ],
 };

package/dist/commands/services/kb/rpc.js

@@ -2,13 +2,14 @@ import { outputCliError } from '../../../core/error.js';
 import { request } from '../../../core/http.js';
 import { getNextRequestId } from './utils.js';
 export async function jsonRpcCall(gateway, method, params, pat) {
+    const requestId = getNextRequestId();
     const requestBody = {
         jsonrpc: '2.0',
         method,
-        id: getNextRequestId(),
+        id: requestId,
         params,
     };
-    const response = await request({
+    const result = await request({
         gateway,
         path: '/jsonrpc.php',
         method: 'POST',
@@ -16,11 +17,26 @@ export async function jsonRpcCall(gateway, method, params, pat) {
         headers: {
             Authorization: `meet ${pat}`,
         },
+        throwOnError: false,
     });
+    // HTTP 层错误
+    if (!result.ok) {
+        outputCliError('NETWORK_ERROR', result.error.message, {
+            code: result.error.code,
+            details: result.error.details,
+            requestId,
+        });
+        return undefined;
+    }
+    const response = result.data;
+    // JSON-RPC 层错误
     if (response.error) {
         outputCliError('NETWORK_ERROR', response.error.message, {
             code: response.error.code,
             data: response.error.data,
+            requestId,
+            // 服务端返回的 id（可能为 null）
+            responseId: response.id,
         });
         return undefined;
     }
@@ -28,6 +44,7 @@ export async function jsonRpcCall(gateway, method, params, pat) {
         outputCliError('NETWORK_ERROR', 'No result returned from Kanboard API', {
             method,
             params,
+            requestId,
         });
         return undefined;
     }

package/dist/commands/services/kb/skill-metadata.d.ts

@@ -2,4 +2,5 @@ import type { Method } from './descriptions.js';
 export interface MethodSkillMetadata {
     notes?: string[];
 }
+export declare const METHOD_SHORTCUT_PARAMS: Partial<Record<Method, string[]>>;
 export declare const METHOD_SKILL_METADATA: Partial<Record<Method, MethodSkillMetadata>>;

package/dist/commands/services/kb/skill-metadata.js

@@ -1,3 +1,16 @@
+export const METHOD_SHORTCUT_PARAMS = {
+    getTask: ['task_id'],
+    createTask: ['title', 'project_id', 'owner_id', 'category_id'],
+    searchTasks: ['project_id', 'query'],
+    getAllActiveIterations: ['project_id'],
+    getAllCategories: ['project_id'],
+    getAllComments: ['task_id'],
+    createComment: ['task_id', 'user_id', 'content'],
+    createProjectFile: ['file', 'project_id'],
+    downloadProjectFile: ['project_id', 'file_id'],
+    createTaskFile: ['file', 'task_id', 'project_id'],
+    downloadTaskFile: ['file_id'],
+};
 export const METHOD_SKILL_METADATA = {
     downloadProjectFile: {
         notes: [

package/dist/commands/services/kb/types.d.ts

@@ -33,6 +33,7 @@ export interface KanboardTask {
     date_due?: string;
     date_started?: string;
     priority: string;
+    priority_name?: string;
     score: string;
     reference: string;
     url: string;
@@ -43,6 +44,17 @@ export interface KanboardTask {
     };
     tags?: string[];
 }
+export interface KanboardSubtask {
+    id: string;
+    title: string;
+    status: string;
+    status_name?: string;
+    time_estimated: string;
+    time_spent: string;
+    task_id: string;
+    user_id: string;
+    position: string;
+}
 export interface GetTaskParams {
     task_id: number;
 }

package/dist/commands/upgrade.d.ts

@@ -1,2 +1,6 @@
 import { Command } from 'commander';
+import { spawn } from 'child_process';
+export declare const upgradeDeps: {
+    spawn: typeof spawn;
+};
 export declare function registerUpgradeCommand(program: Command): void;

package/dist/commands/upgrade.js

@@ -1,8 +1,12 @@
 // src/commands/upgrade.ts
+import { spawn } from 'child_process';
 import { outputCliError } from '../core/error.js';
 import { outputJson } from '../utils/index.js';
 const PACKAGE_NAME = '@meet-im/lxcli';
 const NPM_REGISTRY = 'https://registry.npmjs.org';
+export const upgradeDeps = {
+    spawn,
+};
 async function getLatestVersion() {
     const res = await fetch(`${NPM_REGISTRY}/${PACKAGE_NAME}/latest`);
     if (!res.ok) {
@@ -11,22 +15,52 @@ async function getLatestVersion() {
     const data = await res.json();
     return data.version;
 }
+async function runNpmUpgrade() {
+    const command = process.platform === 'win32' ? 'cmd.exe' : 'npm';
+    const args = process.platform === 'win32'
+        ? ['/c', 'npm', 'install', '-g', `${PACKAGE_NAME}@latest`]
+        : ['install', '-g', `${PACKAGE_NAME}@latest`];
+    await new Promise((resolve, reject) => {
+        const child = upgradeDeps.spawn(command, args, {
+            stdio: 'inherit',
+        });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`npm install exited with code ${code ?? 'unknown'}`));
+        });
+    });
+}
 export function registerUpgradeCommand(program) {
     program
         .command('upgrade')
         .description('Check for updates and show upgrade instructions')
-        .action(async () => {
+        .option('--check', 'Only check for updates without installing')
+        .action(async (options) => {
         try {
             const currentVersion = program.version() || '1.0.0';
             const latestVersion = await getLatestVersion();
             const isLatest = currentVersion === latestVersion;
+            if (options.check || isLatest) {
+                outputJson({
+                    currentVersion,
+                    latestVersion,
+                    isLatest,
+                    message: isLatest
+                        ? 'Already on the latest version'
+                        : `Run "npm install -g ${PACKAGE_NAME}@latest" to upgrade`,
+                });
+                return;
+            }
+            await runNpmUpgrade();
             outputJson({
-                currentVersion,
+                previousVersion: currentVersion,
                 latestVersion,
-                isLatest,
-                message: isLatest
-                    ? 'Already on the latest version'
-                    : `Run "npm install -g ${PACKAGE_NAME}@latest" to upgrade`,
+                upgraded: true,
+                message: `Upgraded ${PACKAGE_NAME} to ${latestVersion}`,
             });
         }
         catch (error) {

package/dist/core/http.d.ts

@@ -1,4 +1,19 @@
-export interface RequestOptions {
+export interface RequestSuccessResult<T> {
+    ok: true;
+    status: number;
+    data: T;
+}
+export interface RequestErrorResult {
+    ok: false;
+    status: number;
+    error: {
+        code: number;
+        message: string;
+        details?: unknown;
+    };
+}
+export type RequestResult<T> = RequestSuccessResult<T> | RequestErrorResult;
+interface RequestOptionsBase {
     /** gateway 地址（必填） */
     gateway: string;
     /** 请求路径（不含域名） */
@@ -16,6 +31,15 @@ export interface RequestOptions {
     /** 最大重试次数，默认 3 */
     maxRetries?: number;
 }
+export type RequestOptionsWithThrow = RequestOptionsBase & {
+    /** 错误时调用 outputApiError 退出进程，默认 true */
+    throwOnError?: true;
+};
+export type RequestOptionsWithoutThrow = RequestOptionsBase & {
+    /** 错误时返回 RequestResult 而非退出 */
+    throwOnError: false;
+};
+export type RequestOptions = RequestOptionsWithThrow | RequestOptionsWithoutThrow;
 /**
  * 通用请求函数
  *
@@ -24,5 +48,9 @@ export interface RequestOptions {
  * 支持自动重试：
  * - 429 (rate limit) 响应时重试，尊重 Retry-After header
  * - 网络错误时重试，使用指数退避
+ *
+ * 当 throwOnError 为 false 时，返回 RequestResult<T> 而非直接退出。
  */
-export declare function request<T>(options: RequestOptions): Promise<T>;
+export declare function request<T>(options: RequestOptionsWithThrow): Promise<T>;
+export declare function request<T>(options: RequestOptionsWithoutThrow): Promise<RequestResult<T>>;
+export {};

package/dist/core/http.js

@@ -40,17 +40,8 @@ function joinUrl(gateway, path) {
     const normalizedPath = path.startsWith('/') ? path : `/${path}`;
     return `${normalizedGateway}${normalizedPath}`;
 }
-/**
- * 通用请求函数
- *
- * 支持灵活传递 gateway、路径、方法、参数、UA 等。
- *
- * 支持自动重试：
- * - 429 (rate limit) 响应时重试，尊重 Retry-After header
- * - 网络错误时重试，使用指数退避
- */
 export async function request(options) {
-    const { gateway, path, method = 'GET', query, body, headers = {}, userAgent = `lxcli/${pkg.version}`, maxRetries = MAX_RETRIES, } = options;
+    const { gateway, path, method = 'GET', query, body, headers = {}, userAgent = `lxcli/${pkg.version}`, maxRetries = MAX_RETRIES, throwOnError = true, } = options;
     // 构建 URL（gateway + path + query）
     let url = joinUrl(gateway, path);
     if (query && Object.keys(query).length > 0) {
@@ -65,6 +56,17 @@ export async function request(options) {
     };
     const requestBody = body ? JSON.stringify(body) : undefined;
     let lastError = null;
+    // 辅助函数：构造错误结果
+    const errorResult = (status, code, message, details) => {
+        return { ok: false, status, error: { code, message, details } };
+    };
+    // 辅助函数：处理错误（throwOnError 时退出，否则返回错误结果）
+    const handleError = (result) => {
+        if (throwOnError) {
+            outputApiError(result.error.code, result.error.message, result.error.details, result.status);
+        }
+        return result;
+    };
     // 发送请求（带重试）
     for (let attempt = 0; attempt < maxRetries; attempt++) {
         try {
@@ -94,19 +96,22 @@ export async function request(options) {
                     await sleep(delay);
                     continue;
                 }
-                outputApiError(errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details, response.status);
+                return handleError(errorResult(response.status, errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details));
             }
             let responseData;
             try {
                 responseData = parseJsonResponse(responseText);
             }
             catch {
-                outputApiError(response.status, `Invalid JSON response: ${responseText}`, undefined, response.status);
+                return handleError(errorResult(response.status, response.status, `Invalid JSON response: ${responseText}`));
             }
             logger.debug('Response', { status: response.status, data: responseData, attempt });
             if (!response.ok) {
-                const errorResponse = responseData;
-                outputApiError(errorResponse.error?.code || response.status, errorResponse.error?.message || 'Request failed', errorResponse.error?.details, response.status);
+                const errResp = responseData;
+                return handleError(errorResult(response.status, errResp?.error?.code || response.status, errResp?.error?.message || 'Request failed', errResp?.error?.details));
+            }
+            if (!throwOnError) {
+                return { ok: true, status: response.status, data: responseData };
             }
             return responseData;
         }
@@ -125,7 +130,7 @@ export async function request(options) {
             }
             if (isNetworkError) {
                 logger.error('Request failed', error);
-                outputApiError(500, error.message, undefined, 500);
+                return handleError(errorResult(500, 500, error.message));
             }
             throw error;
         }
@@ -133,7 +138,7 @@ export async function request(options) {
     // 所有重试都失败了
     if (lastError) {
         logger.error('All retries failed', lastError);
-        outputApiError(500, lastError.message, undefined, 500);
+        return handleError(errorResult(500, 500, lastError.message));
     }
     // 不应该到达这里，但 TypeScript 需要返回值
     throw new Error('Request failed after all retries');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meet-im/lxcli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "连续科技命令行工具",
   "type": "module",
   "main": "dist/index.js",