tender_brief contract v2

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/tender_brief/v2.json",
  "title": "tender_brief contract v2",
  "type": "object",
  "required": [
    "briefed_at",
    "data_coverage",
    "headline",
    "open_question_count",
    "review_state",
    "sections",
    "source_opportunity_ref",
    "status"
  ],
  "properties": {
    "status": {
      "type": "string",
      "description": "The composing run's outcome, including the honest \"too little to compose\" and \"could not read\" states.",
      "x-demiton-requiredness": "required"
    },
    "headline": {
      "type": "string",
      "description": "One-sentence statement of the brief.",
      "x-demiton-requiredness": "required"
    },
    "sections": {
      "type": "array",
      "description": "The brief body: one object per fixed section.",
      "x-demiton-requiredness": "required",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "Which section this object is.",
            "x-demiton-requiredness": "required"
          },
          "markdown": {
            "type": "string",
            "description": "The section prose.",
            "x-demiton-requiredness": "required"
          },
          "citations": {
            "type": "array",
            "description": "The evidence for every figure or factual claim in the section.",
            "x-demiton-requiredness": "required"
          }
        },
        "required": [
          "citations",
          "key",
          "markdown"
        ]
      }
    },
    "briefed_at": {
      "type": "string",
      "description": "When the brief was composed; the as-of anchor against which the 720-hour freshness window is measured.",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "UTC",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "agent_run_id": {
      "type": "number",
      "description": "Which AgentRun produced the brief.",
      "x-demiton-requiredness": "optional"
    },
    "review_state": {
      "type": "string",
      "description": "The record's human-review / publication marker: agent-proposed, not human-approved and not emittable.",
      "x-demiton-requiredness": "required"
    },
    "data_coverage": {
      "type": "object",
      "description": "The honesty ledger: what was consulted, what came back empty, what documents were read.",
      "x-demiton-requiredness": "required",
      "properties": {
        "conduits_empty": {
          "type": "array",
          "description": "Shelves read that returned nothing — the ledger that makes an empty brief honest.",
          "x-demiton-requiredness": "required"
        },
        "documents_read": {
          "type": "array",
          "description": "The tender documents read, by path and page range.",
          "x-demiton-requiredness": "required"
        },
        "conduits_consulted": {
          "type": "array",
          "description": "The Civil Memory shelves the run read.",
          "x-demiton-requiredness": "required"
        }
      },
      "required": [
        "conduits_consulted",
        "conduits_empty",
        "documents_read"
      ]
    },
    "open_question_count": {
      "type": "integer",
      "description": "How many material questions the facts did not answer.",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "count"
    },
    "source_opportunity_ref": {
      "type": "string",
      "description": "The opportunity identifier the brief is anchored to.",
      "x-demiton-requiredness": "required"
    },
    "citations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "description": "The fact id, or the document path plus page.",
            "x-demiton-requiredness": "required"
          },
          "kind": {
            "type": "string",
            "description": "Whether the citation points at a memory fact or a document read.",
            "x-demiton-requiredness": "required"
          },
          "note": {
            "type": "string",
            "description": "Free qualifier on the citation.",
            "x-demiton-requiredness": "optional"
          }
        },
        "required": [
          "kind",
          "ref"
        ]
      }
    }
  },
  "x-demiton-register-type": "tender_brief",
  "x-demiton-contract-version": "2.0.1",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "Directive 2014/24/EU",
        "title": "Directive 2014/24/EU on public procurement",
        "access": "full_text_verified",
        "clause": "Art. 84",
        "region": "European Union",
        "edition": "26 Feb 2014 (consolidated)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "OC4IDS",
        "title": "Open Contracting for Infrastructure Data Standard",
        "access": "full_text_verified",
        "clause": "contractingProcesses",
        "region": "International",
        "edition": "0.9.5 (site switcher shows 0.9.4; unresolved)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "OCDS",
        "title": "Open Contracting Data Standard",
        "access": "full_text_verified",
        "region": "International",
        "edition": "1.1 (documentation release 1.1.5)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "A cited brief on a tender: everything known about it and how you are placed to pursue it.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/tender_brief/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}