@reventlessdev/reventless-core 3.0.0-alpha.211 → 3.0.0-alpha.212

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 3.0.0-alpha.212 (2026-08-04)
+
+### Bug Fixes
+
+* **admin:** declare the component fields the resolver already returned ([879fdf3](https://github.com/ReventlessDev/reventless-core/commit/879fdf3e7ac68be23f915db6bdd0fdc68294de5d))
+### Features
+
+* **admin:** serve the complete plugin structure to developer tooling ([e99cda0](https://github.com/ReventlessDev/reventless-core/commit/e99cda02a2f862b36bcfdb018a0fb34bb7426a2b))
+
+
 # 3.0.0-alpha.211 (2026-08-04)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-core",
-  "version": "3.0.0-alpha.211",
+  "version": "3.0.0-alpha.212",
   "description": "Core package for Reventless framework",
   "license": "Apache-2.0",
   "jest": {
@@ -30,12 +30,12 @@
     "uuid": "^13.0.0",
     "@reventlessdev/rescript-fast-csv": "2.0.0-alpha.1",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
-    "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@reventlessdev/rescript-hash-object": "1.2.0-alpha.14",
     "@reventlessdev/rescript-node": "2.0.0-alpha.1",
+    "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
-    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
     "@reventlessdev/rescript-ssh2": "2.0.0-alpha.1",
+    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
     "@reventlessdev/reventless-infra": "3.0.0-alpha.126",
     "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
     "@reventlessdev/reventless-spec": "3.0.0-alpha.100"

package/src/admin/Platform_AdminApi.res

@@ -136,11 +136,13 @@ let baseFragment = (~cloner: bool) => {
     ->Array.concat(uiFragmentSubscriptionTypes)
     ->Array.concat(pluginStatusSubscriptionTypes)
     ->Array.concat(Platform_ComponentDefinitionsApi.sdlTypes)
+    ->Array.concat(Platform_PluginStructuresApi.sdlTypes)
     ->Array.concat(Platform_UIFragmentsApi.sdlTypes),
     queries: Array.concat(
       parts.queries,
       [
         Platform_ComponentDefinitionsApi.sdlQueryField,
+        Platform_PluginStructuresApi.sdlQueryField,
         Platform_UIFragmentsApi.sdlQueryField,
       ],
     ),

package/src/admin/Platform_AdminApi.res.mjs

@@ -7,6 +7,7 @@ import * as PluginBaseFragment$ReventlessCore from "../plugin/api/PluginBaseFrag
 import * as Platform_UIFragmentsApi$ReventlessCore from "./Platform_UIFragmentsApi.res.mjs";
 import * as GraphQL_FragmentGenerator$ReventlessCore from "../components/Api/GraphQL_FragmentGenerator.res.mjs";
 import * as Plugin_SubscriptionSchema$ReventlessCore from "../plugin/component/Plugin_SubscriptionSchema.res.mjs";
+import * as Platform_PluginStructuresApi$ReventlessCore from "./Platform_PluginStructuresApi.res.mjs";
 import * as Platform_ComponentDefinitionsApi$ReventlessCore from "./Platform_ComponentDefinitionsApi.res.mjs";
 
 let cloneArgsSchema = S.schema(s => ({
@@ -90,10 +91,11 @@ function baseFragment(cloner) {
   let parts = GraphQL_Stitcher$ReventlessCore.decode(base);
   let match = Plugin_SubscriptionSchema$ReventlessCore.sourceCFields(PluginBaseFragment$ReventlessCore.pluginAggregateMutationEntries);
   return GraphQL_Stitcher$ReventlessCore.encode({
-    types: parts.types.concat(uiFragmentSubscriptionTypes).concat(pluginStatusSubscriptionTypes).concat(Platform_ComponentDefinitionsApi$ReventlessCore.sdlTypes).concat(Platform_UIFragmentsApi$ReventlessCore.sdlTypes),
+    types: parts.types.concat(uiFragmentSubscriptionTypes).concat(pluginStatusSubscriptionTypes).concat(Platform_ComponentDefinitionsApi$ReventlessCore.sdlTypes).concat(Platform_PluginStructuresApi$ReventlessCore.sdlTypes).concat(Platform_UIFragmentsApi$ReventlessCore.sdlTypes),
     mutations: parts.mutations.concat(uiFragmentMutationFields).concat(pluginStatusMutationFields),
     queries: parts.queries.concat([
       Platform_ComponentDefinitionsApi$ReventlessCore.sdlQueryField,
+      Platform_PluginStructuresApi$ReventlessCore.sdlQueryField,
       Platform_UIFragmentsApi$ReventlessCore.sdlQueryField
     ]),
     subscriptions: [

package/src/admin/Platform_ComponentDefinitionsApi.res

@@ -3,18 +3,28 @@
 // and the AWS adapter (which resolves from the Plugin read model). Keeping both
 // adapters byte-identical guarantees a single client query string works against
 // both.
+//
+// The component-level types below are shared with `Platform_PluginStructuresApi`,
+// which serves the same components unfiltered to developer tooling. They are
+// declared here because this is where their encoders live; the two queries differ
+// in WHICH components they return and what the entry carries around them, never in
+// how one component is shaped.
 
 open Reventless.Plugin
 
+// Component-level SDL. Every field a leaf encoder below emits is declared here:
+// a field the resolver returns but the SDL omits is unreachable (GraphQL rejects
+// selecting it), which is how `chapter` and `externalSystem` stayed invisible to
+// consumers long after they were being encoded.
 let sdlTypes: array<string> = [
   `type Platform_FieldReference {\n  fieldName: String!\n  entity: String!\n  plugin: String\n}`,
   `type Platform_CommandDef {\n  name: String!\n  schema: String!\n  level: String!\n  aggregateIdField: String\n  mutationField: String!\n  references: [Platform_FieldReference!]!\n  allowedStates: [String!]\n  targetState: String\n  apiExposed: Boolean\n}`,
   `type Platform_EventDef {\n  name: String!\n  schema: String!\n  references: [Platform_FieldReference!]!\n}`,
-  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n}`,
-  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n}`,
-  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n}`,
-  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n}`,
-  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n}`,
+  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n  chapter: String\n}`,
+  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n  visibility: String\n  chapter: String\n}`,
+  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n  targetName: String\n  chapter: String\n}`,
+  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
+  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
   `type Platform_ExtensionDef {\n  name: String!\n  delegateNames: [String!]!\n  eventTypes: [String!]!\n  commandTypes: [String!]!\n}`,
   `type Platform_ComponentDefinitionEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n}`,
 ]
@@ -77,6 +87,11 @@ let encodeQueryableDef = (r: queryableDef): JSON.t =>
       r.labelFieldSource->Option.mapOr(JSON.Encode.null, JSON.Encode.string),
     ),
     ("statusField", r.statusField->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
+    // Carried rather than only filtered on: a tooling consumer reading the
+    // unfiltered structure needs to know WHICH components are Internal, and a
+    // consumer of the filtered query reads null here because nothing Internal
+    // survives the filter anyway.
+    ("visibility", r.visibility->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
     ("chapter", r.chapter->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
   ])->JSON.Encode.object
 
@@ -108,6 +123,10 @@ let encodeAutomationSliceDef = (a: automationSliceDef): JSON.t =>
     ("name", JSON.Encode.string(a.name)),
     ("consumedEventTypes", encodeStrings(a.consumedEventTypes)),
     ("producedCommandTypes", encodeStrings(a.producedCommandTypes)),
+    // Routing target — the plugin this slice's commands are dispatched to. It is
+    // what turns a slice into a cross-plugin edge, so a graph consumer needs it
+    // from the structure rather than from the deploy-time inspector sync.
+    ("targetName", JSON.Encode.string(a.targetName)),
     ("chapter", a.chapter->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
   ])->JSON.Encode.object
 
@@ -116,6 +135,7 @@ let encodeOutboundTranslationSliceDef = (o: outboundTranslationSliceDef): JSON.t
     ("name", JSON.Encode.string(o.name)),
     ("consumedEventTypes", encodeStrings(o.consumedEventTypes)),
     ("inboundCommandTypes", encodeStrings(o.inboundCommandTypes)),
+    ("targetName", o.targetName->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
     // Foreign system this slice publishes to — lets a deployed-graph consumer draw
     // the external-system boundary box without workspace access. None → null.
     ("externalSystem", o.externalSystem->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
@@ -126,6 +146,7 @@ let encodeInboundTranslationSliceDef = (i: inboundTranslationSliceDef): JSON.t =
   Dict.fromArray([
     ("name", JSON.Encode.string(i.name)),
     ("commandTypes", encodeStrings(i.commandTypes)),
+    ("targetName", JSON.Encode.string(i.targetName)),
     // Foreign system this slice receives from — lets a deployed-graph consumer draw
     // the external-system boundary box without workspace access. None → null.
     ("externalSystem", i.externalSystem->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),

package/src/admin/Platform_ComponentDefinitionsApi.res.mjs

@@ -8,11 +8,11 @@ let sdlTypes = [
   `type Platform_FieldReference {\n  fieldName: String!\n  entity: String!\n  plugin: String\n}`,
   `type Platform_CommandDef {\n  name: String!\n  schema: String!\n  level: String!\n  aggregateIdField: String\n  mutationField: String!\n  references: [Platform_FieldReference!]!\n  allowedStates: [String!]\n  targetState: String\n  apiExposed: Boolean\n}`,
   `type Platform_EventDef {\n  name: String!\n  schema: String!\n  references: [Platform_FieldReference!]!\n}`,
-  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n}`,
-  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n}`,
-  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n}`,
-  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n}`,
-  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n}`,
+  `type Platform_WriteSideDef {\n  name: String!\n  commands: [Platform_CommandDef!]!\n  linkedViews: [String!]!\n  consistencyRead: String\n  producedEventTypes: [String!]!\n  consumedEventTypes: [String!]!\n  events: [Platform_EventDef!]!\n  chapter: String\n}`,
+  `type Platform_ReadSideDef {\n  name: String!\n  queryField: String!\n  schema: String!\n  consumedEventTypes: [String!]!\n  linkedWriteSide: [String!]!\n  labelField: String!\n  searchableFields: [String!]!\n  labelFieldSource: String\n  statusField: String\n  visibility: String\n  chapter: String\n}`,
+  `type Platform_AutomationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  producedCommandTypes: [String!]!\n  targetName: String\n  chapter: String\n}`,
+  `type Platform_OutboundTranslationSliceDef {\n  name: String!\n  consumedEventTypes: [String!]!\n  inboundCommandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
+  `type Platform_InboundTranslationSliceDef {\n  name: String!\n  commandTypes: [String!]!\n  targetName: String\n  externalSystem: String\n  chapter: String\n}`,
   `type Platform_ExtensionDef {\n  name: String!\n  delegateNames: [String!]!\n  eventTypes: [String!]!\n  commandTypes: [String!]!\n}`,
   `type Platform_ComponentDefinitionEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n}`
 ];
@@ -124,6 +124,10 @@ function encodeQueryableDef(r) {
       "statusField",
       Stdlib_Option.mapOr(r.statusField, null, prim => prim)
     ],
+    [
+      "visibility",
+      Stdlib_Option.mapOr(r.visibility, null, prim => prim)
+    ],
     [
       "chapter",
       Stdlib_Option.mapOr(r.chapter, null, prim => prim)
@@ -199,6 +203,10 @@ function encodeAutomationSliceDef(a) {
       "producedCommandTypes",
       a.producedCommandTypes.map(prim => prim)
     ],
+    [
+      "targetName",
+      a.targetName
+    ],
     [
       "chapter",
       Stdlib_Option.mapOr(a.chapter, null, prim => prim)
@@ -220,6 +228,10 @@ function encodeOutboundTranslationSliceDef(o) {
       "inboundCommandTypes",
       o.inboundCommandTypes.map(prim => prim)
     ],
+    [
+      "targetName",
+      Stdlib_Option.mapOr(o.targetName, null, prim => prim)
+    ],
     [
       "externalSystem",
       Stdlib_Option.mapOr(o.externalSystem, null, prim => prim)
@@ -241,6 +253,10 @@ function encodeInboundTranslationSliceDef(i) {
       "commandTypes",
       i.commandTypes.map(prim => prim)
     ],
+    [
+      "targetName",
+      i.targetName
+    ],
     [
       "externalSystem",
       Stdlib_Option.mapOr(i.externalSystem, null, prim => prim)

package/src/admin/Platform_PluginStructuresApi.res

@@ -0,0 +1,132 @@
+// SDL types and JSON encoder for the `Platform_PluginStructures` GraphQL query —
+// the COMPLETE plugin structure, for developer tooling.
+//
+// Why this is a separate query rather than more fields on
+// `Platform_ComponentDefinitions`: the two have different contracts, and the
+// difference is not cosmetic.
+//
+//   Platform_ComponentDefinitions  the deployed AutoUI's menu, drill-down pages and
+//                                  queryable defs. Internal ReadModels /
+//                                  StateViewSlices are filtered OUT — showing them
+//                                  would put components in an end user's menu that
+//                                  the author marked as not-for-display.
+//   Platform_PluginStructures      what the plugin actually IS. Nothing is filtered,
+//                                  and the producer-side `extensionPoints` are
+//                                  carried, because a tool drawing the domain graph
+//                                  has to see every component and every cross-plugin
+//                                  bridge or the graph it draws is a lie.
+//
+// Folding both into one field would mean either leaking Internal components into
+// AutoUI or hiding them from tooling; there is no filter setting that is right for
+// both. The component-level types are shared with `Platform_ComponentDefinitionsApi`
+// (one component has one shape), so only the entry type and the two structure-level
+// collections live here.
+//
+// Both adapters resolve this from the same persisted `pluginStructure`, so a single
+// client query string works against a deployed platform and an in-memory one.
+
+open Reventless.Plugin
+
+let sdlTypes: array<string> = [
+  // Producer side of an extension point. `commandTypes` is null for a
+  // notification-only (`command = unit`) extension point — see `extensionPointDef`.
+  `type Platform_ExtensionPointDef {\n  name: String!\n  delegateNames: [String!]!\n  sourceEventTypes: [String!]!\n  commandTypes: [String!]\n}`,
+  `type Platform_RequiredStoreDeclaration {\n  store: String!\n  component: String!\n  field: String!\n  annotation: String\n}`,
+  // `extensionPoints` / `requiredStores` / `requiredStoreDeclarations` are nullable
+  // lists, not `[T!]!`: all three are optional on `pluginStructure` so that plugin
+  // definitions persisted before the field existed still decode. A structure written
+  // by an older deploy sends null, and null is the honest answer — an empty list
+  // would claim the plugin has no extension points when the truth is that the
+  // deployment cannot say.
+  `type Platform_PluginStructureEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n  extensionPoints: [Platform_ExtensionPointDef!]\n  requiredStores: [String!]\n  requiredStoreDeclarations: [Platform_RequiredStoreDeclaration!]\n}`,
+]
+
+let sdlQueryField: string = `  Platform_PluginStructures: [Platform_PluginStructureEntry!]!`
+
+let encodeExtensionPointDef = (e: extensionPointDef): JSON.t =>
+  Dict.fromArray([
+    ("name", JSON.Encode.string(e.name)),
+    ("delegateNames", Platform_ComponentDefinitionsApi.encodeStrings(e.delegateNames)),
+    ("sourceEventTypes", Platform_ComponentDefinitionsApi.encodeStrings(e.sourceEventTypes)),
+    (
+      "commandTypes",
+      e.commandTypes->Option.mapOr(JSON.Encode.null, Platform_ComponentDefinitionsApi.encodeStrings),
+    ),
+  ])->JSON.Encode.object
+
+let encodeRequiredStoreDeclaration = (d: requiredStoreDeclaration): JSON.t =>
+  Dict.fromArray([
+    ("store", JSON.Encode.string(d.store)),
+    ("component", JSON.Encode.string(d.component)),
+    ("field", JSON.Encode.string(d.field)),
+    ("annotation", d.annotation->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
+  ])->JSON.Encode.object
+
+// Deliberately NOT filtered by `isPublicQueryable`: that filter is the AutoUI
+// contract, and applying it here would silently drop Internal components from the
+// graph a developer tool draws.
+let encodePluginStructureEntry = (~pluginId: string, def: pluginStructure): JSON.t =>
+  Dict.fromArray([
+    ("pluginId", JSON.Encode.string(Plugin.name(pluginId))),
+    (
+      "readModels",
+      def.readModels->Array.map(Platform_ComponentDefinitionsApi.encodeQueryableDef)->JSON.Encode.array,
+    ),
+    (
+      "stateViewSlices",
+      def.stateViewSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeQueryableDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "stateChangeSlices",
+      def.stateChangeSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeWritableDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "aggregates",
+      def.aggregates->Array.map(Platform_ComponentDefinitionsApi.encodeWritableDef)->JSON.Encode.array,
+    ),
+    (
+      "automationSlices",
+      def.automationSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeAutomationSliceDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "outboundTranslationSlices",
+      def.outboundTranslationSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeOutboundTranslationSliceDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "inboundTranslationSlices",
+      def.inboundTranslationSlices
+      ->Array.map(Platform_ComponentDefinitionsApi.encodeInboundTranslationSliceDef)
+      ->JSON.Encode.array,
+    ),
+    (
+      "extensions",
+      def.extensions->Array.map(Platform_ComponentDefinitionsApi.encodeExtensionDef)->JSON.Encode.array,
+    ),
+    (
+      "extensionPoints",
+      def.extensionPoints->Option.mapOr(JSON.Encode.null, eps =>
+        eps->Array.map(encodeExtensionPointDef)->JSON.Encode.array
+      ),
+    ),
+    (
+      "requiredStores",
+      def.requiredStores->Option.mapOr(
+        JSON.Encode.null,
+        Platform_ComponentDefinitionsApi.encodeStrings,
+      ),
+    ),
+    (
+      "requiredStoreDeclarations",
+      def.requiredStoreDeclarations->Option.mapOr(JSON.Encode.null, ds =>
+        ds->Array.map(encodeRequiredStoreDeclaration)->JSON.Encode.array
+      ),
+    ),
+  ])->JSON.Encode.object

package/src/admin/Platform_PluginStructuresApi.res.mjs

@@ -0,0 +1,117 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Plugin$ReventlessCore from "../plugin/component/Plugin.res.mjs";
+import * as Platform_ComponentDefinitionsApi$ReventlessCore from "./Platform_ComponentDefinitionsApi.res.mjs";
+
+let sdlTypes = [
+  `type Platform_ExtensionPointDef {\n  name: String!\n  delegateNames: [String!]!\n  sourceEventTypes: [String!]!\n  commandTypes: [String!]\n}`,
+  `type Platform_RequiredStoreDeclaration {\n  store: String!\n  component: String!\n  field: String!\n  annotation: String\n}`,
+  `type Platform_PluginStructureEntry {\n  pluginId: String!\n  readModels: [Platform_ReadSideDef!]!\n  stateViewSlices: [Platform_ReadSideDef!]!\n  stateChangeSlices: [Platform_WriteSideDef!]!\n  aggregates: [Platform_WriteSideDef!]!\n  automationSlices: [Platform_AutomationSliceDef!]!\n  outboundTranslationSlices: [Platform_OutboundTranslationSliceDef!]!\n  inboundTranslationSlices: [Platform_InboundTranslationSliceDef!]!\n  extensions: [Platform_ExtensionDef!]!\n  extensionPoints: [Platform_ExtensionPointDef!]\n  requiredStores: [String!]\n  requiredStoreDeclarations: [Platform_RequiredStoreDeclaration!]\n}`
+];
+
+function encodeExtensionPointDef(e) {
+  return Object.fromEntries([
+    [
+      "name",
+      e.name
+    ],
+    [
+      "delegateNames",
+      Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings(e.delegateNames)
+    ],
+    [
+      "sourceEventTypes",
+      Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings(e.sourceEventTypes)
+    ],
+    [
+      "commandTypes",
+      Stdlib_Option.mapOr(e.commandTypes, null, Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings)
+    ]
+  ]);
+}
+
+function encodeRequiredStoreDeclaration(d) {
+  return Object.fromEntries([
+    [
+      "store",
+      d.store
+    ],
+    [
+      "component",
+      d.component
+    ],
+    [
+      "field",
+      d.field
+    ],
+    [
+      "annotation",
+      Stdlib_Option.mapOr(d.annotation, null, prim => prim)
+    ]
+  ]);
+}
+
+function encodePluginStructureEntry(pluginId, def) {
+  return Object.fromEntries([
+    [
+      "pluginId",
+      Plugin$ReventlessCore.name(pluginId)
+    ],
+    [
+      "readModels",
+      def.readModels.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeQueryableDef)
+    ],
+    [
+      "stateViewSlices",
+      def.stateViewSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeQueryableDef)
+    ],
+    [
+      "stateChangeSlices",
+      def.stateChangeSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeWritableDef)
+    ],
+    [
+      "aggregates",
+      def.aggregates.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeWritableDef)
+    ],
+    [
+      "automationSlices",
+      def.automationSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeAutomationSliceDef)
+    ],
+    [
+      "outboundTranslationSlices",
+      def.outboundTranslationSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeOutboundTranslationSliceDef)
+    ],
+    [
+      "inboundTranslationSlices",
+      def.inboundTranslationSlices.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeInboundTranslationSliceDef)
+    ],
+    [
+      "extensions",
+      def.extensions.map(Platform_ComponentDefinitionsApi$ReventlessCore.encodeExtensionDef)
+    ],
+    [
+      "extensionPoints",
+      Stdlib_Option.mapOr(def.extensionPoints, null, eps => eps.map(encodeExtensionPointDef))
+    ],
+    [
+      "requiredStores",
+      Stdlib_Option.mapOr(def.requiredStores, null, Platform_ComponentDefinitionsApi$ReventlessCore.encodeStrings)
+    ],
+    [
+      "requiredStoreDeclarations",
+      Stdlib_Option.mapOr(def.requiredStoreDeclarations, null, ds => ds.map(encodeRequiredStoreDeclaration))
+    ]
+  ]);
+}
+
+let sdlQueryField = `  Platform_PluginStructures: [Platform_PluginStructureEntry!]!`;
+
+export {
+  sdlTypes,
+  sdlQueryField,
+  encodeExtensionPointDef,
+  encodeRequiredStoreDeclaration,
+  encodePluginStructureEntry,
+}
+/* No side effect */

package/tests/admin/Platform_ComponentDefinitionsApiTest.res

@@ -163,17 +163,22 @@ describe("encodePluginStructureEntry", () => {
   )
 
   // Translation-slice externalSystem: absent on the fixture above (both None), so it
-  // must serialize as null — the "no external box" case.
+  // must serialize as null — the "no external box" case. The leading field keeps the
+  // two directions apart; `targetName` sits between them and is pinned here too.
   testSync("encodes None outbound externalSystem as null", () =>
-    expect(json->String.includes("\"inboundCommandTypes\":[\"Ship\"],\"externalSystem\":null"))->toEqual(
-      true,
-    )
+    expect(
+      json->String.includes(
+        "\"inboundCommandTypes\":[\"Ship\"],\"targetName\":null,\"externalSystem\":null",
+      ),
+    )->toEqual(true)
   )
 
   testSync("encodes None inbound externalSystem as null", () =>
-    expect(json->String.includes("\"commandTypes\":[\"RecordPayment\"],\"externalSystem\":null"))->toEqual(
-      true,
-    )
+    expect(
+      json->String.includes(
+        "\"commandTypes\":[\"RecordPayment\"],\"targetName\":\"Order\",\"externalSystem\":null",
+      ),
+    )->toEqual(true)
   )
 })
 

package/tests/admin/Platform_ComponentDefinitionsApiTest.res.mjs

@@ -183,10 +183,10 @@ globalThis.describe("encodePluginStructureEntry", () => {
     globalThis.expect(json.includes("\"events\":[{\"name\":\"ProductAdded\"")).toEqual(true);
   });
   globalThis.test("encodes None outbound externalSystem as null", () => {
-    globalThis.expect(json.includes("\"inboundCommandTypes\":[\"Ship\"],\"externalSystem\":null")).toEqual(true);
+    globalThis.expect(json.includes("\"inboundCommandTypes\":[\"Ship\"],\"targetName\":null,\"externalSystem\":null")).toEqual(true);
   });
   globalThis.test("encodes None inbound externalSystem as null", () => {
-    globalThis.expect(json.includes("\"commandTypes\":[\"RecordPayment\"],\"externalSystem\":null")).toEqual(true);
+    globalThis.expect(json.includes("\"commandTypes\":[\"RecordPayment\"],\"targetName\":\"Order\",\"externalSystem\":null")).toEqual(true);
   });
 });
 

package/tests/admin/Platform_PluginStructuresApiTest.res

@@ -0,0 +1,144 @@
+// Asserts what makes `Platform_PluginStructures` different from
+// `Platform_ComponentDefinitions`: nothing is filtered out, and the structure-level
+// collections the AutoUI entry does not carry are present. A developer tool draws
+// its graph from this response, so a component or a bridge missing here is a graph
+// that silently disagrees with the source.
+
+open JestGlobals
+open Reventless.Plugin
+
+let publicRm: queryableDef = {
+  name: "Products",
+  queryField: "Catalog_Products",
+  schema: "{}",
+  consumedEventTypes: ["ProductAdded"],
+  linkedWriteSide: ["Product"],
+  labelField: "displayName",
+  searchableFields: ["displayName"],
+  labelFieldSource: Some("annotation"),
+  statusField: None,
+  visibility: None,
+  chapter: Some("Inventory"),
+}
+
+// The component `Platform_ComponentDefinitions` drops and this query must keep.
+let internalRm: queryableDef = {
+  ...publicRm,
+  name: "ProductAudit",
+  queryField: "Catalog_ProductAudit",
+  visibility: Some("Internal"),
+}
+
+let structure: pluginStructure = {
+  readModels: [publicRm, internalRm],
+  stateViewSlices: [internalRm],
+  stateChangeSlices: [],
+  aggregates: [],
+  automationSlices: [],
+  outboundTranslationSlices: [],
+  inboundTranslationSlices: [],
+  extensions: [],
+  extensionPoints: Some([
+    {
+      name: "Catalog.Products",
+      delegateNames: ["onAdded"],
+      sourceEventTypes: ["Catalog.ProductAdded"],
+      commandTypes: None,
+    },
+  ]),
+  requiredStores: Some(["Catalog.images"]),
+  requiredStoreDeclarations: Some([
+    {store: "Catalog.images", component: "Product", field: "image", annotation: Some("images")},
+  ]),
+}
+
+let encoded = Platform_PluginStructuresApi.encodePluginStructureEntry(
+  ~pluginId="Catalog",
+  structure,
+)
+let json = encoded->JSON.stringify
+
+let namesOf = (key): array<string> =>
+  encoded
+  ->JSON.Decode.object
+  ->Option.flatMap(d => d->Dict.get(key))
+  ->Option.flatMap(JSON.Decode.array)
+  ->Option.getOr([])
+  ->Array.filterMap(v =>
+    v->JSON.Decode.object->Option.flatMap(o => o->Dict.get("name"))->Option.flatMap(JSON.Decode.string)
+  )
+
+describe("Platform_PluginStructures entry", () => {
+  testSync("carries the structure-level keys the AutoUI entry omits", () => {
+    let dict = encoded->JSON.Decode.object->Option.getOr(Dict.make())
+    let keys = dict->Dict.keysToArray->Array.toSorted(String.compare)
+    expect(keys)->toEqual([
+      "aggregates",
+      "automationSlices",
+      "extensionPoints",
+      "extensions",
+      "inboundTranslationSlices",
+      "outboundTranslationSlices",
+      "pluginId",
+      "readModels",
+      "requiredStoreDeclarations",
+      "requiredStores",
+      "stateChangeSlices",
+      "stateViewSlices",
+    ])
+  })
+
+  // The whole reason this query exists as a separate field.
+  testSync("keeps Internal read models", () =>
+    expect(namesOf("readModels"))->toEqual(["Products", "ProductAudit"])
+  )
+
+  testSync("keeps Internal state-view slices", () =>
+    expect(namesOf("stateViewSlices"))->toEqual(["ProductAudit"])
+  )
+
+  testSync("carries visibility so a consumer can tell which are Internal", () =>
+    expect(json->String.includes("\"visibility\":\"Internal\""))->toEqual(true)
+  )
+
+  testSync("encodes the chapter band", () =>
+    expect(json->String.includes("\"chapter\":\"Inventory\""))->toEqual(true)
+  )
+
+  testSync("encodes extension points with their source event types", () =>
+    expect(
+      json->String.includes(
+        "\"extensionPoints\":[{\"name\":\"Catalog.Products\",\"delegateNames\":[\"onAdded\"],\"sourceEventTypes\":[\"Catalog.ProductAdded\"],\"commandTypes\":null}]",
+      ),
+    )->toEqual(true)
+  )
+
+  testSync("encodes required stores with their provenance", () =>
+    expect(json->String.includes("\"requiredStores\":[\"Catalog.images\"]"))->toEqual(true)
+  )
+})
+
+// A structure persisted before these fields existed decodes as None, and null is the
+// honest wire value — an empty list would claim the plugin has no extension points
+// when the truth is that the deployment cannot say.
+describe("absent optional collections", () => {
+  let bare: pluginStructure = {
+    ...structure,
+    extensionPoints: None,
+    requiredStores: None,
+    requiredStoreDeclarations: None,
+  }
+  let bareJson =
+    Platform_PluginStructuresApi.encodePluginStructureEntry(
+      ~pluginId="Catalog",
+      bare,
+    )->JSON.stringify
+
+  testSync("encodes absent extensionPoints as null", () =>
+    expect(bareJson->String.includes("\"extensionPoints\":null"))->toEqual(true)
+  )
+
+  testSync("encodes absent requiredStores as null", () =>
+    expect(bareJson->String.includes("\"requiredStores\":null"))->toEqual(true)
+  )
+})

package/tests/admin/Platform_PluginStructuresApiTest.res.mjs

@@ -0,0 +1,197 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Stdlib_JSON from "@rescript/runtime/lib/es6/Stdlib_JSON.js";
+import * as Stdlib_Array from "@rescript/runtime/lib/es6/Stdlib_Array.js";
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Primitive_string from "@rescript/runtime/lib/es6/Primitive_string.js";
+import * as Platform_PluginStructuresApi$ReventlessCore from "../../src/admin/Platform_PluginStructuresApi.res.mjs";
+
+let publicRm_consumedEventTypes = ["ProductAdded"];
+
+let publicRm_linkedWriteSide = ["Product"];
+
+let publicRm_searchableFields = ["displayName"];
+
+let publicRm_labelFieldSource = "annotation";
+
+let publicRm_chapter = "Inventory";
+
+let publicRm = {
+  name: "Products",
+  queryField: "Catalog_Products",
+  schema: "{}",
+  consumedEventTypes: publicRm_consumedEventTypes,
+  linkedWriteSide: publicRm_linkedWriteSide,
+  labelField: "displayName",
+  searchableFields: publicRm_searchableFields,
+  labelFieldSource: publicRm_labelFieldSource,
+  statusField: undefined,
+  visibility: undefined,
+  chapter: publicRm_chapter
+};
+
+let internalRm_consumedEventTypes = publicRm_consumedEventTypes;
+
+let internalRm_linkedWriteSide = publicRm_linkedWriteSide;
+
+let internalRm_searchableFields = publicRm_searchableFields;
+
+let internalRm_labelFieldSource = "annotation";
+
+let internalRm_visibility = "Internal";
+
+let internalRm_chapter = "Inventory";
+
+let internalRm = {
+  name: "ProductAudit",
+  queryField: "Catalog_ProductAudit",
+  schema: "{}",
+  consumedEventTypes: internalRm_consumedEventTypes,
+  linkedWriteSide: internalRm_linkedWriteSide,
+  labelField: "displayName",
+  searchableFields: internalRm_searchableFields,
+  labelFieldSource: internalRm_labelFieldSource,
+  statusField: undefined,
+  visibility: internalRm_visibility,
+  chapter: internalRm_chapter
+};
+
+let structure_readModels = [
+  publicRm,
+  internalRm
+];
+
+let structure_stateViewSlices = [internalRm];
+
+let structure_stateChangeSlices = [];
+
+let structure_aggregates = [];
+
+let structure_automationSlices = [];
+
+let structure_outboundTranslationSlices = [];
+
+let structure_inboundTranslationSlices = [];
+
+let structure_extensions = [];
+
+let structure_extensionPoints = [{
+    name: "Catalog.Products",
+    delegateNames: ["onAdded"],
+    sourceEventTypes: ["Catalog.ProductAdded"],
+    commandTypes: undefined
+  }];
+
+let structure_requiredStores = ["Catalog.images"];
+
+let structure_requiredStoreDeclarations = [{
+    store: "Catalog.images",
+    component: "Product",
+    field: "image",
+    annotation: "images"
+  }];
+
+let structure = {
+  readModels: structure_readModels,
+  stateViewSlices: structure_stateViewSlices,
+  stateChangeSlices: structure_stateChangeSlices,
+  aggregates: structure_aggregates,
+  automationSlices: structure_automationSlices,
+  outboundTranslationSlices: structure_outboundTranslationSlices,
+  inboundTranslationSlices: structure_inboundTranslationSlices,
+  extensions: structure_extensions,
+  extensionPoints: structure_extensionPoints,
+  requiredStores: structure_requiredStores,
+  requiredStoreDeclarations: structure_requiredStoreDeclarations
+};
+
+let encoded = Platform_PluginStructuresApi$ReventlessCore.encodePluginStructureEntry("Catalog", structure);
+
+let json = JSON.stringify(encoded);
+
+function namesOf(key) {
+  return Stdlib_Array.filterMap(Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(encoded), d => d[key]), Stdlib_JSON.Decode.array), []), v => Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(v), o => o["name"]), Stdlib_JSON.Decode.string));
+}
+
+globalThis.describe("Platform_PluginStructures entry", () => {
+  globalThis.test("carries the structure-level keys the AutoUI entry omits", () => {
+    let dict = Stdlib_Option.getOr(Stdlib_JSON.Decode.object(encoded), {});
+    let keys = Object.keys(dict).toSorted(Primitive_string.compare);
+    globalThis.expect(keys).toEqual([
+      "aggregates",
+      "automationSlices",
+      "extensionPoints",
+      "extensions",
+      "inboundTranslationSlices",
+      "outboundTranslationSlices",
+      "pluginId",
+      "readModels",
+      "requiredStoreDeclarations",
+      "requiredStores",
+      "stateChangeSlices",
+      "stateViewSlices"
+    ]);
+  });
+  globalThis.test("keeps Internal read models", () => {
+    globalThis.expect(namesOf("readModels")).toEqual([
+      "Products",
+      "ProductAudit"
+    ]);
+  });
+  globalThis.test("keeps Internal state-view slices", () => {
+    globalThis.expect(namesOf("stateViewSlices")).toEqual(["ProductAudit"]);
+  });
+  globalThis.test("carries visibility so a consumer can tell which are Internal", () => {
+    globalThis.expect(json.includes("\"visibility\":\"Internal\"")).toEqual(true);
+  });
+  globalThis.test("encodes the chapter band", () => {
+    globalThis.expect(json.includes("\"chapter\":\"Inventory\"")).toEqual(true);
+  });
+  globalThis.test("encodes extension points with their source event types", () => {
+    globalThis.expect(json.includes("\"extensionPoints\":[{\"name\":\"Catalog.Products\",\"delegateNames\":[\"onAdded\"],\"sourceEventTypes\":[\"Catalog.ProductAdded\"],\"commandTypes\":null}]")).toEqual(true);
+  });
+  globalThis.test("encodes required stores with their provenance", () => {
+    globalThis.expect(json.includes("\"requiredStores\":[\"Catalog.images\"]")).toEqual(true);
+  });
+});
+
+globalThis.describe("absent optional collections", () => {
+  let bare_readModels = structure_readModels;
+  let bare_stateViewSlices = structure_stateViewSlices;
+  let bare_stateChangeSlices = structure_stateChangeSlices;
+  let bare_aggregates = structure_aggregates;
+  let bare_automationSlices = structure_automationSlices;
+  let bare_outboundTranslationSlices = structure_outboundTranslationSlices;
+  let bare_inboundTranslationSlices = structure_inboundTranslationSlices;
+  let bare_extensions = structure_extensions;
+  let bare = {
+    readModels: bare_readModels,
+    stateViewSlices: bare_stateViewSlices,
+    stateChangeSlices: bare_stateChangeSlices,
+    aggregates: bare_aggregates,
+    automationSlices: bare_automationSlices,
+    outboundTranslationSlices: bare_outboundTranslationSlices,
+    inboundTranslationSlices: bare_inboundTranslationSlices,
+    extensions: bare_extensions,
+    extensionPoints: undefined,
+    requiredStores: undefined,
+    requiredStoreDeclarations: undefined
+  };
+  let bareJson = JSON.stringify(Platform_PluginStructuresApi$ReventlessCore.encodePluginStructureEntry("Catalog", bare));
+  globalThis.test("encodes absent extensionPoints as null", () => {
+    globalThis.expect(bareJson.includes("\"extensionPoints\":null")).toEqual(true);
+  });
+  globalThis.test("encodes absent requiredStores as null", () => {
+    globalThis.expect(bareJson.includes("\"requiredStores\":null")).toEqual(true);
+  });
+});
+
+export {
+  publicRm,
+  internalRm,
+  structure,
+  encoded,
+  json,
+  namesOf,
+}
+/* encoded Not a pure module */