@gitgov/core 2.7.2 → 2.9.0

package/dist/src/index.js

@@ -20,7 +20,6 @@ var adapters_exports = {};
 __export(adapters_exports, {
   AgentAdapter: () => AgentAdapter,
   BacklogAdapter: () => BacklogAdapter,
-  ChangelogAdapter: () => ChangelogAdapter,
   ExecutionAdapter: () => ExecutionAdapter,
   FeedbackAdapter: () => FeedbackAdapter,
   IdentityAdapter: () => IdentityAdapter,
@@ -29,6 +28,25 @@ __export(adapters_exports, {
 });
 
 // src/record_types/common.types.ts
+var RECORD_TYPES = [
+  "actor",
+  "agent",
+  "cycle",
+  "task",
+  "execution",
+  "feedback"
+];
+var DIR_TO_TYPE = {
+  "tasks": "task",
+  "cycles": "cycle",
+  "executions": "execution",
+  "feedbacks": "feedback",
+  "actors": "actor",
+  "agents": "agent"
+};
+var TYPE_TO_DIR = Object.fromEntries(
+  Object.entries(DIR_TO_TYPE).map(([dir, type]) => [type, dir])
+);
 var GitGovError = class extends Error {
   constructor(message, code) {
     super(message);
@@ -74,7 +92,7 @@ var actor_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "actor_record_schema.json",
   title: "ActorRecord",
-  description: "Canonical schema for actor records as defined in actor_protocol.md",
+  description: "Canonical schema for actor records as defined in 02_actor.md",
   additionalProperties: false,
   type: "object",
   required: [
@@ -169,8 +187,9 @@ var agent_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "agent_record_schema.json",
   title: "AgentRecord",
-  description: "Canonical schema for agent operational manifests.",
+  description: "Canonical schema for agent operational manifests \u2014 the work contract that defines how an agent is invoked.",
   type: "object",
+  additionalProperties: false,
   required: [
     "id",
     "engine"
@@ -178,8 +197,13 @@ var agent_record_schema_default = {
   properties: {
     id: {
       type: "string",
-      pattern: "^agent:[a-z0-9:-]+$",
-      description: "Unique identifier for the agent, linking to an ActorRecord."
+      pattern: "^agent(:[a-z0-9-]+)+$",
+      description: "Unique identifier for the agent, linking 1:1 to an ActorRecord of type agent.",
+      examples: [
+        "agent:scribe",
+        "agent:aion",
+        "agent:camilo:cursor"
+      ]
     },
     status: {
       type: "string",
@@ -187,63 +211,12 @@ var agent_record_schema_default = {
         "active",
         "archived"
       ],
-      default: "active"
-    },
-    triggers: {
-      type: "array",
-      default: [],
-      description: "Optional list of triggers that activate the agent.\nAdditional fields are allowed and depend on trigger type:\n- webhook triggers: 'event' (event identifier), 'filter' (condition)\n- scheduled triggers: 'cron' (cron expression)\n- manual triggers: 'command' (example CLI command)\n",
-      items: {
-        type: "object",
-        properties: {
-          type: {
-            type: "string",
-            enum: [
-              "manual",
-              "webhook",
-              "scheduled"
-            ],
-            description: "Type of trigger that activates the agent"
-          }
-        },
-        required: [
-          "type"
-        ],
-        additionalProperties: true
-      }
-    },
-    knowledge_dependencies: {
-      type: "array",
-      default: [],
-      items: {
-        type: "string",
-        description: "Glob patterns for blueprint files this agent needs access to"
-      }
-    },
-    prompt_engine_requirements: {
-      type: "object",
-      properties: {
-        roles: {
-          type: "array",
-          items: {
-            type: "string"
-          }
-        },
-        skills: {
-          type: "array",
-          items: {
-            type: "string"
-          }
-        }
-      }
-    },
-    metadata: {
-      type: "object",
-      description: "Optional framework-specific or deployment-specific metadata for agent extensions.\nCommon use cases: framework identification (langchain, google-adk), deployment info (provider, image, region),\ncost tracking (cost_per_invocation, currency), tool capabilities, maintainer info.\nThis field does NOT affect agent execution - it is purely informational.\n",
-      additionalProperties: true
+      default: "active",
+      description: "Operational status. An archived agent cannot be invoked."
     },
     engine: {
       type: "object",
+      description: "Invocation specification \u2014 defines how the agent is executed. Uses oneOf with 4 variants: local, api, mcp, custom.",
       oneOf: [
         {
           required: [
@@ -290,7 +263,8 @@ var agent_record_schema_default = {
                 "GET",
                 "PUT"
               ],
-              default: "POST"
+              default: "POST",
+              description: "HTTP method"
             },
             auth: {
               type: "object",
@@ -336,7 +310,7 @@ var agent_record_schema_default = {
             },
             tool: {
               type: "string",
-              description: "Name of the MCP tool to invoke. If not specified, defaults to agentId without 'agent:' prefix."
+              description: "Name of the MCP tool to invoke. If omitted, the agent has access to all tools on the server."
             },
             auth: {
               type: "object",
@@ -385,6 +359,60 @@ var agent_record_schema_default = {
           }
         }
       ]
+    },
+    triggers: {
+      type: "array",
+      default: [],
+      description: "Optional list of triggers that activate the agent.\nAdditional fields are allowed and depend on trigger type:\n- manual: 'command' (example CLI command)\n- webhook: 'event' (event identifier), 'filter' (condition)\n- scheduled: 'cron' (cron expression)\n",
+      items: {
+        type: "object",
+        properties: {
+          type: {
+            type: "string",
+            enum: [
+              "manual",
+              "webhook",
+              "scheduled"
+            ],
+            description: "Type of trigger that activates the agent"
+          }
+        },
+        required: [
+          "type"
+        ],
+        additionalProperties: true
+      }
+    },
+    knowledge_dependencies: {
+      type: "array",
+      default: [],
+      items: {
+        type: "string",
+        description: "Glob patterns for files this agent needs access to"
+      }
+    },
+    prompt_engine_requirements: {
+      type: "object",
+      description: "Requirements for prompt composition \u2014 roles and skills the agent needs.",
+      properties: {
+        roles: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        },
+        skills: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        }
+      }
+    },
+    metadata: {
+      type: "object",
+      description: "Optional framework-specific or deployment-specific metadata.\nCommon use cases: framework identification (langchain, google-adk), deployment info,\ncost tracking, tool capabilities, maintainer info.\nThis field does NOT affect agent execution \u2014 it is purely informational.\n",
+      additionalProperties: true
     }
   },
   examples: [
@@ -615,193 +643,12 @@ var agent_record_schema_default = {
   ]
 };
 
-// src/record_schemas/generated/changelog_record_schema.json
-var changelog_record_schema_default = {
-  $schema: "http://json-schema.org/draft-07/schema#",
-  $id: "changelog_record_schema.json",
-  title: "ChangelogRecord",
-  description: "Canonical schema for changelog records - aggregates N tasks into 1 release note",
-  additionalProperties: false,
-  type: "object",
-  required: [
-    "id",
-    "title",
-    "description",
-    "relatedTasks",
-    "completedAt"
-  ],
-  properties: {
-    id: {
-      type: "string",
-      pattern: "^\\d{10}-changelog-[a-z0-9-]{1,50}$",
-      maxLength: 71,
-      description: "Unique identifier for the changelog entry",
-      examples: [
-        "1752707800-changelog-sistema-autenticacion-v1",
-        "1752707800-changelog-sprint-24-api-performance"
-      ]
-    },
-    title: {
-      type: "string",
-      minLength: 10,
-      maxLength: 150,
-      description: "Executive title of the deliverable",
-      examples: [
-        "Sistema de Autenticaci\xF3n Completo v1.0",
-        "Sprint 24 - Performance Optimizations"
-      ]
-    },
-    description: {
-      type: "string",
-      minLength: 20,
-      maxLength: 5e3,
-      description: "Detailed description of the value delivered, including key decisions and impact"
-    },
-    relatedTasks: {
-      type: "array",
-      items: {
-        type: "string",
-        pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$"
-      },
-      minItems: 1,
-      description: "IDs of tasks that compose this deliverable (minimum 1 required)"
-    },
-    completedAt: {
-      type: "number",
-      minimum: 0,
-      description: "Unix timestamp in seconds when the deliverable was completed"
-    },
-    relatedCycles: {
-      type: "array",
-      items: {
-        type: "string",
-        pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$"
-      },
-      default: [],
-      description: "Optional IDs of cycles related to this deliverable"
-    },
-    relatedExecutions: {
-      type: "array",
-      items: {
-        type: "string",
-        pattern: "^\\d{10}-exec-[a-z0-9-]{1,50}$"
-      },
-      default: [],
-      description: "Optional IDs of key execution records related to this work"
-    },
-    version: {
-      type: "string",
-      minLength: 1,
-      maxLength: 50,
-      description: "Optional version or release identifier (e.g., 'v1.0.0', 'sprint-24')",
-      examples: [
-        "v1.0.0",
-        "v2.1.3",
-        "sprint-24"
-      ]
-    },
-    tags: {
-      type: "array",
-      items: {
-        type: "string",
-        pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
-      },
-      default: [],
-      description: "Optional tags for categorization (e.g., 'feature:auth', 'bugfix', 'security')"
-    },
-    commits: {
-      type: "array",
-      items: {
-        type: "string",
-        maxLength: 100
-      },
-      default: [],
-      description: "Optional list of git commit hashes related to this deliverable"
-    },
-    files: {
-      type: "array",
-      items: {
-        type: "string",
-        maxLength: 500
-      },
-      default: [],
-      description: "Optional list of main files that were created or modified"
-    },
-    notes: {
-      type: "string",
-      maxLength: 3e3,
-      description: "Optional additional context, decisions, or learnings"
-    }
-  },
-  examples: [
-    {
-      id: "1752707800-changelog-sistema-autenticacion-v1",
-      title: "Sistema de Autenticaci\xF3n Completo v1.0",
-      description: "Implementaci\xF3n completa del sistema de autenticaci\xF3n con OAuth2, 2FA via TOTP, recuperaci\xF3n de contrase\xF1a, y UI responsive. Incluye tests E2E completos (95% coverage) y documentaci\xF3n t\xE9cnica actualizada.",
-      relatedTasks: [
-        "1752274500-task-crear-ui-login",
-        "1752274600-task-integrar-oauth2-backend",
-        "1752274700-task-implementar-2fa-totp",
-        "1752274800-task-tests-e2e-auth",
-        "1752274900-task-documentar-flujo-auth"
-      ],
-      completedAt: 1752707800,
-      relatedCycles: [
-        "1752200000-cycle-q1-auth-milestone"
-      ],
-      relatedExecutions: [
-        "1752274550-exec-analisis-auth-providers",
-        "1752707750-exec-final-integration-test"
-      ],
-      version: "v1.0.0",
-      tags: [
-        "feature:auth",
-        "security",
-        "frontend",
-        "backend"
-      ],
-      commits: [
-        "abc123def",
-        "456ghi789",
-        "jkl012mno"
-      ],
-      files: [
-        "src/pages/Login.tsx",
-        "src/services/auth.ts",
-        "src/components/TwoFactorSetup.tsx",
-        "e2e/auth.spec.ts"
-      ],
-      notes: "Decisi\xF3n t\xE9cnica: Usamos NextAuth.js despu\xE9s de evaluar Passport.js. El 2FA se implement\xF3 con TOTP (Google Authenticator compatible) en lugar de SMS por seguridad y costo."
-    },
-    {
-      id: "1752707900-changelog-hotfix-payment-timeout",
-      title: "Hotfix: Critical Payment Timeout Fix",
-      description: "Fixed critical payment timeout issue affecting 15% of transactions. Increased timeout from 5s to 30s and added circuit breaker pattern for third-party API calls.",
-      relatedTasks: [
-        "1752707850-task-fix-payment-timeout",
-        "1752707870-task-add-circuit-breaker"
-      ],
-      completedAt: 1752707900,
-      version: "v1.2.1",
-      tags: [
-        "hotfix",
-        "critical",
-        "payment"
-      ],
-      commits: [
-        "xyz789abc"
-      ],
-      notes: "Emergency response to production incident. Deployed to production within 2 hours."
-    }
-  ]
-};
-
 // src/record_schemas/generated/cycle_record_schema.json
 var cycle_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "cycle_record_schema.json",
   title: "CycleRecord",
-  description: "Canonical schema for cycle records - strategic grouping of work",
+  description: "Canonical schema for cycle records \u2014 strategic grouping of work into sprints, milestones, or roadmaps.",
   additionalProperties: false,
   type: "object",
   required: [
@@ -814,7 +661,7 @@ var cycle_record_schema_default = {
       type: "string",
       pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$",
       maxLength: 67,
-      description: "Unique identifier for the cycle (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)",
+      description: "Unique identifier for the cycle (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max).",
       examples: [
         "1754400000-cycle-sprint-24-api-performance",
         "1754500000-cycle-auth-system-v2",
@@ -825,7 +672,7 @@ var cycle_record_schema_default = {
       type: "string",
       minLength: 1,
       maxLength: 256,
-      description: "Human-readable title for the cycle (e.g., 'Sprint 24', 'Auth v2.0', 'Q4 2025')",
+      description: "Human-readable title for the cycle (e.g., 'Sprint 24', 'Auth v2.0', 'Q4 2025').",
       examples: [
         "Sprint 24 - API Performance",
         "Authentication System v2.0",
@@ -840,7 +687,7 @@ var cycle_record_schema_default = {
         "completed",
         "archived"
       ],
-      description: "The lifecycle status of the cycle"
+      description: "The lifecycle status of the cycle."
     },
     taskIds: {
       type: "array",
@@ -850,7 +697,7 @@ var cycle_record_schema_default = {
         maxLength: 66
       },
       default: [],
-      description: "Optional array of Task IDs that belong to this cycle. Can be empty for cycles that only contain child cycles. (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)",
+      description: "Optional array of Task IDs that belong to this cycle. Bidirectional with TaskRecord.cycleIds. Can be empty for container cycles.",
       examples: [
         [
           "1752274500-task-optimizar-endpoint-search",
@@ -866,7 +713,7 @@ var cycle_record_schema_default = {
         maxLength: 67
       },
       default: [],
-      description: "Optional array of Cycle IDs that are children of this cycle, allowing for hierarchies (e.g., Q1 containing Sprint 1, Sprint 2, Sprint 3). (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)",
+      description: "Optional array of child Cycle IDs for hierarchical composition (e.g., Q1 containing Sprint 1, Sprint 2, Sprint 3).",
       examples: [
         [
           "1754400000-cycle-sprint-24",
@@ -900,9 +747,29 @@ var cycle_record_schema_default = {
     },
     notes: {
       type: "string",
-      minLength: 0,
-      maxLength: 1e4,
-      description: "Optional description of the cycle's goals, objectives, and context"
+      minLength: 1,
+      description: "Optional description of the cycle's goals, objectives, and context."
+    },
+    metadata: {
+      type: "object",
+      additionalProperties: true,
+      description: "Optional structured data for machine consumption.\nUse this field for domain-specific data that needs to be programmatically processed.\nExtends the strategic grouping with structured, queryable attributes.\nCommon use cases: epic lifecycle, sprint configuration, OKR tracking, budget allocation.\n",
+      examples: [
+        {
+          epic: true,
+          phase: "active",
+          files: {
+            overview: "overview.md",
+            roadmap: "roadmap.md",
+            plan: "implementation_plan.md"
+          }
+        },
+        {
+          sprint: 24,
+          velocity: 42,
+          team: "backend"
+        }
+      ]
     }
   },
   examples: [
@@ -920,7 +787,7 @@ var cycle_record_schema_default = {
         "team:backend",
         "focus:performance"
       ],
-      notes: "Objetivo: Reducir la latencia p95 de la API por debajo de 200ms y preparar infraestructura para Black Friday."
+      notes: "Objective: Reduce API p95 latency below 200ms and prepare infrastructure for Black Friday."
     },
     {
       id: "1754500000-cycle-auth-system-v2",
@@ -937,7 +804,7 @@ var cycle_record_schema_default = {
         "security",
         "feature:auth"
       ],
-      notes: "Milestone mayor: Sistema completo de autenticaci\xF3n con OAuth2, 2FA, y gesti\xF3n avanzada de sesiones. Cr\xEDtico para lanzamiento Q4."
+      notes: "Major milestone: Complete authentication system with OAuth2, 2FA, and advanced session management. Critical for Q4 launch."
     },
     {
       id: "1754600000-cycle-q4-2025-growth",
@@ -953,7 +820,7 @@ var cycle_record_schema_default = {
         "strategy:growth",
         "okr:scale-to-1m-users"
       ],
-      notes: "Objetivo trimestral: Escalar a 1M usuarios activos. Incluye mejoras de performance, nuevo sistema de auth, y lanzamiento de app m\xF3vil."
+      notes: "Quarterly objective: Scale to 1M active users. Includes performance improvements, new auth system, and mobile app launch."
     }
   ]
 };
@@ -971,10 +838,8 @@ var embedded_metadata_schema_default = {
       properties: {
         version: {
           type: "string",
-          enum: [
-            "1.0"
-          ],
-          description: "Version of the embedded metadata format."
+          pattern: "^\\d+\\.\\d+$",
+          description: 'Protocol version in MAJOR.MINOR format (e.g. "1.1", "2.0").'
         },
         type: {
           type: "string",
@@ -983,12 +848,23 @@ var embedded_metadata_schema_default = {
             "agent",
             "task",
             "execution",
-            "changelog",
             "feedback",
-            "cycle"
+            "cycle",
+            "workflow",
+            "custom"
           ],
           description: "The type of the record contained in the payload."
         },
+        schemaUrl: {
+          type: "string",
+          format: "uri",
+          description: "URL to a custom schema for the payload. Required when type is 'custom'."
+        },
+        schemaChecksum: {
+          type: "string",
+          pattern: "^[a-fA-F0-9]{64}$",
+          description: "SHA-256 checksum of the custom schema. Required when type is 'custom'."
+        },
         payloadChecksum: {
           type: "string",
           pattern: "^[a-fA-F0-9]{64}$",
@@ -1003,14 +879,14 @@ var embedded_metadata_schema_default = {
               keyId: {
                 type: "string",
                 pattern: "^(human|agent)(:[a-z0-9-]+)+$",
-                description: "The Actor ID of the signer (must match ActorRecord.id pattern)."
+                description: "The Actor ID of the signer. Supports scoped identifiers (e.g. agent:camilo:cursor)."
               },
               role: {
                 type: "string",
                 pattern: "^([a-z-]+|custom:[a-z0-9-]+)$",
                 minLength: 1,
                 maxLength: 50,
-                description: "The context role of the signature (e.g., 'author', 'reviewer', 'auditor', or 'custom:*')."
+                description: "The context role of the signature (e.g., 'author', 'reviewer', or 'custom:*')."
               },
               notes: {
                 type: "string",
@@ -1025,6 +901,7 @@ var embedded_metadata_schema_default = {
               },
               timestamp: {
                 type: "integer",
+                minimum: 16e8,
                 description: "Unix timestamp of the signature."
               }
             },
@@ -1058,7 +935,32 @@ var embedded_metadata_schema_default = {
     "payload"
   ],
   additionalProperties: false,
-  oneOf: [
+  allOf: [
+    {
+      if: {
+        properties: {
+          header: {
+            type: "object",
+            properties: {
+              type: {
+                const: "custom"
+              }
+            }
+          }
+        }
+      },
+      then: {
+        properties: {
+          header: {
+            type: "object",
+            required: [
+              "schemaUrl",
+              "schemaChecksum"
+            ]
+          }
+        }
+      }
+    },
     {
       if: {
         properties: {
@@ -1078,8 +980,7 @@ var embedded_metadata_schema_default = {
             $ref: "ref:actor_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
@@ -1100,8 +1001,7 @@ var embedded_metadata_schema_default = {
             $ref: "ref:agent_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
@@ -1122,8 +1022,7 @@ var embedded_metadata_schema_default = {
             $ref: "ref:task_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
@@ -1144,8 +1043,7 @@ var embedded_metadata_schema_default = {
             $ref: "ref:execution_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
@@ -1154,7 +1052,7 @@ var embedded_metadata_schema_default = {
             type: "object",
             properties: {
               type: {
-                const: "changelog"
+                const: "feedback"
               }
             }
           }
@@ -1163,11 +1061,10 @@ var embedded_metadata_schema_default = {
       then: {
         properties: {
           payload: {
-            $ref: "ref:changelog_record_schema"
+            $ref: "ref:feedback_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
@@ -1176,7 +1073,7 @@ var embedded_metadata_schema_default = {
             type: "object",
             properties: {
               type: {
-                const: "feedback"
+                const: "cycle"
               }
             }
           }
@@ -1185,11 +1082,10 @@ var embedded_metadata_schema_default = {
       then: {
         properties: {
           payload: {
-            $ref: "ref:feedback_record_schema"
+            $ref: "ref:cycle_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
@@ -1198,7 +1094,7 @@ var embedded_metadata_schema_default = {
             type: "object",
             properties: {
               type: {
-                const: "cycle"
+                const: "workflow"
               }
             }
           }
@@ -1207,58 +1103,58 @@ var embedded_metadata_schema_default = {
       then: {
         properties: {
           payload: {
-            $ref: "ref:cycle_record_schema"
+            $ref: "ref:workflow_record_schema"
           }
         }
-      },
-      else: false
+      }
     }
   ],
   examples: [
     {
       header: {
-        version: "1.0",
-        type: "task",
-        payloadChecksum: "a1b2c3d4e5f6...",
+        version: "1.1",
+        type: "actor",
+        payloadChecksum: "063d4ba3505e4d2d3852f6063cbd0b98a8728b2afb4a26a323c5c5c512137398",
         signatures: [
           {
             keyId: "human:lead-dev",
             role: "author",
-            notes: "Initial task creation for OAuth 2.0 implementation",
-            signature: "...",
+            notes: "Self-registration of lead developer account",
+            signature: "yEtlWOGAek8ukP8fycqYZOyogQBudO5XUf4v4BUGaOTogDH4wraanhLvutaJBM7rdilFUS2VvmxZmIy0KjTZAg==",
             timestamp: 1752274500
           }
         ]
       },
       payload: {
-        id: "1752274500-task-implementar-auth",
-        status: "pending",
-        priority: "high",
-        description: "Implementar autenticaci\xF3n OAuth 2.0.",
-        tags: [
-          "skill:go",
-          "area:backend"
-        ]
+        id: "human:lead-dev",
+        type: "human",
+        displayName: "Lead Developer",
+        publicKey: "0yyrCETtVql51Id+nRKGmpbfsxNxOz+eCYLpWDoutV0=",
+        roles: [
+          "developer",
+          "reviewer"
+        ],
+        status: "active"
       }
     },
     {
       header: {
-        version: "1.0",
+        version: "1.1",
         type: "execution",
-        payloadChecksum: "b2c3d4e5f6a1...",
+        payloadChecksum: "bd667ddc8698a50594592ac15d0761e62a9f05cc3ba10a9a853ef0819e5fb2ad",
         signatures: [
           {
-            keyId: "agent:cursor",
+            keyId: "agent:camilo:cursor",
             role: "author",
             notes: "OAuth 2.0 flow completed with GitHub provider integration",
-            signature: "...",
+            signature: "8d9LWTtMlK/Ct4+QWGFpH4iFdZb9T/hlFThAAGKqz8UOPe9qDwPFcv3b4qz9G+NQXh1/PgB1pl8YiQCe6fnjAQ==",
             timestamp: 1752274600
           },
           {
             keyId: "human:camilo",
             role: "reviewer",
             notes: "Reviewed and tested locally. LGTM.",
-            signature: "...",
+            signature: "17xsA75W0zzNZI3DXa8iHmxS5NwedfCwu9DoXwk/vArk9yaHcFsY6EgJHNPUtIX+XeKSVF/lOg6CvVIkcXjjAA==",
             timestamp: 1752274650
           }
         ]
@@ -1268,39 +1164,30 @@ var embedded_metadata_schema_default = {
         taskId: "1752274500-task-implement-oauth",
         type: "progress",
         title: "OAuth 2.0 flow implemented",
-        result: "Completed the OAuth 2.0 authentication flow..."
+        result: "Completed the OAuth 2.0 authentication flow with GitHub provider. Token refresh and session management included."
       }
     },
     {
       header: {
-        version: "1.0",
-        type: "actor",
-        payloadChecksum: "c3d4e5f6a1b2...",
+        version: "1.1",
+        type: "custom",
+        schemaUrl: "https://example.com/schemas/deployment-record-v1.json",
+        schemaChecksum: "d4e5f6a1b2c3789012345678901234567890123456789012345678901234abcd",
+        payloadChecksum: "1f9598081fcfcf34732de647de25c8445e68e9320e0c10d3a4bd911c7274a1b3",
         signatures: [
           {
-            keyId: "human:admin",
+            keyId: "agent:deploy-bot",
             role: "author",
-            notes: "New developer onboarded to team",
-            signature: "...",
+            notes: "Production deployment of v2.1.0",
+            signature: "W3cSLJnEp+OmKVOwFqjuLTL1S55/OlQyFDzmmxg+vUfETIiQWNr7aDH06/rHUM11g2BLEGRfXZPQPFry6FJeAw==",
             timestamp: 1752274700
-          },
-          {
-            keyId: "agent:aion",
-            role: "auditor",
-            notes: "Actor verification: 10/10. Credentials validated.",
-            signature: "...",
-            timestamp: 1752274705
           }
         ]
       },
       payload: {
-        id: "human:new-developer",
-        type: "human",
-        displayName: "New Developer",
-        publicKey: "...",
-        roles: [
-          "developer"
-        ]
+        deploymentId: "deploy-2025-07-12-v2.1.0",
+        environment: "production",
+        status: "success"
       }
     }
   ]
@@ -1311,7 +1198,7 @@ var execution_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "execution_record_schema.json",
   title: "ExecutionRecord",
-  description: "Canonical schema for execution log records - the universal event stream",
+  description: "Canonical schema for execution log records - the universal event stream.",
   additionalProperties: false,
   type: "object",
   required: [
@@ -1326,209 +1213,50 @@ var execution_record_schema_default = {
       type: "string",
       pattern: "^\\d{10}-exec-[a-z0-9-]{1,50}$",
       maxLength: 66,
-      description: "Unique identifier for the execution log entry (10 timestamp + 1 dash + 4 'exec' + 1 dash + max 50 slug = 66 max)",
-      examples: [
-        "1752275000-exec-refactor-queries",
-        "1752361200-exec-api-externa-caida"
-      ]
+      description: "Unique identifier for the execution log entry."
     },
     taskId: {
       type: "string",
       pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$",
       maxLength: 66,
-      description: "ID of the parent task this execution belongs to (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)"
+      description: "ID of the parent task this execution belongs to."
     },
     type: {
       type: "string",
-      enum: [
-        "analysis",
-        "progress",
-        "blocker",
-        "completion",
-        "info",
-        "correction"
-      ],
-      description: "Semantic classification of the execution event",
-      examples: [
-        "progress",
-        "analysis",
-        "blocker",
-        "completion"
-      ]
+      pattern: "^(analysis|decision|progress|blocker|completion|correction|info|custom:[a-z0-9-]+(:[a-z0-9-]+)*)$",
+      description: "Classifies what happened in this execution event. Primitive types cover the fundamental kinds of events that occur during any collaborative work. Extend with 'custom:' for your domain.\nPrimitive types:\n  - analysis: Investigation, research, or evaluation before acting.\n  - decision: A choice that changes the direction of work.\n  - progress: Incremental advancement of work.\n  - blocker: An impediment preventing further progress.\n  - completion: Work on the task is finished.\n  - correction: A fix to something previously done incorrectly.\n  - info: Informational note or status update.\n\nCustom types use the 'custom:' prefix for industry-specific extensions. Software development examples:\n  - custom:review (code review, design review, QA)\n  - custom:deployment (deploy to staging/production)\n  - custom:rollback (revert a deployment or change)\n  - custom:release (version release, PR merge to main)\n  - custom:hotfix (emergency fix in production)\nImplementations that encounter an unrecognized custom type MUST treat it as 'info' for display purposes.\n"
     },
     title: {
       type: "string",
       minLength: 1,
       maxLength: 256,
-      description: "Human-readable title for the execution (used to generate ID)",
-      examples: [
-        "Refactor de queries N+1",
-        "API Externa Ca\xEDda",
-        "Plan de implementaci\xF3n OAuth2"
-      ]
+      description: "Human-readable title for the execution (used to generate ID slug)."
     },
     result: {
       type: "string",
       minLength: 10,
-      maxLength: 22e3,
-      description: 'The tangible, verifiable output or result of the execution. \nThis is the "WHAT" - evidence of work or event summary.\n'
+      description: 'The tangible, verifiable output or result of the execution. This is the "WHAT" - evidence of work or event summary.\n'
     },
     notes: {
       type: "string",
-      maxLength: 6500,
-      description: 'Optional narrative, context and decisions behind the execution.\nThis is the "HOW" and "WHY" - the story behind the result.\n'
+      description: 'Optional narrative, context and decisions behind the execution. This is the "HOW" and "WHY" - the story behind the result.\n'
     },
     references: {
       type: "array",
       items: {
         type: "string",
+        minLength: 1,
         maxLength: 500
       },
       default: [],
-      description: "Optional list of typed references to relevant commits, files, PRs, or external documents.\nShould use typed prefixes for clarity and trazabilidad (see execution_protocol_appendix.md):\n- commit:     Git commit SHA\n- pr:         Pull Request number\n- file:       File path (relative to repo root)\n- url:        External URL\n- issue:      GitHub Issue number\n- task:       TaskRecord ID\n- exec:       ExecutionRecord ID (for corrections or dependencies)\n- changelog:  ChangelogRecord ID\n"
+      description: "Optional list of typed references to relevant commits, files, PRs, or external documents. Standard prefixes: commit:, pr:, issue:, file:, url:, task:, exec:.\n"
     },
     metadata: {
       type: "object",
       additionalProperties: true,
-      description: "Optional structured data for machine consumption.\nUse this field for data that needs to be programmatically processed (e.g., audit findings,\nperformance metrics, scan results). This complements result (human-readable WHAT) and\nnotes (narrative HOW/WHY) by providing structured, queryable data.\nCommon use cases: audit findings arrays, performance metrics, tool outputs, scan summaries.\n",
-      examples: [
-        {
-          findings: [
-            {
-              type: "PII",
-              file: "src/user.ts",
-              line: 42
-            }
-          ],
-          scannedFiles: 245
-        },
-        {
-          metrics: {
-            duration_ms: 1250,
-            memory_mb: 512
-          }
-        }
-      ]
-    }
-  },
-  examples: [
-    {
-      id: "1752275500-exec-refactor-queries",
-      taskId: "1752274500-task-optimizar-api",
-      type: "progress",
-      title: "Refactor de queries N+1",
-      result: "Refactorizados 3 queries N+1 a un solo JOIN optimizado. Performance mejor\xF3 de 2.5s a 200ms.",
-      notes: "Identificados 3 N+1 queries en el endpoint /api/search. Aplicado eager loading y caching de relaciones.",
-      references: [
-        "commit:b2c3d4e",
-        "file:src/api/search.ts"
-      ]
-    },
-    {
-      id: "1752361200-exec-api-externa-caida",
-      taskId: "1752274500-task-optimizar-api",
-      type: "blocker",
-      title: "API Externa Ca\xEDda",
-      result: "No se puede continuar con testing de integraci\xF3n. API de pagos devuelve 503.",
-      notes: "La API de pagos de terceros (api.payments.com) est\xE1 devolviendo errores 503. Contactado soporte del proveedor. ETA de resoluci\xF3n: 2-3 horas.",
-      references: [
-        "url:https://status.payments.com"
-      ]
-    },
-    {
-      id: "1752188000-exec-plan-oauth-implementation",
-      taskId: "1752274500-task-oauth-implementation",
-      type: "analysis",
-      title: "Plan de implementaci\xF3n OAuth2",
-      result: "Documento de dise\xF1o t\xE9cnico completado. 5 sub-tareas identificadas con estimaciones de complejidad.",
-      notes: "Evaluadas 3 opciones: NextAuth.js (elegida), Passport.js, custom implementation. NextAuth.js por madurez y soporte de m\xFAltiples providers.",
-      references: [
-        "file:docs/oauth-design.md"
-      ]
-    },
-    {
-      id: "1752707800-exec-oauth-completed",
-      taskId: "1752274500-task-oauth-implementation",
-      type: "completion",
-      title: "OAuth Implementation Completed",
-      result: "Sistema OAuth2 completamente implementado, testeado y deployado a staging. 95% test coverage. Todos los acceptance criteria cumplidos.",
-      notes: "Implementaci\xF3n finalizada. Code review aprobado. Tests E2E passing. Ready para changelog y deploy a producci\xF3n.",
-      references: [
-        "pr:456",
-        "commit:def789abc",
-        "url:https://staging.app.com/login"
-      ]
-    },
-    {
-      id: "1752275600-exec-cambio-estrategia-redis",
-      taskId: "1752274500-task-oauth-implementation",
-      type: "info",
-      title: "Cambio de estrategia: Usar Redis para sessions",
-      result: "Decisi\xF3n: Migrar de JWT stateless a sessions en Redis por requisito de revocaci\xF3n inmediata.",
-      notes: "Durante code review se identific\xF3 requisito cr\xEDtico: revocar sesiones inmediatamente (ej: compromiso de cuenta). JWT stateless no permite esto sin lista negra compleja. Redis sessions permite revocaci\xF3n instant\xE1nea.",
-      references: [
-        "issue:567",
-        "url:https://redis.io/docs/manual/keyspace-notifications/"
-      ]
-    },
-    {
-      id: "1752275700-exec-correccion-metricas",
-      taskId: "1752274500-task-optimizar-api",
-      type: "correction",
-      title: "Correcci\xF3n: M\xE9tricas de performance",
-      result: "Correcci\xF3n de execution 1752275500-exec-refactor-queries: El performance fue 200ms, no 50ms como se report\xF3.",
-      notes: "Error de tipeo en execution original. La mejora real fue de 2.5s a 200ms (no 50ms). Sigue siendo significativa (92% mejora) pero n\xFAmeros correctos son importantes para m\xE9tricas.",
-      references: [
-        "exec:1752275500-exec-refactor-queries"
-      ]
-    },
-    {
-      id: "1752276000-exec-source-audit-scan",
-      taskId: "1752274500-task-audit-compliance",
-      type: "analysis",
-      title: "Source Audit Scan - 2025-01-15",
-      result: "Escaneados 245 archivos. Encontrados 10 findings (3 critical, 4 high, 3 medium). Ver metadata para detalles estructurados.",
-      notes: "Scan ejecutado con RegexDetector + HeuristicDetector. LLM calls: 0 (tier free).",
-      references: [
-        "file:src/config/db.ts",
-        "file:src/auth/keys.ts"
-      ],
-      metadata: {
-        scannedFiles: 245,
-        scannedLines: 18420,
-        duration_ms: 1250,
-        findings: [
-          {
-            id: "SEC-001",
-            severity: "critical",
-            file: "src/config/db.ts",
-            line: 5,
-            type: "api_key"
-          },
-          {
-            id: "SEC-003",
-            severity: "critical",
-            file: "src/auth/keys.ts",
-            line: 2,
-            type: "private_key"
-          },
-          {
-            id: "PII-003",
-            severity: "critical",
-            file: "src/payments/stripe.ts",
-            line: 8,
-            type: "credit_card"
-          }
-        ],
-        summary: {
-          critical: 3,
-          high: 4,
-          medium: 3,
-          low: 0
-        }
-      }
+      description: "Optional structured data for machine consumption. Use this field for data that needs to be programmatically processed (e.g., audit findings, performance metrics, scan results). Complements result (WHAT) and notes (HOW/WHY) with structured, queryable data.\n"
     }
-  ]
+  }
 };
 
 // src/record_schemas/generated/feedback_record_schema.json
@@ -1536,7 +1264,7 @@ var feedback_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "feedback_record_schema.json",
   title: "FeedbackRecord",
-  description: "Canonical schema for feedback records - structured conversation about work",
+  description: "Canonical schema for feedback records \u2014 the structured conversation about work.",
   additionalProperties: false,
   type: "object",
   required: [
@@ -1552,32 +1280,35 @@ var feedback_record_schema_default = {
       type: "string",
       pattern: "^\\d{10}-feedback-[a-z0-9-]{1,50}$",
       maxLength: 70,
-      description: "Unique identifier for the feedback entry",
+      description: "Unique identifier for the feedback entry (10 timestamp + 1 dash + 8 'feedback' + 1 dash + max 50 slug = 70 max)",
       examples: [
         "1752788100-feedback-blocking-rest-api",
-        "1752788200-feedback-question-test-coverage"
+        "1752788400-feedback-question-test-coverage"
       ]
     },
     entityType: {
       type: "string",
       enum: [
+        "actor",
+        "agent",
         "task",
         "execution",
-        "changelog",
         "feedback",
-        "cycle"
+        "cycle",
+        "workflow"
       ],
-      description: "The type of entity this feedback refers to"
+      description: "The type of entity this feedback refers to."
     },
     entityId: {
       type: "string",
       minLength: 1,
       maxLength: 256,
-      description: "The ID of the entity this feedback refers to.\nMust match the pattern for its entityType:\n- task: ^\\d{10}-task-[a-z0-9-]{1,50}$\n- execution: ^\\d{10}-exec-[a-z0-9-]{1,50}$\n- changelog: ^\\d{10}-changelog-[a-z0-9-]{1,50}$\n- feedback: ^\\d{10}-feedback-[a-z0-9-]{1,50}$\n- cycle: ^\\d{10}-cycle-[a-z0-9-]{1,50}$\n",
+      description: "The ID of the entity this feedback refers to.\nMust match the ID pattern for its entityType:\n- actor: ^(human|agent)(:[a-z0-9-]+)+$\n- agent: ^agent(:[a-z0-9-]+)+$\n- task: ^\\d{10}-task-[a-z0-9-]{1,50}$\n- execution: ^\\d{10}-exec-[a-z0-9-]{1,50}$\n- feedback: ^\\d{10}-feedback-[a-z0-9-]{1,50}$\n- cycle: ^\\d{10}-cycle-[a-z0-9-]{1,50}$\n- workflow: ^\\d{10}-workflow-[a-z0-9-]{1,50}$\n",
       examples: [
         "1752274500-task-implementar-oauth",
         "1752642000-exec-subtarea-9-4",
-        "1752788100-feedback-blocking-rest-api"
+        "1752788100-feedback-blocking-rest-api",
+        "human:camilo"
       ]
     },
     type: {
@@ -1590,64 +1321,191 @@ var feedback_record_schema_default = {
         "clarification",
         "assignment"
       ],
-      description: "The semantic intent of the feedback",
+      description: "The semantic intent of the feedback."
+    },
+    status: {
+      type: "string",
+      enum: [
+        "open",
+        "acknowledged",
+        "resolved",
+        "wontfix"
+      ],
+      description: 'The lifecycle status of the feedback.\nFeedbackRecords are immutable. To change status, create a new FeedbackRecord\nthat references this one using entityType: "feedback" and resolvesFeedbackId.\n'
+    },
+    content: {
+      type: "string",
+      minLength: 1,
+      description: "The content of the feedback."
+    },
+    assignee: {
+      type: "string",
+      pattern: "^(human|agent)(:[a-z0-9-]+)+$",
+      maxLength: 256,
+      description: "Optional. The Actor ID responsible for addressing the feedback (e.g., 'human:maria', 'agent:camilo:cursor').",
       examples: [
-        "blocking",
-        "question",
-        "approval"
+        "human:maria",
+        "agent:code-reviewer",
+        "agent:camilo:cursor"
+      ]
+    },
+    resolvesFeedbackId: {
+      type: "string",
+      pattern: "^\\d{10}-feedback-[a-z0-9-]{1,50}$",
+      maxLength: 70,
+      description: "Optional. The ID of another FeedbackRecord that this one resolves or responds to.",
+      examples: [
+        "1752788100-feedback-blocking-rest-api"
       ]
     },
-    status: {
-      type: "string",
-      enum: [
-        "open",
-        "acknowledged",
-        "resolved",
-        "wontfix"
-      ],
-      description: 'The lifecycle status of the feedback. \nNote: FeedbackRecords are immutable. To change status, create a new feedback \nthat references this one using entityType: "feedback" and resolvesFeedbackId.\n'
+    metadata: {
+      type: "object",
+      additionalProperties: true,
+      description: "Optional structured data for machine consumption.\nUse this field for domain-specific data that needs to be programmatically processed.\nCommon use cases: waiver details (fingerprint, ruleId, file, line), approval context, assignment metadata.\n"
+    }
+  },
+  allOf: [
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "actor"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^(human|agent)(:[a-z0-9-]+)+$"
+          }
+        }
+      }
+    },
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "agent"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^agent(:[a-z0-9-]+)+$"
+          }
+        }
+      }
+    },
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "task"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
     },
-    content: {
-      type: "string",
-      minLength: 1,
-      maxLength: 5e3,
-      description: "The content of the feedback. Reduced from 10000 to 5000 chars for practical use."
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "execution"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-exec-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
     },
-    assignee: {
-      type: "string",
-      pattern: "^(human|agent)(:[a-z0-9-]+)+$",
-      maxLength: 256,
-      description: "Optional. The Actor ID responsible for addressing the feedback (e.g., 'human:maria', 'agent:camilo:cursor')",
-      examples: [
-        "human:maria",
-        "agent:code-reviewer",
-        "agent:camilo:cursor"
-      ]
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "feedback"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-feedback-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
     },
-    resolvesFeedbackId: {
-      type: "string",
-      pattern: "^\\d{10}-feedback-[a-z0-9-]{1,50}$",
-      maxLength: 70,
-      description: "Optional. The ID of another feedback record that this one resolves or responds to",
-      examples: [
-        "1752788100-feedback-blocking-rest-api"
-      ]
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "cycle"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
     },
-    metadata: {
-      type: "object",
-      additionalProperties: true,
-      description: "Optional structured data for machine consumption.\nUse this field for domain-specific data that needs to be programmatically processed.\nCommon use cases: waiver details (fingerprint, ruleId, file, line), approval context, assignment metadata.\n",
-      examples: [
-        {
-          fingerprint: "abc123def456",
-          ruleId: "PII-001",
-          file: "src/user.ts",
-          line: 42,
-          expiresAt: "2025-12-31T23:59:59Z"
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "workflow"
+          }
         }
-      ]
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-workflow-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
     }
-  },
+  ],
   examples: [
     {
       id: "1752788100-feedback-blocking-rest-api",
@@ -1655,7 +1513,7 @@ var feedback_record_schema_default = {
       entityId: "1752642000-exec-subtarea-9-4",
       type: "blocking",
       status: "open",
-      content: "Esta implementaci\xF3n no cumple el est\xE1ndar de rutas REST. Los endpoints deben seguir el patr\xF3n /api/v1/{resource}/{id}. Actualmente usa /get-user?id=X que no es RESTful."
+      content: "This implementation does not comply with the REST endpoint standard. Endpoints must follow the /api/v1/{resource}/{id} pattern. Currently uses /get-user?id=X which is not RESTful."
     },
     {
       id: "1752788200-feedback-rest-api-fixed",
@@ -1663,7 +1521,7 @@ var feedback_record_schema_default = {
       entityId: "1752788100-feedback-blocking-rest-api",
       type: "clarification",
       status: "resolved",
-      content: "Implementada la correcci\xF3n. Ahora todos los endpoints siguen el est\xE1ndar REST: GET /api/v1/users/:id, POST /api/v1/users, etc. Tests actualizados y passing.",
+      content: "Fix implemented. All endpoints now follow REST standard: GET /api/v1/users/:id, POST /api/v1/users, etc. Tests updated and passing.",
       resolvesFeedbackId: "1752788100-feedback-blocking-rest-api"
     },
     {
@@ -1672,7 +1530,7 @@ var feedback_record_schema_default = {
       entityId: "1752274500-task-implementar-oauth",
       type: "assignment",
       status: "open",
-      content: "Asignando esta tarea a Mar\xEDa por su experiencia con OAuth2. Prioridad alta para el sprint actual.",
+      content: "Assigning this task to Maria for her experience with OAuth2. High priority for the current sprint.",
       assignee: "human:maria"
     },
     {
@@ -1681,7 +1539,7 @@ var feedback_record_schema_default = {
       entityId: "1752274500-task-implementar-oauth",
       type: "question",
       status: "open",
-      content: "\xBFCu\xE1l es el nivel de test coverage esperado para esta feature? El spec no lo menciona expl\xEDcitamente. \xBFDebemos apuntar a 80% como el resto del proyecto?"
+      content: "What level of test coverage is expected for this feature? The spec does not mention it explicitly. Should we aim for 80% like the rest of the project?"
     }
   ]
 };
@@ -1691,7 +1549,7 @@ var task_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
   $id: "task_record_schema.json",
   title: "TaskRecord",
-  description: "Canonical schema for task records as defined in task_protocol.md",
+  description: "Canonical schema for task records as defined in 04_task.md",
   additionalProperties: false,
   type: "object",
   required: [
@@ -1741,7 +1599,6 @@ var task_record_schema_default = {
         "paused",
         "discarded"
       ],
-      maxLength: 40,
       description: "Current state of the task in the institutional flow"
     },
     priority: {
@@ -1752,13 +1609,11 @@ var task_record_schema_default = {
         "high",
         "critical"
       ],
-      maxLength: 40,
       description: "Strategic or tactical priority level"
     },
     description: {
       type: "string",
       minLength: 10,
-      maxLength: 22e3,
       description: "Functional, technical or strategic summary of the objective"
     },
     tags: {
@@ -1766,7 +1621,7 @@ var task_record_schema_default = {
       items: {
         type: "string",
         minLength: 1,
-        pattern: "^[a-z0-9-]+(:[a-z0-9-:]+)*$"
+        pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
       },
       default: [],
       description: "Optional. List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer')."
@@ -1783,9 +1638,26 @@ var task_record_schema_default = {
     },
     notes: {
       type: "string",
-      minLength: 0,
-      maxLength: 3e3,
+      minLength: 1,
       description: "Additional comments, decisions made or added context"
+    },
+    metadata: {
+      type: "object",
+      additionalProperties: true,
+      description: "Optional structured data for machine consumption.\nUse this field for domain-specific data that needs to be programmatically processed.\nComplements tags (classification) and notes (free text) with structured, queryable data.\nCommon use cases: epic metadata, external tool references, agent metrics, compliance tags.\n",
+      examples: [
+        {
+          epic: true,
+          phase: "implementation",
+          files: {
+            overview: "overview.md"
+          }
+        },
+        {
+          jira: "AUTH-42",
+          storyPoints: 5
+        }
+      ]
     }
   },
   examples: [
@@ -1868,25 +1740,22 @@ var task_record_schema_default = {
 // src/record_schemas/generated/workflow_record_schema.json
 var workflow_record_schema_default = {
   $schema: "http://json-schema.org/draft-07/schema#",
-  $id: "workflow_schema.json",
+  $id: "workflow_record_schema.json",
   title: "WorkflowRecord",
-  description: "Complete schema for workflow methodology configuration files that define state transitions, signatures, and custom rules",
+  description: "Schema for workflow methodology configuration that defines named state transitions, signatures, and custom rules.",
   type: "object",
   required: [
-    "version",
+    "id",
     "name",
     "state_transitions"
   ],
   additionalProperties: false,
   properties: {
-    $schema: {
-      type: "string",
-      description: "JSON Schema reference"
-    },
-    version: {
+    id: {
       type: "string",
-      pattern: "^\\d+\\.\\d+\\.\\d+$",
-      description: "Semantic version of the methodology configuration"
+      pattern: "^\\d{10}-workflow-[a-z0-9-]{1,50}$",
+      maxLength: 70,
+      description: "Unique identifier for the workflow record (10 timestamp + 1 dash + 8 'workflow' + 1 dash + max 50 slug = 70 max)"
     },
     name: {
       type: "string",
@@ -1901,11 +1770,15 @@ var workflow_record_schema_default = {
     },
     state_transitions: {
       type: "object",
-      description: "Defines valid state transitions and their requirements",
+      description: "Map of named transitions to their rules. Keys are transition names (e.g., submit, approve, activate, resume), not target states.",
+      propertyNames: {
+        pattern: "^[a-z][a-z0-9_]{0,49}$"
+      },
       additionalProperties: {
         type: "object",
         required: [
           "from",
+          "to",
           "requires"
         ],
         additionalProperties: false,
@@ -1919,21 +1792,26 @@ var workflow_record_schema_default = {
             minItems: 1,
             description: "Valid source states for this transition"
           },
+          to: {
+            type: "string",
+            pattern: "^[a-z][a-z0-9_]{0,49}$",
+            description: "Target state for this transition"
+          },
           requires: {
             type: "object",
             additionalProperties: false,
             properties: {
               command: {
                 type: "string",
-                description: "CLI command that triggers this transition"
+                description: "CLI command that triggers this transition (Command Gate)"
               },
               event: {
                 type: "string",
-                description: "System event that triggers this transition"
+                description: "System event that triggers this transition (Event Gate)"
               },
               signatures: {
                 type: "object",
-                description: "Signature requirements keyed by role (e.g., 'approver:quality', 'developer:backend')",
+                description: "Signature group requirements (Signature Gate)",
                 additionalProperties: {
                   type: "object",
                   required: [
@@ -1973,7 +1851,7 @@ var workflow_record_schema_default = {
                       items: {
                         type: "string"
                       },
-                      description: "Optional: specific actors that can sign"
+                      description: "Optional: restrict to specific actor IDs"
                     }
                   }
                 }
@@ -2022,7 +1900,7 @@ var workflow_record_schema_default = {
           },
           expression: {
             type: "string",
-            description: "Inline validation expression for 'custom' validation type. Implementation determines the runtime and language. Must return boolean or Promise<boolean>."
+            description: "Inline validation expression for 'custom' type. Must return boolean."
           },
           module_path: {
             type: "string",
@@ -2033,7 +1911,7 @@ var workflow_record_schema_default = {
     },
     agent_integration: {
       type: "object",
-      description: "Optional agent automation configuration for methodology",
+      description: "Optional agent automation configuration",
       additionalProperties: false,
       properties: {
         description: {
@@ -2043,7 +1921,7 @@ var workflow_record_schema_default = {
         },
         required_agents: {
           type: "array",
-          description: "References to agents required for this methodology. Agent details (engine, knowledge, etc.) live in their AgentRecord.",
+          description: "Agents required for this methodology",
           items: {
             type: "object",
             required: [
@@ -2065,8 +1943,8 @@ var workflow_record_schema_default = {
             properties: {
               id: {
                 type: "string",
-                pattern: "^agent:[a-z0-9:-]+$",
-                description: "Specific agent ID. References an existing AgentRecord."
+                pattern: "^agent(:[a-z0-9-]+)+$",
+                description: "Specific agent ID (references an AgentRecord)"
               },
               required_roles: {
                 type: "array",
@@ -2075,11 +1953,11 @@ var workflow_record_schema_default = {
                   pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
                 },
                 minItems: 1,
-                description: "Required capability roles. Matches any agent with these roles (from ActorRecord)."
+                description: "Required capability roles (matches any agent with these roles)"
               },
               triggers: {
                 type: "array",
-                description: "When this agent activates within this methodology",
+                description: "Events that activate this agent",
                 items: {
                   type: "object",
                   required: [
@@ -2108,190 +1986,13 @@ var workflow_record_schema_default = {
         }
       }
     }
-  },
-  examples: [
-    {
-      version: "1.0.0",
-      name: "Simple Kanban",
-      description: "Basic workflow for small teams",
-      state_transitions: {
-        review: {
-          from: [
-            "draft"
-          ],
-          requires: {
-            command: "gitgov task submit"
-          }
-        },
-        ready: {
-          from: [
-            "review"
-          ],
-          requires: {
-            command: "gitgov task approve",
-            signatures: {
-              __default__: {
-                role: "approver",
-                capability_roles: [
-                  "approver:product"
-                ],
-                min_approvals: 1
-              }
-            }
-          }
-        },
-        active: {
-          from: [
-            "ready"
-          ],
-          requires: {
-            event: "first_execution_record_created"
-          }
-        },
-        done: {
-          from: [
-            "active"
-          ],
-          requires: {
-            command: "gitgov task complete"
-          }
-        }
-      }
-    },
-    {
-      version: "1.0.0",
-      name: "GitGovernance Default Methodology",
-      description: "Standard GitGovernance workflow with quality gates and agent collaboration",
-      state_transitions: {
-        review: {
-          from: [
-            "draft"
-          ],
-          requires: {
-            command: "gitgov task submit",
-            signatures: {
-              __default__: {
-                role: "submitter",
-                capability_roles: [
-                  "author"
-                ],
-                min_approvals: 1
-              }
-            }
-          }
-        },
-        ready: {
-          from: [
-            "review"
-          ],
-          requires: {
-            command: "gitgov task approve",
-            signatures: {
-              __default__: {
-                role: "approver",
-                capability_roles: [
-                  "approver:product"
-                ],
-                min_approvals: 1
-              },
-              design: {
-                role: "approver",
-                capability_roles: [
-                  "approver:design"
-                ],
-                min_approvals: 1
-              },
-              quality: {
-                role: "approver",
-                capability_roles: [
-                  "approver:quality"
-                ],
-                min_approvals: 1
-              }
-            }
-          }
-        },
-        active: {
-          from: [
-            "ready",
-            "paused"
-          ],
-          requires: {
-            event: "first_execution_record_created",
-            custom_rules: [
-              "task_must_have_valid_assignment_for_executor"
-            ]
-          }
-        },
-        done: {
-          from: [
-            "active"
-          ],
-          requires: {
-            command: "gitgov task complete",
-            signatures: {
-              __default__: {
-                role: "approver",
-                capability_roles: [
-                  "approver:quality"
-                ],
-                min_approvals: 1
-              }
-            }
-          }
-        },
-        archived: {
-          from: [
-            "done"
-          ],
-          requires: {
-            event: "changelog_record_created"
-          }
-        },
-        paused: {
-          from: [
-            "active",
-            "review"
-          ],
-          requires: {
-            event: "feedback_blocking_created"
-          }
-        },
-        discarded: {
-          from: [
-            "ready",
-            "active"
-          ],
-          requires: {
-            command: "gitgov task cancel",
-            signatures: {
-              __default__: {
-                role: "canceller",
-                capability_roles: [
-                  "approver:product",
-                  "approver:quality"
-                ],
-                min_approvals: 1
-              }
-            }
-          }
-        }
-      },
-      custom_rules: {
-        task_must_have_valid_assignment_for_executor: {
-          description: "Task must have a valid assignment before execution can begin",
-          validation: "assignment_required"
-        }
-      }
-    }
-  ]
+  }
 };
 
 // src/record_schemas/generated/index.ts
 var Schemas = {
   ActorRecord: actor_record_schema_default,
   AgentRecord: agent_record_schema_default,
-  ChangelogRecord: changelog_record_schema_default,
   CycleRecord: cycle_record_schema_default,
   EmbeddedMetadata: embedded_metadata_schema_default,
   ExecutionRecord: execution_record_schema_default,
@@ -2342,7 +2043,6 @@ var SchemaValidationCache = class {
       const schemaRefMap = {
         "ActorRecord": "ref:actor_record_schema",
         "AgentRecord": "ref:agent_record_schema",
-        "ChangelogRecord": "ref:changelog_record_schema",
         "CycleRecord": "ref:cycle_record_schema",
         "ExecutionRecord": "ref:execution_record_schema",
         "FeedbackRecord": "ref:feedback_record_schema",
@@ -2890,10 +2590,6 @@ function generateExecutionId(title, timestamp) {
   const slug = sanitizeForId(title);
   return `${timestamp}-exec-${slug}`;
 }
-function generateChangelogId(title, timestamp) {
-  const slug = sanitizeForId(title);
-  return `${timestamp}-changelog-${slug}`;
-}
 function generateFeedbackId(title, timestamp) {
   const slug = sanitizeForId(title);
   return `${timestamp}-feedback-${slug}`;
@@ -2912,7 +2608,7 @@ function createTaskRecord(payload) {
     cycleIds: payload.cycleIds,
     references: payload.references,
     notes: payload.notes,
-    ...payload
+    metadata: payload.metadata
   };
   const validation = validateTaskRecordDetailed(task);
   if (!validation.isValid) {
@@ -2981,7 +2677,7 @@ function createCycleRecord(payload) {
     childCycleIds: payload.childCycleIds,
     tags: payload.tags,
     notes: payload.notes,
-    ...payload
+    metadata: payload.metadata
   };
   const validation = validateCycleRecordDetailed(cycle);
   if (!validation.isValid) {
@@ -3486,8 +3182,8 @@ var FeedbackAdapter = class {
     if (!payloadWithEntityId.entityId) {
       throw new Error("RecordNotFoundError: entityId is required");
     }
-    if (payloadWithEntityId.entityType && !["task", "execution", "changelog", "feedback", "cycle"].includes(payloadWithEntityId.entityType)) {
-      throw new Error("InvalidEntityTypeError: entityType must be task, execution, changelog, feedback, or cycle");
+    if (payloadWithEntityId.entityType && !["task", "execution", "feedback", "cycle"].includes(payloadWithEntityId.entityType)) {
+      throw new Error("InvalidEntityTypeError: entityType must be task, execution, feedback, or cycle");
     }
     if (payload.type === "assignment" && payload.assignee) {
       const existingFeedbacks = await this.getFeedbackByEntity(payloadWithEntityId.entityId);
@@ -4314,10 +4010,6 @@ var BacklogAdapter = class {
       "execution.created",
       (event) => this.handleExecutionCreated(event)
     );
-    this.eventBus.subscribe(
-      "changelog.created",
-      (event) => this.handleChangelogCreated(event)
-    );
     this.eventBus.subscribe(
       "cycle.status.changed",
       (event) => this.handleCycleStatusChanged(event)
@@ -4895,73 +4587,33 @@ ${task.status === "review" ? "[REJECTED]" : "[CANCELLED]"} ${reason} (${(/* @__P
       }
       const actor = await this.getActor(event.payload.triggeredBy);
       const transitionRule = await this.workflowAdapter.getTransitionRule("ready", "active", {
-        task,
-        actor,
-        signatures: []
-      });
-      if (!transitionRule) {
-        console.warn(`Workflow rejected ready\u2192active transition for task ${task.id}`);
-        return;
-      }
-      const updatedTask = { ...task, status: "active" };
-      const taskRecord = await this.stores.tasks.get(task.id);
-      if (taskRecord) {
-        const updatedRecord = { ...taskRecord, payload: updatedTask };
-        await this.stores.tasks.put(updatedRecord.payload.id, updatedRecord);
-        this.eventBus.publish({
-          type: "task.status.changed",
-          timestamp: Date.now(),
-          source: "backlog_adapter",
-          payload: {
-            taskId: task.id,
-            oldStatus: "ready",
-            newStatus: "active",
-            actorId: event.payload.triggeredBy
-          }
-        });
-      }
-    } catch (error) {
-      console.error("Error in handleExecutionCreated:", error);
-    }
-  }
-  /**
-   * [EARS-37] Handles changelog created events - transitions done→archived
-   */
-  async handleChangelogCreated(event) {
-    try {
-      const changelogRecord = await this.stores.changelogs.get(event.payload.changelogId);
-      if (!changelogRecord) {
-        console.warn(`Changelog not found: ${event.payload.changelogId}`);
-        return;
-      }
-      if (!changelogRecord.payload.relatedTasks || changelogRecord.payload.relatedTasks.length === 0) {
-        return;
-      }
-      for (const taskId of changelogRecord.payload.relatedTasks) {
-        const task = await this.getTask(taskId);
-        if (!task || task.status !== "done") {
-          continue;
-        }
-        const updatedTask = { ...task, status: "archived" };
-        const taskRecord = await this.stores.tasks.get(task.id);
-        if (taskRecord) {
-          const updatedRecord = { ...taskRecord, payload: updatedTask };
-          await this.stores.tasks.put(updatedRecord.payload.id, updatedRecord);
-          this.eventBus.publish({
-            type: "task.status.changed",
-            timestamp: Date.now(),
-            source: "backlog_adapter",
-            payload: {
-              taskId: task.id,
-              oldStatus: "done",
-              newStatus: "archived",
-              actorId: "system"
-            }
-          });
-        }
+        task,
+        actor,
+        signatures: []
+      });
+      if (!transitionRule) {
+        console.warn(`Workflow rejected ready\u2192active transition for task ${task.id}`);
+        return;
+      }
+      const updatedTask = { ...task, status: "active" };
+      const taskRecord = await this.stores.tasks.get(task.id);
+      if (taskRecord) {
+        const updatedRecord = { ...taskRecord, payload: updatedTask };
+        await this.stores.tasks.put(updatedRecord.payload.id, updatedRecord);
+        this.eventBus.publish({
+          type: "task.status.changed",
+          timestamp: Date.now(),
+          source: "backlog_adapter",
+          payload: {
+            taskId: task.id,
+            oldStatus: "ready",
+            newStatus: "active",
+            actorId: event.payload.triggeredBy
+          }
+        });
       }
     } catch (error) {
-      console.error("Error in handleChangelogCreated:", error);
+      console.error("Error in handleExecutionCreated:", error);
     }
   }
   /**
@@ -5365,252 +5017,6 @@ ${task.status === "review" ? "[REJECTED]" : "[CANCELLED]"} ${reason} (${(/* @__P
   }
 };
 
-// src/adapters/changelog_adapter/index.ts
-var changelog_adapter_exports = {};
-__export(changelog_adapter_exports, {
-  ChangelogAdapter: () => ChangelogAdapter
-});
-
-// src/record_validations/changelog_validator.ts
-function validateChangelogRecordSchema(data) {
-  const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.ChangelogRecord);
-  const isValid = validator(data);
-  return [isValid, validator.errors];
-}
-function isChangelogRecord(data) {
-  const [isValid] = validateChangelogRecordSchema(data);
-  return isValid;
-}
-function validateChangelogRecordDetailed(data) {
-  const [isValid, errors] = validateChangelogRecordSchema(data);
-  if (!isValid && errors) {
-    const formattedErrors = errors.map((error) => ({
-      field: error.instancePath?.replace("/", "") || error.params?.["missingProperty"] || "root",
-      message: error.message || "Unknown validation error",
-      value: error.data
-    }));
-    return {
-      isValid: false,
-      errors: formattedErrors
-    };
-  }
-  return {
-    isValid: true,
-    errors: []
-  };
-}
-async function validateFullChangelogRecord(record, getPublicKey) {
-  const [isValid, errors] = validateChangelogRecordSchema(record.payload);
-  if (!isValid) {
-    const formattedErrors = (errors || []).map((error) => ({
-      field: error.instancePath?.replace("/", "") || error.params?.["missingProperty"] || "root",
-      message: error.message || "Unknown validation error",
-      value: error.data
-    }));
-    throw new DetailedValidationError("ChangelogRecord", formattedErrors);
-  }
-  await validateFullEmbeddedMetadataRecord(record, getPublicKey);
-}
-
-// src/record_factories/changelog_factory.ts
-function createChangelogRecord(payload) {
-  const timestamp = Math.floor(Date.now() / 1e3);
-  const changelog = {
-    // Required fields
-    id: payload.id || "",
-    title: payload.title || "",
-    description: payload.description || "",
-    relatedTasks: payload.relatedTasks || [],
-    completedAt: payload.completedAt || timestamp,
-    // Optional fields (only include if provided)
-    ...payload.relatedCycles && { relatedCycles: payload.relatedCycles },
-    ...payload.relatedExecutions && { relatedExecutions: payload.relatedExecutions },
-    ...payload.version && { version: payload.version },
-    ...payload.tags && { tags: payload.tags },
-    ...payload.commits && { commits: payload.commits },
-    ...payload.files && { files: payload.files },
-    ...payload.notes && { notes: payload.notes }
-  };
-  const validation = validateChangelogRecordDetailed(changelog);
-  if (!validation.isValid) {
-    throw new DetailedValidationError("ChangelogRecord", validation.errors);
-  }
-  return changelog;
-}
-function loadChangelogRecord(data) {
-  const embeddedValidation = validateEmbeddedMetadataDetailed(data);
-  if (!embeddedValidation.isValid) {
-    throw new DetailedValidationError("GitGovRecord (ChangelogRecord)", embeddedValidation.errors);
-  }
-  const record = data;
-  const payloadValidation = validateChangelogRecordDetailed(record.payload);
-  if (!payloadValidation.isValid) {
-    throw new DetailedValidationError("ChangelogRecord payload", payloadValidation.errors);
-  }
-  return record;
-}
-
-// src/adapters/changelog_adapter/changelog_adapter.ts
-var ChangelogAdapter = class {
-  stores;
-  identity;
-  eventBus;
-  constructor(dependencies) {
-    this.stores = dependencies.stores;
-    this.identity = dependencies.identity;
-    this.eventBus = dependencies.eventBus;
-  }
-  /**
-   * [EARS-A1] Records a deliverable/release note.
-   *
-   * Description: Aggregates multiple tasks into a single deliverable/release note.
-   * Implementation: Validates required fields, builds record with factory, signs, persists and emits event.
-   * Usage: Invoked by `gitgov changelog add` to document deliverables.
-   * Returns: Complete and signed ChangelogRecord.
-   */
-  async create(payload, actorId) {
-    if (!payload.title || payload.title.length < 10) {
-      throw new Error("DetailedValidationError: title is required and must be at least 10 characters");
-    }
-    if (!payload.description || payload.description.length < 20) {
-      throw new Error("DetailedValidationError: description is required and must be at least 20 characters");
-    }
-    if (!payload.relatedTasks || payload.relatedTasks.length === 0) {
-      throw new Error("DetailedValidationError: relatedTasks is required and must contain at least one task ID");
-    }
-    if (payload.relatedTasks) {
-      for (const taskId of payload.relatedTasks) {
-        const taskExists = await this.stores.tasks.get(taskId);
-        if (!taskExists) {
-          throw new Error(`RecordNotFoundError: Task not found: ${taskId}`);
-        }
-      }
-    }
-    if (payload.relatedCycles) {
-      for (const cycleId of payload.relatedCycles) {
-        const cycleExists = await this.stores.cycles.get(cycleId);
-        if (!cycleExists) {
-          throw new Error(`RecordNotFoundError: Cycle not found: ${cycleId}`);
-        }
-      }
-    }
-    try {
-      const timestamp = payload.completedAt || Math.floor(Date.now() / 1e3);
-      if (!payload.id) {
-        payload.id = generateChangelogId(payload.title, timestamp);
-      }
-      const validatedPayload = createChangelogRecord(payload);
-      const unsignedRecord = {
-        header: {
-          version: "1.0",
-          type: "changelog",
-          payloadChecksum: "will-be-calculated-by-signRecord",
-          signatures: [{
-            keyId: actorId,
-            role: "author",
-            notes: "Changelog entry created",
-            signature: "placeholder",
-            timestamp: Date.now()
-          }]
-        },
-        payload: validatedPayload
-      };
-      const signedRecord = await this.identity.signRecord(unsignedRecord, actorId, "author", "Changelog record created");
-      await this.stores.changelogs.put(validatedPayload.id, signedRecord);
-      this.eventBus.publish({
-        type: "changelog.created",
-        timestamp: Date.now(),
-        source: "changelog_adapter",
-        payload: {
-          changelogId: validatedPayload.id,
-          relatedTasks: validatedPayload.relatedTasks,
-          title: validatedPayload.title,
-          version: validatedPayload.version
-        }
-      });
-      return validatedPayload;
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("DetailedValidationError")) {
-        throw error;
-      }
-      throw error;
-    }
-  }
-  /**
-   * [EARS-B1] Gets a specific ChangelogRecord by its ID.
-   */
-  async getChangelog(changelogId) {
-    const record = await this.stores.changelogs.get(changelogId);
-    return record ? record.payload : null;
-  }
-  /**
-   * [EARS-C1] Gets all ChangelogRecords that include a specific task.
-   */
-  async getChangelogsByTask(taskId) {
-    const ids = await this.stores.changelogs.list();
-    const changelogs = [];
-    for (const id of ids) {
-      const record = await this.stores.changelogs.get(id);
-      if (record && record.payload.relatedTasks.includes(taskId)) {
-        changelogs.push(record.payload);
-      }
-    }
-    return changelogs;
-  }
-  /**
-   * [EARS-D1] Gets all ChangelogRecords with optional filtering and sorting.
-   */
-  async getAllChangelogs(options) {
-    const ids = await this.stores.changelogs.list();
-    let changelogs = [];
-    for (const id of ids) {
-      const record = await this.stores.changelogs.get(id);
-      if (record) {
-        changelogs.push(record.payload);
-      }
-    }
-    if (options?.tags && options.tags.length > 0) {
-      changelogs = changelogs.filter((changelog) => {
-        if (!changelog.tags) return false;
-        return options.tags.some((tag) => changelog.tags.includes(tag));
-      });
-    }
-    if (options?.version) {
-      changelogs = changelogs.filter((changelog) => changelog.version === options.version);
-    }
-    const sortBy = options?.sortBy || "completedAt";
-    const sortOrder = options?.sortOrder || "desc";
-    changelogs.sort((a, b) => {
-      let compareValue = 0;
-      if (sortBy === "completedAt") {
-        compareValue = a.completedAt - b.completedAt;
-      } else if (sortBy === "title") {
-        compareValue = a.title.localeCompare(b.title);
-      }
-      return sortOrder === "asc" ? compareValue : -compareValue;
-    });
-    if (options?.limit && options.limit > 0) {
-      changelogs = changelogs.slice(0, options.limit);
-    }
-    return changelogs;
-  }
-  /**
-   * [EARS-E1] Gets recent ChangelogRecords ordered by completedAt.
-   */
-  async getRecentChangelogs(limit) {
-    const allChangelogs = await this.getAllChangelogs();
-    const sortedChangelogs = allChangelogs.sort((a, b) => b.completedAt - a.completedAt);
-    return sortedChangelogs.slice(0, limit);
-  }
-  /**
-   * Legacy method for backwards compatibility - maps to getChangelogsByTask
-   * @deprecated Use getChangelogsByTask instead
-   */
-  async getChangelogsByEntity(entityId, _entityType) {
-    return this.getChangelogsByTask(entityId);
-  }
-};
-
 // src/adapters/execution_adapter/index.ts
 var execution_adapter_exports = {};
 __export(execution_adapter_exports, {
@@ -6075,14 +5481,15 @@ __export(workflow_adapter_exports, {
 
 // src/adapters/workflow_adapter/generated/kanban_workflow.json
 var kanban_workflow_default = {
-  version: "1.0.0",
+  id: "1700000000-workflow-default-methodology",
   name: "GitGovernance Default Methodology",
   description: "Standard GitGovernance workflow with quality gates and agent collaboration",
   state_transitions: {
-    review: {
+    submit: {
       from: [
         "draft"
       ],
+      to: "review",
       requires: {
         command: "gitgov task submit",
         signatures: {
@@ -6096,10 +5503,11 @@ var kanban_workflow_default = {
         }
       }
     },
-    ready: {
+    approve: {
       from: [
         "review"
       ],
+      to: "ready",
       requires: {
         command: "gitgov task approve",
         signatures: {
@@ -6127,11 +5535,12 @@ var kanban_workflow_default = {
         }
       }
     },
-    active: {
+    activate: {
       from: [
         "ready",
         "paused"
       ],
+      to: "active",
       requires: {
         event: "first_execution_record_created",
         custom_rules: [
@@ -6139,10 +5548,11 @@ var kanban_workflow_default = {
         ]
       }
     },
-    done: {
+    complete: {
       from: [
         "active"
       ],
+      to: "done",
       requires: {
         command: "gitgov task complete",
         signatures: {
@@ -6156,28 +5566,31 @@ var kanban_workflow_default = {
         }
       }
     },
-    archived: {
+    archive: {
       from: [
         "done"
       ],
+      to: "archived",
       requires: {
-        event: "changelog_record_created"
+        command: "gitgov task archive"
       }
     },
-    paused: {
+    pause: {
       from: [
         "active",
         "review"
       ],
+      to: "paused",
       requires: {
         event: "feedback_blocking_created"
       }
     },
-    discarded: {
+    cancel: {
       from: [
         "ready",
         "active"
       ],
+      to: "discarded",
       requires: {
         command: "gitgov task cancel",
         signatures: {
@@ -6211,14 +5624,15 @@ var kanban_workflow_default = {
 
 // src/adapters/workflow_adapter/generated/scrum_workflow.json
 var scrum_workflow_default = {
-  version: "1.0.0",
+  id: "1700000000-workflow-scrum-framework",
   name: "Scrum Framework",
   description: "Agile Scrum methodology with sprint-based workflow and defined roles",
   state_transitions: {
-    review: {
+    submit: {
       from: [
         "draft"
       ],
+      to: "review",
       requires: {
         command: "gitgov task submit",
         signatures: {
@@ -6232,10 +5646,11 @@ var scrum_workflow_default = {
         }
       }
     },
-    ready: {
+    approve: {
       from: [
         "review"
       ],
+      to: "ready",
       requires: {
         command: "gitgov task approve",
         custom_rules: [
@@ -6243,11 +5658,12 @@ var scrum_workflow_default = {
         ]
       }
     },
-    active: {
+    activate: {
       from: [
         "ready",
         "paused"
       ],
+      to: "active",
       requires: {
         event: "sprint_started",
         custom_rules: [
@@ -6255,10 +5671,11 @@ var scrum_workflow_default = {
         ]
       }
     },
-    done: {
+    complete: {
       from: [
         "active"
       ],
+      to: "done",
       requires: {
         command: "gitgov task complete",
         signatures: {
@@ -6272,19 +5689,21 @@ var scrum_workflow_default = {
         }
       }
     },
-    archived: {
+    archive: {
       from: [
         "done"
       ],
+      to: "archived",
       requires: {
-        event: "changelog_record_created"
+        command: "gitgov task archive"
       }
     },
-    paused: {
+    pause: {
       from: [
         "active",
         "review"
       ],
+      to: "paused",
       requires: {
         event: "feedback_blocking_created"
       }
@@ -6387,20 +5806,29 @@ var WorkflowAdapter = class _WorkflowAdapter {
     }
     return "__default__";
   }
+  /**
+   * Finds a transition config by matching from and to states.
+   * Keys are transition names (e.g. submit, approve), target state is in transition.to.
+   */
+  findTransitionByStates(from, to) {
+    const config = this.getConfig();
+    for (const transitionConfig of Object.values(config.state_transitions ?? {})) {
+      if (transitionConfig && transitionConfig.to === to && transitionConfig.from.includes(from)) {
+        return transitionConfig;
+      }
+    }
+    return null;
+  }
   /**
    * Determines if a state transition is legal according to the methodology
    */
   async getTransitionRule(from, to, _context) {
-    const config = this.getConfig();
-    const transitionConfig = config.state_transitions?.[to];
+    const transitionConfig = this.findTransitionByStates(from, to);
     if (!transitionConfig) {
       return null;
     }
-    if (!transitionConfig.from.includes(from)) {
-      return null;
-    }
     return {
-      to,
+      to: transitionConfig.to,
       conditions: transitionConfig.requires
     };
   }
@@ -6408,7 +5836,6 @@ var WorkflowAdapter = class _WorkflowAdapter {
    * Validates if an actor's signature meets the requirements for a transition
    */
   async validateSignature(signature, context) {
-    const config = this.getConfig();
     if (!context.transitionTo) {
       throw new Error('ValidationContext must include "transitionTo" for signature validation.');
     }
@@ -6417,11 +5844,8 @@ var WorkflowAdapter = class _WorkflowAdapter {
     if (!actor) {
       return false;
     }
-    const transitionConfig = config.state_transitions?.[targetState];
+    const transitionConfig = this.findTransitionByStates(context.task.status, targetState);
     if (!transitionConfig) return false;
-    if (!transitionConfig.from.includes(context.task.status)) {
-      return false;
-    }
     const signatureRules = transitionConfig.requires.signatures;
     if (!signatureRules) return true;
     const signatureGroup = this.getApplicableSignatureGroup(signatureRules, actor);
@@ -6503,11 +5927,10 @@ var WorkflowAdapter = class _WorkflowAdapter {
       return [];
     }
     const available = [];
-    for (const toState in config.state_transitions) {
-      const transitionConfig = config.state_transitions[toState];
+    for (const transitionConfig of Object.values(config.state_transitions)) {
       if (transitionConfig && transitionConfig.from.includes(from)) {
         available.push({
-          to: toState,
+          to: transitionConfig.to,
           conditions: transitionConfig.requires
         });
       }
@@ -6641,7 +6064,6 @@ var record_factories_exports = {};
 __export(record_factories_exports, {
   createActorRecord: () => createActorRecord,
   createAgentRecord: () => createAgentRecord,
-  createChangelogRecord: () => createChangelogRecord,
   createCycleRecord: () => createCycleRecord,
   createDefaultWorkflowConfig: () => createDefaultWorkflowConfig,
   createEmbeddedMetadataRecord: () => createEmbeddedMetadataRecord,
@@ -6652,7 +6074,6 @@ __export(record_factories_exports, {
   createWorkflowConfig: () => createWorkflowConfig,
   loadActorRecord: () => loadActorRecord,
   loadAgentRecord: () => loadAgentRecord,
-  loadChangelogRecord: () => loadChangelogRecord,
   loadCycleRecord: () => loadCycleRecord,
   loadExecutionRecord: () => loadExecutionRecord,
   loadFeedbackRecord: () => loadFeedbackRecord,
@@ -6684,19 +6105,19 @@ function validateWorkflowConfigDetailed(data) {
 function validateWorkflowConfigBusinessRules(config) {
   const errors = [];
   const validStates = ["draft", "review", "ready", "active", "done", "archived", "paused", "discarded"];
-  for (const [targetState, transition] of Object.entries(config.state_transitions)) {
-    if (!validStates.includes(targetState)) {
+  for (const [transitionName, transition] of Object.entries(config.state_transitions)) {
+    if (transition?.to && !validStates.includes(transition.to)) {
       errors.push({
-        field: `state_transitions.${targetState}`,
-        message: `Invalid target state: ${targetState}`,
-        value: targetState
+        field: `state_transitions.${transitionName}.to`,
+        message: `Invalid target state: ${transition.to}`,
+        value: transition.to
       });
     }
     if (transition?.from) {
       for (const fromState of transition.from) {
         if (!validStates.includes(fromState)) {
           errors.push({
-            field: `state_transitions.${targetState}.from`,
+            field: `state_transitions.${transitionName}.from`,
             message: `Invalid source state: ${fromState}`,
             value: fromState
           });
@@ -6707,7 +6128,7 @@ function validateWorkflowConfigBusinessRules(config) {
       for (const ruleId of transition.requires.custom_rules) {
         if (!config.custom_rules[ruleId]) {
           errors.push({
-            field: `state_transitions.${targetState}.requires.custom_rules`,
+            field: `state_transitions.${transitionName}.requires.custom_rules`,
             message: `Custom rule '${ruleId}' not defined in custom_rules section`,
             value: ruleId
           });
@@ -6736,12 +6157,13 @@ function validateWorkflowConfigBusinessRules(config) {
 // src/record_factories/workflow_factory.ts
 function createWorkflowConfig(payload) {
   const config = {
-    version: payload.version || "1.0.0",
+    id: payload.id || `${Math.floor(Date.now() / 1e3)}-workflow-custom`,
     name: payload.name || "Custom Methodology",
     description: payload.description,
     state_transitions: payload.state_transitions || {
-      review: {
+      submit: {
         from: ["draft"],
+        to: "review",
         requires: {
           command: "gitgov task submit",
           signatures: {
@@ -6769,12 +6191,13 @@ function createWorkflowConfig(payload) {
 }
 async function createDefaultWorkflowConfig() {
   return createWorkflowConfig({
-    version: "1.0.0",
+    id: "1700000000-workflow-default-methodology",
     name: "GitGovernance Default Methodology",
     description: "Standard GitGovernance workflow with quality gates and agent collaboration",
     state_transitions: {
-      review: {
+      submit: {
         from: ["draft"],
+        to: "review",
         requires: {
           command: "gitgov task submit",
           signatures: {
@@ -6786,8 +6209,9 @@ async function createDefaultWorkflowConfig() {
           }
         }
       },
-      ready: {
+      approve: {
         from: ["review"],
+        to: "ready",
         requires: {
           command: "gitgov task approve",
           signatures: {
@@ -6809,15 +6233,17 @@ async function createDefaultWorkflowConfig() {
           }
         }
       },
-      active: {
-        from: ["ready"],
+      activate: {
+        from: ["ready", "paused"],
+        to: "active",
         requires: {
           event: "first_execution_record_created",
           custom_rules: ["task_must_have_valid_assignment_for_executor"]
         }
       },
-      done: {
+      complete: {
         from: ["active"],
+        to: "done",
         requires: {
           command: "gitgov task complete",
           signatures: {
@@ -6829,17 +6255,33 @@ async function createDefaultWorkflowConfig() {
           }
         }
       },
-      archived: {
+      archive: {
         from: ["done"],
+        to: "archived",
         requires: {
-          event: "changelog_record_created"
+          command: "gitgov task archive"
         }
       },
-      paused: {
+      pause: {
         from: ["active", "review"],
+        to: "paused",
         requires: {
           event: "feedback_blocking_created"
         }
+      },
+      cancel: {
+        from: ["ready", "active"],
+        to: "discarded",
+        requires: {
+          command: "gitgov task cancel",
+          signatures: {
+            "__default__": {
+              role: "canceller",
+              capability_roles: ["approver:product", "approver:quality"],
+              min_approvals: 1
+            }
+          }
+        }
       }
     },
     custom_rules: {
@@ -6874,7 +6316,6 @@ function createTestSignature(keyId = "human:test-user", role = "author", notes =
 function inferTypeFromPayload(payload) {
   if ("engine" in payload) return "agent";
   if ("taskId" in payload && "result" in payload) return "execution";
-  if ("relatedTasks" in payload && "completedAt" in payload) return "changelog";
   if ("entityType" in payload && "entityId" in payload) return "feedback";
   if ("status" in payload && "taskIds" in payload) return "cycle";
   if ("priority" in payload && "description" in payload) return "task";
@@ -7328,6 +6769,7 @@ var FsFileLister = class {
         );
       }
     }
+    const normalized = patterns.map((p) => p.endsWith("/") ? `${p}**` : p);
     const fgOptions = {
       cwd: this.cwd,
       ignore: options?.ignore ?? [],
@@ -7338,7 +6780,7 @@ var FsFileLister = class {
     if (options?.maxDepth !== void 0) {
       fgOptions.deep = options.maxDepth;
     }
-    return fg(patterns, fgOptions);
+    return fg(normalized, fgOptions);
   }
   /**
    * [EARS-FL02] Checks if a file exists.
@@ -7578,7 +7020,6 @@ var ENTITY_TO_SCHEMA = {
   agent: "AgentRecord",
   cycle: "CycleRecord",
   execution: "ExecutionRecord",
-  changelog: "ChangelogRecord",
   feedback: "FeedbackRecord"
 };
 var LintModule = class {
@@ -7695,8 +7136,7 @@ var LintModule = class {
       ["actor", this.stores.actors],
       ["agent", this.stores.agents],
       ["execution", this.stores.executions],
-      ["feedback", this.stores.feedbacks],
-      ["changelog", this.stores.changelogs]
+      ["feedback", this.stores.feedbacks]
     ];
     const recordEntries = [];
     for (const [type, store] of storeMap) {
@@ -7822,9 +7262,6 @@ var LintModule = class {
       case "execution":
         loadExecutionRecord(rawRecord);
         break;
-      case "changelog":
-        loadChangelogRecord(rawRecord);
-        break;
       case "feedback":
         loadFeedbackRecord(rawRecord);
         break;
@@ -8647,12 +8084,225 @@ function isRebaseAlreadyInProgressError(error) {
   return error instanceof RebaseAlreadyInProgressError;
 }
 
+// src/hook_handler/index.ts
+var hook_handler_exports = {};
+__export(hook_handler_exports, {
+  HookHandler: () => HookHandler,
+  classifyCommand: () => classifyCommand
+});
+
+// src/hook_handler/hook_handler.ts
+var HookHandler = class {
+  executionAdapter;
+  sessionManager;
+  configManager;
+  constructor(deps) {
+    this.executionAdapter = deps.executionAdapter;
+    this.sessionManager = deps.sessionManager;
+    this.configManager = deps.configManager;
+  }
+  /**
+   * Process a hook event and decide whether to create an ExecutionRecord.
+   * Fail-silent: catches all errors and returns { action: 'skipped', reason }.
+   */
+  async handleEvent(event, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    try {
+      const config = await this.configManager.loadConfig();
+      if (!config) {
+        return { action: "skipped", reason: "no config" };
+      }
+      if (isFileChangedEvent(event)) {
+        return { action: "skipped", reason: "file changes are not recorded" };
+      }
+      if (isTeammateIdleEvent(event)) {
+        return { action: "skipped", reason: "activity logged" };
+      }
+      const actorId = await this.resolveActorId();
+      const activeTaskId = actorId ? (await this.sessionManager.getActorState(actorId))?.activeTaskId ?? null : null;
+      if (isSessionEndEvent(event)) {
+        return await this.handleSessionEnd(event, actorId, activeTaskId, dryRun);
+      }
+      if (!activeTaskId) {
+        return { action: "skipped", reason: "no active task" };
+      }
+      if (isCommandExecutedEvent(event)) {
+        return await this.handleCommandExecuted(event, actorId, activeTaskId, dryRun);
+      }
+      if (isTaskCompletedEvent(event)) {
+        return await this.handleTaskCompleted(event, actorId, activeTaskId, dryRun);
+      }
+      return { action: "skipped", reason: "unknown event type" };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return { action: "skipped", reason: message };
+    }
+  }
+  // ─── Command Executed ──────────────────────────────────────
+  async handleCommandExecuted(event, actorId, activeTaskId, dryRun = false) {
+    if (event.exit_code !== 0) {
+      return { action: "skipped", reason: "command failed" };
+    }
+    const classification = classifyCommand(event.tool_input.command, event.tool_output);
+    if (classification.kind === "unknown") {
+      return { action: "skipped", reason: "unrecognized command" };
+    }
+    const payload = this.buildCommandPayload(classification, activeTaskId);
+    if (dryRun) {
+      return { action: "recorded", executionId: "dry-run" };
+    }
+    const record = await this.executionAdapter.create(payload, actorId);
+    return { action: "recorded", executionId: record.id };
+  }
+  buildCommandPayload(classification, activeTaskId) {
+    switch (classification.kind) {
+      // [EARS-B2]
+      case "commit":
+        return {
+          taskId: activeTaskId,
+          type: "completion",
+          title: `Commit ${classification.hash}`,
+          result: `Commit ${classification.hash}: ${classification.message} (${classification.filesChanged} files changed)`,
+          references: [`commit:${classification.hash}`]
+        };
+      // [EARS-B3]
+      case "pr":
+        return {
+          taskId: activeTaskId,
+          type: "completion",
+          title: `PR #${classification.number} created`,
+          result: `PR #${classification.number} created`,
+          references: [`pr:${classification.number}`]
+        };
+      // [EARS-B4]
+      case "test":
+        return {
+          taskId: activeTaskId,
+          type: "analysis",
+          title: "Test run",
+          result: `Tests: ${classification.passed}/${classification.total} passing, ${classification.failed} failed`,
+          metadata: { tests: { passed: classification.passed, failed: classification.failed, total: classification.total } }
+        };
+    }
+  }
+  // ─── Task Completed ────────────────────────────────────────
+  async handleTaskCompleted(event, actorId, activeTaskId, dryRun = false) {
+    const payload = {
+      taskId: activeTaskId,
+      type: "completion",
+      title: `Task completed: ${event.task.subject}`,
+      result: `Task "${event.task.subject}" completed${event.task.owner ? ` by ${event.task.owner}` : ""}`,
+      references: [`task:${event.task.id}`]
+    };
+    if (dryRun) {
+      return { action: "recorded", executionId: "dry-run" };
+    }
+    const record = await this.executionAdapter.create(payload, actorId);
+    return { action: "recorded", executionId: record.id };
+  }
+  // ─── Session End ───────────────────────────────────────────
+  async handleSessionEnd(event, actorId, activeTaskId, dryRun = false) {
+    if (!actorId) {
+      return { action: "skipped", reason: "no actor" };
+    }
+    if (!activeTaskId) {
+      return { action: "skipped", reason: "no active task" };
+    }
+    const taskId = activeTaskId;
+    const payload = {
+      taskId,
+      type: "analysis",
+      title: "Session ended",
+      result: `Session ended${event.session_id ? ` (${event.session_id})` : ""}`
+    };
+    if (dryRun) {
+      return { action: "recorded", executionId: "dry-run" };
+    }
+    const record = await this.executionAdapter.create(payload, actorId);
+    return { action: "recorded", executionId: record.id };
+  }
+  // ─── Helpers ───────────────────────────────────────────────
+  async resolveActorId() {
+    const lastSession = await this.sessionManager.getLastSession();
+    if (lastSession) return lastSession.actorId;
+    const detectedId = await this.sessionManager.detectActorFromKeyFiles();
+    return detectedId;
+  }
+};
+function isCommandExecutedEvent(event) {
+  return "tool_name" in event && event.tool_name === "Bash";
+}
+function isFileChangedEvent(event) {
+  return "tool_name" in event && (event.tool_name === "Write" || event.tool_name === "Edit");
+}
+function isTaskCompletedEvent(event) {
+  return "hook_type" in event && event.hook_type === "TaskCompleted";
+}
+function isTeammateIdleEvent(event) {
+  return "hook_type" in event && event.hook_type === "TeammateIdle";
+}
+function isSessionEndEvent(event) {
+  return "hook_type" in event && event.hook_type === "Stop";
+}
+function classifyCommand(command, output) {
+  if (/git\s+commit/.test(command)) {
+    return parseCommitOutput(output);
+  }
+  if (/gh\s+pr\s+create/.test(command)) {
+    return parsePrOutput(output);
+  }
+  if (/(?:jest|vitest|pytest|npm\s+test|pnpm\s+test|npx\s+vitest|npx\s+jest)/.test(command)) {
+    return parseTestOutput(output);
+  }
+  return { kind: "unknown" };
+}
+function parseCommitOutput(output) {
+  if (!output) return { kind: "commit", hash: "unknown", message: "", filesChanged: 0 };
+  const hashMatch = output.match(/\[[\w/.-]+\s+([a-f0-9]+)\]/);
+  const hash = hashMatch?.[1] ?? "unknown";
+  const messageMatch = output.match(/\]\s+(.+?)(?:\n|$)/);
+  const message = messageMatch?.[1] ?? "";
+  const filesMatch = output.match(/(\d+)\s+files?\s+changed/);
+  const filesChanged = filesMatch?.[1] ? parseInt(filesMatch[1], 10) : 0;
+  return { kind: "commit", hash, message, filesChanged };
+}
+function parsePrOutput(output) {
+  if (!output) return { kind: "pr", number: "unknown" };
+  const prMatch = output.match(/\/pull\/(\d+)/);
+  if (prMatch?.[1]) return { kind: "pr", number: prMatch[1] };
+  const numMatch = output.match(/#(\d+)/);
+  return { kind: "pr", number: numMatch?.[1] ?? "unknown" };
+}
+function parseTestOutput(output) {
+  if (!output) return { kind: "test", passed: 0, failed: 0, total: 0 };
+  let passed = 0;
+  let failed = 0;
+  let total = 0;
+  const vitestMatch = output.match(/Tests?\s+(\d+)\s+passed/);
+  const failedMatch = output.match(/(\d+)\s+failed/);
+  const totalMatch = output.match(/(\d+)\s+total/);
+  if (vitestMatch?.[1]) passed = parseInt(vitestMatch[1], 10);
+  if (failedMatch?.[1]) failed = parseInt(failedMatch[1], 10);
+  if (totalMatch?.[1]) {
+    total = parseInt(totalMatch[1], 10);
+  } else {
+    total = passed + failed;
+  }
+  if (!vitestMatch) {
+    const pytestPassed = output.match(/(\d+)\s+passed/);
+    const pytestFailed = output.match(/(\d+)\s+failed/);
+    if (pytestPassed?.[1]) passed = parseInt(pytestPassed[1], 10);
+    if (pytestFailed?.[1]) failed = parseInt(pytestFailed[1], 10);
+    total = passed + failed;
+  }
+  return { kind: "test", passed, failed, total };
+}
+
 // src/record_validations/index.ts
 var record_validations_exports = {};
 __export(record_validations_exports, {
   isActorRecord: () => isActorRecord,
   isAgentRecord: () => isAgentRecord,
-  isChangelogRecord: () => isChangelogRecord,
   isCycleRecord: () => isCycleRecord,
   isEmbeddedMetadataRecord: () => isEmbeddedMetadataRecord,
   isExecutionRecord: () => isExecutionRecord,
@@ -8664,8 +8314,6 @@ __export(record_validations_exports, {
   validateAgentActorRelationship: () => validateAgentActorRelationship,
   validateAgentRecordDetailed: () => validateAgentRecordDetailed,
   validateAgentRecordSchema: () => validateAgentRecordSchema,
-  validateChangelogRecordDetailed: () => validateChangelogRecordDetailed,
-  validateChangelogRecordSchema: () => validateChangelogRecordSchema,
   validateCycleRecordDetailed: () => validateCycleRecordDetailed,
   validateCycleRecordSchema: () => validateCycleRecordSchema,
   validateEmbeddedMetadataDetailed: () => validateEmbeddedMetadataDetailed,
@@ -8676,7 +8324,6 @@ __export(record_validations_exports, {
   validateFeedbackRecordSchema: () => validateFeedbackRecordSchema,
   validateFullActorRecord: () => validateFullActorRecord,
   validateFullAgentRecord: () => validateFullAgentRecord,
-  validateFullChangelogRecord: () => validateFullChangelogRecord,
   validateFullCycleRecord: () => validateFullCycleRecord,
   validateFullEmbeddedMetadataRecord: () => validateFullEmbeddedMetadataRecord,
   validateFullExecutionRecord: () => validateFullExecutionRecord,
@@ -8692,7 +8339,10 @@ __export(record_validations_exports, {
 // src/record_types/index.ts
 var record_types_exports = {};
 __export(record_types_exports, {
-  GitGovError: () => GitGovError
+  DIR_TO_TYPE: () => DIR_TO_TYPE,
+  GitGovError: () => GitGovError,
+  RECORD_TYPES: () => RECORD_TYPES,
+  TYPE_TO_DIR: () => TYPE_TO_DIR
 });
 
 // src/event_bus/index.ts
@@ -10894,7 +10544,6 @@ var RecordProjector = class {
       cycles,
       feedback: await this.readAllFeedback(),
       executions: await this.readAllExecutions(),
-      changelogs: await this.readAllChangelogs(),
       actors
     };
     const activityHistory = await this.calculateActivityHistory(allRecords);
@@ -10920,8 +10569,7 @@ var RecordProjector = class {
           cycles: cycles.length,
           actors: actors.length,
           feedback: allRecords.feedback.length,
-          executions: allRecords.executions.length,
-          changelogs: allRecords.changelogs.length
+          executions: allRecords.executions.length
         },
         generationTime: 0
         // Will be set by caller if needed
@@ -11244,20 +10892,6 @@ var RecordProjector = class {
     }
     return executions;
   }
-  /**
-   * Reads all changelogs from stores.changelogs with full metadata.
-   */
-  async readAllChangelogs() {
-    const changelogIds = await this.stores.changelogs.list();
-    const changelogs = [];
-    for (const id of changelogIds) {
-      const record = await this.stores.changelogs.get(id);
-      if (record) {
-        changelogs.push(record);
-      }
-    }
-    return changelogs;
-  }
   /**
    * Persists IndexData to sink if available.
    * [EARS-U4] No-op when sink is undefined (writeTime=0).
@@ -11407,22 +11041,6 @@ var RecordProjector = class {
           events.push(event);
         }
       });
-      allRecords.changelogs.forEach((changelog) => {
-        const timestampPart = changelog.payload.id.split("-")[0];
-        if (timestampPart) {
-          const event = {
-            timestamp: parseInt(timestampPart),
-            type: "changelog_created",
-            entityId: changelog.payload.id,
-            entityTitle: changelog.payload.title || "Release notes",
-            actorId: changelog.header.signatures[0]?.keyId || "unknown"
-          };
-          if (changelog.payload.version) {
-            event.metadata = { version: changelog.payload.version };
-          }
-          events.push(event);
-        }
-      });
       allRecords.executions.forEach((execution) => {
         const timestampPart = execution.payload.id.split("-")[0];
         if (timestampPart) {
@@ -11500,15 +11118,15 @@ var RecordProjector = class {
           recentActivity = `Execution: ${execution.payload.title || "Work logged"}`;
         }
       }
-      const relatedChangelogs = relatedRecords.changelogs.filter(
-        (c) => c.payload.relatedTasks && c.payload.relatedTasks.includes(taskPayload.id) || c.payload.description?.includes(taskPayload.id)
+      const relatedReleases = relatedRecords.executions.filter(
+        (e) => e.payload.taskId === taskPayload.id && e.payload.type === "custom:release"
       );
-      for (const changelog of relatedChangelogs) {
-        const changelogTime = this.getTimestampFromId(changelog.payload.id) * 1e3;
-        if (changelogTime > lastUpdated) {
-          lastUpdated = changelogTime;
-          lastActivityType = "changelog_created";
-          recentActivity = `Changelog: ${changelog.payload.title}`;
+      for (const release of relatedReleases) {
+        const releaseTime = this.getTimestampFromId(release.payload.id) * 1e3;
+        if (releaseTime > lastUpdated) {
+          lastUpdated = releaseTime;
+          lastActivityType = "execution_added";
+          recentActivity = `Release: ${release.payload.title}`;
         }
       }
       return { lastUpdated, lastActivityType, recentActivity };
@@ -11537,7 +11155,7 @@ var RecordProjector = class {
    * 5. Cycles (all cycles as array with id+title)
    * 6. Metrics (executionCount, blockingFeedbackCount, openQuestionCount)
    * 7. Time to resolution (for done tasks)
-   * 8. Release info (isReleased, lastReleaseVersion from changelogs)
+   * 8. Release info
    * 9. Derived states (EARS-43: REUTILIZA pre-calculated derivedStates con O(1) lookup)
    * 10. Health score (0-100 using multi-factor algorithm)
    * 11. Time in current stage (days)
@@ -11580,11 +11198,12 @@ var RecordProjector = class {
       (f) => f.payload.entityId === task.payload.id && f.payload.type === "question" && f.payload.status === "open"
     ).length;
     const timeToResolution = task.payload.status === "done" ? (lastUpdated - this.getTimestampFromId(task.payload.id) * 1e3) / (1e3 * 60 * 60) : void 0;
-    const releaseChangelogs = relatedRecords.changelogs.filter(
-      (cl) => cl.payload.relatedTasks.includes(task.payload.id)
+    const releaseExecutions = relatedRecords.executions.filter(
+      (e) => e.payload.taskId === task.payload.id && e.payload.type === "custom:release"
     );
-    const isReleased = releaseChangelogs.length > 0;
-    const lastReleaseVersion = isReleased ? releaseChangelogs[releaseChangelogs.length - 1]?.payload.version || void 0 : void 0;
+    const isReleased = releaseExecutions.length > 0;
+    const lastReleaseExec = releaseExecutions[releaseExecutions.length - 1];
+    const lastReleaseVersion = isReleased ? lastReleaseExec?.payload.metadata?.["version"] : void 0;
     const taskId = task.payload.id;
     const isStalled = derivedStateSets.stalledTasks.has(taskId);
     const isAtRisk = derivedStateSets.atRiskTasks.has(taskId);
@@ -11670,6 +11289,6 @@ var RecordProjector = class {
   }
 };
 
-export { adapters_exports as Adapters, backlog_adapter_exports as BacklogAdapter, changelog_adapter_exports as ChangelogAdapter, config_manager_exports as Config, crypto_exports as Crypto, diagram_generator_exports as DiagramGenerator, event_bus_exports as EventBus, execution_adapter_exports as ExecutionAdapter, record_factories_exports as Factories, feedback_adapter_exports as FeedbackAdapter, file_lister_exports as FileLister, finding_detector_exports as FindingDetector, git_exports as Git, identity_adapter_exports as IdentityAdapter, key_provider_exports as KeyProvider, lint_exports as Lint, logger_exports as Logger, project_adapter_exports as ProjectAdapter, project_initializer_exports as ProjectInitializer, record_metrics_exports as RecordMetrics, record_projection_exports as RecordProjection, record_types_exports as Records, agent_runner_exports as Runner, record_schemas_exports as Schemas, session_manager_exports as Session, source_auditor_exports as SourceAuditor, record_store_exports as Store, sync_state_exports as SyncState, record_validations_exports as Validation, workflow_adapter_exports as WorkflowAdapter };
+export { adapters_exports as Adapters, backlog_adapter_exports as BacklogAdapter, config_manager_exports as Config, crypto_exports as Crypto, diagram_generator_exports as DiagramGenerator, event_bus_exports as EventBus, execution_adapter_exports as ExecutionAdapter, record_factories_exports as Factories, feedback_adapter_exports as FeedbackAdapter, file_lister_exports as FileLister, finding_detector_exports as FindingDetector, git_exports as Git, hook_handler_exports as HookHandler, identity_adapter_exports as IdentityAdapter, key_provider_exports as KeyProvider, lint_exports as Lint, logger_exports as Logger, project_adapter_exports as ProjectAdapter, project_initializer_exports as ProjectInitializer, record_metrics_exports as RecordMetrics, record_projection_exports as RecordProjection, record_types_exports as Records, agent_runner_exports as Runner, record_schemas_exports as Schemas, session_manager_exports as Session, source_auditor_exports as SourceAuditor, record_store_exports as Store, sync_state_exports as SyncState, record_validations_exports as Validation, workflow_adapter_exports as WorkflowAdapter };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map