Files
prautoblogger/includes/ajax/class-model-registry-refresh.php
peptiderepo 7401addbd9 v0.11.0 — OpenRouter model picker (#111)
v0.11.0 — OpenRouter model picker (AJAX refresh + cost preview + Phase-2 asset extract)

Replaces the free-text slug inputs for analysis_model, writing_model, and editor_model with a smart picker fed by a daily-refreshed OpenRouter model registry. Picker shows context size + input/output price + provider, filters by per-field capability, previews per-generation cost using existing cost-tracker history, and keeps a custom-slug fallback. Daily registry refresh fires from inside on_daily_generation() before lock acquire — no new top-level cron event.

Commit sequence (preserved for review):
- 353aa4e  feat(models): OpenRouter model picker + AJAX refresh + cost preview
- 283fa55  fix(phpcs): resolve 4 PHPCS violations in model-registry-refresh handler
- 1b1336a  style(phpcs): fix array syntax in model field + cost tracker
- 283f9f9  style(phpcs): fix tabs vs spaces in settings-page.php
- aa78591  refactor(assets): extract model-picker refresh handler to generic-handle file

Verification
- PHPCS strict (CI scope): 0 errors / 0 warnings
- PHPUnit: 206/206 (555 assertions, 2 pre-existing skips)
- All new files under 300-line cap (field renderer 163, AJAX handler 82)
- Security: AJAX nonce + manage_options cap; output escaped; input sanitized
- Phase 2 ready: zero PRAUTOBLOGGER_* coupling in registry/picker/AJAX classes; generic asset handle peptiderepo-model-picker

QA verdict: PASS (qa-reviews/prautoblogger/2026-04-23-aa78591.md)

Out of scope (untouched): cto-review.yml, prautoblogger_image_model field (Workers AI FLUX, Phase 3), Peptide Search AI / Peptide News fields (Phase 2).

Co-authored-by: Engineer PRAutoBlogger (in-session subagent) <engineer-prautoblogger@peptiderepo.users.noreply.github.com>
2026-04-23 12:11:59 +07:00

83 lines
2.9 KiB
PHP

<?php
declare(strict_types=1);
/**
* AJAX handler to manually refresh the OpenRouter model registry.
*
* What: Allows admins to trigger an immediate refresh of the cached model
* list via a button in the admin UI, without waiting for the daily
* cron. Useful for testing new models or after adding an API key.
* Who calls: Admin-facing JavaScript (model-picker.js) via wp_ajax.
* Dependencies: PRAutoBlogger_OpenRouter_Model_Registry, capability gating.
*
* Triggered by: AJAX POST to 'wp-admin/admin-ajax.php?action=prautoblogger_refresh_models'
* Side effects: HTTP GET to OpenRouter /api/v1/models (optional, if 12h window passed);
* wp_options write; transient set.
*
* @see includes/class-ajax-handlers.php — Instantiation and wiring.
* @see assets/js/model-picker.js — Client-side trigger.
* @see services/class-open-router-model-registry.php — Registry that performs the work.
*/
class PRAutoBlogger_Model_Registry_Refresh {
/** @var PRAutoBlogger_OpenRouter_Model_Registry Lazy-loaded singleton. */
private PRAutoBlogger_OpenRouter_Model_Registry $registry;
/**
* @param PRAutoBlogger_OpenRouter_Model_Registry $registry Shared model registry.
*/
public function __construct( PRAutoBlogger_OpenRouter_Model_Registry $registry ) {
$this->registry = $registry;
}
/**
* Handle the AJAX refresh request.
*
* Security: nonce-gated via wp-nonce, capability gated to manage_options.
* Response format: JSON { success: bool, data: { count: int, fetched_at: int, message: string } }
*
* @side-effect Writes HTTP GET request, database options, transient cache.
* @return void (echoes JSON)
*/
public function handle(): void {
// Nonce check.
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'prautoblogger_refresh_models' ) ) {
wp_send_json_error(
array(
'message' => __( 'Security check failed. Please refresh the page and try again.', 'prautoblogger' ),
),
403
);
}
// Capability check.
if ( ! current_user_can( 'manage_options' ) ) {
wp_send_json_error(
array(
'message' => __( 'Insufficient permissions. Only administrators can refresh the model list.', 'prautoblogger' ),
),
403
);
}
// Perform the refresh (force=true bypasses the idempotency window).
$result = $this->registry->refresh( true );
$count = (int) ( $result['count'] ?? 0 );
$fetched_at = (int) ( $result['fetched_at'] ?? 0 );
$mins_ago = $fetched_at > 0 ? intval( ( time() - $fetched_at ) / 60 ) : 0;
wp_send_json_success(
array(
'count' => $count,
'fetched_at' => $fetched_at,
'message' => sprintf(
__( 'Model registry refreshed: %1$d models loaded, last updated %2$s', 'prautoblogger' ),
$count,
0 === $mins_ago ? __( 'just now', 'prautoblogger' ) : sprintf( __( '%d minutes ago', 'prautoblogger' ), $mins_ago )
),
)
);
}
}