cx-viewer 1.0.0

package/concepts/ar/Tool-ExitPlanMode.md

@@ -0,0 +1,62 @@
+# ExitPlanMode
+
+## التعريف
+
+الخروج من وضع التخطيط وتقديم الخطة للمستخدم للموافقة. يُقرأ محتوى الخطة من ملف الخطة المكتوب مسبقاً.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `allowedPrompts` | array | لا | قائمة أوصاف الأذونات المطلوبة لخطة التنفيذ |
+
+كل عنصر في مصفوفة `allowedPrompts`:
+
+| الحقل | النوع | مطلوب | الوصف |
+|-------|-------|-------|-------|
+| `tool` | enum | نعم | الأداة المعنية، حالياً يُدعم فقط `Bash` |
+| `prompt` | string | نعم | وصف دلالي للعملية (مثل "run tests"، "install dependencies") |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- اكتملت الخطة في وضع التخطيط وجاهزة لتقديمها لموافقة المستخدم
+- يُستخدم فقط لمهام التنفيذ التي تتطلب كتابة كود
+
+**غير مناسب للاستخدام:**
+- مهام البحث/الاستكشاف البحتة — لا حاجة للخروج من وضع التخطيط
+- السؤال "هل الخطة مقبولة؟" — هذا بالضبط وظيفة هذه الأداة، لا تستخدم AskUserQuestion لذلك
+
+## ملاحظات
+
+- هذه الأداة لا تقبل محتوى الخطة كمعامل — تقرأ من ملف الخطة المكتوب مسبقاً
+- سيرى المستخدم محتوى ملف الخطة للموافقة
+- لا تستخدم AskUserQuestion قبل استدعاء هذه الأداة للسؤال "هل الخطة مقبولة"، فهذا تكرار
+- لا تذكر "الخطة" في الأسئلة، لأن المستخدم لا يرى محتوى الخطة قبل ExitPlanMode
+
+## النص الأصلي
+
+<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+
+## How This Tool Works
+- You should have already written your plan to the plan file specified in the plan mode system message
+- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
+- This tool simply signals that you're done planning and ready for the user to review and approve
+- The user will see the contents of your plan file when they review it
+
+## When to Use This Tool
+IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+
+## Before Using This Tool
+Ensure your plan is complete and unambiguous:
+- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
+- Once your plan is finalized, use THIS tool to request approval
+
+**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+
+## Examples
+
+1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
+2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
+3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
+</textarea>

package/concepts/ar/Tool-Glob.md

@@ -0,0 +1,39 @@
+# Glob
+
+## التعريف
+
+أداة سريعة لمطابقة أنماط أسماء الملفات، تدعم قواعد الكود بأي حجم. تُرجع مسارات الملفات المطابقة مرتبة حسب وقت التعديل.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `pattern` | string | نعم | نمط glob (مثل `**/*.js`، `src/**/*.ts`) |
+| `path` | string | لا | دليل البحث، الافتراضي هو دليل العمل الحالي. لا تمرر "undefined" أو "null" |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- البحث عن الملفات بنمط اسم الملف
+- البحث عن جميع الملفات من نوع معين (مثل جميع ملفات `.tsx`)
+- تحديد موقع الملفات عند البحث عن تعريف فئة معينة (مثل `class Foo`)
+- يمكن إطلاق عدة استدعاءات Glob بالتوازي في رسالة واحدة
+
+**غير مناسب للاستخدام:**
+- البحث في محتوى الملفات — يجب استخدام Grep
+- الاستكشاف المفتوح الذي يتطلب جولات بحث متعددة — يجب استخدام Task (نوع Explore)
+
+## ملاحظات
+
+- يدعم صيغة glob القياسية: `*` يطابق مستوى واحد، `**` يطابق مستويات متعددة، `{}` يطابق خيارات متعددة
+- النتائج مرتبة حسب وقت التعديل
+- يُفضل استخدامه على أمر `find` في Bash
+
+## النص الأصلي
+
+<textarea readonly>- Fast file pattern matching tool that works with any codebase size
+- Supports glob patterns like "**/*.js" or "src/**/*.ts"
+- Returns matching file paths sorted by modification time
+- Use this tool when you need to find files by name patterns
+- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
+- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>

package/concepts/ar/Tool-Grep.md

@@ -0,0 +1,57 @@
+# Grep
+
+## التعريف
+
+أداة بحث قوية في المحتوى مبنية على ripgrep. تدعم التعبيرات النمطية وتصفية أنواع الملفات وأوضاع إخراج متعددة.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `pattern` | string | نعم | نمط بحث بتعبير نمطي |
+| `path` | string | لا | مسار البحث (ملف أو دليل)، الافتراضي هو دليل العمل الحالي |
+| `glob` | string | لا | تصفية أسماء الملفات (مثل `*.js`، `*.{ts,tsx}`) |
+| `type` | string | لا | تصفية نوع الملف (مثل `js`، `py`، `rust`)، أكثر كفاءة من glob |
+| `output_mode` | enum | لا | وضع الإخراج: `files_with_matches` (افتراضي)، `content`، `count` |
+| `-i` | boolean | لا | بحث غير حساس لحالة الأحرف |
+| `-n` | boolean | لا | عرض أرقام الأسطر (وضع content فقط)، الافتراضي true |
+| `-A` | number | لا | عدد الأسطر المعروضة بعد التطابق |
+| `-B` | number | لا | عدد الأسطر المعروضة قبل التطابق |
+| `-C` / `context` | number | لا | عدد الأسطر المعروضة قبل وبعد التطابق |
+| `head_limit` | number | لا | تحديد عدد نتائج الإخراج، الافتراضي 0 (بلا حدود) |
+| `offset` | number | لا | تخطي أول N نتيجة |
+| `multiline` | boolean | لا | تفعيل وضع المطابقة متعددة الأسطر، الافتراضي false |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- البحث عن سلاسل نصية أو أنماط محددة في قاعدة الكود
+- العثور على مواقع استخدام الدوال/المتغيرات
+- تصفية نتائج البحث حسب نوع الملف
+- إحصاء عدد التطابقات
+
+**غير مناسب للاستخدام:**
+- البحث عن الملفات بالاسم — يجب استخدام Glob
+- الاستكشاف المفتوح الذي يتطلب جولات بحث متعددة — يجب استخدام Task (نوع Explore)
+
+## ملاحظات
+
+- يستخدم صيغة ripgrep (وليس grep)، الأحرف الخاصة مثل الأقواس المعقوفة تحتاج إلى تهريب
+- وضع `files_with_matches` يُرجع مسارات الملفات فقط، وهو الأكثر كفاءة
+- وضع `content` يُرجع محتوى الأسطر المطابقة، مع دعم أسطر السياق
+- المطابقة متعددة الأسطر تتطلب تعيين `multiline: true`
+- يُفضل دائماً استخدام أداة Grep بدلاً من أمر `grep` أو `rg` في Bash
+
+## النص الأصلي
+
+<textarea readonly>A powerful search tool built on ripgrep
+
+  Usage:
+  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
+  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
+  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
+  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
+  - Use Agent tool for open-ended searches requiring multiple rounds
+  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
+  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
+</textarea>

package/concepts/ar/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## التعريف
+
+استبدال أو إدراج أو حذف خلايا محددة في Jupyter notebook (ملفات .ipynb).
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `notebook_path` | string | نعم | المسار المطلق لملف notebook |
+| `new_source` | string | نعم | المحتوى الجديد للخلية |
+| `cell_id` | string | لا | معرف الخلية المراد تحريرها. في وضع الإدراج تُدرج الخلية الجديدة بعد هذا المعرف |
+| `cell_type` | enum | لا | نوع الخلية: `code` أو `markdown`. مطلوب في وضع الإدراج |
+| `edit_mode` | enum | لا | وضع التحرير: `replace` (افتراضي)، `insert`، `delete` |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- تعديل خلايا الكود أو markdown في Jupyter notebook
+- إضافة خلايا جديدة إلى notebook
+- حذف خلايا من notebook
+
+## ملاحظات
+
+- `cell_number` يبدأ من الصفر (0-indexed)
+- وضع `insert` يُدرج خلية جديدة في الموضع المحدد
+- وضع `delete` يحذف الخلية في الموضع المحدد
+- يجب أن يكون المسار مطلقاً
+
+## النص الأصلي
+
+<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>

package/concepts/ar/Tool-Read.md

@@ -0,0 +1,56 @@
+# Read
+
+## التعريف
+
+قراءة محتوى الملفات من نظام الملفات المحلي. يدعم الملفات النصية والصور وPDF وJupyter notebook.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `file_path` | string | نعم | المسار المطلق للملف |
+| `offset` | number | لا | رقم سطر البداية (للقراءة المجزأة للملفات الكبيرة) |
+| `limit` | number | لا | عدد الأسطر المقروءة (للقراءة المجزأة للملفات الكبيرة) |
+| `pages` | string | لا | نطاق صفحات PDF (مثل "1-5"، "3"، "10-20")، ينطبق فقط على PDF |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- قراءة ملفات الكود وملفات التكوين وغيرها من الملفات النصية
+- عرض ملفات الصور (Claude نموذج متعدد الوسائط)
+- قراءة مستندات PDF
+- قراءة Jupyter notebook (يُرجع جميع الخلايا مع مخرجاتها)
+- قراءة عدة ملفات بالتوازي للحصول على السياق
+
+**غير مناسب للاستخدام:**
+- قراءة الأدلة — يجب استخدام أمر `ls` في Bash
+- استكشاف مفتوح لقاعدة الكود — يجب استخدام Task (نوع Explore)
+
+## ملاحظات
+
+- يجب أن يكون المسار مطلقاً وليس نسبياً
+- يقرأ افتراضياً أول 2000 سطر من الملف
+- الأسطر التي تتجاوز 2000 حرف يتم اقتطاعها
+- المخرجات بتنسيق `cat -n`، أرقام الأسطر تبدأ من 1
+- ملفات PDF الكبيرة (أكثر من 10 صفحات) يجب تحديد معامل `pages`، بحد أقصى 20 صفحة في كل مرة
+- قراءة ملف غير موجود تُرجع خطأ (لا تتعطل)
+- يمكن استدعاء عدة Read بالتوازي في رسالة واحدة
+
+## النص الأصلي
+
+<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
+Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
+
+Usage:
+- The file_path parameter must be an absolute path, not a relative path
+- By default, it reads up to 2000 lines starting from the beginning of the file
+- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
+- Any lines longer than 2000 characters will be truncated
+- Results are returned using cat -n format, with line numbers starting at 1
+- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
+- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
+- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
+- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
+- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
+- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
+- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>

package/concepts/ar/Tool-SendMessage.md

@@ -0,0 +1,41 @@
+# SendMessage
+
+## التعريف
+
+يُرسل رسائل بين الـ agent داخل الفريق. يُستخدم للتواصل المباشر والبث والرسائل البروتوكولية (طلبات/ردود الإيقاف، الموافقة على الخطط).
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `to` | string | نعم | المُستلم: اسم العضو، أو `"*"` للبث إلى الجميع |
+| `message` | string / object | نعم | رسالة نصية أو كائن بروتوكولي مُهيكل |
+| `summary` | string | لا | معاينة من 5-10 كلمات تُعرض في الواجهة |
+
+## أنواع الرسائل
+
+### نص عادي
+رسائل مباشرة بين أعضاء الفريق للتنسيق وتحديثات الحالة ومناقشات المهام.
+
+### طلب إيقاف
+يطلب من عضو الإيقاف بشكل منظم: `{ type: "shutdown_request", reason: "..." }`
+
+### رد الإيقاف
+يوافق العضو على الإيقاف أو يرفضه: `{ type: "shutdown_response", approve: true/false }`
+
+### رد الموافقة على الخطة
+يوافق على خطة عضو أو يرفضها: `{ type: "plan_approval_response", approve: true/false }`
+
+## البث مقابل الإرسال المباشر
+
+- **مباشر** (`to: "اسم-العضو"`): إرسال إلى عضو محدد — الأفضل لمعظم حالات التواصل
+- **بث** (`to: "*"`): إرسال إلى جميع الأعضاء — يُستخدم باعتدال، فقط للإعلانات العاجلة على مستوى الفريق
+
+## الأدوات ذات الصلة
+
+| الأداة | الغرض |
+|--------|--------|
+| `TeamCreate` | إنشاء فريق جديد |
+| `TeamDelete` | حذف الفريق عند الانتهاء |
+| `Agent` | توليد أعضاء ينضمون إلى الفريق |
+| `TaskCreate` / `TaskUpdate` / `TaskList` | إدارة قائمة المهام المشتركة |

package/concepts/ar/Tool-Skill.md

@@ -0,0 +1,56 @@
+# Skill
+
+## التعريف
+
+تنفيذ مهارة (skill) في المحادثة الرئيسية. المهارات هي قدرات متخصصة يمكن للمستخدم استدعاؤها عبر أوامر slash (مثل `/commit`، `/review-pr`).
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `skill` | string | نعم | اسم المهارة (مثل "commit"، "review-pr"، "pdf") |
+| `args` | string | لا | معاملات المهارة |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- أدخل المستخدم أمر slash بتنسيق `/<skill-name>`
+- طلب المستخدم يتطابق مع وظيفة مهارة مسجلة
+
+**غير مناسب للاستخدام:**
+- أوامر CLI المدمجة (مثل `/help`، `/clear`)
+- مهارة قيد التشغيل بالفعل
+- اسم مهارة غير موجود في قائمة المهارات المتاحة
+
+## ملاحظات
+
+- بعد استدعاء المهارة تتوسع إلى prompt كامل
+- يدعم الأسماء المؤهلة بالكامل (مثل `ms-office-suite:pdf`)
+- قائمة المهارات المتاحة تُقدم في رسائل system-reminder
+- عند رؤية وسم `<command-name>` فهذا يعني أن المهارة محملة بالفعل، يجب التنفيذ مباشرة بدلاً من استدعاء هذه الأداة مرة أخرى
+- لا تذكر مهارة دون استدعاء الأداة فعلياً
+
+## النص الأصلي
+
+<textarea readonly>Execute a skill within the main conversation
+
+When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+
+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>

package/concepts/ar/Tool-Task.md

@@ -0,0 +1,51 @@
+# Task
+
+> **ملاحظة:** في الإصدارات الأحدث من Claude Code، تمت إعادة تسمية هذه الأداة إلى **Agent**. راجع مستند [Tool-Agent](Tool-Agent).
+
+## التعريف
+
+بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات بشكل مستقل. الوكلاء الفرعيون هم عمليات فرعية مستقلة، لكل منها مجموعة أدوات وسياق مخصص.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `prompt` | string | نعم | وصف المهمة التي سينفذها الوكيل الفرعي |
+| `description` | string | نعم | ملخص مختصر من 3-5 كلمات |
+| `subagent_type` | string | نعم | نوع الوكيل الفرعي، يحدد مجموعة الأدوات المتاحة |
+| `model` | enum | لا | تحديد النموذج (sonnet / opus / haiku)، الافتراضي يرث من الأصل |
+| `max_turns` | integer | لا | الحد الأقصى لعدد الجولات |
+| `run_in_background` | boolean | لا | هل يعمل في الخلفية، المهام الخلفية تُرجع مسار output_file |
+| `resume` | string | لا | معرف الوكيل المراد استئنافه، يستمر من آخر تنفيذ |
+| `isolation` | enum | لا | وضع العزل، `worktree` ينشئ git worktree مؤقت |
+
+## أنواع الوكلاء الفرعيين
+
+| النوع | الغرض | الأدوات المتاحة |
+|-------|--------|----------------|
+| `Bash` | تنفيذ الأوامر، عمليات git | Bash |
+| `general-purpose` | مهام عامة متعددة الخطوات | جميع الأدوات |
+| `Explore` | استكشاف سريع لقاعدة الكود | جميع الأدوات باستثناء Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | تصميم خطط التنفيذ | جميع الأدوات باستثناء Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | أسئلة وأجوبة حول دليل استخدام Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | تكوين شريط الحالة | Read, Edit |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- المهام المعقدة التي تتطلب إنجازاً مستقلاً متعدد الخطوات
+- استكشاف قاعدة الكود والبحث المعمق (باستخدام نوع Explore)
+- العمل المتوازي الذي يتطلب بيئة معزولة
+- المهام طويلة المدة التي تحتاج للعمل في الخلفية
+
+**غير مناسب للاستخدام:**
+- قراءة مسار ملف محدد — استخدم Read أو Glob مباشرة
+- البحث في 2-3 ملفات معروفة — استخدم Read مباشرة
+- البحث عن تعريف فئة محددة — استخدم Glob مباشرة
+
+## ملاحظات
+
+- بعد اكتمال الوكيل الفرعي يُرجع رسالة واحدة، نتائجه غير مرئية للمستخدم ويحتاج الوكيل الرئيسي لنقلها
+- يمكن إطلاق عدة استدعاءات Task بالتوازي في رسالة واحدة لزيادة الكفاءة
+- يتم فحص تقدم المهام الخلفية عبر أداة TaskOutput
+- نوع Explore أبطأ من استدعاء Glob/Grep مباشرة، يُستخدم فقط عندما لا يكفي البحث البسيط

package/concepts/ar/Tool-TaskCreate.md

@@ -0,0 +1,78 @@
+# 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 للتحقق من عدم وجود مهام مكررة
+
+## النص الأصلي
+
+<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
+
+Use this tool proactively in these scenarios:
+
+- 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
+
+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.
+
+## Task Fields
+
+- **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`.
+
+## 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>

package/concepts/ar/Tool-TaskGet.md

@@ -0,0 +1,56 @@
+# TaskGet
+
+## التعريف
+
+الحصول على التفاصيل الكاملة للمهمة عبر معرف المهمة.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `taskId` | string | نعم | معرف المهمة المراد الحصول عليها |
+
+## المحتوى المُرجع
+
+- `subject` — عنوان المهمة
+- `description` — المتطلبات التفصيلية والسياق
+- `status` — الحالة: `pending`، `in_progress` أو `completed`
+- `blocks` — قائمة المهام المحظورة بواسطة هذه المهمة
+- `blockedBy` — قائمة المهام السابقة التي تحظر هذه المهمة
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- الحصول على الوصف الكامل والسياق قبل بدء العمل
+- فهم علاقات التبعية للمهمة
+- الحصول على المتطلبات الكاملة بعد تعيين المهمة
+
+## ملاحظات
+
+- بعد الحصول على المهمة يجب التحقق من أن قائمة `blockedBy` فارغة قبل بدء العمل
+- استخدم TaskList لعرض معلومات ملخصة لجميع المهام
+
+## النص الأصلي
+
+<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+
+## When to Use This Tool
+
+- 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
+
+## 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
+
+## Tips
+
+- After fetching a task, verify its blockedBy list is empty before beginning work.
+- Use TaskList to see all tasks in summary form.
+</textarea>

package/concepts/ar/Tool-TaskList.md

@@ -0,0 +1,56 @@
+# TaskList
+
+## التعريف
+
+عرض جميع المهام في قائمة المهام، لمراجعة التقدم العام والأعمال المتاحة.
+
+## المعاملات
+
+لا توجد معاملات.
+
+## المحتوى المُرجع
+
+معلومات ملخصة لكل مهمة:
+- `id` — معرف المهمة
+- `subject` — وصف مختصر
+- `status` — الحالة: `pending`، `in_progress` أو `completed`
+- `owner` — المسؤول (معرف agent)، فارغ يعني غير مُعيَّن
+- `blockedBy` — قائمة معرفات المهام غير المكتملة التي تحظر هذه المهمة
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- عرض المهام المتاحة (حالة pending، بدون owner، غير محظورة)
+- فحص التقدم العام للمشروع
+- البحث عن المهام المحظورة
+- البحث عن المهمة التالية بعد إكمال مهمة
+
+## ملاحظات
+
+- يُفضل معالجة المهام بترتيب المعرف (الأصغر أولاً)، لأن المهام المبكرة عادة توفر سياقاً للمهام اللاحقة
+- المهام التي لديها `blockedBy` لا يمكن المطالبة بها قبل رفع التبعية
+- استخدم TaskGet للحصول على التفاصيل الكاملة لمهمة محددة
+
+## النص الأصلي
+
+<textarea readonly>Use this tool to list all tasks in the task list.
+
+## When to Use This Tool
+
+- 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
+
+## 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)
+
+Use TaskGet with a specific task ID to view full details including description and comments.
+</textarea>

package/concepts/ar/Tool-TaskOutput.md

@@ -0,0 +1,40 @@
+# TaskOutput
+
+## التعريف
+
+الحصول على مخرجات المهام الخلفية قيد التشغيل أو المكتملة. ينطبق على shell الخلفية والوكلاء غير المتزامنين والجلسات البعيدة.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `task_id` | string | نعم | معرف المهمة |
+| `block` | boolean | نعم | هل ينتظر بشكل محظور حتى اكتمال المهمة، الافتراضي `true` |
+| `timeout` | number | نعم | أقصى وقت انتظار (بالمللي ثانية)، الافتراضي 30000، الحد الأقصى 600000 |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- فحص تقدم الوكلاء الخلفيين المُطلقين عبر Task (`run_in_background: true`)
+- الحصول على نتائج تنفيذ أوامر Bash الخلفية
+- انتظار اكتمال المهام غير المتزامنة والحصول على المخرجات
+
+**غير مناسب للاستخدام:**
+- المهام الأمامية — تُرجع النتائج مباشرة، لا حاجة لهذه الأداة
+
+## ملاحظات
+
+- `block: true` يحظر حتى اكتمال المهمة أو انتهاء المهلة
+- `block: false` للفحص غير المحظور للحالة الحالية
+- يمكن العثور على معرف المهمة عبر أمر `/tasks`
+- ينطبق على جميع أنواع المهام: shell الخلفية، الوكلاء غير المتزامنين، الجلسات البعيدة
+
+## النص الأصلي
+
+<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>