CodeSeal: dale a tu código un historial que puedas revisar

Me gusta publicar cosas. También me gusta poder explicar qué publiqué seis meses después. Cuando una aplicación mezcla código escrito a mano, código generado, librerías y arreglos de madrugada, esa segunda parte se complica. Un commit ayuda, pero quien recibe un paquete quizá no tenga acceso al repositorio.

Para eso creamos CodeSeal, el registro de procedencia de aplicaciones de ProgreTech. Lo digo claramente: es uno de nuestros productos y esta guía es de primera parte. Su aporte es un registro firmado de huellas del código observado y su historial. No es una insignia mágica de seguridad. Si desarrollas herramientas, entregas proyectos o mantienes aplicaciones con ayuda de IA, empieza así.

Prepara algo que puedas compartir

Abre el analizador de CodeSeal y elige un ZIP o un repositorio GitHub compatible. Para la primera prueba utiliza un proyecto pequeño tuyo. Retira secretos, información privada, dependencias generadas y material que no tengas permiso de enviar. Un repositorio público y uno privado conectado mediante una cuenta siguen flujos distintos; el segundo depende de la integración y de tu autorización.

CodeSeal calcula huellas del código compatible sin ejecutar la aplicación. Los archivos son entradas temporales; el registro conserva evidencia y metadatos. Temporal no significa que los bytes nunca salgan de tu equipo. Revisa también nombres de archivos y etiquetas, que pueden revelar información.

Existen marcadores para excluir secciones privadas, pero el filtrado ocurre después de subir o clonar el código. Si quieres evitar que ciertos bytes lleguen al servidor, elimínalos localmente. Comprueba qué archivos entraron y cuáles quedaron fuera. Una firma correcta sobre un alcance equivocado sigue describiendo algo equivocado.

Analizar y registrar son decisiones diferentes

El análisis permite revisar el inventario y las coincidencias anteriores. Registra cuando quieras una observación duradera y puedas realizar la declaración requerida del firmante. Conserva los identificadores Application, Event y Seal junto con la versión publicada. Guarda la evidencia firmada en un lugar adecuado: la evidencia privada puede contener datos identificativos y no debe aparecer en logs públicos.

En la implementación revisada, enviar el mismo paquete puede crear otro evento bajo el mismo Application ID. Cambiar su contenido crea un Application ID nuevo; las coincidencias pueden relacionar observaciones. No supongas que todas tus versiones compartirán identificador. Anota tu versión y los identificadores exactos que recibes.

Verifica y luego interpreta

La documentación de la API explica las operaciones disponibles. Puedes consultar el estado sin crear un registro:

curl --fail --silent --show-error https://codeseal.progretech.com/api/v1/status

El analizador del navegador y la API tienen trabajos distintos. La existencia de /api/v1 no implica un endpoint para subir código. Verificar requiere distinguir integridad criptográfica, clave conocida, coincidencia exacta con el registro y estado actual. Un evento revocado puede conservar una firma válida. Una similitud puede proceder de código compartido legítimamente; no demuestra autoría independiente ni propiedad legal.

Para una entrega asistida por IA guardaría tres cosas: commit revisado, evidencia de pruebas y compilación, y evidencia de procedencia. Una identifica el cambio, otra explica lo comprobado y otra permite consultar una observación firmada. Ninguna reemplaza automáticamente a las demás.

Empieza pequeño

Prueba un proyecto sin información sensible, revisa su análisis y decide si registrar encaja en tu proceso. Esta guía se revisó el 14 de octubre de 2026; consulta los requisitos y condiciones vigentes antes de enviar material. Deja los identificadores donde otro desarrollador pueda encontrarlos. Abre CodeSeal y dale a tu próxima entrega un historial que dure más que la captura de una compilación exitosa.