@gitgov/core 1.3.0 → 1.5.0

package/dist/src/index.d.ts

@@ -23,17 +23,17 @@ interface ActorRecord {
      */
     displayName: string;
     /**
-     * The Ed25519 public key (base64 encoded) for verifying the actor's signatures.
+     * The Ed25519 public key (base64 encoded, 44 characters) for verifying the actor's signatures.
      */
     publicKey: string;
     /**
-     * List of capacity roles defining the actor's skills and permissions.
+     * List of capacity roles defining the actor's skills and permissions. Uses hierarchical format with colons.
      *
      * @minItems 1
      */
     roles: [string, ...string[]];
     /**
-     * The lifecycle status of the actor.
+     * Optional. The lifecycle status of the actor. Defaults to 'active' if not specified.
      */
     status?: 'active' | 'revoked';
     /**
@@ -60,29 +60,109 @@ interface AgentRecord {
      */
     id: string;
     status?: 'active' | 'archived';
-    guild: 'design' | 'intelligence' | 'strategy' | 'operations' | 'quality';
+    /**
+     * Optional list of triggers that activate the agent.
+     * Additional fields are allowed and depend on trigger type:
+     * - webhook triggers: 'event' (event identifier), 'filter' (condition)
+     * - scheduled triggers: 'cron' (cron expression)
+     * - manual triggers: 'command' (example CLI command)
+     *
+     */
     triggers?: {
+        /**
+         * Type of trigger that activates the agent
+         */
         type: 'manual' | 'webhook' | 'scheduled';
+        [k: string]: unknown | undefined;
     }[];
     knowledge_dependencies?: string[];
     prompt_engine_requirements?: {
         roles?: string[];
         skills?: string[];
     };
+    /**
+     * Optional framework-specific or deployment-specific metadata for agent extensions.
+     * Common use cases: framework identification (langchain, google-adk), deployment info (provider, image, region),
+     * cost tracking (cost_per_invocation, currency), tool capabilities, maintainer info.
+     * This field does NOT affect agent execution - it is purely informational.
+     *
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
     engine: {
         type: 'local';
+        /**
+         * Runtime environment (typescript, python, etc.)
+         */
         runtime?: string;
+        /**
+         * Path to the agent entry file
+         */
         entrypoint?: string;
+        /**
+         * Function name to invoke
+         */
         function?: string;
     } | {
         type: 'api';
-        url?: string;
+        /**
+         * HTTP endpoint for the agent
+         */
+        url: string;
         method?: 'POST' | 'GET';
-        auth?: {};
+        /**
+         * Authentication configuration for API requests
+         */
+        auth?: {
+            /**
+             * Authentication type. 'actor-signature' uses the agent's ActorRecord keypair to sign requests.
+             */
+            type?: 'bearer' | 'oauth' | 'api-key' | 'actor-signature';
+            /**
+             * Reference to secret in Secret Manager (for bearer/api-key/oauth auth types)
+             */
+            secret_key?: string;
+            /**
+             * Direct token value (not recommended for production, use secret_key instead)
+             */
+            token?: string;
+            [k: string]: unknown | undefined;
+        };
     } | {
         type: 'mcp';
-        url?: string;
-        auth?: {};
+        /**
+         * MCP server endpoint
+         */
+        url: string;
+        /**
+         * Authentication configuration for MCP server
+         */
+        auth?: {
+            /**
+             * Authentication type. 'actor-signature' uses the agent's ActorRecord keypair to sign requests.
+             */
+            type?: 'bearer' | 'oauth' | 'api-key' | 'actor-signature';
+            /**
+             * Reference to secret in Secret Manager (for bearer/api-key/oauth auth types)
+             */
+            secret_key?: string;
+            /**
+             * Direct token value (not recommended for production, use secret_key instead)
+             */
+            token?: string;
+            [k: string]: unknown | undefined;
+        };
+    } | {
+        type: 'custom';
+        /**
+         * Custom protocol identifier (e.g., 'a2a', 'grpc')
+         */
+        protocol?: string;
+        /**
+         * Protocol-specific configuration
+         */
+        config?: {};
     };
 }
 
@@ -92,7 +172,7 @@ interface AgentRecord {
  * and run 'pnpm compile:types' to regenerate this file.
  */
 /**
- * Canonical schema for changelog records - Enterprise Grade System Historian
+ * Canonical schema for changelog records - aggregates N tasks into 1 release note
  */
 interface ChangelogRecord {
     /**
@@ -100,90 +180,51 @@ interface ChangelogRecord {
      */
     id: string;
     /**
-     * Type of the primary entity that changed
-     */
-    entityType: 'task' | 'cycle' | 'agent' | 'system' | 'configuration';
-    /**
-     * ID of the primary entity that changed
-     */
-    entityId: string;
-    /**
-     * The nature of the change
-     */
-    changeType: 'creation' | 'completion' | 'update' | 'deletion' | 'hotfix';
-    /**
-     * Executive title of the change
+     * Executive title of the deliverable
      */
     title: string;
     /**
-     * Detailed description of the change and its impact
+     * Detailed description of the value delivered, including key decisions and impact
      */
     description: string;
     /**
-     * Unix timestamp in seconds when the change occurred
-     */
-    timestamp: number;
-    /**
-     * How the change was initiated
-     */
-    trigger: 'manual' | 'automated' | 'emergency';
-    /**
-     * Actor or agent ID that initiated the change
-     */
-    triggeredBy: string;
-    /**
-     * Why the change was made
+     * IDs of tasks that compose this deliverable (minimum 1 required)
+     *
+     * @minItems 1
      */
-    reason: string;
+    relatedTasks: [string, ...string[]];
     /**
-     * Risk level of the change
+     * Unix timestamp in seconds when the deliverable was completed
      */
-    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    completedAt: number;
     /**
-     * IDs of systems impacted by this change
+     * Optional IDs of cycles related to this deliverable
      */
-    affectedSystems?: string[];
+    relatedCycles?: string[];
     /**
-     * Number of users impacted by this change
+     * Optional IDs of key execution records related to this work
      */
-    usersAffected?: number;
+    relatedExecutions?: string[];
     /**
-     * Downtime in seconds caused by this change
+     * Optional version or release identifier (e.g., 'v1.0.0', 'sprint-24')
      */
-    downtime?: number;
+    version?: string;
     /**
-     * List of main files that were created or modified
+     * Optional tags for categorization (e.g., 'feature:auth', 'bugfix', 'security')
      */
-    files?: string[];
+    tags?: string[];
     /**
-     * List of git commit hashes related to this change
+     * Optional list of git commit hashes related to this deliverable
      */
     commits?: string[];
     /**
-     * Step-by-step instructions to rollback this change
+     * Optional list of main files that were created or modified
      */
-    rollbackInstructions?: string;
+    files?: string[];
     /**
-     * Cross-references to other GitGovernance records
+     * Optional additional context, decisions, or learnings
      */
-    references?: {
-        /**
-         * IDs of related TaskRecords
-         */
-        tasks?: string[];
-        /**
-         * IDs of related CycleRecords
-         */
-        cycles?: string[];
-        /**
-         * IDs of related ExecutionRecords
-         */
-        executions?: string[];
-        /**
-         * IDs of related ChangelogRecords
-         */
-        changelogs?: string[];
-    };
+    notes?: string;
 }
 
 /**
@@ -192,32 +233,35 @@ interface ChangelogRecord {
  * and run 'pnpm compile:types' to regenerate this file.
  */
 /**
- * Canonical schema for cycle records (sprints, milestones)
+ * Canonical schema for cycle records - strategic grouping of work
  */
 interface CycleRecord {
     /**
-     * Unique identifier for the cycle
+     * Unique identifier for the cycle (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)
      */
     id: string;
     /**
-     * Human-readable title for the cycle (e.g., 'Sprint 24.08')
+     * Human-readable title for the cycle (e.g., 'Sprint 24', 'Auth v2.0', 'Q4 2025')
      */
     title: string;
     /**
      * The lifecycle status of the cycle
      */
     status: 'planning' | 'active' | 'completed' | 'archived';
+    /**
+     * 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)
+     */
     taskIds?: string[];
     /**
-     * An optional array of Cycle IDs that are children of this cycle, allowing for hierarchies.
+     * 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)
      */
     childCycleIds?: string[];
     /**
-     * Optional list of key:value tags for categorization (e.g., 'roadmap:q4', 'team:alpha').
+     * Optional list of key:value tags for categorization (e.g., 'roadmap:q4', 'team:alpha', 'okr:growth').
      */
     tags?: string[];
     /**
-     * An optional description of the cycle's goals and objectives
+     * Optional description of the cycle's goals, objectives, and context
      */
     notes?: string;
 }
@@ -228,35 +272,49 @@ interface CycleRecord {
  * and run 'pnpm compile:types' to regenerate this file.
  */
 /**
- * Canonical schema for execution log records
+ * Canonical schema for execution log records - the universal event stream
  */
 interface ExecutionRecord {
     /**
-     * Unique identifier for the execution log entry
+     * Unique identifier for the execution log entry (10 timestamp + 1 dash + 4 'exec' + 1 dash + max 50 slug = 66 max)
      */
     id: string;
     /**
-     * ID of the parent task
+     * ID of the parent task this execution belongs to (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)
      */
     taskId: string;
     /**
      * Semantic classification of the execution event
      */
-    type?: 'analysis' | 'progress' | 'blocker' | 'completion' | 'info' | 'correction';
+    type: 'analysis' | 'progress' | 'blocker' | 'completion' | 'info' | 'correction';
     /**
-     * Human-readable title for the execution
+     * Human-readable title for the execution (used to generate ID)
      */
-    title?: string;
+    title: string;
     /**
-     * The tangible, verifiable output or result of the execution
+     * The tangible, verifiable output or result of the execution.
+     * This is the "WHAT" - evidence of work or event summary.
+     *
      */
     result: string;
     /**
-     * Optional comments about decisions, blockers or context
+     * Optional narrative, context and decisions behind the execution.
+     * This is the "HOW" and "WHY" - the story behind the result.
+     *
      */
     notes?: string;
     /**
-     * List of URIs to relevant commits, files, or external documents
+     * Optional list of typed references to relevant commits, files, PRs, or external documents.
+     * Should use typed prefixes for clarity and trazabilidad (see execution_protocol_appendix.md):
+     * - commit:     Git commit SHA
+     * - pr:         Pull Request number
+     * - file:       File path (relative to repo root)
+     * - url:        External URL
+     * - issue:      GitHub Issue number
+     * - task:       TaskRecord ID
+     * - exec:       ExecutionRecord ID (for corrections or dependencies)
+     * - changelog:  ChangelogRecord ID
+     *
      */
     references?: string[];
 }
@@ -267,7 +325,7 @@ interface ExecutionRecord {
  * and run 'pnpm compile:types' to regenerate this file.
  */
 /**
- * Canonical schema for feedback records
+ * Canonical schema for feedback records - structured conversation about work
  */
 interface FeedbackRecord {
     /**
@@ -277,9 +335,16 @@ interface FeedbackRecord {
     /**
      * The type of entity this feedback refers to
      */
-    entityType: 'task' | 'execution' | 'changelog' | 'feedback';
+    entityType: 'task' | 'execution' | 'changelog' | 'feedback' | 'cycle';
     /**
-     * The ID of the entity this feedback refers to
+     * The ID of the entity this feedback refers to.
+     * Must match the pattern for its entityType:
+     * - task: ^\d{10}-task-[a-z0-9-]{1,50}$
+     * - execution: ^\d{10}-exec-[a-z0-9-]{1,50}$
+     * - changelog: ^\d{10}-changelog-[a-z0-9-]{1,50}$
+     * - feedback: ^\d{10}-feedback-[a-z0-9-]{1,50}$
+     * - cycle: ^\d{10}-cycle-[a-z0-9-]{1,50}$
+     *
      */
     entityId: string;
     /**
@@ -287,19 +352,22 @@ interface FeedbackRecord {
      */
     type: 'blocking' | 'suggestion' | 'question' | 'approval' | 'clarification' | 'assignment';
     /**
-     * The lifecycle status of the feedback
+     * The lifecycle status of the feedback.
+     * Note: FeedbackRecords are immutable. To change status, create a new feedback
+     * that references this one using entityType: "feedback" and resolvesFeedbackId.
+     *
      */
     status: 'open' | 'acknowledged' | 'resolved' | 'wontfix';
     /**
-     * The content of the feedback
+     * The content of the feedback. Reduced from 10000 to 5000 chars for practical use.
      */
     content: string;
     /**
-     * The Actor ID of the agent responsible for addressing the feedback
+     * Optional. The Actor ID responsible for addressing the feedback (e.g., 'human:maria', 'agent:camilo:cursor')
      */
     assignee?: string;
     /**
-     * The ID of another feedback record that this one resolves or responds to
+     * Optional. The ID of another feedback record that this one resolves or responds to
      */
     resolvesFeedbackId?: string;
 }
@@ -314,7 +382,7 @@ interface FeedbackRecord {
  */
 interface TaskRecord {
     /**
-     * Unique identifier for the task
+     * Unique identifier for the task (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)
      */
     id: string;
     /**
@@ -322,7 +390,7 @@ interface TaskRecord {
      */
     title: string;
     /**
-     * Optional. The IDs of the strategic cycles this task belongs to.
+     * Optional. The IDs of the strategic cycles this task belongs to. (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)
      */
     cycleIds?: string[];
     /**
@@ -338,9 +406,9 @@ interface TaskRecord {
      */
     description: string;
     /**
-     * List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer'). Can be an empty array.
+     * Optional. List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer').
      */
-    tags: string[];
+    tags?: string[];
     /**
      * Valid links or files, when mentioned
      */
@@ -400,7 +468,7 @@ interface WorkflowMethodologyRecord {
                  */
                 event?: string;
                 /**
-                 * Signature requirements keyed by guild
+                 * Signature requirements keyed by role (e.g., 'approver:quality', 'developer:backend')
                  */
                 signatures?: {
                     [k: string]: {
@@ -501,46 +569,7 @@ interface WorkflowMethodologyRecord {
          * List of agents required for this methodology
          */
         required_agents?: {
-            /**
-             * Unique agent identifier
-             */
-            id: string;
-            /**
-             * Agent guild classification
-             */
-            gremio: 'design' | 'intelligence' | 'strategy' | 'operations' | 'quality';
-            engine: {
-                type: 'local';
-                runtime?: string;
-                entrypoint?: string;
-                function?: string;
-            } | {
-                type: 'api';
-                url?: string;
-                method?: 'POST' | 'GET';
-                auth?: {};
-            } | {
-                type: 'mcp';
-                url?: string;
-                auth?: {};
-            };
-            /**
-             * Event triggers for this agent
-             */
-            triggers?: {
-                /**
-                 * Event that triggers the agent
-                 */
-                event: string;
-                /**
-                 * Action the agent should perform
-                 */
-                action: string;
-            }[];
-            /**
-             * Knowledge files this agent depends on
-             */
-            knowledge_dependencies?: string[];
+            [k: string]: unknown | undefined;
         }[];
         /**
          * Automation rules linking triggers to agents
@@ -600,53 +629,49 @@ type EmbeddedMetadataRecord$1 = {
         signatures: [
             {
                 /**
-                 * The Actor ID of the signer.
+                 * The Actor ID of the signer (must match ActorRecord.id pattern).
                  */
                 keyId: string;
                 /**
-                 * The context role of the signature (e.g., 'author').
+                 * The context role of the signature (e.g., 'author', 'reviewer', 'auditor', or 'custom:*').
                  */
                 role: string;
                 /**
-                 * The Ed25519 signature (base64 encoded) of the signature digest.
+                 * Human-readable note from the signer. Part of the signature digest.
+                 */
+                notes: string;
+                /**
+                 * The Ed25519 signature (base64 encoded, 88 chars with padding) of the signature digest.
                  */
                 signature: string;
                 /**
                  * Unix timestamp of the signature.
                  */
                 timestamp: number;
-                /**
-                 * ISO 8601 timestamp of the signature.
-                 */
-                timestamp_iso: string;
             },
             ...{
                 /**
-                 * The Actor ID of the signer.
+                 * The Actor ID of the signer (must match ActorRecord.id pattern).
                  */
                 keyId: string;
                 /**
-                 * The context role of the signature (e.g., 'author').
+                 * The context role of the signature (e.g., 'author', 'reviewer', 'auditor', or 'custom:*').
                  */
                 role: string;
                 /**
-                 * The Ed25519 signature (base64 encoded) of the signature digest.
+                 * Human-readable note from the signer. Part of the signature digest.
+                 */
+                notes: string;
+                /**
+                 * The Ed25519 signature (base64 encoded, 88 chars with padding) of the signature digest.
                  */
                 signature: string;
                 /**
                  * Unix timestamp of the signature.
                  */
                 timestamp: number;
-                /**
-                 * ISO 8601 timestamp of the signature.
-                 */
-                timestamp_iso: string;
             }[]
         ];
-        /**
-         * A human-readable audit stamp (e.g., from gitgov audit).
-         */
-        audit?: string;
     };
     /**
      * The specific record data, validated against the schema defined by header.type.
@@ -661,13 +686,18 @@ type EmbeddedMetadataRecord$1 = {
  * This is hardcoded solution but avoids duplication and uses the generated type as source of truth.
  */
 type Signature = EmbeddedMetadataRecord$1['header']['signatures'][0];
+/**
+ * Extract Header type from the auto-generated base type.
+ * This is the complete header structure for EmbeddedMetadata.
+ */
+type EmbeddedMetadataHeader = EmbeddedMetadataRecord$1['header'];
 /**
  * Generic version of EmbeddedMetadataRecord that accepts any payload type T.
  * This extends the auto-generated base type but makes the payload generic.
  * We need to explicitly preserve the header structure due to the index signature in the base type.
  */
 type EmbeddedMetadataRecord<T extends GitGovRecordPayload> = {
-    header: EmbeddedMetadataRecord$1['header'];
+    header: EmbeddedMetadataHeader;
     payload: T;
 };
 
@@ -690,6 +720,21 @@ type GitGovRecordPayload = ActorRecord | AgentRecord | CycleRecord | TaskRecord
  * The canonical type for any record in GitGovernance, wrapping a payload with metadata.
  */
 type GitGovRecord = EmbeddedMetadataRecord<GitGovRecordPayload>;
+/**
+ * Specific GitGov record types with full metadata (header + payload).
+ * These types provide clean, type-safe access to records with their signatures and checksums.
+ *
+ * @example
+ * const taskRecord: GitGovTaskRecord = await taskStore.read(taskId);
+ * const authorId = taskRecord.header.signatures[0].keyId;
+ */
+type GitGovTaskRecord = EmbeddedMetadataRecord<TaskRecord>;
+type GitGovCycleRecord = EmbeddedMetadataRecord<CycleRecord>;
+type GitGovFeedbackRecord = EmbeddedMetadataRecord<FeedbackRecord>;
+type GitGovExecutionRecord = EmbeddedMetadataRecord<ExecutionRecord>;
+type GitGovChangelogRecord = EmbeddedMetadataRecord<ChangelogRecord>;
+type GitGovActorRecord = EmbeddedMetadataRecord<ActorRecord>;
+type GitGovAgentRecord = EmbeddedMetadataRecord<AgentRecord>;
 type ActorPayload = Partial<ActorRecord>;
 type AgentPayload = Partial<AgentRecord>;
 type CyclePayload = Partial<CycleRecord>;
@@ -715,22 +760,30 @@ type index$j_ChangelogRecord = ChangelogRecord;
 type index$j_CustomRecord = CustomRecord;
 type index$j_CyclePayload = CyclePayload;
 type index$j_CycleRecord = CycleRecord;
+type index$j_EmbeddedMetadataHeader = EmbeddedMetadataHeader;
 type index$j_EmbeddedMetadataRecord<T extends GitGovRecordPayload> = EmbeddedMetadataRecord<T>;
 type index$j_ExecutionPayload = ExecutionPayload;
 type index$j_ExecutionRecord = ExecutionRecord;
 type index$j_FeedbackPayload = FeedbackPayload;
 type index$j_FeedbackRecord = FeedbackRecord;
+type index$j_GitGovActorRecord = GitGovActorRecord;
+type index$j_GitGovAgentRecord = GitGovAgentRecord;
+type index$j_GitGovChangelogRecord = GitGovChangelogRecord;
+type index$j_GitGovCycleRecord = GitGovCycleRecord;
 type index$j_GitGovError = GitGovError;
 declare const index$j_GitGovError: typeof GitGovError;
+type index$j_GitGovExecutionRecord = GitGovExecutionRecord;
+type index$j_GitGovFeedbackRecord = GitGovFeedbackRecord;
 type index$j_GitGovRecord = GitGovRecord;
 type index$j_GitGovRecordPayload = GitGovRecordPayload;
 type index$j_GitGovRecordType = GitGovRecordType;
+type index$j_GitGovTaskRecord = GitGovTaskRecord;
 type index$j_Signature = Signature;
 type index$j_TaskPayload = TaskPayload;
 type index$j_TaskRecord = TaskRecord;
 type index$j_WorkflowMethodologyRecord = WorkflowMethodologyRecord;
 declare namespace index$j {
-  export { type index$j_ActorPayload as ActorPayload, type index$j_ActorRecord as ActorRecord, type index$j_AgentPayload as AgentPayload, type index$j_AgentRecord as AgentRecord, type index$j_ChangelogPayload as ChangelogPayload, type index$j_ChangelogRecord as ChangelogRecord, type index$j_CustomRecord as CustomRecord, type index$j_CyclePayload as CyclePayload, type index$j_CycleRecord as CycleRecord, type index$j_EmbeddedMetadataRecord as EmbeddedMetadataRecord, type index$j_ExecutionPayload as ExecutionPayload, type index$j_ExecutionRecord as ExecutionRecord, type index$j_FeedbackPayload as FeedbackPayload, type index$j_FeedbackRecord as FeedbackRecord, index$j_GitGovError as GitGovError, type index$j_GitGovRecord as GitGovRecord, type index$j_GitGovRecordPayload as GitGovRecordPayload, type index$j_GitGovRecordType as GitGovRecordType, type index$j_Signature as Signature, type index$j_TaskPayload as TaskPayload, type index$j_TaskRecord as TaskRecord, type index$j_WorkflowMethodologyRecord as WorkflowMethodologyRecord };
+  export { type index$j_ActorPayload as ActorPayload, type index$j_ActorRecord as ActorRecord, type index$j_AgentPayload as AgentPayload, type index$j_AgentRecord as AgentRecord, type index$j_ChangelogPayload as ChangelogPayload, type index$j_ChangelogRecord as ChangelogRecord, type index$j_CustomRecord as CustomRecord, type index$j_CyclePayload as CyclePayload, type index$j_CycleRecord as CycleRecord, type index$j_EmbeddedMetadataHeader as EmbeddedMetadataHeader, type index$j_EmbeddedMetadataRecord as EmbeddedMetadataRecord, type index$j_ExecutionPayload as ExecutionPayload, type index$j_ExecutionRecord as ExecutionRecord, type index$j_FeedbackPayload as FeedbackPayload, type index$j_FeedbackRecord as FeedbackRecord, type index$j_GitGovActorRecord as GitGovActorRecord, type index$j_GitGovAgentRecord as GitGovAgentRecord, type index$j_GitGovChangelogRecord as GitGovChangelogRecord, type index$j_GitGovCycleRecord as GitGovCycleRecord, index$j_GitGovError as GitGovError, type index$j_GitGovExecutionRecord as GitGovExecutionRecord, type index$j_GitGovFeedbackRecord as GitGovFeedbackRecord, type index$j_GitGovRecord as GitGovRecord, type index$j_GitGovRecordPayload as GitGovRecordPayload, type index$j_GitGovRecordType as GitGovRecordType, type index$j_GitGovTaskRecord as GitGovTaskRecord, type index$j_Signature as Signature, type index$j_TaskPayload as TaskPayload, type index$j_TaskRecord as TaskRecord, type index$j_WorkflowMethodologyRecord as WorkflowMethodologyRecord };
 }
 
 type StorablePayload = Exclude<GitGovRecordPayload, CustomRecord>;
@@ -847,26 +900,16 @@ type ExecutionCreatedEvent = BaseEvent & {
 
 type FeedbackCreatedEvent = BaseEvent & {
     type: 'feedback.created';
-    payload: Pick<FeedbackRecord, 'entityType' | 'entityId' | 'type' | 'status' | 'content' | 'assignee'> & {
-        feedbackId: string;
-        triggeredBy: string;
-    };
-};
-type FeedbackStatusChangedEvent = BaseEvent & {
-    type: 'feedback.status.changed';
-    payload: Pick<FeedbackRecord, 'assignee'> & {
+    payload: Pick<FeedbackRecord, 'entityType' | 'entityId' | 'type' | 'status' | 'content' | 'assignee' | 'resolvesFeedbackId'> & {
         feedbackId: string;
-        oldStatus: FeedbackRecord['status'];
-        newStatus: FeedbackRecord['status'];
         triggeredBy: string;
     };
 };
 
 type ChangelogCreatedEvent = BaseEvent & {
     type: 'changelog.created';
-    payload: Pick<ChangelogRecord, 'entityType' | 'entityId' | 'changeType' | 'riskLevel' | 'title' | 'trigger'> & {
+    payload: Pick<ChangelogRecord, 'relatedTasks' | 'title' | 'version'> & {
         changelogId: string;
-        triggeredBy: string;
     };
 };
 
@@ -887,7 +930,7 @@ type ActorRevokedEvent = BaseEvent & {
 };
 type AgentRegisteredEvent = BaseEvent & {
     type: 'identity.agent.registered';
-    payload: Pick<AgentRecord, 'guild' | 'engine'> & {
+    payload: Pick<AgentRecord, 'engine'> & {
         agentId: string;
         correspondingActorId: string;
     };
@@ -904,7 +947,7 @@ type SystemDailyTickEvent = BaseEvent & {
 /**
  * Union type of all possible events
  */
-type GitGovEvent = TaskCreatedEvent | TaskStatusChangedEvent | CycleCreatedEvent | CycleStatusChangedEvent | ExecutionCreatedEvent | FeedbackCreatedEvent | FeedbackStatusChangedEvent | ChangelogCreatedEvent | ActorCreatedEvent | ActorRevokedEvent | AgentRegisteredEvent | SystemDailyTickEvent;
+type GitGovEvent = TaskCreatedEvent | TaskStatusChangedEvent | CycleCreatedEvent | CycleStatusChangedEvent | ExecutionCreatedEvent | FeedbackCreatedEvent | ChangelogCreatedEvent | ActorCreatedEvent | ActorRevokedEvent | AgentRegisteredEvent | SystemDailyTickEvent;
 /**
  * Event handler function type
  */
@@ -927,22 +970,73 @@ type EventSubscription = {
 };
 /**
  * Activity Event for IndexerAdapter activity tracking
+ * Uses discriminated unions for type-safe metadata per event type
  */
 type ActivityEvent = {
     timestamp: number;
-    type: "task_created" | "cycle_created" | "feedback_created" | "changelog_created" | "execution_created" | "actor_created" | "agent_registered";
+    type: "task_created";
     entityId: string;
     entityTitle: string;
     actorId?: string;
     metadata?: {
         priority?: string;
         status?: string;
+    };
+} | {
+    timestamp: number;
+    type: "cycle_created";
+    entityId: string;
+    entityTitle: string;
+    actorId?: string;
+    metadata?: {
+        status?: string;
+    };
+} | {
+    timestamp: number;
+    type: "feedback_created";
+    entityId: string;
+    entityTitle: string;
+    actorId?: string;
+    metadata?: {
         type?: string;
         assignee?: string;
         resolution?: string;
+    };
+} | {
+    timestamp: number;
+    type: "changelog_created";
+    entityId: string;
+    entityTitle: string;
+    actorId?: string;
+    metadata?: {
+        version?: string;
+    };
+} | {
+    timestamp: number;
+    type: "execution_created";
+    entityId: string;
+    entityTitle: string;
+    actorId?: string;
+    metadata?: {
         executionType?: string;
         taskId?: string;
     };
+} | {
+    timestamp: number;
+    type: "actor_created";
+    entityId: string;
+    entityTitle: string;
+    actorId?: string;
+    metadata?: {
+        type?: string;
+    };
+} | {
+    timestamp: number;
+    type: "agent_registered";
+    entityId: string;
+    entityTitle: string;
+    actorId?: string;
+    metadata?: Record<string, never>;
 };
 
 /**
@@ -969,6 +1063,12 @@ interface IEventStream {
      * Clear all subscriptions (for testing/cleanup)
      */
     clearSubscriptions(): void;
+    /**
+     * Wait for all pending event handlers to complete (for testing)
+     */
+    waitForIdle(options?: {
+        timeout?: number;
+    }): Promise<void>;
 }
 /**
  * Local EventBus implementation using Node.js EventEmitter
@@ -985,6 +1085,7 @@ interface IEventStream {
 declare class EventBus implements IEventStream {
     private emitter;
     private subscriptions;
+    private pendingHandlers;
     constructor();
     /**
      * Publish an event to all subscribers
@@ -1038,6 +1139,28 @@ declare class EventBus implements IEventStream {
      * @returns EventSubscription object
      */
     subscribeToAll(handler: EventHandler<BaseEvent>): EventSubscription;
+    /**
+     * 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
+     * ```
+     */
+    waitForIdle(options?: {
+        timeout?: number;
+    }): Promise<void>;
 }
 /**
  * Singleton instance for application-wide event bus usage
@@ -1069,7 +1192,6 @@ type index$h_EventMetadata = EventMetadata;
 type index$h_EventSubscription = EventSubscription;
 type index$h_ExecutionCreatedEvent = ExecutionCreatedEvent;
 type index$h_FeedbackCreatedEvent = FeedbackCreatedEvent;
-type index$h_FeedbackStatusChangedEvent = FeedbackStatusChangedEvent;
 type index$h_GitGovEvent = GitGovEvent;
 type index$h_IEventStream = IEventStream;
 type index$h_SystemDailyTickEvent = SystemDailyTickEvent;
@@ -1079,7 +1201,7 @@ declare const index$h_eventBus: typeof eventBus;
 declare const index$h_publishEvent: typeof publishEvent;
 declare const index$h_subscribeToEvent: typeof subscribeToEvent;
 declare namespace index$h {
-  export { type index$h_ActivityEvent as ActivityEvent, type index$h_ActorCreatedEvent as ActorCreatedEvent, type index$h_ActorRevokedEvent as ActorRevokedEvent, type index$h_AgentRegisteredEvent as AgentRegisteredEvent, type index$h_BaseEvent as BaseEvent, type index$h_ChangelogCreatedEvent as ChangelogCreatedEvent, type index$h_CycleCreatedEvent as CycleCreatedEvent, type index$h_CycleStatusChangedEvent as CycleStatusChangedEvent, index$h_EventBus as EventBus, type index$h_EventHandler as EventHandler, type index$h_EventMetadata as EventMetadata, type index$h_EventSubscription as EventSubscription, type index$h_ExecutionCreatedEvent as ExecutionCreatedEvent, type index$h_FeedbackCreatedEvent as FeedbackCreatedEvent, type index$h_FeedbackStatusChangedEvent as FeedbackStatusChangedEvent, type index$h_GitGovEvent as GitGovEvent, type index$h_IEventStream as IEventStream, type index$h_SystemDailyTickEvent as SystemDailyTickEvent, type index$h_TaskCreatedEvent as TaskCreatedEvent, type index$h_TaskStatusChangedEvent as TaskStatusChangedEvent, index$h_eventBus as eventBus, index$h_publishEvent as publishEvent, index$h_subscribeToEvent as subscribeToEvent };
+  export { type index$h_ActivityEvent as ActivityEvent, type index$h_ActorCreatedEvent as ActorCreatedEvent, type index$h_ActorRevokedEvent as ActorRevokedEvent, type index$h_AgentRegisteredEvent as AgentRegisteredEvent, type index$h_BaseEvent as BaseEvent, type index$h_ChangelogCreatedEvent as ChangelogCreatedEvent, type index$h_CycleCreatedEvent as CycleCreatedEvent, type index$h_CycleStatusChangedEvent as CycleStatusChangedEvent, index$h_EventBus as EventBus, type index$h_EventHandler as EventHandler, type index$h_EventMetadata as EventMetadata, type index$h_EventSubscription as EventSubscription, type index$h_ExecutionCreatedEvent as ExecutionCreatedEvent, type index$h_FeedbackCreatedEvent as FeedbackCreatedEvent, type index$h_GitGovEvent as GitGovEvent, type index$h_IEventStream as IEventStream, type index$h_SystemDailyTickEvent as SystemDailyTickEvent, type index$h_TaskCreatedEvent as TaskCreatedEvent, type index$h_TaskStatusChangedEvent as TaskStatusChangedEvent, index$h_eventBus as eventBus, index$h_publishEvent as publishEvent, index$h_subscribeToEvent as subscribeToEvent };
 }
 
 /**
@@ -1178,15 +1300,22 @@ interface FeedbackAdapterDependencies {
 /**
  * FeedbackAdapter Interface - The Communication Facilitator
  */
+/**
+ * FeedbackThread structure for conversation trees
+ */
+interface FeedbackThread {
+    feedback: FeedbackRecord;
+    responses: FeedbackThread[];
+}
 interface IFeedbackAdapter {
     /**
      * Creates a new FeedbackRecord.
      */
     create(payload: Partial<FeedbackRecord>, actorId: string): Promise<FeedbackRecord>;
     /**
-     * Resolves an existing FeedbackRecord.
+     * Helper: Creates a new feedback that "resolves" another (immutable pattern).
      */
-    resolve(feedbackId: string, actorId: string): Promise<FeedbackRecord>;
+    resolve(feedbackId: string, actorId: string, content?: string): Promise<FeedbackRecord>;
     /**
      * Gets a specific FeedbackRecord by its ID.
      */
@@ -1199,6 +1328,10 @@ interface IFeedbackAdapter {
      * Gets all FeedbackRecords in the system.
      */
     getAllFeedback(): Promise<FeedbackRecord[]>;
+    /**
+     * Builds the complete conversation tree for a feedback.
+     */
+    getFeedbackThread(feedbackId: string, maxDepth?: number): Promise<FeedbackThread>;
 }
 /**
  * FeedbackAdapter - The Communication Facilitator
@@ -1212,25 +1345,25 @@ declare class FeedbackAdapter implements IFeedbackAdapter {
     private eventBus;
     constructor(dependencies: FeedbackAdapterDependencies);
     /**
-     * [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.
      */
     create(payload: Partial<FeedbackRecord>, actorId: string): Promise<FeedbackRecord>;
     /**
-     * [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.
+     * 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.
      */
-    resolve(feedbackId: string, actorId: string): Promise<FeedbackRecord>;
+    resolve(feedbackId: string, actorId: string, content?: string): Promise<FeedbackRecord>;
     /**
-     * [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.
@@ -1239,31 +1372,45 @@ declare class FeedbackAdapter implements IFeedbackAdapter {
      */
     getFeedback(feedbackId: string): Promise<FeedbackRecord | 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.
      */
     getFeedbackByEntity(entityId: string): Promise<FeedbackRecord[]>;
     /**
-     * [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.
      */
     getAllFeedback(): Promise<FeedbackRecord[]>;
+    /**
+     * [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.
+     */
+    getFeedbackThread(feedbackId: string, maxDepth?: number): Promise<FeedbackThread>;
+    /**
+     * Private helper: Recursively builds conversation thread.
+     */
+    private buildThread;
 }
 
 type index$f_FeedbackAdapter = FeedbackAdapter;
 declare const index$f_FeedbackAdapter: typeof FeedbackAdapter;
 type index$f_FeedbackAdapterDependencies = FeedbackAdapterDependencies;
+type index$f_FeedbackThread = FeedbackThread;
 type index$f_IFeedbackAdapter = IFeedbackAdapter;
 declare namespace index$f {
-  export { index$f_FeedbackAdapter as FeedbackAdapter, type index$f_FeedbackAdapterDependencies as FeedbackAdapterDependencies, type index$f_IFeedbackAdapter as IFeedbackAdapter };
+  export { index$f_FeedbackAdapter as FeedbackAdapter, type index$f_FeedbackAdapterDependencies as FeedbackAdapterDependencies, type index$f_FeedbackThread as FeedbackThread, type index$f_IFeedbackAdapter as IFeedbackAdapter };
 }
 
 /**
@@ -1359,6 +1506,16 @@ declare namespace index$e {
   export { index$e_ExecutionAdapter as ExecutionAdapter, type index$e_ExecutionAdapterDependencies as ExecutionAdapterDependencies, type index$e_IExecutionAdapter as IExecutionAdapter };
 }
 
+/**
+ * Options for filtering and sorting changelog lists
+ */
+interface ChangelogListOptions {
+    tags?: string[];
+    version?: string;
+    limit?: number;
+    sortBy?: 'completedAt' | 'title';
+    sortOrder?: 'asc' | 'desc';
+}
 /**
  * ChangelogAdapter Dependencies - Facade + Dependency Injection Pattern
  */
@@ -1370,11 +1527,11 @@ interface ChangelogAdapterDependencies {
     cycleStore?: RecordStore<CycleRecord>;
 }
 /**
- * ChangelogAdapter Interface - The Enterprise Historian
+ * ChangelogAdapter Interface - Release Notes & Deliverables Historian
  */
 interface IChangelogAdapter {
     /**
-     * Records a significant change in any system entity.
+     * Records a deliverable/release note aggregating multiple tasks.
      */
     create(payload: Partial<ChangelogRecord>, actorId: string): Promise<ChangelogRecord>;
     /**
@@ -1382,23 +1539,23 @@ interface IChangelogAdapter {
      */
     getChangelog(changelogId: string): Promise<ChangelogRecord | null>;
     /**
-     * Gets all ChangelogRecords for a specific entity.
+     * Gets all ChangelogRecords for a specific task.
      */
-    getChangelogsByEntity(entityId: string, entityType?: string): Promise<ChangelogRecord[]>;
+    getChangelogsByTask(taskId: string): Promise<ChangelogRecord[]>;
     /**
-     * Gets all ChangelogRecords in the system.
+     * Gets all ChangelogRecords in the system with optional filtering.
      */
-    getAllChangelogs(): Promise<ChangelogRecord[]>;
+    getAllChangelogs(options?: ChangelogListOptions): Promise<ChangelogRecord[]>;
     /**
-     * Gets recent ChangelogRecords ordered by timestamp.
+     * Gets recent ChangelogRecords ordered by completedAt.
      */
     getRecentChangelogs(limit: number): Promise<ChangelogRecord[]>;
 }
 /**
- * ChangelogAdapter - The Enterprise Historian
+ * ChangelogAdapter - Release Notes & Deliverables Historian
  *
- * Implements Facade + Dependency Injection Pattern for testeable and configurable orchestration.
- * Acts as Mediator between enterprise changelog system and multi-entity data stores.
+ * Protocol v2: Aggregates N tasks into 1 release note/deliverable.
+ * Focus: Executive communication of delivered value.
  */
 declare class ChangelogAdapter implements IChangelogAdapter {
     private changelogStore;
@@ -1408,58 +1565,44 @@ declare class ChangelogAdapter implements IChangelogAdapter {
     private cycleStore;
     constructor(dependencies: ChangelogAdapterDependencies);
     /**
-     * [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.
      */
     create(payload: Partial<ChangelogRecord>, actorId: string): Promise<ChangelogRecord>;
     /**
-     * [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.
      */
     getChangelog(changelogId: string): Promise<ChangelogRecord | 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.
      */
-    getChangelogsByEntity(entityId: string, entityType?: string): Promise<ChangelogRecord[]>;
+    getChangelogsByTask(taskId: string): Promise<ChangelogRecord[]>;
     /**
-     * [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.
      */
-    getAllChangelogs(): Promise<ChangelogRecord[]>;
+    getAllChangelogs(options?: ChangelogListOptions): Promise<ChangelogRecord[]>;
     /**
-     * [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.
      */
     getRecentChangelogs(limit: number): Promise<ChangelogRecord[]>;
+    /**
+     * Legacy method for backwards compatibility - maps to getChangelogsByTask
+     * @deprecated Use getChangelogsByTask instead
+     */
+    getChangelogsByEntity(entityId: string, _entityType?: string): Promise<ChangelogRecord[]>;
 }
 
 type index$d_ChangelogAdapter = ChangelogAdapter;
 declare const index$d_ChangelogAdapter: typeof ChangelogAdapter;
 type index$d_ChangelogAdapterDependencies = ChangelogAdapterDependencies;
+type index$d_ChangelogListOptions = ChangelogListOptions;
 type index$d_IChangelogAdapter = IChangelogAdapter;
 declare namespace index$d {
-  export { index$d_ChangelogAdapter as ChangelogAdapter, type index$d_ChangelogAdapterDependencies as ChangelogAdapterDependencies, type index$d_IChangelogAdapter as IChangelogAdapter };
+  export { index$d_ChangelogAdapter as ChangelogAdapter, type index$d_ChangelogAdapterDependencies as ChangelogAdapterDependencies, type index$d_ChangelogListOptions as ChangelogListOptions, type index$d_IChangelogAdapter as IChangelogAdapter };
 }
 
 /**
@@ -1701,9 +1844,11 @@ declare class WorkflowMethodologyAdapter implements IWorkflowMethodology {
      */
     private getConfig;
     /**
-     * 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.
      */
-    private getTaskGuild;
+    private getApplicableSignatureGroup;
     /**
      * Determines if a state transition is legal according to the methodology
      */
@@ -1776,7 +1921,6 @@ interface IBacklogAdapter {
     moveTasksBetweenCycles(targetCycleId: string, taskIds: string[], sourceCycleId: string): Promise<void>;
     getTasksAssignedToActor(actorId: string): Promise<TaskRecord[]>;
     handleFeedbackCreated(event: FeedbackCreatedEvent): Promise<void>;
-    handleFeedbackResolved(event: FeedbackStatusChangedEvent): Promise<void>;
     handleExecutionCreated(event: ExecutionCreatedEvent): Promise<void>;
     handleChangelogCreated(event: ChangelogCreatedEvent): Promise<void>;
     handleCycleStatusChanged(event: CycleStatusChangedEvent): Promise<void>;
@@ -1880,13 +2024,18 @@ declare class BacklogAdapter implements IBacklogAdapter {
      */
     getTasksAssignedToActor(actorId: string): Promise<TaskRecord[]>;
     /**
-     * [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
      */
     handleFeedbackCreated(event: FeedbackCreatedEvent): Promise<void>;
-    /**
-     * [EARS-33] Handles feedback resolved events - resumes task if no more blocks
-     */
-    handleFeedbackResolved(event: FeedbackStatusChangedEvent): Promise<void>;
     /**
      * [EARS-35] Handles execution created events - transitions ready→active on first execution
      */
@@ -1964,13 +2113,19 @@ declare namespace index$a {
   export { index$a_BacklogAdapter as BacklogAdapter, type index$a_BacklogAdapterConfig as BacklogAdapterConfig, type index$a_BacklogAdapterDependencies as BacklogAdapterDependencies, type index$a_IBacklogAdapter as IBacklogAdapter };
 }
 
+/**
+ * Collection of all records with full GitGov metadata (headers + payloads).
+ * This allows access to signatures, checksums, and other metadata for enrichment.
+ *
+ * @see GitGovTaskRecord - Full record type with header.signatures for author/lastModifier extraction
+ */
 type AllRecords = {
-    tasks: TaskRecord[];
-    cycles: CycleRecord[];
-    feedback: FeedbackRecord[];
-    executions: ExecutionRecord[];
-    changelogs: ChangelogRecord[];
-    actors: ActorRecord[];
+    tasks: GitGovTaskRecord[];
+    cycles: GitGovCycleRecord[];
+    feedback: GitGovFeedbackRecord[];
+    executions: GitGovExecutionRecord[];
+    changelogs: GitGovChangelogRecord[];
+    actors: GitGovActorRecord[];
 };
 /**
  * Enhanced Task Record with calculated activity metadata
@@ -2060,7 +2215,7 @@ interface IIndexerAdapter {
         lastActivityType: EnrichedTaskRecord['lastActivityType'];
         recentActivity: string;
     }>;
-    enrichTaskRecord(task: TaskRecord, relatedRecords: AllRecords): Promise<EnrichedTaskRecord>;
+    enrichTaskRecord(task: GitGovTaskRecord, relatedRecords: AllRecords): Promise<EnrichedTaskRecord>;
     isIndexUpToDate(): Promise<boolean>;
     invalidateCache(): Promise<void>;
 }
@@ -2102,27 +2257,28 @@ declare class FileIndexerAdapter implements IIndexerAdapter {
      */
     invalidateCache(): Promise<void>;
     /**
-     * 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.
      */
     private readAllTasks;
     /**
-     * Reads all cycles from cycleStore
+     * Reads all cycles from cycleStore with full metadata.
      */
     private readAllCycles;
     /**
-     * Reads all actors from actorStore (graceful degradation)
+     * Reads all actors from actorStore (graceful degradation) with full metadata.
      */
     private readAllActors;
     /**
-     * Reads all feedback from feedbackStore (graceful degradation)
+     * Reads all feedback from feedbackStore (graceful degradation) with full metadata.
      */
     private readAllFeedback;
     /**
-     * Reads all executions from executionStore (graceful degradation)
+     * Reads all executions from executionStore (graceful degradation) with full metadata.
      */
     private readAllExecutions;
     /**
-     * Reads all changelogs from changelogStore (graceful degradation)
+     * Reads all changelogs from changelogStore (graceful degradation) with full metadata.
      */
     private readAllChangelogs;
     /**
@@ -2156,8 +2312,10 @@ declare class FileIndexerAdapter implements IIndexerAdapter {
     }>;
     /**
      * [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
      */
-    enrichTaskRecord(task: TaskRecord, relatedRecords: AllRecords): Promise<EnrichedTaskRecord>;
+    enrichTaskRecord(task: GitGovTaskRecord, relatedRecords: AllRecords): Promise<EnrichedTaskRecord>;
     /**
      * Format timestamp as human-readable time ago
      */
@@ -2427,10 +2585,6 @@ declare class ProjectAdapter implements IProjectAdapter {
      * [EARS-3] Processes blueprint template JSON with schema validation creating cycles and tasks
      */
     processBlueprintTemplate(templatePath: string, projectContext: ProjectContext): Promise<TemplateProcessingResult>;
-    /**
-     * Sets up Kiro IDE integration by always copying GitGovernance hooks
-     */
-    private setupKiroIntegration;
     /**
      * [EARS-4] Cleans up partial setup artifacts if initialization fails
      */
@@ -2448,6 +2602,7 @@ declare class ProjectAdapter implements IProjectAdapter {
      */
     generateProjectReport(): Promise<ProjectReport>;
     private createDirectoryStructure;
+    private copyAgentPrompt;
     private generateProjectId;
     private persistConfiguration;
     private initializeSession;
@@ -2477,6 +2632,7 @@ type index$6_BacklogAdapterDependencies = BacklogAdapterDependencies;
 type index$6_ChangelogAdapter = ChangelogAdapter;
 declare const index$6_ChangelogAdapter: typeof ChangelogAdapter;
 type index$6_ChangelogAdapterDependencies = ChangelogAdapterDependencies;
+type index$6_ChangelogListOptions = ChangelogListOptions;
 type index$6_CollaborationMetrics = CollaborationMetrics;
 type index$6_EnrichedTaskRecord = EnrichedTaskRecord;
 type index$6_EnvironmentValidation = EnvironmentValidation;
@@ -2486,6 +2642,7 @@ type index$6_ExecutionAdapterDependencies = ExecutionAdapterDependencies;
 type index$6_FeedbackAdapter = FeedbackAdapter;
 declare const index$6_FeedbackAdapter: typeof FeedbackAdapter;
 type index$6_FeedbackAdapterDependencies = FeedbackAdapterDependencies;
+type index$6_FeedbackThread = FeedbackThread;
 type index$6_FileIndexerAdapter = FileIndexerAdapter;
 declare const index$6_FileIndexerAdapter: typeof FileIndexerAdapter;
 type index$6_IBacklogAdapter = IBacklogAdapter;
@@ -2526,7 +2683,7 @@ type index$6_WorkflowMethodologyAdapter = WorkflowMethodologyAdapter;
 declare const index$6_WorkflowMethodologyAdapter: typeof WorkflowMethodologyAdapter;
 type index$6_WorkflowMethodologyAdapterDependencies = WorkflowMethodologyAdapterDependencies;
 declare namespace index$6 {
-  export { type index$6_AllRecords as AllRecords, index$6_BacklogAdapter as BacklogAdapter, type index$6_BacklogAdapterConfig as BacklogAdapterConfig, type index$6_BacklogAdapterDependencies as BacklogAdapterDependencies, index$6_ChangelogAdapter as ChangelogAdapter, type index$6_ChangelogAdapterDependencies as ChangelogAdapterDependencies, type index$6_CollaborationMetrics as CollaborationMetrics, type index$6_EnrichedTaskRecord as EnrichedTaskRecord, type index$6_EnvironmentValidation as EnvironmentValidation, index$6_ExecutionAdapter as ExecutionAdapter, type index$6_ExecutionAdapterDependencies as ExecutionAdapterDependencies, index$6_FeedbackAdapter as FeedbackAdapter, type index$6_FeedbackAdapterDependencies as FeedbackAdapterDependencies, index$6_FileIndexerAdapter as FileIndexerAdapter, type index$6_IBacklogAdapter as IBacklogAdapter, type index$6_IChangelogAdapter as IChangelogAdapter, type index$6_IExecutionAdapter as IExecutionAdapter, type index$6_IFeedbackAdapter as IFeedbackAdapter, type index$6_IIdentityAdapter as IIdentityAdapter, type index$6_IIndexerAdapter as IIndexerAdapter, type index$6_IMetricsAdapter as IMetricsAdapter, type index$6_IProjectAdapter as IProjectAdapter, type index$6_IWorkflowMethodology as IWorkflowMethodology, index$6_IdentityAdapter as IdentityAdapter, type index$6_IdentityAdapterDependencies as IdentityAdapterDependencies, type index$6_IndexData as IndexData, type index$6_IndexGenerationReport as IndexGenerationReport, type index$6_IndexerAdapterDependencies as IndexerAdapterDependencies, type index$6_IntegrityError as IntegrityError, type index$6_IntegrityReport as IntegrityReport, type index$6_IntegrityWarning as IntegrityWarning, index$6_MetricsAdapter as MetricsAdapter, type index$6_MetricsAdapterDependencies as MetricsAdapterDependencies, type index$6_ProductivityMetrics as ProductivityMetrics, index$6_ProjectAdapter as ProjectAdapter, type index$6_ProjectAdapterDependencies as ProjectAdapterDependencies, type index$6_ProjectContext as ProjectContext, type index$6_ProjectInfo as ProjectInfo, type index$6_ProjectInitOptions as ProjectInitOptions, type index$6_ProjectInitResult as ProjectInitResult, type index$6_ProjectReport as ProjectReport, type index$6_SystemStatus as SystemStatus, type index$6_TaskHealthReport as TaskHealthReport, type index$6_TemplateProcessingResult as TemplateProcessingResult, type index$6_ValidationContext as ValidationContext, index$6_WorkflowMethodologyAdapter as WorkflowMethodologyAdapter, type index$6_WorkflowMethodologyAdapterDependencies as WorkflowMethodologyAdapterDependencies };
+  export { type index$6_AllRecords as AllRecords, index$6_BacklogAdapter as BacklogAdapter, type index$6_BacklogAdapterConfig as BacklogAdapterConfig, type index$6_BacklogAdapterDependencies as BacklogAdapterDependencies, index$6_ChangelogAdapter as ChangelogAdapter, type index$6_ChangelogAdapterDependencies as ChangelogAdapterDependencies, type index$6_ChangelogListOptions as ChangelogListOptions, type index$6_CollaborationMetrics as CollaborationMetrics, type index$6_EnrichedTaskRecord as EnrichedTaskRecord, type index$6_EnvironmentValidation as EnvironmentValidation, index$6_ExecutionAdapter as ExecutionAdapter, type index$6_ExecutionAdapterDependencies as ExecutionAdapterDependencies, index$6_FeedbackAdapter as FeedbackAdapter, type index$6_FeedbackAdapterDependencies as FeedbackAdapterDependencies, type index$6_FeedbackThread as FeedbackThread, index$6_FileIndexerAdapter as FileIndexerAdapter, type index$6_IBacklogAdapter as IBacklogAdapter, type index$6_IChangelogAdapter as IChangelogAdapter, type index$6_IExecutionAdapter as IExecutionAdapter, type index$6_IFeedbackAdapter as IFeedbackAdapter, type index$6_IIdentityAdapter as IIdentityAdapter, type index$6_IIndexerAdapter as IIndexerAdapter, type index$6_IMetricsAdapter as IMetricsAdapter, type index$6_IProjectAdapter as IProjectAdapter, type index$6_IWorkflowMethodology as IWorkflowMethodology, index$6_IdentityAdapter as IdentityAdapter, type index$6_IdentityAdapterDependencies as IdentityAdapterDependencies, type index$6_IndexData as IndexData, type index$6_IndexGenerationReport as IndexGenerationReport, type index$6_IndexerAdapterDependencies as IndexerAdapterDependencies, type index$6_IntegrityError as IntegrityError, type index$6_IntegrityReport as IntegrityReport, type index$6_IntegrityWarning as IntegrityWarning, index$6_MetricsAdapter as MetricsAdapter, type index$6_MetricsAdapterDependencies as MetricsAdapterDependencies, type index$6_ProductivityMetrics as ProductivityMetrics, index$6_ProjectAdapter as ProjectAdapter, type index$6_ProjectAdapterDependencies as ProjectAdapterDependencies, type index$6_ProjectContext as ProjectContext, type index$6_ProjectInfo as ProjectInfo, type index$6_ProjectInitOptions as ProjectInitOptions, type index$6_ProjectInitResult as ProjectInitResult, type index$6_ProjectReport as ProjectReport, type index$6_SystemStatus as SystemStatus, type index$6_TaskHealthReport as TaskHealthReport, type index$6_TemplateProcessingResult as TemplateProcessingResult, type index$6_ValidationContext as ValidationContext, index$6_WorkflowMethodologyAdapter as WorkflowMethodologyAdapter, type index$6_WorkflowMethodologyAdapterDependencies as WorkflowMethodologyAdapterDependencies };
 }
 
 /**
@@ -2537,6 +2694,13 @@ declare function calculatePayloadChecksum(payload: GitGovRecordPayload): string;
 /**
  * Generates a new Ed25519 key pair.
  * @returns A promise that resolves to an object with publicKey and privateKey in base64 format.
+ *
+ * The publicKey is the raw Ed25519 key (32 bytes -> 44 chars in base64).
+ * The privateKey is stored in PKCS8 PEM format for compatibility.
+ *
+ * Note: Node.js crypto does not support 'raw' format directly for Ed25519,
+ * so we extract the raw 32-byte key from the SPKI DER encoding (RFC 8410).
+ * SPKI DER structure: [algorithm identifier (12 bytes)] + [raw public key (32 bytes)]
  */
 declare function generateKeys(): Promise<{
     publicKey: string;
@@ -2545,9 +2709,11 @@ declare function generateKeys(): Promise<{
 /**
  * Creates a signature for a given payload.
  */
-declare function signPayload(payload: GitGovRecordPayload, privateKey: string, keyId: string, role: string): Signature;
+declare function signPayload(payload: GitGovRecordPayload, privateKey: string, keyId: string, role: string, notes: string): Signature;
 /**
  * Verifies all signatures on a record.
+ *
+ * Reconstructs SPKI DER format from raw Ed25519 key for verification.
  */
 declare function verifySignatures(record: {
     header: {
@@ -2619,17 +2785,72 @@ declare function createWorkflowMethodologyConfig(payload: Partial<WorkflowMethod
  */
 declare function createDefaultWorkflowMethodologyConfig(): Promise<WorkflowMethodologyRecord>;
 
+/**
+ * Configuration for signature generation
+ * Extends Signature with privateKey for signing
+ */
+type SignatureConfig = Partial<Pick<Signature, 'keyId' | 'role' | 'notes'>> & {
+    /** Private key for signing (if not provided, creates unsigned test signature) */
+    privateKey?: string;
+};
+/**
+ * Options for creating an EmbeddedMetadataRecord
+ */
+type CreateEmbeddedMetadataOptions = {
+    /** Header configuration (partial override, excludes auto-generated fields) */
+    header?: Partial<Pick<EmbeddedMetadataHeader, 'version' | 'type' | 'schemaUrl' | 'schemaChecksum'>>;
+    /** Signature configuration (if not provided, uses default test signature) */
+    signature?: SignatureConfig;
+    /** Custom signatures array (if provided, overrides signature config) */
+    signatures?: Signature[];
+};
+/**
+ * Creates a test signature for development/testing purposes (unsigned)
+ * Use this only for testing when you don't have a real private key
+ *
+ * @param keyId - The key ID for the signature (default: 'human:test-user')
+ * @param role - The role for the signature (default: 'author')
+ * @param notes - Notes for the signature (default: 'Test signature - unsigned')
+ * @returns Signature object (with dummy signature value)
+ */
+declare function createTestSignature(keyId?: string, role?: string, notes?: string): Signature;
+/**
+ * Creates a complete EmbeddedMetadataRecord with validation
+ *
+ * @param payload - The record payload (ActorRecord, TaskRecord, etc.)
+ * @param options - Optional configuration for the embedded metadata
+ * @returns Promise<EmbeddedMetadataRecord<T>> - The validated embedded metadata record
+ *
+ * @example
+ * ```typescript
+ * const actorPayload: ActorRecord = {
+ *   id: 'human:john-doe',
+ *   type: 'human',
+ *   displayName: 'John Doe',
+ *   publicKey: 'abc123...',
+ *   roles: ['developer']
+ * };
+ *
+ * const embedded = await createEmbeddedMetadataRecord(actorPayload);
+ * ```
+ */
+declare function createEmbeddedMetadataRecord<T extends GitGovRecordPayload>(payload: T, options?: CreateEmbeddedMetadataOptions): Promise<EmbeddedMetadataRecord<T>>;
+
+type index$4_CreateEmbeddedMetadataOptions = CreateEmbeddedMetadataOptions;
+type index$4_SignatureConfig = SignatureConfig;
 declare const index$4_createActorRecord: typeof createActorRecord;
 declare const index$4_createAgentRecord: typeof createAgentRecord;
 declare const index$4_createChangelogRecord: typeof createChangelogRecord;
 declare const index$4_createCycleRecord: typeof createCycleRecord;
 declare const index$4_createDefaultWorkflowMethodologyConfig: typeof createDefaultWorkflowMethodologyConfig;
+declare const index$4_createEmbeddedMetadataRecord: typeof createEmbeddedMetadataRecord;
 declare const index$4_createExecutionRecord: typeof createExecutionRecord;
 declare const index$4_createFeedbackRecord: typeof createFeedbackRecord;
 declare const index$4_createTaskRecord: typeof createTaskRecord;
+declare const index$4_createTestSignature: typeof createTestSignature;
 declare const index$4_createWorkflowMethodologyConfig: typeof createWorkflowMethodologyConfig;
 declare namespace index$4 {
-  export { index$4_createActorRecord as createActorRecord, index$4_createAgentRecord as createAgentRecord, index$4_createChangelogRecord as createChangelogRecord, index$4_createCycleRecord as createCycleRecord, index$4_createDefaultWorkflowMethodologyConfig as createDefaultWorkflowMethodologyConfig, index$4_createExecutionRecord as createExecutionRecord, index$4_createFeedbackRecord as createFeedbackRecord, index$4_createTaskRecord as createTaskRecord, index$4_createWorkflowMethodologyConfig as createWorkflowMethodologyConfig };
+  export { type index$4_CreateEmbeddedMetadataOptions as CreateEmbeddedMetadataOptions, type index$4_SignatureConfig as SignatureConfig, index$4_createActorRecord as createActorRecord, index$4_createAgentRecord as createAgentRecord, index$4_createChangelogRecord as createChangelogRecord, index$4_createCycleRecord as createCycleRecord, index$4_createDefaultWorkflowMethodologyConfig as createDefaultWorkflowMethodologyConfig, index$4_createEmbeddedMetadataRecord as createEmbeddedMetadataRecord, index$4_createExecutionRecord as createExecutionRecord, index$4_createFeedbackRecord as createFeedbackRecord, index$4_createTaskRecord as createTaskRecord, index$4_createTestSignature as createTestSignature, index$4_createWorkflowMethodologyConfig as createWorkflowMethodologyConfig };
 }
 
 type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
@@ -2688,6 +2909,8 @@ declare const Schemas: {
             };
             publicKey: {
                 type: string;
+                minLength: number;
+                maxLength: number;
                 description: string;
             };
             roles: {
@@ -2745,27 +2968,29 @@ declare const Schemas: {
                 enum: string[];
                 default: string;
             };
-            guild: {
-                type: string;
-                enum: string[];
-            };
             triggers: {
                 type: string;
+                default: never[];
+                description: string;
                 items: {
                     type: string;
                     properties: {
                         type: {
                             type: string;
                             enum: string[];
+                            description: string;
                         };
                     };
                     required: string[];
+                    additionalProperties: boolean;
                 };
             };
             knowledge_dependencies: {
                 type: string;
+                default: never[];
                 items: {
                     type: string;
+                    description: string;
                 };
             };
             prompt_engine_requirements: {
@@ -2785,67 +3010,465 @@ declare const Schemas: {
                     };
                 };
             };
+            metadata: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
             engine: {
                 type: string;
                 oneOf: ({
                     required: string[];
+                    additionalProperties: boolean;
                     properties: {
                         type: {
                             const: string;
                         };
                         runtime: {
                             type: string;
+                            description: string;
                         };
                         entrypoint: {
                             type: string;
+                            description: string;
                         };
                         function: {
                             type: string;
+                            description: string;
                         };
                         url?: never;
                         method?: never;
                         auth?: never;
+                        protocol?: never;
+                        config?: never;
                     };
                 } | {
                     required: string[];
+                    additionalProperties: boolean;
                     properties: {
                         type: {
                             const: string;
                         };
                         url: {
                             type: string;
+                            format: string;
+                            description: string;
                         };
                         method: {
                             type: string;
                             enum: string[];
+                            default: string;
                         };
                         auth: {
                             type: string;
-                        };
-                        runtime?: never;
-                        entrypoint?: never;
-                        function?: never;
-                    };
-                } | {
-                    required: string[];
-                    properties: {
-                        type: {
-                            const: string;
+                            description: string;
+                            additionalProperties: boolean;
+                            properties: {
+                                type: {
+                                    type: string;
+                                    enum: string[];
+                                    description: string;
+                                };
+                                secret_key: {
+                                    type: string;
+                                    description: string;
+                                };
+                                token: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
+                        };
+                        runtime?: never;
+                        entrypoint?: never;
+                        function?: never;
+                        protocol?: never;
+                        config?: never;
+                    };
+                } | {
+                    required: string[];
+                    additionalProperties: boolean;
+                    properties: {
+                        type: {
+                            const: string;
                         };
                         url: {
                             type: string;
+                            format: string;
+                            description: string;
                         };
                         auth: {
                             type: string;
+                            description: string;
+                            additionalProperties: boolean;
+                            properties: {
+                                type: {
+                                    type: string;
+                                    enum: string[];
+                                    description: string;
+                                };
+                                secret_key: {
+                                    type: string;
+                                    description: string;
+                                };
+                                token: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
                         };
                         runtime?: never;
                         entrypoint?: never;
                         function?: never;
                         method?: never;
+                        protocol?: never;
+                        config?: never;
+                    };
+                } | {
+                    required: string[];
+                    additionalProperties: boolean;
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                        protocol: {
+                            type: string;
+                            description: string;
+                        };
+                        config: {
+                            type: string;
+                            description: string;
+                        };
+                        runtime?: never;
+                        entrypoint?: never;
+                        function?: never;
+                        url?: never;
+                        method?: never;
+                        auth?: never;
                     };
                 })[];
             };
         };
+        examples: ({
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                runtime: string;
+                entrypoint: string;
+                function: string;
+                url?: never;
+                method?: never;
+                auth?: never;
+                protocol?: never;
+                config?: never;
+            };
+            metadata: {
+                purpose: string;
+                maintainer: string;
+                framework?: never;
+                version?: never;
+                model?: never;
+                deployment?: never;
+                cost_per_invocation?: never;
+                currency?: never;
+                max_tokens?: never;
+                ide?: never;
+                tool?: never;
+                accepts_tools?: never;
+                provider?: never;
+                supported_languages?: never;
+                max_chars_per_request?: never;
+                experimental?: never;
+            };
+            triggers: {
+                type: string;
+            }[];
+            knowledge_dependencies: string[];
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                url: string;
+                method: string;
+                auth: {
+                    type: string;
+                    secret_key?: never;
+                };
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                protocol?: never;
+                config?: never;
+            };
+            metadata: {
+                framework: string;
+                version: string;
+                model: string;
+                deployment: {
+                    provider: string;
+                    service: string;
+                    region: string;
+                    runtime?: never;
+                    image?: never;
+                    port?: never;
+                };
+                cost_per_invocation: number;
+                currency: string;
+                purpose?: never;
+                maintainer?: never;
+                max_tokens?: never;
+                ide?: never;
+                tool?: never;
+                accepts_tools?: never;
+                provider?: never;
+                supported_languages?: never;
+                max_chars_per_request?: never;
+                experimental?: never;
+            };
+            triggers: {
+                type: string;
+                event: string;
+            }[];
+            knowledge_dependencies: string[];
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                url: string;
+                method: string;
+                auth: {
+                    type: string;
+                    secret_key?: never;
+                };
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                protocol?: never;
+                config?: never;
+            };
+            metadata: {
+                framework: string;
+                version: string;
+                model: string;
+                deployment: {
+                    runtime: string;
+                    image: string;
+                    port: number;
+                    provider?: never;
+                    service?: never;
+                    region?: never;
+                };
+                max_tokens: number;
+                purpose?: never;
+                maintainer?: never;
+                cost_per_invocation?: never;
+                currency?: never;
+                ide?: never;
+                tool?: never;
+                accepts_tools?: never;
+                provider?: never;
+                supported_languages?: never;
+                max_chars_per_request?: never;
+                experimental?: never;
+            };
+            triggers: {
+                type: string;
+                event: string;
+            }[];
+            knowledge_dependencies?: never;
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                url: string;
+                auth: {
+                    type: string;
+                    secret_key?: never;
+                };
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                method?: never;
+                protocol?: never;
+                config?: never;
+            };
+            metadata: {
+                ide: string;
+                tool: string;
+                accepts_tools: string[];
+                purpose?: never;
+                maintainer?: never;
+                framework?: never;
+                version?: never;
+                model?: never;
+                deployment?: never;
+                cost_per_invocation?: never;
+                currency?: never;
+                max_tokens?: never;
+                provider?: never;
+                supported_languages?: never;
+                max_chars_per_request?: never;
+                experimental?: never;
+            };
+            knowledge_dependencies: string[];
+            triggers: {
+                type: string;
+                event: string;
+            }[];
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                url: string;
+                method: string;
+                auth: {
+                    type: string;
+                    secret_key: string;
+                };
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                protocol?: never;
+                config?: never;
+            };
+            metadata: {
+                provider: string;
+                supported_languages: string[];
+                max_chars_per_request: number;
+                purpose?: never;
+                maintainer?: never;
+                framework?: never;
+                version?: never;
+                model?: never;
+                deployment?: never;
+                cost_per_invocation?: never;
+                currency?: never;
+                max_tokens?: never;
+                ide?: never;
+                tool?: never;
+                accepts_tools?: never;
+                experimental?: never;
+            };
+            triggers: {
+                type: string;
+            }[];
+            knowledge_dependencies?: never;
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                protocol: string;
+                config: {
+                    endpoint: string;
+                    version: string;
+                    capabilities: string[];
+                };
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                url?: never;
+                method?: never;
+                auth?: never;
+            };
+            metadata: {
+                purpose: string;
+                experimental: boolean;
+                maintainer?: never;
+                framework?: never;
+                version?: never;
+                model?: never;
+                deployment?: never;
+                cost_per_invocation?: never;
+                currency?: never;
+                max_tokens?: never;
+                ide?: never;
+                tool?: never;
+                accepts_tools?: never;
+                provider?: never;
+                supported_languages?: never;
+                max_chars_per_request?: never;
+            };
+            triggers: {
+                type: string;
+                cron: string;
+            }[];
+            knowledge_dependencies?: never;
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            engine: {
+                type: string;
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                url?: never;
+                method?: never;
+                auth?: never;
+                protocol?: never;
+                config?: never;
+            };
+            status?: never;
+            metadata?: never;
+            triggers?: never;
+            knowledge_dependencies?: never;
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                url: string;
+                runtime?: never;
+                entrypoint?: never;
+                function?: never;
+                method?: never;
+                auth?: never;
+                protocol?: never;
+                config?: never;
+            };
+            knowledge_dependencies: string[];
+            triggers: {
+                type: string;
+            }[];
+            metadata?: never;
+            prompt_engine_requirements?: never;
+        } | {
+            id: string;
+            status: string;
+            engine: {
+                type: string;
+                runtime: string;
+                entrypoint: string;
+                function: string;
+                url?: never;
+                method?: never;
+                auth?: never;
+                protocol?: never;
+                config?: never;
+            };
+            prompt_engine_requirements: {
+                roles: string[];
+                skills: string[];
+            };
+            knowledge_dependencies: string[];
+            triggers: {
+                type: string;
+                event: string;
+                filter: string;
+            }[];
+            metadata?: never;
+        })[];
     };
     readonly ChangelogRecord: {
         $schema: string;
@@ -2859,27 +3482,16 @@ declare const Schemas: {
             id: {
                 type: string;
                 pattern: string;
+                maxLength: number;
                 description: string;
-            };
-            entityType: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            entityId: {
-                type: string;
-                description: string;
-            };
-            changeType: {
-                type: string;
-                enum: string[];
-                description: string;
+                examples: string[];
             };
             title: {
                 type: string;
                 minLength: number;
                 maxLength: number;
                 description: string;
+                examples: string[];
             };
             description: {
                 type: string;
@@ -2887,145 +3499,104 @@ declare const Schemas: {
                 maxLength: number;
                 description: string;
             };
-            timestamp: {
-                type: string;
-                minimum: number;
-                description: string;
-            };
-            trigger: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            triggeredBy: {
+            relatedTasks: {
                 type: string;
+                items: {
+                    type: string;
+                    pattern: string;
+                };
+                minItems: number;
                 description: string;
             };
-            reason: {
-                type: string;
-                minLength: number;
-                maxLength: number;
-                description: string;
-            };
-            riskLevel: {
+            completedAt: {
                 type: string;
-                enum: string[];
+                minimum: number;
                 description: string;
             };
-            affectedSystems: {
+            relatedCycles: {
                 type: string;
                 items: {
                     type: string;
+                    pattern: string;
                 };
+                default: never[];
                 description: string;
             };
-            usersAffected: {
+            relatedExecutions: {
                 type: string;
-                minimum: number;
+                items: {
+                    type: string;
+                    pattern: string;
+                };
+                default: never[];
                 description: string;
             };
-            downtime: {
+            version: {
                 type: string;
-                minimum: number;
+                minLength: number;
+                maxLength: number;
                 description: string;
+                examples: string[];
             };
-            files: {
+            tags: {
                 type: string;
                 items: {
                     type: string;
+                    pattern: string;
                 };
+                default: never[];
                 description: string;
             };
             commits: {
                 type: string;
                 items: {
                     type: string;
+                    maxLength: number;
                 };
+                default: never[];
                 description: string;
             };
-            rollbackInstructions: {
+            files: {
                 type: string;
-                minLength: number;
-                maxLength: number;
+                items: {
+                    type: string;
+                    maxLength: number;
+                };
+                default: never[];
                 description: string;
             };
-            references: {
+            notes: {
                 type: string;
-                additionalProperties: boolean;
-                properties: {
-                    tasks: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                        description: string;
-                    };
-                    cycles: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                        description: string;
-                    };
-                    executions: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                        description: string;
-                    };
-                    changelogs: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                        description: string;
-                    };
-                };
+                maxLength: number;
                 description: string;
             };
         };
         examples: ({
             id: string;
-            entityType: string;
-            entityId: string;
-            changeType: string;
             title: string;
             description: string;
-            timestamp: number;
-            trigger: string;
-            triggeredBy: string;
-            reason: string;
-            riskLevel: string;
-            files: string[];
+            relatedTasks: string[];
+            completedAt: number;
+            relatedCycles: string[];
+            relatedExecutions: string[];
+            version: string;
+            tags: string[];
             commits: string[];
-            references: {
-                tasks: string[];
-                executions: string[];
-            };
-            affectedSystems?: never;
-            usersAffected?: never;
-            downtime?: never;
-            rollbackInstructions?: never;
+            files: string[];
+            notes: string;
         } | {
             id: string;
-            entityType: string;
-            entityId: string;
-            changeType: string;
             title: string;
             description: string;
-            timestamp: number;
-            trigger: string;
-            triggeredBy: string;
-            reason: string;
-            riskLevel: string;
-            affectedSystems: string[];
-            usersAffected: number;
-            downtime: number;
-            rollbackInstructions: string;
+            relatedTasks: string[];
+            completedAt: number;
+            version: string;
+            tags: string[];
             commits: string[];
+            notes: string;
+            relatedCycles?: never;
+            relatedExecutions?: never;
             files?: never;
-            references?: never;
         })[];
     };
     readonly CycleRecord: {
@@ -3040,13 +3611,16 @@ declare const Schemas: {
             id: {
                 type: string;
                 pattern: string;
+                maxLength: number;
                 description: string;
+                examples: string[];
             };
             title: {
                 type: string;
                 minLength: number;
                 maxLength: number;
                 description: string;
+                examples: string[];
             };
             status: {
                 type: string;
@@ -3058,39 +3632,58 @@ declare const Schemas: {
                 items: {
                     type: string;
                     pattern: string;
+                    maxLength: number;
                 };
+                default: never[];
+                description: string;
+                examples: string[][];
             };
             childCycleIds: {
                 type: string;
                 items: {
                     type: string;
                     pattern: string;
+                    maxLength: number;
                 };
+                default: never[];
                 description: string;
+                examples: string[][];
             };
             tags: {
                 type: string;
                 items: {
                     type: string;
                     pattern: string;
+                    maxLength: number;
                 };
                 default: never[];
                 description: string;
+                examples: string[][];
             };
             notes: {
                 type: string;
+                minLength: number;
                 maxLength: number;
                 description: string;
             };
         };
-        examples: {
+        examples: ({
             id: string;
             title: string;
             status: string;
             taskIds: string[];
             tags: string[];
             notes: string;
-        }[];
+            childCycleIds?: never;
+        } | {
+            id: string;
+            title: string;
+            status: string;
+            childCycleIds: string[];
+            tags: string[];
+            notes: string;
+            taskIds?: never;
+        })[];
     };
     readonly EmbeddedMetadata: {
         $schema: string;
@@ -3134,35 +3727,37 @@ declare const Schemas: {
                             properties: {
                                 keyId: {
                                     type: string;
+                                    pattern: string;
                                     description: string;
                                 };
                                 role: {
                                     type: string;
+                                    pattern: string;
+                                    minLength: number;
+                                    maxLength: number;
                                     description: string;
                                 };
-                                signature: {
+                                notes: {
                                     type: string;
+                                    minLength: number;
+                                    maxLength: number;
                                     description: string;
                                 };
-                                timestamp: {
+                                signature: {
                                     type: string;
+                                    pattern: string;
                                     description: string;
                                 };
-                                timestamp_iso: {
+                                timestamp: {
                                     type: string;
                                     description: string;
                                 };
                             };
                             required: string[];
+                            additionalProperties: boolean;
                         };
                         description: string;
                     };
-                    audit: {
-                        type: string;
-                        minLength: number;
-                        maxLength: number;
-                        description: string;
-                    };
                 };
                 required: string[];
                 additionalProperties: boolean;
@@ -3220,7 +3815,7 @@ declare const Schemas: {
             };
             else: boolean;
         })[];
-        examples: {
+        examples: ({
             header: {
                 version: string;
                 type: string;
@@ -3228,9 +3823,9 @@ declare const Schemas: {
                 signatures: {
                     keyId: string;
                     role: string;
+                    notes: string;
                     signature: string;
                     timestamp: number;
-                    timestamp_iso: string;
                 }[];
             };
             payload: {
@@ -3239,8 +3834,69 @@ declare const Schemas: {
                 priority: string;
                 description: string;
                 tags: string[];
+                taskId?: never;
+                type?: never;
+                title?: never;
+                result?: never;
+                displayName?: never;
+                publicKey?: never;
+                roles?: never;
             };
-        }[];
+        } | {
+            header: {
+                version: string;
+                type: string;
+                payloadChecksum: string;
+                signatures: {
+                    keyId: string;
+                    role: string;
+                    notes: string;
+                    signature: string;
+                    timestamp: number;
+                }[];
+            };
+            payload: {
+                id: string;
+                taskId: string;
+                type: string;
+                title: string;
+                result: string;
+                status?: never;
+                priority?: never;
+                description?: never;
+                tags?: never;
+                displayName?: never;
+                publicKey?: never;
+                roles?: never;
+            };
+        } | {
+            header: {
+                version: string;
+                type: string;
+                payloadChecksum: string;
+                signatures: {
+                    keyId: string;
+                    role: string;
+                    notes: string;
+                    signature: string;
+                    timestamp: number;
+                }[];
+            };
+            payload: {
+                id: string;
+                type: string;
+                displayName: string;
+                publicKey: string;
+                roles: string[];
+                status?: never;
+                priority?: never;
+                description?: never;
+                tags?: never;
+                taskId?: never;
+                title?: never;
+                result?: never;
+            };
+        })[];
     };
     readonly ExecutionRecord: {
         $schema: string;
@@ -3272,6 +3928,7 @@ declare const Schemas: {
             };
             title: {
                 type: string;
+                minLength: number;
                 maxLength: number;
                 description: string;
                 examples: string[];
@@ -3293,6 +3950,7 @@ declare const Schemas: {
                     type: string;
                     maxLength: number;
                 };
+                default: never[];
                 description: string;
             };
         };
@@ -3318,7 +3976,9 @@ declare const Schemas: {
             id: {
                 type: string;
                 pattern: string;
+                maxLength: number;
                 description: string;
+                examples: string[];
             };
             entityType: {
                 type: string;
@@ -3327,12 +3987,16 @@ declare const Schemas: {
             };
             entityId: {
                 type: string;
+                minLength: number;
+                maxLength: number;
                 description: string;
+                examples: string[];
             };
             type: {
                 type: string;
                 enum: string[];
                 description: string;
+                examples: string[];
             };
             status: {
                 type: string;
@@ -3347,21 +4011,47 @@ declare const Schemas: {
             };
             assignee: {
                 type: string;
+                pattern: string;
+                maxLength: number;
                 description: string;
+                examples: string[];
             };
             resolvesFeedbackId: {
                 type: string;
+                pattern: string;
+                maxLength: number;
                 description: string;
+                examples: string[];
             };
         };
-        examples: {
+        examples: ({
             id: string;
             entityType: string;
             entityId: string;
             type: string;
             status: string;
             content: string;
-        }[];
+            resolvesFeedbackId?: never;
+            assignee?: never;
+        } | {
+            id: string;
+            entityType: string;
+            entityId: string;
+            type: string;
+            status: string;
+            content: string;
+            resolvesFeedbackId: string;
+            assignee?: never;
+        } | {
+            id: string;
+            entityType: string;
+            entityId: string;
+            type: string;
+            status: string;
+            content: string;
+            assignee: string;
+            resolvesFeedbackId?: never;
+        })[];
     };
     readonly TaskRecord: {
         $schema: string;
@@ -3389,8 +4079,11 @@ declare const Schemas: {
                 type: string;
                 items: {
                     type: string;
+                    minLength: number;
                     pattern: string;
+                    maxLength: number;
                 };
+                default: never[];
                 description: string;
             };
             status: {
@@ -3415,30 +4108,50 @@ declare const Schemas: {
                 type: string;
                 items: {
                     type: string;
+                    minLength: number;
                     pattern: string;
                 };
+                default: never[];
                 description: string;
             };
             references: {
                 type: string;
                 items: {
                     type: string;
+                    minLength: number;
                     maxLength: number;
                 };
+                default: never[];
                 description: string;
             };
             notes: {
                 type: string;
+                minLength: number;
                 maxLength: number;
                 description: string;
             };
         };
-        examples: {
+        examples: ({
             id: string;
+            title: string;
             status: string;
             priority: string;
             description: string;
-        }[];
+            cycleIds: string[];
+            tags: string[];
+            references: string[];
+            notes: string;
+        } | {
+            id: string;
+            title: string;
+            status: string;
+            priority: string;
+            description: string;
+            cycleIds: never[];
+            tags: string[];
+            references: never[];
+            notes?: never;
+        })[];
     };
     readonly WorkflowMethodologyRecord: {
         $schema: string;
@@ -3632,6 +4345,9 @@ declare const Schemas: {
                         items: {
                             type: string;
                             required: string[];
+                            anyOf: {
+                                required: string[];
+                            }[];
                             additionalProperties: boolean;
                             properties: {
                                 id: {
@@ -3639,9 +4355,13 @@ declare const Schemas: {
                                     pattern: string;
                                     description: string;
                                 };
-                                gremio: {
+                                required_roles: {
                                     type: string;
-                                    enum: string[];
+                                    items: {
+                                        type: string;
+                                        pattern: string;
+                                    };
+                                    minItems: number;
                                     description: string;
                                 };
                                 engine: {
@@ -3759,7 +4479,188 @@ declare const Schemas: {
                     };
                 };
             };
-        };
+        };
+        examples: ({
+            version: string;
+            name: string;
+            description: string;
+            state_transitions: {
+                review: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures?: never;
+                    };
+                };
+                ready: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures: {
+                            __default__: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                            design?: never;
+                            quality?: never;
+                        };
+                    };
+                };
+                active: {
+                    from: string[];
+                    requires: {
+                        event: string;
+                        custom_rules?: never;
+                    };
+                };
+                done: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures?: never;
+                    };
+                };
+                archived?: never;
+                paused?: never;
+                discarded?: never;
+            };
+            view_configs: {
+                "kanban-3col": {
+                    columns: {
+                        "To Do": string[];
+                        "In Progress": string[];
+                        Done: string[];
+                    };
+                    theme: string;
+                    layout: string;
+                };
+                "kanban-4col"?: never;
+                "kanban-7col"?: never;
+            };
+            custom_rules?: never;
+        } | {
+            version: string;
+            name: string;
+            description: string;
+            state_transitions: {
+                review: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures: {
+                            __default__: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                        };
+                    };
+                };
+                ready: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures: {
+                            __default__: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                            design: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                            quality: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                        };
+                    };
+                };
+                active: {
+                    from: string[];
+                    requires: {
+                        event: string;
+                        custom_rules: string[];
+                    };
+                };
+                done: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures: {
+                            __default__: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                        };
+                    };
+                };
+                archived: {
+                    from: string[];
+                    requires: {
+                        event: string;
+                    };
+                };
+                paused: {
+                    from: string[];
+                    requires: {
+                        event: string;
+                    };
+                };
+                discarded: {
+                    from: string[];
+                    requires: {
+                        command: string;
+                        signatures: {
+                            __default__: {
+                                role: string;
+                                capability_roles: string[];
+                                min_approvals: number;
+                            };
+                        };
+                    };
+                };
+            };
+            custom_rules: {
+                task_must_have_valid_assignment_for_executor: {
+                    description: string;
+                    validation: string;
+                };
+            };
+            view_configs: {
+                "kanban-4col": {
+                    columns: {
+                        Draft: string[];
+                        "In Progress": string[];
+                        Review: string[];
+                        Done: string[];
+                        Cancelled: string[];
+                    };
+                    theme: string;
+                    layout: string;
+                };
+                "kanban-7col": {
+                    columns: {
+                        Draft: string[];
+                        Review: string[];
+                        Ready: string[];
+                        Active: string[];
+                        Done: string[];
+                        Archived: string[];
+                        Blocked: string[];
+                        Cancelled: string[];
+                    };
+                    theme: string;
+                    layout: string;
+                };
+                "kanban-3col"?: never;
+            };
+        })[];
     };
 };
 /**
@@ -3797,6 +4698,8 @@ declare function getSchema(name: SchemaName): {
         };
         publicKey: {
             type: string;
+            minLength: number;
+            maxLength: number;
             description: string;
         };
         roles: {
@@ -3853,27 +4756,29 @@ declare function getSchema(name: SchemaName): {
             enum: string[];
             default: string;
         };
-        guild: {
-            type: string;
-            enum: string[];
-        };
         triggers: {
             type: string;
+            default: never[];
+            description: string;
             items: {
                 type: string;
                 properties: {
                     type: {
                         type: string;
                         enum: string[];
+                        description: string;
                     };
                 };
                 required: string[];
+                additionalProperties: boolean;
             };
         };
         knowledge_dependencies: {
             type: string;
+            default: never[];
             items: {
                 type: string;
+                description: string;
             };
         };
         prompt_engine_requirements: {
@@ -3893,67 +4798,465 @@ declare function getSchema(name: SchemaName): {
                 };
             };
         };
+        metadata: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+        };
         engine: {
             type: string;
             oneOf: ({
                 required: string[];
+                additionalProperties: boolean;
                 properties: {
                     type: {
                         const: string;
                     };
                     runtime: {
                         type: string;
+                        description: string;
                     };
                     entrypoint: {
                         type: string;
+                        description: string;
                     };
                     function: {
                         type: string;
+                        description: string;
                     };
                     url?: never;
                     method?: never;
                     auth?: never;
+                    protocol?: never;
+                    config?: never;
                 };
             } | {
                 required: string[];
+                additionalProperties: boolean;
                 properties: {
                     type: {
                         const: string;
                     };
                     url: {
                         type: string;
+                        format: string;
+                        description: string;
                     };
                     method: {
                         type: string;
                         enum: string[];
+                        default: string;
                     };
                     auth: {
                         type: string;
+                        description: string;
+                        additionalProperties: boolean;
+                        properties: {
+                            type: {
+                                type: string;
+                                enum: string[];
+                                description: string;
+                            };
+                            secret_key: {
+                                type: string;
+                                description: string;
+                            };
+                            token: {
+                                type: string;
+                                description: string;
+                            };
+                        };
                     };
                     runtime?: never;
                     entrypoint?: never;
                     function?: never;
+                    protocol?: never;
+                    config?: never;
                 };
             } | {
                 required: string[];
+                additionalProperties: boolean;
                 properties: {
                     type: {
                         const: string;
                     };
                     url: {
                         type: string;
+                        format: string;
+                        description: string;
                     };
                     auth: {
                         type: string;
+                        description: string;
+                        additionalProperties: boolean;
+                        properties: {
+                            type: {
+                                type: string;
+                                enum: string[];
+                                description: string;
+                            };
+                            secret_key: {
+                                type: string;
+                                description: string;
+                            };
+                            token: {
+                                type: string;
+                                description: string;
+                            };
+                        };
+                    };
+                    runtime?: never;
+                    entrypoint?: never;
+                    function?: never;
+                    method?: never;
+                    protocol?: never;
+                    config?: never;
+                };
+            } | {
+                required: string[];
+                additionalProperties: boolean;
+                properties: {
+                    type: {
+                        const: string;
+                    };
+                    protocol: {
+                        type: string;
+                        description: string;
+                    };
+                    config: {
+                        type: string;
+                        description: string;
                     };
                     runtime?: never;
                     entrypoint?: never;
                     function?: never;
+                    url?: never;
                     method?: never;
+                    auth?: never;
                 };
             })[];
         };
     };
+    examples: ({
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            runtime: string;
+            entrypoint: string;
+            function: string;
+            url?: never;
+            method?: never;
+            auth?: never;
+            protocol?: never;
+            config?: never;
+        };
+        metadata: {
+            purpose: string;
+            maintainer: string;
+            framework?: never;
+            version?: never;
+            model?: never;
+            deployment?: never;
+            cost_per_invocation?: never;
+            currency?: never;
+            max_tokens?: never;
+            ide?: never;
+            tool?: never;
+            accepts_tools?: never;
+            provider?: never;
+            supported_languages?: never;
+            max_chars_per_request?: never;
+            experimental?: never;
+        };
+        triggers: {
+            type: string;
+        }[];
+        knowledge_dependencies: string[];
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            url: string;
+            method: string;
+            auth: {
+                type: string;
+                secret_key?: never;
+            };
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            protocol?: never;
+            config?: never;
+        };
+        metadata: {
+            framework: string;
+            version: string;
+            model: string;
+            deployment: {
+                provider: string;
+                service: string;
+                region: string;
+                runtime?: never;
+                image?: never;
+                port?: never;
+            };
+            cost_per_invocation: number;
+            currency: string;
+            purpose?: never;
+            maintainer?: never;
+            max_tokens?: never;
+            ide?: never;
+            tool?: never;
+            accepts_tools?: never;
+            provider?: never;
+            supported_languages?: never;
+            max_chars_per_request?: never;
+            experimental?: never;
+        };
+        triggers: {
+            type: string;
+            event: string;
+        }[];
+        knowledge_dependencies: string[];
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            url: string;
+            method: string;
+            auth: {
+                type: string;
+                secret_key?: never;
+            };
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            protocol?: never;
+            config?: never;
+        };
+        metadata: {
+            framework: string;
+            version: string;
+            model: string;
+            deployment: {
+                runtime: string;
+                image: string;
+                port: number;
+                provider?: never;
+                service?: never;
+                region?: never;
+            };
+            max_tokens: number;
+            purpose?: never;
+            maintainer?: never;
+            cost_per_invocation?: never;
+            currency?: never;
+            ide?: never;
+            tool?: never;
+            accepts_tools?: never;
+            provider?: never;
+            supported_languages?: never;
+            max_chars_per_request?: never;
+            experimental?: never;
+        };
+        triggers: {
+            type: string;
+            event: string;
+        }[];
+        knowledge_dependencies?: never;
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            url: string;
+            auth: {
+                type: string;
+                secret_key?: never;
+            };
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            method?: never;
+            protocol?: never;
+            config?: never;
+        };
+        metadata: {
+            ide: string;
+            tool: string;
+            accepts_tools: string[];
+            purpose?: never;
+            maintainer?: never;
+            framework?: never;
+            version?: never;
+            model?: never;
+            deployment?: never;
+            cost_per_invocation?: never;
+            currency?: never;
+            max_tokens?: never;
+            provider?: never;
+            supported_languages?: never;
+            max_chars_per_request?: never;
+            experimental?: never;
+        };
+        knowledge_dependencies: string[];
+        triggers: {
+            type: string;
+            event: string;
+        }[];
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            url: string;
+            method: string;
+            auth: {
+                type: string;
+                secret_key: string;
+            };
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            protocol?: never;
+            config?: never;
+        };
+        metadata: {
+            provider: string;
+            supported_languages: string[];
+            max_chars_per_request: number;
+            purpose?: never;
+            maintainer?: never;
+            framework?: never;
+            version?: never;
+            model?: never;
+            deployment?: never;
+            cost_per_invocation?: never;
+            currency?: never;
+            max_tokens?: never;
+            ide?: never;
+            tool?: never;
+            accepts_tools?: never;
+            experimental?: never;
+        };
+        triggers: {
+            type: string;
+        }[];
+        knowledge_dependencies?: never;
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            protocol: string;
+            config: {
+                endpoint: string;
+                version: string;
+                capabilities: string[];
+            };
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            url?: never;
+            method?: never;
+            auth?: never;
+        };
+        metadata: {
+            purpose: string;
+            experimental: boolean;
+            maintainer?: never;
+            framework?: never;
+            version?: never;
+            model?: never;
+            deployment?: never;
+            cost_per_invocation?: never;
+            currency?: never;
+            max_tokens?: never;
+            ide?: never;
+            tool?: never;
+            accepts_tools?: never;
+            provider?: never;
+            supported_languages?: never;
+            max_chars_per_request?: never;
+        };
+        triggers: {
+            type: string;
+            cron: string;
+        }[];
+        knowledge_dependencies?: never;
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        engine: {
+            type: string;
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            url?: never;
+            method?: never;
+            auth?: never;
+            protocol?: never;
+            config?: never;
+        };
+        status?: never;
+        metadata?: never;
+        triggers?: never;
+        knowledge_dependencies?: never;
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            url: string;
+            runtime?: never;
+            entrypoint?: never;
+            function?: never;
+            method?: never;
+            auth?: never;
+            protocol?: never;
+            config?: never;
+        };
+        knowledge_dependencies: string[];
+        triggers: {
+            type: string;
+        }[];
+        metadata?: never;
+        prompt_engine_requirements?: never;
+    } | {
+        id: string;
+        status: string;
+        engine: {
+            type: string;
+            runtime: string;
+            entrypoint: string;
+            function: string;
+            url?: never;
+            method?: never;
+            auth?: never;
+            protocol?: never;
+            config?: never;
+        };
+        prompt_engine_requirements: {
+            roles: string[];
+            skills: string[];
+        };
+        knowledge_dependencies: string[];
+        triggers: {
+            type: string;
+            event: string;
+            filter: string;
+        }[];
+        metadata?: never;
+    })[];
 } | {
     $schema: string;
     $id: string;
@@ -3966,27 +5269,16 @@ declare function getSchema(name: SchemaName): {
         id: {
             type: string;
             pattern: string;
+            maxLength: number;
             description: string;
-        };
-        entityType: {
-            type: string;
-            enum: string[];
-            description: string;
-        };
-        entityId: {
-            type: string;
-            description: string;
-        };
-        changeType: {
-            type: string;
-            enum: string[];
-            description: string;
+            examples: string[];
         };
         title: {
             type: string;
             minLength: number;
             maxLength: number;
             description: string;
+            examples: string[];
         };
         description: {
             type: string;
@@ -3994,145 +5286,104 @@ declare function getSchema(name: SchemaName): {
             maxLength: number;
             description: string;
         };
-        timestamp: {
-            type: string;
-            minimum: number;
-            description: string;
-        };
-        trigger: {
-            type: string;
-            enum: string[];
-            description: string;
-        };
-        triggeredBy: {
+        relatedTasks: {
             type: string;
+            items: {
+                type: string;
+                pattern: string;
+            };
+            minItems: number;
             description: string;
         };
-        reason: {
+        completedAt: {
             type: string;
-            minLength: number;
-            maxLength: number;
+            minimum: number;
             description: string;
         };
-        riskLevel: {
+        relatedCycles: {
             type: string;
-            enum: string[];
+            items: {
+                type: string;
+                pattern: string;
+            };
+            default: never[];
             description: string;
         };
-        affectedSystems: {
+        relatedExecutions: {
             type: string;
             items: {
                 type: string;
+                pattern: string;
             };
+            default: never[];
             description: string;
         };
-        usersAffected: {
+        version: {
             type: string;
-            minimum: number;
+            minLength: number;
+            maxLength: number;
             description: string;
+            examples: string[];
         };
-        downtime: {
+        tags: {
             type: string;
-            minimum: number;
+            items: {
+                type: string;
+                pattern: string;
+            };
+            default: never[];
             description: string;
         };
-        files: {
+        commits: {
             type: string;
             items: {
                 type: string;
+                maxLength: number;
             };
+            default: never[];
             description: string;
         };
-        commits: {
+        files: {
             type: string;
             items: {
                 type: string;
+                maxLength: number;
             };
+            default: never[];
             description: string;
         };
-        rollbackInstructions: {
+        notes: {
             type: string;
-            minLength: number;
             maxLength: number;
             description: string;
         };
-        references: {
-            type: string;
-            additionalProperties: boolean;
-            properties: {
-                tasks: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                cycles: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                executions: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                changelogs: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-            };
-            description: string;
-        };
     };
     examples: ({
         id: string;
-        entityType: string;
-        entityId: string;
-        changeType: string;
         title: string;
         description: string;
-        timestamp: number;
-        trigger: string;
-        triggeredBy: string;
-        reason: string;
-        riskLevel: string;
-        files: string[];
+        relatedTasks: string[];
+        completedAt: number;
+        relatedCycles: string[];
+        relatedExecutions: string[];
+        version: string;
+        tags: string[];
         commits: string[];
-        references: {
-            tasks: string[];
-            executions: string[];
-        };
-        affectedSystems?: never;
-        usersAffected?: never;
-        downtime?: never;
-        rollbackInstructions?: never;
+        files: string[];
+        notes: string;
     } | {
         id: string;
-        entityType: string;
-        entityId: string;
-        changeType: string;
         title: string;
         description: string;
-        timestamp: number;
-        trigger: string;
-        triggeredBy: string;
-        reason: string;
-        riskLevel: string;
-        affectedSystems: string[];
-        usersAffected: number;
-        downtime: number;
-        rollbackInstructions: string;
+        relatedTasks: string[];
+        completedAt: number;
+        version: string;
+        tags: string[];
         commits: string[];
+        notes: string;
+        relatedCycles?: never;
+        relatedExecutions?: never;
         files?: never;
-        references?: never;
     })[];
 } | {
     $schema: string;
@@ -4146,13 +5397,16 @@ declare function getSchema(name: SchemaName): {
         id: {
             type: string;
             pattern: string;
+            maxLength: number;
             description: string;
+            examples: string[];
         };
         title: {
             type: string;
             minLength: number;
             maxLength: number;
             description: string;
+            examples: string[];
         };
         status: {
             type: string;
@@ -4164,39 +5418,58 @@ declare function getSchema(name: SchemaName): {
             items: {
                 type: string;
                 pattern: string;
+                maxLength: number;
             };
+            default: never[];
+            description: string;
+            examples: string[][];
         };
         childCycleIds: {
             type: string;
             items: {
                 type: string;
                 pattern: string;
+                maxLength: number;
             };
+            default: never[];
             description: string;
+            examples: string[][];
         };
         tags: {
             type: string;
             items: {
                 type: string;
                 pattern: string;
+                maxLength: number;
             };
             default: never[];
             description: string;
+            examples: string[][];
         };
         notes: {
             type: string;
+            minLength: number;
             maxLength: number;
             description: string;
         };
     };
-    examples: {
+    examples: ({
         id: string;
         title: string;
         status: string;
         taskIds: string[];
         tags: string[];
         notes: string;
-    }[];
+        childCycleIds?: never;
+    } | {
+        id: string;
+        title: string;
+        status: string;
+        childCycleIds: string[];
+        tags: string[];
+        notes: string;
+        taskIds?: never;
+    })[];
 } | {
     $schema: string;
     $id: string;
@@ -4239,35 +5512,37 @@ declare function getSchema(name: SchemaName): {
                         properties: {
                             keyId: {
                                 type: string;
+                                pattern: string;
                                 description: string;
                             };
                             role: {
                                 type: string;
+                                pattern: string;
+                                minLength: number;
+                                maxLength: number;
                                 description: string;
                             };
-                            signature: {
+                            notes: {
                                 type: string;
+                                minLength: number;
+                                maxLength: number;
                                 description: string;
                             };
-                            timestamp: {
+                            signature: {
                                 type: string;
+                                pattern: string;
                                 description: string;
                             };
-                            timestamp_iso: {
+                            timestamp: {
                                 type: string;
                                 description: string;
                             };
                         };
                         required: string[];
+                        additionalProperties: boolean;
                     };
                     description: string;
                 };
-                audit: {
-                    type: string;
-                    minLength: number;
-                    maxLength: number;
-                    description: string;
-                };
             };
             required: string[];
             additionalProperties: boolean;
@@ -4325,7 +5600,7 @@ declare function getSchema(name: SchemaName): {
         };
         else: boolean;
     })[];
-    examples: {
+    examples: ({
         header: {
             version: string;
             type: string;
@@ -4333,9 +5608,9 @@ declare function getSchema(name: SchemaName): {
             signatures: {
                 keyId: string;
                 role: string;
+                notes: string;
                 signature: string;
                 timestamp: number;
-                timestamp_iso: string;
             }[];
         };
         payload: {
@@ -4344,8 +5619,69 @@ declare function getSchema(name: SchemaName): {
             priority: string;
             description: string;
             tags: string[];
+            taskId?: never;
+            type?: never;
+            title?: never;
+            result?: never;
+            displayName?: never;
+            publicKey?: never;
+            roles?: never;
         };
-    }[];
+    } | {
+        header: {
+            version: string;
+            type: string;
+            payloadChecksum: string;
+            signatures: {
+                keyId: string;
+                role: string;
+                notes: string;
+                signature: string;
+                timestamp: number;
+            }[];
+        };
+        payload: {
+            id: string;
+            taskId: string;
+            type: string;
+            title: string;
+            result: string;
+            status?: never;
+            priority?: never;
+            description?: never;
+            tags?: never;
+            displayName?: never;
+            publicKey?: never;
+            roles?: never;
+        };
+    } | {
+        header: {
+            version: string;
+            type: string;
+            payloadChecksum: string;
+            signatures: {
+                keyId: string;
+                role: string;
+                notes: string;
+                signature: string;
+                timestamp: number;
+            }[];
+        };
+        payload: {
+            id: string;
+            type: string;
+            displayName: string;
+            publicKey: string;
+            roles: string[];
+            status?: never;
+            priority?: never;
+            description?: never;
+            tags?: never;
+            taskId?: never;
+            title?: never;
+            result?: never;
+        };
+    })[];
 } | {
     $schema: string;
     $id: string;
@@ -4376,6 +5712,7 @@ declare function getSchema(name: SchemaName): {
         };
         title: {
             type: string;
+            minLength: number;
             maxLength: number;
             description: string;
             examples: string[];
@@ -4397,6 +5734,7 @@ declare function getSchema(name: SchemaName): {
                 type: string;
                 maxLength: number;
             };
+            default: never[];
             description: string;
         };
     };
@@ -4421,7 +5759,9 @@ declare function getSchema(name: SchemaName): {
         id: {
             type: string;
             pattern: string;
+            maxLength: number;
             description: string;
+            examples: string[];
         };
         entityType: {
             type: string;
@@ -4430,12 +5770,16 @@ declare function getSchema(name: SchemaName): {
         };
         entityId: {
             type: string;
+            minLength: number;
+            maxLength: number;
             description: string;
+            examples: string[];
         };
         type: {
             type: string;
             enum: string[];
             description: string;
+            examples: string[];
         };
         status: {
             type: string;
@@ -4450,21 +5794,47 @@ declare function getSchema(name: SchemaName): {
         };
         assignee: {
             type: string;
+            pattern: string;
+            maxLength: number;
             description: string;
+            examples: string[];
         };
         resolvesFeedbackId: {
             type: string;
+            pattern: string;
+            maxLength: number;
             description: string;
+            examples: string[];
         };
     };
-    examples: {
+    examples: ({
         id: string;
         entityType: string;
         entityId: string;
         type: string;
         status: string;
         content: string;
-    }[];
+        resolvesFeedbackId?: never;
+        assignee?: never;
+    } | {
+        id: string;
+        entityType: string;
+        entityId: string;
+        type: string;
+        status: string;
+        content: string;
+        resolvesFeedbackId: string;
+        assignee?: never;
+    } | {
+        id: string;
+        entityType: string;
+        entityId: string;
+        type: string;
+        status: string;
+        content: string;
+        assignee: string;
+        resolvesFeedbackId?: never;
+    })[];
 } | {
     $schema: string;
     $id: string;
@@ -4491,8 +5861,11 @@ declare function getSchema(name: SchemaName): {
             type: string;
             items: {
                 type: string;
+                minLength: number;
                 pattern: string;
+                maxLength: number;
             };
+            default: never[];
             description: string;
         };
         status: {
@@ -4517,30 +5890,50 @@ declare function getSchema(name: SchemaName): {
             type: string;
             items: {
                 type: string;
+                minLength: number;
                 pattern: string;
             };
+            default: never[];
             description: string;
         };
         references: {
             type: string;
             items: {
                 type: string;
+                minLength: number;
                 maxLength: number;
             };
+            default: never[];
             description: string;
         };
         notes: {
             type: string;
+            minLength: number;
             maxLength: number;
             description: string;
         };
     };
-    examples: {
+    examples: ({
         id: string;
+        title: string;
         status: string;
         priority: string;
         description: string;
-    }[];
+        cycleIds: string[];
+        tags: string[];
+        references: string[];
+        notes: string;
+    } | {
+        id: string;
+        title: string;
+        status: string;
+        priority: string;
+        description: string;
+        cycleIds: never[];
+        tags: string[];
+        references: never[];
+        notes?: never;
+    })[];
 } | {
     $schema: string;
     $id: string;
@@ -4733,6 +6126,9 @@ declare function getSchema(name: SchemaName): {
                     items: {
                         type: string;
                         required: string[];
+                        anyOf: {
+                            required: string[];
+                        }[];
                         additionalProperties: boolean;
                         properties: {
                             id: {
@@ -4740,9 +6136,13 @@ declare function getSchema(name: SchemaName): {
                                 pattern: string;
                                 description: string;
                             };
-                            gremio: {
+                            required_roles: {
                                 type: string;
-                                enum: string[];
+                                items: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                                minItems: number;
                                 description: string;
                             };
                             engine: {
@@ -4861,6 +6261,187 @@ declare function getSchema(name: SchemaName): {
             };
         };
     };
+    examples: ({
+        version: string;
+        name: string;
+        description: string;
+        state_transitions: {
+            review: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures?: never;
+                };
+            };
+            ready: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures: {
+                        __default__: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                        design?: never;
+                        quality?: never;
+                    };
+                };
+            };
+            active: {
+                from: string[];
+                requires: {
+                    event: string;
+                    custom_rules?: never;
+                };
+            };
+            done: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures?: never;
+                };
+            };
+            archived?: never;
+            paused?: never;
+            discarded?: never;
+        };
+        view_configs: {
+            "kanban-3col": {
+                columns: {
+                    "To Do": string[];
+                    "In Progress": string[];
+                    Done: string[];
+                };
+                theme: string;
+                layout: string;
+            };
+            "kanban-4col"?: never;
+            "kanban-7col"?: never;
+        };
+        custom_rules?: never;
+    } | {
+        version: string;
+        name: string;
+        description: string;
+        state_transitions: {
+            review: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures: {
+                        __default__: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                    };
+                };
+            };
+            ready: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures: {
+                        __default__: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                        design: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                        quality: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                    };
+                };
+            };
+            active: {
+                from: string[];
+                requires: {
+                    event: string;
+                    custom_rules: string[];
+                };
+            };
+            done: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures: {
+                        __default__: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                    };
+                };
+            };
+            archived: {
+                from: string[];
+                requires: {
+                    event: string;
+                };
+            };
+            paused: {
+                from: string[];
+                requires: {
+                    event: string;
+                };
+            };
+            discarded: {
+                from: string[];
+                requires: {
+                    command: string;
+                    signatures: {
+                        __default__: {
+                            role: string;
+                            capability_roles: string[];
+                            min_approvals: number;
+                        };
+                    };
+                };
+            };
+        };
+        custom_rules: {
+            task_must_have_valid_assignment_for_executor: {
+                description: string;
+                validation: string;
+            };
+        };
+        view_configs: {
+            "kanban-4col": {
+                columns: {
+                    Draft: string[];
+                    "In Progress": string[];
+                    Review: string[];
+                    Done: string[];
+                    Cancelled: string[];
+                };
+                theme: string;
+                layout: string;
+            };
+            "kanban-7col": {
+                columns: {
+                    Draft: string[];
+                    Review: string[];
+                    Ready: string[];
+                    Active: string[];
+                    Done: string[];
+                    Archived: string[];
+                    Blocked: string[];
+                    Cancelled: string[];
+                };
+                theme: string;
+                layout: string;
+            };
+            "kanban-3col"?: never;
+        };
+    })[];
 };
 /**
  * Get all schema names
@@ -4924,12 +6505,12 @@ declare class SchemaValidationError extends Error {
  * Error for detailed AJV validation failures with multiple field errors.
  */
 declare class DetailedValidationError extends GitGovError {
-    readonly ajvErrors: Array<{
+    readonly errors: Array<{
         field: string;
         message: string;
         value: unknown;
     }>;
-    constructor(recordType: string, ajvErrors: Array<{
+    constructor(recordType: string, errors: Array<{
         field: string;
         message: string;
         value: unknown;