#查询接口

可用

#CatalogQuery

requestProviderScope、requiredStaticRevision、capabilityIdPrefix、parent、cursor 和 limit。过滤用于发现，不提供授权。

CatalogPage 返回 items、meta 和可选 nextCursor。每项包含完整二元 id、qualifiedId、用途、使用时机、区别和来源修订。

#CapabilityDetailQuery

支持 requiredStaticRevision、neighborLimitPerKind、knowledgeLimit 和每能力知识续页游标。详情只返回有界关系摘要和 KnowledgeRef，不递归读取邻居或正文。

#NeighborQuery

可指定关系种类、每组游标、页大小和静态修订。结果为八组固定键：parents/children、specializes/specializedBy、related/relatedBy、requires/requiredBy。每组独立报告完整性和续页位置。只有 requires 参与 Selection 闭包；requiredBy 是由它派生的反向发现关系。

#Provider 查询

listProviders() 返回页级 meta，Specification 只给 documentCount。getProvider() 增加有界 specificationDocuments 首屏与 meta；listSpecificationDocuments() 按 knowledgeId 续取。公开摘要不会携带内部完整规范文档列表。

#Selection

ResolveSelectionQuery 提供非空 selected、可选的范围收窄和逐 Provider 指定修订。原始选择最多 32 项，即使重复也计入；闭包最多 128 个能力和 256 条真实依赖边。SelectionResult 返回首次出现顺序的 requested、排序后的 resolved/added、全部 requiresEdges，以及每个节点的 SelectionReason.requested/requiredBy。任何节点、边、Scope 或修订错误都会使整次调用失败，不交付半个闭包。多 Provider 返回 servedFromByProvider、staticRevisionByProvider 与组合修订；servedFrom 可能是 mixed。

#文档发现

DocumentPageQuery 以修订、页大小和游标绑定一次分页。KnowledgeMembersQuery 需要能力身份和 Collection ID，KnowledgeMembersPage 返回成员的完整路由元数据；SpecificationDocumentsPage 只返回该 Provider 的规范文档元数据。默认 20 项、最大 100 项，须检查 completeness 和 nextCursor。