meeglesdk 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.2 - 2026-07-11
+
+### Added
+
+- Added OpenAPI request-field drift checks to the release gate, with scanned endpoint configuration kept in `scripts/openapi-field-targets.json`.
+- Added a local OpenAPI docs snapshot gate so release and CI fail when `Meego-API-docs` markdown changes without a reviewed snapshot refresh.
+- Expanded OpenAPI request-field drift coverage from 20 to 38 request bodies, including search, attachment deletion, transition, review, deliverable, field option, operation record, and compound-field update APIs.
+- Expanded OpenAPI field drift coverage to higher-risk write APIs, including batch update, comments, subtasks, work hours, and custom fields.
+- Added manifest self-checks and reusable structure-field drift checks against `Meego-API-docs/数据结构汇总.md`, so release gating now validates both endpoint request bodies and selected shared data structures.
+- Split response-only SDK fields out of `FieldValuePair`, `RoleOwner`, and `Schedule`, and made endpoint-specific expand options independent of the shared `ExpandParams` structure.
+- Expanded reusable structure drift coverage to field config/value, search filters, relation details, transition-required info, workflow status, and delivery-related structures.
+- Added a response model boundary check to keep main work item, workflow, resource, and WBS draft response models on response-specific field, role, and schedule types.
+- Added an optional real resource fixture integration check for successful `ResourceWorkItemDetail` response models without creating unremovable resource instances by default.
+
+### Fixed
+
+- Aligned documented `work_item_id` request and response fields with the Meego MCP `int64` type, while preserving string-compatible URL path parameters where the Path table still documents `work_item_id` as `string`.
+- Aligned real integration behavior for generic file upload and universal search: `uploadFile` now returns the platform URL array, and universal search parses the platform `data` payload with pagination.
+
 ## 0.2.0 - 2026-05-10
 
 ### Added
@@ -18,4 +37,3 @@
 
 - Prepared `meeglesdk@0.2.0` for npm publication.
 - Added `release:check` and `prepublishOnly` so npm publishing runs typecheck, unit tests, and build first.
-

package/README.md

@@ -174,6 +174,29 @@ const options = await client.workItem.getFieldOptions({
 });
 ```
 
+## Work Item Workflow Query
+
+```ts
+const workflow = await client.workItem.workflow.query(
+  'project_key',
+  'story',
+  123456,
+  {
+    fields: ['priority', 'description'],
+    flow_type: 0,
+    expand: {
+      need_user_detail: true,
+      need_sub_task_parent: true,
+      need_rich_text_mark_down: true,
+      need_sub_workitem_detail: true,
+    },
+  },
+  { auth: { type: 'plugin', userKey: 'user_key' } }
+);
+
+console.log(workflow.workflow_nodes);
+```
+
 ## Compound Field Values
 
 ```ts
@@ -186,6 +209,26 @@ await client.workItem.updateCompoundFieldValue({
 });
 ```
 
+## Create Instance from Resource
+
+```ts
+const created = await client.config.resource.createInstanceFromResource(
+  'project_key',
+  872360000,
+  {
+    work_item_type_key: 'story',
+    name: '校验必填创建实例',
+    required_mode: 1,
+    field_value_pairs: [
+      { field_key: 'description', field_value: '测试描述' },
+    ],
+  },
+  { auth: { type: 'plugin', userKey: 'user_key' } }
+);
+
+console.log(created.work_item_id);
+```
+
 ## WBS View (Query + Body)
 
 ```ts
@@ -356,6 +399,54 @@ const next = await client.workItem.search.universalSearch(
 );
 ```
 
+## Generic File Upload
+
+```ts
+const urls = await client.workItem.attachment.uploadFile(
+  'project_key',
+  { file: new Blob(['hello'], { type: 'text/plain' }), fileName: 'hello.txt' },
+  { auth: { type: 'plugin', userKey: 'user_key' } }
+);
+
+const firstUrl = urls[0];
+```
+
+## Release and OpenAPI Checks
+
+```bash
+# Build dist, verify npm pack contents, and compile package-name import examples.
+bun run release:artifacts
+
+# Compare selected OpenAPI request body fields with the TS SDK request types.
+bun run openapi:field-diff
+
+# Emit the same scan as JSON for CI/report consumers.
+bun run openapi:field-report
+
+# Refresh the local OpenAPI docs snapshot after intentionally updating Meego-API-docs.
+bun run openapi:snapshot:update
+
+# Verify the local OpenAPI docs mirror has not changed without a reviewed snapshot update.
+bun run openapi:snapshot:check
+
+# Validate the scan manifest before running the diff.
+bun run openapi:field-targets:check
+
+# Same diff scan, but exits non-zero when differences are found.
+bun run openapi:field-check
+
+# Verify response models keep response-only fields out of shared request structures.
+bun run response-model-check
+```
+
+The OpenAPI docs snapshot pins the local `Meego-API-docs` markdown mirror by path, byte size, line count, and SHA-256 digest. Non-markdown files such as `.DS_Store` are ignored. When the mirror is intentionally refreshed, review SDK impact first, then run `bun run openapi:snapshot:update` and commit the snapshot diff.
+
+The OpenAPI field scan reads the local `Meego-API-docs` mirror and reports the exact document path used for each target. It checks two source classes: endpoint request bodies from their API pages, and reusable SDK structures from `Meego-API-docs/数据结构汇总.md`. It currently covers 38 selected request bodies across work item, workflow, search, resource, review, attachment deletion, comment, subtask, work hour, batch update, compound-field update, field option, operation record, deliverable, and custom field APIs, plus shared structures such as expand params, field configs, field value pairs, role owners, schedules, search filters, relation details, transition-required info, work hour records, node schedule constraint rules, team options, number config, and user detail.
+
+Add or remove scanned targets in `scripts/openapi-field-targets.json`; the checker reads that manifest instead of keeping endpoint config in code. `bun run openapi:field-targets:check` validates the manifest shape, referenced docs, structure headings, and SDK type declarations. `bun run release:check` runs `openapi:snapshot:check` and `openapi:field-check`, so npm publish and CI fail when the local OpenAPI mirror changes without a reviewed snapshot update or SDK fields drift from that mirror.
+
+Shared request structures stay aligned to `数据结构汇总.md`. Response-only additions use explicit response types such as `FieldValuePairResponse`, `RoleOwnerResponse`, and `ScheduleResponse`; endpoint-specific expand options use endpoint-specific types such as `QueryWorkItemExpand` and `WorkflowQueryExpand`. `response-model-check` keeps the main work item, workflow, resource, and WBS draft response models on those response-specific types.
+
 ## Services Overview
 
 Top-level services:
@@ -384,6 +475,8 @@ bun test
 
 Network access is required.
 
+The resource detail success-path check is fixture-based because the public OpenAPI mirror does not expose a resource-instance delete endpoint. Set `TEST_RESOURCE_WORK_ITEM_TYPE_KEY` and `TEST_RESOURCE_WORK_ITEM_ID` to validate a real resource detail response without creating new resource instances.
+
 ## Unit Tests (Edge Cases)
 
 Unit tests mock network calls and focus on request parsing, retries, and token caching.

package/RELEASE.md

@@ -5,8 +5,8 @@ This document is the npm release checklist for `meeglesdk`.
 ## Current Release
 
 - Package: `meeglesdk`
-- Version: `0.2.0`
-- Registry latest checked before release: `0.1.8`
+- Version: `0.2.2`
+- Registry latest checked before release: `0.2.1`
 - Runtime requirement: Node.js 18+
 - Development runtime: Bun 1.3+
 
@@ -37,12 +37,15 @@ This document is the npm release checklist for `meeglesdk`.
 
    ```bash
    npm view meeglesdk version dist-tags --json
-   npm view meeglesdk@0.2.0 dist.tarball
+   npm view meeglesdk@0.2.2 dist.tarball
    ```
 
 ## Notes
 
 - If `npm whoami` returns `E401`, run `npm login` or configure an npm token before publishing.
-- `prepublishOnly` runs the release gate automatically during `npm publish`.
+- `release:check` and `prepublishOnly` run the OpenAPI field check before tests/build, so SDK request fields and selected reusable structures must match the local OpenAPI mirror before publishing.
+- `release:check` first verifies `scripts/openapi-docs-snapshot.json`, so local `Meego-API-docs` mirror changes must be reviewed and committed with a refreshed snapshot before publishing.
+- `openapi:field-check` first validates `scripts/openapi-field-targets.json`, including referenced docs, `数据结构汇总.md` headings, and SDK type declarations.
+- `release:check` also runs `response-model-check`, so response-only fields stay on explicit response types instead of leaking back into shared request structures.
+- The TypeScript SDK GitHub Actions workflow runs the same `release:check` gate for SDK or OpenAPI doc changes.
 - The npm package includes `dist/`, `CHANGELOG.md`, `RELEASE.md`, and npm's always-included package metadata and README.
-

package/dist/index.d.ts

@@ -58,15 +58,15 @@ export { withAuth, withUserKey, withUserToken, withPluginToken } from './helpers
 export { parseDocImages, extractImagesFromMultiTexts, inferImageMimeType, type RichTextImage, } from './helpers/richtext.js';
 export { calculateEventSignature, verifyEventSignature, calculateEventSignatureSync, verifyEventSignatureSync, getEventCategory, getEventName, isListenEvent, isInterceptEvent, createInterceptResponse, } from './helpers/event.js';
 export type { QueryWorkItemOptions } from './service/workitem/workItem.js';
-export type { Logger, ApiResponse, AuthApiResponse, ErrorDetail, PaginationParams, SearchAfterPagination, SearchAfterPaginatedResult, PagedWorkItemIds, FieldUpdateMode, FieldValuePair, TargetState, FieldConf, DefaultValue, OptionConf, RoleAssign, SimpleField, Option, FieldValue, RoleOwner, Schedule, TimeInterval, ExpandParams, UserDetail, Connection, MultiText, MultiTextDetail, RichText, } from './types/common.js';
+export type { Logger, ApiResponse, AuthApiResponse, ErrorDetail, PaginationParams, SearchAfterPagination, SearchAfterPaginatedResult, PagedWorkItemIds, FieldUpdateMode, FieldValuePair, FieldValuePairResponse, TargetState, FieldConf, DefaultValue, OptionConf, RoleAssign, SimpleField, Option, FieldValue, RoleOwner, RoleOwnerResponse, Schedule, ScheduleResponse, TimeInterval, ExpandParams, UserDetail, Connection, MultiText, MultiTextDetail, RichText, } from './types/common.js';
 export type { UserStatus, UserNameMap, UserInfo, GetUserDetailRequest, SearchUsersRequest, UserGroupType, MutableUserGroupType, CreateUserGroupRequest, CreateUserGroupResponse, UpdateUserGroupMembersRequest, QueryUserGroupMembersRequest, UserGroupInfo, UserGroupMembersPage, } from './types/user.js';
-export type { FlowMode, RoleInfo, ResourceLibSetting, WorkItemTypeBasicConfig, UpdateWorkItemTypeConfigRequest, FieldAllRequest, TeamDataScope, TeamOption, NumberSymbolSetting, NumberConfig, CreateCustomFieldRequest, UpdateCustomFieldRequest, RelationDetail, WorkItemRelation, CreateWorkItemRelationRequest, CreateWorkItemRelationResponse, UpdateWorkItemRelationRequest, DeleteWorkItemRelationRequest, RoleAppearMode, MemberAssignMode, FlowRoleWritableMemberAssignMode, RoleLockScope, FlowRoleInfo, FlowRoleRequest, FlowRoleUpdateRequest, CreateFlowRoleRequest, UpdateFlowRoleRequest, DeleteFlowRoleRequest, TemplateAction, TemplateDisabled, WorkflowOwnerUsageMode, WorkflowVisibilityUsageMode, WorkflowPassMode, WorkflowTaskPassMode, WorkflowTaskRequiredMode, StateFlowStateType, TaskConf, WorkflowSubWorkItem, WorkflowSubTask, WorkflowConf, StateFlowConf, TemplateConf, TemplateDetail, TemplateCreateRequest, TemplateCreateResponse, TemplateUpdateRequest, TemplateOperateRequest, ResourceId, ResourceUserDetail, ResourceQueryRequest, ResourceTemplateInfo, ResourceRoleOwner, ResourceWorkItemDetail, ResourceQueryResponse, ResourceCreateRequest, ResourceCreateResponse, ResourceUpdateRequest, ResourceCreateInstanceRequest, ResourceCreateInstanceResponseData, ResourceSearchDataSource, ResourceSearchPaginationRequest, ResourceSearchPagination, ResourceOperateRequest, ResourceSearchParamsRequest, ResourceSearchParamsResponse, } from './types/config.js';
+export type { FlowMode, RoleInfo, ResourceLibSetting, WorkItemTypeBasicConfig, UpdateWorkItemTypeConfigRequest, FieldAllRequest, TeamDataScope, TeamOption, NumberSymbolSetting, NumberConfig, CreateCustomFieldRequest, UpdateCustomFieldRequest, RelationDetail, WorkItemRelation, CreateWorkItemRelationRequest, CreateWorkItemRelationResponse, UpdateWorkItemRelationRequest, DeleteWorkItemRelationRequest, RoleAppearMode, MemberAssignMode, FlowRoleWritableMemberAssignMode, RoleLockScope, FlowRoleInfo, FlowRoleRequest, FlowRoleUpdateRequest, CreateFlowRoleRequest, UpdateFlowRoleRequest, DeleteFlowRoleRequest, TemplateAction, TemplateDisabled, WorkflowOwnerUsageMode, WorkflowVisibilityUsageMode, WorkflowPassMode, WorkflowTaskPassMode, WorkflowTaskRequiredMode, StateFlowStateType, TaskConf, WorkflowSubWorkItem, WorkflowSubTask, WorkflowConf, StateFlowConf, TemplateConf, TemplateDetail, TemplateCreateRequest, TemplateCreateResponse, TemplateUpdateRequest, TemplateOperateRequest, ResourceId, ResourceUserDetail, ResourceQueryExpand, ResourceQueryRequest, ResourceTemplateInfo, ResourceRoleOwner, ResourceWorkItemDetail, ResourceQueryResponse, ResourceCreateRequest, ResourceCreateResponse, ResourceUpdateRequest, ResourceCreateInstanceRequest, ResourceCreateInstanceResponseData, ResourceSearchDataSource, ResourceSearchPaginationRequest, ResourceSearchPagination, ResourceOperateRequest, ResourceSearchParamsRequest, ResourceSearchParamsResponse, } from './types/config.js';
 export type { TenantInfo, GetTenantInfoRequest, TenantEntitlement, GetTenantEntitlementRequest, TenantInstallProjectsResponse, TenantProductInfo, TenantProductPrice, TenantRichText, } from './types/tenant.js';
 export type { ViewType, ViewSystemFlag, ViewAuthStatus, ViewCooperationMode, ViewQuickFilter, ViewCreatedAtRange, ViewConfListRequest, SearchViewByTitleRequest, ViewConfInfo, FixViewInfo, FixViewQueryParams, PanoramicViewQueryParams, CreateFixViewRequest, UpdateFixViewRequest, CreateConditionViewRequest, UpdateConditionViewRequest, CreateConditionViewResponse, } from './types/view.js';
 export type { MeasureChartDataItem, MeasureChartData, MeasureChartsByViewRequest, MeasureChartsByViewPageOptions, MeasureChartSummary, MeasureChartsPagination, MeasureChartsByViewData, } from './types/measure.js';
 export type { ListProjectsRequest, GetProjectDetailRequest, ProjectDetail, ProjectDetailMap, BusinessLine, WorkItemTypeInfo, TeamInfo, RelationRulesRequest, ProjectRelationRule, RelationRule, RelationWorkItemListRequest, RelationInstance, BindRelationRequest, UnbindRelationRequest, } from './types/space.js';
 export type { SearchGroup, SearchParam, SearchOperator, SearchUser, SearchConjunction, PreOperator, UniversalSearchPaginationRequest, UniversalSearchPagination, FilterWorkItemsRequest, FilterWorkItemsAcrossProjectRequest, SearchWorkItemsByParamsRequest, SearchByRelationRequest, CompositiveSearchRequest, UniversalSearchRequest, UniversalSearchResponse, } from './types/workitem.js';
-export type { WorkItemPattern, NodeStatus, OwnerUsageMode, WorkItemStatus, WorkItemStatusHistory, StateTime, CurrentNode, WorkflowNode, StateFlowNode, WorkflowInfo, WorkItem, WorkItemInfo, QueryWorkItemExpand, QueryWorkItemRequest, WorkItemCreateRequiredMode, WorkItemCreateRoleMode, CreateWorkItemRequest, UpdateWorkItemRequest, FreezeWorkItemRequest, GetWorkItemMetaResponse, GetOperationRecordsRequest, GetOperationRecordsResponse, GetFieldOptionsRequest, GetFieldOptionsResponse, UpdateCompoundFieldValueRequest, WbsViewQueryParams, WbsViewExpand, WbsViewRequest, WbsViewRelatedSubWorkItem, WbsViewResponse, QueryWbsDraftRequest, CreateWbsDraftRequest, CreateWbsDraftResponse, ResetWbsDraftRequest, ResetWbsDraftResponse, PublishWbsDraftRequest, PublishWbsDraftResponse, CompleteCreateAuditDraftRequest, UpdateWbsDraftFrozenRowsRequest, PublishWbsDraftByCommitRequest, SwitchBackWbsDraftRequest, CreateWbsDraftProgressRequest, CreateWbsDraftProgressResponse, PatchWbsDraftProgressRequest, PatchWbsDraftProgressResponse, PublishWbsDraftProgressRequest, PublishWbsDraftProgressResponse, ResetWbsDraftProgressRequest, ResetWbsDraftProgressResponse, WbsDraftCurrentRow, WbsDraftStructure, WbsRowFieldMark, QueryWbsDraftStructureRequest, QueryWbsDraftStructureResponse, WbsDraftRowDetail, WbsDraftRowDetailMeta, WbsDraftRowDetailBase, WbsRowDetailType, WbsOwnerAssignType, WbsOwnerCandidateScopeType, WbsScheduleDependencyType, WbsDependencyType, WbsDependencySourceType, WbsProcessStatus, WbsSubInstanceDismantleMode, WbsRelationChainItemType, QueryWbsDraftRowDetailRequest, QueryWbsDraftRowDetailResponse, WbsDraftTaskConf, WbsDraftTaskConfWorkItemTypeInfo, QueryWbsDraftRowConfigRequest, QueryWbsDraftRowConfigResponse, QueryWbsViewStructureRequest, QueryWbsViewStructureResponse, QueryWbsViewRowDetailRequest, QueryWbsViewRowDetailResponse, QueryWbsInstanceExpand, QueryWbsInstanceExpandInfoRequest, QueryWbsInstanceExpandInfoResponse, GetWbsDraftSubWorkItemConfRequest, WbsDraft, WbsDraftWorkItem, WbsDraftOwnerConf, WbsDraftNodeRoleOwners, WbsDraftUnionDeliverable, WbsDraftFieldDeliverableItem, WbsDraftInstanceDeliverableItem, WbsDraftDependencyInfo, WbsDraftScheduleReferenceValue, WbsDraftOrderInfo, WbsDraftSeqOrderInfo, WbsDraftSubWorkItemConf, WbsDraftSubWorkItemConfRelation, PatchWbsDraftRequest, PatchWbsDraftResponse, WbsDraftSuccessResponse, WbsDraftOperation, WbsDraftPatchOperationValue, WbsDraftAssigneeType, WbsDraftValueRef, WbsDraftScheduleDateRange, WbsDraftAssigneeSchedule, WbsDraftAssigneeActualTime, WbsDraftWholeSchedule, WbsDraftActualTime, WbsDraftRoleOwnersValue, WbsDraftFieldDeliverableValue, WbsDraftInstanceDeliverableValue, TransitionRequiredInfoRequest, TransitionRequiredInfo, FlowType, WorkflowQueryExpand, WorkflowQueryRequest, StateChangeRequest, NodeOperateRequest, ScheduleConstraintRule, UpdateNodeRequest, BatchUpdateRequest, BatchUpdateResponse, DeliverableBatchQueryRequest, BotJoinChatRequest, UploadAttachmentRequest, UploadFileRequest, DownloadAttachmentRequest, DeleteAttachmentFieldSelector, DeleteAttachmentRequest, CreateSubtaskRequest, UpdateSubtaskRequest, CompleteRollbackSubtaskRequest, SubtaskStatus, SubTask, NodeTask, GetSubtasksQuery, SearchSubtasksRequest, Comment, CommentRichText, RichTextAttrs, RichTextLineAttrs, RichTextTableCell, RichTextTableInfo, RichTextElement, CommentContentRequest, CreateCommentRequest, UpdateCommentRequest, ListCommentsQuery, } from './types/workitem.js';
+export type { WorkItemPattern, NodeStatus, OwnerUsageMode, WorkItemStatus, WorkItemStatusHistory, StateTime, CurrentNode, WorkflowNode, StateFlowNode, WorkflowInfo, WorkItem, WorkItemInfo, QueryWorkItemExpand, QueryWorkItemRequest, WorkItemCreateRequiredMode, WorkItemCreateRoleMode, CreateWorkItemRequest, UpdateWorkItemRequest, FreezeWorkItemRequest, GetWorkItemMetaResponse, GetOperationRecordsRequest, GetOperationRecordsResponse, GetFieldOptionsRequest, GetFieldOptionsResponse, UpdateCompoundFieldValueRequest, WbsViewQueryParams, WbsViewExpand, WbsViewRequest, WbsViewRelatedSubWorkItem, WbsViewResponse, QueryWbsDraftRequest, CreateWbsDraftRequest, CreateWbsDraftResponse, ResetWbsDraftRequest, ResetWbsDraftResponse, PublishWbsDraftRequest, PublishWbsDraftResponse, CompleteCreateAuditDraftRequest, UpdateWbsDraftFrozenRowsRequest, PublishWbsDraftByCommitRequest, SwitchBackWbsDraftRequest, CreateWbsDraftProgressRequest, CreateWbsDraftProgressResponse, PatchWbsDraftProgressRequest, PatchWbsDraftProgressResponse, PublishWbsDraftProgressRequest, PublishWbsDraftProgressResponse, ResetWbsDraftProgressRequest, ResetWbsDraftProgressResponse, WbsDraftCurrentRow, WbsDraftStructure, WbsRowFieldMark, QueryWbsDraftStructureRequest, QueryWbsDraftStructureResponse, WbsDraftRowDetail, WbsDraftRowDetailMeta, WbsDraftRowDetailBase, WbsRowDetailType, WbsOwnerAssignType, WbsOwnerCandidateScopeType, WbsScheduleDependencyType, WbsDependencyType, WbsDependencySourceType, WbsProcessStatus, WbsSubInstanceDismantleMode, WbsRelationChainItemType, QueryWbsDraftRowDetailRequest, QueryWbsDraftRowDetailResponse, WbsDraftTaskConf, WbsDraftTaskConfWorkItemTypeInfo, QueryWbsDraftRowConfigRequest, QueryWbsDraftRowConfigResponse, QueryWbsViewStructureRequest, QueryWbsViewStructureResponse, QueryWbsViewRowDetailRequest, QueryWbsViewRowDetailResponse, QueryWbsInstanceExpand, QueryWbsInstanceExpandInfoRequest, QueryWbsInstanceExpandInfoResponse, GetWbsDraftSubWorkItemConfRequest, WbsDraft, WbsDraftWorkItem, WbsDraftOwnerConf, WbsDraftNodeRoleOwners, WbsDraftUnionDeliverable, WbsDraftFieldDeliverableItem, WbsDraftInstanceDeliverableItem, WbsDraftDependencyInfo, WbsDraftScheduleReferenceValue, WbsDraftOrderInfo, WbsDraftSeqOrderInfo, WbsDraftSubWorkItemConf, WbsDraftSubWorkItemConfRelation, PatchWbsDraftRequest, PatchWbsDraftResponse, WbsDraftSuccessResponse, WbsDraftOperation, WbsDraftPatchOperationValue, WbsDraftAssigneeType, WbsDraftValueRef, WbsDraftScheduleDateRange, WbsDraftAssigneeSchedule, WbsDraftAssigneeActualTime, WbsDraftWholeSchedule, WbsDraftActualTime, WbsDraftRoleOwnersValue, WbsDraftFieldDeliverableValue, WbsDraftInstanceDeliverableValue, TransitionRequiredInfoRequest, TransitionRequiredInfo, FlowType, WorkflowQueryExpand, WorkflowQueryRequest, StateChangeRequest, NodeOperateRequest, ScheduleConstraintRule, AddSubWorkitemsRequest, UpdateNodeRequest, BatchUpdateRequest, BatchUpdateResponse, DeliverableBatchQueryRequest, BotJoinChatRequest, UploadAttachmentRequest, UploadFileRequest, UploadFileResponse, DownloadAttachmentRequest, DeleteAttachmentFieldSelector, DeleteAttachmentRequest, CreateSubtaskRequest, UpdateSubtaskRequest, CompleteRollbackSubtaskRequest, SubtaskStatus, SubTask, NodeTask, GetSubtasksQuery, SearchSubtasksRequest, Comment, CommentRichText, RichTextAttrs, RichTextLineAttrs, RichTextTableCell, RichTextTableInfo, RichTextElement, CommentContentRequest, CreateCommentRequest, UpdateCommentRequest, ListCommentsQuery, } from './types/workitem.js';
 export type { WorkHourResourceType, CreateWorkingHourRecord, CreateWorkHourRecordRequest, UpdateWorkingHourRecord, UpdateWorkHourRecordRequest, DeleteWorkHourRecordRequest, ListWorkHourRecordsRequest, WorkHourRecord, ReviewConclusionOptionItem, ReviewOwnerOpinionInfo, ReviewOpinionInfo, ReviewOwnerConclusionInfo, ReviewSummaryMode, ReviewConclusionInfo, ReviewFinishedInfoItem, ReviewBatchQueryRequest, ReviewBatchQueryResponse, ReviewConclusionOptionRequest, ReviewConclusionOption, ReviewOperationType, UpdateReviewRequest, WorkItemWithImages, } from './types/workitem.js';
 export type { GetPluginTokenRequest, GetPluginTokenResponseData, GetUserTokenRequest, GetUserTokenResponseData, RefreshUserTokenRequest, RefreshUserTokenResponseData, UserTokenInput, TokenInfo, TokenType, } from './types/auth.js';
 export type { AINodeStatus, AINodeNodeState, AINodeFieldValue, AINodeField, AINodeCustomPropertyType, AINodeCustomProperty, AINodePropValue, AINodeProp, AINodeAppIdentity, AINodeInfo, AINodeSubTask, AINodeSubWorkItem, AINodeLocator, AINodeQueryRequestBase, AINodeQueryRequest, AINodeEditRequestBase, AINodeEditRequest, AINodeEditField, AINodeConfirmRequestBase, AINodeConfirmRequest, AINodeQueryResponse, } from './types/ainode.js';

package/dist/service/config/resource.d.ts

@@ -53,6 +53,19 @@ export declare class ConfigResourceService extends BaseService {
      * @param workItemId 资源工作项 ID
      * @param request 创建请求
      * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * const created = await client.config.resource.createInstanceFromResource('my-project', 872360000, {
+     *   work_item_type_key: 'story',
+     *   name: '校验必填创建实例',
+     *   required_mode: 1,
+     *   field_value_pairs: [
+     *     { field_key: 'description', field_value: '测试描述' },
+     *   ],
+     * });
+     * console.log(created.work_item_id);
+     * ```
      */
     createInstanceFromResource(projectKey: string, workItemId: ResourceId, request: ResourceCreateInstanceRequest, options?: ServiceRequestOptions<ResourceCreateInstanceResponseData>): Promise<ResourceCreateInstanceResponseData>;
 }

package/dist/service/config/resource.js

@@ -64,6 +64,19 @@ export class ConfigResourceService extends BaseService {
      * @param workItemId 资源工作项 ID
      * @param request 创建请求
      * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * const created = await client.config.resource.createInstanceFromResource('my-project', 872360000, {
+     *   work_item_type_key: 'story',
+     *   name: '校验必填创建实例',
+     *   required_mode: 1,
+     *   field_value_pairs: [
+     *     { field_key: 'description', field_value: '测试描述' },
+     *   ],
+     * });
+     * console.log(created.work_item_id);
+     * ```
      */
     async createInstanceFromResource(projectKey, workItemId, request, options) {
         return this.post(API_PATHS.CREATE_INSTANCE_FROM_RESOURCE, request, {

package/dist/service/workitem/attachment.d.ts

@@ -5,7 +5,7 @@
  * 提供附件的上传、下载、删除功能
  */
 import { BaseService, type ServiceRequestOptions, type UploadRequestOptions, type DownloadOptions } from '../../core/base-service.js';
-import type { UploadAttachmentRequest, UploadFileRequest, DownloadAttachmentRequest, DeleteAttachmentRequest } from '../../types/workitem.js';
+import type { UploadAttachmentRequest, UploadFileRequest, UploadFileResponse, DownloadAttachmentRequest, DeleteAttachmentRequest } from '../../types/workitem.js';
 /** API 路径 */
 export declare const API_PATHS: {
     /** 上传文件或富文本图片（通用） */
@@ -26,23 +26,23 @@ export declare class AttachmentService extends BaseService {
     /**
      * 上传文件（通用）
      *
-     * 用于富文本中上传图片等场景，返回上传后的资源路径
+     * 用于富文本中上传图片等场景，返回上传后的资源路径列表
      * 最大支持 100M
      *
      * @param projectKey 空间 ID 或域名
      * @param request 上传请求
      * @param options 请求选项
-     * @returns 附件链接 URL
+     * @returns 附件链接 URL 列表
      *
      * @example
      * ```typescript
-     * const url = await client.workItem.attachment.uploadFile('my-project', {
+     * const urls = await client.workItem.attachment.uploadFile('my-project', {
      *   file: new Blob([...]),
      * });
-     * console.log(url); // https://project.feishu.cn/goapi/v1/tos/file/...
+     * console.log(urls[0]); // https://project.feishu.cn/goapi/v5/platform/file/stream/download/...
      * ```
      */
-    uploadFile(projectKey: string, request: UploadFileRequest, options?: UploadRequestOptions<string>): Promise<string>;
+    uploadFile(projectKey: string, request: UploadFileRequest, options?: UploadRequestOptions<UploadFileResponse>): Promise<UploadFileResponse>;
     /**
      * 添加附件到工作项
      *
@@ -132,7 +132,7 @@ export declare class AttachmentService extends BaseService {
      * ```typescript
      * await client.workItem.attachment.deleteAttachment({
      *   project_key: 'my-project',
-     *   work_item_id: '643711xxxx',
+     *   work_item_id: 643711,
      *   field_key: 'field_xxx',
      *   uuids: ['uuid1', 'uuid2'],
      * });

package/dist/service/workitem/attachment.js

@@ -32,20 +32,20 @@ export class AttachmentService extends BaseService {
     /**
      * 上传文件（通用）
      *
-     * 用于富文本中上传图片等场景，返回上传后的资源路径
+     * 用于富文本中上传图片等场景，返回上传后的资源路径列表
      * 最大支持 100M
      *
      * @param projectKey 空间 ID 或域名
      * @param request 上传请求
      * @param options 请求选项
-     * @returns 附件链接 URL
+     * @returns 附件链接 URL 列表
      *
      * @example
      * ```typescript
-     * const url = await client.workItem.attachment.uploadFile('my-project', {
+     * const urls = await client.workItem.attachment.uploadFile('my-project', {
      *   file: new Blob([...]),
      * });
-     * console.log(url); // https://project.feishu.cn/goapi/v1/tos/file/...
+     * console.log(urls[0]); // https://project.feishu.cn/goapi/v5/platform/file/stream/download/...
      * ```
      */
     async uploadFile(projectKey, request, options) {
@@ -220,7 +220,7 @@ export class AttachmentService extends BaseService {
      * ```typescript
      * await client.workItem.attachment.deleteAttachment({
      *   project_key: 'my-project',
-     *   work_item_id: '643711xxxx',
+     *   work_item_id: 643711,
      *   field_key: 'field_xxx',
      *   uuids: ['uuid1', 'uuid2'],
      * });

package/dist/service/workitem/search.js

@@ -273,7 +273,7 @@ export class SearchService extends BaseService {
      * ```
      */
     async universalSearch(request, options) {
-        const result = await this.postCursorPaginated(API_PATHS.UNIVERSAL_SEARCH, request, options, 'datas');
+        const result = await this.postCursorPaginated(API_PATHS.UNIVERSAL_SEARCH, request, options, 'data');
         return {
             datas: result.data,
             pagination: result.pagination,

package/dist/service/workitem/workflow.d.ts

@@ -59,14 +59,19 @@ export declare class WorkflowService extends BaseService {
      * );
      * console.log('状态流节点:', stateFlowWorkflow.state_flow_nodes);
      *
-     * // 指定返回字段并获取用户详情
+     * // 指定返回字段并获取扩展信息
      * const workflowWithDetails = await client.workItem.workflow.query(
      *   'my-project',
      *   'story',
      *   123456,
      *   {
      *     fields: ['priority', 'description'],
-     *     expand: { need_user_detail: true }
+     *     expand: {
+     *       need_user_detail: true,
+     *       need_sub_task_parent: true,
+     *       need_rich_text_mark_down: true,
+     *       need_sub_workitem_detail: true,
+     *     }
      *   }
      * );
      * ```

package/dist/service/workitem/workflow.js

@@ -58,14 +58,19 @@ export class WorkflowService extends BaseService {
      * );
      * console.log('状态流节点:', stateFlowWorkflow.state_flow_nodes);
      *
-     * // 指定返回字段并获取用户详情
+     * // 指定返回字段并获取扩展信息
      * const workflowWithDetails = await client.workItem.workflow.query(
      *   'my-project',
      *   'story',
      *   123456,
      *   {
      *     fields: ['priority', 'description'],
-     *     expand: { need_user_detail: true }
+     *     expand: {
+     *       need_user_detail: true,
+     *       need_sub_task_parent: true,
+     *       need_rich_text_mark_down: true,
+     *       need_sub_workitem_detail: true,
+     *     }
      *   }
      * );
      * ```

package/dist/types/common.d.ts

@@ -1,6 +1,6 @@
 /**
  * 通用类型定义
- * 100% 参考 Meego API 文档: Meego-API-docs/common/数据结构汇总.md
+ * 参考 Meego API 文档和 Meego-API-docs/数据结构汇总.md
  */
 /**
  * 认证接口响应格式
@@ -125,6 +125,12 @@ export interface FieldValuePair {
     target_state?: TargetState;
     /** 字段更新模式（0: 全局替换, 1: 增量更新） */
     update_mode?: FieldUpdateMode;
+}
+/**
+ * 字段值对响应
+ * 参考: 字段与属性解析格式
+ */
+export interface FieldValuePairResponse extends FieldValuePair {
     /** 字段描述 */
     help_description?: string;
 }
@@ -250,6 +256,11 @@ export interface RoleOwner {
     role: string;
     name?: string;
     owners: string[];
+}
+/**
+ * 角色负责人响应
+ */
+export interface RoleOwnerResponse extends RoleOwner {
     /** 该角色在当前实例上是否存在（状态流工作项返回） */
     exist?: boolean;
 }
@@ -274,6 +285,11 @@ export interface Schedule {
     is_auto?: boolean;
     /** 实际工时，精确到小数点后一位 */
     actual_work_time?: number;
+}
+/**
+ * 排期响应
+ */
+export interface ScheduleResponse extends Schedule {
     /** 计划工期（仅在差异化排期数组中返回） */
     planned_construction_period?: number;
 }
@@ -298,8 +314,6 @@ export interface ExpandParams {
     relation_fields_detail?: boolean;
     /** 是否需要返回用户信息 */
     need_user_detail?: boolean;
-    /** 是否需要子任务父级信息 */
-    need_sub_task_parent?: boolean;
     /** 是否融合需要交付物 */
     need_union_deliverable?: boolean;
     /** 是否需要返回WBS链路实例 */

package/dist/types/common.js

@@ -1,6 +1,6 @@
 /**
  * 通用类型定义
- * 100% 参考 Meego API 文档: Meego-API-docs/common/数据结构汇总.md
+ * 参考 Meego API 文档和 Meego-API-docs/数据结构汇总.md
  */
 /**
  * 默认 Logger 实现（使用 console）

package/dist/types/config.d.ts

@@ -2,10 +2,11 @@
  * 配置相关类型定义
  * 100% 参考 Meego API 文档
  */
-import type { FieldValue, FieldValuePair, FieldConf, SimpleField, MultiText, UserDetail, Connection } from './common.js';
-import type { RelationFieldDetail, SearchGroup } from './workitem.js';
+import type { FieldValue, FieldValuePair, FieldValuePairResponse, FieldConf, SimpleField, MultiText, UserDetail, Connection, ExpandParams } from './common.js';
+import type { RelationFieldDetail, SearchGroup, WorkItemCreateRequiredMode } from './workitem.js';
 export type ResourceId = number | string;
 export type ResourceUserDetail = Partial<UserDetail>;
+export type ResourceQueryExpand = Pick<ExpandParams, 'need_multi_text' | 'relation_fields_detail'>;
 export type FlowMode = 'stateflow' | 'workflow';
 export interface RoleInfo {
     id: string;
@@ -273,10 +274,7 @@ export interface ResourceQueryRequest {
     work_item_ids: ResourceId[];
     fields?: string[];
     work_item_type_key: string;
-    expand?: {
-        need_multi_text?: boolean;
-        relation_fields_detail?: boolean;
-    };
+    expand?: ResourceQueryExpand;
 }
 export interface ResourceTemplateInfo {
     id?: ResourceId;
@@ -301,7 +299,7 @@ export interface ResourceWorkItemDetail {
     created_at?: number;
     updated_at?: number;
     role_owners?: ResourceRoleOwner[];
-    fields?: FieldValuePair[];
+    fields?: FieldValuePairResponse[];
     simple_name?: string;
     template_id?: ResourceId;
     template?: ResourceTemplateInfo;
@@ -333,6 +331,12 @@ export interface ResourceCreateInstanceRequest {
     name?: string;
     field_value_pairs?: FieldValuePair[];
     template_id?: number;
+    /**
+     * 创建工作项必填模式
+     * - 0: 不校验必填项（默认）
+     * - 1: 校验新建页必填项，未填字段返回创建失败并提示哪些字段未填
+     */
+    required_mode?: WorkItemCreateRequiredMode;
 }
 export interface ResourceCreateInstanceResponseData {
     work_item_id: ResourceId;

package/dist/types/workitem.d.ts

@@ -2,7 +2,7 @@
  * 工作项相关类型定义
  * 100% 参考 Meego API 文档
  */
-import type { FieldValuePair, RoleOwner, Schedule, UserDetail, Connection, MultiText, SearchAfterPagination } from './common.js';
+import type { FieldValuePair, FieldValuePairResponse, RoleOwner, RoleOwnerResponse, Schedule, ScheduleResponse, UserDetail, Connection, MultiText, SearchAfterPagination, ExpandParams } from './common.js';
 export type { UserDetail, Connection, MultiText };
 /** 工作流模式 */
 export type WorkItemPattern = 'Node' | 'State';
@@ -76,13 +76,13 @@ export interface WorkflowNode {
     /** 节点状态 1:未开始 2:进行中 3:已完成 */
     status: NodeStatus;
     /** 节点表单字段 */
-    fields?: FieldValuePair[];
+    fields?: FieldValuePairResponse[];
     /** 负责人 user_key 数组 */
     owners?: string[];
     /** 节点总排期 */
-    node_schedule?: Schedule;
+    node_schedule?: ScheduleResponse;
     /** 差异化排期数组 */
-    schedules?: Schedule[];
+    schedules?: ScheduleResponse[];
     /** 子任务列表 */
     sub_tasks?: SubTask[];
     /** 实际开始时间 */
@@ -90,7 +90,7 @@ export interface WorkflowNode {
     /** 实际结束时间 */
     actual_finish_time?: string;
     /** 角色负责人 */
-    role_assignee?: RoleOwner[];
+    role_assignee?: RoleOwnerResponse[];
     /** 是否里程碑节点 */
     milestone?: boolean;
     /** 负责人设置方式 */
@@ -98,7 +98,7 @@ export interface WorkflowNode {
     /** 是否差异化排期 */
     different_schedule?: boolean;
     /** 节点自定义字段 */
-    node_custom_fields?: FieldValuePair[];
+    node_custom_fields?: FieldValuePairResponse[];
 }
 /**
  * 状态流节点
@@ -111,9 +111,9 @@ export interface StateFlowNode {
     /** 状态 */
     status: NodeStatus;
     /** 字段 */
-    fields?: FieldValuePair[];
+    fields?: FieldValuePairResponse[];
     /** 角色负责人 */
-    role_owners?: RoleOwner[];
+    role_owners?: RoleOwnerResponse[];
     /** 状态开始时间 */
     actual_begin_time?: string;
     /** 状态结束时间 */
@@ -195,7 +195,7 @@ export interface WorkItem {
     /** 状态时间记录（节点流） */
     state_times?: StateTime[];
     /** 字段列表 */
-    fields?: FieldValuePair[];
+    fields?: FieldValuePairResponse[];
     /** 用户详情（扩展查询） */
     user_details?: UserDetail[];
     /** 富文本信息（扩展查询） */
@@ -210,22 +210,22 @@ export interface WorkItem {
  * 字段返回按 field_selected 决定，键名为字段 key
  */
 export type WorkItemInfo = Record<string, unknown> & {
-    work_item_id?: number | string;
+    work_item_id?: number;
     id?: number | string;
 };
 /**
  * 查询扩展选项
  */
 export interface QueryWorkItemExpand {
-    /** 是否需要用户详细信息 */
+    /** 是否需要返回用户信息 */
     need_user_detail?: boolean;
-    /** 是否需要工作流信息 */
+    /** 是否需要返回工作流信息 */
     need_workflow?: boolean;
-    /** 是否需要富文本信息 */
+    /** 是否需要返回富文本信息 */
     need_multi_text?: boolean;
-    /** 是否需要关联字段详情 */
+    /** 是否需要返回工作项关联详细信息 */
     relation_fields_detail?: boolean;
-    /** 是否需要复合字段组标识 */
+    /** 是否需要返回复合字段补充组标识 */
     need_group_uuid_for_compound?: boolean;
     /** 是否需要子任务父级信息 */
     need_sub_task_parent?: boolean;
@@ -551,6 +551,8 @@ export interface UploadFileRequest {
     /** 文件 MIME 类型（可选，未传时会结合 Blob.type 与文件名推断） */
     mimeType?: string;
 }
+/** 上传通用文件响应：平台返回一个或多个文件 URL */
+export type UploadFileResponse = string[];
 /**
  * 下载附件请求参数
  */
@@ -576,7 +578,7 @@ export type DeleteAttachmentRequest = {
     /** 空间 ID 或域名 */
     project_key: string;
     /** 工作项 ID */
-    work_item_id: number | string;
+    work_item_id: number;
     /** 要删除的附件 UUID 列表 */
     uuids: string[];
 } & DeleteAttachmentFieldSelector;
@@ -636,14 +638,10 @@ export interface CompleteRollbackSubtaskRequest {
     assignee?: string[];
     /** 子任务角色负责人列表（角色联动模式使用） */
     role_assignee?: RoleOwner[];
-    /** 单个估分排期信息 */
-    schedule?: Schedule;
     /** 估分排期信息 */
     schedules?: Schedule[];
     /** 交付物字段列表 */
     deliverable?: FieldValuePair[];
-    /** 目标更新的字段列表 */
-    update_fields?: FieldValuePair[];
     /** 备注信息 */
     note?: string;
 }
@@ -691,7 +689,7 @@ export interface SubTask {
     /** 子任务名称 */
     name: string;
     /** 排期数组 */
-    schedules?: Schedule[];
+    schedules?: ScheduleResponse[];
     /** 排序字段 */
     order?: number;
     /** 是否已完成 */
@@ -703,11 +701,11 @@ export interface SubTask {
     /** 子任务负责人 userKey 列表（非角色联动模式） */
     assignee?: string[];
     /** 子任务角色负责人列表（角色联动模式） */
-    role_assignee?: RoleOwner[];
+    role_assignee?: RoleOwnerResponse[];
     /** 交付物 */
-    deliverable?: FieldValuePair[];
+    deliverable?: FieldValuePairResponse[];
     /** 自定义字段 */
-    fields?: FieldValuePair[];
+    fields?: FieldValuePairResponse[];
     /** 备注（同 note） */
     details?: string;
     /** 实际开始时间，ISO 8601 格式 */
@@ -788,7 +786,7 @@ export interface Comment {
     /** 评论 ID（字符串格式，避免大整数精度丢失） */
     id: string;
     /** 评论所属工作项 ID */
-    work_item_id: number | string;
+    work_item_id: number;
     /** 评论所属工作项类型 */
     work_item_type_key: string;
     /** 评论创建时间，毫秒精度 */
@@ -1262,16 +1260,14 @@ export type FlowType = 0 | 1;
  * 工作流查询扩展选项
  */
 export interface WorkflowQueryExpand {
-    /** 是否需要返回用户详细信息（默认 false） */
+    /** 是否需要返回用户信息 */
     need_user_detail?: boolean;
-    /** 是否需要 workflow 的信息（仅节点流工作项支持，状态流返回空结构） */
-    need_workflow?: boolean;
-    /** 是否需要富文本信息 */
-    need_multi_text?: boolean;
-    /** 是否需要返回工作项关联详细信息 */
-    relation_fields_detail?: boolean;
-    /** 是否要补充复合字段组标识 */
-    need_group_uuid_for_compound?: boolean;
+    /** 是否需要子任务父级信息 */
+    need_sub_task_parent?: boolean;
+    /** 是否需要返回富文本 Markdown */
+    need_rich_text_mark_down?: boolean;
+    /** 是否需要返回节点子项关联详情 */
+    need_sub_workitem_detail?: boolean;
 }
 /**
  * 获取工作流详情请求
@@ -1341,6 +1337,15 @@ export interface ScheduleConstraintRule {
     /** 按工作项类型区分的 WBS 子实例联动配置 */
     wbs_sub_instance_type?: Record<string, boolean>;
 }
+/**
+ * 节点新增关联子工作项
+ */
+export interface AddSubWorkitemsRequest {
+    /** 节点子项关系 UUID，对应节点子项配置中的关系 */
+    relation_id: string;
+    /** 要新增关联的已有工作项实例 ID 列表，单次最多 10 个 */
+    workitems: number[];
+}
 /**
  * 更新节点请求（节点流工作项）
  * 接口: PUT /open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id
@@ -1360,6 +1365,8 @@ export interface UpdateNodeRequest {
     schedule_constraint_rule?: ScheduleConstraintRule;
     /** 节点自定义字段 */
     node_custom_fields?: FieldValuePair[];
+    /** 节点新增关联子工作项 */
+    add_sub_workitems?: AddSubWorkitemsRequest;
 }
 /** 流转必填信息查询模式 */
 export type TransitionRequiredMode = 'unfinished';
@@ -1476,16 +1483,10 @@ export interface WbsViewQueryParams {
 /**
  * WBS 视图扩展查询参数
  */
-export interface WbsViewExpand {
-    /** 是否需要融合交付物信息 */
-    need_union_deliverable?: boolean;
+export type WbsViewExpand = Pick<ExpandParams, 'need_union_deliverable' | 'need_wbs_relation_chain_path' | 'need_wbs_relation_chain_entity'> & {
     /** 是否需要计划表自定义列聚合字段 */
     need_schedule_table_agg?: boolean;
-    /** 是否需要 WBS 链路层级信息 */
-    need_wbs_relation_chain_path?: boolean;
-    /** 是否需要 WBS 链路实例信息 */
-    need_wbs_relation_chain_entity?: boolean;
-}
+};
 /**
  * WBS 视图请求体
  */
@@ -1531,7 +1532,7 @@ export interface WbsViewRelatedSubWorkItem {
     /** 空间 key */
     project_key?: string;
     /** 字段聚合值 */
-    field_values?: FieldValuePair[];
+    field_values?: FieldValuePairResponse[];
     /** 融合交付物 */
     union_deliverable?: Array<Record<string, unknown>>;
     /** 模板 key */
@@ -1758,14 +1759,14 @@ export interface WbsDraftNodeRoleOwners {
     path?: string;
     work_item_id?: number;
     name?: string;
-    role_owners?: RoleOwner[];
+    role_owners?: RoleOwnerResponse[];
     work_item_type_key?: string;
 }
 /**
  * WBS 草稿字段交付物
  */
 export interface WbsDraftFieldDeliverableItem {
-    field_info?: FieldValuePair;
+    field_info?: FieldValuePairResponse;
     placeholder?: string;
     remark?: string;
     status?: number;
@@ -1801,11 +1802,11 @@ export interface WbsDraftWorkItem {
     wbs_status_map?: Record<string, string>;
     sub_work_item?: WbsDraftWorkItem[];
     name?: string;
-    deliverable?: FieldValuePair[];
-    schedule?: Schedule;
-    schedules?: Schedule[];
+    deliverable?: FieldValuePairResponse[];
+    schedule?: ScheduleResponse;
+    schedules?: ScheduleResponse[];
     points?: number;
-    role_owners?: RoleOwner[];
+    role_owners?: RoleOwnerResponse[];
     work_item_type_key?: string;
     milestone?: boolean;
     connections?: Connection[];
@@ -1825,7 +1826,7 @@ export interface WbsDraftWorkItem {
     dependencies?: WbsDraftDependencyInfo[];
     relative_schedule_v2?: WbsDraftScheduleReferenceValue[];
     is_schedule_agg_item?: boolean;
-    field_values?: FieldValuePair[];
+    field_values?: FieldValuePairResponse[];
 }
 /**
  * WBS 草稿
@@ -1838,7 +1839,7 @@ export interface WbsDraft {
     connections?: Connection[];
     draft_id?: string;
     delete_uuids?: string[];
-    role_owners?: Record<string, RoleOwner[]>;
+    role_owners?: Record<string, RoleOwnerResponse[]>;
     user_details?: UserDetail[];
     work_item_id?: number;
 }
@@ -2502,11 +2503,9 @@ export interface QueryWbsViewRowDetailResponse {
 /**
  * 发布态计划表扩展查询参数
  */
-export interface QueryWbsInstanceExpand {
-    need_wbs_relation_chain_entity?: boolean;
-    need_wbs_relation_chain_path?: boolean;
+export type QueryWbsInstanceExpand = Pick<ExpandParams, 'need_wbs_relation_chain_entity' | 'need_wbs_relation_chain_path'> & {
     need_parent_work_item?: boolean;
-}
+};
 /**
  * 发布态计划表扩展信息查询请求
  */
@@ -2789,7 +2788,7 @@ export interface ReviewBatchQueryRequest {
     /** 空间 ID（必填） */
     project_key: string;
     /** 工作项 ID（必填） */
-    work_item_id: number | string;
+    work_item_id: number;
     /** 节点 ID 列表（必填，最多 10 个） */
     node_ids: string[];
 }
@@ -2798,7 +2797,7 @@ export interface ReviewBatchQueryRequest {
  */
 export interface ReviewBatchQueryResponse {
     project_key: string;
-    work_item_id: number | string;
+    work_item_id: number;
     finished_infos: ReviewFinishedInfoItem[];
 }
 /**
@@ -2808,7 +2807,7 @@ export interface ReviewConclusionOptionRequest {
     /** 空间 ID */
     project_key: string;
     /** 工作项 ID */
-    work_item_id: number | string;
+    work_item_id: number;
     /** 节点 ID 列表 */
     node_ids: string[];
 }
@@ -2836,7 +2835,7 @@ export interface UpdateReviewRequest {
     /** 空间 ID */
     project_key: string;
     /** 工作项 ID */
-    work_item_id: number | string;
+    work_item_id: number;
     /** 节点 ID */
     node_id: string;
     /** 评审意见 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meeglesdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "飞书项目 Open API TypeScript SDK",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,7 +24,15 @@
     "test": "bun test",
     "test:auth": "bun test tests/integration/auth.test.ts",
     "perf": "bun run tests/perf/benchmark.ts",
-    "release:check": "bun run typecheck && bun test tests/unit && bun run build",
+    "release:artifacts": "bun run build && node scripts/check-release-artifacts.mjs",
+    "openapi:field-diff": "node scripts/check-openapi-field-diff.mjs",
+    "openapi:field-report": "node scripts/check-openapi-field-diff.mjs --json",
+    "openapi:snapshot:update": "node scripts/check-openapi-docs-snapshot.mjs --update",
+    "openapi:snapshot:check": "node scripts/check-openapi-docs-snapshot.mjs",
+    "openapi:field-targets:check": "node scripts/check-openapi-field-targets.mjs",
+    "openapi:field-check": "bun run openapi:field-targets:check && node scripts/check-openapi-field-diff.mjs --fail-on-diff",
+    "response-model-check": "node scripts/check-response-model-boundaries.mjs",
+    "release:check": "bun run typecheck && bun run openapi:snapshot:check && bun run openapi:field-check && bun run response-model-check && bun test tests/unit && bun run build && node scripts/check-release-artifacts.mjs",
     "prepublishOnly": "bun run release:check"
   },
   "keywords": [