🌌 Integração Asolaria: ai-memory (Rust) como Backend de Memória Neural + HRM Toolchain

[wesleysimplicio]

Integração Asolaria: ai-memory + HRM Toolchain

Contexto

Dois repositórios do ecossistema Asolaria (JesseBrown1980) são direto aplicáveis ao simplicio-dev-cli:

1. ai-memory (★1, Rust) — Solução de long-term memory para agent coding CLIs. Facilita handoff entre diferentes agent vendors (Claude Code, Codex, Cursor, etc.). Roda como MCP server em Rust.

2. HRM — Hierarchical Reasoning Model — Modelo de raciocínio hierárquico que pode ser usado como toolchain de verificação de edições.

O simplicio-dev-cli é a ferramenta de desenvolvimento que implementa edição determinística, validação, e fluxo de trabalho do Simplicio. Integrar ai-memory + HRM significa evoluir a memória neural e o pipeline de edição/validação.

---

Análise ai-memory (Rust)

Conceitos-Chave

1. MCP Server em Rust

• Servidor MCP nativo em Rust (performance máxima)
• Comunicação via stdio MCP protocol
• Compatível com qualquer cliente MCP (Claude, Codex, Cursor, VS Code)

2. Cross-Vendor Handoff

• Memória persistente entre sessões de diferentes agentes
• Claude Code → Codex → Cursor → Simplicio → qualquer um
• Padrão de dados unificado

3. Markdown Wiki Storage

• Memória armazenada como markdown files + git
• FTS5 search para recall
• Organizado por tópicos/domínios

4. Zero-LLM Mode

• Operação sem chamadas de LLM para recall
• Search puramente determinístico

Mapeamento para o simplicio-dev-cli

ai-memory Concept	Feature no simplicio-dev-cli
MCP Server Rust	simplicio dev-cli serve --mcp — dev-cli como MCP server
Cross-vendor handoff	Memória neural compartilhada entre agentes
Markdown wiki + git	simplicio edit com histórico git
FTS5 search	simplicio memory --search
Zero-LLM mode	Edição determinística sem tokens de LLM

---

Propostas de Implementação

🔴 P0 — Dev-CLI como MCP Server (port do ai-memory)

Descrição: Implementar o dev-cli como MCP server em Rust (ou Python com bindings Rust), seguindo o padrão do ai-memory.

Detalhes:

• simplicio dev-cli serve --mcp expõe tools MCP: editar, validar, memory, map
• Compatível com stdio MCP protocol (mesmo do ai-memory)
• Tools registradas: dev-cli_edit, dev-cli_validate, dev-cli_memory
• Performance nativa vs chamadas HTTP
• Bind para Claude Code, Codex, Cursor via simplicio mcp register

🔴 P0 — Cross-Vendor Memory Handoff

Descrição: Implementar o padrão de handoff do ai-memory no dev-cli, permitindo que diferentes agentes compartilhem estado de memória.

Detalhes:

• simplicio memory init — inicializa armazenamento markdown + git
• simplicio memory recall "<query>" — FTS5 search no banco compartilhado
• simplicio memory store "<key>" "<value>" — armazenamento cross-vendor
• simplicio memory handoff --from codex --to claude — transferência de contexto
• Banco em ~/.simplicio/memory/ acessível por qualquer agente MCP

🟡 P1 — Markdown Wiki + Git como Storage Determinístico

Descrição: Usar markdown + git como formato de armazenamento de memória e histórico de edições, seguindo o ai-memory.

Detalhes:

• Cada sessão de simplicio edit gera diff markdown
• simplicio edit --history mostra histórico git das edições
• simplicio edit --blame mostra quem editou o quê (cross-vendor)
• Rollback via git revert no diretório de memória
• simplicio memory prune — compactação de histórico

🟡 P1 — FTS5 Search + Vector Search Híbrido

Descrição: Combinar FTS5 search (do ai-memory) com vector search (já existente no runtime) para recall híbrido.

Detalhes:

• FTS5 para busca textual exata
• Vector (embeddings) para busca semântica
• simplicio memory "<query>" usa ambos, ranqueia por relevância
• --mode fts5|vector|hybrid para controlar

🔵 P2 — HRM Toolchain de Validação Determinística

Descrição: Implementar o padrão de raciocínio hierárquico do HRM como toolchain de validação.

Detalhes:

• High-level validator: verifica se a edição respeita a arquitetura do projeto
• Low-level validator: verifica sintaxe, tipos, lint
• Comunicação bidirecional: se low-level falha, high-level ajusta o plano
• simplicio validate --hrm ativa validação hierárquica

🔵 P2 — Token-Saving Report via HRM Dual Module

Descrição: Usar o padrão dual module do HRM para produzir relatórios de economia de tokens.

Detalhes:

• Módulo alto nível: estima quantos tokens seriam gastos sem Simplicio
• Módulo baixo nível: mede tokens reais gastos
• simplicio dev-cli savings — relatório estruturado
• Output formatado para AGENTS.md (ex: Simplicio: ~2.1K · without ~15.3K · saved ~13.2K (86%))

---

Referências

• ai-memory: https://github.com/JesseBrown1980/ai-memory (Rust)
• HRM: https://github.com/JesseBrown1980/HRM
• MCP Protocol: https://modelcontextprotocol.io
• Simplicio dev-cli: https://github.com/wesleysimplicio/simplicio-dev-cli

---

Métricas de Sucesso

• Dev-CLI como MCP server funcional com tools de edição/validação/memory
• Cross-vendor handoff operacional (Claude Code ↔ Codex ↔ Simplicio)
• Markdown wiki + git como storage de edições
• FTS5 + vector search híbrido funcional
• HRM toolchain de validação hierárquica
• Token-saving report automatizado

[wesleysimplicio]

🔄 Parcial (por escopo) — PR #91 (mergeado) implementou os 2 itens P0 (simplicio-dev-cli serve --mcp hand-rolled JSON-RPC stdio, memory init/store/recall markdown+git). P1/P2 (FTS5+vector híbrido, HRM toolchain) documentados como follow-up, não implementados. Deixando aberta.

---

Generated by Claude Code