@reventlessdev/reventless-spec 3.0.0-alpha.68 → 3.0.0-alpha.70

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 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.70 (2026-07-10)
+
+### Features
+
+* **reventless-ppx:** add [@group](https://github.com/group)By state-field annotation → x-reventless-group-by ([9e7a7b2](https://github.com/ReventlessDev/reventless-core/commit/9e7a7b29e54fb4eda1c6a145c0e7b6dcf26940ee))
+
+
+# 3.0.0-alpha.69 (2026-07-08)
+
+### Features
+
+* **reventless-core:** classify plugins by kind in the lifecycle read model ([64e3f22](https://github.com/ReventlessDev/reventless-core/commit/64e3f22b8114a771886b7c8ec023e95971413c0b))
+
+
 # 3.0.0-alpha.68 (2026-07-07)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-spec",
-  "version": "3.0.0-alpha.68",
+  "version": "3.0.0-alpha.70",
   "description": "Specifications for Reventless",
   "license": "Apache-2.0",
   "bin": {

package/src/components/Plugin.res

@@ -6,6 +6,23 @@ type name = string
 @schema
 type version = string
 
+/**
+Classifies the business role of a plugin, carried on `pluginDefinition` so the
+plugin-lifecycle read model can segregate infrastructure/commercial/marketplace
+plugins from domain plugins in the admin Plugins view. Absent (on definitions
+persisted before this field existed) is read as `Domain`.
+
+Canonical here in `reventless-spec` because `pluginDefinition` (a `@schema` type
+nested in the lifecycle Message union) needs the sury schema; `ReventlessCore.Plugin_BuiltHook`
+re-exports this same type for its deploy-time metadata registry.
+*/
+@schema
+type pluginKind =
+  | Domain
+  | PlatformInfrastructure
+  | Commercial
+  | Marketplace
+
 /**
 Describes an extension point exported by a plugin.
 Included in the plugin's `pluginDefinition` for use by the gateway / host.
@@ -373,5 +390,10 @@ type pluginDefinition = {
   // subscriptions from this plugin's DCB topic → peer EventCollectors.
   // None for plugins without a DCB EventLog.
   dcbEventLog: @s.matches(dcbEventLogOptionSchema) option<dcbEventLogDefinition>,
+  // Business role of this plugin. Mandatory: `Domain` is the default kind, resolved once
+  // at the deploy-metadata → definition boundary (Plugin_Builder). PlatformInfrastructure
+  // plugins are segregated out of the admin Plugins list. Payload-less variant → serialises
+  // as a bare JSON string, so it is JSON-safe inside the lifecycle Message union without js_nullable.
+  kind: pluginKind,
 }
 

package/src/components/Plugin.res.mjs

@@ -3,6 +3,13 @@
 import * as S from "sury/src/S.res.mjs";
 import * as SuryResMjs from "sury/src/Sury.res.mjs";
 
+let pluginKindSchema = S.union([
+  S.literal("Domain"),
+  S.literal("PlatformInfrastructure"),
+  S.literal("Commercial"),
+  S.literal("Marketplace")
+]);
+
 let extensionPointDefinitionSchema = S.schema(s => ({
   name: s.m(S.string),
   commandTopic: s.m(S.string),
@@ -204,7 +211,8 @@ let pluginDefinitionSchema = S.schema(s => ({
   apiTarget: s.m(stringOptionSchema),
   uiFragments: s.m(uiFragmentManifestOptionSchema),
   structure: s.m(pluginStructureOptionSchema),
-  dcbEventLog: s.m(dcbEventLogOptionSchema)
+  dcbEventLog: s.m(dcbEventLogOptionSchema),
+  kind: s.m(pluginKindSchema)
 }));
 
 let nameSchema = S.string;
@@ -214,6 +222,7 @@ let versionSchema = S.string;
 export {
   nameSchema,
   versionSchema,
+  pluginKindSchema,
   extensionPointDefinitionSchema,
   extensionDefinitionSchema,
   dcbEventLogDefinitionSchema,
@@ -248,4 +257,4 @@ export {
   platformEventGraphSchema,
   pluginDefinitionSchema,
 }
-/* extensionPointDefinitionSchema Not a pure module */
+/* pluginKindSchema Not a pure module */

package/src/components/StateAnnotations.res

@@ -47,6 +47,14 @@ type stateAnnotationSpec = {
   */
   status: option<string>,
   /**
+  Field annotated `@groupBy` on the state record (PPX-emitted). `Some(name)`
+  when one such annotation exists; the PPX errors on duplicate `@groupBy`
+  annotations within the same record. `SuryToJsonSchema.deriveObjectSchema`
+  emits `x-reventless-group-by: true` on the named field, which the UI's
+  list view reads to render rows in sections keyed on that field.
+  */
+  groupBy: option<string>,
+  /**
   Component-level visibility hint from `@@reventless.visibility(...)`.
   `Some("Internal")` when the file-level attribute is `Internal`; `None`
   (omitted) for the default `Public`. `SuryToJsonSchema.deriveObjectSchema`