@coderpp/yunxiao-cli 0.1.11 → 0.2.0

package/dist/src/client.d.ts

@@ -1,3 +1,4 @@
+export { YunxiaoApiError } from "./transport.js";
 export type YunxiaoEdition = "center" | "region";
 export type Fetcher = (url: string | URL | Request, init?: RequestInit) => Promise<Response>;
 export interface YunxiaoClientOptions {
@@ -6,6 +7,8 @@ export interface YunxiaoClientOptions {
     organizationId?: string;
     edition?: YunxiaoEdition;
     fetcher?: Fetcher;
+    timeoutMs?: number;
+    retries?: number;
 }
 export interface ListChangeRequestsOptions {
     page?: number;
@@ -151,11 +154,13 @@ export interface ReleaseByRepositoryNameOptions {
     sourceBranch: string;
     targetBranch: string;
     createOnly?: boolean;
+    resume?: number;
     title?: string;
     description?: string;
     mergeType?: MergeChangeRequestOptions["mergeType"];
 }
 export interface ReleaseResult {
+    status?: string;
     repository: RepositorySummary;
     changeRequest: unknown;
     review: unknown | null;
@@ -163,14 +168,9 @@ export interface ReleaseResult {
 }
 export interface ApproveAndMergeOptions extends ReviewChangeRequestOptions, MergeChangeRequestOptions {
 }
-export declare class YunxiaoApiError extends Error {
-    readonly status: number;
-    readonly 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 timeoutMs;
+    private readonly retries;
     private readonly token;
     private readonly domain;
     private readonly organizationId?;
@@ -201,6 +201,16 @@ export declare class YunxiaoClient {
     listLatestFailedPipelineRuns(options?: ListLatestFailedPipelineRunsOptions): Promise<LatestFailedPipelineRun[]>;
     getPipelineRun(pipelineId: string, pipelineRunId: string): Promise<unknown>;
     retryPipelineJobRun(pipelineId: string, pipelineRunId: string, jobId: string): Promise<unknown>;
+    getChangeRequest(repositoryId: string, localId: number): Promise<unknown>;
+    updateChangeRequest(repositoryId: string, localId: number, body: Record<string, unknown>): Promise<unknown>;
+    closeChangeRequest(repositoryId: string, localId: number): Promise<unknown>;
+    listChangeRequestComments(repositoryId: string, localId: number, body?: Record<string, unknown>): Promise<unknown>;
+    createChangeRequestComment(repositoryId: string, localId: number, body: Record<string, unknown>): Promise<unknown>;
+    compare(repositoryId: string, from: string, to: string, straight: boolean): Promise<unknown>;
+    getRepository(repositoryId: string): Promise<unknown>;
+    getPipelineJobLog(pipelineId: string, runId: string, jobId: string): Promise<unknown>;
+    startPipeline(pipelineId: string, params?: Record<string, unknown>): Promise<unknown>;
+    cancelPipeline(pipelineId: string, runId: 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>;

package/dist/src/client.js

@@ -1,18 +1,11 @@
-export class YunxiaoApiError extends Error {
-    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";
-    }
-}
+import { release } from "./release.js";
+import { requestJson } from "./transport.js";
+export { YunxiaoApiError } from "./transport.js";
+import { paginate } from "./pagination.js";
+import { CliError } from "./errors.js";
 export class YunxiaoClient {
+    timeoutMs;
+    retries;
     token;
     domain;
     organizationId;
@@ -20,15 +13,28 @@ export class YunxiaoClient {
     fetcher;
     constructor(options) {
         if (!options.token) {
-            throw new Error("Yunxiao token is required. Set YUNXIAO_TOKEN or pass --token.");
+            throw new CliError("INVALID_CONFIG", "Yunxiao token is required. Set YUNXIAO_TOKEN or pass --token.");
         }
+        this.timeoutMs = options.timeoutMs ?? 30000;
+        this.retries = options.retries ?? 2;
+        if (!Number.isSafeInteger(this.timeoutMs) ||
+            this.timeoutMs < 1 ||
+            !Number.isSafeInteger(this.retries) ||
+            this.retries < 0 ||
+            this.retries > 10)
+            throw new CliError("INVALID_CONFIG", "Invalid timeout or retry count.");
         this.token = options.token;
         this.domain = stripProtocol(options.domain ?? "openapi-rdc.aliyuncs.com");
         this.organizationId = options.organizationId;
-        this.edition = options.edition ?? (options.organizationId ? "center" : "region");
+        this.edition =
+            options.edition ?? (options.organizationId ? "center" : "region");
         this.fetcher = options.fetcher ?? fetch;
+        if (!["center", "region"].includes(this.edition))
+            throw new CliError("INVALID_CONFIG", "Invalid edition.");
+        if (!/^[a-zA-Z0-9.-]+(?::[0-9]+)?$/.test(this.domain))
+            throw new CliError("INVALID_CONFIG", "Domain must be an HTTPS hostname, optionally with port.");
         if (this.edition === "center" && !this.organizationId) {
-            throw new Error("Center edition requires organizationId. Set YUNXIAO_ORGANIZATION_ID or pass --organization-id.");
+            throw new CliError("INVALID_CONFIG", "Center edition requires organizationId. Set YUNXIAO_ORGANIZATION_ID or pass --organization-id.");
         }
     }
     listChangeRequests(options = {}) {
@@ -53,7 +59,7 @@ export class YunxiaoClient {
         return this.request("POST", `${this.projectPath(projectId)}/members`, undefined, {
             operatorId: options.operatorId,
             roleId: options.roleId,
-            userIds: options.userIds
+            userIds: options.userIds,
         });
     }
     deleteProjectMember(projectId, options) {
@@ -61,7 +67,7 @@ export class YunxiaoClient {
             operatorId: options.operatorId,
             roleIds: [options.roleId],
             userId: options.userIds.length === 1 ? options.userIds[0] : undefined,
-            userIds: options.userIds.length > 1 ? options.userIds : undefined
+            userIds: options.userIds.length > 1 ? options.userIds : undefined,
         });
     }
     listMembers(options = {}) {
@@ -79,7 +85,7 @@ export class YunxiaoClient {
             perPage: options.perPage,
             sort: options.sort,
             spaceId: options.spaceId,
-            spaceType: options.spaceType ?? "Project"
+            spaceType: options.spaceType ?? "Project",
         });
     }
     getWorkitem(workitemId) {
@@ -104,14 +110,14 @@ export class YunxiaoClient {
         return this.request("POST", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/comments`, undefined, {
             content: options.content,
             operatorId: options.operatorId,
-            parentId: options.parentId
+            parentId: options.parentId,
         });
     }
     async getWorkitemTimeline(workitemId) {
         const [workitem, activities, comments] = await Promise.all([
             this.getWorkitem(workitemId),
             this.listWorkitemActivities(workitemId),
-            this.listWorkitemComments(workitemId)
+            this.listWorkitemComments(workitemId),
         ]);
         return { workitem, activities, comments };
     }
@@ -122,7 +128,7 @@ export class YunxiaoClient {
             startTime: options.startTime,
             endTme: options.endTime,
             status: options.status,
-            triggerMode: options.triggerMode
+            triggerMode: options.triggerMode,
         });
     }
     listPipelines(options = {}) {
@@ -134,7 +140,7 @@ export class YunxiaoClient {
             statusList: options.statusList,
             pipelineName: options.pipelineName,
             createStartTime: options.createStartTime,
-            createEndTime: options.createEndTime
+            createEndTime: options.createEndTime,
         });
     }
     async listLatestFailedPipelineRuns(options = {}) {
@@ -146,13 +152,15 @@ export class YunxiaoClient {
             perPage,
             executeStartTime: startTime,
             executeEndTime: endTime,
-            statusList: "FAIL"
+            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 === "") {
+            if (pipelineId === undefined ||
+                pipelineId === null ||
+                pipelineId === "") {
                 continue;
             }
             const runs = await this.listAllPipelineRuns(String(pipelineId), {
@@ -160,17 +168,20 @@ export class YunxiaoClient {
                 perPage,
                 startTime,
                 endTime,
-                status: "FAIL"
+                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];
+                .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") ?? "",
+                pipelineName: stringRecordValue(pipeline, "pipelineName") ??
+                    stringRecordValue(pipeline, "name") ??
+                    "",
                 pipelineRunId: normalizeNumericId(recordValue(latestRun, "pipelineRunId") ?? ""),
                 status: stringRecordValue(latestRun, "status"),
                 triggerMode: numericOrStringValue(recordValue(latestRun, "triggerMode")),
@@ -179,7 +190,7 @@ export class YunxiaoClient {
                 startTimeText: formatTimestamp(recordValue(latestRun, "startTime")),
                 endTime: numericOrStringValue(recordValue(latestRun, "endTime")),
                 endTimeText: formatTimestamp(recordValue(latestRun, "endTime")),
-                creatorAccountId: stringRecordValue(latestRun, "creatorAccountId")
+                creatorAccountId: stringRecordValue(latestRun, "creatorAccountId"),
             });
         }
         return results.sort((left, right) => Number(right.startTime ?? 0) - Number(left.startTime ?? 0));
@@ -190,6 +201,36 @@ export class YunxiaoClient {
     retryPipelineJobRun(pipelineId, pipelineRunId, jobId) {
         return this.request("PUT", `${this.pipelinePath(pipelineId)}/pipelineRuns/${encodePathSegment(pipelineRunId)}/jobs/${encodePathSegment(jobId)}/retry`);
     }
+    getChangeRequest(repositoryId, localId) {
+        return this.request("GET", this.repositoryChangeRequestPath(repositoryId, localId));
+    }
+    updateChangeRequest(repositoryId, localId, body) {
+        return this.request("PUT", this.repositoryChangeRequestPath(repositoryId, localId), undefined, body);
+    }
+    closeChangeRequest(repositoryId, localId) {
+        return this.request("POST", `${this.repositoryChangeRequestPath(repositoryId, localId)}/close`);
+    }
+    listChangeRequestComments(repositoryId, localId, body = {}) {
+        return this.request("POST", `${this.repositoryChangeRequestPath(repositoryId, localId)}/comments/list`, undefined, body);
+    }
+    createChangeRequestComment(repositoryId, localId, body) {
+        return this.request("POST", `${this.repositoryChangeRequestPath(repositoryId, localId)}/comments`, undefined, body);
+    }
+    compare(repositoryId, from, to, straight) {
+        return this.request("GET", `${this.repositoryPath(repositoryId)}/compares`, { from, to, straight });
+    }
+    getRepository(repositoryId) {
+        return this.request("GET", this.repositoryPath(repositoryId));
+    }
+    getPipelineJobLog(pipelineId, runId, jobId) {
+        return this.request("GET", `${this.pipelinePath(pipelineId)}/runs/${encodePathSegment(runId)}/job/${encodePathSegment(jobId)}/log`);
+    }
+    startPipeline(pipelineId, params) {
+        return this.request("POST", `${this.pipelinePath(pipelineId)}/runs`, undefined, { params: params === undefined ? undefined : JSON.stringify(params) });
+    }
+    cancelPipeline(pipelineId, runId) {
+        return this.request("PUT", `${this.pipelinePath(pipelineId)}/runs/${encodePathSegment(runId)}`);
+    }
     createChangeRequest(repositoryId, options) {
         return this.request("POST", `${this.repositoryPath(repositoryId)}/changeRequests`, undefined, {
             createFrom: options.createFrom ?? "WEB",
@@ -201,37 +242,37 @@ export class YunxiaoClient {
             targetProjectId: normalizeProjectId(options.targetProjectId),
             title: options.title,
             triggerAIReviewRun: options.triggerAIReviewRun ?? false,
-            workItemIds: options.workItemIds
+            workItemIds: options.workItemIds,
         });
     }
     reviewChangeRequest(repositoryId, localId, options = {}) {
         return this.request("POST", `${this.repositoryChangeRequestPath(repositoryId, localId)}/review`, undefined, {
             ...compactBody({
                 reviewComment: options.reviewComment,
-                submitDraftCommentIds: options.submitDraftCommentIds
+                submitDraftCommentIds: options.submitDraftCommentIds,
             }),
-            reviewOpinion: options.reviewOpinion ?? "PASS"
+            reviewOpinion: options.reviewOpinion ?? "PASS",
         });
     }
     mergeChangeRequest(repositoryId, localId, options = {}) {
         return this.request("POST", `${this.repositoryChangeRequestPath(repositoryId, localId)}/merge`, undefined, {
             ...compactBody({
                 mergeMessage: options.mergeMessage,
-                removeSourceBranch: options.removeSourceBranch
+                removeSourceBranch: options.removeSourceBranch,
             }),
-            mergeType: options.mergeType ?? "no-fast-forward"
+            mergeType: options.mergeType ?? "no-fast-forward",
         });
     }
     async approveAndMerge(repositoryId, localId, options = {}) {
         await this.reviewChangeRequest(repositoryId, localId, {
             reviewComment: options.reviewComment,
             reviewOpinion: options.reviewOpinion ?? "PASS",
-            submitDraftCommentIds: options.submitDraftCommentIds
+            submitDraftCommentIds: options.submitDraftCommentIds,
         });
         return this.mergeChangeRequest(repositoryId, localId, {
             mergeMessage: options.mergeMessage,
             mergeType: options.mergeType,
-            removeSourceBranch: options.removeSourceBranch
+            removeSourceBranch: options.removeSourceBranch,
         });
     }
     getChangeRequestTree(repositoryId, localId, options) {
@@ -241,52 +282,7 @@ export class YunxiaoClient {
         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);
-        if (options.createOnly) {
-            return {
-                repository,
-                changeRequest,
-                review: null,
-                merge: null
-            };
-        }
-        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
-        };
+        return release(this, options);
     }
     changeRequestsPath() {
         if (this.edition === "center") {
@@ -344,35 +340,15 @@ export class YunxiaoClient {
         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;
+        return (await paginate((page, perPage) => this.listPipelines({ ...options, page, perPage }), { ...options, allPages: true }));
     }
     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;
+        return (await paginate((page, perPage) => this.listPipelineRuns(pipelineId, { ...options, page, perPage }), { ...options, allPages: true }));
     }
     async request(method, path, query, body) {
         const url = new URL(`https://${this.domain}${path}`);
         for (const [key, value] of Object.entries(query ?? {})) {
-            if (value !== undefined && value !== null && value !== "") {
+            if (value !== undefined && value !== null) {
                 url.searchParams.set(key, String(value));
             }
         }
@@ -380,21 +356,20 @@ export class YunxiaoClient {
             method,
             headers: {
                 "content-type": "application/json",
-                "x-yunxiao-token": this.token
-            }
+                "x-yunxiao-token": this.token,
+            },
         };
         if (body) {
             init.body = JSON.stringify(compactBody(body));
         }
-        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}: ${method} ${url.toString()}${text ? `\n${text}` : ""}`, response.status, text, method, url.toString());
-        }
-        if (!text) {
-            return null;
-        }
-        return JSON.parse(text);
+        return requestJson(this.fetcher, url, init, {
+            timeoutMs: this.timeoutMs,
+            retries: this.retries,
+            token: this.token,
+            readOnly: method === "GET" ||
+                path.endsWith(":search") ||
+                path.endsWith("/comments/list"),
+        });
     }
 }
 function stripProtocol(domain) {
@@ -431,7 +406,7 @@ function uniqueBy(values, keyFn) {
 }
 function timestampInRange(value, startTime, endTime) {
     const timestamp = Number(value);
-    return Number.isFinite(timestamp) && timestamp >= startTime && timestamp <= endTime;
+    return (Number.isFinite(timestamp) && timestamp >= startTime && timestamp <= endTime);
 }
 function normalizeNumericId(value) {
     const numberValue = Number(value);
@@ -473,31 +448,9 @@ function triggerModeName(value) {
     }
 }
 function compactBody(body) {
-    return Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined && value !== null && value !== ""));
+    return Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined && value !== null));
 }
 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/dist/src/config.d.ts

@@ -0,0 +1,4 @@
+import type { Flags } from "./arguments.js";
+export declare function configPath(f: Flags, env: NodeJS.ProcessEnv): string;
+export declare function resolveConfig(f: Flags, env: NodeJS.ProcessEnv): Promise<NodeJS.ProcessEnv>;
+export declare function configCommand(command: string, name: string | undefined, f: Flags, env: NodeJS.ProcessEnv): Promise<unknown>;

package/dist/src/config.js

@@ -0,0 +1,106 @@
+import { readFile, mkdir, writeFile, rename } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+import { CliError } from "./errors.js";
+const keys = {
+    domain: "YUNXIAO_DOMAIN",
+    "organization-id": "YUNXIAO_ORGANIZATION_ID",
+    edition: "YUNXIAO_EDITION",
+    "project-ids": "YUNXIAO_PROJECT_IDS",
+    category: "YUNXIAO_WORKITEM_CATEGORIES",
+};
+export function configPath(f, env) {
+    return String(f.config ??
+        env.YUNXIAO_CONFIG ??
+        join(env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "yunxiao", "config.json"));
+}
+async function readConfig(file) {
+    try {
+        const c = JSON.parse(await readFile(file, "utf8"));
+        if (!c ||
+            !c.profiles ||
+            typeof c.profiles !== "object" ||
+            Array.isArray(c.profiles))
+            throw Error();
+        for (const [name, p] of Object.entries(c.profiles)) {
+            if (!name || !p || typeof p !== "object" || Array.isArray(p))
+                throw Error();
+            for (const [k, v] of Object.entries(p))
+                if (![...Object.keys(keys), "token-env"].includes(k) ||
+                    typeof v !== "string")
+                    throw Error();
+        }
+        if (c.current !== undefined &&
+            (typeof c.current !== "string" || !Object.hasOwn(c.profiles, c.current)))
+            throw Error();
+        return c;
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return { profiles: {} };
+        throw new CliError("INVALID_CONFIG", "Invalid configuration file; expected profiles with supported string fields.");
+    }
+}
+export async function resolveConfig(f, env) {
+    const c = await readConfig(configPath(f, env));
+    const name = String(f.profile ?? env.YUNXIAO_PROFILE ?? c.current ?? "");
+    if (!name)
+        return { ...env };
+    if (!Object.hasOwn(c.profiles, name))
+        throw new CliError("INVALID_CONFIG", `Profile not found: ${name}`);
+    const p = c.profiles[name];
+    const result = {};
+    for (const [k, v] of Object.entries(keys))
+        if (p[k])
+            result[v] = p[k];
+    if (p["token-env"])
+        result.YUNXIAO_TOKEN = env[p["token-env"]];
+    for (const [k, v] of Object.entries(env))
+        if (v !== undefined)
+            result[k] = v;
+    return result;
+}
+export async function configCommand(command, name, f, env) {
+    const file = configPath(f, env);
+    const c = await readConfig(file);
+    if (command === "list")
+        return Object.keys(c.profiles).map((name) => ({
+            name,
+            current: name === c.current,
+        }));
+    if (command === "show") {
+        const selected = String(f.profile ?? env.YUNXIAO_PROFILE ?? c.current ?? "");
+        if (!Object.hasOwn(c.profiles, selected))
+            throw new CliError("INVALID_CONFIG", "Select an existing profile.");
+        return { name: selected, ...c.profiles[selected] };
+    }
+    if (!name ||
+        !/^[-\w.]+$/.test(name) ||
+        ["__proto__", "constructor", "prototype"].includes(name))
+        throw new CliError("INVALID_CONFIG", "Invalid profile name.");
+    if (command === "use") {
+        if (!Object.hasOwn(c.profiles, name))
+            throw new CliError("INVALID_CONFIG", `Profile not found: ${name}`);
+        c.current = name;
+    }
+    else if (command === "set") {
+        if (f.token !== undefined)
+            throw new CliError("INVALID_CONFIG", "Use --token-env to reference a credential environment variable.");
+        const p = { ...(Object.hasOwn(c.profiles, name) ? c.profiles[name] : {}) };
+        for (const k of [...Object.keys(keys), "token-env"])
+            if (f[k] !== undefined)
+                p[k] = String(f[k]);
+        if (p["token-env"] && !/^[A-Za-z_][A-Za-z0-9_]*$/.test(p["token-env"]))
+            throw new CliError("INVALID_CONFIG", "Invalid --token-env.");
+        c.profiles[name] = p;
+    }
+    await mkdir(dirname(file), { recursive: true, mode: 0o700 });
+    const temp = `${file}.${randomUUID()}.tmp`;
+    await writeFile(temp, JSON.stringify(c, null, 2) + "\n", {
+        mode: 0o600,
+        flag: "wx",
+    });
+    await rename(temp, file);
+    return { file, profile: name, current: c.current };
+}

package/dist/src/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly details?: unknown | undefined;
+    constructor(code: string, message: string, exitCode?: number, details?: unknown | undefined);
+}
+export declare function redact(text: string, secrets?: string[]): string;
+export declare function errorInfo(error: unknown): {
+    code: string;
+    message: string;
+    exitCode: number;
+    details?: unknown;
+    requestId?: string;
+};

package/dist/src/errors.js

@@ -0,0 +1,42 @@
+export class CliError extends Error {
+    code;
+    exitCode;
+    details;
+    constructor(code, message, exitCode = 2, details) {
+        super(message);
+        this.code = code;
+        this.exitCode = exitCode;
+        this.details = details;
+    }
+}
+export function redact(text, secrets = []) {
+    for (const secret of secrets)
+        if (secret)
+            text = text.split(secret).join("[REDACTED]");
+    return text
+        .replace(/pt-[\w.-]+/g, "[REDACTED]")
+        .replace(/https?:\/\/[^\s"<>]+\?[^\s"<>]+/g, "[URL query redacted]");
+}
+export function errorInfo(error) {
+    if (error instanceof CliError)
+        return error;
+    const e = error;
+    const status = e?.status;
+    const exitCode = status === 401 || status === 403
+        ? 3
+        : status === 404
+            ? 4
+            : status === 409 || status === 412
+                ? 5
+                : status === 429 || (status ?? 0) >= 500
+                    ? 6
+                    : status && status >= 400
+                        ? 2
+                        : 1;
+    return {
+        code: e?.apiCode ?? (status ? `HTTP_${status}` : "ERROR"),
+        message: e?.message ?? String(error),
+        exitCode,
+        requestId: e?.requestId,
+    };
+}

package/dist/src/mr.d.ts

@@ -0,0 +1,13 @@
+import { YunxiaoClient } from "./client.js";
+import type { Flags } from "./arguments.js";
+export declare function record(v: unknown): Record<string, unknown>;
+export declare function records(v: unknown): Record<string, unknown>[];
+export declare function required(f: Flags, key: string): string;
+export declare function confirmed(f: Flags): void;
+export declare function latestPatch(patches: Record<string, unknown>[], type: string): Record<string, unknown>;
+export declare function patchPair(client: YunxiaoClient, repo: string, id: number, f: Flags): Promise<{
+    from: Record<string, unknown>;
+    to: Record<string, unknown>;
+}>;
+export declare function mrDiff(client: YunxiaoClient, repo: string, id: number, f: Flags): Promise<unknown>;
+export declare function runExtendedMr(command: string, p: string[], f: Flags, c: YunxiaoClient): Promise<unknown>;