{
  "schema": "causal-showcase-manifest/1",
  "slug": "liquidity-stress",
  "version": "1.0",
  "title": "Portfolio Liquidity and Market Stress Response",
  "question": "Which hedging, liquidity-buffer and liquidation policy protects obligations under correlated market and redemption stress?",
  "lastValidated": "2026-11-18",
  "evidence": "Reviewed",
  "scenario": {
    "params": [
      {
        "key": "buffer",
        "label": "Liquidity buffer",
        "min": 0,
        "max": 20,
        "step": 2,
        "default": 4,
        "unit": "% NAV"
      },
      {
        "key": "hedge",
        "label": "Equity hedge ratio",
        "min": 0,
        "max": 100,
        "step": 10,
        "default": 0,
        "unit": "%"
      },
      {
        "key": "horizon",
        "label": "Liquidation horizon",
        "min": 1,
        "max": 15,
        "step": 1,
        "default": 2,
        "unit": "days"
      }
    ],
    "alternatives": [
      {
        "name": "Baseline",
        "description": "Current buffer, no hedge, fast liquidation.",
        "params": {
          "buffer": 4,
          "hedge": 0,
          "horizon": 2
        }
      },
      {
        "name": "Fire-sale response",
        "description": "Liquidate everything needed in one day.",
        "params": {
          "buffer": 4,
          "hedge": 0,
          "horizon": 1
        }
      },
      {
        "name": "Hedge",
        "description": "Hedge 80% of equity factor exposure.",
        "params": {
          "buffer": 4,
          "hedge": 80,
          "horizon": 2
        }
      },
      {
        "name": "Liquidity buffer",
        "description": "Raise the buffer to 14% of NAV.",
        "params": {
          "buffer": 14,
          "hedge": 0,
          "horizon": 2
        }
      },
      {
        "name": "Staged liquidation",
        "description": "Spread sales over 10 days.",
        "params": {
          "buffer": 4,
          "hedge": 0,
          "horizon": 10
        }
      },
      {
        "name": "Combined policy",
        "description": "Recommended: moderate buffer, partial hedge, staged sales.",
        "params": {
          "buffer": 12,
          "hedge": 40,
          "horizon": 7
        }
      }
    ],
    "metrics": [
      {
        "key": "coverage",
        "label": "Worst-decile obligation coverage",
        "unit": "%",
        "base": 82,
        "sd": 4,
        "higherIsBetter": true,
        "sensitivity": {
          "buffer": 1.6,
          "hedge": 0.06,
          "horizon": 1.2
        },
        "curvature": {
          "horizon": -0.04
        },
        "constraint": {
          "min": 100,
          "label": "Must reach 100%"
        }
      },
      {
        "key": "drag",
        "label": "Return drag",
        "unit": "bp/yr",
        "base": 10,
        "sd": 2,
        "higherIsBetter": false,
        "sensitivity": {
          "buffer": 6,
          "hedge": 0.9,
          "horizon": 0
        }
      },
      {
        "key": "tail",
        "label": "Tail loss (ES 97.5%)",
        "unit": "% NAV",
        "base": 14,
        "sd": 1.2,
        "higherIsBetter": false,
        "sensitivity": {
          "buffer": -0.1,
          "hedge": -0.07,
          "horizon": -0.25
        },
        "curvature": {
          "horizon": 0.015
        }
      },
      {
        "key": "tcost",
        "label": "Transaction cost",
        "unit": "bp",
        "base": 48,
        "sd": 5,
        "higherIsBetter": false,
        "sensitivity": {
          "buffer": -1.2,
          "hedge": 0.15,
          "horizon": -3.2
        },
        "curvature": {
          "horizon": 0.14
        }
      }
    ],
    "objective": "Cover 100% of obligations in the worst-decile stress cases at the lowest return drag.",
    "runs": 10000
  },
  "technical": {
    "dag": [
      [
        "Price shock",
        "NAV"
      ],
      [
        "NAV",
        "Redemptions"
      ],
      [
        "Past performance",
        "Buffer size"
      ],
      [
        "Past performance",
        "Redemptions"
      ],
      [
        "Buffer size",
        "Redemptions"
      ],
      [
        "Redemptions",
        "Asset sales"
      ],
      [
        "Asset sales",
        "Price impact"
      ],
      [
        "Price impact",
        "NAV"
      ],
      [
        "Hedge",
        "NAV"
      ]
    ],
    "estimand": "Effect of a 5-point larger buffer on worst-decile obligation coverage, under the simulated policy intervention",
    "assumptions": [
      "Educational synthetic portfolio",
      "Policy effects are scenario-specific",
      "Market-impact function valid within the tested depth range",
      "No investment recommendation"
    ],
    "equations": [
      "Gap(t) = Obligations(t) − Cash(t) − Σ_i liquid_i(t) · (1 − haircut_i)",
      "ΔP_i = −λ_i · Sales_i / Depth_i",
      "Redemptions(t) = r₀ + r₁ · max(0, −Return(t−1))"
    ],
    "engines": {
      "Causal": "causal-core 3.4.1",
      "ABM": "agentflow 1.9.3",
      "System dynamics": "stockflow 3.0.4",
      "Network": "graph-prop 1.7.2",
      "Monte Carlo": "mc-sampler 4.0.0",
      "Optimization": "policy-opt 2.2.5"
    },
    "seed": 20261117,
    "validation": [
      {
        "name": "Redemption calibration error",
        "value": "7.2%"
      },
      {
        "name": "Worst-decile coverage stability",
        "value": "±0.6 pts"
      },
      {
        "name": "Impact-function range",
        "value": "tested 0.2× to 3× depth"
      }
    ]
  },
  "provenance": {
    "authors": [
      "Platform Education Team"
    ],
    "reviewers": [
      "Model Risk Validation",
      "Treasury Risk Review"
    ],
    "rights": "CC BY 4.0. Synthetic data generated by the platform.",
    "sourceData": "Synthetic positions, factors, cash flows, redemption agents, market depth, transaction costs, counterparty links and policy actions (seed 20261117).",
    "changelog": [
      {
        "version": "1.0",
        "date": "2026-11-18",
        "note": "Initial publication from the extended catalog specification (packages 8 to 20)."
      }
    ]
  },
  "exportedAt": "2026-11-18T23:20:20.281Z"
}