Ravena Code

Status: EARLY ALPHA

Ravena Code ainda está em fase inicial de implementação e desenvolvimento ativo. A arquitetura, a interface, o Mutano Harness e os fluxos de execução podem mudar com frequência. Use como experimento local, não como ferramenta estável de produção.

Ainda não é um produto estável. O projeto não está pronto para uso diário, não está em fase de produto e ainda está no começo do desenvolvimento. Há partes incompletas, fluxos em validação e decisões técnicas que ainda podem ser reescritas.

Ravena Code é uma interface local para conversar, executar e evoluir projetos com agentes de IA.

O projeto separa duas camadas:

• Ravena Code: a experiência de usuário, com chat, timeline, editor, aprovações, contexto de projeto e configurações.
• Mutano Harness: o runtime local, com fila de execução, tools, política de segurança, auditoria, SQLite e integração com provedores de IA.

Mutano Harness

Status: EARLY ALPHA

O Mutano Harness também está em implementação ativa. Ele já possui uma base funcional, mas ainda não deve ser tratado como API pública estável. Ele não deve ser usado como runtime confiável em produção neste momento.

O Mutano Harness é o núcleo local que coordena:

• sessões e histórico de conversa;
• fila de execução por workspace;
• chamadas de ferramentas;
• política de comandos e arquivos;
• aprovações antes de ações sensíveis;
• auditoria e persistência em SQLite;
• integração com provedores de IA.

Objetivo

Criar um ambiente local, legível e controlado para trabalho agêntico em código.

O foco é:

• conversar com contexto real do projeto;
• executar tarefas em etapas claras;
• pedir aprovação antes de ações sensíveis;
• suportar múltiplos provedores de IA;
• persistir sessões, eventos e auditoria;
• reduzir atrito para iterar em projetos locais.

Estrutura

• src/: frontend React, TypeScript e Vite.
• src-tauri/: shell desktop Tauri e integrações nativas.
• agent-engine/: backend Python do Mutano Harness.
• harness-contract-v1.md: contrato funcional do Mutano Harness local.
• capabilities-minimas-v1.md: capacidades mínimas exigidas no /health.
• risks-and-mitigations-v1.md: riscos técnicos e mitigações atuais.

Roadmap EARLY ALPHA

Em progresso

• Consolidar o contrato entre frontend, Tauri e Mutano Harness.
• Endurecer a política de leitura, escrita e execução de comandos.
• Melhorar a fila de execução e retomada de runs.
• Ampliar os eventos padronizados da timeline.
• Refinar o fluxo de aprovações e aplicação de patches.
• Melhorar indexação, mapas do projeto e contexto enviado aos modelos.
• Separar melhor as responsabilidades do agent-engine.
• Validar integração com provedores de IA em cenários reais.

Próximos passos

• Criar testes automatizados para os fluxos principais do harness.
• Tornar o contrato de eventos mais explícito e versionado.
• Melhorar recuperação depois de falhas, cancelamentos e reinícios.
• Adicionar telas de diagnóstico para capabilities, fila e auditoria.
• Melhorar a experiência de setup local do backend.
• Revisar segurança de comandos, secrets, paths e sandbox.
• Preparar empacotamento desktop mais previsível com Tauri.

Antes de sair do EARLY ALPHA

• API do Mutano Harness estabilizada.
• Fluxos principais cobertos por testes.
• Documentação de instalação e uso inicial completa.
• Migração segura de dados locais entre versões.
• Política de segurança revisada.
• Build desktop validado em ambiente limpo.

Desenvolvimento

Instale as dependências do frontend:

npm install

Instale as dependências do backend:

python -m pip install -r agent-engine/requirements.txt

Execute o frontend web:

npm run web:dev

Execute o Mutano Harness local:

python agent-engine/main.py

Validação

Comandos usados como base de validação:

python -m py_compile agent-engine/*.py
npm run lint
npm run build

O backend deve responder em:

GET http://127.0.0.1:8000/health

Com engine igual a:

Mutano Harness Local Agent