devops-mcp-server-extension 1.0.0

package/dist/operations/appstack/variableGroups.js

@@ -0,0 +1,245 @@
+import { z } from 'zod';
+import { yunxiaoRequest, isRegionEdition } from '../../common/utils.js';
+import { resolveOrganizationId } from '../organization/organization.js';
+// Define the Variable schema based on the definition in appstack.swagger.json
+const VariableSchema = z.object({
+    description: z.string().optional().describe("变量描述"),
+    key: z.string().optional().describe("变量键"),
+    value: z.string().optional().describe("变量值"),
+}).describe("变量模型");
+// Define the RepoMeta schema based on the definition in appstack.swagger.json
+const RepoMetaSchema = z.object({
+    name: z.string().describe("仓库名称"),
+    type: z.string().describe("仓库类型"),
+}).describe("仓库信息");
+// Define the Revision schema based on the definition in 变量组.swagger.json
+const RevisionSchema = z.object({
+    author: z.string().describe("提交人"),
+    commitTime: z.number().describe("提交时间 (毫秒时间戳)"),
+    message: z.string().describe("版本提交信息"),
+    refs: z.array(z.string()).describe("关联信息"),
+    repoMeta: RepoMetaSchema.describe("仓库元信息"),
+    sha: z.string().describe("版本sha值"),
+}).describe("版本信息");
+// Define the RevisionVariableGroup schema based on the definition in 变量组.swagger.json
+const RevisionVariableGroupSchema = z.object({
+    displayName: z.string().optional().describe("变量组展示名称"),
+    name: z.string().optional().describe("变量组名称"),
+    revision: RevisionSchema.optional().describe("版本信息"),
+    type: z.enum(["GLOBAL", "TEMPLATE", "APP"]).optional().describe("类型"),
+    vars: z.array(VariableSchema).optional().describe("变量列表"),
+}).describe("变量组版本记录");
+// Schema for the GetEnvVariableGroups API
+export const GetEnvVariableGroupsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    envName: z.string().describe("环境名"),
+});
+export const GetEnvVariableGroupsResponseSchema = z.array(RevisionVariableGroupSchema);
+// Schema for the CreateVariableGroup API
+export const CreateVariableGroupRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    branchName: z.string().optional().describe("版本分支，默认 master"),
+    displayName: z.string().optional().describe("变量组展示名"),
+    fromRevisionSha: z.string().describe("变量组版本号"),
+    message: z.string().optional().describe("变量组描述信息"),
+    name: z.string().optional().describe("变量组唯一名"),
+    vars: z.array(VariableSchema).optional().describe("变量列表"),
+});
+export const CreateVariableGroupResponseSchema = RevisionVariableGroupSchema;
+// Schema for the DeleteVariableGroup API
+export const DeleteVariableGroupRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    variableGroupName: z.string().describe("变量组名"),
+});
+export const DeleteVariableGroupResponseSchema = z.boolean().describe("调用是否成功");
+// Schema for the GetVariableGroup API
+export const GetVariableGroupRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    variableGroupName: z.string().describe("变量组名"),
+});
+export const GetVariableGroupResponseSchema = RevisionVariableGroupSchema;
+// Schema for the UpdateVariableGroup API
+export const UpdateVariableGroupRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    variableGroupName: z.string().describe("变量组名"),
+    branchName: z.string().optional().describe("版本分支，默认 master"),
+    displayName: z.string().optional().describe("变量组展示名"),
+    fromRevisionSha: z.string().describe("变量组版本号"),
+    message: z.string().optional().describe("变量组描述信息"),
+    name: z.string().optional().describe("变量组唯一名"),
+    vars: z.array(VariableSchema).optional().describe("变量列表"),
+});
+export const UpdateVariableGroupResponseSchema = RevisionVariableGroupSchema;
+// Schema for the GetAppVariableGroups API
+export const GetAppVariableGroupsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+});
+export const GetAppVariableGroupsResponseSchema = z.array(RevisionVariableGroupSchema);
+// Schema for the GetAppVariableGroupsRevision API
+export const GetAppVariableGroupsRevisionRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+});
+export const GetAppVariableGroupsRevisionResponseSchema = RevisionSchema;
+/**
+ * Get variable groups for an environment
+ *
+ * @param params - The request parameters
+ * @returns The list of variable groups for the environment
+ */
+export async function getEnvVariableGroups(params) {
+    const { organizationId, appName, envName } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/envs/${envName}/variableGroups`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/envs/${envName}/variableGroups`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return GetEnvVariableGroupsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Create a variable group
+ *
+ * @param params - The request parameters
+ * @returns The created variable group
+ */
+export async function createVariableGroup(params) {
+    const { organizationId, appName, ...body } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/variableGroup`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/variableGroup`;
+        const response = await yunxiaoRequest(url, {
+            method: 'POST',
+            body: body,
+        });
+        return CreateVariableGroupResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Delete a variable group
+ *
+ * @param params - The request parameters
+ * @returns Whether the deletion was successful
+ */
+export async function deleteVariableGroup(params) {
+    const { organizationId, appName, variableGroupName } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/variableGroup/${variableGroupName}`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/variableGroup/${variableGroupName}`;
+        const response = await yunxiaoRequest(url, {
+            method: 'DELETE',
+        });
+        return DeleteVariableGroupResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Get a variable group
+ *
+ * @param params - The request parameters
+ * @returns The variable group
+ */
+export async function getVariableGroup(params) {
+    const { organizationId, appName, variableGroupName } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/variableGroup/${variableGroupName}`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/variableGroup/${variableGroupName}`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return GetVariableGroupResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Update a variable group
+ *
+ * @param params - The request parameters
+ * @returns The updated variable group
+ */
+export async function updateVariableGroup(params) {
+    const { organizationId, appName, variableGroupName, ...body } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/variableGroup/${variableGroupName}`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/variableGroup/${variableGroupName}`;
+        const response = await yunxiaoRequest(url, {
+            method: 'PUT',
+            body: body,
+        });
+        return UpdateVariableGroupResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Get variable groups for an application
+ *
+ * @param params - The request parameters
+ * @returns The list of variable groups for the application
+ */
+export async function getAppVariableGroups(params) {
+    const { organizationId, appName } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/variableGroups`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/variableGroups`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return GetAppVariableGroupsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Get the revision of variable groups for an application
+ *
+ * @param params - The request parameters
+ * @returns The revision of variable groups for the application
+ */
+export async function getAppVariableGroupsRevision(params) {
+    const { organizationId, appName } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/variableGroups:revision`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/variableGroups:revision`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return GetAppVariableGroupsRevisionResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}

package/dist/operations/codeup/branches.js

@@ -0,0 +1,157 @@
+import { buildUrl, yunxiaoRequest, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { CodeupBranchSchema } from "./types.js";
+/**
+ * 创建分支
+ * @param organizationId
+ * @param repositoryId
+ * @param branch
+ * @param ref
+ */
+export async function createBranchFunc(organizationId, repositoryId, branch, ref = "master") {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // Automatically handle unencoded slashes in repositoryId
+    if (repositoryId.includes("/")) {
+        // Found unencoded slash, automatically URL encode it
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // Remove + signs from encoding (spaces are encoded as +, but we need %20)
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            repositoryId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${repositoryId}/branches`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${repositoryId}/branches`;
+    // Build query parameters
+    const queryParams = {
+        branch: branch,
+        ref: ref
+    };
+    const url = buildUrl(baseUrl, queryParams);
+    console.error("createBranchFunc url:" + url);
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+    });
+    return CodeupBranchSchema.parse(response);
+}
+/**
+ * 获取分支详情
+ * @param organizationId
+ * @param repositoryId
+ * @param branchName
+ */
+export async function getBranchFunc(organizationId, repositoryId, branchName) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // Automatically handle unencoded slashes in repositoryId
+    if (repositoryId.includes("/")) {
+        // Found unencoded slash, automatically URL encode it
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // Remove + signs from encoding (spaces are encoded as +, but we need %20)
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            repositoryId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // Automatically handle unencoded slashes in branchName
+    if (branchName.includes("/")) {
+        branchName = encodeURIComponent(branchName);
+    }
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${repositoryId}/branches/${branchName}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${repositoryId}/branches/${branchName}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return CodeupBranchSchema.parse(response);
+}
+/**
+ * 删除分支
+ * @param organizationId
+ * @param repositoryId
+ * @param branchName
+ */
+export async function deleteBranchFunc(organizationId, repositoryId, branchName) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // Automatically handle unencoded slashes in repositoryId
+    if (repositoryId.includes("/")) {
+        // Found unencoded slash, automatically URL encode it
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // Remove + signs from encoding (spaces are encoded as +, but we need %20)
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            repositoryId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // Automatically handle unencoded slashes in branchName
+    if (branchName.includes("/")) {
+        branchName = encodeURIComponent(branchName);
+    }
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${repositoryId}/branches/${branchName}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${repositoryId}/branches/${branchName}`;
+    const response = await yunxiaoRequest(url, {
+        method: "DELETE",
+    });
+    return {
+        branchName: branchName
+    };
+}
+/**
+ * 查询分支列表
+ * @param organizationId
+ * @param repositoryId
+ * @param page
+ * @param perPage
+ * @param sort
+ * @param search
+ */
+export async function listBranchesFunc(organizationId, repositoryId, page, perPage, sort, // Possible values: name_asc, name_desc, updated_asc, updated_desc
+search) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    console.error("listBranchesFunc page:" + page + " perPage:" + perPage + " sort:" + sort + " search:" + search);
+    // Automatically handle unencoded slashes in repositoryId
+    if (repositoryId.includes("/")) {
+        // Found unencoded slash, automatically URL encode it
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // Remove + signs from encoding (spaces are encoded as +, but we need %20)
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            repositoryId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${repositoryId}/branches`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${repositoryId}/branches`;
+    // Build query parameters - use lowercase parameter names as expected by the API
+    const queryParams = {};
+    if (page !== undefined && page !== null) {
+        queryParams.page = page;
+    }
+    if (perPage !== undefined && perPage !== null) {
+        queryParams.perPage = perPage;
+    }
+    if (sort !== undefined && sort !== null) {
+        queryParams.sort = sort;
+    }
+    if (search !== undefined && search !== null) {
+        queryParams.search = search;
+    }
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    // Map each branch object and handle null values
+    return response.map(branchData => {
+        // Filter out null values that would cause parsing errors
+        // This is a defensive approach until we update all schemas properly
+        return CodeupBranchSchema.parse(branchData);
+    });
+}

package/dist/operations/codeup/changeRequestComments.js

@@ -0,0 +1,140 @@
+import { yunxiaoRequest, handleRepositoryIdEncoding, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { ChangeRequestCommentSchema } from "./types.js";
+/**
+ * 创建合并请求评论
+ * 支持两种评论类型：
+ * 1. GLOBAL_COMMENT - 全局评论：对整个合并请求的评论
+ * 2. INLINE_COMMENT - 行内评论：针对特定代码行的评论
+ *
+ * 创建行内评论时，必须提供以下参数：
+ * - file_path: 文件路径，例如 '/src/main/java/com/example/MyClass.java'
+ * - line_number: 行号，例如 42
+ * - from_patchset_biz_id: 比较的起始版本ID（通常是目标分支版本）
+ * - to_patchset_biz_id: 比较的目标版本ID（通常是源分支版本）
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param repositoryId 代码库ID或路径，示例：'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'
+ * @param localId 合并请求局部ID，示例：'1'
+ * @param comment_type 评论类型：'GLOBAL_COMMENT' 或 'INLINE_COMMENT'
+ * @param content 评论内容，长度1-65535，示例：'This is a comment content.'
+ * @param draft 是否草稿评论，默认 false
+ * @param resolved 是否标记已解决，默认 false
+ * @param patchset_biz_id 关联版本ID，示例：'bf117304dfe44d5d9b1132f348edf92e'
+ * @param file_path 文件路径（仅行内评论），示例：'/src/main/java/com/example/MyClass.java'
+ * @param line_number 行号（仅行内评论），示例：42
+ * @param from_patchset_biz_id 起始版本ID（行内评论必传），示例：'bf117304dfe44d5d9b1132f348edf92e'
+ * @param to_patchset_biz_id 目标版本ID（行内评论必传），示例：'537367017a9841738ac4269fbf6aacbe'
+ * @param parent_comment_biz_id 父评论ID（用于回复），示例：'1d8171cf0cc2453197fae0e0a27d5ece'
+ */
+export async function createChangeRequestCommentFunc(organizationId, repositoryId, localId, comment_type, // Possible values: GLOBAL_COMMENT, INLINE_COMMENT
+content, draft, resolved, patchset_biz_id, file_path, line_number, from_patchset_biz_id, to_patchset_biz_id, parent_comment_biz_id) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/changeRequests/${localId}/comments`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/changeRequests/${localId}/comments`;
+    // 准备payload
+    const payload = {
+        comment_type: comment_type,
+        content: content,
+        draft: draft,
+        resolved: resolved,
+        patchset_biz_id: patchset_biz_id,
+    };
+    // 根据评论类型添加必要参数
+    if (comment_type === "INLINE_COMMENT") {
+        // 检查INLINE_COMMENT必需的参数
+        if (!file_path || line_number === undefined || !from_patchset_biz_id || !to_patchset_biz_id) {
+            throw new Error("For INLINE_COMMENT, file_path, line_number, from_patchset_biz_id, and to_patchset_biz_id are required");
+        }
+        payload.file_path = file_path;
+        payload.line_number = line_number;
+        payload.from_patchset_biz_id = from_patchset_biz_id;
+        payload.to_patchset_biz_id = to_patchset_biz_id;
+    }
+    // 添加可选参数
+    if (parent_comment_biz_id) {
+        payload.parent_comment_biz_id = parent_comment_biz_id;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: payload,
+    });
+    return ChangeRequestCommentSchema.parse(response);
+}
+/**
+ * 获取合并请求评论列表
+ * 支持按评论类型、状态、解决状态和文件路径进行过滤
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param repositoryId 代码库ID或路径，示例：'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'
+ * @param localId 合并请求局部ID，示例：'1'
+ * @param patchSetBizIds 版本ID列表（可选），示例：['bf117304dfe44d5d9b1132f348edf92e']
+ * @param commentType 评论类型：'GLOBAL_COMMENT' 或 'INLINE_COMMENT'，默认 'GLOBAL_COMMENT'
+ * @param state 评论状态：'OPENED' 或 'DRAFT'，默认 'OPENED'
+ * @param resolved 是否已解决，默认 false
+ * @param filePath 文件路径过滤（仅行内评论），示例：'/src/main/java/com/example/MyClass.java'
+ */
+export async function listChangeRequestCommentsFunc(organizationId, repositoryId, localId, patchSetBizIds, commentType = "GLOBAL_COMMENT", // Possible values: GLOBAL_COMMENT, INLINE_COMMENT
+state = "OPENED", // Possible values: OPENED, DRAFT
+resolved = false, filePath) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/changeRequests/${localId}/comments/list`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/changeRequests/${localId}/comments/list`;
+    // 准备payload
+    const payload = {
+        patchSetBizIds: patchSetBizIds || [],
+        commentType: commentType,
+        state: state,
+        resolved: resolved,
+    };
+    // 添加可选参数
+    if (filePath) {
+        payload.filePath = filePath;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: payload,
+    });
+    // 确保响应是数组
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    // 解析每个评论对象
+    return response.map(comment => ChangeRequestCommentSchema.parse(comment));
+}
+/**
+ * 更新合并请求评论
+ * 可以更新评论的内容和解决状态
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param repositoryId 代码库ID或路径，示例：'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'
+ * @param localId 合并请求局部ID，示例：'1'
+ * @param commentBizId 评论 bizId，示例：'bf117304dfe44d5d9b1132f348edf92e'
+ * @param content 更新后的评论内容（可选），示例：'your new comment'
+ * @param resolved 是否已解决（可选），示例：false
+ */
+export async function updateChangeRequestCommentFunc(organizationId, repositoryId, localId, commentBizId, content, resolved) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/changeRequests/${localId}/comments/${commentBizId}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/changeRequests/${localId}/comments/${commentBizId}`;
+    // 准备payload
+    const payload = {};
+    if (content !== undefined) {
+        payload.content = content;
+    }
+    if (resolved !== undefined) {
+        payload.resolved = resolved;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "PUT",
+        body: payload,
+    });
+    // 根据 swagger 文档，响应格式为 { result: boolean }
+    return response;
+}