Tool reference

{
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "minimum": 0,
      "description": "Zero-based QA checklist item position, guarded by expectedText against reorder races. Minimum accepted length or value is 0. The value must be an integer."
    },
    "expectedText": {
      "type": "string",
      "minLength": 1,
      "maxLength": 262144,
      "description": "Expected current checklist text at index; a mismatch fails instead of updating the wrong row. Accepted length or value is 1 through 262144, inclusive."
    },
    "checked": {
      "type": "boolean",
      "description": "Whether this QA checklist item is currently complete."
    },
    "ifVersionNum": {
      "type": "integer",
      "description": "Optional optimistic precondition using the current brief contract version number. Omit the field when it does not apply; omission is distinct from an empty value. The value must be an integer."
    },
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "index",
    "expectedText",
    "checked",
    "briefId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "projectId": {
          "type": "string",
          "description": "Project identifier returned by project_create or project_list; the caller must have access to that project."
        },
        "title": {
          "type": "string",
          "description": "Human-readable title displayed in Semel."
        },
        "state": {
          "type": "string",
          "enum": [
            "drafting",
            "in_review",
            "baselined",
            "in_development",
            "checked",
            "superseded",
            "closed"
          ],
          "description": "Current typed lifecycle state; the schema enum or union branch defines allowed values. Allowed values: \"drafting\", \"in_review\", \"baselined\", \"in_development\", \"checked\", \"superseded\", \"closed\"."
        },
        "currentVersionHash": {
          "type": [
            "string",
            "null"
          ],
          "description": "Hash of the current canonical brief version; null means no canonical version exists yet. A null value explicitly means no current value is available."
        },
        "content": {
          "type": "object",
          "additionalProperties": {},
          "description": "Complete brief logical document for writes, or the stored snapshot on reads; unknown metadata remains round-trippable."
        },
        "versionNum": {
          "type": "integer",
          "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
        },
        "delivery": {
          "type": "object",
          "properties": {
            "deliveryStatus": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "built",
                    "shipped",
                    "deployed"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
            },
            "deliveryStatusVersion": {
              "type": "integer",
              "minimum": 0,
              "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
            },
            "changedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
            },
            "changedById": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "web",
                    "mcp"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
            }
          },
          "required": [
            "deliveryStatus",
            "deliveryStatusVersion",
            "changedAt",
            "changedById",
            "source"
          ],
          "additionalProperties": false,
          "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state. Omit the field when it does not apply; omission is distinct from an empty value."
        },
        "createdNewVersion": {
          "type": "boolean",
          "description": "Whether the write changed canonical content and minted a new immutable brief version."
        },
        "staledApprovals": {
          "type": "integer",
          "description": "Number of prior approval rows made stale by this content change. The value must be an integer."
        }
      },
      "required": [
        "id",
        "projectId",
        "title",
        "state",
        "currentVersionHash",
        "content",
        "versionNum",
        "createdNewVersion",
        "staledApprovals"
      ],
      "additionalProperties": false,
      "description": "Current brief record returned by the operation."
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    },
    "collection": {
      "type": "string",
      "enum": [
        "versions",
        "decisionHistory",
        "findings",
        "proposals",
        "approvals",
        "comments",
        "artifacts",
        "workOrders",
        "reviewSessions",
        "shares"
      ],
      "description": "Durable collection to page within this brief. Use one of the advertised collection keys; the result contains only that collection."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque keyset cursor returned as nextCursor by the preceding page for this same brief and collection. Omit to read the first page."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Maximum records to return, as an integer from 1 through 200. Omit to use the server default."
    }
  },
  "required": [
    "briefId",
    "collection"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "collection": {
      "type": "string",
      "enum": [
        "versions",
        "decisionHistory",
        "findings",
        "proposals",
        "approvals",
        "comments",
        "artifacts",
        "workOrders",
        "reviewSessions",
        "shares"
      ],
      "description": "Named durable brief collection to page; use one of the documented enum values. Allowed values: \"versions\", \"decisionHistory\", \"findings\", \"proposals\", \"approvals\", \"comments\", \"artifacts\", \"workOrders\", \"reviewSessions\", \"shares\"."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      },
      "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
    }
  },
  "required": [
    "collection",
    "items",
    "nextCursor"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    },
    "commentId": {
      "type": "string",
      "minLength": 1,
      "description": "Identifier of the brief comment to resolve."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "briefId",
    "commentId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "comment": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "briefId": {
          "type": "string",
          "description": "Brief identifier returned by brief_create or brief_list; it determines the project authorization boundary."
        },
        "sectionKey": {
          "type": "string",
          "description": "Canonical brief or knowledge-section key that locates the cited statement; copy it from the source schema or search result."
        },
        "anchor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional structured location within a brief section for this comment; null means the comment applies to the section as a whole. A null value explicitly means no current value is available."
        },
        "text": {
          "type": "string",
          "description": "Human-authored or model-produced text for this typed record."
        },
        "authorId": {
          "type": "string",
          "description": "Semel user identifier for the comment or content author."
        },
        "authorEmail": {
          "anyOf": [
            {
              "type": "string",
              "format": "email"
            },
            {
              "type": "null"
            }
          ],
          "description": "Display email of the comment author when the caller may read it; null or omitted otherwise."
        },
        "resolvedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "RFC 3339 timestamp when the comment was resolved; null means unresolved. A null value explicitly means no current value is available."
        },
        "resolvedBy": {
          "type": [
            "string",
            "null"
          ],
          "description": "Semel user identifier that resolved the comment; absent until resolution. A null value explicitly means no current value is available."
        },
        "channel": {
          "type": "string",
          "enum": [
            "web",
            "mcp"
          ],
          "description": "Typed delivery or answer channel recorded as provenance. Omit the field when it does not apply; omission is distinct from an empty value. Allowed values: \"web\", \"mcp\"."
        },
        "createdAt": {
          "type": "string",
          "description": "RFC 3339 timestamp assigned by Semel when this record was created."
        },
        "updatedAt": {
          "type": "string",
          "description": "RFC 3339 timestamp when this record was last updated."
        }
      },
      "required": [
        "id",
        "briefId",
        "sectionKey",
        "anchor",
        "text",
        "authorId",
        "resolvedAt",
        "resolvedBy",
        "createdAt",
        "updatedAt"
      ],
      "additionalProperties": false,
      "description": "The comment after resolution, carrying who resolved it, when, and through which channel."
    }
  },
  "required": [
    "comment"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Project identifier returned by project_create or project_list; the caller must have access to that project. Minimum accepted length or value is 1."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Human-readable title displayed in Semel. Accepted length or value is 1 through 500, inclusive."
    },
    "content": {
      "type": "object",
      "properties": {
        "goal": {
          "type": "string",
          "maxLength": 4000,
          "description": "Concise statement of the outcome this brief must achieve. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "userPersonaContext": {
          "type": "string",
          "maxLength": 4000,
          "description": "User and situational context that explains who needs the outcome and why. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "customerFacingLaunchMessage": {
          "type": "string",
          "maxLength": 4000,
          "description": "Copy-ready end-user launch message stating the capability, value, and one concrete example. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "scope": {
          "type": "string",
          "maxLength": 4000,
          "description": "Work explicitly included in this brief. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "outOfScope": {
          "type": "string",
          "maxLength": 4000,
          "description": "Work explicitly excluded from this brief. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "requirements": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Ordered product requirements; an empty array explicitly records none. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "edgeCases": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Known edge cases the implementation must handle. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "acceptanceCriteria": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "implementation": {
                "type": "boolean",
                "description": "Whether this criterion requires implementation; omission defaults to implementation work. Omit the field when it does not apply; omission is distinct from an empty value."
              },
              "manualEvidence": {
                "type": "object",
                "properties": {
                  "rationale": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable explanation for why this item is exempted from implementation work. Accepted length or value is 1 through 1000, inclusive."
                  },
                  "evidencePath": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable location or procedure for collecting the manual evidence. Accepted length or value is 1 through 1000, inclusive."
                  }
                },
                "required": [
                  "rationale",
                  "evidencePath"
                ],
                "additionalProperties": false,
                "description": "Structured exemption required when implementation is explicitly false. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "id",
              "text"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Stable-ID acceptance criteria that define completion of the brief. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "rolesPermissions": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Roles and permission boundaries relevant to the feature. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "states": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "User-visible and system lifecycle states the feature must represent. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "productSolution": {
          "type": "string",
          "maxLength": 4000,
          "description": "Product behavior chosen to satisfy the goal and requirements. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "technicalSolution": {
          "type": "string",
          "maxLength": 4000,
          "description": "Implementation approach and major technical constraints. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "dataModelImplications": {
          "type": "string",
          "maxLength": 4000,
          "description": "Required data model changes, invariants, and migration implications. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "architectureAssumptions": {
          "type": "string",
          "maxLength": 4000,
          "description": "Architecture assumptions the implementation relies on. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "design": {
          "type": "string",
          "maxLength": 4000,
          "description": "Interaction and visual design requirements for the feature. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "testingQaChecklist": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "checked": {
                "type": "boolean",
                "description": "Whether this QA checklist item is currently complete."
              },
              "addedBy": {
                "type": "string",
                "maxLength": 200,
                "description": "Actor label that added the QA item; omission means legacy or unavailable attribution. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 200."
              },
              "checkedBy": {
                "type": "string",
                "maxLength": 200,
                "description": "Actor label that last checked the item; omission means it has no check attribution. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 200."
              },
              "checkedAt": {
                "type": "string",
                "format": "date-time",
                "description": "RFC 3339 timestamp when the item was checked; omission means it is unchecked or legacy data. Omit the field when it does not apply; omission is distinct from an empty value. Use an RFC 3339 date-time string."
              }
            },
            "required": [
              "text",
              "checked"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Mutable QA checklist; checked state and attribution are preserved by server reconciliation. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "testPlanUnit": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Unit-level verification plan. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "testPlanIntegration": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Integration-level verification plan. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "testPlanUiUx": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Browser, accessibility, and visual verification plan. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "openQuestions": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Unresolved questions that still require an explicit answer. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "generatedTickets": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
              },
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500,
                "description": "Human-readable title displayed in Semel. Accepted length or value is 1 through 500, inclusive."
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 10000
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable explanatory text; null or omission means no description was supplied. A null value explicitly means no current value is available. Maximum accepted length or value is 10000."
              },
              "boundCriteria": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
                },
                "maxItems": 50,
                "description": "Stable acceptance-criterion IDs implemented by this work order. An empty array explicitly means no matching items."
              },
              "boundRequirements": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
                },
                "maxItems": 50,
                "description": "Stable requirement IDs implemented by this work order; omission is tolerated only for legacy reads. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
              }
            },
            "required": [
              "id",
              "title",
              "description",
              "boundCriteria"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Ordered implementation work orders derived from this brief. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "requiredEvidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "implementation": {
                "type": "boolean",
                "description": "Whether this criterion requires implementation; omission defaults to implementation work. Omit the field when it does not apply; omission is distinct from an empty value."
              },
              "manualEvidence": {
                "type": "object",
                "properties": {
                  "rationale": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable explanation for why this item is exempted from implementation work. Accepted length or value is 1 through 1000, inclusive."
                  },
                  "evidencePath": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable location or procedure for collecting the manual evidence. Accepted length or value is 1 through 1000, inclusive."
                  }
                },
                "required": [
                  "rationale",
                  "evidencePath"
                ],
                "additionalProperties": false,
                "description": "Structured exemption required when implementation is explicitly false. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "id",
              "text"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Stable-ID evidence requirements needed to prove completion. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "decisions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "source": {
                "type": "string",
                "maxLength": 1000,
                "description": "Optional human-readable provenance for the decision. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 1000."
              },
              "stated": {
                "type": "boolean",
                "description": "Whether the decision was explicitly stated rather than inferred; omission means unknown legacy provenance. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "text"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Recorded product or engineering decisions with optional source provenance. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "sourceArtifactLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-readable label displayed for this record. Accepted length or value is 1 through 1000, inclusive."
              },
              "kind": {
                "type": "string",
                "maxLength": 200,
                "description": "Discriminator identifying the typed variant represented by this object. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 200."
              },
              "read": {
                "type": "boolean",
                "description": "Whether the referenced source artifact was read when the brief snapshot was produced. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "label"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Artifact labels referenced by the brief; an empty array means none are linked. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        }
      },
      "additionalProperties": true,
      "description": "Complete replacement brief document for agent writes, limited to 262144 serialized bytes. Known sections use the canonical nested shapes; unknown metadata and _draft remain round-trippable."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "projectId",
    "title",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "projectId": {
          "type": "string",
          "description": "Project identifier returned by project_create or project_list; the caller must have access to that project."
        },
        "title": {
          "type": "string",
          "description": "Human-readable title displayed in Semel."
        },
        "state": {
          "type": "string",
          "enum": [
            "drafting",
            "in_review",
            "baselined",
            "in_development",
            "checked",
            "superseded",
            "closed"
          ],
          "description": "Current typed lifecycle state; the schema enum or union branch defines allowed values. Allowed values: \"drafting\", \"in_review\", \"baselined\", \"in_development\", \"checked\", \"superseded\", \"closed\"."
        },
        "currentVersionHash": {
          "type": [
            "string",
            "null"
          ],
          "description": "Hash of the current canonical brief version; null means no canonical version exists yet. A null value explicitly means no current value is available."
        },
        "content": {
          "type": "object",
          "additionalProperties": {},
          "description": "Complete brief logical document for writes, or the stored snapshot on reads; unknown metadata remains round-trippable."
        },
        "versionNum": {
          "type": "integer",
          "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
        },
        "delivery": {
          "type": "object",
          "properties": {
            "deliveryStatus": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "built",
                    "shipped",
                    "deployed"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
            },
            "deliveryStatusVersion": {
              "type": "integer",
              "minimum": 0,
              "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
            },
            "changedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
            },
            "changedById": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "web",
                    "mcp"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
            }
          },
          "required": [
            "deliveryStatus",
            "deliveryStatusVersion",
            "changedAt",
            "changedById",
            "source"
          ],
          "additionalProperties": false,
          "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state. Omit the field when it does not apply; omission is distinct from an empty value."
        }
      },
      "required": [
        "id",
        "projectId",
        "title",
        "state",
        "currentVersionHash",
        "content",
        "versionNum"
      ],
      "additionalProperties": false,
      "description": "Current brief record returned by the operation."
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "deliveryStatus": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "built",
            "shipped",
            "deployed"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Desired explicit delivery state; null deliberately clears the marker and does not alter review, approval, or contract state."
    },
    "ifDeliveryStatusVersion": {
      "type": "integer",
      "minimum": 0,
      "description": "Required optimistic-concurrency precondition copied from the latest deliveryStatusVersion returned by Semel."
    },
    "correctionReason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Trimmed audit reason required for backward transitions and clears; tabs and line breaks are allowed but other control characters are rejected."
    },
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier whose explicit delivery status should be changed."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "deliveryStatus",
    "ifDeliveryStatusVersion",
    "briefId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "projectId": {
          "type": "string",
          "description": "Project identifier returned by project_create or project_list; the caller must have access to that project."
        },
        "title": {
          "type": "string",
          "description": "Human-readable title displayed in Semel."
        },
        "state": {
          "type": "string",
          "enum": [
            "drafting",
            "in_review",
            "baselined",
            "in_development",
            "checked",
            "superseded",
            "closed"
          ],
          "description": "Current typed lifecycle state; the schema enum or union branch defines allowed values. Allowed values: \"drafting\", \"in_review\", \"baselined\", \"in_development\", \"checked\", \"superseded\", \"closed\"."
        },
        "currentVersionHash": {
          "type": [
            "string",
            "null"
          ],
          "description": "Hash of the current canonical brief version; null means no canonical version exists yet. A null value explicitly means no current value is available."
        },
        "content": {
          "type": "object",
          "additionalProperties": {},
          "description": "Complete brief logical document for writes, or the stored snapshot on reads; unknown metadata remains round-trippable."
        },
        "versionNum": {
          "type": "integer",
          "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
        },
        "delivery": {
          "type": "object",
          "properties": {
            "deliveryStatus": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "built",
                    "shipped",
                    "deployed"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
            },
            "deliveryStatusVersion": {
              "type": "integer",
              "minimum": 0,
              "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
            },
            "changedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
            },
            "changedById": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "web",
                    "mcp"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
            }
          },
          "required": [
            "deliveryStatus",
            "deliveryStatusVersion",
            "changedAt",
            "changedById",
            "source"
          ],
          "additionalProperties": false,
          "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state. Omit the field when it does not apply; omission is distinct from an empty value."
        }
      },
      "required": [
        "id",
        "projectId",
        "title",
        "state",
        "currentVersionHash",
        "content",
        "versionNum"
      ],
      "additionalProperties": false,
      "description": "Current brief record returned by the operation."
    },
    "delivery": {
      "type": "object",
      "properties": {
        "projection": {
          "type": "object",
          "properties": {
            "deliveryStatus": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "built",
                    "shipped",
                    "deployed"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
            },
            "deliveryStatusVersion": {
              "type": "integer",
              "minimum": 0,
              "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
            },
            "changedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
            },
            "changedById": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "web",
                    "mcp"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
            }
          },
          "required": [
            "deliveryStatus",
            "deliveryStatusVersion",
            "changedAt",
            "changedById",
            "source"
          ],
          "additionalProperties": false,
          "description": "Authoritative delivery projection after the operation, including an exact no-op response."
        },
        "changed": {
          "type": "boolean",
          "description": "True when projection and audit event were committed; false for an exact event-free no-op."
        },
        "eventId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Immutable delivery-status audit event identifier for a committed change; null for an exact no-op."
        }
      },
      "required": [
        "projection",
        "changed",
        "eventId"
      ],
      "additionalProperties": false,
      "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state."
    }
  },
  "required": [
    "brief",
    "delivery"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    }
  },
  "required": [
    "briefId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "description": "Safe suggested filename for the downloaded export."
    },
    "resource": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "uri": {
              "type": "string",
              "description": "Absolute or same-origin URI for the referenced resource or required operator action."
            },
            "name": {
              "type": "string",
              "description": "Human-readable name displayed in Semel."
            },
            "mimeType": {
              "type": "string",
              "description": "Internet media type of the artifact or exported resource; null means the producer did not record one."
            }
          },
          "required": [
            "uri",
            "name",
            "mimeType"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional MCP resource descriptor for the Markdown export; null means the export is available only in the inline payload. A null value explicitly means no current value is available."
    },
    "downloadUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "Short-lived or public download URL returned by Semel; do not construct or persist it as an identifier. A null value explicitly means no current value is available."
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "Exact UTF-8 Markdown document returned by or submitted to the operation; preserve its text bytes when exact identity matters. A null value explicitly means no current value is available."
    }
  },
  "required": [
    "filename",
    "resource",
    "downloadUrl",
    "markdown"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "briefId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "exportId": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque identifier assigned to this deterministic export package; use returned download metadata rather than constructing it. Minimum accepted length or value is 1."
    },
    "status": {
      "type": "string",
      "const": "ready",
      "description": "Current typed status; the schema enum or union branch lists every allowed value. This branch always uses \"ready\"."
    },
    "filename": {
      "type": "string",
      "minLength": 1,
      "description": "Safe suggested filename for the downloaded export. Minimum accepted length or value is 1."
    },
    "downloadUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Short-lived or public download URL returned by Semel; do not construct or persist it as an identifier. Minimum accepted length or value is 1."
    },
    "manifestSha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Lowercase hexadecimal SHA-256 digest of the export manifest."
    },
    "implementationReady": {
      "type": "boolean",
      "const": true,
      "description": "Whether the exported brief satisfies Semel implementation-readiness checks. This branch always uses true."
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "description": "RFC 3339 expiration timestamp. Use an RFC 3339 date-time string."
    },
    "snapshotId": {
      "type": "string",
      "minLength": 1,
      "description": "Immutable export snapshot identifier used to reproduce the exported brief state. Minimum accepted length or value is 1."
    },
    "contractVersionId": {
      "type": "string",
      "minLength": 1,
      "description": "Immutable brief contract-version identifier resolved by Semel. Minimum accepted length or value is 1."
    }
  },
  "required": [
    "exportId",
    "status",
    "filename",
    "downloadUrl",
    "manifestSha256",
    "implementationReady",
    "expiresAt",
    "snapshotId",
    "contractVersionId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    }
  },
  "required": [
    "briefId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "projectId": {
          "type": "string",
          "description": "Project identifier returned by project_create or project_list; the caller must have access to that project."
        },
        "title": {
          "type": "string",
          "description": "Human-readable title displayed in Semel."
        },
        "state": {
          "type": "string",
          "enum": [
            "drafting",
            "in_review",
            "baselined",
            "in_development",
            "checked",
            "superseded",
            "closed"
          ],
          "description": "Current typed lifecycle state; the schema enum or union branch defines allowed values. Allowed values: \"drafting\", \"in_review\", \"baselined\", \"in_development\", \"checked\", \"superseded\", \"closed\"."
        },
        "currentVersionHash": {
          "type": [
            "string",
            "null"
          ],
          "description": "Hash of the current canonical brief version; null means no canonical version exists yet. A null value explicitly means no current value is available."
        },
        "content": {
          "type": "object",
          "additionalProperties": {},
          "description": "Complete brief logical document for writes, or the stored snapshot on reads; unknown metadata remains round-trippable."
        },
        "versionNum": {
          "type": "integer",
          "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
        },
        "delivery": {
          "type": "object",
          "properties": {
            "deliveryStatus": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "built",
                    "shipped",
                    "deployed"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
            },
            "deliveryStatusVersion": {
              "type": "integer",
              "minimum": 0,
              "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
            },
            "changedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
            },
            "changedById": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "web",
                    "mcp"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
            }
          },
          "required": [
            "deliveryStatus",
            "deliveryStatusVersion",
            "changedAt",
            "changedById",
            "source"
          ],
          "additionalProperties": false,
          "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state. Omit the field when it does not apply; omission is distinct from an empty value."
        }
      },
      "required": [
        "id",
        "projectId",
        "title",
        "state",
        "currentVersionHash",
        "content",
        "versionNum"
      ],
      "additionalProperties": false,
      "description": "Current brief record returned by the operation."
    },
    "collections": {
      "type": "object",
      "properties": {
        "versions": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "versionNum": {
                    "type": "integer",
                    "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
                  },
                  "contentHash": {
                    "type": "string",
                    "description": "Hash of the immutable brief content snapshot."
                  },
                  "aiReviewerRole": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Reviewer role that authored this immutable brief version; null means a human or legacy source authored it. A null value explicitly means no current value is available."
                  },
                  "aiReviewerIdentity": {
                    "type": "object",
                    "properties": {
                      "schemaVersion": {
                        "type": "number",
                        "const": 2,
                        "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                      },
                      "occurrenceId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                      },
                      "reviewerRef": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "builtin",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                              },
                              "role": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ],
                                "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                              }
                            },
                            "required": [
                              "kind",
                              "role"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "custom",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                              },
                              "skillId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                              },
                              "versionId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                              }
                            },
                            "required": [
                              "kind",
                              "skillId",
                              "versionId"
                            ],
                            "additionalProperties": false
                          }
                        ],
                        "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                      },
                      "legacyRole": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "product",
                              "engineering",
                              "design",
                              "security",
                              "test"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                      }
                    },
                    "required": [
                      "schemaVersion",
                      "occurrenceId",
                      "reviewerRef",
                      "label",
                      "legacyRole"
                    ],
                    "additionalProperties": false,
                    "description": "Server-stamped identity of the reviewer occurrence that authored this immutable brief version. Omit the field when it does not apply; omission is distinct from an empty value."
                  },
                  "sourceRunId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Review-run identifier that authored this brief version; null means the version was not created by a reviewer run. A null value explicitly means no current value is available."
                  },
                  "isRevert": {
                    "type": "boolean",
                    "description": "Whether this immutable version was created by reverting to prior content."
                  },
                  "createdById": {
                    "type": "string",
                    "description": "Semel user identifier recorded as the initiating creator."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "versionNum",
                  "contentHash",
                  "aiReviewerRole",
                  "sourceRunId",
                  "isRevert",
                  "createdById",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Immutable brief version summaries, newest first."
        },
        "decisionHistory": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "canonical_decision",
                      "reviewer_question"
                    ],
                    "description": "Discriminator identifying the typed variant represented by this object. Allowed values: \"canonical_decision\", \"reviewer_question\"."
                  },
                  "sourceId": {
                    "type": "string",
                    "description": "Opaque source identifier returned by project_context_sources_list; pass it back unchanged."
                  },
                  "text": {
                    "type": "string",
                    "description": "Human-authored or model-produced text for this typed record."
                  },
                  "answer": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Durable answer text recorded for this decision-history entry; null means the question had no accepted answer at this snapshot. A null value explicitly means no current value is available."
                  },
                  "status": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Current typed status; the schema enum or union branch lists every allowed value. A null value explicitly means no current value is available."
                  },
                  "reviewerRole": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Reviewer role attributed to this question, finding, or version. A null value explicitly means no current value is available."
                  },
                  "reviewerIdentity": {
                    "type": "object",
                    "properties": {
                      "schemaVersion": {
                        "type": "number",
                        "const": 2,
                        "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                      },
                      "occurrenceId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                      },
                      "reviewerRef": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "builtin",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                              },
                              "role": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ],
                                "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                              }
                            },
                            "required": [
                              "kind",
                              "role"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "custom",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                              },
                              "skillId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                              },
                              "versionId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                              }
                            },
                            "required": [
                              "kind",
                              "skillId",
                              "versionId"
                            ],
                            "additionalProperties": false
                          }
                        ],
                        "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                      },
                      "legacyRole": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "product",
                              "engineering",
                              "design",
                              "security",
                              "test"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                      }
                    },
                    "required": [
                      "schemaVersion",
                      "occurrenceId",
                      "reviewerRef",
                      "label",
                      "legacyRole"
                    ],
                    "additionalProperties": false,
                    "description": "Server-stamped reviewer occurrence identity, or the bounded occurrence echo accepted from a schema-2 result. Omit the field when it does not apply; omission is distinct from an empty value."
                  },
                  "section": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Canonical brief section key associated with the question, finding, proposal, or decision entry. A null value explicitly means no current value is available."
                  },
                  "iterationRound": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "One-based review iteration that produced this decision-history entry; null means legacy round data is unavailable. A null value explicitly means no current value is available. The value must be an integer."
                  },
                  "sessionId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Review-session identifier associated with this historical record; null means legacy provenance is unavailable. A null value explicitly means no current value is available."
                  },
                  "runId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Review-run identifier returned by a review start, status, or cascade handoff result. A null value explicitly means no current value is available."
                  },
                  "actorUserId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Accountable Semel user identifier recorded on the event. A null value explicitly means no current value is available."
                  },
                  "createdAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created. A null value explicitly means no current value is available."
                  },
                  "answeredAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "RFC 3339 timestamp when the active answer was recorded. A null value explicitly means no current value is available."
                  }
                },
                "required": [
                  "kind",
                  "sourceId",
                  "text",
                  "answer",
                  "status",
                  "reviewerRole",
                  "section",
                  "iterationRound",
                  "sessionId",
                  "runId",
                  "actorUserId",
                  "createdAt",
                  "answeredAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Durable question and decision history for the brief."
        },
        "findings": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "section": {
                    "type": "string",
                    "description": "Canonical brief section key associated with the question, finding, proposal, or decision entry."
                  },
                  "note": {
                    "type": "string",
                    "description": "Reviewer-facing finding detail that explains the observed issue and the evidence-based change requested."
                  },
                  "severity": {
                    "type": "string",
                    "enum": [
                      "info",
                      "warn",
                      "block"
                    ],
                    "description": "Finding impact level: info is advisory, warn requires attention, and block prevents approval or completion. Allowed values: \"info\", \"warn\", \"block\"."
                  },
                  "citations": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "brief-section",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"brief-section\"."
                            },
                            "sectionKey": {
                              "type": "string",
                              "enum": [
                                "goal",
                                "userPersonaContext",
                                "customerFacingLaunchMessage",
                                "scope",
                                "outOfScope",
                                "requirements",
                                "edgeCases",
                                "acceptanceCriteria",
                                "rolesPermissions",
                                "states",
                                "productSolution",
                                "technicalSolution",
                                "dataModelImplications",
                                "architectureAssumptions",
                                "design",
                                "testingQaChecklist",
                                "testPlanUnit",
                                "testPlanIntegration",
                                "testPlanUiUx",
                                "openQuestions",
                                "generatedTickets",
                                "requiredEvidence",
                                "decisions",
                                "sourceArtifactLinks"
                              ],
                              "description": "Canonical brief or knowledge-section key that locates the cited statement; copy it from the source schema or search result. Allowed values: \"goal\", \"userPersonaContext\", \"customerFacingLaunchMessage\", \"scope\", \"outOfScope\", \"requirements\", \"edgeCases\", \"acceptanceCriteria\", \"rolesPermissions\", \"states\", \"productSolution\", \"technicalSolution\", \"dataModelImplications\", \"architectureAssumptions\", \"design\", \"testingQaChecklist\", \"testPlanUnit\", \"testPlanIntegration\", \"testPlanUiUx\", \"openQuestions\", \"generatedTickets\", \"requiredEvidence\", \"decisions\", \"sourceArtifactLinks\"."
                            },
                            "statementId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Stable identifier of the exact statement within a brief section; omit when the citation addresses the entire section. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "briefId": {
                              "type": "string",
                              "description": "Brief identifier returned by brief_create or brief_list; it determines the project authorization boundary."
                            },
                            "contractVersionId": {
                              "type": "string",
                              "description": "Immutable brief contract-version identifier resolved by Semel."
                            },
                            "versionNum": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "Monotonic brief contract version number assigned by Semel. Omit the field when it does not apply; omission is distinct from an empty value. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "reviewers": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ]
                              },
                              "minItems": 1,
                              "description": "Reviewer roles whose evidence processing verified or contributed this citation. An empty array explicitly means no matching items."
                            },
                            "verification": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "canonical",
                                "unverified"
                              ],
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. Allowed values: \"exact\", \"canonical\", \"unverified\"."
                            }
                          },
                          "required": [
                            "sourceType",
                            "sectionKey",
                            "verbatim",
                            "briefId",
                            "contractVersionId",
                            "reviewers",
                            "verification"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "artifact",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"artifact\"."
                            },
                            "artifactId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Artifact identifier assigned by Semel when source material is uploaded. Accepted length or value is 1 through 200, inclusive."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "extractedTextHash": {
                              "type": "string",
                              "description": "Hash of the normalized text extracted from the cited artifact, used to bind the citation to exact processed content."
                            },
                            "reviewers": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ]
                              },
                              "minItems": 1,
                              "description": "Reviewer roles whose evidence processing verified or contributed this citation. An empty array explicitly means no matching items."
                            },
                            "verification": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "canonical",
                                "unverified"
                              ],
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. Allowed values: \"exact\", \"canonical\", \"unverified\"."
                            }
                          },
                          "required": [
                            "sourceType",
                            "artifactId",
                            "verbatim",
                            "extractedTextHash",
                            "reviewers",
                            "verification"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "repository-code",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"repository-code\"."
                            },
                            "citationKey": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Stable citation key assigned by Semel to repository evidence. Accepted length or value is 1 through 200, inclusive."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "evidenceManifestId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Immutable evidence-manifest identifier captured for the review run. Minimum accepted length or value is 1."
                            },
                            "evidenceManifestItemId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Identifier of the exact item inside the immutable evidence manifest. Minimum accepted length or value is 1."
                            },
                            "workspaceRepositoryId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Workspace-scoped connected repository identifier recorded in evidence provenance. Minimum accepted length or value is 1."
                            },
                            "revisionId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Immutable indexed repository revision identifier. Minimum accepted length or value is 1."
                            },
                            "commitSha": {
                              "type": "string",
                              "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
                              "description": "Git commit SHA pinned by the evidence manifest."
                            },
                            "blobSha": {
                              "type": "string",
                              "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
                              "description": "Git blob SHA for the cited file contents."
                            },
                            "path": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Repository-relative source path; it never denotes an arbitrary local filesystem path. Minimum accepted length or value is 1."
                            },
                            "startLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive start line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "endLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive end line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "excerptSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$",
                              "description": "Lowercase hexadecimal SHA-256 digest of the exact cited excerpt."
                            },
                            "route": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "lexical",
                                "hybrid"
                              ],
                              "description": "Repository route or evidence route label recorded with the citation. Allowed values: \"exact\", \"lexical\", \"hybrid\"."
                            },
                            "coverage": {
                              "type": "object",
                              "additionalProperties": {},
                              "description": "Evidence coverage metadata or typed completeness level for the cited source; unknown or partial coverage must not imply absence."
                            },
                            "reviewers": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ]
                              },
                              "minItems": 1,
                              "description": "Reviewer roles whose evidence processing verified or contributed this citation. An empty array explicitly means no matching items."
                            },
                            "verification": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "canonical",
                                "unverified"
                              ],
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. Allowed values: \"exact\", \"canonical\", \"unverified\"."
                            }
                          },
                          "required": [
                            "sourceType",
                            "citationKey",
                            "verbatim",
                            "evidenceManifestId",
                            "evidenceManifestItemId",
                            "workspaceRepositoryId",
                            "revisionId",
                            "commitSha",
                            "blobSha",
                            "path",
                            "startLine",
                            "endLine",
                            "excerptSha256",
                            "route",
                            "coverage",
                            "reviewers",
                            "verification"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "local-worktree",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"local-worktree\"."
                            },
                            "citationKey": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Stable citation key assigned by Semel to repository evidence. Accepted length or value is 1 through 200, inclusive."
                            },
                            "repositoryId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Repository identifier from the connected-codebase inventory. Minimum accepted length or value is 1."
                            },
                            "headSha": {
                              "type": "string",
                              "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
                              "description": "Git commit SHA of the local worktree HEAD at binding or citation time."
                            },
                            "fileSha": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Git blob SHA of the local working file computed with git hash-object; null when unavailable. Omit the field when it does not apply; omission is distinct from an empty value. A null value explicitly means no current value is available."
                            },
                            "path": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4096,
                              "description": "Repository-relative source path; it never denotes an arbitrary local filesystem path. Accepted length or value is 1 through 4096, inclusive."
                            },
                            "startLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive start line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "endLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive end line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "excerptSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$",
                              "description": "Lowercase hexadecimal SHA-256 digest of the exact cited excerpt."
                            },
                            "dirty": {
                              "type": "boolean",
                              "description": "Whether the local worktree had uncommitted changes at binding or citation time."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "verification": {
                              "type": "string",
                              "const": "unverified",
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. This branch always uses \"unverified\"."
                            },
                            "reviewers": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ]
                              },
                              "minItems": 1,
                              "description": "Reviewer roles whose evidence processing verified or contributed this citation. An empty array explicitly means no matching items."
                            }
                          },
                          "required": [
                            "sourceType",
                            "citationKey",
                            "repositoryId",
                            "headSha",
                            "path",
                            "startLine",
                            "endLine",
                            "excerptSha256",
                            "dirty",
                            "verbatim",
                            "verification",
                            "reviewers"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Bounded evidence anchors supporting this statement; omit when no citation is claimed and use an empty array only to clear a replaceable list. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
                  },
                  "citationsV2": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "brief-section",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"brief-section\"."
                            },
                            "sectionKey": {
                              "type": "string",
                              "enum": [
                                "goal",
                                "userPersonaContext",
                                "customerFacingLaunchMessage",
                                "scope",
                                "outOfScope",
                                "requirements",
                                "edgeCases",
                                "acceptanceCriteria",
                                "rolesPermissions",
                                "states",
                                "productSolution",
                                "technicalSolution",
                                "dataModelImplications",
                                "architectureAssumptions",
                                "design",
                                "testingQaChecklist",
                                "testPlanUnit",
                                "testPlanIntegration",
                                "testPlanUiUx",
                                "openQuestions",
                                "generatedTickets",
                                "requiredEvidence",
                                "decisions",
                                "sourceArtifactLinks"
                              ],
                              "description": "Canonical brief or knowledge-section key that locates the cited statement; copy it from the source schema or search result. Allowed values: \"goal\", \"userPersonaContext\", \"customerFacingLaunchMessage\", \"scope\", \"outOfScope\", \"requirements\", \"edgeCases\", \"acceptanceCriteria\", \"rolesPermissions\", \"states\", \"productSolution\", \"technicalSolution\", \"dataModelImplications\", \"architectureAssumptions\", \"design\", \"testingQaChecklist\", \"testPlanUnit\", \"testPlanIntegration\", \"testPlanUiUx\", \"openQuestions\", \"generatedTickets\", \"requiredEvidence\", \"decisions\", \"sourceArtifactLinks\"."
                            },
                            "statementId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Stable identifier of the exact statement within a brief section; omit when the citation addresses the entire section. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "briefId": {
                              "type": "string",
                              "description": "Brief identifier returned by brief_create or brief_list; it determines the project authorization boundary."
                            },
                            "contractVersionId": {
                              "type": "string",
                              "description": "Immutable brief contract-version identifier resolved by Semel."
                            },
                            "versionNum": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "Monotonic brief contract version number assigned by Semel. Omit the field when it does not apply; omission is distinct from an empty value. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "verification": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "canonical",
                                "unverified"
                              ],
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. Allowed values: \"exact\", \"canonical\", \"unverified\"."
                            },
                            "identitySchemaVersion": {
                              "type": "number",
                              "const": 2,
                              "description": "Version of the reviewer identity attribution stamped on this citation record. This branch always uses 2."
                            },
                            "reviewerIdentities": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "schemaVersion": {
                                    "type": "number",
                                    "const": 2,
                                    "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                                  },
                                  "occurrenceId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200,
                                    "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                                  },
                                  "reviewerRef": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "builtin",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                          },
                                          "role": {
                                            "type": "string",
                                            "enum": [
                                              "product",
                                              "engineering",
                                              "design",
                                              "security",
                                              "test"
                                            ],
                                            "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "role"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "custom",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                          },
                                          "skillId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                          },
                                          "versionId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "skillId",
                                          "versionId"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ],
                                    "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                                  },
                                  "legacyRole": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "product",
                                          "engineering",
                                          "design",
                                          "security",
                                          "test"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                  }
                                },
                                "required": [
                                  "schemaVersion",
                                  "occurrenceId",
                                  "reviewerRef",
                                  "label",
                                  "legacyRole"
                                ],
                                "additionalProperties": false
                              },
                              "minItems": 1,
                              "maxItems": 20,
                              "description": "Server-stamped reviewer occurrence identities attributed to this finding, proposal, or citation. An empty array explicitly means no matching items."
                            }
                          },
                          "required": [
                            "sourceType",
                            "sectionKey",
                            "verbatim",
                            "briefId",
                            "contractVersionId",
                            "verification",
                            "identitySchemaVersion",
                            "reviewerIdentities"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "artifact",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"artifact\"."
                            },
                            "artifactId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Artifact identifier assigned by Semel when source material is uploaded. Accepted length or value is 1 through 200, inclusive."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "extractedTextHash": {
                              "type": "string",
                              "description": "Hash of the normalized text extracted from the cited artifact, used to bind the citation to exact processed content."
                            },
                            "verification": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "canonical",
                                "unverified"
                              ],
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. Allowed values: \"exact\", \"canonical\", \"unverified\"."
                            },
                            "identitySchemaVersion": {
                              "type": "number",
                              "const": 2,
                              "description": "Version of the reviewer identity attribution stamped on this citation record. This branch always uses 2."
                            },
                            "reviewerIdentities": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "schemaVersion": {
                                    "type": "number",
                                    "const": 2,
                                    "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                                  },
                                  "occurrenceId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200,
                                    "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                                  },
                                  "reviewerRef": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "builtin",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                          },
                                          "role": {
                                            "type": "string",
                                            "enum": [
                                              "product",
                                              "engineering",
                                              "design",
                                              "security",
                                              "test"
                                            ],
                                            "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "role"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "custom",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                          },
                                          "skillId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                          },
                                          "versionId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "skillId",
                                          "versionId"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ],
                                    "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                                  },
                                  "legacyRole": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "product",
                                          "engineering",
                                          "design",
                                          "security",
                                          "test"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                  }
                                },
                                "required": [
                                  "schemaVersion",
                                  "occurrenceId",
                                  "reviewerRef",
                                  "label",
                                  "legacyRole"
                                ],
                                "additionalProperties": false
                              },
                              "minItems": 1,
                              "maxItems": 20,
                              "description": "Server-stamped reviewer occurrence identities attributed to this finding, proposal, or citation. An empty array explicitly means no matching items."
                            }
                          },
                          "required": [
                            "sourceType",
                            "artifactId",
                            "verbatim",
                            "extractedTextHash",
                            "verification",
                            "identitySchemaVersion",
                            "reviewerIdentities"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "repository-code",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"repository-code\"."
                            },
                            "citationKey": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Stable citation key assigned by Semel to repository evidence. Accepted length or value is 1 through 200, inclusive."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "evidenceManifestId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Immutable evidence-manifest identifier captured for the review run. Minimum accepted length or value is 1."
                            },
                            "evidenceManifestItemId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Identifier of the exact item inside the immutable evidence manifest. Minimum accepted length or value is 1."
                            },
                            "workspaceRepositoryId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Workspace-scoped connected repository identifier recorded in evidence provenance. Minimum accepted length or value is 1."
                            },
                            "revisionId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Immutable indexed repository revision identifier. Minimum accepted length or value is 1."
                            },
                            "commitSha": {
                              "type": "string",
                              "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
                              "description": "Git commit SHA pinned by the evidence manifest."
                            },
                            "blobSha": {
                              "type": "string",
                              "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
                              "description": "Git blob SHA for the cited file contents."
                            },
                            "path": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Repository-relative source path; it never denotes an arbitrary local filesystem path. Minimum accepted length or value is 1."
                            },
                            "startLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive start line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "endLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive end line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "excerptSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$",
                              "description": "Lowercase hexadecimal SHA-256 digest of the exact cited excerpt."
                            },
                            "route": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "lexical",
                                "hybrid"
                              ],
                              "description": "Repository route or evidence route label recorded with the citation. Allowed values: \"exact\", \"lexical\", \"hybrid\"."
                            },
                            "coverage": {
                              "type": "object",
                              "additionalProperties": {},
                              "description": "Evidence coverage metadata or typed completeness level for the cited source; unknown or partial coverage must not imply absence."
                            },
                            "verification": {
                              "type": "string",
                              "enum": [
                                "exact",
                                "canonical",
                                "unverified"
                              ],
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. Allowed values: \"exact\", \"canonical\", \"unverified\"."
                            },
                            "identitySchemaVersion": {
                              "type": "number",
                              "const": 2,
                              "description": "Version of the reviewer identity attribution stamped on this citation record. This branch always uses 2."
                            },
                            "reviewerIdentities": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "schemaVersion": {
                                    "type": "number",
                                    "const": 2,
                                    "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                                  },
                                  "occurrenceId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200,
                                    "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                                  },
                                  "reviewerRef": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "builtin",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                          },
                                          "role": {
                                            "type": "string",
                                            "enum": [
                                              "product",
                                              "engineering",
                                              "design",
                                              "security",
                                              "test"
                                            ],
                                            "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "role"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "custom",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                          },
                                          "skillId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                          },
                                          "versionId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "skillId",
                                          "versionId"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ],
                                    "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                                  },
                                  "legacyRole": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "product",
                                          "engineering",
                                          "design",
                                          "security",
                                          "test"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                  }
                                },
                                "required": [
                                  "schemaVersion",
                                  "occurrenceId",
                                  "reviewerRef",
                                  "label",
                                  "legacyRole"
                                ],
                                "additionalProperties": false
                              },
                              "minItems": 1,
                              "maxItems": 20,
                              "description": "Server-stamped reviewer occurrence identities attributed to this finding, proposal, or citation. An empty array explicitly means no matching items."
                            }
                          },
                          "required": [
                            "sourceType",
                            "citationKey",
                            "verbatim",
                            "evidenceManifestId",
                            "evidenceManifestItemId",
                            "workspaceRepositoryId",
                            "revisionId",
                            "commitSha",
                            "blobSha",
                            "path",
                            "startLine",
                            "endLine",
                            "excerptSha256",
                            "route",
                            "coverage",
                            "verification",
                            "identitySchemaVersion",
                            "reviewerIdentities"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "sourceType": {
                              "type": "string",
                              "const": "local-worktree",
                              "description": "Discriminator identifying the evidence source variant. This branch always uses \"local-worktree\"."
                            },
                            "citationKey": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Stable citation key assigned by Semel to repository evidence. Accepted length or value is 1 through 200, inclusive."
                            },
                            "repositoryId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Repository identifier from the connected-codebase inventory. Minimum accepted length or value is 1."
                            },
                            "headSha": {
                              "type": "string",
                              "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
                              "description": "Git commit SHA of the local worktree HEAD at binding or citation time."
                            },
                            "fileSha": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Git blob SHA of the local working file computed with git hash-object; null when unavailable. Omit the field when it does not apply; omission is distinct from an empty value. A null value explicitly means no current value is available."
                            },
                            "path": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4096,
                              "description": "Repository-relative source path; it never denotes an arbitrary local filesystem path. Accepted length or value is 1 through 4096, inclusive."
                            },
                            "startLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive start line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "endLine": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "One-based inclusive end line of the cited repository excerpt. Minimum accepted length or value is 0. The value must be an integer."
                            },
                            "excerptSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$",
                              "description": "Lowercase hexadecimal SHA-256 digest of the exact cited excerpt."
                            },
                            "dirty": {
                              "type": "boolean",
                              "description": "Whether the local worktree had uncommitted changes at binding or citation time."
                            },
                            "verbatim": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200,
                              "description": "Exact bounded evidence text supporting the citation. Accepted length or value is 1 through 1200, inclusive."
                            },
                            "verification": {
                              "type": "string",
                              "const": "unverified",
                              "description": "Citation verification result: exact and canonical are publishable evidence matches, while unverified cannot support a durable code claim. This branch always uses \"unverified\"."
                            },
                            "identitySchemaVersion": {
                              "type": "number",
                              "const": 2,
                              "description": "Version of the reviewer identity attribution stamped on this citation record. This branch always uses 2."
                            },
                            "reviewerIdentities": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "schemaVersion": {
                                    "type": "number",
                                    "const": 2,
                                    "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                                  },
                                  "occurrenceId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200,
                                    "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                                  },
                                  "reviewerRef": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "builtin",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                          },
                                          "role": {
                                            "type": "string",
                                            "enum": [
                                              "product",
                                              "engineering",
                                              "design",
                                              "security",
                                              "test"
                                            ],
                                            "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "role"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "custom",
                                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                          },
                                          "skillId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                          },
                                          "versionId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "skillId",
                                          "versionId"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ],
                                    "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                                  },
                                  "legacyRole": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "product",
                                          "engineering",
                                          "design",
                                          "security",
                                          "test"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                  }
                                },
                                "required": [
                                  "schemaVersion",
                                  "occurrenceId",
                                  "reviewerRef",
                                  "label",
                                  "legacyRole"
                                ],
                                "additionalProperties": false
                              },
                              "minItems": 1,
                              "maxItems": 20,
                              "description": "Server-stamped reviewer occurrence identities attributed to this finding, proposal, or citation. An empty array explicitly means no matching items."
                            }
                          },
                          "required": [
                            "sourceType",
                            "citationKey",
                            "repositoryId",
                            "headSha",
                            "path",
                            "startLine",
                            "endLine",
                            "excerptSha256",
                            "dirty",
                            "verbatim",
                            "verification",
                            "identitySchemaVersion",
                            "reviewerIdentities"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Schema-2 evidence citations carrying server-stamped reviewer occurrence attribution. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
                  },
                  "reviewerIdentities": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "schemaVersion": {
                          "type": "number",
                          "const": 2,
                          "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                        },
                        "occurrenceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                        },
                        "reviewerRef": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "builtin",
                                  "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                },
                                "role": {
                                  "type": "string",
                                  "enum": [
                                    "product",
                                    "engineering",
                                    "design",
                                    "security",
                                    "test"
                                  ],
                                  "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                }
                              },
                              "required": [
                                "kind",
                                "role"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "custom",
                                  "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                },
                                "skillId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                },
                                "versionId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                }
                              },
                              "required": [
                                "kind",
                                "skillId",
                                "versionId"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                        },
                        "legacyRole": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "product",
                                "engineering",
                                "design",
                                "security",
                                "test"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                        }
                      },
                      "required": [
                        "schemaVersion",
                        "occurrenceId",
                        "reviewerRef",
                        "label",
                        "legacyRole"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Server-stamped reviewer occurrence identities attributed to this finding, proposal, or citation. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
                  },
                  "evidenceUnavailable": {
                    "type": "boolean",
                    "description": "Whether the finding was emitted without the evidence normally required for verification; omission means evidence availability was not separately recorded. Omit the field when it does not apply; omission is distinct from an empty value."
                  },
                  "claimDisposition": {
                    "type": "string",
                    "enum": [
                      "verified",
                      "unverified"
                    ],
                    "description": "Published support disposition for a code claim; omission indicates a legacy row that is treated as verified. Omit the field when it does not apply; omission is distinct from an empty value. Allowed values: \"verified\", \"unverified\"."
                  }
                },
                "required": [
                  "section",
                  "note",
                  "severity"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Reviewer findings associated with the selected brief version."
        },
        "proposals": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "sessionId": {
                    "type": "string",
                    "description": "Review-session identifier associated with this historical record; null means legacy provenance is unavailable."
                  },
                  "section": {
                    "type": "string",
                    "description": "Canonical brief section key associated with the question, finding, proposal, or decision entry."
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Concise safe summary intended for users and logs. A null value explicitly means no current value is available."
                  },
                  "status": {
                    "type": "string",
                    "description": "Current typed status; the schema enum or union branch lists every allowed value."
                  },
                  "decidedById": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Semel user identifier that decided this proposal; absent until a decision exists. A null value explicitly means no current value is available."
                  },
                  "decidedAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "RFC 3339 timestamp of the proposal decision; null means undecided. A null value explicitly means no current value is available."
                  },
                  "decisionSource": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Typed provenance showing whether a proposal decision came from a user, reviewer, or system rule; null means unavailable legacy provenance. A null value explicitly means no current value is available."
                  },
                  "committedAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "RFC 3339 timestamp when the accepted proposal was committed; null means not committed. A null value explicitly means no current value is available."
                  },
                  "sourceRound": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Review round that produced this proposal; null means no round provenance was recorded. A null value explicitly means no current value is available. The value must be an integer."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  },
                  "reviewerIdentities": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "schemaVersion": {
                          "type": "number",
                          "const": 2,
                          "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 2."
                        },
                        "occurrenceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                        },
                        "reviewerRef": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "builtin",
                                  "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                },
                                "role": {
                                  "type": "string",
                                  "enum": [
                                    "product",
                                    "engineering",
                                    "design",
                                    "security",
                                    "test"
                                  ],
                                  "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                }
                              },
                              "required": [
                                "kind",
                                "role"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "custom",
                                  "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                },
                                "skillId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                },
                                "versionId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                }
                              },
                              "required": [
                                "kind",
                                "skillId",
                                "versionId"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                        },
                        "legacyRole": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "product",
                                "engineering",
                                "design",
                                "security",
                                "test"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                        }
                      },
                      "required": [
                        "schemaVersion",
                        "occurrenceId",
                        "reviewerRef",
                        "label",
                        "legacyRole"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Server-stamped reviewer occurrence identities attributed to this finding, proposal, or citation. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
                  }
                },
                "required": [
                  "id",
                  "sessionId",
                  "section",
                  "summary",
                  "status",
                  "decidedById",
                  "decidedAt",
                  "decisionSource",
                  "committedAt",
                  "sourceRound",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Reviewer proposals and their decision/commit state."
        },
        "approvals": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "contractVersionId": {
                    "type": "string",
                    "description": "Immutable brief contract-version identifier resolved by Semel."
                  },
                  "approverId": {
                    "type": "string",
                    "description": "Semel user identifier for the human who recorded this approval decision."
                  },
                  "action": {
                    "type": "string",
                    "description": "Typed human approval action recorded in the append-only approval ledger."
                  },
                  "isStale": {
                    "type": "boolean",
                    "description": "Whether this historical approval no longer targets the current brief version."
                  },
                  "reRequestReason": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Reason a previously decided approval was requested again; null means no re-request reason applies. A null value explicitly means no current value is available."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "contractVersionId",
                  "approverId",
                  "action",
                  "isStale",
                  "reRequestReason",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Append-only human approval records for brief versions."
        },
        "comments": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "sectionKey": {
                    "type": "string",
                    "description": "Canonical brief or knowledge-section key that locates the cited statement; copy it from the source schema or search result."
                  },
                  "anchor": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Optional structured location within a brief section for this comment; null means the comment applies to the section as a whole. A null value explicitly means no current value is available."
                  },
                  "text": {
                    "type": "string",
                    "description": "Human-authored or model-produced text for this typed record."
                  },
                  "authorId": {
                    "type": "string",
                    "description": "Semel user identifier for the comment or content author."
                  },
                  "resolvedAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "RFC 3339 timestamp when the comment was resolved; null means unresolved. A null value explicitly means no current value is available."
                  },
                  "resolvedBy": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Semel user identifier that resolved the comment; absent until resolution. A null value explicitly means no current value is available."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "sectionKey",
                  "anchor",
                  "text",
                  "authorId",
                  "resolvedAt",
                  "resolvedBy",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Human comments attached to brief sections or anchors."
        },
        "artifacts": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "artifactType": {
                    "type": "string",
                    "description": "Semel artifact classification used to select ingestion and display behavior for this source material."
                  },
                  "label": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Human-readable label displayed for this record. A null value explicitly means no current value is available."
                  },
                  "sourceUrl": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Original source URL recorded for the artifact; null means the artifact has no external source URL. A null value explicitly means no current value is available."
                  },
                  "mimeType": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Internet media type of the artifact or exported resource; null means the producer did not record one. A null value explicitly means no current value is available."
                  },
                  "sizeBytes": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Artifact size in bytes. A null value explicitly means no current value is available. The value must be an integer."
                  },
                  "ingestionStatus": {
                    "type": "string",
                    "description": "Current artifact ingestion lifecycle state; only ready artifacts may supply reviewed evidence."
                  },
                  "createdById": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Semel user identifier recorded as the initiating creator. A null value explicitly means no current value is available."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "artifactType",
                  "label",
                  "sourceUrl",
                  "mimeType",
                  "sizeBytes",
                  "ingestionStatus",
                  "createdById",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Source artifacts attached to the brief."
        },
        "workOrders": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "title": {
                    "type": "string",
                    "description": "Human-readable title displayed in Semel."
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Human-readable explanatory text; null or omission means no description was supplied. A null value explicitly means no current value is available."
                  },
                  "position": {
                    "type": "integer",
                    "description": "Stable zero-based or configured ordering position returned by Semel. The value must be an integer."
                  },
                  "boundCriteria": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Stable acceptance-criterion IDs implemented by this work order. An empty array explicitly means no matching items."
                  },
                  "boundRequirements": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Stable requirement IDs implemented by this work order; omission is tolerated only for legacy reads. An empty array explicitly means no matching items."
                  },
                  "externalTracker": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "External issue-tracker provider associated with the work order; null means the work order has not been exported. A null value explicitly means no current value is available."
                  },
                  "externalUrl": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "External tracker URL associated with the work order; null means no issue is linked. A null value explicitly means no current value is available."
                  },
                  "exportState": {
                    "type": "string",
                    "description": "Current external-tracker export lifecycle state for this generated work order."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "title",
                  "description",
                  "position",
                  "boundCriteria",
                  "boundRequirements",
                  "externalTracker",
                  "externalUrl",
                  "exportState",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Materialized implementation work orders for the brief."
        },
        "reviewSessions": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "runId": {
                    "type": "string",
                    "description": "Review-run identifier returned by a review start, status, or cascade handoff result."
                  },
                  "status": {
                    "type": "string",
                    "description": "Current typed status; the schema enum or union branch lists every allowed value."
                  },
                  "reviewerSet": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Ordered reviewer roles configured for this cascade. An empty array explicitly means no matching items."
                  },
                  "reviewerIdentitySchemaVersion": {
                    "type": "number",
                    "const": 2,
                    "description": "Version of the reviewer identity schema attached to this historical review session. Omit the field when it does not apply; omission is distinct from an empty value. This branch always uses 2."
                  },
                  "cascadeExecutionSnapshotId": {
                    "type": "string",
                    "description": "Identifier of the immutable cascade snapshot shared by every reviewer session in this pass. Omit the field when it does not apply; omission is distinct from an empty value."
                  },
                  "activeReviewerOccurrenceId": {
                    "type": "string",
                    "description": "Enabled reviewer occurrence assigned to this individual review session or execution. Omit the field when it does not apply; omission is distinct from an empty value."
                  },
                  "reviewerOccurrences": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "position": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Stable zero-based or configured ordering position returned by Semel. Minimum accepted length or value is 0. The value must be an integer."
                        },
                        "enabled": {
                          "type": "boolean",
                          "description": "Whether this frozen reviewer occurrence participates in execution; disabled occurrences remain inspectable."
                        },
                        "identity": {
                          "type": "object",
                          "properties": {
                            "occurrenceId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                            },
                            "reviewerRef": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "builtin",
                                      "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                                    },
                                    "role": {
                                      "type": "string",
                                      "enum": [
                                        "product",
                                        "engineering",
                                        "design",
                                        "security",
                                        "test"
                                      ],
                                      "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "role"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "custom",
                                      "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                                    },
                                    "skillId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                                    },
                                    "versionId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "skillId",
                                    "versionId"
                                  ],
                                  "additionalProperties": false
                                }
                              ],
                              "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                            },
                            "legacyRole": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "product",
                                    "engineering",
                                    "design",
                                    "security",
                                    "test"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Closed built-in reviewer-role projection; custom reviewer identities always carry null. A null value explicitly means no current value is available. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                            }
                          },
                          "required": [
                            "occurrenceId",
                            "reviewerRef",
                            "label",
                            "legacyRole"
                          ],
                          "additionalProperties": false,
                          "description": "Frozen reviewer occurrence identity used for display and exact historical attribution."
                        },
                        "pin": {
                          "type": "object",
                          "properties": {
                            "skill": {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200,
                                  "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                                },
                                "sha256": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$",
                                  "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                                }
                              },
                              "required": [
                                "version",
                                "sha256"
                              ],
                              "additionalProperties": false,
                              "description": "Exact immutable reviewer skill artifact pin used for this occurrence."
                            },
                            "framing": {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200,
                                  "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                                },
                                "sha256": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$",
                                  "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                                }
                              },
                              "required": [
                                "version",
                                "sha256"
                              ],
                              "additionalProperties": false,
                              "description": "Exact shared reviewer framing artifact pin used for this occurrence."
                            },
                            "capabilities": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200,
                                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
                                  },
                                  "version": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200,
                                    "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                                  },
                                  "sha256": {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$",
                                    "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                                  }
                                },
                                "required": [
                                  "id",
                                  "version",
                                  "sha256"
                                ],
                                "additionalProperties": false
                              },
                              "maxItems": 32,
                              "description": "Ordered exact capability artifact pins available to this reviewer occurrence. An empty array explicitly means no matching items."
                            },
                            "model": {
                              "type": "object",
                              "properties": {
                                "provider": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100,
                                  "description": "Resolved inference provider preserved in the immutable reviewer execution pin. Accepted length or value is 1 through 100, inclusive."
                                },
                                "model": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200,
                                  "description": "Optional model name declared by the harness. Accepted length or value is 1 through 200, inclusive."
                                },
                                "reasoning": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Resolved reasoning setting preserved in the immutable model pin; null means the model accepts none. A null value explicitly means no current value is available. Accepted length or value is 1 through 100, inclusive."
                                }
                              },
                              "required": [
                                "provider",
                                "model",
                                "reasoning"
                              ],
                              "additionalProperties": false,
                              "description": "Optional model name declared by the harness."
                            }
                          },
                          "required": [
                            "skill",
                            "framing",
                            "capabilities",
                            "model"
                          ],
                          "additionalProperties": false,
                          "description": "Exact skill, framing, capability, and model pins for this reviewer occurrence."
                        }
                      },
                      "required": [
                        "position",
                        "enabled",
                        "identity",
                        "pin"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Complete ordered reviewer occurrence list preserved in the immutable cascade execution snapshot. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
                  },
                  "reviewerConfiguration": {
                    "type": "object",
                    "properties": {
                      "revision": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 20,
                        "pattern": "^(?:0|[1-9][0-9]*)$",
                        "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
                      },
                      "origin": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "project",
                              "personal_default",
                              "team_default",
                              "builtin_fallback",
                              "explicit_override"
                            ],
                            "description": "Discriminator identifying the typed variant represented by this object. Allowed values: \"project\", \"personal_default\", \"team_default\", \"builtin_fallback\", \"explicit_override\"."
                          },
                          "presetVersionId": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset. A null value explicitly means no current value is available. Accepted length or value is 1 through 200, inclusive."
                          }
                        },
                        "required": [
                          "kind",
                          "presetVersionId"
                        ],
                        "additionalProperties": false,
                        "description": "Immutable source from which this cascade configuration was adopted; it never consults a current default."
                      }
                    },
                    "required": [
                      "revision",
                      "origin"
                    ],
                    "additionalProperties": false,
                    "description": "Immutable configuration revision and adoption origin preserved for this review session. Omit the field when it does not apply; omission is distinct from an empty value."
                  },
                  "reviewedContractVersionId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Immutable contract-version identifier actually reviewed by this session; null means the session has not pinned one. A null value explicitly means no current value is available."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "runId",
                  "status",
                  "reviewerSet",
                  "reviewedContractVersionId",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Review session summaries associated with the brief."
        },
        "shares": {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                  },
                  "accessLevel": {
                    "type": "string",
                    "description": "Share-link access policy assigned by Semel; the enum identifies whether the recipient may only view or may also interact."
                  },
                  "sharedById": {
                    "type": "string",
                    "description": "Semel user identifier for the person who created the share."
                  },
                  "isActive": {
                    "type": "boolean",
                    "description": "Whether this share link remains active."
                  },
                  "expiresAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "RFC 3339 expiration timestamp. A null value explicitly means no current value is available."
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "RFC 3339 timestamp assigned by Semel when this record was created."
                  }
                },
                "required": [
                  "id",
                  "accessLevel",
                  "sharedById",
                  "isActive",
                  "expiresAt",
                  "createdAt"
                ],
                "additionalProperties": false
              },
              "description": "Records in this page or grouped result; an empty array means there are none. An empty array explicitly means no matching items."
            },
            "nextCursor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
            }
          },
          "required": [
            "items",
            "nextCursor"
          ],
          "additionalProperties": false,
          "description": "Share-link records associated with the brief."
        }
      },
      "required": [
        "versions",
        "decisionHistory",
        "findings",
        "proposals",
        "approvals",
        "comments",
        "artifacts",
        "workOrders",
        "reviewSessions",
        "shares"
      ],
      "additionalProperties": false,
      "description": "First page of each durable collection associated with the brief."
    },
    "gateNotificationStatus": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string",
              "description": "Server request identifier used for support correlation; it is not an idempotency key."
            },
            "assignmentId": {
              "type": [
                "string",
                "null"
              ],
              "description": "Human gate assignment identifier created by Semel. A null value explicitly means no current value is available."
            },
            "contentHash": {
              "type": [
                "string",
                "null"
              ],
              "description": "Hash of the immutable brief content snapshot. A null value explicitly means no current value is available."
            },
            "notifiedAt": {
              "type": [
                "string",
                "null"
              ],
              "description": "RFC 3339 timestamp when the gate notification was sent; null means not sent. A null value explicitly means no current value is available."
            },
            "createdAt": {
              "type": "string",
              "description": "RFC 3339 timestamp assigned by Semel when this record was created."
            }
          },
          "required": [
            "requestId",
            "assignmentId",
            "contentHash",
            "notifiedAt",
            "createdAt"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Latest human gate notification status; null means no notification request exists. A null value explicitly means no current value is available."
    }
  },
  "required": [
    "brief",
    "collections",
    "gateNotificationStatus"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque keyset cursor returned as nextCursor by the preceding brief_list response. Omit to read the first page."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Maximum briefs to return, as an integer from 1 through 200. Omit to use the server default."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "briefs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
          },
          "projectId": {
            "type": "string",
            "description": "Project identifier returned by project_create or project_list; the caller must have access to that project."
          },
          "title": {
            "type": "string",
            "description": "Human-readable title displayed in Semel."
          },
          "state": {
            "type": "string",
            "description": "Current typed lifecycle state; the schema enum or union branch defines allowed values."
          },
          "versionNum": {
            "type": "integer",
            "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
          },
          "updatedAt": {
            "type": "string",
            "description": "RFC 3339 timestamp when this record was last updated."
          },
          "delivery": {
            "type": "object",
            "properties": {
              "deliveryStatus": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "built",
                      "shipped",
                      "deployed"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
              },
              "deliveryStatusVersion": {
                "type": "integer",
                "minimum": 0,
                "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
              },
              "changedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
              },
              "changedById": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
              },
              "source": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "web",
                      "mcp"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
              }
            },
            "required": [
              "deliveryStatus",
              "deliveryStatusVersion",
              "changedAt",
              "changedById",
              "source"
            ],
            "additionalProperties": false,
            "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state. Omit the field when it does not apply; omission is distinct from an empty value."
          }
        },
        "required": [
          "id",
          "projectId",
          "title",
          "state",
          "versionNum",
          "updatedAt"
        ],
        "additionalProperties": false
      },
      "description": "Brief summaries reachable by the authenticated principal. An empty array explicitly means no matching items."
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opaque cursor for the next page or sync; null means the current result is complete. A null value explicitly means no current value is available."
    }
  },
  "required": [
    "briefs",
    "nextCursor"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "content": {
      "type": "object",
      "properties": {
        "goal": {
          "type": "string",
          "maxLength": 4000,
          "description": "Concise statement of the outcome this brief must achieve. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "userPersonaContext": {
          "type": "string",
          "maxLength": 4000,
          "description": "User and situational context that explains who needs the outcome and why. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "customerFacingLaunchMessage": {
          "type": "string",
          "maxLength": 4000,
          "description": "Copy-ready end-user launch message stating the capability, value, and one concrete example. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "scope": {
          "type": "string",
          "maxLength": 4000,
          "description": "Work explicitly included in this brief. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "outOfScope": {
          "type": "string",
          "maxLength": 4000,
          "description": "Work explicitly excluded from this brief. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "requirements": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Ordered product requirements; an empty array explicitly records none. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "edgeCases": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Known edge cases the implementation must handle. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "acceptanceCriteria": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "implementation": {
                "type": "boolean",
                "description": "Whether this criterion requires implementation; omission defaults to implementation work. Omit the field when it does not apply; omission is distinct from an empty value."
              },
              "manualEvidence": {
                "type": "object",
                "properties": {
                  "rationale": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable explanation for why this item is exempted from implementation work. Accepted length or value is 1 through 1000, inclusive."
                  },
                  "evidencePath": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable location or procedure for collecting the manual evidence. Accepted length or value is 1 through 1000, inclusive."
                  }
                },
                "required": [
                  "rationale",
                  "evidencePath"
                ],
                "additionalProperties": false,
                "description": "Structured exemption required when implementation is explicitly false. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "id",
              "text"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Stable-ID acceptance criteria that define completion of the brief. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "rolesPermissions": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Roles and permission boundaries relevant to the feature. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "states": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "User-visible and system lifecycle states the feature must represent. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "productSolution": {
          "type": "string",
          "maxLength": 4000,
          "description": "Product behavior chosen to satisfy the goal and requirements. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "technicalSolution": {
          "type": "string",
          "maxLength": 4000,
          "description": "Implementation approach and major technical constraints. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "dataModelImplications": {
          "type": "string",
          "maxLength": 4000,
          "description": "Required data model changes, invariants, and migration implications. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "architectureAssumptions": {
          "type": "string",
          "maxLength": 4000,
          "description": "Architecture assumptions the implementation relies on. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "design": {
          "type": "string",
          "maxLength": 4000,
          "description": "Interaction and visual design requirements for the feature. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 4000."
        },
        "testingQaChecklist": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "checked": {
                "type": "boolean",
                "description": "Whether this QA checklist item is currently complete."
              },
              "addedBy": {
                "type": "string",
                "maxLength": 200,
                "description": "Actor label that added the QA item; omission means legacy or unavailable attribution. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 200."
              },
              "checkedBy": {
                "type": "string",
                "maxLength": 200,
                "description": "Actor label that last checked the item; omission means it has no check attribution. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 200."
              },
              "checkedAt": {
                "type": "string",
                "format": "date-time",
                "description": "RFC 3339 timestamp when the item was checked; omission means it is unchecked or legacy data. Omit the field when it does not apply; omission is distinct from an empty value. Use an RFC 3339 date-time string."
              }
            },
            "required": [
              "text",
              "checked"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Mutable QA checklist; checked state and attribution are preserved by server reconciliation. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "testPlanUnit": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Unit-level verification plan. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "testPlanIntegration": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Integration-level verification plan. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "testPlanUiUx": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Browser, accessibility, and visual verification plan. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "openQuestions": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "maxItems": 50,
          "description": "Unresolved questions that still require an explicit answer. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "generatedTickets": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
              },
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500,
                "description": "Human-readable title displayed in Semel. Accepted length or value is 1 through 500, inclusive."
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 10000
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable explanatory text; null or omission means no description was supplied. A null value explicitly means no current value is available. Maximum accepted length or value is 10000."
              },
              "boundCriteria": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
                },
                "maxItems": 50,
                "description": "Stable acceptance-criterion IDs implemented by this work order. An empty array explicitly means no matching items."
              },
              "boundRequirements": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
                },
                "maxItems": 50,
                "description": "Stable requirement IDs implemented by this work order; omission is tolerated only for legacy reads. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
              }
            },
            "required": [
              "id",
              "title",
              "description",
              "boundCriteria"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Ordered implementation work orders derived from this brief. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "requiredEvidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it. Accepted length or value is 1 through 200, inclusive."
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "implementation": {
                "type": "boolean",
                "description": "Whether this criterion requires implementation; omission defaults to implementation work. Omit the field when it does not apply; omission is distinct from an empty value."
              },
              "manualEvidence": {
                "type": "object",
                "properties": {
                  "rationale": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable explanation for why this item is exempted from implementation work. Accepted length or value is 1 through 1000, inclusive."
                  },
                  "evidencePath": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Durable location or procedure for collecting the manual evidence. Accepted length or value is 1 through 1000, inclusive."
                  }
                },
                "required": [
                  "rationale",
                  "evidencePath"
                ],
                "additionalProperties": false,
                "description": "Structured exemption required when implementation is explicitly false. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "id",
              "text"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Stable-ID evidence requirements needed to prove completion. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "decisions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-authored or model-produced text for this typed record. Accepted length or value is 1 through 1000, inclusive."
              },
              "source": {
                "type": "string",
                "maxLength": 1000,
                "description": "Optional human-readable provenance for the decision. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 1000."
              },
              "stated": {
                "type": "boolean",
                "description": "Whether the decision was explicitly stated rather than inferred; omission means unknown legacy provenance. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "text"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Recorded product or engineering decisions with optional source provenance. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        },
        "sourceArtifactLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Human-readable label displayed for this record. Accepted length or value is 1 through 1000, inclusive."
              },
              "kind": {
                "type": "string",
                "maxLength": 200,
                "description": "Discriminator identifying the typed variant represented by this object. Omit the field when it does not apply; omission is distinct from an empty value. Maximum accepted length or value is 200."
              },
              "read": {
                "type": "boolean",
                "description": "Whether the referenced source artifact was read when the brief snapshot was produced. Omit the field when it does not apply; omission is distinct from an empty value."
              }
            },
            "required": [
              "label"
            ],
            "additionalProperties": false
          },
          "maxItems": 50,
          "description": "Artifact labels referenced by the brief; an empty array means none are linked. Omit the field when it does not apply; omission is distinct from an empty value. An empty array explicitly means no matching items."
        }
      },
      "additionalProperties": true,
      "description": "Complete replacement brief document for agent writes, limited to 262144 serialized bytes. Known sections use the canonical nested shapes; unknown metadata and _draft remain round-trippable."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Human-readable title displayed in Semel. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 500, inclusive."
    },
    "ifVersionNum": {
      "type": "integer",
      "description": "Optional optimistic precondition using the current brief contract version number. Omit the field when it does not apply; omission is distinct from an empty value. The value must be an integer."
    },
    "clearDraft": {
      "type": "boolean",
      "description": "When true, explicitly clears draft state after the complete document update; omission leaves it unchanged. Omit the field when it does not apply; omission is distinct from an empty value."
    },
    "briefId": {
      "type": "string",
      "minLength": 1,
      "description": "Brief identifier returned by brief_create or brief_list; the caller must have access to its project. Supply a non-empty identifier."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "content",
    "briefId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "projectId": {
          "type": "string",
          "description": "Project identifier returned by project_create or project_list; the caller must have access to that project."
        },
        "title": {
          "type": "string",
          "description": "Human-readable title displayed in Semel."
        },
        "state": {
          "type": "string",
          "enum": [
            "drafting",
            "in_review",
            "baselined",
            "in_development",
            "checked",
            "superseded",
            "closed"
          ],
          "description": "Current typed lifecycle state; the schema enum or union branch defines allowed values. Allowed values: \"drafting\", \"in_review\", \"baselined\", \"in_development\", \"checked\", \"superseded\", \"closed\"."
        },
        "currentVersionHash": {
          "type": [
            "string",
            "null"
          ],
          "description": "Hash of the current canonical brief version; null means no canonical version exists yet. A null value explicitly means no current value is available."
        },
        "content": {
          "type": "object",
          "additionalProperties": {},
          "description": "Complete brief logical document for writes, or the stored snapshot on reads; unknown metadata remains round-trippable."
        },
        "versionNum": {
          "type": "integer",
          "description": "Monotonic brief contract version number assigned by Semel. The value must be an integer."
        },
        "delivery": {
          "type": "object",
          "properties": {
            "deliveryStatus": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "built",
                    "shipped",
                    "deployed"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Explicit operator-asserted delivery state; null means it has not been marked and never implies review or approval state."
            },
            "deliveryStatusVersion": {
              "type": "integer",
              "minimum": 0,
              "description": "Monotonic optimistic-concurrency version; copy this value into ifDeliveryStatusVersion for the next deliberate write."
            },
            "changedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RFC 3339 time of the latest committed delivery change; null while delivery status remains unset at version zero."
            },
            "changedById": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable user identifier for the latest committed delivery change; null while no change has been recorded."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "web",
                    "mcp"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trusted transport that committed the latest delivery change: web for a human request, MCP for an agent request, or null when unset."
            }
          },
          "required": [
            "deliveryStatus",
            "deliveryStatusVersion",
            "changedAt",
            "changedById",
            "source"
          ],
          "additionalProperties": false,
          "description": "Current explicit delivery-status projection; it is independent from brief review, approval, and contract-version state. Omit the field when it does not apply; omission is distinct from an empty value."
        },
        "createdNewVersion": {
          "type": "boolean",
          "description": "Whether the write changed canonical content and minted a new immutable brief version."
        },
        "staledApprovals": {
          "type": "integer",
          "description": "Number of prior approval rows made stale by this content change. The value must be an integer."
        }
      },
      "required": [
        "id",
        "projectId",
        "title",
        "state",
        "currentVersionHash",
        "content",
        "versionNum",
        "createdNewVersion",
        "staledApprovals"
      ],
      "additionalProperties": false,
      "description": "Current brief record returned by the operation."
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "personal": {
      "type": "object",
      "properties": {
        "revision": {
          "type": "string",
          "minLength": 1,
          "maxLength": 20,
          "pattern": "^(?:0|[1-9][0-9]*)$",
          "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
        },
        "binding": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                },
                "audience": {
                  "type": "string",
                  "enum": [
                    "personal",
                    "team"
                  ],
                  "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
                },
                "ownerUserId": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Accountable owner of a personal reviewer skill; null identifies a workspace-team skill. A null value explicitly means no current value is available."
                },
                "revision": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 20,
                  "pattern": "^(?:0|[1-9][0-9]*)$",
                  "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
                },
                "presetId": {
                  "type": "string",
                  "description": "Stable cascade preset identifier returned by an exact preset save, list, or read."
                },
                "presetVersionId": {
                  "type": "string",
                  "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset."
                },
                "presetName": {
                  "type": "string",
                  "description": "Human-readable name of the exact preset currently bound as a default."
                },
                "updatedAt": {
                  "type": "string",
                  "description": "RFC 3339 timestamp when this record was last updated."
                }
              },
              "required": [
                "id",
                "audience",
                "ownerUserId",
                "revision",
                "presetId",
                "presetVersionId",
                "presetName",
                "updatedAt"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "Current exact preset binding after the default mutation; null means the default is reset. A null value explicitly means no current value is available."
        }
      },
      "required": [
        "revision",
        "binding"
      ],
      "additionalProperties": false,
      "description": "Caller-owned cascade default state, including its optimistic revision and exact preset binding when selected."
    },
    "team": {
      "type": "object",
      "properties": {
        "revision": {
          "type": "string",
          "minLength": 1,
          "maxLength": 20,
          "pattern": "^(?:0|[1-9][0-9]*)$",
          "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
        },
        "binding": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
                },
                "audience": {
                  "type": "string",
                  "enum": [
                    "personal",
                    "team"
                  ],
                  "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
                },
                "ownerUserId": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Accountable owner of a personal reviewer skill; null identifies a workspace-team skill. A null value explicitly means no current value is available."
                },
                "revision": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 20,
                  "pattern": "^(?:0|[1-9][0-9]*)$",
                  "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
                },
                "presetId": {
                  "type": "string",
                  "description": "Stable cascade preset identifier returned by an exact preset save, list, or read."
                },
                "presetVersionId": {
                  "type": "string",
                  "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset."
                },
                "presetName": {
                  "type": "string",
                  "description": "Human-readable name of the exact preset currently bound as a default."
                },
                "updatedAt": {
                  "type": "string",
                  "description": "RFC 3339 timestamp when this record was last updated."
                }
              },
              "required": [
                "id",
                "audience",
                "ownerUserId",
                "revision",
                "presetId",
                "presetVersionId",
                "presetName",
                "updatedAt"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "Current exact preset binding after the default mutation; null means the default is reset. A null value explicitly means no current value is available."
        }
      },
      "required": [
        "revision",
        "binding"
      ],
      "additionalProperties": false,
      "description": "Workspace team cascade default state, including its optimistic revision and exact preset binding when selected."
    },
    "effective": {
      "type": "object",
      "properties": {
        "origin": {
          "type": "string",
          "enum": [
            "project",
            "personal_default",
            "team_default",
            "builtin_fallback",
            "explicit_override"
          ],
          "description": "Immutable source from which this cascade configuration was adopted; it never consults a current default. Allowed values: \"project\", \"personal_default\", \"team_default\", \"builtin_fallback\", \"explicit_override\"."
        },
        "presetVersionId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset. A null value explicitly means no current value is available."
        },
        "payload": {
          "type": "object",
          "properties": {
            "schemaVersion": {
              "type": "number",
              "const": 1,
              "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 1."
            },
            "occurrences": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "occurrenceId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                  },
                  "reviewerRef": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "builtin",
                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                          },
                          "role": {
                            "type": "string",
                            "enum": [
                              "product",
                              "engineering",
                              "design",
                              "security",
                              "test"
                            ],
                            "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                          }
                        },
                        "required": [
                          "kind",
                          "role"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "custom",
                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                          },
                          "skillId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                          },
                          "versionId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                          }
                        },
                        "required": [
                          "kind",
                          "skillId",
                          "versionId"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                  },
                  "enabled": {
                    "type": "boolean",
                    "description": "Whether this frozen reviewer occurrence participates in execution; disabled occurrences remain inspectable."
                  },
                  "skill": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                      },
                      "displayVersion": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Server-derived human-readable publication number for the exact reviewer skill version. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
                      },
                      "sha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$",
                        "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                      }
                    },
                    "required": [
                      "version",
                      "sha256"
                    ],
                    "additionalProperties": false,
                    "description": "Exact immutable reviewer skill artifact pin used for this occurrence."
                  },
                  "model": {
                    "type": "object",
                    "properties": {
                      "provider": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "description": "Resolved inference provider preserved in the immutable reviewer execution pin. Accepted length or value is 1 through 100, inclusive."
                      },
                      "model": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Optional model name declared by the harness. Accepted length or value is 1 through 200, inclusive."
                      },
                      "reasoning": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Resolved reasoning setting preserved in the immutable model pin; null means the model accepts none. A null value explicitly means no current value is available. Accepted length or value is 1 through 100, inclusive."
                      }
                    },
                    "required": [
                      "provider",
                      "model",
                      "reasoning"
                    ],
                    "additionalProperties": false,
                    "description": "Optional model name declared by the harness."
                  }
                },
                "required": [
                  "occurrenceId",
                  "reviewerRef",
                  "label",
                  "enabled",
                  "skill",
                  "model"
                ],
                "additionalProperties": false
              },
              "minItems": 1,
              "maxItems": 20,
              "description": "Ordered reviewer occurrences preserved by this preset, project configuration, or explicit review override. An empty array explicitly means no matching items."
            }
          },
          "required": [
            "schemaVersion",
            "occurrences"
          ],
          "additionalProperties": false,
          "description": "Complete ordered cascade selection preserved in this immutable preset or configuration version."
        }
      },
      "required": [
        "origin",
        "presetVersionId",
        "payload"
      ],
      "additionalProperties": false,
      "description": "Exact cascade selection that a newly created project would inherit after this operation."
    },
    "canEditTeam": {
      "type": "boolean",
      "description": "Whether the current authenticated caller may change the workspace team cascade default."
    }
  },
  "required": [
    "personal",
    "team",
    "effective",
    "canEditTeam"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "audience": {
      "type": "string",
      "enum": [
        "personal",
        "team"
      ],
      "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
    },
    "expectedRevision": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^(?:0|[1-9][0-9]*)$",
      "description": "Optimistic concurrency value copied from the latest preset, default, or project configuration read. Accepted length or value is 1 through 20, inclusive."
    },
    "presetVersionId": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset. A null value explicitly means no current value is available. Minimum accepted length or value is 1."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "audience",
    "expectedRevision",
    "presetVersionId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "operationId": {
      "type": "string",
      "description": "Stable identifier for this mutation attempt and its durable idempotent receipt."
    },
    "binding": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
            },
            "audience": {
              "type": "string",
              "enum": [
                "personal",
                "team"
              ],
              "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
            },
            "ownerUserId": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accountable owner of a personal reviewer skill; null identifies a workspace-team skill. A null value explicitly means no current value is available."
            },
            "revision": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20,
              "pattern": "^(?:0|[1-9][0-9]*)$",
              "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
            },
            "presetId": {
              "type": "string",
              "description": "Stable cascade preset identifier returned by an exact preset save, list, or read."
            },
            "presetVersionId": {
              "type": "string",
              "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset."
            },
            "presetName": {
              "type": "string",
              "description": "Human-readable name of the exact preset currently bound as a default."
            },
            "updatedAt": {
              "type": "string",
              "description": "RFC 3339 timestamp when this record was last updated."
            }
          },
          "required": [
            "id",
            "audience",
            "ownerUserId",
            "revision",
            "presetId",
            "presetVersionId",
            "presetName",
            "updatedAt"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Current exact preset binding after the default mutation; null means the default is reset. A null value explicitly means no current value is available."
    },
    "effective": {
      "type": "object",
      "properties": {
        "origin": {
          "type": "string",
          "enum": [
            "project",
            "personal_default",
            "team_default",
            "builtin_fallback",
            "explicit_override"
          ],
          "description": "Immutable source from which this cascade configuration was adopted; it never consults a current default. Allowed values: \"project\", \"personal_default\", \"team_default\", \"builtin_fallback\", \"explicit_override\"."
        },
        "presetVersionId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Immutable preset-version source when configuration was adopted from or explicitly based on a preset. A null value explicitly means no current value is available."
        },
        "payload": {
          "type": "object",
          "properties": {
            "schemaVersion": {
              "type": "number",
              "const": 1,
              "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 1."
            },
            "occurrences": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "occurrenceId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                  },
                  "reviewerRef": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "builtin",
                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                          },
                          "role": {
                            "type": "string",
                            "enum": [
                              "product",
                              "engineering",
                              "design",
                              "security",
                              "test"
                            ],
                            "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                          }
                        },
                        "required": [
                          "kind",
                          "role"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "custom",
                            "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                          },
                          "skillId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                          },
                          "versionId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                          }
                        },
                        "required": [
                          "kind",
                          "skillId",
                          "versionId"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                  },
                  "enabled": {
                    "type": "boolean",
                    "description": "Whether this frozen reviewer occurrence participates in execution; disabled occurrences remain inspectable."
                  },
                  "skill": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                      },
                      "displayVersion": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Server-derived human-readable publication number for the exact reviewer skill version. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
                      },
                      "sha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$",
                        "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                      }
                    },
                    "required": [
                      "version",
                      "sha256"
                    ],
                    "additionalProperties": false,
                    "description": "Exact immutable reviewer skill artifact pin used for this occurrence."
                  },
                  "model": {
                    "type": "object",
                    "properties": {
                      "provider": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "description": "Resolved inference provider preserved in the immutable reviewer execution pin. Accepted length or value is 1 through 100, inclusive."
                      },
                      "model": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Optional model name declared by the harness. Accepted length or value is 1 through 200, inclusive."
                      },
                      "reasoning": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Resolved reasoning setting preserved in the immutable model pin; null means the model accepts none. A null value explicitly means no current value is available. Accepted length or value is 1 through 100, inclusive."
                      }
                    },
                    "required": [
                      "provider",
                      "model",
                      "reasoning"
                    ],
                    "additionalProperties": false,
                    "description": "Optional model name declared by the harness."
                  }
                },
                "required": [
                  "occurrenceId",
                  "reviewerRef",
                  "label",
                  "enabled",
                  "skill",
                  "model"
                ],
                "additionalProperties": false
              },
              "minItems": 1,
              "maxItems": 20,
              "description": "Ordered reviewer occurrences preserved by this preset, project configuration, or explicit review override. An empty array explicitly means no matching items."
            }
          },
          "required": [
            "schemaVersion",
            "occurrences"
          ],
          "additionalProperties": false,
          "description": "Complete ordered cascade selection preserved in this immutable preset or configuration version."
        }
      },
      "required": [
        "origin",
        "presetVersionId",
        "payload"
      ],
      "additionalProperties": false,
      "description": "Exact cascade selection that a newly created project would inherit after this operation."
    }
  },
  "required": [
    "operationId",
    "binding",
    "effective"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "presetId": {
      "type": "string",
      "minLength": 1,
      "description": "Stable cascade preset identifier returned by an exact preset save, list, or read. Minimum accepted length or value is 1."
    },
    "versionId": {
      "type": "string",
      "minLength": 1,
      "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract. Omit the field when it does not apply; omission is distinct from an empty value. Minimum accepted length or value is 1."
    }
  },
  "required": [
    "presetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "preset": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "audience": {
          "type": "string",
          "enum": [
            "personal",
            "team"
          ],
          "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
        },
        "ownerUserId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Accountable owner of a personal reviewer skill; null identifies a workspace-team skill. A null value explicitly means no current value is available."
        },
        "name": {
          "type": "string",
          "description": "Human-readable name displayed in Semel."
        },
        "revision": {
          "type": "string",
          "minLength": 1,
          "maxLength": 20,
          "pattern": "^(?:0|[1-9][0-9]*)$",
          "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
        },
        "archivedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "RFC 3339 archive timestamp; null means the preset remains available for new selection. A null value explicitly means no current value is available."
        },
        "currentVersion": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
            },
            "presetId": {
              "type": "string",
              "description": "Stable cascade preset identifier returned by an exact preset save, list, or read."
            },
            "versionNumber": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20,
              "pattern": "^(?:0|[1-9][0-9]*)$",
              "description": "Positive monotonic publication number assigned to this immutable reviewer-skill version. Accepted length or value is 1 through 20, inclusive."
            },
            "payload": {
              "type": "object",
              "properties": {
                "schemaVersion": {
                  "type": "number",
                  "const": 1,
                  "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 1."
                },
                "occurrences": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "occurrenceId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                      },
                      "reviewerRef": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "builtin",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                              },
                              "role": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ],
                                "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                              }
                            },
                            "required": [
                              "kind",
                              "role"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "custom",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                              },
                              "skillId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                              },
                              "versionId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                              }
                            },
                            "required": [
                              "kind",
                              "skillId",
                              "versionId"
                            ],
                            "additionalProperties": false
                          }
                        ],
                        "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                      },
                      "enabled": {
                        "type": "boolean",
                        "description": "Whether this frozen reviewer occurrence participates in execution; disabled occurrences remain inspectable."
                      },
                      "skill": {
                        "type": "object",
                        "properties": {
                          "version": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                          },
                          "displayVersion": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "description": "Server-derived human-readable publication number for the exact reviewer skill version. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
                          },
                          "sha256": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$",
                            "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                          }
                        },
                        "required": [
                          "version",
                          "sha256"
                        ],
                        "additionalProperties": false,
                        "description": "Exact immutable reviewer skill artifact pin used for this occurrence."
                      },
                      "model": {
                        "type": "object",
                        "properties": {
                          "provider": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "description": "Resolved inference provider preserved in the immutable reviewer execution pin. Accepted length or value is 1 through 100, inclusive."
                          },
                          "model": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "description": "Optional model name declared by the harness. Accepted length or value is 1 through 200, inclusive."
                          },
                          "reasoning": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Resolved reasoning setting preserved in the immutable model pin; null means the model accepts none. A null value explicitly means no current value is available. Accepted length or value is 1 through 100, inclusive."
                          }
                        },
                        "required": [
                          "provider",
                          "model",
                          "reasoning"
                        ],
                        "additionalProperties": false,
                        "description": "Optional model name declared by the harness."
                      }
                    },
                    "required": [
                      "occurrenceId",
                      "reviewerRef",
                      "label",
                      "enabled",
                      "skill",
                      "model"
                    ],
                    "additionalProperties": false
                  },
                  "minItems": 1,
                  "maxItems": 20,
                  "description": "Ordered reviewer occurrences preserved by this preset, project configuration, or explicit review override. An empty array explicitly means no matching items."
                }
              },
              "required": [
                "schemaVersion",
                "occurrences"
              ],
              "additionalProperties": false,
              "description": "Complete ordered cascade selection preserved in this immutable preset or configuration version."
            },
            "createdById": {
              "type": "string",
              "description": "Semel user identifier recorded as the initiating creator."
            },
            "createdAt": {
              "type": "string",
              "description": "RFC 3339 timestamp assigned by Semel when this record was created."
            }
          },
          "required": [
            "id",
            "presetId",
            "versionNumber",
            "payload",
            "createdById",
            "createdAt"
          ],
          "additionalProperties": false,
          "description": "Current immutable version of this cascade preset, including its exact reviewer pins."
        },
        "canEdit": {
          "type": "boolean",
          "description": "Whether the current authenticated principal may edit this reviewer skill."
        },
        "createdAt": {
          "type": "string",
          "description": "RFC 3339 timestamp assigned by Semel when this record was created."
        },
        "updatedAt": {
          "type": "string",
          "description": "RFC 3339 timestamp when this record was last updated."
        }
      },
      "required": [
        "id",
        "audience",
        "ownerUserId",
        "name",
        "revision",
        "archivedAt",
        "currentVersion",
        "canEdit",
        "createdAt",
        "updatedAt"
      ],
      "additionalProperties": false,
      "description": "Authorized cascade preset metadata and its exact immutable selected version."
    }
  },
  "required": [
    "preset"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "presetId": {
      "type": "string",
      "minLength": 1,
      "description": "Stable cascade preset identifier returned by an exact preset save, list, or read. Omit the field when it does not apply; omission is distinct from an empty value. Minimum accepted length or value is 1."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Human-readable name displayed in Semel. Minimum accepted length or value is 1."
    },
    "audience": {
      "type": "string",
      "enum": [
        "personal",
        "team"
      ],
      "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
    },
    "expectedRevision": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^(?:0|[1-9][0-9]*)$",
      "description": "Optimistic concurrency value copied from the latest preset, default, or project configuration read. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 20, inclusive."
    },
    "occurrences": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "occurrenceId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
          },
          "reviewerRef": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "builtin",
                    "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                  },
                  "role": {
                    "type": "string",
                    "enum": [
                      "product",
                      "engineering",
                      "design",
                      "security",
                      "test"
                    ],
                    "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                  }
                },
                "required": [
                  "kind",
                  "role"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "custom",
                    "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                  },
                  "skillId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                  },
                  "versionId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                  }
                },
                "required": [
                  "kind",
                  "skillId",
                  "versionId"
                ],
                "additionalProperties": false
              }
            ],
            "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
          },
          "enabled": {
            "type": "boolean",
            "description": "Whether this frozen reviewer occurrence participates in execution; disabled occurrences remain inspectable."
          },
          "skill": {
            "type": "object",
            "properties": {
              "version": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
              },
              "displayVersion": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Server-derived human-readable publication number for the exact reviewer skill version. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
              },
              "sha256": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$",
                "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
              }
            },
            "required": [
              "version",
              "sha256"
            ],
            "additionalProperties": false,
            "description": "Exact immutable reviewer skill artifact pin used for this occurrence."
          },
          "model": {
            "type": "object",
            "properties": {
              "provider": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "description": "Resolved inference provider preserved in the immutable reviewer execution pin. Accepted length or value is 1 through 100, inclusive."
              },
              "model": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Optional model name declared by the harness. Accepted length or value is 1 through 200, inclusive."
              },
              "reasoning": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Resolved reasoning setting preserved in the immutable model pin; null means the model accepts none. A null value explicitly means no current value is available. Accepted length or value is 1 through 100, inclusive."
              }
            },
            "required": [
              "provider",
              "model",
              "reasoning"
            ],
            "additionalProperties": false,
            "description": "Optional model name declared by the harness."
          }
        },
        "required": [
          "occurrenceId",
          "reviewerRef",
          "label",
          "enabled",
          "skill",
          "model"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 20,
      "description": "Ordered reviewer occurrences preserved by this preset, project configuration, or explicit review override. An empty array explicitly means no matching items."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "description": "Caller-unique key making this mutation exactly-once (see the receipt contract)."
    }
  },
  "required": [
    "name",
    "audience",
    "occurrences",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "operationId": {
      "type": "string",
      "description": "Stable identifier for this mutation attempt and its durable idempotent receipt."
    },
    "preset": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
        },
        "audience": {
          "type": "string",
          "enum": [
            "personal",
            "team"
          ],
          "description": "Visibility of the customer reviewer skill: personal to its accountable owner or shared with workspace members. Allowed values: \"personal\", \"team\"."
        },
        "ownerUserId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Accountable owner of a personal reviewer skill; null identifies a workspace-team skill. A null value explicitly means no current value is available."
        },
        "name": {
          "type": "string",
          "description": "Human-readable name displayed in Semel."
        },
        "revision": {
          "type": "string",
          "minLength": 1,
          "maxLength": 20,
          "pattern": "^(?:0|[1-9][0-9]*)$",
          "description": "Indexed repository revision used for this evidence result. Accepted length or value is 1 through 20, inclusive."
        },
        "archivedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "RFC 3339 archive timestamp; null means the preset remains available for new selection. A null value explicitly means no current value is available."
        },
        "currentVersion": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Stable identifier for this record; copy it from the corresponding create, list, or read result rather than inventing it."
            },
            "presetId": {
              "type": "string",
              "description": "Stable cascade preset identifier returned by an exact preset save, list, or read."
            },
            "versionNumber": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20,
              "pattern": "^(?:0|[1-9][0-9]*)$",
              "description": "Positive monotonic publication number assigned to this immutable reviewer-skill version. Accepted length or value is 1 through 20, inclusive."
            },
            "payload": {
              "type": "object",
              "properties": {
                "schemaVersion": {
                  "type": "number",
                  "const": 1,
                  "description": "Version of the strict schema used to encode this stored or transmitted record. This branch always uses 1."
                },
                "occurrences": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "occurrenceId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "description": "Server-issued identifier for one ordered reviewer occurrence; repeated reviewer skills have distinct values."
                      },
                      "reviewerRef": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "builtin",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"builtin\"."
                              },
                              "role": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "engineering",
                                  "design",
                                  "security",
                                  "test"
                                ],
                                "description": "Pinned reviewer or artifact role used by the execution bundle. Allowed values: \"product\", \"engineering\", \"design\", \"security\", \"test\"."
                              }
                            },
                            "required": [
                              "kind",
                              "role"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "custom",
                                "description": "Discriminator identifying the typed variant represented by this object. This branch always uses \"custom\"."
                              },
                              "skillId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable tenant skill identifier used by a custom reviewer reference."
                              },
                              "versionId": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Immutable version identifier returned by the owning brief, reviewer skill, or claim contract."
                              }
                            },
                            "required": [
                              "kind",
                              "skillId",
                              "versionId"
                            ],
                            "additionalProperties": false
                          }
                        ],
                        "description": "Tagged immutable reviewer reference identifying either a built-in role or an exact custom skill version."
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Human-readable label displayed for this record. Minimum accepted length or value is 1."
                      },
                      "enabled": {
                        "type": "boolean",
                        "description": "Whether this frozen reviewer occurrence participates in execution; disabled occurrences remain inspectable."
                      },
                      "skill": {
                        "type": "object",
                        "properties": {
                          "version": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "description": "Positive version number of a skill artifact or nonnegative snapshot version of a knowledge collection. Accepted length or value is 1 through 200, inclusive."
                          },
                          "displayVersion": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "description": "Server-derived human-readable publication number for the exact reviewer skill version. Omit the field when it does not apply; omission is distinct from an empty value. Accepted length or value is 1 through 200, inclusive."
                          },
                          "sha256": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$",
                            "description": "Lowercase hexadecimal SHA-256 digest used to verify exact bytes."
                          }
                        },
                        "required": [
                          "version",
                          "sha256"
                        ],
                        "additionalProperties": false,
                        "description": "Exact immutable reviewer skill artifact pin used for this occurrence."
                      },
                      "model": {
                        "type": "object",
                        "properties": {
                          "provider": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "description": "Resolved inference provider preserved in the immutable reviewer execution pin. Accepted length or value is 1 through 100, inclusive."
                          },
                          "model": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "description": "Optional model name declared by the harness. Accepted length or value is 1 through 200, inclusive."
                          },
                          "reasoning": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Resolved reasoning setting preserved in the immutable model pin; null means the model accepts none. A null value explicitly means no current value is available. Accepted length or value is 1 through 100, inclusive."
                          }
                        },
                        "required": [
                          "provider",
                          "model",
                          "reasoning"
                        ],
                        "additionalProperties": false,
                        "description": "Optional model name declared by the harness."
                      }
                    },
                    "required": [
                      "occurrenceId",
                      "reviewerRef",
                      "label",
                      "enabled",
                      "skill",
                      "model"
                    ],
                    "additionalProperties": false
                  },
                  "minItems": 1,
                  "maxItems": 20,
                  "description": "Ordered reviewer occurrences preserved by this preset, project configuration, or explicit review override. An empty array explicitly means no matching items."
                }
              },
              "required": [
                "schemaVersion",
                "occurrences"
              ],
              "additionalProperties": false,
              "description": "Complete ordered cascade selection preserved in this immutable preset or configuration version."
            },
            "createdById": {
              "type": "string",
              "description": "Semel user identifier recorded as the initiating creator."
            },
            "createdAt": {
              "type": "string",
              "description": "RFC 3339 timestamp assigned by Semel when this record was created."
            }
          },
          "required": [
            "id",
            "presetId",
            "versionNumber",
            "payload",
            "createdById",
            "createdAt"
          ],
          "additionalProperties": false,
          "description": "Current immutable version of this cascade preset, including its exact reviewer pins."
        },
        "canEdit": {
          "type": "boolean",
          "description": "Whether the current authenticated principal may edit this reviewer skill."
        },
        "createdAt": {
          "type": "string",
          "description": "RFC 3339 timestamp assigned by Semel when this record was created."
        },
        "updatedAt": {
          "type": "string",
          "description": "RFC 3339 timestamp when this record was last updated."
        }
      },
      "required": [
        "id",
        "audience",
        "ownerUserId",
        "name",
        "revision",
        "archivedAt",
        "currentVersion",
        "canEdit",
        "createdAt",
        "updatedAt"
      ],
      "additionalProperties": false,
      "description": "Authorized cascade preset metadata and its exact immutable selected version."
    }
  },
  "required": [
    "operationId",
    "preset"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Project identifier whose exact current reviewer cascade should be inspected."
    }
  },
  "required": [
    "projectId"
  ],
  "additionalProperties": false
}