@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/domain/work-item-context.d.ts

@@ -0,0 +1,47 @@
+export interface WorkItemContext {
+    source: {
+        type: "task";
+        id: string;
+        identifier: string;
+        shortId: string | null;
+        url: string;
+        apiUrl: string;
+        projectId: string;
+        projectIdentifier: string;
+        projectName: string;
+        updatedAt: number | null;
+        retrievedAt: string;
+        contentHash: string;
+    };
+    title: string;
+    type: string;
+    description: string | null;
+    state: WorkItemNamedValue & {
+        type: string;
+    } | null;
+    priority: WorkItemNamedValue | null;
+    assignee: {
+        id: string;
+        name: string | null;
+        displayName: string | null;
+    } | null;
+    parent: {
+        id: string;
+        identifier: string;
+        title: string;
+        type: string;
+        url: string;
+    } | null;
+    sprint: WorkItemNamedValue | null;
+    version: WorkItemNamedValue | null;
+    tags: WorkItemNamedValue[];
+    startAt: number | null;
+    endAt: number | null;
+    completedAt: number | null;
+    properties: Record<string, unknown>;
+}
+export interface WorkItemNamedValue {
+    id: string;
+    name: string;
+}
+//# sourceMappingURL=work-item-context.d.ts.map

package/dist/domain/work-item-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-context.d.ts","sourceRoot":"","sources":["../../src/domain/work-item-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,kBAAkB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,GAAG,IAAI,CAAC;IACT,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/domain/work-item-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=work-item-context.js.map

package/dist/domain/work-item-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-context.js","sourceRoot":"","sources":["../../src/domain/work-item-context.ts"],"names":[],"mappings":""}

package/dist/environment.d.ts

@@ -0,0 +1,2 @@
+export declare function loadEnvironment(argv?: readonly string[]): void;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,IAAI,CAQ5E"}

package/dist/environment.js

@@ -0,0 +1,21 @@
+import { fileURLToPath } from "node:url";
+import { config as loadDotenv } from "dotenv";
+export function loadEnvironment(argv = process.argv) {
+    const configuredPath = process.env.PINGCODE_ENV_FILE?.trim() || readEnvFileArg(argv);
+    const defaultPath = fileURLToPath(new URL("../.env", import.meta.url));
+    loadDotenv({
+        path: configuredPath || defaultPath,
+        quiet: true,
+    });
+}
+function readEnvFileArg(argv) {
+    const inlineArg = argv.find((arg) => arg.startsWith("--env-file="));
+    if (inlineArg) {
+        const value = inlineArg.slice("--env-file=".length).trim();
+        return value || undefined;
+    }
+    const flagIndex = argv.indexOf("--env-file");
+    const value = flagIndex >= 0 ? argv[flagIndex + 1]?.trim() : undefined;
+    return value || undefined;
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,UAAU,eAAe,CAAC,OAA0B,OAAO,CAAC,IAAI;IACpE,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACrF,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvE,UAAU,CAAC;QACT,IAAI,EAAE,cAAc,IAAI,WAAW;QACnC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,IAAuB;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IACpE,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,OAAO,KAAK,IAAI,SAAS,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { loadConfig } from "./config.js";
+import { loadEnvironment } from "./environment.js";
+import { createLogger } from "./logger.js";
+import { createServices } from "./services.js";
+import { startHttpServer } from "./transports/http.js";
+import { startStdioServer } from "./transports/stdio.js";
+import { createUserOAuthRuntime } from "./auth/runtime.js";
+import { createWriteRuntime } from "./write/runtime.js";
+loadEnvironment();
+async function main() {
+    const stdioMode = process.argv.includes("--stdio");
+    const config = loadConfig(process.env, { allowEphemeralWriteApprovalSecret: stdioMode });
+    const logger = createLogger(config.logLevel);
+    if (config.write.approvalSecretEphemeral) {
+        logger.info("本機寫入使用本次程序隨機 Approval Secret", {
+            approvalMode: "client_confirmation",
+        });
+    }
+    const services = createServices(config, logger);
+    const writeRuntime = createWriteRuntime(config, logger);
+    if (stdioMode) {
+        if (config.pingcode.authMode === "user_oauth") {
+            throw new Error("user_oauth 只支援 Streamable HTTP；stdio 請使用 enterprise 認證模式");
+        }
+        await startStdioServer(services, logger, writeRuntime);
+        return;
+    }
+    const oauthRuntime = config.pingcode.authMode === "user_oauth"
+        ? await createUserOAuthRuntime(config, logger)
+        : undefined;
+    const runningServer = await startHttpServer(config, services, logger, writeRuntime, oauthRuntime);
+    const shutdown = async (signal) => {
+        logger.info("正在停止 PingCode MCP HTTP Server", { signal });
+        await runningServer.close();
+        await writeRuntime.close();
+        process.exit(0);
+    };
+    process.once("SIGINT", () => void shutdown("SIGINT"));
+    process.once("SIGTERM", () => void shutdown("SIGTERM"));
+}
+main().catch((error) => {
+    process.stderr.write(`${JSON.stringify({
+        timestamp: new Date().toISOString(),
+        level: "error",
+        message: "PingCode MCP 啟動失敗",
+        errorName: error instanceof Error ? error.name : typeof error,
+        errorMessage: error instanceof Error ? error.message : "未知錯誤",
+    })}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAe,EAAE,CAAC;AAElB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iCAAiC,EAAE,SAAS,EAAE,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC1C,YAAY,EAAE,qBAAqB;SACpC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAChB,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,YAAY;QACvC,CAAC,CAAC,MAAM,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAClG,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACxC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;QAC7D,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;KAC9D,CAAC,IAAI,CACP,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/inspect-wiki.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=inspect-wiki.d.ts.map

package/dist/inspect-wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-wiki.d.ts","sourceRoot":"","sources":["../src/inspect-wiki.ts"],"names":[],"mappings":""}

package/dist/inspect-wiki.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { loadConfig } from "./config.js";
+import { loadEnvironment } from "./environment.js";
+import { createLogger } from "./logger.js";
+import { createServices } from "./services.js";
+import { createWriteRuntime } from "./write/runtime.js";
+loadEnvironment();
+async function main() {
+    const args = process.argv.slice(2);
+    const jsonOutput = args.includes("--json");
+    const unknownOptions = args.filter((arg) => arg.startsWith("--") && arg !== "--json");
+    const pageReferences = args.filter((arg) => !arg.startsWith("--"));
+    if (unknownOptions.length > 0 || pageReferences.length !== 1) {
+        throw new Error("用法：npm run inspect:wiki -- '<頁面 ID 或 URL>' [--json]。此命令會輸出完整 Wiki 正文。");
+    }
+    const config = loadConfig(process.env, { allowEphemeralWriteApprovalSecret: true });
+    if (config.pingcode.authMode === "user_oauth") {
+        throw new Error("inspect:wiki 只支援 enterprise；user_oauth 請透過 HTTP MCP Client 讀取 Wiki");
+    }
+    const logger = createLogger("error");
+    const services = createServices(config, logger);
+    const writeRuntime = createWriteRuntime(config, logger);
+    if (!services.isConfigured()) {
+        throw new Error(".env 中尚未配置 PingCode 憑據");
+    }
+    try {
+        // Read through the Wiki source rather than the MCP Tool: Tools intentionally return only
+        // human-readable text now, so a structured --json payload is no longer available there.
+        const context = await services.getWikiSource().getRequirementContext(pageReferences[0]);
+        if (!jsonOutput) {
+            const markdown = context.contentMarkdown;
+            process.stdout.write(markdown.endsWith("\n") ? markdown : `${markdown}\n`);
+            return;
+        }
+        process.stdout.write(`${JSON.stringify(context, null, 2)}\n`);
+    }
+    finally {
+        await writeRuntime.close();
+    }
+}
+main().catch((error) => {
+    process.stderr.write(`${JSON.stringify({
+        status: "error",
+        errorName: error instanceof Error ? error.name : typeof error,
+        errorMessage: error instanceof Error ? error.message : "未知錯誤",
+    })}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=inspect-wiki.js.map

package/dist/inspect-wiki.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface Logger {
+    debug(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    error(message: string, fields?: Record<string, unknown>): void;
+}
+export declare function createLogger(minimumLevel: LogLevel): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAY3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChE;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,QAAQ,GAAG,MAAM,CAsB3D"}

package/dist/logger.js

@@ -0,0 +1,40 @@
+const logLevelOrder = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+const sensitiveKeyPattern = /authorization|token|secret|client.?id|cookie|encryption.?key|redis.?url|approval.?token|idempotency.?key$|agent.?session.?id$|approval.?context.?id$/i;
+export function createLogger(minimumLevel) {
+    const write = (level, message, fields = {}) => {
+        if (logLevelOrder[level] < logLevelOrder[minimumLevel]) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...redact(fields),
+        };
+        process.stderr.write(`${JSON.stringify(entry)}\n`);
+    };
+    return {
+        debug: (message, fields) => write("debug", message, fields),
+        info: (message, fields) => write("info", message, fields),
+        warn: (message, fields) => write("warn", message, fields),
+        error: (message, fields) => write("error", message, fields),
+    };
+}
+function redact(value, key = "") {
+    if (sensitiveKeyPattern.test(key)) {
+        return "[REDACTED]";
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redact(item));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([childKey, childValue]) => [childKey, redact(childValue, childKey)]));
+    }
+    return value;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAA6B;IAC9C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,MAAM,mBAAmB,GACvB,uJAAuJ,CAAC;AAS1J,MAAM,UAAU,YAAY,CAAC,YAAsB;IACjD,MAAM,KAAK,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,SAAkC,EAAE,EAAE,EAAE;QACvF,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,OAAO;YACP,GAAI,MAAM,CAAC,MAAM,CAA6B;SAC/C,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;QAC3D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACzD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACzD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,GAAG,GAAG,EAAE;IACtC,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/mcp/create-server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../logger.js";
+import type { Services } from "../services.js";
+import type { WriteRuntime } from "../write/runtime.js";
+import type { WriteApprovalMode } from "./write-approval.js";
+export interface McpServerOptions {
+    writeApprovalMode?: WriteApprovalMode;
+}
+export declare function createMcpServer(services: Services, logger: Logger, writeRuntime: WriteRuntime, options?: McpServerOptions): McpServer;
+//# sourceMappingURL=create-server.d.ts.map

package/dist/mcp/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/mcp/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAuBX"}

package/dist/mcp/create-server.js

@@ -0,0 +1,40 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerWikiTools } from "./tools/wiki.js";
+import { registerTaskTools } from "./tools/task.js";
+import { registerTestCaseTools } from "./tools/test-case.js";
+import { registerTestCaseDeleteTools } from "./tools/test-case-delete.js";
+import { registerTestCaseBulkTools } from "./tools/test-case-bulk.js";
+import { registerSyncTools } from "./tools/sync.js";
+import { registerMetadataTools } from "./tools/metadata.js";
+import { registerShipTools } from "./tools/ship.js";
+import { registerProjectContextTools } from "./tools/project-context.js";
+import { registerProjectWriteTools } from "./tools/project.js";
+import { registerTestLibraryWriteTools } from "./tools/test-library.js";
+import { registerMemberRoleTools } from "./tools/member-role.js";
+import { registerRelationTools } from "./tools/relation.js";
+import { registerShipSuiteTools } from "./tools/ship-suite.js";
+import { registerRuntimeInfoTools } from "./tools/runtime-info.js";
+export function createMcpServer(services, logger, writeRuntime, options = {}) {
+    const server = new McpServer({
+        name: "pingcode-mcp",
+        version: "0.2.0",
+    });
+    const writeApprovalMode = options.writeApprovalMode ?? "approval_token";
+    registerRuntimeInfoTools(server, logger);
+    registerWikiTools(server, services, logger);
+    registerTaskTools(server, services, logger);
+    registerTestCaseTools(server, services, logger);
+    registerTestCaseDeleteTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerTestCaseBulkTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerMetadataTools(server, services, logger);
+    registerProjectContextTools(server, logger);
+    registerShipTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerShipSuiteTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerRelationTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerSyncTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerProjectWriteTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerTestLibraryWriteTools(server, services, logger, writeRuntime, writeApprovalMode);
+    registerMemberRoleTools(server, services, logger, writeRuntime, writeApprovalMode);
+    return server;
+}
+//# sourceMappingURL=create-server.js.map

package/dist/mcp/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/mcp/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAMnE,MAAM,UAAU,eAAe,CAC7B,QAAkB,EAClB,MAAc,EACd,YAA0B,EAC1B,UAA4B,EAAE;IAE9B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,gBAAgB,CAAC;IAExE,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,2BAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACvF,yBAAyB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACrF,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAC7E,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAClF,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACjF,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAC7E,yBAAyB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACrF,6BAA6B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACzF,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/pagination-guidance.d.ts

@@ -0,0 +1,19 @@
+export interface PaginationState {
+    pageIndex: number;
+    pageSize: number;
+    total: number;
+    returned: number;
+    keywords?: string;
+    searchable?: boolean;
+    fallbackFromKeywords?: string;
+}
+export interface KeywordFallbackResult<T> {
+    page: T;
+    keywords?: string;
+    fallbackFromKeywords?: string;
+}
+export declare function loadWithKeywordFallback<T extends {
+    total: number;
+}>(keywords: string | undefined, load: (keywords: string | undefined, resetPage: boolean) => Promise<T>): Promise<KeywordFallbackResult<T>>;
+export declare function paginationGuidance(state: PaginationState): string[];
+//# sourceMappingURL=pagination-guidance.d.ts.map

package/dist/mcp/pagination-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-guidance.d.ts","sourceRoot":"","sources":["../../src/mcp/pagination-guidance.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAsB,uBAAuB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACvE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GACrE,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CASnC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CA4BnE"}

package/dist/mcp/pagination-guidance.js

@@ -0,0 +1,36 @@
+export async function loadWithKeywordFallback(keywords, load) {
+    const page = await load(keywords, false);
+    if (keywords === undefined || page.total > 0) {
+        return { page, ...(keywords === undefined ? {} : { keywords }) };
+    }
+    return {
+        page: await load(undefined, true),
+        fallbackFromKeywords: keywords,
+    };
+}
+export function paginationGuidance(state) {
+    const offset = state.pageIndex * state.pageSize;
+    const hasReturnedRows = state.returned > 0 && offset < state.total;
+    const first = hasReturnedRows ? offset + 1 : 0;
+    const last = hasReturnedRows ? Math.min(offset + state.returned, state.total) : 0;
+    const hasMore = hasReturnedRows && last < state.total;
+    const lines = hasReturnedRows
+        ? [`当前页：第 ${state.pageIndex + 1} 页，显示 ${first}-${last}/${state.total} 条`]
+        : [`当前页：第 ${state.pageIndex + 1} 页，无结果（共 ${state.total} 条）`];
+    if (state.fallbackFromKeywords !== undefined) {
+        lines.push(`关键词「${state.fallbackFromKeywords}」当前没有匹配结果；依据 PingCode 分页语义仅额外读取了无关键词的第一页。该页不是关键词匹配结果，不得据此确认资源不存在或自动选择旧数据。新建资源可能尚未进入搜索索引，请优先使用创建响应的 ID 调用详情 Tool，稍后再按关键词检索。`);
+    }
+    if (hasMore) {
+        lines.push(`当前列表尚未显示全部结果；可使用 page_index=${state.pageIndex + 1} 加载更多。`);
+    }
+    if (state.searchable) {
+        lines.push(state.keywords !== undefined
+            ? `当前使用关键词「${state.keywords}」；如果没有想要的数据，可以修改关键词${hasMore ? "或加载更多" : ""}。`
+            : `如果当前列表没有想要的数据，可以提供 keywords 搜索${hasMore ? "或加载更多" : ""}。`);
+    }
+    else if (hasMore) {
+        lines.push("如果当前列表没有想要的数据，请加载更多后再判断是否存在。");
+    }
+    return lines;
+}
+//# sourceMappingURL=pagination-guidance.js.map

package/dist/mcp/pagination-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-guidance.js","sourceRoot":"","sources":["../../src/mcp/pagination-guidance.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAA4B,EAC5B,IAAsE;IAEtE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;QACjC,oBAAoB,EAAE,QAAQ;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChD,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;IACnE,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,eAAe,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,eAAe;QAC3B,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,GAAG,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC;QACzE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CACR,OAAO,KAAK,CAAC,oBAAoB,4HAA4H,CAC9J,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,SAAS,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,QAAQ,KAAK,SAAS;YAC1B,CAAC,CAAC,WAAW,KAAK,CAAC,QAAQ,sBAAsB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG;YAC1E,CAAC,CAAC,iCAAiC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAC/D,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/mcp/reference-resolution.d.ts

@@ -0,0 +1,19 @@
+import type { Services } from "../services.js";
+export interface ReferenceCandidate {
+    id: string;
+    name: string;
+    identifier?: string | null;
+    selectable?: boolean;
+}
+export declare function resolveCandidate(field: string, value: string | undefined, name: string | undefined, candidates: ReferenceCandidate[]): string | undefined;
+export declare function formatCandidates(candidates: ReferenceCandidate[]): string;
+export declare function namedField(value: string | undefined, name: string | undefined): {
+    value?: string;
+    name?: string;
+};
+export declare function resolveUserReference(field: string, value: string | undefined, name: string | undefined, services: Services): Promise<string | undefined>;
+export declare function resolveTeamReference(field: string, value: string | undefined, name: string | undefined, services: Services): Promise<string | undefined>;
+export declare function resolveProjectStageReference(field: string, value: string | undefined, name: string | undefined, services: Services): Promise<string | undefined>;
+export declare function resolveWorkItemReference(field: string, value: string | undefined, name: string | undefined, services: Services, projectId?: string): Promise<string | undefined>;
+export declare function resolveMetadataReference(field: string, value: string | undefined, name: string | undefined, values: unknown[]): Promise<string | undefined>;
+//# sourceMappingURL=reference-resolution.d.ts.map

package/dist/mcp/reference-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-resolution.d.ts","sourceRoot":"","sources":["../../src/mcp/reference-resolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,UAAU,EAAE,kBAAkB,EAAE,GAC/B,MAAM,GAAG,SAAS,CAmCpB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAWzE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAKnC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B;AAED,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B"}

package/dist/mcp/reference-resolution.js

@@ -0,0 +1,160 @@
+import { PingCodeError } from "../pingcode/errors.js";
+export function resolveCandidate(field, value, name, candidates) {
+    if (value === undefined && name === undefined) {
+        return undefined;
+    }
+    if (value !== undefined && name !== undefined) {
+        throw new PingCodeError(`${field} 的 ID 与名称不得同时提供；请保留名称或选择一个目录候选`, "BAD_REQUEST");
+    }
+    if (name !== undefined) {
+        const normalized = name.trim().toLocaleLowerCase();
+        const matches = candidates.filter((candidate) => candidate.selectable !== false && (candidate.name.trim().toLocaleLowerCase() === normalized
+            || candidate.identifier?.trim().toLocaleLowerCase() === normalized));
+        if (matches.length === 1 && matches[0]) {
+            return matches[0].id;
+        }
+        if (matches.length > 1) {
+            throw new PingCodeError(`${field} 名称「${name}」匹配多个候选：${formatCandidates(matches)}；请让用户选择一个候选`, "CONFLICT");
+        }
+        throw new PingCodeError(`${field} 名称「${name}」没有匹配结果。${formatCandidates(candidates)}；请修改名称或选择列表候选`, "NOT_FOUND");
+    }
+    const match = candidates.find((candidate) => candidate.selectable !== false && candidate.id === value);
+    if (match) {
+        return match.id;
+    }
+    throw new PingCodeError(`${field} ID「${value}」不在当前候选目录中。${formatCandidates(candidates)}；不要直接猜测或重试其他 ID`, "NOT_FOUND");
+}
+export function formatCandidates(candidates) {
+    if (candidates.length === 0) {
+        return "当前目录没有返回候选";
+    }
+    const visible = candidates.slice(0, 20).map((candidate) => {
+        const identifier = candidate.identifier ? `/${candidate.identifier}` : "";
+        return `${candidate.name}${identifier} (${candidate.id})`;
+    }).join("、");
+    return candidates.length > 20
+        ? `可选候选：${visible}；还有 ${candidates.length - 20} 个候选，请使用分页继续读取`
+        : `可选候选：${visible}`;
+}
+export function namedField(value, name) {
+    return {
+        ...(value === undefined ? {} : { value }),
+        ...(name === undefined ? {} : { name }),
+    };
+}
+export async function resolveUserReference(field, value, name, services) {
+    if (value === undefined && name === undefined)
+        return undefined;
+    const searched = name === undefined ? [] : await listAllUsers(services, name);
+    const exactMatches = name === undefined ? [] : searched.filter((candidate) => candidate.name.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase()
+        || candidate.identifier?.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase());
+    if (name !== undefined && exactMatches.length > 1) {
+        throw new PingCodeError(`${field} 名称「${name}」同时匹配多个用户（可能同时命中显示名称和账号）：${formatCandidates(exactMatches)}；请使用唯一账号或明确选择一个候选后再重试`, "CONFLICT");
+    }
+    if (name !== undefined && exactMatches.length === 1 && exactMatches[0]) {
+        return exactMatches[0].id;
+    }
+    const candidates = exactMatches.length > 1 ? exactMatches : searched.length > 0 ? searched : await listAllUsers(services);
+    return resolveCandidate(field, value, name, candidates);
+}
+export async function resolveTeamReference(field, value, name, services) {
+    if (value === undefined && name === undefined)
+        return undefined;
+    const loadTeams = async (keywords) => {
+        const candidates = [];
+        for (let pageIndex = 0; pageIndex < 100; pageIndex += 1) {
+            const page = await services.getMetadataSource().listTeams({ keywords, pageIndex, pageSize: 100 });
+            candidates.push(...page.values.map((team) => ({ id: team.id, name: team.name })));
+            if (candidates.length >= page.total || page.values.length === 0)
+                break;
+        }
+        return candidates;
+    };
+    const searched = await loadTeams(name?.trim());
+    const fallback = name !== undefined && searched.length === 0 ? await loadTeams() : searched;
+    const filtered = name === undefined ? fallback : fallback.filter((candidate) => candidate.name.trim().toLocaleLowerCase().includes(name.trim().toLocaleLowerCase()));
+    return resolveCandidate(field, value, name, filtered.length > 0 ? filtered : fallback);
+}
+export async function resolveProjectStageReference(field, value, name, services) {
+    if (value === undefined && name === undefined)
+        return undefined;
+    const candidates = [];
+    for (let pageIndex = 0; pageIndex < 100; pageIndex += 1) {
+        const page = await services.getMetadataSource().listProjectStages({ pageIndex, pageSize: 100 });
+        candidates.push(...page.values.map((stage) => ({ id: stage.id, name: stage.name })));
+        if (candidates.length >= page.total || page.values.length === 0)
+            break;
+    }
+    return resolveCandidate(field, value, name, candidates);
+}
+export async function resolveWorkItemReference(field, value, name, services, projectId) {
+    if (value === undefined && name === undefined)
+        return undefined;
+    const searched = name === undefined ? [] : await listAllWorkItems(services, name, projectId);
+    const exactMatches = name === undefined ? [] : searched.filter((candidate) => candidate.name.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase()
+        || candidate.identifier?.trim().toLocaleLowerCase() === name.trim().toLocaleLowerCase());
+    if (name !== undefined && exactMatches.length === 1 && exactMatches[0]) {
+        return exactMatches[0].id;
+    }
+    const candidates = exactMatches.length > 1
+        ? exactMatches
+        : searched.length > 0
+            ? searched
+            : await listAllWorkItems(services, undefined, projectId);
+    return resolveCandidate(field, value, name, candidates);
+}
+export async function resolveMetadataReference(field, value, name, values) {
+    return resolveCandidate(field, value, name, values.flatMap((item) => {
+        if (typeof item !== "object" || item === null)
+            return [];
+        const candidate = item;
+        return typeof candidate.id === "string" && typeof candidate.name === "string"
+            ? [{
+                    id: candidate.id,
+                    name: candidate.name,
+                    ...(typeof candidate.identifier === "string"
+                        ? { identifier: candidate.identifier }
+                        : typeof candidate.type === "string" && candidate.type.trim().length > 0
+                            ? { identifier: candidate.type }
+                            : {}),
+                }]
+            : [];
+    }));
+}
+async function listAllUsers(services, keywords) {
+    const candidates = [];
+    let pageIndex = 0;
+    for (let pageCount = 0; pageCount < 100; pageCount += 1) {
+        const page = await services.getMetadataSource().searchUsers({ keywords, pageIndex, pageSize: 100 });
+        candidates.push(...page.values.map((user) => ({
+            id: user.id,
+            name: user.display_name ?? user.name ?? "未命名用户",
+            identifier: user.name ?? null,
+        })));
+        if (candidates.length >= page.total || page.values.length === 0)
+            return deduplicateCandidates(candidates);
+        pageIndex = page.page_index + 1;
+    }
+    throw new PingCodeError("PingCode 用户目录超过安全扫描上限，无法解析用户", "RESPONSE_TOO_LARGE");
+}
+function deduplicateCandidates(candidates) {
+    return [...new Map(candidates.map((candidate) => [candidate.id, candidate])).values()];
+}
+async function listAllWorkItems(services, keywords, projectId) {
+    const candidates = [];
+    let pageIndex = 0;
+    for (let pageCount = 0; pageCount < 100; pageCount += 1) {
+        const page = await services.getTaskSource().listWorkItems({ keywords, projectId, pageIndex, pageSize: 100 });
+        candidates.push(...page.values.map((item) => ({
+            id: item.id,
+            name: item.title,
+            identifier: item.identifier,
+            selectable: item.is_deleted !== true && item.is_deleted !== 1,
+        })));
+        if (candidates.length >= page.total || page.values.length === 0)
+            return candidates;
+        pageIndex = page.pageIndex + 1;
+    }
+    throw new PingCodeError("PingCode 工作项目录超过安全扫描上限，无法解析父工作项", "RESPONSE_TOO_LARGE");
+}
+//# sourceMappingURL=reference-resolution.js.map