@yinuo-ngm/mcp-server 0.1.1 → 0.1.2

package/lib/tools/hub-v2/docs.tools.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2DocsTools = hubV2DocsTools;
+const client_1 = require("./client");
+const config_1 = require("./config");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2DocsTools() {
+    return [
+        {
+            name: "hub_v2_docs_list",
+            description: "List Hub V2 project documents with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.docsListSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const status = args.status;
+                const data = await client.request("GET", client.tokenUrl("/docs", {
+                    page: args.page ?? 1,
+                    pageSize: args.pageSize ?? 20,
+                    status,
+                    statusGroup: status ? undefined : "active",
+                    keyword: args.keyword,
+                    category: args.category,
+                    categoryId: args.categoryId,
+                }));
+                return (0, result_1.ok)("hub_v2_docs_list", data);
+            },
+        },
+        {
+            name: "hub_v2_docs_get",
+            description: "Read one Hub V2 project document by id with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.docsGetSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl(`/docs/${encodeURIComponent(args.docId)}`));
+                return (0, result_1.ok)("hub_v2_docs_get", data);
+            },
+        },
+        {
+            name: "hub_v2_docs_get_by_slug",
+            description: "Read one Hub V2 project document by slug with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.docsGetBySlugSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const payload = await client.request("GET", client.tokenUrl(`/docs/by-slug/${encodeURIComponent(args.slug)}`));
+                if (args.contentOnly) {
+                    const content = extractDocumentContent(payload);
+                    if (typeof content === "string") {
+                        return (0, result_1.ok)("hub_v2_docs_get_by_slug", content);
+                    }
+                    return (0, result_1.fail)("hub_v2_docs_get_by_slug", "Hub V2 document response did not include data.contentMd or data.item.contentMd", {
+                        code: "DOCUMENT_CONTENT_NOT_FOUND",
+                        detail: {
+                            slug: args.slug,
+                            responseKeys: Object.keys(payload),
+                        },
+                    });
+                }
+                return (0, result_1.ok)("hub_v2_docs_get_by_slug", payload);
+            },
+        },
+    ];
+}
+function extractDocumentContent(payload) {
+    const data = payload.data && typeof payload.data === "object" && !Array.isArray(payload.data)
+        ? payload.data
+        : undefined;
+    if (typeof data?.contentMd === "string") {
+        return data.contentMd;
+    }
+    const item = data?.item && typeof data.item === "object" && !Array.isArray(data.item)
+        ? data.item
+        : undefined;
+    return typeof item?.contentMd === "string" ? item.contentMd : undefined;
+}

package/lib/tools/hub-v2/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class HubV2HttpError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    readonly detail?: unknown | undefined;
+    constructor(message: string, status: number, code?: string | undefined, detail?: unknown | undefined);
+}
+export declare function formatHubV2HttpError(status: number, statusText: string, body: unknown): string;
+export declare function toHubV2HttpError(status: number, statusText: string, body: unknown): HubV2HttpError;

package/lib/tools/hub-v2/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubV2HttpError = void 0;
+exports.formatHubV2HttpError = formatHubV2HttpError;
+exports.toHubV2HttpError = toHubV2HttpError;
+class HubV2HttpError extends Error {
+    constructor(message, status, code, detail) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.detail = detail;
+        this.name = "HubV2HttpError";
+    }
+}
+exports.HubV2HttpError = HubV2HttpError;
+function formatHubV2HttpError(status, statusText, body) {
+    const record = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+    const code = typeof record.code === "string" ? record.code : "HTTP_ERROR";
+    const message = typeof record.message === "string" ? record.message : statusText;
+    return `Hub V2 HTTP ${status} ${code}: ${message}`;
+}
+function toHubV2HttpError(status, statusText, body) {
+    const record = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+    const code = typeof record.code === "string" ? record.code : "HTTP_ERROR";
+    const detail = record.detail ?? record.data ?? body;
+    return new HubV2HttpError(formatHubV2HttpError(status, statusText, body), status, code, detail);
+}

package/lib/tools/hub-v2/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2Tools(): McpToolDefinition[];

package/lib/tools/hub-v2/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2Tools = hubV2Tools;
+const docs_tools_1 = require("./docs.tools");
+const issues_tools_1 = require("./issues.tools");
+const projects_tools_1 = require("./projects.tools");
+const rd_tools_1 = require("./rd.tools");
+const upload_tools_1 = require("./upload.tools");
+function hubV2Tools() {
+    return [
+        ...(0, projects_tools_1.hubV2ProjectsTools)(),
+        ...(0, docs_tools_1.hubV2DocsTools)(),
+        ...(0, issues_tools_1.hubV2IssuesTools)(),
+        ...(0, rd_tools_1.hubV2RdTools)(),
+        ...(0, upload_tools_1.hubV2UploadTools)(),
+    ];
+}

package/lib/tools/hub-v2/issues.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2IssuesTools(): McpToolDefinition[];

package/lib/tools/hub-v2/issues.tools.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2IssuesTools = hubV2IssuesTools;
+const client_1 = require("./client");
+const config_1 = require("./config");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2IssuesTools() {
+    return [
+        {
+            name: "hub_v2_issues_list",
+            description: "List Hub V2 issues with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.issuesListSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl("/issues", {
+                    page: args.page ?? 1,
+                    pageSize: args.pageSize ?? 20,
+                    keyword: args.keyword,
+                    status: args.status,
+                    priority: args.priority,
+                    assigneeId: args.assigneeId,
+                    verifierId: args.verifierId,
+                    rdItemId: args.rdItemId,
+                }));
+                return (0, result_1.ok)("hub_v2_issues_list", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_get",
+            description: "Read one Hub V2 issue by id with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.issueGetSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl(`/issues/${encodeURIComponent(args.issueId)}`));
+                return (0, result_1.ok)("hub_v2_issues_get", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_create",
+            description: "Preview or create a Hub V2 issue with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = "/issues";
+                const body = (0, client_1.compact)({
+                    title: args.title,
+                    description: args.description,
+                    type: args.type,
+                    priority: args.priority,
+                    assigneeId: args.assigneeId,
+                    verifierId: args.verifierId,
+                    rdItemId: args.rdItemId,
+                    moduleCode: args.moduleCode,
+                    versionCode: args.versionCode,
+                    environmentCode: args.environmentCode,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:create:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_create", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_comment",
+            description: "Preview or add a Hub V2 issue comment with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueCommentSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/comments`;
+                const body = (0, client_1.compact)({
+                    content: args.content,
+                    mentions: args.mentions,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_comment", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:comment:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_comment", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_update",
+            description: "Preview or update Hub V2 issue basic fields with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueUpdateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}`;
+                const body = (0, client_1.compactUndefined)({
+                    title: args.title,
+                    description: args.description,
+                    type: args.type,
+                    priority: args.priority,
+                    rdItemId: args.rdItemId,
+                    moduleCode: args.moduleCode,
+                    versionCode: args.versionCode,
+                    environmentCode: args.environmentCode,
+                });
+                if (Object.keys(body).length === 0) {
+                    return (0, result_1.fail)("hub_v2_issues_update", "at least one issue field is required");
+                }
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_update", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "PATCH",
+                            path,
+                            requiredScope: "issue:update:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("PATCH", client.personalUrl(path), body, { preserveNull: true });
+                return (0, result_1.ok)("hub_v2_issues_update", data);
+            },
+        },
+    ];
+}

package/lib/tools/hub-v2/projects.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2ProjectsTools(): McpToolDefinition[];

package/lib/tools/hub-v2/projects.tools.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2ProjectsTools = hubV2ProjectsTools;
+const config_1 = require("./config");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2ProjectsTools() {
+    return [
+        {
+            name: "hub_v2_projects_list",
+            description: "List locally configured Hub V2 project aliases without exposing tokens.",
+            riskLevel: "read",
+            inputSchema: schemas_1.projectSelectorSchema,
+            handler(args) {
+                return (0, result_1.ok)("hub_v2_projects_list", (0, config_1.listConfiguredProjects)(args.project ?? args.projectKey));
+            },
+        },
+        {
+            name: "hub_v2_projects_get",
+            description: "Get one locally configured Hub V2 project summary without exposing tokens.",
+            riskLevel: "read",
+            inputSchema: schemas_1.projectSelectorSchema,
+            handler(args) {
+                return (0, result_1.ok)("hub_v2_projects_get", (0, config_1.getConfiguredProject)(args));
+            },
+        },
+    ];
+}

package/lib/tools/hub-v2/rd.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2RdTools(): McpToolDefinition[];

package/lib/tools/hub-v2/rd.tools.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2RdTools = hubV2RdTools;
+const client_1 = require("./client");
+const config_1 = require("./config");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2RdTools() {
+    return [
+        {
+            name: "hub_v2_rd_list",
+            description: "List Hub V2 RD items with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.rdListSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl("/rd-items", {
+                    page: args.page ?? 1,
+                    pageSize: args.pageSize ?? 20,
+                    keyword: args.keyword,
+                    stageId: args.stageId,
+                    status: args.status,
+                    type: args.type,
+                    priority: args.priority,
+                    assigneeId: args.assigneeId,
+                }));
+                return (0, result_1.ok)("hub_v2_rd_list", data);
+            },
+        },
+        {
+            name: "hub_v2_rd_get",
+            description: "Read one Hub V2 RD item by id with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.rdGetSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl(`/rd-items/${encodeURIComponent(args.itemId)}`));
+                return (0, result_1.ok)("hub_v2_rd_get", data);
+            },
+        },
+        {
+            name: "hub_v2_rd_stage_tasks_list",
+            description: "List Hub V2 RD current stage tasks with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.rdStageTasksListSchema,
+            async handler(args) {
+                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl(`/rd-items/${encodeURIComponent(args.itemId)}/stage-tasks`));
+                return (0, result_1.ok)("hub_v2_rd_stage_tasks_list", data);
+            },
+        },
+        {
+            name: "hub_v2_rd_create",
+            description: "Preview or create a Hub V2 RD item with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.rdCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = "/rd-items";
+                const body = (0, client_1.compact)({
+                    title: args.title,
+                    description: args.description,
+                    stageId: args.stageId,
+                    type: args.type,
+                    priority: args.priority,
+                    memberIds: args.memberIds,
+                    verifierId: args.verifierId,
+                    planStartAt: args.planStartAt,
+                    planEndAt: args.planEndAt,
+                    stageTasks: args.stageTasks,
+                    stageTaskTemplates: args.stageTaskTemplates,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_rd_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "rd:create:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_rd_create", data);
+            },
+        },
+        {
+            name: "hub_v2_rd_advance_stage",
+            description: "Preview or execute Hub V2 RD stage advance with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.rdAdvanceStageSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/rd-items/${encodeURIComponent(args.itemId)}/advance-stage`;
+                const body = (0, client_1.compact)({
+                    stageId: args.stageId,
+                    memberIds: args.memberIds,
+                    description: args.description,
+                    planStartAt: args.planStartAt,
+                    planEndAt: args.planEndAt,
+                    stageTasks: args.stageTasks,
+                    stageTaskTemplates: args.stageTaskTemplates,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_rd_advance_stage", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "rd:transition:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_rd_advance_stage", data);
+            },
+        },
+        {
+            name: "hub_v2_rd_stage_tasks_create",
+            description: "Preview or create a Hub V2 RD stage task on the current stage with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.rdStageTaskCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/rd-items/${encodeURIComponent(args.itemId)}/stage-tasks`;
+                const body = (0, client_1.compact)({
+                    title: args.title,
+                    description: args.description,
+                    ownerIds: args.ownerIds,
+                    plannedStartAt: args.plannedStartAt,
+                    plannedEndAt: args.plannedEndAt,
+                    sortOrder: args.sortOrder,
+                    remark: args.remark,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_rd_stage_tasks_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "rd:stage-task:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_rd_stage_tasks_create", data);
+            },
+        },
+        {
+            name: "hub_v2_rd_update_progress",
+            description: "Preview or update Hub V2 RD progress with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.rdUpdateProgressSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/rd-items/${encodeURIComponent(args.itemId)}/progress`;
+                const body = (0, client_1.compact)({
+                    progress: args.progress,
+                    note: args.note,
+                    blockReason: args.blockReason,
+                    resolveBlockId: args.resolveBlockId,
+                    stageTaskId: args.stageTaskId,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_rd_update_progress", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "rd:progress:write or rd:transition:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_rd_update_progress", data);
+            },
+        },
+    ];
+}