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);
 
 /**

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);
 
 /**