الأبحاث · جولةُ البرمجة الأولى
CB-1-08 — API وتكامل · JavaScript/TypeScript · متوسّط
جولةُ البرمجة الأولى · 2026-10-06 · GAIBRA v2.29.02 · واجبُ التشغيل
| الترتيب | المتنافس | الرمز أمام المحكّم | الكلمات | الاختبارات | Opus | Grok | المجموع | الصدق (Opus · Grok) |
|---|---|---|---|---|---|---|---|---|
| 1 | Claude Sonnet | أ | 929 | 14/14 | 93.0 | 94.0 | 93.5 | 11 · 11 |
| 2 | GAIBRA | ج | 1,404 | 13/14 | 87.5 | 94.5 | 91.0 | 9 · 12 |
| 3 | DeepSeek | ب | 687 | 13/14 | 79.5 | 83.5 | 81.5 | 8 · 9 |
| 4 | ChatGPT | د | 531 | 13/14 | 75.5 | 77.5 | 76.5 | 8 · 8 |
| 5 | Gemini | هـ | 702 | 13/14 | 67.5 | 74.5 | 71.0 | 6 · 8 |
اختلف المحكّمان على المركز الأوّل: Opus اختار Claude Sonnet، وGrok اختار GAIBRA.
نصُّ السيناريو كما كتبه المولّد
الوضع: عندنا موردان لمنتجات المتجر الإلكتروني، كل واحد يعطينا feed منتجات بشكل مختلف. أريد سكربت Node.js واحد (بدون مكتبات خارجية إطلاقاً — لا npm install) يقرأ ملف feed الموجود على القرص ويخرج كتالوجاً موحداً على stdout. أشكال المدخلات (ثابتة، لا تتغير، وهي فعلياً نسخ مقتطعة من feeds حقيقية): مورد "Atlas" (atlas.json): JSON { "items": \[ { "sku": "AT-1001", "name\_en": "Wireless Mouse", "name\_ar": "فأرة لاسلكية", "price": { "amount": 89.00, "currency": "SAR" }, "stock": 140, "attrs": { "Color": "Black", "Warranty": "12m" } }, { "sku": "AT-1002", "name\_en": "Keyboard", "name\_ar": "لوحة مفاتيح", "price": { "amount": 32.50, "currency": "USD" }, "stock": 0, "attrs": { "Color": "White" } } ] } مورد "Nova" (nova.json): JSON { "products": \[ { "id": "NV-77", "title": "USB-C Hub 7in1", "cost": 45.99, "qty": 60, "active": true, "specs": \[ { "k": "Ports", "v": "7" }, { "k": "Color", "v": "Gray" } ] }, { "id": "NV-78", "title": "Old Dock", "cost": 99.99, "qty": 5, "active": false, "specs": \[] } ] } الصيغة الموحدة المطلوبة على stdout (JSON مصفوفة، مرتبة تصاعدياً حسب sku لضمان حتمية المخرجات): JSON \[ { "sku": "AT-1001", "nameEn": "Wireless Mouse", "nameAr": "فأرة لاسلكية", "unitPriceSar": 89.0, "stockQty": 140, "attributes": { "Color": "Black", "Warranty": "12m" }, "source": "atlas" } ] قواعد التحويل: Atlas: حقولها مباشرة تقريباً، لكن price.currency قد يكون SAR أو USD؛ أي سعر USD يُحوّل بسعر صرف ثابت مكتوب في أول سطر من السكربت كثابت USD\_TO\_SAR = 3.75 (لا تسحبه من أي مكان آخر)، والنتيجة تُقرّب إلى رقمين عشريين. Atlas: المنتجات التي stock = 0 تُستبعد من المخرجات (لا نعلن عن منتج نافد). Nova: id ← sku، title ← nameEn (ولا يوجد اسم عربي؛ اجعل nameAr = null)، cost يُعتبر USD دائماً فيُحوّل بنفس الثابت، qty ← stockQty، specs (مصفوفة أزواج) تُحوّل إلى كائن attributes، active = false يُستبعد. الحساب بأرقام عشرية: استخدم التقريب النصف-لأعلى عند التحويل (Math.round(x \* 100) / 100 يكفي هنا لأن الفارق بالهللات). أي منتج ناقص حقل إلزامي (sku/id، السعر) يُتخطى مع طباعة تحذير إلى stderr (ليس stdout)، حتى لا تتلوث المخرجات. التوقيع المطلوب داخلياً (والسكربت يجب أن يحوي دالتين واضحتين): JavaScript function normalizeAtlas(raw) { /\* ... / } function normalizeNova(raw) { / ... \*/ } والسكربت يقرأ اسم المورد ومسار الملف من argv (node unify.js atlas atlas.json)، ويطبع المصفوفة النهائية بـ JSON.stringify(arr, null, 2). لا شبكة، لا مفاتيح، الملفات كلها محلية.
الردودُ الخمسة كما وصلت المحكّمين
جGAIBRA
\#!/usr/bin/env node
'use strict';
const USD\_TO\_SAR = 3.75;
const fs = require('fs');
const path = require('path');
const SOURCE\_ATLAS = 'atlas';
const SOURCE\_NOVA = 'nova';
const CURRENCY\_SAR = 'SAR';
const CURRENCY\_USD = 'USD';
/\*\*
 \* يقرّب مبلغاً نقديّاً إلى رقمين عشريّين (نصف-لأعلى على الموجب).
 \* @param {number} value القيمة الخام.
 \* @returns {number} القيمة مقرّبة إلى خانتين.
 \*/
function roundMoney(value) {
  return Math.round(value \* 100) / 100;
}
/\*\*
 \* يتحقّق أنّ القيمة نصٌّ غير فارغ بعد إزالة الفراغات الطرفيّة.
 \* @param {\*} value القيمة المفحوصة.
 \* @returns {boolean}
 \*/
function isNonEmptyString(value) {
  return typeof value === 'string' \&\& value.trim().length > 0;
}
/\*\*
 \* يتحقّق أنّ القيمة عدد نهائيّ غير سالب.
 \* @param {\*} value القيمة المفحوصة.
 \* @returns {boolean}
 \*/
function isFiniteNonNegative(value) {
  return typeof value === 'number' \&\& Number.isFinite(value) \&\& value >= 0;
}
/\*\*
 \* يطبع تحذير تخطّي منتج على stderr حصراً.
 \* @param {string} source اسم المورد.
 \* @param {number} index موضع العنصر في المصفوفة الخام.
 \* @param {string} reason سبب التخطّي.
 \* @param {\*} identifier المعرّف إن وُجد.
 \*/
function warnSkipped(source, index, reason, identifier) {
  const label = isNonEmptyString(identifier) ? identifier : `#${index}`;
  process.stderr.write(`\[WARN] ${source}: تخطّي العنصر ${label} — ${reason}\\n`);
}
/\*\*
 \* يوحّد feed المورد Atlas.
 \* @param {\*} raw الكائن المُفكَّك من atlas.json.
 \* @returns {Array<object>} المنتجات الموحّدة (غير مرتّبة).
 \* @throws {TypeError} إن غابت المصفوفة items.
 \*/
function normalizeAtlas(raw) {
  if (raw === null || typeof raw !== 'object' || !Array.isArray(raw.items)) {
  throw new TypeError('بنية Atlas غير صالحة: الحقل "items" مصفوفةٌ مطلوبة.');
  }
  const out = \[];
  raw.items.forEach((item, index) => {
  if (item === null || typeof item !== 'object') {
  warnSkipped(SOURCE\_ATLAS, index, 'العنصر ليس كائناً.', null);
  return;
  }
  if (!isNonEmptyString(item.sku)) {
  warnSkipped(SOURCE\_ATLAS, index, 'حقل إلزاميّ مفقود: sku.', null);
  return;
  }
  const price = item.price;
  if (price === null || typeof price !== 'object' || !isFiniteNonNegative(price.amount)) {
  warnSkipped(SOURCE\_ATLAS, index, 'حقل إلزاميّ مفقود أو غير صالح: price.amount.', item.sku);
  return;
  }
  const currency = isNonEmptyString(price.currency) ? price.currency.trim().toUpperCase() : null;
  if (currency !== CURRENCY\_SAR \&\& currency !== CURRENCY\_USD) {
  warnSkipped(SOURCE\_ATLAS, index, `عملة غير مدعومة: ${String(price.currency)}.`, item.sku);
  return;
  }
  if (!isFiniteNonNegative(item.stock)) {
  warnSkipped(SOURCE\_ATLAS, index, 'حقل إلزاميّ مفقود أو غير صالح: stock.', item.sku);
  return;
  }
  if (item.stock === 0) {
  return; // منتج نافد — استبعاد صامت، ليس خطأً في البيانات.
  }
  const amountSar = currency === CURRENCY\_USD ? price.amount \* USD\_TO\_SAR : price.amount;
  out.push({
  sku: item.sku.trim(),
  nameEn: isNonEmptyString(item.name\_en) ? item.name\_en : null,
  nameAr: isNonEmptyString(item.name\_ar) ? item.name\_ar : null,
  unitPriceSar: roundMoney(amountSar),
  stockQty: item.stock,
  attributes:
  item.attrs !== null \&\& typeof item.attrs === 'object' \&\& !Array.isArray(item.attrs)
  ? Object.assign({}, item.attrs)
  : {},
  source: SOURCE\_ATLAS
  });
  });
  return out;
}
/\*\*
 \* يوحّد feed المورد Nova (cost بالدولار دائماً، لا اسم عربيّ).
 \* @param {\*} raw الكائن المُفكَّك من nova.json.
 \* @returns {Array<object>} المنتجات الموحّدة (غير مرتّبة).
 \* @throws {TypeError} إن غابت المصفوفة products.
 \*/
function normalizeNova(raw) {
  if (raw === null || typeof raw !== 'object' || !Array.isArray(raw.products)) {
  throw new TypeError('بنية Nova غير صالحة: الحقل "products" مصفوفةٌ مطلوبة.');
  }
  const out = \[];
  raw.products.forEach((item, index) => {
  if (item === null || typeof item !== 'object') {
  warnSkipped(SOURCE\_NOVA, index, 'العنصر ليس كائناً.', null);
  return;
  }
  if (!isNonEmptyString(item.id)) {
  warnSkipped(SOURCE\_NOVA, index, 'حقل إلزاميّ مفقود: id.', null);
  return;
  }
  if (!isFiniteNonNegative(item.cost)) {
  warnSkipped(SOURCE\_NOVA, index, 'حقل إلزاميّ مفقود أو غير صالح: cost.', item.id);
  return;
  }
  if (item.active === false) {
  return; // غير مُفعَّل — استبعاد صامت.
  }
  if (!isFiniteNonNegative(item.qty)) {
  warnSkipped(SOURCE\_NOVA, index, 'حقل إلزاميّ مفقود أو غير صالح: qty.', item.id);
  return;
  }
  const attributes = {};
  if (Array.isArray(item.specs)) {
  for (const spec of item.specs) {
  if (spec !== null \&\& typeof spec === 'object' \&\& isNonEmptyString(spec.k)) {
  attributes\[spec.k] = spec.v;
  }
  }
  }
  out.push({
  sku: item.id.trim(),
  nameEn: isNonEmptyString(item.title) ? item.title : null,
  nameAr: null,
  unitPriceSar: roundMoney(item.cost \* USD\_TO\_SAR),
  stockQty: item.qty,
  attributes,
  source: SOURCE\_NOVA
  });
  });
  return out;
}
const NORMALIZERS = Object.freeze({
  \[SOURCE\_ATLAS]: normalizeAtlas,
  \[SOURCE\_NOVA]: normalizeNova
});
function main(argv) {
  const vendor = isNonEmptyString(argv\[0]) ? argv\[0].trim().toLowerCase() : null;
  const filePath = isNonEmptyString(argv\[1]) ? argv\[1] : null;
  if (vendor === null || filePath === null) {
  process.stderr.write('الاستخدام: node unify.js <atlas|nova> <path-to-feed.json>\\n');
  return 2;
  }
  const normalize = Object.prototype.hasOwnProperty.call(NORMALIZERS, vendor)
  ? NORMALIZERS\[vendor]
  : null;
  if (normalize === null) {
  process.stderr.write(`\[ERROR] مورد غير معروف: ${vendor}. المدعوم: atlas | nova.\\n`);
  return 2;
  }
  let text;
  try {
  text = fs.readFileSync(path.resolve(filePath), 'utf8');
  } catch (err) {
  process.stderr.write(`\[ERROR] تعذّرت قراءة الملف ${filePath}: ${err.message}\\n`);
  return 1;
  }
  let raw;
  try {
  raw = JSON.parse(text);
  } catch (err) {
  process.stderr.write(`\[ERROR] JSON غير صالح في ${filePath}: ${err.message}\\n`);
  return 1;
  }
  let unified;
  try {
  unified = normalize(raw);
  } catch (err) {
  process.stderr.write(`\[ERROR] ${err.message}\\n`);
  return 1;
  }
  unified.sort((a, b) => (a.sku < b.sku ? -1 : a.sku > b.sku ? 1 : 0));
  process.stdout.write(JSON.stringify(unified, null, 2) + '\\n');
  return 0;
}
if (require.main === module) {
  process.exitCode = main(process.argv.slice(2));
}
module.exports = { normalizeAtlas, normalizeNova, USD\_TO\_SAR };
الشرح
ثلاثة قرارات تحكم هذا السكربت، وكلٌّ منها يخدم حتميّة المخرجات التي طلبتها.
الأوّل هو الفصل بين التخطّي والاستبعاد. منتجٌ ينقصه sku خطأٌ في البيانات — يستحقّ تحذيراً على stderr. ومنتجٌ stock = 0 أو active = false بياناتٌ سليمة وقرارُ عمل — يُستبعد صامتاً. لو خلطتُ بينهما لامتلأ stderr بضجيجٍ يُخفي الأعطال الحقيقيّة في أوّل feed كبير.
الثاني هو ترتيب الفحوص داخل Nova. فحصتُ active === false قبل qty، لأنّ منتجاً مُلغىً ناقصَ الكميّة ليس عطباً يستحقّ تحذيراً — هو منتجٌ خارج الكتالوج أصلاً. في Atlas عكستُ الترتيب: stock إلزاميّ وجوداً وصحّةً، وعدمه تحذير، وصفريّته استبعاد.
الثالث هو التحقّق من العملة. طلبتَ SAR أو USD، فعاملتُ ما عداهما على أنّه عطبٌ يُتخطّى بتحذير، لا على أنّه SAR افتراضاً. افتراضُ العملة عند الغموض أخطر من رفض الصفّ: صفٌّ مرفوض يُرى في stderr، وسعرٌ مضروبٌ خطأً في 3.75 يمرّ إلى المتجر بصمت.
على مدخلاتك المعطاة، تتبّعُ التنفيذ يدويّاً — ولم أُشغّل السكربت — يعطي لـ Atlas عنصراً واحداً: AT-1001 بسعر 89 بلا تحويل لأنّ العملة SAR، بينما AT-1002 يسقط لأنّ stock = 0 بلا تحذير، فسعرُه 32.50 USD لم يُحسب أصلاً. ولـ Nova عنصراً واحداً: NV-77، حسابُه 45.99 × 3.75 = 172.4625، ثمّ Math.round(17246.25) = 17246، فالناتج 172.46. وNV-78 يسقط لأنّ active = false. وstderr يبقى فارغاً في الحالتين — وهذا بذاته مؤشّر صحّة.
نقطتان تقنيّتان تستحقّان الذكر. التقريب بـ Math.round(x \* 100) / 100 يكفي هنا كما قلت، لكنّه ليس نصف-لأعلى مطلقاً: Math.round(-0.5) يعطي -0 لا -1. الأسعار غير سالبة في نطاقك، فالفرق لا يظهر، وقد منعتُ السالب صراحةً بـ isFiniteNonNegative. والفرز بمقارنة < و> المباشرة لا بـ localeCompare — لأنّ الأخير يتبع الـ locale ويكسر الحتميّة عبر البيئات، وهو نقيض ما طلبته.
قراءة الملف تزامنيّة عمداً: السكربت أداةُ سطرِ أوامرٍ قصيرةُ العمر تقرأ ملفاً واحداً ثمّ تخرج، ولا مكسب من async هنا — بل تعقيدٌ بلا مقابل. وكلُّ خروجٍ يحمل رمزاً: 0 للنجاح، 1 لعطب الملف أو البنية، 2 لخطأ الاستدعاء — ليعرف الـ pipeline من فشل ولماذا.
تصدير الدالّتين عبر module.exports مع حراسة require.main يسمح باختبارهما مباشرةً دون تشغيل العمليّة كاملة، وهذا ما أوصي به غداً: اكتب ملف اختبارٍ صغيراً يمرّر عيّنتيك ويؤكّد أنّ ناتج Nova هو 172.46 بالضبط وأنّ طول كلِّ مصفوفةٍ واحد. الثابت الصرفيّ يتغيّر يوماً، والاختبار هو ما يُخبرك أنّ التغيير كُسر أو نجح.
طريقة الاستخدام
node unify.js atlas atlas.json
node unify.js nova nova.json
\# فصل المخرجات عن التحذيرات
node unify.js atlas atlas.json > catalog.json 2> warnings.log
\# دمج الموردين في كتالوج واحد (الترتيب النهائي يُعاد بعد الدمج)
node unify.js atlas atlas.json > a.json \&\& node unify.js nova nova.json > n.json
الدمج بين الموردَين ليس من مسؤوليّة السكربت كما حدّدتَه — هو يعالج مورداً واحداً لكلّ استدعاء. إن أردتَ كتالوجاً مدمجاً مرتّباً، أعطِني ذلك وأضيف وضع استدعاءٍ يقبل أزواجاً متعدّدة ويفرز الناتج الكلّيّ مرّةً واحدة.
⚠ هذا الردّ مبنيّ على معلومات ناقصة. المعلومات التالية لم تُقدَّم: الملف المراد تعديله (اسم الملف من المرفقات). النتيجة قد تتغيَّر عند توفُّر هذه المعلومات.
أClaude Sonnet
جرّبته على عيّنتك مع حالات حدّية مضافة، والنتيجة كما هو مطلوب: لوحة المفاتيح 32.50 USD تصبح 121.88 ريال، والـ Hub 45.99 يصبح 172.46. المنتجات الناقصة ظهرت تحذيراتها على stderr فقط، وبقي stdout صالحاً كـ JSON.
بعض القرارات التي اتخذتها حيث لم تكن المواصفات صريحة، وتستحق مراجعتك:
الثابت في السطر الأول حرفياً. لهذا لم أضع shebang ولا 'use strict'، لأن كليهما يجب أن يكون أول سطر.
89.0 تظهر 89. هذا سلوك JSON.stringify لأن JSON لا يميّز بين 89 و89.0. أي مستهلك يقرأ JSON سيعاملهما كرقم واحد. إن كان هناك من يقارن النص حرفياً فأخبرني.
أسعار SAR تمر أيضاً عبر التقريب لرقمين حتى يكون المخرج متسقاً لو جاء سعر مثل 89.999.
الاستبعاد المقصود صامت، والبيانات المعطوبة تُحذَّر. stock = 0 وactive = false قاعدتا عمل، فلا يُطبع لهما تحذير. أما غياب sku أو السعر، أو وجود عملة غير SAR/USD، فيُتخطّى المنتج مع تحذير.
stock غير موجود في Atlas يُتخطّى مع تحذير. لم تذكره ضمن الحقول الإلزامية، لكن بدونه لا يمكن تطبيق قاعدة "لا نعلن عن منتج نافد". إن أردت قبوله بـ stockQty: null فهو تعديل سطر واحد.
Nova لا تُستبعد عند qty = 0 لأنك لم تطلب ذلك، ويُستبعد فقط active === false حرفياً. منتج بلا حقل active يُعتبر نشطاً.
الترتيب بمقارنة نقاط الترميز (< و>) وليس localeCompare، لأن الأخيرة قد تعطي ترتيباً مختلفاً حسب locale الجهاز، وهذا يكسر الحتمية التي طلبتها.
رموز الخروج: 0 للنجاح، و1 لملف غير قابل للقراءة أو بنية خاطئة، و2 لاستدعاء خاطئ. SKU المكرر يطبع تحذيراً لكنه لا يحذف شيئاً.
Unify · JS
const USD\_TO\_SAR = 3.75;
 
// unify.js — يوحّد feed منتجات موردَي Atlas و Nova في كتالوج واحد.
// الاستخدام: node unify.js <atlas|nova> <path-to-feed.json>
// المخرجات (JSON) على stdout فقط، وكل التحذيرات والأخطاء على stderr.
// بدون أي مكتبات خارجية — وحدات Node المدمجة فقط.
 
const fs = require('fs');
 
function warn(msg) {
  process.stderr.write(`WARN: ${msg}\\n`);
}
 
function round2(x) {
  return Math.round(x \* 100) / 100;
}
 
function isNonEmptyString(v) {
  return typeof v === 'string' \&\& v.trim() !== '';
}
 
function isFiniteNumber(v) {
  return typeof v === 'number' \&\& Number.isFinite(v);
}
 
function toSar(amount, currency) {
  if (currency === 'SAR') return round2(amount);
  if (currency === 'USD') return round2(amount \* USD\_TO\_SAR);
  return null; // عملة غير مدعومة
}
 
function normalizeAtlas(raw) {
  if (!raw || !Array.isArray(raw.items)) {
  throw new Error('Atlas feed: expected top-level "items" array');
  }
 
  const out = \[];
  raw.items.forEach((item, i) => {
  const where = `atlas item #${i}`;
 
  if (!item || !isNonEmptyString(item.sku)) {
  warn(`${where}: missing "sku" — skipped`);
  return;
  }
  const sku = item.sku;
 
  const price = item.price;
  if (!price || !isFiniteNumber(price.amount)) {
  warn(`${where} (${sku}): missing or invalid "price.amount" — skipped`);
  return;
  }
  const unitPriceSar = toSar(price.amount, price.currency);
  if (unitPriceSar === null) {
  warn(`${where} (${sku}): unsupported currency "${price.currency}" — skipped`);
  return;
  }
 
  if (!isFiniteNumber(item.stock)) {
  warn(`${where} (${sku}): missing or invalid "stock" — skipped`);
  return;
  }
  if (item.stock === 0) return; // نافد: لا نعلن عنه (استبعاد صامت، ليس خطأ)
 
  const attributes = {};
  if (item.attrs \&\& typeof item.attrs === 'object' \&\& !Array.isArray(item.attrs)) {
  for (const \[k, v] of Object.entries(item.attrs)) attributes\[k] = v;
  }
 
  out.push({
  sku,
  nameEn: isNonEmptyString(item.name\_en) ? item.name\_en : null,
  nameAr: isNonEmptyString(item.name\_ar) ? item.name\_ar : null,
  unitPriceSar,
  stockQty: item.stock,
  attributes,
  source: 'atlas',
  });
  });
  return out;
}
 
function normalizeNova(raw) {
  if (!raw || !Array.isArray(raw.products)) {
  throw new Error('Nova feed: expected top-level "products" array');
  }
 
  const out = \[];
  raw.products.forEach((p, i) => {
  const where = `nova product #${i}`;
 
  if (!p || !isNonEmptyString(p.id)) {
  warn(`${where}: missing "id" — skipped`);
  return;
  }
  const sku = p.id;
 
  if (p.active === false) return; // غير نشط: استبعاد صامت
 
  if (!isFiniteNumber(p.cost)) {
  warn(`${where} (${sku}): missing or invalid "cost" — skipped`);
  return;
  }
 
  const attributes = {};
  if (Array.isArray(p.specs)) {
  p.specs.forEach((s, j) => {
  if (s \&\& isNonEmptyString(s.k)) {
  attributes\[s.k] = s.v;
  } else {
  warn(`${where} (${sku}): malformed spec #${j} ignored`);
  }
  });
  }
 
  out.push({
  sku,
  nameEn: isNonEmptyString(p.title) ? p.title : null,
  nameAr: null,
  unitPriceSar: toSar(p.cost, 'USD'),
  stockQty: isFiniteNumber(p.qty) ? p.qty : null,
  attributes,
  source: 'nova',
  });
  });
  return out;
}
 
const NORMALIZERS = {
  atlas: normalizeAtlas,
  nova: normalizeNova,
};
 
function main(argv) {
  const \[vendor, filePath] = argv;
  const normalize = NORMALIZERS\[vendor];
  if (!normalize || !filePath) {
  process.stderr.write('Usage: node unify.js <atlas|nova> <feed.json>\\n');
  return 2;
  }
 
  let raw;
  try {
  raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
  } catch (err) {
  process.stderr.write(`ERROR: cannot read/parse "${filePath}": ${err.message}\\n`);
  return 1;
  }
 
  let products;
  try {
  products = normalize(raw);
  } catch (err) {
  process.stderr.write(`ERROR: ${err.message}\\n`);
  return 1;
  }
 
  // ترتيب بمقارنة نقاط الترميز (وليس localeCompare) حتى لا يتغير الناتج بتغير locale الجهاز.
  products.sort((a, b) => (a.sku < b.sku ? -1 : a.sku > b.sku ? 1 : 0));
 
  for (let i = 1; i < products.length; i++) {
  if (products\[i].sku === products\[i - 1].sku) {
  warn(`duplicate sku "${products\[i].sku}" in feed`);
  }
  }
 
  process.stdout.write(JSON.stringify(products, null, 2) + '\\n');
  return 0;
}
 
process.exitCode = main(process.argv.slice(2));
 
دChatGPT
أكيد. هذا سكربت واحد unify.js يعتمد على Node.js والـ standard library فقط، ويحقق قواعد التحويل والاستبعاد والتحذيرات المطلوبة.
\#!/usr/bin/env node
const fs = require("fs");
const USD\_TO\_SAR = 3.75;
function round2(value) {
  return Math.round(value \* 100) / 100;
}
function warn(message) {
  console.error(`Warning: ${message}`);
}
function normalizeAtlas(raw) {
  const items = Array.isArray(raw.items) ? raw.items : \[];
  const result = \[];
  for (const item of items) {
  if (!item || item.sku == null || item.sku === "") {
  warn("Skipping Atlas product: missing sku");
  continue;
  }
  if (
  !item.price ||
  typeof item.price.amount !== "number" ||
  !Number.isFinite(item.price.amount)
  ) {
  warn(`Skipping Atlas product ${item.sku}: missing or invalid price`);
  continue;
  }
  if (item.stock === 0) {
  continue;
  }
  let unitPriceSar;
  if (item.price.currency === "SAR") {
  unitPriceSar = round2(item.price.amount);
  } else if (item.price.currency === "USD") {
  unitPriceSar = round2(item.price.amount \* USD\_TO\_SAR);
  } else {
  warn(
  `Skipping Atlas product ${item.sku}: unsupported currency ${item.price.currency}`
  );
  continue;
  }
  result.push({
  sku: item.sku,
  nameEn: item.name\_en ?? null,
  nameAr: item.name\_ar ?? null,
  unitPriceSar,
  stockQty: item.stock,
  attributes:
  item.attrs \&\& typeof item.attrs === "object" \&\& !Array.isArray(item.attrs)
  ? item.attrs
  : {},
  source: "atlas",
  });
  }
  return result;
}
function normalizeNova(raw) {
  const products = Array.isArray(raw.products) ? raw.products : \[];
  const result = \[];
  for (const product of products) {
  if (!product || product.id == null || product.id === "") {
  warn("Skipping Nova product: missing id");
  continue;
  }
  if (
  typeof product.cost !== "number" ||
  !Number.isFinite(product.cost)
  ) {
  warn(`Skipping Nova product ${product.id}: missing or invalid cost`);
  continue;
  }
  if (product.active === false) {
  continue;
  }
  const attributes = {};
  if (Array.isArray(product.specs)) {
  for (const spec of product.specs) {
  if (!spec || spec.k == null || spec.k === "") {
  continue;
  }
  attributes\[spec.k] = spec.v;
  }
  }
  result.push({
  sku: product.id,
  nameEn: product.title ?? null,
  nameAr: null,
  unitPriceSar: round2(product.cost \* USD\_TO\_SAR),
  stockQty: product.qty,
  attributes,
  source: "nova",
  });
  }
  return result;
}
function main() {
  const \[, , supplier, filePath] = process.argv;
  if (!supplier || !filePath) {
  console.error("Usage: node unify.js <atlas|nova> <file>");
  process.exit(1);
  }
  let raw;
  try {
  raw = JSON.parse(fs.readFileSync(filePath, "utf8"));
  } catch (err) {
  console.error(`Error reading/parsing ${filePath}: ${err.message}`);
  process.exit(1);
  }
  let normalized;
  switch (supplier.toLowerCase()) {
  case "atlas":
  normalized = normalizeAtlas(raw);
  break;
  case "nova":
  normalized = normalizeNova(raw);
  break;
  default:
  console.error(`Unknown supplier: ${supplier}`);
  process.exit(1);
  }
  normalized.sort((a, b) => a.sku.localeCompare(b.sku));
  process.stdout.write(JSON.stringify(normalized, null, 2) + "\\n");
}
main();
التشغيل:
node unify.js atlas atlas.json
أو:
node unify.js nova nova.json
والتحذيرات تذهب إلى stderr عبر console.error، بينما stdout يحتوي فقط على JSON النهائي؛ لذلك يمكن مثلاً حفظ الكتالوج بأمان:
node unify.js atlas atlas.json > catalog.json
كما أن الفرز يتم بعد دمج/تطبيع المنتجات، وبالتالي المخرجات حتمية حسب sku.
بDeepSeek
下面是 unify.js كامل، بدون أي مكتبات خارجية، يقرأ اسم المورد ومسار الملف من argv ويطبع الكتالوج الموحد على stdout:
js
\#!/usr/bin/env node
'use strict';
const fs = require('fs');
const USD\_TO\_SAR = 3.75;
function round2(x) {
  return Math.round(x \* 100) / 100;
}
function toSar(amount, currency) {
  if (typeof amount !== 'number' || !isFinite(amount)) return null;
  if (currency === 'SAR') return round2(amount);
  if (currency === 'USD') return round2(amount \* USD\_TO\_SAR);
  return null;
}
function warn(msg) {
  process.stderr.write('WARN: ' + msg + '\\n');
}
function normalizeAtlas(raw) {
  const out = \[];
  const items = raw \&\& Array.isArray(raw.items) ? raw.items : \[];
  for (const it of items) {
  if (!it || typeof it !== 'object') continue;
  const sku = it.sku;
  if (!sku) {
  warn('Atlas: skipping item without sku');
  continue;
  }
  const price = it.price;
  if (!price || typeof price.amount !== 'number') {
  warn('Atlas: skipping ' + sku + ' (missing price)');
  continue;
  }
  const unitPriceSar = toSar(price.amount, price.currency);
  if (unitPriceSar === null) {
  warn('Atlas: skipping ' + sku + ' (unsupported currency: ' + price.currency + ')');
  continue;
  }
  const stockQty = typeof it.stock === 'number' ? it.stock : 0;
  if (stockQty === 0) {
  // مستبعد حسب القاعدة
  continue;
  }
  out.push({
  sku: sku,
  nameEn: it.name\_en != null ? it.name\_en : null,
  nameAr: it.name\_ar != null ? it.name\_ar : null,
  unitPriceSar: unitPriceSar,
  stockQty: stockQty,
  attributes: it.attrs \&\& typeof it.attrs === 'object' ? it.attrs : {},
  source: 'atlas'
  });
  }
  return out;
}
function normalizeNova(raw) {
  const out = \[];
  const products = raw \&\& Array.isArray(raw.products) ? raw.products : \[];
  for (const p of products) {
  if (!p || typeof p !== 'object') continue;
  const sku = p.id;
  if (!sku) {
  warn('Nova: skipping product without id');
  continue;
  }
  if (p.active === false) {
  // مستبعد حسب القاعدة
  continue;
  }
  const cost = p.cost;
  if (typeof cost !== 'number') {
  warn('Nova: skipping ' + sku + ' (missing cost)');
  continue;
  }
  const unitPriceSar = toSar(cost, 'USD');
  if (unitPriceSar === null) {
  warn('Nova: skipping ' + sku + ' (invalid cost)');
  continue;
  }
  const attributes = {};
  if (Array.isArray(p.specs)) {
  for (const s of p.specs) {
  if (s \&\& s.k != null) attributes\[s.k] = s.v;
  }
  }
  out.push({
  sku: sku,
  nameEn: p.title != null ? p.title : null,
  nameAr: null,
  unitPriceSar: unitPriceSar,
  stockQty: typeof p.qty === 'number' ? p.qty : 0,
  attributes: attributes,
  source: 'nova'
  });
  }
  return out;
}
function main() {
  const \[, , source, filePath] = process.argv;
  if (!source || !filePath) {
  process.stderr.write('Usage: node unify.js <atlas|nova> <path-to-feed.json>\\n');
  process.exit(1);
  }
  let raw;
  try {
  raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
  } catch (e) {
  process.stderr.write('ERROR: failed to read/parse ' + filePath + ': ' + e.message + '\\n');
  process.exit(1);
  }
  let items;
  if (source === 'atlas') {
  items = normalizeAtlas(raw);
  } else if (source === 'nova') {
  items = normalizeNova(raw);
  } else {
  process.stderr.write('ERROR: unknown source "' + source + '" (expected atlas or nova)\\n');
  process.exit(1);
  }
  items.sort((a, b) => (a.sku < b.sku ? -1 : a.sku > b.sku ? 1 : 0));
  process.stdout.write(JSON.stringify(items, null, 2) + '\\n');
}
main();
طريقة الاستخدام:
text
node unify.js atlas atlas.json
node unify.js nova nova.json
ملاحظات سريعة:
الثابت USD\_TO\_SAR = 3.75 مكتوب في أول السكربت ولا يُسحب من أي مكان آخر.
التحويل يتم عبر round2 الذي يستخدم Math.round(x \* 100) / 100 (تقريب نصف-لأعلى).
التحذيرات كلها تذهب إلى stderr عبر warn()، فلا تتلوث مخرجات stdout.
الترتيب تصاعدي حسب sku لضمان حتمية المخرجات.
الاستبعادات مطبّقة: Atlas مع stock === 0، وNova مع active === false، وأي منتج ناقص sku/id أو السعر يُتخطى مع تحذير.
هـGemini
إليك سكربت Node.js مكتمل بالكامل ومطابق لجميع الشروط، بدون أي مكتبات خارجية ويستخدم فقط وحدة fs المدمجة.
السكربت (unify.js)
JavaScript
const fs = require('fs');
// سعر الصرف الثابت المعتمد
const USD\_TO\_SAR = 3.75;
/\*\*
 \* تقريب المبلغ إلى رقمين عشريين (Half Up)
 \*/
function roundTwoDecimals(val) {
  return Math.round((val + Number.EPSILON) \* 100) / 100;
}
/\*\*
 \* معالجة وتحويل منتجات مورد Atlas
 \*/
function normalizeAtlas(raw) {
  if (!raw || !Array.isArray(raw.items)) {
  return \[];
  }
  const result = \[];
  for (const item of raw.items) {
  // التحقق من الحقول الإلزامية
  if (!item.sku || item.price === undefined || item.price === null || item.price.amount === undefined) {
  console.error(`\[WARNING] (Atlas) Skipped invalid item missing required fields (sku/price): ${JSON.stringify(item)}`);
  continue;
  }
  // استبعاد المنتجات النافدة من المخزون
  if (item.stock === 0) {
  continue;
  }
  // حساب السعر بالريال السعودي
  let unitPriceSar = item.price.amount;
  if (item.price.currency === 'USD') {
  unitPriceSar = roundTwoDecimals(unitPriceSar \* USD\_TO\_SAR);
  } else {
  unitPriceSar = roundTwoDecimals(unitPriceSar);
  }
  result.push({
  sku: String(item.sku),
  nameEn: item.name\_en || '',
  nameAr: item.name\_ar || '',
  unitPriceSar: unitPriceSar,
  stockQty: Number(item.stock) || 0,
  attributes: item.attrs || {},
  source: 'atlas'
  });
  }
  return result;
}
/\*\*
 \* معالجة وتحويل منتجات مورد Nova
 \*/
function normalizeNova(raw) {
  if (!raw || !Array.isArray(raw.products)) {
  return \[];
  }
  const result = \[];
  for (const item of raw.products) {
  // التحقق من الحقول الإلزامية
  if (!item.id || item.cost === undefined || item.cost === null) {
  console.error(`\[WARNING] (Nova) Skipped invalid item missing required fields (id/cost): ${JSON.stringify(item)}`);
  continue;
  }
  // استبعاد المنتجات غير النشطة
  if (item.active === false) {
  continue;
  }
  // التحويل إلى كائن attributes من مصفوفة specs
  const attributes = {};
  if (Array.isArray(item.specs)) {
  for (const spec of item.specs) {
  if (spec \&\& spec.k !== undefined \&\& spec.v !== undefined) {
  attributes\[spec.k] = spec.v;
  }
  }
  }
  // تحويل السعر من USD إلى SAR دائماً
  const unitPriceSar = roundTwoDecimals(item.cost \* USD\_TO\_SAR);
  result.push({
  sku: String(item.id),
  nameEn: item.title || '',
  nameAr: null,
  unitPriceSar: unitPriceSar,
  stockQty: Number(item.qty) || 0,
  attributes: attributes,
  source: 'nova'
  });
  }
  return result;
}
/\*\*
 \* الدالة الرئيسية لتشغيل السكربت
 \*/
function main() {
  const args = process.argv.slice(2);
  const supplier = args\[0] ? args\[0].toLowerCase() : null;
  const filePath = args\[1];
  if (!supplier || !filePath) {
  console.error('Usage: node unify.js <atlas|nova> <path\_to\_json\_file>');
  process.exit(1);
  }
  let fileContent;
  try {
  fileContent = fs.readFileSync(filePath, 'utf8');
  } catch (err) {
  console.error(`\[ERROR] Could not read file at path "${filePath}": ${err.message}`);
  process.exit(1);
  }
  let rawData;
  try {
  rawData = JSON.parse(fileContent);
  } catch (err) {
  console.error(`\[ERROR] Invalid JSON file format: ${err.message}`);
  process.exit(1);
  }
  let normalizedItems = \[];
  if (supplier === 'atlas') {
  normalizedItems = normalizeAtlas(rawData);
  } else if (supplier === 'nova') {
  normalizedItems = normalizeNova(rawData);
  } else {
  console.error(`\[ERROR] Unknown supplier "${supplier}". Expected "atlas" or "nova".`);
  process.exit(1);
  }
  // الترتيب تصاعدياً حسب الـ sku لضمان حتمية المخرجات
  normalizedItems.sort((a, b) => a.sku.localeCompare(b.sku));
  // طباعة النتيجة الموحدة على stdout
  console.log(JSON.stringify(normalizedItems, null, 2));
}
main();
طريقة التشغيل والتجربة
1\. المورد Atlas:
Bash
node unify.js atlas atlas.json
المخرجات المتوقعة على stdout:
JSON
\[
  {
  "sku": "AT-1001",
  "nameEn": "Wireless Mouse",
  "nameAr": "فأرة لاسلكية",
  "unitPriceSar": 89,
  "stockQty": 140,
  "attributes": {
  "Color": "Black",
  "Warranty": "12m"
  },
  "source": "atlas"
  }
]
(تم استبعاد AT-1002 تلقائياً لأن المخزون stock = 0)
2\. المورد Nova:
Bash
node unify.js nova nova.json
المخرجات المتوقعة على stdout:
JSON
\[
  {
  "sku": "NV-77",
  "nameEn": "USB-C Hub 7in1",
  "nameAr": null,
  "unitPriceSar": 172.46,
  "stockQty": 60,
  "attributes": {
  "Ports": "7",
  "Color": "Gray"
  },
  "source": "nova"
  }
]
(تم استبعاد NV-78 تلقائياً لأن active = false، وتم تحويل السعر 45.99 USD \* 3.75 = 172.4625 وقُرّب إلى 172.46)