Sobre o projeto

Vault Cortex é um servidor MCP (Model Context Protocol) autônomo que fornece aos agentes de IA busca híbrida, gerenciamento de tarefas, memória estruturada e acesso de leitura/gravação a cofres Obsidian. Ele opera diretamente em arquivos `.md` no disco, sem exigir plugins do Obsidian ou uma instância em execução. O servidor roda em um único contêiner Docker e pode ser implantado localmente, auto-hospedado em um VPS, ou via implantação com um clique no Railway ou Render para acesso remoto. **Principais Recursos:** - **Busca Híbrida**: Combina correspondência de palavras-chave FTS5 com similaridade semântica vetorial via Fusão de Classificação Recíproca (RRF), refinada por reclassificação de codificador cruzado para consultas com intenção. Todos os modelos rodam localmente (~45MB no total, sem API externa). - **Memória Estruturada**: Um sistema de entradas datadas, somente anexação, armazenado em arquivos Markdown simples (pasta padrão `About Me/`). A recuperação por tópico busca entradas relevantes em todos os arquivos de memória, mostrando o estado atual e a evolução histórica. Suporta `entry-policy: living` para entradas de estado atual podáveis. - **Gerenciamento de Tarefas**: Consultas e atualizações de tarefas com suporte a Kanban. Filtra por status, datas, prioridade, pasta ou coluna. Lida com indicadores de emoji do plugin Tasks e formatos de campo inline do Dataview. Concluir tarefas recorrentes gera as próximas ocorrências; suporta ações "Ao concluir". - **Acesso a Arquivos**: Lê arquivos não-Markdown, incluindo imagens (redimensionadas no servidor), PDFs (extração de texto ou páginas renderizadas), canvases (esboços legíveis) e arquivos de dados (TXT, SVG, JSON, XML, CSV, YAML, logs, Bases). - **Grafo de Links**: Backlinks, links de saída e detecção de órfãos em todo o cofre. - **Nativo do Obsidian**: Entende frontmatter, wikilinks, tags, cabeçalhos e notas diárias. - **Fluxos de Trabalho Guiados**: Prompts integrados para saúde do cofre, revisão de memória e reconciliação diária, montados a partir de dados ao vivo do cofre. **Autenticação**: Suporta OAuth 2.1 para acesso remoto com páginas de consentimento, além de token Bearer para clientes sem OAuth. A renovação de token é tratada automaticamente para clientes OAuth. **Opções de Implantação**: - Local: Docker + pasta do cofre, configurado via `npx vault-cortex@latest init` - Remoto: Implantação com um clique no Railway ou Render, ou auto-hospedado em qualquer VPS Linux com Docker - Implantações remotas usam Obsidian Sync para manter o cofre atualizado entre dispositivos **Configuração**: A CLI gerencia o ciclo de vida do servidor (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`). A configuração manual via Docker Compose também está disponível. Uma página de configuração em `/setup` lida com o login do Obsidian Sync para implantações remotas. **Segurança**: Inclui CI com varreduras Gitleaks e Trivy, OpenSSF Scorecard e selos de Boas Práticas. O cofre permanece como fonte de verdade em Markdown simples; o contêiner contém apenas uma cópia. **Casos de Uso**: Testado em uma viagem de 15 dias pela Europa com mais de 30 sessões de um telefone, 216 chamadas de ferramentas, zero acesso a laptop. Escritas em uma sessão estavam imediatamente disponíveis na próxima, entre cidades e dias.