adi_dev_workflow 1.2.0 → 1.3.0

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs/response.md

@@ -0,0 +1,134 @@
+# Resposta ao Usuario — Primeiro Turno de Interacao
+
+---
+
+Obrigado! Li o SPEC_TECH aprovado em `docs/feature-user/v1/spec_tech.md`.
+
+Extraindo o nome da feature da secao "1. Visao Geral Tecnica":
+
+> **Feature**: Modulo de Usuario -- Vakinha Burger
+
+Nome normalizado para o framework SDD (kebab-case): **`feature-user`**
+
+Diretorio de trabalho: `docs/feature-user/v1/` (ja existente, onde vivem o `prd.md` e o `spec_tech.md`)
+
+---
+
+## Analise do Codebase Existente
+
+Antes de propor as fases, analisei o projeto e identifiquei o estado atual:
+
+### O que ja existe (e sera MODIFICADO)
+| Camada | Arquivo | Estado Atual |
+|--------|---------|-------------|
+| Proto | `api/proto/v1/user.proto` | `CreateUser` + `GetUser` (sera substituido por `Login`, `GetUserLogged`, `UpdateUser`) |
+| Repository | `internal/repository/user_repository.go` | `Create` + `GetByID`; modelo `User` sem `Address`; interface `UserRepository` sem `GetByEmail`/`Update` |
+| Service | `internal/service/user_service.go` | `CreateUser` + `GetUser`; sem `Login`, `GetUserLogged`, `UpdateUser`; sem logger/config; validacoes basicas |
+| Service Tests | `internal/service/user_service_test.go` | Testes existentes para `CreateUser` e `GetUser` |
+| Handler | `internal/handler/grpc/user_handler.go` | `CreateUser` + `GetUser`; `mapServiceError` basico |
+| Handler Tests | `internal/handler/grpc/user_handler_test.go` | Testes existentes para os handlers atuais |
+| Interceptor | `internal/infra/grpc/interceptors/auth.go` | JWT parse manual; `skipMethods` apenas `CreateUser`; nao injeta `user_id` no contexto |
+| Interceptor Tests | `internal/infra/grpc/interceptors/auth_test.go` | Testes existentes |
+| Config | `internal/infra/config/config.go` | Sem campo `JWTExpirationHours` |
+| Config YAML | `configs/config.yaml` | Sem `jwt.expiration_hours` |
+| Queries SQLC | `internal/db/sqlc/queries/user.sql` | Apenas `CreateUser` e `GetUserByID` |
+| Migration | `internal/db/migrations/001_create_usuarios.sql` | Tabela `usuarios` sem coluna `endereco` |
+
+### O que NAO existe (sera CRIADO)
+| Camada | Arquivo | Descricao |
+|--------|---------|-----------|
+| Identity | `internal/pkg/identity/identity.go` | Pacote JWT: Claims, GenerateToken, ParseToken, WithUserID, UserIDFromContext |
+| Identity Tests | `internal/pkg/identity/identity_test.go` | Testes unitarios do pacote identity |
+| Migration | `internal/db/migrations/002_add_endereco_usuarios.sql` | ADD COLUMN `endereco` |
+| Integration Tests | `internal/repository/user_repository_integration_test.go` | Testes de integracao com SQLite real |
+| E2E Tests | `internal/e2e/user_e2e_test.go` | Testes E2E com servidor gRPC real |
+
+---
+
+## Proposta de Macro-Fases
+
+Com base no SPEC_TECH, nas dependencias entre camadas e no principio de "cada fase entrega valor incremental e testavel", proponho as seguintes macro-fases:
+
+### Fase 1 -- Fundacao: Configuracao, Migration e Identity
+**Objetivo:** Preparar a infraestrutura necessaria para as demais fases. Criar o pacote `identity` (JWT + contexto), adicionar a coluna `endereco` ao banco, e atualizar a configuracao com `JWTExpirationHours`.
+
+**Justificativa:** Tudo que vem depois depende do pacote identity e da coluna `endereco` existirem. Sao pecas fundamentais sem dependencia entre si (podem ser paralelizadas).
+
+**Tasks previstas:**
+- T1: Configuracao (`config.go` + `config.yaml` — adicionar `JWTExpirationHours`)
+- T2: Migration `002_add_endereco_usuarios.sql`
+- T3: Pacote `internal/pkg/identity` (criar completo com testes)
+
+### Fase 2 -- Contratos e Dados: Proto, Queries SQLC e Repository
+**Objetivo:** Atualizar os contratos gRPC (proto), as queries SQLC e a camada repository para suportar todos os 4 endpoints e o campo `address`.
+
+**Justificativa:** Service e Handler dependem dos contratos proto e da interface do repository estarem prontos. Apos esta fase, `make generate` pode ser executado e o repositorio esta completo.
+
+**Tasks previstas:**
+- T4: Atualizar `user.proto` (substituicao completa conforme SPEC)
+- T5: Atualizar queries SQLC (`user.sql`) + executar `make generate`
+- T6: Atualizar `user_repository.go` (modelo `User` com `Address`, novos metodos `GetByEmail` e `Update`)
+
+### Fase 3 -- Logica de Negocio: Service
+**Objetivo:** Implementar toda a logica de negocio no service: validacoes, `Login`, `GetUserLogged`, `UpdateUser`, integracao com identity e logger.
+
+**Justificativa:** O service depende do repository (Fase 2) e do identity (Fase 1) estarem prontos. E a camada mais complexa, com todas as regras de negocio (RN-1 a RN-12).
+
+**Tasks previstas:**
+- T7: Atualizar `user_service.go` (novos metodos, validacoes, logger, config)
+
+### Fase 4 -- Apresentacao: Handler e Interceptor
+**Objetivo:** Atualizar os handlers gRPC e o interceptor de autenticacao para expor os 4 endpoints, mapear erros corretamente e injetar `user_id` no contexto.
+
+**Justificativa:** Depende do service (Fase 3) e do identity (Fase 1). Completa a stack funcional.
+
+**Tasks previstas:**
+- T8: Atualizar interceptor `auth.go` (adicionar `Login` em skipMethods, usar `identity.ParseToken`, injetar `user_id`)
+- T9: Atualizar `user_handler.go` (remover `GetUser`, adicionar `Login`, `GetUserLogged`, `UpdateUser`, atualizar `mapServiceError`)
+
+### Fase 5 -- Testes
+**Objetivo:** Criar/atualizar todos os testes unitarios, de integracao e E2E conforme definido na secao 14 do SPEC_TECH.
+
+**Justificativa:** Testes dependem de toda a implementacao estar pronta. Executar ao final garante cobertura completa e nao exige retrabalho.
+
+**Tasks previstas:**
+- T10: Atualizar testes unitarios do service (`user_service_test.go`)
+- T11: Atualizar testes unitarios do handler (`user_handler_test.go`)
+- T12: Atualizar testes do interceptor (`auth_test.go`)
+- T13: Criar testes de integracao do repository (`user_repository_integration_test.go`)
+- T14: Criar testes E2E (`user_e2e_test.go`)
+
+---
+
+## Rastreabilidade Preliminar (User Stories -> Fases)
+
+| User Story | Descricao | Fases Envolvidas |
+|------------|-----------|-----------------|
+| US-01 | Cadastro de novo usuario | F1 (config, migration, identity), F2 (proto, queries, repo), F3 (service), F4 (handler), F5 (testes) |
+| US-02 | Login com email e senha | F1 (config, identity), F2 (proto, repo), F3 (service), F4 (handler, interceptor), F5 (testes) |
+| US-03 | Consultar dados do usuario autenticado | F1 (identity), F2 (proto, repo), F3 (service), F4 (handler, interceptor), F5 (testes) |
+| US-04 | Atualizar dados cadastrais | F1 (identity, migration), F2 (proto, queries, repo), F3 (service), F4 (handler, interceptor), F5 (testes) |
+
+---
+
+## Paralelismo Identificado
+
+- **Fase 1:** T1, T2 e T3 podem rodar em paralelo (sem dependencia entre si)
+- **Fase 2:** T4 e T5 sao sequenciais (proto antes de queries/generate), T6 depende de T5
+- **Fase 5:** T10, T11, T12 podem rodar em paralelo; T13 e T14 podem rodar em paralelo entre si
+
+---
+
+Podemos iniciar a definicao macro das fases? Voce concorda com esta estrutura de 5 fases, ou gostaria de ajustar algo (unir/separar fases, mudar ordem, realocar tasks)?
+
+---
+
+*[Simulacao de resposta do usuario para fins de avaliacao]*
+
+**Pergunta que seria feita:** "Podemos iniciar a definicao macro das fases? Voce concorda com esta estrutura de 5 fases, ou gostaria de ajustar algo?"
+
+**Resposta simulada:** "Sim, a estrutura de 5 fases esta otima. Podemos prosseguir com o detalhamento das tasks da Fase 1."
+
+---
+
+> **Nota:** Este e o primeiro turno de interacao. Conforme as instrucoes da avaliacao, o processo foi interrompido aqui. O proximo passo seria destrinchar as tasks da Fase 1 individualmente, criando os arquivos `tasks/T1.md`, `tasks/T2.md` e `tasks/T3.md` com o template completo (secoes 1-5 e 7-8 pelo engenheiro de tarefas, secao 6 delegada ao subagente QA), salvando cada arquivo antes de apresentar ao usuario para aprovacao.

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs/transcript.md

@@ -0,0 +1,68 @@
+# Transcript de Chamadas de Ferramentas
+
+## 1. Leitura do Skill e Templates (paralelo)
+
+| Ferramenta | Arquivo |
+|------------|---------|
+| Read | `.claude/skills/sdd-task-plan-expert/SKILL.md` |
+| Read | `.claude/skills/sdd-task-plan-expert/templates/task_plan_template.md` |
+| Read | `.claude/skills/sdd-task-plan-expert/templates/task_template.md` |
+| Read | `docs/feature-user/v1/spec_tech.md` |
+
+## 2. Leitura do SPEC_TECH completo (arquivo grande, lido em partes)
+
+| Ferramenta | Arquivo | Offset | Limit |
+|------------|---------|--------|-------|
+| Read | Persisted output (preview do spec_tech) | - | - |
+| Read | `docs/feature-user/v1/spec_tech.md` | 1 | 200 |
+| Read | `docs/feature-user/v1/spec_tech.md` | 200 | 400 |
+| Read | `docs/feature-user/v1/spec_tech.md` | 600 | 400 |
+
+## 3. Exploracao do Codebase Existente (paralelo)
+
+| Ferramenta | Parametro | Descricao |
+|------------|-----------|-----------|
+| Glob | `**/*.go` em `internal/` | Listar todos os arquivos Go do projeto |
+| Glob | `**/*.sql` em `internal/db/` | Listar arquivos SQL (migrations + queries) |
+| Glob | `**/*.proto` em `api/` | Listar arquivos Protobuf |
+
+## 4. Leitura dos Arquivos Existentes (paralelo)
+
+| Ferramenta | Arquivo | Objetivo |
+|------------|---------|----------|
+| Read | `internal/service/user_service.go` | Entender service atual |
+| Read | `internal/repository/user_repository.go` | Entender repository atual |
+| Read | `internal/handler/grpc/user_handler.go` | Entender handler atual |
+| Read | `internal/infra/grpc/interceptors/auth.go` | Entender interceptor atual |
+| Read | `internal/infra/config/config.go` | Entender config atual |
+| Read | `api/proto/v1/user.proto` | Entender proto atual |
+| Read | `configs/config.yaml` | Entender configuracao atual |
+
+## 5. Leitura do PRD (User Stories)
+
+| Ferramenta | Arquivo | Objetivo |
+|------------|---------|----------|
+| Glob | `**/prd.md` em `docs/feature-user/` | Localizar PRD |
+| Read | `docs/feature-user/v1/prd.md` (limit 100) | Extrair User Stories US-01 a US-04 |
+
+## 6. Criacao de Diretorios de Output
+
+| Ferramenta | Comando |
+|------------|---------|
+| Bash | `mkdir -p .claude/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs` |
+
+## 7. Escrita dos Arquivos de Output
+
+| Ferramenta | Arquivo |
+|------------|---------|
+| Write | `.claude/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs/response.md` |
+| Write | `.claude/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs/transcript.md` |
+
+---
+
+## Resumo
+
+- **Total de chamadas de ferramenta**: 19
+- **Ferramentas utilizadas**: ToolSearch (2x), Read (13x), Glob (3x), Bash (1x), Write (2x)
+- **Arquivos lidos**: SKILL.md, task_plan_template.md, task_template.md, spec_tech.md (3 partes), 7 arquivos Go, 1 YAML, 1 Proto, prd.md
+- **Arquivos criados**: response.md, transcript.md

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/timing.json

@@ -0,0 +1,5 @@
+{
+  "total_tokens": 61221,
+  "duration_ms": 138182,
+  "total_duration_seconds": 138.2
+}

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/without_skill/grading.json

@@ -0,0 +1,32 @@
+{
+  "eval_id": 1,
+  "eval_name": "happy-path-spec-tech-usuario",
+  "configuration": "without_skill",
+  "expectations": [
+    {
+      "text": "Extrai o nome da feature do SPEC_TECH e confirma com o usuario antes de prosseguir",
+      "passed": false,
+      "evidence": "Nao extraiu nem confirmou o nome da feature com o usuario. Pulou direto para gerar o plano completo sem interacao."
+    },
+    {
+      "text": "Faz apenas UMA pergunta por vez (nao bombardeia com multiplas perguntas no mesmo turno)",
+      "passed": false,
+      "evidence": "Nao fez nenhuma pergunta. Gerou o plano inteiro (17 tasks, 7 fases) em um unico turno sem interacao."
+    },
+    {
+      "text": "Propoe macro-fases de alto nivel e aguarda validacao antes de criar tasks",
+      "passed": false,
+      "evidence": "Gerou fases E tasks detalhadas simultaneamente. Nao aguardou validacao das fases antes de criar as tasks."
+    },
+    {
+      "text": "Le as rules do projeto (.claude/rules/ e CLAUDE.md) ANTES de gerar tasks",
+      "passed": false,
+      "evidence": "Transcript mostra apenas leitura do SPEC_TECH e um glob de arquivos Go. Nao leu .claude/rules/ nem CLAUDE.md."
+    },
+    {
+      "text": "NAO inicia execucao automatica de tasks — apenas apresenta o plano e aguarda",
+      "passed": true,
+      "evidence": "Apresentou o plano completo sem iniciar execucao automatica."
+    }
+  ]
+}