コアクレート — 実装状況

これは、docs/design/02-system-architecture.md の対象モジュールマップに対する、正直で現在の状態を補完するものです。実際に構築されたもの、実際のバックエンドに対して検証されたもの（モックではなく）、まだ本当に欠けているものを示しています。計画されているものではありません（それは docs/roadmap/01-implementation-roadmap.md にあります）。

リポジトリルートから cargo build --workspace && cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings を実行してください。本稿執筆時点: 12 クレート、193 の合格テスト、clippy 警告ゼロ、cargo fmt --check クリーン — 表示や外部サービスを必要としない 11 クレートで 183、さらに hiddensteps-observation でライブ X11 ディスプレイを必要とする 10 テスト（存在する場所で検証済み; その行を参照）。4 つのテストは設計上 #[ignore] されており（下記参照）、不合格または 193 の一部としてカウントされません。

存在するもの

さらに、crates/ の外側（ルートワークスペースの一部ではありません — 理由は後述）:

開示された単純化であり、ギャップではないもの

• パターン埋め込みは、hiddensteps-event-store でプレーンな BLOB として保存され、コサイン類似度は Rust で計算され、ADR-0007 の sqlite-vec 仮想テーブルの代わりとなります（event-store/src/schema.sql の先頭のコメントを参照）— ネイティブ SQLite 拡張をロードすることはこの環境では検証不可能であり、ADR-0007 自体も現実的なシングルユーザーボリュームでは、sqlite-vec 自身の動作は総当たりの正確な検索であると述べています。同じセマンティクス、ネイティブ拡張のリスクなし。
• hiddensteps-observation の macOS および Windows モジュール（src/macos/、src/windows/）は、長期間安定したプラットフォーム API（CGWindowListCopyWindowInfo; GetForegroundWindow/GetWindowTextW/QueryFullProcessImageNameW）に対する実際の完全なソースコードで、macOS/Windows ツールチェーンなしで記述されました — 現在は両方とも .github/workflows/ci.yml の core ジョブマトリックスで検証され、クリーンコンパイルされます。macOS モジュールでは最初に 1 つの実際の修正が必要でした（ の型指定なしデフォルト汎用パラメータが キーに対する のトレイト境界を満たさなかった — として明示的に型指定することで修正）; Windows は初回でクリーンコンパイルされました。

Tauri シェルと UI が crates/ の外にある理由

crates/* はルート Cargo.toml ワークスペースであり、cargo が取得する以外のシステム依存関係をゼロにして、この Linux 開発環境で完全にビルド/テスト可能です。apps/desktop/src-tauri はコンパイルするだけでも webkit2gtk-4.1（Linux）を必要としますが、この環境ではインストールできません（パスワードなしの sudo なし、機能する nix/パッケージマネージャーパスなし — 直接試行で確認済み）。ワークスペースから外しておくことで、cargo build --workspace はこのサンドボックスで誰も修正できない 1 つのクレートで永久的に赤くなるのではなく、ここで 100% 緑のままになります。また、同じ理由で、自身の Cargo.toml に空の [workspace] テーブルが必要です — そうしないと、Cargo はこの祖先ワークスペースにアタッチしようとして、「現在のパッケージはワークスペース内にあると信じているが、実際にはそうではない」というエラーで失敗するからです。apps/desktop/ui にはそのような制約はなく、Rust コアと同じ方法で検証されています。どちらの部分もエンドツーエンドで検証されています — ただし、このサンドボックスではなく CI によってです。

4つの #[ignore] テストに関する注記

• hiddensteps-security::keyring_store::tests::set_get_delete_round_trip_against_the_real_vault — 実際の OS 資格情報ボールト/デスクトップセッションが必要。
• hiddensteps-observation::linux::shortcuts::tests::grabs_and_ungrabs_a_real_shortcut — セッション全体の実際の XGrabKey を実行するため、共有環境で自動実行すると妨害になる。
• hiddensteps-llm-provider の tests/ollama_live.rs（2 テスト） — 実際に動作している Ollama インスタンスが必要。両方とも開発中に実際のローカル qwen3:0.6b（0.6B パラメータハイブリッド推論モデル）インスタンスに対して実際に実行され、合計約 2 秒で合格しました; モデル/URL を HIDDENSTEPS_TEST_OLLAMA_MODEL/HIDDENSTEPS_TEST_OLLAMA_URL 環境変数でオーバーライドして別の設定にできます。

4つすべて実際のテストであり、痕跡ではありません — docs/roadmap/03-testing-strategy.md §2 は、CI でモックの背後にあるべきロジックと、意図的で手動の検証に属する OS/セッション/外部サービス統合との正確な区別を描いています。適切なマシンで、cargo test -p <crate> -- --ignored のいずれかを実行してください（1つだけ実行するには <test name> を追加）。