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

<?php
declare(strict_types=1);

/**
 * Main orchestrator for the Peptide Repo Core plugin.
 *
 * What: Registers all hooks, runs migrations, boots subsystems.
 * Who calls it: peptide-repo-core.php on plugins_loaded.
 * Dependencies: PR_Core_Migration_Runner, PR_Core_Peptide_CPT, PR_Core_Admin,
 *               PR_Core_Disclaimer, PR_Core_Jsonld, PR_Core_Rest_Controller.
 *
 * @see peptide-repo-core.php — Bootstrap that instantiates this class.
 * @see ARCHITECTURE.md       — Full data flow diagram.
 */
class PR_Core {

	/**
	 * Initialize all plugin subsystems.
	 *
	 * Side effects: registers WordPress hooks, runs pending migrations.
	 *
	 * @return void
	 */
	public function init(): void {
		// Run migrations before anything else.
		$runner = new PR_Core_Migration_Runner();
		$runner->run_pending();

		// Register CPT + taxonomies (fires on init).
		$cpt = new PR_Core_Peptide_CPT();
		$cpt->register_hooks();

		// One-shot rewrite flush on in-place version bumps. Runs at the very
		// end of init (priority 999) so all CPTs/taxonomies — ours and
		// anyone else's — are registered first. Handles updates deployed
		// without a deactivate/reactivate cycle (e.g., SCP/rsync pushes).
		add_action( 'init', [ PR_Core_Activator::class, 'maybe_flush_on_version_change' ], 999 );

		// Admin UI (fires on admin_init, admin_menu).
		if ( is_admin() ) {
			$admin = new PR_Core_Admin();
			$admin->register_hooks();
		}

		// Frontend: disclaimer shortcode + JSON-LD.
		$disclaimer = new PR_Core_Disclaimer();
		$disclaimer->register_hooks();

		$jsonld = new PR_Core_Jsonld();
		$jsonld->register_hooks();

		// REST API.
		$rest = new PR_Core_Rest_Controller();
		$rest->register_hooks();

		// Expose public API filters.
		$this->register_public_filters();
	}

	/**
	 * Register the public filter hooks that consumer plugins rely on.
	 *
	 * Filters:
	 * - pr_core_get_indexable_corpus: Returns indexable content for search plugins.
	 * - pr_core_disclaimer_for_surface: Returns disclaimer text for a given surface.
	 * - pr_core_evidence_strength_label: Maps enum to human-readable label.
	 *
	 * @return void
	 */
	private function register_public_filters(): void {
		add_filter( 'pr_core_get_indexable_corpus', [ $this, 'filter_indexable_corpus' ] );
		add_filter( 'pr_core_disclaimer_for_surface', [ $this, 'filter_disclaimer_for_surface' ], 10, 2 );
		add_filter( 'pr_core_evidence_strength_label', [ $this, 'filter_evidence_label' ], 10, 2 );
	}

	/**
	 * Return indexable corpus entries for search plugins (e.g., Peptide Search AI).
	 *
	 * Each entry: { id, url, title, body, type }.
	 *
	 * @param array<int, array<string, mixed>> $entries Existing entries from other filters.
	 * @return array<int, array<string, mixed>>
	 */
	public function filter_indexable_corpus( array $entries ): array {
		$repo = new PR_Core_Peptide_Repository();
		$peptides = $repo->find_all( [ 'status' => 'publish' ] );

		foreach ( $peptides as $dto ) {
			$entries[] = [
				'id'    => $dto->id,
				'url'   => get_permalink( $dto->id ),
				'title' => $dto->title,
				'body'  => $dto->excerpt . "\n" . $dto->content,
				'type'  => 'peptide_monograph',
			];
		}

		return $entries;
	}

	/**
	 * Return disclaimer text for a given surface identifier.
	 *
	 * @param string $text    Existing text (empty string default).
	 * @param string $surface Surface identifier (dosing, legal, reconstitution, ai-answer).
	 * @return string Disclaimer HTML.
	 */
	public function filter_disclaimer_for_surface( string $text, string $surface ): string {
		return PR_Core_Disclaimer::get_disclaimer_text( $surface );
	}

	/**
	 * Map evidence_strength enum value to human-readable label.
	 *
	 * @param string $label    Existing label (empty string default).
	 * @param string $strength Enum value.
	 * @return string Localized label.
	 */
	public function filter_evidence_label( string $label, string $strength ): string {
		$map = [
			'preclinical'   => __( 'Preclinical', 'peptide-repo-core' ),
			'case-series'   => __( 'Case Series', 'peptide-repo-core' ),
			'observational' => __( 'Observational', 'peptide-repo-core' ),
			'rct-small'     => __( 'Small RCT', 'peptide-repo-core' ),
			'rct-large'     => __( 'Large RCT', 'peptide-repo-core' ),
			'meta-analysis' => __( 'Meta-Analysis', 'peptide-repo-core' ),
		];

		return $map[ $strength ] ?? $strength;
	}
}