centaur_technical_indicators 1.2.0__tar.gz → 1.2.2__tar.gz

centaur_technical_indicators-1.2.2/.github/pull_request_template.md

@@ -0,0 +1,18 @@
+## Summary
+- What changed?
+- Why was this change needed?
+
+## Compatibility
+- User-facing Python API impact:
+- Migration notes (if any):
+
+## Validation
+- [ ] `maturin develop` (bindings compile cleanly)
+- [ ] `python -m pytest` (all tests pass)
+- [ ] `cargo fmt --check` (no formatting diffs)
+
+Command output summary:
+
+## Changelog
+- [ ] `CHANGELOG.md` updated for user-facing changes
+- Entry summary:

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/AGENTS.md

@@ -9,6 +9,10 @@ Guidance for coding agents working in this repository.
   - `src/` → Rust implementation + Python bindings
   - `tests/` → Python-facing smoke/behavior tests for bindings
 
+## Docs to review before coding
+- `docs/REPO_MAP.md`
+- `CONTRIBUTING.md`
+
 ## Recommended workflow
 1. **Set up an isolated environment**
    ```bash
@@ -42,6 +46,30 @@ Guidance for coding agents working in this repository.
 - Keep naming and argument conventions consistent with neighboring functions.
 - Use clear, user-facing error messages for invalid inputs.
 
+## Change scope discipline
+- Keep changes minimal and focused on the requested task.
+- Do not include opportunistic refactors unless explicitly requested.
+- If you identify unrelated issues, note them separately instead of bundling them into the same change.
+- Preserve existing file organization and naming conventions unless the task requires a structural change.
+
+## Backward compatibility rules
+When changing public Python APIs, preserve compatibility unless the task explicitly allows a breaking change:
+
+1. Do not silently change indicator semantics, output ordering, or warmup behavior.
+2. Do not remove or rename public functions, types, enums, or parameters without explicit approval.
+3. If behavior changes are required, document them in docstrings and `CHANGELOG.md` with clear migration notes.
+
+## Pre-PR quality gates (must pass)
+Run these before opening a PR:
+
+1. `maturin develop` (bindings compile cleanly)
+2. `python -m pytest` (all tests pass)
+3. `cargo fmt --check` (no formatting diffs)
+
+## CI implementation policy
+- Prefer native Python/maturin/cargo commands in workflows.
+- Do not introduce third-party GitHub Actions unless explicitly approved by maintainers.
+
 ## Validation expectations before finishing
 - Rebuild bindings after Rust changes: `maturin develop`.
 - Run relevant tests (ideally full `python -m pytest`).
@@ -54,8 +82,22 @@ Guidance for coding agents working in this repository.
 - [ ] Documentation/changelog updated when needed.
 - [ ] Commit message clearly describes the change.
 
+## PR expectations for agents
+- Keep PRs focused and minimal.
+- Summarize what the agent changed and what was manually verified.
+- Include command output summary for the required quality gates.
+- Explicitly note the `CHANGELOG.md` entry.
+
+### Required PR summary format
+Use this structure in PR descriptions/comments:
+
+1. `Summary`: what changed and why.
+2. `Compatibility`: any user-facing behavior/API impact.
+3. `Validation`: results summary for `maturin develop`, `pytest`, and `cargo fmt`.
+4. `Changelog`: exact `CHANGELOG.md` entry added/updated.
+
 ## Repository expectations
-- This is a public Rust library. Prioritize correctness, determinism, and backward compatibility.
+- This is a public Python/Rust library. Prioritize correctness, determinism, and backward compatibility.
 - Prefer minimal, focused diffs over broad refactors.
 - Do not add new dependencies unless explicitly requested.
 - Treat public APIs, documented behavior, and examples as stability-sensitive.
@@ -69,3 +111,4 @@ Guidance for coding agents working in this repository.
 ## Change boundaries
 - Do not modify CI, licensing, security, or contributor-governance files unless explicitly requested.
 - Keep unrelated formatting churn to a minimum.
+

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/CHANGELOG.md

@@ -6,6 +6,40 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ---
 
+## [Unreleased]
+
+## [1.2.2] - 2026-04-04
+
+### Fixed
+- Inherited fix for `relative_strength_index` (single and bulk) producing incorrect values via upstream crate update. The internal `previous_gains_loss` helper was only collecting non-zero gains/losses, discarding zero entries and causing misaligned averages.
+
+### Changed
+- Updated `centaur_technical_indicators` Rust crate dependency from `1.2.1` to `1.2.2`
+
+### Removed
+- Removed `AI_FRIENDLY_ROADMAP.md`, `docs/AI_ONBOARDING.md`, and `.github/copilot-instructions.md` — redundant with `AGENTS.md`
+- Removed dangling references to removed files from `AGENTS.md`, `docs/REPO_MAP.md`, and `ai-policy.yaml`
+- Simplified PR template from 7 sections to 4 (`Summary`, `Compatibility`, `Validation`, `Changelog`)
+
+---
+
+## [1.2.1] - 2026-03-01
+
+### Changed
+- Updated `centaur_technical_indicators` Rust crate dependency from `1.2.0` to `1.2.1`
+  - Removed `#[allow(deprecated)]` from `volume_price_trend` binding functions (`src/trend_indicators.rs`) as the upstream crate removed the deprecation marker in `1.2.1`
+
+### Added
+- Added `AI_FRIENDLY_ROADMAP.md` with module API surface, contributor-workflow, and library-feature roadmap adapted for this Python binding repository
+- Added `docs/AI_ONBOARDING.md` as canonical start-here onboarding flow for coding agents
+- Added `docs/REPO_MAP.md` with a quick repository map, extension points, and "if changing X, also check Y" guidance
+- Added machine-readable repository policy file `ai-policy.yaml` for required checks, change obligations, and PR section requirements
+- Added default pull request template at `.github/pull_request_template.md` with required sections (`Summary`, `Scope`, `Compatibility`, `Validation`, `Changelog`)
+- Expanded `AGENTS.md` with change-scope discipline, backward compatibility rules, pre-PR quality gates, CI implementation policy, and required PR summary format
+- Updated `CONTRIBUTING.md` with local quality gates and AI-assisted contribution checklist
+
+---
+
 ## [1.2.0] - 2026-02-26
 
 ### Changed

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/CONTRIBUTING.md

@@ -51,5 +51,28 @@ See [open issues](https://github.com/ChironMind/CentaurTechnicalIndicators-Pytho
 
 ---
 
+## 🔒 Local quality gates
+
+Run these before opening a PR:
+
+1. `maturin develop` — bindings compile cleanly
+2. `python -m pytest` — all tests pass
+3. `cargo fmt --check` — no formatting diffs
+
+---
+
+## 🤖 AI-assisted contribution checklist
+
+If you used an AI agent to contribute:
+
+- [ ] Reviewed all AI-generated changes for correctness
+- [ ] Confirmed the scope is minimal and matches the task
+- [ ] Verified `maturin develop` builds successfully
+- [ ] Verified `python -m pytest` passes
+- [ ] Updated `CHANGELOG.md` with a user-facing entry
+- [ ] Disclosed AI assistance in the PR description
+
+---
+
 Thanks again for your interest and contributions!
 

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/Cargo.lock

@@ -10,17 +10,17 @@ checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
 
 [[package]]
 name = "centaur_technical_indicators"
-version = "1.2.0"
+version = "1.2.2"
 dependencies = [
- "centaur_technical_indicators 1.2.0 (registry+https://github.com/rust-lang/crates.io-index)",
+ "centaur_technical_indicators 1.2.2 (registry+https://github.com/rust-lang/crates.io-index)",
  "pyo3",
 ]
 
 [[package]]
 name = "centaur_technical_indicators"
-version = "1.2.0"
+version = "1.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e1a34ab4d40a88bc6253ca7096ef88556ff5b128747ef47ee914b576e7270035"
+checksum = "24ae4cb5750fab3c9d2ae9be158158df08bb4b052c6e5c398885be57e0590be9"
 
 [[package]]
 name = "heck"

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "centaur_technical_indicators"
-version = "1.2.0"
+version = "1.2.2"
 edition = "2021"
 readme = "README.md"
 
@@ -11,4 +11,4 @@ crate-type = ["cdylib"]
 
 [dependencies]
 pyo3 = "0.25.0"
-centaur_technical_indicators = "1.2.0"
+centaur_technical_indicators = "1.2.2"

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: centaur_technical_indicators
-Version: 1.2.0
+Version: 1.2.2
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Financial and Insurance Industry
 Classifier: Topic :: Software Development :: Libraries

centaur_technical_indicators-1.2.2/ai-policy.yaml

@@ -0,0 +1,50 @@
+version: 1
+repository: CentaurTechnicalIndicators-Python
+
+required_checks:
+  local_commands:
+    - maturin develop
+    - python -m pytest
+    - cargo fmt --check
+  benchmark:
+    required_for_paths:
+      - src/candle_indicators.rs
+      - src/chart_trends.rs
+      - src/correlation_indicators.rs
+      - src/momentum_indicators.rs
+      - src/moving_average.rs
+      - src/other_indicators.rs
+      - src/strength_indicators.rs
+      - src/trend_indicators.rs
+      - src/volatility_indicators.rs
+    companion_repo: https://github.com/ChironMind/CentaurTechnicalIndicators-benchmarks
+
+change_requirements:
+  user_facing_change_requires:
+    - CHANGELOG.md
+  public_api_change_requires:
+    - Rust docstring updates for changed/new public binding functions
+    - tests in matching tests/ module
+    - PR Compatibility section summarizing API impact
+
+coding_rules:
+  api_pattern:
+    instruction: Preserve the bulk/single function variant pattern for all indicators.
+  errors:
+    required_error_type: PyValueError
+    instruction: Surface all errors to Python as PyValueError with user-meaningful messages.
+  compatibility:
+    preserve_public_api_unless_explicit_breaking_approval: true
+
+pr_report:
+  required_sections:
+    - Summary
+    - Compatibility
+    - Validation
+    - Changelog
+
+notes:
+  source_of_truth:
+    - AGENTS.md
+    - CONTRIBUTING.md
+  purpose: Minimal machine-readable policy for AI agents and automation.

centaur_technical_indicators-1.2.2/docs/REPO_MAP.md

@@ -0,0 +1,72 @@
+# Repository Map
+
+Quick orientation for contributors and coding agents working in `CentaurTechnicalIndicators-Python`.
+
+## Top-level layout
+
+- `src/`: Rust source files (PyO3 binding implementations for each indicator module).
+- `tests/`: Python test files (smoke tests for each binding module).
+- `assets/`: Supporting artifacts (documentation assets, banner images).
+- `.github/workflows/`: CI workflows (PR validation, release pipeline).
+- `Cargo.toml`: Rust package version and dependency configuration.
+- `pyproject.toml`: Python package metadata and maturin build settings.
+- `CHANGELOG.md`: required entry point for every user-facing change.
+- `AGENTS.md`: agent operating rules and PR/reporting expectations.
+- `CONTRIBUTING.md`: contributor expectations and required validation gates.
+
+## Source module map (`src/`)
+
+- `lib.rs`: PyO3 module wiring, shared enum type definitions (`PyConstantModelType`, `DeviationModel`, `MovingAverageType`).
+- `candle_indicators.rs`: candle/band/channel/envelope-style indicator bindings.
+- `chart_trends.rs`: peak/valley and trend-structure analysis bindings.
+- `correlation_indicators.rs`: pairwise/statistical relationship indicator bindings.
+- `momentum_indicators.rs`: momentum/oscillator indicator bindings.
+- `moving_average.rs`: moving average bindings.
+- `other_indicators.rs`: miscellaneous indicator bindings.
+- `strength_indicators.rs`: strength/participation indicator bindings.
+- `trend_indicators.rs`: trend direction/strength indicator bindings.
+- `volatility_indicators.rs`: volatility/range-expansion indicator bindings.
+
+## Test module map (`tests/`)
+
+- `test_<module_name>.py` mirrors `src/<module_name>.rs` — each test file covers binding smoke tests for the matching source module.
+
+## Extension points
+
+- New indicator binding: add to the appropriate `src/*_indicators.rs` file and wire through `src/lib.rs`.
+- New shared type/enum: add to `src/lib.rs` following the existing string-dispatch pattern.
+- Python tests: add to the matching `tests/test_<module_name>.py` file.
+- Public exports: wire through `src/lib.rs`.
+
+## If changing X, also check Y
+
+- If changing an indicator's parameter names or accepted string values:
+  - Also update the corresponding docstring in `src/<module_name>.rs`.
+  - Also update or add tests in `tests/test_<module_name>.py`.
+- If updating the upstream `centaur_technical_indicators` Rust crate version:
+  - Also update the package `version` in `Cargo.toml`.
+  - Also check for deprecation changes and adjust `#[allow(deprecated)]` annotations accordingly.
+  - Also add a user-facing entry in `CHANGELOG.md`.
+- If adding/changing public Python-facing APIs:
+  - Also update docstrings.
+  - Also add a user-facing entry in `CHANGELOG.md`.
+- If changing indicator math/outputs:
+  - Also update/add tests in the matching test module.
+- If adding new user-visible behavior:
+  - Also update `README.md` and/or examples when appropriate.
+  - Also update `CHANGELOG.md`.
+
+## Required local validation gates
+
+Run these before opening a PR:
+
+1. `maturin develop` (bindings compile cleanly)
+2. `python -m pytest` (all tests pass)
+3. `cargo fmt --check` (no formatting diffs)
+
+## Minimal PR content checklist
+
+- What changed and why.
+- Compatibility/user-impact notes.
+- Validation command summary.
+- Explicit `CHANGELOG.md` entry note.

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/src/trend_indicators.rs

@@ -335,7 +335,6 @@ fn bulk_directional_movement_system(
 ///
 /// Returns:
 ///     VPT value
-#[allow(deprecated)]
 #[pyfunction(name = "volume_price_trend")]
 fn single_volume_price_trend(
     current_price: f64,
@@ -360,7 +359,6 @@ fn single_volume_price_trend(
 ///
 /// Returns:
 ///     List of VPT values
-#[allow(deprecated)]
 #[pyfunction(name = "volume_price_trend")]
 fn bulk_volume_price_trend(
     prices: Vec<f64>,

{centaur_technical_indicators-1.2.0 → centaur_technical_indicators-1.2.2}/tests/test_momentum_indicators.py

@@ -30,23 +30,41 @@ volume = [1000.0, 1500.0, 1200.0, 900.0, 1300.0]
 
 def test_single_relative_strength_index():
     assert momentum_indicators.single.relative_strength_index(prices, "simple") == 42.857142857142854
-    assert momentum_indicators.single.relative_strength_index(prices, "smoothed") == 39.99999999999999
-    assert momentum_indicators.single.relative_strength_index(prices, "exponential") == 38.46153846153846
-    assert momentum_indicators.single.relative_strength_index(prices, "median") == 42.857142857142854
-    assert momentum_indicators.single.relative_strength_index(prices, "mode") == 42.857142857142854
+    assert momentum_indicators.single.relative_strength_index(prices, "smoothed") == 28.662420382165607
+    assert momentum_indicators.single.relative_strength_index(prices, "exponential") == 19.839679358717433
+    assert momentum_indicators.single.relative_strength_index(prices, "median") == 33.33333333333333
+    assert momentum_indicators.single.relative_strength_index(prices, "mode") == 0.0
     with pytest.raises(ValueError):
         momentum_indicators.single.relative_strength_index(prices, "")
 
 
 def test_bulk_relative_strength_index():
     assert momentum_indicators.bulk.relative_strength_index(prices, "simple", 3) == [100.0, 33.33333333333333, 0.0]
-    assert momentum_indicators.bulk.relative_strength_index(prices, "smoothed", 3) == [100.0, 33.33333333333333, 0.0]
-    assert momentum_indicators.bulk.relative_strength_index(prices, "exponential", 3) == [100.0, 33.33333333333333, 0.0]
+    assert momentum_indicators.bulk.relative_strength_index(prices, "smoothed", 3) == [100.0, 20.0, 0.0]
+    assert momentum_indicators.bulk.relative_strength_index(prices, "exponential", 3) == [100.0, 14.285714285714292, 0.0]
     assert momentum_indicators.bulk.relative_strength_index(prices, "median", 3) == [100.0, 33.33333333333333, 0.0]
     assert momentum_indicators.bulk.relative_strength_index(prices, "mode", 3) == [100.0, 33.33333333333333, 0.0]
     with pytest.raises(ValueError):
         momentum_indicators.bulk.relative_strength_index(prices, "", 3)
 
+flat_prices = [100.0, 100.0, 100.0, 102.0, 101.0]
+
+def test_single_relative_strength_index_zero_change_regression():
+    """Regression: zero-change periods must not be discarded from RSI calculation (upstream fix in v1.2.2)."""
+    assert momentum_indicators.single.relative_strength_index(flat_prices, "simple") == 66.66666666666666
+    assert momentum_indicators.single.relative_strength_index(flat_prices, "smoothed") == 60.0
+    assert momentum_indicators.single.relative_strength_index(flat_prices, "exponential") == 54.54545454545455
+    assert momentum_indicators.single.relative_strength_index(flat_prices, "median") == 0.0
+    assert momentum_indicators.single.relative_strength_index(flat_prices, "mode") == 0.0
+
+def test_bulk_relative_strength_index_zero_change_regression():
+    """Regression: zero-change periods must not be discarded from bulk RSI calculation (upstream fix in v1.2.2)."""
+    assert momentum_indicators.bulk.relative_strength_index(flat_prices, "simple", 3) == [0.0, 100.0, 66.66666666666666]
+    assert momentum_indicators.bulk.relative_strength_index(flat_prices, "smoothed", 3) == [0.0, 100.0, 50.0]
+    assert momentum_indicators.bulk.relative_strength_index(flat_prices, "exponential", 3) == [0.0, 100.0, 40.0]
+    assert momentum_indicators.bulk.relative_strength_index(flat_prices, "median", 3) == [0.0, 100.0, 66.66666666666666]
+    assert momentum_indicators.bulk.relative_strength_index(flat_prices, "mode", 3) == [0.0, 100.0, 66.66666666666666]
+
 def test_single_stochastic_oscillator():
     assert momentum_indicators.single.stochastic_oscillator(prices) == 0.0
 

centaur_technical_indicators-1.2.0/.github/copilot-instructions.md

@@ -1,185 +0,0 @@
-# Copilot Instructions for Centaur Technical Indicators
-
-## Repository Overview
-
-**Centaur Technical Indicators** is a production-ready Python library providing 60+ technical indicators for financial analysis, built on a high-performance Rust backend. The project uses PyO3 and maturin to create Python bindings for the underlying Rust implementation.
-
-**Key Stats:**
-- **Languages:** Rust (backend), Python (bindings/tests)  
-- **Build System:** maturin (Rust-Python integration)
-- **Python Support:** 3.10+ (tested through 3.14)
-- **Test Suite:** 107 tests, ~0.31s runtime
-- **License:** MIT
-
-## Build Instructions & Validated Commands
-
-### Bootstrap & Environment Setup (Required)
-**Always create a virtual environment before building:**
-```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-```
-
-### Install Dependencies (Required)
-```bash
-pip install -r test_requirements.txt
-```
-**Contents:** maturin==1.9.1, pytest==8.4.1, and supporting packages
-
-### Build the Project (Required)
-```bash
-maturin develop
-```
-- **Duration:** ~14 seconds for full compilation
-- **Function:** Compiles Rust code and installs Python package in editable mode
-- **Output:** Installs `centaur_technical_indicators` package locally
-
-### Run Tests (Validation)
-```bash
-python -m pytest
-```
-- **Expected:** 107 tests pass in ~0.31s
-- **Coverage:** All indicator modules with bulk/single function variants
-
-### Format Code (Optional)
-```bash
-cargo fmt --check  # Check Rust formatting
-```
-
-### Environment Versions (Reference)
-- **Python:** 3.12.3+ 
-- **Rust:** 1.89.0+
-- **maturin:** 1.9.1
-
-## Project Layout & Architecture
-
-### Root Directory Structure
-```
-/
-├── .github/           # Workflows, issue templates, CODEOWNERS
-├── src/              # Rust source modules
-├── tests/            # Python test files (mirror src/ structure)
-├── assets/           # Documentation assets, banner images
-├── pyproject.toml    # Python project configuration, maturin settings
-├── Cargo.toml        # Rust project configuration, dependencies
-├── requirements.txt  # Runtime dependencies (minimal)
-├── test_requirements.txt  # Development/test dependencies
-└── README.md         # Comprehensive project documentation
-```
-
-### Source Code Architecture (`src/`)
-**Modular Design by Analysis Area:**
-- `lib.rs` - Main module, PyO3 bindings setup, type definitions
-- `candle_indicators.rs` - Ichimoku, Bollinger Bands, Keltner, Supertrend
-- `momentum_indicators.rs` - RSI, MACD, CCI, Williams %R, Stochastic
-- `moving_average.rs` - Simple, Exponential, Smoothed, McGinley Dynamic
-- `standard_indicators.rs` - Basic indicators, moving averages
-- `trend_indicators.rs` - Aroon, Parabolic SAR, DM, TSI
-- `volatility_indicators.rs` - Ulcer Index, Volatility System
-- `strength_indicators.rs` - A/D, PVI, NVI, RVI
-- `chart_trends.rs` - Trend analysis, peak/valley detection
-- `correlation_indicators.rs` - Asset price correlation
-- `other_indicators.rs` - ROI, True Range, ATR
-
-### API Design Patterns
-- **Dual Function Variants:** Each indicator has `bulk` (returns list) and `single` (returns scalar) versions
-- **Type System:** Custom enums (`PyConstantModelType`, `DeviationModel`, `MovingAverageType`) for configuration
-- **Error Handling:** Uses `PyValueError` for invalid inputs with descriptive messages
-
-### Test Structure (`tests/`)
-- **Naming Convention:** `test_<module_name>.py` mirrors `src/<module_name>.rs`
-- **Purpose:** Binding verification, not exhaustive testing (core logic tested in RustTI)
-- **Pattern:** Basic smoke tests to ensure Python-Rust interface works
-
-## CI/CD & Validation Pipelines
-
-### GitHub Workflows
-1. **`python-package.yml`** - Pull request validation
-   - Tests across Python 3.10-3.14 on Ubuntu
-   - Steps: checkout → setup Python → install deps → maturin develop → pytest
-
-2. **`CI.yml`** - Release pipeline (maturin-generated)
-   - Multi-platform wheel building (Linux, Windows, macOS)
-   - Multiple architectures (x86_64, ARM, etc.)
-   - Automatic PyPI publication on tags
-
-### Pre-commit Validation Steps
-```bash
-# Recommended validation sequence:
-source .venv/bin/activate
-pip install -r test_requirements.txt
-maturin develop
-python -m pytest
-cargo fmt --check  # Optional: check Rust formatting
-```
-
-## Development Guidelines
-
-### Making Code Changes
-1. **Rust Changes:** Edit files in `src/`, then run `maturin develop` to rebuild
-2. **Python Tests:** Add corresponding tests in `tests/` following existing patterns
-3. **API Consistency:** Maintain `bulk`/`single` function variants for new indicators
-4. **Type Safety:** Use existing enum types or add new ones following the pattern in `lib.rs`
-
-### Performance Considerations
-- **Rust Backend:** Core calculations optimized for microsecond-level performance
-- **Bulk vs Single:** Use `bulk` for time series, `single` for latest values
-- **Memory:** Rust handles memory management; Python side is minimal overhead
-
-### Dependencies & Updates
-- **Rust Dependencies:** Managed in `Cargo.toml` (pyo3, rust_ti)
-- **Python Dependencies:** Keep `test_requirements.txt` minimal
-- **Version Constraints:** Python 3.10+ required for modern features
-
-## Common Workflows & Commands
-
-### Complete Development Setup
-```bash
-git clone <repo>
-cd CentaurTechnicalIndicators-Python
-python -m venv .venv
-source .venv/bin/activate
-pip install -r test_requirements.txt
-maturin develop
-python -m pytest
-```
-
-### Iterative Development
-```bash
-# After making Rust changes:
-maturin develop  # Rebuild and reinstall
-python -m pytest  # Verify no regressions
-
-# After making Python test changes:
-python -m pytest  # Run updated tests
-```
-
-### Release Preparation
-```bash
-cargo fmt  # Format Rust code
-python -m pytest  # Ensure all tests pass
-# CI handles wheel building and PyPI publication
-```
-
-## Key Files & Configuration
-
-### Build Configuration
-- **`pyproject.toml`:** Python packaging, maturin settings, project metadata
-- **`Cargo.toml`:** Rust compilation, dependencies (pyo3, rust_ti)
-- **`.gitignore`:** Excludes `target/`, `.venv/`, `__pycache__/`, build artifacts
-
-### Documentation Resources
-- **`README.md`:** Complete user documentation, examples, API reference
-- **`CONTRIBUTING.md`:** Contribution guidelines, new indicator process
-- **Wiki:** Full API reference and usage examples
-- **External:** Tutorials, benchmarks, and how-to guides in separate repos
-
-## Trust These Instructions
-
-These instructions are validated and complete. Only perform additional repository exploration if:
-- The build process fails unexpectedly
-- Dependencies have changed significantly
-- New requirements are introduced in documentation
-
-The provided build sequence works reliably and efficiently for the current codebase.