{
 "registration": "03-1560",
 "contract_version": 1,
 "ref_grain": [
  "registration",
  "period",
  "page"
 ],
 "ref_format": "{registration}:{YYYY-MM}:{page}",
 "coverage_vocabulary": [
  "absent",
  "withheld",
  "partial",
  "nil",
  "complete"
 ],
 "cannot": [
  {
   "field": "source_file",
   "why": "no column in t1_line or t1_acquisition names the PDF a row came from; doc_id and viewer_url are empty in all 245 acquisition rows and the 1,368 files on disk follow no naming convention",
   "unblocked_by": "a source_file column written at ingest (re-ingest of all filings)"
  },
  {
   "field": "page_image / sheet number",
   "why": "`page` is the FORM section (1A/1B/2). The schema holds no physical page or sheet number, so a citation cannot point at an image",
   "unblocked_by": "capturing the PDF page index during parsing"
  },
  {
   "field": "revision",
   "why": "nothing distinguishes a filer's amended filing from our own re-read of the original. `n_vintages` counts OUR pulls and is published under that name; a boolean called `revision` would label a re-OCR as a correction by the filer",
   "unblocked_by": "an amendment marker captured from the filing itself"
  },
  {
   "field": "a citation for the stock terms of the closure",
   "why": "the ref grain is (registration, period, page) and t1_stock carries no `page`. So the closure's two stock inputs can be shown but not cited, while its three flow inputs can \u2014 and the payload lists only the refs that exist rather than minting one for the stock table that would resolve to nothing",
   "unblocked_by": "a `page` column on t1_stock, captured at parse time"
  },
  {
   "field": "a top-counterparty share for most facilities",
   "why": "371 of the corpus's 444 facility-sides have exactly one counterparty carrying barrels, so a 'top exposure' figure would read 100% on five in six \u2014 measuring how thinly the T-1 form describes a facility, under a word that means concentration risk. The share is published for the 73 facility-sides that have something for it to be a share OF, and refused as `sole_named` with its counterparty count everywhere else",
   "unblocked_by": "nothing in the T-1 form. A facility's real counterparty mix is not a thing this filing reports; only the counterparties this filer transacted with there are"
  }
 ],
 "refs": {
  "03-1560:2025-05:1A": {
   "registration": "03-1560",
   "period": "2025-05",
   "page": "1A",
   "section": "receipts",
   "n_lines": 6,
   "line_no_range": [
    1,
    6
   ],
   "barrels": 696502.0,
   "districts": [],
   "read_by": [
    "ocr"
   ],
   "ingest_vintage": "2026-10-03 19:56:39",
   "n_vintages": 1,
   "coverage_status": "partial",
   "coverage_stated": 2110439.0,
   "coverage_detail": 696502.0,
   "coverage_delta": -1413937.0,
   "coverage_note": "page 1 states 2,110,439 BBL; the 6 line(s) read sum to 696,502; 1,413,937 BBL is missing from the detail [reader: scan-parsed: operator_no unavailable; facility column recovered for 9/9 lines]",
   "detail_vs_lines": 0.0
  },
  "03-1560:2025-05:1B": {
   "registration": "03-1560",
   "period": "2025-05",
   "page": "1B",
   "section": "deliveries",
   "n_lines": 3,
   "line_no_range": [
    1,
    3
   ],
   "barrels": 2305159.0,
   "districts": [
    "02",
    "03",
    "08"
   ],
   "read_by": [
    "ocr"
   ],
   "ingest_vintage": "2026-10-03 19:56:39",
   "n_vintages": 1,
   "coverage_status": "complete",
   "coverage_stated": 2305159.0,
   "coverage_detail": 2305159.0,
   "coverage_delta": 0.0,
   "coverage_note": "",
   "detail_vs_lines": 0.0
  },
  "03-1560:2025-06:1A": {
   "registration": "03-1560",
   "period": "2025-06",
   "page": "1A",
   "section": "receipts",
   "n_lines": 6,
   "line_no_range": [
    1,
    6
   ],
   "barrels": 630053.0,
   "districts": [],
   "read_by": [
    "ocr"
   ],
   "ingest_vintage": "2026-10-03 19:56:39",
   "n_vintages": 1,
   "coverage_status": "partial",
   "coverage_stated": 1918974.0,
   "coverage_detail": 630053.0,
   "coverage_delta": -1288921.0,
   "coverage_note": "page 1 states 1,918,974 BBL; the 6 line(s) read sum to 630,053; 1,288,921 BBL is missing from the detail [reader: scan-parsed: operator_no unavailable; facility column recovered for 9/9 lines]",
   "detail_vs_lines": 0.0
  },
  "03-1560:2025-06:1B": {
   "registration": "03-1560",
   "period": "2025-06",
   "page": "1B",
   "section": "deliveries",
   "n_lines": 3,
   "line_no_range": [
    1,
    3
   ],
   "barrels": 2198766.0,
   "districts": [
    "02",
    "03",
    "08"
   ],
   "read_by": [
    "ocr"
   ],
   "ingest_vintage": "2026-10-03 19:56:39",
   "n_vintages": 1,
   "coverage_status": "complete",
   "coverage_stated": 2198767.0,
   "coverage_detail": 2198766.0,
   "coverage_delta": -1.0,
   "coverage_note": "",
   "detail_vs_lines": 0.0
  }
 }
}
