@almadar/std 16.210.0 → 16.212.0

package/behaviors/lolo/infra/atoms/std-approval-gate.lolo

@@ -127,6 +127,7 @@ orbital ApprovalGateOrbital {
         })
       ApprovalRequestLoaded -> idle
       ApprovalRequestLoadFailed -> idle
+        (notify error (str/concat "Couldn't load the approval request — " ?error))
       ;; A replay failure can also arrive while the queue is closed.
       APPROVAL_REPLAY_FAILED -> idle
         (set @entity.id ?requestId)
@@ -136,7 +137,9 @@ orbital ApprovalGateOrbital {
         (persist update ApprovalRequest @entity {
           emit: { failure: ApprovalRequestReviewFailed, success: ApprovalRequestReviewed }
         })
-        (notify "Approval could not be applied — the request was reopened." error)
+        (notify error "Approval could not be applied — the request was reopened.")
+      ApprovalRequestReviewFailed -> idle
+        (notify error (str/concat "Couldn't reopen the approval request — " ?error))
       OPEN -> loading when @config.enabled
         (fetch ApprovalRequest {
           filter: ["=", (object/get @entity status), "pending"]
@@ -282,7 +285,7 @@ orbital ApprovalGateOrbital {
         (persist update ApprovalRequest @entity {
           emit: { failure: ApprovalRequestReviewFailed, success: ApprovalRequestReviewed }
         })
-        (notify "Approval could not be applied — the request was reopened." error)
+        (notify error "Approval could not be applied — the request was reopened.")
       CLOSE -> idle
         (render-ui @config.reviewSlot null)
     }

package/behaviors/lolo/infra/atoms/std-cache-aside.lolo

@@ -158,6 +158,12 @@ orbital CacheEntryOrbital {
           gap: md
           type: stack
         })
+      CacheEntryUpdateFailed -> loading
+        (notify error (str/concat "Couldn't update the cache entry — " ?error))
+      CacheEntryUpdated -> loading
+        (fetch CacheEntry {
+          emit: { failure: CacheEntryLoadFailed, success: CacheEntryLoaded }
+        })
     }
 
     state cached {

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

@@ -7,11 +7,11 @@ orbital CalendarSyncOrbital {
 
   entity CalendarSyncRun [persistent: calendarSyncState] {
     id : string!
-    syncToken : string @description "Scratch: Google incremental-sync token from the last listEvents; in-memory per instance — a restart falls back to a full list." @synonyms "sync cursor, next token" = ""
-    lastSyncedAt : number @description "When the last full push+pull cycle completed; 0 = never." @synonyms "last sync time" = 0
-    headId : string @description "Scratch: id of the target row the push loop is currently exporting." @synonyms "cursor, current row" = ""
-    pending : [RemoteEvent] @description "Scratch: remote events remaining in the current pull-upsert loop." @synonyms "pull queue, remaining events" = []
-    lastError : string @description "Last sync failure detail; blank = none." @synonyms "sync error, failure" = ""
+    syncToken : string @intrinsic @description "Scratch: Google incremental-sync token from the last listEvents; in-memory per instance — a restart falls back to a full list." @synonyms "sync cursor, next token" = ""
+    lastSyncedAt : number @intrinsic @description "When the last full push+pull cycle completed; 0 = never." @synonyms "last sync time" = 0
+    headId : string @intrinsic @description "Scratch: id of the target row the push loop is currently exporting." @synonyms "cursor, current row" = ""
+    pending : [RemoteEvent] @intrinsic @description "Scratch: remote events remaining in the current pull-upsert loop." @synonyms "pull queue, remaining events" = []
+    lastError : string @intrinsic @description "Last sync failure detail; blank = none." @synonyms "sync error, failure" = ""
   }
 
   entity CalendarEvent [persistent: calendarEvents] {
@@ -69,6 +69,7 @@ orbital CalendarSyncOrbital {
         (emit CAL_SYNCED { syncedAt: @entity.lastSyncedAt })
       CAL_SYNC_FAILED -> idle
         (set @entity.lastError ?error)
+        (notify error (str/concat "Couldn't sync the calendar — " ?error))
     }
 
     state pushing {
@@ -99,6 +100,7 @@ orbital CalendarSyncOrbital {
         } { emit: { failure: CAL_SYNC_FAILED, success: CAL_REMOTE_LISTED } })
       CAL_SYNC_FAILED -> idle
         (set @entity.lastError ?error)
+        (notify error (str/concat "Couldn't sync the calendar — " ?error))
     }
 
     state pulling {
@@ -137,6 +139,7 @@ orbital CalendarSyncOrbital {
         (emit CAL_SYNCED { syncedAt: @entity.lastSyncedAt })
       CAL_SYNC_FAILED -> idle
         (set @entity.lastError ?error)
+        (notify error (str/concat "Couldn't sync the calendar — " ?error))
     }
 
     emits {

package/behaviors/lolo/infra/atoms/std-cascade-on-delete.lolo

@@ -18,7 +18,7 @@ orbital CascadeOnDeleteOrbital {
     parentId : string @description "Identifier of the deleted parent the cascade is clearing dependents for." @synonyms "parent, source, origin" = ""
     parentEntity : string @description "Identifies the parent entity of the cascade." @synonyms "related entity, source entity, parent" = ""
     rowCount : number @description "The number of rows deleted by the cascade." @synonyms "count, size, quantity" = 0
-    headId : string @description "Scratch: id of the dependent row the loop is currently deleting." @synonyms "current id, cursor" = ""
+    headId : string @intrinsic @description "Scratch: id of the dependent row the loop is currently deleting." @synonyms "current id, cursor" = ""
   }
 
   trait CascadeOnDeleteGate -> CascadeLog [lifecycle, instance, cascade-delete] {
@@ -43,11 +43,18 @@ orbital CascadeOnDeleteOrbital {
         })
       DepsLoaded -> idle when ["=", (array/len (array/filter ?data (fn row ["=", (object/get @row @config.foreignKeyField), @entity.parentId]))), 0]
         (emit CascadeCompleted { parentId: @entity.parentId })
+        (persist create CascadeLog {
+          parentId: @entity.parentId
+          parentEntity: @entity.parentEntity
+          rowCount: @entity.rowCount
+        })
       CascadeStepped -> scanning
+        (set @entity.rowCount (+ @entity.rowCount 1))
         (fetch @config.dependentEntity {
           emit: { failure: CascadeFailed, success: DepsLoaded }
         })
       CascadeFailed -> idle
+        (notify error (str/concat "Couldn't cascade the delete — " ?error))
     }
 
     emits {

package/behaviors/lolo/infra/atoms/std-circuit-breaker.lolo

@@ -21,9 +21,9 @@ orbital ServiceNodeOrbital {
     description : string @description "A textual explanation of the service node's function." @synonyms "explanation, details, notes, information"
     status : "active" | "inactive" | "pending" @description "Current operational state of the component." @synonyms "state, condition, operationalStatus" = active
     createdAt : string
-    failureCount : number @description "The number of times the circuit breaker has failed." @synonyms "error count, failures, error occurrences" = 0
-    successCount : number @description "Number of successful operations." @synonyms "successes, hits, completions" = 0
-    threshold : number @description "Maximum value before triggering an action." @synonyms "limit, cap, boundary" = 5
+    failureCount : number @intrinsic @description "The number of times the circuit breaker has failed." @synonyms "error count, failures, error occurrences" = 0
+    successCount : number @intrinsic @description "Number of successful operations." @synonyms "successes, hits, completions" = 0
+    threshold : number @intrinsic @description "Maximum value before triggering an action." @synonyms "limit, cap, boundary" = 5
   }
 
   trait ShieldIcon = Icon.traits.IconRender -> ServiceNode {
@@ -170,6 +170,8 @@ orbital ServiceNodeOrbital {
           gap: lg
           type: stack
         })
+      ServiceNodeLoadFailed -> closed
+        (notify error (str/concat "Couldn't load the service node — " ?message))
       FAILURE -> open
         (render-ui main {
           children: [{

package/behaviors/lolo/infra/atoms/std-cross-reference.lolo

@@ -47,6 +47,8 @@ orbital CrossReferenceOrbital {
       LinksFetched -> idle
         (set @entity.filteredLinks (array/filter ?data (fn row ["=", (object/get @row leftId), @entity.leftId])))
         (emit LinksLoaded { data: @entity.filteredLinks, leftId: @entity.leftId })
+      LinkOpFailed -> idle
+        (notify error (str/concat "Couldn't update the link — " ?error))
     }
 
     emits {

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

@@ -97,6 +97,7 @@ orbital DataErasureOrbital {
         })
       ErasureLoaded -> idle
       ErasureLoadFailed -> idle
+        (notify error (str/concat "Couldn't load the erasure queue — " ?error))
       OPEN -> loading when @config.enabled
         (fetch ErasureRequest {
           emit: { failure: ErasureLoadFailed, success: ErasureLoaded }
@@ -127,6 +128,7 @@ orbital DataErasureOrbital {
         })
       ExecScanLoaded -> idle when ["=", (array/len ?data), 0]
       ExecScanFailed -> idle
+        (notify error (str/concat "Couldn't scan for erasures to execute — " ?error))
     }
 
     state execScanning {
@@ -153,6 +155,7 @@ orbital DataErasureOrbital {
         })
       ExecScanLoaded -> idle when ["=", (array/len ?data), 0]
       ExecScanFailed -> idle
+        (notify error (str/concat "Couldn't scan for erasures to execute — " ?error))
     }
 
     state loading {

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

@@ -34,6 +34,7 @@ orbital LifecycleOrbital {
         })
       ScanRecordsLoaded -> idle when ["=", (array/len ?data), 0]
       ScanFailed -> idle
+        (notify error (str/concat "Couldn't scan for lifecycle transitions — " ?error))
     }
 
     state scanning {
@@ -51,6 +52,7 @@ orbital LifecycleOrbital {
         })
       ScanRecordsLoaded -> idle when ["=", (array/len ?data), 0]
       ScanFailed -> idle
+        (notify error (str/concat "Couldn't scan for lifecycle transitions — " ?error))
     }
 
     emits {

package/behaviors/lolo/infra/atoms/std-migration-job.lolo

@@ -68,6 +68,7 @@ orbital MigrationJobOrbital {
           target: @entity.target
         })
         (emit MIGRATION_FAILED { error: @entity.error })
+        (notify error (str/concat "Couldn't list the source documents — " ?error))
     }
 
     state mapping {
@@ -114,6 +115,7 @@ orbital MigrationJobOrbital {
           target: @entity.target
         })
         (emit MIGRATION_FAILED { error: @entity.error })
+        (notify error (str/concat "Couldn't fetch the document — " ?error))
     }
 
     state reviewing {
@@ -135,6 +137,15 @@ orbital MigrationJobOrbital {
         (set @entity.skipped [])
         (set @entity.validationErrors [])
         (render-ui @config.reviewSlot null)
+      CLOSE -> idle
+        (set @entity.status idle)
+        (set @entity.documents [])
+        (set @entity.document {})
+        (set @entity.stats {})
+        (set @entity.units [])
+        (set @entity.skipped [])
+        (set @entity.validationErrors [])
+        (render-ui @config.reviewSlot null)
     }
 
     state committing {
@@ -162,6 +173,7 @@ orbital MigrationJobOrbital {
           target: @entity.target
         })
         (emit MIGRATION_FAILED { error: @entity.error })
+        (notify error (str/concat "Couldn't commit the import — " ?error))
     }
 
     state done {

package/behaviors/lolo/infra/atoms/std-mod-queue.lolo

@@ -90,6 +90,7 @@ orbital ModQueueItemOrbital {
         })
       ModQueueItemLoaded -> idle
       ModQueueItemLoadFailed -> idle
+        (notify error (str/concat "Couldn't load the moderation queue — " ?error))
       OPEN -> loading when @config.enabled
         (fetch ModQueueItem {
           emit: { failure: ModQueueItemLoadFailed, success: ModQueueItemLoaded }

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

@@ -190,6 +190,7 @@ orbital NotificationCenterOrbital {
       DIGEST_ROWS_LOADED -> idle when ["=", (array/len ?data), 0]
       DIGEST_FAILED -> idle
         (set @entity.lastError ?error)
+        (notify error (str/concat "Couldn't send the notification digest — " ?error))
     }
 
     state draining {
@@ -216,6 +217,7 @@ orbital NotificationCenterOrbital {
       DIGEST_ROWS_LOADED -> idle when ["=", (array/len ?data), 0]
       DIGEST_FAILED -> idle
         (set @entity.lastError ?error)
+        (notify error (str/concat "Couldn't send the notification digest — " ?error))
     }
 
     emits {

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

@@ -176,6 +176,7 @@ orbital NotifyOnEventOrbital {
           recordedAt: @now
           severity: @entity.severity
         })
+        (notify error (str/concat "Couldn't send the email notification — " ?error))
       NOTIFY_SMS_SENT -> idle
         (set @entity.dispatched true)
         (persist create NotificationRecord {
@@ -198,6 +199,7 @@ orbital NotifyOnEventOrbital {
           recordedAt: @now
           severity: @entity.severity
         })
+        (notify error (str/concat "Couldn't send the text message — " ?error))
       NOTIFY_WEBHOOK_SENT -> idle
         (set @entity.dispatched true)
         (persist create NotificationRecord {
@@ -220,6 +222,7 @@ orbital NotifyOnEventOrbital {
           recordedAt: @now
           severity: @entity.severity
         })
+        (notify error (str/concat "Couldn't send the webhook notification — " ?error))
       NOTIFY_PUSH_SENT -> idle
         (set @entity.dispatched true)
         (persist create NotificationRecord {
@@ -242,6 +245,7 @@ orbital NotifyOnEventOrbital {
           recordedAt: @now
           severity: @entity.severity
         })
+        (notify error (str/concat "Couldn't send the push notification — " ?error))
       NOTIFY_LOOKUP_FAILED -> idle
         (set @entity.dispatched false)
         (set @entity.error ?error)
@@ -254,6 +258,7 @@ orbital NotifyOnEventOrbital {
           recordedAt: @now
           severity: @entity.severity
         })
+        (notify error (str/concat "Couldn't look up notification preferences — " ?error))
     }
 
     emits {

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

@@ -37,6 +37,7 @@ orbital ReminderSchedulerOrbital {
         })
       ScanRecordsLoaded -> idle when ["=", (array/len ?data), 0]
       ScanFailed -> idle
+        (notify error (str/concat "Couldn't scan for reminders — " ?error))
     }
 
     state scanning {
@@ -57,6 +58,7 @@ orbital ReminderSchedulerOrbital {
         })
       ScanRecordsLoaded -> idle when ["=", (array/len ?data), 0]
       ScanFailed -> idle
+        (notify error (str/concat "Couldn't scan for reminders — " ?error))
     }
 
     emits {

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

@@ -31,6 +31,7 @@ orbital StatusLifecycleOrbital {
       StatusPersisted -> idle when ["!=", (str/default ?id ""), ""]
         (emit StatusChanged { entityId: ?id, status: (str/default (object/get @payload @config.statusField) "") })
       StatusChangeFailed -> idle
+        (notify error (str/concat "Couldn't change the status — " ?error))
     }
 
     emits {

package/behaviors/lolo/ml/atoms/std-ml-classify.lolo

@@ -73,6 +73,7 @@ orbital MlClassifyOrbital {
         (set @entity.errorMessage ?error)
         (set @entity.status done)
         (emit CLASSIFY_FAILED { error: @entity.errorMessage })
+        (notify error (str/concat "Couldn't classify — " ?error))
     }
 
     state done {

package/behaviors/lolo/ml/atoms/std-ml-infer.lolo

@@ -87,6 +87,7 @@ orbital MlInferOrbital {
         (set @entity.reason "unavailable")
         (set @entity.status resolved)
         (emit INFER_ABSTAINED { reason: "unavailable", violations: @entity.violations, request: @entity.request })
+        (notify error (str/concat "Couldn't run inference — " ?error))
     }
 
     state resolved {

package/behaviors/lolo/ui/core/atoms/std-app-layout.lolo

@@ -49,6 +49,7 @@ orbital AppLayoutOrbital {
         })
       AppLayoutStateLoaded -> composing
       AppLayoutStateLoadFailed -> composing
+        (notify error (str/concat "Couldn't load the layout — " ?error))
       SEARCH -> composing
       NOTIFY_CLICK -> composing
     }

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

@@ -268,6 +268,12 @@ orbital BoardOrbital {
           label: (object/get @col label)
           variant: (object/get @col variant default)
         })))
+      BoardItemsSaveFailed -> viewing_board
+        (set @entity.errorMessage ?error)
+        (notify error (str/concat "Couldn't save the board — " ?error))
+      BoardItemsLoadFailed -> viewing_board
+        (set @entity.errorMessage ?error)
+        (notify error (str/concat "Couldn't refresh the board — " ?error))
     }
 
     state viewing_card {

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

@@ -105,7 +105,7 @@ orbital BrowseItemOrbital {
       REFETCH_QUERY -> browsing
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
-          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm)))
+          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm)))
           include: @config.include
           limit: @config.pageSize
           offset: 0
@@ -146,6 +146,10 @@ orbital BrowseItemOrbital {
                 (if ["=", @config.browseLook, triage]
                   (render-ui main @config.triageBodyContent)
                   (render-ui main @config.bodyContent))))))
+      ;; A refetch keeps the populated body on screen; only the failure
+      ;; itself has to reach the user.
+      BrowseItemLoadFailed -> browsing
+        (notify error (str/concat "Couldn't refresh the list — " ?error))
     }
 
     state error {
@@ -372,6 +376,11 @@ orbital BrowseItemOrbital {
         @description "Adds a checkbox column with select-all to the dense table. Enable only when the surface offers bulk actions — checkboxes with nothing to act on are a dead affordance."
         @synonyms "row checkboxes, multi-select, bulk select, selection column"
         @tier "presentation"
+      searchField : string = "name"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, content) or the search box can never match a row."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       bodySearch : boolean = true
         @label "Show the list's own search box?"
         @description "The dense/feed/gallery looks embed their own search box above the rows. Set false when the page already provides a search affordance (a toolbar Search molecule), so the surface shows one search box instead of two."

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

@@ -116,7 +116,7 @@ orbital CalendarEventOrbital {
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
           include: @config.include
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm))
         })
       REFETCH_FILTER -> loading
         (fetch CalendarEvent {
@@ -283,6 +283,11 @@ orbital CalendarEventOrbital {
         @description "Row field the agenda list groups its day sections by. Rebound hosts point this at their own timestamp column (e.g. startTime, scheduledAt)."
         @synonyms "group field, section field, day field"
         @tier "presentation"
+      searchField : string = "name"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, description) or the search box can never match a row."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       bodySearch : boolean = false
         @label "Show the calendar's own search box?"
         @description "Embeds a title search box in the toolbar above the calendar body (all three calendarLook trees). Defaults false: std-calendar has never had a search box, so an untouched consumer's surface is unchanged; the primary path is composing std-search beside this atom and wiring XSearch.SEARCH -> REFETCH_QUERY. Set true only for a standalone calendar with no page-level search affordance."

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

@@ -28,6 +28,8 @@ orbital ConfirmActionOrbital {
         (fetch ConfirmAction {
           emit: { failure: ConfirmActionLoadFailed, success: ConfirmActionLoaded }
         })
+      ConfirmActionLoadFailed -> idle
+        (notify error (str/concat "Couldn't load the item to confirm — " ?error))
       ;; Guard: REQUEST is rejected if no `row` payload was provided.
       ;; "Confirm an action against X" is meaningless without X — a
       ;; confirmation dialog with no entity to display is a precondition

package/behaviors/lolo/ui/core/atoms/std-esign-request.lolo

@@ -99,10 +99,10 @@ orbital ESignRequestOrbital {
     state browsing {
       SEND_REQUEST -> browsing
         (set @entity.id ?id)
-        (notify "Signature request sent" success)
+        (notify success "Signature request sent")
       REVOKE_REQUEST -> browsing
         (set @entity.id ?id)
-        (notify "Signature request revoked" info)
+        (notify info "Signature request revoked")
     }
 
     state error {

package/behaviors/lolo/ui/core/atoms/std-event-log.lolo

@@ -256,6 +256,8 @@ orbital EventLogOrbital {
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
+      EventLogLoadFailed -> viewing
+        (notify error (str/concat "Couldn't refresh the event log — " ?error))
       EventLogLoaded -> viewing
         (set @entity.filterChips (array/prepend (array/map @config.kindOptions (fn k {
           icon: (object/get @k icon circle)

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

@@ -160,7 +160,7 @@ orbital GalleryItemOrbital {
       REFETCH_QUERY -> browsing
         (fetch GalleryItem {
           emit: { failure: GalleryItemLoadFailed, success: GalleryItemLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm))
           limit: @config.pageSize
           offset: 0
         })
@@ -177,6 +177,8 @@ orbital GalleryItemOrbital {
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
+      GalleryItemLoadFailed -> browsing
+        (notify error (str/concat "Couldn't refresh the gallery — " ?error))
       GalleryItemLoaded -> browsing
         (render-ui main {
           children: [{
@@ -360,6 +362,11 @@ orbital GalleryItemOrbital {
         @description "Entity field holding the image URL shown in the lightbox for the selected item"
         @synonyms "image url field, thumbnail field, src field"
         @tier "presentation"
+      searchField : string = "name"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, caption) or the search box can never match a row."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       bodySearch : boolean = false
         @label "Show the gallery's own search box?"
         @description "Embeds a search box above the gallery grid. Set false (the default) when the page already provides a search affordance (a toolbar Search molecule), so the surface shows one search box instead of two."

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

@@ -8,7 +8,7 @@ orbital GraphItemOrbital {
 
   entity GraphItem [runtime] {
     id : string!
-    chartData : [ChartPoint] @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" = []
   }
 
   trait GraphItemGraph -> @rebindable GraphItem [interaction, instance] {

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

@@ -179,7 +179,7 @@ orbital ListItemOrbital {
       REFETCH_QUERY -> browsing
         (fetch ListItem {
           emit: { failure: ListItemLoadFailed, success: ListItemLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm))
         })
       REFETCH_FILTER -> browsing
         (fetch ListItem {
@@ -193,6 +193,8 @@ orbital ListItemOrbital {
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
+      ListItemLoadFailed -> browsing
+        (notify error (str/concat "Couldn't refresh the list — " ?error))
       ListItemLoaded -> browsing
         (render-ui main {
           children: [{
@@ -354,6 +356,11 @@ orbital ListItemOrbital {
     }
 
     config {
+      searchField : string = "name"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, label) or the search box can never match a row."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       bodySearch : boolean = false
         @label "Show the list's own search box?"
         @description "Embeds a search box above the grid. Set true only when the page has no other search affordance (e.g. no page-level std-search), so the surface shows one search box instead of two. False is the default — this atom has never had a search box (0 consumers today)."

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

@@ -36,6 +36,8 @@ orbital ModalRecordOrbital {
         (fetch ModalRecord {
           emit: { failure: ModalRecordLoadFailed, success: ModalRecordLoaded }
         })
+      ModalRecordLoadFailed -> closed
+        (notify error (str/concat "Couldn't load the record — " ?error))
       ;; stash only — a SEED never opens anything; OPEN reads it on demand
       SEED -> closed
         (set @entity.seedRow (object/merge ?row {}))
@@ -78,7 +80,7 @@ orbital ModalRecordOrbital {
         (set @entity.seedRow (object/merge ?row {}))
       CLOSE -> closed
         (render-ui @config.detailSlot null)
-        (notify Cancelled info)
+        (notify info Cancelled)
       SAVE -> closed
         (render-ui @config.detailSlot null)
     }

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

@@ -145,7 +145,7 @@ orbital SelectableItemOrbital {
       REFETCH_QUERY -> idle
         (fetch SelectableItem {
           emit: { failure: SelectableItemLoadFailed, success: SelectableItemLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm))
         })
       REFETCH_FILTER -> idle
         (fetch SelectableItem {
@@ -166,6 +166,8 @@ orbital SelectableItemOrbital {
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
+      SelectableItemLoadFailed -> idle
+        (notify error (str/concat "Couldn't refresh the list — " ?error))
       SelectableItemLoaded -> idle
         (render-ui main {
           children: [{
@@ -429,6 +431,11 @@ orbital SelectableItemOrbital {
         @label "Table look"
         @description "Layer 2 visual treatment for the data table rendered by this atom."
         @tier "presentation"
+      searchField : string = "name"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, label) or the search box can never match a row."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       bodySearch : boolean = false
         @label "Show the pick-list's own search box?"
         @description "Embeds a search box above the pick-list. Set true only when the page has no other search affordance (e.g. no page-level std-search), so the surface shows one search box instead of two. False is the default — this atom has never had a search box (0 consumers today)."

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

@@ -15,7 +15,7 @@ orbital StatsItemOrbital {
 
   entity StatsItem [runtime] {
     id : string!
-    cards : [StatCard] @description "A collection of statistical cards to display." @synonyms "statistics, items, displays" = []
+    cards : [StatCard] @intrinsic @description "A collection of statistical cards to display." @synonyms "statistics, items, displays" = []
   }
 
   trait StatsItemStats -> @rebindable StatsItem [interaction, instance] {

package/behaviors/lolo/ui/core/atoms/std-step-flow.lolo

@@ -16,7 +16,8 @@ orbital StepFlowOrbital {
   entity StepFlowView [runtime] {
     id : string!
     wizardSteps : [WizardStep] @intrinsic = []
-    currentStepIndex : number @intrinsic = 0
+    ;; Not @intrinsic: std-approval-chain's ApprovalRequest persists this as chain position.
+    currentStepIndex : number = 0
     totalSteps : number @intrinsic = 0
     currentStepLabel : string @intrinsic = ""
     currentStepDescription : string @intrinsic = ""
@@ -26,8 +27,8 @@ orbital StepFlowOrbital {
     primaryActionLabel : string @intrinsic = "Approve & Continue"
     primaryActionVariant : "primary" | "success" @intrinsic = primary
     primaryActionIcon : string @intrinsic = chevron-right
-    finalStatus : "approved" | "rejected" | "escalated" | "" @intrinsic = ""
-    rejectionReason : string @intrinsic = ""
+    finalStatus : "approved" | "rejected" | "escalated" | "" = ""
+    rejectionReason : string = ""
     errorMessage : string @intrinsic = ""
   }
 

package/behaviors/lolo/ui/core/atoms/std-tag-strip.lolo

@@ -35,6 +35,7 @@ orbital TagStripOrbital {
       ;; Pre-scope paint: the store is warm but no record is open yet.
       TagStripOptions -> idle
       TagStripLoadFailed -> idle
+        (notify error (str/concat "Couldn't load tags — " ?error))
       SHOW_TAG_STRIP -> loading
         (set @entity.docId ?id)
         (set @entity.docTagIds (array/map ?tagIds (fn t (str/default (object/get @t id) @t))))