fix: move file docblocks to immediately after <?php (before declare)

PHPCS Squiz.Commenting.FileComment requires the file docblock to be the
FIRST token after the opening <?php tag. Having declare(strict_types=1)
before the docblock means PHPCS sees no file docblock at all.

Fix: in every includes/*.php file, insert a minimal /** @package ... */
docblock immediately after <?php (no blank line = satisfies SpacingAfterOpen)
with a blank line after it (satisfies SpacingAfterComment), then declare()
then the class docblock.

Also fixes peptide-repo-core.php SpacingAfterOpen/SpacingAfterComment
by removing the blank line between <?php and the existing file docblock
and ensuring one blank line after it.

Agent-Session: claude-adopt-ci-20260616

includes/admin/class-pr-core-admin-columns.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-admin.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-ajax-handlers.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-candidate-queue-page.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-peptide-metaboxes.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-repo-daily-metaboxes.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-settings-renderer.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-settings.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-verification-metabox.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/admin/class-pr-core-verification-widget.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/api/class-pr-core-rest-controller.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/class-pr-core-activator.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/class-pr-core-autoloader.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/class-pr-core-deactivator.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/class-pr-core-seed-data.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/class-pr-core-seed-fixtures.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/class-pr-core.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-pr-core-internal-posts-provider.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-pr-core-related-posts-provider.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/core/class-pr-core-related-posts-section.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/cpt/class-pr-core-peptide-cpt.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/cpt/class-pr-core-peptide-meta-schema.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/cpt/class-pr-core-repo-daily-cpt.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/cpt/class-pr-core-schema-sanitizers.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/cpt/class-pr-core-topic-taxonomy.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/cpt/class-pr-core-verification-sanitizers.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/dto/class-pr-core-candidate-dto.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/dto/class-pr-core-dosing-row-dto.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/dto/class-pr-core-legal-cell-dto.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/dto/class-pr-core-peptide-dto.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/frontend/class-pr-core-disclaimer.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/frontend/class-pr-core-jsonld-drug.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/frontend/class-pr-core-jsonld-faq.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/frontend/class-pr-core-jsonld-webpage.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/frontend/class-pr-core-jsonld.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/frontend/class-pr-core-verification-display.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/interfaces/interface-related-posts-provider.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

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

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

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

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

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

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

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

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

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

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/repositories/class-pr-core-candidate-queue-repository.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/repositories/class-pr-core-dosing-repository.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/repositories/class-pr-core-legal-repository.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/repositories/class-pr-core-peptide-repository.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/scanner/class-pr-core-verification-scanner.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

includes/taxonomies/class-pr-core-repo-daily-taxonomy.php

@@ -1,4 +1,8 @@
 <?php
+/**
+ * @package Peptide_Repo_Core
+ */
+
 declare(strict_types=1);
 
 /**

peptide-repo-core.php

@@ -1,10 +1,10 @@
 <?php
-
 /**
  * Part of the Peptide Repo Core plugin.
  *
  * @package Peptide_Repo_Core
  */
+
 /**
  * Plugin Name: Peptide Repo Core
  * Plugin URI:  https://peptiderepo.com

template-parts/related-posts/card.php

@@ -1,10 +1,10 @@
 <?php
-
 /**
  * Part of the Peptide Repo Core plugin.
  *
  * @package Peptide_Repo_Core
  */
+
 /**
  * Related posts card template part.
  *