أمثلة السكربتات

// قالب «تثبيت» — يراقب قالب «حفظ» (الفهرس 0)
{
  "watchedTemplateIndex": 0,
  "behaviorIndex": 0,
  "enabled": true
}

// قالب «مراجعة» — يراقب قالب «حفظ» بدالة نظام جاهزة
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "ربط الحد الأعلى",
  "enabled": true
}

/**
 * link-behavior-config
 * watched: progress, amount, direction
 * target: progress, amount, direction, startSurah, startAya, navigationSettings.upperBound, navigationSettings.lowerBound, mode
 */
function onPlanChanged(input) {
    if (input.updatedPlan.type !== "quran" || input.targetPlan.type !== "quran") {
        return { updates: {} };
    }

    var updates = {};
    var dir = Number(input.updatedPlan.direction) || 1;

    // 1. مزامنة الاتجاه: التأكد من مطابقة اتجاه الهدف لمصدر التغيير
    if (input.targetPlan.direction !== dir) {
        updates.direction = dir;
    }

    var fullMushafNav = buildNavSettings(null);

    // 2. جلب قيمة التكوين الخاصة بـ "عدد الأيام" من الإعدادات
    var MULTIPLIER = (typeof config !== "undefined" && config && config.MULTIPLIER !== undefined)
                     ? Number(config.MULTIPLIER)
                     : 4;

    var hifzAmount = Number(input.updatedPlan.amount) || 15;

    // 3. مزامنة المقدار: مقدار الهدف = عدد الأيام × مقدار المصدر
    var targetAmount = MULTIPLIER * hifzAmount;
    if (!Number.isFinite(targetAmount) || targetAmount < 1) {
        return { updates: {}, errors: ["مقدار التثبيت غير صالح"] };
    }
    if (Number(input.targetPlan.amount) !== targetAmount) {
        updates.amount = targetAmount;
    }

    var newHifzPos = {
        sura: input.updatedPlan.progress.currentSurah,
        aya: input.updatedPlan.progress.currentAya
    };

    var currentTathbeetPos = {
        sura: input.targetPlan.progress.currentSurah,
        aya: input.targetPlan.progress.currentAya
    };

    var finalTathbeetPos = currentTathbeetPos;
    var forceReposition = false;

    var prevVerseObj = mushaf.previousVerse(newHifzPos, dir, fullMushafNav);
    var endBoundPos = prevVerseObj ? { sura: prevVerseObj.sura, aya: prevVerseObj.number } : newHifzPos;

    var minAllowedDist = MULTIPLIER * hifzAmount;
    var maxAllowedDist = (MULTIPLIER + 1) * hifzAmount;

    var isOut = mushaf.isOutOfBounds(currentTathbeetPos, dir, {
        upperBound: dir === 1 ? fullMushafNav.upperBound : endBoundPos,
        lowerBound: dir === 1 ? endBoundPos : fullMushafNav.lowerBound
    });

    if (isOut) {
        forceReposition = true;
    } else {
        var currentDist = mushaf.calculateLines(currentTathbeetPos, newHifzPos, dir, fullMushafNav);
        if (currentDist < minAllowedDist || currentDist > maxAllowedDist) {
            forceReposition = true;
        }
    }

    if (forceReposition) {
        var targetRes = mushaf.reverseNavigate({
            from: newHifzPos,
            lines: minAllowedDist,
            direction: dir,
            settings: fullMushafNav
        });
        if (!targetRes || !targetRes.verse) {
            return { updates: {}, errors: ["تعذر حساب موضع التثبيت"] };
        }

        finalTathbeetPos = {
            sura: targetRes.verse.sura,
            aya: targetRes.verse.number
        };

        updates.progress = {
            currentSurah: finalTathbeetPos.sura,
            currentAya: finalTathbeetPos.aya
        };
    }

    var isTargetFirst = finalTathbeetPos.sura < endBoundPos.sura ||
                       (finalTathbeetPos.sura === endBoundPos.sura && finalTathbeetPos.aya <= endBoundPos.aya);

    var newUpper = isTargetFirst ? { sura: finalTathbeetPos.sura, aya: finalTathbeetPos.aya } : { sura: endBoundPos.sura, aya: endBoundPos.aya };
    var newLower = isTargetFirst ? { sura: endBoundPos.sura, aya: endBoundPos.aya } : { sura: finalTathbeetPos.sura, aya: finalTathbeetPos.aya };

    var oldUpper = input.targetPlan.navigationSettings && input.targetPlan.navigationSettings.upperBound;
    var oldLower = input.targetPlan.navigationSettings && input.targetPlan.navigationSettings.lowerBound;

    if (!oldUpper || oldUpper.sura !== newUpper.sura || oldUpper.aya !== newUpper.aya) {
        updates["navigationSettings.upperBound"] = newUpper;
    }
    if (!oldLower || oldLower.sura !== newLower.sura || oldLower.aya !== newLower.aya) {
        updates["navigationSettings.lowerBound"] = newLower;
    }

    var keys = getDirectionalBoundKeys(dir);
    var startBound = keys.startBound === "upperBound" ? newUpper : newLower;
    if (Number(input.targetPlan.startSurah) !== startBound.sura) {
        updates.startSurah = startBound.sura;
    }
    if (Number(input.targetPlan.startAya) !== startBound.aya) {
        updates.startAya = startBound.aya;
    }

    // تحويل حرّة/ديناميكية → ثابتة؛ لا يُستدعى إن كانت ثابتة أصلاً
    var modeTrans = undefined;
    if (input.targetPlan.mode !== "static") {
        var r = PlanConverter.toStatic(input.targetPlan, {
            amount: targetAmount,
            reason: "sync:tathbeet-made-static",
            progress: {
                currentSurah: finalTathbeetPos.sura,
                currentAya: finalTathbeetPos.aya
            },
            startSurah: startBound.sura,
            startAya: startBound.aya,
            direction: dir,
            navigationSettings: { upperBound: newUpper, lowerBound: newLower }
        });
        if (!r.ok) {
            return { updates: {}, errors: r.errors };
        }
        modeTrans = r.modeTransition;
    }

    if (Object.keys(updates).length === 0 && !modeTrans) {
        return { updates: {} };
    }

    var output = { updates: updates };
    if (modeTrans) {
        output.modeTransition = modeTrans;
    }
    return output;
}

// قالب «حفظ» (الفهرس 0) — يراقب نفسه
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "تحديد المستوى التلقائي",
  "enabled": true,
  "config": { "observationCount": 2, "tolerancePercent": 10 }
}

// قالب «تثبيت» (الفهرس 1) — يراقب «حفظ»
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "تثبيت",
  "enabled": true,
  "config": { "MULTIPLIER": 3 }
}

// قالب «مراجعة» (الفهرس 2) — رابطان
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "ربط الحد الأعلى",
  "enabled": true,
  "config": { "syncDirection": true }
}
{
  "watchedTemplateIndex": 2,
  "platformBehaviorId": "تحديد المستوى التلقائي",
  "enabled": true,
  "config": { "observationCount": 2, "tolerancePercent": 10 }
}

/**
 * link-behavior-config
 * watched: progress, numberOfActivities
 * target: amount, metadata, mode
 */function onPlanChanged(input) {
  if (input.changeKind !== "activity") return { updates: {} };
  if (input.trigger.action !== "created") return { updates: {} };

  var meta = input.targetPlan.metadata || {};

  if (meta.evaluationDone) return { updates: {} };

  var updates = {};
  var modeTrans = undefined;

  // التأكد من أن الخطة حرة أثناء التقييم
  if (input.targetPlan.mode !== "free") {
     var freeResult = PlanConverter.toFree(input.targetPlan, { reason: "adaptive:evaluation-phase" });
     if (freeResult.ok) modeTrans = freeResult.modeTransition;
  }

  var amounts = meta.recitationAmounts || [];
  var currentAmount = input.trigger.activity.amount;

  if (currentAmount > 0) amounts.push(currentAmount);

  if (amounts.length < config.observationCount) {
    updates["metadata.recitationAmounts"] = amounts;
    var out = { updates: updates };
    if (modeTrans) out.modeTransition = modeTrans;
    return out;
  }

  // حساب الوسيط
  var sorted = amounts.slice().sort(function(a, b) { return a - b; });
  var mid = Math.floor(sorted.length / 2);
  var median = sorted.length % 2 !== 0 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2.0;

  var tolerance = config.tolerancePercent / 100.0;
  var minAccepted = median * (1 - tolerance);
  var maxAccepted = median * (1 + tolerance);

  var validAmounts = [];
  var sum = 0;
  for (var i = 0; i < amounts.length; i++) {
    if (amounts[i] >= minAccepted && amounts[i] <= maxAccepted) {
      validAmounts.push(amounts[i]);
      sum += amounts[i];
    }
  }

  // --- شرط الاستقرار الجديد ---
  // يجب أن يكون 60% على الأقل من القراءات (3 من 5) ضمن النطاق المقبول
  var requiredStableCount = Math.ceil(config.observationCount * 0.6);
  
  if (validAmounts.length < requiredStableCount) {
      // القراءات متذبذبة! نحذف أقدم قراءة وننتظر تلاوة جديدة (Rolling Window)
      amounts.shift(); 
      updates["metadata.recitationAmounts"] = amounts;
      var pendingOut = { updates: updates };
      if (modeTrans) pendingOut.modeTransition = modeTrans;
      return pendingOut;
  }

  // القراءات مستقرة! نحسب المتوسط ونحول الخطة
  var average = sum / validAmounts.length;
  var finalAmount = Math.round(average); 

  var staticResult = PlanConverter.toStatic(input.targetPlan, {
    amount: finalAmount,
    reason: "adaptive:evaluation-finished"
  });

  if (!staticResult.ok) return { updates: {}, errors: staticResult.errors };

  updates["metadata.recitationAmounts"] = null;
  updates["metadata.evaluationDone"] = true;

  return {
    updates: updates,
    modeTransition: staticResult.modeTransition
  };
}

[
  {
    "name": "لا يعمل إلا مع نشاط جديد",
    "input": {
      "changeKind": "manual",
      "updatedFields": ["progress"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "mode": "free", "metadata": {} }
    },
    "expectedOutput": {}
  },
  {
    "name": "يخزّن أول تلاوة ولا يحوّل الخطة بعد",
    "input": {
      "changeKind": "activity",
      "trigger": { "action": "created", "activity": { "amount": 15 } },
      "updatedFields": ["progress", "numberOfActivities"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "mode": "free", "metadata": {} }
    },
    "expectedOutput": { "metadata.recitationAmounts": [15] }
  }
]

/**
 * link-behavior-config
 * watched: totalGainedAmount
 * target: amount, metadata.initialRecitations, metadata.hasDeterminedLevel, metadata.lastTotalGained
 */function onPlanChanged(input) {
  if (input.updatedPlan.type !== "quran") return { updates: {} };
  
  var meta = input.targetPlan.metadata || {};
  if (meta.hasDeterminedLevel) {
    return { updates: { "metadata.lastTotalGained": input.updatedPlan.totalGainedAmount } };
  }

  var gained = input.updatedPlan.totalGainedAmount - (meta.lastTotalGained || 0);
  if (gained <= 0) return { updates: {} };

  var recitations = meta.initialRecitations || [];
  recitations.push(gained);
  
  var updates = {
    "metadata.lastTotalGained": input.updatedPlan.totalGainedAmount,
    "metadata.initialRecitations": recitations
  };

  var targetCount = (typeof config !== 'undefined' && config.targetSessions !== undefined) ? config.targetSessions : 4;

  // التحقق من التقارب فقط عند الوصول للعدد المطلوب أو أكثر
  if (recitations.length >= targetCount) {
    // نأخذ آخر 4 تسميعات للتحقق من تقاربها
    var lastFour = recitations.slice(-targetCount);
    var min = Math.min.apply(null, lastFour);
    var max = Math.max.apply(null, lastFour);
    var sum = 0;
    for (var k = 0; k < lastFour.length; k++) sum += lastFour[k];
    var avg = sum / lastFour.length;

    // شرط التقارب: الفرق بين الأكبر والأصغر لا يتجاوز 40% من المتوسط (قابل للتعديل)
    if ((max - min) <= (avg * 0.4)) {
      updates.amount = Math.round(avg);
      updates["metadata.hasDeterminedLevel"] = true;
    }
  }

  return { updates: updates };
}

/**
 * link-behavior-config
 * watched: progress
 * target: direction
 */

function onPlanChanged(input) {
  // التأكد من أن التغيير ناتج عن نشاط مسجل
  if (input.changeKind !== "activity" || input.trigger.action !== "created") {
    return { updates: {} };
  }

  var act = input.trigger.activity;

  // التأكد من وجود تقييم للنشاط
  if (typeof act.rating !== "number") {
    return { updates: {} };
  }

  var currentDirection = input.targetPlan.direction;
  var newDirection = currentDirection;

  // تقييم 90 أو أقل (خصم 10 فأكثر) -> من الناس للفاتحة
  if (act.rating <= 90) {
    newDirection = -1;
  } 
  // تقييم 107 أو أعلى (زيادة 7 فأكثر) -> من الفاتحة للناس
  else if (act.rating >= 107) {
    newDirection = 1;
  }

  // تحديث الاتجاه فقط إذا كان هناك تغيير فعلي
  if (newDirection !== currentDirection) {
    return { updates: { direction: newDirection } };
  }

  return { updates: {} };
}

[
  {
    "name": "تقييم ضعيف يقلب الاتجاه صعوداً",
    "input": {
      "changeKind": "activity",
      "trigger": { "action": "created", "activity": { "rating": 85 } },
      "updatedFields": ["progress"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "direction": 1 }
    },
    "expectedOutput": { "direction": -1 }
  },
  {
    "name": "تقييم متوسط لا يغيّر شيئاً",
    "input": {
      "changeKind": "activity",
      "trigger": { "action": "created", "activity": { "rating": 100 } },
      "updatedFields": ["progress"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "direction": 1 }
    },
    "expectedOutput": {}
  }
]

/**
 * link-behavior-config
 * watched: progress
 * target: progress, navigationSettings.lowerBound
 */
const configFields = [
  {
    "id": "sessionWindow",
    "name": "عدد جلسات الحفظ الأخيرة",
    "type": "number",
    "required": false,
    "default": 3,
    "validation": { "min": 1 }
  }
];

function onPlanChanged(input) {
  if (input.updatedPlan.type !== "quran") return { updates: {} };
  if (!input.updatedFields.includes("progress")) return { updates: {} };

  // أسطر التأخير = عدد الجلسات × مقدار جلسة الحفظ
  var offset = config.sessionWindow * (input.updatedPlan.amount || 15);
  return COPY_PROGRESS({ positionOffset: offset, stepBackward: true });
}