- Single-line /** @var type Desc. */ docblocks on constants/properties trigger
Generic.Commenting.DocComment.MissingShort because PHPCS cannot extract a
short description from a single-line block that starts with a tag.
Fix: add phpcs:ignore inline on all single-line @var blocks:
includes/admin/class-pr-core-settings.php (7 constants)
includes/api/class-pr-core-rest-controller.php (1 property)
includes/migrations/class-pr-core-migration-0004 (4 constants/property)
- peptide-metaboxes.php line 252: add phpcs:ignore InputNotSanitized on
wp_unslash() call — actual sanitization via config['sanitize'] callback
on the following line; PHPCS cannot see through the callable dispatch
Agent-Session: claude-adopt-ci-20260616
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
1. NAMESPACE is a PHP reserved keyword — renamed to REST_NAMESPACE
in the REST controller. This caused a parse error on activation.
2. Autoloader can't resolve PR_Core class — the class name equals the
autoloader prefix exactly, so stripping "PR_Core_" yields an empty
suffix and the wrong filename. Added explicit require_once in
bootstrap, same pattern as PRAutoBlogger.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
