@@ -0,0 +1,45 @@
+---
+"@objectstack/spec": minor
+---
+
+feat(spec): declare `navigation` on the standalone `object-kanban` / `object-calendar` element faces, and give `object-timeline` the `ComponentPropsMap` row it never had (#17987)
+
+Clause-②: yes (widening) — one new optional key on two published element faces plus one new row, so the accept set grows. Nothing previously admitted is refused, nothing is renamed or retired, and no producer is required to write anything.
+
+**What changes for an author.** A record-click navigation block written on a
+STANDALONE element node is now declared where it is read. Before this, the same
+document ran correctly in objectui's renderer and was refused by name at the
+authoring door:
+
+```
+FROM  ComponentPropsMap['object-kanban'].safeParse({ objectName: 'task',
+        navigation: { mode: 'drawer' } })
+      -> success: false, unrecognized_keys: ['navigation']
+TO    -> success: true, navigation: { mode: 'drawer', preventNavigation: false,
+        openNewTab: false, size: 'auto' }
+```
+
+`object-calendar` moves identically. The value is `NavigationConfigSchema` —
+the same def `ListViewSchema.navigation` already declares, taken by reference,
+so a standalone element and a list view speak one vocabulary and the retired
+`navigation.view` key (17.5.0) stays retired on every face that carries it.
+
+**`object-timeline` gains a row.** It was registered in objectui and reachable
+through the component type union's open string arm with no entry in
+`ComponentPropsMap`, so the authoring gate skipped it entirely: a real key and
+a typo rode through alike. The row declares the key set measured from the
+renderer's own read points at the `.objectui-sha` pin this repo builds against
+— `objectName`, `timeline`, `filter`, `sort`, `limit`, `data`, `items`,
+`variant`, `dateFormat`, `rowLabel`, `minDate`, `maxDate`, `descriptionField`,
+`mapping` and `navigation` — and refuses everything else, the flat `startDateField` /
+`titleField` / `scale` handoff spellings with a prescription pointing at the
+`timeline` config block that owns them.
+
+**What does NOT change.** The view-level `navigation` on `ListViewSchema` is
+untouched: the element key is an ADDITIONAL carrier for the standalone
+placement, not a replacement, and both faces keep judging the same block. The
+parse is unchanged for every document that did not author these keys, and the
+component type union is not narrowed — an `object-timeline` node reaches
+`PageComponentSchema` through the open string arm exactly as it did before.
+
+Executes the objectui#8652 maintainer ruling (verbatim `B`).
@@ -73,10 +73,13 @@ error, so every failure is caught, and callers do not need a surrounding `try`/`
 The consequences are worth knowing precisely, because none of them are visible from the
 caller's side:
 
-- A failed ledger insert is reported at `error` level **once per process** — every later
-  failure drops to `debug` — and the row is simply lost. Nothing retries it. The sign-in
-  itself succeeded and returned 200, so the shipped `auth_events` list view and the
-  system-overview widgets keep showing an empty, healthy-looking screen.
+- A failed ledger insert is reported at `error` level **once per cause** — a cause is the
+  error's `code` plus the object the row is about, so every uncoded failure collapses into
+  one bucket and the object is always `sys_session` on this seam — and the row is simply
+  lost. Nothing retries it. A repeat of an **already-reported** cause drops to `debug`; a
+  **new** cause gets its own `error` line, once. The sign-in itself succeeded and returned
+  200, so the shipped `auth_events` list view and the system-overview widgets keep showing
+  an empty, healthy-looking screen.
 - The call **silently no-ops** when no data engine resolves, or when `userId` is absent.
   A caller that passes an event without a subject records nothing and is told nothing.
 - The most common cause of a failing insert is a datasource split rather than a broken
 
@@ -1,6 +1,6 @@
 ---
 title: Protocol Reference
-description: Every schema published by @objectstack/spec — 1531 schemas across 14 protocol modules
+description: Every schema published by @objectstack/spec — 1532 schemas across 14 protocol modules
 ---
 
 {/* ⚠️  AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs live in the module folders under content/docs/. */}
@@ -32,8 +32,8 @@ counts are sums of the rows they head. Regenerate with
 | [Shared Protocol](/docs/references/shared) | 10 | 31 | Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums. |
 | [Studio Protocol](/docs/references/studio) | 3 | 35 | Studio designer metadata — the authoring surfaces for the protocols above. |
 | [System Protocol](/docs/references/system) | 34 | 273 | The runtime environment — logging, jobs, cache, metrics, notifications, i18n and compliance. |
-| [UI Protocol](/docs/references/ui) | 16 | 156 | Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer. |
-| **Total** | **195** | **1531** | 14 protocol modules |
+| [UI Protocol](/docs/references/ui) | 16 | 157 | Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer. |
+| **Total** | **195** | **1532** | 14 protocol modules |
 
 ---
 
@@ -361,7 +361,7 @@ The runtime environment — logging, jobs, cache, metrics, notifications, i18n a
 
 ## UI Protocol
 
-**Source:** `packages/spec/src/ui/` · **Import:** `@objectstack/spec/ui` · **16 pages, 156 schemas**
+**Source:** `packages/spec/src/ui/` · **Import:** `@objectstack/spec/ui` · **16 pages, 157 schemas**
 
 Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer.
 
@@ -372,7 +372,7 @@ Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI lay
 | [`app.zod.ts`](/docs/references/ui/app) | `ActionNavItem`, `App`, `AppBranding`, `AppContextSelector`, `ComponentNavItem`, `DashboardNavItem`, `GroupNavItem`, `NavigationArea`, `NavigationContribution`, `NavigationItem`, `ObjectNavItem`, `PageNavItem`, `ReportNavItem`, `UrlNavItem` |
 | [`bulk-action.zod.ts`](/docs/references/ui/bulk-action) | `BulkActionDef`, `BulkActionExecution`, `BulkActionOperation`, `BulkActionParam` |
 | [`chart.zod.ts`](/docs/references/ui/chart) | `ChartAggregate`, `ChartAggregateFunction`, `ChartAnnotation`, `ChartAxis`, `ChartConfig`, `ChartDrillDown`, `ChartGroupBy`, `ChartInteraction`, `ChartSeries`, `ChartType` |
-| [`component.zod.ts`](/docs/references/ui/component) | `AIChatWindowProps`, `ElementButtonProps`, `ElementFilterProps`, `ElementFormProps`, `ElementImageProps`, `ElementMetadataViewerProps`, `ElementNumberProps`, `ElementRecordPickerProps`, `ElementTextInputProps`, `ElementTextProps`, `ObjectCalendarProps`, `ObjectFormProps`, `ObjectGanttProps`, `ObjectGridProps`, `ObjectKanbanProps`, `ObjectMapProps`, `ObjectMasterDetailFormProps`, `ObjectMetricProps`, `ObjectTreeProps`, `PageAccordionProps`, `PageCardProps`, `PageContainerProps`, `PageHeaderProps`, `PageTabsProps`, `RecordActivityProps`, `RecordAlertAction`, `RecordAlertProps`, `RecordChatterProps`, `RecordDetailsProps`, `RecordHighlightsField`, `RecordHighlightsProps`, `RecordHistoryProps`, `RecordPathProps`, `RecordQuickActionsProps`, `RecordReferenceRailProps`, `RecordRelatedListProps`, `ReferenceRailEntry` |
+| [`component.zod.ts`](/docs/references/ui/component) | `AIChatWindowProps`, `ElementButtonProps`, `ElementFilterProps`, `ElementFormProps`, `ElementImageProps`, `ElementMetadataViewerProps`, `ElementNumberProps`, `ElementRecordPickerProps`, `ElementTextInputProps`, `ElementTextProps`, `ObjectCalendarProps`, `ObjectFormProps`, `ObjectGanttProps`, `ObjectGridProps`, `ObjectKanbanProps`, `ObjectMapProps`, `ObjectMasterDetailFormProps`, `ObjectMetricProps`, `ObjectTimelineProps`, `ObjectTreeProps`, `PageAccordionProps`, `PageCardProps`, `PageContainerProps`, `PageHeaderProps`, `PageTabsProps`, `RecordActivityProps`, `RecordAlertAction`, `RecordAlertProps`, `RecordChatterProps`, `RecordDetailsProps`, `RecordHighlightsField`, `RecordHighlightsProps`, `RecordHistoryProps`, `RecordPathProps`, `RecordQuickActionsProps`, `RecordReferenceRailProps`, `RecordRelatedListProps`, `ReferenceRailEntry` |
 | [`dashboard.zod.ts`](/docs/references/ui/dashboard) | `Dashboard`, `DashboardHeader`, `DashboardHeaderAction`, `DashboardWidget`, `DashboardWidgetOptions`, `GlobalFilter`, `GlobalFilterOptionsFrom`, `WidgetActionType`, `WidgetColorVariant` |
 | [`dataset.zod.ts`](/docs/references/ui/dataset) | `Dataset`, `DatasetDimension`, `DatasetMeasure`, `DerivedMeasureOp` |
 | [`expression-bindable-text-keys.zod.ts`](/docs/references/ui/expression-bindable-text-keys) | `ExpressionBindableTextKey` |