// 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.' } ]);