@gitgov/core 1.0.0

package/dist/src/schemas/generated/embedded_metadata_schema.json

@@ -0,0 +1,318 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "embedded_metadata_schema.json",
+    "title": "EmbeddedMetadataRecord",
+    "description": "Canonical schema for the wrapper structure of all GitGovernance records.",
+    "type": "object",
+    "properties": {
+        "header": {
+            "type": "object",
+            "properties": {
+                "version": {
+                    "type": "string",
+                    "enum": [
+                        "1.0"
+                    ],
+                    "description": "Version of the embedded metadata format."
+                },
+                "type": {
+                    "type": "string",
+                    "enum": [
+                        "actor",
+                        "agent",
+                        "task",
+                        "execution",
+                        "changelog",
+                        "feedback",
+                        "cycle",
+                        "custom"
+                    ],
+                    "description": "The type of the record contained in the payload."
+                },
+                "schemaUrl": {
+                    "type": "string",
+                    "description": "Optional URL to a custom schema for the payload."
+                },
+                "schemaChecksum": {
+                    "type": "string",
+                    "pattern": "^[a-fA-F0-9]{64}$",
+                    "description": "Optional SHA-256 checksum of the custom schema."
+                },
+                "payloadChecksum": {
+                    "type": "string",
+                    "pattern": "^[a-fA-F0-9]{64}$",
+                    "description": "SHA-256 checksum of the canonically serialized payload."
+                },
+                "signatures": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "keyId": {
+                                "type": "string",
+                                "description": "The Actor ID of the signer."
+                            },
+                            "role": {
+                                "type": "string",
+                                "description": "The context role of the signature (e.g., 'author')."
+                            },
+                            "signature": {
+                                "type": "string",
+                                "description": "The Ed25519 signature (base64 encoded) of the signature digest."
+                            },
+                            "timestamp": {
+                                "type": "integer",
+                                "description": "Unix timestamp of the signature."
+                            },
+                            "timestamp_iso": {
+                                "type": "string",
+                                "description": "ISO 8601 timestamp of the signature."
+                            }
+                        },
+                        "required": [
+                            "keyId",
+                            "role",
+                            "signature",
+                            "timestamp",
+                            "timestamp_iso"
+                        ]
+                    },
+                    "description": "An array of one or more signature objects."
+                },
+                "audit": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 3000,
+                    "description": "A human-readable audit stamp (e.g., from gitgov audit)."
+                }
+            },
+            "required": [
+                "version",
+                "type",
+                "payloadChecksum",
+                "signatures"
+            ],
+            "additionalProperties": false
+        },
+        "payload": {
+            "type": "object",
+            "description": "The specific record data, validated against the schema defined by header.type."
+        }
+    },
+    "required": [
+        "header",
+        "payload"
+    ],
+    "additionalProperties": false,
+    "oneOf": [
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "actor"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:actor_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "agent"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:agent_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "task"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:task_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "execution"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:execution_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "changelog"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:changelog_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "feedback"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:feedback_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "cycle"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "payload": {
+                        "$ref": "ref:cycle_record_schema"
+                    }
+                }
+            },
+            "else": false
+        },
+        {
+            "if": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "properties": {
+                            "type": {
+                                "const": "custom"
+                            }
+                        }
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "header": {
+                        "type": "object",
+                        "required": [
+                            "schemaUrl",
+                            "schemaChecksum"
+                        ]
+                    }
+                }
+            },
+            "else": false
+        }
+    ],
+    "examples": [
+        {
+            "header": {
+                "version": "1.0",
+                "type": "task",
+                "payloadChecksum": "a1b2c3d4e5f6...",
+                "signatures": [
+                    {
+                        "keyId": "human:lead-dev",
+                        "role": "author",
+                        "signature": "...",
+                        "timestamp": 1752274500,
+                        "timestamp_iso": "2025-07-25T14:30:00Z"
+                    }
+                ]
+            },
+            "payload": {
+                "id": "1752274500-task-implementar-auth",
+                "status": "pending",
+                "priority": "high",
+                "description": "Implementar autenticación OAuth 2.0.",
+                "tags": [
+                    "skill:go",
+                    "area:backend"
+                ]
+            }
+        }
+    ]
+}

package/dist/src/schemas/generated/execution_record_schema.json

@@ -0,0 +1,89 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "execution_record_schema.json",
+    "title": "ExecutionRecord",
+    "description": "Canonical schema for execution log records",
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+        "id",
+        "taskId",
+        "result"
+    ],
+    "properties": {
+        "id": {
+            "type": "string",
+            "pattern": "^\\d{10}-exec-[a-z0-9-]{1,50}$",
+            "maxLength": 70,
+            "description": "Unique identifier for the execution log entry",
+            "examples": [
+                "1752275000-exec-crear-schema-inicial"
+            ]
+        },
+        "taskId": {
+            "type": "string",
+            "pattern": "^\\d{10}-task-[a-z0-9-]{1,50}$",
+            "maxLength": 70,
+            "description": "ID of the parent task"
+        },
+        "type": {
+            "type": "string",
+            "enum": [
+                "analysis",
+                "progress",
+                "blocker",
+                "completion",
+                "info",
+                "correction"
+            ],
+            "description": "Semantic classification of the execution event",
+            "examples": [
+                "progress",
+                "analysis",
+                "blocker",
+                "completion"
+            ]
+        },
+        "title": {
+            "type": "string",
+            "maxLength": 256,
+            "description": "Human-readable title for the execution",
+            "examples": [
+                "Sub-Task-11",
+                "Initial analysis"
+            ]
+        },
+        "result": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 22000,
+            "description": "The tangible, verifiable output or result of the execution"
+        },
+        "notes": {
+            "type": "string",
+            "maxLength": 6500,
+            "description": "Optional comments about decisions, blockers or context"
+        },
+        "references": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "maxLength": 500
+            },
+            "description": "List of URIs to relevant commits, files, or external documents"
+        }
+    },
+    "examples": [
+        {
+            "id": "1752642000-exec-subtask-9-4",
+            "taskId": "1752274500-task-integrar-adapter-configuracion",
+            "type": "progress",
+            "title": "Sub-tarea 9.4: Implementar parser de JSON",
+            "result": "Adapter implementado y pasando tests",
+            "notes": "La implementación inicial usa una librería externa para el parsing.",
+            "references": [
+                "commit:a1b2c3d4e5"
+            ]
+        }
+    ]
+}

package/dist/src/schemas/generated/feedback_record_schema.json

@@ -0,0 +1,83 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "feedback_record_schema.json",
+    "title": "FeedbackRecord",
+    "description": "Canonical schema for feedback records",
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+        "id",
+        "entityType",
+        "entityId",
+        "type",
+        "status",
+        "content"
+    ],
+    "properties": {
+        "id": {
+            "type": "string",
+            "pattern": "^\\d{10}-feedback-[a-z0-9-]{1,50}$",
+            "description": "Unique identifier for the feedback entry"
+        },
+        "entityType": {
+            "type": "string",
+            "enum": [
+                "task",
+                "execution",
+                "changelog",
+                "feedback"
+            ],
+            "description": "The type of entity this feedback refers to"
+        },
+        "entityId": {
+            "type": "string",
+            "description": "The ID of the entity this feedback refers to"
+        },
+        "type": {
+            "type": "string",
+            "enum": [
+                "blocking",
+                "suggestion",
+                "question",
+                "approval",
+                "clarification",
+                "assignment"
+            ],
+            "description": "The semantic intent of the feedback"
+        },
+        "status": {
+            "type": "string",
+            "enum": [
+                "open",
+                "acknowledged",
+                "resolved",
+                "wontfix"
+            ],
+            "description": "The lifecycle status of the feedback"
+        },
+        "content": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 10000,
+            "description": "The content of the feedback"
+        },
+        "assignee": {
+            "type": "string",
+            "description": "The Actor ID of the agent responsible for addressing the feedback"
+        },
+        "resolvesFeedbackId": {
+            "type": "string",
+            "description": "The ID of another feedback record that this one resolves or responds to"
+        }
+    },
+    "examples": [
+        {
+            "id": "1752788100-feedback-blocking-comment",
+            "entityType": "execution",
+            "entityId": "1752642000-exec-subtarea-9-4",
+            "type": "blocking",
+            "status": "open",
+            "content": "Esta implementación no cumple el estándar de rutas REST. Sugiero revisar el spec."
+        }
+    ]
+}