feat: add complex dashboard demos and component lab

Author: mohsinht

README.md

@@ -36,7 +36,7 @@ You choose the LLM. You own the data. You control the deployment. Zaati OS has n
 ## What makes it different
 
 - **Any LLM workflow:** ChatGPT, Claude, Gemini, a local model, n8n, cron, or custom code can publish the same contract.
-- **LLM-directed presentation:** A safe UI contract lets the producer request metrics, lists, timelines, calendars, line or bar charts, progress views, notices, text, and tables. The renderer only permits audited components, never arbitrary HTML or code.
+- **LLM-directed presentation:** A safe UI contract lets the producer request metrics, lists, timelines, calendars, line, bar, or allocation charts, progress views, notices, text, and tables. The renderer only permits audited components, never arbitrary HTML or code.
 - **Private by architecture:** Real snapshots are ignored in the public code repository. The recommended public-fork setup keeps data in a separate private repository and protects the deployment with Cloudflare Access.
 - **Files before databases:** JSON is portable, diffable, inspectable, and easy for AI tools to create.
 - **Useful failure states:** Freshness, provenance, confidence, missing sources, and warnings remain visible.
@@ -75,6 +75,8 @@ make tutorial
 
 Everything else, including custom sources, encrypted storage, full theme tokens, and automatic deployment, is optional and documented separately.
 
+Synthetic demo mode includes a **Component lab** with the JSON contract beside each rendered block. Every demo source also includes a **Recreate this page** drawer containing the current base worker and source-specific Markdown prompt, ready for placeholder review and use in a scheduled LLM workflow.
+
 The canonical daily bundle contains agenda, inbox attention, work focus, money, news, and the dependency-backed daily overview. Prompt Studio can also create smaller independent bundles, and now generates the matching private-repository setup command.
 
 ## Create a scheduled task prompt

config/sources.json

@@ -14,7 +14,7 @@
       "cadence": "daily",
       "freshness_sla_hours": 30,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["calendar", "list", "notice"] },
+      "presentation": { "preferred_blocks": ["metric-group", "calendar", "list", "timeline", "notice"] },
       "depends_on": [],
       "target_path": "data/snapshots/agenda/primary/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {
@@ -36,7 +36,7 @@
       "cadence": "daily",
       "freshness_sla_hours": 30,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["metric-group", "list", "notice"] },
+      "presentation": { "preferred_blocks": ["metric-group", "list", "timeline", "table", "notice"] },
       "depends_on": [],
       "target_path": "data/snapshots/inbox/attention/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {
@@ -58,7 +58,7 @@
       "cadence": "weekdays",
       "freshness_sla_hours": 36,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["metric-group", "table", "list", "progress", "notice"] },
+      "presentation": { "preferred_blocks": ["metric-group", "table", "list", "progress", "timeline", "notice"] },
       "depends_on": [],
       "target_path": "data/snapshots/work/focus/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {
@@ -80,7 +80,7 @@
       "cadence": "daily",
       "freshness_sla_hours": 36,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["metric-group", "line-chart", "bar-chart", "table", "progress", "notice"] },
+      "presentation": { "preferred_blocks": ["metric-group", "line-chart", "bar-chart", "donut-chart", "table", "progress", "notice"] },
       "depends_on": [],
       "target_path": "data/snapshots/money/pulse/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {
@@ -102,7 +102,7 @@
       "cadence": "daily",
       "freshness_sla_hours": 24,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["list", "timeline", "text", "notice"] },
+      "presentation": { "preferred_blocks": ["list", "timeline", "bar-chart", "table", "text", "notice"] },
       "depends_on": [],
       "target_path": "data/snapshots/news/briefing/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {
@@ -124,7 +124,7 @@
       "cadence": "daily",
       "freshness_sla_hours": 30,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["metric-group", "line-chart", "calendar", "list", "progress", "notice"] },
+      "presentation": { "preferred_blocks": ["metric-group", "line-chart", "calendar", "list", "progress", "timeline", "table", "notice"] },
       "depends_on": ["agenda:primary", "inbox:attention", "work:focus", "money:pulse", "news:briefing"],
       "target_path": "data/snapshots/overview/daily/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {
@@ -146,7 +146,7 @@
       "cadence": "weekly",
       "freshness_sla_hours": 192,
       "dashboard_role": "primary",
-      "presentation": { "preferred_blocks": ["metric-group", "line-chart", "list", "progress", "timeline", "notice"] },
+      "presentation": { "preferred_blocks": ["metric-group", "line-chart", "list", "progress", "timeline", "table", "notice"] },
       "depends_on": ["overview:daily", "agenda:primary", "inbox:attention", "work:focus", "money:pulse", "news:briefing"],
       "target_path": "data/snapshots/review/weekly/{YYYY}/{MM}/{YYYY-MM-DD}.json",
       "privacy": {

data/examples/agenda/primary/2026-08-24.json

@@ -39,11 +39,19 @@
           "start": "2026-08-24T13:00:00Z",
           "end": "2026-08-24T14:30:00Z",
           "status": "scheduled"
+        },
+        {
+          "id": "a4",
+          "title": "Walk and reset",
+          "start": "2026-08-24T15:00:00Z",
+          "end": "2026-08-24T15:30:00Z",
+          "status": "scheduled"
         }
       ],
       "actions": [
         { "id": "p1", "title": "Open the acceptance criteria", "due_at": "2026-08-24T08:30:00Z", "status": "open" },
-        { "id": "p2", "title": "Write the sync decision", "due_at": "2026-08-24T11:00:00Z", "status": "open" }
+        { "id": "p2", "title": "Write the sync decision", "due_at": "2026-08-24T11:00:00Z", "status": "open" },
+        { "id": "p3", "title": "Prepare the release note", "due_at": "2026-08-24T13:00:00Z", "status": "open" }
       ]
     },
     "presentation": {
@@ -64,7 +72,8 @@
               "tone": "positive"
             },
             { "id": "a2", "title": "Project sync", "start": "2026-08-24T11:00:00Z", "end": "2026-08-24T11:30:00Z", "tone": "info" },
-            { "id": "a3", "title": "Review and ship", "start": "2026-08-24T13:00:00Z", "end": "2026-08-24T14:30:00Z", "tone": "positive" }
+            { "id": "a3", "title": "Review and ship", "start": "2026-08-24T13:00:00Z", "end": "2026-08-24T14:30:00Z", "tone": "positive" },
+            { "id": "a4", "title": "Walk and reset", "start": "2026-08-24T15:00:00Z", "end": "2026-08-24T15:30:00Z", "tone": "neutral" }
           ]
         },
         {
@@ -74,8 +83,55 @@
           "span": "one",
           "items": [
             { "id": "p1", "title": "Open the acceptance criteria", "meta": "Before 08:30", "tone": "neutral" },
-            { "id": "p2", "title": "Write the sync decision in one sentence", "meta": "Before 11:00", "tone": "info" }
+            { "id": "p2", "title": "Write the sync decision in one sentence", "meta": "Before 11:00", "tone": "info" },
+            { "id": "p3", "title": "Prepare the release note", "meta": "Before 13:00", "tone": "neutral" }
+          ]
+        },
+        {
+          "id": "day-capacity",
+          "kind": "metric-group",
+          "title": "Day capacity",
+          "span": "full",
+          "metrics": [
+            { "label": "Protected focus", "value": 3.5, "unit": "hours", "tone": "positive" },
+            { "label": "Meetings", "value": 0.5, "unit": "hours", "tone": "neutral" },
+            { "label": "Open buffer", "value": 2, "unit": "hours", "tone": "info" },
+            { "label": "Prep actions", "value": 3, "tone": "warning" }
           ]
+        },
+        {
+          "id": "day-sequence",
+          "kind": "timeline",
+          "title": "Energy-aware sequence",
+          "span": "one",
+          "items": [
+            {
+              "label": "08:30",
+              "title": "Build before coordinating",
+              "description": "Use the highest-energy window for the complete slice.",
+              "tone": "positive"
+            },
+            {
+              "label": "11:00",
+              "title": "Make one decision visible",
+              "description": "End the sync with an owner and next checkpoint.",
+              "tone": "info"
+            },
+            {
+              "label": "15:00",
+              "title": "Stop before the final push",
+              "description": "The reset protects the remaining buffer.",
+              "tone": "neutral"
+            }
+          ]
+        },
+        {
+          "id": "buffer",
+          "kind": "notice",
+          "title": "Keep 15:30 onward unclaimed",
+          "body": "That window absorbs a late review, travel, or an unfinished release note without displacing recovery time.",
+          "tone": "info",
+          "span": "one"
         }
       ]
     }

data/examples/inbox/attention/2026-08-24.json

@@ -14,8 +14,8 @@
   "quality": { "confidence": "high", "warnings": [] },
   "privacy": { "classification": "public", "contains_personal_data": false, "synthetic": true },
   "data": {
-    "title": "Two messages deserve attention",
-    "summary": "One scheduling decision and one document review need a response. Everything else can wait.",
+    "title": "Four messages fit into two reply windows",
+    "summary": "One deadline and one scheduling decision come first. A review and follow-up can share the afternoon window; 18 low-value messages remain excluded.",
     "attention": "medium",
     "facts": {
       "items": [
@@ -33,6 +33,21 @@
           "subject_summary": "Approve the revised outline",
           "reason": "reply",
           "status": "open"
+        },
+        {
+          "id": "m3",
+          "sender_label": "Operations contact",
+          "subject_summary": "Confirm the renewal choice",
+          "reason": "deadline",
+          "deadline": "2026-08-24T15:00:00Z",
+          "status": "open"
+        },
+        {
+          "id": "m4",
+          "sender_label": "Research collaborator",
+          "subject_summary": "Close the open question",
+          "reason": "follow-up",
+          "status": "waiting"
         }
       ]
     },
@@ -45,7 +60,8 @@
           "title": "Attention filter",
           "span": "full",
           "metrics": [
-            { "label": "Needs reply", "value": 2, "tone": "warning" },
+            { "label": "Needs reply", "value": 4, "tone": "warning" },
+            { "label": "Due today", "value": 2, "tone": "danger" },
             { "label": "Waiting on others", "value": 1, "tone": "neutral" },
             { "label": "Ignored noise", "value": 18, "tone": "positive" }
           ]
@@ -71,6 +87,22 @@
               "meta": "15 minutes",
               "status": "Review",
               "tone": "info"
+            },
+            {
+              "id": "m3",
+              "title": "Confirm the renewal choice",
+              "description": "A yes-or-no choice is due before the afternoon processing window.",
+              "meta": "Due 15:00",
+              "status": "Deadline",
+              "tone": "danger"
+            },
+            {
+              "id": "m4",
+              "title": "Close the open research question",
+              "description": "Send the missing constraint; no full thread review is required.",
+              "meta": "No explicit deadline",
+              "status": "Follow-up",
+              "tone": "neutral"
             }
           ]
         },
@@ -81,6 +113,44 @@
           "body": "Newsletters, receipts, automated updates, and promotional messages were excluded from the attention queue.",
           "tone": "positive",
           "span": "one"
+        },
+        {
+          "id": "reply-plan",
+          "kind": "timeline",
+          "title": "Reply plan",
+          "span": "one",
+          "items": [
+            {
+              "label": "09:50",
+              "title": "Resolve the scheduling choice",
+              "description": "Reply before the first focus block closes.",
+              "tone": "warning"
+            },
+            {
+              "label": "12:15",
+              "title": "Confirm the renewal",
+              "description": "A one-line answer clears the only hard deadline.",
+              "tone": "danger"
+            },
+            { "label": "16:00", "title": "Batch review and follow-up", "description": "Cap the window at 25 minutes.", "tone": "info" }
+          ]
+        },
+        {
+          "id": "attention-register",
+          "kind": "table",
+          "title": "Attention register",
+          "span": "one",
+          "columns": [
+            { "key": "item", "label": "Item" },
+            { "key": "reason", "label": "Reason" },
+            { "key": "window", "label": "Window" }
+          ],
+          "rows": [
+            { "item": "Planning window", "reason": "Decision", "window": "09:50" },
+            { "item": "Renewal choice", "reason": "Deadline", "window": "12:15" },
+            { "item": "Revised outline", "reason": "Review", "window": "16:00" },
+            { "item": "Research question", "reason": "Follow-up", "window": "16:00" }
+          ]
         }
       ]
     }