gwz-cli

gwz serve como a principal interface de linha de comando para GWZ (Git Workspace Zone), um sistema projetado para coordenar múltiplos repositórios Git padrão em um único workspace reproduzível. Diferentemente de ferramentas de monorepo que mesclam código, o gwz mantém cada repositório membro como um repositório Git normal, enquanto registra a composição da raiz e o estado exato. Isso permite que os usuários gerenciem estruturas de projeto complexas com controle de versão preciso em componentes distribuídos. A ferramenta está disponível para instalação em macOS, Linux e Windows por meio de scripts de instalador fornecidos. Ela funciona analisando argumentos de linha de comando e enviando requisições tipadas para a biblioteca subjacente `gwz-core`, que lida com a coordenação orientada a mensagens. A CLI suporta vários formatos de saída, incluindo texto legível por humanos, porcelain, JSON e JSONL, tornando-a adequada tanto para uso interativo no terminal quanto para integração programática. Os principais recursos incluem: - **Coordenação de Workspace**: Gerencia relacionamentos entre múltiplos repositórios Git como uma zona unificada. - **Reprodutibilidade**: Garante que todo o estado do workspace possa ser reproduzido exatamente a partir da configuração raiz. - **Compatibilidade com Git Padrão**: Os repositórios membros permanecem totalmente funcionais e independentes como repositórios Git. - **Suporte Multiplataforma**: Instaladores oficiais para os principais sistemas operacionais. Para desenvolvimento, o projeto usa Rust (Cargo) e Python para geração de documentação. Ele é licenciado sob GPL-2.0-only, alinhando-se à família de licenças do Git. Os usuários são incentivados a consultar a documentação completa do usuário para fluxos de trabalho detalhados, gerenciamento de ciclo de vida e guias de solução de problemas.