# Idea - Roadmap de maturidade do sdd-layer

## Rastreabilidade
- Orquestração: `roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d`
- Slug: `roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d`
- Stage: idea
- Estado atual: recorded
- Artefatos de origem: `00-project-discovery.md`, `00-risk-classification.md`
- Context Pack: `.sdd/intelligence/context-packs/roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d/idea.md`

## Problema
O `sdd-layer` já tem uma base forte de contratos, CLI determinístico, doctors, docs e client surfaces, mas a evolução recente criou fricções de maturidade que podem reduzir confiança no release e velocidade de manutenção:

- não existe um gate único de release que cubra Rust, docs, bot, health e checks opcionais;
- o bot TypeScript compila, mas a suíte Jest quebra ao carregar `execa` ESM;
- `src/main.rs` e arquivos centrais da TUI concentram responsabilidades demais;
- integrações Jira/GitHub ainda precisam de timeout, retry, rate-limit e testes com mock server;
- a precisão de artefatos SDD depende de validações mínimas, mas ainda pode evoluir com golden tests, corpus e property tests;
- não há um relatório único que mostre saúde por área do projeto.

## Objetivo
Transformar essas melhorias em um programa incremental de maturidade para elevar o projeto de uma base forte para uma plataforma mais previsível, testável e fácil de operar, preservando a decisão já aceita de que o core SDD é runtime-agnostic e provider-neutral.

## Usuários
- Mantenedor do `sdd-layer`, que precisa decidir se um diff está pronto para release.
- Agentes de código que executam tasks SDD e precisam de prompts/checks claros.
- Contribuidores que entram pelo CLI, docs site, bot ou client surfaces.
- Reviewers que precisam separar falhas reais de warnings opcionais/advisory.

## Critérios de sucesso
- Existe um comando ou checklist único de release que cobre core Rust, docs, bot e contratos SDD.
- A suíte do bot roda verde localmente e no CI sem depender de hacks por ambiente.
- A modularização reduz o tamanho e acoplamento dos pontos mais críticos sem reescrever tudo de uma vez.
- Integrações Jira/GitHub têm comportamento previsível para timeout, retry, rate-limit e redaction.
- Golden/property tests capturam regressões de artefatos, slugs, traceability map e validações.
- `sdd maintenance report` entrega uma visão por área com status, riscos e próximos checks.
- O fluxo permanece portável entre providers e clients, usando Markdown, CLI `sdd`, artifact store e evidências locais como contrato comum.

## Diagramas
```mermaid
flowchart TD
  A["Roadmap de maturidade"] --> B["Gate único de release"]
  A --> C["Bot Jest/build estável"]
  A --> D["Modularização CLI/TUI"]
  A --> E["Integrações resilientes"]
  A --> F["Precisão por testes de contrato"]
  A --> G["Maintenance report"]
  B --> H["Readiness objetiva"]
  C --> H
  D --> H
  E --> H
  F --> H
  G --> H
```

## Fora do MVP
- Reescrever `src/main.rs` inteiro em uma única entrega.
- Transformar o bot em runtime obrigatório do CLI.
- Exigir que `cargo audit`, `cargo deny`, `gitleaks` ou SBOM estejam instalados para todo contributor.
- Alterar o contrato runtime-agnostic ou tornar qualquer provider específico obrigatório.
