@reventlessdev/reventless-spec 3.0.0-alpha.167 → 3.0.0-alpha.169

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.169 (2026-10-19)
+
+### Features
+
+* **gwt:** record behaviour scenarios as they run, for suites whose source names none ([256b253](https://github.com/ReventlessDev/reventless-core/commit/256b253153ec043105c38ac742a1a3efbde48c87))
+* **spec,aws,local:** tell the host shell which environment it runs in, and write local host UI files into a chosen assetsDir ([4f896d1](https://github.com/ReventlessDev/reventless-core/commit/4f896d13ae9ec0d211c33dbd9271e7197cfebc41))
+
+
+# 3.0.0-alpha.168 (2026-10-17)
+
+**Note:** Version bump only for package @reventlessdev/reventless-spec
+
+
+
+
+
 # 3.0.0-alpha.167 (2026-10-16)
 
 * feat!(inbound): a translation slice can declare a signed webhook URL ([0ad6994](https://github.com/ReventlessDev/reventless-core/commit/0ad69949fcc91c2756c60ca8cb120dd468841d8b))

package/package.json

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

package/src/components/AutomationSlice.res

@@ -39,11 +39,10 @@ let process = (id, item) =>
   Some((id, CreateShipment({orderId: item.orderId, address: item.shippingAddress})))
 
 let maxRetries = 3
-let heartbeatInterval = 60
 ```
 */
 /**
-The lean Spec for an AutomationSlice — types, identity, schemas, sweep config.
+The lean Spec for an AutomationSlice — types, identity, schemas, retry config.
 
 Plan 04 dropped `consumedEvent` from the Spec — the framework now derives the
 consumed-event set from each per-source Mapping's `sourceEventSchema`, so a
@@ -67,9 +66,6 @@ module type Spec = {
   /** Maximum number of retries for a failed processing attempt. */
   let maxRetries: int
 
-  /** Heartbeat interval in seconds for sweeping pending/failed items. */
-  let heartbeatInterval: int
-
   /** Name of the aggregate or StateChangeSlice that receives the produced command. */
   let targetName: string
 

package/src/components/OutboundTranslationSlice.res

@@ -15,7 +15,7 @@ Event(s) -> TODO List (read model) -> Translator -> External Service
 
 Plan 02 splits the merged spec into two module types:
 
-- `Spec` — types, identity, schemas, sweep config. Per D2, `outboundItem`
+- `Spec` — types, identity, schemas, retry config. Per D2, `outboundItem`
   lives here (persisted TODO state with schema).
 - `Translation` — `collect` (sync, observable in tests) and `translate`
   (async, mocked in tests via `whenTranslateMocked`).
@@ -41,11 +41,10 @@ let translate = async (_id, item, ~capabilities as _) => {
 }
 
 let maxRetries = 3
-let heartbeatInterval = 60
 ```
 */
 /**
-The lean Spec for an OutboundTranslationSlice — types, identity, schemas, sweep config.
+The lean Spec for an OutboundTranslationSlice — types, identity, schemas, retry config.
 */
 module type Spec = {
   /** Logical name of this outbound translation slice (used as a component prefix). */
@@ -71,9 +70,6 @@ module type Spec = {
   /** Maximum number of retries for a failed translate attempt. */
   let maxRetries: int
 
-  /** Heartbeat interval in seconds for sweeping pending/failed items. */
-  let heartbeatInterval: int
-
   /** Name of the aggregate or StateChangeSlice that receives the inbound command, or None for fire-and-forget. */
   let targetName: option<string>
 

package/src/types/ShellEnvironment.res

@@ -0,0 +1,39 @@
+/***
+Which environment a host shell runs in, as `config.json` tells it: the name, and
+the purpose when it is known. The shell badges everything that is not
+`production`, so an unknown purpose shows rather than hides.
+
+One answer for every caller, from the two the deploy already gives: a declared
+environment ([DeploymentProvenance]) and the stacks the platform treats as
+production. Pure; the caller passes the stack and the list.
+*/
+
+type t = {name: string, purpose: option<string>}
+
+let nameKey = "environment"
+let purposeKey = "environmentPurpose"
+
+/** What the local platform says about itself. */
+let local = {name: "local", purpose: Some("local")}
+
+/**
+The declared environment wins over the stack, its purpose over the stack list.
+A stack in `prodStacks` with no declared purpose is `production`; any other is
+unknown.
+*/
+let resolve = (
+  ~provenance: DeploymentProvenance.t,
+  ~stack: string,
+  ~prodStacks: array<string>,
+): t => {
+  name: provenance.environment->Option.getOr(stack),
+  purpose: provenance.purpose->Option.orElse(
+    prodStacks->Array.includes(stack) ? Some(Environments.purposeName(Production)) : None,
+  ),
+}
+
+/** The `config.json` entries; no purpose key when the purpose is unknown. */
+let configFields = (env: t): array<(string, JSON.t)> =>
+  [(nameKey, JSON.Encode.string(env.name))]->Array.concat(
+    env.purpose->Option.mapOr([], p => [(purposeKey, JSON.Encode.string(p))]),
+  )

package/src/types/ShellEnvironment.res.mjs

@@ -0,0 +1,39 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Environments$Reventless from "./Environments.res.mjs";
+
+let nameKey = "environment";
+
+let purposeKey = "environmentPurpose";
+
+function resolve(provenance, stack, prodStacks) {
+  return {
+    name: Stdlib_Option.getOr(provenance.environment, stack),
+    purpose: Stdlib_Option.orElse(provenance.purpose, prodStacks.includes(stack) ? Environments$Reventless.purposeName("Production") : undefined)
+  };
+}
+
+function configFields(env) {
+  return [[
+      nameKey,
+      env.name
+    ]].concat(Stdlib_Option.mapOr(env.purpose, [], p => [[
+      purposeKey,
+      p
+    ]]));
+}
+
+let local = {
+  name: "local",
+  purpose: "local"
+};
+
+export {
+  nameKey,
+  purposeKey,
+  local,
+  resolve,
+  configFields,
+}
+/* Environments-Reventless Not a pure module */