chore(agent): adicionar verificacao diaria do bun com bun upgrade --stable
This commit is contained in:
parent
2e6db7dda6
commit
219cca8b06
12 changed files with 129 additions and 46 deletions
|
|
@ -1,13 +1,13 @@
|
|||
---
|
||||
type: rule
|
||||
name: atualizacao-submodulo-sessao
|
||||
description: Atualização obrigatória do submódulo .agent na branch master ao iniciar qualquer sessão de trabalho
|
||||
description: Atualização obrigatória do submódulo .agent na branch master ao iniciar qualquer sessão de trabalho e verificação diária do runtime Bun (bun upgrade --stable)
|
||||
scope: global
|
||||
trigger: always_on
|
||||
updatedAt: "2026-10-14"
|
||||
updatedAt: "2026-10-30"
|
||||
---
|
||||
|
||||
# Regra: Atualização Obrigatória do Submódulo `.agent` na Branch Master ao Iniciar Sessão
|
||||
# Regra: Atualização Obrigatória do Submódulo `.agent` ao Iniciar Sessão e Verificação Diária do Bun
|
||||
|
||||
## Contexto
|
||||
|
||||
|
|
@ -17,19 +17,22 @@ O ecossistema Azteca adota o framework `.agent` como um **git submodule** polim
|
|||
https://git2.idz.one/publico/.agent.git
|
||||
```
|
||||
|
||||
Trabalhar com uma versão defasada do submódulo `.agent` faz com que o agente tome decisões baseadas em regras antigas, falhe em auditorias de setup ou use padrões depreciados. Por isso, a sincronização do submódulo na branch `master` é mandatória ao iniciar qualquer sessão.
|
||||
Além disso, todo o ecossistema utiliza o **Bun** como runtime e gerenciador de pacotes padrão. Trabalhar com uma versão defasada do submódulo `.agent` ou do runtime `bun` faz com que o agente tome decisões baseadas em regras antigas, falhe em auditorias de setup ou enfrente incompatibilidades de runtime. Por isso, a sincronização do submódulo na branch `master` (a cada sessão) e a verificação de atualização do Bun na versão estável (uma vez por dia) são mandatórias.
|
||||
|
||||
---
|
||||
|
||||
## Regra Mandatória de Inicialização
|
||||
## Regra Mandatória de Inicialização e Manutenção Diária
|
||||
|
||||
Ao iniciar uma nova sessão de trabalho ou interação no projeto hospedeiro, a sincronização do submódulo `.agent` **DEVE OBRIGATORIAMENTE ser executada** na branch `master`:
|
||||
1. **Sincronização por Sessão do `.agent`:** Ao iniciar uma nova sessão de trabalho ou interação no projeto hospedeiro, a sincronização do submódulo `.agent` **DEVE OBRIGATORIAMENTE ser executada** na branch `master`:
|
||||
```bash
|
||||
git submodule update --init --recursive --remote
|
||||
```
|
||||
2. **Verificação Diária do Runtime Bun (1x por dia):** Uma vez por dia, o ambiente **DEVE verificar se o Bun está atualizado** na versão estável mais recente executando:
|
||||
```bash
|
||||
bun upgrade --stable
|
||||
```
|
||||
|
||||
```bash
|
||||
git submodule update --init --recursive --remote
|
||||
```
|
||||
|
||||
Esta operação é classificada como uma **ação autônoma** (conforme `rules/autonomia-agente.md`) e não requer autorização prévia do operador humano.
|
||||
Ambas as operações são classificadas como **ações autônomas** (conforme `rules/autonomia-agente.md`) e não requerem autorização prévia do operador humano.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -57,24 +60,25 @@ git submodule set-branch --branch master .agent
|
|||
O framework `.agent` disponibiliza um hook nativo do Antigravity em `.agent/hooks.json` vinculado ao evento `PreInvocation`:
|
||||
|
||||
1. No início da conversa, o hook aciona o script `.agent/scripts/atualizar-submodulo.sh`.
|
||||
2. O script detecta a raiz do projeto pai (superprojeto) e verifica a existência de uma trava temporária da sessão (`/tmp/.antigravity_agent_updated_${conversationId}`).
|
||||
3. **Idempotência:** A sincronização remota é executada apenas no primeiro turno da sessão. Turnos subsequentes retornam imediatamente (`{}`), garantindo zero latência adicional durante o diálogo.
|
||||
4. Ao concluir com sucesso, o script emite uma notificação efêmera informando a IA sobre a sincronização na branch `master`.
|
||||
2. **Idempotência Diária do Bun (`1x por dia`):** O script verifica o arquivo de controle `/tmp/.antigravity_bun_upgrade_date` (formato `YYYY-MM-DD`). Caso ainda não tenha sido verificado na data atual, executa `bun upgrade --stable` e grava a data do dia no arquivo de controle. Execuções subsequentes no mesmo dia ignoram o comando com zero latência.
|
||||
3. **Idempotência de Sessão do `.agent` (`1x por conversa`):** O script detecta a raiz do projeto pai (superprojeto) e verifica a existência da trava temporária da sessão (`/tmp/.antigravity_agent_updated_${conversationId}`). A sincronização remota do submódulo é executada apenas no primeiro turno da sessão, retornando imediatamente (`{}`) nos turnos seguintes.
|
||||
4. Ao concluir com sucesso, o script emite uma notificação efêmera informando a IA sobre a sincronização na branch `master` e, quando executada no dia, o resultado da atualização do Bun.
|
||||
|
||||
---
|
||||
|
||||
## 3. Resiliência e Fallback Offline
|
||||
|
||||
A atualização do submódulo nunca deve interromper ou impedir o atendimento ao operador:
|
||||
A atualização do submódulo e a verificação diária do Bun nunca devem interromper ou impedir o atendimento ao operador:
|
||||
|
||||
- Se o ambiente estiver sem acesso à internet, com DNS indisponível ou falha temporária de rede, o script captura o erro graciosamente.
|
||||
- O agente emite um aviso no log/contexto informando que a sincronização remota não pôde ser completada e prossegue normalmente a execução com a versão local já presente no submódulo.
|
||||
- O agente emite um aviso no log/contexto informando que a sincronização remota ou verificação do Bun não pôde ser completada e prossegue normalmente a execução com as versões locais já presentes.
|
||||
|
||||
---
|
||||
|
||||
## Proibições
|
||||
|
||||
- **NUNCA** travar o submódulo `.agent` em branches experimentais ou desatualizadas sem autorização explícita do operador.
|
||||
- **NUNCA** atualizar o Bun para versões canary/instáveis automaticamente (utilizar sempre `--stable`).
|
||||
- **NUNCA** abortar a sessão ou falhar com crash caso a rede esteja indisponível para atualização remota.
|
||||
- **NUNCA** executar `git submodule update --remote` descartando alterações locais em desenvolvimento sem verificação prévia.
|
||||
|
||||
|
|
|
|||
|
|
@ -29,6 +29,7 @@ O agente pode executar sem perguntar:
|
|||
- Aplicar padrões de nomenclatura já definidos em rules
|
||||
- Sugerir o texto de mensagem de commit (padrão Conventional Commits) ao operador humano após concluir implementações ou documentações
|
||||
- Atualizar o submódulo `.agent` ao iniciar uma sessão executando `git submodule update --init --recursive --remote` na branch `master`
|
||||
- Verificar e atualizar o runtime Bun uma vez por dia executando `bun upgrade --stable`
|
||||
- Executar `git add`, `git commit`, `git pull --rebase` e `git push` diretamente na branch `master` **exclusivamente no submódulo `.agent`** ao evoluir artefatos de IA
|
||||
|
||||
## Ações que Requerem Confirmação
|
||||
|
|
|
|||
|
|
@ -82,7 +82,7 @@ Sempre que qualquer agente, persona, workflow ou skill necessitar de:
|
|||
3. **Propósito ou Stack (`modulo-descricao` e `modulo-tipo`)**: para contextualizar novos agentes, gerar propostas comerciais, marketing, reels, análises de arquitetura ou testes;
|
||||
4. **Credenciais de Testes (`modulo-acesso`)**: O agente de testes (`@testes`, rotinas com `agent-browser`, QA) DEVE extrair as credenciais do contexto específico (`interno`, `externo`, `cliente`, etc.) ou credenciais diretas de `modulo-acesso` em `memorias-ia/modulo.yml` para autenticação determinística sem contaminação de cookies/tokens entre perfis;
|
||||
5. **Caminho da Wiki (`modulo-wiki`)**: Qualquer operação de documentação, leitura de regras ou escrita na Wiki deve resolver o caminho a partir de `modulo-wiki`, adotando compulsoriamente `../wiki/` caso a chave não esteja presente ou esteja vazia;
|
||||
6. **Sincronização do Submódulo (`.agent`)**: Ao iniciar qualquer sessão ou interação no projeto hospedeiro, o agente DEVE assegurar que o submódulo `.agent` esteja atualizado com a branch `master` remota executando `git submodule update --init --recursive --remote`.
|
||||
6. **Sincronização do Submódulo (`.agent`) e Verificação Diária do Bun**: Ao iniciar qualquer sessão ou interação no projeto hospedeiro, o agente DEVE assegurar que o submódulo `.agent` esteja atualizado com a branch `master` remota executando `git submodule update --init --recursive --remote` e que o runtime Bun seja verificado uma vez por dia com `bun upgrade --stable` (automatizado via `.agent/scripts/atualizar-submodulo.sh`).
|
||||
|
||||
👉 **O agente DEVE obrigatoriamente ler e extrair as informações de `memorias-ia/modulo.yml`.**
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue