@reventlessdev/reventless-core 3.0.0-alpha.326 → 3.0.0-alpha.327

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/package.json +5 -5
  3. package/src/adapter/Runtime/AggregateRuntime_Builder_Common.res.mjs +5 -5
  4. package/src/adapter/Runtime/EventCollectorRuntime_Builder_Single.res.mjs +2 -2
  5. package/src/admin/Platform_Admin_Callback.res.mjs +1 -1
  6. package/src/components/Aggregate/Aggregate_Callback.res +88 -18
  7. package/src/components/Aggregate/Aggregate_Callback.res.mjs +53 -32
  8. package/src/components/AutomationSlice/AutomationSlice_Builder.res.mjs +1 -1
  9. package/src/components/AutomationSlice/AutomationSlice_Callback.res +8 -0
  10. package/src/components/AutomationSlice/AutomationSlice_Callback.res.mjs +16 -12
  11. package/src/components/CommandGenerator/CommandGenerator_Callback.res +47 -6
  12. package/src/components/CommandGenerator/CommandGenerator_Callback.res.mjs +41 -4
  13. package/src/components/CommandTopic/CommandTopic_Callback.res.mjs +1 -1
  14. package/src/components/CommandTopic/CommandTopic_Helpers.res +9 -1
  15. package/src/components/CommandTopic/CommandTopic_Helpers.res.mjs +7 -6
  16. package/src/components/CommandTopic/CommandTopic_Operations.res +2 -0
  17. package/src/components/CommandTopic/CommandTopic_Operations.res.mjs +2 -2
  18. package/src/components/Counter/Counter_Callback.res.mjs +3 -3
  19. package/src/components/Counter/Counter_Operations.res.mjs +4 -4
  20. package/src/components/DcbEventLog/DcbEventLog_Operations.res.mjs +3 -3
  21. package/src/components/EventLog/EventLog_Operations.res +1 -0
  22. package/src/components/EventLog/EventLog_Operations.res.mjs +3 -3
  23. package/src/components/EventMapper/EventMapper_Callback.res +4 -0
  24. package/src/components/EventMapper/EventMapper_Callback.res.mjs +13 -12
  25. package/src/components/EventTopic/EventTopic_Operations.res +2 -0
  26. package/src/components/EventTopic/EventTopic_Operations.res.mjs +2 -2
  27. package/src/components/Extension/Extension_Operations.res +4 -0
  28. package/src/components/Extension/Extension_Operations.res.mjs +8 -8
  29. package/src/components/ExtensionPoint/ExtensionPoint_Callback.res.mjs +2 -2
  30. package/src/components/ExtensionPoint/ExtensionPoint_Operations.res +2 -0
  31. package/src/components/ExtensionPoint/ExtensionPoint_Operations.res.mjs +9 -8
  32. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Callback.res.mjs +1 -1
  33. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Webhook.res.mjs +1 -1
  34. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Builder.res.mjs +1 -1
  35. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res +8 -0
  36. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res.mjs +10 -10
  37. package/src/components/ReadModel/ReadModel_Callback.res +1 -0
  38. package/src/components/ReadModel/ReadModel_Callback.res.mjs +1 -1
  39. package/src/components/SideEffectHandler/SideEffectHandler_Callback.res +2 -0
  40. package/src/components/SideEffectHandler/SideEffectHandler_Callback.res.mjs +6 -6
  41. package/src/components/StateChangeSlice/StateChangeSlice_Callback.res +36 -7
  42. package/src/components/StateChangeSlice/StateChangeSlice_Callback.res.mjs +38 -20
  43. package/src/components/StateViewSlice/StateViewSlice_Builder.res +2 -0
  44. package/src/components/StateViewSlice/StateViewSlice_Builder.res.mjs +2 -2
  45. package/src/components/StateViewSlice/StateViewSlice_Callback.res +6 -0
  46. package/src/components/StateViewSlice/StateViewSlice_Callback.res.mjs +3 -2
  47. package/src/plugin/component/Plugin_Callback.res.mjs +2 -2
  48. package/src/plugin/connect/PluginExtensionPoint_Plugin.res.mjs +6 -6
  49. package/src/util/CommandPublisher.res.mjs +9 -9
  50. package/src/util/EffectLogger.res +85 -17
  51. package/src/util/EffectLogger.res.mjs +63 -12
  52. package/src/util/FTPHandler.res.mjs +6 -6
  53. package/src/util/ScheduleOps.res.mjs +4 -4
  54. package/src/util/Util_AdapterRuntime.res.mjs +2 -2
  55. package/src/util/Util_Promise.res.mjs +1 -1
  56. package/src/util/Util_QueryDbRuntime.res.mjs +1 -1
  57. package/src/util/Validation.res.mjs +1 -1
  58. package/tests/commandgenerator/OwnerStampingTest.res +65 -0
  59. package/tests/commandgenerator/OwnerStampingTest.res.mjs +62 -0
  60. package/tests/commandtopic/CommandOutcomeHookTest.res +25 -0
  61. package/tests/commandtopic/CommandOutcomeHookTest.res.mjs +28 -0
  62. package/tests/commandtopic/CommandTopicHelpersRejectionTest.res.mjs +4 -4
  63. package/tests/logger/ComponentLineIdsTest.res +97 -0
  64. package/tests/logger/ComponentLineIdsTest.res.mjs +118 -0
  65. package/tests/logger/LogFormatTest.res.mjs +5 -5
  66. package/tests/logger/LoggerSinkTest.res.mjs +3 -3
package/CHANGELOG.md CHANGED
@@ -3,6 +3,14 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # 3.0.0-alpha.327 (2026-11-01)
7
+
8
+ ### Features
9
+
10
+ * **core:** a component's log line carries the ids of the message it is about ([9c26267](https://github.com/ReventlessDev/reventless-core/commit/9c26267ca6d03ff66b8406caa32243e205e29b5a))
11
+ * **local:** the registry entry names the platform API, and a command's outcome names its cause ([51717c4](https://github.com/ReventlessDev/reventless-core/commit/51717c441820c19dc59e595559b037b808ca716a))
12
+
13
+
6
14
  # 3.0.0-alpha.326 (2026-11-01)
7
15
 
8
16
  ### Features
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@reventlessdev/reventless-core",
3
- "version": "3.0.0-alpha.326",
3
+ "version": "3.0.0-alpha.327",
4
4
  "description": "Core package for Reventless framework",
5
5
  "license": "Apache-2.0",
6
6
  "jest": {
@@ -28,17 +28,17 @@
28
28
  "dependencies": {
29
29
  "sury": "11.0.0",
30
30
  "uuid": "^13.0.0",
31
- "@reventlessdev/rescript-effect": "1.0.0-alpha.1",
32
31
  "@reventlessdev/rescript-fast-csv": "2.0.0-alpha.25",
32
+ "@reventlessdev/rescript-effect": "1.0.0-alpha.1",
33
33
  "@reventlessdev/rescript-hash-object": "1.2.0-alpha.15",
34
- "@reventlessdev/rescript-node": "2.0.0-alpha.25",
35
34
  "@reventlessdev/rescript-jest": "1.0.0-alpha.13",
35
+ "@reventlessdev/rescript-node": "2.0.0-alpha.25",
36
36
  "@reventlessdev/rescript-pulumi-pulumi": "3.0.0-alpha.0",
37
37
  "@reventlessdev/rescript-ssh2": "2.0.0-alpha.26",
38
38
  "@reventlessdev/rescript-uuid": "2.0.0-alpha.1",
39
- "@reventlessdev/reventless-infra": "3.0.0-alpha.221",
40
39
  "@reventlessdev/reventless-interop": "3.0.0-alpha.42",
41
- "@reventlessdev/reventless-spec": "3.0.0-alpha.192"
40
+ "@reventlessdev/reventless-spec": "3.0.0-alpha.192",
41
+ "@reventlessdev/reventless-infra": "3.0.0-alpha.221"
42
42
  },
43
43
  "devDependencies": {
44
44
  "rescript": "12.3.1",
@@ -29,30 +29,30 @@ function Make(RuntimeEnvironment) {
29
29
  if (info !== undefined) {
30
30
  let handler = commandGeneratorHandlers[info];
31
31
  if (handler !== undefined) {
32
- Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, `found CommandGenerator handler for ` + info));
32
+ Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, undefined, `found CommandGenerator handler for ` + info));
33
33
  await runEffect(handler(event, context));
34
34
  return;
35
35
  }
36
36
  let available = Object.keys(commandGeneratorHandlers).join(",");
37
- return Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `no handler found: ` + info + ` available=[` + available + `]`));
37
+ return Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, undefined, `no handler found: ` + info + ` available=[` + available + `]`));
38
38
  }
39
39
  await Promise.all(Object.entries(RuntimeEnvironment.groupBySource(event)).map(async param => {
40
40
  let event = param[1];
41
41
  let urn = param[0];
42
42
  let handler = commandTopicHandlers[urn];
43
43
  if (handler !== undefined) {
44
- Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, `found CommandTopic handler for ` + urn));
44
+ Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, undefined, `found CommandTopic handler for ` + urn));
45
45
  return await runEffect(handler(event, context));
46
46
  }
47
47
  let handlers = eventCollectorHandlers[urn];
48
48
  if (handlers !== undefined) {
49
49
  let count = handlers.length.toString();
50
- Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, `found ` + count + ` EventCollector handler(s) for ` + urn));
50
+ Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, undefined, `found ` + count + ` EventCollector handler(s) for ` + urn));
51
51
  await Promise.all(handlers.map(param => Runtime$ReventlessCore.runEffect(correlationId, causationId, param.comp, undefined, timestamp, retryCount, undefined, undefined, param.handler(event, context))));
52
52
  return;
53
53
  }
54
54
  let available = Object.keys(commandTopicHandlers).concat(Object.keys(eventCollectorHandlers)).join(",");
55
- return Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `no handler found: ` + urn + ` available=[` + available + `]`));
55
+ return Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, undefined, `no handler found: ` + urn + ` available=[` + available + `]`));
56
56
  }));
57
57
  });
58
58
  let getRuntimeSpec = aggregate => Stdlib_Option.getOr(runtimeSpecs[Stdlib_Option.getOr(aggregate.__name, "Unnamed")], {
@@ -38,10 +38,10 @@ function Make(RuntimeEnvironment) {
38
38
  let urn = param[0];
39
39
  let handlers = eventCollectorHandlers[urn];
40
40
  if (handlers === undefined) {
41
- return Effect.runSync(EffectLogger$ReventlessCore.logWarn(groupComp, undefined, `no handler found: ` + urn));
41
+ return Effect.runSync(EffectLogger$ReventlessCore.logWarn(groupComp, undefined, undefined, `no handler found: ` + urn));
42
42
  }
43
43
  let count = handlers.length.toString();
44
- Effect.runSync(EffectLogger$ReventlessCore.logDebug(groupComp, undefined, `found ` + count + ` handler(s) for ` + urn));
44
+ Effect.runSync(EffectLogger$ReventlessCore.logDebug(groupComp, undefined, undefined, `found ` + count + ` handler(s) for ` + urn));
45
45
  await Promise.all(handlers.map(param => Runtime$ReventlessCore.runEffect(correlationId, causationId, param.comp, undefined, timestamp, retryCount, undefined, undefined, param.handler(event, context))));
46
46
  }));
47
47
  });
@@ -7,7 +7,7 @@ import * as EffectLogger$ReventlessCore from "../util/EffectLogger.res.mjs";
7
7
  import * as Platform_Admin_Structure$ReventlessCore from "./Platform_Admin_Structure.res.mjs";
8
8
 
9
9
  function Make(Spec) {
10
- let handleJsonEvents = stream => Stream.runDrain(Stream.mapEffect(stream, eventJson$p => Effect.zipRight(EffectLogger$ReventlessCore.logInfo(Platform_Admin_Structure$ReventlessCore.pluginId, undefined, `handleJsonEvents: outgoing event: ` + LogFormat$ReventlessCore.event$pJsonToLogMessage(eventJson$p)), Effect.map(Effect.all(Spec.outgoingExtensionPointJsonEventsHandlers.map(handleEvent => Effect.promise(() => handleEvent(eventJson$p, Spec.pluginDefinition))), {
10
+ let handleJsonEvents = stream => Stream.runDrain(Stream.mapEffect(stream, eventJson$p => Effect.zipRight(EffectLogger$ReventlessCore.logInfo(Platform_Admin_Structure$ReventlessCore.pluginId, undefined, undefined, `handleJsonEvents: outgoing event: ` + LogFormat$ReventlessCore.event$pJsonToLogMessage(eventJson$p)), Effect.map(Effect.all(Spec.outgoingExtensionPointJsonEventsHandlers.map(handleEvent => Effect.promise(() => handleEvent(eventJson$p, Spec.pluginDefinition))), {
11
11
  concurrency: "unbounded"
12
12
  }), param => {}))));
13
13
  return {
@@ -95,7 +95,7 @@ module Make = (
95
95
  state: Decision.state,
96
96
  owners: array<string>,
97
97
  causes: array<string>,
98
- outcomes: array<(string, cmdOutcome, Message.meta)>,
98
+ outcomes: array<(string, cmdOutcome, Message.meta, option<string>)>,
99
99
  }
100
100
 
101
101
  // Folds a single command into the running accumulator. A domain rejection from
@@ -111,6 +111,7 @@ module Make = (
111
111
  let {reference, command: command'} = topicItem
112
112
  let meta = command'->updateMeta
113
113
  let id = command'.id->Spec.Id.toString
114
+ let ids = EffectLogger.idsOf(command'.meta, ~entityId=id, ~entityType=Spec.name)
114
115
  // Identity, not content: the folded state grows with the entity's whole
115
116
  // history, so serialising it here makes the line's size a function of how
116
117
  // long the system has been in use. The state at decision time is a
@@ -120,6 +121,7 @@ module Make = (
120
121
  let cmdName = cmdVariant->LogFormat.bold
121
122
  EffectLogger.logDebug(
122
123
  ~comp,
124
+ ~ids,
123
125
  `deciding: id=${id} seq=${seq->Int.toString} cmd=${cmdName}`,
124
126
  )->Effect.runSync
125
127
  // Before `decide`, first: a command with a stable id that the stream already
@@ -140,16 +142,31 @@ module Make = (
140
142
  | _ if repeated =>
141
143
  EffectLogger.logInfo(
142
144
  ~comp,
145
+ ~ids,
143
146
  `repeat dropped: ${cmdName}(${id}) msgId=${command'.meta.msgId} already caused events`,
144
147
  )->Effect.runSync
145
- {...acc, outcomes: Array.concat(outcomes, [(reference, CmdRepeated, meta)])}
148
+ {
149
+ ...acc,
150
+ outcomes: Array.concat(
151
+ outcomes,
152
+ [(reference, CmdRepeated, meta, command'.meta.causationId)],
153
+ ),
154
+ }
146
155
  | Some(refused) =>
147
156
  let line = `refused: ${refused.rejected.errorDetail} id=${id}`
148
157
 
149
158
  (
150
- refused.isDefect ? EffectLogger.logError(~comp, line) : EffectLogger.logWarn(~comp, line)
159
+ refused.isDefect
160
+ ? EffectLogger.logError(~comp, line)
161
+ : EffectLogger.logWarn(~comp, ~ids, line)
151
162
  )->Effect.runSync
152
- {...acc, outcomes: Array.concat(outcomes, [(reference, CmdRefused(refused), meta)])}
163
+ {
164
+ ...acc,
165
+ outcomes: Array.concat(
166
+ outcomes,
167
+ [(reference, CmdRefused(refused), meta, command'.meta.causationId)],
168
+ ),
169
+ }
153
170
  | None =>
154
171
  switch Decision.decide(state, command'.command) {
155
172
  | Ok(generatedEvents) =>
@@ -160,7 +177,10 @@ module Make = (
160
177
  causes: generatedEvents->Array.length == 0
161
178
  ? causes
162
179
  : causes->Array.concat([command'.meta.msgId]),
163
- outcomes: Array.concat(outcomes, [(reference, CmdOk(generatedEvents), meta)]),
180
+ outcomes: Array.concat(
181
+ outcomes,
182
+ [(reference, CmdOk(generatedEvents), meta, command'.meta.causationId)],
183
+ ),
164
184
  }
165
185
  | Error(error) =>
166
186
  let errorJson = error->Message.encode(Spec.errorSchema)
@@ -173,13 +193,14 @@ module Make = (
173
193
  : payloadDict->JSON.Encode.object->JSON.stringify
174
194
  EffectLogger.logError(
175
195
  ~comp,
196
+ ~ids,
176
197
  `decide rejected: ${errorCode} ${errorDetail} id=${id}`,
177
198
  )->Effect.runSync
178
199
  {
179
200
  ...acc,
180
201
  outcomes: Array.concat(
181
202
  outcomes,
182
- [(reference, CmdRejected({errorCode, errorDetail}), meta)],
203
+ [(reference, CmdRejected({errorCode, errorDetail}), meta, command'.meta.causationId)],
183
204
  ),
184
205
  }
185
206
  }
@@ -275,6 +296,25 @@ module Make = (
275
296
  // latest persisted snapshot (hash-gated) and replay only the events after it;
276
297
  // otherwise replay full history from seq 0. Returns `(state, sequenceNr, owners)`
277
298
  // where sequenceNr is the total event count (the OCC condition for the next append).
299
+ // The entity a line is about, and its flow when every command of the batch shares one.
300
+ let entityIds = (idStr): EffectLogger.ids => {entityId: idStr, entityType: Spec.name}
301
+ let batchIds = (
302
+ idStr,
303
+ items: array<CommandTopic.topicItem<Message.command'<Spec.Id.t, Spec.command>>>,
304
+ ): EffectLogger.ids => {
305
+ let flows = items->Array.map(i => i.command.meta.correlationId)
306
+ let one = switch flows[0] {
307
+ | Some(f) => flows->Array.every(x => x == f) ? Some(f) : None
308
+ | None => None
309
+ }
310
+ {
311
+ entityId: idStr,
312
+ entityType: Spec.name,
313
+ correlationId: ?one,
314
+ msgId: ?(items->Array.length == 1 ? items[0]->Option.map(i => i.command.meta.msgId) : None),
315
+ }
316
+ }
317
+
278
318
  let coldReadState = id => {
279
319
  let idStr = id->Spec.Id.toString
280
320
  let seedEffect = switch snapshotConfig {
@@ -288,6 +328,7 @@ module Make = (
288
328
  | None =>
289
329
  EffectLogger.logWarn(
290
330
  ~comp,
331
+ ~ids=entityIds(idStr),
291
332
  `snapshot ignored (undecodable): id=${idStr}, seq=${snap.seqNr->Int.toString} — full replay`,
292
333
  )->Effect.runSync
293
334
  (Decision.initialState, 0)
@@ -295,6 +336,7 @@ module Make = (
295
336
  | Ok(Some(snap)) =>
296
337
  EffectLogger.logWarn(
297
338
  ~comp,
339
+ ~ids=entityIds(idStr),
298
340
  `snapshot ignored (schema drift): id=${idStr}, seq=${snap.EventLog.seqNr->Int.toString} — full replay`,
299
341
  )->Effect.runSync
300
342
  (Decision.initialState, 0)
@@ -302,6 +344,7 @@ module Make = (
302
344
  | Error(msg) =>
303
345
  EffectLogger.logWarn(
304
346
  ~comp,
347
+ ~ids=entityIds(idStr),
305
348
  `snapshot read failed (ignored): id=${idStr}: ${msg} — full replay`,
306
349
  )->Effect.runSync
307
350
  (Decision.initialState, 0)
@@ -320,7 +363,7 @@ module Make = (
320
363
  seedSeq > 0
321
364
  ? `(snapshot@${seedSeq->Int.toString}, ${(n - seedSeq)->Int.toString} delta event(s))`
322
365
  : `${n->Int.toString} event(s)`
323
- EffectLogger.logInfo(~comp, `replay: id=${idStr}, ${detail}`)
366
+ EffectLogger.logInfo(~comp, ~ids=entityIds(idStr), `replay: id=${idStr}, ${detail}`)
324
367
  })
325
368
  )
326
369
  }
@@ -345,6 +388,7 @@ module Make = (
345
388
  ->Effect.tap(((_, n, _, _)) =>
346
389
  EffectLogger.logInfo(
347
390
  ~comp,
391
+ ~ids=entityIds(idStr),
348
392
  `replay (with causes, for a stable-id command): id=${idStr}, ${n->Int.toString} event(s)`,
349
393
  )
350
394
  )
@@ -360,11 +404,13 @@ module Make = (
360
404
  | Ok() =>
361
405
  EffectLogger.logDebug(
362
406
  ~comp,
407
+ ~ids=entityIds(idStr),
363
408
  `snapshot written: id=${idStr}, seq=${snap.seqNr->Int.toString}`,
364
409
  )->Effect.runSync
365
410
  | Error(msg) =>
366
411
  EffectLogger.logWarn(
367
412
  ~comp,
413
+ ~ids=entityIds(idStr),
368
414
  `snapshot write failed (ignored): id=${idStr}: ${msg}`,
369
415
  )->Effect.runSync
370
416
  }
@@ -374,6 +420,7 @@ module Make = (
374
420
  let msg = err->JsExn.fromException->Option.flatMap(JsExn.message)->Option.getOr("unknown")
375
421
  EffectLogger.logWarn(
376
422
  ~comp,
423
+ ~ids=entityIds(idStr),
377
424
  `snapshot write threw (ignored): id=${idStr}: ${msg}`,
378
425
  )->Effect.runSync
379
426
  Promise.resolve()
@@ -397,6 +444,7 @@ module Make = (
397
444
  | None =>
398
445
  EffectLogger.logWarn(
399
446
  ~comp,
447
+ ~ids=entityIds(idStr),
400
448
  `snapshot skipped (state not serializable): id=${idStr}, seq=${newSeq->Int.toString}`,
401
449
  )->Effect.runSync
402
450
  }
@@ -408,18 +456,19 @@ module Make = (
408
456
  // are always Ok(reference) — SQS deletes the message because retry would not help —
409
457
  // and the rich error code/detail flows to producers via reportRejected.
410
458
  let reportFinalOutcomes = (
411
- outcomes: array<(string, cmdOutcome, Message.meta)>,
459
+ outcomes: array<(string, cmdOutcome, Message.meta, option<string>)>,
412
460
  ~entityId: string,
413
461
  ~appendSucceeded: bool,
414
462
  ~appendedEventCount: int,
415
463
  ~appendErrorDetail: string="",
416
464
  ): array<result<string, string>> =>
417
- outcomes->Array.map(((reference, outcome, meta: Message.meta)) =>
465
+ outcomes->Array.map(((reference, outcome, meta: Message.meta, causedBy)) =>
418
466
  switch outcome {
419
467
  | CmdRejected({errorCode, errorDetail}) =>
420
468
  CommandTopic_Helpers.reportRejected(
421
469
  ~component=Spec.name,
422
470
  ~correlationId=meta.correlationId,
471
+ ~causationId=?causedBy,
423
472
  ~cause=DomainRejection,
424
473
  reference,
425
474
  {errorCode, errorDetail},
@@ -429,6 +478,7 @@ module Make = (
429
478
  CommandTopic_Helpers.reportRejected(
430
479
  ~component=Spec.name,
431
480
  ~correlationId=meta.correlationId,
481
+ ~causationId=?causedBy,
432
482
  ~cause=AccessRefusal,
433
483
  reference,
434
484
  rejected,
@@ -438,6 +488,7 @@ module Make = (
438
488
  CommandTopic_Helpers.reportAccepted(
439
489
  ~component=Spec.name,
440
490
  ~correlationId=meta.correlationId,
491
+ ~causationId=?causedBy,
441
492
  reference,
442
493
  {entityId, eventCount: appendedEventCount},
443
494
  )
@@ -446,6 +497,7 @@ module Make = (
446
497
  CommandTopic_Helpers.reportAccepted(
447
498
  ~component=Spec.name,
448
499
  ~correlationId=meta.correlationId,
500
+ ~causationId=?causedBy,
449
501
  reference,
450
502
  {entityId, eventCount: 0},
451
503
  )
@@ -455,6 +507,7 @@ module Make = (
455
507
  CommandTopic_Helpers.reportRejected(
456
508
  ~component=Spec.name,
457
509
  ~correlationId=meta.correlationId,
510
+ ~causationId=?causedBy,
458
511
  ~cause=InfrastructureFailure,
459
512
  reference,
460
513
  {errorCode: Reventless.CommandOutcome.code(AppendFailed), errorDetail: appendErrorDetail},
@@ -488,6 +541,7 @@ module Make = (
488
541
  | Some((state, seqNr, owners)) =>
489
542
  EffectLogger.logInfo(
490
543
  ~comp,
544
+ ~ids=batchIds(idStr, topicItemsForId),
491
545
  `replay skipped (cached): id=${idStr}, seq=${seqNr->Int.toString}`,
492
546
  )->Effect.map(_ => (state, seqNr, owners, []))
493
547
  | None =>
@@ -504,7 +558,7 @@ module Make = (
504
558
 
505
559
  let eventsToAppend =
506
560
  outcomes
507
- ->Array.map(((_reference, outcome, meta)) =>
561
+ ->Array.map(((_reference, outcome, meta, _)) =>
508
562
  switch outcome {
509
563
  | CmdOk(events) => events->Array.map(event => {Message.id, meta, event})
510
564
  | CmdRejected(_) | CmdRefused(_) | CmdRepeated => []
@@ -523,7 +577,11 @@ module Make = (
523
577
  ~appendSucceeded=true,
524
578
  ~appendedEventCount=0,
525
579
  )
526
- EffectLogger.logInfo(~comp, `no events produced: id=${idStr}`)->Effect.map(_ => Ok(perRef))
580
+ EffectLogger.logInfo(
581
+ ~comp,
582
+ ~ids=batchIds(idStr, topicItemsForId),
583
+ `no events produced: id=${idStr}`,
584
+ )->Effect.map(_ => Ok(perRef))
527
585
  | generatedEvents' =>
528
586
  let eventCount = generatedEvents'->Array.length->Int.toString
529
587
  let eventDetails =
@@ -531,6 +589,7 @@ module Make = (
531
589
  let eventJsons = generatedEvents'->Array.map(event' => event'->eventJson)->JSON.Encode.array
532
590
  EffectLogger.logInfo(
533
591
  ~comp,
592
+ ~ids=batchIds(idStr, topicItemsForId),
534
593
  ~detail=eventJsons,
535
594
  `produced ${eventCount} event(s): [${eventDetails}]`,
536
595
  )
@@ -553,7 +612,11 @@ module Make = (
553
612
  ~appendSucceeded=true,
554
613
  ~appendedEventCount=generatedEvents'->Array.length,
555
614
  )
556
- EffectLogger.logInfo(~comp, `append: id=${idStr}`)->Effect.map(_ => Ok(perRef))
615
+ EffectLogger.logInfo(
616
+ ~comp,
617
+ ~ids=batchIds(idStr, topicItemsForId),
618
+ `append: id=${idStr}`,
619
+ )->Effect.map(_ => Ok(perRef))
557
620
  | Error(EventLog.Conflict) =>
558
621
  // Another writer advanced the stream past our (possibly cached)
559
622
  // sequenceNr — drop the entry so the retry replays cold.
@@ -561,9 +624,11 @@ module Make = (
561
624
  // Signal the outer replay+re-decide retry loop (which matches
562
625
  // Error(_)); the string is an internal marker, no longer a
563
626
  // cross-component substring sentinel.
564
- EffectLogger.logWarn(~comp, `conflict: id=${idStr}, will retry`)->Effect.map(
565
- _ => Error("conflict"),
566
- )
627
+ EffectLogger.logWarn(
628
+ ~comp,
629
+ ~ids=batchIds(idStr, topicItemsForId),
630
+ `conflict: id=${idStr}, will retry`,
631
+ )->Effect.map(_ => Error("conflict"))
567
632
  | Error(EventLog.StorageFailure(msg)) =>
568
633
  // Appends are atomic, so the read snapshot is likely still valid —
569
634
  // but a storage error means we can't be sure what committed;
@@ -576,9 +641,11 @@ module Make = (
576
641
  ~appendedEventCount=0,
577
642
  ~appendErrorDetail=msg,
578
643
  )
579
- EffectLogger.logError(~comp, `append failed: id=${idStr}: ${msg}`)->Effect.map(
580
- _ => Ok(perRef),
581
- )
644
+ EffectLogger.logError(
645
+ ~comp,
646
+ ~ids=batchIds(idStr, topicItemsForId),
647
+ `append failed: id=${idStr}: ${msg}`,
648
+ )->Effect.map(_ => Ok(perRef))
582
649
  }
583
650
  )
584
651
  }
@@ -617,6 +684,7 @@ module Make = (
617
684
  let idxStr = (idx + 1)->Int.toString
618
685
  EffectLogger.logInfo(
619
686
  ~comp,
687
+ ~ids=EffectLogger.idsOf(cmdJson.meta, ~entityId=idStr, ~entityType=Spec.name),
620
688
  ~detail=cmdJson.commandJson,
621
689
  `handling command ${idxStr}/${count}: ${LogFormat.cmdDetail(cmdJson)}`,
622
690
  )->Effect.runSync
@@ -635,6 +703,7 @@ module Make = (
635
703
  | Error(_) if retryCount < maxConflictRetries =>
636
704
  EffectLogger.logWarn(
637
705
  ~comp,
706
+ ~ids=batchIds(idStr, topicItemsForId),
638
707
  `conflict retry id=${idStr} ${(retryCount + 1)
639
708
  ->Int.toString}/${maxConflictRetries->Int.toString}`,
640
709
  )->Effect.flatMap(_ => attempt(retryCount + 1))
@@ -642,6 +711,7 @@ module Make = (
642
711
  let detail = `concurrent modification (${maxConflictRetries->Int.toString} retries exhausted): ${msg}`
643
712
  EffectLogger.logError(
644
713
  ~comp,
714
+ ~ids=batchIds(idStr, topicItemsForId),
645
715
  `max conflict retries exhausted id=${idStr}: ${msg}`,
646
716
  )->Effect.map(_ => references->Array.map(_ => Error(detail)))
647
717
  },