{
  "tool_id": "art-547-corporate-action-entitlement-recompute",
  "note": "DTC corporate-action entitlement recompute per DTCC Important Notice 23890-26 field set. Vector 1: cash-dividend (DVCA) valid entitlement. Vector 2: rights distribution (RHDI) with fractional-share residue flagged. Vector 3: empty-input finite (all four base-field checks fire).",
  "vectors": [
    {
      "name": "cash_dividend_valid",
      "description": "DVCA cash dividend at $0.42/share on a 1200-share position -- CASH entitlement mode, no fractional-share concept.",
      "policy_parameters": {
        "corporate_action_type": "DVCA",
        "position_qty": 1200,
        "ratio_or_rate": 0.42,
        "record_date": "2027-01-15",
        "reference_id": "CA-OPAQUE-2027-0001"
      },
      "output_payload": {
        "entitlement_computed": true,
        "corporate_action_type": "DVCA",
        "entitlement_mode": "CASH",
        "cash_entitlement": 504,
        "whole_shares": null,
        "fractional_shares": null,
        "fractional_shares_present": false,
        "error_count": 0,
        "violations": [],
        "reference_id": "CA-OPAQUE-2027-0001",
        "dtcc_operator_mandate_basis": "DTCC Important Notice 23890-26 -- legacy corporate-actions message format decommission (DTCC operator mandate: PSE testing 2026-01, Test Facility 2026-03, PROD testing 2026-07, legacy decommission Q3 2027). This is a market-infrastructure migration deadline set by DTCC as CSD operator, NOT a regulatory or statutory deadline.",
        "disambiguation": "recompute_corporate_action_entitlement computes deterministic dividend/rights/split entitlement (entitlement = position_qty x ratio_or_rate, with per-type rounding/proration) for a single position at a record date. It does NOT validate DTC ISO 20022 message shape -- for structural message-shape validation use the DTC CA ISO 20022 message validator (art-546), which chains into this node's input. Fractional-share residue is FLAGGED, never priced -- this kernel fetches no market data and performs no security-master lookup.",
        "pii_note": "ZERO PII: position quantity, rate/ratio, corporate-action type, and record date only. No beneficial-owner name, account, or personal identifier enters this kernel -- use synthetic reference IDs.",
        "not_legal_advice": "Not legal, tax, or accounting advice. Entitlement recompute output requires review by qualified operations staff before use in production DTC CA processing.",
        "table_version": "DTC-CA-ISO20022-FIELDSET-23890-26-V1",
        "table_source": "DTCC Important Notice 23890-26 (legacy corporate-actions message format decommission -- DTCC operator mandate); ISO 20022 seev.031/seev.033/seev.035 corporate-action message family field set"
      },
      "golden_hash": "f8c735bc3b0e08cd6552f87402390b9f6dfe25a9feae6ed2d3309087b4b555e5"
    },
    {
      "name": "rights_distribution_fractional",
      "description": "RHDI rights distribution at a 0.25 ratio on a 999-share position -- SHARES entitlement mode, 249 whole shares plus a 0.75-share fractional residue flagged (never priced).",
      "policy_parameters": {
        "corporate_action_type": "RHDI",
        "position_qty": 999,
        "ratio_or_rate": 0.25,
        "record_date": "2027-03-10",
        "reference_id": "CA-OPAQUE-2027-0002"
      },
      "output_payload": {
        "entitlement_computed": true,
        "corporate_action_type": "RHDI",
        "entitlement_mode": "SHARES",
        "cash_entitlement": null,
        "whole_shares": 249,
        "fractional_shares": 0.75,
        "fractional_shares_present": true,
        "error_count": 0,
        "violations": [],
        "reference_id": "CA-OPAQUE-2027-0002",
        "dtcc_operator_mandate_basis": "DTCC Important Notice 23890-26 -- legacy corporate-actions message format decommission (DTCC operator mandate: PSE testing 2026-01, Test Facility 2026-03, PROD testing 2026-07, legacy decommission Q3 2027). This is a market-infrastructure migration deadline set by DTCC as CSD operator, NOT a regulatory or statutory deadline.",
        "disambiguation": "recompute_corporate_action_entitlement computes deterministic dividend/rights/split entitlement (entitlement = position_qty x ratio_or_rate, with per-type rounding/proration) for a single position at a record date. It does NOT validate DTC ISO 20022 message shape -- for structural message-shape validation use the DTC CA ISO 20022 message validator (art-546), which chains into this node's input. Fractional-share residue is FLAGGED, never priced -- this kernel fetches no market data and performs no security-master lookup.",
        "pii_note": "ZERO PII: position quantity, rate/ratio, corporate-action type, and record date only. No beneficial-owner name, account, or personal identifier enters this kernel -- use synthetic reference IDs.",
        "not_legal_advice": "Not legal, tax, or accounting advice. Entitlement recompute output requires review by qualified operations staff before use in production DTC CA processing.",
        "table_version": "DTC-CA-ISO20022-FIELDSET-23890-26-V1",
        "table_source": "DTCC Important Notice 23890-26 (legacy corporate-actions message format decommission -- DTCC operator mandate); ISO 20022 seev.031/seev.033/seev.035 corporate-action message family field set"
      },
      "golden_hash": "a57c4f5956d2ccb0f93f95a1c79508315a5bd6b1e74e5f8da2b1851d6d692557"
    },
    {
      "name": "empty_input_finite",
      "description": "Empty input -- verifies finite output (no NaN/Infinity) and that all four base-field checks fire (corporate_action_type, position_qty, ratio_or_rate, record_date).",
      "policy_parameters": {},
      "output_payload": {
        "entitlement_computed": false,
        "corporate_action_type": "UNKNOWN",
        "entitlement_mode": null,
        "cash_entitlement": null,
        "whole_shares": null,
        "fractional_shares": null,
        "fractional_shares_present": false,
        "error_count": 4,
        "violations": [
          {
            "code": "INVALID_CORPORATE_ACTION_TYPE",
            "severity": "ERROR",
            "field": "corporate_action_type",
            "message": "corporate_action_type \"(empty)\" is not one of DVCA, DVSE, RHDI, SPLF, SPLR (DTC-CA-ISO20022-FIELDSET-23890-26-V1)."
          },
          {
            "code": "MISSING_POSITION_QTY",
            "severity": "ERROR",
            "field": "position_qty",
            "message": "position_qty is required and must be a finite number."
          },
          {
            "code": "MISSING_RATIO_OR_RATE",
            "severity": "ERROR",
            "field": "ratio_or_rate",
            "message": "ratio_or_rate is required and must be a finite number."
          },
          {
            "code": "MISSING_RECORD_DATE",
            "severity": "ERROR",
            "field": "record_date",
            "message": "record_date is required to date the entitlement computation."
          }
        ],
        "reference_id": null,
        "dtcc_operator_mandate_basis": "DTCC Important Notice 23890-26 -- legacy corporate-actions message format decommission (DTCC operator mandate: PSE testing 2026-01, Test Facility 2026-03, PROD testing 2026-07, legacy decommission Q3 2027). This is a market-infrastructure migration deadline set by DTCC as CSD operator, NOT a regulatory or statutory deadline.",
        "disambiguation": "recompute_corporate_action_entitlement computes deterministic dividend/rights/split entitlement (entitlement = position_qty x ratio_or_rate, with per-type rounding/proration) for a single position at a record date. It does NOT validate DTC ISO 20022 message shape -- for structural message-shape validation use the DTC CA ISO 20022 message validator (art-546), which chains into this node's input. Fractional-share residue is FLAGGED, never priced -- this kernel fetches no market data and performs no security-master lookup.",
        "pii_note": "ZERO PII: position quantity, rate/ratio, corporate-action type, and record date only. No beneficial-owner name, account, or personal identifier enters this kernel -- use synthetic reference IDs.",
        "not_legal_advice": "Not legal, tax, or accounting advice. Entitlement recompute output requires review by qualified operations staff before use in production DTC CA processing.",
        "table_version": "DTC-CA-ISO20022-FIELDSET-23890-26-V1",
        "table_source": "DTCC Important Notice 23890-26 (legacy corporate-actions message format decommission -- DTCC operator mandate); ISO 20022 seev.031/seev.033/seev.035 corporate-action message family field set"
      },
      "golden_hash": "d1f00f02c97d0bef6e77a9c9040ff39e9652ac10d8d3d836a56752a1421115c4"
    }
  ]
}