المسرد
مصطلحات تُستخدم عبر كاظمه، بمعانٍ دقيقة مُستندة إلى قاعدة الشيفرة.
Adapter (platform) — مُكيّف المنصة
صنف يترجم الأحداث الأصلية للمنصة (تحديثات Telegram، أحداث بوابة Discord، أحداث مقبس Slack) إلى IncomingMessage الخاص بكاظمه، ويُصيِّر OutboundMessage للخلف. جميعها توسِّع BaseAdapter (kazma-gateway/.../gateway.py:239). يختلف عن مُكيّف الناقل (bus adapter).
Adapter (bus) — مُكيّف الناقل
مُكيّف منفصل لموافقات HITL الخاصة بالسرب (TelegramBusAdapter، DiscordBusAdapter، SlackBusAdapter)، وجميعها فئات فرعية من BusAdapter (kazma_core/swarm/bus.py:66). يُنشَّط واحدٌ منها فقط في كل مرة؛ الأولوية Telegram > Discord > Slack.
Agent handler — معالج الوكيل
الجسر بين مُكيّفات المنصة ورسم المُشرف. أصبح الآن حزمة agent_handler/ (مُفكَّكة من ملف agent_handler.py القديم). يملك عزل المنصة.
ACP (Agent Client Protocol) — بروتوكول عميل الوكيل
بروتوكول JSON-RPC من Zed لمحرّرات تستضيف وكيل برمجة عبر stdio. تنفّذ كاظمه خادمًا أساسيًا كـ kazma acp (initialize، session/new، session/prompt، session/cancel، مقاطع استدعاء الأدوات في session/update، وsession/request_permission لـ HITL). نفس رسم kazma ask.
Aggregation — التجميع
طريقة دمج نتائج التوزيع المتعدّد (fan-out): collect، first_valid، merge_all، vote، synthesize (swarm/aggregator.py).
Authority (Context) — سلطة السياق
ContextAuthority (authority.py) — يقرّر متى يُضغط (compact) المحادثة (عند 80% من نافذة السياق) ويستدعي CompactionEngine.
AutoScaler — الموسِّع التلقائي
يُنشئ عمّال \{name\}-pool-\{n\} من قوالب عندما لا يجد التوجيه auto عاملًا قادرًا؛ ويُلغي (reaps) النسخ الخاملة.
Blackboard (pipeline) — اللوحة المشتركة (خط المعالجة) السياق المشترك الذي يُمرَّر بين مراحل خط المعالجة؛ ترى كل مرحلة مخرجات المراحل السابقة.
BlackboardStore — مخزن اللوحة المشتركة كائن المسودة المشتركة (scratchpad) الذي يُمرَّر بين عمّال خط المعالجة/التوزيع المتعدّد/الاستشارة؛ تقرأ كل مرحلة المخرجات السابقة وتكتب مخرجاتها.
Bounded concurrency — التوازي المحدود
BoundedConcurrency (reliability.py:872) — غلاف لـ asyncio.Semaphore يحدّ من عمليات الإرسال المتوازية (الافتراضي 5).
Breaker (circuit) — قاطع الدائرة
CircuitBreaker (reliability.py:238) — عازل إخفاقات ثلاثي الحالات (CLOSED/OPEN/HALF_OPEN). تسمح حالة نصف المفتوحة بتجربة واحدة بالضبط (probe) (_probe_in_flight).
Bus (message) — ناقل الرسائل
المفرد (singleton) (get_message_bus()، bus.py:282) الذي يوجّه طلبات موافقة HITL الخاصة بالسرب إلى مُكيّف ناقل المنصة النشط.
Checkpointer — حافظ نقاط التفتيش
طبقة استمرارية LangGraph (AsyncSqliteSaver على kazma-data/checkpoints.db) التي تخزّن حالة المحادثة ووقفات HITL.
CheckpointManager — مدير نقاط التفتيش
swarm/checkpoint_manager.py — يملك حالة خط المعالجة الموقوف، يفعّل مهلات الرفض التلقائي، يحفظ إلى SQLite، ويستعيد عند إعادة التشغيل.
Classify (MCP tool) — تصنيف (أداة MCP)
classify_mcp_tool() (mcp/manager.py:71) — يصنّف أداة MCP مكتشفة وقت التشغيل كـ danger/safe/unknown حسب نمط الاسم. المجهول يُعدّ خطرًا افتراضيًا.
Code-switch token — رمز تبديل الشفرة
تسلسل إنجليزي/لاتيني مضمَّن داخل نص عربي، يُوسَم CODE_SWITCH بواسطة المُرمِّزين المزدوجين ليُحفَظ بدلًا من نقحرته أو تجذيعه.
CommandConsole — وحدة الأوامر
شريط أوامر بأسلوب vim في TUI يُفعَّل بـ : (أدخل أوامر ex مثل :theme، :lang).
Compaction — الضغط
CompactionEngine (compaction.py) — يُلخّص المحادثة عندما تقترب من نافذة السياق. في الربط الافتراضي، تعمل خطوة تلخيص LLM فقط (استرجاع الذاكرة + نقاط التفتيش no-ops).
ConfigStore — مخزن الإعدادات
مخزن إعدادات زمن التشغيل المدعوم بـ SQLite (config_store.py) الذي يتجاوز kazma.yaml. مفرد عبر get_config_store(). WAL + busy_timeout=5000.
CONSULT — الاستشارة نمط سرب: جمع آراء متوازية من عدة عمّال، ثم توليف عبر LLM.
ContextAuthority انظر Authority.
CostCircuitBreaker — قاطع التكلفة
cost_breaker.py — ينفصل عندما يتجاوز الإنفاق سقفًا (الافتراضي $0.50) بعد نافذة صمت (الافتراضي 5 دقائق). غير مربوط تلقائيًا في chat().
Danger tool — أداة الخطر أداة تتطلّب موافقة HITL قبل التنفيذ. هناك ثلاث قوائم (graph/swarm/MCP) — انظر الأمان والسلامة.
Delegation — التفويض أُزيل. تسليم مهام بين الوكلاء بسلامة تشفيرية (Ed25519 / AES-GCM) لم يوصَل قط؛ وحُذف كوده المؤرشف في 2026-07-28. العمل متعدد العمّال يستخدم تسليمات SwarmEngine، ولا شيء يوقّعه أو يشفّره.
DISPATCH — الإرسال نمط سرب: عامل واحد يعالج مهمة.
Document Intelligence — ذكاء المستندات
منصة مستندات دائمة تحت kazma_core/documents/: حجر صحي → استنشاق → تحليل/OCR معزول → فهرسة/توليد/تنقيح اختيارية. الحدّ الدائم العلني هو DocumentIngestionService؛ أما التنفيذ فهو DocumentService. الواجهات: ويب /documents، و/api/documents/*، وأدوات document-platform، وبوابة /documents، وتبويب المستندات في TUI. انظر ذكاء المستندات.
DocumentIR التمثيل الوسيط القياسي غير القابل للتغيير لمستند مُحلَّل (صفحات، كتل، تجزئات) يُخزَّن كـ manifest لكل إصدار — القراءات المُصفَّحة لا تعيد تحليل بايتات عدائية.
DocumentJobState
تعداد دورة حياة مهمة دائمة: received → quarantined → validating → ready_to_parse / ocr_required → parsing / ocr_running → … → ready (إضافةً إلى retry_wait وrejected وcancelled وdead_letter).
Document worker profile — ملف تعريف عامل المستندات
المكان الذي تُحلَّل فيه المستندات غير الموثوقة وتُحرَّر وتُعرَض
(KAZMA_DOCUMENT_WORKER_ISOLATION). process (الافتراضي): عملية فرعية ببيئة
منظَّفة وحدود للذاكرة والمعالج، بلا حصر لنظام الملفات ولا للشبكة — ويُبلَّغ عنه
بأنه غير مؤهَّل للمستندات العدائية. container: وسيط مستندات يشغّل كل مهمة في
حاوية جديدة موثَّقة بلا شبكة ولا وحدات تخزين موصولة؛ ولا رجوع إلى process.
Dormant gate — بوابة خامدة
بوابة HITL غير نشطة لأن hitl_config لم يُمرَّر عند بناء الرسم (كل الأدوات تذهب إلى safe_tools).
FAN_OUT — التوزيع المتعدّد نمط سرب: تنفيذ متوازٍ عبر العمّال بتوازٍ محدود، ثم تجميع.
Fallback chain — سلسلة الاحتياط
احتياطات تسلسلية للعمّال بعد فشل الأساسي (reliability.py:734).
Handoff — التسليم
نقل عامل لمهمة إلى عامل آخر أثناء التنفيذ. محدود بعمق 5 وزيارتين لكل عامل (handoff_guards.py).
HITL Human-in-the-Loop (الإنسان في الحلقة). لدى كاظمه ثلاث بوابات HITL مستقلة: مقاطعة الرسم (الدردشة)، ناقل السرب (الإرسال)، نقاط تفتيش خط المعالجة.
Hub — المحور
سجل/سوق المهارات (kazma_core/hub/) مع التوقيع والشهادة والبحث (kazma hub …).
i18n — التدويل
نظام ترجمة EN/AR في kazma-ui/kazma_ui/i18n/: وحدة فهرس لكل قسم من الواجهة، تُدمج عند الاستيراد (بلا ملفات لغة منفصلة). يضبط dir/lang لكل طلب.
interrupt()
أولية تعليق LangGraph، تُستدعى في tool_worker_node لأدوات الخطر. تُستأنف عبر Command(resume=...).
InProcessWorker
تنفيذ العامل لنوعي in_process وtelegram_bot (worker_factory.py:17).
LSP (IDE)
ذكاء لغوي نطاقه مساحة العمل على /ide (kazma_core/ide/lsp.py). إظهار عند التمرير (hover)، وإكمال، وانتقال إلى التعريف، ومخطط تفصيلي (outline)، وتشخيصات صياغة Python/JSON عبر POST /api/ide/lsp. يستخدم فهرس الكود؛ وليس daemon لـ pylsp. مفتاح الإيقاف: KAZMA_IDE_LSP=0.
Majlis — المجلس
بروتوكول المحادثة الثقافي الخليجي (majlis.py) — 4 مراحل: GREETING → SOCIAL → TRANSACTION → FAREWELL. وحدة جوهرية، لا مفتاح واجهة.
MCP Model Context Protocol. خوادم أدوات خارجية (stdio أو SSE) تُمرَّر إلى الوكيل. SSE يدعم مصادقة bearer؛ stdio لا يدعمها.
ModelRegistry — سجل النماذج
المفرد على مستوى العملية (model_registry.py:81) الذي يدير المزوّدين والنماذج والاكتشاف والاختيار النشط. الاسم البديل: UnifiedModelRegistry.
OutputValidator — مدقّق المخرجات
reliability.py:488 — يتحقّق من مخرج العامل مقابل نموذج Pydantic، أو JSON Schema، أو dict أنواع بسيط.
Phonebook — دليل الأسماء
swarm/phonebook.py — استدعاء وإرسال مباشر يتجاوز طبقة الموثوقية؛ يُستخدم بواسطة منفّذي الطوبولوجيا/DAG. يحقن ذاكرة حلقية من مسار استدعاء V2.
PermissionLevel — مستوى الصلاحية
طبقة وصول أدوات السرب: READ_ONLY، SYSTEM_EXEC، FULL_ACCESS. تُعيَّن لكل دور عامل.
Pipeline — خط المعالجة نمط سرب: مراحل مرتّبة تتشارك لوحة مشتركة، مع نقاط تفتيش HITL اختيارية.
Platform isolation — عزل المنصة
الثابت أن chat_id/user_id/message_id وغيرها لا تدخل أبدًا حالة الرسم — تعيش في SessionStore وتُعاد ربطها عند الرد عبر _build_target_id().
RRF
Reciprocal Rank Fusion — خوارزمية مزج الترتيب. كان UnifiedMemoryAdapter (V1) يستخدمها لدمج طبقاته الأربع (_RRF_K = 60)؛ أُزيل ذلك المكدّس في التحوّل من V1 إلى V2. استرجاع ذاكرة V2 لا يرتّب حسب الموقع منذ 2026-09-26: كل مرشَّح يُقيَّم على أساس دليله (recall._rank_by_evidence)، ويفشل اختبارٌ إن عاد مزج الترتيب. ولا يزال البحث الهجين للمكتبة المعرفية يدمج نتائجه الكلمات المفتاحية والمعنوية بـ RRF.
ReliabilityRegistry — سجل الموثوقية
swarm/reliability_registry.py — حامل إعدادات لقواطع العمّال، وإعادة المحاولة، والمهلات، والمدقّقين، والتوازي. آلات الحالة تعيش في reliability.py.
RetryPolicy — سياسة إعادة المحاولة
reliability.py:66 — تراجع أسي (الافتراضي 3 محاولات، 1–60 ث). لا يعيد محاولة 4xx.
SafetyMiddleware — وسيط السلامة
swarm/safety.py:47 — بوابة HITL لناقل السرب. check_sync() مغلق عند الفشل (fail-closed). (لا يوجد صنف باسم SafetyGate/SafetyChecker.)
SessionStore — مخزن الجلسات
تعيين معرّف المنصة ↔ thread_id (gateway.py:185). SQLite أو في الذاكرة. لا يحمل أبدًا حالة الرسم.
Skill — المهارة
نقطة دخول Python معبّأة وقابلة للتوقيع اختياريًا + manifest يسجّل أداة أو أكثر. تُحمَّل من kazma-skills/manifests/ أو الـ Hub.
Strict tools — الأدوات الصارمة
OpenAI Structured Outputs لاستدعاء الدوال (function.strict: true، كل خاصية مطلوبة، والاختيارية بصيغة T | null). تولّد كاظمه دومًا مخططات مغلقة (additionalProperties: false)؛ أما شارة strict فتُفعَّل اختياريًا عبر KAZMA_STRICT_TOOLS=1.
Structured outputs — المخرجات المهيكلة
JSON مفروض من المزوّد لردّ ليس استدعاء أداة (response_format بقيم json_schema / json_object على LLMProvider.chat). المتصلون يفعّلونه اختياريًا؛ حلقة ReAct للمُشرف لا تُرفقه في كل دور.
Plan mode — وضع التخطيط
فحص ثم اقتراح لكل خيط (/plan on). تُجرَّد أدوات الكتابة/التنفيذ عبر hard_constraints بقيمة read_only. ينفّذ /plan go أو زر Proceed الخطة؛ وHITL يبقى ساريًا. مفتاح الإيقاف: KAZMA_PLAN_MODE=0.
pgvector
امتداد Postgres للبحث المتّجهي. عندما تكون لكاظمه أصلًا DSN لـ Postgres، يختار استرجاع V2 الكثيف pgvector تلقائيًا (الجدول kazma_memory، cosine / HNSW) — إن كان ذلك الخادم يأتي بالامتداد؛ وإلا بقي على sqlite-vec وذكر السبب في الإعدادات ← الذاكرة. ويبقى sqlite-vec الافتراضي للعقدة الواحدة. مفتاح الإيقاف: KAZMA_PGVECTOR=0.
sqlite-vec
امتداد SQLite للبحث المتّجهي. في V2 يدعم memory/vector_engine.py (sqlite-vec أصلي مع احتياطي NumPy محروس) لاسترجاع المتجهات الكثيفة للحلقات على عقدة واحدة. مُعلَن في الإضافة الاختيارية [rag] (sqlite-vec>=0.1.6).
SwarmEngine — محرك السرب
swarm/engine.py:103 — المنسّق async المركزي لعمّال السرب.
TaskType — نوع المهمة
تعداد أنماط السرب: DISPATCH، BROADCAST، PIPELINE، FAN_OUT، CONSULT، CONDITIONAL.
TimeoutGuard — حارس المهلة
reliability.py:397 — مهلة لكل مهمة (الافتراضي 300 ث) بسلوك fail/retry/skip.
Tool hooks — خطّافات الأدوات
استدعاءات راجعة PreToolUse / PostToolUse (agent/tool_hooks.py). ترفض الأداة أو تعيد كتابتها قبل تشغيلها، أو تُلحق ملاحظة بعدها. ليست بديلًا عن HITL — لا يمكنها الموافقة تلقائيًا على أدوات الخطر. مفتاح الإيقاف: KAZMA_TOOL_HOOKS=0.
ToolRegistry — سجل الأدوات
agent/tool_registry.py — السجل الذي يستشيره المُشرف كل دورة. execute() هو مسار التنفيذ الوحيد وبوابة HITL لناقل السرب.
TUI
لوحة Textual الطرفية (kazma-tui)، مستهلك قراءة غالبًا للمفردات الجوهرية.
UnifiedMemoryAdapter — مُكيّف الذاكرة الموحّد
أُزيل في التحوّل من V1 إلى V2. مازج الذاكرة السابق رباعي الطبقات (swarm/memory/adapter.py): ChromaDB + رسم خصائص SQLite + FTS5 + sqlite-vec، مدموج بـ RRF. حلّ محلّه محرك V2 المعرفي — انظر محرك V2 المعرفي.
UnifiedRouter — الموجِّه الموحّد
محرك التوجيه التلقائي لإرسال السرب بـ workers=["auto"].
محرك V2 المعرفي (V2 Cognitive Engine) — مكدّس الذاكرة الوحيد لكاظمه
(kazma-core/kazma_core/memory/). رسم معتردات ثنائي الزمن (مسندات وظيفية/مجموعات/حالة بمحوري valid_from/valid_until + ingested_at/invalidated_at)، حلقات من 4 طبقات، استرجاع Personalized PageRank بمخطط الأنانية المحلي، DAG المهارات الإجرائية، وطابور توحيد دائم بـ SQLite. مسار القراءة الموحّد: recall() في memory/recall.py؛ مسار الكتابة: mutate_belief() في memory/belief_mutation.py. نشط افتراضيًا (memory.v2.use_new_stack: true). حلّ محلّ مكدّس RRF الرباعي الطبقات (V1).
VectorMemory — الذاكرة المتّجهية
أُزيل في التحوّل من V1 إلى V2. مفرد الذاكرة السابق المدعوم بـ ChromaDB (memory/vector_store.py) للإقلاع / الصحة / احتياط الأدوات. تستخدم V2 memory/vector_engine.py (sqlite-vec أصلي + احتياطي NumPy محروس) بدلًا منه.
Consolidator — الموحِّد
أمين مكتبة ما بعد الدورة (memory/consolidator.py): يستخرج حقائق دائمة + ثلاثيات SPO (LLM + استدلال)، مسيَّج بالتعليمات، مزال التكرار مقابل auto_store، يكتب إلى المُكيّف ورسم L2.
Kazma (كاظمه)
اسم المنتج باللاتينية هو Kazma. صيغ العلامة العربية الصحيحة كاظمه (المفضّلة) وكاظمة. الإملاء كازما (بحرف ز) خطأ ويجب عدم استخدامه. معرفة المنتج الذاتية تُحقَن عبر kazma_core.product_knowledge في موجه نظام المُشرف.
Web research tools — أدوات البحث على الويب
حزمة بحث/استخراج/بحث مدمجة: web_search، read_url (تصفّح صفحات)، read_url_to_file، crawl_site (متعدّد الصفحات محدود)، ومساعدات التقطيع/التلخيص. تُستخدم من الدردشة (بلا slash /research). الدليل: البحث على الويب.
Worker — العامل
وحدة تنفيذ السرب (SwarmWorker). مسجَّلة في _workers؛ تُحَل عبر السجل أو دليل الأسماء.
WorkerCapabilities — قدرات العامل
كائن \{role, expertise, tools, model_specialty\} يصف ما يستطيع العامل فعله؛ يستخدمه UnifiedRouter وAutoScaler لمطابقة المهام بالعمّال.
WorkerRegistry — سجل العمّال
سجل عمّال مدعوم بـ JSON (swarm/registry.py)، محفوظ في <data dir>/swarm_registry.json.