Data room / The current model

Model parameters

Code, 1,330 words

model/config.js Open the file as written

// Equity Flow: every parameter the model uses, in one place.
//
// Rules (EQUITY_FLOW_FIXES.md, section 0.5): a parameter lives here, is named,
// and carries the source or verification note beside it. Nothing downstream
// hardcodes a number that appears in this file. VERIFY_LIST at the bottom
// records the status of each default that needed an outside source;
// docs/OPEN_ITEMS.md is rendered from it.
//
// This file is plain ESM with no imports so the browser and Node load it alike.

// HUD HECM principal limit factors at borrower age 62, by expected rate.
// Source: HUD "FY 2018 PLF Tables" (effective for case numbers assigned on or
// after October 2, 2017, Mortgagee Letter 2017-12), sheet "General Table - 62
// to 99", age-62 row, read from the published XLS on 2026-10-15. HUD still
// lists this as the current table. Rates between the listed points are
// interpolated linearly; HUD's table steps by 1/8 percent.
export const HECM_PLF_62_TABLE = Object.freeze([
  [0.05000, 0.410],
  [0.05500, 0.382],
  [0.06000, 0.357],
  [0.06125, 0.351],
  [0.06500, 0.334],
  [0.07000, 0.312],
  [0.07250, 0.301],
  [0.07500, 0.291]
]);

export function hecmPlf62(expectedRate, table = HECM_PLF_62_TABLE) {
  if (expectedRate <= table[0][0]) return table[0][1];
  for (let i = 1; i < table.length; i++) {
    const [r0, p0] = table[i - 1];
    const [r1, p1] = table[i];
    if (expectedRate <= r1) return p0 + (p1 - p0) * (expectedRate - r0) / (r1 - r0);
  }
  return table[table.length - 1][1];
}

const HECM_EXPECTED_RATE = 0.065;

export const CONFIG = Object.freeze({
  // ---------------------------------------------------------------------------
  // Build date. Ages and lien seasoning in the rendered stories and tables are
  // measured from this date so the build is deterministic. The live calculator
  // passes the visitor's real date instead.
  as_of: Object.freeze({ year: 2026, month: 10 }),

  // ---------------------------------------------------------------------------
  // Pricing
  coupon_illustrative: 0.1025,   // existing modeling assumption, not a quote
  origination_fee_pct: 0.02,     // existing
  origination_fee_floor: 2500,   // Cost basis (section 2.2): HECM-style
                                 // counseling $125 to $200 (HUD ML 2011-09;
                                 // Mutual of Omaha 2025 fee schedule $99 to
                                 // $215), appraisal $500 to $1,275 (same
                                 // schedule, $595 default), lender's title
                                 // policy and search $800 to $1,200, recording
                                 // $100 to $250, trust account setup and
                                 // servicing onboarding $400 to $600 (internal
                                 // estimate). Vendor quotes pending.
  min_total_commitment: 50000,   // section 2.1; below this a home equity loan
                                 // fits better because the fee floor dominates
  costs_of_sale: 0.07,           // existing (commission plus closing)

  // ---------------------------------------------------------------------------
  // Underwriting box
  max_start_cltv: 0.60,                 // existing: senior / value at close
  max_proj_cltv_at_draw_end: 0.75,      // existing: (senior + EF) / value at
                                        // draw end, flat prices, incl. fees
  min_cushion_pts_at_draw_end: 0.25,    // existing: cushion is measured net of
                                        // costs of sale, the same way the
                                        // investor table reports it:
                                        // (value * (1 - costs_of_sale)
                                        //  - senior - EF) / value
  min_schedule_months: 12,              // product decision: shortest schedule
  max_schedule_months: 120,             // existing calculator ceiling

  // ---------------------------------------------------------------------------
  // Age fence and the HECM takeout at 62 (section 1)
  min_age_at_close: 45,          // product decision
  max_age_at_close: 61,          // HECM eligibility begins at 62
  launch_age_min: 55,            // go-to-market decision: launch cohort 55 to 61
  hecm_age: 62,                  // 12 USC 1715z-20(b)(1)
  hecm_expected_rate: HECM_EXPECTED_RATE,
                                 // Spec default (section 1.6). HUD defines the
                                 // expected rate as the weekly-average 10-year
                                 // CMT plus the lender's margin (ML 2021-08).
                                 // On 2026-10-09 the weekly 10-year CMT was
                                 // 5.26% (FRED WGS10YR) and quoted margins run
                                 // 1.75% to 2.00%, so today's expected rate is
                                 // 7.0% to 7.3%. 6.5% is a forward assumption
                                 // for a refinance years from now; the
                                 // sensitivity is in CHANGELOG_FIXES.md.
  hecm_plf_62_table: HECM_PLF_62_TABLE,
  hecm_plf_62: hecmPlf62(HECM_EXPECTED_RATE),
                                 // 0.334 at 6.5%, from the HUD table above.
                                 // The spec's 0.36 default corresponds to a
                                 // 6.0% expected rate (0.357).
  fha_hecm_limit: 1249125,       // FHA HECM maximum claim amount, CY2026:
                                 // HUD Mortgagee Letter 2025-22 (Dec 11, 2025).
                                 // CY2025 was $1,209,750 (ML 2024-22).
  hecm_closing_cost_pct: 0.04,   // Upfront MIP 2% of max claim (ML 2017-12,
                                 // 24 CFR 206.105) plus origination fee (24 CFR
                                 // 206.31: greater of $2,500 or 2% of the first
                                 // $200K plus 1% above, capped at $6,000) plus
                                 // appraisal, title, recording. Checked against
                                 // the Mutual of Omaha 2025 fee schedule: 4%
                                 // all-in is fair for $400K to $600K homes,
                                 // slightly low under $350K, high above $700K.

  // ---------------------------------------------------------------------------
  // Funding structure (section 3)
  prefund_months: 12,            // product decision: rolling 12-month prefund
  standby_commitment_fee: 0.0075,// Bank quote pending. Bracketed by published
                                 // data: undrawn commitment fees on U.S.
                                 // syndicated revolvers average 37 bps (Berg,
                                 // Saunders, Steffen, J. Finance 2016);
                                 // financial standby letters of credit run
                                 // 100 to 200 bps per year.
  trust_yield: 0.0426,           // 3-month Treasury bill, 4.26% on 2026-10-13
                                 // (FRED DGS3MO, bond-equivalent basis)

  // ---------------------------------------------------------------------------
  // Market scenarios
  hpi_base: 0.03,                // base case everywhere (section 6.5)
  hpi_historical: 0.04,          // FHFA / Case-Shiller long-run nominal average;
                                 // labeled "historical U.S. average" in the
                                 // scenario columns only
  hpi_scenarios: Object.freeze([
    Object.freeze({ key: 'declining', label: 'Declining −2%/yr', hpi: -0.02 }),
    Object.freeze({ key: 'flat', label: 'Flat 0%', hpi: 0.0 }),
    Object.freeze({ key: 'base', label: 'Base case +3%/yr', hpi: 0.03 }),
    Object.freeze({ key: 'historical', label: 'Historical U.S. avg +4%/yr', hpi: 0.04 }),
    Object.freeze({ key: 'hot', label: 'Hot +6%/yr', hpi: 0.06 })
  ]),

  // ---------------------------------------------------------------------------
  // Alternatives shown in the monthly impact comparison
  heloc_rate: 0.085,             // existing illustrative variable rate
  he_loan_rate: 0.085,           // existing illustrative fixed rate, 15-year
  he_loan_term_years: 15,
  market_rate_30y: 0.074,        // Freddie Mac PMMS 30-year fixed, 7.40% for
                                 // the week of 2026-10-15. Used for the
                                 // cash-out refi "rate-lock toll" and for the
                                 // cohort funnel's rate screen.
  homesafe_second: Object.freeze({
    name: 'HomeSafe Second',
    lender: 'Finance of America',
    min_age: 55,
    rate: 0.0949,                // VERIFY: FoA cut the fixed rate from 9.99% to
                                 // 9.49% in 2024; confirm the current rate
    citation_key: 'homesafe-second'
  }),

  // ---------------------------------------------------------------------------
  // Investor table exits (years) in addition to the hecm_refi_at_62 row
  investor_exit_years: Object.freeze([7, 10, 12, 15, 20])
});

// Every default that needed an outside source, with where it stands.
// docs/OPEN_ITEMS.md is rendered from this list so the two never drift.
export const VERIFY_LIST = Object.freeze([
  { key: 'origination_fee_floor', value: CONFIG.origination_fee_floor, source: 'Counseling, appraisal, title, recording, trust setup, servicing onboarding (section 2.2).', status: 'Cost basis documented against HUD ML 2011-09 and the Mutual of Omaha 2025 HECM fee schedule; vendor quotes pending.' },
  { key: 'hecm_plf_62', value: CONFIG.hecm_plf_62, source: 'HUD principal limit factor table at age 62 and the assumed expected rate.', status: 'Verified: lookup from the HUD FY2018 PLF table (age-62 row). 0.334 at the 6.5% expected rate; the spec default of 0.36 matched a 6.0% rate.' },
  { key: 'hecm_expected_rate', value: CONFIG.hecm_expected_rate, source: '10-year CMT plus lender margin (HUD ML 2021-08).', status: 'Open: today’s market is 7.0% to 7.3% (weekly 10-year CMT 5.26% on 2026-10-09 plus 1.75% to 2.00% margins). 6.5% is kept as the forward assumption; sensitivity recorded in CHANGELOG_FIXES.md.' },
  { key: 'fha_hecm_limit', value: CONFIG.fha_hecm_limit, source: 'HUD Mortgagee Letter setting the HECM maximum claim amount for the current calendar year.', status: 'Verified: $1,249,125 for CY2026 (ML 2025-22, Dec 11, 2025).' },
  { key: 'hecm_closing_cost_pct', value: CONFIG.hecm_closing_cost_pct, source: 'Upfront MIP (2% of max claim) plus HUD origination cap plus title and recording.', status: 'Verified as a fair all-in allowance for $400K to $600K homes (24 CFR 206.31, ML 2017-12, Mutual of Omaha 2025 fee schedule); slightly low under $350K, high above $700K.' },
  { key: 'standby_commitment_fee', value: CONFIG.standby_commitment_fee, source: 'Bank quote for a committed standby facility or letter of credit on the undrawn schedule.', status: 'Open: bracketed by published revolver commitment fees (mean 37 bps) and financial SBLC fees (100 to 200 bps). Bank quote pending.' },
  { key: 'trust_yield', value: CONFIG.trust_yield, source: 'Current 3-month Treasury bill yield.', status: 'Verified: 4.26% on 2026-10-13 (FRED DGS3MO).' },
  { key: 'market_rate_30y', value: CONFIG.market_rate_30y, source: 'Freddie Mac PMMS 30-year fixed, latest week.', status: 'Verified: 7.40% for the week of 2026-10-15.' },
  { key: 'homesafe_second.rate', value: CONFIG.homesafe_second.rate, source: 'Finance of America HomeSafe Second published fixed rate.', status: 'Open: see data/sources.js for the citation status.' }
]);