فصل صريح لما تُنفّذه كاظمة اليوم عمّا هو مخطّط له أو طموحي أو مربوط جزئيًا. مُثبَّت بقاعدة الشيفرة v0.10.0+ (بعد جاهزية الإنتاج).
تُعلَّم العناصر على النحو التالي:
- ✅ مُنفَّذ ومربوط — يعمل في زمن التشغيل الافتراضي، مُتحقَّق منه في الكود.
- 🟡 مُنفَّذ لكن غير مربوط بالكامل — يوجد كود لكنه غير متّصل في المسار الافتراضي.
- 🔴 مخطّط له / على خارطة الطريق — غير موجود في قاعدة الشيفرة، أو مُعلَن عنه كهدف في
ROADMAP.md.
| القدرة | الحالة | ملاحظات |
|---|
| حلقة ReAct للمُشرف عبر LangGraph | ✅ | graph_builder.py. |
| استدعاء الأدوات مع مزوّدين متوافقين مع OpenAI | ✅ | httpx، دون SDK. |
| مسار الأداة الاحتياطي لـ NVIDIA NIM | ✅ | llm_provider.py:285-300. |
| البثّ (SSE) | ✅ | streaming.py. |
| ضغط السياق (تلخيص عبر LLM) | ✅ | compaction.py. |
| الضغط مع استرجاع الذاكرة + نقطة التفتيش | 🟡 | مُكيّف الذاكرة مربوط على المسارات الرئيسية؛ checkpoint_manager ما زال اختياريًا. |
| معالجة تحديد المعدل (429) | ✅ | تراجع أسي + Retry-After في llm_provider.py (2026-07). |
| قاطع التكلفة مربوط تلقائيًا | ✅ | CostCircuitBreaker يُنشأ لكل وكيل (agent_runner.py) ويُقاد على الحلقة الحية — record_user_interaction() لكل رسالة واردة، بوابة should_halt()، وrecord_cost() بعد كل استدعاء LLM (graph_builder.py). معروض على لوحة التحكم عبر .status(). |
حدَّث 2026-07-27 — تعزيز + رسم خصائص SQLite L2 + consolidator + واجهة الرسم على main.
المتبقي: docs/plans/MEMORY_REMAINING.md. الدليل الكامل: الذاكرة وRAG.
| القدرة | الحالة | ملاحظات |
|---|
| محرك V2 المعرفي | ✅ | رسم معتقدات ثنائي الزمن + حلقات من 4 طبقات + DAG إجرائية. مكدّس الذاكرة الوحيد (أُزيلت V1). |
| RAG لكل دورة | ✅ | recall() لـ V2 (معتقدات + حلقات + PPR) كل دورة مستخدم. |
| حقن ذاكرة الضغط | ✅ | recall.search() لـ V2 + تخزين الملخص عبر swarm_bridge. |
| جسر ذاكرة السرب | ✅ | نتائج العمّال + SoulEvolution + ملخّصات الضغط تُكتب إلى V2. |
| رسم معتقدات ثنائي الزمن | ✅ | مسندات وظيفية/مجموعة/حالة؛ valid_until/invalidated_at. |
| PPR بمخطط الأنانية المحلي | ✅ | قفزتان، N≤200، α=0.15 تعزيز الاستدعاء. |
| طابور توحيد دائم | ✅ | طابور مهام memory_ops.db + macro_sleep 6h + نسخ/تصدير 24h. |
| DAG الإجراءات الإجرائية | ✅ | ثقة مهارة مُنعّمة لابلاس C(d)=(S+1)/(N+2). |
| نسخ احتياطي ليلي + تصدير | ✅ | sqlite3.backup() أصلي + JSONL/GraphML على مجدول 24h. |
| مُرمِّز عربي (FTS5) | ✅ | FTS5 حلقات V2 + تطبيع متماثل. |
| متّجهات/رسم مشتركة متعدّدة النسخ | 🔴 | ملفات محلية فقط — MEMORY_REMAINING S1–S2. |
checkpoint_manager في الضغط | 🟡 | ما زال اختياريًا — حافظ نقاط تفتيش LangGraph يغطّي الدورات. |
| القدرة | الحالة | ملاحظات |
|---|
| ستة أنماط إرسال | ✅ | dispatch/broadcast/pipeline/fan-out/consult/conditional. |
| التجميع (collect/first_valid/merge_all/vote/synthesize) | ✅ | aggregator.py. |
| قواطع الدائرة (half-open single-probe) | ✅ | reliability.py. |
| إعادة المحاولة / المهلة / تحقّق المخرجات / توازٍ محدود | ✅ | reliability.py. |
| نقاط تفتيش HITL لخط المعالجة مع مهلة رفض تلقائي | ✅ | checkpoint_manager.py. |
| كشف دورات التسليم (عمق 5، زيارات 2) | ✅ | handoff_guards.py. |
| التوسّع التلقائي للعمّال | 🟡 | get_autoscaler() مُشار إليه؛ تحقّق من العمق. |
| مقاييس Prometheus | ✅ | إضافة prometheus-client اختيارية؛ نقطة /metrics في routes_direct.py. |
| القدرة | الحالة | ملاحظات |
|---|
| بوابة HITL للرسم (interrupt) | ✅ | نشطة على كل مواقع بناء الإنتاج. |
| بوابة HITL لناقل السرب (fail-closed) | ✅ | swarm/safety.py. |
| HITL نقاط تفتيش خط المعالجة | ✅ | checkpoint_manager.py. |
| توقيع وتحقّق HMAC للمهارات | ✅ | hub/cli.py + hub/loader.py. |
| تفويض Ed25519 + AES-GCM | 🟡 | مكتبة/أرشيف فقط — غير مربوط في زمن التشغيل الافتراضي؛ SwarmEngine هو SoT. |
| مصادقة bearer لـ MCP SSE | ✅ | mcp/manager.py:461-466. |
| مصادقة MCP stdio | ✅ | حقن auth.type: env / arg مدعوم على خوادم stdio. |
| أسرار ConfigStore مدعومة بـ Vault | ✅ | المفاتيح الحساسة → خزنة AES عند تعيين KAZMA_VAULT_KEY (معالجات تدقيق 2026-07). |
تعديل نقاط التفتيش /undo / /edit | ✅ | مسار الرسم الحي عبر aget_state / aupdate_state. |
| صفحة تسجيل دخول السر البعيدة | ✅ | /login + POST /api/auth/login. |
| ”طبقات ثقة” تشفيرية | 🔴 | فقط علم منطقي certified + سلسلة trust: غير مستخدمة. |
| فرض مشغّل التصلّب | 🟡 | kazma-security.yaml يعلن السياسة؛ تحقّق من الفرض وقت التشغيل. |
| القدرة | الحالة | ملاحظات |
|---|
| مُكيّف Telegram (كامل الميزات) | ✅ | long-poll + webhook اختياري، صوت، تفاعلات، لوحات مفاتيح. |
| مُكيّف Discord | ✅ | WebSocket للبوابة. |
| مُكيّف Slack | ✅ | Socket Mode / polling. |
| واجهة الويب (SSE) | ✅ | /api/chat/stream. |
| دردشة WebSocket | ✅ | /ws/chat القديم أُزيل؛ SSE /api/chat/stream هو النقل الوحيد. |
| TUI | ✅ | Textual، قراءة غالبًا. |
| i18n EN/AR + RTL | ✅ | قاموس مدمج، IBM Plex Sans / IBM Plex Sans Arabic + أساس 16px لـ RTL. |
استوديو X (/x) | ✅ | مؤلّف ومخطِّط X فقط. x_post في المحادثة يبقى HITL دائمًا. الـ API الرسمي فقط. |
| بروتوكول المجلس | ✅ | majlis.py (جوهر)، ليس مفتاح واجهة. |
| الصوت على Discord/Slack/Web | ✅ | STT + TTS مربوطان بكل المنصات عبر voice_helpers.py (كان Telegram فقط). |
| الوسائط / المرفقات (صورة/مستند/فيديو) | ✅ | عقد Attachment على IncomingMessage/OutboundMessage؛ وارد+صادر على كل المنصات + Web /api/chat/upload. |
أوامر slash /undo، /edit | ✅ | يعالجها الرسم (_handle_undo/_handle_edit يعدّلان حالة نقطة التفتيش). |
| إعادة تشغيل السفر عبر الزمن والتفرع | ✅ | SnapshotRecorder مربوط بكل مواقع بناء الرسم؛ استعادة /replay + فرع /fork + لوحة زمنية Web UI /replay + أحداث لقطات SSE حية + /api/replay/*. |
| القدرة | الحالة | ملاحظات |
|---|
| مزوّدون متوافقون مع OpenAI (18 إعدادًا مسبقًا) | ✅ | providers.py — يشمل Mistral/Together/Cohere/Fireworks/Perplexity/AI21/Groq/xAI/OpenRouter/NVIDIA. |
| مزوّدون أصليون غير OpenAI | ✅ | AnthropicProvider (/messages)، AzureProvider (api-key+api-version)، BedrockProvider (SigV4 + Converse)، GeminiProvider (ADC). انظر مزوّدو LLM. |
| Google Vertex AI (ADC) | ✅ | google_llm.py. |
| خوادم محلية (Ollama/LM Studio) | ✅ | معالجة مفتاح وهمي. |
| MCP (stdio + SSE + Streamable HTTP) | ✅ | mcp/manager.py — Streamable HTTP (مواصفة MCP 2025-03-26) مع استئناف Mcp-Session-Id. |
| Skill Hub (سجل، توقيع، شهادة) | ✅ | hub/. |
| تتبّع Langfuse | 🟡 | التبعية موجودة؛ علم logging.langfuse.enabled؛ التكامل غير نشط. |
| OpenTelemetry | 🟡 | إضافة [tracing] تحوي مُصدِّرات؛ تتبّع كاظمة spans داخلية، لا OTel. |
| Cloudflare Pages / edge | 🔴 | غير منطبق — خدمة Python ذات حالة. |
| PostgreSQL (الوكيل الرئيسي) | ✅ | خلفية من الدرجة الأولى لـ ConfigStore/sessions/swarm/checkpoints؛ موافقات HITL المعلّقة تُعدّد خيوط Postgres (hitl_approval.py). |
| القدرة | الحالة | ملاحظات |
|---|
| سجلات JSON منظَّمة | ✅ | logging.format: json. |
| مقاييس السرب (في الذاكرة + SQLite) | ✅ | MetricsCollector. |
| spans تتبّع داخلية | ✅ | TraceStore (لوحة التحكم) + TracingEmitter (السرب). |
| أحداث قياس SSE | ✅ | /api/chat/stream + مُوجِّه telemetry. |
| تتبّع Langfuse | ✅ | مربوط عبر KazmaTracer؛ خامد افتراضيًا (logging.langfuse.enabled: false). |
| نقطة كشط Prometheus | ✅ | /metrics + /api/metrics في kazma_ui/metrics.py، مُحمَّلة في app.py (كتلة gateway-active). تُصدر text/plain; version=0.0.4 مع عدّادات وارد/صادر/أخطاء، خيوط نشطة، مُكيّف، عمق الطابور، ومقاييس سرب. |
| تصدير OpenTelemetry | 🔴 | أُزيل — كود ميت + 8 حزم طُهّرت. Langfuse + Console يبقيان كخلفتين. أعد الإضافة فقط إذا أصبح تصدير OTLP إلى Jaeger/Tempo متطلّبًا حقيقيًا. |
الذاكرة (2026-07): التعزيز + رسم L2 + consolidator + واجهة الرسم منجزة.
صقل/توسيع الذاكرة المتبقي فقط في MEMORY_REMAINING.md.
عناصر مفتوحة أخرى:
- إضافة تراجع 429 إلى طبقة إعادة المحاولة (أو توثيق متطلّب الوكيل بصوت أعلى).
- حسم سؤال OpenTelemetry — كود OTel الميت + إضافة
[tracing] أُزيلا؛ Langfuse + Console يبقيان. أعد الإضافة فقط إذا كان تصدير OTLP مطلوبًا.
- قاعدة بيانات متّجهية مستضافة (pgvector/Qdrant/Weaviate) — فقط عندما يكون الاستدعاء المشترك متعدّد النسخ متطلّب منتج.
- هذا الملف يقاوم عمدًا المبالغة في الوعود. حيث يصف README/نص تسويقي ميزة مربوطة جزئيًا فقط، عمود الحالة يقول 🟡 مع السبب المحدد.
- “الخطوات التالية المقترحة” توصيات رأيّة من التدقيق، مرتّبة بنسبة الأثر إلى الجهد. ليست التزامات.
- يعكس هذا الملف واقع الكود اعتبارًا من v0.10.0+، لا مستقبل التسويق.
