orbi

Orbi é um sistema automatizado que transforma GitHub Issues em versões etiquetadas. Ele reivindica uma Issue, desenvolve-a em um worktree isolado, executa uma sessão de revisão independente, faz merge apenas do head revisado e publica uma tag por meio de uma Issue de release. As GitHub Issues servem como único armazenamento de estado — sem banco de dados, fila ou daemon. Principais recursos: - **Pool de tarefas via GitHub Issues**: o rótulo `ai-ready` despacha o trabalho; os registros de entrega (comentários, PRs, CI) são completos por padrão. - **Totalmente automatizado**: um timer do agendador do usuário (systemd no Linux, launchd no macOS) dispara um tick a cada 5 minutos; nenhum comando manual de status é necessário. - **Revisão independente + portões de merge**: após a abertura de um PR, uma sessão de revisão independente corrige os achados; apenas o head revisado pode sofrer merge, e a IA nunca faz merge nem push em branches protegidas. - **Falha rápida**: erros de comando falham imediatamente, registram evidências e marcam a Issue como `ai-blocked` para decisão humana. - **Observável de ponta a ponta**: cada log e comentário no GitHub carrega o mesmo `run_id` para reconstrução completa da linha do tempo. Fluxo de trabalho: GitHub Issue (ai-ready) → Claim (branch + worktree) → Desenvolvimento Pi (planejar, implementar, testar, verificar) → Commit de entrega → Fechamento pelo Runner (sincronizar, push, criar PR) → Revisão independente → Portão de merge → Merge. Os comandos da CLI incluem `orbi add` (despachar trabalho), `status` (ver fila), `session` (acompanhar sessão Pi), `install-units` (instalar unidades do agendador) e `doctor` (diagnóstico somente leitura). A instalação requer Python ≥ 3.14, `uv`, `pi` (com um provedor), GitHub CLI ≥ 2.94 e uma sessão de usuário systemd no Linux ou sessão GUI launchd no macOS. Início rápido: clonar, instalar com `uv tool install --force --reinstall --editable --python python3 .`, copiar a configuração de exemplo, executar `orbi setup`, depois `python3 -m orbi.runner` para um tick manual e `orbi doctor` para verificar a saúde. A documentação cobre primeiros passos, configuração, fluxo de trabalho, operações, testes e contribuição. O projeto é licenciado como fair-code sob a Sustainable Use License (v1.0): gratuito para uso pessoal e interno em empresas, compartilhável para fins não comerciais, mas autorização comercial é necessária apenas se você vender o próprio Orbi (por exemplo, hospedando-o como serviço).