# Checkpoint - Tech Spec Roadmap de maturidade do sdd-layer

## Artefato
- Tipo: Tech Spec
- Arquivo local: `docs/roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d/03-techspec.md`
- Estado atual: draft/recorded, ainda não aprovado.
- Reexecução: atualizada em 2026-07-04 sobre a nova base de código.

## Origem
- PRD aprovado: `02-prd.md`
- Discovery: `00-project-discovery.md`
- Risk: `00-risk-classification.md`
- Idea: `01-idea.md`
- Context Pack: `.sdd/intelligence/context-packs/roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d/techspec.md`
- CodeGraph: `ArtifactCommand::Link`, `DiagramCommand`, `DirectAdapter`, `run_cli_workspace_execution_task`, `GitHubProvider`, `github_token`, `fetch_github_last_comment`.

## Decisão necessária
Escolher uma das opções:

- aprovar a Tech Spec revisada e avançar para Tasks;
- pedir ajustes na arquitetura antes de Tasks;
- rejeitar a abordagem e voltar ao PRD.

## Evidências
- `sdd resolve-input "roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d"` confirmou PRD `approved`, Tech Spec `recorded`, próxima etapa `tasks` e Refinement obrigatório.
- `sdd context build --name "roadmap-de-maturidade-do-sdd-layer-gate-unico-de-release-corrigir-jest-do-bot-modul-960734c3de8d" --stage techspec --write` foi executado novamente.
- `git diff --stat` mostrou 58 arquivos alterados, incluindo Rust core, TUI, bot, providers, diagramas, docs, clients e lockfile.
- CodeGraph consultado para as novas superfícies estruturais de artifact link, diagram command, TUI adapters, GitHub provider e block gate.
- Diffs/leitura focada cobriram `Cargo.toml`, `src/domain/orchestrator/block_gate.rs`, `src/main.rs`, `src/tui/runner.rs`, `bot/src/providers/github.ts`, `bot/src/providers/githubWebhook.ts`, `bot/src/providers/githubWebhookReceiver.ts`, `bot/src/__tests__/githubProvider.test.ts` e `bot/src/__tests__/githubWebhook.test.ts`.

## Mudança principal da recomendação
A Tech Spec agora trata o roadmap como estabilização da base atual, não como implementação do zero. A nova ordem sugerida é:

1. estabilizar a base e rodar checks reais;
2. consolidar gate único de release;
3. endurecer GitHub/provider/webhook/block gate;
4. criar maintenance report;
5. modularizar `main.rs` e TUI por fatias;
6. aumentar precisão com golden/property tests.

## Riscos pendentes
- Refinement segue obrigatório por risco `medium`.
- O worktree contém mudanças locais amplas e não deve ser revertido ou reorganizado sem task explícita.
- GitHub provider, webhook, config e migration precisam ser validados como contrato único.
- `execa` já está mockado em teste, mas o import direto no provider segue como risco residual de Jest/ESM/CI.
- Workspace execution multi-provider exige readiness, trace e segurança operacional antes de virar caminho padrão.
- O comando final do release gate ainda precisa ser decidido entre estender `sdd ci` ou criar `sdd release gate`.

## Se aprovado
- Marcar `03-techspec.md` como `approved`.
- Gerar `04-tasks.md` com tasks pequenas e prompts agent provider-neutral.
- Manter Refinement obrigatório antes de Execution.

## Se ajustes
- Atualizar `03-techspec.md`.
- Revalidar `sdd validate-artifact techspec`.
- Apresentar novo checkpoint.
