Contribua com o ai-memory

• releasev3.4.0
• licençaMIT
• estrelas15k
• forks1.1k
• issues abertas17

Principais contribuidores

• akitaonrails
• viniciusdsandrade
• rudycelekli
• djalmajr
• samirhvbr
• everton-dgn
• matheus-rodrigues00
• petersonsalme
• felipe-NR
• lucasliet
• M4ster3001
• root1945
• kevin9327
• wblech
• lhzapata
• rthiago
• maxeinstein-dev
• 4nrry
• giovannirco
• gabrielscharb
• luisfnicolau
• yubr-zzh
• gb
• Gaalbu
• rubenlr
• JohnC0de
• talyssonoc
• rafaelkenedy
• alvadorn
• evanmaranzano
• mihazs
• renatodru
• pablowinck
• zydo
• abhisheksharma2411
• aguirreSL
• viniciusmiguel
• yurioliveira3
• caminhar-deus
• rntjr
• mrpaiva
• rodrigopalhares
• geeksilva97
• lihuiyang1024
• bet4it
• GrYllO
• costajohnt
• marcondesmacaneiro
• pvpmartins
• Murillofilho86
• atirna
• Marcelo7889
• yoggsaron010-lang
• avelino
• carl0sfelipe
• Cardosaum
• mobnix
• vitorvilas

Veja todos os 190 contribuidores no GitHub

1. 1

   Clone e compile

   O Rust 1.95 é obrigatório e está fixado no rust-toolchain.toml, com rustfmt e clippy, então o rustup instala a toolchain certa no primeiro build. O SQLite vem embutido e a libgit2 é vendorizada. Você precisa de uma toolchain C padrão e mais nada.

   git clone https://github.com/akitaonrails/ai-memory
   cd ai-memory
   cargo build --workspace
   cargo test --workspace --all-targets
   

2. 2

   Use o loop do dia a dia

   cargo t precisa do nextest: cargo install cargo-nextest --locked. Ele pula os módulos chamados slow ou stress, que o hook de pre-push e o CI rodam mesmo assim.

   cargo t                        # tudo menos o tier lento, ~20s com cache quente
   cargo t -p ai-memory-store     # um crate: compila só os binários de teste dele
   cargo t -E 'test(/purge/)'     # um assunto (compila tudo, roda um subconjunto)
   

3. 3

   Instale o hook de pre-push

   Uma vez por clone. Ele só mexe no próprio bloco dentro de .git/hooks/pre-push. Em um branch de trabalho em andamento, git push --no-verify pula o hook.

   scripts/install-git-hooks.sh
   

4. 4

   Passe nos gates antes do push

   O CI exige os cinco. Sem o nextest, cargo test --workspace --all-targets equivale a cargo tf. Se o último estiver faltando: cargo install cargo-deny cargo-audit.

   cargo fmt --all -- --check
   git diff --check
   cargo clippy --workspace --all-targets -- -D warnings
   cargo tf                            # todos os testes (alias: cargo nextest run -P full)
   cargo deny check                    # política de dependências
   

5. 5

   Confira quem seus commits dizem que você é

   Use um email verificado na sua conta do GitHub ou o endereço noreply dela. O histórico da main nunca é reescrito para corrigir autoria.

   git log --format='%h %an <%ae>' "$(git merge-base HEAD origin/main)"..HEAD
   

• 88regras escritas no AGENTS.md
• 16invariantes que nenhum pull request pode quebrar
• 124documentos: pesquisa, post-mortems, decisões
• 7.531testes, unitários e de integração

• As regras vêm de erros

  Cada invariante nomeia o bug que a causou e o código que a evita. Uma regra que ninguém consegue rastrear até uma falha é removida.

• Todo pull request é auditado

  As alegações de um pull request são checadas contra o código, os gates rodam de novo, e só o que foi verificado entra. Os checklists de auditoria são públicos.

• Uma pessoa decide

  A IA faz a maior parte da digitação. O mantenedor lê, corrige, e transforma o que deu errado na próxima regra.

Leia os checklists de auditoria

Fora de crates/

Os testes de integração ficam em tests/suite/ dentro de cada crate. Helpers compartilhados entre crates vão em crates/ai-memory-test-support, que nunca é distribuído.