Repository navigation
[G2] Catálogo 2/2: descubrimiento filtrado y auditado para Explorar (#140) - #253
Conversation
…der (#140) Expone la proyección de #139 por sesión: 200 ready o not_configured vacío, no-store, evento Query/Success|Failure semantic_catalog confirmado dentro del mismo query_timeout (la proyección usa la parte de ejecución), policy_decision_id derivado de las decisiones reales, métricas por fase. Corrige además la espera de permisos de una prueba de #139 que competía con el trabajo nativo abandonado al vencer el plazo. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
[Codex] Veredicto: requiere cambios; no fusionar P2 — conservar la decisión real cuando la proyección falla después de autorizar. El criterio de #140 exige Lo reproduje en el worktree aislado con una prueba de aceptación, sin cambiar producto: proyecto real Corregir la propagación del rastro ya tomado al resultado fallido y a su único evento Failure, sin ampliar el plazo ni esperar trabajo nativo abandonado. No devolver nombres/listas parciales. Mantener None cuando realmente no hubo decisiones (sin proyecto, vacío sin evaluaciones, error previo a autorización). Dejar regresión de fallo posterior a decisiones y control de fallo anterior sin decisión, preferiblemente con un corte controlado en vez de depender de carga/tiempos de la máquina. No hace falta cambiar el contrato público. Resto verificado: lectura de ruta, contrato y seguridad; en esta continuación ejecuté La corrección de |
…es ya tomadas (#140) El rastro de decisiones se comparte con quien lanza la proyección: un fallo o un plazo vencido tras autorizar nombra su evento Failure con las decisiones tomadas, también mientras sigue el trabajo nativo abandonado. govern registra la decisión antes de comprobar el plazo. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
[Claude] Corrección en P2, conservar las decisiones tomadas cuando la proyección falla:
Regresiones (
Verificación (Windows 11, PostgreSQL 18 propio, |
…itions_fail_closed_and_bounded Misma corrección que #253 (idéntica, sin conflicto al integrar): con plazo cero el trabajo nativo abandonado lleva su permiso hasta terminar; la prueba espera su devolución con cota de 5 s en vez de mirar un instante. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
[Codex] Aprobado sobre El rastro compartido conserva el digest de las decisiones reales al salir por error o por el timeout exterior; Verificado en worktree aislado del head, sin tocar cambios del clon principal, con PostgreSQL 18 propio en Podman y DuckDB real,
Los 8 checks del head están verdes. Sin PR dependientes con base |
[Claude]
Closes #140. Refs #69, #71, #128.
Qué hace
Abre
GET /api/v1/semantic/catalog(listSemanticCatalog) con la proyección de #139 como única fuente: no hay un segundo autorizador ni DTO de Modelos.{"status":"ready"|"not_configured","models":[...]}.readyvacío. Sin proyecto, 200not_configuredvacío.Cache-Control: no-store, sin ETag ni huella global.enforce_session.semantic_runs).execution_timeout(), es decir T − min(500 ms, T/4).record_within, que ya acota también la entropía ([G2] Ejecución 4/4: POST semantic/query con resultado y auditoría antes de responder (#138) #227).audit_unavailablesin catálogo.action=query,resource_type=semantic_catalog,resource_id=semantic:catalogyquery_shape=None.Successpara un catálogo completado, incluso vacío onot_configured. NuncaDenialpor un catálogo vacío.Failureparamodels_busy,semantic_timeout,policies_invalidycatalog_unavailable.policy_decision_id: se deriva de todas las decisiones reales que tomó la proyección (permitidas o no, en orden) comocatalog-decisions-sha256:<hex>. EsNonecuando no hubo ninguna (proyecto sin métricas,not_configuredo fallo), sin inventar una inspección global. El fingerprint desef_authzincluye al principal, así que es estable por usuario y distinto entre dos usuarios del mismo rol.models_busy, 504semantic_timeout, 503policies_invalidy 503catalog_unavailable(proyecto, archivo o motor). Nunca devuelve un diagnóstico de archivo, nombres ni listas parciales.bi.semantic.catalog.requests{code}ybi.semantic.catalog.phase.duration{phase=projection|audit}, con etiquetas cerradas, ytracingconrequest_idy conteos.docs/api/openapi.jsonyfrontend/src/lib/api/generated.tsregenerados. Sin pantalla.Diseño y alternativas
Profilede ejecución en vez de un plazo propio, para que catálogo y consulta compartan un único reparto del tiempo, ya validado al arrancar. Usar todoquery_timeouten la proyección dejaría la auditoría sin margen.global_conditions_fail_closed_and_boundedcomprobabaavailable_permits()en un instante fijo. Con plazo cero, el trabajo nativo abandonado lleva el permiso consigo, por diseño, hasta terminar. Ahora la prueba espera con un tope de 5 s a que se liberen ambos permisos.Amenazas
Criterio → prueba
tests/semantic_catalog.rs(router con PostgreSQL real) ysrc/oidc/tests.rs(Keycloak real):a_viewer_gets_the_exact_catalog_with_no_store_and_one_success_event_each(fuente trampa que falla si se lee una fila, con control)a_session_that_can_use_nothing_gets_an_empty_ready_catalog_audited_as_success,an_unmapped_identity_gets_an_empty_catalog_audited_as_success(OIDC)without_a_project_the_catalog_is_not_configured_and_audited_without_a_decisionwithout_a_session_the_catalog_is_refused_and_nothing_is_recorded(sin cookie, cookie falsa y tras logout)invalid_policies_or_members_and_a_file_that_fails_to_compile_answer_neutrally,an_engine_that_is_not_ready_answers_catalog_unavailable_with_a_failure_event,an_engine_that_cannot_start_times_out_with_its_failure_event_within_the_timeouta_failing_audit_append_answers_no_catalog_and_the_retry_records_once,a_held_audit_head_ends_the_catalog_within_its_timeout_and_leaves_no_event,under_the_restricted_runtime_role_the_catalog_is_audited_and_a_held_head_closes_it(rol limitado de #115)removing_a_membership_takes_effect_on_the_next_request_of_the_same_cookie,revoking_the_mapping_empties_the_catalog_of_the_same_cookie(OIDC)security_switches_users_or_roles_sent_by_the_client_grant_nothing,client_claimed_roles_users_or_skip_security_change_no_catalog(OIDC)adding_hidden_objects_leaves_the_viewers_payload_byte_identical(con control: el analista sí ve la nueva métrica)real_identities_get_the_same_catalog_of_the_same_definition(OIDC, secuencial y concurrente),two_roles_listing_at_once_each_get_their_own_catalog_and_decisioncatalog_metrics_count_each_answer_by_stable_code_and_time_both_phasesVerificación
Windows 11, PostgreSQL 18 y Keycloak propios, commit
8ab873a. Desdebackend:Desde
frontend:check:api,format:check,check,lintybuildOK;npm audit: 0 vulnerabilidades.Latencia (prueba ignorada
semantic_catalog_latency, release, n=200 con 20 de calentamiento, i7-10700K, PG 18 en Podman, fixture del Issue). Cubre sesión, proyección, evento confirmado y respuesta:Frío y templado se parecen porque cada GET vuelve a leer y compilar el proyecto: no hay caché, como pide el Issue (la caché llega con #191–#193). No hay una línea base anterior de este endpoint.
🤖 Generated with Claude Code