@reventlessdev/reventless-core 3.0.0-alpha.175 → 3.0.0-alpha.176

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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.176 (2026-07-22)
+
+* refactor!: retire the stale "core" vocabulary for platform things ([34e7480](https://github.com/ReventlessDev/reventless-core/commit/34e7480992bd58906a250b0a1ce6ff2c5ba45260))
+
+### BREAKING CHANGES
+
+* the built-in extension point is renamed Core.Plugin ->
+Platform.Plugin. This replaces the CorePluginExtPointCmdTopic SQS queue
+with PlatformPluginExtPointCmdTopic (a replacement, not an update) and
+breaks every already-deployed plugin's connection until redeployed.
+Wipe the alpha stack and redeploy fresh rather than migrating.
+
+Build clean; 1349 tests green (interop 50, core 518, local 501, aws 280).
+
+
+
 # 3.0.0-alpha.175 (2026-07-22)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-core",
-  "version": "3.0.0-alpha.175",
+  "version": "3.0.0-alpha.176",
   "description": "Core package for Reventless framework",
   "license": "Apache-2.0",
   "jest": {
@@ -29,16 +29,16 @@
     "sury": "11.0.0-alpha.4",
     "uuid": "^13.0.0",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.30",
-    "@reventlessdev/rescript-hash-object": "1.2.0-alpha.13",
     "@reventlessdev/rescript-fast-csv": "1.2.0-alpha.14",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.9",
+    "@reventlessdev/rescript-hash-object": "1.2.0-alpha.13",
     "@reventlessdev/rescript-node-streams": "1.1.0-alpha.13",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.17",
     "@reventlessdev/rescript-ssh2": "1.1.0-alpha.14",
-    "@reventlessdev/rescript-uuid": "1.1.0-alpha.17",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.103",
-    "@reventlessdev/reventless-interop": "3.0.0-alpha.28",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.80"
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.104",
+    "@reventlessdev/reventless-interop": "3.0.0-alpha.29",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.80",
+    "@reventlessdev/rescript-uuid": "1.1.0-alpha.17"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/ComponentType.res

@@ -18,10 +18,6 @@ type t =
   | SideEffectHandler
   | Task
   | Vpc
-  | /** Vestigial: predates the platform/plugin split and names nothing the
-       framework builds. Do not reach for it — platform-level things are
-       `Platform`, and the built-in core PLUGIN is a `Plugin`. */
-  Core
   | Heartbeat
   | Cloner
   | DcbEventLog
@@ -52,7 +48,6 @@ let toString = componentType =>
   | SideEffectHandler => "SideEffectHandler"
   | Task => "Task"
   | Vpc => "Vpc"
-  | Core => "Core"
   | Heartbeat => "Heartbeat"
   | Cloner => "Cloner"
   | DcbEventLog => "DcbEventLog"
@@ -84,7 +79,6 @@ let ofString = str =>
   | "SideEffectHandler" => SideEffectHandler->Some
   | "Task" => Task->Some
   | "Vpc" => Vpc->Some
-  | "Core" => Core->Some
   | "Heartbeat" => Heartbeat->Some
   | "Cloner" => Cloner->Some
   | "DcbEventLog" => DcbEventLog->Some
@@ -117,7 +111,6 @@ let toName = componentType =>
   | SideEffectHandler => "SideEffectHandler"
   | Task => "Task"
   | Vpc => "Vpc"
-  | Core => "Core"
   | Heartbeat => "Heartbeat"
   | Cloner => "Cloner"
   | DcbEventLog => "DcbEventLog"

package/src/ComponentType.res.mjs

@@ -42,8 +42,6 @@ function toString(componentType) {
       return "Task";
     case "Vpc" :
       return "Vpc";
-    case "Core" :
-      return "Core";
     case "Heartbeat" :
       return "Heartbeat";
     case "Cloner" :
@@ -75,8 +73,6 @@ function ofString(str) {
       return "CommandGenerator";
     case "CommandTopic" :
       return "CommandTopic";
-    case "Core" :
-      return "Core";
     case "Counter" :
       return "Counter";
     case "DcbEventLog" :
@@ -166,8 +162,6 @@ function toName(componentType) {
       return "Task";
     case "Vpc" :
       return "Vpc";
-    case "Core" :
-      return "Core";
     case "Heartbeat" :
       return "Heartbeat";
     case "Cloner" :

package/src/plugin/component/Plugin_Builder.res

@@ -575,8 +575,8 @@ module Make = (
     let builderOutputs = {
       // Resolve admin extension point data — from Interstack (AWS cross-stack reference).
       let interstackAdminExtensionPoints =
-        Interstack.coreStackReference->Option.mapOr(Pulumi.Output.make(None), coreStack =>
-          coreStack->Pulumi.StackReference.getOutput("extensionPoints")
+        Interstack.platformStackReference->Option.mapOr(Pulumi.Output.make(None), platformStack =>
+          platformStack->Pulumi.StackReference.getOutput("extensionPoints")
         )
 
       // Derive local admin extension point resolved data (passed from makePlatform).

package/src/plugin/component/Plugin_Builder.res.mjs

@@ -399,7 +399,7 @@ function Make(Spec) {
             components: components
           });
         }
-        let interstackAdminExtensionPoints = Stdlib_Option.mapOr(Interstack$ReventlessCore.coreStackReference, Pulumi.output(undefined), coreStack => coreStack.getOutput("extensionPoints"));
+        let interstackAdminExtensionPoints = Stdlib_Option.mapOr(Interstack$ReventlessCore.platformStackReference, Pulumi.output(undefined), platformStack => platformStack.getOutput("extensionPoints"));
         let localAdminResolvedEP = Output$Pulumi.flatMap(Spec.hooks.adminExtensionPoints.contents, eps => {
           let ep = eps[PluginExtensionPointSpec$ReventlessInfra.name];
           if (ep !== undefined) {

package/src/plugin/connect/PluginExtensionPoint_Plugin.res

@@ -47,7 +47,7 @@ module Make = (Spec: Spec) => {
       switch jsons {
       | [] =>
         EffectLogger.logWarn(
-          ~comp="Core.Plugin",
+          ~comp=PluginExtensionPointSpec.name,
           `ForwardCommand: Couldn't find Plugin with ExtensionPoint ${extensionPointName}`,
         )->Effect.runSync
       | plugins =>
@@ -66,28 +66,31 @@ module Make = (Spec: Spec) => {
             ) {
             | _ =>
               EffectLogger.logInfo(
-                ~comp="Core.Plugin",
+                ~comp=PluginExtensionPointSpec.name,
                 `ForwardCommand: published command to ${plugin.name} ${extensionPoint.commandTopic}`,
               )->Effect.runSync
             | exception err =>
               let errMsg =
                 err->JsExn.fromException->Option.flatMap(JsExn.message)->Option.getOr("unknown")
               EffectLogger.logError(
-                ~comp="Core.Plugin",
+                ~comp=PluginExtensionPointSpec.name,
                 `ForwardCommand: Error on publish command: ${errMsg}`,
               )->Effect.runSync
             }
 
           | None =>
             EffectLogger.logWarn(
-              ~comp="Core.Plugin",
+              ~comp=PluginExtensionPointSpec.name,
               `ForwardCommand: Couldn't find ExtensionPoint ${extensionPointName} in ${plugin.name}`,
             )->Effect.runSync
           }
         | exception err =>
           let errMsg =
             err->JsExn.fromException->Option.flatMap(JsExn.message)->Option.getOr("unknown")
-          EffectLogger.logError(~comp="Core.Plugin", `ForwardCommand: Couldn't decode Plugin: ${errMsg}`)->Effect.runSync
+          EffectLogger.logError(
+            ~comp=PluginExtensionPointSpec.name,
+            `ForwardCommand: Couldn't decode Plugin: ${errMsg}`,
+          )->Effect.runSync
         }
       }
     }
@@ -105,7 +108,7 @@ module Make = (Spec: Spec) => {
         rate: timeout->ScheduleOps.minutesFromNow,
         payload: {
           Message.id,
-          meta: Message.generateMeta(~service="Core.Plugin", ~user="Scheduler"),
+          meta: Message.generateMeta(~service=PluginExtensionPointSpec.name, ~user="Scheduler"),
           command: PluginExtensionPointSpec.DisconnectPlugin,
         }
         ->Message.encodeCommand'(S.string, PluginExtensionPointSpec.commandSchema)
@@ -155,7 +158,10 @@ module Make = (Spec: Spec) => {
           PublishCommand(Plugin.name(id), Delegate.Heartbeat(Plugin.version(id))),
           // Re-arm the disconnect schedule with an interval-scaled grace so a
           // single late beat doesn't trip a spurious disconnect (see disconnectGrace).
-          HandleDirective(directiveHandler, CreateDisconnectSchedule(id, disconnectGrace(interval))),
+          HandleDirective(
+            directiveHandler,
+            CreateDisconnectSchedule(id, disconnectGrace(interval)),
+          ),
         ]
       | RedetectPlugin(interval) => [
           // Deploy-time re-detect: drive Redetect (not Heartbeat) so an already-connected
@@ -163,7 +169,10 @@ module Make = (Spec: Spec) => {
           // re-arm the disconnect schedule exactly like a heartbeat so liveness tracking
           // continues from the deploy moment.
           PublishCommand(Plugin.name(id), Delegate.Redetect(Plugin.version(id))),
-          HandleDirective(directiveHandler, CreateDisconnectSchedule(id, disconnectGrace(interval))),
+          HandleDirective(
+            directiveHandler,
+            CreateDisconnectSchedule(id, disconnectGrace(interval)),
+          ),
         ]
       | ConnectPlugin(pluginDefinition) =>
         // Validate protocol versions declared by the connecting plugin.
@@ -172,7 +181,7 @@ module Make = (Spec: Spec) => {
         let protocolErrors =
           pluginDefinition.extensionProtocols->Array.flatMap(proto =>
             ReventlessInterop.Compat.validateProtocol(
-              ~host=ReventlessInterop.CompatMatrix.corePlugin,
+              ~host=ReventlessInterop.CompatMatrix.platformPlugin,
               ~extensionPointName=proto.extensionPointName,
               ~commandVersion=proto.commandVersion,
               ~eventVersion=proto.eventVersion,
@@ -180,7 +189,7 @@ module Make = (Spec: Spec) => {
           )
         let reportAction = if protocolErrors->Array.length > 0 {
           EffectLogger.logWarn(
-            ~comp="Core.Plugin",
+            ~comp=PluginExtensionPointSpec.name,
             `Protocol version mismatch for plugin ${pluginDefinition.id}: ${protocolErrors
               ->JSON.stringifyAny
               ->Option.getOr("[]")}`,
@@ -197,7 +206,9 @@ module Make = (Spec: Spec) => {
           PublishCommand(Plugin.name(id), Delegate.Disconnect(Plugin.version(id))),
           HandleDirective(directiveHandler, DeleteDisconnectSchedule(id)),
         ]
-      | ForwardCommand(forwardCommand) => [HandleDirective(directiveHandler, ForwardCommand(forwardCommand))]
+      | ForwardCommand(forwardCommand) => [
+          HandleDirective(directiveHandler, ForwardCommand(forwardCommand)),
+        ]
       // Routed to the UiFragmentRegistry slice by the sibling UI-fragment mapping, not the
       // Plugin aggregate — a no-op here.
       | RegisterUiFragment(_) => []
@@ -212,7 +223,10 @@ module Make = (Spec: Spec) => {
         // definition publish with `def.id` (= name@version), preserving the prior
         // cross-plugin wire id.
         | Delegate.VersionDetected(version) => [
-            PublishEvent(Plugin.makeId(id, version), PluginExtensionPointSpec.UnknownPluginDetected),
+            PublishEvent(
+              Plugin.makeId(id, version),
+              PluginExtensionPointSpec.UnknownPluginDetected,
+            ),
           ]
         | VersionConnected(pluginDefinition)
         | VersionPromoted(pluginDefinition) => [

package/src/plugin/connect/PluginExtensionPoint_Plugin.res.mjs

@@ -43,7 +43,7 @@ function Make(Spec) {
       ]
     ], 1000);
     if (jsons.length === 0) {
-      return Effect.runSync(EffectLogger$ReventlessCore.logWarn("Core.Plugin", undefined, `ForwardCommand: Couldn't find Plugin with ExtensionPoint ` + extensionPointName));
+      return Effect.runSync(EffectLogger$ReventlessCore.logWarn(PluginExtensionPointSpec$ReventlessInfra.name, undefined, `ForwardCommand: Couldn't find Plugin with ExtensionPoint ` + extensionPointName));
     }
     let plugin = jsons[0];
     let exit = 0;
@@ -54,12 +54,12 @@ function Make(Spec) {
     } catch (raw_err) {
       let err = Primitive_exceptions.internalToException(raw_err);
       let errMsg = Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_JsExn.fromException(err), Stdlib_JsExn.message), "unknown");
-      return Effect.runSync(EffectLogger$ReventlessCore.logError("Core.Plugin", undefined, `ForwardCommand: Couldn't decode Plugin: ` + errMsg));
+      return Effect.runSync(EffectLogger$ReventlessCore.logError(PluginExtensionPointSpec$ReventlessInfra.name, undefined, `ForwardCommand: Couldn't decode Plugin: ` + errMsg));
     }
     if (exit === 1) {
       let extensionPoint = plugin$1.extensionPoints.find(extensionPoint => extensionPoint.name === extensionPointName);
       if (extensionPoint === undefined) {
-        return Effect.runSync(EffectLogger$ReventlessCore.logWarn("Core.Plugin", undefined, `ForwardCommand: Couldn't find ExtensionPoint ` + extensionPointName + ` in ` + plugin$1.name));
+        return Effect.runSync(EffectLogger$ReventlessCore.logWarn(PluginExtensionPointSpec$ReventlessInfra.name, undefined, `ForwardCommand: Couldn't find ExtensionPoint ` + extensionPointName + ` in ` + plugin$1.name));
       }
       let exit$1 = 0;
       let val;
@@ -69,10 +69,10 @@ function Make(Spec) {
       } catch (raw_err$1) {
         let err$1 = Primitive_exceptions.internalToException(raw_err$1);
         let errMsg$1 = Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_JsExn.fromException(err$1), Stdlib_JsExn.message), "unknown");
-        return Effect.runSync(EffectLogger$ReventlessCore.logError("Core.Plugin", undefined, `ForwardCommand: Error on publish command: ` + errMsg$1));
+        return Effect.runSync(EffectLogger$ReventlessCore.logError(PluginExtensionPointSpec$ReventlessInfra.name, undefined, `ForwardCommand: Error on publish command: ` + errMsg$1));
       }
       if (exit$1 === 2) {
-        return Effect.runSync(EffectLogger$ReventlessCore.logInfo("Core.Plugin", undefined, `ForwardCommand: published command to ` + plugin$1.name + ` ` + extensionPoint.commandTopic));
+        return Effect.runSync(EffectLogger$ReventlessCore.logInfo(PluginExtensionPointSpec$ReventlessInfra.name, undefined, `ForwardCommand: published command to ` + plugin$1.name + ` ` + extensionPoint.commandTopic));
       }
     }
   };
@@ -85,7 +85,7 @@ function Make(Spec) {
           rate: ScheduleOps$ReventlessCore.minutesFromNow(directive._1),
           payload: JSON.stringify(Message$ReventlessCore.encodeCommand$p({
             id: id,
-            meta: Message$ReventlessCore.generateMeta("Core.Plugin", undefined, "Scheduler", undefined, undefined, undefined, undefined, undefined),
+            meta: Message$ReventlessCore.generateMeta(PluginExtensionPointSpec$ReventlessInfra.name, undefined, "Scheduler", undefined, undefined, undefined, undefined, undefined),
             command: "DisconnectPlugin"
           }, S.string, PluginExtensionPointSpec$ReventlessInfra.commandSchema))
         });
@@ -162,8 +162,8 @@ function Make(Spec) {
         ];
       case "ConnectPlugin" :
         let pluginDefinition = cmd._0;
-        let protocolErrors = pluginDefinition.extensionProtocols.flatMap(proto => Compat$ReventlessInterop.validateProtocol(CompatMatrix$ReventlessInterop.corePlugin, proto.extensionPointName, proto.commandVersion, proto.eventVersion));
-        let reportAction = protocolErrors.length !== 0 ? (Effect.runSync(EffectLogger$ReventlessCore.logWarn("Core.Plugin", undefined, `Protocol version mismatch for plugin ` + pluginDefinition.id + `: ` + Stdlib_Option.getOr(JSON.stringify(protocolErrors), "[]"))), [{
+        let protocolErrors = pluginDefinition.extensionProtocols.flatMap(proto => Compat$ReventlessInterop.validateProtocol(CompatMatrix$ReventlessInterop.platformPlugin, proto.extensionPointName, proto.commandVersion, proto.eventVersion));
+        let reportAction = protocolErrors.length !== 0 ? (Effect.runSync(EffectLogger$ReventlessCore.logWarn(PluginExtensionPointSpec$ReventlessInfra.name, undefined, `Protocol version mismatch for plugin ` + pluginDefinition.id + `: ` + Stdlib_Option.getOr(JSON.stringify(protocolErrors), "[]"))), [{
               TAG: "PublishCommand",
               _0: Plugin$ReventlessCore.name(id),
               _1: {

package/src/util/Interstack.res

@@ -1,4 +1,4 @@
-let coreStackReference =
+let platformStackReference =
   Pulumi.Config.make(Some("platform"))
   ->Pulumi.Config.get("stack")
   ->Option.map(stack =>

package/src/util/Interstack.res.mjs

@@ -10,7 +10,7 @@ import * as Query$ReventlessInterop from "@reventlessdev/reventless-interop/src/
 import * as EventMapper$ReventlessInterop from "@reventlessdev/reventless-interop/src/components/EventMapper.res.mjs";
 import * as ExtensionPoint$ReventlessInterop from "@reventlessdev/reventless-interop/src/components/ExtensionPoint.res.mjs";
 
-let coreStackReference = Stdlib_Option.map(new Pulumi.Config("platform").get("stack"), stack => new Pulumi.StackReference(stack + "-interstack", {
+let platformStackReference = Stdlib_Option.map(new Pulumi.Config("platform").get("stack"), stack => new Pulumi.StackReference(stack + "-interstack", {
   name: stack
 }));
 
@@ -115,7 +115,7 @@ let mergeEventMappers = DefaultEventMapperQuery.mergeWith;
 let mergeExtensionPoints = DefaultExtensionPointQuery.mergeWith;
 
 export {
-  coreStackReference,
+  platformStackReference,
   stackDependenciesTasks,
   stackDependenciesEventMappers,
   stackDependenciesExtensionPoints,
@@ -123,4 +123,4 @@ export {
   mergeEventMappers,
   mergeExtensionPoints,
 }
-/* coreStackReference Not a pure module */
+/* platformStackReference Not a pure module */

package/src/util/Interstack.resi

@@ -1,4 +1,4 @@
-let coreStackReference: option<Pulumi.StackReference.t>
+let platformStackReference: option<Pulumi.StackReference.t>
 
 let stackDependenciesTasks: Pulumi.Output.t<
   array<result<ReventlessInterop.Task.resolvedOutputs, ReventlessInterop.Compat.error>>,

package/src/util/Util_StackRefs.res

@@ -1,9 +1,9 @@
 let stackRefs: dict<Pulumi.StackReference.t> = Dict.make()
 
-let coreStackName = Pulumi.Config.make(Some("platform"))->Pulumi.Config.get("stack")
+let platformStackName = Pulumi.Config.make(Some("platform"))->Pulumi.Config.get("stack")
 
 let stackName = pluginName =>
-  coreStackName->Option.map(name => {
+  platformStackName->Option.map(name => {
     let parts = name->String.split("/")
     parts->Array.set(1, pluginName)
     parts->Array.joinUnsafe("/")

package/src/util/Util_StackRefs.res.mjs

@@ -6,10 +6,10 @@ import * as Primitive_option from "@rescript/runtime/lib/es6/Primitive_option.js
 
 let stackRefs = {};
 
-let coreStackName = new Pulumi.Config("platform").get("stack");
+let platformStackName = new Pulumi.Config("platform").get("stack");
 
 function stackName(pluginName) {
-  return Stdlib_Option.map(coreStackName, name => {
+  return Stdlib_Option.map(platformStackName, name => {
     let parts = name.split("/");
     parts[1] = pluginName;
     return parts.join("/");
@@ -32,8 +32,8 @@ function get(pluginName) {
 
 export {
   stackRefs,
-  coreStackName,
+  platformStackName,
   stackName,
   get,
 }
-/* coreStackName Not a pure module */
+/* platformStackName Not a pure module */