@calculator53295/backtest-engine 0.1.0

package/dist/retirement/engine.js

@@ -0,0 +1,297 @@
+import { withdrawFromBuckets } from './bucketRules.js';
+import { strategyDecide, getSourcing } from './strategies/index.js';
+function findStartIndex(data, date) {
+    const i = data.findIndex(r => r.date === date);
+    if (i < 0)
+        throw new Error(`Start date ${date} not in data`);
+    return i;
+}
+export function aggregateToAnnual(data) {
+    const byYear = new Map();
+    for (const r of data) {
+        const y = r.date.slice(0, 4);
+        if (!byYear.has(y))
+            byYear.set(y, []);
+        byYear.get(y).push(r);
+    }
+    const out = [];
+    for (const [year, rows] of byYear) {
+        if (rows.length < 12)
+            continue;
+        let sp = 1, bd = 1, ca = 1;
+        for (const r of rows) {
+            sp *= 1 + r.spReturn;
+            bd *= 1 + r.bondReturn;
+            ca *= 1 + r.cashReturn;
+        }
+        out.push({
+            date: `${year}-12`,
+            spReturn: sp - 1, bondReturn: bd - 1, cashReturn: ca - 1,
+            cpi: rows[rows.length - 1].cpi,
+            cape: rows[rows.length - 1].cape,
+        });
+    }
+    return out;
+}
+function applyFees(b, fees, periodsPerYear) {
+    if (!fees)
+        return { balances: b, paid: 0 };
+    const fS = b.stocks * (fees.stocks / periodsPerYear);
+    const fB = b.bonds * (fees.bonds / periodsPerYear);
+    const fC = b.cash * (fees.cash / periodsPerYear);
+    return {
+        balances: { stocks: b.stocks - fS, bonds: b.bonds - fB, cash: b.cash - fC },
+        paid: fS + fB + fC,
+    };
+}
+function streamAmountThisPeriod(stream, yearsElapsed, periodsPerYear, startCpi, currentCpi) {
+    if (!stream.enabled)
+        return 0;
+    if (yearsElapsed < stream.startYear)
+        return 0;
+    if (stream.duration !== 'forever' && yearsElapsed >= stream.startYear + stream.duration)
+        return 0;
+    let amount = stream.annualAmount;
+    if (stream.inflationAdjusted) {
+        const factor = stream.inflationStartsImmediately
+            ? currentCpi / startCpi
+            : currentCpi / startCpi;
+        // (Both branches do the same thing in practice; the "starts only after" semantics is captured by startYear.)
+        amount *= factor;
+    }
+    return amount / periodsPerYear;
+}
+function interpolateAllocation(start, end, t, shape) {
+    const u = shape === 'linear' ? t : shape === 'quadratic-in' ? t * t : 1 - (1 - t) * (1 - t);
+    return {
+        stocks: start.stocks + (end.stocks - start.stocks) * u,
+        bonds: start.bonds + (end.bonds - start.bonds) * u,
+        cash: start.cash + (end.cash - start.cash) * u,
+    };
+}
+function rebalanceIfNeeded(balancesEnd, target, config, i, totalPeriods) {
+    const policy = config.rebalance;
+    const periodsPerYear = config.stepFreq === 'monthly' ? 12 : 1;
+    const everyN = config.rebalanceConfig?.everyN ?? 1;
+    const bandPct = config.rebalanceConfig?.bandPct ?? 0.05;
+    const total = balancesEnd.stocks + balancesEnd.bonds + balancesEnd.cash;
+    if (total <= 0 || policy === 'none')
+        return balancesEnd;
+    let shouldRebalance = false;
+    if (policy === 'on-withdrawal')
+        shouldRebalance = true;
+    else if (policy === 'yearly') {
+        shouldRebalance =
+            (config.stepFreq === 'monthly' && (i + 1) % 12 === 0) ||
+                (config.stepFreq === 'annual');
+    }
+    else if (policy === 'every-n-years') {
+        const periodsBetween = everyN * periodsPerYear;
+        shouldRebalance = (i + 1) % periodsBetween === 0;
+    }
+    else if (policy === 'threshold') {
+        const drift = Math.max(Math.abs(balancesEnd.stocks / total - target.stocks), Math.abs(balancesEnd.bonds / total - target.bonds), Math.abs(balancesEnd.cash / total - target.cash));
+        shouldRebalance = drift >= bandPct;
+    }
+    // Always rebalance on the very last period? No — leave terminal state alone for accurate reporting.
+    void totalPeriods;
+    if (!shouldRebalance)
+        return balancesEnd;
+    return {
+        stocks: total * target.stocks,
+        bonds: total * target.bonds,
+        cash: total * target.cash,
+    };
+}
+function computeTrialSummary(periods, initialBalance) {
+    if (periods.length === 0) {
+        return {
+            maxDrawdownReal: 0,
+            maxDrawdownPeriod: 0,
+            timeUnderwaterFraction: 0,
+            worstYearReturn: 0,
+            totalRealWithdrawn: 0,
+            withdrawalCV: 0,
+        };
+    }
+    let runningPeak = initialBalance;
+    let maxDD = 0;
+    let maxDDPeriod = 0;
+    let underwaterCount = 0;
+    let worstReturn = 0;
+    let totalRealWithdrawn = 0;
+    const realWithdrawals = [];
+    const startCpi = periods[0].cpi;
+    for (const p of periods) {
+        if (p.totalReal > runningPeak)
+            runningPeak = p.totalReal;
+        const dd = runningPeak > 0 ? (runningPeak - p.totalReal) / runningPeak : 0;
+        if (dd > maxDD) {
+            maxDD = dd;
+            maxDDPeriod = p.index;
+        }
+        if (p.totalReal < initialBalance)
+            underwaterCount++;
+        const blended = p.returns.stocks * 0.6 + p.returns.bonds * 0.4;
+        if (blended < worstReturn)
+            worstReturn = blended;
+        const wNominal = p.withdrawal.stocks + p.withdrawal.bonds + p.withdrawal.cash;
+        const wReal = wNominal * (startCpi / p.cpi);
+        totalRealWithdrawn += wReal;
+        if (wReal > 0)
+            realWithdrawals.push(wReal);
+    }
+    let cv = 0;
+    if (realWithdrawals.length > 1) {
+        const mean = realWithdrawals.reduce((s, x) => s + x, 0) / realWithdrawals.length;
+        if (mean > 0) {
+            const variance = realWithdrawals.reduce((s, x) => s + (x - mean) ** 2, 0) / realWithdrawals.length;
+            cv = Math.sqrt(variance) / mean;
+        }
+    }
+    return {
+        maxDrawdownReal: maxDD,
+        maxDrawdownPeriod: maxDDPeriod,
+        timeUnderwaterFraction: underwaterCount / periods.length,
+        worstYearReturn: worstReturn,
+        totalRealWithdrawn,
+        withdrawalCV: cv,
+    };
+}
+export function simulate(config, monthly) {
+    const data = config.stepFreq === 'monthly' ? monthly : aggregateToAnnual(monthly);
+    const periodsPerYear = config.stepFreq === 'monthly' ? 12 : 1;
+    const totalPeriods = config.horizonYears * periodsPerYear;
+    const startIdx = findStartIndex(data, normaliseStartDate(config.startDate, config.stepFreq));
+    if (startIdx + totalPeriods > data.length) {
+        throw new Error('Not enough data for horizon from this start date');
+    }
+    const startCpi = data[startIdx].cpi;
+    const initialAllocation = config.initialAllocation;
+    let balances = {
+        stocks: config.initialBalance * initialAllocation.stocks,
+        bonds: config.initialBalance * initialAllocation.bonds,
+        cash: config.initialBalance * initialAllocation.cash,
+    };
+    const periods = [];
+    let ranOutAtPeriod = null;
+    let prevState;
+    let lastRealAnnualWithdrawal;
+    for (let i = 0; i < totalPeriods; i++) {
+        const row = data[startIdx + i];
+        const returnsTyped = { stocks: row.spReturn, bonds: row.bondReturn, cash: row.cashReturn };
+        // Apply returns
+        let balancesAfterReturns = {
+            stocks: balances.stocks * (1 + returnsTyped.stocks),
+            bonds: balances.bonds * (1 + returnsTyped.bonds),
+            cash: balances.cash * (1 + returnsTyped.cash),
+        };
+        // Apply fees
+        const feesResult = applyFees(balancesAfterReturns, config.fees, periodsPerYear);
+        balancesAfterReturns = feesResult.balances;
+        const feesPaid = feesResult.paid;
+        const balancesStart = balancesAfterReturns;
+        const yearsElapsed = Math.floor(i / periodsPerYear);
+        // Compute glide-path target for THIS period (used by rebalancing).
+        const t = totalPeriods > 1 ? i / (totalPeriods - 1) : 1;
+        const targetAllocation = config.glidePath?.enabled
+            ? interpolateAllocation(initialAllocation, config.glidePath.finalAllocation, t, config.glidePath.shape)
+            : initialAllocation;
+        // Decide gross withdrawal
+        let gross = 0;
+        let sourcing = 'proportional';
+        if (config.strategy.kind !== 'interactive') {
+            const peek = {
+                index: i, date: row.date, cpi: row.cpi, returns: returnsTyped,
+                balancesStart, withdrawal: { stocks: 0, bonds: 0, cash: 0 },
+                balancesEnd: balancesStart,
+                totalReal: 0, totalNominal: 0,
+            };
+            // Attach CAPE for strategies that need it.
+            if (row.cape !== undefined)
+                peek.cape = row.cape;
+            const decision = strategyDecide(config.strategy, {
+                state: peek,
+                freq: config.stepFreq,
+                startCpi,
+                periodsPerYear,
+                totalPeriods,
+                prevState,
+                lastRealAnnualWithdrawal,
+            });
+            gross = decision.amount;
+            sourcing = decision.sourcing ?? getSourcing(config.strategy);
+        }
+        // Income (positive cash inflow) and extra withdrawals (additional outflow).
+        let incomeReceived = 0;
+        let extras = 0;
+        if (config.income) {
+            for (const s of config.income)
+                incomeReceived += streamAmountThisPeriod(s, yearsElapsed, periodsPerYear, startCpi, row.cpi);
+        }
+        if (config.extraWithdrawals) {
+            for (const s of config.extraWithdrawals)
+                extras += streamAmountThisPeriod(s, yearsElapsed, periodsPerYear, startCpi, row.cpi);
+        }
+        const net = Math.max(0, gross + extras - incomeReceived);
+        const withdrawal = withdrawFromBuckets(net, balancesStart, returnsTyped, sourcing);
+        let balancesEnd = {
+            stocks: balancesStart.stocks - withdrawal.stocks,
+            bonds: balancesStart.bonds - withdrawal.bonds,
+            cash: balancesStart.cash - withdrawal.cash,
+        };
+        // Rebalance
+        balancesEnd = rebalanceIfNeeded(balancesEnd, targetAllocation, config, i, totalPeriods);
+        const totalNominal = balancesEnd.stocks + balancesEnd.bonds + balancesEnd.cash;
+        const totalReal = totalNominal * (startCpi / row.cpi);
+        const periodState = {
+            index: i, date: row.date, cpi: row.cpi, returns: returnsTyped,
+            balancesStart, withdrawal, balancesEnd,
+            totalNominal, totalReal,
+            grossWithdrawal: gross,
+            netWithdrawal: net,
+            incomeReceived,
+            feesPaid,
+        };
+        periods.push(periodState);
+        // Track real annual withdrawal for next-period smoothing strategies.
+        const realThisPeriodAnnual = (net * (startCpi / row.cpi)) * periodsPerYear;
+        lastRealAnnualWithdrawal = realThisPeriodAnnual;
+        prevState = periodState;
+        if (totalNominal <= 0 && ranOutAtPeriod === null) {
+            ranOutAtPeriod = i;
+            balances = { stocks: 0, bonds: 0, cash: 0 };
+        }
+        else {
+            balances = balancesEnd;
+        }
+    }
+    const last = periods[periods.length - 1];
+    return {
+        config, startDate: data[startIdx].date,
+        periods, ranOutAtPeriod,
+        endBalanceNominal: last.totalNominal,
+        endBalanceReal: last.totalReal,
+        summary: computeTrialSummary(periods, config.initialBalance),
+    };
+}
+function normaliseStartDate(d, freq) {
+    if (freq === 'monthly')
+        return d;
+    const [y] = d.split('-');
+    return `${y}-12`;
+}
+export function pickRandomStart(data, horizonYears, freq, random) {
+    const periodsPerYear = freq === 'monthly' ? 12 : 1;
+    const haystack = freq === 'monthly' ? data : aggregateToAnnual(data);
+    const candidateCount = haystack.length - horizonYears * periodsPerYear + 1;
+    if (candidateCount <= 0)
+        throw new Error('Not enough data for horizon');
+    const sample = random();
+    if (!Number.isFinite(sample) || sample < 0 || sample >= 1) {
+        throw new Error(`Random source must return a finite value in [0, 1); received ${sample}`);
+    }
+    const i = Math.floor(sample * candidateCount);
+    return haystack[i].date;
+}
+//# sourceMappingURL=engine.js.map

package/dist/retirement/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/retirement/engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpE,SAAS,cAAc,CAAC,IAAqB,EAAE,IAAY;IACzD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,cAAc,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;YAAE,SAAS;QAC/B,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;YACrB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;YACvB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QACzB,CAAC;QACD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,GAAG,IAAI,KAAK;YAClB,QAAQ,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,CAAC;YACxD,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI;SACjC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,CAAU,EAAE,IAAiE,EAAE,cAAsB;IACtH,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,CAAC;IACjD,OAAO;QACL,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE;QAC3E,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAsB,EAAE,YAAoB,EAAE,cAAsB,EAAE,QAAgB,EAAE,UAAkB;IACxI,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,YAAY,GAAG,MAAM,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,YAAY,IAAI,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IAClG,IAAI,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;IACjC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,0BAA0B;YAC9C,CAAC,CAAC,UAAU,GAAG,QAAQ;YACvB,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAC;QAC1B,6GAA6G;QAC7G,MAAM,IAAI,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,GAAG,cAAc,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAiB,EAAE,GAAe,EAAE,CAAS,EAAE,KAAkD;IAC9H,MAAM,CAAC,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5F,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;QACtD,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QAClD,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,WAAoB,EACpB,MAAkB,EAClB,MAAiB,EACjB,CAAS,EACT,YAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;IAChC,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,EAAE,OAAO,IAAI,IAAI,CAAC;IACxD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;IACxE,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IAExD,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,MAAM,KAAK,eAAe;QAAE,eAAe,GAAG,IAAI,CAAC;SAClD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7B,eAAe;YACb,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACrD,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACnC,CAAC;SAAM,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;QACtC,MAAM,cAAc,GAAG,MAAM,GAAG,cAAc,CAAC;QAC/C,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc,KAAK,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,EACpD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAClD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CACjD,CAAC;QACF,eAAe,GAAG,KAAK,IAAI,OAAO,CAAC;IACrC,CAAC;IACD,oGAAoG;IACpG,KAAK,YAAY,CAAC;IAElB,IAAI,CAAC,eAAe;QAAE,OAAO,WAAW,CAAC;IACzC,OAAO;QACL,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM;QAC7B,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK;QAC3B,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAsB,EAAE,cAAsB;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,eAAe,EAAE,CAAC;YAClB,iBAAiB,EAAE,CAAC;YACpB,sBAAsB,EAAE,CAAC;YACzB,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,GAAG,cAAc,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,SAAS,GAAG,WAAW;YAAE,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC;YAAC,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC;QAAC,CAAC;QACtD,IAAI,CAAC,CAAC,SAAS,GAAG,cAAc;YAAE,eAAe,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;QAC/D,IAAI,OAAO,GAAG,WAAW;YAAE,WAAW,GAAG,OAAO,CAAC;QACjD,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9E,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5C,kBAAkB,IAAI,KAAK,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC;YAAE,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC;QACjF,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC;YACnG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO;QACL,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,WAAW;QAC9B,sBAAsB,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM;QACxD,eAAe,EAAE,WAAW;QAC5B,kBAAkB;QAClB,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,OAAwB;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,GAAG,cAAc,CAAC;IAE1D,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7F,IAAI,QAAQ,GAAG,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC;IACpC,MAAM,iBAAiB,GAAe,MAAM,CAAC,iBAAiB,CAAC;IAC/D,IAAI,QAAQ,GAAY;QACtB,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,iBAAiB,CAAC,MAAM;QACxD,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,iBAAiB,CAAC,KAAK;QACtD,IAAI,EAAE,MAAM,CAAC,cAAc,GAAG,iBAAiB,CAAC,IAAI;KACrD,CAAC;IAEF,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,SAAkC,CAAC;IACvC,IAAI,wBAA4C,CAAC;IAEjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,YAAY,GAAY,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QAEpG,gBAAgB;QAChB,IAAI,oBAAoB,GAAY;YAClC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;YACnD,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC;YAChD,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;SAC9C,CAAC;QAEF,aAAa;QACb,MAAM,UAAU,GAAG,SAAS,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAChF,oBAAoB,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;QAEjC,MAAM,aAAa,GAAY,oBAAoB,CAAC;QACpD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC;QAEpD,mEAAmE;QACnE,MAAM,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,gBAAgB,GACpB,MAAM,CAAC,SAAS,EAAE,OAAO;YACvB,CAAC,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YACvG,CAAC,CAAC,iBAAiB,CAAC;QAExB,0BAA0B;QAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,QAAQ,GAAmB,cAAc,CAAC;QAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAgB;gBACxB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY;gBAC7D,aAAa,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;gBAC3D,WAAW,EAAE,aAAa;gBAC1B,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;aAC9B,CAAC;YACF,2CAA2C;YAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;gBAAG,IAAwC,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtF,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE;gBAC/C,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,MAAM,CAAC,QAAQ;gBACrB,QAAQ;gBACR,cAAc;gBACd,YAAY;gBACZ,SAAS;gBACT,wBAAwB;aACzB,CAAC,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;YACxB,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/D,CAAC;QAED,4EAA4E;QAC5E,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;gBAAE,cAAc,IAAI,sBAAsB,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9H,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,gBAAgB;gBAAE,MAAM,IAAI,sBAAsB,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAChI,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,cAAc,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QAEnF,IAAI,WAAW,GAAY;YACzB,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM;YAChD,KAAK,EAAE,aAAa,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK;YAC7C,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI;SAC3C,CAAC;QAEF,YAAY;QACZ,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;QAExF,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;QAC/E,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAEtD,MAAM,WAAW,GAAgB;YAC/B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY;YAC7D,aAAa,EAAE,UAAU,EAAE,WAAW;YACtC,YAAY,EAAE,SAAS;YACvB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,GAAG;YAClB,cAAc;YACd,QAAQ;SACT,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE1B,qEAAqE;QACrE,MAAM,oBAAoB,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC;QAC3E,wBAAwB,GAAG,oBAAoB,CAAC;QAEhD,SAAS,GAAG,WAAW,CAAC;QAExB,IAAI,YAAY,IAAI,CAAC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YACjD,cAAc,GAAG,CAAC,CAAC;YACnB,QAAQ,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,WAAW,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO;QACL,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI;QACtC,OAAO,EAAE,cAAc;QACvB,iBAAiB,EAAE,IAAI,CAAC,YAAY;QACpC,cAAc,EAAE,IAAI,CAAC,SAAS;QAC9B,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS,EAAE,IAA0B;IAC/D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC;AAKD,MAAM,UAAU,eAAe,CAC7B,IAAqB,EACrB,YAAoB,EACpB,IAA0B,EAC1B,MAAoB;IAEpB,MAAM,cAAc,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,CAAC,CAAC;IAC3E,IAAI,cAAc,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,gEAAgE,MAAM,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1B,CAAC"}

package/dist/retirement/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './bucketRules.js';
+export * from './engine.js';
+export * from './runner.js';
+export * from './strategies/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/retirement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retirement/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA"}

package/dist/retirement/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './bucketRules.js';
+export * from './engine.js';
+export * from './runner.js';
+export * from './strategies/index.js';
+//# sourceMappingURL=index.js.map

package/dist/retirement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retirement/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA"}

package/dist/retirement/runner.d.ts

@@ -0,0 +1,15 @@
+import type { HistoricalRow, RunResult, SimConfig } from './types.js';
+export type RunnerOptions = {
+    /** Step density in years between cohort starts (monthly mode). Defaults to 1. */
+    stepYears?: number;
+};
+export declare function runAllCohorts(base: Omit<SimConfig, 'startDate'>, data: HistoricalRow[], options?: RunnerOptions): RunResult;
+/**
+ * SWR back-solve: find the largest constant-real withdrawal rate that yields >= targetSuccess.
+ * Uses bisection. Only meaningful for rules where rate -> success is monotone decreasing.
+ */
+export declare function solveSwr(base: Omit<SimConfig, 'startDate' | 'strategy'>, data: HistoricalRow[], targetSuccess?: number, bounds?: {
+    lo: number;
+    hi: number;
+}): number;
+//# sourceMappingURL=runner.d.ts.map

package/dist/retirement/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/retirement/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAyB,SAAS,EAAe,MAAM,YAAY,CAAC;AAoD1G,MAAM,MAAM,aAAa,GAAG;IAC1B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAClC,IAAI,EAAE,aAAa,EAAE,EACrB,OAAO,GAAE,aAAkB,GAC1B,SAAS,CAsBX;AAqFD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,UAAU,CAAC,EAC/C,IAAI,EAAE,aAAa,EAAE,EACrB,aAAa,SAAO,EACpB,MAAM,GAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAA4B,GAC3D,MAAM,CAYR"}

package/dist/retirement/runner.js

@@ -0,0 +1,178 @@
+import { aggregateToAnnual, simulate } from './engine.js';
+function quantile(sortedAsc, q) {
+    if (sortedAsc.length === 0)
+        return 0;
+    const idx = (sortedAsc.length - 1) * q;
+    const lo = Math.floor(idx);
+    const hi = Math.ceil(idx);
+    if (lo === hi)
+        return sortedAsc[lo];
+    const w = idx - lo;
+    return sortedAsc[lo] * (1 - w) + sortedAsc[hi] * w;
+}
+function quantilesOf(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    return {
+        p5: quantile(sorted, 0.05),
+        p10: quantile(sorted, 0.10),
+        p25: quantile(sorted, 0.25),
+        p50: quantile(sorted, 0.50),
+        p75: quantile(sorted, 0.75),
+        p90: quantile(sorted, 0.90),
+        p95: quantile(sorted, 0.95),
+    };
+}
+function correlation(xs, ys) {
+    const n = Math.min(xs.length, ys.length);
+    if (n < 2)
+        return 0;
+    let sx = 0, sy = 0;
+    for (let i = 0; i < n; i++) {
+        sx += xs[i];
+        sy += ys[i];
+    }
+    const mx = sx / n, my = sy / n;
+    let num = 0, dx = 0, dy = 0;
+    for (let i = 0; i < n; i++) {
+        const a = xs[i] - mx, b = ys[i] - my;
+        num += a * b;
+        dx += a * a;
+        dy += b * b;
+    }
+    if (dx === 0 || dy === 0)
+        return 0;
+    return num / Math.sqrt(dx * dy);
+}
+function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    return quantile(sorted, 0.5);
+}
+function mean(values) {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((s, x) => s + x, 0) / values.length;
+}
+export function runAllCohorts(base, data, options = {}) {
+    const trials = [];
+    const horizonMonths = base.horizonYears * 12;
+    const stepYears = options.stepYears ?? 1;
+    if (base.stepFreq === 'annual') {
+        const annualData = aggregateToAnnual(data);
+        for (let i = 0; i + base.horizonYears <= annualData.length; i += stepYears) {
+            const cfg = { ...base, startDate: annualData[i].date };
+            try {
+                trials.push(simulate(cfg, data));
+            }
+            catch { /* not enough data */ }
+        }
+    }
+    else {
+        for (let i = 0; i + horizonMonths < data.length; i += 12 * stepYears) {
+            const cfg = { ...base, startDate: data[i].date };
+            try {
+                trials.push(simulate(cfg, data));
+            }
+            catch { /* not enough data */ }
+        }
+    }
+    const summary = summarize(trials, base.horizonYears, base.stepFreq === 'monthly' ? 12 : 1);
+    const configHash = hashConfig(base);
+    return { trials, summary, configHash };
+}
+function summarize(trials, horizonYears, periodsPerYear) {
+    if (trials.length === 0) {
+        const zero = { p5: 0, p10: 0, p25: 0, p50: 0, p75: 0, p90: 0, p95: 0 };
+        return {
+            count: 0, successRate: 0,
+            endBalanceReal: zero, endBalanceNominal: zero,
+            withdrawalRealByYear: [], balanceRealByYear: [],
+            timeToRuin: [], medianMaxDrawdown: 0, meanMaxDrawdown: 0, medianTimeUnderwater: 0,
+            worstCohortStart: '', bestCohortStart: '',
+            sequenceRiskScore: 0, withdrawalVolatility: 0, startDates: [],
+        };
+    }
+    const successes = trials.filter(t => t.ranOutAtPeriod === null);
+    const endsReal = trials.map(t => t.endBalanceReal);
+    const endsNominal = trials.map(t => t.endBalanceNominal);
+    // Per-year quantiles for withdrawals (real) and balance (real).
+    const withdrawalRealByYear = [];
+    const balanceRealByYear = [];
+    for (let y = 0; y < horizonYears; y++) {
+        const wValues = [];
+        const bValues = [];
+        for (const t of trials) {
+            // Sum withdrawals across periods within year y
+            let yearW = 0;
+            let lastBal = null;
+            for (let k = 0; k < periodsPerYear; k++) {
+                const p = t.periods[y * periodsPerYear + k];
+                if (!p)
+                    break;
+                const startCpi = t.periods[0].cpi;
+                const wNominal = p.withdrawal.stocks + p.withdrawal.bonds + p.withdrawal.cash;
+                yearW += wNominal * (startCpi / p.cpi);
+                lastBal = p.totalReal;
+            }
+            wValues.push(yearW);
+            if (lastBal !== null)
+                bValues.push(lastBal);
+        }
+        withdrawalRealByYear.push(quantilesOf(wValues));
+        balanceRealByYear.push(quantilesOf(bValues));
+    }
+    const timeToRuin = trials.filter(t => t.ranOutAtPeriod !== null).map(t => t.ranOutAtPeriod);
+    const maxDDs = trials.map(t => t.summary?.maxDrawdownReal ?? 0);
+    const underwaterFractions = trials.map(t => t.summary?.timeUnderwaterFraction ?? 0);
+    const cvs = trials.map(t => t.summary?.withdrawalCV ?? 0);
+    // First-decade return for each cohort (real, blended 60/40).
+    const firstDecadeReturns = trials.map(t => {
+        const decadeEnd = Math.min(t.periods.length, 10 * periodsPerYear);
+        let acc = 1;
+        for (let k = 0; k < decadeEnd; k++) {
+            const r = t.periods[k].returns;
+            acc *= 1 + (r.stocks * 0.6 + r.bonds * 0.4);
+        }
+        return acc - 1;
+    });
+    const sortedByEnd = [...trials].sort((a, b) => a.endBalanceReal - b.endBalanceReal);
+    return {
+        count: trials.length,
+        successRate: successes.length / trials.length,
+        endBalanceReal: quantilesOf(endsReal),
+        endBalanceNominal: quantilesOf(endsNominal),
+        withdrawalRealByYear,
+        balanceRealByYear,
+        timeToRuin,
+        medianMaxDrawdown: median(maxDDs),
+        meanMaxDrawdown: mean(maxDDs),
+        medianTimeUnderwater: median(underwaterFractions),
+        worstCohortStart: sortedByEnd[0].startDate,
+        bestCohortStart: sortedByEnd[sortedByEnd.length - 1].startDate,
+        sequenceRiskScore: correlation(firstDecadeReturns, endsReal),
+        withdrawalVolatility: median(cvs),
+        startDates: trials.map(t => t.startDate),
+    };
+}
+function hashConfig(c) {
+    // Lightweight stable hash — used to skip duplicate runs in live-tweak.
+    return JSON.stringify(c).split('').reduce((h, ch) => ((h << 5) - h + ch.charCodeAt(0)) | 0, 0).toString(36);
+}
+/**
+ * SWR back-solve: find the largest constant-real withdrawal rate that yields >= targetSuccess.
+ * Uses bisection. Only meaningful for rules where rate -> success is monotone decreasing.
+ */
+export function solveSwr(base, data, targetSuccess = 0.95, bounds = { lo: 0.005, hi: 0.12 }) {
+    let { lo, hi } = bounds;
+    for (let iter = 0; iter < 18; iter++) {
+        const mid = (lo + hi) / 2;
+        const result = runAllCohorts({ ...base, strategy: { kind: 'constant-dollar', annualAmount: base.initialBalance * mid, inflationAdjusted: true, sourcing: 'proportional' } }, data);
+        if (result.summary.successRate >= targetSuccess)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    return lo;
+}
+//# sourceMappingURL=runner.js.map

package/dist/retirement/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/retirement/runner.ts"],"names":[],"mappings":"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"}

package/dist/retirement/strategies/index.d.ts

@@ -0,0 +1,30 @@
+import type { BucketSourcing, PeriodState, StepFreq, StrategyKind, WithdrawalStrategy } from '../types.js';
+export type Decision = {
+    amount: number;
+    sourcing: BucketSourcing;
+};
+export type StrategyContext = {
+    state: PeriodState;
+    freq: StepFreq;
+    startCpi: number;
+    periodsPerYear: number;
+    /** Total horizon in periods (used by 1/N, VPW). */
+    totalPeriods: number;
+    /** Prior period (for strategies that need lagged data). Undefined on first period. */
+    prevState?: PeriodState;
+    /** Last computed real (inflation-adjusted) annual withdrawal — used by smoothing rules. */
+    lastRealAnnualWithdrawal?: number;
+};
+export type StrategyDef = {
+    kind: StrategyKind;
+    /** Domain defaults; presentation metadata remains in the consuming app. */
+    defaults: WithdrawalStrategy;
+    /** Returns the gross withdrawal amount for the period (PRE income/extras adjustment). */
+    decide: (strategy: WithdrawalStrategy, ctx: StrategyContext) => Decision;
+};
+export declare const STRATEGY_REGISTRY: Record<StrategyKind, StrategyDef>;
+export declare function getStrategyDef(kind: StrategyKind): StrategyDef;
+export declare function strategyDecide(strategy: WithdrawalStrategy, ctx: StrategyContext): Decision;
+/** Helper to extract the sourcing field from any strategy that has one. */
+export declare function getSourcing(strategy: WithdrawalStrategy): BucketSourcing;
+//# sourceMappingURL=index.d.ts.map

package/dist/retirement/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/retirement/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE3G,MAAM,MAAM,QAAQ,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2FAA2F;IAC3F,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,yFAAyF;IACzF,MAAM,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe,KAAK,QAAQ,CAAC;CAC1E,CAAC;AA4PF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CAc/D,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAE9D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe,GAAG,QAAQ,CAG3F;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAGxE"}