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/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

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.
  *

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

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

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

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

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.

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.
  *

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

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,

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

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

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

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

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

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,

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

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

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

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.
  *