@gitgov/core 1.3.0 → 1.4.0

package/dist/src/index.js

@@ -76,17 +76,19 @@ var actor_record_schema_default = {
     },
     publicKey: {
       type: "string",
-      description: "The Ed25519 public key (base64 encoded) for verifying the actor's signatures."
+      minLength: 44,
+      maxLength: 44,
+      description: "The Ed25519 public key (base64 encoded, 44 characters) for verifying the actor's signatures."
     },
     roles: {
       type: "array",
       items: {
         type: "string",
-        pattern: "^[a-z0-9:]+$"
+        pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
       },
       minItems: 1,
       uniqueItems: true,
-      description: "List of capacity roles defining the actor's skills and permissions.",
+      description: "List of capacity roles defining the actor's skills and permissions. Uses hierarchical format with colons.",
       examples: [
         [
           "developer:backend:go",
@@ -104,7 +106,7 @@ var actor_record_schema_default = {
         "revoked"
       ],
       default: "active",
-      description: "The lifecycle status of the actor."
+      description: "Optional. The lifecycle status of the actor. Defaults to 'active' if not specified."
     },
     supersededBy: {
       type: "string",
@@ -136,7 +138,6 @@ var agent_record_schema_default = {
   type: "object",
   required: [
     "id",
-    "guild",
     "engine"
   ],
   properties: {
@@ -153,18 +154,10 @@ var agent_record_schema_default = {
       ],
       default: "active"
     },
-    guild: {
-      type: "string",
-      enum: [
-        "design",
-        "intelligence",
-        "strategy",
-        "operations",
-        "quality"
-      ]
-    },
     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: {
@@ -174,18 +167,22 @@ var agent_record_schema_default = {
               "manual",
               "webhook",
               "scheduled"
-            ]
+            ],
+            description: "Type of trigger that activates the agent"
           }
         },
         required: [
           "type"
-        ]
+        ],
+        additionalProperties: true
       }
     },
     knowledge_dependencies: {
       type: "array",
+      default: [],
       items: {
-        type: "string"
+        type: "string",
+        description: "Glob patterns for blueprint files this agent needs access to"
       }
     },
     prompt_engine_requirements: {
@@ -205,6 +202,11 @@ var agent_record_schema_default = {
         }
       }
     },
+    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
+    },
     engine: {
       type: "object",
       oneOf: [
@@ -212,63 +214,365 @@ var agent_record_schema_default = {
           required: [
             "type"
           ],
+          additionalProperties: false,
           properties: {
             type: {
               const: "local"
             },
             runtime: {
-              type: "string"
+              type: "string",
+              description: "Runtime environment (typescript, python, etc.)"
             },
             entrypoint: {
-              type: "string"
+              type: "string",
+              description: "Path to the agent entry file"
             },
             function: {
-              type: "string"
+              type: "string",
+              description: "Function name to invoke"
             }
           }
         },
         {
           required: [
-            "type"
+            "type",
+            "url"
           ],
+          additionalProperties: false,
           properties: {
             type: {
               const: "api"
             },
             url: {
-              type: "string"
+              type: "string",
+              format: "uri",
+              description: "HTTP endpoint for the agent"
             },
             method: {
               type: "string",
               enum: [
                 "POST",
                 "GET"
-              ]
+              ],
+              default: "POST"
             },
             auth: {
-              type: "object"
+              type: "object",
+              description: "Authentication configuration for API requests",
+              additionalProperties: true,
+              properties: {
+                type: {
+                  type: "string",
+                  enum: [
+                    "bearer",
+                    "oauth",
+                    "api-key",
+                    "actor-signature"
+                  ],
+                  description: "Authentication type. 'actor-signature' uses the agent's ActorRecord keypair to sign requests."
+                },
+                secret_key: {
+                  type: "string",
+                  description: "Reference to secret in Secret Manager (for bearer/api-key/oauth auth types)"
+                },
+                token: {
+                  type: "string",
+                  description: "Direct token value (not recommended for production, use secret_key instead)"
+                }
+              }
             }
           }
         },
         {
           required: [
-            "type"
+            "type",
+            "url"
           ],
+          additionalProperties: false,
           properties: {
             type: {
               const: "mcp"
             },
             url: {
-              type: "string"
+              type: "string",
+              format: "uri",
+              description: "MCP server endpoint"
             },
             auth: {
-              type: "object"
+              type: "object",
+              description: "Authentication configuration for MCP server",
+              additionalProperties: true,
+              properties: {
+                type: {
+                  type: "string",
+                  enum: [
+                    "bearer",
+                    "oauth",
+                    "api-key",
+                    "actor-signature"
+                  ],
+                  description: "Authentication type. 'actor-signature' uses the agent's ActorRecord keypair to sign requests."
+                },
+                secret_key: {
+                  type: "string",
+                  description: "Reference to secret in Secret Manager (for bearer/api-key/oauth auth types)"
+                },
+                token: {
+                  type: "string",
+                  description: "Direct token value (not recommended for production, use secret_key instead)"
+                }
+              }
+            }
+          }
+        },
+        {
+          required: [
+            "type"
+          ],
+          additionalProperties: false,
+          properties: {
+            type: {
+              const: "custom"
+            },
+            protocol: {
+              type: "string",
+              description: "Custom protocol identifier (e.g., 'a2a', 'grpc')"
+            },
+            config: {
+              type: "object",
+              description: "Protocol-specific configuration"
             }
           }
         }
       ]
     }
-  }
+  },
+  examples: [
+    {
+      id: "agent:scribe",
+      status: "active",
+      engine: {
+        type: "local",
+        runtime: "typescript",
+        entrypoint: "packages/agents/scribe/index.ts",
+        function: "runScribe"
+      },
+      metadata: {
+        purpose: "documentation-generation",
+        maintainer: "team:platform"
+      },
+      triggers: [
+        {
+          type: "manual"
+        }
+      ],
+      knowledge_dependencies: [
+        "packages/blueprints/**/*.md"
+      ]
+    },
+    {
+      id: "agent:langchain-analyzer",
+      status: "active",
+      engine: {
+        type: "api",
+        url: "https://langchain-service-xyz.a.run.app/analyze",
+        method: "POST",
+        auth: {
+          type: "actor-signature"
+        }
+      },
+      metadata: {
+        framework: "langchain",
+        version: "0.2.0",
+        model: "gpt-4-turbo",
+        deployment: {
+          provider: "gcp",
+          service: "cloud-run",
+          region: "us-central1"
+        },
+        cost_per_invocation: 0.03,
+        currency: "USD"
+      },
+      triggers: [
+        {
+          type: "webhook",
+          event: "task.ready"
+        }
+      ],
+      knowledge_dependencies: [
+        "docs/architecture/**/*.md"
+      ]
+    },
+    {
+      id: "agent:sentiment-analyzer",
+      status: "active",
+      engine: {
+        type: "api",
+        url: "http://sentiment-analyzer:8082/analyze",
+        method: "POST",
+        auth: {
+          type: "actor-signature"
+        }
+      },
+      metadata: {
+        framework: "google-adk",
+        version: "1.0.0",
+        model: "gemini-pro",
+        deployment: {
+          runtime: "docker",
+          image: "gitgov/sentiment-analyzer:v1.2.0",
+          port: 8082
+        },
+        max_tokens: 1024
+      },
+      triggers: [
+        {
+          type: "webhook",
+          event: "feedback.created"
+        }
+      ]
+    },
+    {
+      id: "agent:cursor-reviewer",
+      status: "active",
+      engine: {
+        type: "mcp",
+        url: "http://localhost:8083/mcp",
+        auth: {
+          type: "actor-signature"
+        }
+      },
+      metadata: {
+        ide: "cursor",
+        tool: "code-review",
+        accepts_tools: [
+          "review",
+          "refactor",
+          "test"
+        ]
+      },
+      knowledge_dependencies: [
+        "packages/**/*.ts",
+        "packages/**/*.tsx"
+      ],
+      triggers: [
+        {
+          type: "webhook",
+          event: "task.status.ready"
+        }
+      ]
+    },
+    {
+      id: "agent:deepl-translator",
+      status: "active",
+      engine: {
+        type: "api",
+        url: "https://api.deepl.com/v2/translate",
+        method: "POST",
+        auth: {
+          type: "bearer",
+          secret_key: "DEEPL_API_KEY"
+        }
+      },
+      metadata: {
+        provider: "deepl",
+        supported_languages: [
+          "EN",
+          "ES",
+          "FR",
+          "DE",
+          "PT"
+        ],
+        max_chars_per_request: 5e3
+      },
+      triggers: [
+        {
+          type: "manual"
+        }
+      ]
+    },
+    {
+      id: "agent:coordinator",
+      status: "active",
+      engine: {
+        type: "custom",
+        protocol: "a2a",
+        config: {
+          endpoint: "https://agent-hub.gitgov.io/a2a",
+          version: "draft-2025-01",
+          capabilities: [
+            "task-delegation",
+            "status-sync",
+            "feedback-loop"
+          ]
+        }
+      },
+      metadata: {
+        purpose: "multi-agent-orchestration",
+        experimental: true
+      },
+      triggers: [
+        {
+          type: "scheduled",
+          cron: "0 */4 * * *"
+        }
+      ]
+    },
+    {
+      id: "agent:minimal-watcher",
+      engine: {
+        type: "local"
+      }
+    },
+    {
+      id: "agent:local-mcp-server",
+      status: "active",
+      engine: {
+        type: "mcp",
+        url: "http://localhost:9000/mcp"
+      },
+      knowledge_dependencies: [
+        "packages/blueprints/**/*.md"
+      ],
+      triggers: [
+        {
+          type: "manual"
+        }
+      ]
+    },
+    {
+      id: "agent:code-reviewer",
+      status: "active",
+      engine: {
+        type: "local",
+        runtime: "typescript",
+        entrypoint: "packages/agents/code-reviewer/index.ts",
+        function: "reviewCode"
+      },
+      prompt_engine_requirements: {
+        roles: [
+          "code-reviewer",
+          "security-auditor"
+        ],
+        skills: [
+          "typescript",
+          "security-best-practices",
+          "code-quality-analysis"
+        ]
+      },
+      knowledge_dependencies: [
+        "packages/**/*.ts",
+        "packages/**/*.tsx"
+      ],
+      triggers: [
+        {
+          type: "webhook",
+          event: "pull-request.opened",
+          filter: "branch:main"
+        }
+      ]
+    }
+  ]
 };
 
 // src/schemas/generated/changelog_record_schema.json
@@ -276,226 +580,178 @@ 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 - Enterprise Grade System Historian",
+  description: "Canonical schema for changelog records - aggregates N tasks into 1 release note",
   additionalProperties: false,
   type: "object",
   required: [
     "id",
-    "entityType",
-    "entityId",
-    "changeType",
     "title",
     "description",
-    "timestamp",
-    "trigger",
-    "triggeredBy",
-    "reason",
-    "riskLevel"
+    "relatedTasks",
+    "completedAt"
   ],
   properties: {
     id: {
       type: "string",
-      pattern: "^\\d{10}-changelog-[a-z]+-[a-z0-9-]{1,50}$",
-      description: "Unique identifier for the changelog entry"
-    },
-    entityType: {
-      type: "string",
-      enum: [
-        "task",
-        "cycle",
-        "agent",
-        "system",
-        "configuration"
-      ],
-      description: "Type of the primary entity that changed"
-    },
-    entityId: {
-      type: "string",
-      description: "ID of the primary entity that changed"
-    },
-    changeType: {
-      type: "string",
-      enum: [
-        "creation",
-        "completion",
-        "update",
-        "deletion",
-        "hotfix"
-      ],
-      description: "The nature of the change"
+      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 change"
+      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 change and its impact"
+      description: "Detailed description of the value delivered, including key decisions and impact"
     },
-    timestamp: {
+    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 change occurred"
-    },
-    trigger: {
-      type: "string",
-      enum: [
-        "manual",
-        "automated",
-        "emergency"
-      ],
-      description: "How the change was initiated"
+      description: "Unix timestamp in seconds when the deliverable was completed"
     },
-    triggeredBy: {
-      type: "string",
-      description: "Actor or agent ID that initiated the change"
+    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"
     },
-    reason: {
-      type: "string",
-      minLength: 10,
-      maxLength: 1e3,
-      description: "Why the change was made"
+    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"
     },
-    riskLevel: {
+    version: {
       type: "string",
-      enum: [
-        "low",
-        "medium",
-        "high",
-        "critical"
-      ],
-      description: "Risk level of the change"
+      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"
+      ]
     },
-    affectedSystems: {
+    tags: {
       type: "array",
       items: {
-        type: "string"
+        type: "string",
+        pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
       },
-      description: "IDs of systems impacted by this change"
-    },
-    usersAffected: {
-      type: "number",
-      minimum: 0,
-      description: "Number of users impacted by this change"
-    },
-    downtime: {
-      type: "number",
-      minimum: 0,
-      description: "Downtime in seconds caused by this change"
+      default: [],
+      description: "Optional tags for categorization (e.g., 'feature:auth', 'bugfix', 'security')"
     },
-    files: {
+    commits: {
       type: "array",
       items: {
-        type: "string"
+        type: "string",
+        maxLength: 100
       },
-      description: "List of main files that were created or modified"
+      default: [],
+      description: "Optional list of git commit hashes related to this deliverable"
     },
-    commits: {
+    files: {
       type: "array",
       items: {
-        type: "string"
+        type: "string",
+        maxLength: 500
       },
-      description: "List of git commit hashes related to this change"
+      default: [],
+      description: "Optional list of main files that were created or modified"
     },
-    rollbackInstructions: {
+    notes: {
       type: "string",
-      minLength: 20,
-      maxLength: 2e3,
-      description: "Step-by-step instructions to rollback this change"
-    },
-    references: {
-      type: "object",
-      additionalProperties: false,
-      properties: {
-        tasks: {
-          type: "array",
-          items: {
-            type: "string"
-          },
-          description: "IDs of related TaskRecords"
-        },
-        cycles: {
-          type: "array",
-          items: {
-            type: "string"
-          },
-          description: "IDs of related CycleRecords"
-        },
-        executions: {
-          type: "array",
-          items: {
-            type: "string"
-          },
-          description: "IDs of related ExecutionRecords"
-        },
-        changelogs: {
-          type: "array",
-          items: {
-            type: "string"
-          },
-          description: "IDs of related ChangelogRecords"
-        }
-      },
-      description: "Cross-references to other GitGovernance records"
+      maxLength: 3e3,
+      description: "Optional additional context, decisions, or learnings"
     }
   },
   examples: [
     {
-      id: "1752707800-changelog-task-user-dashboard",
-      entityType: "task",
-      entityId: "1752274500-task-user-dashboard",
-      changeType: "completion",
-      title: "User Dashboard Implementation Completed",
-      description: "Responsive dashboard with real-time analytics, user preferences, and notification center. All acceptance criteria met with 95% test coverage.",
-      timestamp: 1752707800,
-      trigger: "manual",
-      triggeredBy: "human:senior-dev",
-      reason: "All acceptance criteria met, code review passed, ready for production",
-      riskLevel: "low",
-      files: [
-        "src/pages/Dashboard.tsx",
-        "src/components/Analytics.tsx"
+      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"
+        "456ghi789",
+        "jkl012mno"
       ],
-      references: {
-        tasks: [
-          "1752274500-task-user-dashboard"
-        ],
-        executions: [
-          "1752707750-exec-dashboard-implementation"
-        ]
-      }
+      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-system-payment-gateway",
-      entityType: "system",
-      entityId: "payment-gateway",
-      changeType: "hotfix",
-      title: "Critical Payment Timeout Fix",
-      description: "Fixed 15% payment failure rate by increasing timeout from 5s to 30s and adding circuit breaker pattern. Emergency response to third-party API latency spike.",
-      timestamp: 1752707900,
-      trigger: "emergency",
-      triggeredBy: "human:on-call-engineer",
-      reason: "Payment failures spiked to 15% due to third-party API latency increase",
-      riskLevel: "critical",
-      affectedSystems: [
-        "payment-gateway",
-        "order-service",
-        "notification-service"
+      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"
       ],
-      usersAffected: 25e3,
-      downtime: 0,
-      rollbackInstructions: "1. Revert to payment-gateway:v2.1.4\n2. kubectl rollout restart deployment/payment-gateway\n3. Monitor success rate for 10 minutes",
       commits: [
-        "abc123def"
-      ]
+        "xyz789abc"
+      ],
+      notes: "Emergency response to production incident. Deployed to production within 2 hours."
     }
   ]
 };
@@ -505,7 +761,7 @@ 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 (sprints, milestones)",
+  description: "Canonical schema for cycle records - strategic grouping of work",
   additionalProperties: false,
   type: "object",
   required: [
@@ -517,13 +773,24 @@ var cycle_record_schema_default = {
     id: {
       type: "string",
       pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$",
-      description: "Unique identifier for the cycle"
+      maxLength: 67,
+      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",
+        "1754600000-cycle-q4-2025-growth"
+      ]
     },
     title: {
       type: "string",
       minLength: 1,
       maxLength: 256,
-      description: "Human-readable title for the cycle (e.g., 'Sprint 24.08')"
+      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",
+        "Q4 2025 - Growth & Scale"
+      ]
     },
     status: {
       type: "string",
@@ -539,45 +806,114 @@ var cycle_record_schema_default = {
       type: "array",
       items: {
         type: "string",
-        pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$"
-      }
+        pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$",
+        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)",
+      examples: [
+        [
+          "1752274500-task-optimizar-endpoint-search",
+          "1752360900-task-anadir-cache-a-redis"
+        ]
+      ]
     },
     childCycleIds: {
       type: "array",
       items: {
         type: "string",
-        pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$"
+        pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$",
+        maxLength: 67
       },
-      description: "An optional array of Cycle IDs that are children of this cycle, allowing for hierarchies."
+      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)",
+      examples: [
+        [
+          "1754400000-cycle-sprint-24",
+          "1754500000-cycle-sprint-25"
+        ]
+      ]
     },
     tags: {
       type: "array",
       items: {
         type: "string",
-        pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
+        pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$",
+        maxLength: 100
       },
       default: [],
-      description: "Optional list of key:value tags for categorization (e.g., 'roadmap:q4', 'team:alpha')."
+      description: "Optional list of key:value tags for categorization (e.g., 'roadmap:q4', 'team:alpha', 'okr:growth').",
+      examples: [
+        [
+          "roadmap:q4",
+          "team:backend"
+        ],
+        [
+          "sprint:24",
+          "focus:performance"
+        ],
+        [
+          "milestone:v2",
+          "security"
+        ]
+      ]
     },
     notes: {
       type: "string",
+      minLength: 0,
       maxLength: 1e4,
-      description: "An optional description of the cycle's goals and objectives"
+      description: "Optional description of the cycle's goals, objectives, and context"
     }
   },
   examples: [
     {
-      id: "1754400000-cycle-sprint-de-q4-api-performance",
-      title: "Sprint de Q4 - API Performance",
+      id: "1754400000-cycle-sprint-24-api-performance",
+      title: "Sprint 24 - API Performance",
       status: "active",
       taskIds: [
         "1752274500-task-optimizar-endpoint-search",
-        "1752360900-task-anadir-cache-a-redis"
+        "1752360900-task-anadir-cache-a-redis",
+        "1752447300-task-implementar-rate-limiting"
       ],
       tags: [
-        "roadmap:q4"
+        "sprint:24",
+        "team:backend",
+        "focus:performance"
       ],
-      notes: "Objetivo: Reducir la latencia p95 de la API por debajo de 200ms."
+      notes: "Objetivo: Reducir la latencia p95 de la API por debajo de 200ms y preparar infraestructura para Black Friday."
+    },
+    {
+      id: "1754500000-cycle-auth-system-v2",
+      title: "Authentication System v2.0",
+      status: "planning",
+      taskIds: [
+        "1752274500-task-oauth2-integration",
+        "1752360900-task-2fa-implementation",
+        "1752447300-task-password-recovery",
+        "1752533700-task-session-management"
+      ],
+      tags: [
+        "milestone:v2",
+        "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."
+    },
+    {
+      id: "1754600000-cycle-q4-2025-growth",
+      title: "Q4 2025 - Growth & Scale",
+      status: "active",
+      childCycleIds: [
+        "1754400000-cycle-sprint-24-api-performance",
+        "1754500000-cycle-auth-system-v2",
+        "1754650000-cycle-mobile-app-launch"
+      ],
+      tags: [
+        "roadmap:q4",
+        "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."
     }
   ]
 };
@@ -636,40 +972,42 @@ var embedded_metadata_schema_default = {
             properties: {
               keyId: {
                 type: "string",
-                description: "The Actor ID of the signer."
+                pattern: "^(human|agent)(:[a-z0-9-]+)+$",
+                description: "The Actor ID of the signer (must match ActorRecord.id pattern)."
               },
               role: {
                 type: "string",
-                description: "The context role of the signature (e.g., 'author')."
+                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:*')."
+              },
+              notes: {
+                type: "string",
+                minLength: 1,
+                maxLength: 1e3,
+                description: "Human-readable note from the signer. Part of the signature digest."
               },
               signature: {
                 type: "string",
-                description: "The Ed25519 signature (base64 encoded) of the signature digest."
+                pattern: "^[A-Za-z0-9+/]{86}==$",
+                description: "The Ed25519 signature (base64 encoded, 88 chars with padding) of the signature digest."
               },
               timestamp: {
                 type: "integer",
                 description: "Unix timestamp of the signature."
-              },
-              timestamp_iso: {
-                type: "string",
-                description: "ISO 8601 timestamp of the signature."
               }
             },
             required: [
               "keyId",
               "role",
+              "notes",
               "signature",
-              "timestamp",
-              "timestamp_iso"
-            ]
+              "timestamp"
+            ],
+            additionalProperties: false
           },
           description: "An array of one or more signature objects."
-        },
-        audit: {
-          type: "string",
-          minLength: 1,
-          maxLength: 3e3,
-          description: "A human-readable audit stamp (e.g., from gitgov audit)."
         }
       },
       required: [
@@ -869,33 +1207,95 @@ var embedded_metadata_schema_default = {
           }
         }
       },
-      else: false
-    }
-  ],
-  examples: [
+      else: false
+    }
+  ],
+  examples: [
+    {
+      header: {
+        version: "1.0",
+        type: "task",
+        payloadChecksum: "a1b2c3d4e5f6...",
+        signatures: [
+          {
+            keyId: "human:lead-dev",
+            role: "author",
+            notes: "Initial task creation for OAuth 2.0 implementation",
+            signature: "...",
+            timestamp: 1752274500
+          }
+        ]
+      },
+      payload: {
+        id: "1752274500-task-implementar-auth",
+        status: "pending",
+        priority: "high",
+        description: "Implementar autenticaci\xF3n OAuth 2.0.",
+        tags: [
+          "skill:go",
+          "area:backend"
+        ]
+      }
+    },
+    {
+      header: {
+        version: "1.0",
+        type: "execution",
+        payloadChecksum: "b2c3d4e5f6a1...",
+        signatures: [
+          {
+            keyId: "agent:cursor",
+            role: "author",
+            notes: "OAuth 2.0 flow completed with GitHub provider integration",
+            signature: "...",
+            timestamp: 1752274600
+          },
+          {
+            keyId: "human:camilo",
+            role: "reviewer",
+            notes: "Reviewed and tested locally. LGTM.",
+            signature: "...",
+            timestamp: 1752274650
+          }
+        ]
+      },
+      payload: {
+        id: "1752274600-exec-implement-oauth",
+        taskId: "1752274500-task-implement-oauth",
+        type: "progress",
+        title: "OAuth 2.0 flow implemented",
+        result: "Completed the OAuth 2.0 authentication flow..."
+      }
+    },
     {
       header: {
         version: "1.0",
-        type: "task",
-        payloadChecksum: "a1b2c3d4e5f6...",
+        type: "actor",
+        payloadChecksum: "c3d4e5f6a1b2...",
         signatures: [
           {
-            keyId: "human:lead-dev",
+            keyId: "human:admin",
             role: "author",
+            notes: "New developer onboarded to team",
+            signature: "...",
+            timestamp: 1752274700
+          },
+          {
+            keyId: "agent:aion",
+            role: "auditor",
+            notes: "Actor verification: 10/10. Credentials validated.",
             signature: "...",
-            timestamp: 1752274500,
-            timestamp_iso: "2025-07-25T14:30:00Z"
+            timestamp: 1752274705
           }
         ]
       },
       payload: {
-        id: "1752274500-task-implementar-auth",
-        status: "pending",
-        priority: "high",
-        description: "Implementar autenticaci\xF3n OAuth 2.0.",
-        tags: [
-          "skill:go",
-          "area:backend"
+        id: "human:new-developer",
+        type: "human",
+        displayName: "New Developer",
+        publicKey: "...",
+        roles: [
+          "developer"
         ]
       }
     }
@@ -907,29 +1307,32 @@ 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",
+  description: "Canonical schema for execution log records - the universal event stream",
   additionalProperties: false,
   type: "object",
   required: [
     "id",
     "taskId",
+    "type",
+    "title",
     "result"
   ],
   properties: {
     id: {
       type: "string",
       pattern: "^\\d{10}-exec-[a-z0-9-]{1,50}$",
-      maxLength: 70,
-      description: "Unique identifier for the execution log entry",
+      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-crear-schema-inicial"
+        "1752275000-exec-refactor-queries",
+        "1752361200-exec-api-externa-caida"
       ]
     },
     taskId: {
       type: "string",
       pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$",
-      maxLength: 70,
-      description: "ID of the parent task"
+      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)"
     },
     type: {
       type: "string",
@@ -951,23 +1354,25 @@ var execution_record_schema_default = {
     },
     title: {
       type: "string",
+      minLength: 1,
       maxLength: 256,
-      description: "Human-readable title for the execution",
+      description: "Human-readable title for the execution (used to generate ID)",
       examples: [
-        "Sub-Task-11",
-        "Initial analysis"
+        "Refactor de queries N+1",
+        "API Externa Ca\xEDda",
+        "Plan de implementaci\xF3n OAuth2"
       ]
     },
     result: {
       type: "string",
       minLength: 10,
       maxLength: 22e3,
-      description: "The tangible, verifiable output or result of the execution"
+      description: 'The tangible, verifiable output or result of the execution. \nThis is the "WHAT" - evidence of work or event summary.\n'
     },
     notes: {
       type: "string",
       maxLength: 6500,
-      description: "Optional comments about decisions, blockers or context"
+      description: 'Optional narrative, context and decisions behind the execution.\nThis is the "HOW" and "WHY" - the story behind the result.\n'
     },
     references: {
       type: "array",
@@ -975,19 +1380,79 @@ var execution_record_schema_default = {
         type: "string",
         maxLength: 500
       },
-      description: "List of URIs to relevant commits, files, or external documents"
+      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"
     }
   },
   examples: [
     {
-      id: "1752642000-exec-subtask-9-4",
-      taskId: "1752274500-task-integrar-adapter-configuracion",
+      id: "1752275500-exec-refactor-queries",
+      taskId: "1752274500-task-optimizar-api",
       type: "progress",
-      title: "Sub-tarea 9.4: Implementar parser de JSON",
-      result: "Adapter implementado y pasando tests",
-      notes: "La implementaci\xF3n inicial usa una librer\xEDa externa para el parsing.",
+      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: [
-        "commit:a1b2c3d4e5"
+        "exec:1752275500-exec-refactor-queries"
       ]
     }
   ]
@@ -998,7 +1463,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",
+  description: "Canonical schema for feedback records - structured conversation about work",
   additionalProperties: false,
   type: "object",
   required: [
@@ -1013,7 +1478,12 @@ var feedback_record_schema_default = {
     id: {
       type: "string",
       pattern: "^\\d{10}-feedback-[a-z0-9-]{1,50}$",
-      description: "Unique identifier for the feedback entry"
+      maxLength: 70,
+      description: "Unique identifier for the feedback entry",
+      examples: [
+        "1752788100-feedback-blocking-rest-api",
+        "1752788200-feedback-question-test-coverage"
+      ]
     },
     entityType: {
       type: "string",
@@ -1021,13 +1491,21 @@ var feedback_record_schema_default = {
         "task",
         "execution",
         "changelog",
-        "feedback"
+        "feedback",
+        "cycle"
       ],
       description: "The type of entity this feedback refers to"
     },
     entityId: {
       type: "string",
-      description: "The ID of the entity this feedback refers to"
+      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",
+      examples: [
+        "1752274500-task-implementar-oauth",
+        "1752642000-exec-subtarea-9-4",
+        "1752788100-feedback-blocking-rest-api"
+      ]
     },
     type: {
       type: "string",
@@ -1039,7 +1517,12 @@ var feedback_record_schema_default = {
         "clarification",
         "assignment"
       ],
-      description: "The semantic intent of the feedback"
+      description: "The semantic intent of the feedback",
+      examples: [
+        "blocking",
+        "question",
+        "approval"
+      ]
     },
     status: {
       type: "string",
@@ -1049,31 +1532,69 @@ var feedback_record_schema_default = {
         "resolved",
         "wontfix"
       ],
-      description: "The lifecycle status of the feedback"
+      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'
     },
     content: {
       type: "string",
       minLength: 1,
-      maxLength: 1e4,
-      description: "The content of the feedback"
+      maxLength: 5e3,
+      description: "The content of the feedback. Reduced from 10000 to 5000 chars for practical use."
     },
     assignee: {
       type: "string",
-      description: "The Actor ID of the agent responsible for addressing the feedback"
+      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"
+      ]
     },
     resolvesFeedbackId: {
       type: "string",
-      description: "The ID of another feedback record that this one resolves or responds to"
+      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"
+      ]
     }
   },
   examples: [
     {
-      id: "1752788100-feedback-blocking-comment",
+      id: "1752788100-feedback-blocking-rest-api",
       entityType: "execution",
       entityId: "1752642000-exec-subtarea-9-4",
       type: "blocking",
       status: "open",
-      content: "Esta implementaci\xF3n no cumple el est\xE1ndar de rutas REST. Sugiero revisar el spec."
+      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."
+    },
+    {
+      id: "1752788200-feedback-rest-api-fixed",
+      entityType: "feedback",
+      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.",
+      resolvesFeedbackId: "1752788100-feedback-blocking-rest-api"
+    },
+    {
+      id: "1752788300-feedback-assign-auth-task",
+      entityType: "task",
+      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.",
+      assignee: "human:maria"
+    },
+    {
+      id: "1752788400-feedback-question-test-coverage",
+      entityType: "task",
+      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?"
     }
   ]
 };
@@ -1091,15 +1612,14 @@ var task_record_schema_default = {
     "title",
     "status",
     "priority",
-    "description",
-    "tags"
+    "description"
   ],
   properties: {
     id: {
       type: "string",
       pattern: "^\\d{10}-task-[a-z0-9-]{1,50}$",
-      maxLength: 70,
-      description: "Unique identifier for the task",
+      maxLength: 66,
+      description: "Unique identifier for the task (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)",
       examples: [
         "1752274500-task-implementar-auth",
         "1752347700-task-fix-logging"
@@ -1115,9 +1635,12 @@ var task_record_schema_default = {
       type: "array",
       items: {
         type: "string",
-        pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$"
+        minLength: 1,
+        pattern: "^\\d{10}-cycle-[a-z0-9-]{1,50}$",
+        maxLength: 67
       },
-      description: "Optional. The IDs of the strategic cycles this task belongs to."
+      default: [],
+      description: "Optional. The IDs of the strategic cycles this task belongs to. (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)"
     },
     status: {
       type: "string",
@@ -1155,30 +1678,102 @@ var task_record_schema_default = {
       type: "array",
       items: {
         type: "string",
+        minLength: 1,
         pattern: "^[a-z0-9-]+(:[a-z0-9-:]+)*$"
       },
-      description: "List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer'). Can be an empty array."
+      default: [],
+      description: "Optional. List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer')."
     },
     references: {
       type: "array",
       items: {
         type: "string",
+        minLength: 1,
         maxLength: 500
       },
+      default: [],
       description: "Valid links or files, when mentioned"
     },
     notes: {
       type: "string",
+      minLength: 0,
       maxLength: 3e3,
       description: "Additional comments, decisions made or added context"
     }
   },
   examples: [
     {
-      id: "1752274500-task-implementar-adapter-github",
-      status: "in_progress",
+      id: "1752274500-task-implement-oauth-flow",
+      title: "Implement OAuth 2.0 authentication flow",
+      status: "draft",
       priority: "high",
-      description: "Implementar adapter completo para GitHub Issues como TaskLifecycle Store"
+      description: "Implement complete OAuth 2.0 flow with GitHub provider. Include token refresh, session management, and secure storage. Must support both web and CLI flows.",
+      cycleIds: [
+        "1752270000-cycle-auth-mvp"
+      ],
+      tags: [
+        "skill:security",
+        "category:feature",
+        "package:core"
+      ],
+      references: [
+        "url:https://docs.github.com/en/apps/oauth-apps/building-oauth-apps"
+      ],
+      notes: "Consider using proven library like passport.js or implement from scratch for learning."
+    },
+    {
+      id: "1752347700-task-fix-memory-leak-indexer",
+      title: "Fix memory leak in indexer process",
+      status: "active",
+      priority: "critical",
+      description: "Indexer process consuming >2GB RAM after 24h uptime. Profiling shows EventEmitter listeners not being cleaned up properly. Fix leak and add monitoring.",
+      cycleIds: [],
+      tags: [
+        "category:bug",
+        "skill:performance",
+        "package:core"
+      ],
+      references: [
+        "file:packages/core/src/adapters/indexer_adapter/index.ts",
+        "commit:a1b2c3d4",
+        "issue:789"
+      ],
+      notes: "Discovered during production monitoring. Affects long-running processes only."
+    },
+    {
+      id: "1752448900-task-add-typescript-linting",
+      title: "Add TypeScript strict mode and ESLint rules",
+      status: "done",
+      priority: "medium",
+      description: "Enable TypeScript strict mode across all packages. Configure ESLint with recommended rules. Fix all existing violations. Add pre-commit hook.",
+      cycleIds: [
+        "1752440000-cycle-code-quality-q1"
+      ],
+      tags: [
+        "category:tooling",
+        "skill:typescript",
+        "epic:code-quality"
+      ],
+      references: [
+        "pr:123",
+        "file:.eslintrc.js",
+        "file:tsconfig.json"
+      ],
+      notes: "Approved by tech lead. All 47 violations fixed in PR #123."
+    },
+    {
+      id: "1752550000-task-research-graphql-migration",
+      title: "Research GraphQL migration feasibility",
+      status: "draft",
+      priority: "low",
+      description: "Evaluate feasibility of migrating REST API to GraphQL. Document pros/cons, effort estimation, and recommended approach. Focus on developer experience and performance.",
+      cycleIds: [],
+      tags: [
+        "category:research",
+        "skill:graphql",
+        "skill:backend"
+      ],
+      references: []
     }
   ]
 };
@@ -1260,7 +1855,7 @@ var workflow_methodology_record_schema_default = {
               },
               signatures: {
                 type: "object",
-                description: "Signature requirements keyed by guild",
+                description: "Signature requirements keyed by role (e.g., 'approver:quality', 'developer:backend')",
                 additionalProperties: {
                   type: "object",
                   required: [
@@ -1428,27 +2023,35 @@ var workflow_methodology_record_schema_default = {
           items: {
             type: "object",
             required: [
-              "id",
-              "gremio",
               "engine"
             ],
+            anyOf: [
+              {
+                required: [
+                  "id"
+                ]
+              },
+              {
+                required: [
+                  "required_roles"
+                ]
+              }
+            ],
             additionalProperties: false,
             properties: {
               id: {
                 type: "string",
                 pattern: "^agent:[a-z0-9:-]+$",
-                description: "Unique agent identifier"
+                description: "Optional: Specific agent ID. If provided, uses this exact agent."
               },
-              gremio: {
-                type: "string",
-                enum: [
-                  "design",
-                  "intelligence",
-                  "strategy",
-                  "operations",
-                  "quality"
-                ],
-                description: "Agent guild classification"
+              required_roles: {
+                type: "array",
+                items: {
+                  type: "string",
+                  pattern: "^[a-z0-9-]+(:[a-z0-9-]+)*$"
+                },
+                minItems: 1,
+                description: "Optional: Required capability roles. Matches any agent with these roles (from ActorRecord)."
               },
               engine: {
                 type: "object",
@@ -1575,7 +2178,257 @@ var workflow_methodology_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"
+          }
+        }
+      },
+      view_configs: {
+        "kanban-3col": {
+          columns: {
+            "To Do": [
+              "draft",
+              "review"
+            ],
+            "In Progress": [
+              "ready",
+              "active"
+            ],
+            Done: [
+              "done"
+            ]
+          },
+          theme: "minimal",
+          layout: "horizontal"
+        }
+      }
+    },
+    {
+      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"
+        }
+      },
+      view_configs: {
+        "kanban-4col": {
+          columns: {
+            Draft: [
+              "draft"
+            ],
+            "In Progress": [
+              "review",
+              "ready",
+              "active"
+            ],
+            Review: [
+              "done"
+            ],
+            Done: [
+              "archived"
+            ],
+            Cancelled: [
+              "discarded"
+            ]
+          },
+          theme: "minimal",
+          layout: "horizontal"
+        },
+        "kanban-7col": {
+          columns: {
+            Draft: [
+              "draft"
+            ],
+            Review: [
+              "review"
+            ],
+            Ready: [
+              "ready"
+            ],
+            Active: [
+              "active"
+            ],
+            Done: [
+              "done"
+            ],
+            Archived: [
+              "archived"
+            ],
+            Blocked: [
+              "paused"
+            ],
+            Cancelled: [
+              "discarded"
+            ]
+          },
+          theme: "corporate",
+          layout: "vertical"
+        }
+      }
+    }
+  ]
 };
 
 // src/schemas/generated/index.ts
@@ -1717,13 +2570,13 @@ var SchemaValidationError = class extends Error {
   }
 };
 var DetailedValidationError = class extends GitGovError {
-  constructor(recordType, ajvErrors) {
-    const errorSummary = ajvErrors.map((err) => `${err.field}: ${err.message}`).join(", ");
+  constructor(recordType, errors) {
+    const errorSummary = errors.map((err) => `${err.field}: ${err.message}`).join(", ");
     super(
       `${recordType} validation failed: ${errorSummary}`,
       "DETAILED_VALIDATION_ERROR"
     );
-    this.ajvErrors = ajvErrors;
+    this.errors = errors;
   }
 };
 
@@ -1827,10 +2680,10 @@ async function generateKeys() {
     privateKey: Buffer.from(privateKey).toString("base64")
   };
 }
-function signPayload(payload, privateKey, keyId, role) {
+function signPayload(payload, privateKey, keyId, role, notes) {
   const payloadChecksum = calculatePayloadChecksum(payload);
   const timestamp = Math.floor(Date.now() / 1e3);
-  const digest = `${payloadChecksum}:${keyId}:${role}:${timestamp}`;
+  const digest = `${payloadChecksum}:${keyId}:${role}:${notes}:${timestamp}`;
   const digestHash = createHash("sha256").update(digest).digest();
   const signature = sign(null, digestHash, {
     key: Buffer.from(privateKey, "base64"),
@@ -1840,9 +2693,9 @@ function signPayload(payload, privateKey, keyId, role) {
   return {
     keyId,
     role,
+    notes,
     signature: signature.toString("base64"),
-    timestamp,
-    timestamp_iso: new Date(timestamp * 1e3).toISOString()
+    timestamp
   };
 }
 async function verifySignatures(record, getActorPublicKey) {
@@ -1852,7 +2705,7 @@ async function verifySignatures(record, getActorPublicKey) {
       logger2.warn(`Public key not found for actor: ${signature.keyId}`);
       return false;
     }
-    const digest = `${record.header.payloadChecksum}:${signature.keyId}:${signature.role}:${signature.timestamp}`;
+    const digest = `${record.header.payloadChecksum}:${signature.keyId}:${signature.role}:${signature.notes}:${signature.timestamp}`;
     const digestHash = createHash("sha256").update(digest).digest();
     const isValid = verify(
       null,
@@ -1955,13 +2808,6 @@ function validateEmbeddedMetadataBusinessRules(data) {
       value: data.header.signatures
     });
   }
-  if (data.header.audit && (data.header.audit.length < 1 || data.header.audit.length > 3e3)) {
-    errors.push({
-      field: "header.audit",
-      message: "audit field must be between 1 and 3000 characters",
-      value: data.header.audit
-    });
-  }
   return {
     isValid: errors.length === 0,
     errors
@@ -1981,8 +2827,8 @@ function isTaskRecord(data) {
 function validateTaskRecordDetailed(data) {
   const [isValid, ajvErrors] = validateTaskRecordSchema(data);
   const formattedErrors = ajvErrors ? ajvErrors.map((error) => ({
-    field: error.instancePath || error.schemaPath || "root",
-    message: error.message || "Validation failed",
+    field: error.instancePath?.replace("/", "") || error.params?.["missingProperty"] || "root",
+    message: error.message || "Unknown validation error",
     value: error.data
   })) : [];
   return {
@@ -1993,9 +2839,12 @@ function validateTaskRecordDetailed(data) {
 async function validateFullTaskRecord(record, getActorPublicKey) {
   const [isValidSchema, errors] = validateTaskRecordSchema(record.payload);
   if (!isValidSchema) {
-    throw new SchemaValidationError(
-      `TaskRecord payload failed schema validation: ${JSON.stringify(errors)}`
-    );
+    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("TaskRecord", formattedErrors);
   }
   await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
 }
@@ -2020,32 +2869,14 @@ function generateExecutionId(title, timestamp) {
   const slug = sanitizeForId(title);
   return `${timestamp}-exec-${slug}`;
 }
-function generateChangelogId(entityType, entityId, timestamp) {
-  let entitySlug;
-  if (entityType === "system" || entityType === "configuration") {
-    entitySlug = sanitizeForId(entityId);
-  } else {
-    const parsed = parseTimestampedId(entityId);
-    entitySlug = parsed ? parsed.slug : sanitizeForId(entityId);
-  }
-  return `${timestamp}-changelog-${entityType}-${entitySlug}`;
+function generateChangelogId(title, timestamp) {
+  const slug = sanitizeForId(title);
+  return `${timestamp}-changelog-${slug}`;
 }
 function generateFeedbackId(title, timestamp) {
   const slug = sanitizeForId(title);
   return `${timestamp}-feedback-${slug}`;
 }
-function parseTimestampedId(id) {
-  if (typeof id !== "string") return null;
-  const match = id.match(/^(\d+)-(\w+)-(.+)$/);
-  if (!match || !match[1] || !match[2] || !match[3]) {
-    return null;
-  }
-  return {
-    timestamp: parseInt(match[1], 10),
-    prefix: match[2],
-    slug: match[3]
-  };
-}
 
 // src/factories/task_factory.ts
 async function createTaskRecord(payload) {
@@ -2083,8 +2914,8 @@ function isCycleRecord(data) {
 function validateCycleRecordDetailed(data) {
   const [isValid, ajvErrors] = validateCycleRecordSchema(data);
   const formattedErrors = ajvErrors ? ajvErrors.map((error) => ({
-    field: error.instancePath || error.schemaPath || "root",
-    message: error.message || "Validation failed",
+    field: error.instancePath?.replace("/", "") || error.params?.["missingProperty"] || "root",
+    message: error.message || "Unknown validation error",
     value: error.data
   })) : [];
   return {
@@ -2095,9 +2926,12 @@ function validateCycleRecordDetailed(data) {
 async function validateFullCycleRecord(record, getActorPublicKey) {
   const [isValidSchema, errors] = validateCycleRecordSchema(record.payload);
   if (!isValidSchema) {
-    throw new SchemaValidationError(
-      `CycleRecord payload failed schema validation: ${JSON.stringify(errors)}`
-    );
+    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("CycleRecord", formattedErrors);
   }
   await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
 }
@@ -2395,8 +3229,8 @@ function isActorRecord(data) {
 function validateActorRecordDetailed(data) {
   const [isValid, ajvErrors] = validateActorRecordSchema(data);
   const formattedErrors = ajvErrors ? ajvErrors.map((error) => ({
-    field: error.instancePath || error.schemaPath || "root",
-    message: error.message || "Validation failed",
+    field: error.instancePath?.replace("/", "") || error.params?.["missingProperty"] || "root",
+    message: error.message || "Unknown validation error",
     value: error.data
   })) : [];
   return {
@@ -2406,10 +3240,13 @@ function validateActorRecordDetailed(data) {
 }
 async function validateFullActorRecord(record, getActorPublicKey) {
   const [isValidSchema, errors] = validateActorRecordSchema(record.payload);
-  if (!isValidSchema) {
-    throw new SchemaValidationError(
-      `ActorRecord payload failed schema validation: ${JSON.stringify(errors)}`
-    );
+  if (!isValidSchema) {
+    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("ActorRecord", formattedErrors);
   }
   await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
 }
@@ -2445,8 +3282,8 @@ function isAgentRecord(data) {
 function validateAgentRecordDetailed(data) {
   const [isValid, ajvErrors] = validateAgentRecordSchema(data);
   const formattedErrors = ajvErrors ? ajvErrors.map((error) => ({
-    field: error.instancePath || error.schemaPath || "root",
-    message: error.message || "Validation failed",
+    field: error.instancePath?.replace("/", "") || error.params?.["missingProperty"] || "root",
+    message: error.message || "Unknown validation error",
     value: error.data
   })) : [];
   return {
@@ -2457,9 +3294,12 @@ function validateAgentRecordDetailed(data) {
 async function validateFullAgentRecord(record, getActorPublicKey) {
   const [isValidSchema, errors] = validateAgentRecordSchema(record.payload);
   if (!isValidSchema) {
-    throw new SchemaValidationError(
-      `AgentRecord payload failed schema validation: ${JSON.stringify(errors)}`
-    );
+    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("AgentRecord", formattedErrors);
   }
   await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
 }
@@ -2486,7 +3326,6 @@ async function validateAgentActorRelationship(agentRecord, getEffectiveActor) {
 async function createAgentRecord(payload) {
   const agent = {
     id: payload.id || "",
-    guild: payload.guild || "design",
     engine: payload.engine || { type: "local" },
     status: payload.status || "active",
     triggers: payload.triggers || [],
@@ -2539,7 +3378,7 @@ var IdentityAdapter = class {
     };
     const validatedPayload = await createActorRecord(completePayload);
     const payloadChecksum = calculatePayloadChecksum(validatedPayload);
-    const signature = await signPayload(validatedPayload, privateKey, actorId, "author");
+    const signature = await signPayload(validatedPayload, privateKey, actorId, "author", "Actor registration");
     const record = {
       header: {
         version: "1.0",
@@ -2601,9 +3440,9 @@ var IdentityAdapter = class {
     const mockSignature = {
       keyId: actorId,
       role,
+      notes: "Record signed",
       signature: `mock-signature-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
-      timestamp: Math.floor(Date.now() / 1e3),
-      timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+      timestamp: Math.floor(Date.now() / 1e3)
     };
     const signedRecord = {
       ...record,
@@ -2711,8 +3550,8 @@ var IdentityAdapter = class {
     console.warn("authenticate not fully implemented yet");
   }
   async createAgentRecord(payload) {
-    if (!payload.id || !payload.guild || !payload.engine) {
-      throw new Error("AgentRecord requires id, guild and engine");
+    if (!payload.id || !payload.engine) {
+      throw new Error("AgentRecord requires id and engine");
     }
     const correspondingActor = await this.getActor(payload.id);
     if (!correspondingActor) {
@@ -2723,7 +3562,6 @@ var IdentityAdapter = class {
     }
     const completePayload = {
       id: payload.id,
-      guild: payload.guild,
       engine: payload.engine,
       status: payload.status || "active",
       triggers: payload.triggers || [],
@@ -2733,7 +3571,7 @@ var IdentityAdapter = class {
     };
     const validatedPayload = await createAgentRecord(completePayload);
     const payloadChecksum = calculatePayloadChecksum(validatedPayload);
-    const signature = signPayload(validatedPayload, "placeholder-private-key", payload.id, "author");
+    const signature = signPayload(validatedPayload, "placeholder-private-key", payload.id, "author", "Agent registration");
     const record = {
       header: {
         version: "1.0",
@@ -2758,7 +3596,6 @@ var IdentityAdapter = class {
         source: "identity_adapter",
         payload: {
           agentId: validatedPayload.id,
-          guild: validatedPayload.guild,
           engine: validatedPayload.engine,
           correspondingActorId: correspondingActor.id
         }
@@ -2863,11 +3700,11 @@ var FeedbackAdapter = class {
     this.eventBus = dependencies.eventBus;
   }
   /**
-   * [EARS-1] Creates a new FeedbackRecord for structured communication between actors.
+   * [EARS-1, EARS-2, EARS-3, EARS-4, EARS-5, EARS-6, EARS-7, EARS-8] Creates a new FeedbackRecord for structured communication between actors.
    * 
    * Description: Creates a new FeedbackRecord for structured communication between actors.
    * Implementation: Builds record with status: "open", signs with actorId, persists and emits event.
-   * Usage: Invoked by `gitgov feedback add` to create feedback, assignments, blocks.
+   * Usage: Invoked by `gitgov feedback create` to create feedback, assignments, blocks, responses.
    * Returns: Complete and signed FeedbackRecord.
    */
   async create(payload, actorId) {
@@ -2875,21 +3712,30 @@ var FeedbackAdapter = class {
     if (!payloadWithEntityId.entityId) {
       throw new Error("RecordNotFoundError: entityId is required");
     }
-    if (payloadWithEntityId.entityType && !["task", "execution", "changelog", "feedback"].includes(payloadWithEntityId.entityType)) {
-      throw new Error("InvalidEntityTypeError: entityType must be task, execution, changelog, or feedback");
+    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 (payload.type === "assignment" && payload.assignee) {
       const existingFeedbacks = await this.getFeedbackByEntity(payloadWithEntityId.entityId);
-      const duplicateAssignment = existingFeedbacks.find(
+      const openAssignments = existingFeedbacks.filter(
         (feedback) => feedback.type === "assignment" && feedback.assignee === payload.assignee && feedback.status === "open"
       );
-      if (duplicateAssignment) {
-        throw new Error(`DuplicateAssignmentError: Task ${payloadWithEntityId.entityId} is already assigned to ${payload.assignee} (feedback: ${duplicateAssignment.id})`);
+      if (openAssignments.length > 0) {
+        const allFeedbacks = await this.getAllFeedback();
+        for (const assignment of openAssignments) {
+          const hasResolution = allFeedbacks.some(
+            (feedback) => feedback.entityType === "feedback" && feedback.resolvesFeedbackId === assignment.id && feedback.status === "resolved"
+          );
+          if (!hasResolution) {
+            throw new Error(`DuplicateAssignmentError: Task ${payloadWithEntityId.entityId} is already assigned to ${payload.assignee} (feedback: ${assignment.id})`);
+          }
+        }
       }
     }
     const enrichedPayload = {
-      ...payload,
-      status: "open"
+      status: "open",
+      ...payload
+      // Allows payload.status to override default
     };
     try {
       const validatedPayload = await createFeedbackRecord(enrichedPayload);
@@ -2901,9 +3747,9 @@ var FeedbackAdapter = class {
           signatures: [{
             keyId: actorId,
             role: "author",
+            notes: "Feedback created",
             signature: "placeholder",
-            timestamp: Date.now(),
-            timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+            timestamp: Date.now()
           }]
         },
         payload: validatedPayload
@@ -2922,7 +3768,8 @@ var FeedbackAdapter = class {
           status: validatedPayload.status,
           content: validatedPayload.content,
           triggeredBy: actorId,
-          assignee: validatedPayload.assignee
+          assignee: validatedPayload.assignee,
+          resolvesFeedbackId: validatedPayload.resolvesFeedbackId
         }
       });
       return validatedPayload;
@@ -2934,51 +3781,30 @@ var FeedbackAdapter = class {
     }
   }
   /**
-   * [EARS-4] Resolves an existing feedback changing its status to resolved.
+   * [EARS-9, EARS-10, EARS-11, EARS-12] Helper: Creates a new feedback that "resolves" another (immutable).
    * 
-   * Description: Resolves an existing feedback changing its status to resolved.
-   * Implementation: Reads feedback, validates permissions (future), transitions state, signs and emits event.
-   * Usage: Invoked by `gitgov feedback resolve` to close conversations and blocks.
-   * Returns: Updated FeedbackRecord with new signature.
-   */
-  async resolve(feedbackId, actorId) {
-    const existingRecord = await this.feedbackStore.read(feedbackId);
-    if (!existingRecord) {
+   * Description: Helper method that creates a new feedback documenting resolution of another feedback.
+   * Implementation: Verifies original exists, then delegates to create() with immutable pattern.
+   * Usage: Ergonomic helper for common case. For advanced cases (wontfix, approval), use create() directly.
+   * Returns: New FeedbackRecord that points to the original with resolvesFeedbackId.
+   */
+  async resolve(feedbackId, actorId, content) {
+    const originalFeedback = await this.getFeedback(feedbackId);
+    if (!originalFeedback) {
       throw new Error(`RecordNotFoundError: Feedback not found: ${feedbackId}`);
     }
-    if (existingRecord.payload.status === "resolved") {
-      throw new Error(`ProtocolViolationError: Feedback ${feedbackId} is already resolved`);
-    }
-    const updatedPayload = {
-      ...existingRecord.payload,
-      status: "resolved"
-    };
-    try {
-      const updatedRecord = {
-        ...existingRecord,
-        payload: updatedPayload
-      };
-      const signedRecord = await this.identity.signRecord(updatedRecord, actorId, "resolver");
-      await this.feedbackStore.write(signedRecord);
-      this.eventBus.publish({
-        type: "feedback.status.changed",
-        timestamp: Date.now(),
-        source: "feedback_adapter",
-        payload: {
-          feedbackId: updatedPayload.id,
-          oldStatus: existingRecord.payload.status,
-          newStatus: updatedPayload.status,
-          triggeredBy: actorId,
-          assignee: updatedPayload.assignee
-        }
-      });
-      return updatedPayload;
-    } catch (error) {
-      throw error;
-    }
+    const resolveContent = content || `Feedback resolved by ${actorId}`;
+    return await this.create({
+      entityType: "feedback",
+      entityId: feedbackId,
+      type: "clarification",
+      status: "resolved",
+      content: resolveContent,
+      resolvesFeedbackId: feedbackId
+    }, actorId);
   }
   /**
-   * [EARS-7] Gets a specific FeedbackRecord by its ID for query.
+   * [EARS-13, EARS-14] Gets a specific FeedbackRecord by its ID for query.
    * 
    * Description: Gets a specific FeedbackRecord by its ID for query.
    * Implementation: Direct read from record store without modifications.
@@ -2990,11 +3816,11 @@ var FeedbackAdapter = class {
     return record ? record.payload : null;
   }
   /**
-   * [EARS-9] Gets all FeedbackRecords associated with a specific entity.
+   * [EARS-15] Gets all FeedbackRecords associated with a specific entity.
    * 
    * Description: Gets all FeedbackRecords associated with a specific entity.
    * Implementation: Reads all records and filters by matching entityId.
-   * Usage: Invoked by `gitgov feedback list` to display feedback for a task/cycle.
+   * Usage: Invoked by `gitgov feedback list` to display feedback for a task/cycle/execution.
    * Returns: Array of FeedbackRecords filtered for the entity.
    */
   async getFeedbackByEntity(entityId) {
@@ -3009,11 +3835,11 @@ var FeedbackAdapter = class {
     return feedbacks;
   }
   /**
-   * [EARS-10] Gets all FeedbackRecords in the system for indexation.
+   * [EARS-16] Gets all FeedbackRecords in the system for indexation.
    * 
    * Description: Gets all FeedbackRecords in the system for complete indexation.
    * Implementation: Complete read from record store without filters.
-   * Usage: Invoked by `gitgov feedback list --all` and by MetricsAdapter for calculations.
+   * Usage: Invoked by `gitgov feedback list` and by MetricsAdapter for calculations.
    * Returns: Complete array of all FeedbackRecords.
    */
   async getAllFeedback() {
@@ -3027,6 +3853,49 @@ var FeedbackAdapter = class {
     }
     return feedbacks;
   }
+  /**
+   * [EARS-17, EARS-18, EARS-19, EARS-20] Builds the complete conversation tree for a feedback.
+   * 
+   * Description: Recursively constructs the conversation tree for a feedback.
+   * Implementation: Reads root feedback, finds all responses, builds tree recursively until maxDepth.
+   * Usage: Invoked by `gitgov feedback thread` and `gitgov feedback show --thread`.
+   * Returns: FeedbackThread object with tree structure.
+   */
+  async getFeedbackThread(feedbackId, maxDepth = Infinity) {
+    return await this.buildThread(feedbackId, maxDepth, 0);
+  }
+  /**
+   * Private helper: Recursively builds conversation thread.
+   */
+  async buildThread(feedbackId, maxDepth, currentDepth) {
+    if (currentDepth >= maxDepth) {
+      throw new Error(`Max depth ${maxDepth} reached for feedback thread`);
+    }
+    const feedback = await this.getFeedback(feedbackId);
+    if (!feedback) {
+      throw new Error(`RecordNotFoundError: Feedback not found: ${feedbackId}`);
+    }
+    const allFeedbacks = await this.getAllFeedback();
+    const responses = allFeedbacks.filter(
+      (f) => f.entityType === "feedback" && f.entityId === feedbackId
+    );
+    const responseThreads = [];
+    for (const response of responses) {
+      try {
+        const thread = await this.buildThread(response.id, maxDepth, currentDepth + 1);
+        responseThreads.push(thread);
+      } catch (error) {
+        if (error instanceof Error && error.message.includes("Max depth")) {
+          continue;
+        }
+        throw error;
+      }
+    }
+    return {
+      feedback,
+      responses: responseThreads
+    };
+  }
 };
 
 // src/adapters/execution_adapter/index.ts
@@ -3117,16 +3986,7 @@ var ExecutionAdapter = class {
    * Returns: Complete and signed ExecutionRecord.
    */
   async create(payload, actorId) {
-    if (!payload.taskId) {
-      throw new Error("DetailedValidationError: taskId is required");
-    }
-    if (!payload.result) {
-      throw new Error("DetailedValidationError: result is required");
-    }
-    if (payload.result && payload.result.length < 10) {
-      throw new Error("DetailedValidationError: result must be at least 10 characters");
-    }
-    if (this.taskStore) {
+    if (this.taskStore && payload.taskId) {
       const taskExists = await this.taskStore.read(payload.taskId);
       if (!taskExists) {
         throw new Error(`RecordNotFoundError: Task not found: ${payload.taskId}`);
@@ -3142,9 +4002,9 @@ var ExecutionAdapter = class {
           signatures: [{
             keyId: actorId,
             role: "author",
+            notes: "Execution recorded",
             signature: "placeholder",
-            timestamp: Date.now(),
-            timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+            timestamp: Date.now()
           }]
         },
         payload: validatedPayload
@@ -3164,9 +4024,6 @@ var ExecutionAdapter = class {
       });
       return validatedPayload;
     } catch (error) {
-      if (error instanceof Error && error.message.includes("DetailedValidationError")) {
-        throw error;
-      }
       throw error;
     }
   }
@@ -3280,31 +4137,21 @@ async function validateFullChangelogRecord(record, getPublicKey) {
 // src/factories/changelog_factory.ts
 async function createChangelogRecord(payload) {
   const timestamp = Math.floor(Date.now() / 1e3);
-  let id = payload.id;
-  if (!id && payload.entityType && payload.entityId) {
-    id = generateChangelogId(payload.entityType, payload.entityId, timestamp);
-  }
   const changelog = {
     // Required fields
-    id: id || "",
-    entityType: payload.entityType || "task",
-    entityId: payload.entityId || "",
-    changeType: payload.changeType || "completion",
+    id: payload.id || "",
     title: payload.title || "",
     description: payload.description || "",
-    timestamp: payload.timestamp || timestamp,
-    trigger: payload.trigger || "manual",
-    triggeredBy: payload.triggeredBy || "",
-    reason: payload.reason || "",
-    riskLevel: payload.riskLevel || "low",
-    // Optional fields (preserve if provided)
-    ...payload.affectedSystems && { affectedSystems: payload.affectedSystems },
-    ...payload.usersAffected !== void 0 && { usersAffected: payload.usersAffected },
-    ...payload.downtime !== void 0 && { downtime: payload.downtime },
-    ...payload.files && { files: payload.files },
+    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.rollbackInstructions && { rollbackInstructions: payload.rollbackInstructions },
-    ...payload.references && { references: payload.references }
+    ...payload.files && { files: payload.files },
+    ...payload.notes && { notes: payload.notes }
   };
   const validation = validateChangelogRecordDetailed(changelog);
   if (!validation.isValid) {
@@ -3328,54 +4175,44 @@ var ChangelogAdapter = class {
     this.cycleStore = dependencies.cycleStore;
   }
   /**
-   * [EARS-1] Records a significant change in any entity with complete context and conditional validation.
+   * [EARS-1] Records a deliverable/release note.
    * 
-   * Description: Records a significant change in any entity of the ecosystem with complete context and conditional validation.
-   * Implementation: Validates entity existence (optional), builds record with factory, validates conditional fields, signs with actorId, persists and emits event.
-   * Usage: Invoked by `gitgov changelog add` to document changes in tasks, cycles, agents, systems, configurations.
-   * Returns: Complete and signed ChangelogRecord with 19 fields.
+   * 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.entityType) {
-      throw new Error("DetailedValidationError: entityType is required");
-    }
-    if (!payload.entityId) {
-      throw new Error("DetailedValidationError: entityId is required");
-    }
-    if (!["task", "cycle", "agent", "system", "configuration"].includes(payload.entityType)) {
-      throw new Error("DetailedValidationError: entityType must be task, cycle, agent, system, or configuration");
-    }
-    if (payload.changeType && !["creation", "completion", "update", "deletion", "hotfix"].includes(payload.changeType)) {
-      throw new Error("DetailedValidationError: changeType must be creation, completion, update, deletion, or hotfix");
+    if (!payload.title || payload.title.length < 10) {
+      throw new Error("DetailedValidationError: title is required and must be at least 10 characters");
     }
-    if (payload.title && payload.title.length < 10) {
-      throw new Error("DetailedValidationError: title 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.description && payload.description.length < 20) {
-      throw new Error("DetailedValidationError: description 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.riskLevel === "high" && !payload.rollbackInstructions) {
-      throw new Error("DetailedValidationError: rollbackInstructions is required when riskLevel is high");
-    }
-    if (payload.riskLevel === "critical" && !payload.rollbackInstructions) {
-      throw new Error("DetailedValidationError: rollbackInstructions is required when riskLevel is critical");
-    }
-    if (payload.changeType === "completion" && (!payload.references?.tasks || payload.references.tasks.length === 0)) {
-      throw new Error("DetailedValidationError: references.tasks is required when changeType is completion");
-    }
-    if (payload.entityType === "task" && this.taskStore) {
-      const taskExists = await this.taskStore.read(payload.entityId);
-      if (!taskExists) {
-        throw new Error(`RecordNotFoundError: Task not found: ${payload.entityId}`);
+    if (this.taskStore && payload.relatedTasks) {
+      for (const taskId of payload.relatedTasks) {
+        const taskExists = await this.taskStore.read(taskId);
+        if (!taskExists) {
+          throw new Error(`RecordNotFoundError: Task not found: ${taskId}`);
+        }
       }
     }
-    if (payload.entityType === "cycle" && this.cycleStore) {
-      const cycleExists = await this.cycleStore.read(payload.entityId);
-      if (!cycleExists) {
-        throw new Error(`RecordNotFoundError: Cycle not found: ${payload.entityId}`);
+    if (this.cycleStore && payload.relatedCycles) {
+      for (const cycleId of payload.relatedCycles) {
+        const cycleExists = await this.cycleStore.read(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 = await createChangelogRecord(payload);
       const unsignedRecord = {
         header: {
@@ -3385,9 +4222,9 @@ var ChangelogAdapter = class {
           signatures: [{
             keyId: actorId,
             role: "author",
+            notes: "Changelog entry created",
             signature: "placeholder",
-            timestamp: Date.now(),
-            timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+            timestamp: Date.now()
           }]
         },
         payload: validatedPayload
@@ -3400,13 +4237,9 @@ var ChangelogAdapter = class {
         source: "changelog_adapter",
         payload: {
           changelogId: validatedPayload.id,
-          entityId: validatedPayload.entityId,
-          entityType: validatedPayload.entityType,
-          changeType: validatedPayload.changeType,
-          triggeredBy: actorId,
-          riskLevel: validatedPayload.riskLevel,
+          relatedTasks: validatedPayload.relatedTasks,
           title: validatedPayload.title,
-          trigger: validatedPayload.trigger
+          version: validatedPayload.version
         }
       });
       return validatedPayload;
@@ -3418,70 +4251,78 @@ var ChangelogAdapter = class {
     }
   }
   /**
-   * [EARS-9] Gets a specific ChangelogRecord by its ID for historical query.
-   * 
-   * Description: Gets a specific ChangelogRecord by its ID for historical query.
-   * Implementation: Direct read from record store without modifications.
-   * Usage: Invoked by `gitgov changelog show` to display change details.
-   * Returns: ChangelogRecord found or null if it doesn't exist.
+   * [EARS-9] Gets a specific ChangelogRecord by its ID.
    */
   async getChangelog(changelogId) {
     const record = await this.changelogStore.read(changelogId);
     return record ? record.payload : null;
   }
   /**
-   * [EARS-11] Gets all ChangelogRecords associated with a specific entity.
-   * 
-   * Description: Gets all ChangelogRecords associated with a specific entity with optional type filtering.
-   * Implementation: Reads all records and filters by matching entityId, optionally by entityType.
-   * Usage: Invoked by `gitgov changelog list` to display history for any system entity.
-   * Returns: Array of ChangelogRecords filtered for the entity.
+   * [EARS-11] Gets all ChangelogRecords that include a specific task.
    */
-  async getChangelogsByEntity(entityId, entityType) {
+  async getChangelogsByTask(taskId) {
     const ids = await this.changelogStore.list();
     const changelogs = [];
     for (const id of ids) {
       const record = await this.changelogStore.read(id);
-      if (record && record.payload.entityId === entityId) {
-        if (!entityType || record.payload.entityType === entityType) {
-          changelogs.push(record.payload);
-        }
+      if (record && record.payload.relatedTasks.includes(taskId)) {
+        changelogs.push(record.payload);
       }
     }
     return changelogs;
   }
   /**
-   * [EARS-12] Gets all ChangelogRecords in the system for complete indexation.
-   * 
-   * Description: Gets all ChangelogRecords in the system for complete indexation.
-   * Implementation: Complete read from record store without filters.
-   * Usage: Invoked by `gitgov changelog list --all` and MetricsAdapter for activity analysis.
-   * Returns: Complete array of all ChangelogRecords.
+   * [EARS-11, EARS-12, EARS-13] Gets all ChangelogRecords with optional filtering and sorting.
    */
-  async getAllChangelogs() {
+  async getAllChangelogs(options) {
     const ids = await this.changelogStore.list();
-    const changelogs = [];
+    let changelogs = [];
     for (const id of ids) {
       const record = await this.changelogStore.read(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-13] Gets recent ChangelogRecords ordered by timestamp for dashboard and monitoring.
-   * 
-   * Description: Gets recent ChangelogRecords ordered by timestamp for dashboard and monitoring.
-   * Implementation: Reads all records, sorts by timestamp descending and applies limit.
-   * Usage: Invoked by `gitgov changelog list --recent` and dashboard for activity monitoring.
-   * Returns: Array of ChangelogRecords limited and ordered by timestamp.
+   * [EARS-13] Gets recent ChangelogRecords ordered by completedAt.
    */
   async getRecentChangelogs(limit) {
     const allChangelogs = await this.getAllChangelogs();
-    const sortedChangelogs = allChangelogs.sort((a, b) => b.timestamp - a.timestamp);
+    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/metrics_adapter/index.ts
@@ -3555,13 +4396,17 @@ var MetricsAdapter = class {
     }
     const task = taskRecord.payload;
     let feedbacks = [];
+    let allFeedbacks = [];
     let executions = [];
     if (this.feedbackStore) {
       const feedbackIds = await this.feedbackStore.list();
       for (const id of feedbackIds) {
         const record = await this.feedbackStore.read(id);
-        if (record && record.payload.entityId === taskId) {
-          feedbacks.push(record.payload);
+        if (record) {
+          allFeedbacks.push(record.payload);
+          if (record.payload.entityId === taskId) {
+            feedbacks.push(record.payload);
+          }
         }
       }
     }
@@ -3576,7 +4421,13 @@ var MetricsAdapter = class {
     }
     const timeInCurrentStage = this.calculateTimeInCurrentStage(task);
     const stalenessIndex = this.calculateStalenessIndex([task]);
-    const blockingFeedbacks = feedbacks.filter((f) => f.type === "blocking" && f.status === "open").length;
+    const blockingFeedbacks = feedbacks.filter((f) => {
+      if (f.type !== "blocking" || f.status !== "open") return false;
+      const hasResolution = allFeedbacks.some(
+        (resolution) => resolution.entityType === "feedback" && resolution.resolvesFeedbackId === f.id && resolution.status === "resolved"
+      );
+      return !hasResolution;
+    }).length;
     const lastActivity = executions.length > 0 ? Math.max(...executions.map((e) => this.getTimestampFromId(e.id))) : this.getTimestampFromId(task.id);
     const recommendations = [];
     if (timeInCurrentStage > 7) recommendations.push("Task has been stagnant for over 7 days");
@@ -4034,10 +4885,6 @@ var BacklogAdapter = class {
       "feedback.created",
       (event) => this.handleFeedbackCreated(event)
     );
-    this.eventBus.subscribe(
-      "feedback.status.changed",
-      (event) => this.handleFeedbackResolved(event)
-    );
     this.eventBus.subscribe(
       "execution.created",
       (event) => this.handleExecutionCreated(event)
@@ -4069,9 +4916,9 @@ var BacklogAdapter = class {
         signatures: [{
           keyId: actorId,
           role: "author",
+          notes: "Task created",
           signature: "placeholder",
-          timestamp: Date.now(),
-          timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+          timestamp: Date.now()
         }]
       },
       payload: validatedPayload
@@ -4174,9 +5021,9 @@ var BacklogAdapter = class {
     const tempSignature = {
       keyId: actorId,
       role: "approver",
+      notes: "Task approval",
       signature: "temp-signature",
-      timestamp: Date.now(),
-      timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+      timestamp: Date.now()
     };
     const context = {
       task,
@@ -4507,7 +5354,16 @@ ${task.status === "review" ? "[REJECTED]" : "[CANCELLED]"} ${reason} (${(/* @__P
   }
   // ===== PHASE 3: EVENT HANDLERS (NEW IMPLEMENTATION) =====
   /**
-   * [EARS-31] Handles feedback created events - pauses task if blocking
+   * [EARS-31, EARS-33, EARS-34] Handles feedback created events (Immutable Pattern)
+   * 
+   * This handler respects the immutable feedback pattern:
+   * - Case 1: Blocking feedback created → pause task if active/ready
+   * - Case 2: Feedback resolving another feedback → resume task if no more blocks
+   * 
+   * The immutable pattern means:
+   * - Original feedbacks NEVER change status
+   * - Resolution is expressed by creating a NEW feedback pointing to the original
+   * - We detect resolution via: entityType='feedback' + status='resolved' + resolvesFeedbackId
    */
   async handleFeedbackCreated(event) {
     try {
@@ -4517,85 +5373,72 @@ ${task.status === "review" ? "[REJECTED]" : "[CANCELLED]"} ${reason} (${(/* @__P
         processedAt: Date.now(),
         sourceAdapter: "backlog_adapter"
       };
-      if (event.payload.type !== "blocking") {
-        return;
-      }
-      const feedbackRecord = await this.feedbackStore.read(event.payload.feedbackId);
-      if (!feedbackRecord) {
-        console.warn(`Feedback not found: ${event.payload.feedbackId}`);
-        return;
-      }
-      const task = await this.getTask(feedbackRecord.payload.entityId);
-      if (!task) {
-        console.warn(`Task not found for feedback: ${feedbackRecord.payload.entityId}`);
+      if (event.payload.type === "blocking" && event.payload.entityType === "task") {
+        const task = await this.getTask(event.payload.entityId);
+        if (!task) {
+          console.warn(`Task not found for feedback: ${event.payload.entityId}`);
+          return;
+        }
+        if (!["active", "ready"].includes(task.status)) {
+          return;
+        }
+        const updatedTask = { ...task, status: "paused" };
+        const taskRecord = await this.taskStore.read(task.id);
+        if (taskRecord) {
+          const updatedRecord = { ...taskRecord, payload: updatedTask };
+          await this.taskStore.write(updatedRecord);
+          this.eventBus.publish({
+            type: "task.status.changed",
+            timestamp: Date.now(),
+            source: "backlog_adapter",
+            payload: {
+              taskId: task.id,
+              oldStatus: task.status,
+              newStatus: "paused",
+              actorId: "system"
+            },
+            metadata
+          });
+        }
         return;
       }
-      if (!["active", "ready"].includes(task.status)) {
+      if (event.payload.entityType === "feedback" && event.payload.status === "resolved" && event.payload.resolvesFeedbackId) {
+        const originalFeedback = await this.feedbackAdapter.getFeedback(event.payload.resolvesFeedbackId);
+        if (!originalFeedback || originalFeedback.type !== "blocking") {
+          return;
+        }
+        const task = await this.getTask(originalFeedback.entityId);
+        if (!task || task.status !== "paused") {
+          return;
+        }
+        const taskHealth = await this.metricsAdapter.getTaskHealth(task.id);
+        if (taskHealth.blockingFeedbacks > 0) {
+          return;
+        }
+        const updatedTask = { ...task, status: "active" };
+        const taskRecord = await this.taskStore.read(task.id);
+        if (taskRecord) {
+          const updatedRecord = { ...taskRecord, payload: updatedTask };
+          await this.taskStore.write(updatedRecord);
+          this.eventBus.publish({
+            type: "task.status.changed",
+            timestamp: Date.now(),
+            source: "backlog_adapter",
+            payload: {
+              taskId: task.id,
+              oldStatus: "paused",
+              newStatus: "active",
+              actorId: "system"
+            },
+            metadata
+          });
+        }
         return;
       }
-      const updatedTask = { ...task, status: "paused" };
-      const taskRecord = await this.taskStore.read(task.id);
-      if (taskRecord) {
-        const updatedRecord = { ...taskRecord, payload: updatedTask };
-        await this.taskStore.write(updatedRecord);
-        this.eventBus.publish({
-          type: "task.status.changed",
-          timestamp: Date.now(),
-          source: "backlog_adapter",
-          payload: {
-            taskId: task.id,
-            oldStatus: task.status,
-            newStatus: "paused",
-            actorId: "system"
-          },
-          metadata
-        });
-      }
     } catch (error) {
       console.error("Error in handleFeedbackCreated:", error);
     }
   }
-  /**
-   * [EARS-33] Handles feedback resolved events - resumes task if no more blocks
-   */
-  async handleFeedbackResolved(event) {
-    try {
-      if (event.payload.oldStatus !== "open" || event.payload.newStatus !== "resolved") {
-        return;
-      }
-      const feedbackRecord = await this.feedbackStore.read(event.payload.feedbackId);
-      if (!feedbackRecord) {
-        return;
-      }
-      const task = await this.getTask(feedbackRecord.payload.entityId);
-      if (!task || task.status !== "paused") {
-        return;
-      }
-      const taskHealth = await this.metricsAdapter.getTaskHealth(task.id);
-      if (taskHealth.blockingFeedbacks > 0) {
-        return;
-      }
-      const updatedTask = { ...task, status: "active" };
-      const taskRecord = await this.taskStore.read(task.id);
-      if (taskRecord) {
-        const updatedRecord = { ...taskRecord, payload: updatedTask };
-        await this.taskStore.write(updatedRecord);
-        this.eventBus.publish({
-          type: "task.status.changed",
-          timestamp: Date.now(),
-          source: "backlog_adapter",
-          payload: {
-            taskId: task.id,
-            oldStatus: "paused",
-            newStatus: "active",
-            actorId: "system"
-          }
-        });
-      }
-    } catch (error) {
-      console.error("Error in handleFeedbackResolved:", error);
-    }
-  }
   /**
    * [EARS-35] Handles execution created events - transitions ready→active on first execution
    */
@@ -4649,29 +5492,31 @@ ${task.status === "review" ? "[REJECTED]" : "[CANCELLED]"} ${reason} (${(/* @__P
         console.warn(`Changelog not found: ${event.payload.changelogId}`);
         return;
       }
-      if (changelogRecord.payload.entityType !== "task") {
-        return;
-      }
-      const task = await this.getTask(changelogRecord.payload.entityId);
-      if (!task || task.status !== "done") {
+      if (!changelogRecord.payload.relatedTasks || changelogRecord.payload.relatedTasks.length === 0) {
         return;
       }
-      const updatedTask = { ...task, status: "archived" };
-      const taskRecord = await this.taskStore.read(task.id);
-      if (taskRecord) {
-        const updatedRecord = { ...taskRecord, payload: updatedTask };
-        await this.taskStore.write(updatedRecord);
-        this.eventBus.publish({
-          type: "task.status.changed",
-          timestamp: Date.now(),
-          source: "backlog_adapter",
-          payload: {
-            taskId: task.id,
-            oldStatus: "done",
-            newStatus: "archived",
-            actorId: "system"
-          }
-        });
+      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.taskStore.read(task.id);
+        if (taskRecord) {
+          const updatedRecord = { ...taskRecord, payload: updatedTask };
+          await this.taskStore.write(updatedRecord);
+          this.eventBus.publish({
+            type: "task.status.changed",
+            timestamp: Date.now(),
+            source: "backlog_adapter",
+            payload: {
+              taskId: task.id,
+              oldStatus: "done",
+              newStatus: "archived",
+              actorId: "system"
+            }
+          });
+        }
       }
     } catch (error) {
       console.error("Error in handleChangelogCreated:", error);
@@ -4785,9 +5630,9 @@ ${task.status === "review" ? "[REJECTED]" : "[CANCELLED]"} ${reason} (${(/* @__P
         signatures: [{
           keyId: actorId,
           role: "author",
+          notes: "Cycle created",
           signature: "placeholder",
-          timestamp: Date.now(),
-          timestamp_iso: (/* @__PURE__ */ new Date()).toISOString()
+          timestamp: Date.now()
         }]
       },
       payload: validatedPayload
@@ -5146,11 +5991,14 @@ var FileIndexerAdapter = class {
         metrics: { ...systemStatus, ...productivityMetrics, ...collaborationMetrics },
         activityHistory,
         // NUEVO
-        tasks,
+        tasks: tasks.map((t) => t.payload),
+        // Extract payloads for IndexData
         enrichedTasks,
         // NUEVO - Tasks with activity metadata
-        cycles,
-        actors
+        cycles: cycles.map((c) => c.payload),
+        // Extract payloads for IndexData
+        actors: actors.map((a) => a.payload)
+        // Extract payloads for IndexData
       };
       const writeStart = performance.now();
       await this.writeCacheFile(indexData);
@@ -5218,19 +6066,19 @@ var FileIndexerAdapter = class {
       ]);
       recordsScanned = tasks.length + cycles.length;
       for (const task of tasks) {
-        if (!task.id || !task.description) {
+        if (!task.payload.id || !task.payload.description) {
           errors.push({
             type: "schema_violation",
-            recordId: task.id || "unknown",
+            recordId: task.payload.id || "unknown",
             message: "Task missing required fields"
           });
         }
       }
       for (const cycle of cycles) {
-        if (!cycle.id || !cycle.title) {
+        if (!cycle.payload.id || !cycle.payload.title) {
           errors.push({
             type: "schema_violation",
-            recordId: cycle.id || "unknown",
+            recordId: cycle.payload.id || "unknown",
             message: "Cycle missing required fields"
           });
         }
@@ -5303,7 +6151,8 @@ var FileIndexerAdapter = class {
   }
   // ===== HELPER METHODS =====
   /**
-   * Reads all tasks from taskStore
+   * Reads all tasks from taskStore with full metadata (headers + payloads).
+   * Returns complete GitGovTaskRecord objects including signatures for author/lastModifier extraction.
    */
   async readAllTasks() {
     const taskIds = await this.taskStore.list();
@@ -5311,13 +6160,13 @@ var FileIndexerAdapter = class {
     for (const id of taskIds) {
       const record = await this.taskStore.read(id);
       if (record) {
-        tasks.push(record.payload);
+        tasks.push(record);
       }
     }
     return tasks;
   }
   /**
-   * Reads all cycles from cycleStore
+   * Reads all cycles from cycleStore with full metadata.
    */
   async readAllCycles() {
     const cycleIds = await this.cycleStore.list();
@@ -5325,13 +6174,13 @@ var FileIndexerAdapter = class {
     for (const id of cycleIds) {
       const record = await this.cycleStore.read(id);
       if (record) {
-        cycles.push(record.payload);
+        cycles.push(record);
       }
     }
     return cycles;
   }
   /**
-   * Reads all actors from actorStore (graceful degradation)
+   * Reads all actors from actorStore (graceful degradation) with full metadata.
    */
   async readAllActors() {
     if (!this.actorStore) {
@@ -5342,13 +6191,13 @@ var FileIndexerAdapter = class {
     for (const id of actorIds) {
       const record = await this.actorStore.read(id);
       if (record) {
-        actors.push(record.payload);
+        actors.push(record);
       }
     }
     return actors;
   }
   /**
-   * Reads all feedback from feedbackStore (graceful degradation)
+   * Reads all feedback from feedbackStore (graceful degradation) with full metadata.
    */
   async readAllFeedback() {
     if (!this.feedbackStore) {
@@ -5359,13 +6208,13 @@ var FileIndexerAdapter = class {
     for (const id of feedbackIds) {
       const record = await this.feedbackStore.read(id);
       if (record) {
-        feedback.push(record.payload);
+        feedback.push(record);
       }
     }
     return feedback;
   }
   /**
-   * Reads all executions from executionStore (graceful degradation)
+   * Reads all executions from executionStore (graceful degradation) with full metadata.
    */
   async readAllExecutions() {
     if (!this.executionStore) {
@@ -5376,13 +6225,13 @@ var FileIndexerAdapter = class {
     for (const id of executionIds) {
       const record = await this.executionStore.read(id);
       if (record) {
-        executions.push(record.payload);
+        executions.push(record);
       }
     }
     return executions;
   }
   /**
-   * Reads all changelogs from changelogStore (graceful degradation)
+   * Reads all changelogs from changelogStore (graceful degradation) with full metadata.
    */
   async readAllChangelogs() {
     if (!this.changelogStore) {
@@ -5393,7 +6242,7 @@ var FileIndexerAdapter = class {
     for (const id of changelogIds) {
       const record = await this.changelogStore.read(id);
       if (record) {
-        changelogs.push(record.payload);
+        changelogs.push(record);
       }
     }
     return changelogs;
@@ -5446,96 +6295,96 @@ var FileIndexerAdapter = class {
     const events = [];
     try {
       allRecords.tasks.forEach((task) => {
-        const timestampPart = task.id.split("-")[0];
+        const timestampPart = task.payload.id.split("-")[0];
         if (timestampPart) {
           events.push({
             timestamp: parseInt(timestampPart),
             type: "task_created",
-            entityId: task.id,
-            entityTitle: task.title,
-            actorId: "human:camilo",
-            // TODO: Extraer del primer signature
-            metadata: { priority: task.priority, status: task.status }
+            entityId: task.payload.id,
+            entityTitle: task.payload.title,
+            actorId: task.header.signatures[0]?.keyId || "unknown",
+            // Extract from first signature
+            metadata: { priority: task.payload.priority, status: task.payload.status }
           });
         }
       });
       allRecords.cycles.forEach((cycle) => {
-        const timestampPart = cycle.id.split("-")[0];
+        const timestampPart = cycle.payload.id.split("-")[0];
         if (timestampPart) {
           events.push({
             timestamp: parseInt(timestampPart),
             type: "cycle_created",
-            entityId: cycle.id,
-            entityTitle: cycle.title,
-            actorId: "human:scrum-master",
-            // TODO: Extraer del primer signature
-            metadata: { status: cycle.status }
+            entityId: cycle.payload.id,
+            entityTitle: cycle.payload.title,
+            actorId: cycle.header.signatures[0]?.keyId || "unknown",
+            // Extract from first signature
+            metadata: { status: cycle.payload.status }
           });
         }
       });
       allRecords.feedback.forEach((feedback) => {
-        const timestampPart = feedback.id.split("-")[0];
+        const timestampPart = feedback.payload.id.split("-")[0];
         if (timestampPart) {
           const metadata = {
-            type: feedback.type,
-            resolution: feedback.status
+            type: feedback.payload.type,
+            resolution: feedback.payload.status
           };
-          if (feedback.assignee) {
-            metadata.assignee = feedback.assignee;
+          if (feedback.payload.assignee) {
+            metadata.assignee = feedback.payload.assignee;
           }
           const event = {
             timestamp: parseInt(timestampPart),
             type: "feedback_created",
-            entityId: feedback.id,
-            entityTitle: `${feedback.type}: ${feedback.content.slice(0, 40)}...`,
+            entityId: feedback.payload.id,
+            entityTitle: `${feedback.payload.type}: ${feedback.payload.content.slice(0, 40)}...`,
+            actorId: feedback.header.signatures[0]?.keyId || feedback.payload.assignee || "unknown",
             metadata
           };
-          if (feedback.assignee) {
-            event.actorId = feedback.assignee;
-          }
           events.push(event);
         }
       });
       allRecords.changelogs.forEach((changelog) => {
-        const timestampPart = changelog.id.split("-")[0];
+        const timestampPart = changelog.payload.id.split("-")[0];
         if (timestampPart) {
-          events.push({
+          const event = {
             timestamp: parseInt(timestampPart),
             type: "changelog_created",
-            entityId: changelog.id,
-            entityTitle: changelog.title || "Release notes",
-            actorId: "agent:api-dev",
-            // TODO: Extraer del primer signature
-            metadata: { type: changelog.changeType }
-          });
+            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.id.split("-")[0];
+        const timestampPart = execution.payload.id.split("-")[0];
         if (timestampPart) {
           events.push({
             timestamp: parseInt(timestampPart),
             type: "execution_created",
-            entityId: execution.id,
-            entityTitle: execution.title || `Working on ${execution.taskId.slice(-8)}`,
-            actorId: "human:developer",
-            // TODO: Extraer del primer signature
+            entityId: execution.payload.id,
+            entityTitle: execution.payload.title || `Working on ${execution.payload.taskId.slice(-8)}`,
+            actorId: execution.header.signatures[0]?.keyId || "unknown",
+            // Extract from first signature
             metadata: {
-              executionType: execution.type || "development",
-              taskId: execution.taskId
+              executionType: execution.payload.type || "development",
+              taskId: execution.payload.taskId
             }
           });
         }
       });
       allRecords.actors.forEach((actor) => {
-        const timestampPart = actor.id.split("-")[0];
+        const timestampPart = actor.payload.id.split("-")[0];
         if (timestampPart) {
           events.push({
             timestamp: parseInt(timestampPart),
             type: "actor_created",
-            entityId: actor.id,
-            entityTitle: `${actor.displayName} joined (${actor.type})`,
-            metadata: { type: actor.type }
+            entityId: actor.payload.id,
+            entityTitle: `${actor.payload.displayName} joined (${actor.payload.type})`,
+            metadata: { type: actor.payload.type }
           });
         }
       });
@@ -5572,34 +6421,34 @@ var FileIndexerAdapter = class {
       } catch (error) {
       }
       const relatedFeedback = relatedRecords.feedback.filter(
-        (f) => f.entityId === task.id || f.content.includes(task.id)
+        (f) => f.payload.entityId === task.id || f.payload.content.includes(task.id)
       );
       for (const feedback of relatedFeedback) {
-        const feedbackTime = this.getTimestampFromId(feedback.id) * 1e3;
+        const feedbackTime = this.getTimestampFromId(feedback.payload.id) * 1e3;
         if (feedbackTime > lastUpdated) {
           lastUpdated = feedbackTime;
           lastActivityType = "feedback_received";
-          recentActivity = `${feedback.type} feedback: ${feedback.content.slice(0, 30)}...`;
+          recentActivity = `${feedback.payload.type} feedback: ${feedback.payload.content.slice(0, 30)}...`;
         }
       }
-      const relatedExecutions = relatedRecords.executions.filter((e) => e.taskId === task.id);
+      const relatedExecutions = relatedRecords.executions.filter((e) => e.payload.taskId === task.id);
       for (const execution of relatedExecutions) {
-        const executionTime = this.getTimestampFromId(execution.id) * 1e3;
+        const executionTime = this.getTimestampFromId(execution.payload.id) * 1e3;
         if (executionTime > lastUpdated) {
           lastUpdated = executionTime;
           lastActivityType = "execution_added";
-          recentActivity = `Execution: ${execution.title || "Work logged"}`;
+          recentActivity = `Execution: ${execution.payload.title || "Work logged"}`;
         }
       }
       const relatedChangelogs = relatedRecords.changelogs.filter(
-        (c) => c.entityId === task.id || c.references?.tasks?.includes(task.id) || c.description?.includes(task.id)
+        (c) => c.payload.relatedTasks.includes(task.id) || c.payload.description?.includes(task.id)
       );
       for (const changelog of relatedChangelogs) {
-        const changelogTime = this.getTimestampFromId(changelog.id) * 1e3;
+        const changelogTime = this.getTimestampFromId(changelog.payload.id) * 1e3;
         if (changelogTime > lastUpdated) {
           lastUpdated = changelogTime;
           lastActivityType = "changelog_created";
-          recentActivity = `Changelog: ${changelog.title}`;
+          recentActivity = `Changelog: ${changelog.payload.title}`;
         }
       }
       return { lastUpdated, lastActivityType, recentActivity };
@@ -5614,11 +6463,13 @@ var FileIndexerAdapter = class {
   }
   /**
    * [EARS-22] Enrich a TaskRecord with activity metadata
+   * @param task - Full GitGovTaskRecord with header.signatures for author/lastModifier extraction
+   * @param relatedRecords - All related records with full metadata
    */
   async enrichTaskRecord(task, relatedRecords) {
-    const { lastUpdated, lastActivityType, recentActivity } = await this.calculateLastUpdated(task, relatedRecords);
+    const { lastUpdated, lastActivityType, recentActivity } = await this.calculateLastUpdated(task.payload, relatedRecords);
     return {
-      ...task,
+      ...task.payload,
       lastUpdated,
       lastActivityType,
       recentActivity
@@ -6459,7 +7310,6 @@ var workflow_methodology_scrum_default = {
     required_agents: [
       {
         id: "agent:scrum-master",
-        gremio: "operations",
         engine: {
           type: "local",
           entrypoint: "@gitgov/agent-scrum-master"
@@ -6485,7 +7335,6 @@ var workflow_methodology_scrum_default = {
       },
       {
         id: "agent:product-owner-assistant",
-        gremio: "strategy",
         engine: {
           type: "mcp",
           url: "http://localhost:8080/product-owner-mcp"
@@ -6561,11 +7410,19 @@ var WorkflowMethodologyAdapter = class _WorkflowMethodologyAdapter {
     return this.config;
   }
   /**
-   * Gets the guild tag from a task's tags array
+   * Determines which signature group to use for validation.
+   * Checks all available signature groups and returns the first one where
+   * the actor has matching capability roles.
    */
-  getTaskGuild(context) {
-    const guildTag = context.task.tags?.find((tag) => tag.startsWith("guild:"));
-    return guildTag ? guildTag.replace("guild:", "") : "__default__";
+  getApplicableSignatureGroup(signatureRules, actor) {
+    for (const [groupName, ruleSet] of Object.entries(signatureRules)) {
+      if (groupName === "__default__") continue;
+      const hasMatchingRole = actor.roles?.some((role) => ruleSet.capability_roles?.includes(role));
+      if (hasMatchingRole) {
+        return groupName;
+      }
+    }
+    return "__default__";
   }
   /**
    * Determines if a state transition is legal according to the methodology
@@ -6589,7 +7446,6 @@ var WorkflowMethodologyAdapter = class _WorkflowMethodologyAdapter {
    */
   async validateSignature(signature, context) {
     const config = this.getConfig();
-    const guild = this.getTaskGuild(context);
     if (!context.transitionTo) {
       throw new Error('ValidationContext must include "transitionTo" for signature validation.');
     }
@@ -6605,7 +7461,8 @@ var WorkflowMethodologyAdapter = class _WorkflowMethodologyAdapter {
     }
     const signatureRules = transitionConfig.requires.signatures;
     if (!signatureRules) return true;
-    const ruleSet = signatureRules[guild] || signatureRules["__default__"];
+    const signatureGroup = this.getApplicableSignatureGroup(signatureRules, actor);
+    const ruleSet = signatureRules[signatureGroup];
     if (!ruleSet) return false;
     if (signature.role !== ruleSet.role) {
       return false;
@@ -6720,9 +7577,11 @@ __export(factories_exports, {
   createChangelogRecord: () => createChangelogRecord,
   createCycleRecord: () => createCycleRecord,
   createDefaultWorkflowMethodologyConfig: () => createDefaultWorkflowMethodologyConfig,
+  createEmbeddedMetadataRecord: () => createEmbeddedMetadataRecord,
   createExecutionRecord: () => createExecutionRecord,
   createFeedbackRecord: () => createFeedbackRecord,
   createTaskRecord: () => createTaskRecord,
+  createTestSignature: () => createTestSignature,
   createWorkflowMethodologyConfig: () => createWorkflowMethodologyConfig
 });
 
@@ -6962,6 +7821,68 @@ async function createDefaultWorkflowMethodologyConfig() {
   });
 }
 
+// src/factories/embedded_metadata_factory.ts
+function createTestSignature(keyId = "human:test-user", role = "author", notes = "Test signature - unsigned") {
+  const timestamp = Math.floor(Date.now() / 1e3);
+  return {
+    keyId,
+    role,
+    notes,
+    signature: "dGVzdHNpZ25hdHVyZWJhc2U2NGVuY29kZWRkdW1teWZvcnRlc3RpbmdwdXJwb3Nlc29ubHlub3RyZWFsY3J5cHRvZ3JhcGh5PT0=",
+    // Dummy 88-char base64 for testing (matches Ed25519 signature length)
+    timestamp
+  };
+}
+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";
+  if ("displayName" in payload && "publicKey" in payload) return "actor";
+  return "custom";
+}
+async function createEmbeddedMetadataRecord(payload, options = {}) {
+  const inferredType = inferTypeFromPayload(payload);
+  const type = options.header?.type || inferredType;
+  const payloadChecksum = calculatePayloadChecksum(payload);
+  let signatures;
+  if (options.signatures) {
+    signatures = options.signatures;
+  } else if (options.signature?.privateKey) {
+    const keyId = options.signature.keyId || "human:test-user";
+    const role = options.signature.role || "author";
+    const notes = options.signature.notes || "Created via factory";
+    signatures = [signPayload(payload, options.signature.privateKey, keyId, role, notes)];
+  } else {
+    const keyId = options.signature?.keyId || "human:test-user";
+    const role = options.signature?.role || "author";
+    const notes = options.signature?.notes || "Test signature - unsigned";
+    signatures = [createTestSignature(keyId, role, notes)];
+  }
+  const header = {
+    version: "1.0",
+    // Always 1.0 (schema enforces this)
+    type,
+    payloadChecksum,
+    signatures,
+    ...type === "custom" && {
+      schemaUrl: options.header?.schemaUrl,
+      schemaChecksum: options.header?.schemaChecksum
+    }
+  };
+  const embeddedRecord = {
+    header,
+    payload
+  };
+  const validation = validateEmbeddedMetadataDetailed(embeddedRecord);
+  if (!validation.isValid) {
+    throw new DetailedValidationError("EmbeddedMetadataRecord", validation.errors);
+  }
+  return embeddedRecord;
+}
+
 // src/validation/index.ts
 var validation_exports = {};
 __export(validation_exports, {
@@ -7025,9 +7946,11 @@ function generateSubscriptionId() {
 var EventBus = class {
   emitter;
   subscriptions;
+  pendingHandlers;
   constructor() {
     this.emitter = new EventEmitter();
     this.subscriptions = /* @__PURE__ */ new Map();
+    this.pendingHandlers = /* @__PURE__ */ new Set();
     this.emitter.setMaxListeners(100);
   }
   /**
@@ -7058,11 +7981,17 @@ var EventBus = class {
   subscribe(eventType, handler) {
     const subscriptionId = generateSubscriptionId();
     const wrappedHandler = async (event) => {
-      try {
-        await handler(event);
-      } catch (error) {
-        console.error(`Error in event handler for ${eventType}:`, error);
-      }
+      const handlerPromise = (async () => {
+        try {
+          await handler(event);
+        } catch (error) {
+          console.error(`Error in event handler for ${eventType}:`, error);
+        }
+      })();
+      this.pendingHandlers.add(handlerPromise);
+      handlerPromise.finally(() => {
+        this.pendingHandlers.delete(handlerPromise);
+      });
     };
     const subscription = {
       id: subscriptionId,
@@ -7134,6 +8063,43 @@ var EventBus = class {
   subscribeToAll(handler) {
     return this.subscribe("*", handler);
   }
+  /**
+   * Wait for all pending event handlers to complete.
+   * This is primarily useful for testing to ensure event handlers finish before assertions.
+   * 
+   * In production, events are fire-and-forget for performance.
+   * In tests, use this to synchronize and avoid race conditions.
+   * 
+   * @param options - Optional configuration
+   * @param options.timeout - Maximum time to wait in ms (default: 5000)
+   * @returns Promise that resolves when all handlers complete or timeout occurs
+   * 
+   * @example
+   * ```typescript
+   * await feedbackAdapter.create(...);  // publishes event
+   * await eventBus.waitForIdle();       // wait for BacklogAdapter.handleFeedbackCreated()
+   * const task = await backlogAdapter.getTask(taskId);
+   * expect(task.status).toBe('paused'); // now safe to assert
+   * ```
+   */
+  async waitForIdle(options = {}) {
+    const timeout = options.timeout ?? 5e3;
+    const startTime = Date.now();
+    while (this.pendingHandlers.size > 0) {
+      if (Date.now() - startTime > timeout) {
+        const pendingCount = this.pendingHandlers.size;
+        console.warn(`EventBus.waitForIdle() timeout after ${timeout}ms with ${pendingCount} handlers still pending`);
+        break;
+      }
+      if (this.pendingHandlers.size > 0) {
+        await Promise.race([
+          Promise.all(Array.from(this.pendingHandlers)),
+          new Promise((resolve) => setTimeout(resolve, 10))
+          // Re-check every 10ms
+        ]);
+      }
+    }
+  }
 };
 var eventBus = new EventBus();
 function publishEvent(event) {
@@ -7327,14 +8293,17 @@ var RelationshipAnalyzer = class {
     for (const task of tasks) {
       const isEpic = this.isEpicTask(task);
       const title = task.title || "Untitled Task";
-      nodes.push({
+      const node = {
         id: this.generateNodeId(task),
         type: isEpic ? "epic-task" : "task",
         title,
         status: task.status,
-        tags: task.tags,
         originalId: task.id
-      });
+      };
+      if (task.tags) {
+        node.tags = task.tags;
+      }
+      nodes.push(node);
     }
     return nodes;
   }