@gitgov/core 1.0.0

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

@@ -0,0 +1,142 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "agent_record_schema.json",
+    "title": "AgentRecord",
+    "description": "Canonical schema for agent operational manifests.",
+    "type": "object",
+    "required": [
+        "id",
+        "guild",
+        "engine"
+    ],
+    "properties": {
+        "id": {
+            "type": "string",
+            "pattern": "^agent:[a-z0-9:-]+$",
+            "description": "Unique identifier for the agent, linking to an ActorRecord."
+        },
+        "status": {
+            "type": "string",
+            "enum": [
+                "active",
+                "archived"
+            ],
+            "default": "active"
+        },
+        "guild": {
+            "type": "string",
+            "enum": [
+                "design",
+                "intelligence",
+                "strategy",
+                "operations",
+                "quality"
+            ]
+        },
+        "triggers": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "enum": [
+                            "manual",
+                            "webhook",
+                            "scheduled"
+                        ]
+                    }
+                },
+                "required": [
+                    "type"
+                ]
+            }
+        },
+        "knowledge_dependencies": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            }
+        },
+        "prompt_engine_requirements": {
+            "type": "object",
+            "properties": {
+                "roles": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "skills": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "engine": {
+            "type": "object",
+            "oneOf": [
+                {
+                    "required": [
+                        "type"
+                    ],
+                    "properties": {
+                        "type": {
+                            "const": "local"
+                        },
+                        "runtime": {
+                            "type": "string"
+                        },
+                        "entrypoint": {
+                            "type": "string"
+                        },
+                        "function": {
+                            "type": "string"
+                        }
+                    }
+                },
+                {
+                    "required": [
+                        "type"
+                    ],
+                    "properties": {
+                        "type": {
+                            "const": "api"
+                        },
+                        "url": {
+                            "type": "string"
+                        },
+                        "method": {
+                            "type": "string",
+                            "enum": [
+                                "POST",
+                                "GET"
+                            ]
+                        },
+                        "auth": {
+                            "type": "object"
+                        }
+                    }
+                },
+                {
+                    "required": [
+                        "type"
+                    ],
+                    "properties": {
+                        "type": {
+                            "const": "mcp"
+                        },
+                        "url": {
+                            "type": "string"
+                        },
+                        "auth": {
+                            "type": "object"
+                        }
+                    }
+                }
+            ]
+        }
+    }
+}

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

@@ -0,0 +1,227 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "changelog_record_schema.json",
+    "title": "ChangelogRecord",
+    "description": "Canonical schema for changelog records - Enterprise Grade System Historian",
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+        "id",
+        "entityType",
+        "entityId",
+        "changeType",
+        "title",
+        "description",
+        "timestamp",
+        "trigger",
+        "triggeredBy",
+        "reason",
+        "riskLevel"
+    ],
+    "properties": {
+        "id": {
+            "type": "string",
+            "pattern": "^\\d{10}-changelog-[a-z]+-[a-z0-9-]{1,50}$",
+            "description": "Unique identifier for the changelog entry"
+        },
+        "entityType": {
+            "type": "string",
+            "enum": [
+                "task",
+                "cycle",
+                "agent",
+                "system",
+                "configuration"
+            ],
+            "description": "Type of the primary entity that changed"
+        },
+        "entityId": {
+            "type": "string",
+            "description": "ID of the primary entity that changed"
+        },
+        "changeType": {
+            "type": "string",
+            "enum": [
+                "creation",
+                "completion",
+                "update",
+                "deletion",
+                "hotfix"
+            ],
+            "description": "The nature of the change"
+        },
+        "title": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 150,
+            "description": "Executive title of the change"
+        },
+        "description": {
+            "type": "string",
+            "minLength": 20,
+            "maxLength": 5000,
+            "description": "Detailed description of the change and its impact"
+        },
+        "timestamp": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Unix timestamp in seconds when the change occurred"
+        },
+        "trigger": {
+            "type": "string",
+            "enum": [
+                "manual",
+                "automated",
+                "emergency"
+            ],
+            "description": "How the change was initiated"
+        },
+        "triggeredBy": {
+            "type": "string",
+            "description": "Actor or agent ID that initiated the change"
+        },
+        "reason": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 1000,
+            "description": "Why the change was made"
+        },
+        "riskLevel": {
+            "type": "string",
+            "enum": [
+                "low",
+                "medium",
+                "high",
+                "critical"
+            ],
+            "description": "Risk level of the change"
+        },
+        "affectedSystems": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            },
+            "description": "IDs of systems impacted by this change"
+        },
+        "usersAffected": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Number of users impacted by this change"
+        },
+        "downtime": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Downtime in seconds caused by this change"
+        },
+        "files": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            },
+            "description": "List of main files that were created or modified"
+        },
+        "commits": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            },
+            "description": "List of git commit hashes related to this change"
+        },
+        "rollbackInstructions": {
+            "type": "string",
+            "minLength": 20,
+            "maxLength": 2000,
+            "description": "Step-by-step instructions to rollback this change"
+        },
+        "references": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "tasks": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "IDs of related TaskRecords"
+                },
+                "cycles": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "IDs of related CycleRecords"
+                },
+                "executions": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "IDs of related ExecutionRecords"
+                },
+                "changelogs": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "IDs of related ChangelogRecords"
+                }
+            },
+            "description": "Cross-references to other GitGovernance records"
+        }
+    },
+    "examples": [
+        {
+            "id": "1752707800-changelog-task-user-dashboard",
+            "entityType": "task",
+            "entityId": "1752274500-task-user-dashboard",
+            "changeType": "completion",
+            "title": "User Dashboard Implementation Completed",
+            "description": "Responsive dashboard with real-time analytics, user preferences, and notification center. All acceptance criteria met with 95% test coverage.",
+            "timestamp": 1752707800,
+            "trigger": "manual",
+            "triggeredBy": "human:senior-dev",
+            "reason": "All acceptance criteria met, code review passed, ready for production",
+            "riskLevel": "low",
+            "files": [
+                "src/pages/Dashboard.tsx",
+                "src/components/Analytics.tsx"
+            ],
+            "commits": [
+                "abc123def",
+                "456ghi789"
+            ],
+            "references": {
+                "tasks": [
+                    "1752274500-task-user-dashboard"
+                ],
+                "executions": [
+                    "1752707750-exec-dashboard-implementation"
+                ]
+            }
+        },
+        {
+            "id": "1752707900-changelog-system-payment-gateway",
+            "entityType": "system",
+            "entityId": "payment-gateway",
+            "changeType": "hotfix",
+            "title": "Critical Payment Timeout Fix",
+            "description": "Fixed 15% payment failure rate by increasing timeout from 5s to 30s and adding circuit breaker pattern. Emergency response to third-party API latency spike.",
+            "timestamp": 1752707900,
+            "trigger": "emergency",
+            "triggeredBy": "human:on-call-engineer",
+            "reason": "Payment failures spiked to 15% due to third-party API latency increase",
+            "riskLevel": "critical",
+            "affectedSystems": [
+                "payment-gateway",
+                "order-service",
+                "notification-service"
+            ],
+            "usersAffected": 25000,
+            "downtime": 0,
+            "rollbackInstructions": "1. Revert to payment-gateway:v2.1.4\n2. kubectl rollout restart deployment/payment-gateway\n3. Monitor success rate for 10 minutes",
+            "commits": [
+                "abc123def"
+            ]
+        }
+    ]
+}

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

@@ -0,0 +1,80 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "cycle_record_schema.json",
+    "title": "CycleRecord",
+    "description": "Canonical schema for cycle records (sprints, milestones)",
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+        "id",
+        "title",
+        "status"
+    ],
+    "properties": {
+        "id": {
+            "type": "string",
+            "pattern": "^\\d{10}-cycle-[a-z0-9-]{1,50}$",
+            "description": "Unique identifier for the cycle"
+        },
+        "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "description": "Human-readable title for the cycle (e.g., 'Sprint 24.08')"
+        },
+        "status": {
+            "type": "string",
+            "enum": [
+                "planning",
+                "active",
+                "completed",
+                "archived"
+            ],
+            "description": "The lifecycle status of the cycle"
+        },
+        "taskIds": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "pattern": "^\\d{10}-task-[a-z0-9-]{1,50}$"
+            }
+        },
+        "childCycleIds": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "pattern": "^\\d{10}-cycle-[a-z0-9-]{1,50}$"
+            },
+            "description": "An optional array of Cycle IDs that are children of this cycle, allowing for hierarchies."
+        },
+        "tags": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "pattern": "^[a-z0-9-]+(:[a-z0-9-]+)*$"
+            },
+            "default": [],
+            "description": "Optional list of key:value tags for categorization (e.g., 'roadmap:q4', 'team:alpha')."
+        },
+        "notes": {
+            "type": "string",
+            "maxLength": 10000,
+            "description": "An optional description of the cycle's goals and objectives"
+        }
+    },
+    "examples": [
+        {
+            "id": "1754400000-cycle-sprint-de-q4-api-performance",
+            "title": "Sprint de Q4 - API Performance",
+            "status": "active",
+            "taskIds": [
+                "1752274500-task-optimizar-endpoint-search",
+                "1752360900-task-anadir-cache-a-redis"
+            ],
+            "tags": [
+                "roadmap:q4"
+            ],
+            "notes": "Objetivo: Reducir la latencia p95 de la API por debajo de 200ms."
+        }
+    ]
+}