OpenAPI and GraphQL contract catalog adapter for Context
面向 Context 的 OpenAPI 与 GraphQL 静态 contract catalog adapter。
该包只解析调用方登记的 source map。OpenAPI 外部引用只能解析到已登记的相对路径；同一次调用中的 GraphQL 文件构成一个 schema scope，使 type extension 能解析到唯一且精确的基础定义。依赖缺失、逃逸、歧义、循环或不受支持时，受影响文件记为 unsupported，且不发布部分 facts。
输出统一的 context.indexer.evidence-adapter-result/v1 ABI，包含 endpoint、operation、type、reference、生成代码边界、locator、disposition 和 diagnostic evidence。不会拉取远程 schema、执行 GraphQL operation、生成客户端，也不会发布源码描述正文。
@c4a/extract-contract 共发布 61 个版本，首次发布于 2026/08/30；过去 12 个月发布了 61 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。
| 版本 | 发布日期 | 距今 |
|---|---|---|
0.7.95latest | 2026/11/09 | 今天 |
0.7.94 | 2026/11/08 | 今天 |
0.7.93 | 2026/11/08 | 今天 |
0.7.92 | 2026/11/07 | 1 天前 |
0.7.91 | 2026/11/02 | 6 天前 |
0.7.90 | 2026/10/28 | 11 天前 |
其他发布通道：bootstrap → 0.0.0-bootstrap.0，alpha → 0.7.10-alpha.2，beta → 0.7.14-beta.1。
OpenAPI and GraphQL contract catalog adapter for Context
在项目目录运行 npm install @c4a/extract-contract，或使用 pnpm add / yarn add / bun add。
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@c4a/extract-contract 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
根据 npm 官方下载统计，@c4a/extract-contract 在 2026/10/09 – 2026/11/07 这 30 天内被下载 5,235 次，日均约 175 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
最新版本 0.7.95 发布于 2026/11/09（今天）；至今共发布 61 个版本，其中过去 12 个月发布了 61 个；首次发布于 2026/08/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。