@almadar/std 16.226.0 → 16.228.0

package/behaviors/registry/infra/atoms/std-audit-capture.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-audit-capture — event-interceptor audit log / audit trail. Use when a user voices that a record's changes must be tracked, logged, or auditable (audit trail, track changes, change history, who edited what, mutation log, record changes, log every edit, edit history, modification log, who did what when, accountability log). Listens for the generic `EntityMutated` sentinel (rename via traitOverrides.events to the real mutation event, e.g. ContactSaved) and persists an AuditEntry row capturing actor, action, entity type/id, before/after snapshots, and timestamp. `captureEventTypes` filters on @payload.data.kind (empty = capture all). Compose with `std-lifecycle` to apply retention. Composable via `extraTraits` to interpose audit logging behind any mutating trait.",
+  "description": "std-audit-capture — event-interceptor audit log / audit trail. Use when a user voices that a record's changes must be tracked, logged, or auditable (audit trail, track changes, change history, who edited what, mutation log, record changes, log every edit, edit history, modification log, who did what when, accountability log). Listens for the generic `EntityMutated` sentinel (rename via traitOverrides.events to the real mutation event, e.g. ContactSaved) and persists an AuditEntry row capturing actor, action, entity type/id, before/after snapshots, and timestamp. `captureEventTypes` filters on @payload.data.kind, or on the delivered event's own name when the payload carries no kind (empty = capture all). Every entry also records where the change came from — the delivering event, the behavior and module that emitted it, and the scheduled job when a tick caused it — with no change to the upstream emitter. Compose with `std-lifecycle` to apply retention. Composable via `extraTraits` to interpose audit logging behind any mutating trait.",
   "ledger": {
     "entries": {
       "ent_01KXG04F0MSA7QDPSYJHC2YPRH": {
@@ -120,6 +120,34 @@
             "name": "recordedAt",
             "synonyms": "timestamp, date, time",
             "type": "number"
+          },
+          {
+            "default": "",
+            "description": "The event that delivered the change to the audit trail, e.g. ContactSaved.",
+            "name": "sourceEvent",
+            "synonyms": "triggering event, cause, origin event",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "The behavior that emitted the change.",
+            "name": "sourceTrait",
+            "synonyms": "emitter, origin, raised by",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "The module the change came from.",
+            "name": "sourceOrbital",
+            "synonyms": "origin module, source module",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "The scheduled job that caused the change; blank when a person or an event did.",
+            "name": "sourceTick",
+            "synonyms": "scheduled job, background job, timer",
+            "type": "string"
           }
         ],
         "id": "ent_01KXG04F0MSA7QDPSYJHC2YPRH",
@@ -166,7 +194,7 @@
             },
             "captureEventTypes": {
               "default": [],
-              "description": "When set, only @payload.data.kind values in this list are audited. Empty list = capture every event. Requires the upstream event to include a `kind` field on its payload.",
+              "description": "When set, only these kinds are audited: the payload's `kind` field, or the delivering event's name when there is no kind. Empty list = capture every event.",
               "items": {
                 "type": "string"
               },
@@ -263,6 +291,22 @@
                 {
                   "name": "recordedAt",
                   "type": "number"
+                },
+                {
+                  "name": "sourceEvent",
+                  "type": "string"
+                },
+                {
+                  "name": "sourceTrait",
+                  "type": "string"
+                },
+                {
+                  "name": "sourceOrbital",
+                  "type": "string"
+                },
+                {
+                  "name": "sourceTick",
+                  "type": "string"
                 }
               ],
               "scope": "external"
@@ -326,6 +370,22 @@
                   {
                     "name": "recordedAt",
                     "type": "number"
+                  },
+                  {
+                    "name": "sourceEvent",
+                    "type": "string"
+                  },
+                  {
+                    "name": "sourceTrait",
+                    "type": "string"
+                  },
+                  {
+                    "name": "sourceOrbital",
+                    "type": "string"
+                  },
+                  {
+                    "name": "sourceTick",
+                    "type": "string"
                   }
                 ]
               }
@@ -358,7 +418,7 @@
                           "object/get",
                           "@payload.data",
                           "kind",
-                          ""
+                          "@event.event"
                         ]
                       ]
                     ],
@@ -376,7 +436,7 @@
                           "object/get",
                           "@payload.data",
                           "kind",
-                          "EntityMutated"
+                          "@event.event"
                         ]
                       ],
                       [
@@ -448,7 +508,23 @@
                           "before": "@entity.before",
                           "entityId": "@entity.entityId",
                           "entityType": "@config.captureEntity",
-                          "recordedAt": 0.0
+                          "recordedAt": 0.0,
+                          "sourceEvent": "@event.event",
+                          "sourceOrbital": [
+                            "str/default",
+                            "@event.source.orbital",
+                            ""
+                          ],
+                          "sourceTick": [
+                            "str/default",
+                            "@event.source.tick",
+                            ""
+                          ],
+                          "sourceTrait": [
+                            "str/default",
+                            "@event.source.trait",
+                            ""
+                          ]
                         }
                       ],
                       [
@@ -459,7 +535,23 @@
                           "actor": "@user.id",
                           "entityId": "@entity.entityId",
                           "entityType": "@config.captureEntity",
-                          "recordedAt": 0.0
+                          "recordedAt": 0.0,
+                          "sourceEvent": "@event.event",
+                          "sourceOrbital": [
+                            "str/default",
+                            "@event.source.orbital",
+                            ""
+                          ],
+                          "sourceTick": [
+                            "str/default",
+                            "@event.source.tick",
+                            ""
+                          ],
+                          "sourceTrait": [
+                            "str/default",
+                            "@event.source.trait",
+                            ""
+                          ]
                         }
                       ]
                     ]
@@ -478,5 +570,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "1.2.0"
+  "version": "1.3.0"
 }

package/behaviors/registry/infra/atoms/std-calendar-sync.orb

@@ -1805,7 +1805,8 @@
                 ]
               ],
               "interval": "*/15 * * * *",
-              "name": "syncCycle"
+              "name": "syncCycle",
+              "runsInBackground": true
             }
           ]
         }

package/behaviors/registry/infra/atoms/std-data-erasure.orb

@@ -1833,7 +1833,8 @@
                 ]
               ],
               "interval": "0 * * * *",
-              "name": "executionScan"
+              "name": "executionScan",
+              "runsInBackground": true
             }
           ],
           "traitEmbedIds": {

package/behaviors/registry/infra/atoms/std-global-search.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-global-search — cross-module federated search. Use when a user voices that one search box should query several modules at once (global search, search everything, unified search, cross-module search, federated search, search across records, omnisearch, one search box, aggregated results, grouped results). One SEARCH event fans out to every module key listed in the `modules` config (comma-separated, deterministic — no registry magic): the trait walks the parsed key list with an internal FAN_OUT_STEP sentinel and emits one scoped MODULE_SEARCH_REQUESTED { moduleKey, queryText, typeFilter, scopeJson } -> external per key, so modules respond in parallel rather than in sequence. Modules answer with SEARCH_RESULTS { moduleKey, resultsJson }; each answer appends a SearchResultGroup to the entity, so the merged view stays grouped by module. Client/person/date/type filters ride `scopeJson` — the atom never interprets them. Every query persists as a SearchQuery row (recent/saved searches) when `saveHistory` is on. The input is the mapped `search-input` type rendered inline with event renamed to SEARCH (the std-geosearch idiom); its native {searchTerm}/{value} payloads are bridged via str/default, so programmatic SEARCH { queryText, typeFilter, scopeJson } emitters and the UI box drive the same arm.",
+  "description": "std-global-search — cross-module federated search. Use when a user voices that one search box should query several modules at once (global search, search everything, unified search, cross-module search, federated search, search across records, omnisearch, one search box, aggregated results, grouped results). One SEARCH event fans out to every module key listed in the `modules` config (comma-separated, deterministic — no registry magic): the trait walks the parsed key list with an internal FAN_OUT_STEP sentinel and emits one scoped MODULE_SEARCH_REQUESTED { moduleKey, queryText, typeFilter, scopeJson } -> external per key, so modules respond in parallel rather than in sequence. Modules answer with SEARCH_RESULTS { moduleKey, resultsJson }; each answer appends a SearchResultGroup to the entity, so the merged view stays grouped by module. A module that answers twice is counted once, a keyless answer is filed under the answering module's name, and every group records which behavior answered it. Client/person/date/type filters ride `scopeJson` — the atom never interprets them. Every query persists as a SearchQuery row (recent/saved searches) when `saveHistory` is on. The input is the mapped `search-input` type rendered inline with event renamed to SEARCH (the std-geosearch idiom); its native {searchTerm}/{value} payloads are bridged via str/default, so programmatic SEARCH { queryText, typeFilter, scopeJson } emitters and the UI box drive the same arm.",
   "ledger": {
     "entries": {
       "ent_01M2HF5GMNGVKWFSM4E6WE1SAY": {
@@ -238,6 +238,11 @@
             "description": "Merged answers, one entry per responding module, grouped by moduleKey.",
             "items": {
               "properties": {
+                "answeredBy": {
+                  "name": "answeredBy",
+                  "required": false,
+                  "type": "string"
+                },
                 "moduleKey": {
                   "name": "moduleKey",
                   "required": false,
@@ -582,6 +587,17 @@
           "id": "trt_01M2HF5GMNYZN83ARCEMGT2H32",
           "linkedEntity": "SearchQuery",
           "linkedEntityId": "ent_01M2HF5GMNGVKWFSM4E6WE1SAY",
+          "listens": [
+            {
+              "event": "SEARCH_RESULTS",
+              "eventId": "evt_01M2HF5GMNEB63359FQVKBKN3V",
+              "source": {
+                "kind": "any"
+              },
+              "triggers": "SEARCH_RESULTS",
+              "triggersId": "evt_01M2HF5GMNEB63359FQVKBKN3V"
+            }
+          ],
           "name": "GlobalSearch",
           "scope": "instance",
           "stateMachine": {
@@ -1205,7 +1221,20 @@
                       "array/append",
                       "@entity.results",
                       {
-                        "moduleKey": "@payload.moduleKey",
+                        "answeredBy": [
+                          "str/default",
+                          "@event.source.trait",
+                          ""
+                        ],
+                        "moduleKey": [
+                          "str/default",
+                          "@payload.moduleKey",
+                          [
+                            "str/default",
+                            "@event.source.orbital",
+                            ""
+                          ]
+                        ],
                         "receivedAt": "@now",
                         "resultsJson": "@payload.resultsJson"
                       }
@@ -1219,7 +1248,15 @@
                       "@entity.resultsSummary",
                       [
                         "str/concat",
-                        "@payload.moduleKey",
+                        [
+                          "str/default",
+                          "@payload.moduleKey",
+                          [
+                            "str/default",
+                            "@event.source.orbital",
+                            ""
+                          ]
+                        ],
                         [
                           "str/concat",
                           ": ",
@@ -1399,6 +1436,30 @@
                 "event": "SEARCH_RESULTS",
                 "eventId": "evt_01M2HF5GMNEB63359FQVKBKN3V",
                 "from": "searching",
+                "guard": [
+                  "not",
+                  [
+                    "array/some",
+                    "@entity.results",
+                    [
+                      "fn",
+                      "g",
+                      [
+                        "=",
+                        "@g.moduleKey",
+                        [
+                          "str/default",
+                          "@payload.moduleKey",
+                          [
+                            "str/default",
+                            "@event.source.orbital",
+                            ""
+                          ]
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
                 "to": "searching"
               },
               {
@@ -1544,6 +1605,10 @@
           {
             "name": "receivedAt",
             "type": "number"
+          },
+          {
+            "name": "answeredBy",
+            "type": "string"
           }
         ]
       },

package/behaviors/registry/infra/atoms/std-lifecycle.orb

@@ -684,7 +684,8 @@
                 ]
               ],
               "interval": "0 * * * *",
-              "name": "scanCycle"
+              "name": "scanCycle",
+              "runsInBackground": true
             }
           ]
         }

package/behaviors/registry/infra/atoms/std-notification-center.orb

@@ -1941,7 +1941,8 @@
                 ]
               ],
               "interval": "0 * * * *",
-              "name": "digestCycle"
+              "name": "digestCycle",
+              "runsInBackground": true
             }
           ]
         }

package/behaviors/registry/infra/atoms/std-notify-on-event.orb

@@ -430,6 +430,27 @@
         {
           "category": "lifecycle",
           "config": {
+            "coalesce": {
+              "default": "none",
+              "description": "When one action raises the subscribed event several times (a bulk import, a batch save), send one notification for the whole action (`perDispatch`) or one per distinct value of `coalesceKey` (`perKey`) instead of one per event. `none` (default) notifies on every event. Scoped to a single action: the next action notifies again.",
+              "label": "Collapse repeat notifications from one action?",
+              "synonyms": "dedupe, deduplicate, collapse, batch notifications, one notification, bulk, coalesce, summarize, avoid spam, notification storm",
+              "tier": "policy",
+              "type": "string",
+              "values": [
+                "none",
+                "perDispatch",
+                "perKey"
+              ]
+            },
+            "coalesceKey": {
+              "default": "id",
+              "description": "With `coalesce: perKey`, the upstream event's payload field compared to tell repeats apart (e.g. `id` = one notification per record). Ignored otherwise.",
+              "label": "Which field makes two events distinct?",
+              "synonyms": "dedupe key, distinct by, per record, unique field",
+              "tier": "policy",
+              "type": "string"
+            },
             "emailSubject": {
               "default": "",
               "description": "Subject line used for the email channel. Falls back to `template` when blank. Ignored for other channels.",
@@ -1465,23 +1486,82 @@
                 "eventId": "evt_01KXG04FE9FBG7H2NH6HKT4ZAR",
                 "from": "idle",
                 "guard": [
-                  "if",
-                  [
-                    "=",
-                    "@config.guardOp",
-                    "eq"
-                  ],
+                  "and",
                   [
                     "or",
                     [
                       "=",
-                      "@config.triggerStatus",
-                      ""
+                      "@config.coalesce",
+                      "none"
                     ],
                     [
-                      "=",
-                      "@payload.status",
-                      "@config.triggerStatus"
+                      "if",
+                      [
+                        "=",
+                        "@config.coalesce",
+                        "perDispatch"
+                      ],
+                      [
+                        "not",
+                        [
+                          "array/includes",
+                          [
+                            "array/map",
+                            "@prevEvents",
+                            [
+                              "fn",
+                              "e",
+                              [
+                                "object/get",
+                                "@e",
+                                "event"
+                              ]
+                            ]
+                          ],
+                          "@event.event"
+                        ]
+                      ],
+                      [
+                        "not",
+                        [
+                          "array/some",
+                          "@prevEvents",
+                          [
+                            "fn",
+                            "e",
+                            [
+                              "and",
+                              [
+                                "=",
+                                [
+                                  "object/get",
+                                  "@e",
+                                  "event"
+                                ],
+                                "@event.event"
+                              ],
+                              [
+                                "=",
+                                [
+                                  "object/get",
+                                  [
+                                    "object/get",
+                                    "@e",
+                                    "payload",
+                                    {}
+                                  ],
+                                  "@config.coalesceKey"
+                                ],
+                                [
+                                  "object/get",
+                                  "@event.payload",
+                                  "@config.coalesceKey"
+                                ]
+                              ]
+                            ]
+                          ]
+                        ]
+                      ]
                     ]
                   ],
                   [
@@ -1489,26 +1569,30 @@
                     [
                       "=",
                       "@config.guardOp",
-                      "gt"
+                      "eq"
                     ],
                     [
-                      ">",
+                      "or",
                       [
-                        "object/get",
-                        "@payload.data",
-                        "@config.guardField"
+                        "=",
+                        "@config.triggerStatus",
+                        ""
                       ],
-                      "@config.guardValue"
+                      [
+                        "=",
+                        "@payload.status",
+                        "@config.triggerStatus"
+                      ]
                     ],
                     [
                       "if",
                       [
                         "=",
                         "@config.guardOp",
-                        "lt"
+                        "gt"
                       ],
                       [
-                        "<",
+                        ">",
                         [
                           "object/get",
                           "@payload.data",
@@ -1521,10 +1605,10 @@
                         [
                           "=",
                           "@config.guardOp",
-                          "gte"
+                          "lt"
                         ],
                         [
-                          ">=",
+                          "<",
                           [
                             "object/get",
                             "@payload.data",
@@ -1533,13 +1617,30 @@
                           "@config.guardValue"
                         ],
                         [
-                          "<=",
+                          "if",
                           [
-                            "object/get",
-                            "@payload.data",
-                            "@config.guardField"
+                            "=",
+                            "@config.guardOp",
+                            "gte"
                           ],
-                          "@config.guardValue"
+                          [
+                            ">=",
+                            [
+                              "object/get",
+                              "@payload.data",
+                              "@config.guardField"
+                            ],
+                            "@config.guardValue"
+                          ],
+                          [
+                            "<=",
+                            [
+                              "object/get",
+                              "@payload.data",
+                              "@config.guardField"
+                            ],
+                            "@config.guardValue"
+                          ]
                         ]
                       ]
                     ]

package/behaviors/registry/infra/atoms/std-reminder-scheduler.orb

@@ -804,7 +804,8 @@
                 ]
               ],
               "interval": "*/15 * * * *",
-              "name": "scanCycle"
+              "name": "scanCycle",
+              "runsInBackground": true
             }
           ]
         }