cc-viewer 1.6.182 → 1.6.183

package/concepts/ar/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## التعريف
+يُسلِّم رسالة من عضو فريق إلى آخر داخل فريق نشط، أو يبث إلى جميع أعضاء الفريق في آن واحد. هذه هي القناة الوحيدة التي يسمعها زملاء الفريق — أي شيء يُكتب في الإخراج النصي العادي يكون غير مرئي لهم.
 
-يُرسل رسائل بين الـ agent داخل الفريق. يُستخدم للتواصل المباشر والبث والرسائل البروتوكولية (طلبات/ردود الإيقاف، الموافقة على الخطط).
+## متى يُستخدم
+
+- تعيين مهمة أو تسليم مشكلة فرعية إلى زميل فريق مُسمَّى أثناء التعاون الجماعي.
+- طلب حالة أو نتائج وسيطة أو مراجعة شفرة من وكيل آخر.
+- بث قرار أو قيد مشترك أو إعلان إيقاف تشغيل للفريق بالكامل عبر `*`.
+- الرد على مطالبة بروتوكول مثل طلب إيقاف تشغيل أو طلب اعتماد خطة من قائد الفريق.
+- إغلاق الحلقة في نهاية مهمة مفوَّضة حتى يتمكن القائد من وضع علامة على البند بالاكتمال.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `to` | string | نعم | المُستلم: اسم العضو، أو `"*"` للبث إلى الجميع |
-| `message` | string / object | نعم | رسالة نصية أو كائن بروتوكولي مُهيكل |
-| `summary` | string | لا | معاينة من 5-10 كلمات تُعرض في الواجهة |
+- `to` (سلسلة، مطلوب): `name` زميل الفريق المستهدف كما هو مسجَّل في الفريق، أو `*` للبث إلى جميع زملاء الفريق دفعة واحدة.
+- `message` (سلسلة أو كائن، مطلوب): نص عادي للتواصل الطبيعي، أو كائن مُنظَّم لردود البروتوكول مثل `shutdown_response` و`plan_approval_response`.
+- `summary` (سلسلة، اختياري): معاينة من 5 إلى 10 كلمات تُعرض في سجل نشاط الفريق للرسائل النصية. مطلوبة للرسائل النصية الطويلة؛ تُتجاهل عندما يكون `message` كائن بروتوكول.
+
+## أمثلة
+
+### مثال 1: تسليم مهمة مباشر
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## أنواع الرسائل
+### مثال 2: بث قيد مشترك
 
-### نص عادي
-رسائل مباشرة بين أعضاء الفريق للتنسيق وتحديثات الحالة ومناقشات المهام.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### طلب إيقاف
-يطلب من عضو الإيقاف بشكل منظم: `{ type: "shutdown_request", reason: "..." }`
+### مثال 3: رد بروتوكول
 
-### رد الإيقاف
-يوافق العضو على الإيقاف أو يرفضه: `{ type: "shutdown_response", approve: true/false }`
+الرد على طلب إيقاف تشغيل من القائد باستخدام رسالة منظمة:
 
-### رد الموافقة على الخطة
-يوافق على خطة عضو أو يرفضها: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## البث مقابل الإرسال المباشر
+### مثال 4: رد اعتماد خطة
 
-- **مباشر** (`to: "اسم-العضو"`): إرسال إلى عضو محدد — الأفضل لمعظم حالات التواصل
-- **بث** (`to: "*"`): إرسال إلى جميع الأعضاء — يُستخدم باعتدال، فقط للإعلانات العاجلة على مستوى الفريق
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## الأدوات ذات الصلة
+## ملاحظات
 
-| الأداة | الغرض |
-|--------|--------|
-| `TeamCreate` | إنشاء فريق جديد |
-| `TeamDelete` | حذف الفريق عند الانتهاء |
-| `Agent` | توليد أعضاء ينضمون إلى الفريق |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | إدارة قائمة المهام المشتركة |
+- إخراج نص المساعد المعتاد لا يُنقل إلى زملاء الفريق. إذا أردت أن يرى وكيل آخر شيئاً، فيجب أن يمر عبر `SendMessage`. هذا أكثر الأخطاء شيوعاً في سير عمل الفرق.
+- البث (`to: "*"`) مكلف — يوقظ كل زميل فريق ويستهلك سياقه. احتفظ به للإعلانات التي تؤثر فعلاً في الجميع. فضِّل الإرسالات المُستهدَفة.
+- أبقِ الرسائل موجزة وموجهة للفعل. أدرج مسارات الملفات والقيود وصيغة الرد المتوقعة التي يحتاجها المستلم؛ تذكر أنه لا ذاكرة مشتركة بينكما.
+- لكائنات رسائل البروتوكول (`shutdown_response`، `plan_approval_response`) أشكال ثابتة. لا تمزج حقول البروتوكول في رسائل نصية أو العكس.
+- الرسائل غير متزامنة. سيستلم المستلم رسالتك في دوره التالي؛ لا تفترض أنه قرأها أو تصرف بناء عليها قبل أن يرد.
+- `summary` جيد الكتابة يجعل سجل نشاط الفريق قابلاً للتصفح للقائد — تعامل معه كسطر موضوع الالتزام.

package/concepts/ar/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## التعريف
+يستدعي مهارة مُسمَّاة داخل المحادثة الحالية. المهارات حزم قدرات معبأة مسبقاً — معرفة مجال، وسير عمل، وأحياناً وصول إلى أدوات — يعرضها الإطار للمساعد عبر تذكيرات النظام.
 
-تنفيذ مهارة (skill) في المحادثة الرئيسية. المهارات هي قدرات متخصصة يمكن للمستخدم استدعاؤها عبر أوامر slash (مثل `/commit`، `/review-pr`).
+## متى يُستخدم
 
-## المعاملات
+- عندما يكتب المستخدم أمر شرطة مائلة مثل `/review` أو `/init` — أوامر الشرطة المائلة هي مهارات ويجب تنفيذها عبر هذه الأداة.
+- عندما يصف المستخدم مهمة تطابق شروط تفعيل مهارة مُعلَنة (مثلاً طلب مسح النصوص بحثاً عن مطالبات إذن متكررة يطابق `fewer-permission-prompts`).
+- عندما يتطابق الغرض المُعلَن لمهارة مع الملف أو الطلب أو سياق المحادثة الحالية.
+- عندما تكون سير عمل متخصصة وقابلة للتكرار متوفرة كمهارات ويكون الإجراء القانوني مفضلاً على نهج مخصص.
+- عندما يسأل المستخدم «ما المهارات المتاحة» — اسرد الأسماء المُعلَنة، ولا تستدعِها إلا بعد تأكيدهم.
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `skill` | string | نعم | اسم المهارة (مثل "commit"، "review-pr"، "pdf") |
-| `args` | string | لا | معاملات المهارة |
+## المعاملات
 
-## سيناريوهات الاستخدام
+- `skill` (سلسلة، مطلوب): الاسم المضبوط لمهارة مُدرجة في تذكير النظام الحالي للمهارات المتاحة. للمهارات ذات مساحة اسم المكوِّن الإضافي، استخدم الصيغة المؤهلة بالكامل `plugin:skill` (مثل `skill-creator:skill-creator`). لا تُضمِّن شرطة مائلة في البداية.
+- `args` (سلسلة، اختياري): وسيطات نصية حرة تُمرر إلى المهارة. الصيغة والدلالات تحددها وثائق كل مهارة.
 
-**مناسب للاستخدام:**
-- أدخل المستخدم أمر slash بتنسيق `/<skill-name>`
-- طلب المستخدم يتطابق مع وظيفة مهارة مسجلة
+## أمثلة
 
-**غير مناسب للاستخدام:**
-- أوامر CLI المدمجة (مثل `/help`، `/clear`)
-- مهارة قيد التشغيل بالفعل
-- اسم مهارة غير موجود في قائمة المهارات المتاحة
+### مثال 1: تشغيل مهارة مراجعة على الفرع الحالي
 
-## ملاحظات
+```
+Skill(skill="review")
+```
 
-- بعد استدعاء المهارة تتوسع إلى prompt كامل
-- يدعم الأسماء المؤهلة بالكامل (مثل `ms-office-suite:pdf`)
-- قائمة المهارات المتاحة تُقدم في رسائل system-reminder
-- عند رؤية وسم `<command-name>` فهذا يعني أن المهارة محملة بالفعل، يجب التنفيذ مباشرة بدلاً من استدعاء هذه الأداة مرة أخرى
-- لا تذكر مهارة دون استدعاء الأداة فعلياً
+تُعبئ مهارة `review` خطوات مراجعة pull request مقابل الفرع الأساسي الحالي. استدعاؤها يُحمِّل إجراء المراجعة المُعرَّف من الإطار في الدور.
 
-## النص الأصلي
+### مثال 2: استدعاء مهارة ذات مساحة اسم مكوِّن إضافي بوسيطات
 
-<textarea readonly>Execute a skill within the main conversation
+```
+Skill(
+  skill="skill-creator:skill-creator",
+  args="create a skill that summarizes git log for a given date range"
+)
+```
 
-When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+يوجه الطلب عبر نقطة دخول المكوِّن الإضافي `skill-creator` حتى يبدأ سير عمل التأليف.
 
-When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
-
-How to invoke:
-- Use this tool with the skill name and optional arguments
-- Examples:
-  - `skill: "pdf"` - invoke the pdf skill
-  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
-  - `skill: "review-pr", args: "123"` - invoke with arguments
-  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+## ملاحظات
 
-Important:
-- Available skills are listed in system-reminder messages in the conversation
-- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
-- NEVER mention a skill without actually calling this tool
-- Do not invoke a skill that is already running
-- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
-</textarea>
+- استدعِ فقط المهارات التي تظهر أسماؤها حرفياً في تذكير النظام للمهارات المتاحة، أو المهارات التي كتبها المستخدم مباشرة كـ `/name` في رسالته. لا تُخمِّن أو تخترع أسماء مهارات من الذاكرة أو بيانات التدريب — إذا لم تكن المهارة مُعلَنة، فلا تستدعِ هذه الأداة.
+- عندما يتطابق طلب المستخدم مع مهارة مُعلَنة، يكون استدعاء `Skill` شرطاً مسبقاً حاجباً: استدعِه قبل توليد أي رد آخر حول المهمة. لا تصف ما ستفعله المهارة — شغِّلها.
+- لا تذكر مهارة بالاسم أبداً دون استدعائها فعلياً. الإعلان عن مهارة دون استدعاء الأداة مضلِّل.
+- لا تستخدم `Skill` لأوامر CLI المدمجة مثل `/help` أو `/clear` أو `/model` أو `/exit`. تلك يعالجها الإطار مباشرة.
+- لا تُعد استدعاء مهارة تعمل بالفعل في الدور الحالي. إذا رأيت وسماً `<command-name>` في الدور الحالي، فالمهارة مُحمَّلة بالفعل — اتبع تعليماتها في مكانها بدلاً من استدعاء الأداة مرة أخرى.
+- إذا كان بإمكان عدة مهارات أن تنطبق، فاختر الأكثر تخصصاً. لتغييرات الإعدادات مثل إضافة أذونات أو خطافات، فضِّل `update-config` على نهج إعدادات عام.
+- قد يُدخل تنفيذ المهارة تذكيرات نظام أو أدوات أو قيوداً جديدة لبقية الدور. أعد قراءة حالة المحادثة بعد اكتمال المهارة قبل المتابعة.

package/concepts/ar/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## التعريف
+يُنشئ مهمة جديدة في قائمة مهام الفريق الحالي (أو قائمة مهام الجلسة عندما لا يكون هناك فريق نشط). استخدمه لالتقاط بنود العمل التي ينبغي تعقبها أو تفويضها أو مراجعتها لاحقاً.
 
-إنشاء عناصر قائمة مهام منظمة، لتتبع التقدم وتنظيم المهام المعقدة وعرض تقدم العمل للمستخدم.
+## متى يُستخدم
 
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `subject` | string | نعم | عنوان مختصر للمهمة، بصيغة الأمر (مثل "Fix authentication bug") |
-| `description` | string | نعم | وصف تفصيلي يتضمن السياق ومعايير القبول |
-| `activeForm` | string | لا | نص بصيغة المضارع المستمر يُعرض أثناء التنفيذ (مثل "Fixing authentication bug") |
-| `metadata` | object | لا | بيانات وصفية عشوائية مرفقة بالمهمة |
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- المهام المعقدة متعددة الخطوات (أكثر من 3 خطوات)
-- المستخدم قدم عدة عناصر مهام
-- تتبع العمل في وضع التخطيط
-- المستخدم طلب صراحة استخدام قائمة المهام
-
-**غير مناسب للاستخدام:**
-- مهمة واحدة بسيطة
-- عمليات بسيطة من 3 خطوات أو أقل
-- محادثة بحتة أو استعلام معلومات
+- عندما يصف المستخدم قطعة عمل متعددة الخطوات تستفيد من التعقب الصريح.
+- عندما تُقسم طلباً كبيراً إلى وحدات أصغر قابلة للإكمال بشكل منفصل.
+- عندما يُكتشف بند متابعة في منتصف مهمة ويجب ألا يُنسى.
+- عندما تحتاج إلى سجل دائم للنية قبل تسليم العمل إلى زميل فريق أو وكيل فرعي.
+- عندما تعمل في وضع التخطيط وتريد تمثيل كل خطوة من الخطة بمهمة ملموسة.
 
-## ملاحظات
-
-- جميع المهام الجديدة تبدأ بحالة `pending`
-- `subject` بصيغة الأمر ("Run tests")، `activeForm` بصيغة المضارع المستمر ("Running tests")
-- بعد إنشاء المهمة يمكن تعيين التبعيات (blocks/blockedBy) عبر TaskUpdate
-- قبل الإنشاء يجب استدعاء TaskList للتحقق من عدم وجود مهام مكررة
-
-## النص الأصلي
+تخطَّ `TaskCreate` للإجراءات التافهة ذات اللقطة الواحدة، أو للمحادثة الصرفة، أو لأي شيء يمكن إكماله في استدعاءي أدوات أو ثلاثة مباشرة.
 
-<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
-It also helps the user understand the progress of the task and overall progress of their requests.
+## المعاملات
 
-## When to Use This Tool
+- `subject` (سلسلة، مطلوب): عنوان أمري قصير، مثل `Fix login redirect on Safari`. احتفظ به تحت ثمانين حرفاً تقريباً.
+- `description` (سلسلة، مطلوب): سياق مفصَّل — المشكلة والقيود ومعايير القبول وأي ملفات أو روابط سيحتاجها القارئ المستقبلي. اكتب كأن زميل فريق سيتسلمها بدون سياق.
+- `activeForm` (سلسلة، اختياري): نص دوَّار في صيغة المضارع المستمر يُعرض بينما المهمة `in_progress`، مثل `Fixing login redirect on Safari`. يعكس `subject` لكن بصيغة -ing.
+- `metadata` (كائن، اختياري): بيانات مُنظَّمة عشوائية مُرفقة بالمهمة. الاستخدامات الشائعة: تسميات، تلميحات أولوية، معرفات تذاكر خارجية، أو إعدادات خاصة بوكيل.
 
-Use this tool proactively in these scenarios:
+المهام المُنشأة حديثاً تبدأ دائماً بحالة `pending` وبلا مالك. التبعيات (`blocks`، `blockedBy`) لا تُضبط وقت الإنشاء — طبقها لاحقاً بـ `TaskUpdate`.
 
-- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-- Plan mode - When using plan mode, create a task list to track the work
-- User explicitly requests todo list - When the user directly asks you to use the todo list
-- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
-- After receiving new instructions - Immediately capture user requirements as tasks
-- When you start working on a task - Mark it as in_progress BEFORE beginning work
-- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+## أمثلة
 
-## When NOT to Use This Tool
+### مثال 1
 
-Skip using this tool when:
-- There is only a single, straightforward task
-- The task is trivial and tracking it provides no organizational benefit
-- The task can be completed in less than 3 trivial steps
-- The task is purely conversational or informational
+التقط تقرير خطأ قدَّمه المستخدم لتوه.
 
-NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+```
+TaskCreate(
+  subject: "Repair broken PDF export on Windows",
+  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
+  activeForm: "Repairing broken PDF export on Windows"
+)
+```
 
-## Task Fields
+### مثال 2
 
-- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
-- **description**: Detailed description of what needs to be done, including context and acceptance criteria
-- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+قسِّم ملحمة إلى وحدات متعقَّبة عند بداية الجلسة.
 
-**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+```
+TaskCreate(
+  subject: "Draft migration plan for auth service",
+  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
+  activeForm: "Drafting migration plan for auth service",
+  metadata: { "priority": "P1", "linearId": "AUTH-214" }
+)
+```
 
-## Tips
+## ملاحظات
 
-- Create tasks with clear, specific subjects that describe the outcome
-- Include enough detail in the description for another agent to understand and complete the task
-- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
-- Check TaskList first to avoid creating duplicate tasks
-</textarea>
+- اكتب `subject` بصيغة الأمر و`activeForm` بصيغة المضارع المستمر حتى تُقرأ الواجهة طبيعياً عند انتقال المهمة إلى `in_progress`.
+- استدعِ `TaskList` قبل الإنشاء لتجنب التكرارات — قائمة الفريق مشتركة مع زملاء الفريق والوكلاء الفرعيين.
+- لا تُضمِّن أسراراً أو بيانات اعتماد في `description` أو `metadata`؛ سجلات المهام مرئية لكل من يملك الوصول إلى الفريق.
+- بعد الإنشاء، حرِّك المهمة عبر دورة حياتها بـ `TaskUpdate`. لا تترك العمل مهجوراً بصمت في `in_progress`.

package/concepts/ar/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## التعريف
+يجلب السجل الكامل لمهمة واحدة بالمعرف، بما في ذلك وصفها وحالتها الحالية ومالكها وبياناتها الوصفية وحواف تبعياتها. استخدمه عندما لا يكون الملخص الذي يُعيده `TaskList` كافياً للتصرف بناءً على المهمة.
 
-الحصول على التفاصيل الكاملة للمهمة عبر معرف المهمة.
+## متى يُستخدم
 
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `taskId` | string | نعم | معرف المهمة المراد الحصول عليها |
-
-## المحتوى المُرجع
+- عندما تلتقط مهمة من `TaskList` وتحتاج إلى الوصف الكامل قبل البدء في العمل.
+- عندما توشك على وسم مهمة بـ `completed` وتريد إعادة فحص معايير القبول.
+- عندما تحتاج إلى فحص ما تحجبه هذه المهمة (`blocks`) أو ما يحجبها (`blockedBy`) لتقرير الخطوة التالية.
+- عندما تُحقق في التاريخ — من يملكها، وما البيانات الوصفية المُرفقة، ومتى تغيرت حالتها.
+- عندما يشير زميل فريق أو جلسة سابقة إلى معرف مهمة وتحتاج إلى السياق.
 
-- `subject` — عنوان المهمة
-- `description` — المتطلبات التفصيلية والسياق
-- `status` — الحالة: `pending`، `in_progress` أو `completed`
-- `blocks` — قائمة المهام المحظورة بواسطة هذه المهمة
-- `blockedBy` — قائمة المهام السابقة التي تحظر هذه المهمة
+فضِّل `TaskList` عندما تحتاج فقط إلى مسح عالي المستوى؛ واحجز `TaskGet` للسجل المحدد الذي تعتزم قراءته بعناية أو تعديله.
 
-## سيناريوهات الاستخدام
+## المعاملات
 
-**مناسب للاستخدام:**
-- الحصول على الوصف الكامل والسياق قبل بدء العمل
-- فهم علاقات التبعية للمهمة
-- الحصول على المتطلبات الكاملة بعد تعيين المهمة
+- `taskId` (سلسلة، مطلوب): معرف المهمة المُعاد من `TaskCreate` أو `TaskList`. المعرفات ثابتة طوال عمر المهمة.
 
-## ملاحظات
+## أمثلة
 
-- بعد الحصول على المهمة يجب التحقق من أن قائمة `blockedBy` فارغة قبل بدء العمل
-- استخدم TaskList لعرض معلومات ملخصة لجميع المهام
+### مثال 1
 
-## النص الأصلي
+ابحث عن مهمة رأيتها للتو في القائمة.
 
-<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+```
+TaskGet(taskId: "t_01HXYZ...")
+```
 
-## When to Use This Tool
+الحقول النموذجية في الاستجابة: `id`، `subject`، `description`، `activeForm`، `status`، `owner`، `blocks`، `blockedBy`، `metadata`، `createdAt`، `updatedAt`.
 
-- When you need the full description and context before starting work on a task
-- To understand task dependencies (what it blocks, what blocks it)
-- After being assigned a task, to get complete requirements
+### مثال 2
 
-## Output
+حل التبعيات قبل البدء.
 
-Returns full task details:
-- **subject**: Task title
-- **description**: Detailed requirements and context
-- **status**: 'pending', 'in_progress', or 'completed'
-- **blocks**: Tasks waiting on this one to complete
-- **blockedBy**: Tasks that must complete before this one can start
+```
+TaskGet(taskId: "t_01HXYZ...")
+# Inspect blockedBy — if any referenced task is still pending
+# or in_progress, work on the blocker first.
+```
 
-## Tips
+## ملاحظات
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` للقراءة فقط وآمن للاستدعاء المتكرر؛ فهو لا يغير الحالة أو الملكية.
+- إذا كان `blockedBy` غير فارغ ويحتوي على مهام غير `completed`، فلا تبدأ هذه المهمة — احل العوائق أولاً (أو نسق مع مالكها).
+- قد يكون حقل `description` طويلاً. اقرأه بالكامل قبل التصرف؛ التصفح السطحي يؤدي إلى معايير قبول فائتة.
+- `taskId` غير معروف أو محذوف يُعيد خطأً. أعد تشغيل `TaskList` لاختيار معرف حالي.
+- إذا كنت ستُعدل مهمة، فاستدعِ `TaskGet` أولاً لتجنب الكتابة فوق حقول غيَّرها زميل فريق للتو.

package/concepts/ar/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## التعريف
+يُعيد كل مهمة في الفريق الحالي (أو الجلسة) بشكل مُلخَّص. استخدمه لاستعراض العمل المعلق وتحديد ما ستتناوله تالياً وتجنب إنشاء تكرارات.
 
-عرض جميع المهام في قائمة المهام، لمراجعة التقدم العام والأعمال المتاحة.
+## متى يُستخدم
+
+- في بداية الجلسة لرؤية ما هو متعقَّب بالفعل.
+- قبل استدعاء `TaskCreate` للتأكد من أن العمل غير مُلتقط بالفعل.
+- عند اتخاذ قرار بشأن أي مهمة تدعي كزميل فريق أو وكيل فرعي.
+- للتحقق من علاقات التبعية عبر الفريق في لمحة.
+- بشكل دوري خلال الجلسات الطويلة لإعادة المزامنة مع زملاء الفريق الذين ربما ادعوا أو أكملوا أو أضافوا مهاماً.
+
+`TaskList` للقراءة فقط ورخيص؛ استدعِه بحرية كلما احتجت إلى نظرة عامة.
 
 ## المعاملات
 
-لا توجد معاملات.
+`TaskList` لا يأخذ معاملات. يُعيد دائماً مجموعة المهام الكاملة للسياق النشط.
 
-## المحتوى المُرجع
+## شكل الاستجابة
 
-معلومات ملخصة لكل مهمة:
-- `id` — معرف المهمة
-- `subject` — وصف مختصر
-- `status` — الحالة: `pending`، `in_progress` أو `completed`
-- `owner` — المسؤول (معرف agent)، فارغ يعني غير مُعيَّن
-- `blockedBy` — قائمة معرفات المهام غير المكتملة التي تحظر هذه المهمة
+كل مهمة في القائمة ملخص لا السجل الكامل. توقع تقريباً:
 
-## سيناريوهات الاستخدام
+- `id` — معرف ثابت للاستخدام مع `TaskGet` / `TaskUpdate`.
+- `subject` — عنوان أمري قصير.
+- `status` — واحدة من `pending` أو `in_progress` أو `completed` أو `deleted`.
+- `owner` — مُعرَّف وكيل أو زميل فريق، أو فارغ عند عدم الادعاء.
+- `blockedBy` — مصفوفة معرفات المهام التي يجب إكمالها أولاً.
 
-**مناسب للاستخدام:**
-- عرض المهام المتاحة (حالة pending، بدون owner، غير محظورة)
-- فحص التقدم العام للمشروع
-- البحث عن المهام المحظورة
-- البحث عن المهمة التالية بعد إكمال مهمة
+للحصول على الوصف الكامل أو معايير القبول أو البيانات الوصفية لمهمة معينة، تابع بـ `TaskGet`.
 
-## ملاحظات
+## أمثلة
 
-- يُفضل معالجة المهام بترتيب المعرف (الأصغر أولاً)، لأن المهام المبكرة عادة توفر سياقاً للمهام اللاحقة
-- المهام التي لديها `blockedBy` لا يمكن المطالبة بها قبل رفع التبعية
-- استخدم TaskGet للحصول على التفاصيل الكاملة لمهمة محددة
+### مثال 1
 
-## النص الأصلي
+فحص حالة سريع.
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+```
+TaskList()
+```
 
-## When to Use This Tool
+امسح المخرج بحثاً عن أي شيء `in_progress` بلا `owner` (عمل راكد) وأي شيء `pending` بـ `blockedBy` فارغ (جاهز للالتقاط).
 
-- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
-- To check overall progress on the project
-- To find tasks that are blocked and need dependencies resolved
-- After completing a task, to check for newly unblocked work or claim the next available task
-- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+### مثال 2
 
-## Output
+زميل فريق يختار المهمة التالية.
 
-Returns a summary of each task:
-- **id**: Task identifier (use with TaskGet, TaskUpdate)
-- **subject**: Brief description of the task
-- **status**: 'pending', 'in_progress', or 'completed'
-- **owner**: Agent ID if assigned, empty if available
-- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+```
+TaskList()
+# Filter to: status == pending AND blockedBy is empty AND owner is empty.
+# Among those, prefer the lower ID (tasks are typically numbered in
+# creation order, so lower IDs are older and usually higher priority).
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
+
+## ملاحظات
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- إرشاد لزميل الفريق: عندما تكون عدة مهام `pending` غير محجوبة وغير ممتلكة، اختر المعرف الأدنى. هذا يُبقي العمل FIFO ويتجنب أن يلتقط وكيلان المهمة بارزة نفسها.
+- احترم `blockedBy`: لا تبدأ مهمة لا تزال عوائقها `pending` أو `in_progress`. اعمل على العائق أولاً أو نسق مع مالكه.
+- `TaskList` هو آلية الاكتشاف الوحيدة للمهام. لا يوجد بحث؛ إذا كانت القائمة طويلة، امسح بنيوياً (حسب الحالة، ثم حسب المالك).
+- قد تظل المهام المحذوفة تظهر في القائمة بحالة `deleted` للتتبع. تجاهلها لأغراض التخطيط.
+- تعكس القائمة الحالة الحية للفريق، لذا قد يُضيف زملاء الفريق أو يدعون مهاماً بين الاستدعاءات. أعد السرد قبل الادعاء إذا مر وقت.

package/concepts/ar/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## التعريف
+يجلب المخرجات المتراكمة لمهمة خلفية قيد التشغيل أو مكتملة — أمر صدفة خلفي، أو وكيل محلي، أو جلسة بعيدة. استخدمه عندما تحتاج إلى فحص ما أنتجته مهمة طويلة الأمد حتى الآن.
 
-الحصول على مخرجات المهام الخلفية قيد التشغيل أو المكتملة. ينطبق على shell الخلفية والوكلاء غير المتزامنين والجلسات البعيدة.
+## متى يُستخدم
+
+- عندما تعمل جلسة بعيدة (مثل صندوق رمل سحابي) وتحتاج إلى stdout الخاص بها.
+- عندما أُرسل وكيل محلي في الخلفية وتريد تقدماً جزئياً قبل عودته.
+- عندما يعمل أمر صدفة خلفي منذ وقت كافٍ وتريد التحقق منه دون إيقافه.
+- عندما تحتاج إلى تأكيد أن مهمة خلفية تحرز تقدماً فعلاً قبل الانتظار أطول أو استدعاء `TaskStop`.
+
+لا تلجأ إلى `TaskOutput` تلقائياً. لمعظم العمل الخلفي يوجد مسار أكثر مباشرة — انظر الملاحظات أدناه.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `task_id` | string | نعم | معرف المهمة |
-| `block` | boolean | نعم | هل ينتظر بشكل محظور حتى اكتمال المهمة، الافتراضي `true` |
-| `timeout` | number | نعم | أقصى وقت انتظار (بالمللي ثانية)، الافتراضي 30000، الحد الأقصى 600000 |
+- `task_id` (سلسلة، مطلوب): معرف المهمة المُعاد عند بدء العمل الخلفي. ليس نفس `taskId` في قائمة المهام؛ هذا هو المقبض التشغيلي للتنفيذ المحدد.
+- `block` (قيمة منطقية، اختياري): عندما تكون `true` (الافتراضي)، انتظر حتى تُنتج المهمة مخرجاً جديداً أو تنتهي قبل الإرجاع. عندما تكون `false`، أعد فوراً بكل ما تم تخزينه.
+- `timeout` (رقم، اختياري): الحد الأقصى بالمللي ثانية للحجب قبل الإرجاع. ذو معنى فقط عندما يكون `block` هو `true`. الافتراضي `30000`، والأقصى `600000`.
 
-## سيناريوهات الاستخدام
+## أمثلة
 
-**مناسب للاستخدام:**
-- فحص تقدم الوكلاء الخلفيين المُطلقين عبر Task (`run_in_background: true`)
-- الحصول على نتائج تنفيذ أوامر Bash الخلفية
-- انتظار اكتمال المهام غير المتزامنة والحصول على المخرجات
+### مثال 1
 
-**غير مناسب للاستخدام:**
-- المهام الأمامية — تُرجع النتائج مباشرة، لا حاجة لهذه الأداة
+اطلع على جلسة بعيدة دون حجب.
 
-## ملاحظات
+```
+TaskOutput(task_id: "sess_01HXYZ...", block: false)
+```
+
+يُعيد أي stdout/stderr تم إنتاجه منذ بدء المهمة (أو منذ آخر استدعاء لـ `TaskOutput`، اعتماداً على وقت التشغيل).
 
-- `block: true` يحظر حتى اكتمال المهمة أو انتهاء المهلة
-- `block: false` للفحص غير المحظور للحالة الحالية
-- يمكن العثور على معرف المهمة عبر أمر `/tasks`
-- ينطبق على جميع أنواع المهام: shell الخلفية، الوكلاء غير المتزامنين، الجلسات البعيدة
+### مثال 2
 
-## النص الأصلي
+انتظر لفترة قصيرة حتى يُصدر وكيل محلي مزيداً من المخرجات.
+
+```
+TaskOutput(
+  task_id: "agent_01ABCD...",
+  block: true,
+  timeout: 10000
+)
+```
+
+## ملاحظات
 
-<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
-- Takes a task_id parameter identifying the task
-- Returns the task output along with status information
-- Use block=true (default) to wait for task completion
-- Use block=false for non-blocking check of current status
-- Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions</textarea>
+- أوامر bash الخلفية: `TaskOutput` مُستغنًى عنه فعلياً لهذه الحالة. عند بدء مهمة صدفة خلفية، تتضمن النتيجة بالفعل مسار ملف مخرجاتها — اقرأ ذلك المسار مباشرة بأداة `Read`. تُتيح `Read` وصولاً عشوائياً وإزاحات أسطر ومنظوراً ثابتاً؛ لا تفعل `TaskOutput`.
+- الوكلاء المحليون (أداة `Agent` المرسلة في الخلفية): عندما ينتهي الوكيل، تحتوي نتيجة أداة `Agent` بالفعل على ردّه النهائي. استخدمها مباشرةً. لا تقرأ ملف النصوص المُرمَّز — فهو يحتوي على تدفق استدعاءات الأدوات الكامل وسيفيض نافذة السياق.
+- الجلسات البعيدة: `TaskOutput` هو الطريقة الصحيحة وأحياناً الوحيدة لتدفق المخرجات. فضِّل `block: true` بـ `timeout` معتدل على حلقات الاستقصاء المُحكمة.
+- `task_id` غير معروف، أو مهمة جُمعت مخرجاتها بالقمامة، تُعيد خطأً. أعد إرسال العمل إذا كنت لا تزال بحاجة إليه.
+- `TaskOutput` لا يوقف المهمة. استخدم `TaskStop` للإنهاء.