refactor+docs: Onda 2 — higiene estrutural (R2/R5/market_data) + refresh completo de docs#69
Merged
Merged
Conversation
…esh de docs Backend: - R5 (ADR-006): fórmula central do Kelly extraída para src/risk/position_sizing.full_kelly_fraction (fonte única), consumida pelo endpoint GET /v1/risk/kelly (antes reimplementava inline) e por KellyCriterion. src/risk/ deixa de ser código morto. Contrato da API inalterado; plugar no sizing real fica como cauda do R5. - R2: colisões de nome de classe renomeadas por propósito — protocols.SquadOrchestrator->A2ASquad, adaptive_replanner.AdaptivePlanner-> AdaptiveReplanner, continuous_evaluator.ContinuousEvaluator-> AgentPerformanceEvaluator, intelligent_forgetting.MemoryStore-> RelevanceMemoryStore. - market_data unificado: engine._build_market_data computa TechnicalIndicators real + regime (guarda de warmup) — Grid/MeanReversion exercitam o mesmo caminho do live no backtest, em vez de placeholders. - Removida dependência não usada `ta` (indicadores usam numpy/pandas direto). Frontend (docs/design/pages): - R8 (fatia): utilitário .kpi-row (auto-fit/reflow) nas linhas de KPI das telas + sidebar responsiva < 960px (lacuna do briefing). Docs (refresh completo): - ADR-006; CHANGELOG.md, CONTRIBUTING.md, SECURITY.md criados; mapeamento-dados §8/§9/§3.4, arquitetura §12 (R2/R5), uml e plano-melhorias sincronizados; nova seção §7.7 na auditoria de junho. Verificação: 408 passed / 8 skipped; ruff limpo; console build OK; deploy-config OK. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QehSjYY6mpa1yBhqZxsY6X
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Contexto
Sequência da Onda 1 (PR #68). Enquanto a Onda 1 zerou as anomalias de baixo risco, esta Onda 2 ataca os itens estruturais do backlog (
docs/plano-melhorias.md/arquitetura.md §12R1–R8), mantendo tudo verificável e preservando o invariante central (paper-trading-first, HITL fail-closed, auditável). Ao final, toda a documentação viva foi sincronizada.Backend
src/risk/deixa de ser código morto. A fórmula central do Kelly foi extraída parasrc/risk/position_sizing.full_kelly_fraction(fonte única), agora consumida pelo endpointGET /v1/risk/kelly(que reimplementava inline) e porKellyCriterion. As duas formas eram algebricamente idênticas ((p·b−q)/b ≡ p−(1−p)/b), então o contrato da API não muda. Plugar Kelly no sizing real (SquadOrchestrator._position_quantity) fica como cauda do R5 (muda o trading → validação própria).protocols.SquadOrchestrator→A2ASquad,adaptive_replanner.AdaptivePlanner→AdaptiveReplanner,continuous_evaluator.ContinuousEvaluator→AgentPerformanceEvaluator,intelligent_forgetting.MemoryStore→RelevanceMemoryStore(a de tradingSquadOrchestratoremorchestration/permanece).engine._build_market_dataagora computa umTechnicalIndicatorsreal +regime(guarda de warmup), em vez de placeholders — Grid/MeanReversion exercitam o mesmo caminho do live no backtest (antes MeanReversion ficava inerte).ta(não importada em lugar nenhum; indicadores usam numpy/pandas direto).Frontend (
docs/design/pages).kpi-row(auto-fit/reflow, sem media query por-tela) aplicado às linhas de KPI + sidebar responsiva < 960px — a lacuna que o próprio briefing prometia. Rollout completo de responsividade/a11y segue aberto.Docs — refresh completo
CHANGELOG.md,CONTRIBUTING.md,SECURITY.md,docs/adr/006-kelly-sizing-policy.md.mapeamento-dados.md(§8 dados mortos, §9 anomalias, §3.4 marcados resolvidos/parciais),arquitetura.md §12(R2/R5),uml/arquitetura-uml.md,docs/adr/README.md,docs/plano-melhorias.md(checkboxes), e nova §7.7 na auditoria de junho documentando Ondas 1–2.Backlog que permanece aberto (no plano)
R1 (isolar cluster "BuildToValue"), cauda do R5 (Kelly no sizing real), R3 (política de risco/autonomia única), R6 (rotas de agentes), R8 completo, CandleOut
lo→l.Verificação
408 passed / 8 skipped; cobertura ≥ gate 72%;ruff(E4/E7/E9/F) limpo.npm run build(esbuild) OK;scripts/validate_deploy_config.pyOK.🤖 Generated with Claude Code
https://claude.ai/code/session_01QehSjYY6mpa1yBhqZxsY6X
Generated by Claude Code