Add comments explaining the purpose of int cast

Author: dati18

app/Http/Controllers/ConversionMetricController.php

@@ -34,13 +34,16 @@ public function index(Request $request) {
             $daysSinceLastEdit = null;
 
             if ($wikiLastEditedTime !== null) {
+                // Cast to int to avoid fractional-day values in CSV/JSON and keep cutoff logic predictable.
                 $daysSinceLastEdit = (int) $wikiLastEditedTime->diffInDays($current_date, false);
             }
 
             if ($daysSinceLastEdit !== null && $daysSinceLastEdit >= 90) {
+                // Keep exported duration as whole days for stable reporting.
                 $time_before_wiki_abandoned_days = (int) $wiki->created_at->diffInDays($wikiLastEditedTime, false);
             }
             if ($wikiFirstEditedTime !== null) {
+                // Keep exported duration as whole days for stable reporting.
                 $time_to_engage_days = (int) $wiki->created_at->diffInDays($wikiFirstEditedTime, false);
             }
             $wiki_number_of_editors = $wiki->wikiSiteStats()->first()['activeusers'] ?? null;

app/Jobs/PlatformStatsSummaryJob.php

@@ -132,6 +132,7 @@ public function prepareStats(array $allStats, $wikis): array {
             // is it edited in the last 90 days?
             if (!is_null($stats['lastEdit'])) {
                 $lastTimestamp = MWTimestampHelper::getCarbonFromMWTimestamp(intval($stats['lastEdit']));
+                // Carbon can return fractional seconds; cast to int so threshold checks use whole-second precision.
                 $diff = (int) $lastTimestamp->diffInSeconds($currentTime, true);
 
                 if ($diff <= $this->inactiveThreshold) {

app/Jobs/SendEmptyWikiNotificationsJob.php

@@ -34,6 +34,7 @@ public function checkIfWikiIsOldAndEmpty(Wiki $wiki) {
         $emptyDaysThreshold = config('wbstack.wiki_empty_notification_threshold');
         $createdAt = $wiki->created_at;
         $now = CarbonImmutable::now();
+        // Normalize to whole days so comparisons with the integer config threshold stay deterministic.
         $emptyWikiDays = (int) $createdAt->diffInDays($now, true);
 
         $firstEdited = $wiki->wikiLifecycleEvents->first_edited;