@c4a/extract-contract 0.0.0-bootstrap.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 context4ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# @c4a/extract-contract
+
+Static OpenAPI and GraphQL contract catalog adapter for Context.
+
+The package parses only the caller-provided source map. OpenAPI external references must resolve to registered relative files. GraphQL files in one invocation form one schema scope so type extensions resolve to an exact base definition. Missing, escaping, ambiguous, cyclic, or unsupported dependencies make the affected file unsupported; unsupported files publish no partial facts.
+
+It emits the common `context.indexer.evidence-adapter-result/v1` ABI with endpoint, operation, type, reference, generated-source boundary, locator, disposition, and diagnostic evidence. It does not fetch remote schemas, execute GraphQL operations, generate clients, or publish source prose.
+
+```ts
+import { parseContractSources } from "@c4a/extract-contract";
+
+const catalogs = parseContractSources({
+  "api/openapi.yaml": "openapi: '3.1.0'\ninfo: { title: API, version: '1' }\npaths: {}",
+  "graphql/schema.graphql": "type Query { ready: Boolean! }",
+});
+```

package/README.zh-CN.md

@@ -0,0 +1,7 @@
+# @c4a/extract-contract
+
+面向 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、生成客户端，也不会发布源码描述正文。