cc-viewer 1.6.182 → 1.6.183

package/concepts/ar/Tool-CronCreate.md

@@ -0,0 +1,57 @@
+# CronCreate
+
+يجدول إدراج موجّه (prompt) في قائمة الانتظار في وقت مستقبلي، سواء لمرة واحدة أو بصورة دورية. يستخدم صيغة cron القياسية ذات الخمسة حقول بتوقيت المستخدم المحلي، دون الحاجة إلى أي تحويل للمنطقة الزمنية.
+
+## متى يُستخدم
+
+- **التذكيرات الفردية**: عندما يرغب المستخدم في تذكيره في وقت محدد ("ذكّرني غدًا الساعة 3 مساءً"). مع `recurring: false` تُحذف المهمة تلقائيًا بعد تنفيذها.
+- **الجداول الدورية**: عندما يتطلب الأمر تنفيذًا متكررًا ("كل يوم عمل الساعة 9 صباحًا"، "كل 30 دقيقة"). تغطي القيمة الافتراضية `recurring: true` هذه الحالة.
+- **حلقات الوكيل المستقل**: لبناء سير عمل تُعيد تشغيل نفسها وفق جدول زمني، كالملخصات اليومية أو فحوصات الحالة الدورية.
+- **المهام الدائمة**: عندما يجب أن يستمر الجدول بعد إعادة تشغيل الجلسة. يؤدي تمرير `durable: true` إلى حفظ المهمة في `.claude/scheduled_tasks.json`.
+- **الأوقات التقريبية**: عندما يقول المستخدم "حوالي الساعة 9" أو "كل ساعة"، ينبغي اختيار قيمة دقائق غير مدورة (مثل `57 8 * * *` أو `7 * * * *`) تجنبًا لتزاحم المستخدمين عند :00 أو :30.
+
+## المعاملات
+
+- `cron` (string، مطلوب): تعبير cron بخمسة حقول وفق التوقيت المحلي للمستخدم. الصيغة: `دقيقة ساعة يوم-الشهر شهر يوم-الأسبوع`. مثال: `"0 9 * * 1-5"` يعني من الاثنين إلى الجمعة الساعة 9:00 صباحًا.
+- `prompt` (string، مطلوب): نص الموجّه الذي يُدرج في قائمة الانتظار عند تشغيل cron — الرسالة الدقيقة التي ترسل إلى REPL في الوقت المحدد.
+- `recurring` (boolean، اختياري، الافتراضي `true`): عند `true` تُنفَّذ المهمة في كل دورة cron مطابقة وتنتهي صلاحيتها تلقائيًا بعد 7 أيام. عند `false` تُنفَّذ مرة واحدة فحسب ثم تُحذف — للتذكيرات الفردية.
+- `durable` (boolean، اختياري، الافتراضي `false`): عند `false` يعيش الجدول في الذاكرة فقط وينتهي مع انتهاء الجلسة. عند `true` تُحفظ المهمة في `.claude/scheduled_tasks.json` وتستمر بعد إعادة التشغيل.
+
+## أمثلة
+
+### مثال 1: تذكير لمرة واحدة
+
+يقول المستخدم: "ذكّرني غدًا الساعة 2:30 مساءً بإرسال التقرير الأسبوعي." بفرض أن غدًا هو 21 أبريل:
+
+```json
+{
+  "cron": "30 14 21 4 *",
+  "prompt": "تذكير: أرسل التقرير الأسبوعي الآن.",
+  "recurring": false,
+  "durable": true
+}
+```
+
+يضمن `recurring: false` حذف المهمة تلقائيًا بعد تنفيذها. يحافظ `durable: true` عليها في حال حدوث إعادة تشغيل قبل ذلك.
+
+### مثال 2: مهمة صباحية دورية في أيام العمل
+
+يقول المستخدم: "كل صباح يوم عمل، لخّص لي المشكلات المفتوحة على GitHub."
+
+```json
+{
+  "cron": "3 9 * * 1-5",
+  "prompt": "لخّص جميع مشكلات GitHub المفتوحة المُسندة إليّ.",
+  "recurring": true,
+  "durable": true
+}
+```
+
+استخدام الدقيقة `3` بدلًا من `0` يتفادى ذروة الحمل عند الساعة المدوّرة. تنتهي صلاحية المهمة تلقائيًا بعد 7 أيام.
+
+## ملاحظات
+
+- **انتهاء صلاحية تلقائي بعد 7 أيام**: تُحذف المهام الدورية تلقائيًا بعد 7 أيام كحد أقصى. إن احتجت إلى جدول أطول، أعد إنشاء المهمة قبل انتهاء صلاحيتها.
+- **التنفيذ عند الخمول فقط**: لا يُدرج `CronCreate` الموجّه في قائمة الانتظار إلا حين لا يعالج REPL طلبًا آخر. إن كان REPL مشغولًا وقت التشغيل، ينتظر الموجّه حتى تنتهي الاستعلام الحالي.
+- **تجنب دقائق :00 و:30**: عند الأوقات التقريبية، اختر قيم دقائق غير مدورة عمدًا لتوزيع حمل النظام. احتفظ بـ :00/:30 للحالات التي يحدد فيها المستخدم تلك الدقيقة بالضبط.
+- **لا حاجة لتحويل المنطقة الزمنية**: يُفسَّر تعبير cron مباشرةً وفق التوقيت المحلي للمستخدم. لا حاجة للتحويل إلى UTC أو أي منطقة زمنية أخرى.

package/concepts/ar/Tool-CronDelete.md

@@ -0,0 +1,43 @@
+# CronDelete
+
+يُلغي مهمة cron مجدولة مسبقاً باستخدام `CronCreate`. يزيلها فوراً من مخزن الجلسة في الذاكرة. لا يُنتج أي أثر إذا كانت المهمة قد حُذفت تلقائياً بالفعل (تُحذف المهام أحادية التنفيذ بعد إطلاقها، وتنتهي صلاحية المهام المتكررة بعد 7 أيام).
+
+## متى يُستخدم
+
+- عندما يطلب المستخدم إيقاف مهمة مجدولة متكررة قبل انتهاء صلاحيتها التلقائية بعد 7 أيام.
+- عندما لا تكون مهمة أحادية التنفيذ ضرورية بعد الآن وينبغي إلغاؤها قبل إطلاقها.
+- عند الحاجة إلى تغيير تعبير الجدولة لمهمة موجودة — احذفها باستخدام `CronDelete`، ثم أعد إنشاءها باستخدام `CronCreate` بالتعبير الجديد.
+- تنظيف عدة مهام قديمة للحفاظ على نظافة مخزن الجلسة.
+
+## المعاملات
+
+- `id` (string، مطلوب): معرّف المهمة الذي أعادته `CronCreate` عند إنشاء المهمة لأول مرة. يجب أن تتطابق هذه القيمة تماماً؛ لا يُدعم البحث التقريبي أو البحث بالاسم.
+
+## أمثلة
+
+### مثال 1: إلغاء مهمة متكررة قيد التشغيل
+
+تم إنشاء مهمة متكررة مسبقاً بمعرّف `"cron_abc123"`. يطلب المستخدم إيقافها.
+
+```
+CronDelete({ id: "cron_abc123" })
+```
+
+تُزال المهمة من مخزن الجلسة ولن تُطلق مجدداً.
+
+### مثال 2: إزالة مهمة أحادية التنفيذ قديمة قبل إطلاقها
+
+جُدولت مهمة أحادية التنفيذ بمعرّف `"cron_xyz789"` للتشغيل بعد 30 دقيقة، لكن المستخدم قرر أنها لم تعد ضرورية.
+
+```
+CronDelete({ id: "cron_xyz789" })
+```
+
+تُلغى المهمة. لن تُنفَّذ أي إجراء عند وصول وقت الإطلاق الأصلي.
+
+## ملاحظات
+
+- يجب الحصول على `id` من القيمة المُعادة بواسطة `CronCreate`. لا توجد طريقة للبحث عن مهمة بالوصف أو الاستدعاء الخلفي — احفظ المعرّف إذا كنت قد تحتاج إلى الإلغاء لاحقاً.
+- إذا كانت المهمة قد حُذفت تلقائياً بالفعل (أُطلقت كمهمة أحادية التنفيذ، أو وصلت إلى انتهاء الصلاحية المتكررة بعد 7 أيام)، فإن استدعاء `CronDelete` بذلك المعرّف لا يُنتج أي أثر ولن يُولّد خطأ.
+- يؤثر `CronDelete` فقط على الجلسة الحالية في الذاكرة. إذا كانت بيئة التشغيل لا تحفظ حالة cron عبر إعادة التشغيل، ستُفقد المهام المجدولة عند إعادة التشغيل بغض النظر عمّا إذا كان `CronDelete` قد استُدعي أم لا.
+- لا توجد عملية حذف جماعي؛ قم بإلغاء كل مهمة بشكل فردي باستخدام `id` الخاص بها.

package/concepts/ar/Tool-CronList.md

@@ -0,0 +1,30 @@
+# CronList
+
+يسرد جميع مهام cron المجدولة عبر `CronCreate` في الجلسة الحالية. يُعيد ملخصاً لكل مهمة cron نشطة يتضمن `id` والتعبير الزمني cron و`prompt` المختصر وعلامة `recurring` وعلامة `durable` وموعد التشغيل التالي.
+
+## متى يُستخدم
+
+- لمراجعة جميع المهام المجدولة حالياً قبل إجراء تغييرات أو إنهاء الجلسة.
+- للعثور على `id` الصحيح لمهمة ما قبل استدعاء `CronDelete` لحذفها.
+- لتشخيص سبب عدم تشغيل مهمة متوقعة، من خلال التحقق من وجودها وموعد تشغيلها التالي.
+- للتأكد من أن مهمة لمرة واحدة (غير متكررة) لم تُنفَّذ بعد وما زالت في انتظار التشغيل.
+
+## المعاملات
+
+لا شيء.
+
+## أمثلة
+
+### مثال 1: مراجعة جميع المهام المجدولة
+
+استدع `CronList` بدون أي وسيطات للحصول على القائمة الكاملة لجميع مهام cron النشطة. تتضمن الاستجابة لكل مهمة: `id` والتعبير الزمني cron الذي يحدد جدولها الزمني ونسخة مختصرة من `prompt` الذي ستُنفذه وما إذا كانت `recurring` (متكررة) وما إذا كانت `durable` (مستمرة عبر إعادة التشغيل) وموعد التشغيل التالي المجدول.
+
+### مثال 2: تحديد id مهمة متكررة معينة
+
+إذا أنشأت عدة مهام cron وتحتاج إلى حذف مهمة متكررة محددة، فاستدع `CronList` أولاً. تصفَّح القائمة المُعادة للعثور على المهمة التي يتطابق ملخص `prompt` والتعبير الزمني cron الخاص بها مع المهمة المراد حذفها. انسخ `id` الخاص بها ومرره إلى `CronDelete`.
+
+## ملاحظات
+
+- تُعرض فقط المهام التي أُنشئت في الجلسة الحالية، ما لم تُنشأ باستخدام `durable: true`، مما يتيح لها الاستمرار عبر إعادة تشغيل الجلسة.
+- حقل `prompt` في الملخص مُختصَر؛ إذ يعرض فقط بداية نص الأمر الكامل وليس المحتوى بالكامل.
+- تُحذف المهام لمرة واحدة (حيث تكون `recurring` بقيمة `false`) التي سبق تشغيلها تلقائياً ولن تظهر بعد ذلك في القائمة.

package/concepts/ar/Tool-Edit.md

@@ -1,46 +1,38 @@
 # Edit
 
-## التعريف
+يُنفِّذ استبدال سلسلة نصية دقيق داخل ملف قائم. هي الطريقة المفضلة لتعديل الملفات لأن ما يُرسَل هو الفارق فقط، ما يُبقي التعديلات دقيقة وقابلة للتدقيق.
 
-تحرير الملفات عبر استبدال نصي دقيق. يستبدل `old_string` بـ `new_string` في الملف.
+## متى يُستخدم
 
-## المعاملات
+- إصلاح علة في دالة واحدة دون إعادة كتابة الملف المحيط
+- تحديث قيمة إعداد أو سلسلة إصدار أو مسار استيراد
+- إعادة تسمية رمز عبر ملف باستخدام `replace_all`
+- إدراج كتلة قرب علامة مرجعية (وسِّع `old_string` ليشمل سياقاً قريباً، ثم قدِّم الاستبدال)
+- تطبيق تعديلات صغيرة محددة النطاق ضمن إعادة هيكلة متعددة الخطوات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `file_path` | string | نعم | المسار المطلق للملف المراد تعديله |
-| `old_string` | string | نعم | النص الأصلي المراد استبداله |
-| `new_string` | string | نعم | النص الجديد بعد الاستبدال (يجب أن يختلف عن old_string) |
-| `replace_all` | boolean | لا | هل يتم استبدال جميع التطابقات، الافتراضي `false` |
+## المعاملات
 
-## سيناريوهات الاستخدام
+- `file_path` (سلسلة، مطلوب): المسار المطلق للملف المراد تعديله.
+- `old_string` (سلسلة، مطلوب): النص المضبوط المطلوب البحث عنه. يجب أن يتطابق حرفاً حرفاً، بما في ذلك المسافات البيضاء والمسافة البادئة.
+- `new_string` (سلسلة، مطلوب): نص الاستبدال. يجب أن يختلف عن `old_string`.
+- `replace_all` (قيمة منطقية، اختياري): عندما تكون `true`، يستبدل كل ورود لـ `old_string`. الافتراضي `false`، ويتطلب أن يكون التطابق فريداً.
 
-**مناسب للاستخدام:**
-- تعديل أجزاء محددة من الكود في ملفات موجودة
-- إصلاح الأخطاء وتحديث المنطق
-- إعادة تسمية المتغيرات (مع `replace_all: true`)
-- أي سيناريو يتطلب تعديلاً دقيقاً لمحتوى الملف
+## أمثلة
 
-**غير مناسب للاستخدام:**
-- إنشاء ملفات جديدة — يجب استخدام Write
-- إعادة كتابة واسعة النطاق — قد يتطلب Write للكتابة فوق الملف بالكامل
+### مثال 1: إصلاح موقع استدعاء واحد
+اضبط `old_string` على السطر الدقيق `const port = 3000;` و`new_string` على `const port = process.env.PORT ?? 3000;`. التطابق فريد لذا يمكن إبقاء `replace_all` على قيمته الافتراضية.
 
-## ملاحظات
+### مثال 2: إعادة تسمية رمز عبر ملف
+لإعادة تسمية `getUser` إلى `fetchUser` في كل مكان داخل `api.ts`، اضبط `old_string: "getUser"` و`new_string: "fetchUser"` و`replace_all: true`.
 
-- يجب قراءة الملف أولاً عبر Read قبل الاستخدام، وإلا سيحدث خطأ
-- يجب أن يكون `old_string` فريداً في الملف، وإلا يفشل التحرير. إذا لم يكن فريداً، يجب توفير مزيد من السياق لجعله فريداً، أو استخدام `replace_all`
-- يجب الحفاظ على المسافة البادئة الأصلية (tab/مسافات) عند تحرير النص، ولا تُضمَّن بادئة أرقام الأسطر من مخرجات Read
-- يُفضل تحرير الملفات الموجودة بدلاً من إنشاء ملفات جديدة
-- يجب أن يختلف `new_string` عن `old_string`
+### مثال 3: إزالة الالتباس في مقتطف متكرر
+إذا ظهر `return null;` في عدة فروع، فوسِّع `old_string` ليشمل سياقاً محيطاً (مثل سطر `if` السابق) حتى يكون التطابق فريداً. وإلا ستُصدر الأداة خطأً بدلاً من التخمين.
 
-## النص الأصلي
-
-<textarea readonly>Performs exact string replacements in files.
+## ملاحظات
 
-Usage:
-- You must use your `Read` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file. 
-- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: spaces + line number + tab. Everything after that tab is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.
-- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
-- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.
-- The edit will FAIL if `old_string` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use `replace_all` to change every instance of `old_string`.
-- Use `replace_all` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.</textarea>
+- يجب عليك استدعاء `Read` على الملف مرة واحدة على الأقل في الجلسة الحالية قبل أن يقبل `Edit` التغييرات. بادئات أرقام الأسطر من مخرجات `Read` ليست جزءاً من محتوى الملف؛ لا تُضمنها في `old_string` أو `new_string`.
+- يجب أن تتطابق المسافات البيضاء تماماً. انتبه للتبويبات مقابل المسافات والمسافات الزائدة في النهاية، خاصةً في YAML وMakefiles وPython.
+- إذا لم يكن `old_string` فريداً وكان `replace_all` هو `false`، يفشل التعديل. إما أن توسِّع السياق أو أن تُفعِّل `replace_all`.
+- فضِّل `Edit` على `Write` كلما كان الملف موجوداً فعلاً؛ إذ يُعيد `Write` كتابة الملف بأكمله ويفقد المحتوى غير المرتبط إن لم تكن حذراً.
+- لإجراء عدة تعديلات غير مترابطة في الملف نفسه، أصدر عدة استدعاءات `Edit` بالتعاقب بدلاً من استبدال واحد كبير وهش.
+- تجنَّب إدخال الرموز التعبيرية أو النصوص التسويقية أو كتل التوثيق غير المطلوبة عند تعديل ملفات المصدر.

package/concepts/ar/Tool-EnterPlanMode.md

@@ -1,128 +1,35 @@
 # EnterPlanMode
 
-## التعريف
+يُحوِّل الجلسة إلى وضع التخطيط، وهو طور استكشاف للقراءة فقط يتحقق فيه المساعد من قاعدة الشفرة ويُعد خطة تنفيذ ملموسة ليعتمدها المستخدم قبل تعديل أي ملفات.
 
-تحويل Claude Code إلى وضع التخطيط، لاستكشاف قاعدة الكود وتصميم الحلول قبل التنفيذ.
+## متى يُستخدم
+
+- عندما يطلب المستخدم تغييراً غير تافه يمتد عبر عدة ملفات أو أنظمة فرعية.
+- عندما تكون المتطلبات غامضة ويحتاج المساعد إلى قراءة الشفرة قبل الالتزام بنهج معين.
+- عندما يُقترح إعادة هيكلة أو ترحيل أو ترقية لتبعية ويكون نطاق الأثر غير واضح.
+- عندما يقول المستخدم صراحةً «خطط لهذا» أو «لنخطط أولاً» أو يطلب مراجعة تصميم.
+- عندما يكون الخطر مرتفعاً بما يكفي بحيث إن الانتقال المباشر إلى التعديلات قد يُهدر عملاً أو يُفسد الحالة.
 
 ## المعاملات
 
-لا توجد معاملات.
+لا يوجد. لا يأخذ `EnterPlanMode` أي وسيطات — استدعِه بكائن معاملات فارغ.
 
-## سيناريوهات الاستخدام
+## أمثلة
 
-**مناسب للاستخدام:**
-- تنفيذ ميزات جديدة — تتطلب قرارات معمارية
-- وجود عدة حلول ممكنة — تتطلب اختيار المستخدم
-- تعديلات الكود تؤثر على السلوك أو البنية الحالية
-- تغييرات متعددة الملفات — قد تشمل أكثر من 2-3 ملفات
-- متطلبات غير واضحة — تحتاج استكشافاً أولاً لفهم النطاق
-- تفضيلات المستخدم مهمة — يمكن أن يكون للتنفيذ عدة اتجاهات معقولة
+### مثال 1: طلب ميزة كبير
 
-**غير مناسب للاستخدام:**
-- إصلاحات سطر واحد أو أسطر قليلة (أخطاء إملائية، أخطاء واضحة)
-- المستخدم أعطى تعليمات محددة جداً
-- مهام البحث/الاستكشاف البحتة — يجب استخدام Task (نوع Explore)
+يطلب المستخدم: «أضف SSO عبر Okta إلى لوحة المشرف». يستدعي المساعد `EnterPlanMode`، ثم يقضي عدة جولات في قراءة وسيطات المصادقة وتخزين الجلسات وحراس المسارات وواجهة تسجيل الدخول الحالية. يكتب خطة تصف التغييرات المطلوبة وخطوات الترحيل وتغطية الاختبارات، ثم يُقدمها عبر `ExitPlanMode` للاعتماد.
 
-## السلوك في وضع التخطيط
+### مثال 2: إعادة هيكلة خطرة
 
-بعد الدخول في وضع التخطيط، يقوم Claude Code بـ:
-1. استخدام أدوات Glob وGrep وRead لاستكشاف قاعدة الكود بعمق
-2. فهم الأنماط والبنية المعمارية الحالية
-3. تصميم خطة التنفيذ
-4. تقديم الخطة للمستخدم للموافقة
-5. استخدام AskUserQuestion للتوضيح عند الحاجة
-6. الخروج عبر ExitPlanMode عندما تكون الخطة جاهزة
+يقول المستخدم: «حوِّل متحكمات REST إلى tRPC». يدخل المساعد وضع التخطيط، ويستعرض كل متحكم، ويُفهرس العقد العام، ويسرد مراحل الطرح (طبقة وسيطة، قراءة مزدوجة، الانتقال الكامل)، ويقترح خطة ترتيبية قبل لمس أي ملف.
 
 ## ملاحظات
 
-- تتطلب هذه الأداة موافقة المستخدم للدخول في وضع التخطيط
-- إذا لم تكن متأكداً من الحاجة للتخطيط، فضّل التخطيط — المواءمة المسبقة أفضل من إعادة العمل
-
-## النص الأصلي
-
-<textarea readonly>Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you into plan mode where you can explore the codebase and design an implementation approach for user approval.
-
-## When to Use This Tool
-
-**Prefer using EnterPlanMode** for implementation tasks unless they're simple. Use it when ANY of these conditions apply:
-
-1. **New Feature Implementation**: Adding meaningful new functionality
-   - Example: "Add a logout button" - where should it go? What should happen on click?
-   - Example: "Add form validation" - what rules? What error messages?
-
-2. **Multiple Valid Approaches**: The task can be solved in several different ways
-   - Example: "Add caching to the API" - could use Redis, in-memory, file-based, etc.
-   - Example: "Improve performance" - many optimization strategies possible
-
-3. **Code Modifications**: Changes that affect existing behavior or structure
-   - Example: "Update the login flow" - what exactly should change?
-   - Example: "Refactor this component" - what's the target architecture?
-
-4. **Architectural Decisions**: The task requires choosing between patterns or technologies
-   - Example: "Add real-time updates" - WebSockets vs SSE vs polling
-   - Example: "Implement state management" - Redux vs Context vs custom solution
-
-5. **Multi-File Changes**: The task will likely touch more than 2-3 files
-   - Example: "Refactor the authentication system"
-   - Example: "Add a new API endpoint with tests"
-
-6. **Unclear Requirements**: You need to explore before understanding the full scope
-   - Example: "Make the app faster" - need to profile and identify bottlenecks
-   - Example: "Fix the bug in checkout" - need to investigate root cause
-
-7. **User Preferences Matter**: The implementation could reasonably go multiple ways
-   - If you would use AskUserQuestion to clarify the approach, use EnterPlanMode instead
-   - Plan mode lets you explore first, then present options with context
-
-## When NOT to Use This Tool
-
-Only skip EnterPlanMode for simple tasks:
-- Single-line or few-line fixes (typos, obvious bugs, small tweaks)
-- Adding a single function with clear requirements
-- Tasks where the user has given very specific, detailed instructions
-- Pure research/exploration tasks (use the Agent tool with explore agent instead)
-
-## What Happens in Plan Mode
-
-In plan mode, you'll:
-1. Thoroughly explore the codebase using Glob, Grep, and Read tools
-2. Understand existing patterns and architecture
-3. Design an implementation approach
-4. Present your plan to the user for approval
-5. Use AskUserQuestion if you need to clarify approaches
-6. Exit plan mode with ExitPlanMode when ready to implement
-
-## Examples
-
-### GOOD - Use EnterPlanMode:
-User: "Add user authentication to the app"
-- Requires architectural decisions (session vs JWT, where to store tokens, middleware structure)
-
-User: "Optimize the database queries"
-- Multiple approaches possible, need to profile first, significant impact
-
-User: "Implement dark mode"
-- Architectural decision on theme system, affects many components
-
-User: "Add a delete button to the user profile"
-- Seems simple but involves: where to place it, confirmation dialog, API call, error handling, state updates
-
-User: "Update the error handling in the API"
-- Affects multiple files, user should approve the approach
-
-### BAD - Don't use EnterPlanMode:
-User: "Fix the typo in the README"
-- Straightforward, no planning needed
-
-User: "Add a console.log to debug this function"
-- Simple, obvious implementation
-
-User: "What files handle routing?"
-- Research task, not implementation planning
-
-## Important Notes
-
-- This tool REQUIRES user approval - they must consent to entering plan mode
-- If unsure whether to use it, err on the side of planning - it's better to get alignment upfront than to redo work
-- Users appreciate being consulted before significant changes are made to their codebase
-</textarea>
+- وضع التخطيط للقراءة فقط بموجب العقد. في داخله، يجب ألا يُشغل المساعد `Edit` أو `Write` أو `NotebookEdit` أو أي أمر صدفة مُعدِّل. استخدم `Read` و`Grep` و`Glob` وأوامر `Bash` غير المدمرة فقط.
+- لا تدخل وضع التخطيط للتعديلات التافهة من سطر واحد، أو للأسئلة البحثية الصرفة، أو للمهام التي حدد فيها المستخدم بالفعل التغيير بتفصيل كامل. العبء يضر أكثر مما ينفع.
+- في وضع Auto، يُثبَّط استخدام وضع التخطيط إلا إذا طلبه المستخدم صراحةً — يُفضل وضع Auto الفعل على التخطيط المسبق.
+- استخدم وضع التخطيط لتقليل التصحيحات في الأعمال المكلفة. خطة من خمس دقائق كثيراً ما توفر ساعة من التعديلات الخاطئة.
+- بمجرد الدخول في وضع التخطيط، ركِّز التحقيق على أجزاء النظام التي ستتغير فعلاً. تجنب الجولات الشاملة في المستودع غير المرتبطة بالمهمة.
+- يجب أن تُكتب الخطة نفسها على القرص في المسار الذي يتوقعه الإطار حتى يستطيع `ExitPlanMode` تقديمها. يجب أن تحتوي الخطة على مسارات ملفات ملموسة وأسماء دوال وخطوات تحقق، لا على نوايا مبهمة.
+- قد يرفض المستخدم الخطة ويطلب تعديلات. كرر داخل وضع التخطيط حتى تُقبل الخطة؛ ثم اخرج بعد ذلك فقط.

package/concepts/ar/Tool-EnterWorktree.md

@@ -1,56 +1,44 @@
 # EnterWorktree
 
-## التعريف
+يُنشئ worktree معزولاً في Git على فرع جديد، أو يُحوِّل الجلسة إلى worktree موجود ضمن المستودع الحالي، حتى يمكن المضي في عمل متوازٍ أو تجريبي دون المساس بالسحب الأساسي.
 
-Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+## متى يُستخدم
 
-## المعاملات
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | No | A name for the worktree. If not provided, a random name is generated. |
-
-## حالات الاستخدام
+- عندما يقول المستخدم صراحةً «worktree» — على سبيل المثال «ابدأ worktree» أو «أنشئ worktree» أو «اعمل في worktree».
+- عندما توجه تعليمات المشروع في `CLAUDE.md` أو الذاكرة الدائمة إلى استخدام worktree للمهمة الحالية.
+- عندما تريد متابعة مهمة أُعدَّت سابقاً كـ worktree (مرر `path` للدخول إليها من جديد).
+- عندما تحتاج عدة فروع تجريبية إلى التعايش على القرص دون تناوب متكرر في السحب.
+- عندما يجب عزل مهمة طويلة الأمد عن تعديلات غير مرتبطة في شجرة العمل الرئيسية.
 
-**مناسب لـ:**
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
-
-**غير مناسب لـ:**
-- The user asks to create/switch branches — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-
-## ملاحظات
-
-- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
-- Must not already be in a worktree
-
-## النص الأصلي
-
-<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+## المعاملات
 
-## When to Use
+- `name` (سلسلة، اختياري): اسم لدليل worktree جديد. يجوز أن يحتوي كل مقطع مفصول بـ `/` على أحرف وأرقام ونقاط وشرطات سفلية وشرطات فقط؛ والسلسلة الكاملة محددة بـ 64 حرفاً. إذا حُذف وكذلك حُذف `path`، يُولَّد اسم عشوائي. متعارض مع `path`.
+- `path` (سلسلة، اختياري): مسار نظام الملفات لـ worktree موجود ضمن المستودع الحالي للتحول إليه. يجب أن يظهر في `git worktree list` لهذا المستودع؛ المسارات التي ليست worktrees مسجلة للمستودع الحالي مرفوضة. متعارض مع `name`.
 
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+## أمثلة
 
-## When NOT to Use
+### مثال 1: إنشاء worktree جديد باسم وصفي
 
-- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-- Never use this tool unless the user explicitly mentions "worktree"
+```
+EnterWorktree(name="feat/okta-sso")
+```
 
-## Requirements
+يُنشئ `.claude/worktrees/feat/okta-sso` على فرع جديد مستند إلى `HEAD`، ثم يُحوِّل دليل عمل الجلسة إليه. تعمل جميع تعديلات الملفات وأوامر الصدفة اللاحقة داخل ذلك الـ worktree حتى تخرج منه.
 
-- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
-- Must not already be in a worktree
+### مثال 2: إعادة الدخول إلى worktree موجود
 
-## Behavior
+```
+EnterWorktree(path="/Users/me/repo/.claude/worktrees/feat/okta-sso")
+```
 
-- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
-- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
-- Switches the session's working directory to the new worktree
-- On session exit, the user will be prompted to keep or remove the worktree
+يستأنف العمل في worktree أُنشئ سابقاً. وبما أنك دخلته عبر `path`، فإن `ExitWorktree` لن يحذفه تلقائياً — الخروج بـ `action: "keep"` يعود ببساطة إلى الدليل الأصلي.
 
-## Parameters
+## ملاحظات
 
-- `name` (optional): A name for the worktree. If not provided, a random name is generated.
-</textarea>
+- لا تستدعِ `EnterWorktree` إلا إذا طلب المستخدم ذلك صراحةً أو اشترطته تعليمات المشروع. يجب أن تستخدم طلبات تبديل الفرع العادية أو إصلاح العلل أوامر Git الاعتيادية، لا worktrees.
+- عند الاستدعاء داخل مستودع Git، تُنشئ الأداة worktree تحت `.claude/worktrees/` وتُسجِّل فرعاً جديداً مستنداً إلى `HEAD`. خارج مستودع Git، تُفوض إلى خطافات `WorktreeCreate` / `WorktreeRemove` المهيأة في `settings.json` لعزل مستقل عن نظام التحكم بالإصدار.
+- جلسة worktree واحدة فقط تكون نشطة في وقت واحد. ترفض الأداة التشغيل إذا كنت بالفعل داخل جلسة worktree؛ اخرج أولاً بـ `ExitWorktree`.
+- استخدم `ExitWorktree` للمغادرة في منتصف الجلسة. إذا انتهت الجلسة بينما لا تزال داخل worktree أُنشئ حديثاً، يُطلب من المستخدم الاحتفاظ به أو إزالته.
+- تُعتبر worktrees التي دخلت إليها عبر `path` خارجية — لن يحذفها `ExitWorktree` بـ `action: "remove"`. هذه حاجز أمان لحماية الـ worktrees التي يديرها المستخدم يدوياً.
+- يَرث worktree جديد محتويات الفرع الحالي لكن لديه دليل عمل وفهرس مستقلان. التغييرات المُرحَّلة وغير المُرحَّلة في السحب الرئيسي ليست مرئية داخل الـ worktree.
+- نصيحة في التسمية: اسبق بنوع العمل (`feat/`، `fix/`، `spike/`) حتى يسهل تمييز عدة worktrees متزامنة في `git worktree list`.

package/concepts/ar/Tool-ExitPlanMode.md

@@ -1,62 +1,42 @@
 # ExitPlanMode
 
-## التعريف
+يُقدم خطة التنفيذ التي أُعدت أثناء وضع التخطيط لاعتماد المستخدم، ثم — إذا اعتُمدت — ينقل الجلسة خارج وضع التخطيط حتى يمكن أن تبدأ التعديلات.
 
-الخروج من وضع التخطيط وتقديم الخطة للمستخدم للموافقة. يُقرأ محتوى الخطة من ملف الخطة المكتوب مسبقاً.
+## متى يُستخدم
 
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `allowedPrompts` | array | لا | قائمة أوصاف الأذونات المطلوبة لخطة التنفيذ |
-
-كل عنصر في مصفوفة `allowedPrompts`:
-
-| الحقل | النوع | مطلوب | الوصف |
-|-------|-------|-------|-------|
-| `tool` | enum | نعم | الأداة المعنية، حالياً يُدعم فقط `Bash` |
-| `prompt` | string | نعم | وصف دلالي للعملية (مثل "run tests"، "install dependencies") |
-
-## سيناريوهات الاستخدام
+- عندما تكتمل خطة كُتبت خلال `EnterPlanMode` وتصبح جاهزة للمراجعة.
+- عندما تكون المهمة موجهة نحو التنفيذ (تغييرات شفرة أو إعدادات)، لا بحثاً صرفاً، فالخطة الصريحة مناسبة.
+- عندما تكون جميع القراءة والتحليل التمهيدية منجزة؛ لا حاجة لمزيد من التحقيق قبل أن يقرر المستخدم.
+- عندما يكون المساعد قد عدَّد مسارات ملفات ودوال وخطوات ملموسة — لا مجرد أهداف.
+- عندما يطلب المستخدم رؤية الخطة، أو عندما يوشك سير عمل وضع التخطيط على التسليم إلى أدوات التعديل.
 
-**مناسب للاستخدام:**
-- اكتملت الخطة في وضع التخطيط وجاهزة لتقديمها لموافقة المستخدم
-- يُستخدم فقط لمهام التنفيذ التي تتطلب كتابة كود
-
-**غير مناسب للاستخدام:**
-- مهام البحث/الاستكشاف البحتة — لا حاجة للخروج من وضع التخطيط
-- السؤال "هل الخطة مقبولة؟" — هذا بالضبط وظيفة هذه الأداة، لا تستخدم AskUserQuestion لذلك
-
-## ملاحظات
+## المعاملات
 
-- هذه الأداة لا تقبل محتوى الخطة كمعامل — تقرأ من ملف الخطة المكتوب مسبقاً
-- سيرى المستخدم محتوى ملف الخطة للموافقة
-- لا تستخدم AskUserQuestion قبل استدعاء هذه الأداة للسؤال "هل الخطة مقبولة"، فهذا تكرار
-- لا تذكر "الخطة" في الأسئلة، لأن المستخدم لا يرى محتوى الخطة قبل ExitPlanMode
+- `allowedPrompts` (مصفوفة، اختياري): مطالبات يمكن للمستخدم كتابتها في شاشة الاعتماد لاعتماد الخطة تلقائياً أو تعديلها. يحدد كل عنصر صلاحية مُحدَّدة النطاق (على سبيل المثال، اسم عملية والأداة التي تنطبق عليها). اتركها غير مضبوطة لاستخدام تدفق الاعتماد الافتراضي.
 
-## النص الأصلي
+## أمثلة
 
-<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.
+### مثال 1: تقديم قياسي
 
-## 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
+بعد التحقق من إعادة هيكلة المصادقة داخل وضع التخطيط وكتابة ملف الخطة على القرص، يستدعي المساعد `ExitPlanMode` دون وسيطات. يقرأ الإطار الخطة من موقعها القانوني، ويعرضها على المستخدم، وينتظر الاعتماد أو الرفض.
 
-## 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.
+### مثال 2: إجراءات سريعة معتمدة مسبقاً
 
-## 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
+```
+ExitPlanMode(allowedPrompts=[
+  {"tool": "Bash", "prompt": "run tests"},
+  {"tool": "Bash", "prompt": "install dependencies"}
+])
+```
 
-**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>
+- لا معنى لـ `ExitPlanMode` إلا في العمل بطابع التنفيذ. إذا كان طلب المستخدم مهمة بحث أو شرح بلا تغييرات في الملفات، فأجب مباشرةً — لا تتوجه عبر وضع التخطيط لمجرد الخروج منه.
+- يجب أن تكون الخطة مكتوبة على القرص قبل استدعاء هذه الأداة. لا يقبل `ExitPlanMode` متن الخطة كمعامل؛ إذ يقرأ من المسار الذي يتوقعه الإطار.
+- إذا رفض المستخدم الخطة، تعود إلى وضع التخطيط. راجع بناءً على الملاحظات وقدم مرة أخرى؛ لا تبدأ في تعديل الملفات بينما الخطة غير معتمدة.
+- الاعتماد يمنح الإذن بمغادرة وضع التخطيط واستخدام الأدوات المُعدِّلة (`Edit` و`Write` و`Bash` وغيرها) للنطاق الموصوف في الخطة. توسيع النطاق بعد ذلك يتطلب خطة جديدة أو موافقة صريحة من المستخدم.
+- لا تستخدم `AskUserQuestion` لسؤال «هل تبدو هذه الخطة جيدة؟» قبل استدعاء هذه الأداة — طلب اعتماد الخطة هو بالضبط ما يفعله `ExitPlanMode`، ولا يستطيع المستخدم رؤية الخطة قبل تقديمها.
+- اجعل الخطة ضئيلة وقابلة للتنفيذ. ينبغي أن يستطيع المراجع تصفحها في أقل من دقيقة وأن يفهم تحديداً ما سيتغير.
+- إذا أدركت في منتصف التنفيذ أن الخطة كانت خاطئة، توقف وأبلغ المستخدم بدلاً من الانحراف بصمت. إعادة الدخول إلى وضع التخطيط خطوة صالحة.

package/concepts/ar/Tool-ExitWorktree.md

@@ -0,0 +1,41 @@
+# ExitWorktree
+
+يُنهي جلسة worktree أُنشئت مسبقاً بواسطة `EnterWorktree` ويُعيد الجلسة إلى دليل العمل الأصلي. يعمل هذا الأداة حصراً على worktrees التي أنشأتها `EnterWorktree` في الجلسة الحالية؛ إذا لم تكن هناك جلسة نشطة من هذا النوع، فإن الاستدعاء لا يُحدث أي تأثير.
+
+## متى يُستخدم
+
+- اكتمل العمل في worktree معزول وتريد العودة إلى دليل العمل الرئيسي.
+- انتهت مهمة في worktree لفرع ميزة وبعد الدمج تريد حذف الفرع والمجلد.
+- تريد الاحتفاظ بـ worktree لاستخدامه لاحقاً والعودة فقط إلى الدليل الأصلي دون حذف أي شيء.
+- تريد التخلي عن فرع تجريبي أو مؤقت دون ترك أي بيانات على القرص.
+- تحتاج إلى بدء جلسة `EnterWorktree` جديدة، مما يستلزم الخروج من الجلسة الحالية أولاً.
+
+## المعاملات
+
+- `action` (نص، مطلوب): `"keep"` يحتفظ بمجلد worktree والفرع على القرص للعودة إليهما لاحقاً؛ `"remove"` يحذف المجلد والفرع معاً لإجراء خروج نظيف.
+- `discard_changes` (قيمة منطقية، اختياري، الافتراضي `false`): ذو معنى فقط عندما يكون `action` هو `"remove"`. إذا احتوى worktree على ملفات غير مُحفوظة (uncommitted) أو commits غير موجودة في الفرع الأصلي، يرفض الأداة الحذف ما لم يُضبط `discard_changes` على `true`. تُدرج استجابة الخطأ التغييرات المحددة لتتمكن من تأكيدها مع المستخدم قبل إعادة الاستدعاء.
+
+## أمثلة
+
+### مثال 1: خروج نظيف بعد دمج التغييرات
+
+بعد إنهاء العمل في worktree ودمج الفرع في main، استدع `ExitWorktree` مع `action: "remove"` لحذف مجلد worktree والفرع والعودة إلى دليل العمل الأصلي.
+
+```
+ExitWorktree(action: "remove")
+```
+
+### مثال 2: التخلص من worktree مؤقت يحتوي على كود تجريبي غير محفوظ
+
+إذا احتوى worktree على تغييرات تجريبية غير محفوظة يجب التخلص منها كلياً، جرب أولاً `action: "remove"`. سيرفض الأداة ويُدرج التغييرات غير المحفوظة. بعد تأكيد المستخدم أن التغييرات يمكن التخلص منها، أعد الاستدعاء مع `discard_changes: true`.
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## ملاحظات
+
+- يعمل هذا الأداة حصراً على worktrees أنشأتها `EnterWorktree` في الجلسة الحالية. لن يؤثر على worktrees المُنشأة بـ `git worktree add`، أو worktrees من جلسات سابقة، أو دليل العمل العادي إذا لم تُستدعَ `EnterWorktree` قط — في هذه الحالات يكون الاستدعاء بلا تأثير.
+- يُرفض `action: "remove"` إذا احتوى worktree على تغييرات غير محفوظة أو commits غير موجودة في الفرع الأصلي، ما لم يُقدَّم `discard_changes: true` صراحةً. تأكد دائماً مع المستخدم قبل ضبط `discard_changes: true`، إذ لا يمكن استرداد البيانات بعد حذفها.
+- إذا كانت جلسة tmux مرتبطة بـ worktree: عند `remove` تُنهى الجلسة؛ عند `keep` تستمر في العمل ويُعاد اسمها حتى يتمكن المستخدم من إعادة الاتصال لاحقاً.
+- بعد اكتمال `ExitWorktree`، يمكن استدعاء `EnterWorktree` مرة أخرى لبدء جلسة worktree جديدة.