mirror of
https://github.com/Heretek-AI/heretek-control-core.git
synced 2026-10-12 02:03:55 +00:00
Mian Shahzad RazaandClaude Opus 4.8
ce17704a15
load_classes() require_once'd all ~180 class files (~10 MB) on every request, including front-end page views that never use the AI tools. The ~120 MCP ability classes + their exclusive infra (schema catalogs, guards, security/performance audits, theme/forms/SEO integrations) now load via load_mcp_surface() only when the surface is needed: is_admin() || WP-CLI || cron || a REST request. register_abilities() and the Pro loader split the same way, with a lazy fallback in register_abilities() so a request type the gate misses still works the moment the Abilities API fires. Free base integration classes (Form/SEO/Theme) stay runtime since Pro adapters extend them; Atomic props/factory/schema/validators stay runtime (referenced unguarded). Measured on a Pro dev site: front-end load_classes dropped 10.0 MB -> 4.0 MB per request (surfaces deferred), while REST/admin/CLI load the full surface and all 209 abilities register unchanged. Front-end (homepage/post/404) and REST/MCP verified; both suites green (pro 2060, public 145). Co-Authored-By: Claude Opus 4.8 <[email protected]>
290 lines
11 KiB
PHP
290 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* Loads Pro-tier units only when the private `pro/` overlay is present.
|
|
*
|
|
* The free plugin ships without any Pro file. Every Pro require + every Pro
|
|
* instantiation/hook-wire goes through here, each guarded by file_exists /
|
|
* class_exists, so the free plugin runs with zero Pro references and no fatals.
|
|
* The runtime can_use_premium_code() license gate remains inside each Pro unit.
|
|
*
|
|
* Dual-root path resolution lets the same code serve two layouts:
|
|
* 1. EMCP_TOOLS_DIR . $rel — premium BUILD (pro/* overlaid onto plugin paths)
|
|
* 2. EMCP_TOOLS_DIR . 'pro/' . $rel — DEV checkout (private submodule at pro/)
|
|
* so developers edit files in pro/ directly with no in-place copies or sync.
|
|
*
|
|
* @package EMCP_Tools
|
|
*/
|
|
|
|
defined( 'ABSPATH' ) || exit;
|
|
|
|
final class EMCP_Tools_Pro_Loader {
|
|
|
|
/** Pro class files, in load order. Relative to the Pro root. */
|
|
private const FILES = array(
|
|
'includes/class-sandbox-template-compiler.php',
|
|
'includes/class-block-store.php',
|
|
'includes/class-block-loader.php',
|
|
// Project Memory (Pro).
|
|
'includes/memory/class-memory-store.php',
|
|
'includes/memory/class-memory-digest.php',
|
|
'includes/memory/class-memory-injector.php',
|
|
'includes/memory/class-memory-enforcer.php',
|
|
'includes/memory/class-memory-summarizer.php',
|
|
// Backup / Migrate / Sync MCP tools (Pro). The engine classes load with
|
|
// the module on init:5; this ability class is loaded here so the registrar
|
|
// (wp_abilities_api_init, earlier) can register the group when the module
|
|
// is enabled. Executors lazy-load the engines defensively.
|
|
// Forms integrations (Pro adapters; the base + CF7 are free-tree).
|
|
// Elementor addon widget packs (discovery + curation only; placement
|
|
// stays on the generic add-free-widget tool).
|
|
// SEO integrations (Pro adapters; the base + Slim SEO are free-tree).
|
|
// GeneratePress + GenerateBlocks theme integration (Pro).
|
|
// Blocksy theme integration (Pro): blocks + Companion extensions.
|
|
'includes/class-skill-catalog.php',
|
|
'includes/class-page-snapshot-pro.php',
|
|
'includes/admin/class-pro-brand-kits.php',
|
|
'includes/ai-chat/class-key-crypto.php',
|
|
'includes/ai-chat/class-ai-providers.php',
|
|
'includes/ai-chat/class-ai-chat-provider.php',
|
|
'includes/ai-chat/class-ai-chat-store.php',
|
|
'includes/ai-chat/class-ai-chat-tool-groups.php',
|
|
// Settings depends on Tool_Groups (it validates group ids against it).
|
|
'includes/ai-chat/class-ai-chat-settings.php',
|
|
'includes/ai-chat/class-ai-chat-prompt.php',
|
|
'includes/ai-chat/class-ai-chat-web-fetch.php',
|
|
'includes/ai-chat/class-ai-chat-image-reader.php',
|
|
'includes/ai-chat/class-ai-chat-usage.php',
|
|
'includes/ai-chat/class-ai-chat-controller.php',
|
|
'includes/themer/class-themer-pro-matchers.php',
|
|
'includes/themer/class-themer-pro-conditions.php',
|
|
'includes/themer/class-themer-pro.php',
|
|
);
|
|
|
|
/**
|
|
* Pro ability adapters + their exclusive infra, deferred off the boot path and
|
|
* loaded by load_mcp_surface() only when the MCP tool surface is needed (an MCP
|
|
* request, the admin Tools screen, WP-CLI, or cron) — the free surface is split
|
|
* the same way in EMCP_Tools_Bootstrap. Runtime-wired Pro units (block store/
|
|
* loader, memory infra, ai-chat, themer-pro, skill-catalog, page-snapshot-pro)
|
|
* stay in FILES so their front-end hooks fire on every request.
|
|
*/
|
|
private const MCP_FILES = array(
|
|
'includes/class-color-contrast.php',
|
|
'includes/class-content-extractor.php',
|
|
'includes/class-seo-meta.php',
|
|
'includes/class-block-generator.php',
|
|
'includes/abilities/class-memory-abilities.php',
|
|
'includes/abilities/class-migrate-abilities.php',
|
|
'includes/class-widget-generator.php',
|
|
'includes/abilities/class-system-kit-abilities.php',
|
|
'includes/abilities/class-widget-builder-abilities.php',
|
|
'includes/abilities/class-block-builder-abilities.php',
|
|
'includes/abilities/class-seo-abilities.php',
|
|
'includes/abilities/class-a11y-abilities.php',
|
|
'includes/abilities/class-woo-integration.php',
|
|
'includes/abilities/forms/class-wpforms-integration.php',
|
|
'includes/abilities/forms/class-gravityforms-integration.php',
|
|
'includes/abilities/forms/class-fluentforms-integration.php',
|
|
'includes/abilities/forms/class-ninjaforms-integration.php',
|
|
'includes/abilities/forms/class-formidable-integration.php',
|
|
'includes/abilities/forms/class-metform-integration.php',
|
|
'includes/abilities/forms/class-sureforms-integration.php',
|
|
'includes/abilities/forms/class-forminator-integration.php',
|
|
'includes/abilities/addons/class-addon-pack-integration.php',
|
|
'includes/abilities/addons/class-essential-addons-integration.php',
|
|
'includes/abilities/addons/class-premium-addons-integration.php',
|
|
'includes/abilities/addons/class-uae-integration.php',
|
|
'includes/abilities/seo/class-yoast-integration.php',
|
|
'includes/abilities/seo/class-rankmath-integration.php',
|
|
'includes/abilities/seo/class-aioseo-integration.php',
|
|
'includes/abilities/seo/class-seopress-integration.php',
|
|
'includes/abilities/seo/class-seoframework-integration.php',
|
|
'includes/abilities/seo/class-surerank-integration.php',
|
|
'includes/blocks-catalog/class-generateblocks-catalog.php',
|
|
'includes/abilities/class-generatepress-integration.php',
|
|
'includes/abilities/class-generateblocks-integration.php',
|
|
'includes/blocks-catalog/class-blocksy-blocks-catalog.php',
|
|
'includes/abilities/class-blocksy-blocks-integration.php',
|
|
'includes/abilities/class-blocksy-extensions-integration.php',
|
|
'includes/abilities/class-skill-abilities.php',
|
|
);
|
|
|
|
/** Pro admin class files, in load order. Relative to the Pro root. */
|
|
private const ADMIN_FILES = array(
|
|
'includes/ai-chat/class-ai-chat-page.php',
|
|
'includes/ai-chat/class-elementor-editor.php',
|
|
'includes/ai-chat/class-gutenberg-editor.php',
|
|
'includes/admin/class-pro-prompts.php',
|
|
'includes/admin/class-pro-templates.php',
|
|
'includes/admin/class-pro-usage.php',
|
|
'includes/admin/class-pro-ajax.php',
|
|
'includes/admin/class-pro-skills.php',
|
|
);
|
|
|
|
/**
|
|
* Resolve a Pro-relative path against the two candidate roots (build root
|
|
* first so an overlaid premium build wins).
|
|
*
|
|
* @param string $rel Path relative to the Pro root.
|
|
* @return string Absolute path, or '' when the file exists in neither root.
|
|
*/
|
|
public static function path( string $rel ): string {
|
|
foreach ( array( EMCP_TOOLS_DIR . $rel, EMCP_TOOLS_DIR . 'pro/' . $rel ) as $candidate ) {
|
|
if ( is_readable( $candidate ) ) {
|
|
return $candidate;
|
|
}
|
|
}
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* URL twin of path() — for enqueuing Pro assets (ai-chat.js/css).
|
|
* Uses EMCP_TOOLS_URL (emcp-tools.php); there is no EMCP_TOOLS_FILE constant.
|
|
*
|
|
* @param string $rel Path relative to the Pro root.
|
|
* @return string Asset URL, or '' when the asset exists in neither root.
|
|
*/
|
|
public static function url( string $rel ): string {
|
|
if ( is_readable( EMCP_TOOLS_DIR . $rel ) ) {
|
|
return EMCP_TOOLS_URL . $rel;
|
|
}
|
|
if ( is_readable( EMCP_TOOLS_DIR . 'pro/' . $rel ) ) {
|
|
return EMCP_TOOLS_URL . 'pro/' . $rel;
|
|
}
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Cache-busting version for a Pro asset: its modification time.
|
|
*
|
|
* Keyed on the file, not on EMCP_TOOLS_VERSION, so an edited asset is picked
|
|
* up without a version bump. Previously this fell back to the plugin version
|
|
* unless WP_DEBUG was on, which meant an unreleased JS/CSS change was served
|
|
* from the browser cache on any non-debug install — including a dev site.
|
|
*
|
|
* On a released install the mtime is the install/extract time and still
|
|
* changes on every update, so this is also correct in production.
|
|
*
|
|
* @since 3.2.0
|
|
* @param string $rel Path relative to the Pro root.
|
|
* @return string Version string.
|
|
*/
|
|
public static function asset_version( string $rel ): string {
|
|
$path = self::path( $rel );
|
|
if ( '' !== $path ) {
|
|
$mtime = @filemtime( $path ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- Falls back below.
|
|
if ( $mtime ) {
|
|
return (string) $mtime;
|
|
}
|
|
}
|
|
return EMCP_TOOLS_VERSION;
|
|
}
|
|
|
|
/** True when the private Pro overlay is present (either root). */
|
|
public static function is_present(): bool {
|
|
return '' !== self::path( 'includes/ai-chat/class-ai-chat-controller.php' );
|
|
}
|
|
|
|
/** require_once each Pro runtime file that exists (dual-root). */
|
|
public static function load_runtime(): void {
|
|
foreach ( self::FILES as $rel ) {
|
|
$path = self::path( $rel );
|
|
if ( '' !== $path ) {
|
|
require_once $path;
|
|
}
|
|
}
|
|
}
|
|
|
|
/** require_once each deferred Pro MCP-surface file that exists (dual-root). */
|
|
public static function load_mcp_surface(): void {
|
|
foreach ( self::MCP_FILES as $rel ) {
|
|
$path = self::path( $rel );
|
|
if ( '' !== $path ) {
|
|
require_once $path;
|
|
}
|
|
}
|
|
}
|
|
|
|
/** require_once each Pro admin file that exists (dual-root). */
|
|
public static function load_admin(): void {
|
|
foreach ( self::ADMIN_FILES as $rel ) {
|
|
$path = self::path( $rel );
|
|
if ( '' !== $path ) {
|
|
require_once $path;
|
|
}
|
|
}
|
|
}
|
|
|
|
/** Wire Pro runtime hooks, each guarded by class_exists. */
|
|
public static function wire_runtime_hooks(): void {
|
|
// AI Chat runtime wiring now lives in EMCP_Tools_AI_Chat_Module::register(),
|
|
// booted by the modules registry only when the module is active.
|
|
|
|
// EMCP Themer Pro power-ups: attach granular matchers, priority ranking,
|
|
// unlimited quota, and granular selectors to the free seams (license-gated).
|
|
if ( class_exists( 'EMCP_Tools_Themer_Pro' ) ) {
|
|
EMCP_Tools_Themer_Pro::init();
|
|
}
|
|
|
|
// Agent-facing skills (read-side): hook the discovery-context catalog.
|
|
if ( class_exists( 'EMCP_Tools_Skill_Catalog' ) ) {
|
|
EMCP_Tools_Skill_Catalog::init();
|
|
}
|
|
|
|
// Page-snapshot Pro sections (a11y + deep seo) attach to the free seam.
|
|
if ( class_exists( 'EMCP_Tools_Page_Snapshot_Pro' ) ) {
|
|
EMCP_Tools_Page_Snapshot_Pro::init();
|
|
}
|
|
}
|
|
|
|
/** Wire Pro admin hooks, each guarded by class_exists. */
|
|
public static function wire_admin_hooks(): void {
|
|
// AI Chat admin page + Elementor editor are wired by the AI Chat module.
|
|
if ( ! function_exists( 'emcp_tools_fs' ) ) {
|
|
return;
|
|
}
|
|
if ( class_exists( 'EMCP_Tools_Pro_Ajax' ) ) {
|
|
EMCP_Tools_Pro_Ajax::register();
|
|
}
|
|
if ( class_exists( 'EMCP_Tools_Pro_Prompts' ) && method_exists( 'EMCP_Tools_Pro_Prompts', 'register_download' ) ) {
|
|
EMCP_Tools_Pro_Prompts::register_download();
|
|
}
|
|
if ( class_exists( 'EMCP_Tools_Pro_Skills' ) ) {
|
|
( new EMCP_Tools_Pro_Skills() )->init();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Let Pro register its modules into the shared registry. No-op today (no Pro
|
|
* modules yet); the private overlay will instantiate + register them here,
|
|
* each guarded by class_exists, when the first Pro module lands.
|
|
*
|
|
* @param EMCP_Tools_Modules_Registry $registry The shared registry.
|
|
*/
|
|
public static function register_modules( EMCP_Tools_Modules_Registry $registry ): void {
|
|
$path = self::path( 'includes/modules/class-ai-chat-module.php' );
|
|
if ( '' !== $path ) {
|
|
require_once $path;
|
|
if ( class_exists( 'EMCP_Tools_AI_Chat_Module' ) ) {
|
|
$registry->register( new EMCP_Tools_AI_Chat_Module() );
|
|
}
|
|
}
|
|
|
|
$memory_path = self::path( 'includes/modules/class-memory-module.php' );
|
|
if ( '' !== $memory_path ) {
|
|
require_once $memory_path;
|
|
if ( class_exists( 'EMCP_Tools_Memory_Module' ) ) {
|
|
$registry->register( new EMCP_Tools_Memory_Module() );
|
|
}
|
|
}
|
|
|
|
$migrate_path = self::path( 'includes/modules/class-migrate-module.php' );
|
|
if ( '' !== $migrate_path ) {
|
|
require_once $migrate_path;
|
|
if ( class_exists( 'EMCP_Tools_Migrate_Module' ) ) {
|
|
$registry->register( new EMCP_Tools_Migrate_Module() );
|
|
}
|
|
}
|
|
}
|
|
}
|