कोर क्रेट्स — कार्यान्वयन स्थिति

यह 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 पासिंग टेस्ट, शून्य क्लिप्पी चेतावनियाँ, cargo fmt --check क्लीन — 183 उन 11 क्रेट्स में जिन्हें किसी डिस्प्ले या बाहरी सेवा की आवश्यकता नहीं है, साथ ही hiddensteps-observation में 10 जिन्हें लाइव X11 डिस्प्ले की आवश्यकता है (सत्यापित जहाँ एक मौजूद है; वह पंक्ति देखें)। चार टेस्ट डिज़ाइन द्वारा #[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 के जॉब मैट्रिक्स द्वारा सत्यापित। macOS मॉड्यूल को पहले एक वास्तविक सुधार की आवश्यकता थी ( के अनटाइप्ड डिफ़ॉल्ट जेनेरिक पैरामीटर की ट्रेट बाउंड को कुंजी के लिए संतुष्ट नहीं करते थे — इसे स्पष्ट रूप से के रूप में टाइप करके ठीक किया गया); Windows पहले प्रयास में क्लीन संकलित हुआ।

Tauri शेल और UI crates/ के बाहर क्यों रहते हैं

crates/* रूट Cargo.toml वर्कस्पेस है और इस लिनक्स डेव वातावरण में cargo द्वारा लाए गए शून्य सिस्टम निर्भरताओं के साथ पूरी तरह से बिल्ड/टेस्ट योग्य है। apps/desktop/src-tauri को संकलित करने के लिए भी webkit2gtk-4.1 (लिनक्स) की आवश्यकता है, जिसे यह वातावरण स्थापित नहीं कर सकता (कोई पासवर्डलेस 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 env वेरिएबल्स के माध्यम से मॉडल/URL को ओवरराइड करें।

सभी चार वास्तविक टेस्ट हैं, अवशेष नहीं — docs/roadmap/03-testing-strategy.md §2 ठीक यही अंतर खींचता है उस तर्क के बीच जो CI में मॉक के पीछे होना चाहिए और OS/सत्र/बाहरी-सेवा एकीकरण जो जानबूझकर, मैनुअल सत्यापन में होना चाहिए। उनमें से किसी को भी cargo test -p <crate> -- --ignored के साथ चलाएँ (केवल एक चलाने के लिए <test name> जोड़ें) उस मशीन पर जहाँ ऐसा करना उचित है।