devops-mcp-server-extension 1.0.0

package/dist/operations/projex/effort.js

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { yunxiaoRequest, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { EffortRecordSchema, EstimatedEffortSchema, IdentifierDTOSchema, ListCurrentUserEffortRecordsSchema, ListEffortRecordsSchema, CreateEffortRecordRequestSchema, ListEstimatedEffortsSchema, CreateEstimatedEffortRequestSchema } from "./types.js";
+// List current user effort records
+export async function listCurrentUserEffortRecords(params) {
+    const validatedParams = ListCurrentUserEffortRecordsSchema.parse(params);
+    const finalOrgId = await resolveOrganizationId(validatedParams.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/effortRecords`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/effortRecords`;
+    const queryParams = {
+        startDate: validatedParams.startDate,
+        endDate: validatedParams.endDate
+    };
+    const response = await yunxiaoRequest(`${url}?startDate=${queryParams.startDate}&endDate=${queryParams.endDate}`, {
+        method: "GET"
+    });
+    return z.array(EffortRecordSchema).parse(response);
+}
+// List effort records
+export async function listEffortRecords(params) {
+    const validatedParams = ListEffortRecordsSchema.parse(params);
+    const finalOrgId = await resolveOrganizationId(validatedParams.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/workitems/${validatedParams.id}/effortRecords`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/workitems/${validatedParams.id}/effortRecords`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET"
+    });
+    return z.array(EffortRecordSchema).parse(response);
+}
+// Create effort record
+export async function createEffortRecord(params) {
+    const validatedParams = CreateEffortRecordRequestSchema.parse({
+        actualTime: params.actualTime,
+        description: params.description,
+        gmtEnd: params.gmtEnd,
+        gmtStart: params.gmtStart,
+        operatorId: params.operatorId,
+        workType: params.workType
+    });
+    const finalOrgId = await resolveOrganizationId(params.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/workitems/${params.id}/effortRecords`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/workitems/${params.id}/effortRecords`;
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: validatedParams
+    });
+    return IdentifierDTOSchema.parse(response);
+}
+// List estimated efforts
+export async function listEstimatedEfforts(params) {
+    const validatedParams = ListEstimatedEffortsSchema.parse(params);
+    const finalOrgId = await resolveOrganizationId(validatedParams.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/workitems/${validatedParams.id}/estimatedEfforts`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/workitems/${validatedParams.id}/estimatedEfforts`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET"
+    });
+    return z.array(EstimatedEffortSchema).parse(response);
+}
+// Create estimated effort
+export async function createEstimatedEffort(params) {
+    const validatedParams = CreateEstimatedEffortRequestSchema.parse({
+        description: params.description,
+        operatorId: params.operatorId,
+        owner: params.owner,
+        spentTime: params.spentTime,
+        workType: params.workType
+    });
+    const finalOrgId = await resolveOrganizationId(params.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/workitems/${params.id}/estimatedEfforts`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/workitems/${params.id}/estimatedEfforts`;
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: validatedParams
+    });
+    return IdentifierDTOSchema.parse(response);
+}
+// Update effort record
+export async function updateEffortRecord(params) {
+    const validatedParams = CreateEffortRecordRequestSchema.parse({
+        actualTime: params.actualTime,
+        description: params.description,
+        gmtEnd: params.gmtEnd,
+        gmtStart: params.gmtStart,
+        operatorId: params.operatorId,
+        workType: params.workType
+    });
+    const finalOrgId = await resolveOrganizationId(params.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/workitems/${params.workitemId}/effortRecords/${params.id}`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/workitems/${params.workitemId}/effortRecords/${params.id}`;
+    const response = await yunxiaoRequest(url, {
+        method: "PUT",
+        body: validatedParams
+    });
+    return response;
+}
+// Update estimated effort
+export async function updateEstimatedEffort(params) {
+    const validatedParams = CreateEstimatedEffortRequestSchema.parse({
+        description: params.description,
+        operatorId: params.operatorId,
+        owner: params.owner,
+        spentTime: params.spentTime,
+        workType: params.workType
+    });
+    const finalOrgId = await resolveOrganizationId(params.organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/workitems/${params.workitemId}/estimatedEfforts/${params.id}`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/workitems/${params.workitemId}/estimatedEfforts/${params.id}`;
+    const response = await yunxiaoRequest(url, {
+        method: "PUT",
+        body: validatedParams
+    });
+    return response;
+}

package/dist/operations/projex/project.js

@@ -0,0 +1,243 @@
+/**
+ * 项目（Project）相关操作
+ *
+ * 概念说明：
+ * - 项目（Project）是云效平台中的项目管理单元，包含工作项、迭代等管理概念
+ * - 项目与代码库（Repository）是不同的概念，代码库属于CodeUp产品，用于代码管理
+ * - 一个项目可以关联多个代码库，但两者是不同的资源类型
+ */
+import { yunxiaoRequest, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { ProjectInfoSchema, ProjectMemberSchema } from "./types.js";
+/**
+ * 获取项目详情
+ * @param organizationId
+ * @param id
+ */
+export async function getProjectFunc(organizationId, id) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/projects/${id}`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects/${id}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return ProjectInfoSchema.parse(response);
+}
+/**
+ * 搜索项目
+ * @param organizationId
+ * @param name
+ * @param status
+ * @param createdAfter
+ * @param createdBefore
+ * @param creator
+ * @param adminUserId
+ * @param logicalStatus
+ * @param advancedConditions
+ * @param extraConditions
+ * @param orderBy
+ * @param page
+ * @param perPage
+ * @param sort
+ * @param scenarioFilter
+ * @param userId
+ */
+export async function searchProjectsFunc(organizationId, name, status, createdAfter, createdBefore, creator, adminUserId, // Project administrator user ID
+logicalStatus, advancedConditions, extraConditions, // Should be constructed using buildExtraConditions for common filters
+orderBy, // Possible values: "gmtCreate", "name"
+page, perPage, sort, // Possible values: "desc", "asc"
+scenarioFilter, // Common project filter scenarios
+userId // User ID to use with scenarioFilter
+) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/projects:search`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects:search`;
+    const payload = {};
+    if (scenarioFilter && userId) {
+        extraConditions = buildExtraConditions(scenarioFilter, userId);
+    }
+    const conditions = buildProjectConditions({
+        name,
+        status,
+        createdAfter,
+        createdBefore,
+        creator,
+        adminUserId,
+        logicalStatus,
+        advancedConditions
+    });
+    if (conditions) {
+        payload.conditions = conditions;
+    }
+    if (extraConditions) {
+        payload.extraConditions = extraConditions;
+    }
+    if (orderBy) {
+        payload.orderBy = orderBy;
+    }
+    if (page !== undefined) {
+        payload.page = page;
+    }
+    if (perPage !== undefined) {
+        payload.perPage = perPage;
+    }
+    if (sort) {
+        payload.sort = sort;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: payload,
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map(project => ProjectInfoSchema.parse(project));
+}
+/**
+ * 构建项目过滤条件(源API所需参数conditions是一个固定的JSON结构)
+ * @param args
+ */
+function buildProjectConditions(args) {
+    if (args.advancedConditions) {
+        return args.advancedConditions;
+    }
+    const filterConditions = [];
+    if (args.name) {
+        filterConditions.push({
+            className: "string",
+            fieldIdentifier: "name",
+            format: "input",
+            operator: "CONTAINS",
+            toValue: null,
+            value: [args.name],
+        });
+    }
+    if (args.status) {
+        const statusValues = args.status.split(",");
+        const values = statusValues.map(v => v.trim());
+        filterConditions.push({
+            className: "status",
+            fieldIdentifier: "status",
+            format: "list",
+            operator: "CONTAINS",
+            toValue: null,
+            value: values,
+        });
+    }
+    if (args.createdAfter) {
+        const createdBefore = args.createdBefore ? `${args.createdBefore} 23:59:59` : null;
+        filterConditions.push({
+            className: "date",
+            fieldIdentifier: "gmtCreate",
+            format: "input",
+            operator: "BETWEEN",
+            toValue: createdBefore,
+            value: [`${args.createdAfter} 00:00:00`],
+        });
+    }
+    if (args.creator) {
+        const creatorValues = args.creator.split(",");
+        const values = creatorValues.map(v => v.trim());
+        filterConditions.push({
+            className: "user",
+            fieldIdentifier: "creator",
+            format: "list",
+            operator: "CONTAINS",
+            toValue: null,
+            value: values,
+        });
+    }
+    if (args.adminUserId) {
+        const adminValues = args.adminUserId.split(",");
+        const values = adminValues.map(v => v.trim());
+        filterConditions.push({
+            className: "user",
+            fieldIdentifier: "project.admin",
+            format: "multiList",
+            operator: "CONTAINS",
+            toValue: null,
+            value: values,
+        });
+    }
+    if (args.logicalStatus) {
+        filterConditions.push({
+            className: "string",
+            fieldIdentifier: "logicalStatus",
+            format: "list",
+            operator: "CONTAINS",
+            toValue: null,
+            value: [args.logicalStatus],
+        });
+    }
+    if (filterConditions.length === 0) {
+        return undefined;
+    }
+    const conditions = {
+        conditionGroups: [filterConditions],
+    };
+    return JSON.stringify(conditions);
+}
+/**
+ * 获取项目成员列表
+ * @param organizationId 组织ID
+ * @param id 项目唯一标识
+ * @param name 名称过滤
+ * @param roleId 角色ID过滤，如 project.admin 表示管理员
+ */
+export async function listProjectMembersFunc(organizationId, id, name, roleId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/projects/${id}/members`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects/${id}/members`;
+    const params = {};
+    if (name) {
+        params.name = name;
+    }
+    if (roleId) {
+        params.roleId = roleId;
+    }
+    const queryString = Object.keys(params).length > 0
+        ? '?' + Object.entries(params).map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join('&')
+        : '';
+    const response = await yunxiaoRequest(url + queryString, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map(member => ProjectMemberSchema.parse(member));
+}
+/**
+ * 项目额外过滤条件
+ * @param scenario The filter scenario: "manage" (projects I manage), "participate" (projects I participate in), "favorite" (projects I favorited)
+ * @param userId The user ID to filter by
+ * @returns JSON string for extraConditions parameter
+ */
+export function buildExtraConditions(scenario, userId) {
+    let fieldIdentifier;
+    switch (scenario) {
+        case "manage":
+            fieldIdentifier = "project.admin";
+            break;
+        case "participate":
+            fieldIdentifier = "users";
+            break;
+        case "favorite":
+            fieldIdentifier = "collectMembers";
+            break;
+        default:
+            throw new Error(`Unknown scenario: ${scenario}`);
+    }
+    const conditions = {
+        conditionGroups: [[{
+                    className: "user",
+                    fieldIdentifier: fieldIdentifier,
+                    format: "multiList",
+                    operator: "CONTAINS",
+                    value: [userId]
+                }]]
+    };
+    return JSON.stringify(conditions);
+}

package/dist/operations/projex/sprint.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { yunxiaoRequest, buildUrl, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { SprintInfoSchema } from "./types.js";
+// Create Sprint Response Schema
+const CreateSprintResponseSchema = z.object({
+    id: z.string().describe("Created sprint ID"),
+});
+export async function getSprintFunc(organizationId, projectId, id) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/projects/${projectId}/sprints/${id}`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects/${projectId}/sprints/${id}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return SprintInfoSchema.parse(response);
+}
+export async function listSprintsFunc(organizationId, id, status, page, perPage) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/projex/projects/${id}/sprints`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects/${id}/sprints`;
+    const queryParams = {};
+    if (status !== undefined && status.length > 0) {
+        queryParams.status = status.join(',');
+    }
+    if (page !== undefined) {
+        queryParams.page = page;
+    }
+    if (perPage !== undefined) {
+        queryParams.perPage = perPage;
+    }
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map(sprint => SprintInfoSchema.parse(sprint));
+}
+export async function createSprintFunc(organizationId, projectId, name, owners, startDate, endDate, description, capacityHours, operatorId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/projects/${projectId}/sprints`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects/${projectId}/sprints`;
+    const requestBody = {
+        name,
+        owners,
+    };
+    if (startDate !== undefined) {
+        requestBody.startDate = startDate;
+    }
+    if (endDate !== undefined) {
+        requestBody.endDate = endDate;
+    }
+    if (description !== undefined) {
+        requestBody.description = description;
+    }
+    if (capacityHours !== undefined) {
+        requestBody.capacityHours = capacityHours;
+    }
+    if (operatorId !== undefined) {
+        requestBody.operatorId = operatorId;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: requestBody,
+    });
+    return CreateSprintResponseSchema.parse(response);
+}
+export async function updateSprintFunc(organizationId, projectId, id, name, owners, startDate, endDate, description, capacityHours, operatorId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/projex/projects/${projectId}/sprints/${id}`
+        : `/oapi/v1/projex/organizations/${finalOrgId}/projects/${projectId}/sprints/${id}`;
+    const requestBody = {
+        name,
+    };
+    if (owners !== undefined) {
+        requestBody.owners = owners;
+    }
+    if (startDate !== undefined) {
+        requestBody.startDate = startDate;
+    }
+    if (endDate !== undefined) {
+        requestBody.endDate = endDate;
+    }
+    if (description !== undefined) {
+        requestBody.description = description;
+    }
+    if (capacityHours !== undefined) {
+        requestBody.capacityHours = capacityHours;
+    }
+    if (operatorId !== undefined) {
+        requestBody.operatorId = operatorId;
+    }
+    await yunxiaoRequest(url, {
+        method: "PUT",
+        body: requestBody,
+    });
+}