@almadar/std 16.227.0 → 16.228.0

package/behaviors/lolo/agent/organisms/std-agent-rabit.lolo

@@ -101,6 +101,7 @@ orbital CoordinatorOrbital {
     }
 
     listens {
+      CoordinatorMonitor.ALL_DONE -> ALL_DONE
       START { prompt: string!, totalOrbitals: number! }
       ALL_DONE
       RESET

package/behaviors/lolo/infra/atoms/std-audit-capture.lolo

@@ -1,9 +1,9 @@
-app std-audit-capture "1.2.0"
-"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."
+app std-audit-capture "1.3.0"
+"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."
 orbital AuditCaptureOrbital {
     type EntityMutated = Event { data : @entity @config.captureEntity } "Rename via traitOverrides.events to the upstream mutation event (e.g. ContactSaved, ContactDeleted)."
 
-    type AuditRecorded = Event { actor : string, action : string, entityType : string, entityId : string, recordedAt : number } "Re-emitted after the audit row persists; rename to wire downstream listeners (e.g. AuditDashboardAppended)."
+    type AuditRecorded = Event { actor : string, action : string, entityType : string, entityId : string, recordedAt : number, sourceEvent : string, sourceTrait : string, sourceOrbital : string, sourceTick : string } "Re-emitted after the audit row persists; rename to wire downstream listeners (e.g. AuditDashboardAppended)."
 
   entity AuditEntry [persistent: audit_entries] {
     id : string!
@@ -14,6 +14,10 @@ orbital AuditCaptureOrbital {
     before : Map string scalar @description "The state of the entity prior to the modification." @synonyms "previous, original, old value" = {}
     after : Map string scalar @description "The state of the entity after a modification." @synonyms "new, updated, post, subsequent" = {}
     recordedAt : number @description "Timestamp indicating when the audit event was recorded." @synonyms "timestamp, date, time" = 0
+    sourceEvent : string @description "The event that delivered the change to the audit trail, e.g. ContactSaved." @synonyms "triggering event, cause, origin event" = ""
+    sourceTrait : string @description "The behavior that emitted the change." @synonyms "emitter, origin, raised by" = ""
+    sourceOrbital : string @description "The module the change came from." @synonyms "origin module, source module" = ""
+    sourceTick : string @description "The scheduled job that caused the change; blank when a person or an event did." @synonyms "scheduled job, background job, timer" = ""
   }
 
   trait AuditCaptureListener -> @rebindable AuditEntry [lifecycle, instance, audit, compliance] {
@@ -21,7 +25,7 @@ orbital AuditCaptureOrbital {
 
     state idle {
       EntityMutated -> idle when @config.enabled
-        (when (or ["=", (array/len @config.captureEventTypes), 0] (array/includes @config.captureEventTypes (object/get ?data kind ""))) (do (set @entity.actor @user.id) (set @entity.action (object/get ?data kind EntityMutated)) (set @entity.entityType @config.captureEntity) (set @entity.entityId (object/get ?data id "")) (set @entity.before (if @config.captureBeforeAfter (object/omit (object/get ?data before {}) @config.excludeFields) {})) (set @entity.after (if @config.captureBeforeAfter (object/omit (object/get ?data after {}) @config.excludeFields) {})) (set @entity.recordedAt 0) (persist create AuditEntry {
+        (when (or ["=", (array/len @config.captureEventTypes), 0] (array/includes @config.captureEventTypes (object/get ?data kind @event.event))) (do (set @entity.actor @user.id) (set @entity.action (object/get ?data kind @event.event)) (set @entity.entityType @config.captureEntity) (set @entity.entityId (object/get ?data id "")) (set @entity.before (if @config.captureBeforeAfter (object/omit (object/get ?data before {}) @config.excludeFields) {})) (set @entity.after (if @config.captureBeforeAfter (object/omit (object/get ?data after {}) @config.excludeFields) {})) (set @entity.recordedAt 0) (persist create AuditEntry {
           action: @entity.action
           actor: @user.id
           after: @entity.after
@@ -29,12 +33,20 @@ orbital AuditCaptureOrbital {
           entityId: @entity.entityId
           entityType: @config.captureEntity
           recordedAt: 0
+          sourceEvent: @event.event
+          sourceTrait: (str/default @event.source.trait "")
+          sourceOrbital: (str/default @event.source.orbital "")
+          sourceTick: (str/default @event.source.tick "")
         }) (emit AuditRecorded {
           action: @entity.action
           actor: @user.id
           entityId: @entity.entityId
           entityType: @config.captureEntity
           recordedAt: 0
+          sourceEvent: @event.event
+          sourceTrait: (str/default @event.source.trait "")
+          sourceOrbital: (str/default @event.source.orbital "")
+          sourceTick: (str/default @event.source.tick "")
         })))
     }
 
@@ -45,6 +57,10 @@ orbital AuditCaptureOrbital {
         entityType : string
         entityId : string
         recordedAt : number
+        sourceEvent : string
+        sourceTrait : string
+        sourceOrbital : string
+        sourceTick : string
       }
     }
 
@@ -66,7 +82,7 @@ orbital AuditCaptureOrbital {
         @tier "internal"
       captureEventTypes : [string] = []
         @label "Event-kind filter"
-        @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."
         @tier "internal"
       excludeFields : [string] = []
         @label "Skip fields"

package/behaviors/lolo/infra/atoms/std-calendar-sync.lolo

@@ -227,7 +227,7 @@ orbital CalendarSyncOrbital {
     }
 
     ticks {
-      syncCycle every "*/15 * * * *"
+      syncCycle every "*/15 * * * *" [background]
         (fetch @config.targetEntity {
           emit: { failure: CAL_SYNC_FAILED, success: PUSH_ROWS_LOADED }
           filter: ["=", (object/get @entity externalEventId), ""]

package/behaviors/lolo/infra/atoms/std-data-erasure.lolo

@@ -378,7 +378,7 @@ orbital DataErasureOrbital {
     }
 
     ticks {
-      executionScan every "0 * * * *"
+      executionScan every "0 * * * *" [background]
         (fetch ErasureRequest {
           emit: { failure: ExecScanFailed, success: ExecScanLoaded }
           filter: (and ["=", (object/get @entity status), grace] ["<", (object/get @entity executesAt), @now])

package/behaviors/lolo/infra/atoms/std-global-search.lolo

@@ -1,6 +1,6 @@
 app std-global-search "1.0.0"
-"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."
-type SearchResultGroup = { moduleKey : string, resultsJson : string, receivedAt : number }
+"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."
+type SearchResultGroup = { moduleKey : string, resultsJson : string, receivedAt : number, answeredBy : string }
 orbital GlobalSearchOrbital {
     uses Typography from "std/behaviors/ui-typography"
     uses Spinner from "std/behaviors/ui-spinner"
@@ -133,14 +133,15 @@ orbital GlobalSearchOrbital {
           (set @entity.fanOutDone true))
         (when [">", (array/len @entity.pendingModules), 0]
           (emit FAN_OUT_STEP { remaining: (array/len @entity.pendingModules) }))
-      SEARCH_RESULTS -> searching
+      SEARCH_RESULTS -> searching when (not (array/some @entity.results (fn g (= @g.moduleKey (str/default ?moduleKey (str/default @event.source.orbital ""))))))
         (set @entity.respondedCount ["+", @entity.respondedCount, 1])
         (set @entity.results (array/append @entity.results {
-          moduleKey: ?moduleKey
+          moduleKey: (str/default ?moduleKey (str/default @event.source.orbital ""))
           receivedAt: @now
           resultsJson: ?resultsJson
+          answeredBy: (str/default @event.source.trait "")
         }))
-        (set @entity.resultsSummary (str/concat @entity.resultsSummary (str/concat ?moduleKey (str/concat ": " (str/concat ?resultsJson "\n")))))
+        (set @entity.resultsSummary (str/concat @entity.resultsSummary (str/concat (str/default ?moduleKey (str/default @event.source.orbital "")) (str/concat ": " (str/concat ?resultsJson "\n")))))
         (render-ui main {
           children: [{
             event: SEARCH
@@ -250,6 +251,7 @@ orbital GlobalSearchOrbital {
       FAN_OUT_STEP {
         remaining : number
       }
+      *.SEARCH_RESULTS -> SEARCH_RESULTS
     }
 
     config {

package/behaviors/lolo/infra/atoms/std-lifecycle.lolo

@@ -86,7 +86,7 @@ orbital LifecycleOrbital {
     }
 
     ticks {
-      scanCycle every "0 * * * *"
+      scanCycle every "0 * * * *" [background]
         (fetch @config.targetEntity {
           emit: { failure: ScanFailed, success: ScanRecordsLoaded }
           filter: (and ["=", (object/get @entity status), @config.fromStatus] ["<", (object/get @entity @config.dateField), ["-", @now, ["*", @config.ageDays, 86400000]]])

package/behaviors/lolo/infra/atoms/std-notification-center.lolo

@@ -279,7 +279,7 @@ orbital NotificationCenterOrbital {
     }
 
     ticks {
-      digestCycle every "0 * * * *"
+      digestCycle every "0 * * * *" [background]
         (fetch NotificationRecord {
           emit: { failure: DIGEST_FAILED, success: DIGEST_ROWS_LOADED }
           filter: (and ["=", (object/get @entity dispatched), false] (or ["=", (object/get @entity error), "digest-deferred"] ["=", (object/get @entity error), "quiet-hours"]) ["<", (object/get @entity recordedAt), ["-", @now, ["*", @config.minAgeHours, 3600000]]])

package/behaviors/lolo/infra/atoms/std-notify-on-event.lolo

@@ -49,7 +49,7 @@ orbital NotifyOnEventOrbital {
     initial: idle
 
     state idle {
-      EventOccurred -> idle when (if ["=", @config.guardOp, "eq"] (or ["=", @config.triggerStatus, ""] ["=", ?status, @config.triggerStatus]) (if ["=", @config.guardOp, "gt"] [">", (object/get ?data @config.guardField), @config.guardValue] (if ["=", @config.guardOp, "lt"] ["<", (object/get ?data @config.guardField), @config.guardValue] (if ["=", @config.guardOp, "gte"] [">=", (object/get ?data @config.guardField), @config.guardValue] ["<=", (object/get ?data @config.guardField), @config.guardValue]))))
+      EventOccurred -> idle when (and (or ["=", @config.coalesce, "none"] (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)])))))) (if ["=", @config.guardOp, "eq"] (or ["=", @config.triggerStatus, ""] ["=", ?status, @config.triggerStatus]) (if ["=", @config.guardOp, "gt"] [">", (object/get ?data @config.guardField), @config.guardValue] (if ["=", @config.guardOp, "lt"] ["<", (object/get ?data @config.guardField), @config.guardValue] (if ["=", @config.guardOp, "gte"] [">=", (object/get ?data @config.guardField), @config.guardValue] ["<=", (object/get ?data @config.guardField), @config.guardValue])))))
         (set @entity.recipient (if ["=", (array/len @config.recipients), 0] (if (not ["=", @config.fallbackRecipient, ""]) @config.fallbackRecipient @user.id) (array/first @config.recipients)))
         (set @entity.channel @config.notifyChannel)
         (set @entity.message @config.template)
@@ -352,6 +352,16 @@ orbital NotifyOnEventOrbital {
     }
 
     config {
+      coalesce : "none" | "perDispatch" | "perKey" = none
+        @label "Collapse repeat notifications from one action?"
+        @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."
+        @synonyms "dedupe, deduplicate, collapse, batch notifications, one notification, bulk, coalesce, summarize, avoid spam, notification storm"
+        @tier "policy"
+      coalesceKey : string = "id"
+        @label "Which field makes two events distinct?"
+        @description "With `coalesce: perKey`, the upstream event's payload field compared to tell repeats apart (e.g. `id` = one notification per record). Ignored otherwise."
+        @synonyms "dedupe key, distinct by, per record, unique field"
+        @tier "policy"
       triggerStatus : string = ""
         @label "Trigger status"
         @description "When `guardOp` is `eq` and this is set, dispatch only when the upstream event's `status` field equals this value (e.g. fire only when a record becomes 'approved'). Empty = fire on every subscribed event. Ignored when `guardOp` is a numeric comparison."

package/behaviors/lolo/infra/atoms/std-reminder-scheduler.lolo

@@ -96,7 +96,7 @@ orbital ReminderSchedulerOrbital {
     }
 
     ticks {
-      scanCycle every "*/15 * * * *"
+      scanCycle every "*/15 * * * *" [background]
         (fetch @config.targetEntity {
           emit: { failure: ScanFailed, success: ScanRecordsLoaded }
           filter: (and ["=", (object/get @entity remindedAt), 0] (or (and ["=", @config.direction, "future"] [">", (time/parse (object/get @entity @config.dateField)), @now] ["<", ["-", (time/parse (object/get @entity @config.dateField)), @now], ["*", @config.offsetHours, 3600000]]) (and ["=", @config.direction, "past"] [">", ["-", @now, (time/parse (object/get @entity @config.dateField))], ["*", @config.offsetHours, 3600000]])))

package/behaviors/lolo/infra/atoms/std-review-cycle.lolo

@@ -0,0 +1,135 @@
+app std-review-cycle "0.1.0"
+"std-review-cycle — revise-and-resubmit review workflow (document review, pull-request review, design review, editorial review, submission review, send back for changes, request changes, resubmit, review rounds, four-eyes approval). A record moves draft → in review → changes requested → in review → … → approved. One SUBMIT event serves both the first submission and every resubmission; the atom counts review rounds and marks resubmissions on the emitted ReviewRequested. Every move writes a ReviewEvent history row stamped with the states it left and entered. `requireSeparateApproval` enforces four-eyes review: an approval raised in the same action that submitted the record (an auto-responding rule or bot) is rejected. Headless — the host renders the badge and buttons and routes its actions to SUBMIT / REQUEST_CHANGES / APPROVE."
+orbital ReviewCycleOrbital {
+    type ReviewSubmitted = Event { id : string, note : string } "Rename via traitOverrides.events to the host's submit action. Serves both the first submission and every resubmission."
+
+    type ReviewChangesRequested = Event { id : string, note : string } "Rename to the host's request-changes action. Sends the record back to its author."
+
+    type ReviewApproved = Event { id : string, note : string } "Rename to the host's approve action."
+
+    type ReviewRequested = Event { itemId : string, round : number, resubmission : boolean } "Emitted when a record enters review; `resubmission` is true when it came back from changes requested."
+
+    type ReviewLogged = Event ReviewEvent "Internal: a history row landed."
+
+    type ReviewLogFailed = Event { error : string, code : string } "Internal: writing a history row failed."
+
+    type ReviewDecided = Event { itemId : string, decision : string, round : number } "Emitted when a reviewer decides; `decision` is the state the record moved to (changes_requested or approved)."
+
+  entity ReviewItem [persistent: review_items] {
+    id : string!
+    round : number @description "Review round the record is on; 1 for the first review, incremented on each resubmission." @synonyms "iteration, revision round, review count" = 0
+    lastNote : string @description "Note left with the most recent move." @synonyms "comment, reason, feedback" = ""
+    lastLogId : string @description "Id of the most recent ReviewEvent history row." @synonyms "history id, log entry" = ""
+  }
+
+  entity ReviewEvent [persistent: review_events] {
+    id : string!
+    itemId : string @description "The record this history entry belongs to." @synonyms "record id, document id, item" = ""
+    fromState : string @description "The review state the record left." @synonyms "previous state, was" = ""
+    toState : string @description "The review state the record entered." @synonyms "new state, became" = ""
+    round : number @description "Review round at the time of the move." @synonyms "iteration" = 0
+    actor : string @description "Who made the move." @synonyms "user, reviewer, author" = ""
+    note : string @description "Note left with the move." @synonyms "comment, feedback, reason" = ""
+    at : number @description "When the move happened." @synonyms "timestamp, date, time" = 0
+  }
+
+  trait ReviewCycle -> @rebindable ReviewItem [lifecycle, instance] {
+    initial: draft
+
+    state draft {
+      INIT -> draft
+      ReviewSubmitted -> in_review when @config.enabled
+        (set @entity.round 1)
+        (set @entity.lastNote (str/default ?note ""))
+        (emit ReviewRequested { itemId: (str/default ?id ""), round: 1, resubmission: false })
+        (persist create ReviewEvent { itemId: (str/default ?id ""), fromState: @fromState, toState: @toState, round: 1, actor: (str/default @user.id ""), note: (str/default ?note ""), at: @now } { emit: { success: ReviewLogged, failure: ReviewLogFailed } })
+    }
+
+    state in_review {
+      INIT -> in_review
+      ReviewLogged -> in_review
+        (set @entity.lastLogId (str/default ?id ""))
+      ReviewLogFailed -> in_review
+        (notify error (str/concat "Couldn't record the review history — " ?error))
+      ReviewChangesRequested -> changes_requested
+        (set @entity.lastNote (str/default ?note ""))
+        (emit ReviewDecided { itemId: (str/default ?id ""), decision: @toState, round: @entity.round })
+        (persist create ReviewEvent { itemId: (str/default ?id ""), fromState: @fromState, toState: @toState, round: @entity.round, actor: (str/default @user.id ""), note: (str/default ?note ""), at: @now } { emit: { success: ReviewLogged, failure: ReviewLogFailed } })
+      ReviewApproved -> approved when (or (not @config.requireSeparateApproval) (not (array/some @prevStates (fn s (or (= @s "draft") (= @s "changes_requested"))))))
+        (set @entity.lastNote (str/default ?note ""))
+        (emit ReviewDecided { itemId: (str/default ?id ""), decision: @toState, round: @entity.round })
+        (persist create ReviewEvent { itemId: (str/default ?id ""), fromState: @fromState, toState: @toState, round: @entity.round, actor: (str/default @user.id ""), note: (str/default ?note ""), at: @now } { emit: { success: ReviewLogged, failure: ReviewLogFailed } })
+    }
+
+    state changes_requested {
+      INIT -> changes_requested
+      ReviewLogged -> changes_requested
+        (set @entity.lastLogId (str/default ?id ""))
+      ReviewLogFailed -> changes_requested
+        (notify error (str/concat "Couldn't record the review history — " ?error))
+      ReviewSubmitted -> in_review
+        (set @entity.round (+ @entity.round 1))
+        (set @entity.lastNote (str/default ?note ""))
+        (emit ReviewRequested { itemId: (str/default ?id ""), round: @entity.round, resubmission: true })
+        (persist create ReviewEvent { itemId: (str/default ?id ""), fromState: @fromState, toState: @toState, round: @entity.round, actor: (str/default @user.id ""), note: (str/default ?note ""), at: @now } { emit: { success: ReviewLogged, failure: ReviewLogFailed } })
+    }
+
+    state approved {
+      INIT -> approved
+      ReviewLogged -> approved
+        (set @entity.lastLogId (str/default ?id ""))
+      ReviewLogFailed -> approved
+        (notify error (str/concat "Couldn't record the review history — " ?error))
+    }
+
+    emits {
+      ReviewLogged
+      ReviewLogFailed
+      ReviewRequested -> external {
+        itemId : string
+        round : number
+        resubmission : boolean
+      }
+      ReviewDecided -> external {
+        itemId : string
+        decision : string
+        round : number
+      }
+    }
+
+    listens {
+      ReviewLogged
+      ReviewLogFailed {
+        error : string
+        code : string
+      }
+      ReviewSubmitted {
+        id : string
+        note : string
+      }
+      ReviewChangesRequested {
+        id : string
+        note : string
+      }
+      ReviewApproved {
+        id : string
+        note : string
+      }
+    }
+
+    config {
+      enabled : boolean = true
+        @label "Run the review workflow?"
+        @description "Accept submissions into review. Off = submissions are ignored."
+        @synonyms "enable, turn on, review, require review, review workflow"
+        @tier "policy"
+      requireSeparateApproval : boolean = true
+        @label "Require approval to be a separate action?"
+        @description "Four-eyes review: reject an approval raised by the same action that submitted the record, such as an automatic rule or bot that approves instantly. Approvals made as their own action are unaffected."
+        @synonyms "four eyes, two person rule, no self approval, separate reviewer, independent approval, no auto approve"
+        @tier "policy"
+    }
+  }
+
+  page "/review-cycle" as ReviewCyclePage -> ReviewCycle
+}

package/behaviors/lolo/ui/avl/atoms/ui-behavior-view.lolo

@@ -1,5 +1,6 @@
 app ui-behavior-view "1.0.0"
 "BehaviorView — UI factory (1:1 with the @almadar/ui behavior-view pattern)."
+;; @pattern "behavior-view"
 orbital BehaviorViewOrbital {
   type BehaviorViewData = {
     orbitalName : string!

package/behaviors/lolo/ui/avl/atoms/ui-module-card.lolo

@@ -1,6 +1,7 @@
 app ui-module-card "1.0.0"
 "ModuleCard — a card summarizing one course module or lesson with progress and entry point. — UI factory (1:1 with the @almadar/ui module-card pattern)."
 ;; @capabilities "course module card, lesson card, curriculum unit card, learning-path step card"
+;; @pattern "module-card"
 orbital ModuleCardOrbital {
   type ModuleCardData = {
     orbitalName : string!

package/behaviors/lolo/ui/core/atoms/std-graphs.lolo

@@ -8,7 +8,7 @@ orbital GraphItemOrbital {
 
   entity GraphItem [runtime] {
     id : string!
-    chartData : [ChartPoint] @intrinsic @description "The data points used to render the chart." @synonyms "data, values, points" = []
+    chartData : [ChartPoint] @intrinsic @description "The data points used to render the chart." @synonyms "data, values, points" = [{ label: Active, value: 6 }, { label: Pending, value: 3 }, { label: Inactive, value: 1 }]
   }
 
   trait GraphItemGraph -> @rebindable GraphItem [interaction, instance] {
@@ -16,7 +16,6 @@ orbital GraphItemOrbital {
 
     state idle {
       INIT -> idle
-        (set @entity.chartData [{ label: Active, value: 6 }, { label: Pending, value: 3 }, { label: Inactive, value: 1 }])
         (render-ui main {
           chartType: @config.chartType
           data: @entity.chartData

package/behaviors/lolo/ui/core/atoms/std-slide-deck.lolo

@@ -0,0 +1,113 @@
+app std-slide-deck "1.0.0"
+"std-slide-deck — generic presentation atom. An ordered list of slide nodes (`config.slides`, any render tree or @trait) shown one at a time, with a previous/next arrow on either side, a dot strip and a k / n counter underneath, and keyboard stepping through the host's KEY router (`config.nextKeys` / `config.prevKeys`, captured per `config.keymap`). The cursor clamps at either end unless `loop` is on. Each visit mounts the slide fresh, so its own entry animations replay. Carries no content or visual style: a realization supplies the slides and restyles via `bodyContent`. The default body picks the slide inside a mapped-children lambda, which expands static slides only; a deck whose slides hold stateful traits (forms, live lists) overrides `bodyContent` with one `presence` per slide gated on `@entity.slideIndex`. Every move emits SLIDE_CHANGED for speaker notes, timers or analytics."
+;; @capabilities "slide deck, presentation, pitch deck, keynote-style slideshow, previous and next slide arrows, arrow-key slide navigation, jump to slide from dots, slide counter"
+;; @synonyms "slideshow, deck, presentation, slides, pitch"
+orbital SlideDeckOrbital {
+  entity SlideDeck [runtime] {
+    id : string!
+    slideIndex : number @description "Zero-based index of the slide currently shown." @synonyms "current slide, cursor, position" = 0
+  }
+
+  trait SlideDeckPresenter -> @rebindable SlideDeck [interaction, instance] {
+    initial: presenting
+
+    state presenting {
+      INIT -> presenting
+        (set @entity.slideIndex @config.startIndex)
+        (render-ui main @config.bodyContent)
+      GO_TO -> presenting
+        (set @entity.slideIndex ?index)
+        (emit SLIDE_CHANGED { index: @entity.slideIndex })
+        (render-ui main @config.bodyContent)
+    }
+
+    emits {
+      SLIDE_CHANGED -> external {
+        index : number!
+      }
+        @description "The deck moved to a new slide (zero-based index)."
+        @synonyms "slide shown, advanced, went back"
+        @tier "domain"
+    }
+
+    listens {
+      GO_TO {
+        index : number!
+      }
+        @description "Show a zero-based slide index. The arrows and dots send the already-bounded target; a remote or table of contents can send any index."
+        @synonyms "jump, seek, next slide, previous slide, select slide"
+        @tier "domain"
+    }
+
+    config {
+      slides : [trait] = []
+        @label "Slides"
+        @description "Ordered slide nodes; each entry is a render tree or a @trait reference and is shown one at a time."
+        @tier "domain"
+      startIndex : number = 0
+        @label "Start slide"
+        @description "Zero-based slide shown on first render; clamped to the deck."
+        @tier "presentation"
+      loop : boolean = false
+        @label "Loop"
+        @description "Wrap from the last slide to the first (and back) instead of stopping at either end."
+        @tier "presentation"
+      showArrows : boolean = true
+        @label "Show arrows"
+        @description "Previous/next buttons on the left and right of the slide."
+        @tier "presentation"
+      showProgress : boolean = true
+        @label "Show progress"
+        @description "Dot strip and k / n counter under the slide; dots jump to their slide."
+        @tier "presentation"
+      stageMinHeight : string = "70vh"
+        @label "Stage height"
+        @description "Minimum height of the slide stage (any CSS length, e.g. 70vh or 640px); the slide is centred vertically inside it so short and tall slides share one frame."
+        @tier "presentation"
+      prevIcon : icon = chevron-left
+        @label "Previous icon"
+        @tier "presentation"
+      nextIcon : icon = chevron-right
+        @label "Next icon"
+        @tier "presentation"
+      bodyContent : render-ui = {
+        type: stack
+        direction: vertical
+        gap: md
+        className: "w-full"
+        children: [{
+          type: stack
+          direction: horizontal
+          gap: md
+          align: center
+          children: [
+            (array/map [(array/len @config.slides)] (fn n (if @config.showArrows { type: button, variant: ghost, size: lg, icon: @config.prevIcon, action: GO_TO, actionPayload: { index: (if @config.loop (math/wrap (- @entity.slideIndex 1) 0 @n) (math/max 0 (- @entity.slideIndex 1))) }, disabled: (and (== @config.loop false) (<= @entity.slideIndex 0)) } null))),
+            { type: center, className: "flex-1 min-w-0", minHeight: @config.stageMinHeight, children: (array/map [@entity.slideIndex] (fn i { type: box, className: "w-full", children: [(array/nth @config.slides @i)] })) },
+            (array/map [(array/len @config.slides)] (fn n (if @config.showArrows { type: button, variant: ghost, size: lg, icon: @config.nextIcon, action: GO_TO, actionPayload: { index: (if @config.loop (math/wrap (+ @entity.slideIndex 1) 0 @n) (math/min (- @n 1) (+ @entity.slideIndex 1))) }, disabled: (and (== @config.loop false) (>= @entity.slideIndex (- @n 1))) } null)))
+          ]
+        }, (if @config.showProgress {
+          type: stack
+          direction: horizontal
+          gap: md
+          align: center
+          justify: center
+          children: (array/map [(array/len @config.slides)] (fn n {
+            type: stack
+            direction: horizontal
+            gap: md
+            align: center
+            children: [
+              { type: progress-dots, count: @n, currentIndex: @entity.slideIndex, onDotClick: GO_TO, size: sm },
+              { type: typography, variant: caption, color: muted, content: (str/concat "" (+ @entity.slideIndex 1) " / " @n) }
+            ]
+          }))
+        } null)]
+      }
+        @label "Body content tree"
+        @description "Render-ui tree for the deck. Default: slide centred between previous/next arrows, dot strip and counter below. A realization overrides this to restyle (full-bleed, bottom bar, no chrome) while keeping the same cursor, keys and emits."
+        @tier "internal"
+    }
+  }
+
+  page "/slide-deck" as SlideDeckPage -> SlideDeckPresenter
+}

package/behaviors/lolo/ui/core/atoms/ui-aside.lolo

@@ -1,6 +1,7 @@
 app ui-aside "1.0.0"
 "Aside — a secondary side panel that hosts navigation links or supplementary content alongside a main content area. — UI factory (1:1 with the @almadar/ui aside pattern)."
 ;; @capabilities "settings navigation sidebar, preferences menu panel, account settings nav, secondary panel, side navigation rail"
+;; @pattern "aside"
 orbital AsideOrbital {
   entity AsideItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-atlas-image.lolo

@@ -1,5 +1,6 @@
 app ui-atlas-image "1.0.0"
 "AtlasImage — UI factory (1:1 with the @almadar/ui atlas-image pattern)."
+;; @pattern "atlas-image"
 orbital AtlasImageOrbital {
   type AtlasImageAsset = {
     url : string

package/behaviors/lolo/ui/core/atoms/ui-atlas-panel.lolo

@@ -1,5 +1,6 @@
 app ui-atlas-panel "1.0.0"
 "AtlasPanel — UI factory (1:1 with the @almadar/ui atlas-panel pattern)."
+;; @pattern "atlas-panel"
 orbital AtlasPanelOrbital {
   type AtlasPanelAsset = {
     url : string

package/behaviors/lolo/ui/core/atoms/ui-avatar.lolo

@@ -1,5 +1,6 @@
 app ui-avatar "1.0.0"
 "Avatar — UI factory (1:1 with the @almadar/ui avatar pattern)."
+;; @pattern "avatar"
 orbital AvatarOrbital {
   entity AvatarItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-badge.lolo

@@ -1,5 +1,6 @@
 app ui-badge "1.0.0"
 "Badge — UI factory (1:1 with the @almadar/ui badge pattern)."
+;; @pattern "badge"
 orbital BadgeOrbital {
   type BadgeIconAsset = {
     url : asset!

package/behaviors/lolo/ui/core/atoms/ui-box.lolo

@@ -1,5 +1,6 @@
 app ui-box "1.0.0"
 "Box — UI factory (1:1 with the @almadar/ui box pattern)."
+;; @pattern "box"
 orbital BoxOrbital {
   entity BoxItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-button.lolo

@@ -1,5 +1,6 @@
 app ui-button "1.0.0"
 "Button — UI factory (1:1 with the @almadar/ui button pattern)."
+;; @pattern "button"
 orbital ButtonOrbital {
   type ButtonIconAsset = {
     url : asset!

package/behaviors/lolo/ui/core/atoms/ui-card.lolo

@@ -1,5 +1,6 @@
 app ui-card "1.0.0"
 "Card — UI factory (1:1 with the @almadar/ui card pattern)."
+;; @pattern "card"
 orbital CardOrbital {
   entity CardItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-center.lolo

@@ -1,5 +1,6 @@
 app ui-center "1.0.0"
 "Center — UI factory (1:1 with the @almadar/ui center pattern)."
+;; @pattern "center"
 orbital CenterOrbital {
   entity CenterItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-checkbox.lolo

@@ -1,5 +1,6 @@
 app ui-checkbox "1.0.0"
 "Checkbox — UI factory (1:1 with the @almadar/ui checkbox pattern)."
+;; @pattern "checkbox"
 orbital CheckboxOrbital {
   entity CheckboxItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-conditional-wrapper.lolo

@@ -1,5 +1,6 @@
 app ui-conditional-wrapper "1.0.0"
 "ConditionalWrapper — UI factory (1:1 with the @almadar/ui conditional-wrapper pattern)."
+;; @pattern "conditional-wrapper"
 orbital ConditionalWrapperOrbital {
   type ConditionalWrapperContext = {
     formValues : Map string ControlValue!

package/behaviors/lolo/ui/core/atoms/ui-confetti-effect.lolo

@@ -1,5 +1,6 @@
 app ui-confetti-effect "1.0.0"
 "ConfettiEffect — UI factory (1:1 with the @almadar/ui confetti-effect pattern)."
+;; @pattern "confetti-effect"
 orbital ConfettiEffectOrbital {
   entity ConfettiEffectItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-day-cell.lolo

@@ -1,5 +1,6 @@
 app ui-day-cell "1.0.0"
 "DayCell — UI factory (1:1 with the @almadar/ui day-cell pattern)."
+;; @pattern "day-cell"
 orbital DayCellOrbital {
   entity DayCellItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-dialog.lolo

@@ -1,5 +1,6 @@
 app ui-dialog "1.0.0"
 "Dialog — UI factory (1:1 with the @almadar/ui dialog pattern)."
+;; @pattern "dialog"
 orbital DialogOrbital {
   entity DialogItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-divider.lolo

@@ -1,5 +1,6 @@
 app ui-divider "1.0.0"
 "Divider — UI factory (1:1 with the @almadar/ui divider pattern)."
+;; @pattern "divider"
 orbital DividerOrbital {
   entity DividerItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-filter-pill.lolo

@@ -1,5 +1,6 @@
 app ui-filter-pill "1.0.0"
 "FilterPill — UI factory (1:1 with the @almadar/ui filter-pill pattern)."
+;; @pattern "filter-pill"
 orbital FilterPillOrbital {
   entity FilterPillItem [runtime] {
     id : string!

package/behaviors/lolo/ui/core/atoms/ui-flip-container.lolo

@@ -1,5 +1,6 @@
 app ui-flip-container "1.0.0"
 "FlipContainer — UI factory (1:1 with the @almadar/ui flip-container pattern)."
+;; @pattern "flip-container"
 orbital FlipContainerOrbital {
   entity FlipContainerItem [runtime] {
     id : string!