Crates principais — estado da implementação

Este é o complemento honesto do estado atual ao mapa de módulos-alvo de docs/design/02-system-architecture.md. Ele descreve o que está realmente construído, o que foi verificado contra um backend real vs. um mock, e o que ainda está genuinamente faltando — não o que está planejado (isso está em docs/roadmap/01-implementation-roadmap.md).

Execute cargo build --workspace && cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings a partir da raiz do repositório. No momento em que isto foi escrito: 12 crates, 193 testes aprovados, zero avisos do clippy, cargo fmt --check limpo — 183 nos 11 crates que não precisam de display ou serviço externo, mais 10 em hiddensteps-observation que precisam de um display X11 ativo (verificados onde um existe; veja essa linha). Quatro testes estão marcados com #[ignore] por design (veja abaixo) e não são contados como falhas nem como parte dos 193.

O que existe

Além disso, fora de crates/ (não faz parte do workspace raiz — veja o motivo abaixo):

O que é uma simplificação declarada, não uma lacuna

• Embeddings de padrões são armazenados como BLOBs simples em hiddensteps-event-store com similaridade de cosseno calculada em Rust, substituindo a tabela virtual sqlite-vec da ADR-0007 (veja o comentário no topo de event-store/src/schema.sql) — carregar uma extensão SQLite nativa não era verificável neste ambiente, e a própria ADR-0007 observa que, em volumes realistas de usuário único, o comportamento do sqlite-vec é busca exata por força bruta. Mesma semântica, sem risco de extensão nativa.
• Os módulos de macOS e Windows de hiddensteps-observation (src/macos/, src/windows/) são código-fonte completo e real contra APIs de plataforma estáveis há muito tempo (CGWindowListCopyWindowInfo; GetForegroundWindow/GetWindowTextW/QueryFullProcessImageNameW), escritos sem um toolchain macOS/Windows disponível — e ambos agora compilam limpos, verificado pela matriz de jobs de . O módulo macOS precisou de uma correção real primeiro (os parâmetros genéricos padrão não tipados de não satisfaziam o trait bound de para uma chave — corrigido tipando-o explicitamente como ); o Windows compilou limpo na primeira tentativa.

Por que o shell Tauri e a UI ficam fora de crates/

crates/* é o workspace do Cargo.toml raiz e é totalmente compilável/testável neste ambiente de desenvolvimento Linux, sem nenhuma dependência de sistema além do que cargo baixa. apps/desktop/src-tauri precisa de webkit2gtk-4.1 (Linux) apenas para compilar, o que este ambiente não consegue instalar (sem sudo sem senha, sem caminho funcional via nix/gerenciador de pacotes — confirmado por tentativa direta). Mantê-lo fora do workspace significa que cargo build --workspace continua 100% verde aqui, em vez de ficar permanentemente vermelho por causa de um crate que ninguém consegue corrigir neste sandbox. Ele também precisa de sua própria tabela [workspace] vazia em seu Cargo.toml pelo mesmo motivo — caso contrário, o Cargo tenta anexá-lo a este workspace ancestral de qualquer forma e falha com "current package believes it's in a workspace when it's not." apps/desktop/ui não tem essa restrição e é verificado da mesma forma que o núcleo Rust. Ambas as partes ainda são verificadas de ponta a ponta — apenas pela CI em vez deste sandbox.

Uma nota sobre os quatro testes marcados com #[ignore]

• hiddensteps-security::keyring_store::tests::set_get_delete_round_trip_against_the_real_vault — precisa de um vault de credenciais do SO/sessão de desktop real.
• hiddensteps-observation::linux::shortcuts::tests::grabs_and_ungrabs_a_real_shortcut — executa um XGrabKey real em toda a sessão, o que seria disruptivo para executar automaticamente em um ambiente compartilhado.
• Os tests/ollama_live.rs de hiddensteps-llm-provider (2 testes) — precisam de uma instância Ollama real em execução. Ambos foram realmente executados durante o desenvolvimento contra uma instância local real qwen3:0.6b (modelo de raciocínio híbrido de 0,6B parâmetros) e passaram em ~2 segundos no total; substitua o modelo/URL por meio das variáveis de ambiente HIDDENSTEPS_TEST_OLLAMA_MODEL/HIDDENSTEPS_TEST_OLLAMA_URL para uma configuração diferente.

Todos os quatro são testes reais, não vestigiais — docs/roadmap/03-testing-strategy.md §2 traça exatamente essa distinção entre lógica que pertence atrás de um mock na CI e integração com SO/sessão/serviço externo que pertence à verificação manual e deliberada. Execute qualquer um deles com cargo test -p <crate> -- --ignored (adicione <test name> para executar apenas um) em uma máquina onde isso seja apropriado.