Changeset 3776286

Timestamp:

10/31/2026 02:56:18 AM (33 hours ago)

Author:

avakodeforge

Message:

Release 1.0.3 (trunk + tag; see readme changelog)

Location:

clearwayforge

Files:

• tags/1.0.3 (copied) (copied from clearwayforge/trunk )
• tags/1.0.3/assets/admin/admin.js (modified) (9 diffs)
• tags/1.0.3/clearwayforge.php (modified) (2 diffs)
• tags/1.0.3/languages/clearwayforge.pot (modified) (4 diffs)
• tags/1.0.3/readme.txt (modified) (2 diffs)
• tags/1.0.3/src/Admin/AgentRevenueScreen.php (modified) (2 diffs)
• tags/1.0.3/src/Admin/Assets.php (modified) (2 diffs)
• tags/1.0.3/src/Admin/Menu.php (modified) ( previous)
• tags/1.0.3/src/Domain/Attribution/Allocation.php (modified) (2 diffs)
• tags/1.0.3/src/Domain/Attribution/AttributionModel.php (modified) (1 diff)
• tags/1.0.3/src/Domain/Crawler/ClientAddress.php (added)
• tags/1.0.3/src/Domain/Crawler/TrustedProxies.php (added)
• tags/1.0.3/src/Domain/Llms/LlmsGenerator.php (modified) ( previous)
• tags/1.0.3/src/Domain/Llms/StoreProfile.php (modified) (2 diffs)
• tags/1.0.3/src/Domain/Report/AgentRevenueTable.php (modified) (4 diffs)
• tags/1.0.3/src/Domain/Report/DashboardBuilder.php (modified) (10 diffs)
• tags/1.0.3/src/Domain/Report/DashboardReport.php (modified) ( previous)
• tags/1.0.3/src/Domain/Report/MoneyText.php (modified) (2 diffs)
• tags/1.0.3/src/Domain/Report/RefundSplit.php (added)
• tags/1.0.3/src/Domain/Report/SourceRow.php (modified) (2 diffs)
• tags/1.0.3/src/Infra/Attribution/OrderObserver.php (modified) (1 diff)
• tags/1.0.3/src/Infra/Attribution/OrderRefunds.php (added)
• tags/1.0.3/src/Infra/Attribution/RefundBackfill.php (added)
• tags/1.0.3/src/Infra/Attribution/RefundObserver.php (added)
• tags/1.0.3/src/Infra/Attribution/WcOrderRefunds.php (added)
• tags/1.0.3/src/Infra/Collect/RequestAddress.php (added)
• tags/1.0.3/src/Infra/Collect/VisitCollector.php (modified) (1 diff)
• tags/1.0.3/src/Infra/Db/Schema.php (modified) (3 diffs)
• tags/1.0.3/src/Infra/Health/HealthReport.php (modified) (1 diff)
• tags/1.0.3/src/Infra/Llms/DocumentCaching.php (added)
• tags/1.0.3/src/Infra/Llms/LlmsRoutes.php (modified) (7 diffs)
• tags/1.0.3/src/Infra/Llms/ProductTranslations.php (added)
• tags/1.0.3/src/Infra/Llms/StoreProfileBuilder.php (modified) (7 diffs)
• tags/1.0.3/src/Infra/Plugin.php (modified) ( previous)
• tags/1.0.3/src/Infra/Privacy/PersonalData.php (modified) ( previous)
• tags/1.0.3/src/Infra/Pro/Bridge.php (modified) ( previous)
• tags/1.0.3/src/Infra/Report/DashboardAssembler.php (modified) (6 diffs)
• tags/1.0.3/src/Infra/Report/StoreMinorUnit.php (added)
• tags/1.0.3/src/Infra/Repository/TouchRepository.php (modified) (6 diffs)
• tags/1.0.3/src/Infra/Rest/Routes.php (modified) (1 diff)
• tags/1.0.3/src/Infra/Rest/SettingsController.php (modified) (5 diffs)
• tags/1.0.3/src/Infra/Scheduler/Maintenance.php (modified) (3 diffs)
• tags/1.0.3/src/Infra/Support/Options.php (modified) ( previous)
• tags/1.0.3/uninstall.php (modified) (2 diffs)
• tags/1.0.3/vendor/composer/autoload_classmap.php (modified) (6 diffs)
• tags/1.0.3/vendor/composer/autoload_static.php (modified) (6 diffs)
• tags/1.0.3/vendor/composer/installed.php (modified) (2 diffs)
• trunk/assets/admin/admin.js (modified) (9 diffs)
• trunk/clearwayforge.php (modified) (2 diffs)
• trunk/languages/clearwayforge.pot (modified) (4 diffs)
• trunk/readme.txt (modified) (2 diffs)
• trunk/src/Admin/AgentRevenueScreen.php (modified) (2 diffs)
• trunk/src/Admin/Assets.php (modified) (2 diffs)
• trunk/src/Admin/Menu.php (modified) ( previous)
• trunk/src/Domain/Attribution/Allocation.php (modified) (2 diffs)
• trunk/src/Domain/Attribution/AttributionModel.php (modified) (1 diff)
• trunk/src/Domain/Crawler/ClientAddress.php (added)
• trunk/src/Domain/Crawler/TrustedProxies.php (added)
• trunk/src/Domain/Llms/LlmsGenerator.php (modified) ( previous)
• trunk/src/Domain/Llms/StoreProfile.php (modified) (2 diffs)
• trunk/src/Domain/Report/AgentRevenueTable.php (modified) (4 diffs)
• trunk/src/Domain/Report/DashboardBuilder.php (modified) (10 diffs)
• trunk/src/Domain/Report/DashboardReport.php (modified) ( previous)
• trunk/src/Domain/Report/MoneyText.php (modified) (2 diffs)
• trunk/src/Domain/Report/RefundSplit.php (added)
• trunk/src/Domain/Report/SourceRow.php (modified) (2 diffs)
• trunk/src/Infra/Attribution/OrderObserver.php (modified) (1 diff)
• trunk/src/Infra/Attribution/OrderRefunds.php (added)
• trunk/src/Infra/Attribution/RefundBackfill.php (added)
• trunk/src/Infra/Attribution/RefundObserver.php (added)
• trunk/src/Infra/Attribution/WcOrderRefunds.php (added)
• trunk/src/Infra/Collect/RequestAddress.php (added)
• trunk/src/Infra/Collect/VisitCollector.php (modified) (1 diff)
• trunk/src/Infra/Db/Schema.php (modified) (3 diffs)
• trunk/src/Infra/Health/HealthReport.php (modified) (1 diff)
• trunk/src/Infra/Llms/DocumentCaching.php (added)
• trunk/src/Infra/Llms/LlmsRoutes.php (modified) (7 diffs)
• trunk/src/Infra/Llms/ProductTranslations.php (added)
• trunk/src/Infra/Llms/StoreProfileBuilder.php (modified) (7 diffs)
• trunk/src/Infra/Plugin.php (modified) ( previous)
• trunk/src/Infra/Privacy/PersonalData.php (modified) ( previous)
• trunk/src/Infra/Pro/Bridge.php (modified) ( previous)
• trunk/src/Infra/Report/DashboardAssembler.php (modified) (6 diffs)
• trunk/src/Infra/Report/StoreMinorUnit.php (added)
• trunk/src/Infra/Repository/TouchRepository.php (modified) (6 diffs)
• trunk/src/Infra/Rest/Routes.php (modified) (1 diff)
• trunk/src/Infra/Rest/SettingsController.php (modified) (5 diffs)
• trunk/src/Infra/Scheduler/Maintenance.php (modified) (3 diffs)
• trunk/src/Infra/Support/Options.php (modified) ( previous)
• trunk/uninstall.php (modified) (2 diffs)
• trunk/vendor/composer/autoload_classmap.php (modified) (6 diffs)
• trunk/vendor/composer/autoload_static.php (modified) (6 diffs)
• trunk/vendor/composer/installed.php (modified) (2 diffs)

clearwayforge/tags/1.0.3/assets/admin/admin.js

@@ -11 +11 @@
  * ── Почему числа форматируются здесь, а считаются на сервере ─────────────
  *
- * Все суммы приходят целыми центами, доли — базисными пунктами. Клиент их
- * только показывает. Любая арифметика здесь означала бы второй источник
+ * Все суммы приходят целыми минорными единицами, доли — базисными пунктами.
+ * Клиент их только показывает; сколько знаков после запятой у единицы, говорит
+ * сервер (`cwforgeAdmin.minorUnit` = `wc_get_price_decimals()`, та же точность,
+ * с которой заказ записан): иены (0 знаков) и динары (3) — не центы. Любая арифметика здесь означала бы второй источник
  * истины: экран и письмо-дайджест начали бы показывать разные числа, и
  * поймать это можно было бы только глазами.
@@ -29 +31 @@
         var apiFetch = wp.apiFetch;
 
-        /** Центы в строку с валютой. Форматирование локали делает браузер. */
+        /**
+         * Записанные единицы в строку с валютой. Форматирование локали делает
+         * браузер, а место точки — настройка магазина `config.minorUnit`: 1500
+         * при нуле знаков это 1500 иен, а не 15 (BUG-CLEAR-ATTR-02). WordPress
+         * отдаёт скаляры локализации строками, поэтому число разбирается заново;
+         * без него или вне 0-4 остаются два знака, как было.
+         */
         function money( cents, currency ) {
-                var value = ( cents || 0 ) / 100;
+                var digits = parseInt( config.minorUnit, 10 );
+                if ( isNaN( digits ) || digits < 0 || digits > 4 ) {
+                        digits = 2;
+                }
+                var value = ( cents || 0 ) / Math.pow( 10, digits );
                 try {
                         return new Intl.NumberFormat( undefined, {
                                 style: 'currency',
                                 currency: currency || 'USD',
-                                maximumFractionDigits: 2,
+                                minimumFractionDigits: digits,
+                                maximumFractionDigits: digits,
                         } ).format( value );
                 } catch ( e ) {
                         // Неизвестный код валюты роняет Intl. Магазин с экзотической
                         // валютой не должен получать пустой экран вместо цифр.
-                        return value.toFixed( 2 ) + ' ' + ( currency || '' );
+                        return value.toFixed( digits ) + ' ' + ( currency || '' );
                 }
         }
@@ -444 +457 @@
                                 { className: 'cwforge-stats' },
                                 el( Stat, { label: 'AI-attributed orders', value: String( data.totals.orders ) } ),
+                                // Выручка выше уже за вычетом возвратов; сами возвраты отдельной строкой.
+                                el( Stat, { label: 'Refunded', value: money( data.totals.refunded_cents || 0, currency ) } ),
                                 el( Stat, { label: 'AI sessions', value: String( data.totals.sessions ) } ),
                                 el( Stat, { label: 'Recovered sessions', value: percent( recovered.share_bp ) } ),
@@ -743 +758 @@
                 var uninstall = uninstallState[ 0 ];
                 var setUninstall = uninstallState[ 1 ];
+                // Доверенные прокси: черновик текста правится в поле и уходит одной
+                // кнопкой; сервер сохраняет годные записи и называет отброшенные.
+                var proxiesState = useState( { value: '', saved: '', message: '', rejected: [], overLimit: 0, limit: 0 } );
+                var proxies = proxiesState[ 0 ];
+                var setProxies = proxiesState[ 1 ];
+                // Список прокси правит администратор; менеджеру магазина поле только читается.
+                var proxiesAllowedState = useState( false );
+                var proxiesAllowed = proxiesAllowedState[ 0 ];
+                var setProxiesAllowed = proxiesAllowedState[ 1 ];
 
                 function load() {
@@ -764 +788 @@
                                                 saved: '',
                                         } );
+                                        setProxies( { value: data.trusted_proxies || '', saved: '', message: '', rejected: [], overLimit: 0, limit: data.trusted_proxies_limit || 0 } );
+                                        setProxiesAllowed( !! data.can_change_proxies );
                                 } )
                                 .catch( function ( error ) {
@@ -814 +840 @@
                                 .catch( function () {
                                         setUninstall( { value: ! next, allowed: uninstall.allowed, saved: 'error' } );
+                                } );
+                }
+
+                function saveProxies() {
+                        var draft = proxies.value;
+                        setProxies( { value: draft, saved: 'saving', message: '', rejected: [], overLimit: 0, limit: proxies.limit } );
+                        apiFetch( {
+                                path: '/cwforge/v1/settings',
+                                method: 'POST',
+                                data: { trusted_proxies: draft },
+                        } )
+                                .then( function ( data ) {
+                                        // Показываем то, что сервер сохранил (без повторов и лишних пробелов),
+                                        // и называем записи, которые он отбросил.
+                                        setProxies( {
+                                                value: data.trusted_proxies || '',
+                                                saved: 'saved',
+                                                message: '',
+                                                rejected: Array.isArray( data.trusted_proxies_rejected ) ? data.trusted_proxies_rejected : [],
+                                                overLimit: data.trusted_proxies_over_limit || 0,
+                                                limit: data.trusted_proxies_limit || proxies.limit,
+                                        } );
+                                } )
+                                .catch( function ( error ) {
+                                        // Черновик остаётся как есть: владелец правит запись, а не вводит всё заново.
+                                        setProxies( {
+                                                value: draft,
+                                                saved: 'error',
+                                                message: error && error.message ? String( error.message ) : '',
+                                                rejected: [],
+                                                overLimit: 0,
+                                                limit: proxies.limit,
+                                        } );
                                 } );
                 }
@@ -919 +978 @@
                                 'p',
                                 { className: 'description' },
-                                'The dashboard and the revenue by AI agent report credit every order in the window with this model. ' +
+                                'The model applies to orders placed from the moment you switch it. Earlier orders keep the model they ' +
+                                        'were recorded with, so past reports are not recalculated. ' +
                                         'The AI channel column on an order keeps the model that was in force when the order was placed.'
                         ),
@@ -948 +1008 @@
                         ),
                         savedNote( ranges.saved ),
+                        el( 'h3', null, 'Trusted reverse proxies' ),
+                        el(
+                                'label',
+                                { htmlFor: 'cwforge-trusted-proxies' },
+                                'Networks of the proxies in front of this site, one per line (a network such as 10.0.0.0/8, or a single address)'
+                        ),
+                        el( 'textarea', {
+                                id: 'cwforge-trusted-proxies',
+                                className: 'large-text code',
+                                rows: 4,
+                                placeholder: '10.0.0.0/8',
+                                value: proxies.value,
+                                disabled: ! proxiesAllowed || proxies.saved === 'saving',
+                                onChange: function ( event ) {
+                                        setProxies( { value: event.target.value, saved: '', message: '', rejected: [], overLimit: 0, limit: proxies.limit } );
+                                },
+                        } ),
+                        el(
+                                'p',
+                                { className: 'description' },
+                                'Leave this empty unless a reverse proxy or load balancer that you control sits in front of the site. ' +
+                                        'While the list is empty the plugin checks crawler visits against the address of the connection only ' +
+                                        'and never reads the X-Forwarded-For header, which any visitor can forge. Behind a proxy that address ' +
+                                        'is the proxy itself, so crawler visits are shown as "declared". When the connection comes from a ' +
+                                        'network listed here, the plugin uses the right-most X-Forwarded-For address that is not in the list.'
+                        ),
+                        el(
+                                'button',
+                                {
+                                        type: 'button',
+                                        className: 'button',
+                                        disabled: ! proxiesAllowed || proxies.saved === 'saving',
+                                        onClick: saveProxies,
+                                },
+                                'Save proxies'
+                        ),
+                        proxiesAllowed
+                                ? null
+                                : el( 'p', { className: 'description' }, 'Only an administrator can change the trusted proxies.' ),
+                        proxies.saved === 'saved' ? el( 'p', { role: 'status' }, 'Saved.' ) : null,
+                        proxies.saved === 'saved' && proxies.rejected.length
+                                ? el(
+                                        'p',
+                                        { className: 'notice notice-warning', role: 'alert' },
+                                        'Not saved, because they are not an IP address or network: ' + proxies.rejected.join( ', ' )
+                                )
+                                : null,
+                        proxies.saved === 'saved' && proxies.overLimit
+                                ? el(
+                                        'p',
+                                        { className: 'notice notice-warning', role: 'alert' },
+                                        'Only the first ' + proxies.limit + ' entries are kept; ' + proxies.overLimit + ' more were not saved.'
+                                )
+                                : null,
+                        proxies.saved === 'error'
+                                ? el(
+                                        'p',
+                                        { className: 'notice notice-error' },
+                                        'Could not save' + ( proxies.message ? ': ' + proxies.message : '. Try again.' )
+                                )
+                                : null,
                         el( 'h3', null, 'When the plugin is deleted' ),
                         el(
@@ -983 +1104 @@
                 /*
                  * Экраны бесплатного ядра, и только они. Очередь одобрений сюда не
-                 * входит и входить не может: это код уровня Growth, а этот файл едет
+                 * входит и входить не может: это платный код Guard, а этот файл едет
                  * в бесплатном zip на wp.org, где реализация платной функции на диске
                  * — отказ на ревью (docs/free-pro-split.md §5). Её рисует свой скрипт

clearwayforge/tags/1.0.3/clearwayforge.php

@@ -2 +2 @@
 
 /**
- * Plugin Name:       Clearway Forge for WooCommerce
+ * Plugin Name:       Clearway Forge – AI Traffic Analytics & llms.txt for WooCommerce
  * Plugin URI:        https://clearwayforge.com/
  * Description:       See what AI assistants earn your store, make your catalogue readable to them, and keep the numbers in your own database.
- * Version:           1.0.2
+ * Version:           1.0.3
  * Requires at least: 6.5
  * Requires PHP:      8.2
@@ -38 +38 @@
 }
 
-const CWFORGE_VERSION = '1.0.2';
+const CWFORGE_VERSION = '1.0.3';
 const CWFORGE_MIN_PHP = '8.2';
 const CWFORGE_MIN_WP = '6.5';

clearwayforge/tags/1.0.3/languages/clearwayforge.pot

@@ -3 +3 @@
 msgid ""
 msgstr ""
-"Project-Id-Version: Clearway Forge for WooCommerce 0.1.0\n"
-"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/clearwayforge\n"
+"Project-Id-Version: Clearway Forge – AI Traffic Analytics & llms.txt for WooCommerce 1.0.3\n"
+"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/plugin\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -10 +10 @@
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"POT-Creation-Date: 2026-08-26T18:36:47+00:00\n"
+"POT-Creation-Date: 2026-10-30T22:19:42+00:00\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "X-Generator: WP-CLI 2.12.0\n"
@@ -17 +17 @@
 #. Plugin Name of the plugin
 #: clearwayforge.php
-msgid "Clearway Forge for WooCommerce"
+msgid "Clearway Forge – AI Traffic Analytics & llms.txt for WooCommerce"
 msgstr ""
 
 #. Plugin URI of the plugin
 #: clearwayforge.php
-msgid "https://github.com/avakode/clearway-forge"
+msgid "https://clearwayforge.com/"
 msgstr ""
 
 #. Description of the plugin
 #: clearwayforge.php
-msgid "See what AI assistants earn you, make your store readable to them, and keep agent actions under your control."
+msgid "See what AI assistants earn your store, make your catalogue readable to them, and keep the numbers in your own database."
 msgstr ""
 
@@ -35 +35 @@
 msgstr ""
 
-#: src/Admin/Menu.php:47
-#: src/Admin/Menu.php:48
-#: src/Admin/Menu.php:109
+#: src/Admin/AgentRevenueScreen.php:83
+#: src/Admin/Menu.php:101
+msgid "Revenue by AI agent"
+msgstr ""
+
+#. translators: %d: number of days in the longest window the report can show.
+#: src/Admin/AgentRevenueScreen.php:94
+#, php-format
+msgid "Showing the last %d days, the longest window the report can show. Nothing was deleted."
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:126
+msgid "Period"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:139
+msgid "Show"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:151
+msgid "AI agent"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:152
+msgid "Revenue"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:153
+msgid "Orders"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:154
+msgid "Sessions"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:155
+msgid "Conversion"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:156
+msgid "Average order"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:157
+msgid "Share"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:167
+msgid "No AI-attributed orders in this period yet."
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:187
+msgid "Total"
+msgstr ""
+
+#. translators: %s: revenue proven by a referrer or a campaign tag.
+#: src/Admin/AgentRevenueScreen.php:194
+#, php-format
+msgid "%s proven by a referrer or a tag"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:203
+msgid "Refunded"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:205
+msgid "Already taken off the revenue above."
+msgstr ""
+
+#. translators: 1: start date, 2: end date, 3: IANA time zone name.
+#: src/Admin/AgentRevenueScreen.php:214
+#, php-format
+msgid "Computed by your own store, %1$s to %2$s in %3$s."
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:220
+msgid "Nothing left your server to produce it."
+msgstr ""
+
+#: src/Admin/Menu.php:86
+#: src/Admin/Menu.php:200
 msgid "AI Channel"
 msgstr ""
 
-#: src/Admin/Menu.php:58
-#: src/Admin/Menu.php:114
+#: src/Admin/Menu.php:91
+msgid "Measurement"
+msgstr ""
+
+#: src/Admin/Menu.php:102
+msgid "Revenue by agent"
+msgstr ""
+
+#: src/Admin/Menu.php:110
+#: src/Admin/Menu.php:205
 msgid "AI Channel settings"
 msgstr ""
 
-#: src/Admin/Menu.php:59
+#: src/Admin/Menu.php:111
 msgid "Settings"
 msgstr ""
 
-#: src/Admin/Menu.php:67
+#: src/Admin/Menu.php:119
+#: src/Admin/Menu.php:211
+msgid "AI Channel health"
+msgstr ""
+
 #: src/Admin/Menu.php:120
-msgid "AI Channel health"
-msgstr ""
-
-#: src/Admin/Menu.php:68
 msgid "Health"
 msgstr ""
 
-#: src/Admin/Menu.php:136
+#: src/Admin/Menu.php:131
+msgid "AI Channel catalog"
+msgstr ""
+
+#: src/Admin/Menu.php:132
+#: src/Admin/Menu.php:217
+msgid "Catalog"
+msgstr ""
+
+#: src/Admin/Menu.php:141
+msgid "AI Channel agents"
+msgstr ""
+
+#: src/Admin/Menu.php:142
+#: src/Admin/Menu.php:223
+msgid "Agents"
+msgstr ""
+
+#: src/Admin/Menu.php:274
+msgid "The Clearway Forge add-on has not added any screens here yet."
+msgstr ""
+
+#: src/Admin/Menu.php:304
+msgid "Catalog needs an active WooCommerce store."
+msgstr ""
+
+#: src/Admin/Menu.php:305
+msgid "Feed drift and SKU tasks come with the separate Clearway Forge add-on."
+msgstr ""
+
+#: src/Admin/Menu.php:309
+msgid "Agents needs an active WooCommerce store."
+msgstr ""
+
+#: src/Admin/Menu.php:310
+msgid "Agent keys, scopes and the journal come with the separate Clearway Forge add-on."
+msgstr ""
+
+#: src/Admin/Menu.php:334
+#: src/Admin/Menu.php:393
+msgid "About the add-on"
+msgstr ""
+
+#: src/Admin/Menu.php:367
 msgid "Loading your AI channel data..."
 msgstr ""
 
-#: src/Admin/Menu.php:155
-msgid "Available in the paid add-on"
-msgstr ""
-
-#: src/Admin/Menu.php:162
-msgid "(active)"
-msgstr ""
-
-#: src/Admin/Menu.php:167
-msgid "What the add-on adds"
-msgstr ""
-
-#. translators: %d: maximum number of days available without the paid add-on.
-#: src/Infra/Rest/Routes.php:143
-#, php-format
-msgid "Reporting windows longer than %d days need the paid add-on."
-msgstr ""
+#: src/Admin/Menu.php:385
+msgid "In the separate Clearway Forge add-on"
+msgstr ""
+
+#: src/Admin/OrdersColumn.php:99
+#: src/Admin/OrdersColumn.php:105
+msgid "AI channel"
+msgstr ""
+
+#. translators: %d: largest reporting window the plugin accepts.
+#: src/Infra/Rest/Routes.php:189
+#, php-format
+msgid "Reporting windows longer than %d days are not supported."
+msgstr ""

clearwayforge/tags/1.0.3/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 8.2
-Stable tag: 1.0.2
+Stable tag: 1.0.3
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -168 +168 @@
 == Changelog ==
 
+= 1.0.3 =
+* Revenue is shown net of refunds. The dashboard and Revenue by agent take a refund off the order's own period and show the refunded total on its own line. Refunds made before the update are counted in the background, 200 orders at a time.
+* Changing the attribution model no longer hides your history: each order stays under the model it was recorded with, and the new model applies to orders from then on.
+* Amounts follow your store's number of price decimals (zero-decimal currencies included) in the dashboard and Revenue by agent. The privacy export shows the attributed amount as an amount instead of a raw count of cents.
+* llms.txt and llms-full.txt: page-cache plugins are told not to store them (the DONOTCACHEPAGE constant, and a no-cache header for LiteSpeed Cache). Both documents now share one freshness of 15 minutes: Cache-Control said 1 hour and the server copy of llms.txt lived 6 hours. Saving a product still clears the server copy.
+* llms.txt and llms-full.txt on Polylang and WPML sites list one product per translation group, in your default language. Without a multilingual plugin nothing changes.
+* llms-full.txt lists up to 500 products instead of repeating the short list, says "Showing N of M products" when it is cut, and points to the JSON catalogue feed when the paid add-on serves it.
+* On a multisite network with subdirectories, /sub/llms.txt now returns that site's own document.
+* A listener on the `clearwayforge/ai_order` hook that throws no longer breaks checkout. The exception is written as one line to WooCommerce > Status > Logs (source clearwayforge) by class name and the folder of the plugin it came from, with no message and no order data, and the order goes through.
+* New setting, Trusted reverse proxies: crawler address verification reads X-Forwarded-For for requests that arrive from a proxy on your list and ignores it for every other request. The list is empty by default, so the header is ignored. Changing it needs an administrator. IPv4 addresses carried in IPv6 notation now match the IPv4 vendor ranges.
+* Health: the UTC timezone warning no longer misses sites whose timezone is set by name.
+* The retention clean-up job is put back in the queue from the admin when activation missed it (an FTP update, a migrated database).
+* Deleting the plugin before the paid add-on keeps your "delete all data" choice for the add-on, so its tables go too.
+
 = 1.0.2 =
 * llms.txt and llms-full.txt show prices, names and descriptions as plain characters: a dollar price carried the HTML entity for the "$" sign instead of the sign itself, and a sale price repeated itself. A sale now reads the way WooCommerce says it to screen readers ("Original price was: $150.00. Current price is: $129.00."). The documents cached by 1.0.1 are not served after the update.

clearwayforge/tags/1.0.3/src/Admin/AgentRevenueScreen.php

@@ -91 +91 @@
                 esc_html(
                     sprintf(
-                        /* translators: %d: number of days the free plugin can show. */
+                        /* translators: %d: number of days in the longest window the report can show. */
                         __(
-                            'Showing the last %d days. Longer windows need the paid add-on; nothing was deleted.',
+                            'Showing the last %d days, the longest window the report can show. Nothing was deleted.',
                             'clearwayforge'
                         ),
@@ -196 +196 @@
             )
         ));
-        echo '</tr></tfoot></table>';
+        echo '</tr>';
+        // Выручка в таблице уже за вычетом возвратов; сумма возвратов стоит
+        // отдельной строкой (BUG-CLEAR-MISC-01, п. 14).
+        printf(
+            '<tr class="cwforge-refunded"><th scope="row">%s</th><td>%s</td><td colspan="5">%s</td></tr>',
+            esc_html__('Refunded', 'clearwayforge'),
+            esc_html($totals['refunded']),
+            esc_html__('Already taken off the revenue above.', 'clearwayforge')
+        );
+        echo '</tfoot></table>';
 
         printf(

clearwayforge/tags/1.0.3/src/Admin/Assets.php

@@ -27 +27 @@
 namespace ClearwayForge\Admin;
 
+use ClearwayForge\Infra\Report\StoreMinorUnit;
 use ClearwayForge\Infra\Rest\Routes;
 
@@ -55 +56 @@
             'nonce' => wp_create_nonce('wp_rest'),
             'currency' => get_woocommerce_currency(),
+            // Знаков после запятой у записанных сумм: `money()` ставит точку по
+            // ним, а не делением на сто (BUG-CLEAR-ATTR-02).
+            'minorUnit' => StoreMinorUnit::current(),
             'timezone' => wp_timezone_string(),
             'settingsUrl' => esc_url_raw(admin_url('admin.php?page=cwforge-settings')),

clearwayforge/tags/1.0.3/src/Domain/Attribution/Allocation.php

@@ -3 +3 @@
 /**
  * Доля заказа, приписанная одному касанию.
+ *
+ * ── Возврат (BUG-CLEAR-MISC-01, п. 14) ───────────────────────────────────
+ *
+ * `$amount` — сумма доли в момент заказа, она не меняется: движок атрибуции
+ * считает её один раз. Возврат приходит позже и хранится рядом
+ * (`$refundedCents`, доля возврата, пришедшаяся на эту строку): отчёты
+ * показывают выручку за вычетом возврата (`netCents()`), а сам возврат
+ * отдельной строкой.
  */
 
@@ -16 +24 @@
         public readonly Touch $touch,
         public readonly Money $amount,
-        public readonly int $weight
+        public readonly int $weight,
+        public readonly int $refundedCents = 0
     ) {
     }
+
+    /**
+     * Возврат в пределах доли: вернуть больше, чем заплачено за долю, нельзя,
+     * поэтому лишнее (повторный разбор с меньшей суммой, ошибка округления)
+     * отрезается, а выручка не уходит в минус.
+     */
+    public function effectiveRefundCents(): int
+    {
+        return max(0, min($this->refundedCents, $this->amount->cents));
+    }
+
+    /** Доля за вычетом возврата — то, что попадает в выручку. */
+    public function netCents(): int
+    {
+        return $this->amount->cents - $this->effectiveRefundCents();
+    }
 }

clearwayforge/tags/1.0.3/src/Domain/Attribution/AttributionModel.php

@@ -4 +4 @@
  * Как делить заказ между касаниями.
  *
- * Free-тариф получает только `LastTouch`, и это не искусственное урезание:
- * мульти-тач осмыслен, когда истории накопилось хотя бы на месяц, а тридцать
- * дней истории — ровно граница free.
+ * Все четыре модели входят в бесплатный плагин (readme на wp.org обещает это
+ * прямо), и платный аддон их не отнимает. Модель, выбранная в настройках,
+ * действует на заказы с момента выбора: каждый заказ записывается под ней и
+ * потом читается под ней же, задним числом отчёты не пересчитываются
+ * (`TouchRepository`, `DashboardAssembler`).
  */
 

clearwayforge/tags/1.0.3/src/Domain/Llms/StoreProfile.php

@@ -19 +19 @@
      * @param list<LlmsLink> $policies
      * @param list<LlmsLink> $pages
+     * @param ?int           $productsTotal Сколько товаров в каталоге всего. `products`
+     *                                      — только та часть, что загружена; без этого
+     *                                      числа документ не может сказать, что обрезан.
      */
     public function __construct(
@@ -30 +33 @@
         public readonly string $currency = 'USD',
         public readonly ?string $shippingNote = null,
-        public readonly ?string $returnsNote = null
+        public readonly ?string $returnsNote = null,
+        public readonly ?int $productsTotal = null
     ) {
     }

clearwayforge/tags/1.0.3/src/Domain/Report/AgentRevenueTable.php

@@ -32 +32 @@
 {
     /**
+     * `revenue_cents` — за вычетом возвратов, `refunded_cents` — сами возвраты
+     * по этому источнику (BUG-CLEAR-MISC-01, п. 14).
+     *
      * @return list<array{agent:string,label:string,orders:int,sessions:int,revenue_cents:int,
-     *                    revenue:string,aov:string,aov_cents:int,conversion:string,conversion_bp:int,
-     *                    share:string,share_bp:int}>
+     *                    revenue:string,refunded_cents:int,refunded:string,aov:string,aov_cents:int,
+     *                    conversion:string,conversion_bp:int,share:string,share_bp:int}>
      */
     public static function rows(DashboardReport $report): array
@@ -47 +50 @@
                 'sessions' => $row->sessions,
                 'revenue_cents' => $row->revenueCents,
-                'revenue' => MoneyText::format($row->revenueCents, $report->currency),
-                'aov' => MoneyText::format($row->aovCents(), $report->currency),
+                'revenue' => MoneyText::format($row->revenueCents, $report->currency, $report->minorUnit),
+                'refunded_cents' => $row->refundedCents,
+                'refunded' => MoneyText::format($row->refundedCents, $report->currency, $report->minorUnit),
+                'aov' => MoneyText::format($row->aovCents(), $report->currency, $report->minorUnit),
                 'aov_cents' => $row->aovCents(),
                 'conversion' => MoneyText::percent($row->conversionBp()),
@@ -68 +73 @@
      * молча чинить.
      *
-     * @return array{orders:int,sessions:int,revenue_cents:int,rows_cents:int,revenue:string,proven:string}
+     * @return array{orders:int,sessions:int,revenue_cents:int,rows_cents:int,revenue:string,
+     *                    refunded_cents:int,refunded:string,proven:string}
      */
     public static function totals(DashboardReport $report): array
@@ -82 +88 @@
             'revenue_cents' => $report->revenueCents,
             'rows_cents' => $rowsCents,
-            'revenue' => MoneyText::format($report->revenueCents, $report->currency),
-            'proven' => MoneyText::format($report->provenRevenueCents, $report->currency),
+            'revenue' => MoneyText::format($report->revenueCents, $report->currency, $report->minorUnit),
+            'refunded_cents' => $report->refundedCents,
+            'refunded' => MoneyText::format($report->refundedCents, $report->currency, $report->minorUnit),
+            'proven' => MoneyText::format($report->provenRevenueCents, $report->currency, $report->minorUnit),
         ];
     }

clearwayforge/tags/1.0.3/src/Domain/Report/DashboardBuilder.php

@@ -24 +24 @@
      * @param list<Touch>           $sessions По одному касанию на сессию окна.
      * @param list<CrawlerRow>      $crawlers Агрегаты заходов ботов за окно.
+     * @param int                   $minorUnit Знаков после запятой у записанных сумм
+     *                                         (`wc_get_price_decimals()`), отчёт только несёт их до печати.
      */
     public function build(
@@ -30 +32 @@
         array $sessions,
         array $crawlers = [],
-        string $currency = 'USD'
+        string $currency = 'USD',
+        int $minorUnit = 2
     ): DashboardReport {
         $orders = array_values(array_filter($orders, static fn (AttributedOrder $o): bool => $window->contains($o->atMs)));
@@ -38 +41 @@
         $provenRevenueBySource = [];
         $ordersBySource = [];
+        $refundedBySource = [];
         $totalRevenue = 0;
         $provenRevenue = 0;
+        $totalRefunded = 0;
         $attributedOrders = 0;
 
@@ -54 +59 @@
             foreach ($order->result->allocations as $allocation) {
                 $key = $allocation->touch->source->value;
-                $revenueBySource[$key] = ($revenueBySource[$key] ?? 0) + $allocation->amount->cents;
-                $totalRevenue += $allocation->amount->cents;
+                // Выручка — за вычетом возврата по этой доле (BUG-CLEAR-MISC-01,
+                // п. 14); сам возврат копится отдельно.
+                $net = $allocation->netCents();
+                $refunded = $allocation->effectiveRefundCents();
+                $revenueBySource[$key] = ($revenueBySource[$key] ?? 0) + $net;
+                $refundedBySource[$key] = ($refundedBySource[$key] ?? 0) + $refunded;
+                $totalRevenue += $net;
+                $totalRefunded += $refunded;
                 if ($allocation->touch->isProof()) {
-                    $provenRevenue += $allocation->amount->cents;
+                    $provenRevenue += $net;
                     // Та же доказанность, только по строке источника, а не
                     // по всему магазину — таблица «Where the money came
                     // from» обязана иметь ту же пару observed/estimated,
                     // что и заголовок (ревью major-3).
-                    $provenRevenueBySource[$key] = ($provenRevenueBySource[$key] ?? 0) + $allocation->amount->cents;
+                    $provenRevenueBySource[$key] = ($provenRevenueBySource[$key] ?? 0) + $net;
                 }
                 if (!isset($seenSources[$key])) {
@@ -84 +95 @@
         }
 
-        $bySource = $this->sourceRows($revenueBySource, $ordersBySource, $sessionsBySource, $provenRevenueBySource);
+        $bySource = $this->sourceRows(
+            $revenueBySource,
+            $ordersBySource,
+            $sessionsBySource,
+            $provenRevenueBySource,
+            $refundedBySource
+        );
         $days = $this->days($window, $orders);
 
@@ -98 +115 @@
             recoveredSessions: $recoveredSessions,
             provenRevenueCents: $provenRevenue,
+            refundedCents: $totalRefunded,
+            minorUnit: $minorUnit,
         );
     }
@@ -111 +130 @@
      * @param array<string,int> $provenRevenue Доля `$revenue` за этот источник,
      *        доказанная реферером или меткой (ревью major-3).
+     * @param array<string,int> $refunded Возвраты по источнику (уже вычтены из `$revenue`).
      * @return list<SourceRow>
      */
-    private function sourceRows(array $revenue, array $orders, array $sessions, array $provenRevenue = []): array
-    {
+    private function sourceRows(
+        array $revenue,
+        array $orders,
+        array $sessions,
+        array $provenRevenue = [],
+        array $refunded = []
+    ): array {
         $present = [];
         foreach (AiSource::ordered() as $source) {
@@ -153 +178 @@
                 $provenRevenue[$key] ?? 0,
                 $observedShares[$i] ?? 0,
+                $refunded[$key] ?? 0,
             );
         }
@@ -190 +216 @@
             }
             $revenue[$key] += array_sum(array_map(
-                static fn (Allocation $a): int => $a->amount->cents,
+                static fn (Allocation $a): int => $a->netCents(),
                 $order->result->allocations
             ));
@@ -197 +223 @@
             // observed/estimated, что и заголовок (ревью major-3).
             $provenRevenue[$key] += array_sum(array_map(
-                static fn (Allocation $a): int => $a->touch->isProof() ? $a->amount->cents : 0,
+                static fn (Allocation $a): int => $a->touch->isProof() ? $a->netCents() : 0,
                 $order->result->allocations
             ));

clearwayforge/tags/1.0.3/src/Domain/Report/MoneyText.php

@@ -18 +18 @@
  * ── Про арифметику ───────────────────────────────────────────────────────
  *
- * Её здесь нет. Центы уже целые, деление на сто — это разрез строки, а не
- * деление; `float` не участвует ни на одном шаге (AGENTS.md §3).
+ * Её здесь нет. Единицы уже целые, деление на степень десяти — это разрез
+ * строки, а не деление; `float` не участвует ни на одном шаге (AGENTS.md §3).
  *
  * ── Про скудный список символов ──────────────────────────────────────────
@@ -34 +34 @@
 final class MoneyText
 {
-    /** Целые центы в строку: `-1234550` и `USD` дают `-$12,345.50`. */
-    public static function format(int $cents, string $currency = 'USD'): string
+    /**
+     * Целые единицы в строку: `-1234550` и `USD` дают `-$12,345.50`.
+     *
+     * `$decimals` — знаков после запятой у записанной суммы (BUG-CLEAR-ATTR-02):
+     * 1500 иен при нуле знаков печатаются «JPY 1,500», 12345 динаров-миллей при
+     * трёх — «BHD 12.345». Прежняя константа «сто» превращала их в «15.00» и
+     * «123.45». Границы 0–4 — те же, что принимает `Money::fromDecimalString()`.
+     */
+    public static function format(int $cents, string $currency = 'USD', int $decimals = 2): string
     {
+        $decimals = max(0, min(4, $decimals));
         $sign = $cents < 0 ? '-' : '';
         $abs = abs($cents);
+        $text = $sign . self::symbol($currency);
 
-        return $sign
-            . self::symbol($currency)
-            . self::group(intdiv($abs, 100))
+        if ($decimals === 0) {
+            return $text . self::group($abs);
+        }
+
+        $factor = 10 ** $decimals;
+
+        return $text
+            . self::group(intdiv($abs, $factor))
             . '.'
-            . str_pad((string) ($abs % 100), 2, '0', STR_PAD_LEFT);
+            . str_pad((string) ($abs % $factor), $decimals, '0', STR_PAD_LEFT);
     }
 

clearwayforge/tags/1.0.3/src/Domain/Report/SourceRow.php

@@ -50 +50 @@
         public readonly int $provenRevenueCents = 0,
         /** Доля в базисных пунктах, посчитанная по весам `provenRevenueCents`, а не по `revenueCents`. */
-        public readonly int $observedShareBp = 0
+        public readonly int $observedShareBp = 0,
+        /** Возвраты по заказам этого источника; уже вычтены из `revenueCents`. */
+        public readonly int $refundedCents = 0
     ) {
     }
@@ -113 +115 @@
             'observed_aov_cents' => $this->observedAovCents(),
             'observed_share_bp' => $this->observedShareBp,
+            // BUG-CLEAR-MISC-01, п. 14: `revenue_cents` выше уже за вычетом
+            // возвратов, а сам возврат — здесь, отдельным числом.
+            'refunded_cents' => $this->refundedCents,
         ];
     }

clearwayforge/tags/1.0.3/src/Infra/Attribution/OrderObserver.php

@@ -140 +140 @@
         }
 
-        /**
-         * Заказ засчитан ИИ-каналу.
-         *
-         * Срабатывает один раз на заказ — не на касание, — сразу после того,
-         * как разбор лёг в таблицу. Аргумент `$agent` несёт источник с
-         * наибольшей долей; полная раскладка мультитач-заказа едет в
-         * `$attribution['sources']`.
-         *
-         * Хук идёт ПОСЛЕ записи намеренно: слушатель, разбуженный до неё,
-         * прочитал бы таблицу без этого заказа и решил, что его нет.
-         *
-         * @since 1.0.0
-         *
-         * @param int                 $order_id    Идентификатор заказа WooCommerce.
-         * @param string              $agent       Значение AiSource: 'chatgpt', 'perplexity'.
-         * @param array<string,mixed> $attribution Модель, валюта, суммы в целых
-         *                                         центах и раскладка по источникам.
+        /*
+         * Хук — побочный: чужой код атрибуции не должен стоить магазину
+         * продажи. `do_action()` не ловит исключений слушателей, а мы стоим
+         * внутри оформления заказа (после записи разбора, до оплаты), поэтому
+         * без `try` ошибка чужого слушателя дошла бы до покупателя как
+         * «не удалось оформить заказ». Ловим всё, что бросается, включая
+         * `\Error` (несовпавшая сигнатура слушателя).
          */
-        // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- имя в константе: AiOrderEvent::HOOK = 'clearwayforge/ai_order', префикс на месте, но статически WPCS его не разворачивает
-        do_action(AiOrderEvent::HOOK, ...$event->hookArgs());
+        try {
+            /**
+             * Заказ засчитан ИИ-каналу.
+             *
+             * Срабатывает один раз на заказ — не на касание, — сразу после того,
+             * как разбор лёг в таблицу. Аргумент `$agent` несёт источник с
+             * наибольшей долей; полная раскладка мультитач-заказа едет в
+             * `$attribution['sources']`.
+             *
+             * Хук идёт ПОСЛЕ записи намеренно: слушатель, разбуженный до неё,
+             * прочитал бы таблицу без этого заказа и решил, что его нет.
+             *
+             * Гарантия слушателям (CLEAR-ATTR-15): A listener exception does not
+             * break checkout. The observer catches any `\Throwable`, writes one
+             * WooCommerce log line (level `warning`, source `clearwayforge`; see
+             * WooCommerce > Status > Logs) with the hook name, the exception class
+             * and the plugin folder (or file name) it came from, and nothing else
+             * (no message, order number, email or amounts), and the order goes
+             * through.
+             * The listeners after the failing one are not called on that call,
+             * because the exception stops `do_action()` for that firing. A
+             * listener must therefore be safe to skip and must not rely on being
+             * last; one that must not be skipped belongs first in the priority
+             * order or has to catch its own errors.
+             *
+             * @since 1.0.0
+             *
+             * @param int                 $order_id    Идентификатор заказа WooCommerce.
+             * @param string              $agent       Значение AiSource: 'chatgpt', 'perplexity'.
+             * @param array<string,mixed> $attribution Модель, валюта, суммы в целых
+             *                                         центах и раскладка по источникам.
+             */
+            // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- имя в константе: AiOrderEvent::HOOK = 'clearwayforge/ai_order', префикс на месте, но статически WPCS его не разворачивает
+            do_action(AiOrderEvent::HOOK, ...$event->hookArgs());
+        } catch (\Throwable $listenerError) {
+            /*
+             * Одна строка: имя хука, класс исключения и виновник — папка
+             * плагина, из файла которого оно прилетело (первый сегмент пути
+             * под WP_PLUGIN_DIR), иначе имя файла. Ни текста исключения
+             * (в нём чужой код может держать номер заказа или почту), ни
+             * аргументов хука, ни полного пути. Имя класса анонимного
+             * исключения (`RuntimeException@anonymous\0<файл>:<строка>$0`) —
+             * до байта NUL: после него идут полный путь и номер строки, а
+             * байту NUL в строке лога не место.
+             *
+             * Строка идёт в журнал WooCommerce (WooCommerce > Status > Logs,
+             * источник `clearwayforge`), а не в error_log: в пакет wordpress.org
+             * вызовы error_log не попадают. Без WooCommerce заказов нет, и
+             * писать нечего.
+             */
+            if (function_exists('wc_get_logger')) {
+                try {
+                    wc_get_logger()->warning(
+                        sprintf(
+                            '[clearwayforge] a listener on %s threw %s in %s; the order was not affected.',
+                            AiOrderEvent::HOOK,
+                            explode("\0", $listenerError::class, 2)[0],
+                            self::listenerSource($listenerError->getFile(), defined('WP_PLUGIN_DIR') ? (string) constant('WP_PLUGIN_DIR') : null)
+                        ),
+                        ['source' => 'clearwayforge']
+                    );
+                } catch (\Throwable) {
+                    // Сломанный обработчик журнала (WooCommerce даёт их добавлять другим плагинам) не отменяет гарантию выше: заказ всё равно проходит.
+                }
+            }
+        }
+    }
+
+    /**
+     * Кто бросил исключение, для строки лога: имя папки плагина, если файл
+     * лежит под каталогом плагинов (первый сегмент пути после него; плагин из
+     * одного файла — имя этого файла), иначе имя файла. Каталог плагинов
+     * проверяется и как задан, и по `realpath()`: он может быть символической
+     * ссылкой, а PHP отдаёт путь файла уже раскрытым. Полный путь в лог не
+     * попадает.
+     *
+     * @internal Открыт только ради теста.
+     */
+    public static function listenerSource(string $file, ?string $pluginDir): string
+    {
+        $file = str_replace('\\', '/', $file);
+
+        $roots = [];
+        if ($pluginDir !== null && $pluginDir !== '') {
+            $roots[] = $pluginDir;
+            $real = realpath($pluginDir);
+            if ($real !== false) {
+                $roots[] = $real;
+            }
+        }
+
+        foreach ($roots as $root) {
+            $root = rtrim(str_replace('\\', '/', $root), '/') . '/';
+            if (strpos($file, $root) !== 0) {
+                continue;
+            }
+            $first = explode('/', substr($file, strlen($root)), 2)[0];
+            if ($first !== '') {
+                return $first;
+            }
+        }
+
+        return basename($file);
     }
 

clearwayforge/tags/1.0.3/src/Infra/Collect/VisitCollector.php

@@ -153 +153 @@
      * Адрес для проверки сети краулера.
      *
-     * Читается только `REMOTE_ADDR`: заголовки вроде `X-Forwarded-For`
-     * подделываются кем угодно, и поверить им означало бы дать любому
-     * скраперу способ объявить себя проверенным GPTBot одной строкой. За
-     * обратным прокси адрес будет неверным — и тогда классификатор честно
-     * скажет `declared` вместо `verified`, что лучше, чем ложное `verified`.
+     * Читается `REMOTE_ADDR`, а заголовки прокси (`X-Forwarded-For`) — только
+     * если владелец назвал доверенные прокси в настройках, и по правилам
+     * `RequestAddress`. Без списка заголовок не читается никогда:
+     * подделываемый кем угодно, он давал бы любому скраперу способ объявить
+     * себя проверенным GPTBot одной строкой. За обратным прокси без списка
+     * адрес будет неверным — и классификатор честно скажет `declared` вместо
+     * `verified`, что лучше, чем ложное `verified`.
      */
     private function trustedAddress(): ?string
     {
-        if (!isset($_SERVER['REMOTE_ADDR']) || !is_string($_SERVER['REMOTE_ADDR'])) {
-            return null;
-        }
-
-        $address = sanitize_text_field(wp_unslash($_SERVER['REMOTE_ADDR']));
-
-        return $address === '' ? null : $address;
+        return RequestAddress::fromServer($_SERVER);
     }
 

clearwayforge/tags/1.0.3/src/Infra/Db/Schema.php

@@ -36 +36 @@
      * Версия схемы. Инкрементируется при любом изменении определений ниже;
      * `Migrator` сравнивает её с сохранённой и решает, звать ли `dbDelta`.
+     *
+     * 2 — `touches.refunded_cents` (BUG-CLEAR-MISC-01, п. 14): возврат по
+     * заказу хранится рядом с суммой доли, отчёты вычитают его при чтении.
      */
-    public const VERSION = 1;
+    public const VERSION = 2;
 
     /** Общий префикс таблиц плагина поверх префикса WordPress. */
@@ -115 +118 @@
              * сменить, и старые отчёты обязаны остаться такими, какими он их
              * видел, иначе выручка прошлого месяца меняется задним числом.
+             *
+             * `refunded_cents` — доля возврата, пришедшаяся на эту строку
+             * (`TouchRepository::setOrderRefund()`). Сумма доли остаётся
+             * как была, отчёты вычитают возврат при чтении: возврат уменьшает
+             * заказ, к которому сделан, в периоде самого заказа.
              */
             'touches' => "CREATE TABLE {$p}touches (
@@ -125 +133 @@
   model VARCHAR(16) NOT NULL DEFAULT 'last',
   amount_cents BIGINT(20) NOT NULL DEFAULT 0,
+  refunded_cents BIGINT(20) NOT NULL DEFAULT 0,
   currency CHAR(3) NOT NULL DEFAULT 'USD',
   captured_ms BIGINT(20) UNSIGNED NOT NULL,

clearwayforge/tags/1.0.3/src/Infra/Health/HealthReport.php

@@ -107 +107 @@
             [
                 'label' => 'Site timezone',
-                'problem' => (wp_timezone_string() === 'UTC' && get_option('gmt_offset') === '0')
-                    ? 'The site timezone is UTC. Daily figures will be grouped in UTC, not in your local day.'
-                    : null,
+                'problem' => self::timezoneProblem(wp_timezone_string(), get_option('gmt_offset')),
             ],
         ];
+    }
+
+    /**
+     * Предупреждение о поясе UTC — или `null`, если сайт считает сутки по местному поясу.
+     *
+     * Смещение сравнивается числом, а не строкой: на сайте с поясом по названию ядро
+     * отвечает на `get_option('gmt_offset')` через `pre_option_gmt_offset` и отдаёт
+     * `float 0.0`, а не `'0'`, и строгое сравнение со строкой скрывало предупреждение
+     * на каждом таком сайте (BUG-CLEAR-DASH-01).
+     *
+     * @param mixed $gmtOffset Значение `get_option('gmt_offset')`: число, строка или `false`.
+     */
+    public static function timezoneProblem(string $timezone, mixed $gmtOffset): ?string
+    {
+        $offset = is_int($gmtOffset) || is_float($gmtOffset) || is_string($gmtOffset) ? (float) $gmtOffset : 0.0;
+
+        return $timezone === 'UTC' && $offset === 0.0
+            ? 'The site timezone is UTC. Daily figures will be grouped in UTC, not in your local day.'
+            : null;
     }
 

clearwayforge/tags/1.0.3/src/Infra/Llms/LlmsRoutes.php

@@ -16 +16 @@
  * кеша каждый заход бота собирал бы полный список категорий и товаров —
  * несколько запросов к базе на каждый из тысяч заходов в сутки.
+ *
+ * Страничные кеши плагинов (WP Super Cache, LiteSpeed Cache и другие)
+ * документ не держат, а всё, что стоит перед сайтом, держит его
+ * `DocumentCaching::MAX_AGE_SECONDS` (15 минут, как `catalog.json`). Чужие
+ * кеши мы не чистим (NEIGH-04).
  */
 
@@ -23 +28 @@
 
 use ClearwayForge\Domain\Llms\LlmsGenerator;
+use ClearwayForge\Infra\Pro\Bridge;
 use ClearwayForge\Infra\Support\Options;
 
@@ -34 +40 @@
      *
      * Число в конце ключа — версия того, как собирается документ. Меняется
-     * сборка — меняется число: иначе обновлённый сайт до шести часов отдаёт
+     * сборка — меняется число: иначе обновлённый сайт до пятнадцати минут отдаёт
      * текст, собранный прошлой версией, а сторож дрейфа принимает разницу
      * между старым кешем и новой сборкой за изменение каталога. 2 — 1.0.2:
-     * цены и названия без HTML-сущностей.
-     */
-    public const CACHE_MAP = 'cwforge_llms_map_2';
-    public const CACHE_FULL = 'cwforge_llms_full_2';
-    public const CACHE_TTL = 6 * HOUR_IN_SECONDS;
+     * цены и названия без HTML-сущностей. 3 — полная выгрузка грузит до
+     * `LlmsGenerator::FULL_PRODUCT_LIMIT` товаров, а обе пишут «Showing N of
+     * M products», когда каталог больше окна (BUG-CLEAR-MISC-01). 4 (только
+     * полная выгрузка) — она называет адрес машинного фида, когда магазин его
+     * отдаёт, и без обрезки (BUG-CLEAR-LLMS-02).
+     */
+    public const CACHE_MAP = 'cwforge_llms_map_3';
+    public const CACHE_FULL = 'cwforge_llms_full_4';
+
+    /**
+     * Серверный кеш живёт столько же, сколько документ обещает всем, кто стоит
+     * перед сайтом: одна константа `DocumentCaching::MAX_AGE_SECONDS` (900 с)
+     * на `llms.txt`, `llms-full.txt` и `catalog.json`. Сохранение товара кеш
+     * сбрасывает сразу (`invalidate()`), срок — страховка от правок мимо
+     * сохранения (импорт, прямая запись в базу).
+     */
+    public const CACHE_TTL = DocumentCaching::MAX_AGE_SECONDS;
+
+    /**
+     * Хук аддона: набор платных возможностей изменился (активация, окончание,
+     * освобождение лицензии). Ядро о лицензиях не знает и только сбрасывает кеш.
+     */
+    public const PAID_FEATURES_CHANGED = 'cwforge_paid_features_changed';
 
     /** Ключи прошлых версий сборки: их чистит удаление плагина. */
-    public const RETIRED_CACHE_KEYS = ['cwforge_llms_map', 'cwforge_llms_full'];
+    public const RETIRED_CACHE_KEYS = [
+        'cwforge_llms_map',
+        'cwforge_llms_full',
+        'cwforge_llms_map_2',
+        'cwforge_llms_full_2',
+        'cwforge_llms_full_3',
+    ];
 
     public function register(): void
@@ -53 +83 @@
         add_action('woocommerce_update_product', [$this, 'invalidate']);
         add_action('update_option_' . Options::NAME, [$this, 'invalidate']);
+        // Строка про машинный фид зависит от лицензии аддона (`feedUrl()`): аддон сообщает
+        // об изменении набора платных возможностей, и документ собирается заново.
+        add_action(self::PAID_FEATURES_CHANGED, [$this, 'invalidate']);
     }
 
@@ -66 +99 @@
             $path = (string) (wp_parse_url($requestUri, PHP_URL_PATH) ?? '/');
         }
-        $path = '/' . ltrim($path, '/');
+        // Дочерний сайт мультисайта с подпапками живёт по `/sub/`, и его документ — `/sub/llms.txt`
+        // (BUG-CLEAR-LLMS-01): путь главной страницы этого сайта снимается до сравнения.
+        $homePath = (string) (wp_parse_url(home_url('/'), PHP_URL_PATH) ?? '/');
+
+        $document = self::documentFor($path, $homePath);
+        if ($document === 'map') {
+            $this->serve(self::CACHE_MAP, false);
+        }
+        if ($document === 'full') {
+            $this->serve(self::CACHE_FULL, true);
+        }
+    }
+
+    /**
+     * Какой документ просит этот путь: `map` (`llms.txt`), `full` (`llms-full.txt`) или `null`.
+     *
+     * Сравнение точное: ни регистра, ни косой черты в конце, ни вложенных папок. Корневой
+     * `/llms.txt` для сайта с home `/sub/` — документ корневого сайта, а не этого; каталог
+     * корня ему не подставляется.
+     *
+     * @param string $requestPath Путь запроса, как пришёл (`/sub/llms.txt`).
+     * @param string $homePath    Путь главной страницы этого сайта: `/` или `/sub/` на мультисайте с подпапками.
+     */
+    public static function documentFor(string $requestPath, string $homePath): ?string
+    {
+        $path = '/' . ltrim($requestPath, '/');
+        $home = rtrim('/' . ltrim($homePath, '/'), '/');
+
+        if ($home !== '') {
+            if (strpos($path, $home . '/') !== 0) {
+                return null;
+            }
+            $path = substr($path, strlen($home));
+        }
 
         if ($path === '/llms.txt') {
-            $this->serve(self::CACHE_MAP, false);
+            return 'map';
         }
         if ($path === '/llms-full.txt') {
-            $this->serve(self::CACHE_FULL, true);
-        }
+            return 'full';
+        }
+
+        return null;
+    }
+
+    /**
+     * Строки заголовков ответа: тип, длина, запрет угадывания типа и срок жизни.
+     *
+     * Отдельным методом, чтобы заголовки проверялись без вывода и `exit`.
+     * Срок свежести и отказ страничным кешам берутся из `DocumentCaching`:
+     * число одно с `catalog.json` платного аддона.
+     *
+     * @return list<string>
+     */
+    public static function responseHeaders(int $length): array
+    {
+        return [
+            'Content-Type: text/plain; charset=utf-8',
+            'Content-Length: ' . $length,
+            'X-Robots-Tag: noindex',
+            // Без этого браузер вправе «угадать» HTML в тексте из названий товаров; с ним вывод остаётся текстом.
+            'X-Content-Type-Options: nosniff',
+            'Cache-Control: ' . DocumentCaching::cacheControl(),
+            DocumentCaching::LITESPEED_HEADER . ': ' . DocumentCaching::liteSpeedControl(),
+        ];
+    }
+
+    /**
+     * Положить собранный документ в серверный кеш на `CACHE_TTL`.
+     *
+     * Отдельным методом, чтобы срок проверялся без вывода и `exit`.
+     */
+    public static function remember(string $cacheKey, string $body): void
+    {
+        set_transient($cacheKey, $body, self::CACHE_TTL);
     }
 
@@ -80 +180 @@
         $body = get_transient($cacheKey);
         if (!is_string($body) || $body === '') {
-            $store = (new StoreProfileBuilder())->build();
-            $generator = new LlmsGenerator(max(1, Options::int('llms_product_limit', 50)));
+            $store = (new StoreProfileBuilder())->build($full);
+            $generator = new LlmsGenerator(max(1, Options::int('llms_product_limit', LlmsGenerator::MAP_PRODUCT_LIMIT)));
             $document = $full
-                ? $generator->full($store)
-                : $generator->map($store, rest_url('cwforge/v1/catalog.json'));
+                ? $generator->full($store, self::feedUrl())
+                : $generator->map($store, self::feedUrl());
             $body = $document->render();
-            set_transient($cacheKey, $body, self::CACHE_TTL);
+            self::remember($cacheKey, $body);
         }
 
         // Заголовки ставятся до вывода и включают длину: бот, читающий поток
         // без длины, не может отличить обрыв соединения от конца документа.
-        header('Content-Type: text/plain; charset=utf-8');
-        header('Content-Length: ' . strlen($body));
-        header('X-Robots-Tag: noindex');
-        // Без этого браузер вправе «угадать» HTML в тексте из названий товаров; с ним вывод остаётся текстом.
-        header('X-Content-Type-Options: nosniff');
-        header('Cache-Control: public, max-age=3600');
+        foreach (self::responseHeaders(strlen($body)) as $line) {
+            header($line);
+        }
+        // Страничные кеши плагинов документ не держат; свежесть для всего, что стоит перед сайтом, — наша (DocumentCaching).
+        DocumentCaching::excludeFromPageCaches();
 
         echo $body; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- ответ text/plain с nosniff: HTML-экранирование исказило бы документ для агентов.
@@ -102 +201 @@
     }
 
+    /**
+     * Адрес машинного фида — только если этот магазин его отдаёт.
+     *
+     * Фид живёт в платном аддоне и закрыт без лицензии. Строка «полный
+     * каталог — по такому-то адресу», ведущая на отказ, хуже её отсутствия.
+     */
+    private static function feedUrl(): ?string
+    {
+        return Bridge::instance()->isEnabled('catalog-feed') ? rest_url('cwforge/v1/catalog.json') : null;
+    }
+
     public function invalidate(): void
     {

clearwayforge/tags/1.0.3/src/Infra/Llms/StoreProfileBuilder.php

@@ -25 +25 @@
 namespace ClearwayForge\Infra\Llms;
 
+use ClearwayForge\Domain\Llms\LlmsGenerator;
 use ClearwayForge\Domain\Llms\LlmsLink;
 use ClearwayForge\Domain\Llms\PlainText;
@@ -34 +35 @@
 final class StoreProfileBuilder
 {
-    public function build(): StoreProfile
-    {
+    /**
+     * @param bool $full Профиль для `/llms-full.txt`: товаров грузится больше
+     *                   (`LlmsGenerator::fetchLimit()`), а общее число уходит в документ.
+     */
+    public function build(bool $full = false): StoreProfile
+    {
+        [$products, $total] = $this->products($full);
+
         return new StoreProfile(
             name: PlainText::fromHtml(get_bloginfo('name')),
@@ -41 +48 @@
             description: PlainText::fromHtml(get_bloginfo('description')),
             categories: $this->categories(),
-            products: $this->products(),
+            products: $products,
             policies: $this->policies(),
             pages: $this->pages(),
@@ -47 +54 @@
             shippingNote: $this->shippingNote(),
             returnsNote: null,
+            productsTotal: $total,
         );
     }
@@ -84 +92 @@
     }
 
-    /** @return list<LlmsLink> */
-    private function products(): array
-    {
-        $limit = max(1, Options::int('llms_product_limit', 50));
-
-        $products = wc_get_products([
+    /** @return array{0:list<LlmsLink>,1:?int} Товары окна и сколько их в каталоге всего. */
+    private function products(bool $full): array
+    {
+        $limit = LlmsGenerator::fetchLimit($full, Options::int('llms_product_limit', LlmsGenerator::MAP_PRODUCT_LIMIT));
+
+        // Один товар на группу переводов, как в catalog.json (NEIGH-07): `ProductTranslations` — единственное место правила.
+        $result = ProductTranslations::products([
             'status' => 'publish',
             'limit' => $limit,
@@ -95 +104 @@
             'order' => 'DESC',
             'visibility' => 'catalog',
+            'paginate' => true,
         ]);
 
+        // С `paginate` WooCommerce отдаёт объект с `products` и `total`; без
+        // него (старые версии, чужие фильтры) — просто список.
+        $total = null;
+        $products = $result;
+        if (is_object($result)) {
+            $products = $result->products ?? [];
+            $total = isset($result->total) ? (int) $result->total : null;
+        }
+
         if (!is_array($products)) {
-            return [];
+            return [[], null];
         }
 
@@ -113 +132 @@
         }
 
-        return $links;
+        return [$links, $total];
     }
 

clearwayforge/tags/1.0.3/src/Infra/Report/DashboardAssembler.php

@@ -25 +25 @@
  * ── Что здесь НЕ происходит ──────────────────────────────────────────────
  *
+ * Возвраты (BUG-CLEAR-MISC-01, п. 14): сумма доли хранится как была, а
+ * возврат по заказу лежит рядом (`refunded_cents`) и приходит в `Allocation`.
+ * Отчёт показывает выручку за вычетом возвратов в периоде самого заказа,
+ * а сумму возвратов — отдельным числом; здесь возврат только передаётся
+ * дальше, вычитает его `DashboardBuilder`.
+ *
  * Пересчёта атрибуции нет: суммы посчитаны в момент заказа и сохранены.
  * Пересчитать их сейчас значило бы применить сегодняшнюю модель к прошлому
  * месяцу и показать владельцу не ту выручку, которую он видел вчера.
+ *
+ * Тем более текущая модель не отбирает строки: заказ читается под той
+ * моделью, под которой записан (`TouchRepository::inWindow()`), и после
+ * смены настройки старые заказы остаются в отчёте (BUG-CLEAR-ATTR-01).
+ * Поэтому `$model` в `assemble()` — не фильтр, а запасное значение для
+ * строки, записанной моделью, которой эта версия не знает.
  */
 
@@ -62 +74 @@
     }
 
-    public function assemble(ReportWindow $window, AttributionModel $model, string $currency): DashboardReport
-    {
+    /**
+     * @param int|null $minorUnit Знаков после запятой у записанных сумм. Без
+     *                            указания — настройка магазина, та же, что
+     *                            читала запись заказа (BUG-CLEAR-ATTR-02).
+     */
+    public function assemble(
+        ReportWindow $window,
+        AttributionModel $model,
+        string $currency,
+        ?int $minorUnit = null
+    ): DashboardReport {
         return (new DashboardBuilder())->build(
             $window,
@@ -70 +91 @@
             $this->crawlerRows($window),
             $currency,
+            $minorUnit ?? StoreMinorUnit::current(),
         );
     }
@@ -81 +103 @@
     {
         $byOrder = [];
-        foreach ($this->touches->inWindow($fromMs, $toMs, $model->value) as $row) {
+        foreach ($this->touches->inWindow($fromMs, $toMs) as $row) {
             $source = AiSource::tryFrom($row['source']);
             $via = RecoveredVia::tryFrom($row['recovered_via']);
@@ -99 +121 @@
             $byOrder[$row['order_id']]['at'] = $row['captured_ms'];
             $byOrder[$row['order_id']]['currency'] = $row['currency'];
+            $byOrder[$row['order_id']]['model'] = AttributionModel::tryFrom($row['model']) ?? $model;
             $byOrder[$row['order_id']]['allocations'][] = new Allocation(
                 $touch,
                 Money::fromCents($row['amount_cents'], $row['currency']),
-                1
+                1,
+                $row['refunded_cents']
             );
         }
@@ -115 +139 @@
                 (int) $orderId,
                 (int) $data['at'],
-                new AttributionResult($model, $data['allocations'], $total)
+                new AttributionResult($data['model'], $data['allocations'], $total)
             );
         }

clearwayforge/tags/1.0.3/src/Infra/Repository/TouchRepository.php

@@ -7 +7 @@
  * модель атрибуции, и отчёт за прошлый месяц обязан остаться таким, каким он
  * его видел. Выручка, меняющаяся задним числом, обесценивает весь дашборд.
+ *
+ * Отсюда правило чтения (BUG-CLEAR-ATTR-01): заказ считается той моделью, под
+ * которой он записан первой, и текущая настройка модели строки не отбирает.
+ * Смена модели действует на заказы с момента смены (`OrderObserver` пишет их
+ * под новой), а прежние заказы остаются в дашборде, Revenue by agent, CSV и
+ * дайджесте с теми же суммами. Если у заказа есть строки под двумя моделями
+ * (повторный разбор), читается набор первой записанной: иначе заказ
+ * посчитался бы дважды.
  */
 
@@ -31 +39 @@
 
 use ClearwayForge\Domain\Attribution\AttributionResult;
+use ClearwayForge\Domain\Report\RefundSplit;
 use ClearwayForge\Infra\Db\Schema;
 
@@ -88 +97 @@
 
     /**
-     * Разобранные заказы окна.
+     * Разобранные заказы окна — каждый под моделью, с которой он записан.
+     *
+     * Подзапрос берёт модель самой ранней строки заказа (`id` растёт со
+     * вставкой), так что повторный разбор под другой моделью выручку не
+     * удваивает и не подменяет. Уникальный ключ (order_id, source, model)
+     * ведёт подзапрос по префиксу `order_id`.
+     *
+     * `refunded_cents` — доля возврата, пришедшаяся на строку; отчёт вычитает
+     * её из суммы строки в периоде самого заказа (BUG-CLEAR-MISC-01, п. 14).
      *
      * @return list<array{order_id:int,source:string,recovered_via:string,confidence:int,
-     *                    amount_cents:int,currency:string,captured_ms:int,model:string}>
-     */
-    public function inWindow(int $fromMs, int $toMs, string $model): array
+     *                    amount_cents:int,refunded_cents:int,currency:string,captured_ms:int,model:string}>
+     */
+    public function inWindow(int $fromMs, int $toMs): array
     {
         global $wpdb;
@@ -100 +117 @@
         $rows = $wpdb->get_results(
             $wpdb->prepare(
-                'SELECT order_id, source, recovered_via, confidence, amount_cents, currency, captured_ms, model
-                 FROM %i
-                 WHERE captured_ms >= %d AND captured_ms <= %d AND model = %s
-                 ORDER BY captured_ms ASC',
+                'SELECT t.order_id, t.source, t.recovered_via, t.confidence, t.amount_cents,
+                        t.refunded_cents, t.currency, t.captured_ms, t.model
+                 FROM %i t
+                 WHERE t.captured_ms >= %d AND t.captured_ms <= %d
+                   AND t.model = (
+                       SELECT h.model FROM %i h
+                       WHERE h.order_id = t.order_id
+                       ORDER BY h.id ASC
+                       LIMIT 1
+                   )
+                 ORDER BY t.captured_ms ASC, t.id ASC',
                 $table,
                 $fromMs,
                 $toMs,
-                $model
+                $table
             ),
             ARRAY_A
@@ -123 +147 @@
                 'confidence' => (int) $r['confidence'],
                 'amount_cents' => (int) $r['amount_cents'],
+                'refunded_cents' => (int) $r['refunded_cents'],
                 'currency' => (string) $r['currency'],
                 'captured_ms' => (int) $r['captured_ms'],
@@ -131 +156 @@
     }
 
+    /** Есть ли у заказа разбор: дёшево отсекает возвраты по заказам, которых мы не считали. */
+    public function hasOrder(int $orderId): bool
+    {
+        global $wpdb;
+
+        $table = Schema::table($this->wpPrefix, 'touches');
+
+        return $wpdb->get_var($wpdb->prepare('SELECT 1 FROM %i WHERE order_id = %d LIMIT 1', $table, $orderId)) !== null;
+    }
+
+    /**
+     * Записать, сколько по заказу возвращено всего (BUG-CLEAR-MISC-01, п. 14).
+     *
+     * Принимает итог, а не приращение: WooCommerce отвечает «возвращено по
+     * заказу столько», и повторный вызов с тем же числом, удаление возврата и
+     * новый частичный возврат дают верный результат без учёта порядка событий.
+     * Итог делится между строками заказа пропорционально их суммам
+     * (`RefundSplit`) и ложится в те строки, что читает `inWindow()` —
+     * записанные под первой моделью заказа.
+     *
+     * @return int Сколько строк заказа обновлено; 0 — разбора у заказа нет.
+     */
+    public function setOrderRefund(int $orderId, int $refundedCents): int
+    {
+        global $wpdb;
+
+        $table = Schema::table($this->wpPrefix, 'touches');
+        $rows = $wpdb->get_results(
+            $wpdb->prepare(
+                'SELECT t.id, t.amount_cents
+                 FROM %i t
+                 WHERE t.order_id = %d
+                   AND t.model = (
+                       SELECT h.model FROM %i h
+                       WHERE h.order_id = t.order_id
+                       ORDER BY h.id ASC
+                       LIMIT 1
+                   )
+                 ORDER BY t.id ASC',
+                $table,
+                $orderId,
+                $table
+            ),
+            ARRAY_A
+        );
+
+        if (!is_array($rows) || $rows === []) {
+            return 0;
+        }
+
+        $parts = RefundSplit::apportion(
+            $refundedCents,
+            array_values(array_map(static fn (array $r): int => (int) $r['amount_cents'], $rows))
+        );
+
+        foreach (array_values($rows) as $i => $row) {
+            $wpdb->query(
+                $wpdb->prepare(
+                    'UPDATE %i SET refunded_cents = %d WHERE id = %d',
+                    $table,
+                    $parts[$i],
+                    (int) $row['id']
+                )
+            );
+        }
+
+        return count($rows);
+    }
+
+    /**
+     * Следующая пачка различных заказов с разбором, по возрастанию номера.
+     *
+     * Курсором служит сам номер заказа: «всё, что больше последнего
+     * обработанного». Ключ `(order_id, source, model)` отдаёт такую выборку
+     * без сортировки по таблице целиком (досчёт возвратов, п. 14).
+     *
+     * @return list<int>
+     */
+    public function orderIdsAfter(int $afterOrderId, int $limit): array
+    {
+        global $wpdb;
+
+        $table = Schema::table($this->wpPrefix, 'touches');
+        $ids = $wpdb->get_col(
+            $wpdb->prepare(
+                'SELECT DISTINCT order_id FROM %i WHERE order_id > %d ORDER BY order_id ASC LIMIT %d',
+                $table,
+                $afterOrderId,
+                max(1, $limit)
+            )
+        );
+
+        return is_array($ids) ? array_values(array_map('intval', $ids)) : [];
+    }
+
     public function deleteOrder(int $orderId): int
     {

clearwayforge/tags/1.0.3/src/Infra/Rest/Routes.php

@@ -132 +132 @@
                             'required' => false,
                         ),
+                        'trusted_proxies'        => array(
+                            'type'     => 'string',
+                            'required' => false,
+                        ),
                         'delete_data_on_uninstall' => array(
                             'type'     => 'boolean',

clearwayforge/tags/1.0.3/src/Infra/Rest/SettingsController.php

@@ -26 +26 @@
 
 use ClearwayForge\Domain\Attribution\AttributionModel;
+use ClearwayForge\Domain\Crawler\TrustedProxies;
 use ClearwayForge\Infra\Scheduler\CrawlerRangeSources;
 use ClearwayForge\Infra\Scheduler\Maintenance;
@@ -74 +75 @@
         }
 
+        /*
+         * Доверенные прокси (BUG-CLEAR-MISC-01, п. 10): от списка зависит, чьему
+         * слову об адресе верит проверка краулеров. Запись, не являющаяся
+         * адресом или сетью, отбрасывается, остальные сохраняются; отброшенные
+         * возвращаются в ответе по имени (`trusted_proxies_rejected`), чтобы
+         * опечатка не осталась незамеченной. Пустая строка очищает список — и
+         * заголовки прокси снова не читаются.
+         */
+        $rejectedProxies = [];
+        $overLimitProxies = 0;
+        if ($request->get_param('trusted_proxies') !== null) {
+            if (!current_user_can('manage_options')) {
+                // Список решает, чьему заголовку верить, — это доверие к сети, а
+                // не настройка отчётов: менеджеру магазина (`manage_woocommerce`)
+                // оно не принадлежит. Отказ до любой записи, как у удаления данных.
+                return new WP_REST_Response(
+                    ['code' => 'cwforge_forbidden', 'message' => 'Only an administrator can change the trusted proxies.'],
+                    403
+                );
+            }
+
+            $proxies = TrustedProxies::fromText((string) $request->get_param('trusted_proxies'));
+            $values['trusted_proxies'] = $proxies->cidrs();
+            $rejectedProxies = $proxies->rejected();
+            $overLimitProxies = count($proxies->overLimit());
+        }
+
         $deleteOnUninstall = $request->get_param('delete_data_on_uninstall');
         if ($deleteOnUninstall !== null && !current_user_can('delete_plugins')) {
@@ -96 +124 @@
         }
 
-        return new WP_REST_Response(self::payload(), 200);
+        return new WP_REST_Response(self::payload($rejectedProxies, $overLimitProxies), 200);
     }
 
     /**
+     * @param list<string> $rejectedProxies Записи списка прокси, отброшенные в этом запросе как «не адрес».
+     * @param int $overLimitProxies Сколько годных записей не поместилось в потолок списка в этом запросе.
      * @return array{
      *     show_estimated_revenue:bool,
@@ -106 +136 @@
      *     crawler_ranges_refresh:bool,
      *     crawler_ranges_hosts:list<string>,
+     *     trusted_proxies:string,
+     *     trusted_proxies_rejected:list<string>,
+     *     trusted_proxies_over_limit:int,
+     *     trusted_proxies_limit:int,
+     *     can_change_proxies:bool,
      *     delete_data_on_uninstall:bool,
      *     can_change_uninstall:bool
      * }
      */
-    private static function payload(): array
+    private static function payload(array $rejectedProxies = [], int $overLimitProxies = 0): array
     {
         $current = AttributionModel::tryFrom(Options::string('attribution_model', 'last')) ?? AttributionModel::LastTouch;
@@ -125 +160 @@
             // не из текста: согласие даётся на то, что реально произойдёт.
             'crawler_ranges_hosts'     => self::hosts((new CrawlerRangeSources())->all()),
+            // Список как текст для поля ввода: по записи на строку.
+            'trusted_proxies'          => implode("\n", TrustedProxies::fromStored(Options::get('trusted_proxies', array()))->cidrs()),
+            // Что не прошло при последнем сохранении; на чтении всегда пусто.
+            'trusted_proxies_rejected' => $rejectedProxies,
+            // Годные записи сверх потолка: считаются отдельно, на чтении всегда 0.
+            'trusted_proxies_over_limit' => $overLimitProxies,
+            'trusted_proxies_limit'    => TrustedProxies::MAX,
+            'can_change_proxies'       => current_user_can('manage_options'),
             'delete_data_on_uninstall' => get_option(Options::DELETE_ON_UNINSTALL) === 'yes',
             'can_change_uninstall'     => current_user_can('delete_plugins'),

clearwayforge/tags/1.0.3/src/Infra/Scheduler/Maintenance.php

@@ -36 +36 @@
     public const GROUP = 'clearwayforge';
 
+    /** Метка «очередь проверена»: самолечение не чаще раза в окно, а не на каждый запрос админки. */
+    public const SCHEDULE_CHECKED = 'cwforge_schedule_checked';
+
     /** Скачанные сети вендоров. */
     public const RANGES_OPTION = 'cwforge_crawler_ranges';
@@ -54 +57 @@
         add_action(self::HOOK_PURGE, [$this, 'purge']);
         add_action(self::HOOK_RANGES, [$this, 'refreshRanges']);
+        // Только запросы админки: на витрине лишний вопрос к очереди — это
+        // накладные расходы на каждом хите покупателя (принцип 1 в AGENTS.md).
+        add_action('admin_init', [self::class, 'ensureScheduled']);
+    }
+
+    /**
+     * Вернуть уборку в очередь, если активация её не поставила.
+     *
+     * `scheduleAll()` зовёт только активация, а плагин попадает на сайт и
+     * без неё: обновление по FTP, перенос базы без таблиц Action Scheduler,
+     * очередь, вычищенная чужим инструментом, Action Scheduler, которого не
+     * было при активации. Без задачи `cwforge_purge_old_data` срок хранения
+     * (`retention_days`) тихо перестаёт действовать, и таблицы растут. Ту же
+     * оговорку про FTP несёт `Migrator::migrateIfNeeded()` в `Plugin::wire()`.
+     *
+     * Метка «проверено» ставится только когда очередь доступна: иначе одна
+     * неудачная попытка отключила бы самолечение на всё окно.
+     */
+    public static function ensureScheduled(): void
+    {
+        if (!function_exists('as_next_scheduled_action')) {
+            return;
+        }
+
+        if (get_transient(self::SCHEDULE_CHECKED) !== false) {
+            return;
+        }
+
+        set_transient(self::SCHEDULE_CHECKED, 1, 12 * HOUR_IN_SECONDS);
+        self::scheduleAll();
     }
 
@@ -81 +114 @@
 
         as_unschedule_all_actions(self::HOOK_PURGE, [], self::GROUP);
+        // Досчёт возвратов: поставленная пачка не должна пережить плагин (п. 14).
+        as_unschedule_all_actions(\ClearwayForge\Infra\Attribution\RefundBackfill::HOOK, [], self::GROUP);
         self::unscheduleRanges();
     }

clearwayforge/tags/1.0.3/uninstall.php

@@ -39 +39 @@
             \ClearwayForge\Infra\Support\Options::NAME,
             \ClearwayForge\Infra\Scheduler\Maintenance::RANGES_OPTION,
-            \ClearwayForge\Infra\Support\Options::DELETE_ON_UNINSTALL,
+            \ClearwayForge\Infra\Attribution\RefundBackfill::OPTION,
         ] as $cwforge_option
     ) {
@@ -45 +45 @@
     }
 
+    /*
+     * Согласие владельца общее для Free и платного аддона: надпись на экране
+     * настроек — «Delete all Clearway Forge data». Пока на сайте остались
+     * данные аддона (его метка версии схемы), флаг остаётся, иначе аддон,
+     * удаляемый вторым, не найдёт согласия и оставит свои таблицы
+     * (BUG-CLEAR-MISC-01). Аддон уберёт флаг сам, когда уйдёт последним.
+     */
+    if (get_option('cwforge_pro_schema_version', null) === null) {
+        delete_option(\ClearwayForge\Infra\Support\Options::DELETE_ON_UNINSTALL);
+    }
+
+    delete_transient(\ClearwayForge\Infra\Scheduler\Maintenance::SCHEDULE_CHECKED);
     delete_transient(\ClearwayForge\Infra\Llms\LlmsRoutes::CACHE_MAP);
     delete_transient(\ClearwayForge\Infra\Llms\LlmsRoutes::CACHE_FULL);

clearwayforge/tags/1.0.3/vendor/composer/autoload_classmap.php

@@ -25 +25 @@
     'ClearwayForge\\Domain\\Attribution\\SourceDetector' => $baseDir . '/src/Domain/Attribution/SourceDetector.php',
     'ClearwayForge\\Domain\\Attribution\\Touch' => $baseDir . '/src/Domain/Attribution/Touch.php',
+    'ClearwayForge\\Domain\\Crawler\\ClientAddress' => $baseDir . '/src/Domain/Crawler/ClientAddress.php',
     'ClearwayForge\\Domain\\Crawler\\CrawlerClassifier' => $baseDir . '/src/Domain/Crawler/CrawlerClassifier.php',
     'ClearwayForge\\Domain\\Crawler\\CrawlerCorpus' => $baseDir . '/src/Domain/Crawler/CrawlerCorpus.php',
@@ -31 +32 @@
     'ClearwayForge\\Domain\\Crawler\\CrawlerKind' => $baseDir . '/src/Domain/Crawler/CrawlerKind.php',
     'ClearwayForge\\Domain\\Crawler\\IpRange' => $baseDir . '/src/Domain/Crawler/IpRange.php',
+    'ClearwayForge\\Domain\\Crawler\\TrustedProxies' => $baseDir . '/src/Domain/Crawler/TrustedProxies.php',
     'ClearwayForge\\Domain\\Crawler\\Verification' => $baseDir . '/src/Domain/Crawler/Verification.php',
     'ClearwayForge\\Domain\\Llms\\LlmsBlock' => $baseDir . '/src/Domain/Llms/LlmsBlock.php',
@@ -52 +54 @@
     'ClearwayForge\\Domain\\Report\\MoneyText' => $baseDir . '/src/Domain/Report/MoneyText.php',
     'ClearwayForge\\Domain\\Report\\PeriodSelector' => $baseDir . '/src/Domain/Report/PeriodSelector.php',
+    'ClearwayForge\\Domain\\Report\\RefundSplit' => $baseDir . '/src/Domain/Report/RefundSplit.php',
     'ClearwayForge\\Domain\\Report\\ReportWindow' => $baseDir . '/src/Domain/Report/ReportWindow.php',
     'ClearwayForge\\Domain\\Report\\SourceRow' => $baseDir . '/src/Domain/Report/SourceRow.php',
@@ -63 +66 @@
     'ClearwayForge\\Infra\\Attribution\\OrderMeta' => $baseDir . '/src/Infra/Attribution/OrderMeta.php',
     'ClearwayForge\\Infra\\Attribution\\OrderObserver' => $baseDir . '/src/Infra/Attribution/OrderObserver.php',
+    'ClearwayForge\\Infra\\Attribution\\OrderRefunds' => $baseDir . '/src/Infra/Attribution/OrderRefunds.php',
     'ClearwayForge\\Infra\\Attribution\\OrderVerdictWriter' => $baseDir . '/src/Infra/Attribution/OrderVerdictWriter.php',
+    'ClearwayForge\\Infra\\Attribution\\RefundBackfill' => $baseDir . '/src/Infra/Attribution/RefundBackfill.php',
+    'ClearwayForge\\Infra\\Attribution\\RefundObserver' => $baseDir . '/src/Infra/Attribution/RefundObserver.php',
     'ClearwayForge\\Infra\\Attribution\\WcOrderMeta' => $baseDir . '/src/Infra/Attribution/WcOrderMeta.php',
+    'ClearwayForge\\Infra\\Attribution\\WcOrderRefunds' => $baseDir . '/src/Infra/Attribution/WcOrderRefunds.php',
+    'ClearwayForge\\Infra\\Collect\\RequestAddress' => $baseDir . '/src/Infra/Collect/RequestAddress.php',
     'ClearwayForge\\Infra\\Collect\\RequestSignals' => $baseDir . '/src/Infra/Collect/RequestSignals.php',
     'ClearwayForge\\Infra\\Collect\\VisitCollector' => $baseDir . '/src/Infra/Collect/VisitCollector.php',
@@ -73 +81 @@
     'ClearwayForge\\Infra\\Db\\Schema' => $baseDir . '/src/Infra/Db/Schema.php',
     'ClearwayForge\\Infra\\Health\\HealthReport' => $baseDir . '/src/Infra/Health/HealthReport.php',
+    'ClearwayForge\\Infra\\Llms\\DocumentCaching' => $baseDir . '/src/Infra/Llms/DocumentCaching.php',
     'ClearwayForge\\Infra\\Llms\\LlmsRoutes' => $baseDir . '/src/Infra/Llms/LlmsRoutes.php',
+    'ClearwayForge\\Infra\\Llms\\ProductTranslations' => $baseDir . '/src/Infra/Llms/ProductTranslations.php',
     'ClearwayForge\\Infra\\Llms\\StoreProfileBuilder' => $baseDir . '/src/Infra/Llms/StoreProfileBuilder.php',
     'ClearwayForge\\Infra\\Plugin' => $baseDir . '/src/Infra/Plugin.php',
@@ -79 +89 @@
     'ClearwayForge\\Infra\\Pro\\Bridge' => $baseDir . '/src/Infra/Pro/Bridge.php',
     'ClearwayForge\\Infra\\Report\\DashboardAssembler' => $baseDir . '/src/Infra/Report/DashboardAssembler.php',
+    'ClearwayForge\\Infra\\Report\\StoreMinorUnit' => $baseDir . '/src/Infra/Report/StoreMinorUnit.php',
     'ClearwayForge\\Infra\\Repository\\HitRepository' => $baseDir . '/src/Infra/Repository/HitRepository.php',
     'ClearwayForge\\Infra\\Repository\\SessionRepository' => $baseDir . '/src/Infra/Repository/SessionRepository.php',

clearwayforge/tags/1.0.3/vendor/composer/autoload_static.php

@@ -40 +40 @@
         'ClearwayForge\\Domain\\Attribution\\SourceDetector' => __DIR__ . '/../..' . '/src/Domain/Attribution/SourceDetector.php',
         'ClearwayForge\\Domain\\Attribution\\Touch' => __DIR__ . '/../..' . '/src/Domain/Attribution/Touch.php',
+        'ClearwayForge\\Domain\\Crawler\\ClientAddress' => __DIR__ . '/../..' . '/src/Domain/Crawler/ClientAddress.php',
         'ClearwayForge\\Domain\\Crawler\\CrawlerClassifier' => __DIR__ . '/../..' . '/src/Domain/Crawler/CrawlerClassifier.php',
         'ClearwayForge\\Domain\\Crawler\\CrawlerCorpus' => __DIR__ . '/../..' . '/src/Domain/Crawler/CrawlerCorpus.php',
@@ -46 +47 @@
         'ClearwayForge\\Domain\\Crawler\\CrawlerKind' => __DIR__ . '/../..' . '/src/Domain/Crawler/CrawlerKind.php',
         'ClearwayForge\\Domain\\Crawler\\IpRange' => __DIR__ . '/../..' . '/src/Domain/Crawler/IpRange.php',
+        'ClearwayForge\\Domain\\Crawler\\TrustedProxies' => __DIR__ . '/../..' . '/src/Domain/Crawler/TrustedProxies.php',
         'ClearwayForge\\Domain\\Crawler\\Verification' => __DIR__ . '/../..' . '/src/Domain/Crawler/Verification.php',
         'ClearwayForge\\Domain\\Llms\\LlmsBlock' => __DIR__ . '/../..' . '/src/Domain/Llms/LlmsBlock.php',
@@ -67 +69 @@
         'ClearwayForge\\Domain\\Report\\MoneyText' => __DIR__ . '/../..' . '/src/Domain/Report/MoneyText.php',
         'ClearwayForge\\Domain\\Report\\PeriodSelector' => __DIR__ . '/../..' . '/src/Domain/Report/PeriodSelector.php',
+        'ClearwayForge\\Domain\\Report\\RefundSplit' => __DIR__ . '/../..' . '/src/Domain/Report/RefundSplit.php',
         'ClearwayForge\\Domain\\Report\\ReportWindow' => __DIR__ . '/../..' . '/src/Domain/Report/ReportWindow.php',
         'ClearwayForge\\Domain\\Report\\SourceRow' => __DIR__ . '/../..' . '/src/Domain/Report/SourceRow.php',
@@ -78 +81 @@
         'ClearwayForge\\Infra\\Attribution\\OrderMeta' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderMeta.php',
         'ClearwayForge\\Infra\\Attribution\\OrderObserver' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderObserver.php',
+        'ClearwayForge\\Infra\\Attribution\\OrderRefunds' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderRefunds.php',
         'ClearwayForge\\Infra\\Attribution\\OrderVerdictWriter' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderVerdictWriter.php',
+        'ClearwayForge\\Infra\\Attribution\\RefundBackfill' => __DIR__ . '/../..' . '/src/Infra/Attribution/RefundBackfill.php',
+        'ClearwayForge\\Infra\\Attribution\\RefundObserver' => __DIR__ . '/../..' . '/src/Infra/Attribution/RefundObserver.php',
         'ClearwayForge\\Infra\\Attribution\\WcOrderMeta' => __DIR__ . '/../..' . '/src/Infra/Attribution/WcOrderMeta.php',
+        'ClearwayForge\\Infra\\Attribution\\WcOrderRefunds' => __DIR__ . '/../..' . '/src/Infra/Attribution/WcOrderRefunds.php',
+        'ClearwayForge\\Infra\\Collect\\RequestAddress' => __DIR__ . '/../..' . '/src/Infra/Collect/RequestAddress.php',
         'ClearwayForge\\Infra\\Collect\\RequestSignals' => __DIR__ . '/../..' . '/src/Infra/Collect/RequestSignals.php',
         'ClearwayForge\\Infra\\Collect\\VisitCollector' => __DIR__ . '/../..' . '/src/Infra/Collect/VisitCollector.php',
@@ -88 +96 @@
         'ClearwayForge\\Infra\\Db\\Schema' => __DIR__ . '/../..' . '/src/Infra/Db/Schema.php',
         'ClearwayForge\\Infra\\Health\\HealthReport' => __DIR__ . '/../..' . '/src/Infra/Health/HealthReport.php',
+        'ClearwayForge\\Infra\\Llms\\DocumentCaching' => __DIR__ . '/../..' . '/src/Infra/Llms/DocumentCaching.php',
         'ClearwayForge\\Infra\\Llms\\LlmsRoutes' => __DIR__ . '/../..' . '/src/Infra/Llms/LlmsRoutes.php',
+        'ClearwayForge\\Infra\\Llms\\ProductTranslations' => __DIR__ . '/../..' . '/src/Infra/Llms/ProductTranslations.php',
         'ClearwayForge\\Infra\\Llms\\StoreProfileBuilder' => __DIR__ . '/../..' . '/src/Infra/Llms/StoreProfileBuilder.php',
         'ClearwayForge\\Infra\\Plugin' => __DIR__ . '/../..' . '/src/Infra/Plugin.php',
@@ -94 +104 @@
         'ClearwayForge\\Infra\\Pro\\Bridge' => __DIR__ . '/../..' . '/src/Infra/Pro/Bridge.php',
         'ClearwayForge\\Infra\\Report\\DashboardAssembler' => __DIR__ . '/../..' . '/src/Infra/Report/DashboardAssembler.php',
+        'ClearwayForge\\Infra\\Report\\StoreMinorUnit' => __DIR__ . '/../..' . '/src/Infra/Report/StoreMinorUnit.php',
         'ClearwayForge\\Infra\\Repository\\HitRepository' => __DIR__ . '/../..' . '/src/Infra/Repository/HitRepository.php',
         'ClearwayForge\\Infra\\Repository\\SessionRepository' => __DIR__ . '/../..' . '/src/Infra/Repository/SessionRepository.php',

clearwayforge/tags/1.0.3/vendor/composer/installed.php

@@ -4 +4 @@
         'pretty_version' => 'dev-main',
         'version' => 'dev-main',
-        'reference' => 'ad83e89e38c6b6fbc028bc3dc13d42efbd4497a4',
+        'reference' => '7fe110de51f63a39ee1c6e61f2b9cbed4b17852c',
         'type' => 'wordpress-plugin',
         'install_path' => __DIR__ . '/../../',
@@ -14 +14 @@
             'pretty_version' => 'dev-main',
             'version' => 'dev-main',
-            'reference' => 'ad83e89e38c6b6fbc028bc3dc13d42efbd4497a4',
+            'reference' => '7fe110de51f63a39ee1c6e61f2b9cbed4b17852c',
             'type' => 'wordpress-plugin',
             'install_path' => __DIR__ . '/../../',

clearwayforge/trunk/assets/admin/admin.js

@@ -11 +11 @@
  * ── Почему числа форматируются здесь, а считаются на сервере ─────────────
  *
- * Все суммы приходят целыми центами, доли — базисными пунктами. Клиент их
- * только показывает. Любая арифметика здесь означала бы второй источник
+ * Все суммы приходят целыми минорными единицами, доли — базисными пунктами.
+ * Клиент их только показывает; сколько знаков после запятой у единицы, говорит
+ * сервер (`cwforgeAdmin.minorUnit` = `wc_get_price_decimals()`, та же точность,
+ * с которой заказ записан): иены (0 знаков) и динары (3) — не центы. Любая арифметика здесь означала бы второй источник
  * истины: экран и письмо-дайджест начали бы показывать разные числа, и
  * поймать это можно было бы только глазами.
@@ -29 +31 @@
         var apiFetch = wp.apiFetch;
 
-        /** Центы в строку с валютой. Форматирование локали делает браузер. */
+        /**
+         * Записанные единицы в строку с валютой. Форматирование локали делает
+         * браузер, а место точки — настройка магазина `config.minorUnit`: 1500
+         * при нуле знаков это 1500 иен, а не 15 (BUG-CLEAR-ATTR-02). WordPress
+         * отдаёт скаляры локализации строками, поэтому число разбирается заново;
+         * без него или вне 0-4 остаются два знака, как было.
+         */
         function money( cents, currency ) {
-                var value = ( cents || 0 ) / 100;
+                var digits = parseInt( config.minorUnit, 10 );
+                if ( isNaN( digits ) || digits < 0 || digits > 4 ) {
+                        digits = 2;
+                }
+                var value = ( cents || 0 ) / Math.pow( 10, digits );
                 try {
                         return new Intl.NumberFormat( undefined, {
                                 style: 'currency',
                                 currency: currency || 'USD',
-                                maximumFractionDigits: 2,
+                                minimumFractionDigits: digits,
+                                maximumFractionDigits: digits,
                         } ).format( value );
                 } catch ( e ) {
                         // Неизвестный код валюты роняет Intl. Магазин с экзотической
                         // валютой не должен получать пустой экран вместо цифр.
-                        return value.toFixed( 2 ) + ' ' + ( currency || '' );
+                        return value.toFixed( digits ) + ' ' + ( currency || '' );
                 }
         }
@@ -444 +457 @@
                                 { className: 'cwforge-stats' },
                                 el( Stat, { label: 'AI-attributed orders', value: String( data.totals.orders ) } ),
+                                // Выручка выше уже за вычетом возвратов; сами возвраты отдельной строкой.
+                                el( Stat, { label: 'Refunded', value: money( data.totals.refunded_cents || 0, currency ) } ),
                                 el( Stat, { label: 'AI sessions', value: String( data.totals.sessions ) } ),
                                 el( Stat, { label: 'Recovered sessions', value: percent( recovered.share_bp ) } ),
@@ -743 +758 @@
                 var uninstall = uninstallState[ 0 ];
                 var setUninstall = uninstallState[ 1 ];
+                // Доверенные прокси: черновик текста правится в поле и уходит одной
+                // кнопкой; сервер сохраняет годные записи и называет отброшенные.
+                var proxiesState = useState( { value: '', saved: '', message: '', rejected: [], overLimit: 0, limit: 0 } );
+                var proxies = proxiesState[ 0 ];
+                var setProxies = proxiesState[ 1 ];
+                // Список прокси правит администратор; менеджеру магазина поле только читается.
+                var proxiesAllowedState = useState( false );
+                var proxiesAllowed = proxiesAllowedState[ 0 ];
+                var setProxiesAllowed = proxiesAllowedState[ 1 ];
 
                 function load() {
@@ -764 +788 @@
                                                 saved: '',
                                         } );
+                                        setProxies( { value: data.trusted_proxies || '', saved: '', message: '', rejected: [], overLimit: 0, limit: data.trusted_proxies_limit || 0 } );
+                                        setProxiesAllowed( !! data.can_change_proxies );
                                 } )
                                 .catch( function ( error ) {
@@ -814 +840 @@
                                 .catch( function () {
                                         setUninstall( { value: ! next, allowed: uninstall.allowed, saved: 'error' } );
+                                } );
+                }
+
+                function saveProxies() {
+                        var draft = proxies.value;
+                        setProxies( { value: draft, saved: 'saving', message: '', rejected: [], overLimit: 0, limit: proxies.limit } );
+                        apiFetch( {
+                                path: '/cwforge/v1/settings',
+                                method: 'POST',
+                                data: { trusted_proxies: draft },
+                        } )
+                                .then( function ( data ) {
+                                        // Показываем то, что сервер сохранил (без повторов и лишних пробелов),
+                                        // и называем записи, которые он отбросил.
+                                        setProxies( {
+                                                value: data.trusted_proxies || '',
+                                                saved: 'saved',
+                                                message: '',
+                                                rejected: Array.isArray( data.trusted_proxies_rejected ) ? data.trusted_proxies_rejected : [],
+                                                overLimit: data.trusted_proxies_over_limit || 0,
+                                                limit: data.trusted_proxies_limit || proxies.limit,
+                                        } );
+                                } )
+                                .catch( function ( error ) {
+                                        // Черновик остаётся как есть: владелец правит запись, а не вводит всё заново.
+                                        setProxies( {
+                                                value: draft,
+                                                saved: 'error',
+                                                message: error && error.message ? String( error.message ) : '',
+                                                rejected: [],
+                                                overLimit: 0,
+                                                limit: proxies.limit,
+                                        } );
                                 } );
                 }
@@ -919 +978 @@
                                 'p',
                                 { className: 'description' },
-                                'The dashboard and the revenue by AI agent report credit every order in the window with this model. ' +
+                                'The model applies to orders placed from the moment you switch it. Earlier orders keep the model they ' +
+                                        'were recorded with, so past reports are not recalculated. ' +
                                         'The AI channel column on an order keeps the model that was in force when the order was placed.'
                         ),
@@ -948 +1008 @@
                         ),
                         savedNote( ranges.saved ),
+                        el( 'h3', null, 'Trusted reverse proxies' ),
+                        el(
+                                'label',
+                                { htmlFor: 'cwforge-trusted-proxies' },
+                                'Networks of the proxies in front of this site, one per line (a network such as 10.0.0.0/8, or a single address)'
+                        ),
+                        el( 'textarea', {
+                                id: 'cwforge-trusted-proxies',
+                                className: 'large-text code',
+                                rows: 4,
+                                placeholder: '10.0.0.0/8',
+                                value: proxies.value,
+                                disabled: ! proxiesAllowed || proxies.saved === 'saving',
+                                onChange: function ( event ) {
+                                        setProxies( { value: event.target.value, saved: '', message: '', rejected: [], overLimit: 0, limit: proxies.limit } );
+                                },
+                        } ),
+                        el(
+                                'p',
+                                { className: 'description' },
+                                'Leave this empty unless a reverse proxy or load balancer that you control sits in front of the site. ' +
+                                        'While the list is empty the plugin checks crawler visits against the address of the connection only ' +
+                                        'and never reads the X-Forwarded-For header, which any visitor can forge. Behind a proxy that address ' +
+                                        'is the proxy itself, so crawler visits are shown as "declared". When the connection comes from a ' +
+                                        'network listed here, the plugin uses the right-most X-Forwarded-For address that is not in the list.'
+                        ),
+                        el(
+                                'button',
+                                {
+                                        type: 'button',
+                                        className: 'button',
+                                        disabled: ! proxiesAllowed || proxies.saved === 'saving',
+                                        onClick: saveProxies,
+                                },
+                                'Save proxies'
+                        ),
+                        proxiesAllowed
+                                ? null
+                                : el( 'p', { className: 'description' }, 'Only an administrator can change the trusted proxies.' ),
+                        proxies.saved === 'saved' ? el( 'p', { role: 'status' }, 'Saved.' ) : null,
+                        proxies.saved === 'saved' && proxies.rejected.length
+                                ? el(
+                                        'p',
+                                        { className: 'notice notice-warning', role: 'alert' },
+                                        'Not saved, because they are not an IP address or network: ' + proxies.rejected.join( ', ' )
+                                )
+                                : null,
+                        proxies.saved === 'saved' && proxies.overLimit
+                                ? el(
+                                        'p',
+                                        { className: 'notice notice-warning', role: 'alert' },
+                                        'Only the first ' + proxies.limit + ' entries are kept; ' + proxies.overLimit + ' more were not saved.'
+                                )
+                                : null,
+                        proxies.saved === 'error'
+                                ? el(
+                                        'p',
+                                        { className: 'notice notice-error' },
+                                        'Could not save' + ( proxies.message ? ': ' + proxies.message : '. Try again.' )
+                                )
+                                : null,
                         el( 'h3', null, 'When the plugin is deleted' ),
                         el(
@@ -983 +1104 @@
                 /*
                  * Экраны бесплатного ядра, и только они. Очередь одобрений сюда не
-                 * входит и входить не может: это код уровня Growth, а этот файл едет
+                 * входит и входить не может: это платный код Guard, а этот файл едет
                  * в бесплатном zip на wp.org, где реализация платной функции на диске
                  * — отказ на ревью (docs/free-pro-split.md §5). Её рисует свой скрипт

clearwayforge/trunk/clearwayforge.php

@@ -2 +2 @@
 
 /**
- * Plugin Name:       Clearway Forge for WooCommerce
+ * Plugin Name:       Clearway Forge – AI Traffic Analytics & llms.txt for WooCommerce
  * Plugin URI:        https://clearwayforge.com/
  * Description:       See what AI assistants earn your store, make your catalogue readable to them, and keep the numbers in your own database.
- * Version:           1.0.2
+ * Version:           1.0.3
  * Requires at least: 6.5
  * Requires PHP:      8.2
@@ -38 +38 @@
 }
 
-const CWFORGE_VERSION = '1.0.2';
+const CWFORGE_VERSION = '1.0.3';
 const CWFORGE_MIN_PHP = '8.2';
 const CWFORGE_MIN_WP = '6.5';

clearwayforge/trunk/languages/clearwayforge.pot

@@ -3 +3 @@
 msgid ""
 msgstr ""
-"Project-Id-Version: Clearway Forge for WooCommerce 0.1.0\n"
-"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/clearwayforge\n"
+"Project-Id-Version: Clearway Forge – AI Traffic Analytics & llms.txt for WooCommerce 1.0.3\n"
+"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/plugin\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -10 +10 @@
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"POT-Creation-Date: 2026-08-26T18:36:47+00:00\n"
+"POT-Creation-Date: 2026-10-30T22:19:42+00:00\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "X-Generator: WP-CLI 2.12.0\n"
@@ -17 +17 @@
 #. Plugin Name of the plugin
 #: clearwayforge.php
-msgid "Clearway Forge for WooCommerce"
+msgid "Clearway Forge – AI Traffic Analytics & llms.txt for WooCommerce"
 msgstr ""
 
 #. Plugin URI of the plugin
 #: clearwayforge.php
-msgid "https://github.com/avakode/clearway-forge"
+msgid "https://clearwayforge.com/"
 msgstr ""
 
 #. Description of the plugin
 #: clearwayforge.php
-msgid "See what AI assistants earn you, make your store readable to them, and keep agent actions under your control."
+msgid "See what AI assistants earn your store, make your catalogue readable to them, and keep the numbers in your own database."
 msgstr ""
 
@@ -35 +35 @@
 msgstr ""
 
-#: src/Admin/Menu.php:47
-#: src/Admin/Menu.php:48
-#: src/Admin/Menu.php:109
+#: src/Admin/AgentRevenueScreen.php:83
+#: src/Admin/Menu.php:101
+msgid "Revenue by AI agent"
+msgstr ""
+
+#. translators: %d: number of days in the longest window the report can show.
+#: src/Admin/AgentRevenueScreen.php:94
+#, php-format
+msgid "Showing the last %d days, the longest window the report can show. Nothing was deleted."
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:126
+msgid "Period"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:139
+msgid "Show"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:151
+msgid "AI agent"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:152
+msgid "Revenue"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:153
+msgid "Orders"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:154
+msgid "Sessions"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:155
+msgid "Conversion"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:156
+msgid "Average order"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:157
+msgid "Share"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:167
+msgid "No AI-attributed orders in this period yet."
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:187
+msgid "Total"
+msgstr ""
+
+#. translators: %s: revenue proven by a referrer or a campaign tag.
+#: src/Admin/AgentRevenueScreen.php:194
+#, php-format
+msgid "%s proven by a referrer or a tag"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:203
+msgid "Refunded"
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:205
+msgid "Already taken off the revenue above."
+msgstr ""
+
+#. translators: 1: start date, 2: end date, 3: IANA time zone name.
+#: src/Admin/AgentRevenueScreen.php:214
+#, php-format
+msgid "Computed by your own store, %1$s to %2$s in %3$s."
+msgstr ""
+
+#: src/Admin/AgentRevenueScreen.php:220
+msgid "Nothing left your server to produce it."
+msgstr ""
+
+#: src/Admin/Menu.php:86
+#: src/Admin/Menu.php:200
 msgid "AI Channel"
 msgstr ""
 
-#: src/Admin/Menu.php:58
-#: src/Admin/Menu.php:114
+#: src/Admin/Menu.php:91
+msgid "Measurement"
+msgstr ""
+
+#: src/Admin/Menu.php:102
+msgid "Revenue by agent"
+msgstr ""
+
+#: src/Admin/Menu.php:110
+#: src/Admin/Menu.php:205
 msgid "AI Channel settings"
 msgstr ""
 
-#: src/Admin/Menu.php:59
+#: src/Admin/Menu.php:111
 msgid "Settings"
 msgstr ""
 
-#: src/Admin/Menu.php:67
+#: src/Admin/Menu.php:119
+#: src/Admin/Menu.php:211
+msgid "AI Channel health"
+msgstr ""
+
 #: src/Admin/Menu.php:120
-msgid "AI Channel health"
-msgstr ""
-
-#: src/Admin/Menu.php:68
 msgid "Health"
 msgstr ""
 
-#: src/Admin/Menu.php:136
+#: src/Admin/Menu.php:131
+msgid "AI Channel catalog"
+msgstr ""
+
+#: src/Admin/Menu.php:132
+#: src/Admin/Menu.php:217
+msgid "Catalog"
+msgstr ""
+
+#: src/Admin/Menu.php:141
+msgid "AI Channel agents"
+msgstr ""
+
+#: src/Admin/Menu.php:142
+#: src/Admin/Menu.php:223
+msgid "Agents"
+msgstr ""
+
+#: src/Admin/Menu.php:274
+msgid "The Clearway Forge add-on has not added any screens here yet."
+msgstr ""
+
+#: src/Admin/Menu.php:304
+msgid "Catalog needs an active WooCommerce store."
+msgstr ""
+
+#: src/Admin/Menu.php:305
+msgid "Feed drift and SKU tasks come with the separate Clearway Forge add-on."
+msgstr ""
+
+#: src/Admin/Menu.php:309
+msgid "Agents needs an active WooCommerce store."
+msgstr ""
+
+#: src/Admin/Menu.php:310
+msgid "Agent keys, scopes and the journal come with the separate Clearway Forge add-on."
+msgstr ""
+
+#: src/Admin/Menu.php:334
+#: src/Admin/Menu.php:393
+msgid "About the add-on"
+msgstr ""
+
+#: src/Admin/Menu.php:367
 msgid "Loading your AI channel data..."
 msgstr ""
 
-#: src/Admin/Menu.php:155
-msgid "Available in the paid add-on"
-msgstr ""
-
-#: src/Admin/Menu.php:162
-msgid "(active)"
-msgstr ""
-
-#: src/Admin/Menu.php:167
-msgid "What the add-on adds"
-msgstr ""
-
-#. translators: %d: maximum number of days available without the paid add-on.
-#: src/Infra/Rest/Routes.php:143
-#, php-format
-msgid "Reporting windows longer than %d days need the paid add-on."
-msgstr ""
+#: src/Admin/Menu.php:385
+msgid "In the separate Clearway Forge add-on"
+msgstr ""
+
+#: src/Admin/OrdersColumn.php:99
+#: src/Admin/OrdersColumn.php:105
+msgid "AI channel"
+msgstr ""
+
+#. translators: %d: largest reporting window the plugin accepts.
+#: src/Infra/Rest/Routes.php:189
+#, php-format
+msgid "Reporting windows longer than %d days are not supported."
+msgstr ""

clearwayforge/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 8.2
-Stable tag: 1.0.2
+Stable tag: 1.0.3
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -168 +168 @@
 == Changelog ==
 
+= 1.0.3 =
+* Revenue is shown net of refunds. The dashboard and Revenue by agent take a refund off the order's own period and show the refunded total on its own line. Refunds made before the update are counted in the background, 200 orders at a time.
+* Changing the attribution model no longer hides your history: each order stays under the model it was recorded with, and the new model applies to orders from then on.
+* Amounts follow your store's number of price decimals (zero-decimal currencies included) in the dashboard and Revenue by agent. The privacy export shows the attributed amount as an amount instead of a raw count of cents.
+* llms.txt and llms-full.txt: page-cache plugins are told not to store them (the DONOTCACHEPAGE constant, and a no-cache header for LiteSpeed Cache). Both documents now share one freshness of 15 minutes: Cache-Control said 1 hour and the server copy of llms.txt lived 6 hours. Saving a product still clears the server copy.
+* llms.txt and llms-full.txt on Polylang and WPML sites list one product per translation group, in your default language. Without a multilingual plugin nothing changes.
+* llms-full.txt lists up to 500 products instead of repeating the short list, says "Showing N of M products" when it is cut, and points to the JSON catalogue feed when the paid add-on serves it.
+* On a multisite network with subdirectories, /sub/llms.txt now returns that site's own document.
+* A listener on the `clearwayforge/ai_order` hook that throws no longer breaks checkout. The exception is written as one line to WooCommerce > Status > Logs (source clearwayforge) by class name and the folder of the plugin it came from, with no message and no order data, and the order goes through.
+* New setting, Trusted reverse proxies: crawler address verification reads X-Forwarded-For for requests that arrive from a proxy on your list and ignores it for every other request. The list is empty by default, so the header is ignored. Changing it needs an administrator. IPv4 addresses carried in IPv6 notation now match the IPv4 vendor ranges.
+* Health: the UTC timezone warning no longer misses sites whose timezone is set by name.
+* The retention clean-up job is put back in the queue from the admin when activation missed it (an FTP update, a migrated database).
+* Deleting the plugin before the paid add-on keeps your "delete all data" choice for the add-on, so its tables go too.
+
 = 1.0.2 =
 * llms.txt and llms-full.txt show prices, names and descriptions as plain characters: a dollar price carried the HTML entity for the "$" sign instead of the sign itself, and a sale price repeated itself. A sale now reads the way WooCommerce says it to screen readers ("Original price was: $150.00. Current price is: $129.00."). The documents cached by 1.0.1 are not served after the update.

clearwayforge/trunk/src/Admin/AgentRevenueScreen.php

@@ -91 +91 @@
                 esc_html(
                     sprintf(
-                        /* translators: %d: number of days the free plugin can show. */
+                        /* translators: %d: number of days in the longest window the report can show. */
                         __(
-                            'Showing the last %d days. Longer windows need the paid add-on; nothing was deleted.',
+                            'Showing the last %d days, the longest window the report can show. Nothing was deleted.',
                             'clearwayforge'
                         ),
@@ -196 +196 @@
             )
         ));
-        echo '</tr></tfoot></table>';
+        echo '</tr>';
+        // Выручка в таблице уже за вычетом возвратов; сумма возвратов стоит
+        // отдельной строкой (BUG-CLEAR-MISC-01, п. 14).
+        printf(
+            '<tr class="cwforge-refunded"><th scope="row">%s</th><td>%s</td><td colspan="5">%s</td></tr>',
+            esc_html__('Refunded', 'clearwayforge'),
+            esc_html($totals['refunded']),
+            esc_html__('Already taken off the revenue above.', 'clearwayforge')
+        );
+        echo '</tfoot></table>';
 
         printf(

clearwayforge/trunk/src/Admin/Assets.php

@@ -27 +27 @@
 namespace ClearwayForge\Admin;
 
+use ClearwayForge\Infra\Report\StoreMinorUnit;
 use ClearwayForge\Infra\Rest\Routes;
 
@@ -55 +56 @@
             'nonce' => wp_create_nonce('wp_rest'),
             'currency' => get_woocommerce_currency(),
+            // Знаков после запятой у записанных сумм: `money()` ставит точку по
+            // ним, а не делением на сто (BUG-CLEAR-ATTR-02).
+            'minorUnit' => StoreMinorUnit::current(),
             'timezone' => wp_timezone_string(),
             'settingsUrl' => esc_url_raw(admin_url('admin.php?page=cwforge-settings')),

clearwayforge/trunk/src/Domain/Attribution/Allocation.php

@@ -3 +3 @@
 /**
  * Доля заказа, приписанная одному касанию.
+ *
+ * ── Возврат (BUG-CLEAR-MISC-01, п. 14) ───────────────────────────────────
+ *
+ * `$amount` — сумма доли в момент заказа, она не меняется: движок атрибуции
+ * считает её один раз. Возврат приходит позже и хранится рядом
+ * (`$refundedCents`, доля возврата, пришедшаяся на эту строку): отчёты
+ * показывают выручку за вычетом возврата (`netCents()`), а сам возврат
+ * отдельной строкой.
  */
 
@@ -16 +24 @@
         public readonly Touch $touch,
         public readonly Money $amount,
-        public readonly int $weight
+        public readonly int $weight,
+        public readonly int $refundedCents = 0
     ) {
     }
+
+    /**
+     * Возврат в пределах доли: вернуть больше, чем заплачено за долю, нельзя,
+     * поэтому лишнее (повторный разбор с меньшей суммой, ошибка округления)
+     * отрезается, а выручка не уходит в минус.
+     */
+    public function effectiveRefundCents(): int
+    {
+        return max(0, min($this->refundedCents, $this->amount->cents));
+    }
+
+    /** Доля за вычетом возврата — то, что попадает в выручку. */
+    public function netCents(): int
+    {
+        return $this->amount->cents - $this->effectiveRefundCents();
+    }
 }

clearwayforge/trunk/src/Domain/Attribution/AttributionModel.php

@@ -4 +4 @@
  * Как делить заказ между касаниями.
  *
- * Free-тариф получает только `LastTouch`, и это не искусственное урезание:
- * мульти-тач осмыслен, когда истории накопилось хотя бы на месяц, а тридцать
- * дней истории — ровно граница free.
+ * Все четыре модели входят в бесплатный плагин (readme на wp.org обещает это
+ * прямо), и платный аддон их не отнимает. Модель, выбранная в настройках,
+ * действует на заказы с момента выбора: каждый заказ записывается под ней и
+ * потом читается под ней же, задним числом отчёты не пересчитываются
+ * (`TouchRepository`, `DashboardAssembler`).
  */
 

clearwayforge/trunk/src/Domain/Llms/StoreProfile.php

@@ -19 +19 @@
      * @param list<LlmsLink> $policies
      * @param list<LlmsLink> $pages
+     * @param ?int           $productsTotal Сколько товаров в каталоге всего. `products`
+     *                                      — только та часть, что загружена; без этого
+     *                                      числа документ не может сказать, что обрезан.
      */
     public function __construct(
@@ -30 +33 @@
         public readonly string $currency = 'USD',
         public readonly ?string $shippingNote = null,
-        public readonly ?string $returnsNote = null
+        public readonly ?string $returnsNote = null,
+        public readonly ?int $productsTotal = null
     ) {
     }

clearwayforge/trunk/src/Domain/Report/AgentRevenueTable.php

@@ -32 +32 @@
 {
     /**
+     * `revenue_cents` — за вычетом возвратов, `refunded_cents` — сами возвраты
+     * по этому источнику (BUG-CLEAR-MISC-01, п. 14).
+     *
      * @return list<array{agent:string,label:string,orders:int,sessions:int,revenue_cents:int,
-     *                    revenue:string,aov:string,aov_cents:int,conversion:string,conversion_bp:int,
-     *                    share:string,share_bp:int}>
+     *                    revenue:string,refunded_cents:int,refunded:string,aov:string,aov_cents:int,
+     *                    conversion:string,conversion_bp:int,share:string,share_bp:int}>
      */
     public static function rows(DashboardReport $report): array
@@ -47 +50 @@
                 'sessions' => $row->sessions,
                 'revenue_cents' => $row->revenueCents,
-                'revenue' => MoneyText::format($row->revenueCents, $report->currency),
-                'aov' => MoneyText::format($row->aovCents(), $report->currency),
+                'revenue' => MoneyText::format($row->revenueCents, $report->currency, $report->minorUnit),
+                'refunded_cents' => $row->refundedCents,
+                'refunded' => MoneyText::format($row->refundedCents, $report->currency, $report->minorUnit),
+                'aov' => MoneyText::format($row->aovCents(), $report->currency, $report->minorUnit),
                 'aov_cents' => $row->aovCents(),
                 'conversion' => MoneyText::percent($row->conversionBp()),
@@ -68 +73 @@
      * молча чинить.
      *
-     * @return array{orders:int,sessions:int,revenue_cents:int,rows_cents:int,revenue:string,proven:string}
+     * @return array{orders:int,sessions:int,revenue_cents:int,rows_cents:int,revenue:string,
+     *                    refunded_cents:int,refunded:string,proven:string}
      */
     public static function totals(DashboardReport $report): array
@@ -82 +88 @@
             'revenue_cents' => $report->revenueCents,
             'rows_cents' => $rowsCents,
-            'revenue' => MoneyText::format($report->revenueCents, $report->currency),
-            'proven' => MoneyText::format($report->provenRevenueCents, $report->currency),
+            'revenue' => MoneyText::format($report->revenueCents, $report->currency, $report->minorUnit),
+            'refunded_cents' => $report->refundedCents,
+            'refunded' => MoneyText::format($report->refundedCents, $report->currency, $report->minorUnit),
+            'proven' => MoneyText::format($report->provenRevenueCents, $report->currency, $report->minorUnit),
         ];
     }

clearwayforge/trunk/src/Domain/Report/DashboardBuilder.php

@@ -24 +24 @@
      * @param list<Touch>           $sessions По одному касанию на сессию окна.
      * @param list<CrawlerRow>      $crawlers Агрегаты заходов ботов за окно.
+     * @param int                   $minorUnit Знаков после запятой у записанных сумм
+     *                                         (`wc_get_price_decimals()`), отчёт только несёт их до печати.
      */
     public function build(
@@ -30 +32 @@
         array $sessions,
         array $crawlers = [],
-        string $currency = 'USD'
+        string $currency = 'USD',
+        int $minorUnit = 2
     ): DashboardReport {
         $orders = array_values(array_filter($orders, static fn (AttributedOrder $o): bool => $window->contains($o->atMs)));
@@ -38 +41 @@
         $provenRevenueBySource = [];
         $ordersBySource = [];
+        $refundedBySource = [];
         $totalRevenue = 0;
         $provenRevenue = 0;
+        $totalRefunded = 0;
         $attributedOrders = 0;
 
@@ -54 +59 @@
             foreach ($order->result->allocations as $allocation) {
                 $key = $allocation->touch->source->value;
-                $revenueBySource[$key] = ($revenueBySource[$key] ?? 0) + $allocation->amount->cents;
-                $totalRevenue += $allocation->amount->cents;
+                // Выручка — за вычетом возврата по этой доле (BUG-CLEAR-MISC-01,
+                // п. 14); сам возврат копится отдельно.
+                $net = $allocation->netCents();
+                $refunded = $allocation->effectiveRefundCents();
+                $revenueBySource[$key] = ($revenueBySource[$key] ?? 0) + $net;
+                $refundedBySource[$key] = ($refundedBySource[$key] ?? 0) + $refunded;
+                $totalRevenue += $net;
+                $totalRefunded += $refunded;
                 if ($allocation->touch->isProof()) {
-                    $provenRevenue += $allocation->amount->cents;
+                    $provenRevenue += $net;
                     // Та же доказанность, только по строке источника, а не
                     // по всему магазину — таблица «Where the money came
                     // from» обязана иметь ту же пару observed/estimated,
                     // что и заголовок (ревью major-3).
-                    $provenRevenueBySource[$key] = ($provenRevenueBySource[$key] ?? 0) + $allocation->amount->cents;
+                    $provenRevenueBySource[$key] = ($provenRevenueBySource[$key] ?? 0) + $net;
                 }
                 if (!isset($seenSources[$key])) {
@@ -84 +95 @@
         }
 
-        $bySource = $this->sourceRows($revenueBySource, $ordersBySource, $sessionsBySource, $provenRevenueBySource);
+        $bySource = $this->sourceRows(
+            $revenueBySource,
+            $ordersBySource,
+            $sessionsBySource,
+            $provenRevenueBySource,
+            $refundedBySource
+        );
         $days = $this->days($window, $orders);
 
@@ -98 +115 @@
             recoveredSessions: $recoveredSessions,
             provenRevenueCents: $provenRevenue,
+            refundedCents: $totalRefunded,
+            minorUnit: $minorUnit,
         );
     }
@@ -111 +130 @@
      * @param array<string,int> $provenRevenue Доля `$revenue` за этот источник,
      *        доказанная реферером или меткой (ревью major-3).
+     * @param array<string,int> $refunded Возвраты по источнику (уже вычтены из `$revenue`).
      * @return list<SourceRow>
      */
-    private function sourceRows(array $revenue, array $orders, array $sessions, array $provenRevenue = []): array
-    {
+    private function sourceRows(
+        array $revenue,
+        array $orders,
+        array $sessions,
+        array $provenRevenue = [],
+        array $refunded = []
+    ): array {
         $present = [];
         foreach (AiSource::ordered() as $source) {
@@ -153 +178 @@
                 $provenRevenue[$key] ?? 0,
                 $observedShares[$i] ?? 0,
+                $refunded[$key] ?? 0,
             );
         }
@@ -190 +216 @@
             }
             $revenue[$key] += array_sum(array_map(
-                static fn (Allocation $a): int => $a->amount->cents,
+                static fn (Allocation $a): int => $a->netCents(),
                 $order->result->allocations
             ));
@@ -197 +223 @@
             // observed/estimated, что и заголовок (ревью major-3).
             $provenRevenue[$key] += array_sum(array_map(
-                static fn (Allocation $a): int => $a->touch->isProof() ? $a->amount->cents : 0,
+                static fn (Allocation $a): int => $a->touch->isProof() ? $a->netCents() : 0,
                 $order->result->allocations
             ));

clearwayforge/trunk/src/Domain/Report/MoneyText.php

@@ -18 +18 @@
  * ── Про арифметику ───────────────────────────────────────────────────────
  *
- * Её здесь нет. Центы уже целые, деление на сто — это разрез строки, а не
- * деление; `float` не участвует ни на одном шаге (AGENTS.md §3).
+ * Её здесь нет. Единицы уже целые, деление на степень десяти — это разрез
+ * строки, а не деление; `float` не участвует ни на одном шаге (AGENTS.md §3).
  *
  * ── Про скудный список символов ──────────────────────────────────────────
@@ -34 +34 @@
 final class MoneyText
 {
-    /** Целые центы в строку: `-1234550` и `USD` дают `-$12,345.50`. */
-    public static function format(int $cents, string $currency = 'USD'): string
+    /**
+     * Целые единицы в строку: `-1234550` и `USD` дают `-$12,345.50`.
+     *
+     * `$decimals` — знаков после запятой у записанной суммы (BUG-CLEAR-ATTR-02):
+     * 1500 иен при нуле знаков печатаются «JPY 1,500», 12345 динаров-миллей при
+     * трёх — «BHD 12.345». Прежняя константа «сто» превращала их в «15.00» и
+     * «123.45». Границы 0–4 — те же, что принимает `Money::fromDecimalString()`.
+     */
+    public static function format(int $cents, string $currency = 'USD', int $decimals = 2): string
     {
+        $decimals = max(0, min(4, $decimals));
         $sign = $cents < 0 ? '-' : '';
         $abs = abs($cents);
+        $text = $sign . self::symbol($currency);
 
-        return $sign
-            . self::symbol($currency)
-            . self::group(intdiv($abs, 100))
+        if ($decimals === 0) {
+            return $text . self::group($abs);
+        }
+
+        $factor = 10 ** $decimals;
+
+        return $text
+            . self::group(intdiv($abs, $factor))
             . '.'
-            . str_pad((string) ($abs % 100), 2, '0', STR_PAD_LEFT);
+            . str_pad((string) ($abs % $factor), $decimals, '0', STR_PAD_LEFT);
     }
 

clearwayforge/trunk/src/Domain/Report/SourceRow.php

@@ -50 +50 @@
         public readonly int $provenRevenueCents = 0,
         /** Доля в базисных пунктах, посчитанная по весам `provenRevenueCents`, а не по `revenueCents`. */
-        public readonly int $observedShareBp = 0
+        public readonly int $observedShareBp = 0,
+        /** Возвраты по заказам этого источника; уже вычтены из `revenueCents`. */
+        public readonly int $refundedCents = 0
     ) {
     }
@@ -113 +115 @@
             'observed_aov_cents' => $this->observedAovCents(),
             'observed_share_bp' => $this->observedShareBp,
+            // BUG-CLEAR-MISC-01, п. 14: `revenue_cents` выше уже за вычетом
+            // возвратов, а сам возврат — здесь, отдельным числом.
+            'refunded_cents' => $this->refundedCents,
         ];
     }

clearwayforge/trunk/src/Infra/Attribution/OrderObserver.php

@@ -140 +140 @@
         }
 
-        /**
-         * Заказ засчитан ИИ-каналу.
-         *
-         * Срабатывает один раз на заказ — не на касание, — сразу после того,
-         * как разбор лёг в таблицу. Аргумент `$agent` несёт источник с
-         * наибольшей долей; полная раскладка мультитач-заказа едет в
-         * `$attribution['sources']`.
-         *
-         * Хук идёт ПОСЛЕ записи намеренно: слушатель, разбуженный до неё,
-         * прочитал бы таблицу без этого заказа и решил, что его нет.
-         *
-         * @since 1.0.0
-         *
-         * @param int                 $order_id    Идентификатор заказа WooCommerce.
-         * @param string              $agent       Значение AiSource: 'chatgpt', 'perplexity'.
-         * @param array<string,mixed> $attribution Модель, валюта, суммы в целых
-         *                                         центах и раскладка по источникам.
+        /*
+         * Хук — побочный: чужой код атрибуции не должен стоить магазину
+         * продажи. `do_action()` не ловит исключений слушателей, а мы стоим
+         * внутри оформления заказа (после записи разбора, до оплаты), поэтому
+         * без `try` ошибка чужого слушателя дошла бы до покупателя как
+         * «не удалось оформить заказ». Ловим всё, что бросается, включая
+         * `\Error` (несовпавшая сигнатура слушателя).
          */
-        // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- имя в константе: AiOrderEvent::HOOK = 'clearwayforge/ai_order', префикс на месте, но статически WPCS его не разворачивает
-        do_action(AiOrderEvent::HOOK, ...$event->hookArgs());
+        try {
+            /**
+             * Заказ засчитан ИИ-каналу.
+             *
+             * Срабатывает один раз на заказ — не на касание, — сразу после того,
+             * как разбор лёг в таблицу. Аргумент `$agent` несёт источник с
+             * наибольшей долей; полная раскладка мультитач-заказа едет в
+             * `$attribution['sources']`.
+             *
+             * Хук идёт ПОСЛЕ записи намеренно: слушатель, разбуженный до неё,
+             * прочитал бы таблицу без этого заказа и решил, что его нет.
+             *
+             * Гарантия слушателям (CLEAR-ATTR-15): A listener exception does not
+             * break checkout. The observer catches any `\Throwable`, writes one
+             * WooCommerce log line (level `warning`, source `clearwayforge`; see
+             * WooCommerce > Status > Logs) with the hook name, the exception class
+             * and the plugin folder (or file name) it came from, and nothing else
+             * (no message, order number, email or amounts), and the order goes
+             * through.
+             * The listeners after the failing one are not called on that call,
+             * because the exception stops `do_action()` for that firing. A
+             * listener must therefore be safe to skip and must not rely on being
+             * last; one that must not be skipped belongs first in the priority
+             * order or has to catch its own errors.
+             *
+             * @since 1.0.0
+             *
+             * @param int                 $order_id    Идентификатор заказа WooCommerce.
+             * @param string              $agent       Значение AiSource: 'chatgpt', 'perplexity'.
+             * @param array<string,mixed> $attribution Модель, валюта, суммы в целых
+             *                                         центах и раскладка по источникам.
+             */
+            // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- имя в константе: AiOrderEvent::HOOK = 'clearwayforge/ai_order', префикс на месте, но статически WPCS его не разворачивает
+            do_action(AiOrderEvent::HOOK, ...$event->hookArgs());
+        } catch (\Throwable $listenerError) {
+            /*
+             * Одна строка: имя хука, класс исключения и виновник — папка
+             * плагина, из файла которого оно прилетело (первый сегмент пути
+             * под WP_PLUGIN_DIR), иначе имя файла. Ни текста исключения
+             * (в нём чужой код может держать номер заказа или почту), ни
+             * аргументов хука, ни полного пути. Имя класса анонимного
+             * исключения (`RuntimeException@anonymous\0<файл>:<строка>$0`) —
+             * до байта NUL: после него идут полный путь и номер строки, а
+             * байту NUL в строке лога не место.
+             *
+             * Строка идёт в журнал WooCommerce (WooCommerce > Status > Logs,
+             * источник `clearwayforge`), а не в error_log: в пакет wordpress.org
+             * вызовы error_log не попадают. Без WooCommerce заказов нет, и
+             * писать нечего.
+             */
+            if (function_exists('wc_get_logger')) {
+                try {
+                    wc_get_logger()->warning(
+                        sprintf(
+                            '[clearwayforge] a listener on %s threw %s in %s; the order was not affected.',
+                            AiOrderEvent::HOOK,
+                            explode("\0", $listenerError::class, 2)[0],
+                            self::listenerSource($listenerError->getFile(), defined('WP_PLUGIN_DIR') ? (string) constant('WP_PLUGIN_DIR') : null)
+                        ),
+                        ['source' => 'clearwayforge']
+                    );
+                } catch (\Throwable) {
+                    // Сломанный обработчик журнала (WooCommerce даёт их добавлять другим плагинам) не отменяет гарантию выше: заказ всё равно проходит.
+                }
+            }
+        }
+    }
+
+    /**
+     * Кто бросил исключение, для строки лога: имя папки плагина, если файл
+     * лежит под каталогом плагинов (первый сегмент пути после него; плагин из
+     * одного файла — имя этого файла), иначе имя файла. Каталог плагинов
+     * проверяется и как задан, и по `realpath()`: он может быть символической
+     * ссылкой, а PHP отдаёт путь файла уже раскрытым. Полный путь в лог не
+     * попадает.
+     *
+     * @internal Открыт только ради теста.
+     */
+    public static function listenerSource(string $file, ?string $pluginDir): string
+    {
+        $file = str_replace('\\', '/', $file);
+
+        $roots = [];
+        if ($pluginDir !== null && $pluginDir !== '') {
+            $roots[] = $pluginDir;
+            $real = realpath($pluginDir);
+            if ($real !== false) {
+                $roots[] = $real;
+            }
+        }
+
+        foreach ($roots as $root) {
+            $root = rtrim(str_replace('\\', '/', $root), '/') . '/';
+            if (strpos($file, $root) !== 0) {
+                continue;
+            }
+            $first = explode('/', substr($file, strlen($root)), 2)[0];
+            if ($first !== '') {
+                return $first;
+            }
+        }
+
+        return basename($file);
     }
 

clearwayforge/trunk/src/Infra/Collect/VisitCollector.php

@@ -153 +153 @@
      * Адрес для проверки сети краулера.
      *
-     * Читается только `REMOTE_ADDR`: заголовки вроде `X-Forwarded-For`
-     * подделываются кем угодно, и поверить им означало бы дать любому
-     * скраперу способ объявить себя проверенным GPTBot одной строкой. За
-     * обратным прокси адрес будет неверным — и тогда классификатор честно
-     * скажет `declared` вместо `verified`, что лучше, чем ложное `verified`.
+     * Читается `REMOTE_ADDR`, а заголовки прокси (`X-Forwarded-For`) — только
+     * если владелец назвал доверенные прокси в настройках, и по правилам
+     * `RequestAddress`. Без списка заголовок не читается никогда:
+     * подделываемый кем угодно, он давал бы любому скраперу способ объявить
+     * себя проверенным GPTBot одной строкой. За обратным прокси без списка
+     * адрес будет неверным — и классификатор честно скажет `declared` вместо
+     * `verified`, что лучше, чем ложное `verified`.
      */
     private function trustedAddress(): ?string
     {
-        if (!isset($_SERVER['REMOTE_ADDR']) || !is_string($_SERVER['REMOTE_ADDR'])) {
-            return null;
-        }
-
-        $address = sanitize_text_field(wp_unslash($_SERVER['REMOTE_ADDR']));
-
-        return $address === '' ? null : $address;
+        return RequestAddress::fromServer($_SERVER);
     }
 

clearwayforge/trunk/src/Infra/Db/Schema.php

@@ -36 +36 @@
      * Версия схемы. Инкрементируется при любом изменении определений ниже;
      * `Migrator` сравнивает её с сохранённой и решает, звать ли `dbDelta`.
+     *
+     * 2 — `touches.refunded_cents` (BUG-CLEAR-MISC-01, п. 14): возврат по
+     * заказу хранится рядом с суммой доли, отчёты вычитают его при чтении.
      */
-    public const VERSION = 1;
+    public const VERSION = 2;
 
     /** Общий префикс таблиц плагина поверх префикса WordPress. */
@@ -115 +118 @@
              * сменить, и старые отчёты обязаны остаться такими, какими он их
              * видел, иначе выручка прошлого месяца меняется задним числом.
+             *
+             * `refunded_cents` — доля возврата, пришедшаяся на эту строку
+             * (`TouchRepository::setOrderRefund()`). Сумма доли остаётся
+             * как была, отчёты вычитают возврат при чтении: возврат уменьшает
+             * заказ, к которому сделан, в периоде самого заказа.
              */
             'touches' => "CREATE TABLE {$p}touches (
@@ -125 +133 @@
   model VARCHAR(16) NOT NULL DEFAULT 'last',
   amount_cents BIGINT(20) NOT NULL DEFAULT 0,
+  refunded_cents BIGINT(20) NOT NULL DEFAULT 0,
   currency CHAR(3) NOT NULL DEFAULT 'USD',
   captured_ms BIGINT(20) UNSIGNED NOT NULL,

clearwayforge/trunk/src/Infra/Health/HealthReport.php

@@ -107 +107 @@
             [
                 'label' => 'Site timezone',
-                'problem' => (wp_timezone_string() === 'UTC' && get_option('gmt_offset') === '0')
-                    ? 'The site timezone is UTC. Daily figures will be grouped in UTC, not in your local day.'
-                    : null,
+                'problem' => self::timezoneProblem(wp_timezone_string(), get_option('gmt_offset')),
             ],
         ];
+    }
+
+    /**
+     * Предупреждение о поясе UTC — или `null`, если сайт считает сутки по местному поясу.
+     *
+     * Смещение сравнивается числом, а не строкой: на сайте с поясом по названию ядро
+     * отвечает на `get_option('gmt_offset')` через `pre_option_gmt_offset` и отдаёт
+     * `float 0.0`, а не `'0'`, и строгое сравнение со строкой скрывало предупреждение
+     * на каждом таком сайте (BUG-CLEAR-DASH-01).
+     *
+     * @param mixed $gmtOffset Значение `get_option('gmt_offset')`: число, строка или `false`.
+     */
+    public static function timezoneProblem(string $timezone, mixed $gmtOffset): ?string
+    {
+        $offset = is_int($gmtOffset) || is_float($gmtOffset) || is_string($gmtOffset) ? (float) $gmtOffset : 0.0;
+
+        return $timezone === 'UTC' && $offset === 0.0
+            ? 'The site timezone is UTC. Daily figures will be grouped in UTC, not in your local day.'
+            : null;
     }
 

clearwayforge/trunk/src/Infra/Llms/LlmsRoutes.php

@@ -16 +16 @@
  * кеша каждый заход бота собирал бы полный список категорий и товаров —
  * несколько запросов к базе на каждый из тысяч заходов в сутки.
+ *
+ * Страничные кеши плагинов (WP Super Cache, LiteSpeed Cache и другие)
+ * документ не держат, а всё, что стоит перед сайтом, держит его
+ * `DocumentCaching::MAX_AGE_SECONDS` (15 минут, как `catalog.json`). Чужие
+ * кеши мы не чистим (NEIGH-04).
  */
 
@@ -23 +28 @@
 
 use ClearwayForge\Domain\Llms\LlmsGenerator;
+use ClearwayForge\Infra\Pro\Bridge;
 use ClearwayForge\Infra\Support\Options;
 
@@ -34 +40 @@
      *
      * Число в конце ключа — версия того, как собирается документ. Меняется
-     * сборка — меняется число: иначе обновлённый сайт до шести часов отдаёт
+     * сборка — меняется число: иначе обновлённый сайт до пятнадцати минут отдаёт
      * текст, собранный прошлой версией, а сторож дрейфа принимает разницу
      * между старым кешем и новой сборкой за изменение каталога. 2 — 1.0.2:
-     * цены и названия без HTML-сущностей.
-     */
-    public const CACHE_MAP = 'cwforge_llms_map_2';
-    public const CACHE_FULL = 'cwforge_llms_full_2';
-    public const CACHE_TTL = 6 * HOUR_IN_SECONDS;
+     * цены и названия без HTML-сущностей. 3 — полная выгрузка грузит до
+     * `LlmsGenerator::FULL_PRODUCT_LIMIT` товаров, а обе пишут «Showing N of
+     * M products», когда каталог больше окна (BUG-CLEAR-MISC-01). 4 (только
+     * полная выгрузка) — она называет адрес машинного фида, когда магазин его
+     * отдаёт, и без обрезки (BUG-CLEAR-LLMS-02).
+     */
+    public const CACHE_MAP = 'cwforge_llms_map_3';
+    public const CACHE_FULL = 'cwforge_llms_full_4';
+
+    /**
+     * Серверный кеш живёт столько же, сколько документ обещает всем, кто стоит
+     * перед сайтом: одна константа `DocumentCaching::MAX_AGE_SECONDS` (900 с)
+     * на `llms.txt`, `llms-full.txt` и `catalog.json`. Сохранение товара кеш
+     * сбрасывает сразу (`invalidate()`), срок — страховка от правок мимо
+     * сохранения (импорт, прямая запись в базу).
+     */
+    public const CACHE_TTL = DocumentCaching::MAX_AGE_SECONDS;
+
+    /**
+     * Хук аддона: набор платных возможностей изменился (активация, окончание,
+     * освобождение лицензии). Ядро о лицензиях не знает и только сбрасывает кеш.
+     */
+    public const PAID_FEATURES_CHANGED = 'cwforge_paid_features_changed';
 
     /** Ключи прошлых версий сборки: их чистит удаление плагина. */
-    public const RETIRED_CACHE_KEYS = ['cwforge_llms_map', 'cwforge_llms_full'];
+    public const RETIRED_CACHE_KEYS = [
+        'cwforge_llms_map',
+        'cwforge_llms_full',
+        'cwforge_llms_map_2',
+        'cwforge_llms_full_2',
+        'cwforge_llms_full_3',
+    ];
 
     public function register(): void
@@ -53 +83 @@
         add_action('woocommerce_update_product', [$this, 'invalidate']);
         add_action('update_option_' . Options::NAME, [$this, 'invalidate']);
+        // Строка про машинный фид зависит от лицензии аддона (`feedUrl()`): аддон сообщает
+        // об изменении набора платных возможностей, и документ собирается заново.
+        add_action(self::PAID_FEATURES_CHANGED, [$this, 'invalidate']);
     }
 
@@ -66 +99 @@
             $path = (string) (wp_parse_url($requestUri, PHP_URL_PATH) ?? '/');
         }
-        $path = '/' . ltrim($path, '/');
+        // Дочерний сайт мультисайта с подпапками живёт по `/sub/`, и его документ — `/sub/llms.txt`
+        // (BUG-CLEAR-LLMS-01): путь главной страницы этого сайта снимается до сравнения.
+        $homePath = (string) (wp_parse_url(home_url('/'), PHP_URL_PATH) ?? '/');
+
+        $document = self::documentFor($path, $homePath);
+        if ($document === 'map') {
+            $this->serve(self::CACHE_MAP, false);
+        }
+        if ($document === 'full') {
+            $this->serve(self::CACHE_FULL, true);
+        }
+    }
+
+    /**
+     * Какой документ просит этот путь: `map` (`llms.txt`), `full` (`llms-full.txt`) или `null`.
+     *
+     * Сравнение точное: ни регистра, ни косой черты в конце, ни вложенных папок. Корневой
+     * `/llms.txt` для сайта с home `/sub/` — документ корневого сайта, а не этого; каталог
+     * корня ему не подставляется.
+     *
+     * @param string $requestPath Путь запроса, как пришёл (`/sub/llms.txt`).
+     * @param string $homePath    Путь главной страницы этого сайта: `/` или `/sub/` на мультисайте с подпапками.
+     */
+    public static function documentFor(string $requestPath, string $homePath): ?string
+    {
+        $path = '/' . ltrim($requestPath, '/');
+        $home = rtrim('/' . ltrim($homePath, '/'), '/');
+
+        if ($home !== '') {
+            if (strpos($path, $home . '/') !== 0) {
+                return null;
+            }
+            $path = substr($path, strlen($home));
+        }
 
         if ($path === '/llms.txt') {
-            $this->serve(self::CACHE_MAP, false);
+            return 'map';
         }
         if ($path === '/llms-full.txt') {
-            $this->serve(self::CACHE_FULL, true);
-        }
+            return 'full';
+        }
+
+        return null;
+    }
+
+    /**
+     * Строки заголовков ответа: тип, длина, запрет угадывания типа и срок жизни.
+     *
+     * Отдельным методом, чтобы заголовки проверялись без вывода и `exit`.
+     * Срок свежести и отказ страничным кешам берутся из `DocumentCaching`:
+     * число одно с `catalog.json` платного аддона.
+     *
+     * @return list<string>
+     */
+    public static function responseHeaders(int $length): array
+    {
+        return [
+            'Content-Type: text/plain; charset=utf-8',
+            'Content-Length: ' . $length,
+            'X-Robots-Tag: noindex',
+            // Без этого браузер вправе «угадать» HTML в тексте из названий товаров; с ним вывод остаётся текстом.
+            'X-Content-Type-Options: nosniff',
+            'Cache-Control: ' . DocumentCaching::cacheControl(),
+            DocumentCaching::LITESPEED_HEADER . ': ' . DocumentCaching::liteSpeedControl(),
+        ];
+    }
+
+    /**
+     * Положить собранный документ в серверный кеш на `CACHE_TTL`.
+     *
+     * Отдельным методом, чтобы срок проверялся без вывода и `exit`.
+     */
+    public static function remember(string $cacheKey, string $body): void
+    {
+        set_transient($cacheKey, $body, self::CACHE_TTL);
     }
 
@@ -80 +180 @@
         $body = get_transient($cacheKey);
         if (!is_string($body) || $body === '') {
-            $store = (new StoreProfileBuilder())->build();
-            $generator = new LlmsGenerator(max(1, Options::int('llms_product_limit', 50)));
+            $store = (new StoreProfileBuilder())->build($full);
+            $generator = new LlmsGenerator(max(1, Options::int('llms_product_limit', LlmsGenerator::MAP_PRODUCT_LIMIT)));
             $document = $full
-                ? $generator->full($store)
-                : $generator->map($store, rest_url('cwforge/v1/catalog.json'));
+                ? $generator->full($store, self::feedUrl())
+                : $generator->map($store, self::feedUrl());
             $body = $document->render();
-            set_transient($cacheKey, $body, self::CACHE_TTL);
+            self::remember($cacheKey, $body);
         }
 
         // Заголовки ставятся до вывода и включают длину: бот, читающий поток
         // без длины, не может отличить обрыв соединения от конца документа.
-        header('Content-Type: text/plain; charset=utf-8');
-        header('Content-Length: ' . strlen($body));
-        header('X-Robots-Tag: noindex');
-        // Без этого браузер вправе «угадать» HTML в тексте из названий товаров; с ним вывод остаётся текстом.
-        header('X-Content-Type-Options: nosniff');
-        header('Cache-Control: public, max-age=3600');
+        foreach (self::responseHeaders(strlen($body)) as $line) {
+            header($line);
+        }
+        // Страничные кеши плагинов документ не держат; свежесть для всего, что стоит перед сайтом, — наша (DocumentCaching).
+        DocumentCaching::excludeFromPageCaches();
 
         echo $body; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- ответ text/plain с nosniff: HTML-экранирование исказило бы документ для агентов.
@@ -102 +201 @@
     }
 
+    /**
+     * Адрес машинного фида — только если этот магазин его отдаёт.
+     *
+     * Фид живёт в платном аддоне и закрыт без лицензии. Строка «полный
+     * каталог — по такому-то адресу», ведущая на отказ, хуже её отсутствия.
+     */
+    private static function feedUrl(): ?string
+    {
+        return Bridge::instance()->isEnabled('catalog-feed') ? rest_url('cwforge/v1/catalog.json') : null;
+    }
+
     public function invalidate(): void
     {

clearwayforge/trunk/src/Infra/Llms/StoreProfileBuilder.php

@@ -25 +25 @@
 namespace ClearwayForge\Infra\Llms;
 
+use ClearwayForge\Domain\Llms\LlmsGenerator;
 use ClearwayForge\Domain\Llms\LlmsLink;
 use ClearwayForge\Domain\Llms\PlainText;
@@ -34 +35 @@
 final class StoreProfileBuilder
 {
-    public function build(): StoreProfile
-    {
+    /**
+     * @param bool $full Профиль для `/llms-full.txt`: товаров грузится больше
+     *                   (`LlmsGenerator::fetchLimit()`), а общее число уходит в документ.
+     */
+    public function build(bool $full = false): StoreProfile
+    {
+        [$products, $total] = $this->products($full);
+
         return new StoreProfile(
             name: PlainText::fromHtml(get_bloginfo('name')),
@@ -41 +48 @@
             description: PlainText::fromHtml(get_bloginfo('description')),
             categories: $this->categories(),
-            products: $this->products(),
+            products: $products,
             policies: $this->policies(),
             pages: $this->pages(),
@@ -47 +54 @@
             shippingNote: $this->shippingNote(),
             returnsNote: null,
+            productsTotal: $total,
         );
     }
@@ -84 +92 @@
     }
 
-    /** @return list<LlmsLink> */
-    private function products(): array
-    {
-        $limit = max(1, Options::int('llms_product_limit', 50));
-
-        $products = wc_get_products([
+    /** @return array{0:list<LlmsLink>,1:?int} Товары окна и сколько их в каталоге всего. */
+    private function products(bool $full): array
+    {
+        $limit = LlmsGenerator::fetchLimit($full, Options::int('llms_product_limit', LlmsGenerator::MAP_PRODUCT_LIMIT));
+
+        // Один товар на группу переводов, как в catalog.json (NEIGH-07): `ProductTranslations` — единственное место правила.
+        $result = ProductTranslations::products([
             'status' => 'publish',
             'limit' => $limit,
@@ -95 +104 @@
             'order' => 'DESC',
             'visibility' => 'catalog',
+            'paginate' => true,
         ]);
 
+        // С `paginate` WooCommerce отдаёт объект с `products` и `total`; без
+        // него (старые версии, чужие фильтры) — просто список.
+        $total = null;
+        $products = $result;
+        if (is_object($result)) {
+            $products = $result->products ?? [];
+            $total = isset($result->total) ? (int) $result->total : null;
+        }
+
         if (!is_array($products)) {
-            return [];
+            return [[], null];
         }
 
@@ -113 +132 @@
         }
 
-        return $links;
+        return [$links, $total];
     }
 

clearwayforge/trunk/src/Infra/Report/DashboardAssembler.php

@@ -25 +25 @@
  * ── Что здесь НЕ происходит ──────────────────────────────────────────────
  *
+ * Возвраты (BUG-CLEAR-MISC-01, п. 14): сумма доли хранится как была, а
+ * возврат по заказу лежит рядом (`refunded_cents`) и приходит в `Allocation`.
+ * Отчёт показывает выручку за вычетом возвратов в периоде самого заказа,
+ * а сумму возвратов — отдельным числом; здесь возврат только передаётся
+ * дальше, вычитает его `DashboardBuilder`.
+ *
  * Пересчёта атрибуции нет: суммы посчитаны в момент заказа и сохранены.
  * Пересчитать их сейчас значило бы применить сегодняшнюю модель к прошлому
  * месяцу и показать владельцу не ту выручку, которую он видел вчера.
+ *
+ * Тем более текущая модель не отбирает строки: заказ читается под той
+ * моделью, под которой записан (`TouchRepository::inWindow()`), и после
+ * смены настройки старые заказы остаются в отчёте (BUG-CLEAR-ATTR-01).
+ * Поэтому `$model` в `assemble()` — не фильтр, а запасное значение для
+ * строки, записанной моделью, которой эта версия не знает.
  */
 
@@ -62 +74 @@
     }
 
-    public function assemble(ReportWindow $window, AttributionModel $model, string $currency): DashboardReport
-    {
+    /**
+     * @param int|null $minorUnit Знаков после запятой у записанных сумм. Без
+     *                            указания — настройка магазина, та же, что
+     *                            читала запись заказа (BUG-CLEAR-ATTR-02).
+     */
+    public function assemble(
+        ReportWindow $window,
+        AttributionModel $model,
+        string $currency,
+        ?int $minorUnit = null
+    ): DashboardReport {
         return (new DashboardBuilder())->build(
             $window,
@@ -70 +91 @@
             $this->crawlerRows($window),
             $currency,
+            $minorUnit ?? StoreMinorUnit::current(),
         );
     }
@@ -81 +103 @@
     {
         $byOrder = [];
-        foreach ($this->touches->inWindow($fromMs, $toMs, $model->value) as $row) {
+        foreach ($this->touches->inWindow($fromMs, $toMs) as $row) {
             $source = AiSource::tryFrom($row['source']);
             $via = RecoveredVia::tryFrom($row['recovered_via']);
@@ -99 +121 @@
             $byOrder[$row['order_id']]['at'] = $row['captured_ms'];
             $byOrder[$row['order_id']]['currency'] = $row['currency'];
+            $byOrder[$row['order_id']]['model'] = AttributionModel::tryFrom($row['model']) ?? $model;
             $byOrder[$row['order_id']]['allocations'][] = new Allocation(
                 $touch,
                 Money::fromCents($row['amount_cents'], $row['currency']),
-                1
+                1,
+                $row['refunded_cents']
             );
         }
@@ -115 +139 @@
                 (int) $orderId,
                 (int) $data['at'],
-                new AttributionResult($model, $data['allocations'], $total)
+                new AttributionResult($data['model'], $data['allocations'], $total)
             );
         }

clearwayforge/trunk/src/Infra/Repository/TouchRepository.php

@@ -7 +7 @@
  * модель атрибуции, и отчёт за прошлый месяц обязан остаться таким, каким он
  * его видел. Выручка, меняющаяся задним числом, обесценивает весь дашборд.
+ *
+ * Отсюда правило чтения (BUG-CLEAR-ATTR-01): заказ считается той моделью, под
+ * которой он записан первой, и текущая настройка модели строки не отбирает.
+ * Смена модели действует на заказы с момента смены (`OrderObserver` пишет их
+ * под новой), а прежние заказы остаются в дашборде, Revenue by agent, CSV и
+ * дайджесте с теми же суммами. Если у заказа есть строки под двумя моделями
+ * (повторный разбор), читается набор первой записанной: иначе заказ
+ * посчитался бы дважды.
  */
 
@@ -31 +39 @@
 
 use ClearwayForge\Domain\Attribution\AttributionResult;
+use ClearwayForge\Domain\Report\RefundSplit;
 use ClearwayForge\Infra\Db\Schema;
 
@@ -88 +97 @@
 
     /**
-     * Разобранные заказы окна.
+     * Разобранные заказы окна — каждый под моделью, с которой он записан.
+     *
+     * Подзапрос берёт модель самой ранней строки заказа (`id` растёт со
+     * вставкой), так что повторный разбор под другой моделью выручку не
+     * удваивает и не подменяет. Уникальный ключ (order_id, source, model)
+     * ведёт подзапрос по префиксу `order_id`.
+     *
+     * `refunded_cents` — доля возврата, пришедшаяся на строку; отчёт вычитает
+     * её из суммы строки в периоде самого заказа (BUG-CLEAR-MISC-01, п. 14).
      *
      * @return list<array{order_id:int,source:string,recovered_via:string,confidence:int,
-     *                    amount_cents:int,currency:string,captured_ms:int,model:string}>
-     */
-    public function inWindow(int $fromMs, int $toMs, string $model): array
+     *                    amount_cents:int,refunded_cents:int,currency:string,captured_ms:int,model:string}>
+     */
+    public function inWindow(int $fromMs, int $toMs): array
     {
         global $wpdb;
@@ -100 +117 @@
         $rows = $wpdb->get_results(
             $wpdb->prepare(
-                'SELECT order_id, source, recovered_via, confidence, amount_cents, currency, captured_ms, model
-                 FROM %i
-                 WHERE captured_ms >= %d AND captured_ms <= %d AND model = %s
-                 ORDER BY captured_ms ASC',
+                'SELECT t.order_id, t.source, t.recovered_via, t.confidence, t.amount_cents,
+                        t.refunded_cents, t.currency, t.captured_ms, t.model
+                 FROM %i t
+                 WHERE t.captured_ms >= %d AND t.captured_ms <= %d
+                   AND t.model = (
+                       SELECT h.model FROM %i h
+                       WHERE h.order_id = t.order_id
+                       ORDER BY h.id ASC
+                       LIMIT 1
+                   )
+                 ORDER BY t.captured_ms ASC, t.id ASC',
                 $table,
                 $fromMs,
                 $toMs,
-                $model
+                $table
             ),
             ARRAY_A
@@ -123 +147 @@
                 'confidence' => (int) $r['confidence'],
                 'amount_cents' => (int) $r['amount_cents'],
+                'refunded_cents' => (int) $r['refunded_cents'],
                 'currency' => (string) $r['currency'],
                 'captured_ms' => (int) $r['captured_ms'],
@@ -131 +156 @@
     }
 
+    /** Есть ли у заказа разбор: дёшево отсекает возвраты по заказам, которых мы не считали. */
+    public function hasOrder(int $orderId): bool
+    {
+        global $wpdb;
+
+        $table = Schema::table($this->wpPrefix, 'touches');
+
+        return $wpdb->get_var($wpdb->prepare('SELECT 1 FROM %i WHERE order_id = %d LIMIT 1', $table, $orderId)) !== null;
+    }
+
+    /**
+     * Записать, сколько по заказу возвращено всего (BUG-CLEAR-MISC-01, п. 14).
+     *
+     * Принимает итог, а не приращение: WooCommerce отвечает «возвращено по
+     * заказу столько», и повторный вызов с тем же числом, удаление возврата и
+     * новый частичный возврат дают верный результат без учёта порядка событий.
+     * Итог делится между строками заказа пропорционально их суммам
+     * (`RefundSplit`) и ложится в те строки, что читает `inWindow()` —
+     * записанные под первой моделью заказа.
+     *
+     * @return int Сколько строк заказа обновлено; 0 — разбора у заказа нет.
+     */
+    public function setOrderRefund(int $orderId, int $refundedCents): int
+    {
+        global $wpdb;
+
+        $table = Schema::table($this->wpPrefix, 'touches');
+        $rows = $wpdb->get_results(
+            $wpdb->prepare(
+                'SELECT t.id, t.amount_cents
+                 FROM %i t
+                 WHERE t.order_id = %d
+                   AND t.model = (
+                       SELECT h.model FROM %i h
+                       WHERE h.order_id = t.order_id
+                       ORDER BY h.id ASC
+                       LIMIT 1
+                   )
+                 ORDER BY t.id ASC',
+                $table,
+                $orderId,
+                $table
+            ),
+            ARRAY_A
+        );
+
+        if (!is_array($rows) || $rows === []) {
+            return 0;
+        }
+
+        $parts = RefundSplit::apportion(
+            $refundedCents,
+            array_values(array_map(static fn (array $r): int => (int) $r['amount_cents'], $rows))
+        );
+
+        foreach (array_values($rows) as $i => $row) {
+            $wpdb->query(
+                $wpdb->prepare(
+                    'UPDATE %i SET refunded_cents = %d WHERE id = %d',
+                    $table,
+                    $parts[$i],
+                    (int) $row['id']
+                )
+            );
+        }
+
+        return count($rows);
+    }
+
+    /**
+     * Следующая пачка различных заказов с разбором, по возрастанию номера.
+     *
+     * Курсором служит сам номер заказа: «всё, что больше последнего
+     * обработанного». Ключ `(order_id, source, model)` отдаёт такую выборку
+     * без сортировки по таблице целиком (досчёт возвратов, п. 14).
+     *
+     * @return list<int>
+     */
+    public function orderIdsAfter(int $afterOrderId, int $limit): array
+    {
+        global $wpdb;
+
+        $table = Schema::table($this->wpPrefix, 'touches');
+        $ids = $wpdb->get_col(
+            $wpdb->prepare(
+                'SELECT DISTINCT order_id FROM %i WHERE order_id > %d ORDER BY order_id ASC LIMIT %d',
+                $table,
+                $afterOrderId,
+                max(1, $limit)
+            )
+        );
+
+        return is_array($ids) ? array_values(array_map('intval', $ids)) : [];
+    }
+
     public function deleteOrder(int $orderId): int
     {

clearwayforge/trunk/src/Infra/Rest/Routes.php

@@ -132 +132 @@
                             'required' => false,
                         ),
+                        'trusted_proxies'        => array(
+                            'type'     => 'string',
+                            'required' => false,
+                        ),
                         'delete_data_on_uninstall' => array(
                             'type'     => 'boolean',

clearwayforge/trunk/src/Infra/Rest/SettingsController.php

@@ -26 +26 @@
 
 use ClearwayForge\Domain\Attribution\AttributionModel;
+use ClearwayForge\Domain\Crawler\TrustedProxies;
 use ClearwayForge\Infra\Scheduler\CrawlerRangeSources;
 use ClearwayForge\Infra\Scheduler\Maintenance;
@@ -74 +75 @@
         }
 
+        /*
+         * Доверенные прокси (BUG-CLEAR-MISC-01, п. 10): от списка зависит, чьему
+         * слову об адресе верит проверка краулеров. Запись, не являющаяся
+         * адресом или сетью, отбрасывается, остальные сохраняются; отброшенные
+         * возвращаются в ответе по имени (`trusted_proxies_rejected`), чтобы
+         * опечатка не осталась незамеченной. Пустая строка очищает список — и
+         * заголовки прокси снова не читаются.
+         */
+        $rejectedProxies = [];
+        $overLimitProxies = 0;
+        if ($request->get_param('trusted_proxies') !== null) {
+            if (!current_user_can('manage_options')) {
+                // Список решает, чьему заголовку верить, — это доверие к сети, а
+                // не настройка отчётов: менеджеру магазина (`manage_woocommerce`)
+                // оно не принадлежит. Отказ до любой записи, как у удаления данных.
+                return new WP_REST_Response(
+                    ['code' => 'cwforge_forbidden', 'message' => 'Only an administrator can change the trusted proxies.'],
+                    403
+                );
+            }
+
+            $proxies = TrustedProxies::fromText((string) $request->get_param('trusted_proxies'));
+            $values['trusted_proxies'] = $proxies->cidrs();
+            $rejectedProxies = $proxies->rejected();
+            $overLimitProxies = count($proxies->overLimit());
+        }
+
         $deleteOnUninstall = $request->get_param('delete_data_on_uninstall');
         if ($deleteOnUninstall !== null && !current_user_can('delete_plugins')) {
@@ -96 +124 @@
         }
 
-        return new WP_REST_Response(self::payload(), 200);
+        return new WP_REST_Response(self::payload($rejectedProxies, $overLimitProxies), 200);
     }
 
     /**
+     * @param list<string> $rejectedProxies Записи списка прокси, отброшенные в этом запросе как «не адрес».
+     * @param int $overLimitProxies Сколько годных записей не поместилось в потолок списка в этом запросе.
      * @return array{
      *     show_estimated_revenue:bool,
@@ -106 +136 @@
      *     crawler_ranges_refresh:bool,
      *     crawler_ranges_hosts:list<string>,
+     *     trusted_proxies:string,
+     *     trusted_proxies_rejected:list<string>,
+     *     trusted_proxies_over_limit:int,
+     *     trusted_proxies_limit:int,
+     *     can_change_proxies:bool,
      *     delete_data_on_uninstall:bool,
      *     can_change_uninstall:bool
      * }
      */
-    private static function payload(): array
+    private static function payload(array $rejectedProxies = [], int $overLimitProxies = 0): array
     {
         $current = AttributionModel::tryFrom(Options::string('attribution_model', 'last')) ?? AttributionModel::LastTouch;
@@ -125 +160 @@
             // не из текста: согласие даётся на то, что реально произойдёт.
             'crawler_ranges_hosts'     => self::hosts((new CrawlerRangeSources())->all()),
+            // Список как текст для поля ввода: по записи на строку.
+            'trusted_proxies'          => implode("\n", TrustedProxies::fromStored(Options::get('trusted_proxies', array()))->cidrs()),
+            // Что не прошло при последнем сохранении; на чтении всегда пусто.
+            'trusted_proxies_rejected' => $rejectedProxies,
+            // Годные записи сверх потолка: считаются отдельно, на чтении всегда 0.
+            'trusted_proxies_over_limit' => $overLimitProxies,
+            'trusted_proxies_limit'    => TrustedProxies::MAX,
+            'can_change_proxies'       => current_user_can('manage_options'),
             'delete_data_on_uninstall' => get_option(Options::DELETE_ON_UNINSTALL) === 'yes',
             'can_change_uninstall'     => current_user_can('delete_plugins'),

clearwayforge/trunk/src/Infra/Scheduler/Maintenance.php

@@ -36 +36 @@
     public const GROUP = 'clearwayforge';
 
+    /** Метка «очередь проверена»: самолечение не чаще раза в окно, а не на каждый запрос админки. */
+    public const SCHEDULE_CHECKED = 'cwforge_schedule_checked';
+
     /** Скачанные сети вендоров. */
     public const RANGES_OPTION = 'cwforge_crawler_ranges';
@@ -54 +57 @@
         add_action(self::HOOK_PURGE, [$this, 'purge']);
         add_action(self::HOOK_RANGES, [$this, 'refreshRanges']);
+        // Только запросы админки: на витрине лишний вопрос к очереди — это
+        // накладные расходы на каждом хите покупателя (принцип 1 в AGENTS.md).
+        add_action('admin_init', [self::class, 'ensureScheduled']);
+    }
+
+    /**
+     * Вернуть уборку в очередь, если активация её не поставила.
+     *
+     * `scheduleAll()` зовёт только активация, а плагин попадает на сайт и
+     * без неё: обновление по FTP, перенос базы без таблиц Action Scheduler,
+     * очередь, вычищенная чужим инструментом, Action Scheduler, которого не
+     * было при активации. Без задачи `cwforge_purge_old_data` срок хранения
+     * (`retention_days`) тихо перестаёт действовать, и таблицы растут. Ту же
+     * оговорку про FTP несёт `Migrator::migrateIfNeeded()` в `Plugin::wire()`.
+     *
+     * Метка «проверено» ставится только когда очередь доступна: иначе одна
+     * неудачная попытка отключила бы самолечение на всё окно.
+     */
+    public static function ensureScheduled(): void
+    {
+        if (!function_exists('as_next_scheduled_action')) {
+            return;
+        }
+
+        if (get_transient(self::SCHEDULE_CHECKED) !== false) {
+            return;
+        }
+
+        set_transient(self::SCHEDULE_CHECKED, 1, 12 * HOUR_IN_SECONDS);
+        self::scheduleAll();
     }
 
@@ -81 +114 @@
 
         as_unschedule_all_actions(self::HOOK_PURGE, [], self::GROUP);
+        // Досчёт возвратов: поставленная пачка не должна пережить плагин (п. 14).
+        as_unschedule_all_actions(\ClearwayForge\Infra\Attribution\RefundBackfill::HOOK, [], self::GROUP);
         self::unscheduleRanges();
     }

clearwayforge/trunk/uninstall.php

@@ -39 +39 @@
             \ClearwayForge\Infra\Support\Options::NAME,
             \ClearwayForge\Infra\Scheduler\Maintenance::RANGES_OPTION,
-            \ClearwayForge\Infra\Support\Options::DELETE_ON_UNINSTALL,
+            \ClearwayForge\Infra\Attribution\RefundBackfill::OPTION,
         ] as $cwforge_option
     ) {
@@ -45 +45 @@
     }
 
+    /*
+     * Согласие владельца общее для Free и платного аддона: надпись на экране
+     * настроек — «Delete all Clearway Forge data». Пока на сайте остались
+     * данные аддона (его метка версии схемы), флаг остаётся, иначе аддон,
+     * удаляемый вторым, не найдёт согласия и оставит свои таблицы
+     * (BUG-CLEAR-MISC-01). Аддон уберёт флаг сам, когда уйдёт последним.
+     */
+    if (get_option('cwforge_pro_schema_version', null) === null) {
+        delete_option(\ClearwayForge\Infra\Support\Options::DELETE_ON_UNINSTALL);
+    }
+
+    delete_transient(\ClearwayForge\Infra\Scheduler\Maintenance::SCHEDULE_CHECKED);
     delete_transient(\ClearwayForge\Infra\Llms\LlmsRoutes::CACHE_MAP);
     delete_transient(\ClearwayForge\Infra\Llms\LlmsRoutes::CACHE_FULL);

clearwayforge/trunk/vendor/composer/autoload_classmap.php

@@ -25 +25 @@
     'ClearwayForge\\Domain\\Attribution\\SourceDetector' => $baseDir . '/src/Domain/Attribution/SourceDetector.php',
     'ClearwayForge\\Domain\\Attribution\\Touch' => $baseDir . '/src/Domain/Attribution/Touch.php',
+    'ClearwayForge\\Domain\\Crawler\\ClientAddress' => $baseDir . '/src/Domain/Crawler/ClientAddress.php',
     'ClearwayForge\\Domain\\Crawler\\CrawlerClassifier' => $baseDir . '/src/Domain/Crawler/CrawlerClassifier.php',
     'ClearwayForge\\Domain\\Crawler\\CrawlerCorpus' => $baseDir . '/src/Domain/Crawler/CrawlerCorpus.php',
@@ -31 +32 @@
     'ClearwayForge\\Domain\\Crawler\\CrawlerKind' => $baseDir . '/src/Domain/Crawler/CrawlerKind.php',
     'ClearwayForge\\Domain\\Crawler\\IpRange' => $baseDir . '/src/Domain/Crawler/IpRange.php',
+    'ClearwayForge\\Domain\\Crawler\\TrustedProxies' => $baseDir . '/src/Domain/Crawler/TrustedProxies.php',
     'ClearwayForge\\Domain\\Crawler\\Verification' => $baseDir . '/src/Domain/Crawler/Verification.php',
     'ClearwayForge\\Domain\\Llms\\LlmsBlock' => $baseDir . '/src/Domain/Llms/LlmsBlock.php',
@@ -52 +54 @@
     'ClearwayForge\\Domain\\Report\\MoneyText' => $baseDir . '/src/Domain/Report/MoneyText.php',
     'ClearwayForge\\Domain\\Report\\PeriodSelector' => $baseDir . '/src/Domain/Report/PeriodSelector.php',
+    'ClearwayForge\\Domain\\Report\\RefundSplit' => $baseDir . '/src/Domain/Report/RefundSplit.php',
     'ClearwayForge\\Domain\\Report\\ReportWindow' => $baseDir . '/src/Domain/Report/ReportWindow.php',
     'ClearwayForge\\Domain\\Report\\SourceRow' => $baseDir . '/src/Domain/Report/SourceRow.php',
@@ -63 +66 @@
     'ClearwayForge\\Infra\\Attribution\\OrderMeta' => $baseDir . '/src/Infra/Attribution/OrderMeta.php',
     'ClearwayForge\\Infra\\Attribution\\OrderObserver' => $baseDir . '/src/Infra/Attribution/OrderObserver.php',
+    'ClearwayForge\\Infra\\Attribution\\OrderRefunds' => $baseDir . '/src/Infra/Attribution/OrderRefunds.php',
     'ClearwayForge\\Infra\\Attribution\\OrderVerdictWriter' => $baseDir . '/src/Infra/Attribution/OrderVerdictWriter.php',
+    'ClearwayForge\\Infra\\Attribution\\RefundBackfill' => $baseDir . '/src/Infra/Attribution/RefundBackfill.php',
+    'ClearwayForge\\Infra\\Attribution\\RefundObserver' => $baseDir . '/src/Infra/Attribution/RefundObserver.php',
     'ClearwayForge\\Infra\\Attribution\\WcOrderMeta' => $baseDir . '/src/Infra/Attribution/WcOrderMeta.php',
+    'ClearwayForge\\Infra\\Attribution\\WcOrderRefunds' => $baseDir . '/src/Infra/Attribution/WcOrderRefunds.php',
+    'ClearwayForge\\Infra\\Collect\\RequestAddress' => $baseDir . '/src/Infra/Collect/RequestAddress.php',
     'ClearwayForge\\Infra\\Collect\\RequestSignals' => $baseDir . '/src/Infra/Collect/RequestSignals.php',
     'ClearwayForge\\Infra\\Collect\\VisitCollector' => $baseDir . '/src/Infra/Collect/VisitCollector.php',
@@ -73 +81 @@
     'ClearwayForge\\Infra\\Db\\Schema' => $baseDir . '/src/Infra/Db/Schema.php',
     'ClearwayForge\\Infra\\Health\\HealthReport' => $baseDir . '/src/Infra/Health/HealthReport.php',
+    'ClearwayForge\\Infra\\Llms\\DocumentCaching' => $baseDir . '/src/Infra/Llms/DocumentCaching.php',
     'ClearwayForge\\Infra\\Llms\\LlmsRoutes' => $baseDir . '/src/Infra/Llms/LlmsRoutes.php',
+    'ClearwayForge\\Infra\\Llms\\ProductTranslations' => $baseDir . '/src/Infra/Llms/ProductTranslations.php',
     'ClearwayForge\\Infra\\Llms\\StoreProfileBuilder' => $baseDir . '/src/Infra/Llms/StoreProfileBuilder.php',
     'ClearwayForge\\Infra\\Plugin' => $baseDir . '/src/Infra/Plugin.php',
@@ -79 +89 @@
     'ClearwayForge\\Infra\\Pro\\Bridge' => $baseDir . '/src/Infra/Pro/Bridge.php',
     'ClearwayForge\\Infra\\Report\\DashboardAssembler' => $baseDir . '/src/Infra/Report/DashboardAssembler.php',
+    'ClearwayForge\\Infra\\Report\\StoreMinorUnit' => $baseDir . '/src/Infra/Report/StoreMinorUnit.php',
     'ClearwayForge\\Infra\\Repository\\HitRepository' => $baseDir . '/src/Infra/Repository/HitRepository.php',
     'ClearwayForge\\Infra\\Repository\\SessionRepository' => $baseDir . '/src/Infra/Repository/SessionRepository.php',

clearwayforge/trunk/vendor/composer/autoload_static.php

@@ -40 +40 @@
         'ClearwayForge\\Domain\\Attribution\\SourceDetector' => __DIR__ . '/../..' . '/src/Domain/Attribution/SourceDetector.php',
         'ClearwayForge\\Domain\\Attribution\\Touch' => __DIR__ . '/../..' . '/src/Domain/Attribution/Touch.php',
+        'ClearwayForge\\Domain\\Crawler\\ClientAddress' => __DIR__ . '/../..' . '/src/Domain/Crawler/ClientAddress.php',
         'ClearwayForge\\Domain\\Crawler\\CrawlerClassifier' => __DIR__ . '/../..' . '/src/Domain/Crawler/CrawlerClassifier.php',
         'ClearwayForge\\Domain\\Crawler\\CrawlerCorpus' => __DIR__ . '/../..' . '/src/Domain/Crawler/CrawlerCorpus.php',
@@ -46 +47 @@
         'ClearwayForge\\Domain\\Crawler\\CrawlerKind' => __DIR__ . '/../..' . '/src/Domain/Crawler/CrawlerKind.php',
         'ClearwayForge\\Domain\\Crawler\\IpRange' => __DIR__ . '/../..' . '/src/Domain/Crawler/IpRange.php',
+        'ClearwayForge\\Domain\\Crawler\\TrustedProxies' => __DIR__ . '/../..' . '/src/Domain/Crawler/TrustedProxies.php',
         'ClearwayForge\\Domain\\Crawler\\Verification' => __DIR__ . '/../..' . '/src/Domain/Crawler/Verification.php',
         'ClearwayForge\\Domain\\Llms\\LlmsBlock' => __DIR__ . '/../..' . '/src/Domain/Llms/LlmsBlock.php',
@@ -67 +69 @@
         'ClearwayForge\\Domain\\Report\\MoneyText' => __DIR__ . '/../..' . '/src/Domain/Report/MoneyText.php',
         'ClearwayForge\\Domain\\Report\\PeriodSelector' => __DIR__ . '/../..' . '/src/Domain/Report/PeriodSelector.php',
+        'ClearwayForge\\Domain\\Report\\RefundSplit' => __DIR__ . '/../..' . '/src/Domain/Report/RefundSplit.php',
         'ClearwayForge\\Domain\\Report\\ReportWindow' => __DIR__ . '/../..' . '/src/Domain/Report/ReportWindow.php',
         'ClearwayForge\\Domain\\Report\\SourceRow' => __DIR__ . '/../..' . '/src/Domain/Report/SourceRow.php',
@@ -78 +81 @@
         'ClearwayForge\\Infra\\Attribution\\OrderMeta' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderMeta.php',
         'ClearwayForge\\Infra\\Attribution\\OrderObserver' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderObserver.php',
+        'ClearwayForge\\Infra\\Attribution\\OrderRefunds' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderRefunds.php',
         'ClearwayForge\\Infra\\Attribution\\OrderVerdictWriter' => __DIR__ . '/../..' . '/src/Infra/Attribution/OrderVerdictWriter.php',
+        'ClearwayForge\\Infra\\Attribution\\RefundBackfill' => __DIR__ . '/../..' . '/src/Infra/Attribution/RefundBackfill.php',
+        'ClearwayForge\\Infra\\Attribution\\RefundObserver' => __DIR__ . '/../..' . '/src/Infra/Attribution/RefundObserver.php',
         'ClearwayForge\\Infra\\Attribution\\WcOrderMeta' => __DIR__ . '/../..' . '/src/Infra/Attribution/WcOrderMeta.php',
+        'ClearwayForge\\Infra\\Attribution\\WcOrderRefunds' => __DIR__ . '/../..' . '/src/Infra/Attribution/WcOrderRefunds.php',
+        'ClearwayForge\\Infra\\Collect\\RequestAddress' => __DIR__ . '/../..' . '/src/Infra/Collect/RequestAddress.php',
         'ClearwayForge\\Infra\\Collect\\RequestSignals' => __DIR__ . '/../..' . '/src/Infra/Collect/RequestSignals.php',
         'ClearwayForge\\Infra\\Collect\\VisitCollector' => __DIR__ . '/../..' . '/src/Infra/Collect/VisitCollector.php',
@@ -88 +96 @@
         'ClearwayForge\\Infra\\Db\\Schema' => __DIR__ . '/../..' . '/src/Infra/Db/Schema.php',
         'ClearwayForge\\Infra\\Health\\HealthReport' => __DIR__ . '/../..' . '/src/Infra/Health/HealthReport.php',
+        'ClearwayForge\\Infra\\Llms\\DocumentCaching' => __DIR__ . '/../..' . '/src/Infra/Llms/DocumentCaching.php',
         'ClearwayForge\\Infra\\Llms\\LlmsRoutes' => __DIR__ . '/../..' . '/src/Infra/Llms/LlmsRoutes.php',
+        'ClearwayForge\\Infra\\Llms\\ProductTranslations' => __DIR__ . '/../..' . '/src/Infra/Llms/ProductTranslations.php',
         'ClearwayForge\\Infra\\Llms\\StoreProfileBuilder' => __DIR__ . '/../..' . '/src/Infra/Llms/StoreProfileBuilder.php',
         'ClearwayForge\\Infra\\Plugin' => __DIR__ . '/../..' . '/src/Infra/Plugin.php',
@@ -94 +104 @@
         'ClearwayForge\\Infra\\Pro\\Bridge' => __DIR__ . '/../..' . '/src/Infra/Pro/Bridge.php',
         'ClearwayForge\\Infra\\Report\\DashboardAssembler' => __DIR__ . '/../..' . '/src/Infra/Report/DashboardAssembler.php',
+        'ClearwayForge\\Infra\\Report\\StoreMinorUnit' => __DIR__ . '/../..' . '/src/Infra/Report/StoreMinorUnit.php',
         'ClearwayForge\\Infra\\Repository\\HitRepository' => __DIR__ . '/../..' . '/src/Infra/Repository/HitRepository.php',
         'ClearwayForge\\Infra\\Repository\\SessionRepository' => __DIR__ . '/../..' . '/src/Infra/Repository/SessionRepository.php',

clearwayforge/trunk/vendor/composer/installed.php

@@ -4 +4 @@
         'pretty_version' => 'dev-main',
         'version' => 'dev-main',
-        'reference' => 'ad83e89e38c6b6fbc028bc3dc13d42efbd4497a4',
+        'reference' => '7fe110de51f63a39ee1c6e61f2b9cbed4b17852c',
         'type' => 'wordpress-plugin',
         'install_path' => __DIR__ . '/../../',
@@ -14 +14 @@
             'pretty_version' => 'dev-main',
             'version' => 'dev-main',
-            'reference' => 'ad83e89e38c6b6fbc028bc3dc13d42efbd4497a4',
+            'reference' => '7fe110de51f63a39ee1c6e61f2b9cbed4b17852c',
             'type' => 'wordpress-plugin',
             'install_path' => __DIR__ . '/../../',