sqa-tai 0.1.2 → 0.4.0

data/lib/sqa/tai/volatility_indicators.rb

@@ -3,6 +3,13 @@
 module SQA
   module TAI
     # Volatility Indicators
+    #
+    # :reek:DataClump and :reek:LongParameterList -- these methods
+    # intentionally mirror TA-Lib's own C function signatures (separate
+    # high/low/close/period args, up to 7 for sarext); bundling them into
+    # a value object would be a breaking public API change for this gem
+    # and its downstream consumers (sqa, sqa-cli, sqa-advisor) and their
+    # 133 published indicator doc pages.
     module VolatilityIndicators
       # Average True Range
       # @param high [Array<Float>] High prices
@@ -16,7 +23,7 @@ module SQA
         validate_prices!(low)
         validate_prices!(close)
 
-        TALibFFI.atr(high, low, close, time_period: period)
+        Native.atr([high, low, close], time_period: period)
       end
 
       # True Range
@@ -30,7 +37,7 @@ module SQA
         validate_prices!(low)
         validate_prices!(close)
 
-        TALibFFI.trange(high, low, close)
+        Native.trange([high, low, close])
       end
 
       # Normalized Average True Range
@@ -45,7 +52,7 @@ module SQA
         validate_prices!(low)
         validate_prices!(close)
 
-        TALibFFI.natr(high, low, close, time_period: period)
+        Native.natr([high, low, close], time_period: period)
       end
 
       # Parabolic SAR
@@ -59,7 +66,7 @@ module SQA
         validate_prices!(high)
         validate_prices!(low)
 
-        TALibFFI.sar(high, low, acceleration: acceleration, maximum: maximum)
+        Native.sar([high, low], acceleration:, maximum:)
       end
 
       # Parabolic SAR - Extended
@@ -71,17 +78,18 @@ module SQA
       # @param acceleration_step [Float] Acceleration step (default: 0.02)
       # @param acceleration_max [Float] Acceleration max (default: 0.20)
       # @return [Array<Float>] SAREXT values
-      def sarext(high, low, start_value: 0.0, offset_on_reverse: 0.0, acceleration_init: 0.02, acceleration_step: 0.02, acceleration_max: 0.20)
+      def sarext(high, low, start_value: 0.0, offset_on_reverse: 0.0, acceleration_init: 0.02, acceleration_step: 0.02,
+                 acceleration_max: 0.20)
         check_available!
         validate_prices!(high)
         validate_prices!(low)
 
-        TALibFFI.sarext(high, low,
-          start_value: start_value,
-          offset_on_reverse: offset_on_reverse,
-          af_init: acceleration_init,
-          af_increment: acceleration_step,
-          af_max: acceleration_max)
+        Native.sarext([high, low],
+                      start_value:,
+                      offset_on_reverse:,
+                      af_init: acceleration_init,
+                      af_increment: acceleration_step,
+                      af_max: acceleration_max)
       end
 
       # Acceleration Bands
@@ -97,14 +105,8 @@ module SQA
         validate_prices!(close)
         validate_period!(period, [high.size, low.size, close.size].min)
 
-        result = TALibFFI.accbands(high, low, close, time_period: period)
-
-        # Handle hash return format from newer ta_lib_ffi versions
-        if result.is_a?(Hash)
-          [result[:upper_band], result[:middle_band], result[:lower_band]]
-        else
-          result
-        end
+        result = Native.accbands([high, low, close], time_period: period)
+        [result[:upper_band], result[:middle_band], result[:lower_band]]
       end
 
       # Hilbert Transform - Instantaneous Trendline
@@ -114,7 +116,7 @@ module SQA
         check_available!
         validate_prices!(prices)
 
-        TALibFFI.ht_trendline(prices)
+        Native.ht_trendline(prices)
       end
 
       # MESA Adaptive Moving Average
@@ -126,14 +128,8 @@ module SQA
         check_available!
         validate_prices!(prices)
 
-        result = TALibFFI.mama(prices, fastlimit: fast_limit, slowlimit: slow_limit)
-
-        # Handle hash return format from newer ta_lib_ffi versions
-        if result.is_a?(Hash)
-          [result[:mama], result[:fama]]
-        else
-          result
-        end
+        result = Native.mama(prices, fastlimit: fast_limit, slowlimit: slow_limit)
+        [result[:mama], result[:fama]]
       end
 
       # Moving Average with Variable Period
@@ -146,7 +142,7 @@ module SQA
         validate_prices!(prices)
         validate_prices!(periods)
 
-        TALibFFI.mavp(prices, periods, ma_type: ma_type)
+        Native.mavp(prices, periods, ma_type:)
       end
 
       # Midpoint over period
@@ -158,7 +154,7 @@ module SQA
         validate_prices!(prices)
         validate_period!(period, prices.size)
 
-        TALibFFI.midpoint(prices, time_period: period)
+        Native.midpoint(prices, time_period: period)
       end
 
       # Midpoint Price over period
@@ -172,7 +168,7 @@ module SQA
         validate_prices!(low)
         validate_period!(period, [high.size, low.size].min)
 
-        TALibFFI.midprice(high, low, time_period: period)
+        Native.midprice([high, low], time_period: period)
       end
     end
   end

data/lib/sqa/tai/volume_indicators.rb

@@ -13,7 +13,10 @@ module SQA
         validate_prices!(close)
         validate_prices!(volume)
 
-        TALibFFI.obv(close, volume)
+        # OBV's second parameter is a TA_Input_Price bundle consisting of
+        # just the VOLUME flag, so it's still wrapped in an array even
+        # though it's a single series.
+        Native.obv(close, [volume])
       end
 
       # Chaikin A/D Line
@@ -29,7 +32,7 @@ module SQA
         validate_prices!(close)
         validate_prices!(volume)
 
-        TALibFFI.ad(high, low, close, volume)
+        Native.ad([high, low, close, volume])
       end
 
       # Chaikin A/D Oscillator
@@ -40,6 +43,9 @@ module SQA
       # @param fast_period [Integer] Fast period (default: 3)
       # @param slow_period [Integer] Slow period (default: 10)
       # @return [Array<Float>] ADOSC values
+      # :reek:LongParameterList -- mirrors TA-Lib's own ADOSC signature;
+      # bundling these would be a breaking public API change (see
+      # MomentumIndicators/VolatilityIndicators for the fuller rationale).
       def adosc(high, low, close, volume, fast_period: 3, slow_period: 10)
         check_available!
         validate_prices!(high)
@@ -47,7 +53,7 @@ module SQA
         validate_prices!(close)
         validate_prices!(volume)
 
-        TALibFFI.adosc(high, low, close, volume, fast_period: fast_period, slow_period: slow_period)
+        Native.adosc([high, low, close, volume], fast_period:, slow_period:)
       end
     end
   end

data/lib/sqa/tai.rb

@@ -1,10 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "tai/version"
-require "ta_lib_ffi"
-
-# Apply monkey patch to fix ta_lib_ffi 0.3.0 multi-array parameter bug
-require_relative "../extensions/ta_lib_ffi"
+require_relative "tai/native"
 
 # Require all indicator modules
 require_relative "tai/overlap_studies"
@@ -38,7 +35,7 @@ module SQA
     class << self
       # Check if TA-Lib C library is available
       def available?
-        defined?(TALibFFI) && TALibFFI.respond_to?(:sma)
+        Native.available?
       rescue LoadError
         false
       end
@@ -77,45 +74,57 @@ module SQA
       #   SQA::TAI.help(search: "moving average")
       #
       def help(indicator = nil, **options)
-        # List all indicators
-        if indicator == :all
-          return Help.indicators.transform_values { |meta| "#{Help::BASE_URL}/#{meta[:path]}/" }
-        end
+        return help_all_indicators if indicator == :all
+        return help_by_category(options[:category]) if options[:category]
+        return help_by_search(options[:search]) if options[:search]
 
-        # Category listing
-        if options[:category]
-          category_indicators = Help.indicators.select { |_k, v| v[:category] == options[:category] }
-          return category_indicators.transform_values { |meta| "#{Help::BASE_URL}/#{meta[:path]}/" }
-        end
+        help_for_indicator(indicator, options)
+      end
+
+      private
+
+      # Build a hash of {indicator => url} from a set of indicator metadata entries
+      def help_urls_for(meta_entries)
+        meta_entries.transform_values { |meta| "#{Help::BASE_URL}/#{meta[:path]}/" }
+      end
+
+      def help_all_indicators
+        help_urls_for(Help.indicators)
+      end
+
+      def help_by_category(category)
+        category_indicators = Help.indicators.select { |_k, v| v[:category] == category }
+        help_urls_for(category_indicators)
+      end
 
-        # Search
-        if options[:search]
-          query = options[:search].downcase
-          matches = Help.indicators.select do |k, v|
-            k.to_s.include?(query) || v[:name].downcase.include?(query)
-          end
-          return matches.transform_values { |meta| "#{Help::BASE_URL}/#{meta[:path]}/" }
+      def help_by_search(search)
+        query = search.downcase
+        matches = Help.indicators.select do |k, v|
+          k.to_s.include?(query) || v[:name].downcase.include?(query)
         end
+        help_urls_for(matches)
+      end
 
-        # Single indicator
+      def help_for_indicator(indicator, options)
         meta = Help.indicators[indicator]
         raise ArgumentError, "Unknown indicator: #{indicator}" unless meta
 
         resource = Help::Resource.new(indicator, meta[:name], meta[:category], meta[:path])
-
-        # Open in browser if requested
         resource.open if options[:open]
 
-        # Return format
-        case options[:format]
+        format_help_resource(resource, meta, options[:format])
+      end
+
+      # :reek:ControlParameter -- dispatches on the caller-requested output
+      # shape (:uri/:hash/default); that's the method's whole job.
+      def format_help_resource(resource, meta, format)
+        case format
         when :uri then resource.uri
-        when :hash then {name: meta[:name], category: meta[:category], url: resource.url}
+        when :hash then { name: meta[:name], category: meta[:category], url: resource.url }
         else resource # Return Help::Resource object (responds to to_s)
         end
       end
 
-      private
-
       def validate_prices!(prices)
         raise InvalidParameterError, "Prices array cannot be nil" if prices.nil?
         raise InvalidParameterError, "Prices array cannot be empty" if prices.empty?

data/mkdocs.yml

@@ -145,33 +145,171 @@ nav:
     - Installation: getting-started/installation.md
     - Quick Start: getting-started/quick-start.md
     - Basic Usage: getting-started/basic-usage.md
+    - Pattern Recognition Guide: getting-started/pattern-recognition.md
     - Help System: getting-started/help.md
+  - Concepts:
+    - Technical Analysis Basics: basics.md
+    - Support and Resistance: concepts/support-resistance.md
   - Indicators:
     - Overview: indicators/index.md
     - Overlap Studies:
-      - Simple Moving Average: indicators/overlap/sma.md
-      - Exponential Moving Average: indicators/overlap/ema.md
-      - Weighted Moving Average: indicators/overlap/wma.md
-      - Bollinger Bands: indicators/overlap/bbands.md
+      - Overview: indicators/overlap/index.md
+      - ACCBANDS (Acceleration Bands): indicators/overlap/accbands.md
+      - BBANDS (Bollinger Bands): indicators/overlap/bbands.md
+      - DEMA (Double Exponential Moving Average): indicators/overlap/dema.md
+      - EMA (Exponential Moving Average): indicators/overlap/ema.md
+      - HT_TRENDLINE (Hilbert Transform - Instantaneous Trendline): indicators/volatility/ht_trendline.md
+      - KAMA (Kaufman Adaptive Moving Average): indicators/overlap/kama.md
+      - MA (Moving Average - Generic Interface): indicators/overlap/ma.md
+      - MAMA (MESA Adaptive Moving Average): indicators/volatility/mama.md
+      - Moving Average with Variable Period (MAVP): indicators/volatility/mavp.md
+      - Midpoint Over Period (MIDPOINT): indicators/volatility/midpoint.md
+      - Midpoint Price (MIDPRICE): indicators/volatility/midprice.md
+      - Parabolic SAR Extended (SAREXT): indicators/volatility/sarext.md
+      - SMA (Simple Moving Average): indicators/overlap/sma.md
+      - T3 (Tillson T3 Moving Average): indicators/overlap/t3.md
+      - TEMA (Triple Exponential Moving Average): indicators/overlap/tema.md
+      - TRIMA (Triangular Moving Average): indicators/overlap/trima.md
+      - VWAP (Volume-Weighted Average Price): indicators/overlap/vwap.md
+      - WMA (Weighted Moving Average): indicators/overlap/wma.md
     - Momentum:
-      - RSI: indicators/momentum/rsi.md
-      - MACD: indicators/momentum/macd.md
-      - Stochastic: indicators/momentum/stoch.md
-      - Momentum: indicators/momentum/mom.md
+      - ADX (Average Directional Index): indicators/momentum/adx.md
+      - Average Directional Movement Index Rating (ADXR): indicators/momentum/adxr.md
+      - Absolute Price Oscillator (APO): indicators/momentum/apo.md
+      - Aroon Indicator (AROON): indicators/momentum/aroon.md
+      - Aroon Oscillator (AROONOSC): indicators/momentum/aroonosc.md
+      - Balance of Power (BOP): indicators/momentum/bop.md
+      - Commodity Channel Index (CCI): indicators/momentum/cci.md
+      - Chande Momentum Oscillator (CMO): indicators/momentum/cmo.md
+      - Directional Movement Index (DX): indicators/momentum/dx.md
+      - Intraday Momentum Index (IMI): indicators/momentum/imi.md
+      - MACD (Moving Average Convergence Divergence): indicators/momentum/macd.md
+      - MACD with Controllable MA Type (MACDEXT): indicators/momentum/macdext.md
+      - Moving Average Convergence Divergence - Fixed Parameters (MACDFIX): indicators/momentum/macdfix.md
+      - MFI (Money Flow Index): indicators/momentum/mfi.md
+      - Minus Directional Indicator (MINUS_DI): indicators/momentum/minus_di.md
+      - Minus Directional Movement (MINUS_DM): indicators/momentum/minus_dm.md
+      - Momentum (MOM): indicators/momentum/mom.md
+      - Plus Directional Indicator (+DI): indicators/momentum/plus_di.md
+      - Plus Directional Movement (PLUS_DM): indicators/momentum/plus_dm.md
+      - Percentage Price Oscillator (PPO): indicators/momentum/ppo.md
+      - Rate of Change (ROC): indicators/momentum/roc.md
+      - Rate of Change Percentage (ROCP): indicators/momentum/rocp.md
+      - Rate of Change Ratio (ROCR): indicators/momentum/rocr.md
+      - Rate of Change Ratio 100 Scale (ROCR100): indicators/momentum/rocr100.md
+      - RSI (Relative Strength Index): indicators/momentum/rsi.md
+      - Stochastic Oscillator (STOCH): indicators/momentum/stoch.md
+      - STOCHF (Fast Stochastic Oscillator): indicators/momentum/stochf.md
+      - Stochastic Relative Strength Index (STOCHRSI): indicators/momentum/stochrsi.md
+      - TRIX (Triple Exponential Average): indicators/momentum/trix.md
+      - Ultimate Oscillator (ULTOSC): indicators/momentum/ultosc.md
+      - "Williams %R (WILLR)": indicators/momentum/willr.md
     - Volatility:
-      - Average True Range: indicators/volatility/atr.md
-      - True Range: indicators/volatility/trange.md
+      - Average True Range (ATR): indicators/volatility/atr.md
+      - Keltner Channels: indicators/volatility/keltner.md
+      - NATR (Normalized Average True Range): indicators/volatility/natr.md
+      - Parabolic SAR (Stop and Reverse): indicators/volatility/sar.md
+      - True Range (TRANGE): indicators/volatility/trange.md
     - Volume:
-      - On Balance Volume: indicators/volume/obv.md
-      - Chaikin A/D Line: indicators/volume/ad.md
+      - Overview: indicators/volume/index.md
+      - AD (Chaikin Accumulation/Distribution Line): indicators/volume/ad.md
+      - ADOSC (Chaikin A/D Oscillator): indicators/volume/adosc.md
+      - CMF (Chaikin Money Flow): indicators/volume/cmf.md
+      - On Balance Volume (OBV): indicators/volume/obv.md
+    - Cycle:
+      - Overview: indicators/cycle/index.md
+      - HT_DCPERIOD (Hilbert Transform - Dominant Cycle Period): indicators/cycle/ht_dcperiod.md
+      - HT_DCPHASE (Hilbert Transform - Dominant Cycle Phase): indicators/cycle/ht_dcphase.md
+      - HT_PHASOR (Hilbert Transform - Phasor Components): indicators/cycle/ht_phasor.md
+      - HT_SINE (Hilbert Transform - Sine Wave Indicator): indicators/cycle/ht_sine.md
+      - HT_TRENDMODE (Hilbert Transform - Trend vs Cycle Mode): indicators/cycle/ht_trendmode.md
+    - Statistical Functions:
+      - Overview: indicators/statistical/index.md
+      - Beta Coefficient (BETA): indicators/statistical/beta.md
+      - "CORREL (Pearson's Correlation Coefficient)": indicators/statistical/correl.md
+      - Linear Regression (LINEARREG): indicators/statistical/linearreg.md
+      - Linear Regression Angle (LINEARREG_ANGLE): indicators/statistical/linearreg_angle.md
+      - Linear Regression Intercept (LINEARREG_INTERCEPT): indicators/statistical/linearreg_intercept.md
+      - Linear Regression Slope (LINEARREG_SLOPE): indicators/statistical/linearreg_slope.md
+      - Standard Deviation (STDDEV): indicators/statistical/stddev.md
+      - Time Series Forecast (TSF): indicators/statistical/tsf.md
+      - Variance (VAR): indicators/statistical/var.md
+    - Price Transform:
+      - Overview: indicators/price_transform/index.md
+      - AVGPRICE (Average Price): indicators/price_transform/avgprice.md
+      - Median Price (MEDPRICE): indicators/price_transform/medprice.md
+      - Typical Price (TYPPRICE): indicators/price_transform/typprice.md
+      - Weighted Close Price (WCLPRICE): indicators/price_transform/wclprice.md
     - Patterns:
       - Overview: indicators/patterns/index.md
-      - Doji: indicators/patterns/cdl_doji.md
-      - Hammer: indicators/patterns/cdl_hammer.md
-      - Engulfing: indicators/patterns/cdl_engulfing.md
+      - Two Crows Pattern: indicators/patterns/cdl_2crows.md
+      - Three Black Crows Pattern: indicators/patterns/cdl_3blackcrows.md
+      - Three Inside Up/Down Pattern: indicators/patterns/cdl_3inside.md
+      - Three Line Strike Pattern: indicators/patterns/cdl_3linestrike.md
+      - Three Outside Up/Down Pattern: indicators/patterns/cdl_3outside.md
+      - Three Stars in the South Pattern: indicators/patterns/cdl_3starsinsouth.md
+      - Three White Soldiers Pattern: indicators/patterns/cdl_3whitesoldiers.md
+      - Abandoned Baby Pattern: indicators/patterns/cdl_abandonedbaby.md
+      - Advance Block Pattern: indicators/patterns/cdl_advanceblock.md
+      - Belt Hold Pattern: indicators/patterns/cdl_belthold.md
+      - Breakaway Pattern: indicators/patterns/cdl_breakaway.md
+      - Closing Marubozu Pattern: indicators/patterns/cdl_closingmarubozu.md
+      - Concealing Baby Swallow Pattern: indicators/patterns/cdl_concealbabyswall.md
+      - Counterattack Pattern: indicators/patterns/cdl_counterattack.md
+      - Dark Cloud Cover Pattern: indicators/patterns/cdl_darkcloudcover.md
+      - CDL_DOJI (Doji Candlestick Pattern): indicators/patterns/cdl_doji.md
+      - CDL_DOJISTAR (Doji Star Candlestick Pattern): indicators/patterns/cdl_dojistar.md
+      - Dragonfly Doji Pattern: indicators/patterns/cdl_dragonflydoji.md
+      - Engulfing Pattern: indicators/patterns/cdl_engulfing.md
+      - CDL_EVENINGDOJISTAR (Evening Doji Star): indicators/patterns/cdl_eveningdojistar.md
+      - CDL_EVENINGSTAR (Evening Star): indicators/patterns/cdl_eveningstar.md
+      - CDL_GAPSIDESIDEWHITE (Up/Down-Gap Side-by-Side White Lines): indicators/patterns/cdl_gapsidesidewhite.md
+      - CDL_GRAVESTONEDOJI (Gravestone Doji): indicators/patterns/cdl_gravestonedoji.md
+      - Hammer Pattern: indicators/patterns/cdl_hammer.md
+      - CDL_HANGINGMAN (Hanging Man Candlestick Pattern): indicators/patterns/cdl_hangingman.md
+      - CDL_HARAMI (Harami): indicators/patterns/cdl_harami.md
+      - CDL_HARAMICROSS (Harami Cross): indicators/patterns/cdl_haramicross.md
+      - CDL_HIGHWAVE (High Wave Candle): indicators/patterns/cdl_highwave.md
+      - CDL_HIKKAKE (Hikkake Pattern): indicators/patterns/cdl_hikkake.md
+      - CDL_HIKKAKEMOD (Modified Hikkake Pattern): indicators/patterns/cdl_hikkakemod.md
+      - CDL_HOMINGPIGEON (Homing Pigeon): indicators/patterns/cdl_homingpigeon.md
+      - CDL_IDENTICAL3CROWS (Identical Three Crows): indicators/patterns/cdl_identical3crows.md
+      - CDL_INNECK (In-Neck Pattern): indicators/patterns/cdl_inneck.md
+      - CDL_INSIDE - See Three Inside Up/Down: indicators/patterns/cdl_inside.md
+      - CDL_INVERTEDHAMMER (Inverted Hammer): indicators/patterns/cdl_invertedhammer.md
+      - CDL_KICKING (Kicking Pattern): indicators/patterns/cdl_kicking.md
+      - CDL_KICKINGBYLENGTH (Kicking By Length): indicators/patterns/cdl_kickingbylength.md
+      - CDL_LADDERBOTTOM (Ladder Bottom): indicators/patterns/cdl_ladderbottom.md
+      - CDL_LONGLEGGEDDOJI (Long-Legged Doji): indicators/patterns/cdl_longleggeddoji.md
+      - CDL_LONGLINE (Long Line Candle): indicators/patterns/cdl_longline.md
+      - CDL_MARUBOZU (Marubozu): indicators/patterns/cdl_marubozu.md
+      - CDL_MATCHINGLOW (Matching Low): indicators/patterns/cdl_matchinglow.md
+      - CDL_MATHOLD (Mat Hold): indicators/patterns/cdl_mathold.md
+      - CDL_MEETINGLINES (Meeting Lines): indicators/patterns/cdl_meetinglines.md
+      - CDL_MORNINGDOJISTAR (Morning Doji Star): indicators/patterns/cdl_morningdojistar.md
+      - CDL_MORNINGSTAR (Morning Star): indicators/patterns/cdl_morningstar.md
+      - CDL_ONNECK (On-Neck Pattern): indicators/patterns/cdl_onneck.md
+      - CDL_PIERCING (Piercing Pattern): indicators/patterns/cdl_piercing.md
+      - CDL_RICKSHAWMAN (Rickshaw Man): indicators/patterns/cdl_rickshawman.md
+      - CDL_RISEFALL3METHODS (Rising/Falling Three Methods): indicators/patterns/cdl_risefall3methods.md
+      - CDL_SEPARATINGLINES (Separating Lines): indicators/patterns/cdl_separatinglines.md
+      - CDL_SHOOTINGSTAR (Shooting Star): indicators/patterns/cdl_shootingstar.md
+      - CDL_SHORTLINE (Short Line Candle): indicators/patterns/cdl_shortline.md
+      - CDL_SPINNINGTOP (Spinning Top): indicators/patterns/cdl_spinningtop.md
+      - CDL_STALLEDPATTERN (Stalled Pattern): indicators/patterns/cdl_stalledpattern.md
+      - CDL_STICKSANDWICH (Stick Sandwich): indicators/patterns/cdl_sticksandwich.md
+      - CDL_TAKURI (Takuri Line (Dragonfly Doji at Support)): indicators/patterns/cdl_takuri.md
+      - CDL_TASUKIGAP (Tasuki Gap): indicators/patterns/cdl_tasukigap.md
+      - CDL_THRUSTING (Thrusting Pattern): indicators/patterns/cdl_thrusting.md
+      - CDL_TRISTAR (Tristar): indicators/patterns/cdl_tristar.md
+      - CDL_UNIQUE3RIVER (Unique 3 River): indicators/patterns/cdl_unique3river.md
+      - CDL_UPSIDEGAP2CROWS (Upside Gap Two Crows): indicators/patterns/cdl_upsidegap2crows.md
+      - CDL_XSIDEGAP3METHODS (Upside/Downside Gap Three Methods): indicators/patterns/cdl_xsidegap3methods.md
   - API Reference: api-reference.md
   - Examples:
     - Trend Analysis: examples/trend-analysis.md
     - Momentum Trading: examples/momentum-trading.md
     - Volatility Analysis: examples/volatility-analysis.md
+    - Trend Following: examples/trend-following.md
+    - Adaptive Indicators: examples/adaptive-indicators.md
   - Contributing: contributing.md

data/sqa-tai.gemspec

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require_relative "lib/sqa/tai/version"
+
+Gem::Specification.new do |spec|
+  spec.name         = "sqa-tai"
+  spec.version      = SQA::TAI::VERSION
+  spec.authors      = ["Dewayne VanHoozer"]
+  spec.email        = ["dvanhoozer@gmail.com"]
+
+  spec.summary      = "SQA::TAI - Technical Analysis Indicators"
+  spec.description  = "An SQA-specific Fiddle binding directly against the installed TA-Lib C library, providing many " \
+                      "technical analysis indicators for stock analysis. Part of the SQA (Simple Qualitative Analysis) ecosystem."
+  spec.homepage     = "https://github.com/MadBomber/sqa-tai"
+  spec.license      = "MIT"
+
+  spec.required_ruby_version = ">= 3.4.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"]      = spec.homepage
+  spec.metadata["source_code_uri"]   = spec.homepage
+  spec.metadata["changelog_uri"]     = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["documentation_uri"] = "https://madbomber.github.io/sqa-tai"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[test/ spec/ features/ .git .github/ docs/])
+    end
+  end
+
+  spec.require_paths = ["lib"]
+
+  # Core dependency
+  spec.add_dependency "fiddle" # Ruby 3.5+ moved this to a bundled (not default) gem
+  spec.add_dependency "myway_config"  # XDG-aware configuration management (extends anyway_config)
+
+  # Development dependencies
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "minitest-reporters"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "debug"
+  spec.add_development_dependency "debug_me"
+  spec.add_development_dependency "flog"
+  spec.add_development_dependency "flay"
+  spec.add_development_dependency "racc" # flog/flay transitively need this on Ruby 4+
+  spec.add_development_dependency "reek" # code smell gate (rake reek_check)
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "fasterer" # performance-hint gate (asgard fasterer_check); not in bundle by
+  # default, so `bundle exec fasterer` silently fails into fasterer_output.txt without this
+end