Atmos JSON Schema System

Overview

Atmos uses JSON Schema (Draft 2020-12) to validate stack manifests, provide IDE auto-completion, and catch configuration errors early. The schema system has three layers:

1. Website manifest schema -- Published at website/static/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json, served at https://atmos.tools/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json, and registered with SchemaStore as https://json.schemastore.org/atmos-manifest.json. This is the public-facing schema for IDE integration.

2. Embedded schemas -- Located under pkg/datafetcher/schema/, compiled into the Atmos binary via Go embed. These are the schemas Atmos uses at runtime for validation. There are multiple embedded schemas:

   • pkg/datafetcher/schema/atmos/manifest/1.0.json -- Minimal manifest schema (fallback).
   • pkg/datafetcher/schema/stacks/stack-config/1.0.json -- Stack configuration validation schema. This is the primary schema used by atmos validate stacks.
   • pkg/datafetcher/schema/config/global/1.0.json -- Global Atmos configuration schema.
   • pkg/datafetcher/schema/vendor/package/1.0.json -- Vendor package manifest schema.