@voxgig/apidef 8.2.0 → 8.2.1

package/model/apidef.aon

@@ -128,17 +128,22 @@ main: kit: entity: &: {
         var?: string
       } ]
 
-      # MIGRATION TOMBSTONE for the `parts` field segments replace.
+      # NO TOMBSTONE FOR `parts` HERE, and this is load-bearing.
       #
-      # A point object is open, so a model file generated by apidef <= 8.1 —
-      # one checked in under a project's `.sdk/model/` — would otherwise
-      # unify cleanly, carry its `parts` along as an undeclared extra, and
-      # take the empty default for `segments`. Every request would then go to
-      # the API ROOT: a silently wrong URL, which is the exact failure ADR-003
-      # exists to remove. `null` conflicts with any concrete value, so such a
-      # model fails to unify and names `...points.N.parts` as the path.
-      # Regenerate the model to fix it.
-      parts?: null
+      # 8.2.0 declared `parts?: null` so that a model generated by apidef
+      # <= 8.1 would fail to unify rather than take the empty `segments`
+      # default and send every request to the API root. It caught exactly
+      # that, and it also BRICKED the upgrade: a project's checked-in
+      # `.sdk/model/entity/*.aon` IS the input to the tool that rewrites it,
+      # and voxgig-model unifies before it runs apidef's build. So the stale
+      # file blocked the regeneration that would have removed it, with no
+      # supported way out — `voxgig-apidef` is still a stub.
+      #
+      # A schema cannot police its own migration. The guard belongs where a
+      # stale point would actually do harm: sdkgen reads the path through one
+      # helper, and that helper refuses a point carrying `parts` and no
+      # `segments`. Same defect caught, at generation time, without
+      # deadlocking the regeneration.
 
       # GraphQL wire data: the precomputed operation document plus the
       # variable bindings and (for list ops) the pagination descriptor.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/apidef",
-  "version": "8.2.0",
+  "version": "8.2.1",
   "main": "dist/apidef.js",
   "type": "commonjs",
   "types": "dist/apidef.d.ts",