Análisis de cartera construido sobre una regla: código determinista calcula las cifras y el modelo las narra

El problema

Un informe patrimonial es una lista de cifras, y la mayoría de esas cifras llega sin fuente, sin fecha y sin método. Un tipo de cambio puede ser el de ayer. Una valoración puede apoyarse en un precio que nadie puede rastrear. Cuando se coloca un modelo de lenguaje frente a un informe así, el riesgo crece: el modelo puede producir una frase fluida con una cifra que ningún cálculo respalda.

Portfolio Horizon, descrito en su propia página como "Private Wealth Intelligence System" (sistema de inteligencia patrimonial privada), se construyó sobre una regla y no sobre una promesa: cada cifra tiene fuente, fecha y método, y al modelo de lenguaje nunca se le pide calcular una cifra, solo narrar las cifras que recibe.

Portfolio Horizon no es asesoramiento de inversión y no hace ninguna afirmación de rendimiento.

Qué se construyó

La página pública declara lo que hace el sistema: revaluación de cartera en vivo, análisis de riesgo y lectura probabilística de escenarios. Su titular, en inglés, es "Your portfolio, with every figure traceable." (su patrimonio, con cada cifra trazable). Nombra tres atributos: patrimonio trazable, el tipo de cambio PTAX oficial e IA explicable.

En la página se enumeran seis compromisos: fuente y hora en la cifra mostrada; tipo de cambio PTAX oficial fechado; horizonte y límites por pronóstico; indisponibilidad declarada; idoneidad explícita; lectura probabilística. Cuatro bloques repiten la idea de forma más breve: PTAX, el tipo de cambio oficial fechado; fuentes, con origen y hora visibles; brechas, declaradas en lugar de ocultas; código, es decir, cálculos deterministas.

La cartera que se muestra en la página pública es un ejemplo ilustrativo. Su composición está etiquetada como ficticia y la demostración corre sobre datos sintéticos. No se muestra ninguna cartera de cliente y no se afirma ninguna.

Cómo funciona

La regla del propio repositorio es que toda cifra mostrada proviene de funciones deterministas en src/quant y que el modelo de lenguaje solo narra las cifras que recibe. Lo que se ha medido es más estrecho: las exposiciones, la concentración, la liquidez, el VaR paramétrico y el motor de escenarios son deterministas y están cubiertos por pruebas al centavo (ejecución del 31 de julio de 2026). El modelo de lenguaje se sitúa después de esa etapa: recibe las cifras calculadas y escribe la narrativa alrededor de ellas.

El tipo de cambio sigue una cadena de resolución. El endpoint GET /api/fx resuelve la PTAX de cierre del Banco Central de Brasil (BACEN): primero el boletín de hoy, luego hasta cuatro días hábiles anteriores y, por último, una referencia local etiquetada. La etiqueta mostrada declara qué es el número, con su fecha y su fuente. El 24 de septiembre de 2026 la página pública mostraba el estado de día hábil anterior, con el texto, en inglés, "Latest available PTAX. Official close from the last available business day. Not an intraday quote." (última PTAX disponible; cierre oficial del último día hábil disponible; no es una cotización intradía).

Entre el modelo y el lector hay una frontera de salida diseñada para fallar cerrada. En la suite adversarial documentada ejecutada el 31 de julio de 2026, esa frontera no liberó ninguna cifra financiera sin respaldo bajo el modelo de amenaza especificado: payloads adversariales de prompt contra la vía de orquestación, con la salida del modelo nunca renderizada directamente al cliente. La ruta pública de entrevista de perfil queda fuera de ese alcance y no lleva ninguna afirmación.

Dentro del alcance de los resultados operativos verificados el 31 de julio de 2026, la cifra mostrada informa de dónde viene: su función, su proveedor y su hora de referencia. Dentro del alcance verificado en la misma fecha, la cifra mostrada en el informe abre el rastro de evidencia que la originó. Los pronósticos reciben la misma disciplina. Dentro del alcance verificado el 31 de julio de 2026, el pronóstico mostrado viene acompañado de horizonte, metodología y límites. La página lo resume en cinco palabras: la IA justifica, usted decide.

Evidencia

Todo lo que Portfolio Horizon dice en público está acotado por la allowlist de afirmaciones externas del propio proyecto (la lista de lo que puede decirse), decidida el 31 de julio de 2026, y por un registro de afirmaciones retenidas que anota cada declaración retirada y el motivo (hecho portfolio-horizon-16). La verificación es mecánica: un lint falla si una formulación permitida no consta en la allowlist o si una formulación retenida reaparece en una superficie pública, y cada comando de reproducción de la allowlist se vuelve a ejecutar y su resultado queda registrado.

Las cifras que sobreviven a ese proceso son conteos de pruebas, cada uno ligado a un comando y a una fecha. El 31 de julio de 2026, en la ejecución detrás de la afirmación del núcleo determinista pasaron 67 pruebas en 6 archivos; esa ejecución cubre el núcleo cuantitativo, la cadena PTAX y las afirmaciones de la página de inicio (allowlist EXT-A03, hecho portfolio-horizon-14). En la cadena de resolución de la PTAX, por sí sola, pasaron 11 pruebas, que forman parte de esas 67 (allowlist EXT-A02, hecho portfolio-horizon-13). En la suite adversarial detrás de la frontera de salida fail-closed pasaron 415 pruebas en 11 archivos, y la frontera no liberó ninguna cifra financiera sin respaldo bajo el modelo de amenaza especificado (allowlist EXT-B03, hecho portfolio-horizon-12).

El pie de la propia página declara el límite de lo que afirma, en inglés; en traducción: "Un pronóstico no es una promesa. Dentro del alcance verificado el 31/07/2026, la pantalla predictiva declara horizonte, confianza y límites." (página activa, hecho portfolio-horizon-11). No se publica ninguna cifra de rendimiento, retorno o precisión de pronóstico, porque ninguna está en la allowlist.

Tecnologías

Portfolio Horizon es una aplicación web escrita en TypeScript: React 19 con Vite en el cliente, Express en el servidor, Tailwind CSS para los estilos y Zod para la validación. Los datos viven en PostgreSQL, accedidos mediante el cliente pg y el cliente de Supabase. Vitest ejecuta las pruebas unitarias nombradas en la allowlist y Playwright ejecuta las pruebas de extremo a extremo. El sitio activo corre las mismas tecnologías: el encabezado de respuesta menciona Express y la página carga un bundle de Vite.

Qué demuestra

Definir. La tarea tenía una definición medible antes de elegir cualquier modelo: una lectura patrimonial en la que cada cifra lleva su fuente, su fecha y su método, y en la que las brechas se declaran en lugar de rellenarse.

Instrumentar. La evaluación existe en dos capas. El núcleo cuantitativo está cubierto por pruebas unitarias al centavo y la cadena del tipo de cambio por sus propias pruebas unitarias, ambas en una ejecución fechada el 31 de julio de 2026. La frontera de salida está cubierta por una suite adversarial con un modelo de amenaza declarado. Por encima del código, las propias afirmaciones están instrumentadas: una allowlist de formulaciones exactas, un registro de afirmaciones retenidas y un lint que falla cuando se incumple cualquiera de los dos.

Integrar. La PTAX oficial, la etiqueta de procedencia en la cifra mostrada, el rastro de evidencia y la indisponibilidad declarada forman parte del producto, no de una diapositiva sobre él.

Transferir. La allowlist y el registro de afirmaciones retenidas son el runbook de lo que puede decirse. Sobreviven a la construcción y cualquier persona con el repositorio puede volver a ejecutarlos, que es como NASCIA prefiere entregar un sistema: con las pruebas, los límites y las palabras, todo por escrito.