الصناديق الأساسية (Core crates) — حالة التنفيذ

هذا هو المكمّل الأمين للحالة الراهنة لخريطة الوحدات المستهدفة في 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 صندوقاً (crate)، 193 اختباراً ناجحاً، صفر تحذيرات clippy، cargo fmt --check نظيف — 183 عبر الصناديق الـ 11 التي لا تحتاج إلى شاشة عرض أو خدمة خارجية، بالإضافة إلى 10 في hiddensteps-observation تحتاج إلى شاشة X11 حية (تم التحقق منها حيثما توجد واحدة؛ انظر ذلك الصف). أربعة اختبارات مؤجَّلة بـ #[ignore] عن قصد (انظر أدناه) ولا تُحتسب كإخفاقات أو ضمن الـ 193.

ما هو موجود

بالإضافة إلى ذلك، خارج crates/ (وليس جزءاً من مساحة العمل الجذرية — انظر السبب أدناه):

ما هو تبسيط مُعلَن عنه وليس فجوة

• تمثيلات الأنماط (Pattern embeddings) تُخزَّن كـ BLOBs عادية في hiddensteps-event-store مع حساب تشابه جيب التمام (cosine similarity) في Rust، نيابةً عن الجدول الافتراضي sqlite-vec الخاص بـ ADR-0007 (انظر التعليق أعلى event-store/src/schema.sql) — لم يكن تحميل امتداد SQLite أصلي قابلاً للتحقق في هذه البيئة، ويلاحظ ADR-0007 نفسه أنه عند أحجام الاستخدام الواقعية لمستخدم واحد، فإن سلوك sqlite-vec هو بحث دقيق بالقوة الغاشمة. دلالات متماثلة، دون مخاطر الامتداد الأصلي.
• وحدتا macOS وWindows في hiddensteps-observation (src/macos/، src/windows/) مصدر حقيقي كامل مقابل واجهات برمجة منصات مستقرة منذ زمن طويل (CGWindowListCopyWindowInfo؛ GetForegroundWindow/GetWindowTextW/QueryFullProcessImageNameW) كُتبتا دون توفر سلسلة أدوات macOS/Windows — وكلتاهما تُترجم الآن نظيفة، وهو ما تحققت منه مصفوفة وظيفة core في . تطلبت وحدة macOS إصلاحاً حقيقياً واحداً أولاً (لم تُرضِ المعاملات العامة الافتراضية غير المكتوبة الأنواع في قيدَ trait الخاص بـ لمفتاح — أُصلح بكتابة نوعها صراحةً كـ )؛ أما Windows فتُرجمت نظيفة من المحاولة الأولى.

لماذا يقع غلاف Tauri والواجهة خارج crates/

crates/* هو مساحة عمل Cargo.toml الجذرية ويمكن بناؤه واختباره بالكامل في بيئة تطوير لينكس هذه دون أي تبعيات نظام تتجاوز ما يجلبه cargo. يحتاج apps/desktop/src-tauri إلى webkit2gtk-4.1 (لينكس) حتى يُترجم أصلاً، ولا يمكن لهذه البيئة تثبيته (لا sudo بلا كلمة مرور، ولا مسار nix/مدير حزم يعمل — مؤكد بمحاولة مباشرة). إبقاؤه خارج مساحة العمل يعني أن cargo build --workspace يبقى أخضر 100% هنا بدلاً من أن يبقى أحمر بشكل دائم على صندوق واحد لا يمكن لأحد إصلاحه في هذا الصندوق الرملي. كما يحتاج جدول [workspace] فارغاً خاصاً به في Cargo.toml للسبب نفسه — وإلا فسيحاول 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 — يحتاج خزنة بيانات اعتماد نظام تشغيل/جلسة سطح مكتب حقيقية.
• hiddensteps-observation::linux::shortcuts::tests::grabs_and_ungrabs_a_real_shortcut — ينفذ XGrabKey حقيقياً على مستوى الجلسة، وهو ما سيكون معطِّلاً إذا شُغِّل تلقائياً في بيئة مشتركة.
• tests/ollama_live.rs الخاص بـ hiddensteps-llm-provider (اختباران) — يحتاج مثيل Ollama حقيقياً قيد التشغيل. وقد شُغِّل الاثنان فعلياً أثناء التطوير مقابل مثيل محلي حقيقي qwen3:0.6b (نموذج استدلال هجين بمعاملات 0.6B) ونجحا في نحو ثانيتين معاً؛ لتجاوز النموذج/العنوان استخدم متغيرَي البيئة HIDDENSTEPS_TEST_OLLAMA_MODEL/HIDDENSTEPS_TEST_OLLAMA_URL لإعداد مختلف.

الاختبارات الأربعة كلها اختبارات حقيقية، وليست بقايا — يرسم docs/roadmap/03-testing-strategy.md §2 هذا التمييز بالضبط بين المنطق الذي ينتمي خلف نموذج محاكاة في CI وتكامل نظام التشغيل/الجلسة/الخدمة الخارجية الذي ينتمي إلى تحقق يدوي متعمد. شغّل أيّاً منها بـ cargo test -p <crate> -- --ignored (أضف <test name> لتشغيل واحد فقط) على جهاز يكون التشغيل فيه مناسباً.