tech.transparencia.document.mxdof.note.enrichment

transparencia.pds.transparencia.tech

Documentation

Sidecar record carrying the full enrichment of a single DOF nota. One nota can have multiple enrichments (different models, different analysts, different languages); all of them reference the same tech.transparencia.document.mxdof.note record via strongRef.

main record

Sidecar record carrying the full enrichment of a single DOF nota. One nota can have multiple enrichments (different models, different analysts, different languages); all of them reference the same tech.transparencia.document.mxdof.note record via strongRef.

Record Key tid Timestamp-based ID

Properties

complianceItems array of ref #complianceItem Optional

Structured compliance tasks derived from the publication when the nota sets actionable requirements. Empty array when the document does not contain clear actions.

maxLength: 50 items
contentDomain string Required

Cross-domain classification aligned with the existing TransparencIA news taxonomy (IPTC Media Topics) for mixed analysis across DOF and news.

maxLength: 64 bytes
Known values: arts-culture-entertainment, crime-law-justice, disaster-accident, economy-business-finance, education, environment, health, human-interest, labour, lifestyle-leisure, politics, religion, science-technology, society, sport, conflict-war-peace, weather
costUsd string Optional

Cost of this inference in USD as a decimal string (AT Protocol does not support floats). Example: '0.00123456'.

maxLength: 32 bytes
createdAt string datetime Required

When this enrichment was generated.

documentClass string Required

Broad publication family used for cross-type analysis while preserving the more specific tipoActo field.

maxLength: 64 bytes
Known values: normative, judicial, procurement, intergovernmental, planning, administrative, informational, other
effectiveDate string datetime Optional

Normalized effective date/time when the act takes effect, if recoverable with confidence from the text. Distinct from tech.transparencia.document.item.effectiveAt (which is from source metadata).

effectiveDateText string Optional

Original textual expression of vigencia when a normalized date is unavailable or lossy (e.g., 'al día siguiente al de su publicación en el Diario Oficial de la Federación').

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
eventType string Required

Cross-domain event/action category for shared analytics. Common DOF values: policy-legislation, regulatory-action, court-ruling-legal, announcement, data-report-study, appointment-resignation, investigation-audit, infrastructure-project. Open set.

maxLength: 64 bytes
Known values: policy-legislation, regulatory-action, court-ruling-legal, announcement, data-report-study, appointment-resignation, investigation-audit, infrastructure-project, diplomatic-relations, environmental-incident, other
geographicScope string Optional

Free-text spatial scope when finer legal phrasing matters (e.g., 'Estado de México', 'República Mexicana', 'puertos nacionales', 'Jalisco').

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
impactLevel integer Required

Estimated relevance and severity for public analysis. 1 = routine procedural notice, 3 = limited administrative or regulatory act, 5 = clear sectoral or intergovernmental change, 7 = significant reform / national program / major institutional decision, 10 = constitutional change or extraordinary structural transformation.

minimum: 1maximum: 10
impactReasoning string Optional

Brief justification for the impactLevel score.

maxLength: 5000 bytesmaxGraphemes: 1000 graphemes
inputTokens integer Optional

Tokens consumed by the LLM prompt for this enrichment.

minimum: 0
language string language Required

Language of this enrichment's free-text fields (BCP-47, e.g., 'es-MX', 'es', 'en'). Independent of the document's own language; multiple language enrichments can coexist for the same nota.

legalEffects array of string Optional

Normalized verbs or phrases describing what the act does in legal or administrative terms. Open set; only include effects substantiated by the text.

maxLength: 30 items
locations array of ref tech.transparencia.defs#location Required

Geographic references: states, municipalities, ciudades, puertos, circuitos judiciales, or the territorial scope of the act. Empty array when no specific location is recoverable.

maxLength: 50 items
modelUsed string Required

AI model or analyst profile identifier that produced the enrichment (e.g., 'claude-3-5-sonnet', 'gemini-2.0-flash', 'manual-analyst-v1').

maxLength: 256 bytes
modelVersion string Optional

Model version or checkpoint.

maxLength: 256 bytes
neutralHeadline string Optional

Optional plain-language rewrite of the official title, useful when the DOF title is formulaic or excessively legalistic.

maxLength: 4096 bytesmaxGraphemes: 1024 graphemes
note ref com.atproto.repo.strongRef Required

Strong reference to the tech.transparencia.document.mxdof.note record being enriched. Consumers can hop to the underlying tech.transparencia.document.item via note.item.

obligations array of string Optional

Concrete obligations, duties, deadlines, restrictions, or compliance actions extracted from the nota as Spanish free-text statements. For more structured tasks, use complianceItems.

maxLength: 50 items
organizationEntities array of ref tech.transparencia.defs#organization Required

Institutions, tribunals, secretarías, organismos autónomos, empresas públicas, entes convocantes, or other organizations referenced in the publication.

maxLength: 50 items
outputTokens integer Optional

Tokens generated by the LLM response.

minimum: 0
people array of ref tech.transparencia.defs#person Required

People materially relevant to the nota: titulares del acto, ministros firmantes, gobernadores, autoridades responsables, litigantes, terceros interesados. Only natural persons.

maxLength: 50 items
readingLevel string Optional

Approximate reading level of the document content, useful for UX surfacing of legalistic vs accessible texts.

maxLength: 32 bytes
Known values: basic, intermediate, advanced
region string Optional

Geographic scope of the publication's effects or relevance.

maxLength: 32 bytes
Known values: local, state, national, regional, global
relatedReferences array of ref #relatedReference Required

References to prior or related legal/administrative materials that the nota cites, modifies, abrogates, complements, or depends on (leyes, reglamentos, acuerdos, decretos, expedientes, acciones de inconstitucionalidad, tratados, programas, etc.).

maxLength: 100 items
sector string Required

Main affected policy or institutional sector. Spanish lowercased tokens. Open set.

maxLength: 128 bytesmaxGraphemes: 64 graphemes
Known values: salud, justicia, seguridad, energia, transporte, hacienda, educacion, medio_ambiente, telecomunicaciones, agropecuario, trabajo, cultura, comercio, defensa, administracion_publica, vivienda, relaciones_exteriores, otro
sourceAuthorityLevel string Optional

Normalized authority tier, mirrored from tech.transparencia.document.mxdof.note.authorityLevel for analytical convenience.

maxLength: 64 bytes
Known values: federal_executive, federal_judicial, federal_legislative, autonomous_constitutional_body, state_judicial, state_executive, state_legislative, municipal, state_owned_enterprise, decentralized_body, procurement_section, judicial_notices_section, other
structuredRefs array of ref tech.transparencia.defs#structuredRef Required

Typed references useful for graph navigation across laws, cases, programs, regulations, treaties, procurement IDs, and related objects.

maxLength: 100 items
summary string Required

Plain-language explanation in 2–4 sentences of what the nota publishes, who issues it, what it changes or orders, and who it affects. Prioritize substance over formalities.

maxLength: 10000 bytesmaxGraphemes: 2500 graphemes
targetEntities array of string Optional

Who the act directly affects or addresses: proveedores interesados, terceros interesados, secretarías coordinadas, gobiernos estatales, instituciones de salud, concesionarios, sujetos regulados, población beneficiaria, etc. Free-form Spanish strings.

maxLength: 30 items
timeline array of ref #timelineEntry Optional

Chronological events or milestones described by the publication.

maxLength: 30 items
tipoActo string Required

Specific legal-administrative act type observed or inferred from the nota. Lowercased except for acronyms or proper names. Open set; consumers should tolerate unknown values.

maxLength: 128 bytesmaxGraphemes: 64 graphemes
Known values: decreto, acuerdo, acuerdo-secretarial, sentencia, edicto, aviso-judicial, aviso, licitacion, convocatoria, convenio, convenio-modificatorio, circular, lineamientos, manual, programa, declaratoria, resolucion, calendario, oficio, nota-aclaratoria, extracto-de-acuerdo, otro
topics array of string Required

Primary topical tags. Spanish or English free-form.

maxLength: 15 items
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "note",
      "summary",
      "tipoActo",
      "documentClass",
      "sector",
      "impactLevel",
      "topics",
      "people",
      "organizationEntities",
      "locations",
      "relatedReferences",
      "structuredRefs",
      "contentDomain",
      "eventType",
      "modelUsed",
      "language",
      "createdAt"
    ],
    "properties": {
      "note": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "Strong reference to the tech.transparencia.document.mxdof.note record being enriched. Consumers can hop to the underlying tech.transparencia.document.item via note.item."
      },
      "people": {
        "type": "array",
        "items": {
          "ref": "tech.transparencia.defs#person",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "People materially relevant to the nota: titulares del acto, ministros firmantes, gobernadores, autoridades responsables, litigantes, terceros interesados. Only natural persons."
      },
      "region": {
        "type": "string",
        "maxLength": 32,
        "description": "Geographic scope of the publication's effects or relevance.",
        "knownValues": [
          "local",
          "state",
          "national",
          "regional",
          "global"
        ]
      },
      "sector": {
        "type": "string",
        "maxLength": 128,
        "description": "Main affected policy or institutional sector. Spanish lowercased tokens. Open set.",
        "knownValues": [
          "salud",
          "justicia",
          "seguridad",
          "energia",
          "transporte",
          "hacienda",
          "educacion",
          "medio_ambiente",
          "telecomunicaciones",
          "agropecuario",
          "trabajo",
          "cultura",
          "comercio",
          "defensa",
          "administracion_publica",
          "vivienda",
          "relaciones_exteriores",
          "otro"
        ],
        "maxGraphemes": 64
      },
      "topics": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 1024,
          "maxGraphemes": 256
        },
        "maxLength": 15,
        "description": "Primary topical tags. Spanish or English free-form."
      },
      "costUsd": {
        "type": "string",
        "maxLength": 32,
        "description": "Cost of this inference in USD as a decimal string (AT Protocol does not support floats). Example: '0.00123456'."
      },
      "summary": {
        "type": "string",
        "maxLength": 10000,
        "description": "Plain-language explanation in 2–4 sentences of what the nota publishes, who issues it, what it changes or orders, and who it affects. Prioritize substance over formalities.",
        "maxGraphemes": 2500
      },
      "language": {
        "type": "string",
        "format": "language",
        "description": "Language of this enrichment's free-text fields (BCP-47, e.g., 'es-MX', 'es', 'en'). Independent of the document's own language; multiple language enrichments can coexist for the same nota."
      },
      "timeline": {
        "type": "array",
        "items": {
          "ref": "#timelineEntry",
          "type": "ref"
        },
        "maxLength": 30,
        "description": "Chronological events or milestones described by the publication."
      },
      "tipoActo": {
        "type": "string",
        "maxLength": 128,
        "description": "Specific legal-administrative act type observed or inferred from the nota. Lowercased except for acronyms or proper names. Open set; consumers should tolerate unknown values.",
        "knownValues": [
          "decreto",
          "acuerdo",
          "acuerdo-secretarial",
          "sentencia",
          "edicto",
          "aviso-judicial",
          "aviso",
          "licitacion",
          "convocatoria",
          "convenio",
          "convenio-modificatorio",
          "circular",
          "lineamientos",
          "manual",
          "programa",
          "declaratoria",
          "resolucion",
          "calendario",
          "oficio",
          "nota-aclaratoria",
          "extracto-de-acuerdo",
          "otro"
        ],
        "maxGraphemes": 64
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "When this enrichment was generated."
      },
      "eventType": {
        "type": "string",
        "maxLength": 64,
        "description": "Cross-domain event/action category for shared analytics. Common DOF values: policy-legislation, regulatory-action, court-ruling-legal, announcement, data-report-study, appointment-resignation, investigation-audit, infrastructure-project. Open set.",
        "knownValues": [
          "policy-legislation",
          "regulatory-action",
          "court-ruling-legal",
          "announcement",
          "data-report-study",
          "appointment-resignation",
          "investigation-audit",
          "infrastructure-project",
          "diplomatic-relations",
          "environmental-incident",
          "other"
        ]
      },
      "locations": {
        "type": "array",
        "items": {
          "ref": "tech.transparencia.defs#location",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "Geographic references: states, municipalities, ciudades, puertos, circuitos judiciales, or the territorial scope of the act. Empty array when no specific location is recoverable."
      },
      "modelUsed": {
        "type": "string",
        "maxLength": 256,
        "description": "AI model or analyst profile identifier that produced the enrichment (e.g., 'claude-3-5-sonnet', 'gemini-2.0-flash', 'manual-analyst-v1')."
      },
      "impactLevel": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "Estimated relevance and severity for public analysis. 1 = routine procedural notice, 3 = limited administrative or regulatory act, 5 = clear sectoral or intergovernmental change, 7 = significant reform / national program / major institutional decision, 10 = constitutional change or extraordinary structural transformation."
      },
      "inputTokens": {
        "type": "integer",
        "minimum": 0,
        "description": "Tokens consumed by the LLM prompt for this enrichment."
      },
      "obligations": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 8000,
          "maxGraphemes": 2000
        },
        "maxLength": 50,
        "description": "Concrete obligations, duties, deadlines, restrictions, or compliance actions extracted from the nota as Spanish free-text statements. For more structured tasks, use complianceItems."
      },
      "legalEffects": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 256,
          "knownValues": [
            "reforma",
            "adiciona",
            "deroga",
            "abroga",
            "declara_invalidez",
            "convoca",
            "emplaza",
            "notifica",
            "da_a_conocer",
            "autoriza",
            "establece_plazo",
            "asigna_recursos",
            "coordina",
            "crea_mecanismo",
            "aprueba_metodologia",
            "publica_programa",
            "modifica_cartografia",
            "otro"
          ],
          "maxGraphemes": 64
        },
        "maxLength": 30,
        "description": "Normalized verbs or phrases describing what the act does in legal or administrative terms. Open set; only include effects substantiated by the text."
      },
      "modelVersion": {
        "type": "string",
        "maxLength": 256,
        "description": "Model version or checkpoint."
      },
      "outputTokens": {
        "type": "integer",
        "minimum": 0,
        "description": "Tokens generated by the LLM response."
      },
      "readingLevel": {
        "type": "string",
        "maxLength": 32,
        "description": "Approximate reading level of the document content, useful for UX surfacing of legalistic vs accessible texts.",
        "knownValues": [
          "basic",
          "intermediate",
          "advanced"
        ]
      },
      "contentDomain": {
        "type": "string",
        "maxLength": 64,
        "description": "Cross-domain classification aligned with the existing TransparencIA news taxonomy (IPTC Media Topics) for mixed analysis across DOF and news.",
        "knownValues": [
          "arts-culture-entertainment",
          "crime-law-justice",
          "disaster-accident",
          "economy-business-finance",
          "education",
          "environment",
          "health",
          "human-interest",
          "labour",
          "lifestyle-leisure",
          "politics",
          "religion",
          "science-technology",
          "society",
          "sport",
          "conflict-war-peace",
          "weather"
        ]
      },
      "documentClass": {
        "type": "string",
        "maxLength": 64,
        "description": "Broad publication family used for cross-type analysis while preserving the more specific tipoActo field.",
        "knownValues": [
          "normative",
          "judicial",
          "procurement",
          "intergovernmental",
          "planning",
          "administrative",
          "informational",
          "other"
        ]
      },
      "effectiveDate": {
        "type": "string",
        "format": "datetime",
        "description": "Normalized effective date/time when the act takes effect, if recoverable with confidence from the text. Distinct from tech.transparencia.document.item.effectiveAt (which is from source metadata)."
      },
      "structuredRefs": {
        "type": "array",
        "items": {
          "ref": "tech.transparencia.defs#structuredRef",
          "type": "ref"
        },
        "maxLength": 100,
        "description": "Typed references useful for graph navigation across laws, cases, programs, regulations, treaties, procurement IDs, and related objects."
      },
      "targetEntities": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 2048,
          "maxGraphemes": 512
        },
        "maxLength": 30,
        "description": "Who the act directly affects or addresses: proveedores interesados, terceros interesados, secretarías coordinadas, gobiernos estatales, instituciones de salud, concesionarios, sujetos regulados, población beneficiaria, etc. Free-form Spanish strings."
      },
      "complianceItems": {
        "type": "array",
        "items": {
          "ref": "#complianceItem",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "Structured compliance tasks derived from the publication when the nota sets actionable requirements. Empty array when the document does not contain clear actions."
      },
      "geographicScope": {
        "type": "string",
        "maxLength": 1024,
        "description": "Free-text spatial scope when finer legal phrasing matters (e.g., 'Estado de México', 'República Mexicana', 'puertos nacionales', 'Jalisco').",
        "maxGraphemes": 256
      },
      "impactReasoning": {
        "type": "string",
        "maxLength": 5000,
        "description": "Brief justification for the impactLevel score.",
        "maxGraphemes": 1000
      },
      "neutralHeadline": {
        "type": "string",
        "maxLength": 4096,
        "description": "Optional plain-language rewrite of the official title, useful when the DOF title is formulaic or excessively legalistic.",
        "maxGraphemes": 1024
      },
      "effectiveDateText": {
        "type": "string",
        "maxLength": 2048,
        "description": "Original textual expression of vigencia when a normalized date is unavailable or lossy (e.g., 'al día siguiente al de su publicación en el Diario Oficial de la Federación').",
        "maxGraphemes": 512
      },
      "relatedReferences": {
        "type": "array",
        "items": {
          "ref": "#relatedReference",
          "type": "ref"
        },
        "maxLength": 100,
        "description": "References to prior or related legal/administrative materials that the nota cites, modifies, abrogates, complements, or depends on (leyes, reglamentos, acuerdos, decretos, expedientes, acciones de inconstitucionalidad, tratados, programas, etc.)."
      },
      "organizationEntities": {
        "type": "array",
        "items": {
          "ref": "tech.transparencia.defs#organization",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "Institutions, tribunals, secretarías, organismos autónomos, empresas públicas, entes convocantes, or other organizations referenced in the publication."
      },
      "sourceAuthorityLevel": {
        "type": "string",
        "maxLength": 64,
        "description": "Normalized authority tier, mirrored from tech.transparencia.document.mxdof.note.authorityLevel for analytical convenience.",
        "knownValues": [
          "federal_executive",
          "federal_judicial",
          "federal_legislative",
          "autonomous_constitutional_body",
          "state_judicial",
          "state_executive",
          "state_legislative",
          "municipal",
          "state_owned_enterprise",
          "decentralized_body",
          "procurement_section",
          "judicial_notices_section",
          "other"
        ]
      }
    }
  },
  "description": "Sidecar record carrying the full enrichment of a single DOF nota. One nota can have multiple enrichments (different models, different analysts, different languages); all of them reference the same tech.transparencia.document.mxdof.note record via strongRef."
}
complianceItem object

A structured compliance task derived from a DOF nota: deadline, requirement, restriction, payment, appearance, reporting obligation, or similar actionable item.

Properties

amountText string Optional

Monetary or quantitative amount as expressed in the text (e.g., 'multa de hasta 10,000 UMA', '500,000 pesos').

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
beneficiary string Optional

Who benefits or is the counterparty, when applicable.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
dueDate string datetime Optional

Normalized due date when recoverable with confidence.

dueDateText string Optional

Original textual expression of the deadline when a normalized datetime is unavailable or lossy.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
kind string Optional

Category of compliance task.

maxLength: 64 bytes
Known values: deadline, requirement, restriction, payment, appearance, reporting, other
responsibleEntity string Optional

Who must perform or comply (institution, person, role, regulated party).

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
text string Required

Plain-language description of the task in Spanish (matching the enrichment language).

maxLength: 8000 bytesmaxGraphemes: 2000 graphemes
View raw schema 
{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "maxLength": 64,
      "description": "Category of compliance task.",
      "knownValues": [
        "deadline",
        "requirement",
        "restriction",
        "payment",
        "appearance",
        "reporting",
        "other"
      ]
    },
    "text": {
      "type": "string",
      "maxLength": 8000,
      "description": "Plain-language description of the task in Spanish (matching the enrichment language).",
      "maxGraphemes": 2000
    },
    "dueDate": {
      "type": "string",
      "format": "datetime",
      "description": "Normalized due date when recoverable with confidence."
    },
    "amountText": {
      "type": "string",
      "maxLength": 1024,
      "description": "Monetary or quantitative amount as expressed in the text (e.g., 'multa de hasta 10,000 UMA', '500,000 pesos').",
      "maxGraphemes": 256
    },
    "beneficiary": {
      "type": "string",
      "maxLength": 2048,
      "description": "Who benefits or is the counterparty, when applicable.",
      "maxGraphemes": 512
    },
    "dueDateText": {
      "type": "string",
      "maxLength": 2048,
      "description": "Original textual expression of the deadline when a normalized datetime is unavailable or lossy.",
      "maxGraphemes": 512
    },
    "responsibleEntity": {
      "type": "string",
      "maxLength": 2048,
      "description": "Who must perform or comply (institution, person, role, regulated party).",
      "maxGraphemes": 512
    }
  },
  "description": "A structured compliance task derived from a DOF nota: deadline, requirement, restriction, payment, appearance, reporting obligation, or similar actionable item."
}
relatedReference object

A reference to a prior or related legal/administrative material cited, modified, abrogated, complemented, or depended upon by this nota.

Properties

publicationDateText string Optional

Original date text for the referenced item as extracted from the publication.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
referenceKind string Optional

Kind of referenced material when clearly identifiable.

maxLength: 32 bytes
Known values: law, regulation, decree, agreement, judgment, case, program, notice, treaty, procurement, other
relationType string Required

How the nota relates to the referenced item. Open set; typical Spanish verbs.

maxLength: 64 bytes
Known values: cita, modifica, reforma, fundamento, antecedente, aclara, complementa, abroga, invalida, implementa, deriva_de, otro
resolvedCodNota integer Optional

Resolved DOF nota identifier if the reference can be linked to another nota in the corpus. Pipelines should leave this empty when not resolved with confidence; the LLM must never invent it.

minimum: 1
title string Required

Title or label of the referenced act, law, case, decree, agreement, regulation, or proceeding.

maxLength: 8192 bytesmaxGraphemes: 2048 graphemes
url string uri Optional

URL to the referenced item, only when explicitly present in the source text.

View raw schema 
{
  "type": "object",
  "required": [
    "title",
    "relationType"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL to the referenced item, only when explicitly present in the source text."
    },
    "title": {
      "type": "string",
      "maxLength": 8192,
      "description": "Title or label of the referenced act, law, case, decree, agreement, regulation, or proceeding.",
      "maxGraphemes": 2048
    },
    "relationType": {
      "type": "string",
      "maxLength": 64,
      "description": "How the nota relates to the referenced item. Open set; typical Spanish verbs.",
      "knownValues": [
        "cita",
        "modifica",
        "reforma",
        "fundamento",
        "antecedente",
        "aclara",
        "complementa",
        "abroga",
        "invalida",
        "implementa",
        "deriva_de",
        "otro"
      ]
    },
    "referenceKind": {
      "type": "string",
      "maxLength": 32,
      "description": "Kind of referenced material when clearly identifiable.",
      "knownValues": [
        "law",
        "regulation",
        "decree",
        "agreement",
        "judgment",
        "case",
        "program",
        "notice",
        "treaty",
        "procurement",
        "other"
      ]
    },
    "resolvedCodNota": {
      "type": "integer",
      "minimum": 1,
      "description": "Resolved DOF nota identifier if the reference can be linked to another nota in the corpus. Pipelines should leave this empty when not resolved with confidence; the LLM must never invent it."
    },
    "publicationDateText": {
      "type": "string",
      "maxLength": 2048,
      "description": "Original date text for the referenced item as extracted from the publication.",
      "maxGraphemes": 512
    }
  },
  "description": "A reference to a prior or related legal/administrative material cited, modified, abrogated, complemented, or depended upon by this nota."
}
timelineEntry object

A chronological event or milestone described by the publication. DOF variant requires startDateText because many legal dates are expressed non-numerically (e.g., 'al día siguiente al de su publicación') and may not be normalizable.

Properties

endDate string datetime Optional

End date/time for ranged events.

endDateText string Optional

Original textual expression of the end date when applicable.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
event string Required

Description of the event or milestone.

maxLength: 4096 bytesmaxGraphemes: 1024 graphemes
startDate string datetime Optional

Start date/time in ISO 8601 format when normalizable with confidence.

startDateText string Required

Original textual expression of the start date or moment as it appears in the publication.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
View raw schema 
{
  "type": "object",
  "required": [
    "event",
    "startDateText"
  ],
  "properties": {
    "event": {
      "type": "string",
      "maxLength": 4096,
      "description": "Description of the event or milestone.",
      "maxGraphemes": 1024
    },
    "endDate": {
      "type": "string",
      "format": "datetime",
      "description": "End date/time for ranged events."
    },
    "startDate": {
      "type": "string",
      "format": "datetime",
      "description": "Start date/time in ISO 8601 format when normalizable with confidence."
    },
    "endDateText": {
      "type": "string",
      "maxLength": 2048,
      "description": "Original textual expression of the end date when applicable.",
      "maxGraphemes": 512
    },
    "startDateText": {
      "type": "string",
      "maxLength": 2048,
      "description": "Original textual expression of the start date or moment as it appears in the publication.",
      "maxGraphemes": 512
    }
  },
  "description": "A chronological event or milestone described by the publication. DOF variant requires startDateText because many legal dates are expressed non-numerically (e.g., 'al día siguiente al de su publicación') and may not be normalizable."
}

Lexicon Garden

@