# Versões e canais

Como as versões dos pacotes @fayz-ai/* são coordenadas por canais e como ler o suporte de cada superfície.

{% callout type="warn" %}
Em construção — estrutura para validação.
{% /callout %}

## Canais

| Canal | Para quê |
| --- | --- |
| `stable` | O conjunto testado e recomendado para produção. |
| `latest` | A última versão publicada de cada pacote. |
| `preview` | Versões de pré-lançamento, para experimentar o que vem. |

Os canais são conjuntos de versões fixados (pin sets) pelo release-channels: o resolver mantém todos os pacotes `@fayz-ai/*` em um conjunto coerente. Para trocar de canal depois, você atualiza os pins do app para o conjunto desejado (`stable`, `latest` ou `preview`).

**Como o canal entra no scaffold depende da versão da CLI:**

- **CLI 0.2.0** (publicada) — o `fayz create` aceita a flag `--channel stable|latest|preview`; sem a flag, o default é `stable`. Você escolhe o conjunto de versões no momento de criar o app.
- **CLI ≥ 0.3.0** — o `create` é flagless: o canal é decidido pelo próprio scaffold (o conjunto embutido na release da CLI), não por uma flag. Para trocar depois, você edita os pins do app.

## Tiers de suporte

Cada superfície do SDK declara um nível de suporte (SUPPORT). Use-o para saber com o que contar: superfícies estáveis têm garantia de compatibilidade; superfícies em preview ou experimental podem mudar.