@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/mcp/tools/wiki.js

@@ -0,0 +1,266 @@
+import * as z from "zod/v4";
+import { PingCodeError } from "../../pingcode/errors.js";
+import { executeTool, requestIdForLog } from "../tool-runtime.js";
+import { paginationGuidance } from "../pagination-guidance.js";
+import { loadWithKeywordFallback } from "../pagination-guidance.js";
+const readOnlyAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+export function registerWikiTools(server, services, logger) {
+    server.registerTool("pingcode_wiki_list_spaces", {
+        title: "列出 PingCode Wiki 空間",
+        description: "列出目前凭据可访问的 PingCode Wiki 空间。scope_type 可选 organization、user_group 或 user：organization 不需要 scope_id（organization 不传 scope_id）；user_group/user 必须传 PingCode Wiki 空间目录返回的 scope_id，不得把普通用户或团队目录 ID 当作 Wiki scope_id。此操作为唯读，不会生成规格文件。",
+        inputSchema: {
+            keywords: z.string().trim().min(1).max(200).optional().describe("選填的空間名稱關鍵字"),
+            scope_type: z.enum(["organization", "user_group", "user"]).optional().describe("Wiki 范围类型；organization 不需要 scope_id"),
+            scope_id: z.string().trim().min(1).optional().describe("仅接受 PingCode Wiki 空间目录返回的 scope_id；不要填普通用户、团队或用户搜索结果的 ID"),
+            page_index: z.number().int().min(0).optional(),
+            page_size: z.number().int().min(1).max(100).optional(),
+        },
+        annotations: readOnlyAnnotations,
+    }, async ({ keywords, scope_type, scope_id, page_index, page_size }, extra) => executeTool(logger, "pingcode_wiki_list_spaces", requestIdForLog(extra.requestInfo?.headers["x-request-id"], extra.requestId), {
+        hasKeywords: keywords !== undefined,
+        scopeType: scope_type ?? null,
+        hasScopeId: scope_id !== undefined,
+    }, async () => {
+        if (scope_type === "user" && scope_id === undefined) {
+            throw new PingCodeError("scope_type=user 时必须提供 Wiki 范围目录返回的 scope_id；普通用户 ID 不能直接作为 Wiki scope_id", "BAD_REQUEST");
+        }
+        if (scope_type === "user_group" && scope_id === undefined) {
+            throw new PingCodeError("scope_type=user_group 时必须提供 Wiki 范围目录返回的 scope_id", "BAD_REQUEST");
+        }
+        if (scope_type === "organization" && scope_id !== undefined) {
+            throw new PingCodeError("scope_type=organization 不需要 scope_id；organization 不是范围资源 ID", "BAD_REQUEST");
+        }
+        const loaded = await loadWithKeywordFallback(keywords, (searchKeywords, resetPage) => services.getWikiSource().listSpaces({
+            ...(searchKeywords === undefined ? {} : { keywords: searchKeywords }),
+            ...(scope_type === undefined ? {} : { scopeType: scope_type }),
+            ...(scope_id === undefined ? {} : { scopeId: scope_id }),
+            pageIndex: resetPage ? 0 : page_index,
+            pageSize: page_size,
+        }));
+        const result = loaded.page;
+        return {
+            pageSize: result.pageSize,
+            pageIndex: result.pageIndex,
+            total: result.total,
+            spaces: result.values.map((space) => ({
+                id: space.id,
+                identifier: space.identifier,
+                name: space.name,
+                visibility: space.visibility ?? null,
+                description: space.description ?? null,
+                updatedAt: space.updated_at ?? null,
+            })),
+            ...(loaded.keywords === undefined ? {} : { keywords: loaded.keywords }),
+            ...(loaded.fallbackFromKeywords === undefined ? {} : { fallbackFromKeywords: loaded.fallbackFromKeywords }),
+        };
+    }, { formatResult: formatSpaceListResult }));
+    server.registerTool("pingcode_wiki_list_pages", {
+        title: "列出 PingCode Wiki 頁面",
+        description: "列出可存取的 Wiki 頁面，可依空間、直接父頁面或祖先頁面篩選。parent_id 和 ancestor_id 不能同時使用。",
+        inputSchema: {
+            space_id: z.string().trim().min(1).optional().describe("Wiki 空间 ID；来自 pingcode_wiki_list_spaces，名称入口使用 space_name"),
+            space_name: z.string().trim().min(1).optional(),
+            parent_id: z.string().trim().min(1).optional().describe("父页面 ID；来自当前空间的 pingcode_wiki_list_pages，名称入口使用 parent_name"),
+            parent_name: z.string().trim().min(1).optional(),
+            ancestor_id: z.string().trim().min(1).optional().describe("祖先页面 ID；来自当前空间的 pingcode_wiki_list_pages，名称入口使用 ancestor_name"),
+            ancestor_name: z.string().trim().min(1).optional(),
+            page_name: z.string().trim().min(1).optional().describe("页面名称；MCP 会在所选空间/层级内匹配候选"),
+            page_index: z.number().int().min(0).optional(),
+            page_size: z.number().int().min(1).max(100).optional(),
+        },
+        annotations: readOnlyAnnotations,
+    }, async ({ space_id, space_name, parent_id, parent_name, ancestor_id, ancestor_name, page_name, page_index, page_size }, extra) => executeTool(logger, "pingcode_wiki_list_pages", requestIdForLog(extra.requestInfo?.headers["x-request-id"], extra.requestId), {
+        filterType: space_id || space_name
+            ? "space"
+            : parent_id
+                ? "parent"
+                : ancestor_id
+                    ? "ancestor"
+                    : "none",
+        ...(space_id ?? space_name ?? parent_id ?? parent_name ?? ancestor_id ?? ancestor_name
+            ? { resourceId: space_id ?? space_name ?? parent_id ?? parent_name ?? ancestor_id ?? ancestor_name }
+            : {}),
+    }, async () => {
+        const resolvedSpaceId = await resolveSpaceId(services, space_id, space_name);
+        const allPages = await listWikiPages(services, resolvedSpaceId, page_index, page_size);
+        const parentId = await resolvePageName(services, parent_id, parent_name, resolvedSpaceId);
+        const ancestorId = await resolvePageName(services, ancestor_id, ancestor_name, resolvedSpaceId);
+        const result = parentId === undefined && ancestorId === undefined
+            ? allPages
+            : await services.getWikiSource().listPages({ spaceId: resolvedSpaceId, ...(parentId === undefined ? {} : { parentId }), ...(ancestorId === undefined ? {} : { ancestorId }), pageIndex: page_index, pageSize: page_size });
+        const filteredValues = page_name === undefined ? result.values : result.values.filter((page) => page.name.trim().toLocaleLowerCase() === page_name.trim().toLocaleLowerCase());
+        return {
+            pageSize: result.pageSize,
+            pageIndex: result.pageIndex,
+            total: result.total,
+            pages: filteredValues.map((page) => ({
+                id: page.id,
+                shortId: page.short_id ?? null,
+                name: page.name,
+                type: page.type,
+                url: page.html_url,
+                spaceId: page.space.id,
+                spaceName: page.space.name,
+                parentId: page.parent?.id ?? null,
+                updatedAt: page.updated_at ?? null,
+                archived: toBoolean(page.is_archived),
+                deleted: toBoolean(page.is_deleted),
+            })),
+        };
+    }, { formatResult: formatPageListResult }));
+    server.registerTool("pingcode_wiki_get_requirement_context", {
+        title: "取得 PingCode Wiki 需求上下文",
+        description: "取得 Wiki 頁面及其 Markdown 正文，作為 Coding Agent 或 Spec Kit 可追溯的需求上下文。最小输入是 page_id、page_url、page_name 三者之一；必须且只能提供一个。优先使用 pingcode_wiki_list_pages 返回的页面名称或完整 URL，名称不唯一时等待用户选择；列表返回的完整 URL 使用 page_url。此 Tool 不会调用 AI 模型或写入文件。",
+        inputSchema: {
+            page_id: z.string().trim().min(1).optional().describe("内部页面 ID 或短 ID；与 page_url、page_name 互斥"),
+            page_url: z.url().optional().describe("pingcode_wiki_list_pages 返回的完整 Wiki 页面 URL；与 page_id、page_name 互斥"),
+            page_name: z.string().trim().min(1).optional().describe("页面名称；Tool 会在指定空间内匹配唯一页面"),
+            space_id: z.string().trim().min(1).optional().describe("Wiki 空间 ID；来自 pingcode_wiki_list_spaces，名称入口使用 space_name"),
+            space_name: z.string().trim().min(1).optional(),
+        },
+        annotations: readOnlyAnnotations,
+    }, async ({ page_id, page_url, page_name, space_id, space_name }, extra) => executeTool(logger, "pingcode_wiki_get_requirement_context", requestIdForLog(extra.requestInfo?.headers["x-request-id"], extra.requestId), { resourceId: pageReferenceForLog(page_id ?? page_url ?? page_name ?? "") }, async () => {
+        const referenceCount = [page_id, page_url, page_name].filter((value) => value !== undefined).length;
+        if (referenceCount !== 1) {
+            throw new PingCodeError("page_id、page_url、page_name 必须且只能提供一个", "BAD_REQUEST");
+        }
+        if (page_url !== undefined) {
+            if (space_id !== undefined || space_name !== undefined) {
+                throw new PingCodeError("使用 page_url 时不得同时提供 space_id 或 space_name", "BAD_REQUEST");
+            }
+            return services.getWikiSource().getRequirementContext(page_url);
+        }
+        if (page_id !== undefined && space_id === undefined && space_name === undefined) {
+            return services.getWikiSource().getRequirementContext(page_id);
+        }
+        const resolvedSpaceId = await resolveSpaceId(services, space_id, space_name);
+        const resolvedPageId = await resolvePageName(services, page_id, page_name, resolvedSpaceId);
+        if (resolvedPageId === undefined)
+            throw new Error("页面引用不能为空");
+        return services.getWikiSource().getRequirementContext(resolvedPageId);
+    }, { formatResult: formatRequirementContext }));
+}
+async function resolveSpaceId(services, value, name) {
+    if (value === undefined && name === undefined)
+        return undefined;
+    const loadSpaces = async (keywords) => {
+        const values = [];
+        for (let pageIndex = 0; pageIndex < 100; pageIndex += 1) {
+            const page = await services.getWikiSource().listSpaces({ keywords, pageIndex, pageSize: 100 });
+            values.push(...page.values);
+            if (values.length >= page.total || page.values.length === 0)
+                break;
+        }
+        return values;
+    };
+    let spaces = await loadSpaces(name);
+    if (name !== undefined && spaces.length === 0)
+        spaces = await loadSpaces();
+    const matches = spaces.filter((space) => value === undefined ? space.name.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase() || space.identifier.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase() : space.id === value);
+    if (matches.length === 1)
+        return matches[0].id;
+    if (matches.length > 1)
+        throw new PingCodeError("空间名称匹配多个候选，请选择一个空间", "CONFLICT");
+    throw new PingCodeError("空间引用不在 Wiki 空间目录中", "NOT_FOUND");
+}
+async function resolvePageName(services, value, name, spaceId) {
+    if (value === undefined && name === undefined)
+        return undefined;
+    const pages = [];
+    for (let pageIndex = 0; pageIndex < 100; pageIndex += 1) {
+        const page = await listWikiPages(services, spaceId, pageIndex, 100);
+        pages.push(...page.values);
+        if (pages.length >= page.total || page.values.length === 0)
+            break;
+    }
+    const matches = pages.filter((page) => value === undefined ? page.name.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase() : page.id === value || page.short_id === value);
+    if (matches.length === 1)
+        return matches[0].id;
+    if (matches.length > 1)
+        throw new PingCodeError("页面名称匹配多个候选，请选择一个页面", "CONFLICT");
+    throw new PingCodeError("页面引用不在当前空间目录中", "NOT_FOUND");
+}
+async function listWikiPages(services, spaceId, pageIndex = 0, pageSize = 100) {
+    return services.getWikiSource().listPages({ ...(spaceId === undefined ? {} : { spaceId }), pageIndex, pageSize });
+}
+function formatRequirementContext(context) {
+    return [
+        "PingCode Wiki 需求上下文",
+        `標題：${context.title}`,
+        `页面 ID：${context.source.id}`,
+        `短 ID：${context.source.shortId ?? "API 未返回"}`,
+        `空間：${context.source.spaceName}`,
+        `來源：${context.source.url}`,
+        `取得時間：${context.source.retrievedAt}`,
+        `內容 Hash：${context.source.contentHash}`,
+        "",
+        "正文（PingCode 原始 Markdown）：",
+        "",
+        context.contentMarkdown,
+    ].join("\n");
+}
+function formatSpaceListResult(result) {
+    const lines = [`PingCode Wiki 空间候选（${result.spaces.length}/${result.total}）`];
+    for (const space of result.spaces) {
+        lines.push(`- ${space.name}（${space.identifier}）`);
+        lines.push(`  空间 ID：${space.id}`);
+        lines.push(`  可见性：${space.visibility ?? "API 未返回"}`);
+    }
+    if (result.spaces.length === 0) {
+        lines.push("当前筛选条件没有匹配的 Wiki 空间。");
+    }
+    lines.push(...paginationGuidance({
+        pageIndex: result.pageIndex ?? 0,
+        pageSize: result.pageSize ?? Math.max(result.spaces.length, 1),
+        total: result.total,
+        returned: result.spaces.length,
+        ...(result.keywords === undefined ? {} : { keywords: result.keywords }),
+        searchable: true,
+        ...(result.fallbackFromKeywords === undefined ? {} : { fallbackFromKeywords: result.fallbackFromKeywords }),
+    }));
+    return lines.join("\n");
+}
+function formatPageListResult(result) {
+    const lines = [`PingCode Wiki 页面候选（${result.pages.length}/${result.total}）`];
+    for (const page of result.pages) {
+        lines.push(`- ${page.name}（${page.shortId ?? page.id}）`);
+        lines.push(`  页面 ID：${page.id}`);
+        lines.push(`  空间：${page.spaceName}`);
+        lines.push(`  来源：${page.url}`);
+        if (page.deleted || page.archived) {
+            lines.push(`  状态：${page.deleted ? "已删除" : "已归档"}`);
+        }
+    }
+    if (result.pages.length === 0) {
+        lines.push("当前筛选条件没有匹配的 Wiki 页面。");
+    }
+    lines.push(...paginationGuidance({
+        pageIndex: result.pageIndex ?? 0,
+        pageSize: result.pageSize ?? Math.max(result.pages.length, 1),
+        total: result.total,
+        returned: result.pages.length,
+        searchable: false,
+    }));
+    return lines.join("\n");
+}
+function pageReferenceForLog(value) {
+    if (!value.includes("://")) {
+        return value;
+    }
+    try {
+        const segments = new URL(value).pathname.split("/").filter(Boolean);
+        return decodeURIComponent(segments.at(-1) ?? "unknown");
+    }
+    catch {
+        return "invalid-url";
+    }
+}
+function toBoolean(value) {
+    return value === true || value === 1;
+}
+//# sourceMappingURL=wiki.js.map

package/dist/mcp/tools/wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../../src/mcp/tools/wiki.ts"],"names":[],"mappings":"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"}

package/dist/mcp/write-approval.d.ts

@@ -0,0 +1,48 @@
+import type { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import * as z from "zod/v4";
+import type { Logger } from "../logger.js";
+import type { ApprovalPayload, WriteResourceType } from "../write/approval.js";
+import type { WriteRuntime } from "../write/runtime.js";
+export type WriteApprovalMode = "approval_token" | "client_confirmation";
+export type WriteAction = "create" | "update" | "delete";
+export type WriteConfirmationPolicy = "required" | "update" | "delete" | "none";
+export declare function requiresWriteConfirmation(policy: WriteConfirmationPolicy, actions: readonly WriteAction[]): boolean;
+export declare function approvalTokenSchema(_mode: WriteApprovalMode): z.ZodOptional<z.ZodString>;
+export declare function resolveCommitVerification(runtime: WriteRuntime, input: {
+    previewId?: string;
+    approvalContextId?: string;
+    idempotencyKey?: string;
+    requestHash?: string;
+    agentSessionId?: string;
+    authInfo?: AuthInfo;
+}, resourceType: WriteResourceType): Promise<{
+    approvalContextId: string;
+    requestHash: string;
+    evidenceHash: string;
+    sessionBinding: string;
+    idempotencyKey: string;
+}>;
+export declare function requestClientWriteConfirmation(server: McpServer, logger: Logger, mode: WriteApprovalMode, approvalToken: string | undefined, message: string, confirmationRequired?: boolean): Promise<void>;
+export declare function formatWriteToolResult(result: object): string;
+export declare function formatWriteConfirmationMessage(title: string, details: string[], finalNotice?: string): string;
+export declare function formatPreviewToolResult(result: object): string;
+export declare function commitWithApproval<T>(runtime: WriteRuntime, mode: WriteApprovalMode, input: {
+    resourceType: WriteResourceType;
+    requestHash: string;
+    evidenceHash: string;
+    approvalContextId: string;
+    sessionBinding: string;
+    agentSessionId?: string;
+    approvalToken?: string;
+    idempotencyKey: string;
+    authInfo?: AuthInfo;
+    actions?: readonly WriteAction[];
+    action: () => Promise<T>;
+}): Promise<{
+    result: T;
+    replayed: boolean;
+    approval: ApprovalPayload;
+    auditId: string;
+}>;
+//# sourceMappingURL=write-approval.d.ts.map

package/dist/mcp/write-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-approval.d.ts","sourceRoot":"","sources":["../../src/mcp/write-approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACzD,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAKnH;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,8BAO3D;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE;IACL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,EACD,YAAY,EAAE,iBAAiB,GAC9B,OAAO,CAAC;IACT,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAyDD;AAED,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,EAAE,MAAM,EACf,oBAAoB,UAAO,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+C5D;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,SAAkC,GAC5C,MAAM,CAKR;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2C9D;AAoHD,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE;IACL,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1B,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBvF"}