قاعدة المعرفة: التغييرات غير المتوافقة

قائمة التغييرات حسب الإصدار التي قد تتطلب إجراءً عند الترقية.

Notion: إزالة client_secret

الالتزام: 6d876c3

أُزيل حقل client_secret من تكوين تكامل Notion كإجراء تقوية أمنية. يستخدم Notion الآن فقط رمز OAuth المخزّن في سلسلة مفاتيح نظام التشغيل.

الإجراء المطلوب: إذا كان triggerfish.yaml يحتوي على حقل notion.client_secret، أزله. سيُتجاهل لكنه قد يسبب ارتباكاً.

تدفق الإعداد الجديد:

triggerfish connect notion

يخزّن هذا رمز التكامل في سلسلة المفاتيح. لا حاجة لسر عميل.

---

أسماء الأدوات: من النقاط إلى الشرطات السفلية

الالتزام: 505a443

غُيّرت جميع أسماء الأدوات من تدوين النقاط (foo.bar) إلى تدوين الشرطة السفلية (foo_bar). بعض مزودي LLM لا يدعمون النقاط في أسماء الأدوات، مما سبّب فشل استدعاءات الأدوات.

الإجراء المطلوب: إذا كانت لديك قواعد سياسة مخصصة أو تعريفات مهارات تشير إلى أسماء أدوات بنقاط، حدّثها لاستخدام الشرطات السفلية:

# قبل
- tool: notion.search

# بعد
- tool: notion_search

---

مُثبّت Windows: من Move-Item إلى Copy-Item

الالتزام: 5e0370f

غُيّر مُثبّت PowerShell لـ Windows من Move-Item -Force إلى Copy-Item -Force لاستبدال الملف التنفيذي أثناء الترقيات. Move-Item لا يُعيد الكتابة فوق الملفات بشكل موثوق على Windows.

الإجراء المطلوب: لا شيء إذا كنت تُثبّت لأول مرة. إذا كنت على إصدار أقدم وفشل triggerfish update على Windows، أوقف الخدمة يدوياً قبل التحديث:

Stop-Service Triggerfish
# ثم أعد تشغيل المُثبّت أو triggerfish update

---

ختم الإصدار: من وقت التشغيل إلى وقت البناء

الالتزامات: e8b0c8c، eae3930، 6ce0c25

نُقلت معلومات الإصدار من الاكتشاف في وقت التشغيل (فحص deno.json) إلى الختم في وقت البناء من وسوم git. لم يعد شعار CLI يعرض سلسلة إصدار مُثبّتة.

الإجراء المطلوب: لا شيء. triggerfish version يستمر في العمل. بناءات التطوير تعرض dev كالإصدار.

---

Signal: من JRE 21 إلى JRE 25

الالتزام: e5b1047

حُدّث المُثبّت التلقائي لقناة Signal لتنزيل JRE 25 (من Adoptium) بدلاً من JRE 21. ثُبّت أيضاً إصدار signal-cli على v0.14.0.

الإجراء المطلوب: إذا كان لديك تثبيت signal-cli موجود بـ JRE أقدم، أعد تشغيل إعداد Signal:

triggerfish config add-channel signal

ينزّل هذا JRE و signal-cli المُحدَّثين.

---

الأسرار: من نص عادي إلى مشفر

تغيّر تنسيق تخزين الأسرار من JSON بنص عادي إلى JSON مشفر بـ AES-256-GCM.

الإجراء المطلوب: لا شيء. الترحيل تلقائي. راجع ترحيل الأسرار للتفاصيل.

بعد الترحيل، يُوصى بتدوير أسرارك لأن نسخ النص العادي كانت مخزّنة سابقاً على القرص.

---

Tidepool: من بروتوكول الاستدعاء إلى بروتوكول Canvas

هاجرت واجهة Tidepool (A2UI) من واجهة TidepoolTools القائمة على الاستدعاءات إلى بروتوكول قائم على canvas.

الملفات المتأثرة:

• src/tools/tidepool/tools/tools_legacy.ts (الواجهة القديمة، مُحتفظ بها للتوافق)
• src/tools/tidepool/tools/tools_canvas.ts (الواجهة الجديدة)

الإجراء المطلوب: إذا كانت لديك مهارات مخصصة تستخدم واجهة استدعاء Tidepool القديمة، ستستمر في العمل عبر الطبقة القديمة. المهارات الجديدة يجب أن تستخدم بروتوكول canvas.

---

التكوين: تنسيق primary القديم بالسلسلة

قبل حقل models.primary كان يقبل سلسلة عادية ("anthropic/claude-sonnet-4-20250514"). الآن يتطلب كائناً:

# قديم (لا يزال مقبولاً للتوافق العكسي)
models:
  primary: "anthropic/claude-sonnet-4-20250514"

# حالي (مُفضَّل)
models:
  primary:
    provider: anthropic
    model: claude-sonnet-4-20250514

الإجراء المطلوب: حدّث إلى تنسيق الكائن. تنسيق السلسلة لا يزال يُحلَّل لكنه قد يُزال في إصدار مستقبلي.

---

تسجيل Console: أُزيل

الالتزام: 9ce1ce5

رُحّلت جميع استدعاءات console.log وconsole.warn وconsole.error الخام إلى المسجّل المنظّم (createLogger()). بما أن Triggerfish يعمل كخدمة خلفية، مخرجات stdout/stderr غير مرئية للمستخدمين. جميع التسجيل الآن يمر عبر كاتب الملفات.

الإجراء المطلوب: لا شيء. إذا كنت تعتمد على مخرجات console للتصحيح (مثل توجيه stdout)، استخدم triggerfish logs بدلاً من ذلك.

---

تقدير الأثر

عند الترقية عبر عدة إصدارات، تحقق من كل إدخال أعلاه. معظم التغييرات متوافقة عكسياً مع ترحيل تلقائي. التغييرات الوحيدة التي تتطلب إجراءً يدوياً هي:

1. إزالة client_secret لـ Notion (أزل الحقل من التكوين)
2. تغيير تنسيق أسماء الأدوات (حدّث قواعد السياسة المخصصة)
3. تحديث JRE لـ Signal (أعد تشغيل إعداد Signal إذا كنت تستخدم Signal)

كل شيء آخر يُعالج تلقائياً.