From 1d21b291a16b8003b84713e12807fa3abd9e5f34 Mon Sep 17 00:00:00 2001
From: Chris Huber <chubes@extrachill.com>
Date: Fri, 22 May 2026 16:56:42 -0400
Subject: [PATCH 1/2] fix: document direct database query exceptions

---
 inc/Abilities/Engine/DrainJobAbility.php                 | 1 +
 inc/Abilities/Engine/PipelineBatchScheduler.php          | 1 +
 inc/Abilities/Job/RecoverStuckJobsAbility.php            | 1 +
 inc/Abilities/Media/AltTextAbilities.php                 | 1 +
 inc/Abilities/SEO/MetaDescriptionAbilities.php           | 1 +
 inc/Api/System/System.php                                | 1 +
 inc/Cli/Commands/Flows/FlowsCommand.php                  | 1 +
 inc/Cli/Commands/Flows/QueueCommand.php                  | 1 +
 inc/Cli/Commands/JobsCommand.php                         | 1 +
 inc/Cli/Commands/ProcessedItemsCommand.php               | 5 +++--
 inc/Core/Admin/FlowFormatter.php                         | 1 +
 inc/Core/Database/Agents/Agents.php                      | 1 +
 inc/Core/Database/BaseRepository.php                     | 1 +
 inc/Core/Database/Chat/Chat.php                          | 1 +
 inc/Core/Database/Jobs/Jobs.php                          | 1 +
 inc/Core/Database/ProcessedItems/ProcessedItems.php      | 3 ++-
 inc/Core/JobArtifacts.php                                | 1 +
 inc/Core/RunMetrics.php                                  | 1 +
 inc/Engine/AI/Actions/PendingActionStore.php             | 9 +++++----
 inc/Engine/AI/System/Tasks/DailyMemoryTask.php           | 1 +
 inc/Engine/Actions/Engine.php                            | 1 +
 inc/Engine/Tasks/TaskScheduler.php                       | 1 +
 inc/migrations/flows.php                                 | 1 +
 .../Unit/Abilities/Engine/PipelineBatchSchedulerTest.php | 1 +
 .../Core/Database/Chat/ConversationStoreFactoryTest.php  | 1 +
 25 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/inc/Abilities/Engine/DrainJobAbility.php b/inc/Abilities/Engine/DrainJobAbility.php
index 6ba7a0cae..aa13d44ca 100644
--- a/inc/Abilities/Engine/DrainJobAbility.php
+++ b/inc/Abilities/Engine/DrainJobAbility.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Drain Job Ability
  *
diff --git a/inc/Abilities/Engine/PipelineBatchScheduler.php b/inc/Abilities/Engine/PipelineBatchScheduler.php
index 0a5e217bf..0f271cdbc 100644
--- a/inc/Abilities/Engine/PipelineBatchScheduler.php
+++ b/inc/Abilities/Engine/PipelineBatchScheduler.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Pipeline Batch Scheduler
  *
diff --git a/inc/Abilities/Job/RecoverStuckJobsAbility.php b/inc/Abilities/Job/RecoverStuckJobsAbility.php
index 6a591cfb5..d15e62968 100644
--- a/inc/Abilities/Job/RecoverStuckJobsAbility.php
+++ b/inc/Abilities/Job/RecoverStuckJobsAbility.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Recover Stuck Jobs Ability
  *
diff --git a/inc/Abilities/Media/AltTextAbilities.php b/inc/Abilities/Media/AltTextAbilities.php
index 52492dc7f..efb20b0e5 100644
--- a/inc/Abilities/Media/AltTextAbilities.php
+++ b/inc/Abilities/Media/AltTextAbilities.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Alt Text Abilities
  *
diff --git a/inc/Abilities/SEO/MetaDescriptionAbilities.php b/inc/Abilities/SEO/MetaDescriptionAbilities.php
index 7da72dfca..53e3a55a6 100644
--- a/inc/Abilities/SEO/MetaDescriptionAbilities.php
+++ b/inc/Abilities/SEO/MetaDescriptionAbilities.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Meta Description Abilities
  *
diff --git a/inc/Api/System/System.php b/inc/Api/System/System.php
index e5498f66a..6cd2c9889 100644
--- a/inc/Api/System/System.php
+++ b/inc/Api/System/System.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * System REST API Endpoint
  *
diff --git a/inc/Cli/Commands/Flows/FlowsCommand.php b/inc/Cli/Commands/Flows/FlowsCommand.php
index 168b58ef1..0c9c45a50 100644
--- a/inc/Cli/Commands/Flows/FlowsCommand.php
+++ b/inc/Cli/Commands/Flows/FlowsCommand.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * WP-CLI Flows Command
  *
diff --git a/inc/Cli/Commands/Flows/QueueCommand.php b/inc/Cli/Commands/Flows/QueueCommand.php
index 9aab4661c..cead9ea55 100644
--- a/inc/Cli/Commands/Flows/QueueCommand.php
+++ b/inc/Cli/Commands/Flows/QueueCommand.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * WP-CLI Flows Queue Command
  *
diff --git a/inc/Cli/Commands/JobsCommand.php b/inc/Cli/Commands/JobsCommand.php
index cd58f059f..204246b19 100644
--- a/inc/Cli/Commands/JobsCommand.php
+++ b/inc/Cli/Commands/JobsCommand.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * WP-CLI Jobs Command
  *
diff --git a/inc/Cli/Commands/ProcessedItemsCommand.php b/inc/Cli/Commands/ProcessedItemsCommand.php
index e42f18507..80fbf5f70 100644
--- a/inc/Cli/Commands/ProcessedItemsCommand.php
+++ b/inc/Cli/Commands/ProcessedItemsCommand.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * WP-CLI Processed Items Command
  *
@@ -496,7 +497,7 @@ public function cleanup_orphans( array $args, array $assoc_args ): void {
 				...$values
 			)
 		);
-		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber, WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
 
 		if ( 0 === $count ) {
 			WP_CLI::success( 'No orphaned processed items found.' );
@@ -524,7 +525,7 @@ public function cleanup_orphans( array $args, array $assoc_args ): void {
 				...$values
 			)
 		);
-		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber, WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
 
 		if ( false === $deleted ) {
 			WP_CLI::error( 'Database error during deletion: ' . $wpdb->last_error );
diff --git a/inc/Core/Admin/FlowFormatter.php b/inc/Core/Admin/FlowFormatter.php
index 21d4895b5..2b8ef40a3 100644
--- a/inc/Core/Admin/FlowFormatter.php
+++ b/inc/Core/Admin/FlowFormatter.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Flow Formatter Utility
  *
diff --git a/inc/Core/Database/Agents/Agents.php b/inc/Core/Database/Agents/Agents.php
index 25d4fdfc4..7995bb871 100644
--- a/inc/Core/Database/Agents/Agents.php
+++ b/inc/Core/Database/Agents/Agents.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Agents Repository
  *
diff --git a/inc/Core/Database/BaseRepository.php b/inc/Core/Database/BaseRepository.php
index d27670d24..628691d4d 100644
--- a/inc/Core/Database/BaseRepository.php
+++ b/inc/Core/Database/BaseRepository.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Base Repository for shared database CRUD patterns.
  *
diff --git a/inc/Core/Database/Chat/Chat.php b/inc/Core/Database/Chat/Chat.php
index 3dcd2e30e..5d878b091 100644
--- a/inc/Core/Database/Chat/Chat.php
+++ b/inc/Core/Database/Chat/Chat.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Chat Database Operations
  *
diff --git a/inc/Core/Database/Jobs/Jobs.php b/inc/Core/Database/Jobs/Jobs.php
index e37eca3a6..8e4312c5c 100644
--- a/inc/Core/Database/Jobs/Jobs.php
+++ b/inc/Core/Database/Jobs/Jobs.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Jobs Database Repository
  *
diff --git a/inc/Core/Database/ProcessedItems/ProcessedItems.php b/inc/Core/Database/ProcessedItems/ProcessedItems.php
index 3f22e0258..92be5df71 100644
--- a/inc/Core/Database/ProcessedItems/ProcessedItems.php
+++ b/inc/Core/Database/ProcessedItems/ProcessedItems.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * ProcessedItems database service - prevents duplicate processing at flow step level.
  *
@@ -115,7 +116,7 @@ public function get_processed_at( string $flow_step_id, string $source_type, str
 				self::STATUS_PROCESSED
 			)
 		);
-		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
 
 		if ( null === $value || '' === $value ) {
 			return null;
diff --git a/inc/Core/JobArtifacts.php b/inc/Core/JobArtifacts.php
index f28e22b94..14932e016 100644
--- a/inc/Core/JobArtifacts.php
+++ b/inc/Core/JobArtifacts.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Job artifact payload builder.
  *
diff --git a/inc/Core/RunMetrics.php b/inc/Core/RunMetrics.php
index 67a21c0d3..d3b7a4224 100644
--- a/inc/Core/RunMetrics.php
+++ b/inc/Core/RunMetrics.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Generic run metrics helpers.
  *
diff --git a/inc/Engine/AI/Actions/PendingActionStore.php b/inc/Engine/AI/Actions/PendingActionStore.php
index aa147260f..986240aed 100644
--- a/inc/Engine/AI/Actions/PendingActionStore.php
+++ b/inc/Engine/AI/Actions/PendingActionStore.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * PendingActionStore — server-side storage for tool invocations awaiting user resolution.
  *
@@ -429,7 +430,7 @@ public static function list( array $filters = array() ): array {
 
 		// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.NotPrepared
 		$rows = $wpdb->get_results( $wpdb->prepare( $sql, ...$prepare_args ), ARRAY_A );
-		// phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.NotPrepared
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
 
 		return array_values( array_filter( array_map( array( self::class, 'row_to_payload' ), (array) $rows ) ) );
 	}
@@ -501,7 +502,7 @@ public static function summary( array $filters = array() ): array {
 
 		// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.NotPrepared
 		$rows = $wpdb->get_results( $wpdb->prepare( $sql, ...$prepare_args ), ARRAY_A );
-		// phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.NotPrepared
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
 
 		$summary = array(
 			'total'       => count( (array) $rows ),
@@ -550,7 +551,7 @@ public static function expire_due_actions( ?string $before = null ): int {
 				$boundary
 			)
 		);
-		// phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.NotPrepared
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
 
 		$expired = 0;
 		foreach ( (array) $action_ids as $action_id ) {
@@ -630,7 +631,7 @@ private static function get_row( string $action_id ): ?array {
 			$wpdb->prepare( 'SELECT * FROM %i WHERE action_id = %s', self::get_table_name(), $action_id ),
 			ARRAY_A
 		);
-		// phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.NotPrepared
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
 
 		return is_array( $row ) ? $row : null;
 	}
diff --git a/inc/Engine/AI/System/Tasks/DailyMemoryTask.php b/inc/Engine/AI/System/Tasks/DailyMemoryTask.php
index 175731a65..4f3187641 100644
--- a/inc/Engine/AI/System/Tasks/DailyMemoryTask.php
+++ b/inc/Engine/AI/System/Tasks/DailyMemoryTask.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Daily Memory Task
  *
diff --git a/inc/Engine/Actions/Engine.php b/inc/Engine/Actions/Engine.php
index e07bc67f2..88f4b9d36 100644
--- a/inc/Engine/Actions/Engine.php
+++ b/inc/Engine/Actions/Engine.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Execution engine — shared utilities and action hook bridges.
  *
diff --git a/inc/Engine/Tasks/TaskScheduler.php b/inc/Engine/Tasks/TaskScheduler.php
index 4ef12e7d5..3db5e9b50 100644
--- a/inc/Engine/Tasks/TaskScheduler.php
+++ b/inc/Engine/Tasks/TaskScheduler.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Task Scheduler — Routes system tasks through the workflow engine.
  *
diff --git a/inc/migrations/flows.php b/inc/migrations/flows.php
index 3b74e10c1..81c788df4 100644
--- a/inc/migrations/flows.php
+++ b/inc/migrations/flows.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Data Machine — Flow activation helpers.
  *
diff --git a/tests/Unit/Abilities/Engine/PipelineBatchSchedulerTest.php b/tests/Unit/Abilities/Engine/PipelineBatchSchedulerTest.php
index 432b6bac3..33f8c7581 100644
--- a/tests/Unit/Abilities/Engine/PipelineBatchSchedulerTest.php
+++ b/tests/Unit/Abilities/Engine/PipelineBatchSchedulerTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Tests for PipelineBatchScheduler.
  *
diff --git a/tests/Unit/Core/Database/Chat/ConversationStoreFactoryTest.php b/tests/Unit/Core/Database/Chat/ConversationStoreFactoryTest.php
index ac80eeca0..14c84ec16 100644
--- a/tests/Unit/Core/Database/Chat/ConversationStoreFactoryTest.php
+++ b/tests/Unit/Core/Database/Chat/ConversationStoreFactoryTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Conversation Store Factory Tests
  *

From 1d49743baf733473fbda20171c674a807d262aab Mon Sep 17 00:00:00 2001
From: Chris Huber <chubes@extrachill.com>
Date: Fri, 22 May 2026 18:55:06 -0400
Subject: [PATCH 2/2] fix: keep direct db annotations lint clean

---
 inc/Cli/Commands/ProcessedItemsCommand.php          | 5 ++---
 inc/Core/Database/BaseRepository.php                | 1 -
 inc/Core/Database/Jobs/Jobs.php                     | 1 -
 inc/Core/Database/ProcessedItems/ProcessedItems.php | 3 +--
 4 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/inc/Cli/Commands/ProcessedItemsCommand.php b/inc/Cli/Commands/ProcessedItemsCommand.php
index 80fbf5f70..e42f18507 100644
--- a/inc/Cli/Commands/ProcessedItemsCommand.php
+++ b/inc/Cli/Commands/ProcessedItemsCommand.php
@@ -1,5 +1,4 @@
 <?php
-// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * WP-CLI Processed Items Command
  *
@@ -497,7 +496,7 @@ public function cleanup_orphans( array $args, array $assoc_args ): void {
 				...$values
 			)
 		);
-		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber, WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
 
 		if ( 0 === $count ) {
 			WP_CLI::success( 'No orphaned processed items found.' );
@@ -525,7 +524,7 @@ public function cleanup_orphans( array $args, array $assoc_args ): void {
 				...$values
 			)
 		);
-		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber, WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
 
 		if ( false === $deleted ) {
 			WP_CLI::error( 'Database error during deletion: ' . $wpdb->last_error );
diff --git a/inc/Core/Database/BaseRepository.php b/inc/Core/Database/BaseRepository.php
index 628691d4d..d27670d24 100644
--- a/inc/Core/Database/BaseRepository.php
+++ b/inc/Core/Database/BaseRepository.php
@@ -1,5 +1,4 @@
 <?php
-// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Base Repository for shared database CRUD patterns.
  *
diff --git a/inc/Core/Database/Jobs/Jobs.php b/inc/Core/Database/Jobs/Jobs.php
index 8e4312c5c..e37eca3a6 100644
--- a/inc/Core/Database/Jobs/Jobs.php
+++ b/inc/Core/Database/Jobs/Jobs.php
@@ -1,5 +1,4 @@
 <?php
-// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * Jobs Database Repository
  *
diff --git a/inc/Core/Database/ProcessedItems/ProcessedItems.php b/inc/Core/Database/ProcessedItems/ProcessedItems.php
index 92be5df71..3f22e0258 100644
--- a/inc/Core/Database/ProcessedItems/ProcessedItems.php
+++ b/inc/Core/Database/ProcessedItems/ProcessedItems.php
@@ -1,5 +1,4 @@
 <?php
-// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.DirectDatabaseQuery.SchemaChange -- Data Machine owns custom operational tables and these paths require fresh runtime state or one-time schema mutation.
 /**
  * ProcessedItems database service - prevents duplicate processing at flow step level.
  *
@@ -116,7 +115,7 @@ public function get_processed_at( string $flow_step_id, string $source_type, str
 				self::STATUS_PROCESSED
 			)
 		);
-		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
+		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
 
 		if ( null === $value || '' === $value ) {
 			return null;