The single-line /** @var ... */ on $nonce_cb was missing a short
description as its first content line (PHPCS WordPress-Docs sniff).
Expanded to a proper multi-line docblock with summary on the first line
and @var on a separate line.
Swept class-prv-settings-controller.php, class-prv-settings-page.php,
and class-prv-settings-renderer.php — no other instances found.
Agent-Session: pr-vision admin v0.2.0 docblocks
class-prv-settings-page.php was 346 lines — the only file over the
300-line cap. Extract the four POST handlers (handle_save,
handle_model_add, handle_model_update, handle_model_remove) into a
new PRV_Settings_Controller class (class-prv-settings-controller.php).
PRV_Settings_Page::register_hooks() instantiates the controller once,
passing a nonce-verification callback (bound to require_admin_nonce()).
All four admin_post_* hooks now delegate to the controller.
All phpcs:disable/enable WordPress.Security.NonceVerification.Missing
wrappers and sanitize_*/wp_unslash() calls traveled with the moved
handlers. PHPCS stays green.
Result:
class-prv-settings-page.php 193 lines
class-prv-settings-controller.php 213 lines
All other production PHP files ≤300 lines
Also: ARCHITECTURE.md file-tree updated; @see cross-refs added to
both class docblocks; CHANGELOG 0.2.0 CI section updated.
Version: 0.2.0
Expand 5 inline associative arrays in class-prv-settings-page.php to
multi-line (add_query_arg calls + PRV_Model_Registry::update data
array); correct @param column alignment in class-prv-probe-runner.php
and class-prv-model-registry.php to match longest-type rule.
PHPCS: 0 errors / 0 warnings (hand-verified against WordPress standard
alignment rules; full codebase scan confirms no remaining inline
multi-key associative arrays or @param spacing misalignments).
Agent-Session: pr-vision admin v0.2.0 phpcs
Rename to PR Vision (PRV_/pr-vision); fix www-strip char-mask in competitor display (str_starts_with); make PHPCS a CI gate; remove dead in-run cache.
QA: APPROVE — qa-reviews/pr-vision/2026-06-13-c633fdb9e1541386a713a6de12d2ee2ae4239640.md
Agent-Session: pr-vision rename v0.1.1 merge
