@coderpp/yunxiao-cli 0.1.8 → 0.1.10

package/README.md

@@ -1,6 +1,6 @@
 # @coderpp/yunxiao-cli
 
-用于评审和合并云效 Codeup 合并请求、查询项目协作工作项并维护项目成员的命令行工具。
+用于评审和合并云效 Codeup 合并请求、重试云效流水线任务、查询项目协作工作项并维护项目成员的命令行工具。
 
 ## 安装
 
@@ -69,6 +69,38 @@ npm version 0.1.1
 git push origin main v0.1.1
 ```
 
+## 技能同步
+
+当前仓库的技能位于 `.agents/skills`，可以同步到常用技能目录：
+
+```bash
+npm run skills:sync
+```
+
+同步目标：
+
+- `~/pp-note/.agents/skills`
+- `~/pp-note/.claude/skills`
+- `~/.hermes/skills`
+
+如果希望技能文件修改后自动同步，启动 watcher：
+
+```bash
+npm run skills:watch
+```
+
+Watcher 会先同步一次，然后持续监听 `.agents/skills` 文件变化；同名技能会覆盖，目标目录里的其他技能不会被删除。
+
+如果希望后台常驻自动同步：
+
+```bash
+npm run skills:watch:start
+npm run skills:watch:status
+npm run skills:watch:stop
+```
+
+后台 watcher 的 PID 和日志保存在 `.git/skill-sync-watch.*`，不会提交到仓库。
+
 ## 配置
 
 不要把个人访问令牌写入代码或提交到仓库。建议通过环境变量提供：
@@ -186,6 +218,9 @@ node dist/src/index.js mr list --output json
 node dist/src/index.js mr review 2813489 12 --output table
 node dist/src/index.js mr release yunxiao-cli release/1.2.3 master --yes --create-only --output json
 node dist/src/index.js mr patches 2813489 12 --output json
+node dist/src/index.js pipeline failed-runs --hours 24 --output json
+node dist/src/index.js pipeline runs 123 --status FAIL --output json
+node dist/src/index.js pipeline retry-job 123 456 789 --yes --output table
 ```
 
 支持的格式：
@@ -254,6 +289,62 @@ node dist/src/index.js member list --per-page 100
 node dist/src/index.js member get <memberId> --output json
 ```
 
+## 流水线命令
+
+查询最近失败流水线运行实例，并且同一个流水线只保留最新一次失败运行：
+
+```bash
+node dist/src/index.js pipeline failed-runs --hours 24 --output table
+```
+
+默认查询最近 24 小时，等价于：
+
+```bash
+node dist/src/index.js pipeline failed-runs --hours 24
+```
+
+也可以用毫秒时间戳指定范围：
+
+```bash
+node dist/src/index.js pipeline failed-runs \
+  --start-time 1777358348118 \
+  --end-time 1777444748118 \
+  --output json
+```
+
+查询流水线运行实例列表：
+
+```bash
+node dist/src/index.js pipeline runs <pipelineId> --status FAIL --per-page 30
+```
+
+可用过滤参数：
+
+- `--page`、`--per-page`
+- `--start-time`、`--end-time`：毫秒时间戳，例如 `1729178040000`
+- `--status`：`FAIL`、`SUCCESS`、`RUNNING`
+- `--trigger-mode`：触发方式，常见值为 `1` 人工触发、`2` 定时触发、`3` 代码提交触发、`5` 流水线触发、`6` Webhook 触发
+
+获取单次流水线运行详情：
+
+```bash
+node dist/src/index.js pipeline run <pipelineId> <pipelineRunId> --output json
+```
+
+运行详情里包含阶段和任务信息，重试任务时需要从返回结果里的 `stages[].stageInfo.jobs[].id` 获取 `jobId`。
+
+重试指定流水线任务：
+
+```bash
+node dist/src/index.js pipeline retry-job <pipelineId> <pipelineRunId> <jobId> --yes
+```
+
+`pipeline` 也可以简写为 `pl`，`retry-job` 也可以简写为 `retry`：
+
+```bash
+node dist/src/index.js pl retry <pipelineId> <pipelineRunId> <jobId> --yes
+```
+
 ## 工作项命令
 
 查询当前用户待办工作项：
@@ -270,6 +361,14 @@ node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --a
 node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --assigned-to user-id --state done
 ```
 
+按创建人查询工作项：
+
+```bash
+node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --created-by user-id
+```
+
+`--created-by` 支持逗号分隔多个用户 ID，也可以使用等价参数 `--creator`。
+
 按时间范围查询工作项：
 
 ```bash
@@ -335,5 +434,6 @@ node dist/src/index.js workitem comment <workitemId> --content "处理完成，
 
 - `project member-add`
 - `project member-remove`
+- `pipeline retry-job`
 - `workitem update`
 - `workitem comment`

package/dist/src/cli.js

@@ -42,6 +42,9 @@ async function runCommand(scope, command, parsed, client, env) {
             return runProjectCommand(command, parsed, client);
         case "member":
             return runMemberCommand(command, parsed, client);
+        case "pipeline":
+        case "pl":
+            return runPipelineCommand(command, parsed, client);
         case "workitem":
         case "wi":
             return runWorkitemCommand(command, parsed, client, env);
@@ -141,6 +144,29 @@ async function runMemberCommand(command, parsed, client) {
             throw new Error(`Unknown member command: ${command}`);
     }
 }
+async function runPipelineCommand(command, parsed, client) {
+    if (command === "failed-runs" || command === "failed" || command === "latest-failed-runs") {
+        return client.listLatestFailedPipelineRuns(latestFailedPipelineRunsOptions(parsed.flags));
+    }
+    const pipelineId = requiredPositional(parsed.positionals[2], "pipelineId");
+    const pipelineRunId = parsed.positionals[3];
+    const jobId = parsed.positionals[4];
+    switch (command) {
+        case "runs":
+        case "list-runs":
+            return client.listPipelineRuns(pipelineId, pipelineRunsOptions(parsed.flags));
+        case "run":
+        case "get-run":
+        case "get":
+            return client.getPipelineRun(pipelineId, requiredPositional(pipelineRunId, "pipelineRunId"));
+        case "retry-job":
+        case "retry":
+            requireConfirmation(parsed.flags);
+            return client.retryPipelineJobRun(pipelineId, requiredPositional(pipelineRunId, "pipelineRunId"), requiredPositional(jobId, "jobId"));
+        default:
+            throw new Error(`Unknown pipeline command: ${command}`);
+    }
+}
 async function runWorkitemCommand(command, parsed, client, env) {
     const workitemId = parsed.positionals[2];
     switch (command) {
@@ -242,6 +268,24 @@ function projectSearchOptions(flags) {
         sort: optionalString(flags.sort) ?? "desc"
     };
 }
+function pipelineRunsOptions(flags) {
+    return {
+        page: optionalNumber(flags.page),
+        perPage: optionalNumber(flags["per-page"]),
+        startTime: optionalNumber(flags["start-time"]),
+        endTime: optionalNumber(flags["end-time"]) ?? optionalNumber(flags["end-tme"]),
+        status: optionalString(flags.status),
+        triggerMode: optionalNumber(flags["trigger-mode"])
+    };
+}
+function latestFailedPipelineRunsOptions(flags) {
+    return {
+        hours: optionalNumber(flags.hours) ?? 24,
+        startTime: optionalNumber(flags["start-time"]),
+        endTime: optionalNumber(flags["end-time"]) ?? optionalNumber(flags["end-tme"]),
+        perPage: optionalNumber(flags["per-page"]) ?? 30
+    };
+}
 async function searchWorkitems(client, flags, env) {
     const projectIds = workitemProjectIds(flags, env);
     const perPage = optionalNumber(flags["per-page"]) ?? 20;
@@ -277,7 +321,7 @@ function workitemConditions(flags) {
     const rawConditions = optionalString(flags.conditions);
     const filters = [];
     const assignedTo = optionalString(flags["assigned-to"]) ?? optionalString(flags.assignee);
-    const creator = optionalString(flags.creator);
+    const creator = optionalString(flags["created-by"]) ?? optionalString(flags.creator);
     const statusIds = optionalString(flags["status-ids"]);
     const subject = optionalString(flags.subject);
     const from = optionalString(flags.from) ?? optionalString(flags["created-after"]);
@@ -413,6 +457,9 @@ function formatTable(rows) {
     }
     const normalizedRows = rows.map((row) => (isRecord(row) ? row : { value: row }));
     const preferredKeys = [
+        "pipelineName",
+        "pipelineRunId",
+        "pipelineId",
         "localId",
         "projectId",
         "queryProjectId",
@@ -423,7 +470,17 @@ function formatTable(rows) {
         "title",
         "state",
         "status",
+        "triggerMode",
+        "triggerModeName",
+        "startTime",
+        "startTimeText",
+        "endTime",
+        "endTimeText",
+        "createTime",
+        "gmtCreate",
         "assignedTo",
+        "creator",
+        "createdBy",
         "userId",
         "userName",
         "roleName",
@@ -648,7 +705,11 @@ Usage:
   yunxiao project member-remove <projectId> --user-ids user1,user2 [--role-id project.participant] --yes
   yunxiao member list [--page 1] [--per-page 100] [--output table|json]
   yunxiao member get <memberId> [--output table|json]
-  yunxiao workitem list --project-ids p1,p2 [--assigned-to userId] [--state todo|doing|done] [--from "2026-04-01 00:00:00"] [--to "2026-04-30 23:59:59"]
+  yunxiao pipeline failed-runs [--hours 24] [--output table|json]
+  yunxiao pipeline runs <pipelineId> [--status FAIL] [--start-time 1729178040000] [--end-time 1729181640000] [--output table|json]
+  yunxiao pipeline run <pipelineId> <pipelineRunId> [--output table|json]
+  yunxiao pipeline retry-job <pipelineId> <pipelineRunId> <jobId> --yes [--output table|json]
+  yunxiao workitem list --project-ids p1,p2 [--assigned-to userId] [--created-by userId] [--state todo|doing|done] [--from "2026-04-01 00:00:00"] [--to "2026-04-30 23:59:59"]
   yunxiao workitem mine --project-ids p1,p2 [--state todo|doing|done] [--output table|json]
   yunxiao workitem get <workitemId> [--output table|json]
   yunxiao workitem update <workitemId> --yes [--assigned-to userId] [--participants user1,user2] [--due-date "2026-05-01 18:00:00"] [--field key=value]

package/dist/src/client.d.ts

@@ -84,6 +84,43 @@ export interface CreateWorkitemCommentOptions {
     parentId?: string;
 }
 export type UpdateWorkitemOptions = Record<string, unknown>;
+export interface ListPipelineRunsOptions {
+    page?: number;
+    perPage?: number;
+    startTime?: number;
+    endTime?: number;
+    status?: "FAIL" | "SUCCESS" | "RUNNING" | string;
+    triggerMode?: number;
+}
+export interface ListPipelinesOptions {
+    createStartTime?: number;
+    createEndTime?: number;
+    executeStartTime?: number;
+    executeEndTime?: number;
+    pipelineName?: string;
+    statusList?: string;
+    page?: number;
+    perPage?: number;
+}
+export interface ListLatestFailedPipelineRunsOptions {
+    hours?: number;
+    startTime?: number;
+    endTime?: number;
+    perPage?: number;
+}
+export interface LatestFailedPipelineRun {
+    pipelineId: number | string;
+    pipelineName: string;
+    pipelineRunId: number | string;
+    status?: string;
+    triggerMode?: number | string;
+    triggerModeName: string;
+    startTime?: number | string;
+    startTimeText: string;
+    endTime?: number | string;
+    endTimeText: string;
+    creatorAccountId?: string;
+}
 export interface RepositorySummary {
     id: number | string;
     name?: string;
@@ -157,6 +194,11 @@ export declare class YunxiaoClient {
     listWorkitemComments(workitemId: string): Promise<unknown>;
     createWorkitemComment(workitemId: string, options: CreateWorkitemCommentOptions): Promise<unknown>;
     getWorkitemTimeline(workitemId: string): Promise<unknown>;
+    listPipelineRuns(pipelineId: string, options?: ListPipelineRunsOptions): Promise<unknown>;
+    listPipelines(options?: ListPipelinesOptions): Promise<unknown>;
+    listLatestFailedPipelineRuns(options?: ListLatestFailedPipelineRunsOptions): Promise<LatestFailedPipelineRun[]>;
+    getPipelineRun(pipelineId: string, pipelineRunId: string): Promise<unknown>;
+    retryPipelineJobRun(pipelineId: string, pipelineRunId: string, jobId: string): Promise<unknown>;
     createChangeRequest(repositoryId: string, options: CreateChangeRequestOptions): Promise<unknown>;
     reviewChangeRequest(repositoryId: string, localId: number, options?: ReviewChangeRequestOptions): Promise<unknown>;
     mergeChangeRequest(repositoryId: string, localId: number, options?: MergeChangeRequestOptions): Promise<unknown>;
@@ -172,5 +214,9 @@ export declare class YunxiaoClient {
     private workitemsSearchPath;
     private projectPath;
     private platformMembersPath;
+    private pipelinesPath;
+    private pipelinePath;
+    private listAllPipelines;
+    private listAllPipelineRuns;
     private request;
 }

package/dist/src/client.js

@@ -109,6 +109,81 @@ export class YunxiaoClient {
         ]);
         return { workitem, activities, comments };
     }
+    listPipelineRuns(pipelineId, options = {}) {
+        return this.request("GET", `${this.pipelinePath(pipelineId)}/runs`, {
+            page: options.page,
+            perPage: options.perPage,
+            startTime: options.startTime,
+            endTme: options.endTime,
+            status: options.status,
+            triggerMode: options.triggerMode
+        });
+    }
+    listPipelines(options = {}) {
+        return this.request("GET", this.pipelinesPath(), {
+            page: options.page,
+            perPage: options.perPage,
+            executeStartTime: options.executeStartTime,
+            executeEndTime: options.executeEndTime,
+            statusList: options.statusList,
+            pipelineName: options.pipelineName,
+            createStartTime: options.createStartTime,
+            createEndTime: options.createEndTime
+        });
+    }
+    async listLatestFailedPipelineRuns(options = {}) {
+        const endTime = options.endTime ?? Date.now();
+        const startTime = options.startTime ?? endTime - (options.hours ?? 24) * 60 * 60 * 1000;
+        const perPage = options.perPage ?? 30;
+        const pipelines = await this.listAllPipelines({
+            page: 1,
+            perPage,
+            executeStartTime: startTime,
+            executeEndTime: endTime,
+            statusList: "FAIL"
+        });
+        const uniquePipelines = uniqueBy(pipelines, (pipeline) => String(recordValue(pipeline, "pipelineId") ?? recordValue(pipeline, "id")));
+        const results = [];
+        for (const pipeline of uniquePipelines) {
+            const pipelineId = recordValue(pipeline, "pipelineId") ?? recordValue(pipeline, "id");
+            if (pipelineId === undefined || pipelineId === null || pipelineId === "") {
+                continue;
+            }
+            const runs = await this.listAllPipelineRuns(String(pipelineId), {
+                page: 1,
+                perPage,
+                startTime,
+                endTime,
+                status: "FAIL"
+            });
+            const latestRun = runs
+                .filter((run) => timestampInRange(recordValue(run, "startTime"), startTime, endTime))
+                .sort((left, right) => Number(recordValue(right, "startTime") ?? 0) - Number(recordValue(left, "startTime") ?? 0))[0];
+            if (!latestRun) {
+                continue;
+            }
+            results.push({
+                pipelineId: normalizeNumericId(pipelineId),
+                pipelineName: stringRecordValue(pipeline, "pipelineName") ?? stringRecordValue(pipeline, "name") ?? "",
+                pipelineRunId: normalizeNumericId(recordValue(latestRun, "pipelineRunId") ?? ""),
+                status: stringRecordValue(latestRun, "status"),
+                triggerMode: numericOrStringValue(recordValue(latestRun, "triggerMode")),
+                triggerModeName: triggerModeName(recordValue(latestRun, "triggerMode")),
+                startTime: numericOrStringValue(recordValue(latestRun, "startTime")),
+                startTimeText: formatTimestamp(recordValue(latestRun, "startTime")),
+                endTime: numericOrStringValue(recordValue(latestRun, "endTime")),
+                endTimeText: formatTimestamp(recordValue(latestRun, "endTime")),
+                creatorAccountId: stringRecordValue(latestRun, "creatorAccountId")
+            });
+        }
+        return results.sort((left, right) => Number(right.startTime ?? 0) - Number(left.startTime ?? 0));
+    }
+    getPipelineRun(pipelineId, pipelineRunId) {
+        return this.request("GET", `${this.pipelinePath(pipelineId)}/runs/${encodePathSegment(pipelineRunId)}`);
+    }
+    retryPipelineJobRun(pipelineId, pipelineRunId, jobId) {
+        return this.request("PUT", `${this.pipelinePath(pipelineId)}/pipelineRuns/${encodePathSegment(pipelineRunId)}/jobs/${encodePathSegment(jobId)}/retry`);
+    }
     createChangeRequest(repositoryId, options) {
         return this.request("POST", `${this.repositoryPath(repositoryId)}/changeRequests`, undefined, {
             createFrom: options.createFrom ?? "WEB",
@@ -252,6 +327,42 @@ export class YunxiaoClient {
         }
         return "/oapi/v1/platform/members";
     }
+    pipelinesPath() {
+        if (this.edition === "center") {
+            return `/oapi/v1/flow/organizations/${encodePathSegment(this.organizationId ?? "")}/pipelines`;
+        }
+        return "/oapi/v1/flow/pipelines";
+    }
+    pipelinePath(pipelineId) {
+        const encodedPipelineId = encodePathSegment(pipelineId);
+        return `${this.pipelinesPath()}/${encodedPipelineId}`;
+    }
+    async listAllPipelines(options) {
+        const rows = [];
+        const perPage = options.perPage ?? 30;
+        for (let page = options.page ?? 1;; page += 1) {
+            const response = await this.listPipelines({ ...options, page, perPage });
+            const pageRows = arrayRecords(response);
+            rows.push(...pageRows);
+            if (pageRows.length < perPage) {
+                break;
+            }
+        }
+        return rows;
+    }
+    async listAllPipelineRuns(pipelineId, options) {
+        const rows = [];
+        const perPage = options.perPage ?? 30;
+        for (let page = options.page ?? 1;; page += 1) {
+            const response = await this.listPipelineRuns(pipelineId, { ...options, page, perPage });
+            const pageRows = arrayRecords(response);
+            rows.push(...pageRows);
+            if (pageRows.length < perPage) {
+                break;
+            }
+        }
+        return rows;
+    }
     async request(method, path, query, body) {
         const url = new URL(`https://${this.domain}${path}`);
         for (const [key, value] of Object.entries(query ?? {})) {
@@ -286,6 +397,75 @@ function stripProtocol(domain) {
 function encodePathSegment(value) {
     return encodeURIComponent(value);
 }
+function arrayRecords(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : [];
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function recordValue(record, key) {
+    return record[key];
+}
+function stringRecordValue(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value : undefined;
+}
+function uniqueBy(values, keyFn) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const key = keyFn(value);
+        if (!key || seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        result.push(value);
+    }
+    return result;
+}
+function timestampInRange(value, startTime, endTime) {
+    const timestamp = Number(value);
+    return Number.isFinite(timestamp) && timestamp >= startTime && timestamp <= endTime;
+}
+function normalizeNumericId(value) {
+    const numberValue = Number(value);
+    return Number.isInteger(numberValue) ? numberValue : String(value);
+}
+function numericOrStringValue(value) {
+    if (value === undefined || value === null || value === "") {
+        return undefined;
+    }
+    const numberValue = Number(value);
+    return Number.isFinite(numberValue) ? numberValue : String(value);
+}
+function formatTimestamp(value) {
+    const timestamp = Number(value);
+    if (!Number.isFinite(timestamp)) {
+        return "";
+    }
+    const date = new Date(timestamp);
+    if (Number.isNaN(date.getTime())) {
+        return "";
+    }
+    const pad = (part) => String(part).padStart(2, "0");
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
+function triggerModeName(value) {
+    switch (Number(value)) {
+        case 1:
+            return "人工触发";
+        case 2:
+            return "定时触发";
+        case 3:
+            return "代码提交触发";
+        case 5:
+            return "流水线触发";
+        case 6:
+            return "Webhook触发";
+        default:
+            return value === undefined || value === null ? "" : String(value);
+    }
+}
 function compactBody(body) {
     return Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined && value !== null && value !== ""));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coderpp/yunxiao-cli",
-  "version": "0.1.8",
-  "description": "A CLI for Yunxiao merge request, project member, and workitem workflows.",
+  "version": "0.1.10",
+  "description": "A CLI for Yunxiao merge request, pipeline retry, project member, and workitem workflows.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -18,6 +18,11 @@
     "build": "tsc -p tsconfig.json",
     "pack:dry-run": "npm pack --dry-run",
     "prepack": "npm run build",
+    "skills:sync": "scripts/sync-skills.sh",
+    "skills:watch": "scripts/watch-skills.sh",
+    "skills:watch:start": "scripts/start-skill-sync-watch.sh",
+    "skills:watch:status": "scripts/status-skill-sync-watch.sh",
+    "skills:watch:stop": "scripts/stop-skill-sync-watch.sh",
     "test": "tsc -p tsconfig.json && node --test dist/test/*.test.js"
   },
   "publishConfig": {