@gitgov/core 2.7.2 → 2.8.0

package/dist/src/fs.js

@@ -735,7 +735,6 @@ var DIR_TO_TYPE = {
   "tasks": "task",
   "cycles": "cycle",
   "executions": "execution",
-  "changelogs": "changelog",
   "feedbacks": "feedback",
   "actors": "actor",
   "agents": "agent"
@@ -762,9 +761,6 @@ function inferEntityTypeFromId(recordId) {
   if (recordId.match(/^\d+-exec-/) || recordId.includes("-execution-")) {
     return "execution";
   }
-  if (recordId.match(/^\d+-changelog-/)) {
-    return "changelog";
-  }
   if (recordId.match(/^\d+-feedback-/)) {
     return "feedback";
   }
@@ -887,7 +883,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: [
@@ -982,8 +978,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"
@@ -991,8 +988,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",
@@ -1000,63 +1002,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: [
@@ -1103,7 +1054,8 @@ var agent_record_schema_default = {
                 "GET",
                 "PUT"
               ],
-              default: "POST"
+              default: "POST",
+              description: "HTTP method"
             },
             auth: {
               type: "object",
@@ -1149,7 +1101,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",
@@ -1198,6 +1150,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: [
@@ -1428,193 +1434,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: [
@@ -1627,7 +1452,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",
@@ -1638,7 +1463,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",
@@ -1653,7 +1478,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",
@@ -1663,7 +1488,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",
@@ -1679,7 +1504,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",
@@ -1713,9 +1538,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: [
@@ -1733,7 +1578,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",
@@ -1750,7 +1595,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",
@@ -1766,7 +1611,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."
     }
   ]
 };
@@ -1784,10 +1629,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",
@@ -1796,12 +1639,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}$",
@@ -1816,14 +1670,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",
@@ -1838,6 +1692,7 @@ var embedded_metadata_schema_default = {
               },
               timestamp: {
                 type: "integer",
+                minimum: 16e8,
                 description: "Unix timestamp of the signature."
               }
             },
@@ -1871,12 +1726,35 @@ var embedded_metadata_schema_default = {
     "payload"
   ],
   additionalProperties: false,
-  oneOf: [
+  allOf: [
     {
       if: {
+        properties: {
+          header: {
+            properties: {
+              type: {
+                const: "custom"
+              }
+            }
+          }
+        }
+      },
+      then: {
         properties: {
           header: {
             type: "object",
+            required: [
+              "schemaUrl",
+              "schemaChecksum"
+            ]
+          }
+        }
+      }
+    },
+    {
+      if: {
+        properties: {
+          header: {
             properties: {
               type: {
                 const: "actor"
@@ -1891,14 +1769,12 @@ var embedded_metadata_schema_default = {
             $ref: "ref:actor_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
         properties: {
           header: {
-            type: "object",
             properties: {
               type: {
                 const: "agent"
@@ -1913,14 +1789,12 @@ var embedded_metadata_schema_default = {
             $ref: "ref:agent_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
         properties: {
           header: {
-            type: "object",
             properties: {
               type: {
                 const: "task"
@@ -1935,14 +1809,12 @@ var embedded_metadata_schema_default = {
             $ref: "ref:task_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
         properties: {
           header: {
-            type: "object",
             properties: {
               type: {
                 const: "execution"
@@ -1957,17 +1829,15 @@ var embedded_metadata_schema_default = {
             $ref: "ref:execution_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
         properties: {
           header: {
-            type: "object",
             properties: {
               type: {
-                const: "changelog"
+                const: "feedback"
               }
             }
           }
@@ -1976,20 +1846,18 @@ var embedded_metadata_schema_default = {
       then: {
         properties: {
           payload: {
-            $ref: "ref:changelog_record_schema"
+            $ref: "ref:feedback_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
         properties: {
           header: {
-            type: "object",
             properties: {
               type: {
-                const: "feedback"
+                const: "cycle"
               }
             }
           }
@@ -1998,20 +1866,18 @@ var embedded_metadata_schema_default = {
       then: {
         properties: {
           payload: {
-            $ref: "ref:feedback_record_schema"
+            $ref: "ref:cycle_record_schema"
           }
         }
-      },
-      else: false
+      }
     },
     {
       if: {
         properties: {
           header: {
-            type: "object",
             properties: {
               type: {
-                const: "cycle"
+                const: "workflow"
               }
             }
           }
@@ -2020,58 +1886,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
           }
         ]
@@ -2081,39 +1947,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"
       }
     }
   ]
@@ -2124,7 +1981,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: [
@@ -2139,209 +1996,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",
-        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"
-    },
-    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
-        }
-      }
+        type: "string",
+        minLength: 1,
+        maxLength: 500
+      },
+      default: [],
+      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. 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
@@ -2349,7 +2047,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: [
@@ -2365,32 +2063,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: {
@@ -2403,12 +2104,7 @@ var feedback_record_schema_default = {
         "clarification",
         "assignment"
       ],
-      description: "The semantic intent of the feedback",
-      examples: [
-        "blocking",
-        "question",
-        "approval"
-      ]
+      description: "The semantic intent of the feedback."
     },
     status: {
       type: "string",
@@ -2418,19 +2114,18 @@ var feedback_record_schema_default = {
         "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'
+      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,
-      maxLength: 5e3,
-      description: "The content of the feedback. Reduced from 10000 to 5000 chars for practical use."
+      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')",
+      description: "Optional. The Actor ID responsible for addressing the feedback (e.g., 'human:maria', 'agent:camilo:cursor').",
       examples: [
         "human:maria",
         "agent:code-reviewer",
@@ -2441,7 +2136,7 @@ var feedback_record_schema_default = {
       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",
+      description: "Optional. The ID of another FeedbackRecord that this one resolves or responds to.",
       examples: [
         "1752788100-feedback-blocking-rest-api"
       ]
@@ -2449,18 +2144,151 @@ var feedback_record_schema_default = {
     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"
-        }
-      ]
+      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}$"
+          }
+        }
+      }
+    },
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "execution"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-exec-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
+    },
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "feedback"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-feedback-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
+    },
+    {
+      if: {
+        required: [
+          "entityType"
+        ],
+        properties: {
+          entityType: {
+            const: "cycle"
+          }
+        }
+      },
+      then: {
+        properties: {
+          entityId: {
+            type: "string",
+            pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$"
+          }
+        }
+      }
+    },
+    {
+      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",
@@ -2468,7 +2296,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",
@@ -2476,7 +2304,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"
     },
     {
@@ -2485,7 +2313,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"
     },
     {
@@ -2494,7 +2322,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?"
     }
   ]
 };
@@ -2504,7 +2332,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: [
@@ -2554,7 +2382,6 @@ var task_record_schema_default = {
         "paused",
         "discarded"
       ],
-      maxLength: 40,
       description: "Current state of the task in the institutional flow"
     },
     priority: {
@@ -2565,13 +2392,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: {
@@ -2579,7 +2404,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')."
@@ -2596,9 +2421,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: [
@@ -2681,25 +2523,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",
@@ -2714,11 +2553,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,
@@ -2732,21 +2575,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: [
@@ -2786,7 +2634,7 @@ var workflow_record_schema_default = {
                       items: {
                         type: "string"
                       },
-                      description: "Optional: specific actors that can sign"
+                      description: "Optional: restrict to specific actor IDs"
                     }
                   }
                 }
@@ -2835,7 +2683,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",
@@ -2846,7 +2694,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: {
@@ -2856,7 +2704,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: [
@@ -2878,8 +2726,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",
@@ -2888,11 +2736,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: [
@@ -2921,190 +2769,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,
@@ -3146,7 +2817,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",
@@ -3373,45 +3043,6 @@ function loadExecutionRecord(data) {
   return record;
 }
 
-// src/record_validations/changelog_validator.ts
-function validateChangelogRecordSchema(data) {
-  const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.ChangelogRecord);
-  const isValid = validator(data);
-  return [isValid, validator.errors];
-}
-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: []
-  };
-}
-
-// src/record_factories/changelog_factory.ts
-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/record_validations/feedback_validator.ts
 function validateFeedbackRecordSchema(data) {
   const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.FeedbackRecord);
@@ -3516,7 +3147,7 @@ var FsLintModule = class {
     return this.lintModule.lintRecord(record, context);
   }
   /**
-   * Delegates to LintModule.lintRecordReferences() for prefix validation.
+   * Delegates to LintModule.lintRecordReferences() for reference validation.
    */
   lintRecordReferences(record, context) {
     return this.lintModule.lintRecordReferences(record, context);
@@ -3754,9 +3385,6 @@ var FsLintModule = class {
         case "execution":
           record = loadExecutionRecord(raw);
           break;
-        case "changelog":
-          record = loadChangelogRecord(raw);
-          break;
         case "feedback":
           record = loadFeedbackRecord(raw);
           break;
@@ -3769,10 +3397,6 @@ var FsLintModule = class {
         filePath
       });
       results.push(...lintResults);
-      if (options.validateFileNaming) {
-        const namingResults = this.validateFileNaming(record, recordId, filePath, entityType);
-        results.push(...namingResults);
-      }
       if (options.validateReferences) {
         const refResults = this.lintModule.lintRecordReferences(record, {
           recordId,
@@ -3781,6 +3405,10 @@ var FsLintModule = class {
         });
         results.push(...refResults);
       }
+      if (options.validateFileNaming) {
+        const namingResults = this.validateFileNaming(record, recordId, filePath, entityType);
+        results.push(...namingResults);
+      }
     } catch (error) {
       if (error instanceof DetailedValidationError) {
         const hasAdditionalProperties = error.errors.some(
@@ -3833,7 +3461,6 @@ var FsLintModule = class {
       "task": "tasks",
       "cycle": "cycles",
       "execution": "executions",
-      "changelog": "changelogs",
       "feedback": "feedbacks",
       "actor": "actors",
       "agent": "agents"
@@ -3876,7 +3503,6 @@ var FsLintModule = class {
       "cycle",
       "task",
       "execution",
-      "changelog",
       "feedback"
     ];
     const allRecords = [];
@@ -3884,7 +3510,6 @@ var FsLintModule = class {
       "task": "tasks",
       "cycle": "cycles",
       "execution": "executions",
-      "changelog": "changelogs",
       "feedback": "feedbacks",
       "actor": "actors",
       "agent": "agents"
@@ -3910,7 +3535,6 @@ var FsLintModule = class {
       "task": "tasks",
       "cycle": "cycles",
       "execution": "executions",
-      "changelog": "changelogs",
       "feedback": "feedbacks",
       "actor": "actors",
       "agent": "agents"
@@ -4126,8 +3750,7 @@ var GITGOV_DIRECTORIES = [
   "cycles",
   "tasks",
   "executions",
-  "feedbacks",
-  "changelogs"
+  "feedbacks"
 ];
 var FsProjectInitializer = class {
   projectRoot;
@@ -5656,7 +5279,6 @@ var SYNC_DIRECTORIES = [
   "agents",
   "feedbacks",
   "executions",
-  "changelogs",
   "workflows"
 ];
 var SYNC_ROOT_FILES = [