{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "UNS Console Contracts",
  "description": "Machine-readable contract snapshot for UNS Console /ui endpoints",
  "version": "1.0.0",
  "generated_at": "2026-11-05T07:41:40.017266+00:00",
  "source": "scripts/generate_ui_contracts.py",
  "enums": {
    "AckStatus": [
      "ACKED",
      "DISMISSED",
      "PENDING",
      "TIMED_OUT"
    ],
    "AuditEventType": [
      "ack.dismissed",
      "ack.pending",
      "ack.received",
      "ack.timed_out",
      "delivery.channel_attempted",
      "delivery.deduplicated",
      "delivery.failed",
      "delivery.rate_limited",
      "delivery.started",
      "delivery.succeeded",
      "escalation.triggered",
      "notification.created"
    ],
    "AutonomyMode": [
      "LIVE",
      "PREVIEW",
      "SHADOW"
    ],
    "Channel": [
      "EMAIL",
      "PAGERDUTY",
      "SLACK",
      "WEBSOCKET"
    ],
    "DeliveryMode": [
      "BEST_EFFORT",
      "GUARANTEED"
    ],
    "DeliveryStatus": [
      "DEDUPLICATED",
      "DELIVERED",
      "FAILED",
      "PENDING",
      "RATE_LIMITED",
      "SUCCESS"
    ],
    "DeltaState": [
      "APPLIED",
      "APPROVED",
      "PROPOSED",
      "REJECTED",
      "SHADOW"
    ],
    "EnforcementType": [
      "exception",
      "guard",
      "isolation",
      "test"
    ],
    "InvariantSeverity": [
      "HIGH",
      "LOW",
      "MEDIUM"
    ],
    "InvariantStatus": [
      "active",
      "inactive"
    ],
    "NotificationIntent": [
      "GOVERNANCE",
      "INFORMATIONAL",
      "OPERATIONAL",
      "SAFETY"
    ],
    "PolicyStatus": [
      "ACTIVE",
      "DRAFT",
      "PREVIEW",
      "RETIRED"
    ],
    "Priority": [
      "HIGH",
      "LOW",
      "NORMAL"
    ],
    "ResolutionSource": [
      "explicit_override",
      "mode_override",
      "policy_base",
      "sdk_default"
    ]
  },
  "constants": {
    "TITLE_MAX_LENGTH": 200,
    "MESSAGE_MAX_LENGTH": 4000,
    "PAGINATION_DEFAULT_LIMIT": 25,
    "PAGINATION_MAX_LIMIT": 100
  },
  "schemas": {
    "ActivePolicyListResponse": {
      "$defs": {
        "ActivePolicySummary": {
          "description": "Summary of an active notification routing policy for the console catalog.",
          "properties": {
            "notification_type": {
              "description": "Policy notification_type identifier",
              "title": "Notification Type",
              "type": "string"
            },
            "version": {
              "description": "Policy version",
              "title": "Version",
              "type": "string"
            },
            "status": {
              "description": "Lifecycle status (e.g., ACTIVE)",
              "title": "Status",
              "type": "string"
            },
            "intent": {
              "anyOf": [
                {
                  "$ref": "#/$defs/NotificationIntent"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default notification intent"
            },
            "channels": {
              "description": "Default LIVE channels",
              "items": {
                "$ref": "#/$defs/Channel"
              },
              "title": "Channels",
              "type": "array"
            },
            "delivery_mode": {
              "anyOf": [
                {
                  "$ref": "#/$defs/DeliveryMode"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE delivery mode"
            },
            "require_ack": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE ack requirement",
              "title": "Require Ack"
            },
            "ack_timeout_minutes": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE ack timeout in minutes",
              "title": "Ack Timeout Minutes"
            },
            "ack_timeout_seconds": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE ack timeout in seconds",
              "title": "Ack Timeout Seconds"
            },
            "dedup_window_seconds": {
              "description": "Deduplication window in seconds",
              "title": "Dedup Window Seconds",
              "type": "integer"
            }
          },
          "required": [
            "notification_type",
            "version",
            "status",
            "dedup_window_seconds"
          ],
          "title": "ActivePolicySummary",
          "type": "object"
        },
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        }
      },
      "description": "Catalog of active notification routing policies.",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/$defs/ActivePolicySummary"
          },
          "title": "Items",
          "type": "array"
        },
        "total_count": {
          "description": "Total number of active policies",
          "title": "Total Count",
          "type": "integer"
        }
      },
      "required": [
        "total_count"
      ],
      "title": "ActivePolicyListResponse",
      "type": "object"
    },
    "ActivePolicySummary": {
      "$defs": {
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        }
      },
      "description": "Summary of an active notification routing policy for the console catalog.",
      "properties": {
        "notification_type": {
          "description": "Policy notification_type identifier",
          "title": "Notification Type",
          "type": "string"
        },
        "version": {
          "description": "Policy version",
          "title": "Version",
          "type": "string"
        },
        "status": {
          "description": "Lifecycle status (e.g., ACTIVE)",
          "title": "Status",
          "type": "string"
        },
        "intent": {
          "anyOf": [
            {
              "$ref": "#/$defs/NotificationIntent"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default notification intent"
        },
        "channels": {
          "description": "Default LIVE channels",
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels",
          "type": "array"
        },
        "delivery_mode": {
          "anyOf": [
            {
              "$ref": "#/$defs/DeliveryMode"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE delivery mode"
        },
        "require_ack": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE ack requirement",
          "title": "Require Ack"
        },
        "ack_timeout_minutes": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE ack timeout in minutes",
          "title": "Ack Timeout Minutes"
        },
        "ack_timeout_seconds": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE ack timeout in seconds",
          "title": "Ack Timeout Seconds"
        },
        "dedup_window_seconds": {
          "description": "Deduplication window in seconds",
          "title": "Dedup Window Seconds",
          "type": "integer"
        }
      },
      "required": [
        "notification_type",
        "version",
        "status",
        "dedup_window_seconds"
      ],
      "title": "ActivePolicySummary",
      "type": "object"
    },
    "AuditEvent": {
      "$defs": {
        "AuditEventType": {
          "description": "Types of audit events.",
          "enum": [
            "notification.created",
            "delivery.started",
            "delivery.channel_attempted",
            "delivery.succeeded",
            "delivery.failed",
            "delivery.deduplicated",
            "delivery.rate_limited",
            "ack.pending",
            "ack.received",
            "ack.dismissed",
            "ack.timed_out",
            "escalation.triggered"
          ],
          "title": "AuditEventType",
          "type": "string"
        },
        "AutonomyContextResponse": {
          "description": "Autonomy context in responses.",
          "properties": {
            "autonomy_mode": {
              "$ref": "#/$defs/AutonomyMode"
            },
            "agent_id": {
              "format": "uuid",
              "title": "Agent Id",
              "type": "string"
            },
            "plan_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Plan Id"
            },
            "decision_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Decision Snapshot Id"
            },
            "execution_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Execution Snapshot Id"
            },
            "skip_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Skip Snapshot Id"
            }
          },
          "required": [
            "autonomy_mode",
            "agent_id"
          ],
          "title": "AutonomyContextResponse",
          "type": "object"
        },
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        }
      },
      "description": "Single audit event.",
      "properties": {
        "audit_id": {
          "format": "uuid",
          "title": "Audit Id",
          "type": "string"
        },
        "event_type": {
          "$ref": "#/$defs/AuditEventType"
        },
        "event_time": {
          "format": "date-time",
          "title": "Event Time",
          "type": "string"
        },
        "notification_id": {
          "format": "uuid",
          "title": "Notification Id",
          "type": "string"
        },
        "notification_type": {
          "title": "Notification Type",
          "type": "string"
        },
        "autonomy_context": {
          "$ref": "#/$defs/AutonomyContextResponse"
        },
        "payload": {
          "additionalProperties": true,
          "title": "Payload",
          "type": "object"
        },
        "correlation_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Correlation Id"
        }
      },
      "required": [
        "audit_id",
        "event_type",
        "event_time",
        "notification_id",
        "notification_type",
        "autonomy_context"
      ],
      "title": "AuditEvent",
      "type": "object"
    },
    "AuditEventListResponse": {
      "$defs": {
        "AuditEvent": {
          "description": "Single audit event.",
          "properties": {
            "audit_id": {
              "format": "uuid",
              "title": "Audit Id",
              "type": "string"
            },
            "event_type": {
              "$ref": "#/$defs/AuditEventType"
            },
            "event_time": {
              "format": "date-time",
              "title": "Event Time",
              "type": "string"
            },
            "notification_id": {
              "format": "uuid",
              "title": "Notification Id",
              "type": "string"
            },
            "notification_type": {
              "title": "Notification Type",
              "type": "string"
            },
            "autonomy_context": {
              "$ref": "#/$defs/AutonomyContextResponse"
            },
            "payload": {
              "additionalProperties": true,
              "title": "Payload",
              "type": "object"
            },
            "correlation_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Correlation Id"
            }
          },
          "required": [
            "audit_id",
            "event_type",
            "event_time",
            "notification_id",
            "notification_type",
            "autonomy_context"
          ],
          "title": "AuditEvent",
          "type": "object"
        },
        "AuditEventType": {
          "description": "Types of audit events.",
          "enum": [
            "notification.created",
            "delivery.started",
            "delivery.channel_attempted",
            "delivery.succeeded",
            "delivery.failed",
            "delivery.deduplicated",
            "delivery.rate_limited",
            "ack.pending",
            "ack.received",
            "ack.dismissed",
            "ack.timed_out",
            "escalation.triggered"
          ],
          "title": "AuditEventType",
          "type": "string"
        },
        "AutonomyContextResponse": {
          "description": "Autonomy context in responses.",
          "properties": {
            "autonomy_mode": {
              "$ref": "#/$defs/AutonomyMode"
            },
            "agent_id": {
              "format": "uuid",
              "title": "Agent Id",
              "type": "string"
            },
            "plan_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Plan Id"
            },
            "decision_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Decision Snapshot Id"
            },
            "execution_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Execution Snapshot Id"
            },
            "skip_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Skip Snapshot Id"
            }
          },
          "required": [
            "autonomy_mode",
            "agent_id"
          ],
          "title": "AutonomyContextResponse",
          "type": "object"
        },
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        },
        "PaginationInfo": {
          "additionalProperties": false,
          "description": "Pagination metadata for list responses.",
          "properties": {
            "next_cursor": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Opaque cursor for next page, null if no more pages",
              "title": "Next Cursor"
            },
            "has_more": {
              "default": false,
              "description": "Whether more pages exist",
              "title": "Has More",
              "type": "boolean"
            },
            "total_count": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Total count (included when efficient to compute)",
              "title": "Total Count"
            }
          },
          "title": "PaginationInfo",
          "type": "object"
        }
      },
      "description": "Paginated list of audit events.",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/$defs/AuditEvent"
          },
          "title": "Items",
          "type": "array"
        },
        "pagination": {
          "$ref": "#/$defs/PaginationInfo"
        }
      },
      "required": [
        "pagination"
      ],
      "title": "AuditEventListResponse",
      "type": "object"
    },
    "AutonomyContextResponse": {
      "$defs": {
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        }
      },
      "description": "Autonomy context in responses.",
      "properties": {
        "autonomy_mode": {
          "$ref": "#/$defs/AutonomyMode"
        },
        "agent_id": {
          "format": "uuid",
          "title": "Agent Id",
          "type": "string"
        },
        "plan_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Plan Id"
        },
        "decision_snapshot_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Decision Snapshot Id"
        },
        "execution_snapshot_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Execution Snapshot Id"
        },
        "skip_snapshot_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Skip Snapshot Id"
        }
      },
      "required": [
        "autonomy_mode",
        "agent_id"
      ],
      "title": "AutonomyContextResponse",
      "type": "object"
    },
    "ConsoleSessionResponse": {
      "description": "Authenticated console principal and capability scopes.",
      "properties": {
        "subject": {
          "title": "Subject",
          "type": "string"
        },
        "scopes": {
          "items": {
            "type": "string"
          },
          "title": "Scopes",
          "type": "array"
        },
        "persistence_mode": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Persistence Mode"
        }
      },
      "required": [
        "subject"
      ],
      "title": "ConsoleSessionResponse",
      "type": "object"
    },
    "DeliveryAttempt": {
      "$defs": {
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        }
      },
      "description": "Single channel delivery attempt.",
      "properties": {
        "attempt_id": {
          "format": "uuid",
          "title": "Attempt Id",
          "type": "string"
        },
        "channel": {
          "$ref": "#/$defs/Channel"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "started_at": {
          "format": "date-time",
          "title": "Started At",
          "type": "string"
        },
        "completed_at": {
          "format": "date-time",
          "title": "Completed At",
          "type": "string"
        },
        "duration_ms": {
          "title": "Duration Ms",
          "type": "integer"
        },
        "error_message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error Message"
        },
        "error_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error Code"
        },
        "metadata": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Metadata"
        }
      },
      "required": [
        "attempt_id",
        "channel",
        "status",
        "started_at",
        "completed_at",
        "duration_ms"
      ],
      "title": "DeliveryAttempt",
      "type": "object"
    },
    "DeliveryTimelineListResponse": {
      "$defs": {
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        },
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "DeliveryStatus": {
          "description": "Outcome of a delivery attempt.",
          "enum": [
            "PENDING",
            "DELIVERED",
            "SUCCESS",
            "FAILED",
            "DEDUPLICATED",
            "RATE_LIMITED"
          ],
          "title": "DeliveryStatus",
          "type": "string"
        },
        "DeliveryTimelineSummary": {
          "description": "Summary view of delivery timeline for list responses.",
          "properties": {
            "notification_id": {
              "format": "uuid",
              "title": "Notification Id",
              "type": "string"
            },
            "notification_type": {
              "title": "Notification Type",
              "type": "string"
            },
            "intent": {
              "$ref": "#/$defs/NotificationIntent"
            },
            "delivery_mode": {
              "$ref": "#/$defs/DeliveryMode"
            },
            "status": {
              "$ref": "#/$defs/DeliveryStatus"
            },
            "created_at": {
              "format": "date-time",
              "title": "Created At",
              "type": "string"
            },
            "delivered_at": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Delivered At"
            },
            "channels_attempted": {
              "items": {
                "$ref": "#/$defs/Channel"
              },
              "title": "Channels Attempted",
              "type": "array"
            },
            "channels_succeeded": {
              "items": {
                "$ref": "#/$defs/Channel"
              },
              "title": "Channels Succeeded",
              "type": "array"
            },
            "autonomy_mode": {
              "$ref": "#/$defs/AutonomyMode"
            },
            "agent_id": {
              "format": "uuid",
              "title": "Agent Id",
              "type": "string"
            }
          },
          "required": [
            "notification_id",
            "notification_type",
            "intent",
            "delivery_mode",
            "status",
            "created_at",
            "autonomy_mode",
            "agent_id"
          ],
          "title": "DeliveryTimelineSummary",
          "type": "object"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        },
        "PaginationInfo": {
          "additionalProperties": false,
          "description": "Pagination metadata for list responses.",
          "properties": {
            "next_cursor": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Opaque cursor for next page, null if no more pages",
              "title": "Next Cursor"
            },
            "has_more": {
              "default": false,
              "description": "Whether more pages exist",
              "title": "Has More",
              "type": "boolean"
            },
            "total_count": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Total count (included when efficient to compute)",
              "title": "Total Count"
            }
          },
          "title": "PaginationInfo",
          "type": "object"
        }
      },
      "description": "Paginated list of delivery timelines.",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/$defs/DeliveryTimelineSummary"
          },
          "title": "Items",
          "type": "array"
        },
        "pagination": {
          "$ref": "#/$defs/PaginationInfo"
        }
      },
      "required": [
        "pagination"
      ],
      "title": "DeliveryTimelineListResponse",
      "type": "object"
    },
    "DeliveryTimelineResponse": {
      "$defs": {
        "AutonomyContextResponse": {
          "description": "Autonomy context in responses.",
          "properties": {
            "autonomy_mode": {
              "$ref": "#/$defs/AutonomyMode"
            },
            "agent_id": {
              "format": "uuid",
              "title": "Agent Id",
              "type": "string"
            },
            "plan_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Plan Id"
            },
            "decision_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Decision Snapshot Id"
            },
            "execution_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Execution Snapshot Id"
            },
            "skip_snapshot_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Skip Snapshot Id"
            }
          },
          "required": [
            "autonomy_mode",
            "agent_id"
          ],
          "title": "AutonomyContextResponse",
          "type": "object"
        },
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        },
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryAttempt": {
          "description": "Single channel delivery attempt.",
          "properties": {
            "attempt_id": {
              "format": "uuid",
              "title": "Attempt Id",
              "type": "string"
            },
            "channel": {
              "$ref": "#/$defs/Channel"
            },
            "status": {
              "title": "Status",
              "type": "string"
            },
            "started_at": {
              "format": "date-time",
              "title": "Started At",
              "type": "string"
            },
            "completed_at": {
              "format": "date-time",
              "title": "Completed At",
              "type": "string"
            },
            "duration_ms": {
              "title": "Duration Ms",
              "type": "integer"
            },
            "error_message": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Error Message"
            },
            "error_code": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Error Code"
            },
            "metadata": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Metadata"
            }
          },
          "required": [
            "attempt_id",
            "channel",
            "status",
            "started_at",
            "completed_at",
            "duration_ms"
          ],
          "title": "DeliveryAttempt",
          "type": "object"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "DeliveryStatus": {
          "description": "Outcome of a delivery attempt.",
          "enum": [
            "PENDING",
            "DELIVERED",
            "SUCCESS",
            "FAILED",
            "DEDUPLICATED",
            "RATE_LIMITED"
          ],
          "title": "DeliveryStatus",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        }
      },
      "description": "Full delivery timeline for a notification.",
      "properties": {
        "runtime_state": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Runtime State"
        },
        "notification_id": {
          "format": "uuid",
          "title": "Notification Id",
          "type": "string"
        },
        "notification_type": {
          "title": "Notification Type",
          "type": "string"
        },
        "intent": {
          "$ref": "#/$defs/NotificationIntent"
        },
        "delivery_mode": {
          "$ref": "#/$defs/DeliveryMode"
        },
        "status": {
          "$ref": "#/$defs/DeliveryStatus"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "delivered_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Delivered At"
        },
        "attempts": {
          "items": {
            "$ref": "#/$defs/DeliveryAttempt"
          },
          "title": "Attempts",
          "type": "array"
        },
        "channels_attempted": {
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels Attempted",
          "type": "array"
        },
        "channels_succeeded": {
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels Succeeded",
          "type": "array"
        },
        "channels_failed": {
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels Failed",
          "type": "array"
        },
        "autonomy_context": {
          "$ref": "#/$defs/AutonomyContextResponse"
        }
      },
      "required": [
        "notification_id",
        "notification_type",
        "intent",
        "delivery_mode",
        "status",
        "created_at",
        "autonomy_context"
      ],
      "title": "DeliveryTimelineResponse",
      "type": "object"
    },
    "DeliveryTimelineSummary": {
      "$defs": {
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        },
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "DeliveryStatus": {
          "description": "Outcome of a delivery attempt.",
          "enum": [
            "PENDING",
            "DELIVERED",
            "SUCCESS",
            "FAILED",
            "DEDUPLICATED",
            "RATE_LIMITED"
          ],
          "title": "DeliveryStatus",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        }
      },
      "description": "Summary view of delivery timeline for list responses.",
      "properties": {
        "notification_id": {
          "format": "uuid",
          "title": "Notification Id",
          "type": "string"
        },
        "notification_type": {
          "title": "Notification Type",
          "type": "string"
        },
        "intent": {
          "$ref": "#/$defs/NotificationIntent"
        },
        "delivery_mode": {
          "$ref": "#/$defs/DeliveryMode"
        },
        "status": {
          "$ref": "#/$defs/DeliveryStatus"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "delivered_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Delivered At"
        },
        "channels_attempted": {
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels Attempted",
          "type": "array"
        },
        "channels_succeeded": {
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels Succeeded",
          "type": "array"
        },
        "autonomy_mode": {
          "$ref": "#/$defs/AutonomyMode"
        },
        "agent_id": {
          "format": "uuid",
          "title": "Agent Id",
          "type": "string"
        }
      },
      "required": [
        "notification_id",
        "notification_type",
        "intent",
        "delivery_mode",
        "status",
        "created_at",
        "autonomy_mode",
        "agent_id"
      ],
      "title": "DeliveryTimelineSummary",
      "type": "object"
    },
    "EffectivePolicyResponse": {
      "$defs": {
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        },
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "EffectivePolicyValues": {
          "description": "Effective policy values that were actually used.",
          "properties": {
            "delivery_mode": {
              "$ref": "#/$defs/DeliveryMode"
            },
            "channels": {
              "items": {
                "$ref": "#/$defs/Channel"
              },
              "title": "Channels",
              "type": "array"
            },
            "require_ack": {
              "title": "Require Ack",
              "type": "boolean"
            },
            "ack_timeout_minutes": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Ack Timeout Minutes"
            },
            "dedup_window_seconds": {
              "title": "Dedup Window Seconds",
              "type": "integer"
            }
          },
          "required": [
            "delivery_mode",
            "channels",
            "require_ack",
            "dedup_window_seconds"
          ],
          "title": "EffectivePolicyValues",
          "type": "object"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        },
        "ResolutionContext": {
          "description": "Context used for policy resolution.",
          "properties": {
            "intent": {
              "$ref": "#/$defs/NotificationIntent"
            },
            "autonomy_mode": {
              "$ref": "#/$defs/AutonomyMode"
            },
            "irreversible": {
              "title": "Irreversible",
              "type": "boolean"
            },
            "policy_found": {
              "title": "Policy Found",
              "type": "boolean"
            },
            "policy_notification_type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Policy Notification Type"
            }
          },
          "required": [
            "intent",
            "autonomy_mode",
            "irreversible",
            "policy_found"
          ],
          "title": "ResolutionContext",
          "type": "object"
        },
        "ResolutionSource": {
          "description": "Source of a policy resolution value.",
          "enum": [
            "explicit_override",
            "mode_override",
            "policy_base",
            "sdk_default"
          ],
          "title": "ResolutionSource",
          "type": "string"
        },
        "ResolutionStep": {
          "description": "Single step in policy resolution chain.",
          "properties": {
            "source": {
              "$ref": "#/$defs/ResolutionSource"
            },
            "value": {
              "description": "The value at this resolution step",
              "title": "Value"
            },
            "applied": {
              "description": "Whether this value was used",
              "title": "Applied",
              "type": "boolean"
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Explanation if not applied",
              "title": "Reason"
            }
          },
          "required": [
            "source",
            "value",
            "applied"
          ],
          "title": "ResolutionStep",
          "type": "object"
        }
      },
      "description": "Response for effective policy resolution.",
      "properties": {
        "notification_type": {
          "title": "Notification Type",
          "type": "string"
        },
        "effective": {
          "$ref": "#/$defs/EffectivePolicyValues"
        },
        "resolution": {
          "additionalProperties": {
            "items": {
              "$ref": "#/$defs/ResolutionStep"
            },
            "type": "array"
          },
          "description": "Resolution trace for each field",
          "title": "Resolution",
          "type": "object"
        },
        "resolution_context": {
          "$ref": "#/$defs/ResolutionContext"
        }
      },
      "required": [
        "notification_type",
        "effective",
        "resolution",
        "resolution_context"
      ],
      "title": "EffectivePolicyResponse",
      "type": "object"
    },
    "EffectivePolicyValues": {
      "$defs": {
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        }
      },
      "description": "Effective policy values that were actually used.",
      "properties": {
        "delivery_mode": {
          "$ref": "#/$defs/DeliveryMode"
        },
        "channels": {
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels",
          "type": "array"
        },
        "require_ack": {
          "title": "Require Ack",
          "type": "boolean"
        },
        "ack_timeout_minutes": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Ack Timeout Minutes"
        },
        "dedup_window_seconds": {
          "title": "Dedup Window Seconds",
          "type": "integer"
        }
      },
      "required": [
        "delivery_mode",
        "channels",
        "require_ack",
        "dedup_window_seconds"
      ],
      "title": "EffectivePolicyValues",
      "type": "object"
    },
    "ErrorDetail": {
      "description": "Error detail structure.",
      "properties": {
        "code": {
          "description": "Machine-readable error code",
          "title": "Code",
          "type": "string"
        },
        "message": {
          "description": "Human-readable description",
          "title": "Message",
          "type": "string"
        },
        "details": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Additional context",
          "title": "Details"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "title": "ErrorDetail",
      "type": "object"
    },
    "EvidenceLink": {
      "description": "Link to evidence for an invariant.",
      "properties": {
        "path": {
          "description": "Repo-relative path",
          "title": "Path",
          "type": "string"
        },
        "note": {
          "description": "Description of what this evidences",
          "title": "Note",
          "type": "string"
        },
        "line_ref": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional line reference",
          "title": "Line Ref"
        }
      },
      "required": [
        "path",
        "note"
      ],
      "title": "EvidenceLink",
      "type": "object"
    },
    "InvariantEnforcement": {
      "$defs": {
        "EnforcementType": {
          "description": "Invariant enforcement mechanism.",
          "enum": [
            "guard",
            "isolation",
            "test",
            "exception"
          ],
          "title": "EnforcementType",
          "type": "string"
        }
      },
      "description": "Enforcement details for an invariant.",
      "properties": {
        "type": {
          "$ref": "#/$defs/EnforcementType"
        },
        "description": {
          "title": "Description",
          "type": "string"
        }
      },
      "required": [
        "type",
        "description"
      ],
      "title": "InvariantEnforcement",
      "type": "object"
    },
    "InvariantEntry": {
      "$defs": {
        "EnforcementType": {
          "description": "Invariant enforcement mechanism.",
          "enum": [
            "guard",
            "isolation",
            "test",
            "exception"
          ],
          "title": "EnforcementType",
          "type": "string"
        },
        "EvidenceLink": {
          "description": "Link to evidence for an invariant.",
          "properties": {
            "path": {
              "description": "Repo-relative path",
              "title": "Path",
              "type": "string"
            },
            "note": {
              "description": "Description of what this evidences",
              "title": "Note",
              "type": "string"
            },
            "line_ref": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Optional line reference",
              "title": "Line Ref"
            }
          },
          "required": [
            "path",
            "note"
          ],
          "title": "EvidenceLink",
          "type": "object"
        },
        "InvariantEnforcement": {
          "description": "Enforcement details for an invariant.",
          "properties": {
            "type": {
              "$ref": "#/$defs/EnforcementType"
            },
            "description": {
              "title": "Description",
              "type": "string"
            }
          },
          "required": [
            "type",
            "description"
          ],
          "title": "InvariantEnforcement",
          "type": "object"
        },
        "InvariantSeverity": {
          "description": "Invariant severity level.",
          "enum": [
            "HIGH",
            "MEDIUM",
            "LOW"
          ],
          "title": "InvariantSeverity",
          "type": "string"
        },
        "InvariantStatus": {
          "description": "Invariant status.",
          "enum": [
            "active",
            "inactive"
          ],
          "title": "InvariantStatus",
          "type": "string"
        }
      },
      "description": "Single invariant entry.",
      "properties": {
        "id": {
          "description": "e.g., INV-ACK-001",
          "title": "Id",
          "type": "string"
        },
        "statement": {
          "description": "The invariant claim",
          "title": "Statement",
          "type": "string"
        },
        "severity": {
          "$ref": "#/$defs/InvariantSeverity"
        },
        "status": {
          "$ref": "#/$defs/InvariantStatus"
        },
        "enforcement": {
          "$ref": "#/$defs/InvariantEnforcement"
        },
        "evidence": {
          "items": {
            "$ref": "#/$defs/EvidenceLink"
          },
          "title": "Evidence",
          "type": "array"
        },
        "owner": {
          "description": "Team/role responsible",
          "title": "Owner",
          "type": "string"
        },
        "last_reviewed": {
          "description": "ISO 8601 date",
          "title": "Last Reviewed",
          "type": "string"
        },
        "mitigation": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "For exceptions only",
          "title": "Mitigation"
        }
      },
      "required": [
        "id",
        "statement",
        "severity",
        "status",
        "enforcement",
        "owner",
        "last_reviewed"
      ],
      "title": "InvariantEntry",
      "type": "object"
    },
    "InvariantListResponse": {
      "$defs": {
        "EnforcementType": {
          "description": "Invariant enforcement mechanism.",
          "enum": [
            "guard",
            "isolation",
            "test",
            "exception"
          ],
          "title": "EnforcementType",
          "type": "string"
        },
        "EvidenceLink": {
          "description": "Link to evidence for an invariant.",
          "properties": {
            "path": {
              "description": "Repo-relative path",
              "title": "Path",
              "type": "string"
            },
            "note": {
              "description": "Description of what this evidences",
              "title": "Note",
              "type": "string"
            },
            "line_ref": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Optional line reference",
              "title": "Line Ref"
            }
          },
          "required": [
            "path",
            "note"
          ],
          "title": "EvidenceLink",
          "type": "object"
        },
        "InvariantEnforcement": {
          "description": "Enforcement details for an invariant.",
          "properties": {
            "type": {
              "$ref": "#/$defs/EnforcementType"
            },
            "description": {
              "title": "Description",
              "type": "string"
            }
          },
          "required": [
            "type",
            "description"
          ],
          "title": "InvariantEnforcement",
          "type": "object"
        },
        "InvariantEntry": {
          "description": "Single invariant entry.",
          "properties": {
            "id": {
              "description": "e.g., INV-ACK-001",
              "title": "Id",
              "type": "string"
            },
            "statement": {
              "description": "The invariant claim",
              "title": "Statement",
              "type": "string"
            },
            "severity": {
              "$ref": "#/$defs/InvariantSeverity"
            },
            "status": {
              "$ref": "#/$defs/InvariantStatus"
            },
            "enforcement": {
              "$ref": "#/$defs/InvariantEnforcement"
            },
            "evidence": {
              "items": {
                "$ref": "#/$defs/EvidenceLink"
              },
              "title": "Evidence",
              "type": "array"
            },
            "owner": {
              "description": "Team/role responsible",
              "title": "Owner",
              "type": "string"
            },
            "last_reviewed": {
              "description": "ISO 8601 date",
              "title": "Last Reviewed",
              "type": "string"
            },
            "mitigation": {
              "anyOf": [
                {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "For exceptions only",
              "title": "Mitigation"
            }
          },
          "required": [
            "id",
            "statement",
            "severity",
            "status",
            "enforcement",
            "owner",
            "last_reviewed"
          ],
          "title": "InvariantEntry",
          "type": "object"
        },
        "InvariantSeverity": {
          "description": "Invariant severity level.",
          "enum": [
            "HIGH",
            "MEDIUM",
            "LOW"
          ],
          "title": "InvariantSeverity",
          "type": "string"
        },
        "InvariantStatus": {
          "description": "Invariant status.",
          "enum": [
            "active",
            "inactive"
          ],
          "title": "InvariantStatus",
          "type": "string"
        },
        "PaginationInfo": {
          "additionalProperties": false,
          "description": "Pagination metadata for list responses.",
          "properties": {
            "next_cursor": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Opaque cursor for next page, null if no more pages",
              "title": "Next Cursor"
            },
            "has_more": {
              "default": false,
              "description": "Whether more pages exist",
              "title": "Has More",
              "type": "boolean"
            },
            "total_count": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Total count (included when efficient to compute)",
              "title": "Total Count"
            }
          },
          "title": "PaginationInfo",
          "type": "object"
        }
      },
      "description": "Paginated list of invariants.",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/$defs/InvariantEntry"
          },
          "title": "Items",
          "type": "array"
        },
        "pagination": {
          "$ref": "#/$defs/PaginationInfo"
        }
      },
      "required": [
        "pagination"
      ],
      "title": "InvariantListResponse",
      "type": "object"
    },
    "InvariantSummaryResponse": {
      "description": "Summary statistics for invariants.",
      "properties": {
        "total_count": {
          "title": "Total Count",
          "type": "integer"
        },
        "by_severity": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "By Severity",
          "type": "object"
        },
        "by_enforcement_type": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "By Enforcement Type",
          "type": "object"
        },
        "by_status": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "By Status",
          "type": "object"
        },
        "exceptions_requiring_review": {
          "title": "Exceptions Requiring Review",
          "type": "integer"
        },
        "last_updated": {
          "title": "Last Updated",
          "type": "string"
        }
      },
      "required": [
        "total_count",
        "by_severity",
        "by_enforcement_type",
        "by_status",
        "exceptions_requiring_review",
        "last_updated"
      ],
      "title": "InvariantSummaryResponse",
      "type": "object"
    },
    "PaginationInfo": {
      "additionalProperties": false,
      "description": "Pagination metadata for list responses.",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Opaque cursor for next page, null if no more pages",
          "title": "Next Cursor"
        },
        "has_more": {
          "default": false,
          "description": "Whether more pages exist",
          "title": "Has More",
          "type": "boolean"
        },
        "total_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Total count (included when efficient to compute)",
          "title": "Total Count"
        }
      },
      "title": "PaginationInfo",
      "type": "object"
    },
    "PolicyGuardResultItem": {
      "description": "Guard check evidence for a policy delta transition.",
      "properties": {
        "candidate_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Candidate Hash"
        },
        "stage": {
          "title": "Stage",
          "type": "string"
        },
        "allowed": {
          "title": "Allowed",
          "type": "boolean"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Reason"
        },
        "reason_detail": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Reason Detail"
        },
        "checks": {
          "additionalProperties": true,
          "title": "Checks",
          "type": "object"
        },
        "checked_at": {
          "format": "date-time",
          "title": "Checked At",
          "type": "string"
        }
      },
      "required": [
        "stage",
        "allowed",
        "checked_at"
      ],
      "title": "PolicyGuardResultItem",
      "type": "object"
    },
    "PolicyProposalListResponse": {
      "$defs": {
        "PolicyGuardResultItem": {
          "description": "Guard check evidence for a policy delta transition.",
          "properties": {
            "candidate_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Candidate Hash"
            },
            "stage": {
              "title": "Stage",
              "type": "string"
            },
            "allowed": {
              "title": "Allowed",
              "type": "boolean"
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason"
            },
            "reason_detail": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason Detail"
            },
            "checks": {
              "additionalProperties": true,
              "title": "Checks",
              "type": "object"
            },
            "checked_at": {
              "format": "date-time",
              "title": "Checked At",
              "type": "string"
            }
          },
          "required": [
            "stage",
            "allowed",
            "checked_at"
          ],
          "title": "PolicyGuardResultItem",
          "type": "object"
        },
        "PolicyProposalSummary": {
          "description": "Full representation of a PolicyDelta proposal, shadow evidence, and guard status.",
          "properties": {
            "delta_id": {
              "format": "uuid",
              "title": "Delta Id",
              "type": "string"
            },
            "policy_type": {
              "title": "Policy Type",
              "type": "string"
            },
            "field_path": {
              "title": "Field Path",
              "type": "string"
            },
            "current_value": {
              "title": "Current Value"
            },
            "proposed_value": {
              "title": "Proposed Value"
            },
            "reasoning": {
              "title": "Reasoning",
              "type": "string"
            },
            "confidence": {
              "title": "Confidence",
              "type": "number"
            },
            "evidence_count": {
              "title": "Evidence Count",
              "type": "integer"
            },
            "state": {
              "title": "State",
              "type": "string"
            },
            "baseline_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Baseline Hash"
            },
            "baseline_version": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Baseline Version"
            },
            "candidate_hash": {
              "title": "Candidate Hash",
              "type": "string"
            },
            "approval_candidate_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Approval Candidate Hash"
            },
            "current_active_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Current Active Hash"
            },
            "current_active_version": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Current Active Version"
            },
            "baseline_hash_matches": {
              "default": false,
              "title": "Baseline Hash Matches",
              "type": "boolean"
            },
            "evidence_hash_matches": {
              "default": false,
              "title": "Evidence Hash Matches",
              "type": "boolean"
            },
            "can_promote_to_shadow": {
              "default": false,
              "title": "Can Promote To Shadow",
              "type": "boolean"
            },
            "can_approve": {
              "default": false,
              "title": "Can Approve",
              "type": "boolean"
            },
            "can_activate": {
              "default": false,
              "title": "Can Activate",
              "type": "boolean"
            },
            "draft_policy_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Draft Policy Id"
            },
            "draft_version": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Draft Version"
            },
            "required_guards": {
              "items": {
                "type": "string"
              },
              "title": "Required Guards",
              "type": "array"
            },
            "guard_results": {
              "items": {
                "$ref": "#/$defs/PolicyGuardResultItem"
              },
              "title": "Guard Results",
              "type": "array"
            },
            "transition_history": {
              "items": {
                "$ref": "#/$defs/PolicyTransitionItem"
              },
              "title": "Transition History",
              "type": "array"
            },
            "shadow_aggregate": {
              "anyOf": [
                {
                  "$ref": "#/$defs/ShadowEvaluationSummaryItem"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            },
            "shadow_results": {
              "items": {
                "$ref": "#/$defs/ShadowEvaluationSampleItem"
              },
              "title": "Shadow Results",
              "type": "array"
            },
            "proposed_by": {
              "title": "Proposed By",
              "type": "string"
            },
            "approved_by": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Approved By"
            },
            "rejected_by": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rejected By"
            },
            "rejection_reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rejection Reason"
            },
            "applied_at": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Applied At"
            },
            "created_at": {
              "format": "date-time",
              "title": "Created At",
              "type": "string"
            },
            "updated_at": {
              "format": "date-time",
              "title": "Updated At",
              "type": "string"
            }
          },
          "required": [
            "delta_id",
            "policy_type",
            "field_path",
            "current_value",
            "proposed_value",
            "reasoning",
            "confidence",
            "evidence_count",
            "state",
            "candidate_hash",
            "proposed_by",
            "created_at",
            "updated_at"
          ],
          "title": "PolicyProposalSummary",
          "type": "object"
        },
        "PolicyTransitionItem": {
          "description": "Audit entry for a policy delta state transition.",
          "properties": {
            "from_state": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "From State"
            },
            "to_state": {
              "title": "To State",
              "type": "string"
            },
            "actor": {
              "title": "Actor",
              "type": "string"
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason"
            },
            "guard_stage": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Guard Stage"
            },
            "transitioned_at": {
              "format": "date-time",
              "title": "Transitioned At",
              "type": "string"
            }
          },
          "required": [
            "to_state",
            "actor",
            "transitioned_at"
          ],
          "title": "PolicyTransitionItem",
          "type": "object"
        },
        "ShadowEvaluationSampleItem": {
          "description": "Individual shadow evaluation decision sample.",
          "properties": {
            "result_id": {
              "format": "uuid",
              "title": "Result Id",
              "type": "string"
            },
            "delta_id": {
              "format": "uuid",
              "title": "Delta Id",
              "type": "string"
            },
            "decision_id": {
              "title": "Decision Id",
              "type": "string"
            },
            "original_outcome": {
              "additionalProperties": true,
              "title": "Original Outcome",
              "type": "object"
            },
            "shadow_outcome": {
              "additionalProperties": true,
              "title": "Shadow Outcome",
              "type": "object"
            },
            "changed": {
              "title": "Changed",
              "type": "boolean"
            },
            "improvement_score": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Improvement Score"
            },
            "evaluated_at": {
              "format": "date-time",
              "title": "Evaluated At",
              "type": "string"
            }
          },
          "required": [
            "result_id",
            "delta_id",
            "decision_id",
            "changed",
            "evaluated_at"
          ],
          "title": "ShadowEvaluationSampleItem",
          "type": "object"
        },
        "ShadowEvaluationSummaryItem": {
          "description": "Aggregate shadow evaluation summary for a policy delta.",
          "properties": {
            "aggregate_id": {
              "format": "uuid",
              "title": "Aggregate Id",
              "type": "string"
            },
            "delta_id": {
              "format": "uuid",
              "title": "Delta Id",
              "type": "string"
            },
            "baseline_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Baseline Hash"
            },
            "candidate_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Candidate Hash"
            },
            "evaluated_by": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Evaluated By"
            },
            "total_decisions": {
              "title": "Total Decisions",
              "type": "integer"
            },
            "improved_decisions": {
              "title": "Improved Decisions",
              "type": "integer"
            },
            "degraded_decisions": {
              "title": "Degraded Decisions",
              "type": "integer"
            },
            "neutral_decisions": {
              "title": "Neutral Decisions",
              "type": "integer"
            },
            "win_rate": {
              "title": "Win Rate",
              "type": "number"
            },
            "min_sample_met": {
              "title": "Min Sample Met",
              "type": "boolean"
            },
            "accuracy_threshold_met": {
              "title": "Accuracy Threshold Met",
              "type": "boolean"
            },
            "status": {
              "title": "Status",
              "type": "string"
            },
            "can_promote_to_approval": {
              "title": "Can Promote To Approval",
              "type": "boolean"
            },
            "computed_at": {
              "format": "date-time",
              "title": "Computed At",
              "type": "string"
            }
          },
          "required": [
            "aggregate_id",
            "delta_id",
            "total_decisions",
            "improved_decisions",
            "degraded_decisions",
            "neutral_decisions",
            "win_rate",
            "min_sample_met",
            "accuracy_threshold_met",
            "status",
            "can_promote_to_approval",
            "computed_at"
          ],
          "title": "ShadowEvaluationSummaryItem",
          "type": "object"
        }
      },
      "description": "List of governed policy delta proposals and shadow evidence.",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/$defs/PolicyProposalSummary"
          },
          "title": "Items",
          "type": "array"
        },
        "total_count": {
          "title": "Total Count",
          "type": "integer"
        }
      },
      "required": [
        "total_count"
      ],
      "title": "PolicyProposalListResponse",
      "type": "object"
    },
    "PolicyProposalSummary": {
      "$defs": {
        "PolicyGuardResultItem": {
          "description": "Guard check evidence for a policy delta transition.",
          "properties": {
            "candidate_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Candidate Hash"
            },
            "stage": {
              "title": "Stage",
              "type": "string"
            },
            "allowed": {
              "title": "Allowed",
              "type": "boolean"
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason"
            },
            "reason_detail": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason Detail"
            },
            "checks": {
              "additionalProperties": true,
              "title": "Checks",
              "type": "object"
            },
            "checked_at": {
              "format": "date-time",
              "title": "Checked At",
              "type": "string"
            }
          },
          "required": [
            "stage",
            "allowed",
            "checked_at"
          ],
          "title": "PolicyGuardResultItem",
          "type": "object"
        },
        "PolicyTransitionItem": {
          "description": "Audit entry for a policy delta state transition.",
          "properties": {
            "from_state": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "From State"
            },
            "to_state": {
              "title": "To State",
              "type": "string"
            },
            "actor": {
              "title": "Actor",
              "type": "string"
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason"
            },
            "guard_stage": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Guard Stage"
            },
            "transitioned_at": {
              "format": "date-time",
              "title": "Transitioned At",
              "type": "string"
            }
          },
          "required": [
            "to_state",
            "actor",
            "transitioned_at"
          ],
          "title": "PolicyTransitionItem",
          "type": "object"
        },
        "ShadowEvaluationSampleItem": {
          "description": "Individual shadow evaluation decision sample.",
          "properties": {
            "result_id": {
              "format": "uuid",
              "title": "Result Id",
              "type": "string"
            },
            "delta_id": {
              "format": "uuid",
              "title": "Delta Id",
              "type": "string"
            },
            "decision_id": {
              "title": "Decision Id",
              "type": "string"
            },
            "original_outcome": {
              "additionalProperties": true,
              "title": "Original Outcome",
              "type": "object"
            },
            "shadow_outcome": {
              "additionalProperties": true,
              "title": "Shadow Outcome",
              "type": "object"
            },
            "changed": {
              "title": "Changed",
              "type": "boolean"
            },
            "improvement_score": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Improvement Score"
            },
            "evaluated_at": {
              "format": "date-time",
              "title": "Evaluated At",
              "type": "string"
            }
          },
          "required": [
            "result_id",
            "delta_id",
            "decision_id",
            "changed",
            "evaluated_at"
          ],
          "title": "ShadowEvaluationSampleItem",
          "type": "object"
        },
        "ShadowEvaluationSummaryItem": {
          "description": "Aggregate shadow evaluation summary for a policy delta.",
          "properties": {
            "aggregate_id": {
              "format": "uuid",
              "title": "Aggregate Id",
              "type": "string"
            },
            "delta_id": {
              "format": "uuid",
              "title": "Delta Id",
              "type": "string"
            },
            "baseline_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Baseline Hash"
            },
            "candidate_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Candidate Hash"
            },
            "evaluated_by": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Evaluated By"
            },
            "total_decisions": {
              "title": "Total Decisions",
              "type": "integer"
            },
            "improved_decisions": {
              "title": "Improved Decisions",
              "type": "integer"
            },
            "degraded_decisions": {
              "title": "Degraded Decisions",
              "type": "integer"
            },
            "neutral_decisions": {
              "title": "Neutral Decisions",
              "type": "integer"
            },
            "win_rate": {
              "title": "Win Rate",
              "type": "number"
            },
            "min_sample_met": {
              "title": "Min Sample Met",
              "type": "boolean"
            },
            "accuracy_threshold_met": {
              "title": "Accuracy Threshold Met",
              "type": "boolean"
            },
            "status": {
              "title": "Status",
              "type": "string"
            },
            "can_promote_to_approval": {
              "title": "Can Promote To Approval",
              "type": "boolean"
            },
            "computed_at": {
              "format": "date-time",
              "title": "Computed At",
              "type": "string"
            }
          },
          "required": [
            "aggregate_id",
            "delta_id",
            "total_decisions",
            "improved_decisions",
            "degraded_decisions",
            "neutral_decisions",
            "win_rate",
            "min_sample_met",
            "accuracy_threshold_met",
            "status",
            "can_promote_to_approval",
            "computed_at"
          ],
          "title": "ShadowEvaluationSummaryItem",
          "type": "object"
        }
      },
      "description": "Full representation of a PolicyDelta proposal, shadow evidence, and guard status.",
      "properties": {
        "delta_id": {
          "format": "uuid",
          "title": "Delta Id",
          "type": "string"
        },
        "policy_type": {
          "title": "Policy Type",
          "type": "string"
        },
        "field_path": {
          "title": "Field Path",
          "type": "string"
        },
        "current_value": {
          "title": "Current Value"
        },
        "proposed_value": {
          "title": "Proposed Value"
        },
        "reasoning": {
          "title": "Reasoning",
          "type": "string"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "evidence_count": {
          "title": "Evidence Count",
          "type": "integer"
        },
        "state": {
          "title": "State",
          "type": "string"
        },
        "baseline_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Baseline Hash"
        },
        "baseline_version": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Baseline Version"
        },
        "candidate_hash": {
          "title": "Candidate Hash",
          "type": "string"
        },
        "approval_candidate_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Approval Candidate Hash"
        },
        "current_active_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Active Hash"
        },
        "current_active_version": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Active Version"
        },
        "baseline_hash_matches": {
          "default": false,
          "title": "Baseline Hash Matches",
          "type": "boolean"
        },
        "evidence_hash_matches": {
          "default": false,
          "title": "Evidence Hash Matches",
          "type": "boolean"
        },
        "can_promote_to_shadow": {
          "default": false,
          "title": "Can Promote To Shadow",
          "type": "boolean"
        },
        "can_approve": {
          "default": false,
          "title": "Can Approve",
          "type": "boolean"
        },
        "can_activate": {
          "default": false,
          "title": "Can Activate",
          "type": "boolean"
        },
        "draft_policy_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Draft Policy Id"
        },
        "draft_version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Draft Version"
        },
        "required_guards": {
          "items": {
            "type": "string"
          },
          "title": "Required Guards",
          "type": "array"
        },
        "guard_results": {
          "items": {
            "$ref": "#/$defs/PolicyGuardResultItem"
          },
          "title": "Guard Results",
          "type": "array"
        },
        "transition_history": {
          "items": {
            "$ref": "#/$defs/PolicyTransitionItem"
          },
          "title": "Transition History",
          "type": "array"
        },
        "shadow_aggregate": {
          "anyOf": [
            {
              "$ref": "#/$defs/ShadowEvaluationSummaryItem"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "shadow_results": {
          "items": {
            "$ref": "#/$defs/ShadowEvaluationSampleItem"
          },
          "title": "Shadow Results",
          "type": "array"
        },
        "proposed_by": {
          "title": "Proposed By",
          "type": "string"
        },
        "approved_by": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Approved By"
        },
        "rejected_by": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Rejected By"
        },
        "rejection_reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Rejection Reason"
        },
        "applied_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Applied At"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "delta_id",
        "policy_type",
        "field_path",
        "current_value",
        "proposed_value",
        "reasoning",
        "confidence",
        "evidence_count",
        "state",
        "candidate_hash",
        "proposed_by",
        "created_at",
        "updated_at"
      ],
      "title": "PolicyProposalSummary",
      "type": "object"
    },
    "PolicyRevisionListResponse": {
      "$defs": {
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        },
        "PolicyRevisionSummary": {
          "description": "Summary of a persisted notification routing policy revision for governance and lineage.",
          "properties": {
            "policy_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Persisted policy revision identifier",
              "title": "Policy Id"
            },
            "notification_type": {
              "description": "Policy notification_type identifier",
              "title": "Notification Type",
              "type": "string"
            },
            "version": {
              "description": "Policy version",
              "title": "Version",
              "type": "string"
            },
            "status": {
              "description": "Lifecycle status (ACTIVE, DRAFT, PREVIEW, RETIRED)",
              "title": "Status",
              "type": "string"
            },
            "config_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Semantic policy content hash",
              "title": "Config Hash"
            },
            "previous_version_id": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Previous policy version ID in lifecycle lineage",
              "title": "Previous Version Id"
            },
            "intent": {
              "anyOf": [
                {
                  "$ref": "#/$defs/NotificationIntent"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default notification intent"
            },
            "channels": {
              "description": "Default LIVE channels",
              "items": {
                "$ref": "#/$defs/Channel"
              },
              "title": "Channels",
              "type": "array"
            },
            "delivery_mode": {
              "anyOf": [
                {
                  "$ref": "#/$defs/DeliveryMode"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE delivery mode"
            },
            "require_ack": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE ack requirement",
              "title": "Require Ack"
            },
            "ack_timeout_minutes": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE ack timeout in minutes",
              "title": "Ack Timeout Minutes"
            },
            "ack_timeout_seconds": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Default LIVE ack timeout in seconds",
              "title": "Ack Timeout Seconds"
            },
            "dedup_window_seconds": {
              "description": "Deduplication window in seconds",
              "title": "Dedup Window Seconds",
              "type": "integer"
            },
            "created_at": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "When the policy revision was created",
              "title": "Created At"
            },
            "updated_at": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "When the policy revision was last updated",
              "title": "Updated At"
            },
            "activated_at": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "When the policy revision became ACTIVE",
              "title": "Activated At"
            },
            "retired_at": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "When the policy revision was retired",
              "title": "Retired At"
            }
          },
          "required": [
            "notification_type",
            "version",
            "status",
            "dedup_window_seconds"
          ],
          "title": "PolicyRevisionSummary",
          "type": "object"
        }
      },
      "description": "Catalog of notification routing policy revisions across lifecycle statuses.",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/$defs/PolicyRevisionSummary"
          },
          "title": "Items",
          "type": "array"
        },
        "total_count": {
          "description": "Total number of policy revisions",
          "title": "Total Count",
          "type": "integer"
        }
      },
      "required": [
        "total_count"
      ],
      "title": "PolicyRevisionListResponse",
      "type": "object"
    },
    "PolicyRevisionSummary": {
      "$defs": {
        "Channel": {
          "description": "Supported delivery channels for notifications.",
          "enum": [
            "SLACK",
            "EMAIL",
            "WEBSOCKET",
            "PAGERDUTY"
          ],
          "title": "Channel",
          "type": "string"
        },
        "DeliveryMode": {
          "description": "Delivery reliability semantics.\n\nGUARANTEED: Must raise error if all persistent channels fail.\nBEST_EFFORT: May fail silently but must log failure.\n\nInvariants:\n- SAFETY -> GUARANTEED\n- GOVERNANCE -> GUARANTEED\n- OPERATIONAL -> BEST_EFFORT\n- INFORMATIONAL -> BEST_EFFORT",
          "enum": [
            "GUARANTEED",
            "BEST_EFFORT"
          ],
          "title": "DeliveryMode",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        }
      },
      "description": "Summary of a persisted notification routing policy revision for governance and lineage.",
      "properties": {
        "policy_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Persisted policy revision identifier",
          "title": "Policy Id"
        },
        "notification_type": {
          "description": "Policy notification_type identifier",
          "title": "Notification Type",
          "type": "string"
        },
        "version": {
          "description": "Policy version",
          "title": "Version",
          "type": "string"
        },
        "status": {
          "description": "Lifecycle status (ACTIVE, DRAFT, PREVIEW, RETIRED)",
          "title": "Status",
          "type": "string"
        },
        "config_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Semantic policy content hash",
          "title": "Config Hash"
        },
        "previous_version_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Previous policy version ID in lifecycle lineage",
          "title": "Previous Version Id"
        },
        "intent": {
          "anyOf": [
            {
              "$ref": "#/$defs/NotificationIntent"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default notification intent"
        },
        "channels": {
          "description": "Default LIVE channels",
          "items": {
            "$ref": "#/$defs/Channel"
          },
          "title": "Channels",
          "type": "array"
        },
        "delivery_mode": {
          "anyOf": [
            {
              "$ref": "#/$defs/DeliveryMode"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE delivery mode"
        },
        "require_ack": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE ack requirement",
          "title": "Require Ack"
        },
        "ack_timeout_minutes": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE ack timeout in minutes",
          "title": "Ack Timeout Minutes"
        },
        "ack_timeout_seconds": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Default LIVE ack timeout in seconds",
          "title": "Ack Timeout Seconds"
        },
        "dedup_window_seconds": {
          "description": "Deduplication window in seconds",
          "title": "Dedup Window Seconds",
          "type": "integer"
        },
        "created_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When the policy revision was created",
          "title": "Created At"
        },
        "updated_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When the policy revision was last updated",
          "title": "Updated At"
        },
        "activated_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When the policy revision became ACTIVE",
          "title": "Activated At"
        },
        "retired_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When the policy revision was retired",
          "title": "Retired At"
        }
      },
      "required": [
        "notification_type",
        "version",
        "status",
        "dedup_window_seconds"
      ],
      "title": "PolicyRevisionSummary",
      "type": "object"
    },
    "PolicyTransitionItem": {
      "description": "Audit entry for a policy delta state transition.",
      "properties": {
        "from_state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From State"
        },
        "to_state": {
          "title": "To State",
          "type": "string"
        },
        "actor": {
          "title": "Actor",
          "type": "string"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Reason"
        },
        "guard_stage": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Guard Stage"
        },
        "transitioned_at": {
          "format": "date-time",
          "title": "Transitioned At",
          "type": "string"
        }
      },
      "required": [
        "to_state",
        "actor",
        "transitioned_at"
      ],
      "title": "PolicyTransitionItem",
      "type": "object"
    },
    "ResolutionContext": {
      "$defs": {
        "AutonomyMode": {
          "description": "Operating mode of the autonomous agent.\n\nAffects channel routing and acknowledgment requirements.\n\nChannel routing varies by mode:\n- PREVIEW: All intents -> WebSocket only\n- SHADOW: OPERATIONAL -> WebSocket, GOVERNANCE -> Slack + WebSocket\n- LIVE: Full channel routing based on intent",
          "enum": [
            "PREVIEW",
            "SHADOW",
            "LIVE"
          ],
          "title": "AutonomyMode",
          "type": "string"
        },
        "NotificationIntent": {
          "description": "Classification of notification urgency and handling requirements.\n\nInvariants:\n- SAFETY and GOVERNANCE imply elevated delivery guarantees (GUARANTEED mode)\n- OPERATIONAL and INFORMATIONAL use BEST_EFFORT mode by default",
          "enum": [
            "SAFETY",
            "GOVERNANCE",
            "OPERATIONAL",
            "INFORMATIONAL"
          ],
          "title": "NotificationIntent",
          "type": "string"
        }
      },
      "description": "Context used for policy resolution.",
      "properties": {
        "intent": {
          "$ref": "#/$defs/NotificationIntent"
        },
        "autonomy_mode": {
          "$ref": "#/$defs/AutonomyMode"
        },
        "irreversible": {
          "title": "Irreversible",
          "type": "boolean"
        },
        "policy_found": {
          "title": "Policy Found",
          "type": "boolean"
        },
        "policy_notification_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Policy Notification Type"
        }
      },
      "required": [
        "intent",
        "autonomy_mode",
        "irreversible",
        "policy_found"
      ],
      "title": "ResolutionContext",
      "type": "object"
    },
    "ResolutionStep": {
      "$defs": {
        "ResolutionSource": {
          "description": "Source of a policy resolution value.",
          "enum": [
            "explicit_override",
            "mode_override",
            "policy_base",
            "sdk_default"
          ],
          "title": "ResolutionSource",
          "type": "string"
        }
      },
      "description": "Single step in policy resolution chain.",
      "properties": {
        "source": {
          "$ref": "#/$defs/ResolutionSource"
        },
        "value": {
          "description": "The value at this resolution step",
          "title": "Value"
        },
        "applied": {
          "description": "Whether this value was used",
          "title": "Applied",
          "type": "boolean"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Explanation if not applied",
          "title": "Reason"
        }
      },
      "required": [
        "source",
        "value",
        "applied"
      ],
      "title": "ResolutionStep",
      "type": "object"
    },
    "ShadowEvaluationSampleItem": {
      "description": "Individual shadow evaluation decision sample.",
      "properties": {
        "result_id": {
          "format": "uuid",
          "title": "Result Id",
          "type": "string"
        },
        "delta_id": {
          "format": "uuid",
          "title": "Delta Id",
          "type": "string"
        },
        "decision_id": {
          "title": "Decision Id",
          "type": "string"
        },
        "original_outcome": {
          "additionalProperties": true,
          "title": "Original Outcome",
          "type": "object"
        },
        "shadow_outcome": {
          "additionalProperties": true,
          "title": "Shadow Outcome",
          "type": "object"
        },
        "changed": {
          "title": "Changed",
          "type": "boolean"
        },
        "improvement_score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Improvement Score"
        },
        "evaluated_at": {
          "format": "date-time",
          "title": "Evaluated At",
          "type": "string"
        }
      },
      "required": [
        "result_id",
        "delta_id",
        "decision_id",
        "changed",
        "evaluated_at"
      ],
      "title": "ShadowEvaluationSampleItem",
      "type": "object"
    },
    "ShadowEvaluationSummaryItem": {
      "description": "Aggregate shadow evaluation summary for a policy delta.",
      "properties": {
        "aggregate_id": {
          "format": "uuid",
          "title": "Aggregate Id",
          "type": "string"
        },
        "delta_id": {
          "format": "uuid",
          "title": "Delta Id",
          "type": "string"
        },
        "baseline_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Baseline Hash"
        },
        "candidate_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Candidate Hash"
        },
        "evaluated_by": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Evaluated By"
        },
        "total_decisions": {
          "title": "Total Decisions",
          "type": "integer"
        },
        "improved_decisions": {
          "title": "Improved Decisions",
          "type": "integer"
        },
        "degraded_decisions": {
          "title": "Degraded Decisions",
          "type": "integer"
        },
        "neutral_decisions": {
          "title": "Neutral Decisions",
          "type": "integer"
        },
        "win_rate": {
          "title": "Win Rate",
          "type": "number"
        },
        "min_sample_met": {
          "title": "Min Sample Met",
          "type": "boolean"
        },
        "accuracy_threshold_met": {
          "title": "Accuracy Threshold Met",
          "type": "boolean"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "can_promote_to_approval": {
          "title": "Can Promote To Approval",
          "type": "boolean"
        },
        "computed_at": {
          "format": "date-time",
          "title": "Computed At",
          "type": "string"
        }
      },
      "required": [
        "aggregate_id",
        "delta_id",
        "total_decisions",
        "improved_decisions",
        "degraded_decisions",
        "neutral_decisions",
        "win_rate",
        "min_sample_met",
        "accuracy_threshold_met",
        "status",
        "can_promote_to_approval",
        "computed_at"
      ],
      "title": "ShadowEvaluationSummaryItem",
      "type": "object"
    },
    "UIErrorResponse": {
      "$defs": {
        "ErrorDetail": {
          "description": "Error detail structure.",
          "properties": {
            "code": {
              "description": "Machine-readable error code",
              "title": "Code",
              "type": "string"
            },
            "message": {
              "description": "Human-readable description",
              "title": "Message",
              "type": "string"
            },
            "details": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Additional context",
              "title": "Details"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "title": "ErrorDetail",
          "type": "object"
        }
      },
      "description": "Standard error response for console / read endpoints.",
      "properties": {
        "error": {
          "$ref": "#/$defs/ErrorDetail"
        },
        "request_id": {
          "description": "Request ID for correlation/support",
          "title": "Request Id",
          "type": "string"
        }
      },
      "required": [
        "error",
        "request_id"
      ],
      "title": "UIErrorResponse",
      "type": "object"
    }
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/ui/audit",
      "summary": "List audit events",
      "description": "Query audit event stream with filtering. Read-only endpoint.",
      "response_model": "AuditEventListResponse",
      "query_params": [
        {
          "name": "cursor",
          "type": "string",
          "required": false
        },
        {
          "name": "limit",
          "type": "integer",
          "required": false,
          "default": 25,
          "min": 1,
          "max": 100
        },
        {
          "name": "start_time",
          "type": "datetime",
          "required": false
        },
        {
          "name": "end_time",
          "type": "datetime",
          "required": false
        },
        {
          "name": "event_type",
          "type": "AuditEventType",
          "required": false
        },
        {
          "name": "notification_id",
          "type": "uuid",
          "required": false
        },
        {
          "name": "agent_id",
          "type": "uuid",
          "required": false
        },
        {
          "name": "autonomy_mode",
          "type": "AutonomyMode",
          "required": false
        },
        {
          "name": "correlation_id",
          "type": "string",
          "required": false
        }
      ],
      "error_codes": [
        "invalid_parameter",
        "invalid_cursor"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/deliveries",
      "summary": "List delivery timelines",
      "description": "Query delivery timelines with optional filtering. Read-only endpoint.",
      "response_model": "DeliveryTimelineListResponse",
      "query_params": [
        {
          "name": "cursor",
          "type": "string",
          "required": false
        },
        {
          "name": "limit",
          "type": "integer",
          "required": false,
          "default": 25,
          "min": 1,
          "max": 100
        },
        {
          "name": "start_time",
          "type": "datetime",
          "required": false
        },
        {
          "name": "end_time",
          "type": "datetime",
          "required": false
        },
        {
          "name": "status",
          "type": "DeliveryStatus",
          "required": false
        },
        {
          "name": "intent",
          "type": "NotificationIntent",
          "required": false
        },
        {
          "name": "delivery_mode",
          "type": "DeliveryMode",
          "required": false
        },
        {
          "name": "agent_id",
          "type": "uuid",
          "required": false
        },
        {
          "name": "autonomy_mode",
          "type": "AutonomyMode",
          "required": false
        },
        {
          "name": "notification_type",
          "type": "string",
          "required": false
        },
        {
          "name": "channel",
          "type": "Channel",
          "required": false
        }
      ],
      "error_codes": [
        "invalid_parameter"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/deliveries/{notification_id}",
      "summary": "Get delivery timeline",
      "description": "Get full delivery timeline for a specific notification. Read-only endpoint.",
      "response_model": "DeliveryTimelineResponse",
      "path_params": [
        {
          "name": "notification_id",
          "type": "uuid",
          "required": true
        }
      ],
      "error_codes": [
        "not_found"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/invariants",
      "summary": "List system invariants",
      "description": "Get the system invariant registry. Read-only endpoint.",
      "response_model": "InvariantListResponse",
      "query_params": [
        {
          "name": "cursor",
          "type": "string",
          "required": false
        },
        {
          "name": "limit",
          "type": "integer",
          "required": false,
          "default": 25,
          "min": 1,
          "max": 100
        },
        {
          "name": "severity",
          "type": "InvariantSeverity",
          "required": false
        },
        {
          "name": "enforcement_type",
          "type": "EnforcementType",
          "required": false
        },
        {
          "name": "status",
          "type": "InvariantStatus",
          "required": false
        },
        {
          "name": "search",
          "type": "string",
          "required": false
        }
      ],
      "error_codes": [
        "invalid_parameter"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/invariants/summary",
      "summary": "Get invariant summary",
      "description": "Get summary statistics for system invariants. Read-only endpoint.",
      "response_model": "InvariantSummaryResponse",
      "query_params": [],
      "error_codes": []
    },
    {
      "method": "GET",
      "path": "/ui/policies/active",
      "summary": "List active notification policies",
      "description": "Return the catalog of currently active notification routing policies.",
      "response_model": "ActivePolicyListResponse",
      "query_params": [],
      "error_codes": []
    },
    {
      "method": "GET",
      "path": "/ui/policies/effective",
      "summary": "Get effective policy",
      "description": "Get effective policy resolution for a notification type. Read-only endpoint.",
      "response_model": "EffectivePolicyResponse",
      "query_params": [
        {
          "name": "notification_type",
          "type": "string",
          "required": true
        },
        {
          "name": "intent",
          "type": "NotificationIntent",
          "required": false
        },
        {
          "name": "autonomy_mode",
          "type": "AutonomyMode",
          "required": true
        },
        {
          "name": "irreversible",
          "type": "boolean",
          "required": false,
          "default": false
        }
      ],
      "error_codes": [
        "invalid_parameter"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/policies/proposals",
      "summary": "List policy delta proposals and shadow evaluation evidence",
      "description": "Return governed policy delta proposals, shadow evaluation aggregates, and guard results.",
      "response_model": "PolicyProposalListResponse",
      "query_params": [
        {
          "name": "policy_type",
          "type": "string",
          "required": false
        },
        {
          "name": "state",
          "type": "DeltaState",
          "required": false
        },
        {
          "name": "limit",
          "type": "integer",
          "required": false,
          "default": 50,
          "min": 1,
          "max": 200
        }
      ],
      "error_codes": [
        "invalid_parameter"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/policies/proposals/{delta_id}",
      "summary": "Inspect a policy delta proposal and shadow evaluation samples",
      "description": "Return full detail for a policy delta proposal, including shadow decision samples and guard history.",
      "response_model": "PolicyProposalSummary",
      "path_params": [
        {
          "name": "delta_id",
          "type": "uuid",
          "required": true
        }
      ],
      "error_codes": [
        "not_found"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/policies/revisions",
      "summary": "List notification policy revisions",
      "description": "Return stored notification policy revisions across lifecycle statuses (ACTIVE, DRAFT, PREVIEW, RETIRED).",
      "response_model": "PolicyRevisionListResponse",
      "query_params": [
        {
          "name": "notification_type",
          "type": "string",
          "required": false
        },
        {
          "name": "status",
          "type": "PolicyStatus",
          "required": false
        },
        {
          "name": "limit",
          "type": "integer",
          "required": false,
          "default": 200,
          "min": 1,
          "max": 500
        }
      ],
      "error_codes": [
        "invalid_parameter"
      ]
    },
    {
      "method": "GET",
      "path": "/ui/session",
      "summary": "Get console session capabilities",
      "description": "Return the authenticated principal subject and capability scopes.",
      "response_model": "ConsoleSessionResponse",
      "query_params": [],
      "error_codes": [
        "unauthorized",
        "forbidden"
      ]
    }
  ]
}