@fleetbase/fleetops-engine 0.6.65 → 0.6.66

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']);
+});

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

@@ -0,0 +1,260 @@
+<?php
+
+use Fleetbase\FleetOps\Support\Radar\RadarItemState;
+use Fleetbase\Models\Alert;
+use Fleetbase\Models\User;
+use Illuminate\Config\Repository;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Events\Dispatcher;
+use Illuminate\Http\Request;
+use Illuminate\Support\Carbon;
+
+/**
+ * The alerts table and the users it points at, in memory. Every column is a
+ * nullable string: what is asserted is what the helper writes and reads.
+ */
+function fleetOpsRadarStateDatabase(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    EloquentModel::setEventDispatcher(new Dispatcher());
+    EloquentModel::clearBootedModels();
+
+    $config = new Repository([
+        'activitylog' => ['enabled' => false, 'default_auth_driver' => null, 'default_log_name' => 'default'],
+        'api'         => ['cache' => ['enabled' => false]],
+    ]);
+    app()->instance('config', $config);
+    app()->instance(Illuminate\Contracts\Config\Repository::class, $config);
+    app()->instance(Spatie\Activitylog\CauserResolver::class, new class extends Spatie\Activitylog\CauserResolver {
+        public function __construct()
+        {
+        }
+
+        public function resolve(EloquentModel|int|string|null $subject = null): ?EloquentModel
+        {
+            return null;
+        }
+    });
+    app()->instance('db', new class($connection) {
+        public function __construct(public SQLiteConnection $connection)
+        {
+        }
+
+        public function connection($name = null): SQLiteConnection
+        {
+            return $this->connection;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return $this->connection->{$method}(...$arguments);
+        }
+    });
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+    app()->instance('db.schema', $connection->getSchemaBuilder());
+    app()->instance('responsecache', new class {
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+    });
+    app()->instance('request', Request::create('/'));
+
+    $schema = $connection->getSchemaBuilder();
+    $tables = [
+        'alerts'       => ['uuid', 'public_id', '_key', 'company_uuid', 'category_uuid', 'acknowledged_by_uuid', 'resolved_by_uuid', 'snoozed_by_uuid', 'assigned_to_uuid', 'type', 'severity', 'status', 'subject_type', 'subject_uuid', 'message', 'rule', 'context', 'meta', 'triggered_at', 'acknowledged_at', 'resolved_at', 'snoozed_until', 'planned_at'],
+        'users'        => ['uuid', 'public_id', '_key', 'company_uuid', 'name', 'email', 'phone', 'type', 'status'],
+        'companies'    => ['uuid', 'public_id', '_key', 'name', 'owner_uuid'],
+        'activity_log' => ['uuid', 'company_uuid', 'log_name', 'description', 'subject_type', 'subject_id', 'causer_type', 'causer_id', 'properties', 'event', 'batch_uuid'],
+        'settings'     => ['key', 'value'],
+    ];
+
+    foreach ($tables as $table => $columns) {
+        $schema->create($table, function ($blueprint) use ($columns) {
+            $blueprint->increments('id');
+            foreach ($columns as $column) {
+                $blueprint->string($column)->nullable();
+            }
+            $blueprint->timestamps();
+            $blueprint->timestamp('deleted_at')->nullable();
+        });
+    }
+
+    $connection->table('companies')->insert(['uuid' => 'company-radar', 'public_id' => 'company_radar', 'name' => 'Radar Co']);
+    $connection->table('users')->insert(['uuid' => 'user-ada', 'public_id' => 'user_ada', 'company_uuid' => 'company-radar', 'name' => 'Ada Ops', 'type' => 'user']);
+    $connection->table('users')->insert(['uuid' => 'user-bo', 'public_id' => 'user_bo', 'company_uuid' => 'company-radar', 'name' => 'Bo Tran', 'type' => 'user']);
+
+    session(['company' => 'company-radar', 'user' => 'user-ada']);
+
+    return $connection;
+}
+
+function fleetOpsRadarStateItem(string $key = 'issue_open:issue_1', array $extra = []): array
+{
+    [$rule] = explode(':', $key);
+
+    return array_merge([
+        'key'      => $key,
+        'rule'     => $rule,
+        'category' => 'issues',
+        'chip'     => 'Issue',
+        'severity' => 'critical',
+        'title'    => 'Check engine light',
+        'due_at'   => null,
+        'record'   => ['route' => 'management.issues.index.details', 'model' => 'issue_1'],
+        'subject'  => ['type' => 'vehicle', 'class' => 'Fleetbase\FleetOps\Models\Vehicle', 'uuid' => 'vehicle-311', 'public_id' => 'vehicle_311', 'label' => 'TRK-311', 'photo_url' => null],
+    ], $extra);
+}
+
+afterEach(fn () => Carbon::setTestNow());
+
+test('rowFor creates one open row per item key and reuses it', function () {
+    fleetOpsRadarStateDatabase();
+    Carbon::setTestNow(Carbon::parse('2026-09-15 08:35:00', 'UTC'));
+
+    $row = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem());
+
+    expect($row->exists)->toBeTrue()
+        ->and($row->type)->toBe('issue_open')
+        ->and($row->status)->toBe('open')
+        ->and($row->severity)->toBe('critical')
+        ->and($row->subject_type)->toBe('Fleetbase\FleetOps\Models\Vehicle')
+        ->and($row->subject_uuid)->toBe('vehicle-311')
+        ->and($row->message)->toBe('Check engine light')
+        ->and($row->context['key'])->toBe('issue_open:issue_1')
+        ->and($row->context['subject']['label'])->toBe('TRK-311')
+        ->and($row->context['record']['model'])->toBe('issue_1')
+        ->and(RadarItemState::keyOf($row))->toBe('issue_open:issue_1');
+
+    $again = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem());
+    expect($again->uuid)->toBe($row->uuid)
+        ->and(Alert::query()->count())->toBe(1);
+
+    // A resolved row is history: the next action opens a fresh one.
+    RadarItemState::resolve($row, null, 'done');
+    $fresh = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem());
+    expect($fresh->uuid)->not->toBe($row->uuid)
+        ->and(Alert::query()->count())->toBe(2);
+});
+
+test('statesFor and findRow read live rows by key, including notices by public id', function () {
+    fleetOpsRadarStateDatabase();
+    Carbon::setTestNow(Carbon::parse('2026-09-15 08:35:00', 'UTC'));
+
+    $issue = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem());
+    $ada   = User::query()->where('uuid', 'user-ada')->first();
+    $bo    = User::query()->where('uuid', 'user-bo')->first();
+    RadarItemState::acknowledge($issue, $ada);
+    RadarItemState::assign($issue, $bo);
+    RadarItemState::snooze($issue, now()->addHour(), 'Waiting on parts', $bo);
+    RadarItemState::plan($issue, now()->addHours(3));
+
+    // A second acknowledgement keeps the first one.
+    RadarItemState::acknowledge($issue, $bo);
+    expect(RadarItemState::refresh($issue)->getAttribute('acknowledged_by_uuid'))->toBe('user-ada')
+        ->and(RadarItemState::refresh($issue)->meta['snooze_reason'])->toBe('Waiting on parts')
+        ->and(RadarItemState::refresh(new Alert())->exists)->toBeFalse();
+
+    $notice = Alert::create(['company_uuid' => 'company-radar', 'type' => 'radar_notice', 'severity' => 'info', 'status' => 'open', 'message' => 'Yard closed']);
+    $notice->forceFill(['public_id' => 'alert_yard'])->save();
+
+    // A row for another company, and one that is resolved, are not live.
+    Alert::create(['company_uuid' => 'company-other', 'type' => 'issue_open', 'severity' => 'info', 'status' => 'open', 'message' => 'x', 'context' => ['key' => 'issue_open:issue_other']]);
+    Alert::create(['company_uuid' => 'company-radar', 'type' => 'issue_open', 'severity' => 'info', 'status' => 'resolved', 'message' => 'x', 'context' => ['key' => 'issue_open:issue_done']]);
+
+    $states = RadarItemState::statesFor('company-radar');
+
+    expect(array_keys($states))->toBe(['issue_open:issue_1', 'notice:alert_yard'])
+        ->and($states['issue_open:issue_1'])->toMatchArray([
+            'status'               => 'acknowledged',
+            'alert_id'             => $issue->public_id,
+            'acknowledged_at'      => '2026-09-15T08:35:00+00:00',
+            'acknowledged_by_name' => 'Ada Ops',
+            'snoozed_until'        => '2026-09-15T09:35:00+00:00',
+            'snoozed_by_name'      => 'Bo Tran',
+            'planned_at'           => '2026-09-15T11:35:00+00:00',
+        ])
+        ->and($states['issue_open:issue_1']['assigned_to'])->toBe(['uuid' => 'user-bo', 'public_id' => 'user_bo', 'name' => 'Bo Tran', 'initials' => 'BT'])
+        ->and(RadarItemState::findRow('company-radar', 'issue_open:issue_1')?->uuid)->toBe($issue->uuid)
+        ->and(RadarItemState::findRow('company-radar', 'notice:alert_yard')?->uuid)->toBe($notice->uuid)
+        ->and(RadarItemState::findRow('company-radar', 'notice:' . $notice->uuid)?->uuid)->toBe($notice->uuid)
+        ->and(RadarItemState::findRow('company-radar', 'issue_open:issue_other'))->toBeNull()
+        ->and(RadarItemState::findRow('company-radar', 'issue_open:issue_done'))->toBeNull()
+        ->and(RadarItemState::findRow('company-radar', 'garbage'))->toBeNull();
+
+    $notices = RadarItemState::notices('company-radar');
+    expect($notices)->toHaveCount(1)
+        ->and($notices[0]['public_id'])->toBe('alert_yard')
+        ->and($notices[0]['state']['status'])->toBe('open');
+});
+
+test('reconcile resolves rows whose gap is gone and leaves the live ones', function () {
+    fleetOpsRadarStateDatabase();
+    Carbon::setTestNow(Carbon::parse('2026-09-15 08:35:00', 'UTC'));
+
+    $live   = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('issue_open:issue_1'));
+    $gone   = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('part_low_stock:part_pads', ['category' => 'parts', 'chip' => 'Parts', 'title' => 'Brake pads — 2 left']));
+    $notice = Alert::create(['company_uuid' => 'company-radar', 'type' => 'radar_notice', 'severity' => 'info', 'status' => 'open', 'message' => 'Yard closed', 'context' => ['key' => 'notice:alert_yard']]);
+
+    // A row written by something other than Radar carries no item key and is left alone.
+    Alert::create(['company_uuid' => 'company-radar', 'type' => 'issue_open', 'severity' => 'info', 'status' => 'open', 'message' => 'Raised elsewhere']);
+    expect(RadarItemState::statesFor('company-radar'))->not->toHaveKey('')
+        ->and(RadarItemState::findRow('company-radar', 'issue_open:elsewhere'))->toBeNull();
+
+    expect(RadarItemState::reconcile('company-radar', ['issue_open:issue_1', 'notice:alert_yard']))->toBe(1)
+        ->and($live->fresh()->status)->toBe('open')
+        ->and($notice->fresh()->status)->toBe('open')
+        ->and($gone->fresh()->status)->toBe('resolved')
+        ->and($gone->fresh()->resolved_at?->toIso8601String())->toBe('2026-09-15T08:35:00+00:00')
+        ->and($gone->fresh()->meta['resolution'])->toBe('auto');
+
+    $resolved = RadarItemState::resolvedSince('company-radar', Carbon::parse('2026-09-14 00:00:00', 'UTC'), now());
+    expect($resolved)->toHaveCount(1)
+        ->and($resolved[0]['key'])->toBe('part_low_stock:part_pads')
+        ->and($resolved[0]['title'])->toBe('Brake pads — 2 left')
+        ->and($resolved[0]['chip'])->toBe('Parts')
+        ->and($resolved[0]['category'])->toBe('parts')
+        ->and($resolved[0]['meta_line'])->toBe('closed on the record')
+        ->and($resolved[0]['subject']['label'])->toBe('TRK-311')
+        ->and($resolved[0]['state']['status'])->toBe('resolved')
+        ->and($resolved[0]['state']['resolution'])->toBe('auto')
+        ->and($resolved[0]['actions'])->toBe(['open_record']);
+});
+
+test('snoozeSchedule lists the snoozes waking within a week, soonest first', function () {
+    fleetOpsRadarStateDatabase();
+    Carbon::setTestNow(Carbon::parse('2026-09-15 08:35:00', 'UTC'));
+
+    $soon  = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('issue_open:issue_1', ['title' => 'Soon']));
+    $later = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('issue_open:issue_2', ['title' => 'Later']));
+    $far   = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('issue_open:issue_3', ['title' => 'Far']));
+    $past  = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('issue_open:issue_4', ['title' => 'Past']));
+
+    RadarItemState::snooze($later, now()->addDays(3), null, null);
+    RadarItemState::snooze($soon, now()->addHours(2), null, null);
+    RadarItemState::snooze($far, now()->addDays(20), null, null);
+    RadarItemState::snooze($past, now()->subHour(), null, null);
+
+    // Woken early, a row leaves the schedule.
+    $woken = RadarItemState::rowFor('company-radar', fleetOpsRadarStateItem('issue_open:issue_5', ['title' => 'Woken']));
+    RadarItemState::snooze($woken, now()->addHours(1), null, null);
+    RadarItemState::wake($woken);
+
+    $schedule = RadarItemState::snoozeSchedule('company-radar', now());
+
+    expect(array_column($schedule, 'title'))->toBe(['Soon', 'Later'])
+        ->and($schedule[0]['key'])->toBe('issue_open:issue_1')
+        ->and($schedule[0]['snoozed_until'])->toBe('2026-09-15T10:35:00+00:00');
+});
+
+test('initials come from the first and last name', function () {
+    expect(RadarItemState::initials('Ada Ops'))->toBe('AO')
+        ->and(RadarItemState::initials('Cher'))->toBe('C')
+        ->and(RadarItemState::initials('  mary jane  watson '))->toBe('MW')
+        ->and(RadarItemState::initials(null))->toBe('');
+});