@descryy/runtime-openapi-observation 0.2.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) Descry
+
+All rights reserved. This software is proprietary and confidential.
+No license, express or implied, to reproduce, distribute, modify, or
+create derivative works is granted except as explicitly agreed in
+writing.

package/dist/declared-roles.d.ts

@@ -1,20 +1,14 @@
 /**
- * Which DTO schemas a resolved `API_ENDPOINT` actually declares, by role —
- * the two-hop join `adapter-openapi` (descry-adapters) writes but nothing
- * here had read yet: `API_ROUTE --SERVES_API--> API_ENDPOINT`,
- * `API_ROUTE --USES_TYPE(roles)--> DTO`. An endpoint resolves; its declared
- * shape is one edge traversal further, through the route that serves it —
- * `API_ENDPOINT` itself carries no `attrs.fields`, only `attrs.method`/
- * `attrs.pathTemplate` (`adapter.ts`, read directly rather than assumed).
+ * Which DTO schemas a resolved `API_ENDPOINT` declares, by role — a
+ * two-hop join `adapter-openapi` writes but nothing here reads yet:
+ * `API_ROUTE --SERVES_API--> API_ENDPOINT`, `API_ROUTE --USES_TYPE(roles)-->
+ * DTO`. `API_ENDPOINT` itself carries no `attrs.fields`, only
+ * `attrs.method`/`attrs.pathTemplate`.
  *
- * **Multiple serving routes are folded, not refused.** Unlike
- * `resolveEndpointNode`'s own "similar endpoint" ambiguity (which route
- * served THIS request), several real routes legitimately serving one shared
- * `API_ENDPOINT` (a repo-scoped route in each of several repositories,
- * DEC-115) all declare the *same contract* by construction — the endpoint is
- * the join point precisely because it is workspace-scoped and they are not.
- * So every DTO any serving route declares, under whichever roles it declares
- * them, is unioned rather than picked between.
+ * Multiple serving routes are folded, not refused: several routes
+ * legitimately serving one shared `API_ENDPOINT` (repo-scoped, DEC-115)
+ * declare the same contract by construction, so every DTO any serving
+ * route declares is unioned rather than picked between.
  */
 import type { IRNode } from "@descryy/ir";
 import { type SqlDriver } from "@descryy/core";
@@ -22,6 +16,6 @@ export type SchemaRole = "request" | "response" | "errorResponse";
 export type DeclaredSchemaRoles = {
     readonly [K in SchemaRole]: readonly IRNode[];
 };
-/** `{request: [], response: [], errorResponse: []}` for an endpoint no route serves (should not happen for a `resolved` endpoint, but reported rather than assumed) or one whose serving route(s) declared no `USES_TYPE` edge at all — a real, disclosed "this operation names no schema", not an error. */
+/** `{request: [], response: [], errorResponse: []}` when no route serves this endpoint or none declared a `USES_TYPE` edge — a real "this operation names no schema", not an error. */
 export declare function declaredSchemaRoles(driver: SqlDriver, endpointNodeId: string): DeclaredSchemaRoles;
 //# sourceMappingURL=declared-roles.d.ts.map

package/dist/declared-roles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declared-roles.d.ts","sourceRoot":"","sources":["../src/declared-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,UAAU,GAAG,SAAS,MAAM,EAAE;CAAE,CAAC;AAOpF,6SAA6S;AAC7S,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAqBlG"}
+{"version":3,"file":"declared-roles.d.ts","sourceRoot":"","sources":["../src/declared-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,UAAU,GAAG,SAAS,MAAM,EAAE;CAAE,CAAC;AAOpF,uLAAuL;AACvL,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAqBlG"}

package/dist/declared-roles.js

@@ -1,27 +1,21 @@
 /**
- * Which DTO schemas a resolved `API_ENDPOINT` actually declares, by role —
- * the two-hop join `adapter-openapi` (descry-adapters) writes but nothing
- * here had read yet: `API_ROUTE --SERVES_API--> API_ENDPOINT`,
- * `API_ROUTE --USES_TYPE(roles)--> DTO`. An endpoint resolves; its declared
- * shape is one edge traversal further, through the route that serves it —
- * `API_ENDPOINT` itself carries no `attrs.fields`, only `attrs.method`/
- * `attrs.pathTemplate` (`adapter.ts`, read directly rather than assumed).
+ * Which DTO schemas a resolved `API_ENDPOINT` declares, by role — a
+ * two-hop join `adapter-openapi` writes but nothing here reads yet:
+ * `API_ROUTE --SERVES_API--> API_ENDPOINT`, `API_ROUTE --USES_TYPE(roles)-->
+ * DTO`. `API_ENDPOINT` itself carries no `attrs.fields`, only
+ * `attrs.method`/`attrs.pathTemplate`.
  *
- * **Multiple serving routes are folded, not refused.** Unlike
- * `resolveEndpointNode`'s own "similar endpoint" ambiguity (which route
- * served THIS request), several real routes legitimately serving one shared
- * `API_ENDPOINT` (a repo-scoped route in each of several repositories,
- * DEC-115) all declare the *same contract* by construction — the endpoint is
- * the join point precisely because it is workspace-scoped and they are not.
- * So every DTO any serving route declares, under whichever roles it declares
- * them, is unioned rather than picked between.
+ * Multiple serving routes are folded, not refused: several routes
+ * legitimately serving one shared `API_ENDPOINT` (repo-scoped, DEC-115)
+ * declare the same contract by construction, so every DTO any serving
+ * route declares is unioned rather than picked between.
  */
 import { getNode, incoming, outgoing } from "@descryy/core";
 function rolesOf(attrs) {
     const roles = attrs?.roles;
     return Array.isArray(roles) ? roles.filter((r) => typeof r === "string") : [];
 }
-/** `{request: [], response: [], errorResponse: []}` for an endpoint no route serves (should not happen for a `resolved` endpoint, but reported rather than assumed) or one whose serving route(s) declared no `USES_TYPE` edge at all — a real, disclosed "this operation names no schema", not an error. */
+/** `{request: [], response: [], errorResponse: []}` when no route serves this endpoint or none declared a `USES_TYPE` edge — a real "this operation names no schema", not an error. */
 export function declaredSchemaRoles(driver, endpointNodeId) {
     const result = { request: [], response: [], errorResponse: [] };
     const seen = new Set();

package/dist/declared-roles.js.map

@@ -1 +1 @@
-{"version":3,"file":"declared-roles.js","sourceRoot":"","sources":["../src/declared-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAkB,MAAM,eAAe,CAAC;AAM5E,SAAS,OAAO,CAAC,KAAoD;IACnE,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,6SAA6S;AAC7S,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,cAAsB;IAC3E,MAAM,MAAM,GAAoC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IACjG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAClF,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5E,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS,CAAC,kEAAkE;YACnG,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,eAAe;oBAAE,SAAS;gBACpF,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"declared-roles.js","sourceRoot":"","sources":["../src/declared-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAkB,MAAM,eAAe,CAAC;AAM5E,SAAS,OAAO,CAAC,KAAoD;IACnE,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,uLAAuL;AACvL,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,cAAsB;IAC3E,MAAM,MAAM,GAAoC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IACjG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAClF,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5E,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS,CAAC,kEAAkE;YACnG,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,eAAe;oBAAE,SAAS;gBACpF,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/endpoint-comparison.d.ts

@@ -1,16 +1,14 @@
 /**
- * Resolving an observed request's method+path against the graph's declared
- * `API_ENDPOINT` shapes — checklist §15's "documented endpoint" /
- * "undocumented endpoint" / "wrong method" boxes, and §18's "table/column
- * mapping" analogue for the OpenAPI half: does the contract know about this
- * call at all, and if not, is that because the path was never declared, or
- * because it was declared under a different verb.
+ * Resolving an observed request's method+path against declared
+ * `API_ENDPOINT` shapes — checklist §15's "documented"/"undocumented"/
+ * "wrong method" and §18's table/column-mapping analogue for OpenAPI: does
+ * the contract know this call, and if not, was the path never declared or
+ * declared under a different verb.
  *
  * Both underlying queries (`resolveEndpointNode`, `resolveEndpointNodesByPath`)
  * are `@descryy/runtime-graph-correlator`'s, reused rather than duplicated —
- * `resolveEndpointNodesByPath` exists in that package specifically because
- * this comparison needed it (a method-agnostic path query resolveEndpointNode
- * deliberately doesn't answer on its own).
+ * `resolveEndpointNodesByPath` exists there specifically because this
+ * comparison needed a method-agnostic path query.
  */
 import type { IRNode } from "@descryy/ir";
 import type { SqlDriver } from "@descryy/core";

package/dist/endpoint-comparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint-comparison.d.ts","sourceRoot":"","sources":["../src/endpoint-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,MAAM,kBAAkB;AAC5B,oEAAoE;AAClE;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC/D;;;GAGG;GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/D;;;;GAIG;GACD;IACE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACH,0GAA0G;GACxG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CA2BxG"}
+{"version":3,"file":"endpoint-comparison.d.ts","sourceRoot":"","sources":["../src/endpoint-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,MAAM,kBAAkB;AAC5B,oEAAoE;AAClE;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC/D;;;GAGG;GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/D;;;;GAIG;GACD;IACE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACH,0GAA0G;GACxG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CA0BxG"}

package/dist/endpoint-comparison.js

@@ -1,16 +1,14 @@
 /**
- * Resolving an observed request's method+path against the graph's declared
- * `API_ENDPOINT` shapes — checklist §15's "documented endpoint" /
- * "undocumented endpoint" / "wrong method" boxes, and §18's "table/column
- * mapping" analogue for the OpenAPI half: does the contract know about this
- * call at all, and if not, is that because the path was never declared, or
- * because it was declared under a different verb.
+ * Resolving an observed request's method+path against declared
+ * `API_ENDPOINT` shapes — checklist §15's "documented"/"undocumented"/
+ * "wrong method" and §18's table/column-mapping analogue for OpenAPI: does
+ * the contract know this call, and if not, was the path never declared or
+ * declared under a different verb.
  *
  * Both underlying queries (`resolveEndpointNode`, `resolveEndpointNodesByPath`)
  * are `@descryy/runtime-graph-correlator`'s, reused rather than duplicated —
- * `resolveEndpointNodesByPath` exists in that package specifically because
- * this comparison needed it (a method-agnostic path query resolveEndpointNode
- * deliberately doesn't answer on its own).
+ * `resolveEndpointNodesByPath` exists there specifically because this
+ * comparison needed a method-agnostic path query.
  */
 import { resolveEndpointNode, resolveEndpointNodesByPath } from "@descryy/runtime-graph-correlator";
 export function compareObservedEndpoint(driver, observed) {
@@ -21,9 +19,8 @@ export function compareObservedEndpoint(driver, observed) {
     if (exact.outcome === "ambiguous") {
         return { outcome: "ambiguous", candidates: exact.candidates, reason: exact.reason };
     }
-    // exact.outcome === "not-found" -- the exact method+path is not declared.
-    // Whether the *path* is declared under some other method is a separate
-    // question resolveEndpointNode's own method filter cannot answer.
+    // not-found: exact method+path isn't declared. Whether the path is
+    // declared under another method is a separate question.
     const byPath = resolveEndpointNodesByPath(driver, observed.path);
     if (byPath.nodes.length === 0) {
         return { outcome: "undocumented", reason: exact.reason };

package/dist/endpoint-comparison.js.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint-comparison.js","sourceRoot":"","sources":["../src/endpoint-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AA6BpG,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,QAAyB;IAClF,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1E,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACtF,CAAC;IAED,0EAA0E;IAC1E,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,oBAAoB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChH,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;QAC7C,oBAAoB;QACpB,MAAM,EACJ,GAAG,QAAQ,CAAC,IAAI,sBAAsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC7E,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,mDAAmD;KACtF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"endpoint-comparison.js","sourceRoot":"","sources":["../src/endpoint-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AA6BpG,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,QAAyB;IAClF,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1E,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACtF,CAAC;IAED,mEAAmE;IACnE,wDAAwD;IACxD,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,oBAAoB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChH,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;QAC7C,oBAAoB;QACpB,MAAM,EACJ,GAAG,QAAQ,CAAC,IAAI,sBAAsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC7E,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,mDAAmD;KACtF,CAAC;AACJ,CAAC"}

package/dist/exchange-comparison.d.ts

@@ -1,27 +1,21 @@
 /**
- * Ties `compareObservedEndpoint`, `classifyStatus`, `declaredSchemaRoles` and
- * `compareBodyAgainstSchema` together into the one comparison checklist
- * §15's own boxes actually describe: is the call documented, did its
- * outcome's class match a schema role the contract declares for it, and —
- * when a body was observed — does that body's own fields match that role's
- * declared shape.
+ * Ties `compareObservedEndpoint`, `classifyStatus`, `declaredSchemaRoles`
+ * and `compareBodyAgainstSchema` together into checklist §15's comparison:
+ * is the call documented, did its outcome's class match a declared schema
+ * role, and — when a body was observed — does it match that role's shape.
  *
- * **What "surprising" claims, precisely, and what it does not.** The
- * contract (`adapter-openapi`) carries `responseSchemas`/`errorSchemas` by
- * *role*, never a specific status code (§14/§18's own DECISIONS entry names
- * this limit). So this can say "the operation's contract declares zero
- * schemas for outcomes shaped like this one" — a real, checkable fact — and
- * cannot say "this contract expected 200, not 201." Reported as
- * `statusSurprising: boolean | null`, never as a confident status-code
- * mismatch it has no basis for.
+ * What "surprising" claims and doesn't: the contract carries schemas by
+ * *role*, never a specific status code (§14/§18). So this can say "the
+ * contract declares zero schemas for outcomes shaped like this one" but
+ * never "expected 200, not 201." Reported as `statusSurprising: boolean |
+ * null`, never a status-code mismatch it has no basis for.
  *
- * **Request and response are compared against different roles, on purpose.**
- * A request body is always checked against the `request` role, regardless of
- * outcome; a response body is checked against whichever role the *observed*
- * status bucket expects (`response` for success, `errorResponse` for a client
- * or server error) — the same operation's success and error bodies are
- * different contracts, and comparing an error body against the success DTO
- * would report every field of a real, correct error response as missing.
+ * Request and response are compared against different roles on purpose: a
+ * request body is always checked against `request`; a response body
+ * against whichever role the observed status bucket expects (`response`
+ * for success, `errorResponse` for an error) — comparing an error body
+ * against the success DTO would report a correct error response as all
+ * fields missing.
  */
 import type { SqlDriver } from "@descryy/core";
 import { type EndpointComparison, type ObservedRequest } from "./endpoint-comparison.ts";

package/dist/exchange-comparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exchange-comparison.d.ts","sourceRoot":"","sources":["../src/exchange-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAA2B,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClH,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEzF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6IAA6I;IAC7I,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,+HAA+H;IAC/H,QAAQ,CAAC,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnD;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,4IAA4I;IAC5I,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,0IAA0I;IAC1I,QAAQ,CAAC,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,CAwBzG"}
+{"version":3,"file":"exchange-comparison.d.ts","sourceRoot":"","sources":["../src/exchange-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAA2B,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClH,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEzF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6IAA6I;IAC7I,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,+HAA+H;IAC/H,QAAQ,CAAC,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnD;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,4IAA4I;IAC5I,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,0IAA0I;IAC1I,QAAQ,CAAC,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,CAwBzG"}

package/dist/exchange-comparison.js

@@ -1,27 +1,21 @@
 /**
- * Ties `compareObservedEndpoint`, `classifyStatus`, `declaredSchemaRoles` and
- * `compareBodyAgainstSchema` together into the one comparison checklist
- * §15's own boxes actually describe: is the call documented, did its
- * outcome's class match a schema role the contract declares for it, and —
- * when a body was observed — does that body's own fields match that role's
- * declared shape.
+ * Ties `compareObservedEndpoint`, `classifyStatus`, `declaredSchemaRoles`
+ * and `compareBodyAgainstSchema` together into checklist §15's comparison:
+ * is the call documented, did its outcome's class match a declared schema
+ * role, and — when a body was observed — does it match that role's shape.
  *
- * **What "surprising" claims, precisely, and what it does not.** The
- * contract (`adapter-openapi`) carries `responseSchemas`/`errorSchemas` by
- * *role*, never a specific status code (§14/§18's own DECISIONS entry names
- * this limit). So this can say "the operation's contract declares zero
- * schemas for outcomes shaped like this one" — a real, checkable fact — and
- * cannot say "this contract expected 200, not 201." Reported as
- * `statusSurprising: boolean | null`, never as a confident status-code
- * mismatch it has no basis for.
+ * What "surprising" claims and doesn't: the contract carries schemas by
+ * *role*, never a specific status code (§14/§18). So this can say "the
+ * contract declares zero schemas for outcomes shaped like this one" but
+ * never "expected 200, not 201." Reported as `statusSurprising: boolean |
+ * null`, never a status-code mismatch it has no basis for.
  *
- * **Request and response are compared against different roles, on purpose.**
- * A request body is always checked against the `request` role, regardless of
- * outcome; a response body is checked against whichever role the *observed*
- * status bucket expects (`response` for success, `errorResponse` for a client
- * or server error) — the same operation's success and error bodies are
- * different contracts, and comparing an error body against the success DTO
- * would report every field of a real, correct error response as missing.
+ * Request and response are compared against different roles on purpose: a
+ * request body is always checked against `request`; a response body
+ * against whichever role the observed status bucket expects (`response`
+ * for success, `errorResponse` for an error) — comparing an error body
+ * against the success DTO would report a correct error response as all
+ * fields missing.
  */
 import { compareObservedEndpoint } from "./endpoint-comparison.js";
 import { declaredSchemaRoles } from "./declared-roles.js";

package/dist/exchange-comparison.js.map

@@ -1 +1 @@
-{"version":3,"file":"exchange-comparison.js","sourceRoot":"","sources":["../src/exchange-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,uBAAuB,EAAiD,MAAM,0BAA0B,CAAC;AAClH,OAAO,EAAE,mBAAmB,EAA4B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAqB,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAyB,MAAM,wBAAwB,CAAC;AA6BzF,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,QAA0B;IACnF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErD,IAAI,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QACtC,OAAO;YACL,QAAQ;YACR,YAAY;YACZ,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE,IAAI;YACtB,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAEjG,MAAM,aAAa,GAAG,wBAAwB,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5F,MAAM,cAAc,GAClB,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE9G,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"exchange-comparison.js","sourceRoot":"","sources":["../src/exchange-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,uBAAuB,EAAiD,MAAM,0BAA0B,CAAC;AAClH,OAAO,EAAE,mBAAmB,EAA4B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAqB,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAyB,MAAM,wBAAwB,CAAC;AA6BzF,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,QAA0B;IACnF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErD,IAAI,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QACtC,OAAO;YACL,QAAQ;YACR,YAAY;YACZ,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE,IAAI;YACtB,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAEjG,MAAM,aAAa,GAAG,wBAAwB,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5F,MAAM,cAAc,GAClB,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE9G,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AACpG,CAAC"}

package/dist/schema-comparison.d.ts

@@ -1,27 +1,21 @@
 /**
- * The row §15 left open: an observed request/response BODY compared against a
- * declared DTO's fields, not merely *which* DTOs a role names
- * (`declaredSchemaRoles`, which stops at "here are the schemas"). Reads
- * `DTO.attrs.fieldDetail` — `{name, nullable, required, type?}[]`, written by
- * `adapter-openapi`'s own `document.ts` directly from the contract, never
- * derived here.
+ * §15's open row: an observed request/response BODY compared against a
+ * declared DTO's fields, not just which DTOs a role names
+ * (`declaredSchemaRoles` stops at "here are the schemas"). Reads
+ * `DTO.attrs.fieldDetail` (`{name, nullable, required, type?}[]`), written
+ * by `adapter-openapi`'s `document.ts` directly from the contract.
  *
- * **Comparable to the resolved graph, not to a stream.** This takes a raw
- * body already in hand (the same `string | null` `browser-network-collector`
- * already captures) — parsing and shape-checking are this file's job, sourcing
- * the bytes is not, matching every other comparator in this package.
+ * Takes a raw body already in hand — sourcing the bytes isn't this file's
+ * job, matching every other comparator in this package.
  *
- * **Extra fields are never reported.** This adapter does not capture
+ * Extra fields are never reported: this adapter doesn't capture
  * `additionalProperties`, so "the body has a field the contract doesn't
- * mention" is not a claim the contract supports either way — reporting it
- * would be inventing a stricter contract than the one that was published.
+ * mention" isn't a claim the contract supports either way.
  *
- * **A role naming more than one DTO refuses, rather than picks one.**
- * `declaredSchemaRoles` unions across every serving route by design (DEC-115,
- * multiple repo-scoped routes serving one workspace endpoint) — ordinarily
- * they agree, but when they name two different schemas for the same role,
- * comparing the body against whichever came first would silently prefer one
- * repository's contract over another's.
+ * A role naming more than one DTO refuses rather than picks one:
+ * `declaredSchemaRoles` unions across serving routes (DEC-115) — when they
+ * name different schemas for the same role, picking one would silently
+ * prefer one repository's contract over another's.
  */
 import type { IRNode } from "@descryy/ir";
 export interface FieldDetail {

package/dist/schema-comparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-comparison.d.ts","sourceRoot":"","sources":["../src/schema-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxH;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,gBAAgB;AAC1B,4EAA4E;AAC1E;IAAE,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE;AAC5C,8EAA8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC3G,gGAAgG;GAC9F;IAAE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACnE,wFAAwF;GACtF;IAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC3F,8EAA8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC;AAwC7G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CA+DzH"}
+{"version":3,"file":"schema-comparison.d.ts","sourceRoot":"","sources":["../src/schema-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxH;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,gBAAgB;AAC1B,4EAA4E;AAC1E;IAAE,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE;AAC5C,8EAA8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC3G,gGAAgG;GAC9F;IAAE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACnE,wFAAwF;GACtF;IAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC3F,8EAA8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC;AAwC7G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CA6DzH"}

package/dist/schema-comparison.js

@@ -1,27 +1,21 @@
 /**
- * The row §15 left open: an observed request/response BODY compared against a
- * declared DTO's fields, not merely *which* DTOs a role names
- * (`declaredSchemaRoles`, which stops at "here are the schemas"). Reads
- * `DTO.attrs.fieldDetail` — `{name, nullable, required, type?}[]`, written by
- * `adapter-openapi`'s own `document.ts` directly from the contract, never
- * derived here.
+ * §15's open row: an observed request/response BODY compared against a
+ * declared DTO's fields, not just which DTOs a role names
+ * (`declaredSchemaRoles` stops at "here are the schemas"). Reads
+ * `DTO.attrs.fieldDetail` (`{name, nullable, required, type?}[]`), written
+ * by `adapter-openapi`'s `document.ts` directly from the contract.
  *
- * **Comparable to the resolved graph, not to a stream.** This takes a raw
- * body already in hand (the same `string | null` `browser-network-collector`
- * already captures) — parsing and shape-checking are this file's job, sourcing
- * the bytes is not, matching every other comparator in this package.
+ * Takes a raw body already in hand — sourcing the bytes isn't this file's
+ * job, matching every other comparator in this package.
  *
- * **Extra fields are never reported.** This adapter does not capture
+ * Extra fields are never reported: this adapter doesn't capture
  * `additionalProperties`, so "the body has a field the contract doesn't
- * mention" is not a claim the contract supports either way — reporting it
- * would be inventing a stricter contract than the one that was published.
+ * mention" isn't a claim the contract supports either way.
  *
- * **A role naming more than one DTO refuses, rather than picks one.**
- * `declaredSchemaRoles` unions across every serving route by design (DEC-115,
- * multiple repo-scoped routes serving one workspace endpoint) — ordinarily
- * they agree, but when they name two different schemas for the same role,
- * comparing the body against whichever came first would silently prefer one
- * repository's contract over another's.
+ * A role naming more than one DTO refuses rather than picks one:
+ * `declaredSchemaRoles` unions across serving routes (DEC-115) — when they
+ * name different schemas for the same role, picking one would silently
+ * prefer one repository's contract over another's.
  */
 function isFieldDetail(value) {
     if (typeof value !== "object" || value === null)
@@ -104,9 +98,7 @@ export function compareBodyAgainstSchema(schemas, rawBody) {
         if (field.type === undefined)
             continue;
         const check = TYPE_CHECKS[field.type];
-        // An unrecognised declared type (the document names something outside
-        // this map) is not checked, rather than silently treated as a match —
-        // there is nothing here yet to compare it against.
+        // Unrecognised declared type isn't checked, not silently treated as a match.
         if (check !== undefined && !check(value)) {
             mismatches.push({
                 kind: "type-mismatch",

package/dist/schema-comparison.js.map

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

package/dist/status-bucket.d.ts

@@ -1,21 +1,17 @@
 /**
- * A real HTTP status classified into the class an OpenAPI document actually
- * has a role vocabulary for. `adapter-openapi`'s `Operation` (descry-adapters)
- * carries `responseSchemas` (2xx) and `errorSchemas` (non-2xx) — two roles,
- * not eleven status codes — so this reader stops at the same resolution the
- * contract itself does, rather than inventing a numeric comparison the
- * document was never asked to support.
+ * A real HTTP status classified into the class an OpenAPI document has a
+ * role vocabulary for. `adapter-openapi`'s `Operation` carries
+ * `responseSchemas` (2xx) and `errorSchemas` (non-2xx) — two roles, not
+ * eleven status codes — so this stops at the contract's own resolution.
  */
 export declare const STATUS_BUCKETS: readonly ["informational", "success", "redirect", "client-error", "server-error"];
 export type StatusBucket = (typeof STATUS_BUCKETS)[number];
 export declare function classifyStatus(status: number): StatusBucket;
 /**
- * The DTO role (`adapter.ts`'s own `roles` vocabulary: `"request"` /
- * `"response"` / `"errorResponse"`) a bucket corresponds to — `null` for
- * informational/redirect, which `adapter-openapi` never assigns a role to at
- * all. Refused rather than guessed: reporting "no declared schema" for a
- * bucket the contract was never asked about would read as a finding where
- * there is only an unmodelled case.
+ * The DTO role a bucket corresponds to (`"request"`/`"response"`/
+ * `"errorResponse"`) — `null` for informational/redirect, which
+ * `adapter-openapi` never assigns a role to. Refused rather than guessed:
+ * "no declared schema" for an unmodelled bucket would read as a finding.
  */
 export declare function expectedRoleForBucket(bucket: StatusBucket): "response" | "errorResponse" | null;
 //# sourceMappingURL=status-bucket.d.ts.map

package/dist/status-bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-bucket.d.ts","sourceRoot":"","sources":["../src/status-bucket.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,cAAc,mFAAoF,CAAC;AAChH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAM3D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,IAAI,CAI/F"}
+{"version":3,"file":"status-bucket.d.ts","sourceRoot":"","sources":["../src/status-bucket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,mFAAoF,CAAC;AAChH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,IAAI,CAI/F"}

package/dist/status-bucket.js

@@ -1,10 +1,8 @@
 /**
- * A real HTTP status classified into the class an OpenAPI document actually
- * has a role vocabulary for. `adapter-openapi`'s `Operation` (descry-adapters)
- * carries `responseSchemas` (2xx) and `errorSchemas` (non-2xx) — two roles,
- * not eleven status codes — so this reader stops at the same resolution the
- * contract itself does, rather than inventing a numeric comparison the
- * document was never asked to support.
+ * A real HTTP status classified into the class an OpenAPI document has a
+ * role vocabulary for. `adapter-openapi`'s `Operation` carries
+ * `responseSchemas` (2xx) and `errorSchemas` (non-2xx) — two roles, not
+ * eleven status codes — so this stops at the contract's own resolution.
  */
 export const STATUS_BUCKETS = ["informational", "success", "redirect", "client-error", "server-error"];
 export function classifyStatus(status) {
@@ -19,12 +17,10 @@ export function classifyStatus(status) {
     return "server-error";
 }
 /**
- * The DTO role (`adapter.ts`'s own `roles` vocabulary: `"request"` /
- * `"response"` / `"errorResponse"`) a bucket corresponds to — `null` for
- * informational/redirect, which `adapter-openapi` never assigns a role to at
- * all. Refused rather than guessed: reporting "no declared schema" for a
- * bucket the contract was never asked about would read as a finding where
- * there is only an unmodelled case.
+ * The DTO role a bucket corresponds to (`"request"`/`"response"`/
+ * `"errorResponse"`) — `null` for informational/redirect, which
+ * `adapter-openapi` never assigns a role to. Refused rather than guessed:
+ * "no declared schema" for an unmodelled bucket would read as a finding.
  */
 export function expectedRoleForBucket(bucket) {
     if (bucket === "success")

package/dist/status-bucket.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-bucket.js","sourceRoot":"","sources":["../src/status-bucket.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,CAAU,CAAC;AAGhH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,eAAe,CAAC;IAC1D,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,UAAU,CAAC;IACrD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,cAAc,CAAC;IACzD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,eAAe,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"status-bucket.js","sourceRoot":"","sources":["../src/status-bucket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,CAAU,CAAC;AAGhH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,eAAe,CAAC;IAC1D,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,UAAU,CAAC;IACrD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,cAAc,CAAC;IACzD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,eAAe,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@descryy/runtime-openapi-observation",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "OpenAPI runtime contract comparison (plan \u00a715/\u00a718): a real observed HTTP exchange, compared against the graph's already-declared API_ENDPOINT/DTO shapes -- documented/undocumented/wrong-method resolution and status-bucket-vs-declared-role comparison.",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descryhq-wq/descry-runtime.git",
+    "directory": "packages/openapi-observation"
+  },
   "engines": {
     "node": ">=22.5"
   },
@@ -24,9 +29,9 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/ir": "0.3.0",
-    "@descryy/core": "0.3.0",
-    "@descryy/runtime-graph-correlator": "0.2.0"
+    "@descryy/ir": "0.5.0",
+    "@descryy/core": "0.5.0",
+    "@descryy/runtime-graph-correlator": "0.4.0"
   },
   "devDependencies": {
     "@descry/adapter-openapi": "file:../../../descry-adapters/packages/adapter-openapi",