> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Branches e versões

> Como o código vira uma versão: branches, canais Estável e Beta, e como voltar uma versão.

## Branches

Todo script tem um repositório com uma branch principal. Cada gravação (`write_files` ou `POST /scripts/{script_id}/repo/commits`) vira um commit e precisa do `expected_head` atual da branch. Assim, duas IAs não apagam o trabalho uma da outra: se a branch andou, a gravação é recusada e é preciso ler de novo.

| Ação | Ferramenta MCP |
| - | - |
| Ver branches e o `head_sha` | `list_branches` |
| Criar a partir de um commit (padrão: head da principal) | `create_branch` |
| Ver o que mudaria e se há conflito | `compare_branches` |
| Mesclar (para se houver conflito) | `merge_branch` |

## Versões

Publicar junta a pasta `src/`, compacta, protege e gera uma versão. Cada canal tem uma única versão **live**, a que os usuários recebem.

| Canal | `channel` | Sai de |
| - | - | - |
| Estável | `stable` | Só da branch principal. Mescle antes de publicar. |
| Beta | `beta` | De uma branch diferente da principal. |

> [!WARNING]
>
> Publicar sem proteção exige confirmação (`confirm_unprotected`). O código fica legível para quem instala.

Para voltar, use `rollback_release` com a versão anterior: o canal passa a entregar aquela versão. Nada é apagado.

Ferramentas: [Versões](https://docs.doglytdc.dev/pt-BR/scripts/mcp/tools/versions.md) · [Branches](https://docs.doglytdc.dev/pt-BR/scripts/mcp/tools/branches.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.