amenbo 10.0.0 — um plugin alcança só o projeto para o qual ele dispara

Um plugin recebe uma janela, e o export, o backup e o restore agora param nela. Pedimos desculpas pelo comportamento que ficou de pé até a 9.2.0. Uma mudança de forma no que o amenbo agent --json devolve — leia a seção de atualização antes de subir de versão.

O export, o backup e o restore param na janela do plugin

O amenbo entrega ao plugin uma janela: o projeto para o qual ele dispara, e mais nada. Até a 9.2.0, três comandos não consultavam essa janela. Chamados de dentro de um plugin, o export, o backup e o restore agiam sobre todos os projetos da máquina — e o restore escreve em vez de ler, então podia substituir os próprios registros guardados.

Na 10.0.0 a chamada é recusada.

Error: export acts on this whole device, and a plugin reaches only through the window it fires in (AMB-P-…) — a window no argument widens. Nothing outside it was yours to read or to replace: the ids in the payload name what you were launched for.

O backup e o restore recusam do mesmo jeito.

Rodar esses comandos você mesmo não muda em nada, e nem uma IA a quem você confiou uma pasta. Só a chamada feita de dentro de um plugin é recusada.

Uma exportação são os registros de um só instante

Registros podem ser adicionados enquanto uma exportação está rodando. Até a 9.2.0, um comentário adicionado depois do início da exportação podia cair no arquivo sem que a tarefa da qual ele pende caísse junto, deixando um arquivo que apontava para algo que não estava nele. Na 10.0.0, o arquivo exportado inteiro são os registros de um só instante.

Os comandos de um plugin aparecem no passo em que são usados

O amenbo agent --json é o que uma IA lê para saber como trabalhar numa pasta. Instale e habilite um plugin, e as linhas de comando dele agora ficam no passo a que pertencem. Do plugin worktree:

{
  "id": "cut-per-task",
  "step": "Cut a worktree per task, whenever the work will produce commits. ...",
  "tools": [
    "amenbo plugin run worktree start <task-id>"
  ]
}

A IA não precisa mais descobrir como chamar o plugin naquele ponto — a chamada está no passo.

Se você já tem o plugin worktree, amenbo plugin update worktree faz a troca.

Um SHA de commit curto é recusado com o jeito de montar o completo

O amenbo task commit add aceita só SHAs de comprimento completo. A recusa agora leva junto como expandir um curto.

$ amenbo task commit add AMB-T-… 4a73991 --actor ai
Error: a commit sha must be full-length lower-case hex (40 for SHA-1, 64 for SHA-256) — not a short sha, branch, tag or revision
Hint: `git log --oneline` prints the short form. Expand it with `git rev-parse <short sha>` and pass what that returns — amenbo never runs git itself.

Antes de atualizar

Uma mudança de forma no que o amenbo agent --json devolve. As instruções que você entrega à sua IA não precisam de edição, porque elas vêm do próprio amenbo agent --json. Só os seus próprios scripts que leem essa saída são afetados.

O agentCycle deixou de ser uma lista de frases e virou um objeto. Agora ele guarda description, que diz como ler os passos, e steps. Cada passo leva um id.

O formato dos dados guardados não muda, então os dados da versão anterior abrem como estão.

Como obter

Abra o instalador do seu sistema na versão mais recente. Não precisa de direitos de administrador.

• macOS — .pkg, um para Apple silicon e um para Intel (a GUI e a CLI vêm juntas; a primeira abertura mostra um aviso do Gatekeeper: clique com o botão direito → Abrir)
• Windows — .exe de instalação (a GUI e a CLI vêm juntas)
• Linux — a GUI é um AppImage; o comando amenbo vem do instalador da CLI

Para atualizar: na GUI, o banner de “há uma versão mais nova” aplica a atualização ali mesmo. Se você instalou só a CLI, amenbo update --apply faz a troca.

Chegou agora? Veja Começar.