@meet-im/lxcli 0.0.5 → 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

@@ -20,7 +20,7 @@ export async function jsonRpcCall(gateway, method, params, pat) {
         throwOnError: false,
     });
     // HTTP 层错误
-    if (result.error) {
+    if (!result.ok) {
         outputCliError('NETWORK_ERROR', result.error.message, {
             code: result.error.code,
             details: result.error.details,

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/core/http.d.ts

@@ -1,16 +1,19 @@
-export interface RequestResult<T> {
-    /** HTTP 状态码 */
+export interface RequestSuccessResult<T> {
+    ok: true;
     status: number;
-    /** 响应数据（成功时） */
-    data?: T;
-    /** 错误信息（失败时） */
-    error?: {
+    data: T;
+}
+export interface RequestErrorResult {
+    ok: false;
+    status: number;
+    error: {
         code: number;
         message: string;
         details?: unknown;
     };
 }
-export interface RequestOptionsWithThrow {
+export type RequestResult<T> = RequestSuccessResult<T> | RequestErrorResult;
+interface RequestOptionsBase {
     /** gateway 地址（必填） */
     gateway: string;
     /** 请求路径（不含域名） */
@@ -27,29 +30,15 @@ export interface RequestOptionsWithThrow {
     userAgent?: string;
     /** 最大重试次数，默认 3 */
     maxRetries?: number;
-    /** 错误时抛出异常而非直接退出，默认 true */
-    throwOnError?: true;
 }
-export interface RequestOptionsWithoutThrow {
-    /** gateway 地址（必填） */
-    gateway: string;
-    /** 请求路径（不含域名） */
-    path: string;
-    /** HTTP 方法，默认 GET */
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
-    /** URL query 参数 */
-    query?: Record<string, string | number | boolean>;
-    /** 请求体 */
-    body?: Record<string, unknown>;
-    /** 自定义 headers（会覆盖默认 headers） */
-    headers?: Record<string, string>;
-    /** User-Agent，默认 lxcli/版本号 */
-    userAgent?: string;
-    /** 最大重试次数，默认 3 */
-    maxRetries?: number;
+export type RequestOptionsWithThrow = RequestOptionsBase & {
+    /** 错误时调用 outputApiError 退出进程，默认 true */
+    throwOnError?: true;
+};
+export type RequestOptionsWithoutThrow = RequestOptionsBase & {
     /** 错误时返回 RequestResult 而非退出 */
     throwOnError: false;
-}
+};
 export type RequestOptions = RequestOptionsWithThrow | RequestOptionsWithoutThrow;
 /**
  * 通用请求函数
@@ -64,3 +53,4 @@ export type RequestOptions = RequestOptionsWithThrow | RequestOptionsWithoutThro
  */
 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

@@ -56,12 +56,16 @@ export async function request(options) {
     };
     const requestBody = body ? JSON.stringify(body) : undefined;
     let lastError = null;
-    // 辅助函数：处理错误响应
-    const makeErrorResult = (status, code, message, details) => {
+    // 辅助函数：构造错误结果
+    const errorResult = (status, code, message, details) => {
+        return { ok: false, status, error: { code, message, details } };
+    };
+    // 辅助函数：处理错误（throwOnError 时退出，否则返回错误结果）
+    const handleError = (result) => {
         if (throwOnError) {
-            outputApiError(code, message, details, status);
+            outputApiError(result.error.code, result.error.message, result.error.details, result.status);
         }
-        return { status, error: { code, message, details } };
+        return result;
     };
     // 发送请求（带重试）
     for (let attempt = 0; attempt < maxRetries; attempt++) {
@@ -92,32 +96,22 @@ export async function request(options) {
                     await sleep(delay);
                     continue;
                 }
-                const result = makeErrorResult(response.status, errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details);
-                if (!throwOnError)
-                    return result;
-                // throwOnError 为 true 时 makeErrorResult 已经调用 outputApiError 退出了
+                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 {
-                const result = makeErrorResult(response.status, response.status, `Invalid JSON response: ${responseText}`);
-                if (!throwOnError)
-                    return result;
-                // throwOnError 为 true 时 makeErrorResult 已经调用 outputApiError 退出了
+                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;
-                const result = makeErrorResult(response.status, errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details);
-                if (!throwOnError)
-                    return result;
-                // throwOnError 为 true 时 makeErrorResult 已经调用 outputApiError 退出了
+                const errResp = responseData;
+                return handleError(errorResult(response.status, errResp?.error?.code || response.status, errResp?.error?.message || 'Request failed', errResp?.error?.details));
             }
-            // throwOnError 为 false 时返回完整结果
             if (!throwOnError) {
-                return { status: response.status, data: responseData };
+                return { ok: true, status: response.status, data: responseData };
             }
             return responseData;
         }
@@ -136,9 +130,7 @@ export async function request(options) {
             }
             if (isNetworkError) {
                 logger.error('Request failed', error);
-                const result = makeErrorResult(500, 500, error.message);
-                if (!throwOnError)
-                    return result;
+                return handleError(errorResult(500, 500, error.message));
             }
             throw error;
         }
@@ -146,9 +138,7 @@ export async function request(options) {
     // 所有重试都失败了
     if (lastError) {
         logger.error('All retries failed', lastError);
-        const result = makeErrorResult(500, 500, lastError.message);
-        if (!throwOnError)
-            return result;
+        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.5",
+  "version": "0.0.6",
   "description": "连续科技命令行工具",
   "type": "module",
   "main": "dist/index.js",