cc-viewer 1.6.182 → 1.6.183

package/concepts/ar/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## التعريف
+يطابق أسماء الملفات وفق نمط glob ويُعيد المسارات مرتبة حسب أحدث وقت تعديل أولاً. مُحسَّن لتحديد مواقع الملفات بسرعة في قواعد شفرة من أي حجم دون الرجوع إلى `find` عبر الصدفة.
 
-أداة سريعة لمطابقة أنماط أسماء الملفات، تدعم قواعد الكود بأي حجم. تُرجع مسارات الملفات المطابقة مرتبة حسب وقت التعديل.
+## متى يُستخدم
 
-## المعاملات
+- تعداد كل ملف من امتداد محدد (مثل جميع ملفات `*.ts` تحت `src`)
+- اكتشاف ملفات الإعدادات أو المواضع حسب اصطلاح التسمية (`**/jest.config.*`، `**/*.test.tsx`)
+- تضييق سطح البحث قبل تشغيل `Grep` موجَّه
+- التحقق مما إذا كان ملف موجوداً بالفعل بنمط معروف قبل استدعاء `Write`
+- العثور على الملفات المعدَّلة مؤخراً بالاعتماد على ترتيب وقت التعديل
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `pattern` | string | نعم | نمط glob (مثل `**/*.js`، `src/**/*.ts`) |
-| `path` | string | لا | دليل البحث، الافتراضي هو دليل العمل الحالي. لا تمرر "undefined" أو "null" |
+## المعاملات
 
-## سيناريوهات الاستخدام
+- `pattern` (سلسلة، مطلوب): تعبير glob للمطابقة. يدعم `*` للبدائل من جزء واحد، و`**` للمطابقة التكرارية، و`{a,b}` للبدائل، مثل `src/**/*.{ts,tsx}`.
+- `path` (سلسلة، اختياري): الدليل الذي يُجرى فيه البحث. يجب أن يكون مسار دليل صالحاً عند تقديمه. احذف الحقل كلياً للبحث في دليل العمل الحالي. لا تمرر السلسلتين `"undefined"` أو `"null"`.
 
-**مناسب للاستخدام:**
-- البحث عن الملفات بنمط اسم الملف
-- البحث عن جميع الملفات من نوع معين (مثل جميع ملفات `.tsx`)
-- تحديد موقع الملفات عند البحث عن تعريف فئة معينة (مثل `class Foo`)
-- يمكن إطلاق عدة استدعاءات Glob بالتوازي في رسالة واحدة
+## أمثلة
 
-**غير مناسب للاستخدام:**
-- البحث في محتوى الملفات — يجب استخدام Grep
-- الاستكشاف المفتوح الذي يتطلب جولات بحث متعددة — يجب استخدام Task (نوع Explore)
+### مثال 1: كل ملف مصدر TypeScript
+استدعِ `Glob` بـ `pattern: "src/**/*.ts"`. النتيجة قائمة مرتبة حسب mtime، لذا تظهر الملفات المعدَّلة مؤخراً أولاً، وهو مفيد للتركيز على النقاط الساخنة.
 
-## ملاحظات
+### مثال 2: تحديد ملف محتمل لتعريف صف
+عندما تشك أن صفاً موجود في ملف لا تعرف اسمه، ابحث بـ `pattern: "**/*UserService*"` لتضييق المرشحين، ثم تابع بـ `Read` أو `Grep`.
 
-- يدعم صيغة glob القياسية: `*` يطابق مستوى واحد، `**` يطابق مستويات متعددة، `{}` يطابق خيارات متعددة
-- النتائج مرتبة حسب وقت التعديل
-- يُفضل استخدامه على أمر `find` في Bash
+### مثال 3: اكتشاف متوازٍ قبل مهمة أكبر
+في رسالة واحدة، أطلق عدة استدعاءات `Glob` (مثل واحد لـ `**/*.test.ts` وآخر لـ `**/fixtures/**`) حتى يعملا بالتوازي وتُرتبط نتائجهما.
 
-## النص الأصلي
+## ملاحظات
 
-<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>
+- النتائج مرتبة حسب وقت تعديل الملف (الأحدث أولاً)، لا أبجدياً. رتِّب لاحقاً إذا احتجت ترتيباً ثابتاً.
+- تُقيَّم الأنماط بواسطة الأداة، لا الصدفة؛ لا حاجة لتضليلها أو وضعها بين علامات اقتباس كما تفعل في سطر الأوامر.
+- للاستكشاف المفتوح الذي يتطلب عدة جولات من البحث والاستدلال، فوِّض إلى `Agent` من نوع وكيل Explore بدلاً من تسلسل كثير من استدعاءات `Glob`.
+- فضِّل `Glob` على استدعاءات `Bash` لـ `find` أو `ls` لاكتشاف أسماء الملفات؛ فهي تتعامل مع الأذونات بثبات وتُعيد مخرجات منظمة.
+- عند البحث عن محتوى داخل الملفات لا أسمائها، استخدم `Grep` بدلاً منها.

package/concepts/ar/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## التعريف
+يبحث في محتويات الملفات باستخدام محرك ripgrep. يوفر دعماً كاملاً للتعابير النمطية وفلترة حسب نوع الملف وثلاثة أوضاع إخراج للمفاضلة بين الدقة والاختصار.
 
-أداة بحث قوية في المحتوى مبنية على ripgrep. تدعم التعبيرات النمطية وتصفية أنواع الملفات وأوضاع إخراج متعددة.
+## متى يُستخدم
+
+- تحديد كل موقع استدعاء لدالة أو كل مرجع لمعرِّف
+- التحقق مما إذا كانت سلسلة أو رسالة خطأ تظهر في أي مكان في قاعدة الشفرة
+- عدّ ورودات نمط لقياس الأثر قبل إعادة الهيكلة
+- تضييق البحث إلى نوع ملف (`type: "ts"`) أو glob (`glob: "**/*.tsx"`)
+- جلب تطابقات ممتدة عبر أسطر مثل تعريفات الـ structs متعددة الأسطر أو كتل JSX باستخدام `multiline: true`
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `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)
+- `pattern` (سلسلة، مطلوب): التعبير النمطي المراد البحث عنه. يستخدم صياغة ripgrep، لذا تحتاج الأقواس الحرفية إلى تضليل (مثل `interface\{\}` للعثور على `interface{}`).
+- `path` (سلسلة، اختياري): ملف أو دليل للبحث. الافتراضي دليل العمل الحالي.
+- `glob` (سلسلة، اختياري): مرشح اسم ملف مثل `*.js` أو `*.{ts,tsx}`.
+- `type` (سلسلة، اختياري): اختصار نوع الملف مثل `js` أو `py` أو `rust` أو `go`. أكفأ من `glob` للغات القياسية.
+- `output_mode` (تعداد، اختياري): `files_with_matches` (الافتراضي، يُعيد المسارات فقط)، أو `content` (يُعيد الأسطر المطابقة)، أو `count` (يُعيد أعداد التطابقات).
+- `-i` (قيمة منطقية، اختياري): مطابقة غير حساسة لحالة الأحرف.
+- `-n` (قيمة منطقية، اختياري): تضمين أرقام الأسطر في وضع `content`. الافتراضي `true`.
+- `-A` (رقم، اختياري): أسطر السياق المعروضة بعد كل تطابق (يتطلب وضع `content`).
+- `-B` (رقم، اختياري): أسطر السياق قبل كل تطابق (يتطلب وضع `content`).
+- `-C` / `context` (رقم، اختياري): أسطر السياق على جانبي كل تطابق.
+- `multiline` (قيمة منطقية، اختياري): السماح للأنماط بامتدادها عبر الأسطر (`.` يطابق `\n`). الافتراضي `false`.
+- `head_limit` (رقم، اختياري): حد الأسطر أو مسارات الملفات أو إدخالات العدّ المُعادة. الافتراضي 250؛ مرر `0` لعدم وجود حد (استخدمه باعتدال).
+- `offset` (رقم، اختياري): تخطي أول N نتائج قبل تطبيق `head_limit`. الافتراضي `0`.
+
+## أمثلة
+
+### مثال 1: إيجاد جميع مواقع استدعاء دالة
+اضبط `pattern: "registerHandler\\("` و`output_mode: "content"` و`-C: 2` لرؤية الأسطر المحيطة بكل استدعاء.
+
+### مثال 2: عدّ التطابقات عبر نوع
+اضبط `pattern: "TODO"` و`type: "py"` و`output_mode: "count"` لرؤية إجماليات TODO لكل ملف عبر مصادر Python.
+
+### مثال 3: تطابق بنية متعددة الأسطر
+استخدم `pattern: "struct Config \\{[\\s\\S]*?version"` مع `multiline: true` لالتقاط حقل مُعلَن على بُعد عدة أسطر داخل بنية Go.
 
 ## ملاحظات
 
-- يستخدم صيغة 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>
+- فضِّل دائماً `Grep` على تشغيل `grep` أو `rg` عبر `Bash`؛ فالأداة مُحسَّنة للأذونات الصحيحة والمخرجات المنظمة.
+- وضع الإخراج الافتراضي `files_with_matches` هو الأرخص. انتقل إلى `content` فقط عندما تحتاج إلى رؤية الأسطر نفسها.
+- أعلام السياق (`-A`، `-B`، `-C`) تُتجاهل إلا إذا كان `output_mode` هو `content`.
+- مجموعات النتائج الكبيرة تستهلك رموز السياق. استخدم `head_limit` أو `offset` أو فلاتر `glob`/`type` أضيق للبقاء مركِّزاً.
+- لاكتشاف أسماء الملفات، استخدم `Glob` بدلاً منها؛ وللتحقيقات المفتوحة عبر جولات كثيرة، أرسل `Agent` مع وكيل Explore.

package/concepts/ar/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+يشغّل مراقبًا في الخلفية يبثّ الأحداث من برنامج نصي طويل الأمد. كل سطر في المخرجات القياسية يصبح إشعارًا — واصل عملك بينما تصل الأحداث في المحادثة.
+
+## متى يُستخدم
+
+- تتبّع الأخطاء والتحذيرات وأنماط الانهيار في ملف السجل أثناء تشغيل عملية النشر
+- استطلاع واجهة برمجية بعيدة أو طلب سحب أو أنبوب CI كل 30 ثانية للكشف عن أحداث الحالة الجديدة
+- مراقبة التغييرات في دليل نظام الملفات أو مخرجات البناء في الوقت الفعلي
+- انتظار شرط محدد عبر تكرارات عديدة (مثل الوصول إلى نقطة تحقق في خطوة تدريب أو إفراغ طابور)
+- **ليس** للانتظار البسيط حتى الانتهاء — استخدم `Bash` مع `run_in_background` لذلك؛ يُرسل إشعار اكتمال واحد عند انتهاء العملية
+
+## المعاملات
+
+- `command` (نص، مطلوب): أمر الصدفة أو البرنامج النصي المراد تشغيله. كل سطر يُكتب في المخرجات القياسية يصبح حدث إشعار مستقلًا. ينتهي المراقب عند انتهاء العملية.
+- `description` (نص، مطلوب): تسمية قصيرة قابلة للقراءة تظهر في كل إشعار. كن محددًا — "الأخطاء في deploy.log" أفضل من "مراقبة السجلات". تُعرّف هذه التسمية أيّ مراقب قد اشتغل.
+- `timeout_ms` (رقم، الافتراضي `300000`، الحد الأقصى `3600000`): مهلة الإنهاء القسري بالمللي ثانية. بعد هذه المدة تُنهى العملية. يُتجاهل عند `persistent: true`.
+- `persistent` (قيمة منطقية، الافتراضي `false`): عند `true` يعمل المراقب طوال فترة الجلسة دون مهلة. أوقفه صراحةً باستخدام `TaskStop`.
+
+## أمثلة
+
+### المثال الأول: تتبّع ملف سجل للأخطاء والانهيارات
+
+يغطّي هذا المثال جميع الحالات النهائية: علامة النجاح، والتتبّع الخلفي، وكلمات الخطأ الشائعة، والإنهاء بسبب OOM، والخروج غير المتوقع للعملية.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+استخدم `grep --line-buffered` في كل أنبوب. بدونه يخزّن نظام التشغيل المخرجات في كتل 4 كيلوبايت وقد تتأخر الأحداث لدقائق. يغطّي نمط التبديل مسار النجاح (`deployed`) ومسارات الإخفاق (`Traceback`، `Error`، `FAILED`، `Killed`، `OOM`). المراقب الذي يرصد علامة النجاح فقط يبقى صامتًا عند الانهيار — الصمت لا يختلف عن "لا يزال يعمل".
+
+### المثال الثاني: استطلاع واجهة برمجية بعيدة كل 30 ثانية
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` يمنع خطأ شبكي عابرًا من إنهاء الحلقة. فترات الاستطلاع البالغة 30 ثانية أو أكثر مناسبة للواجهات البرمجية البعيدة لتجنب حدود معدل الطلبات. عدّل نمط grep لالتقاط استجابات النجاح والإخفاق على حدٍّ سواء حتى لا تُخفي الأخطاء من جانب الواجهة البرمجية بالصمت.
+
+## ملاحظات
+
+- **استخدم دائمًا `grep --line-buffered` في الأنابيب.** بدونه يؤخّر تخزين الأنبوب الأحداث لدقائق لأن نظام التشغيل يجمع المخرجات حتى يمتلئ كتلة 4 كيلوبايت. يفرض `--line-buffered` تفريغ الذاكرة المؤقتة بعد كل سطر.
+- **يجب أن يغطّي الفلتر توقيعات النجاح والإخفاق معًا.** المراقب الذي يرصد علامة النجاح فقط يبقى صامتًا عند الانهيار أو التجمّد أو الخروج غير المتوقع. وسّع التبديل: أضف `Error`، `Traceback`، `FAILED`، `Killed`، `OOM` وعلامات الحالة النهائية المماثلة بجانب كلمة النجاح.
+- **فترات الاستطلاع: 30 ثانية أو أكثر للواجهات البرمجية البعيدة.** الاستطلاع المتكرر للخدمات الخارجية يخاطر بأخطاء حدود معدل الطلبات أو الحظر. لفحوصات نظام الملفات المحلية أو العمليات، 0.5–1 ثانية مناسبة.
+- **استخدم `persistent: true` للمراقبين طوال فترة الجلسة.** القيمة الافتراضية لـ `timeout_ms` وهي 300,000 مللي ثانية (5 دقائق) تُنهي العملية. للمراقبين الذين يجب أن يعملوا حتى الإيقاف الصريح، عيّن `persistent: true` واستدعِ `TaskStop` عند الانتهاء.
+- **إيقاف تلقائي عند فيضان الأحداث.** كل سطر في المخرجات القياسية رسالة محادثة. إذا كان الفلتر واسعًا جدًا وأنتج أحداثًا كثيرة جدًا، يُوقف المراقب تلقائيًا. أعد التشغيل بنمط `grep` أضيق. السطور التي تصل في غضون 200 مللي ثانية تُجمَّع في إشعار واحد.

package/concepts/ar/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## التعريف
+يُعدِّل خلية واحدة في دفتر Jupyter (`.ipynb`). يدعم استبدال مصدر الخلية، أو إدراج خلية جديدة، أو حذف خلية موجودة مع الحفاظ على بقية هيكل الدفتر.
 
-استبدال أو إدراج أو حذف خلايا محددة في Jupyter notebook (ملفات .ipynb).
+## متى يُستخدم
+
+- إصلاح أو تحديث خلية شفرة في دفتر تحليلي دون إعادة كتابة الملف بأكمله
+- استبدال خلية markdown لتحسين السرد أو إضافة توثيق
+- إدراج خلية شفرة أو markdown جديدة في موضع معروف داخل دفتر موجود
+- إزالة خلية قديمة أو معطوبة حتى لا تعتمد عليها الخلايا اللاحقة
+- إعداد دفتر قابل للتكرار بالتطوير على خلية تلو أخرى
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `notebook_path` | string | نعم | المسار المطلق لملف notebook |
-| `new_source` | string | نعم | المحتوى الجديد للخلية |
-| `cell_id` | string | لا | معرف الخلية المراد تحريرها. في وضع الإدراج تُدرج الخلية الجديدة بعد هذا المعرف |
-| `cell_type` | enum | لا | نوع الخلية: `code` أو `markdown`. مطلوب في وضع الإدراج |
-| `edit_mode` | enum | لا | وضع التحرير: `replace` (افتراضي)، `insert`، `delete` |
+- `notebook_path` (سلسلة، مطلوب): المسار المطلق لملف `.ipynb`. تُرفض المسارات النسبية.
+- `new_source` (سلسلة، مطلوب): مصدر الخلية الجديد. في `replace` و`insert` يصبح متن الخلية؛ وفي `delete` يُتجاهل لكنه مطلوب في المخطط.
+- `cell_id` (سلسلة، اختياري): معرف الخلية المستهدفة. في وضعي `replace` و`delete`، تعمل الأداة على هذه الخلية. في وضع `insert`، تُدرج الخلية الجديدة مباشرة بعد الخلية ذات هذا المعرف؛ احذفه للإدراج في أعلى الدفتر.
+- `cell_type` (تعداد، اختياري): إما `code` أو `markdown`. مطلوب عندما يكون `edit_mode` هو `insert`. عند حذفه خلال `replace`، يُحافظ على نوع الخلية الحالي.
+- `edit_mode` (تعداد، اختياري): `replace` (الافتراضي)، أو `insert`، أو `delete`.
 
-## سيناريوهات الاستخدام
+## أمثلة
 
-**مناسب للاستخدام:**
-- تعديل خلايا الكود أو markdown في Jupyter notebook
-- إضافة خلايا جديدة إلى notebook
-- حذف خلايا من notebook
+### مثال 1: استبدال خلية شفرة معيبة
+استدعِ `NotebookEdit` مع تعيين `notebook_path` إلى المسار المطلق و`cell_id` إلى معرف الخلية المستهدفة و`new_source` يحتوي على شفرة Python المُصحَّحة. اترك `edit_mode` على قيمته الافتراضية `replace`.
 
-## ملاحظات
+### مثال 2: إدراج شرح markdown
+لإضافة خلية markdown مباشرة بعد خلية `setup` موجودة، اضبط `edit_mode: "insert"` و`cell_type: "markdown"` و`cell_id` لمعرف خلية setup، وضع السرد في `new_source`.
 
-- `cell_number` يبدأ من الصفر (0-indexed)
-- وضع `insert` يُدرج خلية جديدة في الموضع المحدد
-- وضع `delete` يحذف الخلية في الموضع المحدد
-- يجب أن يكون المسار مطلقاً
+### مثال 3: حذف خلية قديمة
+اضبط `edit_mode: "delete"` ومرر `cell_id` للخلية المراد إزالتها. قدِّم أي سلسلة لـ `new_source`؛ فلا تُطبَّق.
 
-## النص الأصلي
+## ملاحظات
 
-<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>
+- مرر دائماً مساراً مطلقاً. لا يحل `NotebookEdit` المسارات النسبية مقابل دليل العمل.
+- تُعيد الأداة كتابة الخلية المستهدفة فقط؛ تبقى أعداد التنفيذ والمخرجات والبيانات الوصفية للخلايا غير المرتبطة كما هي.
+- الإدراج دون `cell_id` يضع الخلية الجديدة في بداية الدفتر تماماً.
+- `cell_type` إلزامي للإدراج. للاستبدالات، احذفه إلا إذا أردت صراحةً تحويل خلية شفرة إلى markdown أو العكس.
+- لفحص الخلايا وأخذ معرفاتها، استخدم أداة `Read` على الدفتر أولاً؛ فهي تُعيد الخلايا بمحتوياتها ومخرجاتها.
+- استخدم `Edit` المعتاد للملفات المصدرية العادية؛ `NotebookEdit` خاص بـ JSON في `.ipynb` ويفهم هيكل خلاياها.

package/concepts/ar/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+يُرسل إشعارًا على سطح المكتب من جلسة Claude Code الحالية. إذا كان التحكم عن بُعد متصلًا، يُرسَل الإشعار أيضًا إلى هاتف المستخدم، ليسترعي انتباهه من أي مكان يتواجد فيه ويعيده إلى الجلسة.
+
+## متى يُستخدم
+
+- اكتملت مهمة طويلة الأمد بينما كان المستخدم على الأرجح بعيدًا عن الطرفية
+- اكتمل بناء البرنامج أو تشغيل الاختبارات أو النشر، والنتيجة جاهزة للمراجعة
+- وُصل إلى نقطة قرار تستلزم مدخلات المستخدم قبل المتابعة
+- ظهر خطأ أو عائق لا يمكن حله بشكل مستقل
+- طلب المستخدم صراحةً إشعاره عند اكتمال مهمة معينة أو تحقق شرط محدد
+
+## متى لا يُستخدم
+
+لا ترسل إشعارًا لتحديثات التقدم الروتينية أثناء تنفيذ مهمة، ولا لتأكيد إجابة سؤال طرحه المستخدم للتو وهو ينتظر ردًا واضحًا. لا ترسل إشعارًا عند انتهاء مهمة قصيرة — إذا أرسل المستخدم المهمة للتو وهو ينتظر، فالإشعار لا قيمة له ويُضعف الثقة في الإشعارات المستقبلية. مِل بشدة نحو عدم الإرسال.
+
+## المعاملات
+
+- `message` (سلسلة نصية، مطلوب): نص الإشعار. احتفظ به أقل من 200 حرف؛ تقوم أنظمة التشغيل للهواتف المحمولة باقتصاص السلاسل الأطول. ابدأ بما سيتصرف المستخدم بناءً عليه: "build failed: 2 auth tests" أكثر فائدة من "task complete".
+- `status` (سلسلة نصية، مطلوب): يُضبط دائمًا على `"proactive"`. هذا معرِّف ثابت ولا يتغير.
+
+## أمثلة
+
+### المثال الأول: الإشعار عند اكتمال تحليل طويل
+
+طُلب إجراء مراجعة شاملة للاعتماديات على مستوى المستودع واستغرق تشغيلها عدة دقائق. غادر المستخدم مكانه. عند جاهزية التقرير:
+
+```
+message: "اكتملت مراجعة الاعتماديات: 3 ثغرات CVE عالية الخطورة في lodash وaxios وjsonwebtoken. التقرير: audit-report.txt"
+status: "proactive"
+```
+
+### المثال الثاني: الإشارة إلى نقطة قرار أثناء العمل المستقل
+
+خلال إعادة هيكلة متعددة الخطوات، اكتُشف أن وحدتين لهما واجهات متعارضة ولا يمكن دمجهما دون قرار تصميمي:
+
+```
+message: "توقفت إعادة الهيكلة: واجهات الرمز في AuthService وUserService متعارضة. يلزم قرارك قبل المتابعة."
+status: "proactive"
+```
+
+## ملاحظات
+
+- مِل بشدة نحو **عدم** الإرسال. الإشعار يقاطع المستخدم بصرف النظر عما يفعله. عامله كتكلفة يجب تبريرها بقيمة المعلومة.
+- ابدأ بمحتوى قابل للتنفيذ. يجب أن تُخبر الكلمات الأولى المستخدم بما حدث وبما يجب فعله إن وُجد — لا بتسمية حالة عامة.
+- احتفظ بـ `message` أقل من 200 حرف. ستقتص أنظمة التشغيل المحمولة السلاسل الأطول، مما قد يُفقد الجزء الأهم إذا كان في النهاية.
+- إذا أشارت النتيجة إلى أن الإرسال لم يتم لأن التحكم عن بُعد غير متصل، فهذا سلوك متوقع. لا حاجة لإعادة المحاولة أو أي إجراء إضافي؛ إشعار سطح المكتب المحلي يُطلَق على أي حال.
+- تجنب إغراق المستخدم بالإشعارات. إذا أُرسلت إشعارات بكثرة لأحداث ثانوية، سيبدأ المستخدم في تجاهلها. احتفظ بهذه الأداة للحظات التي يكون فيها احتمال كبير بأن المستخدم قد ابتعد وسيرغب في معرفة النتيجة الآن.

package/concepts/ar/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## التعريف
+يُحمِّل محتويات ملف واحد من نظام الملفات المحلي. يدعم النصوص العادية والشفرة المصدرية والصور وملفات PDF ودفاتر Jupyter، ويُعيد النتائج بأرقام أسطر تبدأ من 1 بأسلوب `cat -n`.
 
-قراءة محتوى الملفات من نظام الملفات المحلي. يدعم الملفات النصية والصور وPDF وJupyter notebook.
+## متى يُستخدم
+
+- قراءة ملف مصدر في مسار معروف قبل التعديل أو التحليل
+- فحص ملفات الإعدادات أو ملفات القفل أو السجلات أو العناصر المُولَّدة
+- عرض لقطات الشاشة أو المخططات التي لصقها المستخدم في المحادثة
+- استخراج نطاق صفحات محدد من دليل PDF طويل
+- فتح دفتر `.ipynb` لمراجعة خلايا الشفرة وmarkdown ومخرجات الخلايا معاً
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `file_path` | string | نعم | المسار المطلق للملف |
-| `offset` | number | لا | رقم سطر البداية (للقراءة المجزأة للملفات الكبيرة) |
-| `limit` | number | لا | عدد الأسطر المقروءة (للقراءة المجزأة للملفات الكبيرة) |
-| `pages` | string | لا | نطاق صفحات PDF (مثل "1-5"، "3"، "10-20")، ينطبق فقط على PDF |
+- `file_path` (سلسلة، مطلوب): المسار المطلق للملف المستهدف. تُرفض المسارات النسبية.
+- `offset` (عدد صحيح، اختياري): رقم سطر يبدأ من 1 للقراءة منه. مفيد للملفات الكبيرة عند الاقتران بـ `limit`.
+- `limit` (عدد صحيح، اختياري): الحد الأقصى لعدد الأسطر المُعادة ابتداءً من `offset`. الافتراضي 2000 سطر من أعلى الملف عند الحذف.
+- `pages` (سلسلة، اختياري): نطاق الصفحات لملفات PDF، مثل `"1-5"` أو `"3"` أو `"10-20"`. مطلوب لملفات PDF الأطول من 10 صفحات؛ الحد الأقصى 20 صفحة لكل طلب.
+
+## أمثلة
+
+### مثال 1: قراءة ملف صغير بأكمله
+استدعِ `Read` بـ `file_path` فقط مضبوطاً على `/Users/me/project/src/index.ts`. تُعاد حتى 2000 سطر بأرقام الأسطر، وهو عادة كافٍ لسياق التعديل.
 
-## سيناريوهات الاستخدام
+### مثال 2: التصفح عبر سجل طويل
+استخدم `offset: 5001` و`limit: 500` على ملف سجل بآلاف الأسطر لاسترجاع نافذة ضيقة دون إهدار رموز السياق.
 
-**مناسب للاستخدام:**
-- قراءة ملفات الكود وملفات التكوين وغيرها من الملفات النصية
-- عرض ملفات الصور (Claude نموذج متعدد الوسائط)
-- قراءة مستندات PDF
-- قراءة Jupyter notebook (يُرجع جميع الخلايا مع مخرجاتها)
-- قراءة عدة ملفات بالتوازي للحصول على السياق
+### مثال 3: استخراج صفحات PDF محددة
+لملف PDF من 120 صفحة في `/tmp/spec.pdf`، اضبط `pages: "8-15"` لسحب الفصل الذي تحتاجه فقط. حذف `pages` في PDF كبير يُنتج خطأً.
 
-**غير مناسب للاستخدام:**
-- قراءة الأدلة — يجب استخدام أمر `ls` في Bash
-- استكشاف مفتوح لقاعدة الكود — يجب استخدام Task (نوع Explore)
+### مثال 4: عرض صورة
+مرر المسار المطلق للقطة شاشة PNG أو JPG. تُعرض الصورة بصرياً حتى يستطيع Claude Code التفكير فيها مباشرة.
 
 ## ملاحظات
 
-- يجب أن يكون المسار مطلقاً وليس نسبياً
-- يقرأ افتراضياً أول 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>
+- فضِّل دائماً المسارات المطلقة. إذا قدم المستخدم واحداً، فثق به كما هو.
+- تُقطع الأسطر الأطول من 2000 حرف؛ تعامل مع المحتوى المُعاد على أنه قد يكون مقتطعاً للبيانات العريضة جداً.
+- قراءة عدة ملفات مستقلة؟ أصدر عدة استدعاءات `Read` في الاستجابة نفسها حتى تعمل بالتوازي.
+- لا يستطيع `Read` سرد الأدلة. استخدم استدعاء `Bash` `ls` أو أداة `Glob` بدلاً منه.
+- قراءة ملف موجود لكنه فارغ تُعيد تذكيراً من النظام بدلاً من بايتات الملف، لذا عالج هذه الإشارة صراحةً.
+- `Read` ناجح مطلوب قبل أن تتمكن من استخدام `Edit` على الملف نفسه في الجلسة الحالية.

package/concepts/ar/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+يستدعي واجهة برمجة تطبيقات المشغّلات البعيدة في claude.ai لإدارة المهام المجدولة وتنفيذ المشغّلات عند الطلب. يتم التعامل مع رمز OAuth داخليًا بواسطة الأداة ولا يتعرض أبدًا للنموذج أو الواجهة البرمجية للسطر.
+
+## متى يُستخدم
+
+- إدارة العوامل البعيدة (المشغّلات) على claude.ai، بما في ذلك سرد المشغّلات الموجودة وفحصها وتحديثها
+- إنشاء مهمة آلية جديدة قائمة على cron تُشغّل عامل Claude وفق جدول زمني متكرر
+- تشغيل مشغّل موجود عند الطلب دون انتظار تشغيله المجدول التالي
+- سرد أو مراجعة جميع المشغّلات الحالية للاطلاع على إعداداتها وحالتها
+- تحديث إعدادات المشغّل كالجدول الزمني أو الحمولة أو الوصف دون الحاجة إلى إعادة إنشائه
+
+## المعاملات
+
+- `action` (string، مطلوب): العملية المراد تنفيذها — إحدى القيم `list` أو `get` أو `create` أو `update` أو `run`
+- `trigger_id` (string، مطلوب لـ `get` و`update` و`run`): معرّف المشغّل المراد تنفيذ العملية عليه؛ يجب أن يطابق النمط `^[\w-]+$` (أحرف الكلمات والشرطات فقط)
+- `body` (object، مطلوب لـ `create` و`update`؛ اختياري لـ `run`): حمولة الطلب المرسلة إلى الواجهة البرمجية
+
+## أمثلة
+
+### مثال 1: سرد جميع المشغّلات
+
+```json
+{
+  "action": "list"
+}
+```
+
+يستدعي `GET /v1/code/triggers` ويُعيد مصفوفة JSON بجميع المشغّلات المرتبطة بالحساب المصادق عليه.
+
+### مثال 2: إنشاء مشغّل جديد يعمل كل صباح في أيام الأسبوع
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "إنشاء ملخص يومي في كل يوم عمل الساعة 08:00 UTC"
+  }
+}
+```
+
+يستدعي `POST /v1/code/triggers` مع الجسم المقدَّم ويُعيد كائن المشغّل المنشأ حديثًا متضمنًا `trigger_id` المخصص له.
+
+### مثال 3: تشغيل مشغّل عند الطلب
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+يستدعي فورًا `POST /v1/code/triggers/my-report-trigger/run`، متجاوزًا الوقت المجدول.
+
+### مثال 4: جلب مشغّل واحد
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+يستدعي `GET /v1/code/triggers/my-report-trigger` ويُعيد الإعداد الكامل للمشغّل.
+
+## ملاحظات
+
+- يتم حقن رمز OAuth داخل العملية بواسطة الأداة — لا تقم أبدًا بنسخ الرموز أو لصقها أو تسجيلها يدويًا؛ فذلك يُشكّل خطرًا أمنيًا وهو أمر غير ضروري عند استخدام هذه الأداة.
+- يُفضَّل استخدام هذه الأداة بدلًا من `curl` المباشر أو غيره من عملاء HTTP لجميع استدعاءات واجهة برمجة تطبيقات المشغّلات؛ إذ إن الاستخدام المباشر لـ HTTP يتجاوز الحقن الآمن للرمز وقد يكشف بيانات الاعتماد.
+- تُعيد الأداة استجابة JSON الخام من الواجهة البرمجية؛ ويتحمل المُستدعي مسؤولية تحليل الاستجابة والتعامل مع رموز حالة الأخطاء.
+- يجب أن تتطابق قيمة `trigger_id` مع النمط `^[\w-]+$` — يُسمح فقط بالأحرف الأبجدية الرقمية والشرطات السفلية والشرطات؛ وستؤدي المسافات أو الأحرف الخاصة إلى فشل الطلب.

package/concepts/ar/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+يُجدوِل موعد استئناف العمل في الوضع الديناميكي `/loop`. تتيح هذه الأداة لـ Claude إدارة وتيرة تكرارات المهمة ذاتيًا، بالدخول في وضع السكون للمدة المختارة ثم إعادة التشغيل بنفس موجّه الحلقة.
+
+## متى يُستخدم
+
+- لإدارة وتيرة مهمة ديناميكية `/loop` بشكل ذاتي حيث يعتمد فاصل التكرار على حالة العمل لا على ساعة ثابتة
+- لانتظار اكتمال بناء طويل أو نشر أو تشغيل اختبارات قبل فحص النتائج
+- لإدراج علامات انتظار خامل بين التكرارات عندما لا يوجد إشارة محددة للمراقبة في الوقت الحالي
+- لتشغيل حلقة مستقلة بدون موجّه من المستخدم — مرّر الـ sentinel الحرفي `<<autonomous-loop-dynamic>>` كـ `prompt`
+- لاستطلاع حالة عملية على وشك التغيير (استخدم تأخيرًا قصيرًا للحفاظ على دفء الذاكرة المؤقتة)
+
+## المعاملات
+
+- `delaySeconds` (رقم، مطلوب): الثواني حتى الاستئناف. يقيّد وقت التشغيل القيمة تلقائيًا في النطاق `[60, 3600]`، لذا لا يلزم التقييد اليدوي.
+- `reason` (نص، مطلوب): جملة قصيرة تشرح التأخير المختار. تُعرض للمستخدم وتُسجَّل في بيانات القياس عن بُعد. كن محددًا — "التحقق من بناء bun الطويل" أفيد من "في انتظار."
+- `prompt` (نص، مطلوب): إدخال `/loop` الذي يُطلَق عند الاستيقاظ. مرّر نفس النص في كل دور لكي يُكرر التشغيل التالي المهمة. في حالة حلقة مستقلة بدون موجّه من المستخدم، مرّر الـ sentinel الحرفي `<<autonomous-loop-dynamic>>`.
+
+## أمثلة
+
+### مثال 1: تأخير قصير لإعادة التحقق من إشارة سريعة التغيير (الحفاظ على دفء الذاكرة المؤقتة)
+
+بدأ البناء للتو ويستغرق عادةً دقيقتين إلى ثلاث دقائق.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "التحقق من بناء bun المتوقع اكتماله خلال ~2 دقيقة",
+  "prompt": "التحقق من حالة البناء والإبلاغ عن أي أخطاء"
+}
+```
+
+120 ثانية تحافظ على سياق المحادثة في الذاكرة المؤقتة لـ Anthropic (TTL 5 دقائق)، مما يجعل الاستيقاظ التالي أسرع وأرخص.
+
+### مثال 2: علامة انتظار خامل طويلة (قبول إغفال الذاكرة المؤقتة، وتوزيعه على فترة انتظار أطول)
+
+تجري عملية ترحيل قاعدة البيانات وتستغرق عادةً 20–40 دقيقة.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "الترحيل يستغرق عادةً 20–40 دقيقة؛ التحقق بعد 20 دقيقة",
+  "prompt": "التحقق من حالة الترحيل والمتابعة عند الاكتمال"
+}
+```
+
+ستكون الذاكرة المؤقتة باردة عند الاستيقاظ، لكن انتظار 20 دقيقة يعوّض بما يكفي تكلفة إغفال الذاكرة المؤقتة الواحد. الاستطلاع كل 5 دقائق سيدفع نفس تكلفة الإغفال 4 مرات دون أي فائدة.
+
+## ملاحظات
+
+- **مدة صلاحية الذاكرة المؤقتة 5 دقائق**: تنتهي صلاحية الذاكرة المؤقتة لـ Anthropic بعد 300 ثانية. التأخيرات أقل من 300 ثانية تحافظ على دفء السياق؛ التأخيرات فوق 300 ثانية تُسبب إغفال الذاكرة المؤقتة في الاستيقاظ التالي.
+- **تجنب 300 ثانية بالضبط**: هذا أسوأ الحالتين — تدفع ثمن إغفال الذاكرة المؤقتة دون الحصول على فترة انتظار أطول بشكل ملموس. إما انخفض إلى 270 ثانية (حافظ على دفء الذاكرة المؤقتة) أو التزم بـ 1200 ثانية أو أكثر (إغفال واحد يشتري انتظارًا أطول بكثير).
+- **القيمة الافتراضية للانتظار الخامل**: عندما لا توجد إشارة محددة للمراقبة، استخدم **1200–1800 ثانية** (20–30 دقيقة). يتيح ذلك للحلقة التحقق دوريًا دون إهدار الذاكرة المؤقتة 12 مرة في الساعة دون سبب.
+- **التقييد التلقائي**: يقيّد وقت التشغيل `delaySeconds` في النطاق `[60, 3600]`. القيم أقل من 60 تصبح 60؛ القيم فوق 3600 تصبح 3600. لا يلزم التعامل مع هذه الحدود يدويًا.
+- **احذف الاستدعاء لإنهاء الحلقة**: إذا كنت تنوي إيقاف التكرارات، لا تستدعِ ScheduleWakeup. مجرد حذف الاستدعاء ينهي الحلقة.
+- **مرّر نفس `prompt` في كل دور**: يجب أن يحمل حقل `prompt` تعليمات `/loop` الأصلية في كل استدعاء حتى يعرف الاستيقاظ التالي أي مهمة يستأنف.