From d2aa5f5c9697d2008cc75bc6c12b72c58ced7c52 Mon Sep 17 00:00:00 2001
From: Danil Silantyev <danilsilantyevwork@gmail.com>
Date: Sun, 12 Jul 2026 00:30:33 +0700
Subject: [PATCH] feat(baseline): model per-platform vendor and NDDev support
 tiers

Record machine-readable support tiers with a freshness window in
references/zcode-baseline.json:platform_support. macOS is a vendor
general-availability download; upstream ZCode Linux ships only through the
vendor Linux beta group, so Ubuntu is documented as NDDev-supported on top of a
vendor beta channel. Document the distinction in docs/install.md and record it
under CHANGELOG [Unreleased]. No installed runtime behavior changes.
---
 CHANGELOG.md                   |  8 ++++++++
 docs/install.md                |  7 ++++++-
 references/zcode-baseline.json | 19 +++++++++++++++++++
 3 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 97eadf6..16a1227 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,14 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+### Added
+
+- Machine-readable per-platform support tiers in
+  `references/zcode-baseline.json:platform_support`: macOS is a vendor
+  general-availability download and Ubuntu is NDDev-supported on top of the
+  vendor Linux beta channel, each with an explicit verified/expiry freshness
+  window.
+
 ## [2.1.2] - 2026-07-10
 
 ### Fixed
diff --git a/docs/install.md b/docs/install.md
index b6fdc95..5102d4d 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -9,7 +9,12 @@
 2. **`install`** — builds a clean `~/.zcode` from a setup (config, plugins,
    skills). Backs up the current one first.
 
-Both work on macOS (desktop) and Ubuntu (desktop/server).
+Both work on macOS (desktop) and Ubuntu (desktop/server). Upstream ZCode
+distributes macOS as a general-availability download and Linux only through the
+vendor Linux beta group, so NDDev supports the Ubuntu build on top of a vendor
+beta channel. The machine-readable per-platform support tiers and their
+freshness window are recorded in
+`references/zcode-baseline.json:platform_support`.
 
 ## Prerequisites
 
diff --git a/references/zcode-baseline.json b/references/zcode-baseline.json
index c84cba2..1b9689e 100644
--- a/references/zcode-baseline.json
+++ b/references/zcode-baseline.json
@@ -41,6 +41,25 @@
     "official_distribution_base": "https://cdn-zcode.z.ai/zcode/electron/releases",
     "artifact_contract": "build/version.json:zcode_download_artifacts"
   },
+  "platform_support": {
+    "_comment": "Explicit vendor and NDDev support tiers per installer platform with a freshness window. macOS is a vendor general-availability download; upstream ZCode Linux ships only through the vendor Linux beta group, so Ubuntu is NDDev-supported on top of a vendor beta. Re-verify the vendor tiers and refresh verified_at_utc/expires_at_utc before expiry.",
+    "verified_at_utc": "2026-07-10T00:00:00Z",
+    "expires_at_utc": "2027-01-06T00:00:00Z",
+    "platforms": {
+      "macos": {
+        "vendor_support_tier": "stable",
+        "vendor_distribution_channel": "general-download",
+        "nddev_support_tier": "supported",
+        "artifact_prefix": "macos"
+      },
+      "ubuntu": {
+        "vendor_support_tier": "beta",
+        "vendor_distribution_channel": "linux-beta-group",
+        "nddev_support_tier": "supported",
+        "artifact_prefix": "linux"
+      }
+    }
+  },
   "verified_date": "2026-07-10",
   "verified_against": "ZCode app 3.3.4 (build 3.3.4.2877), CLI 0.15.2 config parser and desktop model-selection adapter, all six native distribution artifacts, and the task/session storage layout"
 }