bquant 0.0.2__tar.gz → 0.0.3__tar.gz

{bquant-0.0.2 → bquant-0.0.3}/CHANGELOG.md

@@ -9,6 +9,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.3] - 2026-07-24
+
+### Added
+- **`confirmation_index` для стратегий `find_peaks` и `pivot_points`** — маркер причинной
+  доступности свинга теперь заполняется всеми свинг-стратегиями, а не только ZigZag (0.0.2).
+  Для `pivot_points` это точное fractal-подтверждение (`index + right_bars`); для `find_peaks` —
+  causal leak-free (`max(index + distance, бар prominence-ретрейса справа)`). Позволяет строить
+  look-ahead-free потребителей на любой свинг-стратегии. (PR #108)
+
+### Changed
+- **`CACHE_SCHEMA_VERSION` повышена 2 → 3** — `find_peaks`/`pivot_points` теперь заполняют
+  `confirmation_index`, что меняет семантику кэшируемого вывода; старые кэши инвалидируются.
+
+### Fixed
+- **ZigZag: мягкая деградация при отсутствии pandas-ta `zigzag`.** В глобальном режиме
+  (`swing_scope='global'`) стратегия теперь возвращает пустой `SwingContext` с понятным
+  предупреждением вместо исключения, когда опциональный индикатор pandas-ta `zigzag`
+  недоступен — как уже делал per-zone режим. Пайплайн больше не логирует ошибку/traceback
+  на этом пути.
+
 ## [0.0.2] - 2026-07-20
 
 ### Added

{bquant-0.0.2/bquant.egg-info → bquant-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bquant
-Version: 0.0.2
+Version: 0.0.3
 Summary: Quantitative research toolkit for financial markets
 Author-email: kogriv <kogriv@gmail.com>
 License: MIT

{bquant-0.0.2 → bquant-0.0.3}/bquant/__init__.py

@@ -5,7 +5,7 @@ A comprehensive toolkit for quantitative analysis of financial data,
 starting with MACD analysis and expandable to all aspects of market research.
 """
 
-__version__ = "0.0.2"
+__version__ = "0.0.3"
 __author__ = "kogriv"
 __email__ = "kogriv@gmail.com"
 

{bquant-0.0.2 → bquant-0.0.3}/bquant/analysis/zones/pipeline.py

@@ -47,7 +47,9 @@ _SWING_CLASS_TO_NAME = {
 # SwingPoint/ZoneInfo fields, changed swing computation, etc.), so that on-disk
 # caches computed under an older schema are not silently served.
 #   v2 (2026-07): SwingPoint.confirmation_index added (causal availability).
-CACHE_SCHEMA_VERSION = 2
+#   v3 (2026-07): confirmation_index now populated by find_peaks & pivot_points
+#                 (previously only zigzag; changes cached swing output).
+CACHE_SCHEMA_VERSION = 3
 
 
 @dataclass

{bquant-0.0.2 → bquant-0.0.3}/bquant/analysis/zones/strategies/swing/find_peaks.py

@@ -53,6 +53,10 @@ class FindPeaksSwingStrategy:
         swing_points: List[SwingPoint] = []
         indices: List[int] = []
 
+        high_arr = full_data['high'].to_numpy(dtype=float)
+        low_arr = full_data['low'].to_numpy(dtype=float)
+        full_len = len(full_data)
+
         for point_id, point in enumerate(extrema):
             timestamp = point['timestamp']
             ts = (
@@ -74,6 +78,16 @@ class FindPeaksSwingStrategy:
                     0, int(next_point['index']) - index_position
                 )
 
+            confirmation_index = self._confirmation_index(
+                index_position,
+                float(price),
+                point['type'],
+                prominence_value,
+                high_arr,
+                low_arr,
+                full_len,
+            )
+
             swing_points.append(
                 SwingPoint(
                     point_id=point_id,
@@ -85,6 +99,7 @@ class FindPeaksSwingStrategy:
                     duration_to_next=duration_to_next,
                     strategy_name='find_peaks',
                     strategy_params=self._build_strategy_params(prominence_value),
+                    confirmation_index=confirmation_index,
                 )
             )
             indices.append(index_position)
@@ -387,6 +402,52 @@ class FindPeaksSwingStrategy:
 
         return metrics
 
+    def _confirmation_index(
+        self,
+        index: int,
+        price: float,
+        swing_type: str,
+        prominence: float,
+        high_arr: np.ndarray,
+        low_arr: np.ndarray,
+        full_len: int,
+    ) -> Optional[int]:
+        """Bar by which this find_peaks extremum is causally confirmed.
+
+        A find_peaks extremum survives the global pass only if it clears BOTH the
+        ``distance`` (minimum separation) and ``prominence`` filters. It becomes
+        causally known at the later of two events:
+
+        * **distance stabilisation** — ``index + distance``: once that many
+          right-hand bars are observed, no nearer higher peak (resp. lower trough)
+          can still displace it via the distance filter (had one existed within
+          ``distance``, the extremum would have been dropped, so its absence is
+          confirmed here);
+        * **prominence retrace** — the first bar after ``index`` at which the right
+          base falls ``prominence`` away from the pivot (peak: ``high <= price -
+          prominence``; trough: ``low >= price + prominence``). scipy's prominence
+          requires *both* bases below ``price - prominence``, so this right-side
+          retrace is a necessary condition and, for a kept extremum, occurs before
+          any higher opposing bar.
+
+        Returns ``max`` of the two (both are necessary), or ``None`` if the pivot
+        cannot yet be confirmed within the available data (retrace not reached, or
+        the distance window extends past the end — a still-forming tail swing).
+        This is the ``find_peaks`` realisation of the generic
+        :attr:`SwingPoint.confirmation_index` contract.
+        """
+        if swing_type == 'peak':
+            seg = high_arr[index + 1:]
+            hits = np.nonzero(seg <= price - prominence)[0]
+        else:
+            seg = low_arr[index + 1:]
+            hits = np.nonzero(seg >= price + prominence)[0]
+        if not len(hits):
+            return None
+        prominence_bar = index + 1 + int(hits[0])
+        conf = max(index + self.distance, prominence_bar)
+        return conf if conf < full_len else None
+
     def _empty_metrics(self) -> SwingMetrics:
         return self._aggregate_metrics(
             [],

{bquant-0.0.2 → bquant-0.0.3}/bquant/analysis/zones/strategies/swing/pivot_points.py

@@ -92,6 +92,10 @@ class PivotPointsSwingStrategy:
                     0, int(next_point['index']) - index_position
                 )
 
+            confirmation_index = self._confirmation_index(
+                index_position, len(full_data)
+            )
+
             swing_points.append(
                 SwingPoint(
                     point_id=point_id,
@@ -103,6 +107,7 @@ class PivotPointsSwingStrategy:
                     duration_to_next=duration_to_next,
                     strategy_name='pivot_points',
                     strategy_params=self._strategy_params(),
+                    confirmation_index=confirmation_index,
                 )
             )
             indices.append(index_position)
@@ -391,6 +396,24 @@ class PivotPointsSwingStrategy:
 
         return metrics
 
+    def _confirmation_index(
+        self, index: int, full_data_length: int
+    ) -> Optional[int]:
+        """Bar by which this pivot is causally confirmed.
+
+        A classic N-bar pivot is defined by ``right_bars`` bars to its right that
+        are all lower (pivot high) or higher (pivot low). The pattern therefore
+        becomes complete — and the pivot causally known — exactly at
+        ``index + right_bars``: the bar at which the last required right-side bar
+        is observed. This is the ``pivot_points`` realisation of the generic
+        :attr:`SwingPoint.confirmation_index` contract (a fractal swing confirms
+        after its fixed right-hand look-ahead window). Because pivots are only
+        detected for ``index <= len - right_bars - 1``, the confirmation bar always
+        lies inside the data; the guard returns ``None`` only defensively.
+        """
+        conf = index + self.right_bars
+        return conf if conf < full_data_length else None
+
     def _empty_metrics(self) -> SwingMetrics:
         return self._aggregate_metrics([], [])
 

{bquant-0.0.2 → bquant-0.0.3}/bquant/analysis/zones/strategies/swing/zigzag.py

@@ -60,13 +60,25 @@ class ZigZagSwingStrategy:
 
         from .....indicators import LibraryManager
 
-        zigzag = LibraryManager.create_indicator(
-            'pandas_ta',
-            'zigzag',
-            legs=self.legs,
-            deviation=self.deviation,
-        )
-        result = zigzag.calculate(full_data)
+        # ZigZag relies on the optional pandas-ta 'zigzag' indicator. If pandas-ta
+        # is unavailable (skipped/not installed) or ships no zigzag, degrade to an
+        # empty context with a clean warning instead of crashing the pipeline —
+        # this mirrors the per-zone calculate() fallback below.
+        try:
+            zigzag = LibraryManager.create_indicator(
+                'pandas_ta',
+                'zigzag',
+                legs=self.legs,
+                deviation=self.deviation,
+            )
+            result = zigzag.calculate(full_data)
+        except Exception as exc:
+            logger.warning(
+                "ZigZag global: pandas-ta 'zigzag' unavailable (%s). "
+                "Returning empty SwingContext.",
+                exc,
+            )
+            return self._empty_context(len(full_data))
 
         if result.data.shape[1] < 2:
             logger.warning(

{bquant-0.0.2 → bquant-0.0.3/bquant.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bquant
-Version: 0.0.2
+Version: 0.0.3
 Summary: Quantitative research toolkit for financial markets
 Author-email: kogriv <kogriv@gmail.com>
 License: MIT

{bquant-0.0.2 → bquant-0.0.3}/bquant.egg-info/SOURCES.txt

@@ -187,7 +187,6 @@ bquant/visualization/statistical.py
 bquant/visualization/themes.py
 bquant/visualization/utils.py
 bquant/visualization/zones.py
-docs/BUILD_ISSUES.md
 docs/README.md
 docs/index.rst
 docs/_build/html/_sources/index.rst.txt
@@ -247,11 +246,6 @@ docs/_build/html/_sources/user_guide/quick_start.md.txt
 docs/_build/html/_sources/user_guide/swing_analysis_results.md.txt
 docs/_build/html/_sources/user_guide/swing_strategies.md.txt
 docs/_build/html/_sources/user_guide/zone_analysis.md.txt
-docs/analytics/zones/layerA_ii_representations_case_study.md
-docs/analytics/zones/layerA_zone_structure_case_study.md
-docs/analytics/zones/macd_zone_consistency_case_study.md
-docs/analytics/zones/s1_swing_anatomy_case_study.md
-docs/analytics/zones/swing.md
 docs/analytics/zones/swing_strategy_comparison_case_study.md
 docs/api/README.md
 docs/api/extension_guide.md
@@ -261,9 +255,9 @@ docs/api/analysis/pipeline.md
 docs/api/analysis/statistical.md
 docs/api/analysis/strategies.md
 docs/api/analysis/zones.md
-docs/api/analysis/zones/models.md
-docs/api/analysis/zones/pipeline.md
-docs/api/analysis/zones/strategies.md
+docs/api/analysis/zones/global_swings_models.md
+docs/api/analysis/zones/global_swings_pipeline.md
+docs/api/analysis/zones/global_swings_strategies.md
 docs/api/core/README.md
 docs/api/core/config.md
 docs/api/core/exceptions.md
@@ -303,7 +297,6 @@ docs/user_guide/best_practices.md
 docs/user_guide/caching.md
 docs/user_guide/core_concepts.md
 docs/user_guide/quick_start.md
-docs/user_guide/swing_analysis_results.md
 docs/user_guide/swing_strategies.md
 docs/user_guide/zone_analysis.md
 docs/user_guide/zone_analysis_result.md
@@ -335,6 +328,7 @@ tests/analysis/zones/test_pipeline_cache.py
 tests/analysis/zones/test_swing_presets.py
 tests/analysis/zones/test_swing_thresholds.py
 tests/fixtures/__init__.py
+tests/fixtures/swing_coverage.py
 tests/fixtures/swing_mocks.py
 tests/integration/__init__.py
 tests/integration/test_backward_compatibility.py
@@ -358,6 +352,7 @@ tests/unit/test_compatibility_validation.py
 tests/unit/test_core_modules.py
 tests/unit/test_data_modules.py
 tests/unit/test_divergence_strategy_universal.py
+tests/unit/test_docs_parity.py
 tests/unit/test_find_peaks_swing_strategy.py
 tests/unit/test_imports_migration.py
 tests/unit/test_indicator_factory.py

{bquant-0.0.2 → bquant-0.0.3}/docs/api/analysis/README.md

@@ -56,9 +56,9 @@ Analysis модули содержат инструменты для стати
 - **115 тестов, 100% pass rate** - доказательство универсальности
 
 **Документация по глобальным свингам:**
-- [Модели](zones/models.md) — `SwingPoint`, `SwingContext`, расширения `ZoneInfo`
-- [Пайплайн](zones/pipeline.md) — `_calculate_global_swings`, `_inject_swing_context`, `with_swing_scope()`
-- [Стратегии](zones/strategies.md) — протокол `SwingCalculationStrategy`, ZigZag/FindPeaks/PivotPoints
+- [Модели](zones/global_swings_models.md) — `SwingPoint`, `SwingContext`, расширения `ZoneInfo`
+- [Пайплайн](zones/global_swings_pipeline.md) — `_calculate_global_swings`, `_inject_swing_context`, `with_swing_scope()`
+- [Стратегии](zones/global_swings_strategies.md) — протокол `SwingCalculationStrategy`, ZigZag/FindPeaks/PivotPoints
 
 ### 🎨 [bquant.analysis.zones.strategies](strategies.md) - Strategy Pattern (New)
 

{bquant-0.0.2 → bquant-0.0.3}/docs/api/analysis/pipeline.md

@@ -135,6 +135,22 @@ result = (
 .with_cache(enable=False)
 ```
 
+#### `.with_swing_scope(scope)`
+Режим расчёта свингов.
+
+**Параметры:**
+- `scope='global'` (по умолчанию) — свинги считаются один раз по всему датасету, затем
+  агрегируются в каждую зону (`calculate_global` + `aggregate_for_zone`).
+- `scope='per_zone'` — свинги считаются локально внутри каждой зоны (совместимость).
+
+**Пример:**
+```python
+.with_strategies(swing='zigzag').with_swing_scope('global')
+```
+
+> 📖 Внутренняя механика (`_calculate_global_swings`, `_inject_swing_context`, фолбэки) —
+> в [Глобальные свинги: пайплайн](zones/global_swings_pipeline.md).
+
 #### `.build()`
 Запуск анализа и получение результата.
 
@@ -352,9 +368,9 @@ zone_features = result.zones[0].features.get('zone_type')
 
 ### 🎯 Learning Path
 - **[Examples](../../examples/README.md)** - Готовые примеры использования
-- **[Deep Dive Tutorial](../../research/notebooks/03_zones_universal.py)** - Comprehensive analysis
-- **[Advanced Features](../../research/notebooks/03_analysis_new_features.py)** - Swing, divergence, regression
-- **[Migration Guide](../../examples/02_macd_zone_analysis.py)** - Переход с legacy API
+- **[Deep Dive Tutorial](../../../research/notebooks/03_zones_universal.py)** - Comprehensive analysis
+- **[Advanced Features](../../../research/notebooks/03_analysis_new_features.py)** - Swing, divergence, regression
+- **[Migration Guide](../../../examples/02_macd_zone_analysis.py)** - Переход с legacy API
 
 ### 🏗️ Developer Resources
 - **[Architecture Patterns](../../developer_guide/README.md)** - Design Patterns, Extension Points

{bquant-0.0.2 → bquant-0.0.3}/docs/api/analysis/strategies.md

@@ -51,11 +51,19 @@ ZoneFeaturesAnalyzer
 
 ```python
 class SwingCalculationStrategy(Protocol):
-    def calculate_swing(self, data: pd.DataFrame) -> SwingMetrics: ...
-    def get_name(self) -> str: ...
-    def get_metadata(self) -> dict: ...
+    # Глобальный режим (по умолчанию)
+    def calculate_global(self, full_data: pd.DataFrame) -> SwingContext: ...
+    def aggregate_for_zone(self, zone: ZoneInfo, context: SwingContext) -> SwingMetrics: ...
+    # Легаси per-zone режим (совместимость)
+    def calculate(self, zone_data: pd.DataFrame) -> SwingMetrics: ...
+    def get_metadata(self) -> Dict[str, Any]: ...
+    def config_hash(self) -> Dict[str, Any]: ...
 ```
 
+> 📖 Полный разбор глобального контракта (`calculate_global`/`aggregate_for_zone`) и
+> реализаций ZigZag/FindPeaks/PivotPoints — в
+> [Глобальные свинги: стратегии](zones/global_swings_strategies.md).
+
 ### SwingMetrics Dataclass (23 поля)
 
 Полный результат анализа свингов в зоне.
@@ -113,11 +121,10 @@ class SwingCalculationStrategy(Protocol):
 
 ```python
 class ShapeCalculationStrategy(Protocol):
-    def calculate(self, data: pd.DataFrame, indicator_col: Optional[str] = None) -> ShapeMetrics: ...
-    #                                        ^^^^^^^^^^^^^^^^^^^^^^^^
-    #                                        v2.1: Required for universal usage
-    def get_name(self) -> str: ...
-    def get_metadata(self) -> dict: ...
+    def calculate(self, zone_data: pd.DataFrame, indicator_col: str) -> ShapeMetrics: ...
+    #                                            ^^^^^^^^^^^^^^^^^^
+    #                                            v2.1: обязателен (без авто-детекта)
+    def get_metadata(self) -> Dict[str, Any]: ...
 ```
 
 **Универсальное использование v2.1:**
@@ -173,14 +180,13 @@ shape = strategy.calculate(zone_data, indicator_col='MY_CUSTOM_OSC')
 
 ```python
 class DivergenceCalculationStrategy(Protocol):
-    def calculate_divergence(self, 
-                           data: pd.DataFrame, 
-                           indicator_col: Optional[str] = None,
-                           indicator_line_col: Optional[str] = None) -> DivergenceMetrics: ...
-    #                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-    #                       v2.1: Support for 2-line indicators (MACD line + signal)
-    def get_name(self) -> str: ...
-    def get_metadata(self) -> dict: ...
+    def calculate_divergence(self,
+                           zone_data: pd.DataFrame,
+                           indicator_col: str,
+                           indicator_line_col: str = None) -> DivergenceMetrics: ...
+    #                       ^^^^^^^^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^^^^^
+    #                       обязателен          v2.1: 2-линейные индикаторы (MACD + signal)
+    def get_metadata(self) -> Dict[str, Any]: ...
 ```
 
 **Универсальные примеры v2.1:**
@@ -225,9 +231,8 @@ div = strategy.calculate_divergence(data, indicator_col='AO_5_34')
 
 ```python
 class VolatilityCalculationStrategy(Protocol):
-    def calculate_volatility(self, data: pd.DataFrame) -> VolatilityMetrics: ...
-    def get_name(self) -> str: ...
-    def get_metadata(self) -> dict: ...
+    def calculate_volatility(self, zone_data: pd.DataFrame) -> VolatilityMetrics: ...
+    def get_metadata(self) -> Dict[str, Any]: ...
 ```
 
 ### VolatilityMetrics Dataclass (10 полей)
@@ -262,9 +267,11 @@ class VolatilityCalculationStrategy(Protocol):
 
 ```python
 class VolumeCalculationStrategy(Protocol):
-    def calculate_volume(self, data: pd.DataFrame, baseline_volume: Optional[float] = None) -> VolumeMetrics: ...
-    def get_name(self) -> str: ...
-    def get_metadata(self) -> dict: ...
+    def calculate_volume(self, zone_data: pd.DataFrame,
+                         baseline_volume: Optional[float] = None,
+                         indicator_col: Optional[str] = None) -> VolumeMetrics: ...
+    #                    v2.1: indicator_col для универсальной корреляции объём↔индикатор
+    def get_metadata(self) -> Dict[str, Any]: ...
 ```
 
 ### VolumeMetrics Dataclass (4 поля)
@@ -816,9 +823,9 @@ if zone.features:
 
 ### 🎯 Learning Path
 - **[Examples](../../examples/README.md)** - Готовые примеры использования
-- **[Deep Dive Tutorial](../../research/notebooks/03_zones_universal.py)** - Подробный разбор
-- **[Advanced Features](../../research/notebooks/03_analysis_new_features.py)** - Свинги, дивергенции, регрессия
-- **[Migration Guide](../../examples/02_macd_zone_analysis.py)** - Переход с legacy API
+- **[Deep Dive Tutorial](../../../research/notebooks/03_zones_universal.py)** - Подробный разбор
+- **[Advanced Features](../../../research/notebooks/03_analysis_new_features.py)** - Свинги, дивергенции, регрессия
+- **[Migration Guide](../../../examples/02_macd_zone_analysis.py)** - Переход с legacy API
 
 ### 🏗️ Developer Resources
 - **[Architecture Patterns](../../developer_guide/README.md)** - Паттерны проектирования, точки расширения
@@ -829,5 +836,5 @@ if zone.features:
 ### 🔧 Technical Resources
 - **Implementations:** `bquant/analysis/zones/strategies/`
 - **Tests:** `tests/unit/test_*_strategy.py`
-- **Technical docs:** `devref/gaps/swing_detection_approaches.md`
+- **Technical docs:** `devref/archive/gaps/swing_detection_approaches.md`
 

bquant-0.0.2/docs/api/analysis/zones/pipeline.md → bquant-0.0.3/docs/api/analysis/zones/global_swings_pipeline.md

@@ -1,6 +1,10 @@
-# bquant.analysis.zones.pipeline — Пайплайн анализа зон v2.1
+# Глобальные свинги: внутренняя механика пайплайна
 
-Этот документ фиксирует ключевые изменения API, связанные с глобальным расчётом свингов. Все описания приведены на русском языке в соответствии с требованиями плана 6.2.2.
+> **Узкий справочник.** Эта страница покрывает только шаги `ZoneAnalysisPipeline`,
+> относящиеся к **глобальному расчёту свингов** (`swing_scope="global"`). Полный справочник
+> публичного builder-API — в [Universal Pipeline](../pipeline.md).
+
+Этот документ фиксирует ключевые изменения API, связанные с глобальным расчётом свингов.
 
 ## Обзор рабочего процесса
 

bquant-0.0.2/docs/api/analysis/zones/strategies.md → bquant-0.0.3/docs/api/analysis/zones/global_swings_strategies.md

@@ -1,4 +1,8 @@
-# bquant.analysis.zones.strategies — Стратегии свингов
+# Глобальные свинги: протокол `SwingCalculationStrategy`
+
+> **Узкий справочник.** Эта страница покрывает контракт свинг-стратегий в режиме
+> **глобального расчёта** (`calculate_global`/`aggregate_for_zone`). Обзор всех метрик-стратегий
+> (swing/shape/divergence/volatility/volume) — в [Strategy Pattern](../strategies.md).
 
 Раздел описывает контракт `SwingCalculationStrategy` и обновлённые реализации ZigZag, FindPeaks и PivotPoints после перехода на глобальный расчёт свингов.
 

{bquant-0.0.2 → bquant-0.0.3}/docs/api/analysis/zones.md

@@ -23,10 +23,10 @@
 > 
 > **Справочник API:**
 > - [Универсальные Стратегии](strategies.md) - аналитические стратегии для ЛЮБОГО индикатора
-> - [Руководство по Расширению](../developer_guide/zone_detection_strategies.md) - создание пользовательских стратегий
-> - [Модели глобальных свингов](zones/models.md) — `SwingPoint`, `SwingContext`, `ZoneInfo.get_zone_swings()`
-> - [Пайплайн с поддержкой global scope](zones/pipeline.md) — `_calculate_global_swings`, `_inject_swing_context`
-> - [Стратегии свингов v2](zones/strategies.md) — протокол `SwingCalculationStrategy` и ZigZag/FindPeaks/PivotPoints
+> - [Руководство по Расширению](../../developer_guide/zone_detection_strategies.md) - создание пользовательских стратегий
+> - [Модели глобальных свингов](zones/global_swings_models.md) — `SwingPoint`, `SwingContext`, `ZoneInfo.get_zone_swings()`
+> - [Пайплайн с поддержкой global scope](zones/global_swings_pipeline.md) — `_calculate_global_swings`, `_inject_swing_context`
+> - [Стратегии свингов v2](zones/global_swings_strategies.md) — протокол `SwingCalculationStrategy` и ZigZag/FindPeaks/PivotPoints
 
 ## Обзор
 
@@ -178,7 +178,7 @@ print(first_zone.indicator_context['detection_indicator'])  # → 'FICTIONAL_IND
 **Документация:**
 - **Универсальная Архитектура:** См. выше (🟢 v2.1 - стабильно)
 - **Паттерн Стратегия:** См. [strategies.md](strategies.md) (🟢 стабильный API)
-- **Руководство по Расширению:** См. [developer guide](../developer_guide/zone_detection_strategies.md) (пользовательские стратегии)
+- **Руководство по Расширению:** См. [developer guide](../../developer_guide/zone_detection_strategies.md) (пользовательские стратегии)
 
 ### Использование Аналитических Стратегий (v2.1)
 
@@ -273,14 +273,10 @@ result = (
 #### `analyze_zones(df) -> ZoneAnalysisBuilder`
 Точка входа для Universal Pipeline. Возвращает fluent builder для настройки анализа.
 
-#### `ZoneAnalysisBuilder`
-Fluent interface для настройки анализа:
-- `.with_indicator(source, name, **params)` - настройка индикатора
-- `.detect_zones(strategy, **params)` - настройка детекции зон
-- `.with_strategies(**strategies)` - настройка аналитических стратегий
-- `.analyze(**options)` - настройка анализа
-- `.with_cache(enable=True, ttl=3600)` - настройка кэширования
-- `.build()` - запуск анализа
+> 📖 **Полный справочник по методам билдера** (`.with_indicator()`, `.detect_zones()`,
+> `.with_strategies()`, `.analyze()`, `.with_cache()`, `.with_swing_scope()`, `.build()`) —
+> в канонической странице [Universal Pipeline](pipeline.md). Ниже — только модели данных
+> результата.
 
 #### `ZoneAnalysisResult`
 Результат анализа с полным набором данных:

{bquant-0.0.2 → bquant-0.0.3}/docs/api/core/logging.md

@@ -485,7 +485,7 @@ setup_logging(
 
 ## 📚 См. также
 
-- [NotebookSimulator API](nb.md#logging) - интеграция с логированием
+- [NotebookSimulator API](nb.md#логирование) - интеграция с логированием
 - [Data Modules](../data/README.md) - логирование в модулях данных
 - [Developer Guide](../../developer_guide/README.md) - руководство разработчика
 - [Best Practices](../../user_guide/best_practices.md) - лучшие практики работы с BQuant

{bquant-0.0.2 → bquant-0.0.3}/docs/api/core/nb.md

@@ -351,7 +351,7 @@ nb.finish()
 6. **Тестируйте в разных режимах** - с `--trap` и `--no-trap`
 7. **Не создавайте функцию main()** - размещайте код в корне модуля
 
-### Логирование {#logging}
+### Логирование
 
 **Интеграция с системой логирования:**
 
@@ -368,7 +368,7 @@ logging.getLogger('bquant.indicators').setLevel(logging.WARNING)
 nb = NotebookSimulator("My Analysis")
 ```
 
-**См. подробности:** [Управление логированием](logging.md#управление-логированием-в-многомодульных-проектах)
+**См. подробности:** [Управление логированием](logging.md#-модульная-настройка)
 
 ### Ограничения
 

{bquant-0.0.2 → bquant-0.0.3}/docs/api/data/README.md

@@ -192,7 +192,7 @@ generator = SampleDataGenerator()
 # generator.generate_all()  # создаст embedded-файлы согласно конфигурации
 ```
 
-## Логирование {#logging}
+## Логирование
 
 Data модули используют контекстное логирование с техническими деталями загрузки и обработки данных. При использовании с NotebookSimulator может возникать дублирование сообщений.
 
@@ -204,7 +204,7 @@ import logging
 logging.getLogger('bquant.data').setLevel(logging.WARNING)
 ```
 
-**См. подробности:** [Управление логированием](../core/logging.md#управление-логированием-в-многомодульных-проектах)
+**См. подробности:** [Управление логированием](../core/logging.md#-модульная-настройка)
 
 ## 🔗 Связанные разделы
 

{bquant-0.0.2 → bquant-0.0.3}/docs/api/data/loader.md

@@ -48,7 +48,7 @@ datasets = load_all_data_files()
 print(list(datasets.keys()))
 ```
 
-## Логирование {#logging}
+## Логирование
 
 Модуль использует контекстное логирование с детальными техническими сообщениями:
 
@@ -71,7 +71,7 @@ logging.getLogger('bquant.data.loader').setLevel(logging.WARNING)
 logging.getLogger('bquant.data').setLevel(logging.WARNING)
 ```
 
-**См. подробности:** [Управление логированием](../core/logging.md#управление-логированием-в-многомодульных-проектах)
+**См. подробности:** [Управление логированием](../core/logging.md#-модульная-настройка)
 
 ## Замечания
 

{bquant-0.0.2 → bquant-0.0.3}/docs/api/extension_guide.md

@@ -1228,10 +1228,10 @@ class CustomIndicator(BaseIndicator):
 
 ## 📚 Дополнительные ресурсы
 
-- **[Core Modules](../core/README.md)** - Базовые модули для расширения
-- **[Indicators](../indicators/README.md)** - Примеры индикаторов
-- **[Analysis](../analysis/README.md)** - Примеры анализаторов
-- **[Visualization](../visualization/README.md)** - Примеры визуализаций
+- **[Core Modules](core/README.md)** - Базовые модули для расширения
+- **[Indicators](indicators/README.md)** - Примеры индикаторов
+- **[Analysis](analysis/README.md)** - Примеры анализаторов
+- **[Visualization](visualization/README.md)** - Примеры визуализаций
 
 ---