sqa-tai 0.1.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c708d46e3d535588af3a14a4d209e32e79a34fa11733c3a20cec8e8a25ddf8f
-  data.tar.gz: 665274f5b878d3165f50edfc78a6c6903c95f3696483357d07b12b929f2a00fb
+  metadata.gz: ae6d7d288fb0bea0c3664ce0daf6cb02d73fb0d9590637431cd276c0b00e9efc
+  data.tar.gz: 8c10225300c771ace26256f9724f37ca84261bb718ebe9e8b061fbc51c7ad1dd
 SHA512:
-  metadata.gz: 72e84001d6624688c24800916e2d9651a13d4047e3dc10e6dd53725b1ea464748890df15e4c35b74e1def91429dc2819750d87529cdb86f2d4fa3a8295fca706
-  data.tar.gz: b0a2341c3d7777326cddd41f50254f9ff5a290c73b63a6782495fc5c94a29759daa7d0d752cc82e1ea2cd3f1f749bb866ed69f76ba89d12cb1afc13959851a66
+  metadata.gz: de3f11e6ca8fdf99034d951a74a35d8930585325a0cd91098330e6765cae71d1600c1b7fae05e79a7a4f50f9a1e2f164e4998520037179fca6ff5ea7ca03a479
+  data.tar.gz: 8f6c5bff1286e2833ec9c846b7b6243f9d313b9d17fe49da857567ae97adcfff70b1ab3adf50a17ef5425d24c79840d658563b600de77b3332879515432f2f9f

data/.claude/settings.local.json

@@ -0,0 +1,33 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find:*)",
+      "Bash(bundle exec rake:*)",
+      "Bash(ruby -e:*)",
+      "Bash(gem which:*)",
+      "Bash(xargs dirname:*)",
+      "Bash(xargs:*)",
+      "Bash(gem info:*)",
+      "Bash(ruby analyze_indicators.rb:*)",
+      "Bash(bundle exec rspec:*)",
+      "Bash(ruby count_indicators.rb:*)",
+      "Bash(ruby test_new_indicators.rb:*)",
+      "Bash(ruby verify_count.rb:*)",
+      "Bash(ruby generate_docs.rb:*)",
+      "Bash(mkdocs build:*)",
+      "Bash(test:*)",
+      "Bash(for file in cdl_counterattack.md cdl_darkcloudcover.md cdl_dojistar.md cdl_dragonflydoji.md cdl_eveningdojistar.md cdl_eveningstar.md cdl_gapsidesidewhite.md cdl_gravestonedoji.md cdl_hammer.md cdl_hangingman.md)",
+      "Bash(done)",
+      "Bash(wc:*)",
+      "Bash(for file in cdl_sticksandwich cdl_matchinglow cdl_identical3crows cdl_unique3river cdl_tristar cdl_stalledpattern cdl_tasukigap cdl_xsidegap3methods cdl_upsidegap2crows cdl_longline cdl_shortline)",
+      "Bash(do echo \"Processing $file\")",
+      "Bash(ls:*)",
+      "Bash(ruby:*)",
+      "Bash(git commit:*)",
+      "Bash(mkdir:*)",
+      "Bash(bundle install:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

data/.envrc

@@ -1 +1,6 @@
-export RR=`pwd`
+# sqa_project/sqa-tai/.envrc
+
+source_up
+
+export RR=$(pwd)
+# BUNDLE_GEMFILE is inherited from the project root .envrc (asgard dev|prod)

data/.loki

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+# sqa-tai — Ruby wrapper around TA-Lib, 136+ technical indicators.
+
+import_up "repo_dev.loki"
+
+class Tasks
+  @@gem_name ||= "sqa-tai".freeze
+
+  header "sqa-tai v#{gem_version} — TA-Lib technical indicators"
+end

data/.rubocop.yml

@@ -0,0 +1,221 @@
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  TargetRubyVersion: 4.0
+  Exclude:
+    - 'examples/**/*'
+    - 'docs/**/*'
+    - 'site/**/*'
+    - 'pkg/**/*'
+    - 'coverage/**/*'
+    # Untracked scratch/dev scripts left at repo root in sqa-tai (not part of the shipped gem)
+    - 'add_array_order_note.rb'
+    - 'complete_all_patterns.rb'
+    - 'generate_remaining_patterns.rb'
+
+# ── Style: disabled cops ───────────────────────────────────────────────────
+Style/StringLiterals:
+  Enabled: false
+
+Style/StringLiteralsInInterpolation:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+# Ruby 4.0 freezes string literals by default
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/RescueModifier:
+  Enabled: false
+
+Style/TrivialAccessors:
+  Enabled: false
+
+Style/MultilineTernaryOperator:
+  Enabled: false
+
+Style/SafeNavigation:
+  Enabled: false
+
+Style/EmptyClassDefinition:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/RescueStandardError:
+  Enabled: false
+
+Style/OneClassPerFile:
+  Enabled: false
+
+# Both % and format/sprintf are acceptable
+Style/FormatString:
+  Enabled: false
+
+# String concatenation and interpolation are both acceptable
+Style/StringConcatenation:
+  Enabled: false
+
+# OpenStruct is a deliberate architectural choice throughout this ecosystem —
+# strategy/backtest/stream vectors are built as OpenStructs on purpose (see
+# sqa/CLAUDE.md). Not a candidate for a Struct/class/test-double rewrite.
+Style/OpenStructUse:
+  Enabled: false
+
+# $DEBUG_ME (debug_me gem convention) and test fixture globals like $data are
+# established patterns here, not accidental global-variable leaks.
+Style/GlobalVars:
+  Enabled: false
+
+# ── Layout ─────────────────────────────────────────────────────────────────
+Layout/LineLength:
+  Max: 140
+
+Layout/ExtraSpacing:
+  Enabled: false
+
+Layout/HashAlignment:
+  Enabled: false
+
+Layout/FirstHashElementIndentation:
+  Enabled: false
+
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+
+# ── Naming ─────────────────────────────────────────────────────────────────
+# Single-char params (c, e, n) are acceptable throughout
+Naming/MethodParameterName:
+  Enabled: false
+
+# sma_20, percentile_95, and similar parameterized names are more readable
+# than the normalcase default (sma20, percentile95). alpha_vantage_api.rb is
+# excluded entirely: it mirrors Alpha Vantage's literal API function/parameter
+# names (t3, timeperiod1/2/3, ...) verbatim, which we can't rename. Same
+# reasoning for sqa-tai's overlap_studies.rb (t3) and momentum_indicators.rb
+# (ultosc's time_period1/2/3) — TA-Lib's own C function/parameter names.
+Naming/VariableNumber:
+  EnforcedStyle: snake_case
+  Exclude:
+    - 'test/**/*'
+    - 'lib/api/alpha_vantage_api.rb'
+    - 'lib/sqa/tai/overlap_studies.rb'
+    - 'lib/sqa/tai/momentum_indicators.rb'
+    - 'lib/sqa/data_frame/yahoo_finance.rb' # period1/period2 mirror Yahoo's own chart API query params verbatim
+
+# sqa-cli's gem entry point must be lib/sqa-cli.rb (hyphen) so that
+# `require 'sqa-cli'` resolves by exact match on the gem name; renaming to
+# snake_case would break the require path. (Only sqa-cli has such a file.)
+Naming/FileName:
+  Exclude:
+    - 'lib/sqa-cli.rb'
+
+Naming/RescuedExceptionsVariableName:
+  Enabled: false
+
+# set_results and similar explicit setters are clear and conventional
+Naming/AccessorMethodName:
+  Enabled: false
+
+# has_tool_calls? and similar are clear and conventional
+Naming/PredicatePrefix:
+  Enabled: false
+
+# Test helper methods don't need to follow predicate naming rules
+Naming/PredicateMethod:
+  Exclude:
+    - 'test/**/*'
+
+# ── Lint: relax noisy cops on intentional patterns ─────────────────────────
+Lint/EmptyBlock:
+  Exclude:
+    - 'test/**/*'
+
+# Library and framework methods commonly accept args for API/documentation purposes
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'Rakefile'
+    - 'test/**/*'
+
+# ── Gemspec ────────────────────────────────────────────────────────────────
+# All 5 sqa gem repos declare dev deps directly in the gemspec (not a Gemfile
+# group) — the opposite convention from robot_lab_project, so match reality.
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+
+Gemspec/OrderedDependencies:
+  Enabled: false
+
+# ── Metrics ────────────────────────────────────────────────────────────────
+# Flog is the primary complexity gate (see repo_dev.loki flog_check) — these
+# RuboCop thresholds catch only egregious outliers without duplicating flog's
+# more precise per-method scoring.
+
+Metrics/MethodLength:
+  Max: 35
+  CountAsOne:
+    - heredoc
+    - array
+    - hash
+  Exclude:
+    - 'test/**/*'
+    - 'bin/**/*'
+
+Metrics/AbcSize:
+  Max: 40
+  Exclude:
+    - 'test/**/*'
+    - 'bin/**/*'
+
+Metrics/ClassLength:
+  Max: 650 # matches robot_lab_project: central orchestrator classes are legitimately large
+  Exclude:
+    - 'test/**/*'
+    - 'bin/**/*'
+
+Metrics/ModuleLength:
+  Max: 200
+  Exclude:
+    - 'test/**/*'
+    - 'bin/**/*'
+    # Many independent thin TA-Lib indicator wrappers — naturally long by breadth, not complexity
+    - 'lib/sqa/tai/pattern_recognition.rb'
+    - 'lib/sqa/tai/momentum_indicators.rb'
+    # Cohesive groups of route helpers extracted during the flog complexity pass
+    - 'lib/sqa_demo/sinatra/helpers/api_helpers.rb'
+    - 'lib/sqa_demo/sinatra/helpers/stock_loader.rb'
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+    - 'bin/**/*'
+
+Metrics/PerceivedComplexity:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+    - 'bin/**/*'
+
+# Long method signatures with keyword args are common in this codebase
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'Rakefile'
+    - '*.gemspec'
+    - 'test/**/*'
+    - 'bin/**/*'

data/CHANGELOG.md

@@ -7,6 +7,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-18
+### Changed
+- Dropped the unmaintained `ta_lib_ffi` gem dependency. `sqa-tai` now talks
+  to the installed TA-Lib C library directly via a vendored Fiddle binding
+  (`SQA::TAI::Native`), using TA-Lib's own abstract interface
+  (`TA_GetFuncInfo`/`TA_Get{Input,OptInput,Output}ParameterInfo`) to
+  discover each function's signature at runtime instead of depending on
+  hand-written, unmaintained bindings.
+### Fixed
+- Fixed an ABI mismatch where `ta_lib_ffi`'s `TA_FuncInfo` struct declared
+  a `camelCaseName` field that doesn't exist in current TA-Lib builds
+  (Homebrew's 0.8.x community fork), which misaligned every subsequent
+  struct field and caused any indicator call to hang while allocating
+  unbounded memory.
+- Fixed indicators whose TA-Lib input is `TA_Input_Price` (all OHLC(V)
+  indicators and all 61 candlestick pattern functions) to bundle their
+  price arrays into a single argument (e.g. `atr([high, low, close], ...)`)
+  as the C API requires, instead of passing them as separate positional
+  arguments — this had previously been worked around with a monkey patch
+  (`lib/extensions/ta_lib_ffi.rb`, now removed) that patched the wrong
+  layer instead of fixing the call sites.
+
+## [0.3.0] - 2026-07-02
+- Coordinated version bump to v0.3.0 across the SQA workspace.
+
+## [0.1.2] 2025-11-13
+### Added
+- Help system for accessing indicator documentation (`SQA::TAI.help`)
+  - Returns URLs to online documentation for any indicator
+  - Supports searching by name, filtering by category, and listing all indicators
+  - Auto-generated from mkdocs documentation files via `rake help:generate`
+  - Flexible API returns Help::Resource objects with formatted output
+  - Optional browser integration to open documentation directly
+  - Zeitwerk-compatible namespace structure with `help/resource.rb` and `help/data.json`
+  - Lazy-loaded JSON data for improved gem load performance
+  - Formatted `to_s` output displaying indicator name, category, and website URL
+
 ## [0.1.1] 2025-11-13
 ### Added
 - Intraday Momentum Index (IMI) indicator

data/Gemfile

@@ -4,14 +4,6 @@ source "https://rubygems.org"
 
 gemspec
 
-group :development, :test do
-  gem "rake", "~> 13.0"
-  gem "minitest", "~> 5.0"
-  gem "minitest-reporters"
-  gem "simplecov", require: false
-  gem "debug"
-end
-
 group :documentation do
   # MkDocs is Python-based, managed separately
   # See docs/README.md for setup instructions

data/Gemfile.local

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Local cross-repo development Gemfile.
+#
+# sqa-tai is the leaf of the SQA dependency chain (it has no sibling
+# SQA-ecosystem dependencies), so this file is identical to Gemfile.
+# It exists so that `BUNDLE_GEMFILE=Gemfile.local` works uniformly in
+# every repo of the workspace.
+#
+# Activate with:  BUNDLE_GEMFILE=Gemfile.local bundle <command>
+
+source "https://rubygems.org"
+
+gemspec
+
+group :documentation do
+  # MkDocs is Python-based, managed separately
+  # See docs/README.md for setup instructions
+end

data/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <h1>SQA::TAI - Technical Analysis Indicators</h1>
 
-  <p>Ruby wrapper around [TA-Lib](https://ta-lib.org/) providing **136 technical analysis indicators** for stock market analysis.<br/>
+  <p>Ruby wrapper around [TA-Lib](https://ta-lib.org/) providing **134 technical analysis indicators** for stock market analysis.<br/>
       Part of the [SQA](https://github.com/MadBomber/sqa) (Simple Qualitative Analysis) ecosystem.</p>
 </div>
 
@@ -15,14 +15,13 @@
 
 ## Features
 
-- 🚀 **136 Indicators** - Comprehensive coverage with 94% of trading-relevant TA-Lib indicators
-- ⚡ **Blazing Fast** - C library performance with Ruby convenience
+- 🚀 **134 Indicators** - Comprehensive coverage with 94% of trading-relevant TA-Lib indicators
+- ⚡ **Blazing Fast** - Talks directly to the TA-Lib C library via a vendored Fiddle binding, no unmaintained FFI gem in between
 - 🎯 **Clean API** - Simple, intuitive Ruby interface with keyword arguments
 - 📊 **Comprehensive** - Overlap studies, momentum, volatility, volume, cycles, stats, patterns
 - 🔌 **Easy Integration** - Works seamlessly with existing Ruby trading tools
 - ✅ **Well Tested** - 73 tests, 332 assertions, 100% passing
 - 📚 **Documented** - Full documentation at [madbomber.github.io/sqa-tai](https://madbomber.github.io/sqa-tai)
-- 🔧 **Bug Fixed** - Includes monkey patch for ta_lib_ffi 0.3.0 multi-array parameter bug
 
 </td>
 </tr>
@@ -86,17 +85,45 @@ if SQA::TAI.available?
 end
 ```
 
-## Available Indicators (136 Total)
+## Getting Help on Indicators
 
-### Overlap Studies (15)
-- **SMA, EMA, WMA** - Moving Averages
+Access comprehensive documentation for any indicator directly from your code:
+
+```ruby
+# Get documentation URL for an indicator
+help = SQA::TAI.help(:sma)
+puts help.url
+# => https://madbomber.github.io/sqa-tai/indicators/overlap/sma/
+
+# Open documentation in browser
+SQA::TAI.help(:rsi, open: true)
+
+# Search for indicators
+SQA::TAI.help(search: "momentum")
+# => {mom: "https://...", cmo: "https://...", ...}
+
+# List all indicators in a category
+SQA::TAI.help(category: :momentum_indicators)
+# => {rsi: "https://...", macd: "https://...", ...}
+
+# Get all available indicators
+SQA::TAI.help(:all)
+# => {sma: "https://...", ema: "https://...", ...}
+```
+
+See the [Help System Guide](https://madbomber.github.io/sqa-tai/getting-started/help/) for more details.
+
+## Available Indicators (134 Total)
+
+### Overlap Studies (17)
+- **SMA, EMA, WMA, MA** - Moving Averages
 - **DEMA, TEMA, TRIMA** - Advanced Moving Averages
 - **KAMA, T3, MAMA** - Adaptive Moving Averages
-- **BBANDS** - Bollinger Bands
+- **BBANDS, ACCBANDS** - Bands
 - **SAREXT, HT_TRENDLINE** - Trend indicators
 - **MIDPOINT, MIDPRICE, MAVP** - Price calculations
 
-### Momentum Indicators (30)
+### Momentum Indicators (31)
 - **RSI** - Relative Strength Index
 - **MACD, MACDEXT, MACDFIX** - MACD variants
 - **STOCH, STOCHF, STOCHRSI** - Stochastic variants
@@ -110,6 +137,7 @@ end
 - **BOP** - Balance of Power
 - **CMO** - Chande Momentum Oscillator
 - **MFI** - Money Flow Index
+- **IMI** - Intraday Momentum Index
 - **PLUS_DI, MINUS_DI, PLUS_DM, MINUS_DM** - Directional indicators
 - **TRIX** - Triple Smooth EMA
 - **ULTOSC** - Ultimate Oscillator
@@ -282,7 +310,6 @@ The gem is available as open source under the terms of the [MIT License](LICENSE
 ## Acknowledgments
 
 - [TA-Lib](https://ta-lib.org/) - The underlying C library
-- [ta_lib_ffi](https://github.com/TA-Lib/ta-lib-ruby) - Ruby FFI wrapper
 
 ## Support
 

data/Rakefile

@@ -11,3 +11,228 @@ Rake::TestTask.new(:test) do |t|
 end
 
 task default: :test
+
+desc "Check code style with RuboCop"
+task :rubocop do
+  sh "bundle exec rubocop --format simple"
+end
+
+desc "Auto-correct RuboCop offenses"
+task :rubocop_fix do
+  sh "bundle exec rubocop -A"
+end
+
+desc "Check code complexity with Flog (warn >=20, fail >=50)"
+task :flog_check do
+  require "flog"
+
+  warn_threshold = 20.0
+  fail_threshold = 50.0
+
+  flogger = Flog.new(all: true)
+  flogger.flog(*Dir.glob("lib/**/*.rb"))
+
+  warnings = []
+  failures = []
+
+  flogger.each_by_score do |method, score|
+    next if method.end_with?("#none")
+
+    if score > fail_threshold
+      failures << "#{format("%.1f", score)}: #{method}"
+    elsif score > warn_threshold
+      warnings << "#{format("%.1f", score)}: #{method}"
+    end
+  end
+
+  unless warnings.empty?
+    puts "\nFlog warnings (#{warn_threshold}–#{fail_threshold}) — target for future refactoring:"
+    warnings.each { |v| puts "  #{v}" }
+  end
+
+  if failures.empty?
+    puts "\nFlog: no methods exceed the failure threshold (>=#{fail_threshold})"
+  else
+    puts "\nFlog failures (>=#{fail_threshold}) — must be refactored:"
+    failures.each { |v| puts "  #{v}" }
+    abort "\nFlog quality gate failed: #{failures.size} method(s) exceed #{fail_threshold}"
+  end
+end
+
+desc "Check for structural code duplication with Flay (mass >= 50)"
+task :flay_check do
+  require "flay"
+
+  mass_threshold = 50
+
+  flay = Flay.new(mass: mass_threshold, diff: false, verbose: false, summary: false, timeout: 60)
+  flay.process(*Dir.glob("lib/**/*.rb"))
+  flay.analyze
+
+  if flay.hashes.empty?
+    puts "\nFlay: no structural duplication detected (mass >= #{mass_threshold})"
+  else
+    puts "\nFlay found structural duplication (mass >= #{mass_threshold}):"
+    flay.report
+    abort "\nFlay quality gate failed: #{flay.hashes.length} pattern(s) detected"
+  end
+end
+
+desc "Check code smells with Reek (fails only on new/worsened files vs .quality/reek_baseline.txt)"
+task :reek_check do
+  require "reek"
+  require "reek/configuration/app_configuration"
+
+  # Resolve .reek.yml by walking up from cwd: a gem-level config wins,
+  # otherwise the shared workspace-level one is used.
+  config_file = nil
+  dir = Pathname.new(Dir.pwd).expand_path
+  loop do
+    candidate = dir.join(".reek.yml")
+    if candidate.exist?
+      config_file = candidate.to_s
+      break
+    end
+    break if dir.root?
+
+    dir = dir.parent
+  end
+  config = config_file ? Reek::Configuration::AppConfiguration.from_path(Pathname.new(config_file)) : nil
+
+  # Smell count per file (only files with at least one smell).
+  current = Dir.glob("lib/**/*.rb").each_with_object({}) do |file, acc|
+    count = Reek::Examiner.new(File.read(file), configuration: config).smells.size
+    acc[file] = count if count.positive?
+  end
+
+  # Grandfathered smell counts from .quality/reek_baseline.txt ("count\tfile").
+  baseline_path = File.join(".quality", "reek_baseline.txt")
+  baseline = {}
+  if File.exist?(baseline_path)
+    File.readlines(baseline_path).each do |line|
+      count, file = line.strip.split("\t", 2)
+      baseline[file] = count.to_i if file && !file.empty?
+    end
+  end
+
+  new_files = current.reject { |file, _| baseline.key?(file) }
+  worsened  = current.select { |file, count| baseline.key?(file) && count > baseline[file] }
+
+  puts "\nReek: #{current.values.sum} warning(s) across #{current.size} file(s) " \
+       "(#{baseline.values.sum} grandfathered across #{baseline.size} file(s))."
+
+  if new_files.empty? && worsened.empty?
+    puts "Reek: no new or worsened files (quality gate passed)"
+  else
+    puts "\nReek quality gate failed:"
+    new_files.each { |file, count| puts "  NEW      #{count.to_s.rjust(3)} warning(s): #{file}" }
+    worsened.each  { |file, count| puts "  WORSENED #{baseline[file].to_s.rjust(3)} -> #{count.to_s.rjust(3)}: #{file}" }
+    abort "\nReek quality gate failed: #{new_files.size + worsened.size} file(s) regressed. " \
+          "Fix smells, or run `asgard reek_baseline` if intentional."
+  end
+end
+
+desc "Run all quality checks: tests (with coverage), Flog, Flay, and Reek"
+task :quality do
+  results = {}
+
+  puts "\n#{"=" * 60}"
+  puts "Quality Gate: Tests + Coverage"
+  puts "=" * 60
+  results[:tests] = system("bundle exec rake test") ? :pass : :fail
+
+  puts "\n#{"=" * 60}"
+  puts "Quality Gate: Flog Complexity"
+  puts "=" * 60
+  results[:flog] = system("bundle exec rake flog_check") ? :pass : :fail
+
+  puts "\n#{"=" * 60}"
+  puts "Quality Gate: Flay Duplication"
+  puts "=" * 60
+  results[:flay] = system("bundle exec rake flay_check") ? :pass : :fail
+
+  puts "\n#{"=" * 60}"
+  puts "Quality Gate: Reek Smells"
+  puts "=" * 60
+  results[:reek] = system("bundle exec rake reek_check") ? :pass : :fail
+
+  puts "\n#{"=" * 60}"
+  puts "Quality Summary"
+  puts "=" * 60
+  results.each do |gate, status|
+    icon = status == :pass ? "PASS" : "FAIL"
+    puts "  [#{icon}] #{gate}"
+  end
+  puts "=" * 60
+
+  abort "\nQuality gate failed" if results.values.any?(:fail)
+  puts "\nAll quality gates passed."
+end
+
+namespace :help do
+  desc "Generate help mappings from documentation files"
+  task :generate do
+    require "fileutils"
+
+    indicators = {}
+    category_mapping = {
+      "overlap" => :overlap_studies,
+      "momentum" => :momentum_indicators,
+      "volatility" => :volatility_indicators,
+      "volume" => :volume_indicators,
+      "price_transform" => :price_transform,
+      "statistical" => :statistical_functions,
+      "cycle" => :cycle_indicators,
+      "patterns" => :pattern_recognition
+    }
+
+    # Scan docs directory
+    Dir.glob("docs/indicators/**/*.md").each do |file|
+      next if file.include?("index.md")
+
+      # Extract indicator name from filename
+      indicator = File.basename(file, ".md").to_sym
+
+      # Extract category from path
+      path_category = File.dirname(file).split("/").last
+      category = category_mapping[path_category] || path_category.to_sym
+
+      # Read first heading for name
+      name = nil
+      File.open(file, "r") do |f|
+        f.each_line do |line|
+          next unless line.start_with?("# ")
+          name = line.gsub(/^#\s*/, "").strip
+          # Remove content after parentheses if present
+          name = name.split("(").first.strip if name.include?("(")
+          break
+        end
+      end
+
+      # Build path relative to docs/
+      path = file.gsub("docs/", "").gsub(".md", "")
+
+      indicators[indicator] = {
+        name: name || indicator.to_s.upcase,
+        category: category,
+        path: path
+      }
+    end
+
+    # Convert to JSON-friendly format (strings instead of symbols)
+    json_data = indicators.transform_keys(&:to_s).transform_values do |meta|
+      {
+        "name" => meta[:name],
+        "category" => meta[:category].to_s,
+        "path" => meta[:path]
+      }
+    end
+
+    # Write to JSON file
+    require "json"
+    json_output = JSON.pretty_generate(json_data)
+    File.write("lib/sqa/tai/help/data.json", json_output)
+    puts "✓ Generated help data for #{indicators.size} indicators"
+    puts "  File: lib/sqa/tai/help/data.json"
+  end
+end