@fleetbase/fleetops-engine 0.6.64 → 0.6.66

package/server/tests/Unit/Support/RadarAgendaTest.php

@@ -0,0 +1,200 @@
+<?php
+
+use Fleetbase\FleetOps\Support\Radar\RadarAgenda;
+use Illuminate\Support\Carbon;
+
+function fleetOpsAgendaNow(): Carbon
+{
+    return Carbon::parse('2026-09-15 08:35:00', 'UTC');
+}
+
+function fleetOpsAgendaItem(string $key, array $extra = []): array
+{
+    [$rule] = explode(':', $key);
+
+    return array_merge([
+        'key'        => $key,
+        'rule'       => $rule,
+        'category'   => 'maintenance',
+        'lane'       => 'maintenance',
+        'chip'       => 'Maint',
+        'severity'   => 'warning',
+        'title'      => $key,
+        'subject'    => null,
+        'due_at'     => null,
+        'due_bucket' => 'none',
+        'window'     => null,
+        'state'      => ['status' => 'open'],
+        'actions'    => [],
+        'record'     => null,
+    ], $extra);
+}
+
+function fleetOpsAgendaDriver(string $name, array $extra = []): array
+{
+    $slug = strtolower(str_replace(' ', '', $name));
+
+    return array_merge(['type' => 'driver', 'uuid' => 'driver-' . $slug, 'public_id' => 'driver_' . $slug, 'label' => $name, 'photo_url' => null], $extra);
+}
+
+afterEach(fn () => Carbon::setTestNow());
+
+test('items land in the overdue band, a lane, the later rail or the anytime tray', function () {
+    $now   = fleetOpsAgendaNow();
+    $items = [
+        fleetOpsAgendaItem('maintenance_overdue:a', ['due_at' => '2026-09-12T08:00:00+00:00', 'due_bucket' => 'overdue']),
+        fleetOpsAgendaItem('maintenance_due_soon:b', ['due_at' => '2026-09-15T14:00:00+00:00', 'due_bucket' => 'today']),
+        fleetOpsAgendaItem('license_expiring:c', ['category' => 'compliance', 'lane' => 'expiries', 'due_at' => '2026-09-21T00:00:00+00:00', 'due_bucket' => 'week']),
+        fleetOpsAgendaItem('notice:d', ['category' => 'notices', 'lane' => 'notices', 'due_at' => '2026-09-16T06:00:00+00:00', 'due_bucket' => 'later']),
+        fleetOpsAgendaItem('issue_open:e', ['category' => 'issues', 'lane' => 'anytime']),
+        fleetOpsAgendaItem('part_low_stock:f', ['category' => 'parts', 'lane' => 'anytime', 'state' => ['status' => 'open', 'planned_at' => '2026-09-15T16:00:00+00:00']]),
+        fleetOpsAgendaItem('fuel_unmatched:g', ['category' => 'fuel', 'lane' => 'anytime', 'state' => ['status' => 'snoozed', 'snoozed_until' => '2026-09-18T08:00:00+00:00']]),
+    ];
+
+    $day = RadarAgenda::build($items, [], '24h', $now);
+
+    expect($day['window']['key'])->toBe('24h')
+        ->and($day['window']['start_at'])->toBe('2026-09-15T08:00:00+00:00')
+        ->and($day['window']['end_at'])->toBe('2026-09-16T08:00:00+00:00')
+        ->and($day['window']['now_pct'])->toBe(2.43)
+        ->and(array_column($day['window']['ticks'], 'label'))->toBe(['08', '10', '12', '14', '16', '18', '20', '22', '00', '02', '04', '06', '08'])
+        ->and(array_column($day['overdue'], 'key'))->toBe(['maintenance_overdue:a'])
+        ->and(array_column($day['lanes']['maintenance'], 'key'))->toBe(['maintenance_due_soon:b', 'part_low_stock:f'])
+        ->and($day['lanes']['maintenance'][0]['pct'])->toBe(25.0)
+        ->and($day['lanes']['maintenance'][0]['label'])->toBe('14:00')
+        ->and($day['lanes']['maintenance'][1]['planned'])->toBeTrue()
+        ->and(array_column($day['lanes']['notices'], 'key'))->toBe(['notice:d'])
+        ->and(array_column($day['later'], 'key'))->toBe(['license_expiring:c'])
+        ->and(array_column($day['anytime'], 'key'))->toBe(['issue_open:e'], 'snoozed items are not on the agenda')
+        ->and($day['counts'])->toBe(['overdue' => 1, 'later' => 1, 'anytime' => 1, 'shifts' => 0]);
+
+    $week = RadarAgenda::build($items, [], '7d', $now);
+    expect($week['window']['hours'])->toBe(168)
+        ->and(array_column($week['lanes']['expiries'], 'key'))->toBe(['license_expiring:c'], 'the 7-day window absorbs the later rail')
+        ->and($week['later'])->toBe([])
+        ->and($week['window']['ticks'][1]['label'])->toBe('Wed 16');
+
+    expect(RadarAgenda::build($items, [], 'bogus', $now)['window']['key'])->toBe('24h');
+});
+
+test('every live shift is a bar on the shifts lane carrying its gaps and handover', function () {
+    $now    = fleetOpsAgendaNow();
+    $ortega = fleetOpsAgendaDriver('Luis Ortega');
+    $diallo = fleetOpsAgendaDriver('Amara Diallo');
+    $items  = [
+        fleetOpsAgendaItem('shift_handover:driver_luisortega', ['category' => 'staffing', 'lane' => 'shifts', 'subject' => $ortega, 'window' => ['start_at' => '2026-09-15T01:15:00+00:00', 'end_at' => '2026-09-15T09:15:00+00:00'], 'due_at' => '2026-09-15T09:15:00+00:00', 'due_bucket' => 'today', 'source' => ['active_orders' => 2]]),
+        fleetOpsAgendaItem('shift_late_start:driver_amaradiallo', ['category' => 'staffing', 'lane' => 'shifts', 'severity' => 'critical', 'subject' => $diallo, 'window' => ['start_at' => '2026-09-15T08:00:00+00:00', 'end_at' => '2026-09-15T16:00:00+00:00']]),
+    ];
+    $shifts = [
+        ['uuid' => 'sh1', 'public_id' => 'shift_1', 'start_at' => '2026-09-15 01:15:00', 'end_at' => '2026-09-15 09:15:00', 'status' => 'in_progress', 'driver' => $ortega, 'driver_online' => true, 'active_orders' => 2],
+        ['uuid' => 'sh2', 'public_id' => 'shift_2', 'start_at' => '2026-09-15 08:00:00', 'end_at' => '2026-09-15 16:00:00', 'status' => 'scheduled', 'driver' => $diallo, 'driver_online' => false, 'active_orders' => 0],
+        ['uuid' => 'sh3', 'public_id' => 'shift_3', 'start_at' => '2026-09-15 14:00:00', 'end_at' => '2026-09-15 21:00:00', 'status' => 'scheduled', 'driver' => fleetOpsAgendaDriver('Tomas Alves'), 'driver_online' => false, 'active_orders' => 0],
+        ['uuid' => 'sh4', 'public_id' => 'shift_4', 'start_at' => '2026-09-17 06:00:00', 'end_at' => '2026-09-17 14:00:00', 'status' => 'scheduled', 'driver' => fleetOpsAgendaDriver('Far Away'), 'driver_online' => false, 'active_orders' => 0],
+        ['uuid' => 'sh5', 'public_id' => 'shift_5', 'start_at' => '2026-09-14 20:00:00', 'end_at' => '2026-09-15 04:00:00', 'status' => 'completed', 'driver' => fleetOpsAgendaDriver('Night Done'), 'driver_online' => false, 'active_orders' => 0],
+    ];
+
+    $day  = RadarAgenda::build($items, $shifts, '24h', $now);
+    $lane = collect($day['lanes']['shifts']);
+    $bars = $lane->where('kind', 'shift')->keyBy('key');
+
+    expect($bars->keys()->all())->toBe(['shift:shift_1', 'shift:shift_2', 'shift:shift_3'])
+        ->and($bars['shift:shift_1']['state'])->toBe('on_shift')
+        ->and($bars['shift:shift_1']['pct'])->toBe(0.0)
+        ->and($bars['shift:shift_1']['width_pct'])->toBe(5.21)
+        ->and($bars['shift:shift_1']['handover_key'])->toBe('shift_handover:driver_luisortega')
+        ->and($bars['shift:shift_1']['gap_keys'])->toBe(['shift_handover:driver_luisortega'])
+        ->and($bars['shift:shift_2']['state'])->toBe('not_online')
+        ->and($bars['shift:shift_2']['severity'])->toBe('critical')
+        ->and($bars['shift:shift_3']['state'])->toBe('upcoming')
+        ->and($bars['shift:shift_3']['pct'])->toBe(25.0)
+        ->and($bars['shift:shift_3']['label'])->toBe('14:00–21:00')
+        ->and($lane->where('kind', 'item')->pluck('key')->all())->toBe(['shift_late_start:driver_amaradiallo', 'shift_handover:driver_luisortega'], 'a live gap sits at the now line, ahead of the 09:15 handover')
+        ->and($day['counts']['shifts'])->toBe(5);
+});
+
+test('a handover card lists the orders and suggests the nearest on-shift driver with capacity', function () {
+    $now    = fleetOpsAgendaNow();
+    $ortega = fleetOpsAgendaDriver('Luis Ortega');
+    $alves  = fleetOpsAgendaDriver('Tomas Alves');
+    $kim    = fleetOpsAgendaDriver('Rin Kim');
+    $full   = fleetOpsAgendaDriver('Full Driver');
+    $early  = fleetOpsAgendaDriver('Ends Early');
+    $items  = [
+        fleetOpsAgendaItem('shift_handover:driver_luisortega', ['category' => 'staffing', 'lane' => 'shifts', 'subject' => $ortega, 'window' => ['start_at' => '2026-09-15T01:15:00+00:00', 'end_at' => '2026-09-15T09:15:00+00:00'], 'due_at' => '2026-09-15T09:15:00+00:00', 'due_bucket' => 'today', 'source' => ['active_orders' => 2], 'record' => ['route' => 'management.drivers.index.details', 'model' => 'driver_luisortega']]),
+    ];
+    $shifts = [
+        ['uuid' => 'sh1', 'start_at' => '2026-09-15 01:15:00', 'end_at' => '2026-09-15 09:15:00', 'status' => 'in_progress', 'driver' => $ortega, 'driver_online' => true],
+        ['uuid' => 'sh2', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 21:00:00', 'status' => 'in_progress', 'driver' => $alves, 'driver_online' => true],
+        ['uuid' => 'sh3', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 18:00:00', 'status' => 'in_progress', 'driver' => $kim, 'driver_online' => true],
+        ['uuid' => 'sh4', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 18:00:00', 'status' => 'in_progress', 'driver' => $full, 'driver_online' => true],
+        ['uuid' => 'sh5', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 10:00:00', 'status' => 'in_progress', 'driver' => $early, 'driver_online' => true],
+    ];
+    $drivers = [
+        ['uuid' => 'driver-luisortega', 'location' => ['lat' => 40.70, 'lng' => -73.99], 'active_orders' => 2],
+        ['uuid' => 'driver-tomasalves', 'location' => ['lat' => 40.71, 'lng' => -73.98], 'active_orders' => 2, 'max_daily_orders' => 6],
+        ['uuid' => 'driver-rinkim', 'location' => ['lat' => 40.80, 'lng' => -73.90], 'active_orders' => 0],
+        ['uuid' => 'driver-fulldriver', 'location' => ['lat' => 40.70, 'lng' => -73.99], 'active_orders' => 6],
+        ['uuid' => 'driver-endsearly', 'location' => ['lat' => 40.70, 'lng' => -73.99], 'active_orders' => 0],
+    ];
+    $orders = [
+        'driver-luisortega' => [
+            ['uuid' => 'o1', 'public_id' => 'order_88412', 'status' => 'dispatched', 'destination' => 'Bay Ridge', 'ends_at' => '2026-09-15T09:40:00+00:00'],
+            ['uuid' => 'o2', 'public_id' => 'order_88431', 'status' => 'dispatched', 'destination' => 'Sunset Park', 'ends_at' => '2026-09-15T08:50:00+00:00'],
+        ],
+    ];
+
+    $cards = RadarAgenda::handovers($items, $shifts, $drivers, $orders, $now);
+
+    expect($cards)->toHaveCount(1)
+        ->and($cards[0]['key'])->toBe('shift_handover:driver_luisortega')
+        ->and($cards[0]['shift']['minutes_left'])->toBe(40)
+        ->and($cards[0]['rule'])->toBe('shift_handover')
+        ->and(array_column($cards[0]['orders'], 'finishes_after_shift'))->toBe([true, false])
+        ->and($cards[0]['orders'][0]['destination'])->toBe('Bay Ridge')
+        ->and($cards[0]['suggested']['driver']['label'])->toBe('Tomas Alves')
+        ->and($cards[0]['suggested']['distance_km'])->toBe(1.4)
+        ->and($cards[0]['suggested']['capacity_label'])->toBe('2 of 6 orders')
+        ->and($cards[0]['suggested']['on_shift_until'])->toBe('2026-09-15T21:00:00+00:00');
+
+    // Without anyone on shift long enough, the card still exists but has no suggestion.
+    $none = RadarAgenda::handovers($items, [$shifts[0], $shifts[4]], $drivers, $orders, $now);
+    expect($none[0]['suggested'])->toBeNull();
+
+    expect(RadarAgenda::distanceKm(['lat' => 0, 'lng' => 0], ['lat' => 0, 'lng' => 1]))->toBe(111.2)
+        ->and(RadarAgenda::distanceKm(null, ['lat' => 0, 'lng' => 1]))->toBeNull();
+});
+
+test('cover suggestions prefer online drivers, then the nearest, then the least busy', function () {
+    $now      = fleetOpsAgendaNow();
+    $shiftEnd = Carbon::parse('2026-09-15 09:15:00', 'UTC');
+    $shift    = fn (string $name, bool $online) => ['uuid' => 'sh-' . $name, 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 21:00:00', 'status' => 'in_progress', 'driver' => fleetOpsAgendaDriver($name), 'driver_online' => $online];
+
+    $offlineFirst = RadarAgenda::suggestCover('driver-leaving', null, $shiftEnd, [$shift('Offline Olga', false), $shift('Online Omar', true)], [], $now);
+    expect($offlineFirst['driver']['label'])->toBe('Online Omar');
+
+    // With no locations to compare, the driver carrying fewer orders wins.
+    $rows = [
+        'driver-busybea'  => ['uuid' => 'driver-busybea', 'active_orders' => 4],
+        'driver-freefred' => ['uuid' => 'driver-freefred', 'active_orders' => 1],
+    ];
+    $leastBusy = RadarAgenda::suggestCover('driver-leaving', null, $shiftEnd, [$shift('Busy Bea', true), $shift('Free Fred', true)], $rows, $now);
+    expect($leastBusy['driver']['label'])->toBe('Free Fred');
+});
+
+test('a driver with several gaps shows the worst one on their shift bar', function () {
+    $now    = fleetOpsAgendaNow();
+    $driver = fleetOpsAgendaDriver('Amara Diallo');
+    $window = ['start_at' => '2026-09-15T08:00:00+00:00', 'end_at' => '2026-09-15T09:30:00+00:00'];
+    $items  = [
+        fleetOpsAgendaItem('shift_handover:driver_amaradiallo', ['category' => 'staffing', 'lane' => 'shifts', 'severity' => 'warning', 'subject' => $driver, 'window' => $window]),
+        fleetOpsAgendaItem('shift_late_start:driver_amaradiallo', ['category' => 'staffing', 'lane' => 'shifts', 'severity' => 'critical', 'subject' => $driver, 'window' => $window]),
+        fleetOpsAgendaItem('driver_without_vehicle:driver_amaradiallo', ['category' => 'staffing', 'lane' => 'anytime', 'severity' => 'info', 'subject' => $driver]),
+    ];
+    $shifts = [['uuid' => 'sh', 'public_id' => 'shift_a', 'start_at' => '2026-09-15 08:00:00', 'end_at' => '2026-09-15 09:30:00', 'status' => 'scheduled', 'driver' => $driver, 'driver_online' => false]];
+
+    $bar = collect(RadarAgenda::build($items, $shifts, '24h', $now)['lanes']['shifts'])->firstWhere('kind', 'shift');
+
+    expect($bar['severity'])->toBe('critical')
+        ->and($bar['handover_key'])->toBe('shift_handover:driver_amaradiallo')
+        ->and($bar['gap_keys'])->toHaveCount(3);
+});

package/server/tests/Unit/Support/RadarBriefingTest.php

@@ -0,0 +1,214 @@
+<?php
+
+use Fleetbase\FleetOps\Support\Radar\RadarBriefing;
+use Fleetbase\FleetOps\Support\Radar\RadarRules;
+use Illuminate\Support\Carbon;
+
+function fleetOpsBriefNow(): Carbon
+{
+    return Carbon::parse('2026-09-15 08:35:00', 'UTC');
+}
+
+function fleetOpsBriefVehicle(string $id): array
+{
+    return ['type' => 'vehicle', 'class' => 'Fleetbase\FleetOps\Models\Vehicle', 'uuid' => 'vehicle-' . strtolower($id), 'public_id' => 'vehicle_' . strtolower($id), 'label' => $id, 'photo_url' => null];
+}
+
+function fleetOpsBriefDriver(string $name, array $extra = []): array
+{
+    $slug = strtolower(str_replace(' ', '', $name));
+
+    return array_merge(['type' => 'driver', 'class' => 'Fleetbase\FleetOps\Models\Driver', 'uuid' => 'driver-' . $slug, 'public_id' => 'driver_' . $slug, 'name' => $name, 'label' => $name, 'photo_url' => null, 'online' => true, 'vehicle_uuid' => null], $extra);
+}
+
+/**
+ * The morning from the design concept, as RadarRules sees it.
+ */
+function fleetOpsBriefItems(): array
+{
+    $now = fleetOpsBriefNow();
+
+    return RadarRules::build([
+        'schedules' => [
+            ['uuid' => 's1', 'public_id' => 'schedule_oil', 'name' => 'Oil change', 'type' => 'oil_change', 'status' => 'active', 'next_due_date' => '2026-09-12 08:00:00', 'has_open_work_order' => false, 'subject' => fleetOpsBriefVehicle('TRK-118')],
+            ['uuid' => 's2', 'public_id' => 'schedule_tires', 'name' => 'Tire rotation', 'type' => 'tire_rotation', 'status' => 'active', 'next_due_date' => '2026-09-17 12:00:00', 'has_open_work_order' => true, 'subject' => fleetOpsBriefVehicle('TRK-204')],
+        ],
+        'workOrders' => [
+            ['uuid' => 'w1', 'public_id' => 'work_order_2041', 'code' => 'WO-2041', 'subject' => 'brake pad replacement', 'status' => 'in_progress', 'priority' => 'high', 'due_at' => '2026-09-13 09:00:00', 'target' => fleetOpsBriefVehicle('TRK-207'), 'checklist' => [['title' => 'Fit brake pads (PN 8842)']]],
+        ],
+        'inspectionSubmissions' => [
+            ['uuid' => 'a', 'public_id' => 'inspection_submission_a', 'status' => 'submitted', 'result' => 'failed', 'failed_items' => 2, 'issue_uuid' => null, 'work_order_uuid' => null, 'resolved_at' => null, 'form_name' => 'Pre-trip DVIR', 'highest_severity' => 'critical', 'vehicle' => fleetOpsBriefVehicle('VAN-042'), 'driver' => null],
+        ],
+        'shifts' => [
+            ['uuid' => 'sh1', 'public_id' => 'shift_1', 'start_at' => '2026-09-15 08:00:00', 'end_at' => '2026-09-15 16:00:00', 'status' => 'scheduled', 'driver' => fleetOpsBriefDriver('Amara Diallo'), 'driver_online' => false, 'driver_vehicle_uuid' => 'v', 'active_orders' => 0],
+            ['uuid' => 'sh2', 'public_id' => 'shift_2', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 14:00:00', 'status' => 'in_progress', 'driver' => fleetOpsBriefDriver('Priya Nair'), 'driver_online' => true, 'driver_vehicle_uuid' => null, 'active_orders' => 0],
+            ['uuid' => 'sh3', 'public_id' => 'shift_3', 'start_at' => '2026-09-15 01:15:00', 'end_at' => '2026-09-15 09:15:00', 'status' => 'in_progress', 'driver' => fleetOpsBriefDriver('Luis Ortega'), 'driver_online' => true, 'driver_vehicle_uuid' => 'v2', 'active_orders' => 2],
+        ],
+        'vehicles' => [
+            ['uuid' => 'vehicle-van042', 'public_id' => 'vehicle_van042', 'label' => 'VAN-042', 'status' => 'available', 'driver_uuid' => null, 'device_count' => 1, 'lease_expires_at' => '2026-09-30'],
+        ],
+        'drivers' => [
+            fleetOpsBriefDriver('Sam Bauer', ['online' => false, 'license_expiry' => '2026-10-06']),
+        ],
+        'parts' => [
+            ['uuid' => 'p1', 'public_id' => 'part_pads', 'name' => 'Brake pads', 'sku' => 'PN 8842', 'quantity_on_hand' => 2, 'reorder_point' => 6],
+        ],
+        'fuelTransactions' => [
+            ['uuid' => 'f1', 'public_id' => 'fuel_provider_transaction_1', 'amount' => 21240, 'currency' => 'USD', 'station_name' => 'Pilot #331', 'transaction_at' => '2026-09-14 08:04:00', 'vehicle_card_id' => '4471', 'sync_status' => 'unmatched', 'suggested_vehicle' => ['uuid' => 'vehicle-trk207', 'public_id' => 'vehicle_trk207', 'label' => 'TRK-207', 'matched' => 'fuel_card_number']],
+        ],
+        'states' => [
+            'lease_expiring:vehicle_van042' => ['status' => 'snoozed', 'snoozed_until' => '2026-09-18T08:00:00+00:00'],
+        ],
+    ], $now)['items'];
+}
+
+afterEach(fn () => Carbon::setTestNow());
+
+test('category rows score the open gaps with capped, visible arithmetic', function () {
+    $brief = RadarBriefing::build(fleetOpsBriefItems(), fleetOpsBriefNow());
+    $rows  = collect($brief['categories'])->keyBy('key');
+
+    // Maintenance: oil overdue (10) + tires due soon (4) + WO-2041 overdue (10) = 24 off.
+    expect($rows['maintenance']['score'])->toBe(76)
+        ->and($rows['maintenance']['count'])->toBe(3)
+        ->and($rows['maintenance']['critical'])->toBe(2)
+        ->and(array_column($rows['maintenance']['gaps'], 'label'))->toBe(['1 overdue', '1 work order overdue', '1 due this week'])
+        ->and($rows['maintenance']['filter'])->toBe(['category' => 'maintenance'])
+        // Inspections: one critical failed inspection.
+        ->and($rows['inspections']['score'])->toBe(90)
+        ->and($rows['inspections']['gaps'][0]['label'])->toBe('1 failed, no follow-up')
+        // Staffing: late start (4) + no vehicle (4) + handover (4) + idle vehicle (1) + offline driver without vehicle (1) = 14.
+        ->and($rows['staffing']['score'])->toBe(86)
+        ->and(array_column($rows['staffing']['gaps'], 'rule'))->toContain('shift_late_start', 'shift_no_vehicle', 'shift_handover', 'vehicle_without_driver')
+        // Compliance: the snoozed lease is not open; only the licence counts.
+        ->and($rows['compliance']['score'])->toBe(96)
+        ->and($rows['compliance']['gaps'])->toBe([['rule' => 'license_expiring', 'count' => 1, 'label' => '1 licence expiring']])
+        ->and($rows['fuel']['score'])->toBe(96)
+        ->and($rows['parts']['score'])->toBe(96)
+        ->and($rows['connectivity']['score'])->toBe(100)
+        ->and($rows['issues']['score'])->toBe(100)
+        ->and($brief['score']['value'])->toBe((int) round((76 + 90 + 86 + 96 + 96 + 96 + 100 + 100) / 8))
+        ->and($brief['score']['delta'])->toBeNull()
+        ->and($brief['score']['summary'])->toBe('2 overdue · 2 due this week · 3 unassigned · 1 inspection items')
+        ->and($brief['open'])->toBe(12);
+
+    // One rule cannot zero a category on its own.
+    $many = [];
+    for ($i = 0; $i < 20; $i++) {
+        $many[] = ['key' => "issue_open:i{$i}", 'rule' => 'issue_open', 'category' => 'issues', 'severity' => 'critical', 'state' => ['status' => 'open'], 'title' => 'x', 'due_bucket' => 'none', 'pills' => ['issues']];
+    }
+    $capped = collect(RadarBriefing::categories($many))->firstWhere('key', 'issues');
+    expect($capped['score'])->toBe(100 - RadarBriefing::RULE_CAP);
+});
+
+test('the delta compares with the most recent earlier day and the history keeps 30 days', function () {
+    $now     = fleetOpsBriefNow();
+    $history = [
+        ['date' => '2026-09-13', 'score' => 70],
+        ['date' => '2026-09-14', 'score' => 82],
+        ['date' => '2026-09-15', 'score' => 50],
+        ['date' => '2026-09-16', 'score' => 99],
+    ];
+
+    expect(RadarBriefing::delta(78, $history, $now))->toBe(-4)
+        ->and(RadarBriefing::delta(78, [], $now))->toBeNull()
+        ->and(RadarBriefing::delta(78, [['date' => '2026-09-15', 'score' => 10]], $now))->toBeNull();
+
+    $pushed = RadarBriefing::pushHistory($history, 78, $now);
+    expect(array_column($pushed, 'score'))->toBe([70, 82, 78, 99])
+        ->and($pushed[2])->toBe(['date' => '2026-09-15', 'score' => 78]);
+
+    $long = [];
+    for ($day = 1; $day <= 40; $day++) {
+        $long[] = ['date' => sprintf('2026-08-%02d', $day), 'score' => $day];
+    }
+    expect(RadarBriefing::pushHistory($long, 1, $now))->toHaveCount(30);
+});
+
+test('the brief names the records behind the morning, with links, and closes with routine', function () {
+    $brief     = RadarBriefing::build(fleetOpsBriefItems(), fleetOpsBriefNow());
+    $sentences = array_map(fn ($sentence) => implode('', array_column($sentence, 'text')), $brief['brief']);
+
+    expect($sentences)->toHaveCount(4)
+        ->and($sentences[0])->toBe('2 jobs are past due: TRK-118 (3d overdue) and TRK-207 (1d overdue). 1 failed inspection has no follow-up yet: VAN-042 2 failed · no issue · no work order.')
+        ->and($sentences[1])->toBe('Amara Diallo is 35m late for a shift that started 08:00, Priya Nair has been on shift 2h 35m on shift without a vehicle, and Luis Ortega ends at 09:15 still holding 2 orders.')
+        ->and($sentences[2])->toBe('1 licence or lease expires within 30 days; 1 fuel transaction is unmatched (1 with a suggested vehicle); 1 part is below reorder point, 1 blocking a work order.')
+        ->and($sentences[3])->toBe('Everything else is routine.');
+
+    $links = array_filter($brief['brief'][0], fn ($segment) => isset($segment['route']));
+    expect(array_values($links)[0])->toBe(['text' => 'TRK-118', 'route' => 'maintenance.schedules.index.details', 'model' => 'schedule_oil']);
+
+    expect(RadarBriefing::brief([], fleetOpsBriefNow()))->toBe([[['text' => 'All clear: nothing needs a decision this morning.']]]);
+});
+
+test('decisions are one click each, most urgent first, and say what the click calls', function () {
+    $brief     = RadarBriefing::build(fleetOpsBriefItems(), fleetOpsBriefNow());
+    $decisions = collect($brief['decisions'])->keyBy('key');
+
+    expect(array_column($brief['decisions'], 'key'))->toBe([
+        'inspection_follow_up:inspection_submission_a',
+        'open_work_order:schedule_oil',
+        'assign_vehicle:driver_priyanair',
+        'match_fuel:fuel_provider_transaction_1',
+    ]);
+
+    $followUp = $decisions['inspection_follow_up:inspection_submission_a'];
+    expect($followUp['severity'])->toBe('critical')
+        ->and($followUp['title'])->toBe('Raise a work order for VAN-042')
+        ->and($followUp['confirm'])->toBe(['label' => 'Raise work order', 'action' => 'create_work_order_from_inspection', 'method' => 'POST', 'endpoint' => 'inspection-submissions/inspection_submission_a/create-work-order', 'body' => []])
+        ->and($followUp['alternatives'][0]['endpoint'])->toBe('inspection-submissions/inspection_submission_a/create-issue')
+        ->and($followUp['keys'])->toBe(['inspection_failed:inspection_submission_a'])
+        ->and($followUp['record']['route'])->toBe('maintenance.inspection-submissions.index.details');
+
+    $workOrder = $decisions['open_work_order:schedule_oil'];
+    expect($workOrder['title'])->toBe('Open a work order for TRK-118')
+        ->and($workOrder['confirm']['endpoint'])->toBe('maintenance-schedules/schedule_oil/trigger');
+
+    $assign = $decisions['assign_vehicle:driver_priyanair'];
+    expect($assign['severity'])->toBe('warning')
+        ->and($assign['title'])->toBe('Assign VAN-042 to Priya Nair')
+        ->and($assign['subtitle'])->toBe('clears 2 gaps')
+        ->and($assign['confirm']['endpoint'])->toBe('drivers/driver-priyanair/assign-vehicle')
+        ->and($assign['confirm']['body'])->toBe(['vehicle' => 'vehicle-van042'])
+        ->and($assign['confirm']['undo']['endpoint'])->toBe('drivers/driver-priyanair/unassign-vehicle')
+        ->and($assign['alternatives'][0]['action'])->toBe('pick_vehicle')
+        ->and($assign['keys'])->toBe(['shift_no_vehicle:driver_priyanair', 'vehicle_without_driver:vehicle_van042']);
+
+    $fuel = $decisions['match_fuel:fuel_provider_transaction_1'];
+    expect($fuel['severity'])->toBe('info')
+        ->and($fuel['title'])->toBe('Match USD 212.40 at Pilot #331 to TRK-207')
+        ->and($fuel['subtitle'])->toBe('matched by fuel card number')
+        ->and($fuel['confirm']['body'])->toBe(['vehicle' => 'vehicle-trk207'])
+        ->and($fuel['alternatives'][0]['body'])->toBe(['status' => 'ignored']);
+});
+
+test('the brief and decisions cope with thin mornings', function () {
+    $now = fleetOpsBriefNow();
+
+    expect(RadarBriefing::score([]))->toBe(100);
+
+    $overdue = [];
+    foreach (['A', 'B', 'C'] as $letter) {
+        $overdue[] = ['uuid' => 's' . $letter, 'public_id' => 'schedule_' . $letter, 'name' => 'Service', 'type' => 'oil_change', 'status' => 'active', 'next_due_date' => '2026-09-12 08:00:00', 'has_open_work_order' => true, 'subject' => fleetOpsBriefVehicle('TRK-' . $letter)];
+    }
+    $items = RadarRules::build([
+        'schedules'             => $overdue,
+        // A failed inspection that already has both follow-ups offers no decision.
+        'inspectionSubmissions' => [['uuid' => 'x', 'public_id' => 'inspection_submission_x', 'status' => 'submitted', 'result' => 'failed', 'failed_items' => 1, 'issue_uuid' => null, 'work_order_uuid' => null, 'resolved_at' => null, 'form_name' => 'DVIR', 'highest_severity' => 'low', 'vehicle' => null, 'driver' => null]],
+        // Two drivers need a vehicle but only one is idle.
+        'shifts'   => [
+            ['uuid' => 'sh1', 'public_id' => 'shift_1', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 14:00:00', 'status' => 'in_progress', 'driver' => fleetOpsBriefDriver('One Driver'), 'driver_online' => true, 'driver_vehicle_uuid' => null, 'active_orders' => 0],
+            ['uuid' => 'sh2', 'public_id' => 'shift_2', 'start_at' => '2026-09-15 06:00:00', 'end_at' => '2026-09-15 14:00:00', 'status' => 'in_progress', 'driver' => fleetOpsBriefDriver('Two Driver'), 'driver_online' => true, 'driver_vehicle_uuid' => null, 'active_orders' => 0],
+        ],
+        'vehicles' => [['uuid' => 'vehicle-idle', 'public_id' => 'vehicle_idle', 'label' => 'IDLE-1', 'status' => 'available', 'driver_uuid' => null, 'device_count' => 1]],
+    ], $now)['items'];
+
+    $items = array_map(fn ($item) => $item['rule'] === 'inspection_failed' ? array_merge($item, ['actions' => ['acknowledge']]) : $item, $items);
+
+    $brief     = RadarBriefing::build($items, $now);
+    $sentences = array_map(fn ($sentence) => implode('', array_column($sentence, 'text')), $brief['brief']);
+
+    expect($sentences[0])->toBe('3 jobs are past due: TRK-A (3d overdue) and TRK-B (3d overdue) and 1 more. 1 failed inspection has no follow-up yet: a vehicle 1 failed · no issue · no work order.')
+        ->and($sentences)->toHaveCount(3, 'no housekeeping sentence when nothing expires, fuel is matched and stock is fine')
+        ->and(array_column($brief['decisions'], 'key'))->toBe(['assign_vehicle:driver_onedriver']);
+});