From 0e1551be42e684cd0b9280022216fcd56088aa5a Mon Sep 17 00:00:00 2001
From: peptiderepo <peptiderepo@users.noreply.github.com>
Date: Thu, 23 Apr 2026 03:26:50 +0000
Subject: [PATCH] fix(phpcs): move ignore pragmas into file-level docblocks

File-level sniffs like WordPress.Files.FileName are evaluated at the file level,
not at code level. They require phpcs:ignore directives to be placed within the
file-level docblock (/** ... */), not in code comments.

Moved all 81 phpcs:ignore pragmas from code comments to the file-level docblocks.
This applies to:
- 79 class files with class-naming convention ignores
- prautoblogger.php with strict-types docblock ignore
- uninstall.php with strict-types docblock ignore
---
 includes/admin/class-admin-notices.php                      | 3 ++-
 includes/admin/class-admin-page.php                         | 3 ++-
 includes/admin/class-dashboard-widget.php                   | 3 ++-
 includes/admin/class-ideas-browser.php                      | 3 ++-
 includes/admin/class-image-model-registry.php               | 3 ++-
 includes/admin/class-log-viewer.php                         | 3 ++-
 includes/admin/class-metrics-page.php                       | 3 ++-
 includes/admin/class-post-list-columns.php                  | 3 ++-
 includes/admin/class-post-metabox.php                       | 3 ++-
 includes/admin/class-review-queue.php                       | 3 ++-
 includes/admin/class-settings-fields-extended.php           | 3 ++-
 includes/admin/class-settings-fields.php                    | 3 ++-
 includes/admin/fields/class-open-router-model-field.php     | 3 ++-
 includes/admin/fields/class-source-status-field.php         | 3 ++-
 includes/class-activator.php                                | 3 ++-
 includes/class-ajax-handlers.php                            | 3 ++-
 includes/class-autoloader.php                               | 3 ++-
 includes/class-deactivator.php                              | 3 ++-
 includes/class-encryption.php                               | 3 ++-
 includes/class-executor.php                                 | 3 ++-
 includes/class-generation-lock.php                          | 3 ++-
 includes/class-migrate-remove-cloudflare-v0100.php          | 3 ++-
 includes/class-prautoblogger.php                            | 3 ++-
 includes/class-schema-installer.php                         | 3 ++-
 includes/core/class-analysis-prompts.php                    | 3 ++-
 includes/core/class-article-worker.php                      | 3 ++-
 includes/core/class-chief-editor.php                        | 3 ++-
 includes/core/class-content-analyzer.php                    | 3 ++-
 includes/core/class-content-generator.php                   | 3 ++-
 includes/core/class-content-prompts.php                     | 3 ++-
 includes/core/class-cost-reporter.php                       | 3 ++-
 includes/core/class-cost-tracker.php                        | 3 ++-
 includes/core/class-ga4-client.php                          | 3 ++-
 includes/core/class-idea-scorer.php                         | 3 ++-
 includes/core/class-image-media-sideloader.php              | 3 ++-
 includes/core/class-image-nsfw-retry.php                    | 3 ++-
 includes/core/class-image-pipeline.php                      | 3 ++-
 includes/core/class-image-prompt-builder.php                | 3 ++-
 includes/core/class-json-extractor.php                      | 3 ++-
 includes/core/class-logger.php                              | 3 ++-
 includes/core/class-metrics-collector.php                   | 3 ++-
 includes/core/class-peptide-linker.php                      | 3 ++-
 includes/core/class-pipeline-runner.php                     | 3 ++-
 includes/core/class-post-assembler.php                      | 3 ++-
 includes/core/class-publisher.php                           | 3 ++-
 includes/core/class-research-reaper.php                     | 3 ++-
 includes/core/class-semantic-dedup.php                      | 3 ++-
 includes/core/class-source-collector.php                    | 3 ++-
 includes/frontend/class-article-typography.php              | 3 ++-
 includes/frontend/class-posts-widget.php                    | 3 ++-
 includes/models/class-analysis-result.php                   | 3 ++-
 includes/models/class-article-idea.php                      | 3 ++-
 includes/models/class-content-request.php                   | 3 ++-
 includes/models/class-content-score.php                     | 3 ++-
 includes/models/class-editorial-review.php                  | 3 ++-
 includes/models/class-generation-log.php                    | 3 ++-
 includes/models/class-source-data.php                       | 3 ++-
 includes/providers/class-image-nsfw-blocked.php             | 3 ++-
 includes/providers/class-llm-research-provider.php          | 3 ++-
 includes/providers/class-open-router-config.php             | 3 ++-
 includes/providers/class-open-router-embedding-provider.php | 3 ++-
 includes/providers/class-open-router-image-batch.php        | 3 ++-
 includes/providers/class-open-router-image-pricing.php      | 3 ++-
 includes/providers/class-open-router-image-provider.php     | 3 ++-
 includes/providers/class-open-router-image-support.php      | 3 ++-
 includes/providers/class-open-router-pricing.php            | 3 ++-
 includes/providers/class-open-router-provider.php           | 3 ++-
 includes/providers/class-open-router-request-builder.php    | 3 ++-
 includes/providers/class-open-router-response-parser.php    | 3 ++-
 includes/providers/class-open-router-validator.php          | 3 ++-
 includes/providers/class-reddit-availability.php            | 3 ++-
 includes/providers/class-reddit-json-client.php             | 3 ++-
 includes/providers/class-reddit-provider.php                | 3 ++-
 includes/providers/class-reddit-rss-parser.php              | 3 ++-
 includes/providers/class-runware-image-pricing.php          | 3 ++-
 includes/providers/class-runware-image-provider.php         | 3 ++-
 includes/providers/class-runware-image-support.php          | 3 ++-
 includes/services/class-open-router-model-normalizer.php    | 3 ++-
 includes/services/class-open-router-model-registry.php      | 3 ++-
 prautoblogger.php                                           | 3 ++-
 uninstall.php                                               | 3 ++-
 81 files changed, 162 insertions(+), 81 deletions(-)

diff --git a/includes/admin/class-admin-notices.php b/includes/admin/class-admin-notices.php
index df97733..c75fe4a 100755
--- a/includes/admin/class-admin-notices.php
+++ b/includes/admin/class-admin-notices.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Displays admin notices for onboarding, errors, and budget warnings.
  *
  * Triggered by: PRAutoBlogger::register_admin_hooks() on `admin_notices`.
diff --git a/includes/admin/class-admin-page.php b/includes/admin/class-admin-page.php
index bcbbfd8..cc13d88 100755
--- a/includes/admin/class-admin-page.php
+++ b/includes/admin/class-admin-page.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Registers and renders the main PRAutoBlogger settings page in wp-admin.
  *
  * Uses the WordPress Settings API for option registration, sanitization, and rendering.
diff --git a/includes/admin/class-dashboard-widget.php b/includes/admin/class-dashboard-widget.php
index 436c832..e457a2e 100755
--- a/includes/admin/class-dashboard-widget.php
+++ b/includes/admin/class-dashboard-widget.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * WordPress Dashboard widget showing PRAutoBlogger generation status at a glance.
  *
  * Displays: last generation time, articles generated today, monthly cost,
diff --git a/includes/admin/class-ideas-browser.php b/includes/admin/class-ideas-browser.php
index 9e1df82..db6c396 100644
--- a/includes/admin/class-ideas-browser.php
+++ b/includes/admin/class-ideas-browser.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Admin page listing analysis results (article ideas) with per-idea generation.
  *
  * Triggered by: PRAutoBlogger::register_admin_hooks() on `admin_menu`.
diff --git a/includes/admin/class-image-model-registry.php b/includes/admin/class-image-model-registry.php
index b25b85f..241c986 100644
--- a/includes/admin/class-image-model-registry.php
+++ b/includes/admin/class-image-model-registry.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Static registry of available image generation models.
  *
  * What: Returns a hardcoded list of image models for the admin model picker.
diff --git a/includes/admin/class-log-viewer.php b/includes/admin/class-log-viewer.php
index 25fd482..1493e37 100755
--- a/includes/admin/class-log-viewer.php
+++ b/includes/admin/class-log-viewer.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Admin page displaying structured application log entries.
  *
  * Provides level filtering (error/warning/info/debug), text search,
diff --git a/includes/admin/class-metrics-page.php b/includes/admin/class-metrics-page.php
index 0ca20bf..fc2e655 100755
--- a/includes/admin/class-metrics-page.php
+++ b/includes/admin/class-metrics-page.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Admin page displaying cost dashboard, content scores, and generation history.
  *
  * Shows: monthly spend, daily cost chart, spend by pipeline stage, budget
diff --git a/includes/admin/class-post-list-columns.php b/includes/admin/class-post-list-columns.php
index 143f78e..5d96b6a 100644
--- a/includes/admin/class-post-list-columns.php
+++ b/includes/admin/class-post-list-columns.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Adds "Writing Model", "Image Model", and "Cost" columns to the Posts list.
  *
  * Shows which LLM wrote each article, which model generated its featured image,
diff --git a/includes/admin/class-post-metabox.php b/includes/admin/class-post-metabox.php
index cffa5ba..63ad522 100755
--- a/includes/admin/class-post-metabox.php
+++ b/includes/admin/class-post-metabox.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Adds a metabox to posts showing PRAutoBlogger generation metadata.
  *
  * Only appears on posts that were generated by PRAutoBlogger (checked via
diff --git a/includes/admin/class-review-queue.php b/includes/admin/class-review-queue.php
index 63c4789..58a4785 100755
--- a/includes/admin/class-review-queue.php
+++ b/includes/admin/class-review-queue.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Admin page listing generated draft posts for editorial review.
  *
  * Provides approve (publish), edit (opens WP editor), and reject (trash)
diff --git a/includes/admin/class-settings-fields-extended.php b/includes/admin/class-settings-fields-extended.php
index 27bb116..c8c6466 100644
--- a/includes/admin/class-settings-fields-extended.php
+++ b/includes/admin/class-settings-fields-extended.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Extended settings fields: schedule, publishing, analytics, display, and images.
  *
  * What: Declarative field definitions for operational settings sections.
diff --git a/includes/admin/class-settings-fields.php b/includes/admin/class-settings-fields.php
index 508daca..9c71398 100755
--- a/includes/admin/class-settings-fields.php
+++ b/includes/admin/class-settings-fields.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Declarative settings fields and sections for the PRAutoBlogger admin page.
  *
  * Centralizes all field and section definitions in one place, making it trivial
diff --git a/includes/admin/fields/class-open-router-model-field.php b/includes/admin/fields/class-open-router-model-field.php
index 5e55366..4aba6d0 100644
--- a/includes/admin/fields/class-open-router-model-field.php
+++ b/includes/admin/fields/class-open-router-model-field.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Renders the interactive model-picker field for OpenRouter models.
  *
  * What: a button showing the current model's name + pricing. Clicking it
diff --git a/includes/admin/fields/class-source-status-field.php b/includes/admin/fields/class-source-status-field.php
index ee0933b..b42ab51 100644
--- a/includes/admin/fields/class-source-status-field.php
+++ b/includes/admin/fields/class-source-status-field.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Renders the Reddit source status indicator in the admin settings.
  *
  * What: shows RSS (primary) and .json (fallback) availability with
diff --git a/includes/class-activator.php b/includes/class-activator.php
index a39ee3d..59ad098 100755
--- a/includes/class-activator.php
+++ b/includes/class-activator.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Handles plugin activation: creates database tables, sets default options,
  * and schedules the initial cron job.
  *
diff --git a/includes/class-ajax-handlers.php b/includes/class-ajax-handlers.php
index a2d680a..c6987b3 100644
--- a/includes/class-ajax-handlers.php
+++ b/includes/class-ajax-handlers.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * AJAX endpoint handlers for PRAutoBlogger admin actions.
  *
  * What: Handles image generation, model registry, and connection test AJAX requests.
diff --git a/includes/class-autoloader.php b/includes/class-autoloader.php
index 74bfd82..5997cca 100755
--- a/includes/class-autoloader.php
+++ b/includes/class-autoloader.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * PSR-4-inspired autoloader for PRAutoBlogger classes.
  *
  * Maps class names like `PRAutoBlogger_Content_Generator` to file paths like
diff --git a/includes/class-deactivator.php b/includes/class-deactivator.php
index f22666d..851d894 100755
--- a/includes/class-deactivator.php
+++ b/includes/class-deactivator.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Handles plugin deactivation: clears scheduled cron events and transients.
  *
  * Note: does NOT delete data or options — that happens in uninstall.php.
diff --git a/includes/class-encryption.php b/includes/class-encryption.php
index 74d8ce7..04582ef 100755
--- a/includes/class-encryption.php
+++ b/includes/class-encryption.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Encrypts and decrypts sensitive option values (API keys, secrets).
  *
  * Uses OpenSSL AES-256-CBC with a key derived from wp_salt('auth').
diff --git a/includes/class-executor.php b/includes/class-executor.php
index 6095e37..a2edfc2 100644
--- a/includes/class-executor.php
+++ b/includes/class-executor.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Cron/AJAX handlers for content generation, metrics collection, model registry.
  *
  * Triggered by: PRAutoBlogger hook registration.
diff --git a/includes/class-generation-lock.php b/includes/class-generation-lock.php
index 6bc30fd..39357a6 100644
--- a/includes/class-generation-lock.php
+++ b/includes/class-generation-lock.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Database-level atomic mutex for content generation.
  *
  * What: Provides acquire/release/check semantics for a single-writer generation lock.
diff --git a/includes/class-migrate-remove-cloudflare-v0100.php b/includes/class-migrate-remove-cloudflare-v0100.php
index e414238..2adfee8 100644
--- a/includes/class-migrate-remove-cloudflare-v0100.php
+++ b/includes/class-migrate-remove-cloudflare-v0100.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * One-shot v0.10.0 migration — remove Cloudflare Workers AI as image provider.
  *
  * Cloudflare Workers AI was removed as an image provider in v0.10.0.
diff --git a/includes/class-prautoblogger.php b/includes/class-prautoblogger.php
index b7ca1f1..0cbba6e 100644
--- a/includes/class-prautoblogger.php
+++ b/includes/class-prautoblogger.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Main orchestrator for the PRAutoBlogger plugin.
  *
  * Registers all WordPress hooks (actions and filters) and wires up dependencies.
diff --git a/includes/class-schema-installer.php b/includes/class-schema-installer.php
index 3327b4f..260c295 100644
--- a/includes/class-schema-installer.php
+++ b/includes/class-schema-installer.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Creates / updates the plugin's custom database tables via `dbDelta`.
  *
  * Extracted from `PRAutoBlogger_Activator` in v0.8.2 to keep that class
diff --git a/includes/core/class-analysis-prompts.php b/includes/core/class-analysis-prompts.php
index a233f9f..9f2c6e2 100644
--- a/includes/core/class-analysis-prompts.php
+++ b/includes/core/class-analysis-prompts.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Prompt construction for the content analysis LLM call.
  *
  * What: Builds system and user prompts for source-data analysis, including
diff --git a/includes/core/class-article-worker.php b/includes/core/class-article-worker.php
index 27745aa..2063e88 100644
--- a/includes/core/class-article-worker.php
+++ b/includes/core/class-article-worker.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Generates a single article: content → editorial review → publish/draft.
  *
  * Extracted from Pipeline_Runner so each chained cron job has a focused,
diff --git a/includes/core/class-chief-editor.php b/includes/core/class-chief-editor.php
index d48c796..b219970 100755
--- a/includes/core/class-chief-editor.php
+++ b/includes/core/class-chief-editor.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Chief Editor agent — LLM-powered editorial review of generated content.
  *
  * Reviews articles for quality, accuracy, SEO, and tone before publishing.
diff --git a/includes/core/class-content-analyzer.php b/includes/core/class-content-analyzer.php
index ae3bd7a..c7a9985 100755
--- a/includes/core/class-content-analyzer.php
+++ b/includes/core/class-content-analyzer.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Analyzes collected source data using an LLM to detect recurring patterns:
  * questions people ask, complaints/pain points, and product comparisons.
  *
diff --git a/includes/core/class-content-generator.php b/includes/core/class-content-generator.php
index 793f830..f566faf 100755
--- a/includes/core/class-content-generator.php
+++ b/includes/core/class-content-generator.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Writer agent — generates blog post content from article ideas.
  *
  * Supports two configurable pipeline modes:
diff --git a/includes/core/class-content-prompts.php b/includes/core/class-content-prompts.php
index 6f7f2c2..399d374 100644
--- a/includes/core/class-content-prompts.php
+++ b/includes/core/class-content-prompts.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Builds all LLM prompts used by the content generation pipeline.
  *
  * Centralises prompt construction so Content_Generator stays lean and
diff --git a/includes/core/class-cost-reporter.php b/includes/core/class-cost-reporter.php
index 644445d..4591789 100644
--- a/includes/core/class-cost-reporter.php
+++ b/includes/core/class-cost-reporter.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Provides historical cost reporting and analysis methods.
  *
  * Extracted from PRAutoBlogger_Cost_Tracker, this class handles all read-only
diff --git a/includes/core/class-cost-tracker.php b/includes/core/class-cost-tracker.php
index 42454f6..4b0fe4c 100755
--- a/includes/core/class-cost-tracker.php
+++ b/includes/core/class-cost-tracker.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Tracks all API costs and enforces monthly budget limits.
  *
  * Every LLM API call in the plugin is logged through this class. The budget
diff --git a/includes/core/class-ga4-client.php b/includes/core/class-ga4-client.php
index 0c1f078..13f0871 100755
--- a/includes/core/class-ga4-client.php
+++ b/includes/core/class-ga4-client.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Google Analytics 4 API client for fetching post performance metrics.
  *
  * Handles OAuth2 service account authentication and the GA4 Data API.
diff --git a/includes/core/class-idea-scorer.php b/includes/core/class-idea-scorer.php
index 1d7d89b..c454f35 100755
--- a/includes/core/class-idea-scorer.php
+++ b/includes/core/class-idea-scorer.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Ranks and deduplicates article ideas from analysis results.
  *
  * Uses PRAutoBlogger_Semantic_Dedup for similarity detection — embedding-based
diff --git a/includes/core/class-image-media-sideloader.php b/includes/core/class-image-media-sideloader.php
index 85dc41e..26d4605 100644
--- a/includes/core/class-image-media-sideloader.php
+++ b/includes/core/class-image-media-sideloader.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Downloads generated images and imports them into the WordPress media library.
  *
  * Handles sideloading (importing external images as WordPress attachments),
diff --git a/includes/core/class-image-nsfw-retry.php b/includes/core/class-image-nsfw-retry.php
index 5f50de2..0a440b4 100644
--- a/includes/core/class-image-nsfw-retry.php
+++ b/includes/core/class-image-nsfw-retry.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Single-shot retry of NSFW-blocked image slots with a sanitized prompt.
  *
  * When an image provider rejects a prompt via its content filter, its
diff --git a/includes/core/class-image-pipeline.php b/includes/core/class-image-pipeline.php
index 20f9f1b..56764d5 100644
--- a/includes/core/class-image-pipeline.php
+++ b/includes/core/class-image-pipeline.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Orchestrates image generation for published articles.
  *
  * Generates two images per article (A/B): Image A (article-driven) as featured
diff --git a/includes/core/class-image-prompt-builder.php b/includes/core/class-image-prompt-builder.php
index 4de2ef4..ebb29c6 100644
--- a/includes/core/class-image-prompt-builder.php
+++ b/includes/core/class-image-prompt-builder.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Builds image prompts from article content or source data.
  *
  * Uses a cheap LLM (via OpenRouter) to distill article content into concise
diff --git a/includes/core/class-json-extractor.php b/includes/core/class-json-extractor.php
index 81a26bd..8d3aa8a 100644
--- a/includes/core/class-json-extractor.php
+++ b/includes/core/class-json-extractor.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Extracts valid JSON from potentially dirty LLM response strings.
  *
  * Many models ignore the `response_format: json_object` instruction and wrap
diff --git a/includes/core/class-logger.php b/includes/core/class-logger.php
index 7d424ad..7990eec 100755
--- a/includes/core/class-logger.php
+++ b/includes/core/class-logger.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Structured logging with configurable verbosity levels.
  *
  * Writes log entries to a custom database table and optionally forwards
diff --git a/includes/core/class-metrics-collector.php b/includes/core/class-metrics-collector.php
index 5e6a377..912253f 100755
--- a/includes/core/class-metrics-collector.php
+++ b/includes/core/class-metrics-collector.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Collects post performance metrics from WordPress native data and Google Analytics 4.
  *
  * Runs on a separate cron schedule (every 6 hours) to gather pageviews, bounce rate,
diff --git a/includes/core/class-peptide-linker.php b/includes/core/class-peptide-linker.php
index e9bea62..a1a6682 100644
--- a/includes/core/class-peptide-linker.php
+++ b/includes/core/class-peptide-linker.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Deterministic post-processor that hyperlinks peptide mentions in HTML content.
  *
  * Scans generated article HTML for any peptide name that exists in the PR Core
diff --git a/includes/core/class-pipeline-runner.php b/includes/core/class-pipeline-runner.php
index c76674b..436c242 100755
--- a/includes/core/class-pipeline-runner.php
+++ b/includes/core/class-pipeline-runner.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Executes the content generation pipeline using a chained-job architecture.
  *
  * Orchestrates: Budget check → Collect source data → Analyze patterns →
diff --git a/includes/core/class-post-assembler.php b/includes/core/class-post-assembler.php
index f017db8..872600d 100644
--- a/includes/core/class-post-assembler.php
+++ b/includes/core/class-post-assembler.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Post-creation assembly helpers: taxonomy, log linking, images, content sanitization.
  *
  * What: After wp_insert_post, assigns categories/tags, links generation logs,
diff --git a/includes/core/class-publisher.php b/includes/core/class-publisher.php
index 93713e7..2efec36 100755
--- a/includes/core/class-publisher.php
+++ b/includes/core/class-publisher.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Creates WordPress posts from generated and editor-approved content.
  *
  * Handles both publishing (editor-approved) and saving as draft (editor-rejected).
diff --git a/includes/core/class-research-reaper.php b/includes/core/class-research-reaper.php
index cf1eed5..4c74c7f 100644
--- a/includes/core/class-research-reaper.php
+++ b/includes/core/class-research-reaper.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Daily cron that retroactively amortizes orphan `llm_research` rows.
  *
  * When a pipeline run dies between post creation and the final
diff --git a/includes/core/class-semantic-dedup.php b/includes/core/class-semantic-dedup.php
index 2526d57..829af75 100644
--- a/includes/core/class-semantic-dedup.php
+++ b/includes/core/class-semantic-dedup.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Semantic deduplication using embedding cosine similarity.
  *
  * Embeds candidate topics and recent post titles in a single batch API call,
diff --git a/includes/core/class-source-collector.php b/includes/core/class-source-collector.php
index 0d19271..9fd5944 100755
--- a/includes/core/class-source-collector.php
+++ b/includes/core/class-source-collector.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Orchestrates data collection from all enabled source providers.
  *
  * Iterates through enabled sources (Reddit, LLM Research), calls their
diff --git a/includes/frontend/class-article-typography.php b/includes/frontend/class-article-typography.php
index 5edd952..96385d7 100644
--- a/includes/frontend/class-article-typography.php
+++ b/includes/frontend/class-article-typography.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Injects frontend typography and table styles for PRAutoBlogger-generated posts.
  *
  * What: Outputs inline CSS on all single post pages, applying
diff --git a/includes/frontend/class-posts-widget.php b/includes/frontend/class-posts-widget.php
index 380eb76..b6ad308 100644
--- a/includes/frontend/class-posts-widget.php
+++ b/includes/frontend/class-posts-widget.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Registers the [prautoblogger_posts] shortcode and its supporting REST API endpoint.
  *
  * This is PRAutoBlogger's first public-facing frontend feature. It renders a React-powered
diff --git a/includes/models/class-analysis-result.php b/includes/models/class-analysis-result.php
index 99d2034..135dd70 100755
--- a/includes/models/class-analysis-result.php
+++ b/includes/models/class-analysis-result.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object representing an analyzed topic pattern (recurring question,
  * complaint, or comparison detected in source data).
  *
diff --git a/includes/models/class-article-idea.php b/includes/models/class-article-idea.php
index 5e12805..95ab540 100755
--- a/includes/models/class-article-idea.php
+++ b/includes/models/class-article-idea.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object representing a scored article idea ready for content generation.
  *
  * Created by the Idea_Scorer from Analysis_Results. Consumed by Content_Generator.
diff --git a/includes/models/class-content-request.php b/includes/models/class-content-request.php
index 7cf8551..5c66509 100755
--- a/includes/models/class-content-request.php
+++ b/includes/models/class-content-request.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object encapsulating all parameters for a content generation request.
  *
  * Bundles the article idea with user-configured generation preferences
diff --git a/includes/models/class-content-score.php b/includes/models/class-content-score.php
index 5026930..6c7c5d7 100755
--- a/includes/models/class-content-score.php
+++ b/includes/models/class-content-score.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object for a post's composite performance score.
  *
  * Triggered by: Metrics_Collector creates these; Content_Analyzer reads them for self-improvement.
diff --git a/includes/models/class-editorial-review.php b/includes/models/class-editorial-review.php
index 4884448..e3836de 100755
--- a/includes/models/class-editorial-review.php
+++ b/includes/models/class-editorial-review.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object representing the chief editor agent's review of generated content.
  *
  * Triggered by: Chief_Editor creates these; Publisher consumes them.
diff --git a/includes/models/class-generation-log.php b/includes/models/class-generation-log.php
index 9eee55e..a027c42 100755
--- a/includes/models/class-generation-log.php
+++ b/includes/models/class-generation-log.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object for an API call log entry (cost tracking).
  *
  * Triggered by: Cost_Tracker creates these; Metrics_Page displays them.
diff --git a/includes/models/class-source-data.php b/includes/models/class-source-data.php
index 2277355..bac0a05 100755
--- a/includes/models/class-source-data.php
+++ b/includes/models/class-source-data.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Value object representing a single piece of collected social media data
  * (e.g., a Reddit post or comment).
  *
diff --git a/includes/providers/class-image-nsfw-blocked.php b/includes/providers/class-image-nsfw-blocked.php
index e7c0a97..dd06ea8 100644
--- a/includes/providers/class-image-nsfw-blocked.php
+++ b/includes/providers/class-image-nsfw-blocked.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Exception raised when an image provider rejects a prompt as NSFW.
  *
  * Image providers (Runware, OpenRouter) return provider-specific error
diff --git a/includes/providers/class-llm-research-provider.php b/includes/providers/class-llm-research-provider.php
index 1e69609..08937bf 100644
--- a/includes/providers/class-llm-research-provider.php
+++ b/includes/providers/class-llm-research-provider.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * LLM Deep Research source provider — uses a reasoning-capable model to
  * identify trending topics, emerging questions, and content gaps in the niche.
  *
diff --git a/includes/providers/class-open-router-config.php b/includes/providers/class-open-router-config.php
index e7fc475..a59a56f 100644
--- a/includes/providers/class-open-router-config.php
+++ b/includes/providers/class-open-router-config.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Configuration helpers for OpenRouter provider.
  *
  * Resolves admin-configured settings for API endpoint selection
diff --git a/includes/providers/class-open-router-embedding-provider.php b/includes/providers/class-open-router-embedding-provider.php
index b053af3..7285dd7 100644
--- a/includes/providers/class-open-router-embedding-provider.php
+++ b/includes/providers/class-open-router-embedding-provider.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Fetches text embeddings from OpenRouter for semantic similarity comparisons.
  *
  * Used by the Idea Scorer to detect semantically similar topics that keyword
diff --git a/includes/providers/class-open-router-image-batch.php b/includes/providers/class-open-router-image-batch.php
index 94ea0d0..7eefe54 100644
--- a/includes/providers/class-open-router-image-batch.php
+++ b/includes/providers/class-open-router-image-batch.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Parallel image generation via curl_multi for OpenRouter.
  *
  * Fires multiple chat/completions requests concurrently using PHP's
diff --git a/includes/providers/class-open-router-image-pricing.php b/includes/providers/class-open-router-image-pricing.php
index 3e57431..b2dd1ad 100644
--- a/includes/providers/class-open-router-image-pricing.php
+++ b/includes/providers/class-open-router-image-pricing.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Pricing + model-id resolution helpers for the OpenRouter image provider.
  *
  * Mirrors the Runware pricing helper pattern. Each model's cost per image
diff --git a/includes/providers/class-open-router-image-provider.php b/includes/providers/class-open-router-image-provider.php
index 5e37bc8..2d233a8 100644
--- a/includes/providers/class-open-router-image-provider.php
+++ b/includes/providers/class-open-router-image-provider.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * OpenRouter image provider — model-agnostic, works with any image model.
  *
  * Triggered by: PRAutoBlogger_Image_Pipeline during content generation.
diff --git a/includes/providers/class-open-router-image-support.php b/includes/providers/class-open-router-image-support.php
index 2ad763e..1244114 100644
--- a/includes/providers/class-open-router-image-support.php
+++ b/includes/providers/class-open-router-image-support.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Support helpers for the OpenRouter image provider — API key lookup,
  * response parsing, retry backoff, and logging.
  *
diff --git a/includes/providers/class-open-router-pricing.php b/includes/providers/class-open-router-pricing.php
index 3a641b8..664a7b0 100644
--- a/includes/providers/class-open-router-pricing.php
+++ b/includes/providers/class-open-router-pricing.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * OpenRouter model pricing and availability lookup.
  *
  * Manages pricing tables, model lists, and cost estimation. Decoupled from
diff --git a/includes/providers/class-open-router-provider.php b/includes/providers/class-open-router-provider.php
index d414bef..217fb3c 100644
--- a/includes/providers/class-open-router-provider.php
+++ b/includes/providers/class-open-router-provider.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * OpenRouter API integration for all LLM calls (analysis, writing, editing).
  *
  * OpenRouter provides a unified API to access models from Anthropic, OpenAI,
diff --git a/includes/providers/class-open-router-request-builder.php b/includes/providers/class-open-router-request-builder.php
index 3aa34e9..72e3203 100644
--- a/includes/providers/class-open-router-request-builder.php
+++ b/includes/providers/class-open-router-request-builder.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Request builder for OpenRouter API calls.
  *
  * Encapsulates the logic for building HTTP request headers, including
diff --git a/includes/providers/class-open-router-response-parser.php b/includes/providers/class-open-router-response-parser.php
index 0ca1bd0..8e5c2c1 100644
--- a/includes/providers/class-open-router-response-parser.php
+++ b/includes/providers/class-open-router-response-parser.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Response parser for OpenRouter API responses.
  *
  * Encapsulates the logic for parsing and validating OpenRouter chat completion
diff --git a/includes/providers/class-open-router-validator.php b/includes/providers/class-open-router-validator.php
index 4f0da19..51fc775 100644
--- a/includes/providers/class-open-router-validator.php
+++ b/includes/providers/class-open-router-validator.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Credential + connectivity validator for the OpenRouter LLM provider.
  *
  * Split out of the provider to keep each file under the 300-line cap and
diff --git a/includes/providers/class-reddit-availability.php b/includes/providers/class-reddit-availability.php
index 3ac3c26..167eb18 100644
--- a/includes/providers/class-reddit-availability.php
+++ b/includes/providers/class-reddit-availability.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Reddit endpoint availability checker.
  *
  * Probes Reddit's RSS and .json endpoints to determine which data sources
diff --git a/includes/providers/class-reddit-json-client.php b/includes/providers/class-reddit-json-client.php
index 0191034..75e44d3 100644
--- a/includes/providers/class-reddit-json-client.php
+++ b/includes/providers/class-reddit-json-client.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Reddit HTTP client — fetches posts via RSS (primary) and .json (fallback).
  *
  * RSS feeds are the primary data source because they work reliably from datacenter
diff --git a/includes/providers/class-reddit-provider.php b/includes/providers/class-reddit-provider.php
index 60ad526..6fed888 100755
--- a/includes/providers/class-reddit-provider.php
+++ b/includes/providers/class-reddit-provider.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Reddit data provider — collects posts and comments from target subreddits.
  *
  * Uses Reddit RSS/Atom feeds as the PRIMARY data source (reliable from datacenter IPs,
diff --git a/includes/providers/class-reddit-rss-parser.php b/includes/providers/class-reddit-rss-parser.php
index 45ae4b3..56a3acb 100644
--- a/includes/providers/class-reddit-rss-parser.php
+++ b/includes/providers/class-reddit-rss-parser.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Reddit RSS/Atom feed parser — parses Atom XML into normalized post arrays.
  *
  * Handles parsing of Reddit's Atom/RSS feeds and mapping them to the standard
diff --git a/includes/providers/class-runware-image-pricing.php b/includes/providers/class-runware-image-pricing.php
index 363a4f2..32cd817 100644
--- a/includes/providers/class-runware-image-pricing.php
+++ b/includes/providers/class-runware-image-pricing.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Pricing + model-id resolution helpers for the Runware image provider.
  *
  * Each Runware FLUX model has a flat per-image cost sourced from
diff --git a/includes/providers/class-runware-image-provider.php b/includes/providers/class-runware-image-provider.php
index db108c2..7bb35f1 100644
--- a/includes/providers/class-runware-image-provider.php
+++ b/includes/providers/class-runware-image-provider.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Runware image provider — FLUX.1 schnell / dev via runware.ai.
  *
  * Default image backend as of 2026-04-21: schnell (runware:100@1) at
diff --git a/includes/providers/class-runware-image-support.php b/includes/providers/class-runware-image-support.php
index e56b9e7..e876a24 100644
--- a/includes/providers/class-runware-image-support.php
+++ b/includes/providers/class-runware-image-support.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Support helpers for the Runware image provider — API key lookup,
  * response parsing (URL fetch), retry backoff, and logging.
  *
diff --git a/includes/services/class-open-router-model-normalizer.php b/includes/services/class-open-router-model-normalizer.php
index dbcb2f4..e0610dd 100644
--- a/includes/services/class-open-router-model-normalizer.php
+++ b/includes/services/class-open-router-model-normalizer.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * Normalizes raw OpenRouter model data into the standardized record shape.
  *
  * Extracted from PRAutoBlogger_OpenRouter_Model_Registry so both classes stay
diff --git a/includes/services/class-open-router-model-registry.php b/includes/services/class-open-router-model-registry.php
index c54c699..46825a5 100644
--- a/includes/services/class-open-router-model-registry.php
+++ b/includes/services/class-open-router-model-registry.php
@@ -1,8 +1,9 @@
 <?php
-// phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
 declare(strict_types=1);
 
 /**
+ * phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
+ *
  * OpenRouter model registry — fetches, normalizes, and caches the model list.
  *
  * All config is constructor-injected. No PRAUTOBLOGGER_* constants referenced
diff --git a/prautoblogger.php b/prautoblogger.php
index df630b0..3bf53da 100644
--- a/prautoblogger.php
+++ b/prautoblogger.php
@@ -1,8 +1,9 @@
 <?php
 declare(strict_types=1);
-// phpcs:ignore Generic.PHP.RequireStrictTypes.MissingDeclaration -- strict_types must precede docblock
 
 /**
+ * phpcs:ignore Generic.PHP.RequireStrictTypes.MissingDeclaration -- strict_types must precede docblock
+ *
  * PRAutoBlogger — Automated Content Research & Publishing
  *
  * @wordpress-plugin
diff --git a/uninstall.php b/uninstall.php
index 205bb0b..132c314 100755
--- a/uninstall.php
+++ b/uninstall.php
@@ -1,8 +1,9 @@
 <?php
 declare(strict_types=1);
-// phpcs:ignore Generic.PHP.RequireStrictTypes.MissingDeclaration -- strict_types must precede docblock
 
 /**
+ * phpcs:ignore Generic.PHP.RequireStrictTypes.MissingDeclaration -- strict_types must precede docblock
+ *
  * Fired when the plugin is uninstalled (deleted) from WordPress.
  *
  * Removes ALL plugin data: custom tables, options, post meta, transients, and cron events.