PPL Search Intelligence Core for Magento 2

PPL Search Intelligence Core is the single shared backend for the Luma and Hyva storefront adapters. It owns query understanding, product truth, schema, configuration, admin UI, routes, indexing, ranking, redirects, cron, queues and the stable storefront response contract.

What It Adds

• Canonical search-page and overlay product truth
• Magento full and incremental indexing, MySQL/OpenSearch routing and optional Redis cache data
• Query rules, synonyms, corrections, redirects, recovery, ranking, merchandising and diagnostics
• One admin/configuration/schema/cron/queue implementation shared by both storefront adapters

Requirements And Dependencies

• PHP >=8.1 and Magento Open Source or Adobe Commerce 2.4.9
• Ppl_Hub and the Magento modules declared in composer.json
• Exactly one storefront adapter: Ppl_SearchIntelligence for Luma or Ppl_SearchIntelligenceHV for Hyva
• Do not enable with Ppl_ScoredSearch; both modules own the same search surface

Installation

Install one storefront adapter. Composer installs this Core package transitively.

# Luma
composer require ppl/module-hub ppl/module-search-intelligence
bin/magento module:enable Ppl_Hub Ppl_SearchIntelligenceCore Ppl_SearchIntelligence

# Or Hyva
composer require ppl/module-hub ppl/module-search-intelligence-hv
bin/magento module:enable Ppl_Hub Ppl_SearchIntelligenceCore Ppl_SearchIntelligenceHV

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

For manual app/code installation, copy Ppl/Hub, Ppl/SearchIntelligenceCore and exactly one adapter into app/code/Ppl, then enable the same three modules in that order.

First Use

• Disable Ppl_ScoredSearch and ensure only one Search Intelligence adapter is active.
• Run ppl:search-intelligence:signals:rebuild and ppl:search-intelligence:index:rebuild before enabling storefront suggestions or search-page ownership.
• Keep Magento cron running. Async rebuilding additionally requires AMQP/RabbitMQ; without it rebuilds remain synchronous.
• Pair the active adapter with the corresponding Discovery Filters frontend when overlay facets are required.

Admin entry: PPL Hub > PPL Search Intelligence.

Integrations And Boundaries

• Cooperates with Discovery Filters only through PPL Hub capability contracts and the neutral filter integration event.
• Luma and Hyva call the same application service and receive the same versioned payload; only templates, JavaScript, CSS and adapter ViewModels differ.
• Queue XML is transport-neutral so setup and synchronous operation work without RabbitMQ. Heavy async indexing is enabled only after the AMQP queue is reachable and provisioned.

Localization

The package includes translation CSV files for 12 locales: de_DE, en_US, es_ES, fr_FR, it_IT, ja_JP, nl_NL, pl_PL, pt_BR, ru_RU, tr_TR, zh_CN.

Customer Documentation

Customer-facing User Guides and Marketplace Long Descriptions are maintained outside the Magento module package in the repository-level docs/user_guides and docs/long_descriptions folders. The module package itself intentionally keeps only this technical README plus developer-relevant files.

Support

Support contact: [email protected]. Include the module version, Magento version, enabled PPL companion modules, and the relevant admin or storefront screenshot when reporting an issue.

Changelog

1.3.0

• Extracted the single shared backend used by the Luma and Hyva storefront adapters; schema, routes,
  configuration, admin UI, controllers, cron, queues, indexing, ranking and response contracts now
  have one owner.
• Added live product-truth validation, current customer-group pricing/tax formatting, MSI salability,
  deterministic recovery behavior and version-aware candidate totals.
• Added Magento indexer/mview product updates for catalog, price, inventory, category, rule and review
  changes; removed the unused reserved index-queue table and exposed the working indexer setting.
• Made queue XML transport-neutral while retaining the explicit AMQP capability gate for heavy async
  rebuilds, and bounded result-set cleanup with a non-blocking process lock.
• Added the shared overlay application service and stable versioned AJAX/profiler payload contract.
• Added Magento Open Source and Adobe Commerce 2.4.9 compatibility and PPL Hub 1.3 integration.

1.2.0

• Initial release.
• Added query understanding, MySQL candidate provider, explainable ranking and product signal rebuilds.
• Added admin Test Lab, hub-only configuration sections, CLI commands, cron jobs and core schema tables.
• Added optional configurable storefront suggestions, Discovery Filters integration and read-only internal provider status.
• Search result pages use Search Intelligence as the canonical product basis for product list rendering, Discovery Filters, toolbar totals, pagination and sorting.
• Added overlay fast-path payload mapping, action payload slimming, optional payload pruning and profiler payload parity.
• Added behavior-aware ranking gates that consume aggregated behavior signals; storefront behavior collection, impression tracking and purchase/return attribution are owned by the optional Ppl_Tracking module.
• Added Smart Discovery P0 payload support as an additive, read-only overlay field.
• Added Test Lab timing help and request-path details while keeping winner/loser row backgrounds neutral and limiting colored highlights to metric cells.
• Routed Search Intelligence <-> Discovery Filters cooperation through neutral Ppl_Hub capabilities: SI exposes the canonical search product set via the Hub SearchPageProductSetProviderInterface bridge and reads facet/filter data via the Hub FilterIndexReaderInterface, instead of reading a sibling module's tables.
• Declared an explicit magento/module-cron dependency and Magento_Cron load-order sequence so the bundled cron jobs (index bootstrap/rebuild, signal rebuild, knowledge-pack compile, result-set purge, async dispatch/advance) load deterministically.
• Normalized every ranking component to a common [0,1] scale before weighting, retuned the shipped default weights, and added a data patch that calibrates stored per-scope weight overrides onto the new scale so existing merchant tuning is preserved.
• Added optional async index rebuilds that fan a catalog rebuild out to the Magento message queue (one message per product batch, version-swapped only when complete) with a transactional outbox, per-minute dispatch/advance cron jobs and a broker-availability probe; falls back to the synchronous rebuild when no broker is configured.
• Extended product signal scoring with freshness (recency), return-rate, click-through and search-conversion terms and lifted the signal scale cap so strong products no longer saturate.
• Added search smoke/profile/recall diagnostic and corpus/benchmark/seed CLI commands that exercise the live SI + Discovery Filters result path through the Hub filter-index reader.