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