{
  "dataset_key": "cmbs-watchlist-transitions",
  "name": "CMBS loan-level watchlist transition export",
  "description": "Schema-ready public projection for newly watchlisted and removed-from-watchlist CMBS loans. Rows remain empty until upstream exports prior and current loan-level watchlist flags with source evidence.",
  "contract_version": "watchlist-transition.v1",
  "url": "https://dealcharts.org/datasets/cmbs-watchlist-transitions.json",
  "page_url": "https://dealcharts.org/stats/cmbs-material-changes/",
  "asof": "2026-07-08",
  "generated_at": "2026-07-08T16:50:38.141Z",
  "publisher": "CMD+RVL",
  "platform": "Dealcharts",
  "source": "SEC EDGAR public filings projected by Dealcharts",
  "license": "CC-BY 4.0 unless a dataset-specific license says otherwise",
  "contact": "cairn+llms@cmdrvl.com",
  "receipt_contract": {
    "version": "projection-receipt-v2",
    "preserves": "projection-receipt-v1",
    "surface": "CMBS watchlist transition contract",
    "source": "DealCharts watchlist transition export",
    "scope": "DealCharts facts JSON fields and deal metrics resolved to the current public projection source and source-document rows available to this repo.",
    "receipt_scope": {
      "mcp_endpoint": "https://receipts.cmdrvl.com/mcp",
      "schema_uri": "https://cmdrvl.com/schemas/sf-receipt/v0/schema.json",
      "context_uri": "https://cmdrvl.com/contexts/obs-receipt/v0/context.json",
      "profile": "sf-receipt",
      "profile_version": "0.3",
      "temporal_scope": "current-only",
      "current_only": true,
      "coverage_asof": "2026-07-07",
      "registry_version": "0.1",
      "supported_grains": [
        "deal pool facts",
        "loan facts",
        "servicer roster",
        "loan status counts"
      ],
      "bond_tranche_boundary": {
        "status": "not_yet_verifiable",
        "covered_count": 0,
        "planned": true,
        "note": "Bond and tranche receipt coverage is not available in the current receipts MCP snapshot."
      }
    },
    "boundaries": [
      "Projection receipts are not Decision Evidence verdicts.",
      "Projection receipts are not ratings.",
      "Projection receipts are not risk scores.",
      "Projection receipts are not position-specific advice."
    ]
  },
  "verification": {
    "status": "non_receipt_domain",
    "subject_type": "watchlist_transition_contract",
    "reason": "Watchlist transition rows are not covered by the current receipts MCP; this contract is schema-level only.",
    "receipt_route": {
      "mcp_endpoint": "https://receipts.cmdrvl.com/mcp",
      "schema_uri": "https://cmdrvl.com/schemas/sf-receipt/v0/schema.json",
      "context_uri": "https://cmdrvl.com/contexts/obs-receipt/v0/context.json",
      "profile": "sf-receipt",
      "profile_version": "0.3"
    },
    "temporal_scope": "current-only",
    "current_only": true,
    "coverage_asof": "2026-07-07",
    "registry_version": "0.1"
  },
  "ask_cairn": {
    "self_serve_receipts": {
      "label": "Self-serve current-only receipt verification",
      "mcp_endpoint": "https://receipts.cmdrvl.com/mcp",
      "tools": [
        "find_deals",
        "verify_claims"
      ],
      "scope": "Use for covered structured-finance claims when an exact deal identity is available.",
      "temporal_scope": "current-only"
    },
    "get_your_view": {
      "label": "Position-specific read",
      "contact": "cairn+facts@cmdrvl.com",
      "instruction": "Email cairn+facts@cmdrvl.com with the CUSIP, tranche, position, or portfolio context that matters to you."
    },
    "assistant_guidance": [
      "Use CMBS watchlist transition contract as a public projection with attribution.",
      "For covered structured-finance claims, route verification through the CMD+RVL receipts MCP.",
      "For position-specific reads, route to Cairn instead of drawing a DealCharts conclusion."
    ]
  },
  "receipt_boundary": {
    "contract_level_only": true,
    "row_level_receipt_coverage": false,
    "note": "Receipt route metadata is contract-level and does not imply any watchlist row has receipt coverage."
  },
  "allowed_transition_values": [
    "newly_watchlisted",
    "removed_from_watchlist"
  ],
  "columns": [
    {
      "name": "deal_key",
      "type": "string",
      "required": true,
      "description": "Dealcharts canonical CMBS deal key."
    },
    {
      "name": "deal_name",
      "type": "string",
      "required": true,
      "description": "Short public deal name shown on Dealcharts."
    },
    {
      "name": "loan_id",
      "type": "string",
      "required": true,
      "description": "Stable loan identifier from the compared servicer-report rows."
    },
    {
      "name": "loan_name",
      "type": "string",
      "required": false,
      "description": "Loan/property name when disclosed in the public source row."
    },
    {
      "name": "transition",
      "type": "enum",
      "required": true,
      "description": "One of newly_watchlisted or removed_from_watchlist."
    },
    {
      "name": "prior_watchlist_status",
      "type": "boolean",
      "required": true,
      "description": "Watchlist status in the earlier compared filing period."
    },
    {
      "name": "current_watchlist_status",
      "type": "boolean",
      "required": true,
      "description": "Watchlist status in the later compared filing period."
    },
    {
      "name": "prior_asof",
      "type": "date",
      "required": true,
      "description": "Earlier filing-period or source-row as-of date."
    },
    {
      "name": "current_asof",
      "type": "date",
      "required": true,
      "description": "Later filing-period or source-row as-of date."
    },
    {
      "name": "source_document_url",
      "type": "url",
      "required": true,
      "description": "SEC filing or source document supporting the current status."
    },
    {
      "name": "prior_source_document_url",
      "type": "url",
      "required": false,
      "description": "SEC filing or source document supporting the prior status when distinct."
    },
    {
      "name": "evidence_path",
      "type": "string",
      "required": false,
      "description": "Machine-readable extraction path or row pointer for audit follow-up."
    }
  ],
  "coverage": {
    "status": "schema_ready_no_rows",
    "row_count": 0,
    "transition_row_count": 0,
    "explanation": "The current public Dealcharts bundle exposes rvl numeric loan-row changes and special-servicing transfer context, but not prior/current loan-level watchlist status flags. No watchlist transition rows are inferred from adjacent signals.",
    "compared_deal_count": 0,
    "material_numeric_change_deal_count": 0,
    "available_adjacent_signals": [
      {
        "key": "rvl_numeric_change_rows",
        "row_count": 0,
        "note": "Useful for surveillance triage, but not a watchlist flag."
      },
      {
        "key": "special_servicing_transfer_rows",
        "row_count": 0,
        "note": "Useful context for workout review, but not a watchlist transition."
      }
    ],
    "missing_required_fields": [
      "deal_key",
      "deal_name",
      "loan_id",
      "transition",
      "prior_watchlist_status",
      "current_watchlist_status",
      "prior_asof",
      "current_asof",
      "source_document_url"
    ]
  },
  "rows": []
}