PHPCS: fix file docblock format (short description + blank line after)

File-level docblocks lacked a short description and required blank line
between the block and declare(strict_types=1). WP PHPCS file comment
sniff requires both. All 21 PHP files corrected.

Agent-Session: pr-vision rename v0.1.1

includes/collector/class-prv-ai-visibility-collector.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * AI-visibility data collector for the PR Vision dashboard.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/collector/interface-prv-data-collector.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Contract for all PR Vision data collectors.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-activator.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Plugin activation handler.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-admin-page.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * PR Vision top-level admin page.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-autoloader.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Class and interface autoloader for the PR Vision plugin.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-collector-registry.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Registry for PR Vision data collectors and dashboard panels.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-config.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Configuration getters and default-seeding for PR Vision.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-cost-ledger.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Month-to-date cost tracking and budget-cap enforcement.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-cron.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * WP-Cron management for the weekly AI-visibility probe.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-deactivator.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Plugin deactivation handler.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-plugin.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Main orchestrator for the PR Vision plugin.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-probe-result.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Immutable value object returned by every probe provider.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-prv-probe-runner.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Orchestrates a full probe run across peptides, intents, and models.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**
@@ -86,7 +91,7 @@ class PRV_Probe_Runner {
 						$result = $provider->probe( $query );
 					} catch ( \Exception $e ) {
 						// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
-					error_log( sprintf( 'PRV: probe failed [%s / %s]: %s', $model, $peptide['slug'], $e->getMessage() ) );
+						error_log( sprintf( 'PRV: probe failed [%s / %s]: %s', $model, $peptide['slug'], $e->getMessage() ) );
 						++$counts['skipped_error'];
 						continue;
 					}
@@ -107,11 +112,11 @@ class PRV_Probe_Runner {
 	/**
 	 * Persist a single probe result to the database.
 	 *
-	 * @param string          $run_id     UUID for this run.
-	 * @param array<string,string> $peptide Peptide config with slug and label.
-	 * @param string          $model      Model identifier.
-	 * @param string          $intent_tpl Raw intent template string.
-	 * @param PRV_Probe_Result $result    Probe result.
+	 * @param string               $run_id     UUID for this run.
+	 * @param array<string,string> $peptide    Peptide config with slug and label.
+	 * @param string               $model      Model identifier.
+	 * @param string               $intent_tpl Raw intent template string.
+	 * @param PRV_Probe_Result     $result     Probe result.
 	 *
 	 * @return int Inserted row ID, or 0 on failure.
 	 */

includes/core/class-prv-table-manager.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Database table creation and schema versioning for PR Vision.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/panel/class-prv-ai-visibility-panel.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * AI-visibility dashboard panel renderer.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/panel/interface-prv-dashboard-panel.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Contract for all PR Vision dashboard panels.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/providers/class-prv-citation-detector.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Detects whether peptiderepo.com appears in LLM source citations.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/providers/class-prv-gateway-client.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Cloudflare AI Gateway HTTP client shared by all providers.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/providers/class-prv-openrouter-provider.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Generic OpenRouter provider for GPT-search and Gemini-search models.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/providers/class-prv-perplexity-provider.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Perplexity sonar provider — primary citation signal.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**

includes/providers/interface-prv-probe-provider.php

@@ -1,5 +1,10 @@
 <?php
-/** @package PrVision */
+/**
+ * Contract for all LLM probe providers.
+ *
+ * @package PrVision
+ */
+
 declare(strict_types=1);
 
 /**