fix: add short descriptions to file docblocks + fix security/Yoda errors in metaboxes

- All 49 PHP includes files: expand minimal file docblocks to include a
  short description (satisfies Generic.Commenting.DocComment.MissingShort)
  Format: <?php\n/**\n * Filename-derived description.\n *\n * @package ...\n */
- settings.php delegation stubs: add compact docblocks to all 8 render_*
  methods (Squiz.Commenting.FunctionComment.Missing, lines 93-231)
- settings.php: compress mirrored @var constant docblocks to single-line;
  remove redundant intermediate class docblock → 273 lines (was 315)
- rest-controller.php: compress 1 mirrored @var docblock → 298 lines
- migration-0004: compress 4 property docblocks → 288 lines
- verification-widget.php line 111: cast days_since to int + phpcs:ignore
- verification-metabox.php line 80: phpcs:ignore on hardcoded badge_class
- peptide-metaboxes.php line 86: phpcs:ignore EscapeOutput (esc_attr'd above)
- peptide-metaboxes.php lines 147/148: Yoda null !== dose_min/dose_max
- peptide-metaboxes.php line 248: phpcs:ignore InputNotSanitized (isset only)
- peptide-metaboxes.php line 259: wrap pr_core_editorial_review_status in wp_unslash()
- peptide-metaboxes.php line 262: Yoda 'published' !== old_status

Agent-Session: claude-adopt-ci-20260616

includes/migrations/class-pr-core-migration-0001-dosing-rows.php

@@ -1,5 +1,7 @@
 <?php
 /**
+ * Migration 0001 Dosing Rows.
+ *
  * @package Peptide_Repo_Core
  */
 

includes/migrations/class-pr-core-migration-0002-legal-cells.php

@@ -1,5 +1,7 @@
 <?php
 /**
+ * Migration 0002 Legal Cells.
+ *
  * @package Peptide_Repo_Core
  */
 

includes/migrations/class-pr-core-migration-0003-candidate-queue.php

@@ -1,5 +1,7 @@
 <?php
 /**
+ * Migration 0003 Candidate Queue.
+ *
  * @package Peptide_Repo_Core
  */
 

includes/migrations/class-pr-core-migration-0004-backfill-peptide-meta.php

@@ -1,5 +1,9 @@
 <?php
-/** @package Peptide_Repo_Core */
+/**
+ * Migration 0004: Backfill peptide schema meta.
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**
@@ -31,32 +35,16 @@ declare(strict_types=1);
  */
 class PR_Core_Migration_0004_Backfill_Peptide_Meta {
 
-	/**
-	 * Meta key: molecular formula (PR Core namespace).
-	 *
-	 * @var string Meta key: molecular formula (PR Core namespace).
-	 */
+	/** @var string Meta key: molecular formula (PR Core namespace). */
 	public const META_FORMULA = '_pr_molecular_formula';
 
-	/**
-	 * Meta key: molecular weight as float string (PR Core namespace).
-	 *
-	 * @var string Meta key: molecular weight as float string (PR Core namespace).
-	 */
+	/** @var string Meta key: molecular weight as float string (PR Core namespace). */
 	public const META_WEIGHT = '_pr_molecular_weight';
 
-	/**
-	 * Meta key: aliases JSON array (PR Core namespace).
-	 *
-	 * @var string Meta key: aliases JSON array (PR Core namespace).
-	 */
+	/** @var string Meta key: aliases JSON array (PR Core namespace). */
 	public const META_ALIASES = '_pr_aliases';
 
-	/**
-	 * HTTP client for PubChem REST API.
-	 *
-	 * @var PR_Core_Pubchem_Client HTTP client for PubChem REST API.
-	 */
+	/** @var PR_Core_Pubchem_Client HTTP client for PubChem REST API. */
 	private PR_Core_Pubchem_Client $pubchem;
 
 	/**

includes/migrations/class-pr-core-migration-runner.php

@@ -1,5 +1,7 @@
 <?php
 /**
+ * Migration Runner.
+ *
  * @package Peptide_Repo_Core
  */
 

includes/migrations/class-pr-core-pubchem-client.php

@@ -1,5 +1,7 @@
 <?php
 /**
+ * Pubchem Client.
+ *
  * @package Peptide_Repo_Core
  */