핵심 크레이트 — 구현 현황

이는 docs/design/02-system-architecture.md의 대상 모듈 맵에 대한 솔직한 현재 상태 보충 자료입니다. 실제로 구축된 것, 목(mock)이 아닌 실제 백엔드에 대해 검증된 것, 그리고 여전히 실제로 누락된 것을 설명합니다 — 계획된 것이 아니라요 (계획은 docs/roadmap/01-implementation-roadmap.md에 있습니다).

저장소 루트에서 cargo build --workspace && cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings를 실행하세요. 이 글을 작성하는 시점 기준: 12개 크레이트, 193개 통과 테스트, clippy 경고 0건, cargo fmt --check 통과 — 디스플레이나 외부 서비스가 필요 없는 11개 크레이트에서 183개, 그리고 실제 X11 디스플레이가 필요한 hiddensteps-observation에서 10개(디스플레이가 있는 환경에서 검증됨; 해당 행 참조). 4개의 테스트는 설계상 #[ignore] 처리되어 있으며(아래 참조) 실패로도, 193개에도 포함되지 않습니다.

현재 구현된 것

그리고 crates/ 외부(루트 워크스페이스의 일부가 아님 — 아래에서 이유 확인):

공개된 단순화이지 결함이 아닌 것

• 패턴 임베딩은 hiddensteps-event-store에 일반 BLOB로 저장되며 코사인 유사도는 Rust에서 계산됩니다 — ADR-0007의 sqlite-vec 가상 테이블을 대신합니다(event-store/src/schema.sql 상단의 주석 참조) — 네이티브 SQLite 확장을 로드하는 것은 이 환경에서 검증할 수 없었고, ADR-0007 자체도 현실적인 단일 사용자 규모에서는 sqlite-vec의 동작이 본질적으로 무차별 정밀 검색(brute-force exact search)이라고 명시합니다. 동일한 의미론, 네이티브 확장 위험 없음.
• hiddensteps-observation의 macOS 및 Windows 모듈(src/macos/, src/windows/)은 macOS/Windows 툴체인 없이 작성된, 오랫동안 안정적인 플랫폼 API(CGWindowListCopyWindowInfo; GetForegroundWindow/GetWindowTextW/QueryFullProcessImageNameW)에 대한 실제 완전한 소스입니다 — 그리고 이제 둘 다 깨끗하게 컴파일되며, .github/workflows/ci.yml의 core 작업 매트릭스로 검증되었습니다. macOS 모듈은 먼저 실제 수정이 하나 필요했습니다(의 타입이 지정되지 않은 기본 제네릭 매개변수가 키에 대한 의 트레이트 바운드를 충족하지 못함 — 로 명시적으로 타입을 지정하여 수정); Windows는 첫 시도에 깨끗하게 컴파일되었습니다.

Tauri 셸과 UI가 crates/ 외부에 있는 이유

crates/*는 루트 Cargo.toml 워크스페이스이며, cargo가 가져오는 것 외에는 시스템 종속성 없이 이 Linux 개발 환경에서 완전히 빌드/테스트할 수 있습니다. apps/desktop/src-tauri는 컴파일조차 하려면 webkit2gtk-4.1(Linux)이 필요한데, 이 환경에서는 설치할 수 없습니다(비밀번호 없는 sudo 없음, 작동하는 nix/패키지 관리자 경로 없음 — 직접 시도로 확인됨). 워크스페이스에서 제외함으로써 cargo build --workspace가 이 샌드박스에서 아무도 수정할 수 없는 크레이트 하나 때문에 영구히 빨간불이 되는 대신 여기서 100% 초록불을 유지합니다. 같은 이유로 Cargo.toml에 자체 빈 [workspace] 테이블도 필요합니다 — 그렇지 않으면 Cargo가 어쨌든 이 상위 워크스페이스에 연결하려 시도하고 "current package believes it's in a workspace when it's not" 오류로 실패합니다. apps/desktop/ui에는 그러한 제약이 없으며 Rust 코어와 같은 방식으로 검증됩니다. 두 부분 모두 여전히 종단 간 검증됩니다 — 이 샌드박스 대신 CI에 의해요.

#[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초 만에 통과했습니다; 다른 설정을 원하면 HIDDENSTEPS_TEST_OLLAMA_MODEL/HIDDENSTEPS_TEST_OLLAMA_URL 환경 변수로 모델/URL을 재정의하세요.

네 개 모두 실제 테스트이지 잔재물이 아닙니다 — docs/roadmap/03-testing-strategy.md §2는 CI에서 목 뒤에 있어야 하는 로직과 의도적인 수동 검증에 속하는 OS/세션/외부 서비스 통합 사이를 정확히 이렇게 구분합니다. 실행하기 적절한 머신에서 cargo test -p <crate> -- --ignored로 이 중 아무 테스트나 실행하세요(하나만 실행하려면 <test name>을 추가하세요).