@almadar/std 15.15.0 → 15.15.1

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

@@ -0,0 +1,330 @@
+{
+  "name": "std-reminder-scheduler",
+  "version": "1.0.0",
+  "description": "std-reminder-scheduler — declarative deadline-reminder rules for a target entity. Periodic tick logs scans to ReminderRunLog. v1.0 ships the knob set + scan topology so the questionnaire surfaces dateField + offsetsHours + template; auto-emit of ReminderDue per matching record lands in v1.1 (loop-with-emit gap — docs/Almadar_Std_Factories.md). Composed alongside std-notify-on-event in organisms once the emit lands.",
+  "orbitals": [
+    {
+      "name": "ReminderSchedulerOrbital",
+      "entity": {
+        "name": "ReminderRunLog",
+        "collection": "reminder_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": "ReminderScheduler",
+          "category": "lifecycle",
+          "linkedEntity": "ReminderRunLog",
+          "emits": [
+            {
+              "event": "ScanRecordsLoaded",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[object]"
+                }
+              ]
+            },
+            {
+              "event": "ScanFailed",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ReminderRunLogged",
+              "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": "ReminderRunFailed",
+              "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": "ReminderRunLogged",
+                "name": "ReminderRunLog ged",
+                "payloadSchema": [
+                  {
+                    "name": "row",
+                    "type": "ReminderRunLog"
+                  }
+                ]
+              },
+              {
+                "key": "ReminderRunFailed",
+                "name": "Reminder 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",
+                    "ReminderRunLog",
+                    "@entity",
+                    {
+                      "emit": {
+                        "failure": "ReminderRunFailed",
+                        "success": "ReminderRunLogged"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ScanFailed",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.targetEntity",
+                    "@config.targetEntity"
+                  ],
+                  [
+                    "set",
+                    "@entity.recordCount",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.errors",
+                    "@payload.error"
+                  ],
+                  [
+                    "persist",
+                    "create",
+                    "ReminderRunLog",
+                    "@entity",
+                    {
+                      "emit": {
+                        "success": "ReminderRunLogged",
+                        "failure": "ReminderRunFailed"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ReminderRunLogged"
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ReminderRunFailed"
+              }
+            ]
+          },
+          "ticks": [
+            {
+              "name": "scanCycle",
+              "interval": 900000.0,
+              "effects": [
+                [
+                  "fetch",
+                  "ReminderRunLog",
+                  {
+                    "emit": {
+                      "success": "ScanRecordsLoaded",
+                      "failure": "ScanFailed"
+                    }
+                  }
+                ]
+              ]
+            }
+          ],
+          "config": {
+            "severity": {
+              "type": "string",
+              "default": "info",
+              "label": "Severity",
+              "description": "Severity passed to the notifier when emit lands: info / warning / error.",
+              "tier": "customization"
+            },
+            "template": {
+              "type": "string",
+              "default": "",
+              "label": "Message template",
+              "description": "Message body passed to the notifier.",
+              "tier": "customization"
+            },
+            "dateField": {
+              "type": "string",
+              "default": "",
+              "label": "Deadline field",
+              "description": "Field on the target entity holding the deadline timestamp (e.g. 'dueAt', 'startsAt').",
+              "tier": "essential"
+            },
+            "targetEntity": {
+              "type": "string",
+              "default": "",
+              "label": "Target entity",
+              "description": "Entity to scan for upcoming deadlines (e.g. 'ClassSession', 'CourtDeadlineRecord').",
+              "tier": "essential"
+            },
+            "offsetsHours": {
+              "type": "[number]",
+              "default": [],
+              "label": "Reminder offsets (hours before deadline)",
+              "description": "Multi-touch reminder offsets: e.g. [168, 24, 1] for 7d/1d/1h reminders. v1.0 declarative only — emit lands in v1.1 (gap).",
+              "tier": "essential",
+              "items": {
+                "type": "number"
+              }
+            },
+            "windowToleranceMinutes": {
+              "type": "number",
+              "default": 60.0,
+              "label": "Match tolerance (minutes)",
+              "description": "How close to the offset a record must be to fire a reminder. Wider = more forgiving but more dupes.",
+              "tier": "advanced"
+            }
+          },
+          "scope": "instance"
+        }
+      ],
+      "pages": [
+        {
+          "name": "ReminderSchedulerPage",
+          "path": "/reminders/scheduler",
+          "traits": [
+            {
+              "ref": "ReminderScheduler"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/behaviors/registry/marketing/atoms/std-marketing-article.orb

@@ -0,0 +1,96 @@
+{
+  "name": "std-marketing-article",
+  "version": "1.0.0",
+  "description": "Article section atom for marketing pages. Renders a centered prose block with title and rich content. Pick for about pages, mission statements, and blog-style content.",
+  "orbitals": [
+    {
+      "name": "ArticleItemOrbital",
+      "entity": {
+        "name": "ArticleItem",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "ArticleItemArticle",
+          "category": "interaction",
+          "linkedEntity": "ArticleItem",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "article-section",
+                      "children": "@config.content",
+                      "maxWidth": "@config.maxWidth",
+                      "title": "@config.title"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "config": {
+            "content": {
+              "type": "string",
+              "default": "We believe building software should be as natural as describing it.",
+              "label": "Content",
+              "description": "Body text rendered as markdown",
+              "tier": "essential"
+            },
+            "title": {
+              "type": "string",
+              "default": "Our Mission",
+              "label": "Title",
+              "description": "Section headline",
+              "tier": "essential"
+            },
+            "maxWidth": {
+              "type": "string",
+              "default": "lg",
+              "label": "Max Width",
+              "description": "Content width constraint",
+              "tier": "customization"
+            }
+          },
+          "scope": "instance"
+        }
+      ],
+      "pages": [
+        {
+          "name": "ArticleItemArticlePage",
+          "path": "/article",
+          "traits": [
+            {
+              "ref": "ArticleItemArticle"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/behaviors/registry/marketing/atoms/std-marketing-case-studies.orb

@@ -0,0 +1,243 @@
+{
+  "name": "std-marketing-case-studies",
+  "version": "1.0.0",
+  "description": "Case studies grid atom for marketing pages. Renders a grid of case study cards with categories, descriptions, and links. Pick for social proof and success story sections.",
+  "orbitals": [
+    {
+      "name": "CaseStudyItemOrbital",
+      "entity": {
+        "name": "CaseStudyItem",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "items",
+            "type": "array",
+            "default": [],
+            "items": {
+              "type": "object",
+              "properties": {
+                "title": {
+                  "name": "title",
+                  "type": "string",
+                  "required": true
+                },
+                "linkLabel": {
+                  "name": "linkLabel",
+                  "type": "string",
+                  "required": false
+                },
+                "id": {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                "category": {
+                  "name": "category",
+                  "type": "string",
+                  "required": true
+                },
+                "categoryColor": {
+                  "name": "categoryColor",
+                  "type": "string",
+                  "required": false
+                },
+                "href": {
+                  "name": "href",
+                  "type": "string",
+                  "required": true
+                },
+                "description": {
+                  "name": "description",
+                  "type": "string",
+                  "required": true
+                }
+              }
+            }
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "CaseStudyItemCaseStudies",
+          "category": "interaction",
+          "linkedEntity": "CaseStudyItem",
+          "emits": [
+            {
+              "event": "CASE_STUDY_CLICK",
+              "scope": "external",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "title",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "CASE_STUDY_CLICK",
+                "name": "Case Study Click",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  },
+                  {
+                    "name": "title",
+                    "type": "string"
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.items",
+                    "@config.items"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "case-study-organism",
+                      "entity": "@entity.items"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "CASE_STUDY_CLICK",
+                "effects": [
+                  [
+                    "emit",
+                    "CASE_STUDY_CLICK",
+                    {
+                      "title": "@payload.title",
+                      "id": "@payload.id"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "config": {
+            "items": {
+              "type": "[CaseStudyCard]",
+              "default": [
+                {
+                  "description": "How Acme scaled from 1K to 1M users in 6 months.",
+                  "id": "1",
+                  "href": "#",
+                  "category": "SaaS",
+                  "categoryColor": "",
+                  "linkLabel": "Read story",
+                  "title": "Acme Corp"
+                },
+                {
+                  "href": "#",
+                  "linkLabel": "Read story",
+                  "description": "Globex reduced infrastructure costs by 70%.",
+                  "id": "2",
+                  "title": "Globex",
+                  "category": "Fintech",
+                  "categoryColor": ""
+                },
+                {
+                  "description": "Initech shipped their mobile app 3x faster.",
+                  "category": "Healthtech",
+                  "id": "3",
+                  "categoryColor": "",
+                  "href": "#",
+                  "linkLabel": "Read story",
+                  "title": "Initech"
+                }
+              ],
+              "label": "Case Studies",
+              "description": "Array of case study cards",
+              "tier": "essential",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "categoryColor": {
+                    "name": "categoryColor",
+                    "type": "string",
+                    "required": false
+                  },
+                  "href": {
+                    "name": "href",
+                    "type": "string",
+                    "required": true
+                  },
+                  "id": {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  },
+                  "title": {
+                    "name": "title",
+                    "type": "string",
+                    "required": true
+                  },
+                  "description": {
+                    "name": "description",
+                    "type": "string",
+                    "required": true
+                  },
+                  "linkLabel": {
+                    "name": "linkLabel",
+                    "type": "string",
+                    "required": false
+                  },
+                  "category": {
+                    "name": "category",
+                    "type": "string",
+                    "required": true
+                  }
+                }
+              }
+            }
+          },
+          "scope": "instance"
+        }
+      ],
+      "pages": [
+        {
+          "name": "CaseStudyItemCaseStudiesPage",
+          "path": "/case-studies",
+          "traits": [
+            {
+              "ref": "CaseStudyItemCaseStudies"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}