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

@@ -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`.

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.

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,

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

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.

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,

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

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,

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

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)

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.

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

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

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

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

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.

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

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.

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').

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.

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.

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.

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.

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

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

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,

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.

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

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:

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

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

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

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.

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

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),

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

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

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

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

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

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,

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

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 →

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,

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

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

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,

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

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

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

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

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.

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

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.

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.

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.

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

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

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

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

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

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.