Anclado en 10 hechos verificados del motor real (archivo:línea en el documento completo): NODE_STARTED ya existe en el vocabulario con manejador pero solo lo emite el espejo v1; NODE_SUCCEEDED sale del despachador con payload mínimo; work_items pierde la historia del lease en cada intento; resolveStepRefs es pura con fallback silencioso.
| evento | veredicto | forma final | productor | qué resuelve |
|---|---|---|---|---|
| NODE_QUEUED | no hace falta como evento | columna work_items.created_at, migración en DOS pasos (ADD NULL, luego SET DEFAULT), NULL = histórico desconocido | el INSERT existente del despachador (default de la base) | separar cola de ejecución sin inventar historia ni backfill |
| NODE_STARTED | sí, como registro de intento | fila en node_attempts, identidad = lease_token (attempt es metadata); INSERT inmutable | despachador.reclamar(), dentro del claim SOLO si el benchmark lo aprueba | la frontera cola/ejecución que hoy no existe, con historia por lease físico |
| NODE_COMPLETED | ya existe (NODE_SUCCEEDED) | cierre de la fila de node_attempts: outcome, duraciones, salida_sha256 | POST-COMMIT del cierre, FUERA de la transacción soberana; hueco reconciliable | una falla telemétrica jamás aborta un cierre ya pagado; el log soberano no cambia |
| NODE_FAILED | ya existe | ídem con outcome=failed + error_code; y el claim de un lease vencido cierra el intento anterior como lease_perdido | post-commit + el camino de lease vencido (tercer productor) | ocupación histórica con intervalos finitos aun con leases perdidos |
| EDGE_TRANSFER | sí, lo genuinamente nuevo | filas por OCURRENCIA de referencia: PK (lease_token, input_path, ref_ordinal) + receipt de captura por intento | worker, envoltura que instrumenta la RAMA del resolver (resolved / inline / path_missing / source_missing), batch antes del handler | input bindeado probado SIN payload: sha256 versionado, reproducible contra el work_item del PRODUCTOR REAL (source_work_item_id, aun de otra corrida) |
EDGE_TRANSFER prueba que el dato cruzó SIN almacenar payload: guarda el sha256 del valor resuelto y Graph Health lo verifica offline recomputándolo desde work_items.result del productor. El fallback silencioso del resolver (template sin resolver cuando el camino no existe) se vuelve visible como resuelto=fallback_sin_dato: handoff incompleto medido, no inferido. Volumen: ~8 KB por corrida del brief.
| punto ciego de Graph Health v0.1 | lo elimina | cómo queda |
|---|---|---|
| 56 aristas no_instrumentado | edge_transfers + receipt de captura | estados honestos: verificado / unverifiable / path_missing / source_missing / sin_consumo (SOLO con captura completa) / telemetria_desconocida |
| cola indistinguible de ejecución | node_attempts.leased_at + queued_at | dur_cola_ms y dur_ejecucion_ms exactos por intento; la nota "incluye cola" desaparece del contrato |
| 14 SLAs aparentemente violados | G10 recalculado sobre dur_ejecucion_ms | la mayoría se disuelve (los 47s de s0 con SLA 3s son cola del cron); los que sobreviven son reales y accionables |
| contención de carril ambigua | node_attempts con lease_until_at_claim y cierres lease_perdido | ocupación real por carril con intervalos FINITOS aun con leases perdidos; G7 deja de estimar |
| lineage no reconstruible | cierre transitivo de edge_transfers | el grafo de procedencia OBSERVADO existe por primera vez; lineage_from_steps se valida contra él |
| cambio | zona | tallaje | riesgo y candado |
|---|---|---|---|
| migración: 2 tablas + created_at en dos pasos | migraciones Postgres (crítica por protocolo) | S | lock_timeout de 1s con reintento; NULL = histórico desconocido; tablas nuevas = DROP reversible |
| INSERT inmutable del intento al reclamar | motor v2, dentro del advisory lock | S | benchmark bajo concurrencia OBLIGATORIO antes de fijarlo en la transacción |
| UPDATE de cierre post-commit + cierre de intentos con lease vencido | motor v2 | S | fuera de la transacción soberana; hueco reconciliable desde work_items/run_events |
| resolver instrumentado | motor v2 | M | candado: test de equivalencia byte a byte contra la función pura |
| INSERT batch de consumos + receipt de captura | motor v2 (worker) | S | try/catch; el receipt hace legales las conclusiones de ausencia |
| funciones y handlers de Inngest | Inngest | 0 | NO SE TOCAN; el único contacto es que despachador/worker corren dentro del cron |
| run_events / reducer / espejo | log soberano | 0 | intocados por diseño |
Reversibilidad: flag TELEMETRIA_GRAPH_HEALTH default off; rollback = quitar flag + DROP de las dos tablas. Cinco mordidas obligatorias de W2: fallo del batch → telemetria_desconocida (nunca sin_consumo); lease robado → intento anterior cerrado como lease_perdido con intervalo finito; fallo de insert no tumba el nodo; equivalencia byte a byte del resolver; lease ajeno no pisa fila ajena.
El cerebro (chatgpt-web/extra-high) revisó v0.1 con el código real al lado y la BLOQUEÓ: la tesis base (tablas laterales, resolver observador, hash sin payload) es defendible, pero el diseño podía producir evidencia falsa justo en retries, lease robado, pérdida de telemetría y recuperación heredada. Los 8 hallazgos están adoptados en v0.2; ninguno quedó abierto.
La identidad del intento dependía de attempt, un invariante asumido: el material no demuestra que el claim incremente work_items.attempts.
corrección adoptada: PK = lease_token (el lease físico ES la identidad); attempt degradado a metadata.
La PK de edge_transfers (run, nodo, attempt, from_step, campo) perdía referencias inline múltiples al mismo step en el mismo campo: ON CONFLICT se tragaba una en silencio.
corrección adoptada: PK = (lease_token, input_path JSON Pointer, ref_ordinal): identidad por OCURRENCIA de referencia.
Con batch best-effort, "sin consumo" era indistinguible de "perdimos la telemetría": Graph Health habría fabricado G1 falsos.
corrección adoptada: Receipt de captura por intento (edge_capture_status + edge_count); sin receipt completo, el único estado legal es telemetria_desconocida.
outcome=lease_perdido no tenía productor suficiente (el cierre que descubre el robo lanza LeasePerdidoError sin cerrar nada) y la ocupación histórica quedaba abierta.
corrección adoptada: Tercer productor: el claim de un lease vencido cierra el intento anterior por su lease_token, con lost_at y lease_until_at_claim.
El hash no constituía la prueba reproducible prometida: en herencia el productor vive en OTRA corrida, y productor/verificador pueden canonicalizar distinto.
corrección adoptada: source_run_id + source_work_item_id obligatorios en herencia; canonical_version; fixtures compartidos TS↔Python; source ausente = unverifiable, nunca mismatch.
fallback_sin_dato inferido comparando input/output: un upstream puede producir literalmente el string del template, el step inexistente devuelve null (no el template), y el regex del resolver ni acepta ?.
corrección adoptada: Instrumentar la RAMA del recorrido (resolved / inline_resolved / path_missing / source_missing), un registro por match inline; sin semántica inventada para ?.
Escribir telemetría dentro de las transacciones soberanas alarga la sección crítica del advisory lock y una falla telemétrica podía abortar el cierre de un paso ya pagado.
corrección adoptada: INSERT inmutable (DO NOTHING) en el claim SOLO si el benchmark lo aprueba; el UPDATE de cierre sale de la transacción soberana (post-commit reconciliable).
created_at NOT NULL DEFAULT now() inventaba historia (colas negativas para filas viejas) y el ALTER TABLE arriesga encolar tráfico detrás del lock.
corrección adoptada: Migración en dos pasos (ADD COLUMN NULL, luego SET DEFAULT), NULL = histórico desconocido, lock_timeout de 1s con reintento.