data_drain 0.1.19 → 0.2.1

data/docs/execution/archive/v0.2.0.agente-review.md

@@ -0,0 +1,125 @@
+# Observaciones del Agente — v0.2.0
+
+**Reviewer:** opencode/big-pickle  
+**Fecha:** 2026-04-13  
+**Plan revisado:** `docs/execution/v0.2.0.md`
+
+---
+
+## Veredicto General
+
+El plan es **sólido y bien estructurado**. Los problemas identificados son menores y no bloquean la ejecución.
+
+---
+
+## Problemas a Addressar Antes de Ejecutar
+
+### 1. `aws_region` también necesita escape en S3
+
+**Ubicación:** `lib/data_drain/storage/s3.rb:11`
+
+```ruby
+connection.query("SET s3_region='#{@config.aws_region}';")
+```
+
+El plan de Item 1 solo propone `escape_sql` para `aws_access_key_id` y `aws_secret_access_key`, pero `aws_region` también se interpola en SQL. Un valor con `'` rompería el query.
+
+**Acción requerida:** Incluir `aws_region` en la función `escape_sql` del plan.
+
+---
+
+### 2. Falta convención `:integration` tag
+
+**Ubicación:** `spec/spec_helper.rb`
+
+El plan menciona "marcar como `:integration` y skip por default en CI" pero no hay convención definida en `spec_helper.rb`.
+
+**Acción requerida:** Antes de Fase 2, agregar en `spec_helper.rb`:
+```ruby
+config.define_derived_metadata(:integration) do |metadata|
+  metadata[:skip] = "Integration test — requires Postgres real"
+end
+```
+
+---
+
+### 3. Versión de aws-sdk-s3 no verificada
+
+**Ubicación:** Gemfile
+
+El plan usa `Aws::S3::Client.new(stub_responses: true)` (requiere aws-sdk-s3 ~> 1.114 según IMPROVEMENT_PLAN.md).
+
+**Acción requerida:** En Fase 0, verificar:
+```bash
+bundle exec ruby -e "require 'bundler'; puts Bundler.load.specs.find { |s| s.name == 'aws-sdk-s3' }.version"
+```
+
+Si es < 1.114, actualizarla en Gemfile.
+
+---
+
+### 4. Posible conflicto entre `before(:suite)` de spec_helper y ParquetFixtures
+
+**Ubicación:** `spec/spec_helper.rb` vs `spec/support/parquet_fixtures.rb`
+
+El `spec_helper.rb` tiene `config.before(:suite)` que configura DataDrain. Si `ParquetFixtures.generate!` se ejecuta ANTES, fallará porque la config no está seteada.
+
+**Acción requerida:** Mover la configuración de DataDrain a un archivo separado en `spec/support/` que se cargue antes, o asegurar que ParquetFixtures se ejecuta DESPUÉS del `before(:suite)` de spec_helper.
+
+---
+
+## Preguntas a Resolver Antes de Ejecutar
+
+### Q1: ¿Qué caracteres necesita escapar `escape_sql`?
+
+El plan propone:
+```ruby
+def escape_sql(value)
+  value.to_s.gsub("'", "''")
+end
+```
+
+DuckDB usa SQL estándar escaping. ¿Hay que escapar también `\`, `"`, o caracteres de control?
+
+**Recomendación:** Investigar con un test manual en `bin/console` antes de implementar.
+
+---
+
+### Q2: ¿Hay callers que usan `public.table_name` con schema?
+
+El plan de Item 2 restringe `table_name` a identificadores simples (`\A[a-zA-Z_][a-zA-Z0-9_]*\z`). Si hay callers que usan `"public.versions"`, romperá.
+
+**Acción requerida:** Buscar en el monorepo consumidor antes de merge:
+```bash
+rg "table_name.*public\." --type ruby
+```
+
+---
+
+## Recomendaciones Opcionales (Nice to Have)
+
+### R1: Documentar el hook de cleanup de SpecHelper
+
+Agregar comentario en `spec_helper.rb` explicando que `config.after(:each)` limpia `tmp/test_lake` y que cualquier nuevo test que escriba archivos debe usar este directorio.
+
+---
+
+## Checkpoint Sugerido Antes de Iniciar
+
+- [ ] aws-sdk-s3 versión verificada
+- [ ] Convención `:integration` tag definida en spec_helper.rb
+- [ ] Pregunta Q1 (escape_sql) resuelta
+- [ ] Pregunta Q2 (schema.table) verificada en caller
+
+---
+
+## Archivos a Modificar Durante la Ejecución
+
+| Fase | Archivo | Cambio |
+|------|---------|--------|
+| 0 | `Gemfile` | Agregar simplecov |
+| 0 | `spec/spec_helper.rb` | Agregar convención :integration |
+| 1 | `lib/data_drain/validations.rb` | Crear |
+| 1 | `lib/data_drain/engine.rb` | Agregar validación |
+| 1 | `lib/data_drain/file_ingestor.rb` | Agregar validación |
+| 3 | `lib/data_drain/storage/s3.rb` | escape_sql para aws_region también |