Eje 3: Componentes
Visión general
El GCBoK define seis componentes principales del stack de GitCover:
GCDMS - GitCover Document Management System
Sistema de gestión de evidencia y documentos basado en contenedores .v7g.md y sus metadatos. Cadena de herramientas: v7g-pack, v7g-verify, v7g-sign, v7g-export.
GCPN - GitCover PrimaNota
Mecanismo de metadatos para la formación de cadenas de evidencia a prueba de revisiones (predecesor/sucesor) para documentos de negocio. El término histórico PrimaNota designa una clave de ordenación que asigna a un evento de negocio —p. ej., una partida de la contabilidad por partida doble o una operación de registro multipartita (reclamación, IVA, reparto por centro de coste/portador de coste)— una clave única de pertenencia. GCPN transfiere este principio sobre la base de UUIDv7: cada documento recibe un identificador ordenado temporalmente (RFC 9562) y se encadena con sus documentos predecesores y sucesores mediante referencias Predecessor/Successor.
El encadenamiento se realiza de forma no cronológica: un documento registrado posteriormente puede insertarse como predecesor (Predecessor-Insert) en una cadena existente, lo cual es decisivo para GoBD Rz. 80 (verificación progresiva y retroactiva). Los campos Match-Key (número de pedido, deudor, importe bruto, etc.) permiten la asociación automática de cadenas sin asignación manual.
El formato de contenedor .v7g.md combina metadatos legibles por humanos (YAML + Markdown) con datos de negocio procesables por máquina (JSON incrustado) y se almacena en repositorios Git, cuyo hash de commit sirve como prueba criptográfica de integridad.
Ámbitos de aplicación más allá de la contabilidad: registros de actividades de tratamiento del RGPD (Art. 30), cadenas de incidentes NIS2, decisiones de arquitectura MADR, ciclo de vida de tokens OIDC/OAuth, resultados de evaluación OSCAL.
Protección de modelo de utilidad: Az 20 2026 000 272.7 — en vigor. Objeto protegido: estructura de datos de contenedor para la gestión a prueba de revisiones de documentos de negocio basada en UUIDv7 con encadenamiento dinámico Predecessor/Successor. Solicitud de patente presentada (47 reivindicaciones).
GCUCB - GitCover Unified Communication Bus
Bus de contexto basado en memoria compartida con direccionamiento determinista V7GUID. Nodo central de datos entre agentes de IA, validadores OPA y sistemas de auditoría.
El problema de la sobrecarga
| Fuente | Hallazgo |
|---|---|
| RMMAP (EuroSys 2024) | Serialización = 17-72% del tiempo del workflow |
| AgentTaxo (ICLR 2025) | 20-60% de los tokens = sobrecarga de coordinación |
| AgentDiet (arXiv 2025) | 39,9-59,7% de los tokens de entrada son inútiles |
La solución
GCUCB elimina la serialización/deserialización repetida mediante acceso directo tipado a regiones de archivos mapeados en memoria. Los agentes de IA reciben structs tipados y referenciados por V7GUID directamente desde el bus, sin enormes system prompts.
OPA/Rego funciona como VPRM (Verifiable Process Reward Model): las guardrails surgen de un conjunto de reglas determinista, no de ingeniería de prompts.
Delimitación
| Componente | Capa | Delimitación respecto a GCUCB |
|---|---|---|
| GCEP | Persistencia (Git-to-Git) | Instancia a instancia; GCUCB = bus de memoria en tiempo de ejecución |
| GCSYNC | Saliente (Git -> RAG) | Canal externo; GCUCB = bus interno |
| GCPN | Lógica de encadenamiento | Cadenas de evidencia (predecesor/sucesor); GCUCB = transporte/acceso |
GCEP - GitCover Exchange Protocol
Protocolo de intercambio entre instancias entre repositorios Git en soportes distintos. Determinado semánticamente por catálogos OSCAL y hooks/callbacks definidos por OPA.
Ruta IETF planificada (I-D, abreviatura: gcep). Solicitud de patente: 10 2025 003 359.1.
Niveles de protocolo: ACP, MCP y GCEP
GCEP no debe confundirse con los protocolos de agentes de IA. Los tres resuelven problemas distintos en niveles diferentes:
(z. B. VS Code)"] -->|"Agent Client Protocol (ACP)"| B["Logik-Ebene / KI-Agent"] B -->|"Model Context Protocol (MCP)"| C["Infrastruktur- & Daten-Ebene"] C -->|"GitCover Exchange Protocol (GCEP)
mit Advisory Locks"| D["Verteilte Git-Server / VCS"] style A fill:#bbdefb style B fill:#c8e6c9 style C fill:#ffe0b2 style D fill:#f8bbd0
| Nivel | Protocolo | Dirección | Propósito |
|---|---|---|---|
| Puente de UI | ACP (Agent Client Protocol) | UI ↔ Agente | Conecta la interfaz de usuario (p. ej., VS Code) con la lógica del agente |
| Puente de contexto de IA | MCP (Model Context Protocol) | Agente ↔ Datos | Acceso estructurado del agente a fuentes de datos (documentos, herramientas) |
| Nivel de repositorio | GCEP | Servidor ↔ Servidor | Replicación, sincronización y respaldo del estado entre instancias físicas de Git |
La combinación es de gran relevancia para la gestión: el agente opera a alta velocidad a través de ACP/MCP; GCEP garantiza en el nivel de repositorio subyacente que las rutas de commit y sincronización se mantengan consistentes.
Advisory Locks en la era de la IA
Los agentes de IA autónomos generan accesos de escritura de alta frecuencia. Sin un protocolo de bloqueo a nivel de Git, dos agentes que actúen en paralelo —o un agente y un gestor humano— pueden modificar los mismos repositorios simultáneamente y generar estados inconsistentes (condiciones de carrera).
| Aspecto | Advisory Lock | Mandatory Lock |
|---|---|---|
| Mecanismo de acción | Los procesos comprueban el estado de bloqueo voluntariamente antes de escribir | El sistema operativo impone el bloqueo de forma estricta |
| Comportamiento ante timeout | El agente puede reaccionar estratégicamente: reprogramar un subobjetivo, emitir una notificación de UI | A menudo estados de sistema colapsados (deadlocks) |
| Adecuación para agentes de IA | Alta — el agente consulta el estado de bloqueo previamente (p. ej., a través de un servidor MCP-Git) | Baja — bloquea la pipeline del agente |
Un agente de IA puede consultar previamente el estado de bloqueo GCEP («¿Está este repositorio bloqueado para otra sede?») y adaptar su planificación en consecuencia, en lugar de bloquearse de forma rígida.
GCAL - GitCover Advisory Lock
Mecanismo de bloqueo distribuido entre repositorios Git, análogo al Advisory Lock de PostgreSQL, pero a nivel de repositorio. Prerrequisito para GCEP: antes de que dos instancias intercambien datos, un lock debe garantizar una transferencia atómica.
GCSYNC - GitCover Sync
Canal saliente desde GitCover hacia otros sistemas de almacenamiento de datos. Proporciona datos para sistemas RAG, servidores MCP y Nextcloud Shares.
Véase también: Derechos de protección y estado de la patente en Derechos de protección. Reconocimiento de investigación en Proyectos de investigación.