v0.3 Gate: Numeric Validation and Compatibility Proof

[TDamiao]

Goal

Move the library from "works" to "trusted" with explicit numeric validation against reference implementations.

Scope

• Compare outputs against TA-Lib (and current compat refs where useful).
• Define and document per-indicator tolerances and warmup alignment rules.
• Publish a compatibility table in README with references and tolerances.

Acceptance criteria

• Compatibility vectors/tests cover priority indicators for v0.3.
• Tolerance policy is documented and enforced in tests.
• README compatibility table is updated and release-ready.
• CI keeps compatibility checks green or reports explicit, justified skips.

Test plan

• Add/update compat fixtures and scripts.
• Validate reproducibility on clean environment.
• Confirm no silent regressions via golden + compat suite.

[TDamiao]

Progresso do Gate #3: Numeric Validation and Compatibility Proof

Feito nesta etapa:

• Politica unica de compatibilidade criada em scripts/compat-policy.json (tolerancia + burn-in por indicador).
• compare-technicalindicators.js e compare-python-refs.py migrados para consumir a policy compartilhada.
• export-compat-vectors.js agora inclui snapshot da policy em meta.compatPolicy para rastreabilidade.
• README atualizado com tabela release-ready por indicador (tolerancia, burn-in, refs bloqueantes e nao bloqueantes).
• Script Python melhorado para falhar com mensagem explicita quando TA-Lib nao estiver instalado.

PR

• chore(compat): enforce shared tolerance and warmup policy #11

Validacao executada

• npm.cmd run test:compat:technicalindicators ?
• npm.cmd run test:compat:python -> falha explicita por dependencia local ausente:
  • TA-Lib unavailable: No module named 'talib'
  • install requirements: pip install -r scripts/requirements-compat.txt

Checklist do #3 (estado atual)

• Vetores/checks de compatibilidade cobrindo indicadores prioritarios
• Politica de tolerancia e warmup documentada e aplicada nos testes/scripts
• Tabela de compatibilidade no README pronta para release
• Scripts com skip/falha explicita por ambiente/dependencia
• Rodar suite Python completa em ambiente com TA-Lib (CI/Linux)
• Revisao e merge dos PRs empilhados

[TDamiao]

Gate concluido com policy de tolerancia/warmup compartilhada (scripts/compat-policy.json) e comparadores JS/Python alinhados no PR #11. Release publicado em v0.3.0: https://github.com/TDamiao/ta-crypto/releases/tag/v0.3.0