chore(quality): eslint and phpcs to zero, and fix the E2E test failing on development

lib/BackgroundJob/AdviceDeadlineJob.php

@@ -39,6 +39,8 @@
 
 /**
  * Daily timed job that processes advice request deadlines and reminders.
+ *
+ * @spec openspec/specs/advice-management/spec.md
  */
 class AdviceDeadlineJob extends TimedJob {
 	/**

lib/BackgroundJob/AppointmentReminderJob.php

@@ -34,6 +34,8 @@
 
 /**
  * Daily timed job that sends appointment reminders for next-day appointments.
+ *
+ * @spec openspec/specs/appointment-booking/spec.md
  */
 class AppointmentReminderJob extends TimedJob {
 	/**

lib/BackgroundJob/BerichtenboxReadStatusJob.php

@@ -33,6 +33,8 @@
 
 /**
  * Daily timed job that polls Berichtenbox read status for sent messages.
+ *
+ * @spec openspec/specs/berichtenbox-integration/spec.md
  */
 class BerichtenboxReadStatusJob extends TimedJob {
 	/**

lib/BackgroundJob/BottleneckDetectionJob.php

@@ -41,6 +41,8 @@
 
 /**
  * Daily timed job that detects milestone bottlenecks and notifies case workers.
+ *
+ * @spec openspec/specs/milestone-tracking/spec.md
  */
 class BottleneckDetectionJob extends TimedJob {
 	/**

lib/BackgroundJob/DeadlineNotificationDispatchJob.php

@@ -41,6 +41,8 @@
  * Asynchronous queued notification dispatcher.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/termijnbewaking-dwangsom-engine-08-burger-notifications/tasks.md
  */
 class DeadlineNotificationDispatchJob extends QueuedJob {
 	/**

lib/BackgroundJob/EmailPdfRetryJob.php

@@ -37,6 +37,8 @@
 
 /**
  * Retries failed PDF archival attempts on a 15-minute cadence.
+ *
+ * @spec openspec/changes/case-email-integration/tasks.md#T09
  */
 class EmailPdfRetryJob extends TimedJob {
 	/**

lib/BackgroundJob/InboundEmailJob.php

@@ -42,6 +42,8 @@
 
 /**
  * Pulls inbound email from the shared mailbox and auto-links to cases.
+ *
+ * @spec openspec/changes/case-email-integration/tasks.md#T08
  */
 class InboundEmailJob extends TimedJob {
 

lib/BackgroundJob/ResetMonthlyQuotasJob.php

@@ -36,6 +36,8 @@
 
 /**
  * Resets monthly + hourly quotas after their window elapses.
+ *
+ * @spec openspec/changes/tenant-zaaksysteem-saas-09-quotas-enforcement/tasks.md
  */
 class ResetMonthlyQuotasJob extends TimedJob {
 	/**

lib/BackgroundJob/ShareMaintenanceJob.php

@@ -39,6 +39,8 @@
  *
  * Checks for shares expiring within 3 days and sends reminder
  * notifications to case workers.
+ *
+ * @spec openspec/specs/case-management/spec.md
  */
 class ShareMaintenanceJob extends TimedJob {
 	/**

lib/BackgroundJob/StufRetryJob.php

@@ -36,6 +36,8 @@
 
 /**
  * On-demand background job that retries a single StufMessage.
+ *
+ * @spec openspec/specs/stuf-zkn-outbound/spec.md#requirement-circuit-breaker-and-retry
  */
 class StufRetryJob extends Job {
 	/**

lib/Command/BackfillLegalHoldsCommand.php

@@ -59,6 +59,8 @@
  * Backfill the Awb legal holds the dead bezwaar listener never placed.
  *
  * @SuppressWarnings(PHPMD.CouplingBetweenObjects) Remediation spans several OpenRegister collaborators.
+ *
+ * @spec openspec/specs/archief-edepot-handover/spec.md#requirement-legal-proceedings-must-suspend-archival-via-or-legal-holds
  */
 class BackfillLegalHoldsCommand extends Command {
 

lib/Command/SeedBezwaarBeroepCommand.php

@@ -40,6 +40,8 @@
 
 /**
  * Seed the Bezwaar & Beroep case types, status types and role types.
+ *
+ * @spec openspec/specs/bezwaar-beroep-workflow/spec.md#requirement-req-bbw-001-bezwaar-casetype-seed-shall-be-installed-with-awb-compliant-process-configuration
  */
 class SeedBezwaarBeroepCommand extends Command {
 	/**

lib/Controller/AdviceController.php

@@ -43,6 +43,8 @@
 
 /**
  * Controller for advice request workflow operations.
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class AdviceController extends Controller {
 	/**

lib/Controller/AiAuditExportController.php

@@ -44,6 +44,8 @@
  * Read-only action controller for the AI audit trail export.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/ai-oversight-log/tasks.md#2.1
  */
 class AiAuditExportController extends Controller {
 	/**

lib/Controller/AiController.php

@@ -48,6 +48,8 @@
  * health endpoints live on {@see AiSettingsController}.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class AiController extends Controller {
 	/**

lib/Controller/AppointmentController.php

@@ -36,6 +36,8 @@
 
 /**
  * Controller exposing citizen appointment endpoints.
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class AppointmentController extends Controller {
 	/**

lib/Controller/BerichtenboxController.php

@@ -35,6 +35,8 @@
 
 /**
  * Controller exposing Berichtenbox send/list/poll endpoints.
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class BerichtenboxController extends Controller {
 	/**

lib/Controller/BesluitvormingController.php

@@ -42,6 +42,8 @@
  * Controller exposing besluitvorming template-activation endpoints.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/besluitvorming-workflow/tasks.md#task-2
  */
 class BesluitvormingController extends Controller {
 	/**

lib/Controller/BrcController.php

@@ -55,6 +55,8 @@
  * @SuppressWarnings(PHPMD.ExcessiveClassComplexity)
  * @SuppressWarnings(PHPMD.CyclomaticComplexity)
  * @SuppressWarnings(PHPMD.NPathComplexity)
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class BrcController extends ZgwController {
 	/**

lib/Controller/ConsultationController.php

@@ -43,6 +43,8 @@
  *
  * Every endpoint carries the NoAdminRequired annotation and applies the
  * ConsultationAccessGuard (OWASP A01:2021, ADR-005 Rule 3).
+ *
+ * @spec openspec/changes/consultation-management/tasks.md#TASK-CN-04
  */
 class ConsultationController extends Controller {
 	/**

lib/Controller/DashboardController.php

@@ -56,6 +56,8 @@
  * Controller for the main Dossiq dashboard page plus the PWA assets.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/adopt-apphost/tasks.md#task-2.1
  */
 class DashboardController extends Controller {
 	/**

lib/Controller/DeelzaakController.php

@@ -38,6 +38,8 @@
 
 /**
  * REST controller for sub-case operations.
+ *
+ * @spec openspec/specs/authz-bypass-fixes/spec.md
  */
 class DeelzaakController extends Controller {
 	/**

lib/Controller/DoorlooptijdController.php

@@ -37,6 +37,8 @@
 
 /**
  * REST controller for the throughput-time dashboard.
+ *
+ * @spec openspec/changes/doorlooptijd-dashboard/tasks.md#T02
  */
 class DoorlooptijdController extends Controller {
 	/**

lib/Controller/DrcController.php

@@ -53,6 +53,8 @@
  * @SuppressWarnings(PHPMD.ExcessiveMethodLength)
  * @SuppressWarnings(PHPMD.CyclomaticComplexity)
  * @SuppressWarnings(PHPMD.NPathComplexity)
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class DrcController extends ZgwController {
 	/**

lib/Controller/EmailController.php

@@ -35,6 +35,8 @@
 
 /**
  * Controller for case email operations.
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class EmailController extends Controller {
 	/**

lib/Controller/EmailTemplateController.php

@@ -46,6 +46,8 @@
 
 /**
  * REST controller for email-template templating + IMAP settings.
+ *
+ * @spec openspec/changes/case-email-integration/tasks.md#T06
  */
 class EmailTemplateController extends Controller {
 

lib/Controller/Iv3TaakveldController.php

@@ -46,6 +46,8 @@
 
 /**
  * Read-only access to the IV3/BBV taakveld reference list.
+ *
+ * @spec openspec/specs/iv3-taakveld-2023-refinement/spec.md
  */
 class Iv3TaakveldController extends Controller {
 	/**
@@ -70,6 +72,8 @@ public function __construct(
 	 * is a public CBS classification, not report data).
 	 *
 	 * @return JSONResponse
+	 *
+	 * @spec openspec/specs/iv3-taakveld-2023-refinement/spec.md
 	 */
 	#[NoAdminRequired]
 	public function taakvelden(): JSONResponse {

lib/Controller/KccContactController.php

@@ -44,6 +44,8 @@
  * Controller exposing KCC contact-moment and callback endpoints.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
  */
 class KccContactController extends Controller {
 	/**
@@ -73,6 +75,8 @@ public function __construct(
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function index(): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -107,6 +111,8 @@ public function index(): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function create(): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -133,6 +139,8 @@ public function create(): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function show(string $id): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -163,6 +171,8 @@ public function show(string $id): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function update(string $id): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -194,6 +204,8 @@ public function update(string $id): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function related(string $id): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -222,6 +234,8 @@ public function related(string $id): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function scheduleCallback(): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -246,6 +260,8 @@ public function scheduleCallback(): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function indexCallbacks(): JSONResponse {
 		$agentId = $this->requireAgentId();
@@ -278,6 +294,8 @@ public function indexCallbacks(): JSONResponse {
 	 * @NoAdminRequired
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-16
 	 */
 	public function cancelCallback(string $id): JSONResponse {
 		$agentId = $this->requireAgentId();

lib/Controller/KccRoutingController.php

@@ -44,6 +44,8 @@
  * Controller exposing KCC routing-rule and routing-evaluation endpoints.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-17
  */
 class KccRoutingController extends Controller {
 	/**
@@ -102,6 +104,8 @@ public function index(): JSONResponse {
 	 * @return JSONResponse
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-17
 	 */
 	#[AuthorizedAdminSetting(settings: AdminSettings::class)]
 	public function create(): JSONResponse {
@@ -130,6 +134,8 @@ public function create(): JSONResponse {
 	 * @return JSONResponse
 	 *
 	 * @psalm-suppress PossiblyUnusedMethod
+	 *
+	 * @spec openspec/changes/kcc-klantcontact-integratie/tasks.md#TASK-KCC-17
 	 */
 	#[AuthorizedAdminSetting(settings: AdminSettings::class)]
 	public function update(string $id): JSONResponse {

lib/Controller/MilestoneController.php

@@ -36,6 +36,8 @@
 
 /**
  * Controller for milestone progress tracking.
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class MilestoneController extends Controller {
 	/**

lib/Controller/NotesController.php

@@ -44,6 +44,8 @@
 
 /**
  * Controller for note-mention notification side-effects.
+ *
+ * @spec openspec/specs/ncvue-w2-leaves-adoption/spec.md
  */
 class NotesController extends Controller {
 	/**

lib/Controller/NoticeOfDefaultController.php

@@ -40,6 +40,8 @@
  * REST surface for ingebrekestelling registration.
  *
  * @psalm-suppress UnusedClass
+ *
+ * @spec openspec/changes/termijnbewaking-dwangsom-engine-10-bezwaar-rest-api/tasks.md
  */
 class NoticeOfDefaultController extends Controller {
 

lib/Controller/NrcController.php

@@ -44,6 +44,8 @@
  * @psalm-suppress UnusedClass
  *
  * @SuppressWarnings(PHPMD.TooManyPublicMethods)
+ *
+ * @spec openspec/changes/retrofit-2026-05-24-case-management/tasks.md
  */
 class NrcController extends ZgwController {
 	/**