@almadar/std 15.15.0 → 15.15.1

package/dist/behaviors/registry/core/atoms/std-lifecycle.orb

@@ -0,0 +1,343 @@
+{
+  "name": "std-lifecycle",
+  "version": "1.0.0",
+  "description": "std-lifecycle — declarative lifecycle-rule definitions for a target entity. Periodic tick logs scan attempts to LifecycleRunLog. v1.0 ships the config knobs + scan topology so the questionnaire surfaces rules + targetEntity + dryRun cleanly; auto-emit of SET_STATUS per matching record lands in v1.1 when loop-with-emit primitive exists (gap — docs/Almadar_Std_Factories.md).",
+  "orbitals": [
+    {
+      "name": "LifecycleOrbital",
+      "entity": {
+        "name": "LifecycleRunLog",
+        "collection": "lifecycle_runs",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "targetEntity",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "recordCount",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "ranAt",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "errors",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "LifecycleScheduler",
+          "category": "lifecycle",
+          "linkedEntity": "LifecycleRunLog",
+          "emits": [
+            {
+              "event": "ScanRecordsLoaded",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[object]"
+                }
+              ]
+            },
+            {
+              "event": "ScanFailed",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "LifecycleRunLogged",
+              "payloadSchema": [
+                {
+                  "name": "row.id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "row.targetEntity",
+                  "type": "string"
+                },
+                {
+                  "name": "row.recordCount",
+                  "type": "number"
+                },
+                {
+                  "name": "row.ranAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.errors",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "LifecycleRunFailed",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "ScanRecordsLoaded",
+                "name": "Scan records loaded",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "type": "[object]"
+                  }
+                ]
+              },
+              {
+                "key": "ScanFailed",
+                "name": "Scan failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "LifecycleRunLogged",
+                "name": "LifecycleRunLog ged",
+                "payloadSchema": [
+                  {
+                    "name": "row",
+                    "type": "LifecycleRunLog"
+                  }
+                ]
+              },
+              {
+                "key": "LifecycleRunFailed",
+                "name": "Lifecycle run failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ScanRecordsLoaded",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.targetEntity",
+                    "@config.targetEntity"
+                  ],
+                  [
+                    "set",
+                    "@entity.recordCount",
+                    [
+                      "array/len",
+                      "@payload.data"
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.ranAt",
+                    0.0
+                  ],
+                  [
+                    "persist",
+                    "create",
+                    "LifecycleRunLog",
+                    "@entity",
+                    {
+                      "emit": {
+                        "failure": "LifecycleRunFailed",
+                        "success": "LifecycleRunLogged"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ScanFailed",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.targetEntity",
+                    "@config.targetEntity"
+                  ],
+                  [
+                    "set",
+                    "@entity.recordCount",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.errors",
+                    "@payload.error"
+                  ],
+                  [
+                    "persist",
+                    "create",
+                    "LifecycleRunLog",
+                    "@entity",
+                    {
+                      "emit": {
+                        "failure": "LifecycleRunFailed",
+                        "success": "LifecycleRunLogged"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "LifecycleRunLogged"
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "LifecycleRunFailed"
+              }
+            ]
+          },
+          "ticks": [
+            {
+              "name": "scanCycle",
+              "interval": 3600000.0,
+              "effects": [
+                [
+                  "fetch",
+                  "LifecycleRunLog",
+                  {
+                    "emit": {
+                      "failure": "ScanFailed",
+                      "success": "ScanRecordsLoaded"
+                    }
+                  }
+                ]
+              ]
+            }
+          ],
+          "config": {
+            "rules": {
+              "type": "[LifecycleRule]",
+              "default": [],
+              "label": "Lifecycle rules",
+              "description": "When a record's status is fromStatus and its dateField is older than condition.value days (kind='ageDays'), transition to toStatus. v1.0 declarative only — wiring lands in v1.1 (gap).",
+              "tier": "essential",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "fromStatus": {
+                    "name": "fromStatus",
+                    "type": "string",
+                    "required": false
+                  },
+                  "toStatus": {
+                    "name": "toStatus",
+                    "type": "string",
+                    "required": false
+                  },
+                  "condition": {
+                    "name": "condition",
+                    "type": "object",
+                    "required": false,
+                    "properties": {
+                      "kind": {
+                        "name": "kind",
+                        "type": "string",
+                        "required": false
+                      },
+                      "value": {
+                        "name": "value",
+                        "type": "number",
+                        "required": false
+                      },
+                      "dateField": {
+                        "name": "dateField",
+                        "type": "string",
+                        "required": false
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "dryRun": {
+              "type": "boolean",
+              "default": false,
+              "label": "Dry-run mode",
+              "description": "When true, log scan results without emitting transitions.",
+              "tier": "advanced"
+            },
+            "targetEntity": {
+              "type": "string",
+              "default": "",
+              "label": "Target entity",
+              "description": "Entity name to scan (e.g. 'InvoiceRecord'). v1.1 will drive SET_STATUS transitions on this entity.",
+              "tier": "essential"
+            }
+          },
+          "scope": "instance"
+        }
+      ],
+      "pages": [
+        {
+          "name": "LifecycleSchedulerPage",
+          "path": "/lifecycle/scheduler",
+          "traits": [
+            {
+              "ref": "LifecycleScheduler"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -1,7 +1,7 @@
 {
   "name": "std-notify-on-event",
-  "version": "1.0.0",
-  "description": "std-notify-on-event — event-driven notification dispatcher. Listens for the generic `EventOccurred` sentinel (rename via traitOverrides.events to the real event, e.g. ContactSaved). Emits in-app `notify` when `notifyChannel` is `\"in-app\"`, or persists a `NotificationRecord` row for out-of-band delivery when channel is `\"email\"` or `\"sms\"`. Composable via `extraTraits` to wire reactive notifications behind any emitting trait.",
+  "version": "1.1.0",
+  "description": "std-notify-on-event — event-driven notification dispatcher. Listens for the generic `EventOccurred` sentinel (rename via traitOverrides.events to the real event, e.g. ContactSaved). Resolves recipient from `recipients` (first entry; fan-out is a future extension) or falls back to `@user.id`. Skips dispatch when the recipient is in `suppressionList`. Emits in-app `notify` when `notifyChannel` is `\"in-app\"`, or persists a `NotificationRecord` row for out-of-band delivery when channel is `\"email\"` or `\"sms\"`.",
   "orbitals": [
     {
       "name": "NotifyOnEventOrbital",
@@ -126,7 +126,22 @@
                   [
                     "set",
                     "@entity.recipient",
-                    "@user.id"
+                    [
+                      "if",
+                      [
+                        "=",
+                        [
+                          "array/len",
+                          "@config.recipients"
+                        ],
+                        0.0
+                      ],
+                      "@user.id",
+                      [
+                        "array/first",
+                        "@config.recipients"
+                      ]
+                    ]
                   ],
                   [
                     "set",
@@ -147,9 +162,20 @@
                     "set",
                     "@entity.dispatched",
                     [
-                      "=",
-                      "@config.notifyChannel",
-                      "in-app"
+                      "and",
+                      [
+                        "=",
+                        "@config.notifyChannel",
+                        "in-app"
+                      ],
+                      [
+                        "not",
+                        [
+                          "array/includes",
+                          "@config.suppressionList",
+                          "@entity.recipient"
+                        ]
+                      ]
                     ]
                   ],
                   [
@@ -158,39 +184,50 @@
                     0.0
                   ],
                   [
-                    "if",
-                    [
-                      "=",
-                      "@config.notifyChannel",
-                      "in-app"
-                    ],
+                    "when",
                     [
-                      "notify",
-                      "@config.severity",
-                      "@config.template"
+                      "not",
+                      [
+                        "array/includes",
+                        "@config.suppressionList",
+                        "@entity.recipient"
+                      ]
                     ],
                     [
-                      "persist",
-                      "create",
-                      "NotificationRecord",
-                      {
-                        "recipient": "@user.id",
-                        "message": "@config.template",
-                        "dispatched": false,
-                        "channel": "@config.notifyChannel",
-                        "severity": "@config.severity",
-                        "recordedAt": 0.0
-                      }
+                      "if",
+                      [
+                        "=",
+                        "@config.notifyChannel",
+                        "in-app"
+                      ],
+                      [
+                        "notify",
+                        "@config.severity",
+                        "@config.template"
+                      ],
+                      [
+                        "persist",
+                        "create",
+                        "NotificationRecord",
+                        {
+                          "channel": "@config.notifyChannel",
+                          "recipient": "@entity.recipient",
+                          "severity": "@config.severity",
+                          "dispatched": false,
+                          "message": "@config.template",
+                          "recordedAt": 0.0
+                        }
+                      ]
                     ]
                   ],
                   [
                     "emit",
                     "NotificationDispatched",
                     {
-                      "channel": "@config.notifyChannel",
+                      "recipient": "@entity.recipient",
+                      "severity": "@config.severity",
                       "message": "@config.template",
-                      "recipient": "@user.id",
-                      "severity": "@config.severity"
+                      "channel": "@config.notifyChannel"
                     }
                   ]
                 ]
@@ -198,19 +235,44 @@
             ]
           },
           "config": {
-            "notifyChannel": {
-              "type": "string",
-              "default": "in-app",
-              "label": "Channel",
-              "description": "Delivery channel: in-app, email, or sms",
-              "tier": "customization"
+            "quietHours": {
+              "type": "QuietHoursSpec",
+              "default": {
+                "start": "",
+                "end": ""
+              },
+              "label": "Quiet hours",
+              "description": "Local-time window during which dispatch is suppressed. Both start and end required to activate. WIRING DEFERRED: needs @now-aware time comparison primitive (gap — docs/Almadar_Std_Factories.md).",
+              "tier": "customization",
+              "properties": {
+                "end": {
+                  "name": "end",
+                  "type": "string",
+                  "required": false
+                },
+                "start": {
+                  "name": "start",
+                  "type": "string",
+                  "required": false
+                }
+              }
             },
-            "severity": {
+            "template": {
               "type": "string",
-              "default": "info",
-              "label": "Severity",
-              "description": "info, success, warning, or error — controls styling",
-              "tier": "customization"
+              "default": "",
+              "label": "Message template",
+              "description": "Text shown to the recipient; supports payload interpolation",
+              "tier": "essential"
+            },
+            "recipients": {
+              "type": "[string]",
+              "default": [],
+              "label": "Recipients",
+              "description": "Recipient ids/addresses. v1.1 uses the first entry; multi-recipient fan-out lands in v1.2 (gap). When empty, falls back to the authenticated user.",
+              "tier": "customization",
+              "items": {
+                "type": "string"
+              }
             },
             "listensFor": {
               "type": "[string]",
@@ -222,12 +284,36 @@
                 "type": "string"
               }
             },
-            "template": {
+            "suppressionList": {
+              "type": "[string]",
+              "default": [],
+              "label": "Suppression list",
+              "description": "Recipient ids/addresses to skip (e.g. unsubscribed users). Suppression check runs before dispatch.",
+              "tier": "customization",
+              "items": {
+                "type": "string"
+              }
+            },
+            "notifyChannel": {
               "type": "string",
-              "default": "",
-              "label": "Message template",
-              "description": "Text shown to the recipient; supports payload interpolation",
-              "tier": "essential"
+              "default": "in-app",
+              "label": "Channel",
+              "description": "Delivery channel: in-app, email, or sms",
+              "tier": "customization"
+            },
+            "severity": {
+              "type": "string",
+              "default": "info",
+              "label": "Severity",
+              "description": "info, success, warning, or error — controls styling",
+              "tier": "customization"
+            },
+            "frequencyCapPerWeek": {
+              "type": "number",
+              "default": 0.0,
+              "label": "Frequency cap (per week)",
+              "description": "Max sends per (channel, recipient) per rolling 7-day window. 0 = uncapped. WIRING DEFERRED: needs stateful history query (gap — docs/Almadar_Std_Factories.md).",
+              "tier": "customization"
             }
           },
           "scope": "instance"
@@ -246,4 +332,4 @@
       ]
     }
   ]
-}
+}