@synap-core/cli 1.10.0 → 1.12.2

package/skills/synap-ui/bento-recipes.md

@@ -1,8 +1,12 @@
 # Bento recipes — reference
 
-Ready-to-adapt layouts for the most common user asks. Each recipe is a starting point — verify widget kinds against `/widget-definitions` and swap in real IDs before committing.
+Ready-to-adapt layouts for the most common user asks. Each recipe is the `widgets` array you send to `POST /api/hub/views/{bentoViewId}/arrange` (IS: `arrange_workspace`): `{ key, config, x, y, w, h }` on the 12-column grid. Arrange validates every key against the catalog and refuses a missing required config, so a recipe that arranges cleanly renders.
 
-All coordinates use the 12-column grid. `layout: { x, y, w, h }`.
+Before using one:
+
+1. `synap_list_widgets` — confirm each key is listed for this workspace (and read its `requiredConfig`).
+2. `synap_list_profiles` — swap the example `profileSlug`s for ones that exist.
+3. A `view` block needs a saved view: `synap_list_views` for its `viewId`, or `synap_create_view` first.
 
 ---
 
@@ -10,589 +14,355 @@ All coordinates use the 12-column grid. `layout: { x, y, w, h }`.
 
 _User asks: "Give me a home dashboard."_
 
-The canonical landing page. What matters today + quick access + recent activity.
+What matters today, quick access, recent activity.
 
 ```json
-{
-  "name": "Home",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "h1",
-        "kind": "widget",
-        "widgetKind": "section-header",
-        "layout": { "x": 0, "y": 0, "w": 12, "h": 1 },
-        "config": { "title": "Today", "subtitle": "{{date}}" }
-      },
-
-      {
-        "id": "h2",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 0, "y": 1, "w": 3, "h": 2 },
-        "config": {
-          "label": "Due today",
-          "metric": "count",
-          "filter": {
-            "profileSlug": "task",
-            "properties.dueDate": "today",
-            "properties.status": ["todo", "in-progress"]
-          },
-          "icon": "calendar"
-        }
-      },
-
-      {
-        "id": "h3",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 3, "y": 1, "w": 3, "h": 2 },
-        "config": {
-          "label": "This week",
-          "metric": "count",
-          "filter": {
-            "profileSlug": "event",
-            "properties.startDate": "this-week"
-          },
-          "icon": "calendar-days"
-        }
-      },
-
-      {
-        "id": "h4",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 6, "y": 1, "w": 3, "h": 2 },
-        "config": {
-          "label": "Pending review",
-          "metric": "count",
-          "filter": { "type": "proposal", "status": "pending" },
-          "icon": "inbox"
-        }
-      },
-
-      {
-        "id": "h5",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 9, "y": 1, "w": 3, "h": 2 },
-        "config": {
-          "label": "Captured this week",
-          "metric": "count",
-          "filter": { "createdAt": "this-week" },
-          "icon": "zap"
-        }
-      },
-
-      {
-        "id": "h6",
-        "kind": "widget",
-        "widgetKind": "view-list",
-        "layout": { "x": 0, "y": 3, "w": 6, "h": 5 },
-        "config": {
-          "profileSlug": "task",
-          "primaryField": "title",
-          "secondaryFields": ["priority", "dueDate", "projectId"],
-          "filters": [
-            {
-              "property": "status",
-              "op": "in",
-              "value": ["todo", "in-progress"]
-            }
-          ],
-          "sort": [{ "property": "priority", "direction": "desc" }],
-          "limit": 10
-        }
-      },
-
-      {
-        "id": "h7",
-        "kind": "widget",
-        "widgetKind": "proactive-feed",
-        "layout": { "x": 6, "y": 3, "w": 6, "h": 5 },
-        "config": { "limit": 8 }
-      },
-
-      {
-        "id": "h8",
-        "kind": "widget",
-        "widgetKind": "feed",
-        "layout": { "x": 0, "y": 8, "w": 12, "h": 4 },
-        "config": { "sources": ["entity.create", "entity.update"], "limit": 20 }
-      }
-    ]
-  }
-}
+[
+  {
+    "key": "greeting",
+    "config": { "showDate": true },
+    "x": 0,
+    "y": 0,
+    "w": 8,
+    "h": 2
+  },
+  { "key": "quick-access", "config": {}, "x": 8, "y": 0, "w": 4, "h": 2 },
+  {
+    "key": "stat-card",
+    "config": { "profileSlug": "task", "label": "Open tasks" },
+    "x": 0,
+    "y": 2,
+    "w": 3,
+    "h": 3
+  },
+  {
+    "key": "stat-card",
+    "config": {
+      "profileSlug": "note",
+      "label": "Notes this week",
+      "timePeriod": "week"
+    },
+    "x": 3,
+    "y": 2,
+    "w": 3,
+    "h": 3
+  },
+  { "key": "inbox", "config": { "limit": 8 }, "x": 6, "y": 2, "w": 6, "h": 6 },
+  {
+    "key": "entity-list",
+    "config": {
+      "profileSlug": "task",
+      "title": "Next up",
+      "sortField": "priority",
+      "sortDirection": "desc",
+      "limit": 10
+    },
+    "x": 0,
+    "y": 5,
+    "w": 6,
+    "h": 6
+  },
+  { "key": "feed", "config": { "limit": 20 }, "x": 0, "y": 11, "w": 12, "h": 4 }
+]
 ```
 
----
-
 ## Recipe: Project overview
 
-_User asks: "Make me a page for Project X."_
+_User asks: "Make a page for project X."_
 
-Built around one entity. Shows context + child tasks + documents + activity.
+Pair the bento with a kanban **view** of the project's tasks (create it first, then embed its id).
 
 ```json
-{
-  "name": "{{projectName}}",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "p1",
-        "kind": "entity",
-        "entityId": "{{projectId}}",
-        "layout": { "x": 0, "y": 0, "w": 12, "h": 3 }
-      },
-
-      {
-        "id": "p2",
-        "kind": "widget",
-        "widgetKind": "view-kanban",
-        "layout": { "x": 0, "y": 3, "w": 8, "h": 6 },
-        "config": {
-          "profileSlug": "task",
-          "groupBy": { "property": "status" },
-          "filters": [
-            { "property": "projectId", "op": "eq", "value": "{{projectId}}" }
-          ]
-        }
-      },
-
-      {
-        "id": "p3",
-        "kind": "widget",
-        "widgetKind": "entity-gallery",
-        "layout": { "x": 8, "y": 3, "w": 4, "h": 3 },
-        "config": {
-          "profileSlug": "file",
-          "filters": [
-            { "property": "projectId", "op": "eq", "value": "{{projectId}}" }
-          ],
-          "limit": 6
-        }
-      },
-
-      {
-        "id": "p4",
-        "kind": "widget",
-        "widgetKind": "feed",
-        "layout": { "x": 8, "y": 6, "w": 4, "h": 3 },
-        "config": { "entityId": "{{projectId}}", "limit": 10 }
-      }
-    ]
+[
+  {
+    "key": "section-header",
+    "config": { "title": "Project X" },
+    "x": 0,
+    "y": 0,
+    "w": 12,
+    "h": 2
+  },
+  {
+    "key": "view",
+    "config": { "viewId": "<tasks kanban viewId>", "layout": "kanban" },
+    "x": 0,
+    "y": 2,
+    "w": 8,
+    "h": 8
+  },
+  {
+    "key": "chart-pie",
+    "config": {
+      "profileSlug": "task",
+      "groupBy": "status",
+      "label": "Tasks by status"
+    },
+    "x": 8,
+    "y": 2,
+    "w": 4,
+    "h": 5
+  },
+  {
+    "key": "entity-gallery",
+    "config": { "profileSlug": "file", "title": "Files", "limit": 6 },
+    "x": 8,
+    "y": 7,
+    "w": 4,
+    "h": 4
   }
-}
+]
 ```
 
----
-
 ## Recipe: CRM home
 
-_User asks: "Make me a CRM."_
-
-Pipeline-forward. Deals, contacts, upcoming meetings.
+_User asks: "Build me a CRM dashboard."_
 
 ```json
-{
-  "name": "CRM",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "c1",
-        "kind": "widget",
-        "widgetKind": "section-header",
-        "layout": { "x": 0, "y": 0, "w": 12, "h": 1 },
-        "config": { "title": "Pipeline" }
-      },
-
-      {
-        "id": "c2",
-        "kind": "widget",
-        "widgetKind": "view-kanban",
-        "layout": { "x": 0, "y": 1, "w": 12, "h": 6 },
-        "config": {
-          "profileSlug": "deal",
-          "groupBy": { "property": "stage" },
-          "cardFields": ["title", "value", "closeDate", "contactId"]
-        }
-      },
-
-      {
-        "id": "c3",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 0, "y": 7, "w": 4, "h": 2 },
-        "config": {
-          "label": "Open pipeline",
-          "metric": "sum",
-          "metricField": "value",
-          "filter": {
-            "profileSlug": "deal",
-            "properties.stage": ["lead", "qualified", "proposal"]
-          },
-          "format": "currency",
-          "icon": "trending-up"
-        }
-      },
-
-      {
-        "id": "c4",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 4, "y": 7, "w": 4, "h": 2 },
-        "config": {
-          "label": "Closing this month",
-          "metric": "count",
-          "filter": {
-            "profileSlug": "deal",
-            "properties.closeDate": "this-month"
-          },
-          "icon": "clock"
-        }
-      },
-
-      {
-        "id": "c5",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 8, "y": 7, "w": 4, "h": 2 },
-        "config": {
-          "label": "New contacts (30d)",
-          "metric": "count",
-          "filter": { "profileSlug": "contact", "createdAt": "last-30-days" },
-          "icon": "user-plus"
-        }
-      },
-
-      {
-        "id": "c6",
-        "kind": "widget",
-        "widgetKind": "view-calendar",
-        "layout": { "x": 0, "y": 9, "w": 8, "h": 5 },
-        "config": {
-          "profileSlug": "event",
-          "dateProperty": "startDate",
-          "endDateProperty": "endDate",
-          "view": "week",
-          "filters": [{ "property": "relatedToContact", "op": "exists" }]
-        }
-      },
-
-      {
-        "id": "c7",
-        "kind": "widget",
-        "widgetKind": "view-list",
-        "layout": { "x": 8, "y": 9, "w": 4, "h": 5 },
-        "config": {
-          "profileSlug": "contact",
-          "primaryField": "title",
-          "secondaryFields": ["role", "companyId"],
-          "sort": [{ "property": "lastInteractionAt", "direction": "desc" }],
-          "limit": 12
-        }
-      }
-    ]
+[
+  {
+    "key": "stat-card",
+    "config": {
+      "profileSlug": "deal",
+      "aggregation": "sum",
+      "field": "value",
+      "label": "Pipeline value"
+    },
+    "x": 0,
+    "y": 0,
+    "w": 3,
+    "h": 3
+  },
+  {
+    "key": "stat-card",
+    "config": { "profileSlug": "deal", "label": "Open deals" },
+    "x": 3,
+    "y": 0,
+    "w": 3,
+    "h": 3
+  },
+  {
+    "key": "stat-card",
+    "config": { "profileSlug": "contact", "label": "Contacts" },
+    "x": 6,
+    "y": 0,
+    "w": 3,
+    "h": 3
+  },
+  {
+    "key": "chart-bar",
+    "config": {
+      "profileSlug": "deal",
+      "groupBy": "stage",
+      "aggregation": "sum",
+      "valueField": "value",
+      "label": "Value by stage"
+    },
+    "x": 0,
+    "y": 3,
+    "w": 6,
+    "h": 5
+  },
+  {
+    "key": "view",
+    "config": { "viewId": "<deals kanban viewId>", "layout": "kanban" },
+    "x": 6,
+    "y": 3,
+    "w": 6,
+    "h": 8
+  },
+  {
+    "key": "calendar",
+    "config": {
+      "profileSlug": "event",
+      "dateField": "startDate",
+      "endDateField": "endDate",
+      "defaultView": "timeGridWeek"
+    },
+    "x": 0,
+    "y": 8,
+    "w": 6,
+    "h": 8
+  },
+  {
+    "key": "entity-list",
+    "config": {
+      "profileSlug": "contact",
+      "title": "Recently contacted",
+      "sortField": "lastInteractionAt",
+      "sortDirection": "desc",
+      "limit": 10
+    },
+    "x": 6,
+    "y": 11,
+    "w": 6,
+    "h": 5
   }
-}
+]
 ```
 
----
-
 ## Recipe: Content pipeline
 
-_User asks: "Make me a content creation workspace / dashboard."_
-
-Assumes a `draft` profile exists (extend `article` via `synap-schema`).
+_User asks: "Help me manage my content."_
 
 ```json
-{
-  "name": "Content Pipeline",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "ct1",
-        "kind": "widget",
-        "widgetKind": "view-kanban",
-        "layout": { "x": 0, "y": 0, "w": 12, "h": 6 },
-        "config": {
-          "profileSlug": "draft",
-          "groupBy": { "property": "status" },
-          "columnOrder": ["idea", "writing", "review", "published"],
-          "cardFields": ["title", "wordCount", "publishDate"]
-        }
-      },
-
-      {
-        "id": "ct2",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 0, "y": 6, "w": 4, "h": 2 },
-        "config": {
-          "label": "Published this month",
-          "metric": "count",
-          "filter": {
-            "profileSlug": "draft",
-            "properties.status": "published",
-            "properties.publishDate": "this-month"
-          }
-        }
-      },
-
-      {
-        "id": "ct3",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 4, "y": 6, "w": 4, "h": 2 },
-        "config": {
-          "label": "Words written this week",
-          "metric": "sum",
-          "metricField": "wordCount",
-          "filter": { "updatedAt": "this-week" }
-        }
-      },
-
-      {
-        "id": "ct4",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 8, "y": 6, "w": 4, "h": 2 },
-        "config": {
-          "label": "In review",
-          "metric": "count",
-          "filter": { "profileSlug": "draft", "properties.status": "review" }
-        }
-      },
-
-      {
-        "id": "ct5",
-        "kind": "widget",
-        "widgetKind": "entity-gallery",
-        "layout": { "x": 0, "y": 8, "w": 12, "h": 4 },
-        "config": {
-          "profileSlug": "article",
-          "filters": [
-            { "property": "source", "op": "eq", "value": "research" }
-          ],
-          "imageProperty": "thumbnail",
-          "limit": 12
-        }
-      }
-    ]
+[
+  {
+    "key": "view",
+    "config": { "viewId": "<drafts kanban viewId>", "layout": "kanban" },
+    "x": 0,
+    "y": 0,
+    "w": 12,
+    "h": 8
+  },
+  {
+    "key": "stat-card",
+    "config": {
+      "profileSlug": "draft",
+      "label": "Published this month",
+      "timePeriod": "month"
+    },
+    "x": 0,
+    "y": 8,
+    "w": 4,
+    "h": 3
+  },
+  {
+    "key": "chart-line",
+    "config": {
+      "profileSlug": "draft",
+      "timePeriod": "week",
+      "label": "Drafts per week"
+    },
+    "x": 4,
+    "y": 8,
+    "w": 8,
+    "h": 5
   }
-}
+]
 ```
 
----
-
 ## Recipe: Reading list
 
 _User asks: "Show me my reading list."_
 
-Simple masonry/gallery + stats.
-
 ```json
-{
-  "name": "Reading",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "r1",
-        "kind": "widget",
-        "widgetKind": "section-header",
-        "layout": { "x": 0, "y": 0, "w": 12, "h": 1 },
-        "config": { "title": "To read" }
-      },
-
-      {
-        "id": "r2",
-        "kind": "widget",
-        "widgetKind": "entity-gallery",
-        "layout": { "x": 0, "y": 1, "w": 8, "h": 8 },
-        "config": {
-          "profileSlug": "article",
-          "filters": [{ "property": "status", "op": "neq", "value": "read" }],
-          "sort": [{ "property": "createdAt", "direction": "desc" }],
-          "imageProperty": "thumbnail",
-          "captionProperty": "domain",
-          "limit": 24
-        }
-      },
-
-      {
-        "id": "r3",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 8, "y": 1, "w": 4, "h": 2 },
-        "config": {
-          "label": "Saved this week",
-          "metric": "count",
-          "filter": { "profileSlug": "article", "createdAt": "this-week" }
-        }
-      },
-
-      {
-        "id": "r4",
-        "kind": "widget",
-        "widgetKind": "view-list",
-        "layout": { "x": 8, "y": 3, "w": 4, "h": 6 },
-        "config": {
-          "profileSlug": "article",
-          "primaryField": "title",
-          "secondaryFields": ["readAt"],
-          "filters": [{ "property": "status", "op": "eq", "value": "read" }],
-          "sort": [{ "property": "readAt", "direction": "desc" }],
-          "limit": 10
-        }
-      }
-    ]
+[
+  {
+    "key": "stat-card",
+    "config": { "profileSlug": "article", "label": "Unread" },
+    "x": 0,
+    "y": 0,
+    "w": 4,
+    "h": 3
+  },
+  {
+    "key": "entity-spotlight",
+    "config": { "profileSlug": "article", "seed": "daily" },
+    "x": 4,
+    "y": 0,
+    "w": 8,
+    "h": 3
+  },
+  {
+    "key": "entity-gallery",
+    "config": { "profileSlug": "article", "title": "To read", "limit": 12 },
+    "x": 0,
+    "y": 3,
+    "w": 8,
+    "h": 6
+  },
+  {
+    "key": "entity-list",
+    "config": {
+      "profileSlug": "article",
+      "title": "Recently read",
+      "sortField": "readAt",
+      "sortDirection": "desc",
+      "limit": 10
+    },
+    "x": 8,
+    "y": 3,
+    "w": 4,
+    "h": 6
   }
-}
+]
 ```
 
----
-
 ## Recipe: Daily briefing
 
-_User asks: "Every morning show me what matters."_
-
-Minimal. AI-driven. Designed to be scannable in 30 seconds.
+_User asks: "What should I look at every morning?"_
 
 ```json
-{
-  "name": "Morning Briefing",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "m1",
-        "kind": "widget",
-        "widgetKind": "morning-briefing",
-        "layout": { "x": 0, "y": 0, "w": 12, "h": 4 }
-      },
-
-      {
-        "id": "m2",
-        "kind": "widget",
-        "widgetKind": "view-list",
-        "layout": { "x": 0, "y": 4, "w": 6, "h": 5 },
-        "config": {
-          "profileSlug": "task",
-          "primaryField": "title",
-          "secondaryFields": ["dueDate"],
-          "filters": [
-            { "property": "dueDate", "op": "lte", "value": "today" },
-            {
-              "property": "status",
-              "op": "in",
-              "value": ["todo", "in-progress"]
-            }
-          ],
-          "limit": 8
-        }
-      },
-
-      {
-        "id": "m3",
-        "kind": "widget",
-        "widgetKind": "view-calendar",
-        "layout": { "x": 6, "y": 4, "w": 6, "h": 5 },
-        "config": {
-          "profileSlug": "event",
-          "dateProperty": "startDate",
-          "view": "day"
-        }
-      }
-    ]
-  }
-}
+[
+  {
+    "key": "greeting",
+    "config": { "showDate": true, "showCapturedToday": true },
+    "x": 0,
+    "y": 0,
+    "w": 12,
+    "h": 2
+  },
+  {
+    "key": "entity-list",
+    "config": {
+      "profileSlug": "task",
+      "title": "Due soon",
+      "sortField": "dueDate",
+      "sortDirection": "asc",
+      "limit": 8
+    },
+    "x": 0,
+    "y": 2,
+    "w": 6,
+    "h": 6
+  },
+  {
+    "key": "calendar",
+    "config": {
+      "profileSlug": "event",
+      "dateField": "startDate",
+      "defaultView": "timeGridDay"
+    },
+    "x": 6,
+    "y": 2,
+    "w": 6,
+    "h": 6
+  },
+  { "key": "inbox", "config": { "limit": 6 }, "x": 0, "y": 8, "w": 12, "h": 4 }
+]
 ```
 
----
-
 ## Recipe: Governance dashboard
 
-_User asks: "Show me what my AI has been doing."_
+_User asks: "What are my agents doing?"_
 
 ```json
-{
-  "name": "AI Activity",
-  "type": "bento",
-  "config": {
-    "blocks": [
-      {
-        "id": "g1",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 0, "y": 0, "w": 3, "h": 2 },
-        "config": {
-          "label": "Pending proposals",
-          "metric": "count",
-          "filter": { "type": "proposal", "status": "pending" }
-        }
-      },
-      {
-        "id": "g2",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 3, "y": 0, "w": 3, "h": 2 },
-        "config": {
-          "label": "Auto-approved (24h)",
-          "metric": "count",
-          "filter": {
-            "type": "action",
-            "source": "agent",
-            "status": "approved",
-            "createdAt": "last-24h"
-          }
-        }
-      },
-      {
-        "id": "g3",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 6, "y": 0, "w": 3, "h": 2 },
-        "config": {
-          "label": "Agents connected",
-          "metric": "count",
-          "filter": { "type": "agent", "status": "active" }
-        }
-      },
-      {
-        "id": "g4",
-        "kind": "widget",
-        "widgetKind": "stat-card",
-        "layout": { "x": 9, "y": 0, "w": 3, "h": 2 },
-        "config": {
-          "label": "Entities created (7d)",
-          "metric": "count",
-          "filter": { "source": "agent", "createdAt": "this-week" }
-        }
-      },
-
-      {
-        "id": "g5",
-        "kind": "widget",
-        "widgetKind": "proposals-list",
-        "layout": { "x": 0, "y": 2, "w": 6, "h": 6 },
-        "config": { "status": "pending", "limit": 15 }
-      },
-
-      {
-        "id": "g6",
-        "kind": "widget",
-        "widgetKind": "agent-activity",
-        "layout": { "x": 6, "y": 2, "w": 6, "h": 6 },
-        "config": { "limit": 20 }
-      }
-    ]
+[
+  {
+    "key": "section-header",
+    "config": { "title": "Needs your review" },
+    "x": 0,
+    "y": 0,
+    "w": 12,
+    "h": 2
+  },
+  {
+    "key": "proposals-list",
+    "config": { "status": "pending", "limit": 10 },
+    "x": 0,
+    "y": 2,
+    "w": 6,
+    "h": 8
+  },
+  {
+    "key": "proposals-list",
+    "config": { "status": "approved", "layout": "timeline", "limit": 20 },
+    "x": 6,
+    "y": 2,
+    "w": 6,
+    "h": 8
   }
-}
+]
 ```
 
 ---
@@ -600,9 +370,9 @@ _User asks: "Show me what my AI has been doing."_
 ## Composition tips
 
 - **Row-by-row thinking.** Each row is one visual theme. Mixing themes in the same row confuses the eye.
-- **Start tall, shrink later.** It's easier to shrink an oversized block than to realize a tight block feels cramped.
+- **Start from `defaultSize`.** Each entry in `synap_list_widgets` carries one; it's easier to shrink an oversized block than to realize a tight block feels cramped.
 - **Use `section-header` between themes.** Readers parse visual separators faster than mental ones.
-- **Keep stat-cards together in a strip.** Four stats at 3×2 each = one clean row. Four stats scattered = noise.
+- **Keep stat-cards together in a strip.** Four stats at 3×3 each = one clean row. Four stats scattered = noise.
 - **End with the feed.** Activity feeds work best as the last row — they're where the eye lands for recency.
 - **One primary view per bento.** The user should know what the bento is "about" at a glance. If you have two headline views, split into two bentos.
-- **Show, don't hide.** Putting the most important info behind a widget that needs interaction is a trap. Top-left gets the most attention — put the answer there.
+- **Show, don't hide.** Top-left gets the most attention — put the answer there.