zcode-baseline.json

{
  "baseline_version": 2,
  "_comment": "ZCode runtime baseline for this build. The app and CLI versions are pinned in build/version.json, compared during setup installation, and enforced as strict bootstrap postconditions. CLI 0.15.2 requires an explicit provider/model reference and matching provider base URL before desktop session creation. Account-mode Z.ai authentication uses the verified OAuth preference; explicit API-key providers are separate custom provider entries. Update versions and the platform support verification window when the baseline changes.",
  "zcode": {
    "app_version": "3.5.3",
    "app_build": "3.5.3.3911",
    "linux_deb_package_version": "3.5.3-3911",
    "cli_version": "0.15.2",
    "app_bundle_id": "dev.zcode.app",
    "macos_team_id": "8A5X4JJ39T",
    "runtime_model": "GLM-5.2",
    "provider_domain_default": "zai",
    "provider_kind": "anthropic",
    "provider_account_auth_mode": "oauth",
    "cli_model_ref": "builtin:zai-coding-plan/GLM-5.2",
    "cli_model_provider_id": "builtin:zai-coding-plan",
    "cli_model_provider_base_url": "https://api.z.ai/api/anthropic",
    "provider_api_key_source": "custom",
    "provider_zai_api_key_id": "custom:zai-api-key",
    "provider_bigmodel_api_key_id": "custom:bigmodel-api-key",
    "provider_zai_api_key_base_url": "https://api.z.ai/api/anthropic",
    "provider_bigmodel_api_key_base_url": "https://open.bigmodel.cn/api/anthropic",
    "marketplace_format": "root marketplace.json (name + owner + plugins[])",
    "plugin_manifest_path": ".zcode-plugin/plugin.json",
    "config_file": "~/.zcode/cli/config.json",
    "instruction_file_user": "~/.zcode/AGENTS.md",
    "instruction_file_workspace": "<repo>/AGENTS.md",
    "hooks_key": "hooks",
    "hooks_enabled_flag_required": true,
    "mcp_config_key": "mcp.servers",
    "mcp_plugin_file": ".mcp.json",
    "mcp_plugin_key": "mcpServers",
    "task_index_file": "~/.zcode/v2/tasks-index.sqlite",
    "legacy_session_dir": "~/.zcode/v2/sessions/",
    "cli_session_database": "~/.zcode/cli/db/db.sqlite",
    "bot_state_file": "~/.zcode/v2/bot-state.v2.json",
    "embedded_cli_sha512": "3882119cca504bfdeff39b1946d73d5c7eab0db639ac07bb08043b619ae90b9e0a9786b469c576c5e63775219c5a8c3a6f100467d4c70b2b2ba9c246c2f923d4"
  },
  "evidence": {
    "official_install_documentation": "https://zcode.z.ai/en/docs/install",
    "official_configuration_documentation": "https://zcode.z.ai/en/docs/configuration",
    "official_distribution_base": "https://cdn-zcode.z.ai/zcode/electron/releases",
    "artifact_contract": "build/version.json:zcode_download_artifacts",
    "official_changelog": "https://zcode.z.ai/en/changelog"
  },
  "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-29T00:00:00Z",
    "expires_at_utc": "2027-01-25T00: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_against": "ZCode app 3.5.3 (build 3.5.3.3911), CLI 0.15.2 config parser and desktop model-selection adapter, all six native distribution artifacts, embedded CLI SHA-512 3882119cca504bfdeff39b1946d73d5c7eab0db639ac07bb08043b619ae90b9e0a9786b469c576c5e63775219c5a8c3a6f100467d4c70b2b2ba9c246c2f923d4, official macOS ZIP artifacts from latest.yml with DMG bytes rejected, macOS Gatekeeper source Notarized Developer ID on both architectures, and the task/session storage layout",
  "release_notes": {
    "version": "3.5.3",
    "released_on": "2026-07-27",
    "source": "https://zcode.z.ai/en/changelog",
    "claims": [
      "optimized cache hit rate"
    ]
  },
  "macos_gatekeeper_sources": {
    "macos-arm64": "Notarized Developer ID",
    "macos-x64": "Notarized Developer ID"
  }
}