@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/sources/wiki-source.d.ts

@@ -0,0 +1,34 @@
+import { type WikiPage, type WikiSpace } from "../pingcode/schemas.js";
+import type { PingCodeClientLike } from "../pingcode/client.js";
+import type { RequirementContext } from "../domain/requirement-context.js";
+import type { RequirementSource } from "./requirement-source.js";
+export interface ListSpacesInput {
+    keywords?: string;
+    scopeType?: "organization" | "user_group" | "user";
+    scopeId?: string;
+    pageIndex?: number;
+    pageSize?: number;
+}
+export interface ListPagesInput {
+    spaceId?: string;
+    parentId?: string;
+    ancestorId?: string;
+    pageIndex?: number;
+    pageSize?: number;
+}
+export interface ListResult<T> {
+    pageSize: number;
+    pageIndex: number;
+    total: number;
+    values: T[];
+}
+export declare class WikiRequirementSource implements RequirementSource {
+    private readonly client;
+    private readonly now;
+    constructor(client: PingCodeClientLike, now?: () => Date);
+    listSpaces(input: ListSpacesInput): Promise<ListResult<WikiSpace>>;
+    listPages(input: ListPagesInput): Promise<ListResult<WikiPage>>;
+    getRequirementContext(pageReference: string): Promise<RequirementContext>;
+    private resolvePageId;
+}
+//# sourceMappingURL=wiki-source.d.ts.map

package/dist/sources/wiki-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-source.d.ts","sourceRoot":"","sources":["../../src/sources/wiki-source.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,CAAC,EAAE,CAAC;CACb;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;IAE3D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,MAAM,EAAE,kBAAkB,EAC1B,GAAG,GAAE,MAAM,IAAuB;IAG/C,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAalE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAe/D,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YA6CjE,aAAa;CA+B5B"}

package/dist/sources/wiki-source.js

@@ -0,0 +1,136 @@
+import { createHash } from "node:crypto";
+import { PingCodeError } from "../pingcode/errors.js";
+import { paginatedSchema, wikiPageContentSchema, wikiPageSchema, wikiSpaceSchema, } from "../pingcode/schemas.js";
+export class WikiRequirementSource {
+    client;
+    now;
+    constructor(client, now = () => new Date()) {
+        this.client = client;
+        this.now = now;
+    }
+    async listSpaces(input) {
+        const payload = await this.client.get("/v1/wiki/spaces", {
+            keywords: input.keywords,
+            scope_type: input.scopeType,
+            scope_id: input.scopeId,
+            include_deleted: false,
+            include_archived: false,
+            ...(input.pageIndex === undefined ? {} : { page_index: input.pageIndex }),
+            ...(input.pageSize === undefined ? {} : { page_size: input.pageSize }),
+        });
+        return mapList(paginatedSchema(wikiSpaceSchema).parse(payload));
+    }
+    async listPages(input) {
+        if (input.parentId && input.ancestorId) {
+            throw new PingCodeError("parentId 和 ancestorId 不能同時使用", "BAD_REQUEST");
+        }
+        const payload = await this.client.get("/v1/wiki/pages", {
+            space_id: input.spaceId,
+            parent_id: input.parentId,
+            ancestor_id: input.ancestorId,
+            page_index: input.pageIndex,
+            ...(input.pageSize === undefined ? {} : { page_size: input.pageSize }),
+        });
+        return mapList(paginatedSchema(wikiPageSchema).parse(payload));
+    }
+    async getRequirementContext(pageReference) {
+        const pageId = await this.resolvePageId(pageReference);
+        const [pagePayload, contentPayload] = await Promise.all([
+            this.client.get(`/v1/wiki/pages/${encodeURIComponent(pageId)}`),
+            this.client.get(`/v1/wiki/pages/${encodeURIComponent(pageId)}/content`, {
+                format_type: "markdown",
+            }),
+        ]);
+        const page = wikiPageSchema.parse(pagePayload);
+        const content = wikiPageContentSchema.parse(contentPayload);
+        if (content.format_type.toLowerCase() !== "markdown") {
+            throw new PingCodeError("PingCode 未以 Markdown 格式返回 Wiki 頁面", "INVALID_RESPONSE");
+        }
+        return {
+            source: {
+                type: "wiki",
+                id: page.id,
+                shortId: page.short_id ?? null,
+                url: page.html_url,
+                apiUrl: page.url,
+                spaceId: page.space.id,
+                spaceName: page.space.name,
+                updatedAt: page.updated_at ?? null,
+                retrievedAt: this.now().toISOString(),
+                contentHash: `sha256:${createHash("sha256").update(content.content, "utf8").digest("hex")}`,
+            },
+            title: page.name,
+            contentFormat: "markdown",
+            contentMarkdown: content.content,
+            parent: page.parent
+                ? {
+                    id: page.parent.id,
+                    title: page.parent.name,
+                    url: page.parent.html_url ?? null,
+                }
+                : null,
+            tags: (page.tags ?? []).map((tag) => ({ id: tag.id, name: tag.name })),
+            attachments: [],
+            relatedLinks: [],
+        };
+    }
+    async resolvePageId(pageReference) {
+        const normalizedReference = normalizePageReference(pageReference);
+        if (/^[0-9a-f]{24}$/i.test(normalizedReference)) {
+            return normalizedReference;
+        }
+        const matches = [];
+        let pageIndex = 0;
+        for (;;) {
+            const result = await this.listPages({ pageIndex });
+            matches.push(...result.values.filter((page) => page.short_id === normalizedReference));
+            const consumed = (result.pageIndex + 1) * result.pageSize;
+            if (consumed >= result.total || result.values.length === 0) {
+                break;
+            }
+            pageIndex = result.pageIndex + 1;
+        }
+        if (matches.length === 0) {
+            throw new PingCodeError(`找不到短 ID 為 '${normalizedReference}' 的可存取 PingCode Wiki 頁面`, "NOT_FOUND");
+        }
+        if (matches.length > 1) {
+            throw new PingCodeError(`有多個可存取的 PingCode Wiki 頁面使用短 ID '${normalizedReference}'`, "BAD_REQUEST");
+        }
+        return matches[0].id;
+    }
+}
+function normalizePageReference(pageReference) {
+    const normalized = pageReference.trim();
+    if (!normalized) {
+        throw new PingCodeError("pageReference 不能為空", "BAD_REQUEST");
+    }
+    if (!normalized.includes("://")) {
+        return normalized;
+    }
+    let url;
+    try {
+        url = new URL(normalized);
+    }
+    catch {
+        throw new PingCodeError("pageReference 不是有效的 Wiki 頁面 URL", "BAD_REQUEST");
+    }
+    const match = url.pathname.match(/\/wiki\/(?:spaces\/[^/]+\/)?pages\/([^/]+)\/?$/);
+    if (!match) {
+        throw new PingCodeError("pageReference URL 必須指向 PingCode Wiki 頁面", "BAD_REQUEST");
+    }
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        throw new PingCodeError("pageReference URL 包含無效的頁面識別碼", "BAD_REQUEST");
+    }
+}
+function mapList(input) {
+    return {
+        pageSize: input.page_size,
+        pageIndex: input.page_index,
+        total: input.total,
+        values: input.values,
+    };
+}
+//# sourceMappingURL=wiki-source.js.map

package/dist/sources/wiki-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-source.js","sourceRoot":"","sources":["../../src/sources/wiki-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,eAAe,GAGhB,MAAM,wBAAwB,CAAC;AA4BhC,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,MAA0B,EAC1B,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QADlC,WAAM,GAAN,MAAM,CAAoB;QAC1B,QAAG,GAAH,GAAG,CAA+B;IAClD,CAAC;IAEJ,KAAK,CAAC,UAAU,CAAC,KAAsB;QACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACvD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,eAAe,EAAE,KAAK;YACtB,gBAAgB,EAAE,KAAK;YACvB,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;YACzE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAqB;QACnC,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,aAAa,CAAC,8BAA8B,EAAE,aAAa,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE;YACtD,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,SAAS,EAAE,KAAK,CAAC,QAAQ;YACzB,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,aAAqB;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QAEvD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAAE;gBACtE,WAAW,EAAE,UAAU;aACxB,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,aAAa,CAAC,mCAAmC,EAAE,kBAAkB,CAAC,CAAC;QACnF,CAAC;QAED,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;gBAC9B,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,MAAM,EAAE,IAAI,CAAC,GAAG;gBAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBACtB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;gBAC1B,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;gBAClC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;gBACrC,WAAW,EAAE,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC5F;YACD,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,aAAa,EAAE,UAAU;YACzB,eAAe,EAAE,OAAO,CAAC,OAAO;YAChC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACjB,CAAC,CAAC;oBACE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;oBAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;oBACvB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI;iBAClC;gBACH,CAAC,CAAC,IAAI;YACR,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,aAAqB;QAC/C,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAChD,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,mBAAmB,CAAC,CAAC,CAAC;YAEvF,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC1D,IAAI,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM;YACR,CAAC;YACD,SAAS,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,aAAa,CAAC,cAAc,mBAAmB,yBAAyB,EAAE,WAAW,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,aAAa,CACrB,mCAAmC,mBAAmB,GAAG,EACzD,aAAa,CACd,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IACxB,CAAC;CACF;AAED,SAAS,sBAAsB,CAAC,aAAqB;IACnD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,aAAa,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,aAAa,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,aAAa,CAAC,yCAAyC,EAAE,aAAa,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,8BAA8B,EAAE,aAAa,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAI,KAKnB;IACC,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,SAAS;QACzB,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC"}

package/dist/sources/work-item-source.d.ts

@@ -0,0 +1,33 @@
+import type { WorkItemContext } from "../domain/work-item-context.js";
+import type { PingCodeClientLike } from "../pingcode/client.js";
+import { type WorkItem } from "../pingcode/schemas.js";
+import type { ListResult } from "./wiki-source.js";
+export interface ListWorkItemsInput {
+    identifier?: string;
+    projectId?: string;
+    typeId?: string;
+    parentId?: string;
+    assigneeId?: string;
+    stateId?: string;
+    priorityId?: string;
+    sprintId?: string;
+    versionId?: string;
+    planId?: string;
+    createdById?: string;
+    participantId?: string;
+    keywords?: string;
+    includePublicImageToken?: string;
+    includeDeleted?: boolean;
+    includeArchived?: boolean;
+    pageIndex?: number;
+    pageSize?: number;
+}
+export declare class WorkItemRequirementSource {
+    private readonly client;
+    private readonly now;
+    constructor(client: PingCodeClientLike, now?: () => Date);
+    listWorkItems(input: ListWorkItemsInput): Promise<ListResult<WorkItem>>;
+    getWorkItemContext(reference: string): Promise<WorkItemContext>;
+    private resolveWorkItemId;
+}
+//# sourceMappingURL=work-item-source.d.ts.map

package/dist/sources/work-item-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-source.d.ts","sourceRoot":"","sources":["../../src/sources/work-item-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAmC,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,MAAM,EAAE,kBAAkB,EAC1B,GAAG,GAAE,MAAM,IAAuB;IAG/C,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IA8BvE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YAwDvD,iBAAiB;CAgBhC"}

package/dist/sources/work-item-source.js

@@ -0,0 +1,159 @@
+import { createHash } from "node:crypto";
+import { PingCodeError } from "../pingcode/errors.js";
+import { paginatedSchema, workItemSchema } from "../pingcode/schemas.js";
+export class WorkItemRequirementSource {
+    client;
+    now;
+    constructor(client, now = () => new Date()) {
+        this.client = client;
+        this.now = now;
+    }
+    async listWorkItems(input) {
+        const payload = await this.client.get("/v1/project/work_items", {
+            identifier: input.identifier,
+            project_id: input.projectId,
+            type_id: input.typeId,
+            parent_id: input.parentId,
+            assignee_id: input.assigneeId,
+            state_id: input.stateId,
+            priority_id: input.priorityId,
+            sprint_id: input.sprintId,
+            version_id: input.versionId,
+            plan_id: input.planId,
+            created_by: input.createdById,
+            participant_id: input.participantId,
+            keywords: input.keywords,
+            include_public_image_token: input.includePublicImageToken,
+            page_index: input.pageIndex,
+            page_size: input.pageSize,
+            include_deleted: input.includeDeleted ?? false,
+            include_archived: input.includeArchived ?? false,
+        });
+        const parsed = paginatedSchema(workItemSchema).parse(payload);
+        return {
+            pageSize: parsed.page_size,
+            pageIndex: parsed.page_index,
+            total: parsed.total,
+            values: parsed.values,
+        };
+    }
+    async getWorkItemContext(reference) {
+        const workItemId = await this.resolveWorkItemId(reference);
+        const payload = await this.client.get(`/v1/project/work_items/${encodeURIComponent(workItemId)}`);
+        const workItem = workItemSchema.parse(payload);
+        return {
+            source: {
+                type: "task",
+                id: workItem.id,
+                identifier: workItem.identifier,
+                shortId: workItem.short_id ?? null,
+                url: workItem.html_url ?? workItem.url,
+                apiUrl: workItem.url,
+                projectId: workItem.project.id,
+                projectIdentifier: workItem.project.identifier,
+                projectName: workItem.project.name,
+                updatedAt: workItem.updated_at ?? null,
+                retrievedAt: this.now().toISOString(),
+                // Parent names are denormalized display data. Hash the parent identity
+                // but not its mutable title so renaming a parent does not invalidate a
+                // child's optimistic-lock token.
+                contentHash: `sha256:${createHash("sha256").update(stableJsonForContentHash(workItem), "utf8").digest("hex")}`,
+            },
+            title: workItem.title,
+            type: workItem.type,
+            description: workItem.description ?? null,
+            state: workItem.state
+                ? { id: workItem.state.id, name: workItem.state.name, type: workItem.state.type }
+                : null,
+            priority: workItem.priority ? { id: workItem.priority.id, name: workItem.priority.name } : null,
+            assignee: workItem.assignee
+                ? {
+                    id: workItem.assignee.id,
+                    name: workItem.assignee.name ?? null,
+                    displayName: workItem.assignee.display_name ?? null,
+                }
+                : null,
+            parent: workItem.parent
+                ? {
+                    id: workItem.parent.id,
+                    identifier: workItem.parent.identifier,
+                    title: workItem.parent.title,
+                    type: workItem.parent.type,
+                    url: workItem.parent.url,
+                }
+                : null,
+            sprint: workItem.sprint ? { id: workItem.sprint.id, name: workItem.sprint.name } : null,
+            version: workItem.version ? { id: workItem.version.id, name: workItem.version.name } : null,
+            tags: (workItem.tags ?? []).map((tag) => ({ id: tag.id, name: tag.name })),
+            startAt: workItem.start_at ?? null,
+            endAt: workItem.end_at ?? null,
+            completedAt: workItem.completed_at ?? null,
+            properties: workItem.properties ?? {},
+        };
+    }
+    async resolveWorkItemId(reference) {
+        const normalizedReference = normalizeWorkItemReference(reference);
+        if (/^[0-9a-f]{24}$/i.test(normalizedReference)) {
+            return normalizedReference;
+        }
+        const result = await this.listWorkItems({ identifier: normalizedReference, pageSize: 2 });
+        const matches = result.values.filter((workItem) => workItem.identifier === normalizedReference);
+        if (matches.length === 0) {
+            throw new PingCodeError(`找不到編號為 '${normalizedReference}' 的可存取 PingCode 工作項目`, "NOT_FOUND");
+        }
+        if (matches.length > 1) {
+            throw new PingCodeError(`有多個可存取的 PingCode 工作項目使用編號 '${normalizedReference}'`, "BAD_REQUEST");
+        }
+        return matches[0].id;
+    }
+}
+function normalizeWorkItemReference(reference) {
+    const normalized = reference.trim();
+    if (!normalized) {
+        throw new PingCodeError("workItemReference 不能為空", "BAD_REQUEST");
+    }
+    if (!normalized.includes("://")) {
+        return normalized;
+    }
+    let url;
+    try {
+        url = new URL(normalized);
+    }
+    catch {
+        throw new PingCodeError("workItemReference 不是有效的工作項目 URL", "BAD_REQUEST");
+    }
+    const match = url.pathname.match(/\/(?:project\/)?work_items\/([^/]+)\/?$/);
+    if (!match) {
+        throw new PingCodeError("workItemReference URL 必須指向 PingCode 工作項目 API", "BAD_REQUEST");
+    }
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        throw new PingCodeError("workItemReference URL 包含無效的工作項目識別碼", "BAD_REQUEST");
+    }
+}
+function stableJson(value) {
+    return JSON.stringify(sortJson(value));
+}
+function stableJsonForContentHash(workItem) {
+    const snapshot = {
+        ...workItem,
+        parent: workItem.parent
+            ? { id: workItem.parent.id, identifier: workItem.parent.identifier, type: workItem.parent.type }
+            : workItem.parent,
+    };
+    return stableJson(snapshot);
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortJson);
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nestedValue]) => [key, sortJson(nestedValue)]));
+    }
+    return value;
+}
+//# sourceMappingURL=work-item-source.js.map

package/dist/sources/work-item-source.js.map

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