@coderpp/yunxiao-cli 0.1.7 → 0.1.9

package/dist/src/client.d.ts

@@ -42,6 +42,85 @@ export interface ListRepositoriesOptions {
     search?: string;
     archived?: boolean;
 }
+export interface SearchProjectsOptions {
+    conditions?: string;
+    extraConditions?: string;
+    orderBy?: "gmtCreate" | "name" | string;
+    page?: number;
+    perPage?: number;
+    sort?: "asc" | "desc" | string;
+}
+export interface ListProjectMembersOptions {
+    name?: string;
+    roleId?: string;
+}
+export interface ChangeProjectMemberOptions {
+    operatorId?: string;
+    roleId: string;
+    userIds: string[];
+}
+export interface DeleteProjectMemberOptions {
+    operatorId?: string;
+    roleId: string;
+    userIds: string[];
+}
+export interface ListMembersOptions {
+    page?: number;
+    perPage?: number;
+}
+export interface SearchWorkitemsOptions {
+    category: string;
+    conditions?: string;
+    orderBy?: "gmtCreate" | "gmtModified" | "updateStatusAt" | "name" | string;
+    page?: number;
+    perPage?: number;
+    sort?: "asc" | "desc" | string;
+    spaceId: string;
+    spaceType?: "Project" | "Program" | string;
+}
+export interface CreateWorkitemCommentOptions {
+    content: string;
+    operatorId?: string;
+    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;
@@ -71,6 +150,7 @@ export interface ReleaseByRepositoryNameOptions {
     repositoryName: string;
     sourceBranch: string;
     targetBranch: string;
+    createOnly?: boolean;
     title?: string;
     description?: string;
     mergeType?: MergeChangeRequestOptions["mergeType"];
@@ -78,8 +158,8 @@ export interface ReleaseByRepositoryNameOptions {
 export interface ReleaseResult {
     repository: RepositorySummary;
     changeRequest: unknown;
-    review: unknown;
-    merge: unknown;
+    review: unknown | null;
+    merge: unknown | null;
 }
 export interface ApproveAndMergeOptions extends ReviewChangeRequestOptions, MergeChangeRequestOptions {
 }
@@ -100,6 +180,25 @@ export declare class YunxiaoClient {
     listChangeRequests(options?: ListChangeRequestsOptions): Promise<unknown>;
     getCurrentUser(): Promise<CurrentUser>;
     listRepositories(options?: ListRepositoriesOptions): Promise<RepositorySummary[]>;
+    searchProjects(options?: SearchProjectsOptions): Promise<unknown>;
+    getProject(projectId: string): Promise<unknown>;
+    listProjectMembers(projectId: string, options?: ListProjectMembersOptions): Promise<unknown>;
+    createProjectMember(projectId: string, options: ChangeProjectMemberOptions): Promise<unknown>;
+    deleteProjectMember(projectId: string, options: DeleteProjectMemberOptions): Promise<unknown>;
+    listMembers(options?: ListMembersOptions): Promise<unknown>;
+    getMember(memberId: string): Promise<unknown>;
+    searchWorkitems(options: SearchWorkitemsOptions): Promise<unknown>;
+    getWorkitem(workitemId: string): Promise<unknown>;
+    updateWorkitem(workitemId: string, options: UpdateWorkitemOptions): Promise<unknown>;
+    listWorkitemActivities(workitemId: string): Promise<unknown>;
+    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>;
@@ -111,5 +210,13 @@ export declare class YunxiaoClient {
     private repositoriesPath;
     private repositoryPath;
     private repositoryChangeRequestPath;
+    private projexPath;
+    private workitemsSearchPath;
+    private projectPath;
+    private platformMembersPath;
+    private pipelinesPath;
+    private pipelinePath;
+    private listAllPipelines;
+    private listAllPipelineRuns;
     private request;
 }

package/dist/src/client.js

@@ -40,6 +40,150 @@ export class YunxiaoClient {
     listRepositories(options = {}) {
         return this.request("GET", this.repositoriesPath(), options);
     }
+    searchProjects(options = {}) {
+        return this.request("POST", this.projexPath("/projects:search"), undefined, options);
+    }
+    getProject(projectId) {
+        return this.request("GET", this.projectPath(projectId));
+    }
+    listProjectMembers(projectId, options = {}) {
+        return this.request("GET", `${this.projectPath(projectId)}/members`, options);
+    }
+    createProjectMember(projectId, options) {
+        return this.request("POST", `${this.projectPath(projectId)}/members`, undefined, {
+            operatorId: options.operatorId,
+            roleId: options.roleId,
+            userIds: options.userIds
+        });
+    }
+    deleteProjectMember(projectId, options) {
+        return this.request("DELETE", `${this.projectPath(projectId)}/members`, undefined, {
+            operatorId: options.operatorId,
+            roleIds: [options.roleId],
+            userId: options.userIds.length === 1 ? options.userIds[0] : undefined,
+            userIds: options.userIds.length > 1 ? options.userIds : undefined
+        });
+    }
+    listMembers(options = {}) {
+        return this.request("GET", this.platformMembersPath(), options);
+    }
+    getMember(memberId) {
+        return this.request("GET", `${this.platformMembersPath()}/${encodePathSegment(memberId)}`);
+    }
+    searchWorkitems(options) {
+        return this.request("POST", this.workitemsSearchPath(), undefined, {
+            category: options.category,
+            conditions: options.conditions,
+            orderBy: options.orderBy,
+            page: options.page,
+            perPage: options.perPage,
+            sort: options.sort,
+            spaceId: options.spaceId,
+            spaceType: options.spaceType ?? "Project"
+        });
+    }
+    getWorkitem(workitemId) {
+        return this.request("GET", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}`);
+    }
+    updateWorkitem(workitemId, options) {
+        return this.request("PUT", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}`, undefined, options);
+    }
+    listWorkitemActivities(workitemId) {
+        return this.request("GET", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/activities`);
+    }
+    listWorkitemComments(workitemId) {
+        return this.request("GET", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/comments`);
+    }
+    createWorkitemComment(workitemId, options) {
+        return this.request("POST", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/comments`, undefined, {
+            content: options.content,
+            operatorId: options.operatorId,
+            parentId: options.parentId
+        });
+    }
+    async getWorkitemTimeline(workitemId) {
+        const [workitem, activities, comments] = await Promise.all([
+            this.getWorkitem(workitemId),
+            this.listWorkitemActivities(workitemId),
+            this.listWorkitemComments(workitemId)
+        ]);
+        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",
@@ -116,6 +260,14 @@ export class YunxiaoClient {
             description: options.description
         });
         const localId = localIdFromChangeRequest(changeRequest);
+        if (options.createOnly) {
+            return {
+                repository,
+                changeRequest,
+                review: null,
+                merge: null
+            };
+        }
         const review = await this.reviewChangeRequest(repositoryId, localId, {
             reviewComment: "Approved by yunxiao-cli release workflow"
         });
@@ -152,6 +304,65 @@ export class YunxiaoClient {
     repositoryChangeRequestPath(repositoryId, localId) {
         return `${this.repositoryPath(repositoryId)}/changeRequests/${localId}`;
     }
+    projexPath(path) {
+        if (this.edition === "center") {
+            return `/oapi/v1/projex/organizations/${encodePathSegment(this.organizationId ?? "")}${path}`;
+        }
+        return `/oapi/v1/projex${path}`;
+    }
+    workitemsSearchPath() {
+        if (this.edition === "center") {
+            return this.projexPath("/workitems:search");
+        }
+        return this.organizationId
+            ? `/oapi/v1/projex/${encodePathSegment(this.organizationId)}/workitems:search`
+            : "/oapi/v1/projex/workitems:search";
+    }
+    projectPath(projectId) {
+        return `${this.projexPath("/projects")}/${encodePathSegment(projectId)}`;
+    }
+    platformMembersPath() {
+        if (this.edition === "center") {
+            return `/oapi/v1/platform/organizations/${encodePathSegment(this.organizationId ?? "")}/members`;
+        }
+        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 ?? {})) {
@@ -186,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.7",
-  "description": "A CLI for Yunxiao Codeup merge request review and merge workflows.",
+  "version": "0.1.9",
+  "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": {