@coderpp/yunxiao-cli 0.1.5 → 0.1.6

package/README.md

@@ -118,6 +118,14 @@ node dist/src/index.js mr merge 2813489 12 --yes
 node dist/src/index.js mr approve-and-merge 2813489 12 --yes --merge-type squash --remove-source-branch
 ```
 
+创建发布合并请求、自动评审通过并合并：
+
+```bash
+node dist/src/index.js mr release yunxiao-cli release/1.2.3 master --yes
+```
+
+这个命令会先按仓库名称查询代码库 ID，再用当前 token 对应的用户作为评审人创建合并请求，随后评审通过并合并。合并时固定保留源分支，不会删除源分支。
+
 查询变更文件树：
 
 ```bash
@@ -140,6 +148,7 @@ node dist/src/index.js mr patches 2813489 12
 node dist/src/index.js mr list --output table
 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 --output json
 node dist/src/index.js mr patches 2813489 12 --output json
 ```
 
@@ -158,6 +167,7 @@ node dist/src/index.js mr patches 2813489 12 --output json
 
 - `mr merge`
 - `mr approve-and-merge`
+- `mr release`
 
 这是为了避免误合并。
 

package/dist/src/cli.js

@@ -25,6 +25,19 @@ export async function runCli(args = process.argv.slice(2), env = process.env, io
         if (!repositoryId || !localIdRaw) {
             throw new Error(`Command mr ${command} requires <repositoryId> and <localId>.`);
         }
+        if (command === "release") {
+            requireConfirmation(parsed.flags);
+            result = await client.releaseByRepositoryName({
+                repositoryName: repositoryId,
+                sourceBranch: localIdRaw,
+                targetBranch: requiredPositional(parsed.positionals[4], "targetBranch"),
+                title: optionalString(parsed.flags.title),
+                description: optionalString(parsed.flags.description),
+                mergeType: mergeOptions(parsed.flags).mergeType
+            });
+            printResult(result, outputFormat, stdout);
+            return 0;
+        }
         const localId = parseLocalId(localIdRaw);
         switch (command) {
             case "review":
@@ -199,6 +212,12 @@ function parseLocalId(value) {
     }
     return localId;
 }
+function requiredPositional(value, name) {
+    if (!value) {
+        throw new Error(`Missing required positional argument <${name}>.`);
+    }
+    return value;
+}
 function requiredFlag(flags, name) {
     const value = optionalString(flags[name]);
     if (!value) {
@@ -233,6 +252,7 @@ Usage:
   yunxiao mr review <repositoryId> <localId> [--comment "LGTM"] [--output table|json]
   yunxiao mr merge <repositoryId> <localId> --yes [--merge-type no-fast-forward] [--output table|json]
   yunxiao mr approve-and-merge <repositoryId> <localId> --yes [--merge-type no-fast-forward] [--output table|json]
+  yunxiao mr release <repositoryName> <sourceBranch> <targetBranch> --yes [--title "Release"] [--output table|json]
   yunxiao mr tree <repositoryId> <localId> --from-patch-set-id <id> --to-patch-set-id <id> [--output table|json]
   yunxiao mr patches <repositoryId> <localId> [--output table|json]
 

package/dist/src/client.d.ts

@@ -34,12 +34,61 @@ export interface ChangeRequestTreeOptions {
     fromPatchSetId: string;
     toPatchSetId: string;
 }
+export interface ListRepositoriesOptions {
+    page?: number;
+    perPage?: number;
+    orderBy?: "created_at" | "updated_at" | "last_activity_at" | string;
+    sort?: "asc" | "desc" | string;
+    search?: string;
+    archived?: boolean;
+}
+export interface RepositorySummary {
+    id: number | string;
+    name?: string;
+    path?: string;
+    nameWithNamespace?: string;
+    pathWithNamespace?: string;
+}
+export interface CurrentUser {
+    id: string;
+    name?: string;
+    username?: string;
+    email?: string;
+}
+export interface CreateChangeRequestOptions {
+    sourceBranch: string;
+    sourceProjectId: number | string;
+    targetBranch: string;
+    targetProjectId: number | string;
+    title: string;
+    createFrom?: "WEB" | "COMMAND_LINE";
+    description?: string;
+    reviewerUserIds?: string[];
+    triggerAIReviewRun?: boolean;
+    workItemIds?: string;
+}
+export interface ReleaseByRepositoryNameOptions {
+    repositoryName: string;
+    sourceBranch: string;
+    targetBranch: string;
+    title?: string;
+    description?: string;
+    mergeType?: MergeChangeRequestOptions["mergeType"];
+}
+export interface ReleaseResult {
+    repository: RepositorySummary;
+    changeRequest: unknown;
+    review: unknown;
+    merge: unknown;
+}
 export interface ApproveAndMergeOptions extends ReviewChangeRequestOptions, MergeChangeRequestOptions {
 }
 export declare class YunxiaoApiError extends Error {
     readonly status: number;
     readonly responseBody: string;
-    constructor(message: string, status: number, responseBody: string);
+    readonly method: string;
+    readonly url: string;
+    constructor(message: string, status: number, responseBody: string, method: string, url: string);
 }
 export declare class YunxiaoClient {
     private readonly token;
@@ -49,12 +98,18 @@ export declare class YunxiaoClient {
     private readonly fetcher;
     constructor(options: YunxiaoClientOptions);
     listChangeRequests(options?: ListChangeRequestsOptions): Promise<unknown>;
+    getCurrentUser(): Promise<CurrentUser>;
+    listRepositories(options?: ListRepositoriesOptions): Promise<RepositorySummary[]>;
+    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>;
     approveAndMerge(repositoryId: string, localId: number, options?: ApproveAndMergeOptions): Promise<unknown>;
     getChangeRequestTree(repositoryId: string, localId: number, options: ChangeRequestTreeOptions): Promise<unknown>;
     listChangeRequestPatchSets(repositoryId: string, localId: number): Promise<unknown>;
+    releaseByRepositoryName(options: ReleaseByRepositoryNameOptions): Promise<ReleaseResult>;
     private changeRequestsPath;
+    private repositoriesPath;
+    private repositoryPath;
     private repositoryChangeRequestPath;
     private request;
 }

package/dist/src/client.js

@@ -1,10 +1,14 @@
 export class YunxiaoApiError extends Error {
     status;
     responseBody;
-    constructor(message, status, responseBody) {
+    method;
+    url;
+    constructor(message, status, responseBody, method, url) {
         super(message);
         this.status = status;
         this.responseBody = responseBody;
+        this.method = method;
+        this.url = url;
         this.name = "YunxiaoApiError";
     }
 }
@@ -30,6 +34,26 @@ export class YunxiaoClient {
     listChangeRequests(options = {}) {
         return this.request("GET", this.changeRequestsPath(), options);
     }
+    getCurrentUser() {
+        return this.request("GET", "/oapi/v1/platform/user");
+    }
+    listRepositories(options = {}) {
+        return this.request("GET", this.repositoriesPath(), options);
+    }
+    createChangeRequest(repositoryId, options) {
+        return this.request("POST", `${this.repositoryPath(repositoryId)}/changeRequests`, undefined, {
+            createFrom: options.createFrom ?? "COMMAND_LINE",
+            description: options.description,
+            reviewerUserIds: options.reviewerUserIds,
+            sourceBranch: options.sourceBranch,
+            sourceProjectId: normalizeProjectId(options.sourceProjectId),
+            targetBranch: options.targetBranch,
+            targetProjectId: normalizeProjectId(options.targetProjectId),
+            title: options.title,
+            triggerAIReviewRun: options.triggerAIReviewRun ?? false,
+            workItemIds: options.workItemIds
+        });
+    }
     reviewChangeRequest(repositoryId, localId, options = {}) {
         return this.request("POST", `${this.repositoryChangeRequestPath(repositoryId, localId)}/review`, undefined, {
             ...compactBody({
@@ -66,18 +90,67 @@ export class YunxiaoClient {
     listChangeRequestPatchSets(repositoryId, localId) {
         return this.request("GET", `${this.repositoryChangeRequestPath(repositoryId, localId)}/diffs/patches`);
     }
+    async releaseByRepositoryName(options) {
+        const [currentUser, repositories] = await Promise.all([
+            this.getCurrentUser(),
+            this.listRepositories({
+                page: 1,
+                perPage: 20,
+                search: options.repositoryName,
+                archived: false
+            })
+        ]);
+        const repository = findRepositoryByName(repositories, options.repositoryName);
+        if (!repository) {
+            throw new Error(`Repository not found by name: ${options.repositoryName}`);
+        }
+        const repositoryId = String(repository.id);
+        const title = options.title ?? `Release ${options.sourceBranch} into ${options.targetBranch}`;
+        const changeRequest = await this.createChangeRequest(repositoryId, {
+            sourceBranch: options.sourceBranch,
+            targetBranch: options.targetBranch,
+            sourceProjectId: repository.id,
+            targetProjectId: repository.id,
+            reviewerUserIds: [currentUser.id],
+            title,
+            description: options.description
+        });
+        const localId = localIdFromChangeRequest(changeRequest);
+        const review = await this.reviewChangeRequest(repositoryId, localId, {
+            reviewComment: "Approved by yunxiao-cli release workflow"
+        });
+        const merge = await this.mergeChangeRequest(repositoryId, localId, {
+            mergeType: options.mergeType,
+            removeSourceBranch: false
+        });
+        return {
+            repository,
+            changeRequest,
+            review,
+            merge
+        };
+    }
     changeRequestsPath() {
         if (this.edition === "center") {
             return `/oapi/v1/codeup/organizations/${encodePathSegment(this.organizationId ?? "")}/changeRequests`;
         }
         return "/oapi/v1/codeup/changeRequests";
     }
-    repositoryChangeRequestPath(repositoryId, localId) {
+    repositoriesPath() {
+        if (this.edition === "center") {
+            return `/oapi/v1/codeup/organizations/${encodePathSegment(this.organizationId ?? "")}/repositories`;
+        }
+        return "/oapi/v1/codeup/repositories";
+    }
+    repositoryPath(repositoryId) {
         const encodedRepositoryId = encodePathSegment(repositoryId);
         if (this.edition === "center") {
-            return `/oapi/v1/codeup/organizations/${encodePathSegment(this.organizationId ?? "")}/repositories/${encodedRepositoryId}/changeRequests/${localId}`;
+            return `/oapi/v1/codeup/organizations/${encodePathSegment(this.organizationId ?? "")}/repositories/${encodedRepositoryId}`;
         }
-        return `/oapi/v1/codeup/repositories/${encodedRepositoryId}/changeRequests/${localId}`;
+        return `/oapi/v1/codeup/repositories/${encodedRepositoryId}`;
+    }
+    repositoryChangeRequestPath(repositoryId, localId) {
+        return `${this.repositoryPath(repositoryId)}/changeRequests/${localId}`;
     }
     async request(method, path, query, body) {
         const url = new URL(`https://${this.domain}${path}`);
@@ -99,7 +172,7 @@ export class YunxiaoClient {
         const response = await this.fetcher(url.toString(), init);
         const text = await response.text();
         if (!response.ok) {
-            throw new YunxiaoApiError(`Yunxiao API request failed with HTTP ${response.status}`, response.status, text);
+            throw new YunxiaoApiError(`Yunxiao API request failed with HTTP ${response.status}: ${method} ${url.toString()}${text ? `\n${text}` : ""}`, response.status, text, method, url.toString());
         }
         if (!text) {
             return null;
@@ -116,3 +189,29 @@ function encodePathSegment(value) {
 function compactBody(body) {
     return Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined && value !== null && value !== ""));
 }
+function normalizeProjectId(value) {
+    const numberValue = typeof value === "string" ? Number(value) : value;
+    return Number.isInteger(numberValue) ? numberValue : value;
+}
+function findRepositoryByName(repositories, repositoryName) {
+    const normalizedName = normalizeRepositoryName(repositoryName);
+    const matches = repositories.filter((repository) => [repository.name, repository.path, repository.nameWithNamespace, repository.pathWithNamespace]
+        .filter((value) => typeof value === "string")
+        .some((value) => normalizeRepositoryName(value) === normalizedName));
+    if (matches.length > 1) {
+        throw new Error(`Multiple repositories matched name: ${repositoryName}. Use a more specific path.`);
+    }
+    return matches[0];
+}
+function normalizeRepositoryName(value) {
+    return value.replace(/\s+\/\s+/g, "/").trim().toLowerCase();
+}
+function localIdFromChangeRequest(changeRequest) {
+    if (typeof changeRequest === "object" && changeRequest !== null && "localId" in changeRequest) {
+        const localId = Number(changeRequest.localId);
+        if (Number.isInteger(localId) && localId > 0) {
+            return localId;
+        }
+    }
+    throw new Error("Create change request response did not include a valid localId.");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coderpp/yunxiao-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "A CLI for Yunxiao Codeup merge request review and merge workflows.",
   "type": "module",
   "repository": {