egutierrez
68bb9fbdae
8 fn-recopilador design-e2e paralelos: - services_api (Go service, schema custom operations.db) - registry_mcp (Go stdio MCP, JSON-RPC handshake test) - sqlite_api (Go service read-only HTTP, query_endpoint) - registry_dashboard (C++ ImGui, NO Go+React como yo supuse) - primitives_gallery (C++ build gate de toda API C++ del registry, 44 .cpp) - pipeline_launcher (Go TUI bubbletea) - docker_tui (Go TUI + go-duckdb) - fn_match (subcmd ./fn, hook helper, fuzzy match) 13/26 apps cubiertas. README documenta: - 6 bugs/drift descubiertos lateral (dag_engine x3, deploy_server, pipeline_launcher, docker_tui). - 3 correcciones de mi prompt (yo asumi stacks incorrectos). - Hallazgos arquitectonicos (primitives_gallery = build gate C++). Pendiente wave 3 (13 apps) + 0121b + 0121c. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
131 lines
6.2 KiB
YAML
131 lines
6.2 KiB
YAML
# app_id: services_api
|
|
# lang: go (CGO_ENABLED=1, go-sqlite3, NO fts5 — no FTS5 features in this app)
|
|
# stack: net/http + SQLite (go-sqlite3) + SSH polling (ssh_exec_go_infra)
|
|
# dir_path: apps/services_api
|
|
# entry: main.go (--bind / --once / --registry / --db flags)
|
|
# service: port 8485, health /api/health, systemd-user
|
|
# ops.db: SI — service_state + service_transition (001_init.sql applied)
|
|
# sin entities/relations/executions del schema fn_operations
|
|
# tests: NO (*_test.go absent) — solo --once como smoke gate
|
|
# basicAuth: NO detectado en main.go / check.go
|
|
# ssh: SI — probeRemote usa infra.SSHExec (ssh_exec_go_infra)
|
|
# e2e port: 8585 (prod 8485 + 100, evita colision)
|
|
# issue: 0121a wave 2 — design-e2e services_api
|
|
# date: 2026-05-19
|
|
#
|
|
# INSTRUCCIONES PARA EL HUMANO:
|
|
# 1. Revisar y ajustar comentarios; luego copiar el bloque e2e_checks:
|
|
# al frontmatter de apps/services_api/app.md (despues de service: block).
|
|
# 2. El check ops_audit invoca fn-recopilador sobre operations.db propia
|
|
# (NO usa el schema estandar fn_operations — solo service_state/service_transition).
|
|
# 3. El check smoke_once usa --once + --db efimera para no contaminar la BD
|
|
# de produccion ni necesitar registry.db real (usa /tmp/fn_e2e_sreg.db con
|
|
# un registry.db vacio).
|
|
# 4. smoke_health sube el binario como daemon real en puerto 8585 y verifica
|
|
# /api/health. Requiere que el check build haya producido el binario.
|
|
# 5. No hay go test porque no existen *_test.go. Si se añaden tests en el
|
|
# futuro, activar el check tests descomentando la entrada correspondiente.
|
|
|
|
e2e_checks:
|
|
# -----------------------------------------------------------------------
|
|
# 1. BUILD
|
|
# CGO_ENABLED=1 porque go-sqlite3 requiere cgo (no hay fts5 en este app,
|
|
# pero el flag no rompe nada y evita confusion futura si se añade FTS).
|
|
# -----------------------------------------------------------------------
|
|
- id: build
|
|
cmd: "cd /home/lucas/fn_registry/apps/services_api && CGO_ENABLED=1 go build -o services_api ."
|
|
timeout_s: 120
|
|
severity: critical
|
|
# por que: si no compila no hay nada que probar
|
|
|
|
# -----------------------------------------------------------------------
|
|
# 2. SMOKE --once
|
|
# Corre un ciclo completo de checks sin arrancar el HTTP server.
|
|
# Usa una BD efimera en /tmp y apunta el registry a fn_registry real
|
|
# (read-only); las queries a registry.db devuelven los targets reales del PC.
|
|
# Exit 0 = el loop no peta al cargar targets + persistir en ops_db.
|
|
# -----------------------------------------------------------------------
|
|
- id: smoke_once
|
|
cmd: >
|
|
cd /home/lucas/fn_registry/apps/services_api &&
|
|
FN_REGISTRY_ROOT=/home/lucas/fn_registry
|
|
./services_api
|
|
--once
|
|
--registry /home/lucas/fn_registry
|
|
--db /tmp/services_api_e2e.db
|
|
--bind 127.0.0.1:8585
|
|
timeout_s: 45
|
|
severity: critical
|
|
# por que: valida que loadTargets + probeLocal + upsertState no panican
|
|
# Nota: SSH remotes daran no-route (sin config SSH en CI) — eso es correcto
|
|
# y no falla el check; el exit code del proceso es 0 si completo el ciclo.
|
|
|
|
# -----------------------------------------------------------------------
|
|
# 3. SMOKE HTTP + HEALTH
|
|
# Arranca el server en background en puerto 8585 con BD efimera,
|
|
# espera que /api/health responda 200.
|
|
# -----------------------------------------------------------------------
|
|
- id: smoke_health
|
|
cmd: >
|
|
cd /home/lucas/fn_registry/apps/services_api &&
|
|
./services_api
|
|
--bind 127.0.0.1:8585
|
|
--registry /home/lucas/fn_registry
|
|
--db /tmp/services_api_e2e_http.db
|
|
--interval 300s &
|
|
health: "http://127.0.0.1:8585/api/health"
|
|
timeout_s: 15
|
|
severity: critical
|
|
# por que: verifica que el HTTP server arranca y responde en el puerto
|
|
# declarado en service.port (proxy: 8585 en lugar de 8485)
|
|
|
|
# -----------------------------------------------------------------------
|
|
# 4. ENDPOINT /api/services (warning — depende de datos del PC)
|
|
# Valida que el endpoint responde JSON bien formado con el campo self_pc.
|
|
# Es warning porque en un PC sin ~/.fn_pc o sin registry.db poblado
|
|
# puede devolver lista vacia pero eso no es un bug.
|
|
# -----------------------------------------------------------------------
|
|
- id: check_services_endpoint
|
|
cmd: >
|
|
curl -sf http://127.0.0.1:8585/api/services |
|
|
python3 -c "import sys,json; d=json.load(sys.stdin); assert 'services' in d and 'self_pc' in d"
|
|
timeout_s: 10
|
|
severity: warning
|
|
# por que: smoke de formato de respuesta del endpoint principal que
|
|
# services_monitor (C++) consume. Un cambio de schema JSON rompe el cliente.
|
|
|
|
# -----------------------------------------------------------------------
|
|
# 5. ENDPOINT /api/pcs (warning)
|
|
# Valida que /api/pcs responde con el campo pcs.
|
|
# -----------------------------------------------------------------------
|
|
- id: check_pcs_endpoint
|
|
cmd: >
|
|
curl -sf http://127.0.0.1:8585/api/pcs |
|
|
python3 -c "import sys,json; d=json.load(sys.stdin); assert 'pcs' in d"
|
|
timeout_s: 10
|
|
severity: warning
|
|
# por que: services_monitor usa /api/pcs para la barra lateral de PCs
|
|
|
|
# -----------------------------------------------------------------------
|
|
# 6. OPS AUDIT
|
|
# Invoca fn-recopilador sobre la operations.db propia.
|
|
# NOTA: esta BD tiene schema propio (service_state, service_transition),
|
|
# NO el schema estandar fn_operations (entities/relations/executions).
|
|
# El recopilador auditara estructura y datos vivos.
|
|
# -----------------------------------------------------------------------
|
|
- id: ops_audit
|
|
ref: "fn-recopilador:apps/services_api"
|
|
severity: warning
|
|
# por que: detecta inconsistencias en service_state (ej. overall invalido,
|
|
# last_check_ts cero en todas las filas = --once nunca corrio)
|
|
|
|
# -----------------------------------------------------------------------
|
|
# OMITIDO: tests
|
|
# No existen *_test.go en apps/services_api. Activar cuando se añadan.
|
|
#
|
|
# - id: tests
|
|
# cmd: "cd /home/lucas/fn_registry/apps/services_api && CGO_ENABLED=1 go test -count=1 ./..."
|
|
# timeout_s: 120
|
|
# severity: critical
|
|
# -----------------------------------------------------------------------
|