Kern-Crates — Implementierungsstatus

Dies ist die ehrliche, den aktuellen Stand abbildende Ergänzung zur Zielmodul-Karte aus docs/design/02-system-architecture.md. Sie sagt, was tatsächlich gebaut ist, was gegen ein echtes Backend statt gegen einen Mock verifiziert wurde und was wirklich noch fehlt — nicht, was geplant ist (dafür gibt es docs/roadmap/01-implementation-roadmap.md).

Führen Sie cargo build --workspace && cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings vom Repository-Stammverzeichnis aus. Zum Zeitpunkt dieses Schreibens: 12 Crates, 193 bestandene Tests, keine Clippy-Warnungen, cargo fmt --check sauber — 183 verteilt auf die 11 Crates, die weder ein Display noch einen externen Dienst benötigen, plus 10 in hiddensteps-observation, die ein aktives X11-Display benötigen (verifiziert, wo eines vorhanden ist; siehe diese Zeile). Vier Tests sind bewusst mit #[ignore] markiert (siehe unten) und zählen weder als Fehlschläge noch als Teil der 193.

Was existiert

Außerdem, außerhalb von crates/ (nicht Teil des Root-Workspace — siehe unten für die Begründung):

Was eine offengelegte Vereinfachung ist, keine Lücke

• Pattern-Embeddings werden in hiddensteps-event-store als einfache BLOBs gespeichert, wobei die Kosinus-Ähnlichkeit in Rust berechnet wird; sie dienen als Ersatz für die virtuelle sqlite-vec-Tabelle aus ADR-0007 (siehe den Kommentar am Anfang von event-store/src/schema.sql) — das Laden einer nativen SQLite-Erweiterung war in dieser Umgebung nicht verifizierbar, und ADR-0007 selbst merkt an, dass das Verhalten von sqlite-vec bei realistischen Einzelbenutzer-Volumina selbst eine Brute-Force-Exaktsuche ist. Gleiche Semantik, kein Risiko durch native Erweiterungen.
• Die macOS- und Windows-Module von hiddensteps-observation (src/macos/, src/windows/) sind echter, vollständiger Quellcode gegen seit langem stabile Plattform-APIs (CGWindowListCopyWindowInfo; GetForegroundWindow/GetWindowTextW/QueryFullProcessImageNameW), geschrieben ohne verfügbare macOS-/Windows-Toolchain — und beide kompilieren nun sauber, verifiziert durch die -Job-Matrix von . Das macOS-Modul benötigte zunächst eine echte Korrektur (die untypisierten Standard-Generik-Parameter von erfüllten die Trait-Bound von für einen -Schlüssel nicht — behoben durch explizite Typisierung als ); Windows kompilierte beim ersten Versuch sauber.

Warum die Tauri-Shell und die UI außerhalb von crates/ liegen

crates/* ist der Workspace des Root-Cargo.toml und in dieser Linux-Entwicklungsumgebung vollständig baubar/testbar, ohne Systemabhängigkeiten über das hinaus, was cargo herunterlädt. apps/desktop/src-tauri benötigt webkit2gtk-4.1 (Linux), um überhaupt zu kompilieren, was diese Umgebung nicht installieren kann (kein passwortloses sudo, kein funktionierender nix-/Paketmanager-Pfad — durch direkten Versuch bestätigt). Es außerhalb des Workspace zu halten, bedeutet, dass cargo build --workspace hier zu 100 % grün bleibt, statt wegen eines einzigen Crates dauerhaft rot zu sein, das in dieser Sandbox niemand reparieren kann. Aus demselben Grund benötigt es außerdem eine eigene leere [workspace]-Tabelle in seiner Cargo.toml — andernfalls versucht Cargo, es ohnehin an diesen übergeordneten Workspace anzuhängen, und schlägt mit "current package believes it's in a workspace when it's not" fehl. apps/desktop/ui hat keine solche Einschränkung und wird auf dieselbe Weise verifiziert wie der Rust-Kern. Beide Teile werden weiterhin End-to-End verifiziert — nur eben durch CI statt durch diese Sandbox.

Eine Anmerkung zu den vier mit #[ignore] markierten Tests

• hiddensteps-security::keyring_store::tests::set_get_delete_round_trip_against_the_real_vault — benötigt einen echten OS-Anmeldedaten-Tresor bzw. eine Desktop-Sitzung.
• hiddensteps-observation::linux::shortcuts::tests::grabs_and_ungrabs_a_real_shortcut — führt ein echtes sitzungsweites XGrabKey aus, was bei einem automatischen Lauf in einer geteilten Umgebung störend wäre.
• tests/ollama_live.rs aus hiddensteps-llm-provider (2 Tests) — benötigt eine echt laufende Ollama-Instanz. Beide wurden während der Entwicklung tatsächlich gegen eine echte lokale qwen3:0.6b-Instanz (ein Hybrid-Reasoning-Modell mit 0,6 Mrd. Parametern) ausgeführt und bestanden in zusammen ~2 Sekunden; für ein anderes Setup können Modell/URL über die Umgebungsvariablen HIDDENSTEPS_TEST_OLLAMA_MODEL/HIDDENSTEPS_TEST_OLLAMA_URL überschrieben werden.

Alle vier sind echte Tests, keine Relikte — docs/roadmap/03-testing-strategy.md §2 zieht genau diese Unterscheidung zwischen Logik, die in CI hinter einem Mock gehört, und OS-/Sitzungs-/Externdienst-Integration, die in bewusste, manuelle Verifikation gehört. Führen Sie jeden davon mit cargo test -p <crate> -- --ignored aus (fügen Sie <test name> hinzu, um nur einen auszuführen) auf einer Maschine, auf der das angemessen ist.