Merge branch 'main' into dependabot/npm_and_yarn/wrangler-4.125.0

Author: mohsinht

.github/workflows/release.yml

@@ -21,7 +21,19 @@ jobs:
           cache: npm
       - run: npm ci
       - run: npm run check
-      - name: Create GitHub release
+      - name: Create or verify GitHub release
         env:
           GH_TOKEN: ${{ github.token }}
-        run: gh release create "$GITHUB_REF_NAME" --verify-tag --generate-notes --title "$GITHUB_REF_NAME"
+        run: |
+          release_state=$(gh release view "$GITHUB_REF_NAME" --json isDraft --jq '.isDraft' 2>/dev/null || echo missing)
+          case "$release_state" in
+            true)
+              gh release edit "$GITHUB_REF_NAME" --draft=false
+              ;;
+            false)
+              echo "Release $GITHUB_REF_NAME already exists; validation completed successfully."
+              ;;
+            missing)
+              gh release create "$GITHUB_REF_NAME" --verify-tag --generate-notes --title "$GITHUB_REF_NAME"
+              ;;
+          esac

CHANGELOG.md

@@ -2,7 +2,9 @@
 
 All notable changes follow [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and semantic versioning.
 
-## [0.1.1] - Unreleased
+## [Unreleased]
+
+## [0.1.1] - 2026-08-25
 
 ### Added
 
@@ -30,3 +32,6 @@ All notable changes follow [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Dynamic freshness, real provenance disclosure, evidence references, and bounded snapshot history navigation.
 - Plain-language Prompt Studio starters with a separate human-readable permission receipt.
 - SHA-pinned GitHub Actions, a public synthetic Pages demo, fork-sync, lifecycle, compatibility, support, and release guidance.
+
+[Unreleased]: https://github.com/mohsinht/zaati-os/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/mohsinht/zaati-os/releases/tag/v0.1.1

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.
@@ -50,11 +50,17 @@ Requires Node.js 22 or newer.
 git clone https://github.com/YOUR_GITHUB_USERNAME/zaati-os.git
 cd zaati-os
 npm install
+npm run dev
+```
+
+The first demo visit opens an optional guided tour of sources, safe components, scheduled-task prompts, and the private setup path. Everything shown is public synthetic data. When you are ready to create your workspace:
+
+```bash
 npm run setup
 npm run tutorial
 ```
 
-The setup assistant creates ignored local preferences. The tutorial runs a credential-free mock LLM that deliberately fails its first contract attempt, retries safely, creates six synthetic snapshots in one transaction, and opens the dashboard.
+The setup assistant creates ignored local preferences and switches the local app to private mode. Synthetic example pages, Component Lab, copy-prompt guides, and the automatic demo tour are no longer included. The tutorial can still test ingestion with credential-free synthetic snapshots, clearly labeled as test data inside the private shell.
 
 ![Animated terminal showing Zaati OS setup and the synthetic tutorial](docs/assets/onboarding/setup.gif)
 
@@ -69,12 +75,15 @@ make tutorial
 
 ## Make it yours
 
-1. Fork the code repository and run `npm run setup`.
-2. Test the entire ingestion loop with `npm run tutorial`.
-3. Run `npm run prompt:create`, then paste the generated task prompt into the LLM you already use.
+1. Explore the synthetic demo and guided tour with `npm run dev`.
+2. Run `npm run setup` to create an ignored private workspace and remove demo-only UI.
+3. Test the entire ingestion loop with `npm run tutorial`.
+4. Run `npm run prompt:create`, then paste the generated task prompt into the LLM you already use.
 
 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 one standalone scheduled-task prompt. It includes the resolved worker and source, permission boundary, and current executable schemas; the user only replaces the code repository, private data repository, and timezone placeholders before review and use.
+
 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
@@ -155,7 +164,7 @@ See [LLM contract](docs/llm-contract.md) and [`schemas/`](schemas/) for the exec
 | `daily-overview.md`  | Combine registered source snapshots                  | Adaptive dashboard            |
 | `weekly-review.md`   | Find patterns and produce an evidence-based review   | Progress, timeline, decisions |
 
-These are provider-neutral templates, not connectors. ChatGPT scheduled tasks are the target first real path, but the release evidence is not complete yet. Other providers are contract-compatible and are not claimed as end-to-end certified until their documented release gate passes.
+These are provider-neutral templates, not connectors. The local mock tutorial and command adapter are maintained in v0.1.1. ChatGPT scheduled tasks are the target first hosted path, but no hosted provider is claimed as end-to-end certified until its documented provider gate passes.
 
 ## Repository map
 
@@ -236,7 +245,9 @@ Zaati OS charges no platform fee and can be deployed using free or already-owned
 
 Code version: **v0.1.1**
 
-No immutable GitHub Release is published yet. Until the recorded provider and hosted-demo release gates pass, pin private validators to a reviewed full commit SHA. This code version establishes the portable data contract, atomic bundle ingestion, adaptive renderer, guided onboarding, provider-neutral prompts, optional encrypted storage, theme studio, privacy boundaries, Cloudflare recipe, and CI quality gates. See [CHANGELOG.md](CHANGELOG.md).
+Latest GitHub release: **[v0.1.1](https://github.com/mohsinht/zaati-os/releases/tag/v0.1.1)**, published August 25, 2026.
+
+This foundation release establishes the portable data contract, atomic bundle ingestion, adaptive renderer, guided onboarding, provider-neutral prompts, optional encrypted storage, theme studio, privacy boundaries, Cloudflare recipe, and CI quality gates. Hosted LLM workflows remain contract-compatible rather than provider-certified until their recorded end-to-end gates pass. Private validators should pin the reviewed v0.1.1 release commit `0ef31dc8e973e5f1f557b1df9c7f79a012dd7d2a`; future signed, protected, and immutable releases may be used as stable references. See [CHANGELOG.md](CHANGELOG.md).
 
 Before storing real data, read [Data lifecycle and key recovery](docs/data-lifecycle.md). Fork maintainers can follow [Upgrade and fork sync](docs/upgrading.md).
 

config/instance.example.json

@@ -8,6 +8,10 @@
   "currency": "USD",
   "week_starts_on": "monday",
   "enabled_sources": ["overview:daily", "agenda:primary", "inbox:attention", "work:focus", "money:pulse", "news:briefing", "review:weekly"],
+  "experience": {
+    "mode": "demo",
+    "show_tour": true
+  },
   "theme": {
     "preset": "sage",
     "default_mode": "system",

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" }
+          ]
         }
       ]
     }