feat: verification scanner + admin UI (PR Core v0.4.0)

Implements recurring verification scanner, dashboard widget, per-post sidebar meta box, reader-facing last-verified display, and unified settings panel. Bumps to v0.4.0.

Co-authored-by: peptiderepo <peptiderepo@users.noreply.github.com>
This commit is contained in:
peptiderepo
2026-04-27 12:24:57 +07:00
committed by GitHub
parent 554b7aa293
commit c52cf9b3d6
15 changed files with 1150 additions and 266 deletions

View File

@@ -0,0 +1,128 @@
<?php
/**
* Unit tests for PR_Core_Verification_Scanner::compute_status().
*
* Run: php tests/unit/test-verification-scanner.php
* Exit code 0 = all pass, 1 = any failure.
*
* What's covered:
* - Empty last_verified → overdue.
* - Days < 90% of threshold → current.
* - Days >= 90% and < 100% of threshold → due.
* - Days >= threshold → overdue.
* - Boundary: exactly at 90% → due (not current).
* - high velocity applies 60-day threshold from option.
* - low velocity applies 365-day constant (not option).
* - medium/default applies 180-day threshold from option.
*
* @package PeptideRepoCore
*/
declare(strict_types=1);
require_once __DIR__ . '/../bootstrap.php';
// ── Additional stubs needed by the scanner ──────────────────────────────
if ( ! defined( 'DAY_IN_SECONDS' ) ) {
define( 'DAY_IN_SECONDS', 86400 );
}
/** @var array<string, mixed> $GLOBALS['pr_core_options'] Mocked option store. */
$GLOBALS['pr_core_options'] = [];
if ( ! function_exists( 'get_option' ) ) {
function get_option( string $key, $default = false ) {
return $GLOBALS['pr_core_options'][ $key ] ?? $default;
}
}
// ── Load the scanner class ──────────────────────────────────────────────
require_once __DIR__ . '/../../includes/scanner/class-pr-core-verification-scanner.php';
// ── Helper: build a date N days ago ────────────────────────────────────
function days_ago( int $days ): string {
return gmdate( 'Y-m-d', time() - ( $days * DAY_IN_SECONDS ) );
}
echo "== PR_Core_Verification_Scanner::compute_status() unit tests ==\n\n";
// ── Empty last_verified ─────────────────────────────────────────────────
echo "Empty last_verified:\n";
pr_assert_equals(
'overdue',
PR_Core_Verification_Scanner::compute_status( '', 'medium' ),
'empty string → overdue'
);
// ── Medium velocity (default 180-day threshold) ─────────────────────────
echo "\nMedium velocity (threshold=180, option default):\n";
$GLOBALS['pr_core_options'] = [];
// 160 days ago → 160 < 162 (90% of 180) → current.
pr_assert_equals( 'current', PR_Core_Verification_Scanner::compute_status( days_ago( 160 ), 'medium' ), '160 days → current' );
// 163 days ago → 163 >= 162 and < 180 → due.
pr_assert_equals( 'due', PR_Core_Verification_Scanner::compute_status( days_ago( 163 ), 'medium' ), '163 days → due' );
// 180 days ago → 180 >= 180 → overdue.
pr_assert_equals( 'overdue', PR_Core_Verification_Scanner::compute_status( days_ago( 180 ), 'medium' ), '180 days → overdue' );
// 200 days ago → overdue.
pr_assert_equals( 'overdue', PR_Core_Verification_Scanner::compute_status( days_ago( 200 ), 'medium' ), '200 days → overdue' );
// ── 90% boundary exactness ──────────────────────────────────────────────
echo "\n90% boundary (threshold=100):\n";
$GLOBALS['pr_core_options'] = [ 'pr_core_default_threshold' => 100 ];
// 89 days → 89 < 90 (90% of 100) → current.
pr_assert_equals( 'current', PR_Core_Verification_Scanner::compute_status( days_ago( 89 ), 'medium' ), '89 days (threshold 100) → current' );
// 90 days → 90 >= 90 and < 100 → due.
pr_assert_equals( 'due', PR_Core_Verification_Scanner::compute_status( days_ago( 90 ), 'medium' ), '90 days (threshold 100) → due (at boundary)' );
// 100 days → 100 >= 100 → overdue.
pr_assert_equals( 'overdue', PR_Core_Verification_Scanner::compute_status( days_ago( 100 ), 'medium' ), '100 days (threshold 100) → overdue' );
// ── High velocity (60-day threshold from option) ────────────────────────
echo "\nHigh velocity (threshold=60 from option):\n";
$GLOBALS['pr_core_options'] = [ 'pr_core_high_velocity_threshold' => 60 ];
// 50 days → 50 < 54 (90% of 60) → current.
pr_assert_equals( 'current', PR_Core_Verification_Scanner::compute_status( days_ago( 50 ), 'high' ), 'high: 50 days → current' );
// 55 days → 55 >= 54, < 60 → due.
pr_assert_equals( 'due', PR_Core_Verification_Scanner::compute_status( days_ago( 55 ), 'high' ), 'high: 55 days → due' );
// 61 days → overdue.
pr_assert_equals( 'overdue', PR_Core_Verification_Scanner::compute_status( days_ago( 61 ), 'high' ), 'high: 61 days → overdue' );
// ── Low velocity (365-day constant — ignores option) ────────────────────
echo "\nLow velocity (threshold=365, constant, ignores option):\n";
$GLOBALS['pr_core_options'] = [ 'pr_core_default_threshold' => 999 ]; // Should be ignored for low.
// 300 days → 300 < 328.5 (90% of 365) → current.
pr_assert_equals( 'current', PR_Core_Verification_Scanner::compute_status( days_ago( 300 ), 'low' ), 'low: 300 days → current' );
// 340 days → 340 >= 328.5, < 365 → due.
pr_assert_equals( 'due', PR_Core_Verification_Scanner::compute_status( days_ago( 340 ), 'low' ), 'low: 340 days → due' );
// 366 days → overdue.
pr_assert_equals( 'overdue', PR_Core_Verification_Scanner::compute_status( days_ago( 366 ), 'low' ), 'low: 366 days → overdue' );
// ── Unknown velocity falls through to medium/default ────────────────────
echo "\nUnknown velocity (falls to default/medium):\n";
$GLOBALS['pr_core_options'] = [ 'pr_core_default_threshold' => 180 ];
pr_assert_equals( 'current', PR_Core_Verification_Scanner::compute_status( days_ago( 100 ), 'unknown' ), 'unknown velocity: 100 days → current (uses default 180)' );
// ── Summary ─────────────────────────────────────────────────────────────
exit( pr_test_summary() );

View File

@@ -0,0 +1,131 @@
<?php
/**
* Unit tests for PR_Core_Settings verification methods.
*
* Run: php tests/unit/test-verification-settings.php
* Exit code 0 = all pass, 1 = any failure.
*
* What's covered:
* - sanitize_cadence() accepts valid values, rejects invalid → 'weekly'.
* - sanitize_emails() filters invalid addresses, preserves valid ones.
* - reschedule_cron() no-ops when old === new value.
* - reschedule_cron() clears + reschedules when value changes.
*
* @package PeptideRepoCore
*/
declare(strict_types=1);
require_once __DIR__ . '/../bootstrap.php';
// ── Additional stubs needed by the settings class ───────────────────────
$GLOBALS['pr_core_options'] = [];
$GLOBALS['pr_core_cron_calls'] = [];
if ( ! function_exists( 'get_option' ) ) {
function get_option( string $key, $default = false ) {
return $GLOBALS['pr_core_options'][ $key ] ?? $default;
}
}
if ( ! function_exists( 'update_option' ) ) {
function update_option( string $key, $value ): bool {
$GLOBALS['pr_core_options'][ $key ] = $value;
return true;
}
}
if ( ! function_exists( 'register_setting' ) ) {
function register_setting( string $group, string $option, array $args = [] ): void {}
}
if ( ! function_exists( 'add_settings_section' ) ) {
function add_settings_section( string $id, string $title, $cb, string $page ): void {}
}
if ( ! function_exists( 'add_settings_field' ) ) {
function add_settings_field( string $id, string $title, $cb, string $page, string $section = '' ): void {}
}
if ( ! function_exists( 'is_email' ) ) {
function is_email( string $email ): bool {
return (bool) filter_var( $email, FILTER_VALIDATE_EMAIL );
}
}
if ( ! function_exists( 'wp_clear_scheduled_hook' ) ) {
function wp_clear_scheduled_hook( string $hook ): void {
$GLOBALS['pr_core_cron_calls'][] = [ 'action' => 'clear', 'hook' => $hook ];
}
}
if ( ! function_exists( 'wp_schedule_event' ) ) {
function wp_schedule_event( int $timestamp, string $recurrence, string $hook ): void {
$GLOBALS['pr_core_cron_calls'][] = [ 'action' => 'schedule', 'hook' => $hook, 'recurrence' => $recurrence ];
}
}
// ── Load the settings class ─────────────────────────────────────────────
require_once __DIR__ . '/../../includes/cpt/class-pr-core-peptide-cpt.php';
require_once __DIR__ . '/../../includes/admin/class-pr-core-settings.php';
echo "== PR_Core_Settings verification methods unit tests ==\n\n";
// ── sanitize_cadence() ──────────────────────────────────────────────────
echo "sanitize_cadence():\n";
pr_assert_equals( 'daily', PR_Core_Settings::sanitize_cadence( 'daily' ), 'daily → daily' );
pr_assert_equals( 'weekly', PR_Core_Settings::sanitize_cadence( 'weekly' ), 'weekly → weekly' );
pr_assert_equals( 'monthly', PR_Core_Settings::sanitize_cadence( 'monthly' ), 'monthly → monthly' );
pr_assert_equals( 'weekly', PR_Core_Settings::sanitize_cadence( 'hourly' ), 'hourly (invalid) → weekly default' );
pr_assert_equals( 'weekly', PR_Core_Settings::sanitize_cadence( '' ), 'empty → weekly default' );
pr_assert_equals( 'weekly', PR_Core_Settings::sanitize_cadence( 'DAILY' ), 'uppercase → weekly (case-sensitive)' );
// ── sanitize_emails() ───────────────────────────────────────────────────
echo "\nsanitize_emails():\n";
pr_assert_equals( '', PR_Core_Settings::sanitize_emails( '' ), 'empty → empty' );
pr_assert_equals( 'admin@example.com', PR_Core_Settings::sanitize_emails( 'admin@example.com' ), 'valid single → kept' );
pr_assert_equals( '', PR_Core_Settings::sanitize_emails( 'not-an-email' ), 'invalid single → empty' );
pr_assert_equals( 'a@test.com, b@test.com', PR_Core_Settings::sanitize_emails( 'a@test.com, b@test.com' ), 'valid pair → both kept' );
pr_assert_equals( 'good@test.com', PR_Core_Settings::sanitize_emails( 'good@test.com, bad-email' ), 'mixed → only valid kept' );
pr_assert_equals( 'trimmed@test.com', PR_Core_Settings::sanitize_emails( ' trimmed@test.com ' ), 'whitespace trimmed around valid email' );
// ── reschedule_cron(): no-op when same value ────────────────────────────
echo "\nreschedule_cron() — no-op when value unchanged:\n";
$GLOBALS['pr_core_cron_calls'] = [];
PR_Core_Settings::reschedule_cron( 'weekly', 'weekly' );
pr_assert( empty( $GLOBALS['pr_core_cron_calls'] ), 'no cron calls when old === new' );
// ── reschedule_cron(): clears + reschedules on change ───────────────────
echo "\nreschedule_cron() — reschedules when value changes:\n";
$GLOBALS['pr_core_cron_calls'] = [];
PR_Core_Settings::reschedule_cron( 'weekly', 'daily' );
$actions = array_column( $GLOBALS['pr_core_cron_calls'], 'action' );
pr_assert( in_array( 'clear', $actions, true ), 'wp_clear_scheduled_hook was called' );
pr_assert( in_array( 'schedule', $actions, true ), 'wp_schedule_event was called' );
$schedule_call = null;
foreach ( $GLOBALS['pr_core_cron_calls'] as $call ) {
if ( 'schedule' === $call['action'] ) {
$schedule_call = $call;
break;
}
}
pr_assert( null !== $schedule_call, 'schedule call found' );
pr_assert_equals( 'pr_core_verification_scan', $schedule_call['hook'] ?? '', 'rescheduled hook = pr_core_verification_scan' );
pr_assert_equals( 'daily', $schedule_call['recurrence'] ?? '', 'rescheduled with new cadence "daily"' );
// Clear fires before schedule (correct ordering).
$clear_idx = array_search( 'clear', $actions, true );
$schedule_idx = array_search( 'schedule', $actions, true );
pr_assert( $clear_idx < $schedule_idx, 'clear fires before schedule' );
// ── Summary ─────────────────────────────────────────────────────────────
exit( pr_test_summary() );