Projetos
A página Projetos mostra tudo o que seus agentes constroem de durável nos seus servidores: cada projeto é uma pasta real na máquina, espelhada aqui com o que o servidor reportou — se tem descrição (PROJECT.md), se está publicado no GitHub, quando foi mexido pela última vez.
De onde vem um projeto
Um projeto nasce de uma missão do tipo "Novo projeto" — nunca de uma conversa solta. Isso garante que criar um projeto é sempre um ato deliberado, com entrega definida, e que pedidos de alteração continuam dentro do mesmo projeto em vez de espalhar cópias.
Todo projeto web carrega a própria suíte de testes de ponta a ponta (Playwright, em tests/e2e/) e só conta como pronto quando o bia-e2e passa na pasta do projeto — a suíte e a sondagem no navegador do servidor em desktop e celular. Isso vale tanto para missões (o motor reprova a rodada sem ele) quanto para trabalho pedido no chat ou no quadro: a regra está nas instruções padrão de todo agente. As capturas de tela e o relatório ficam em .bia/e2e/ dentro do projeto.
Um app que roda numa porta declara também o comando que o sobe ("start" no .bia-web.json) e passa a rodar como serviço do servidor (bia-project up): ele volta sozinho depois de uma pausa de emergência, de uma retomada ou de um reboot, e a Bia o revive a cada sincronização se a porta parar de responder — nunca fica dependendo da sessão do agente que o iniciou.
Publicando no GitHub
Com um token salvo em Credenciais → GitHub, você pode publicar qualquer projeto com um clique — a Bia cria um repositório privado na sua conta, envia os arquivos e deixa o endereço fixo no cartão do projeto ("Abrir no GitHub"). Ligando "Publicar projetos automaticamente", todo projeto novo ganha repositório sem clique nenhum, e seus servidores fazem commits de checkpoint quando uma sessão de trabalho fica quieta com alterações pendentes.
O painel mostra o repositório realmente configurado no servidor: se um agente apontar o projeto para outro repositório durante o trabalho, o link acompanha.
Baixando e arquivando
- Baixar (.tar.gz) — o servidor empacota a pasta inteira e o painel te entrega o arquivo (links expiram em alguns minutos).
- Arquivar projeto — envia tudo para o GitHub e libera o disco do servidor. O modal diz exatamente o que vai subir e quanto espaço libera, e o arquivamento recusa qualquer situação em que algo se perderia (arquivos fora do controle do git, repositórios aninhados) até você consentir explicitamente. Retomar clona de volta na mesma pasta.
O que a página não inventa
Um projeto sem PROJECT.md ganha o selo honesto "Sem PROJECT.md"; um push que falhou aparece como falha; um tamanho que o servidor ainda não mediu aparece como não reportado — nunca como um número inventado.
Próximos passos
- Acesso Web a projetos — colocar um projeto no ar no seu próprio domínio, com HTTPS.
- Missões — como projetos nascem e evoluem.