fundedness 0.1.0__tar.gz → 0.2.1__tar.gz

{fundedness-0.1.0 → fundedness-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fundedness
-Version: 0.1.0
+Version: 0.2.1
 Summary: A Python financial planning toolkit with CEFR calculations, Monte Carlo simulations, and beautiful visualizations
 Project-URL: Homepage, https://github.com/engineerinvestor/financial-health-calculator
 Project-URL: Documentation, https://engineerinvestor.github.io/financial-health-calculator/
@@ -54,15 +54,22 @@ Description-Content-Type: text/markdown
 
 # Financial Health Calculator
 
-A comprehensive Python financial planning toolkit with CEFR calculations, Monte Carlo simulations, and beautiful Plotly visualizations.
-
+[![PyPI version](https://img.shields.io/pypi/v/fundedness.svg)](https://pypi.org/project/fundedness/)
+[![Python versions](https://img.shields.io/pypi/pyversions/fundedness.svg)](https://pypi.org/project/fundedness/)
+[![CI](https://github.com/engineerinvestor/financial-health-calculator/actions/workflows/ci.yml/badge.svg)](https://github.com/engineerinvestor/financial-health-calculator/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/engineerinvestor/financial-health-calculator/branch/main/graph/badge.svg)](https://codecov.io/gh/engineerinvestor/financial-health-calculator)
+[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://engineerinvestor.github.io/financial-health-calculator/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/engineerinvestor/financial-health-calculator/blob/main/examples/01_cefr_basics.ipynb)
 
+A comprehensive Python financial planning toolkit with CEFR calculations, Monte Carlo simulations, and beautiful Plotly visualizations.
+
 ## Features
 
 - **CEFR (Certainty-Equivalent Funded Ratio)**: A fundedness metric that accounts for taxes, liquidity, and concentration risk
 - **Monte Carlo Simulations**: Project retirement outcomes with configurable market assumptions
-- **Withdrawal Strategy Lab**: Compare strategies including fixed SWR, guardrails, VPW, and RMD-style
+- **Withdrawal Strategy Lab**: Compare strategies including fixed SWR, guardrails, VPW, RMD-style, and Merton optimal
+- **Utility Optimization**: Merton optimal spending and allocation based on lifetime utility maximization
 - **Beautiful Visualizations**: Interactive Plotly charts with fan charts, waterfalls, and survival curves
 - **REST API**: FastAPI backend for programmatic access
 - **Streamlit App**: User-friendly web interface
@@ -72,12 +79,12 @@ A comprehensive Python financial planning toolkit with CEFR calculations, Monte
 ### Installation
 
 ```bash
-pip install git+https://github.com/engineerinvestor/financial-health-calculator.git
+pip install fundedness
 ```
 
 For development with all extras:
 ```bash
-pip install "git+https://github.com/engineerinvestor/financial-health-calculator.git#egg=fundedness[all]"
+pip install "fundedness[all]"
 ```
 
 ### Basic Usage
@@ -176,6 +183,22 @@ Where τ = tax rate, λ = liquidity factor, ρ = reliability factor
 | Guardrails | Adjustable with floor/ceiling | Balance |
 | VPW | Age-based variable percentage | Maximizing spending |
 | RMD-Style | IRS distribution table based | Tax efficiency |
+| Merton Optimal | Utility-maximizing spending rate | Optimality |
+
+### Utility Optimization
+
+The toolkit includes Merton's optimal consumption and portfolio choice framework, as applied in modern retirement planning research<sup>[1]</sup>:
+
+- **Optimal Equity Allocation**: `k* = (μ - r) / (γ × σ²)`
+- **Wealth-Adjusted Allocation**: Reduces equity as wealth approaches subsistence floor
+- **Optimal Spending Rate**: Increases with age as horizon shortens
+- **Expected Lifetime Utility**: Track utility across Monte Carlo paths
+
+Key insights from this methodology:
+1. Optimal spending starts low (~2-3%) and rises with age
+2. Allocation should decrease as wealth approaches the floor
+3. Risk aversion (gamma) is the critical input parameter
+4. The 4% rule is suboptimal from a utility perspective
 
 ## Development
 
@@ -207,13 +230,16 @@ financial-health-calculator/
 ├── fundedness/           # Core Python package
 │   ├── models/           # Pydantic data models
 │   ├── viz/              # Plotly visualizations
-│   ├── withdrawals/      # Withdrawal strategies
-│   ├── allocation/       # Asset allocation strategies
+│   ├── withdrawals/      # Withdrawal strategies (SWR, guardrails, VPW, Merton)
+│   ├── allocation/       # Asset allocation strategies (constant, glidepath, Merton)
 │   ├── cefr.py           # CEFR calculation
-│   ├── simulate.py       # Monte Carlo engine
+│   ├── simulate.py       # Monte Carlo engine with utility tracking
+│   ├── merton.py         # Merton optimal formulas
+│   ├── optimize.py       # Policy parameter optimization
 │   └── policies.py       # Spending/allocation policies
 ├── api/                  # FastAPI REST API
 ├── streamlit_app/        # Streamlit web application
+│   └── pages/            # Includes Utility Optimization page
 ├── examples/             # Jupyter notebooks
 └── tests/                # pytest tests
 ```
@@ -228,6 +254,12 @@ financial-health-calculator/
 
 MIT License
 
+## References
+
+1. Haghani, V., & White, J. (2023). *The Missing Billionaires: A Guide to Better Financial Decisions*. Wiley. See also [Elm Wealth](https://elmwealth.com/) for related research on optimal spending and allocation.
+
+2. Merton, R. C. (1969). Lifetime Portfolio Selection under Uncertainty: The Continuous-Time Case. *The Review of Economics and Statistics*, 51(3), 247-257.
+
 ## Disclaimer
 
 This tool is for educational purposes only and does not constitute financial advice. Consult a qualified financial advisor for personalized recommendations.

{fundedness-0.1.0 → fundedness-0.2.1}/README.md

@@ -1,14 +1,21 @@
 # Financial Health Calculator
 
-A comprehensive Python financial planning toolkit with CEFR calculations, Monte Carlo simulations, and beautiful Plotly visualizations.
-
+[![PyPI version](https://img.shields.io/pypi/v/fundedness.svg)](https://pypi.org/project/fundedness/)
+[![Python versions](https://img.shields.io/pypi/pyversions/fundedness.svg)](https://pypi.org/project/fundedness/)
+[![CI](https://github.com/engineerinvestor/financial-health-calculator/actions/workflows/ci.yml/badge.svg)](https://github.com/engineerinvestor/financial-health-calculator/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/engineerinvestor/financial-health-calculator/branch/main/graph/badge.svg)](https://codecov.io/gh/engineerinvestor/financial-health-calculator)
+[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://engineerinvestor.github.io/financial-health-calculator/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/engineerinvestor/financial-health-calculator/blob/main/examples/01_cefr_basics.ipynb)
 
+A comprehensive Python financial planning toolkit with CEFR calculations, Monte Carlo simulations, and beautiful Plotly visualizations.
+
 ## Features
 
 - **CEFR (Certainty-Equivalent Funded Ratio)**: A fundedness metric that accounts for taxes, liquidity, and concentration risk
 - **Monte Carlo Simulations**: Project retirement outcomes with configurable market assumptions
-- **Withdrawal Strategy Lab**: Compare strategies including fixed SWR, guardrails, VPW, and RMD-style
+- **Withdrawal Strategy Lab**: Compare strategies including fixed SWR, guardrails, VPW, RMD-style, and Merton optimal
+- **Utility Optimization**: Merton optimal spending and allocation based on lifetime utility maximization
 - **Beautiful Visualizations**: Interactive Plotly charts with fan charts, waterfalls, and survival curves
 - **REST API**: FastAPI backend for programmatic access
 - **Streamlit App**: User-friendly web interface
@@ -18,12 +25,12 @@ A comprehensive Python financial planning toolkit with CEFR calculations, Monte
 ### Installation
 
 ```bash
-pip install git+https://github.com/engineerinvestor/financial-health-calculator.git
+pip install fundedness
 ```
 
 For development with all extras:
 ```bash
-pip install "git+https://github.com/engineerinvestor/financial-health-calculator.git#egg=fundedness[all]"
+pip install "fundedness[all]"
 ```
 
 ### Basic Usage
@@ -122,6 +129,22 @@ Where τ = tax rate, λ = liquidity factor, ρ = reliability factor
 | Guardrails | Adjustable with floor/ceiling | Balance |
 | VPW | Age-based variable percentage | Maximizing spending |
 | RMD-Style | IRS distribution table based | Tax efficiency |
+| Merton Optimal | Utility-maximizing spending rate | Optimality |
+
+### Utility Optimization
+
+The toolkit includes Merton's optimal consumption and portfolio choice framework, as applied in modern retirement planning research<sup>[1]</sup>:
+
+- **Optimal Equity Allocation**: `k* = (μ - r) / (γ × σ²)`
+- **Wealth-Adjusted Allocation**: Reduces equity as wealth approaches subsistence floor
+- **Optimal Spending Rate**: Increases with age as horizon shortens
+- **Expected Lifetime Utility**: Track utility across Monte Carlo paths
+
+Key insights from this methodology:
+1. Optimal spending starts low (~2-3%) and rises with age
+2. Allocation should decrease as wealth approaches the floor
+3. Risk aversion (gamma) is the critical input parameter
+4. The 4% rule is suboptimal from a utility perspective
 
 ## Development
 
@@ -153,13 +176,16 @@ financial-health-calculator/
 ├── fundedness/           # Core Python package
 │   ├── models/           # Pydantic data models
 │   ├── viz/              # Plotly visualizations
-│   ├── withdrawals/      # Withdrawal strategies
-│   ├── allocation/       # Asset allocation strategies
+│   ├── withdrawals/      # Withdrawal strategies (SWR, guardrails, VPW, Merton)
+│   ├── allocation/       # Asset allocation strategies (constant, glidepath, Merton)
 │   ├── cefr.py           # CEFR calculation
-│   ├── simulate.py       # Monte Carlo engine
+│   ├── simulate.py       # Monte Carlo engine with utility tracking
+│   ├── merton.py         # Merton optimal formulas
+│   ├── optimize.py       # Policy parameter optimization
 │   └── policies.py       # Spending/allocation policies
 ├── api/                  # FastAPI REST API
 ├── streamlit_app/        # Streamlit web application
+│   └── pages/            # Includes Utility Optimization page
 ├── examples/             # Jupyter notebooks
 └── tests/                # pytest tests
 ```
@@ -174,6 +200,12 @@ financial-health-calculator/
 
 MIT License
 
+## References
+
+1. Haghani, V., & White, J. (2023). *The Missing Billionaires: A Guide to Better Financial Decisions*. Wiley. See also [Elm Wealth](https://elmwealth.com/) for related research on optimal spending and allocation.
+
+2. Merton, R. C. (1969). Lifetime Portfolio Selection under Uncertainty: The Continuous-Time Case. *The Review of Economics and Statistics*, 51(3), 247-257.
+
 ## Disclaimer
 
 This tool is for educational purposes only and does not constitute financial advice. Consult a qualified financial advisor for personalized recommendations.

{fundedness-0.1.0 → fundedness-0.2.1}/docs/api/core.md

@@ -12,4 +12,4 @@ The main calculation and simulation functions.
 
 ## Strategy Comparison
 
-::: fundedness.simulate.compare_strategies
+::: fundedness.withdrawals.comparison.compare_strategies

fundedness-0.2.1/docs/api/merton.md

@@ -0,0 +1,91 @@
+# Merton Optimal API Reference
+
+This module provides Merton's optimal consumption and portfolio choice formulas.
+
+## Core Functions
+
+::: fundedness.merton.merton_optimal_allocation
+    options:
+      show_root_heading: true
+
+::: fundedness.merton.certainty_equivalent_return
+    options:
+      show_root_heading: true
+
+::: fundedness.merton.merton_optimal_spending_rate
+    options:
+      show_root_heading: true
+
+::: fundedness.merton.wealth_adjusted_optimal_allocation
+    options:
+      show_root_heading: true
+
+::: fundedness.merton.calculate_merton_optimal
+    options:
+      show_root_heading: true
+
+## Helper Functions
+
+::: fundedness.merton.optimal_spending_by_age
+    options:
+      show_root_heading: true
+
+::: fundedness.merton.optimal_allocation_by_wealth
+    options:
+      show_root_heading: true
+
+## Data Classes
+
+::: fundedness.merton.MertonOptimalResult
+    options:
+      show_root_heading: true
+
+## Spending Policies
+
+::: fundedness.withdrawals.merton_optimal.MertonOptimalSpendingPolicy
+    options:
+      show_root_heading: true
+
+::: fundedness.withdrawals.merton_optimal.SmoothedMertonPolicy
+    options:
+      show_root_heading: true
+
+::: fundedness.withdrawals.merton_optimal.FloorAdjustedMertonPolicy
+    options:
+      show_root_heading: true
+
+## Allocation Policies
+
+::: fundedness.allocation.merton_optimal.MertonOptimalAllocationPolicy
+    options:
+      show_root_heading: true
+
+::: fundedness.allocation.merton_optimal.WealthBasedAllocationPolicy
+    options:
+      show_root_heading: true
+
+::: fundedness.allocation.merton_optimal.FloorProtectionAllocationPolicy
+    options:
+      show_root_heading: true
+
+## Policy Optimization
+
+::: fundedness.optimize.PolicyParameterSpec
+    options:
+      show_root_heading: true
+
+::: fundedness.optimize.OptimizationResult
+    options:
+      show_root_heading: true
+
+::: fundedness.optimize.optimize_spending_policy
+    options:
+      show_root_heading: true
+
+::: fundedness.optimize.optimize_allocation_policy
+    options:
+      show_root_heading: true
+
+::: fundedness.optimize.optimize_combined_policy
+    options:
+      show_root_heading: true

{fundedness-0.1.0 → fundedness-0.2.1}/docs/api/models.md

@@ -14,7 +14,7 @@ Pydantic models for representing financial data.
 
 ## Balance Sheet
 
-::: fundedness.models.balance_sheet.BalanceSheet
+::: fundedness.models.assets.BalanceSheet
 
 ## Liabilities
 
@@ -26,6 +26,14 @@ Pydantic models for representing financial data.
 
 ::: fundedness.models.household.Person
 
-## Market Assumptions
+## Market Model
 
-::: fundedness.models.assumptions.MarketAssumptions
+::: fundedness.models.market.MarketModel
+
+## Simulation Config
+
+::: fundedness.models.simulation.SimulationConfig
+
+## Tax Model
+
+::: fundedness.models.tax.TaxModel

fundedness-0.2.1/docs/api/viz.md

@@ -0,0 +1,23 @@
+# Visualization Functions
+
+Plotly chart generation functions.
+
+## CEFR Charts
+
+::: fundedness.viz.waterfall.create_cefr_waterfall
+
+## Simulation Charts
+
+::: fundedness.viz.fan_chart.create_fan_chart
+
+::: fundedness.viz.survival.create_survival_curve
+
+::: fundedness.viz.histogram.create_time_distribution_histogram
+
+## Comparison Charts
+
+::: fundedness.viz.comparison.create_strategy_comparison_chart
+
+## Sensitivity Charts
+
+::: fundedness.viz.tornado.create_tornado_chart

{fundedness-0.1.0 → fundedness-0.2.1}/docs/api/withdrawals.md

@@ -6,13 +6,15 @@ Classes implementing different withdrawal strategies.
 
 ::: fundedness.withdrawals.base.WithdrawalPolicy
 
+::: fundedness.withdrawals.base.BaseWithdrawalPolicy
+
 ## Fixed SWR
 
-::: fundedness.withdrawals.fixed_swr.FixedSWRPolicy
+::: fundedness.withdrawals.fixed_swr.FixedRealSWRPolicy
 
 ## Percentage of Portfolio
 
-::: fundedness.withdrawals.percent_of_portfolio.PercentOfPortfolioPolicy
+::: fundedness.withdrawals.fixed_swr.PercentOfPortfolioPolicy
 
 ## Guardrails
 
@@ -24,4 +26,4 @@ Classes implementing different withdrawal strategies.
 
 ## RMD-Style
 
-::: fundedness.withdrawals.rmd.RMDPolicy
+::: fundedness.withdrawals.rmd_style.RMDStylePolicy

fundedness-0.2.1/docs/guide/utility-optimization.md

@@ -0,0 +1,200 @@
+# Utility Optimization
+
+This guide covers the utility-optimal spending and allocation framework based on Merton's continuous-time portfolio optimization theory.
+
+## Overview
+
+Traditional retirement planning often uses rules of thumb like the "4% rule." While simple, these approaches don't account for individual preferences about risk and the trade-off between spending now versus later.
+
+Utility optimization provides a rigorous framework for finding the **optimal** spending rate and asset allocation based on:
+
+- **Risk aversion (gamma)**: How much you dislike uncertainty
+- **Time preference**: How much you prefer spending now vs. later
+- **Subsistence floor**: Minimum spending you need to survive
+
+## Key Formulas
+
+### Optimal Equity Allocation
+
+The Merton formula gives the optimal fraction to invest in risky assets:
+
+$$k^* = \frac{\mu - r}{\gamma \times \sigma^2}$$
+
+Where:
+
+- $\mu$ = expected stock return
+- $r$ = bond/risk-free return
+- $\gamma$ = risk aversion coefficient
+- $\sigma$ = stock volatility
+
+### Certainty Equivalent Return
+
+The guaranteed return that provides the same utility as the risky portfolio:
+
+$$r_{CE} = r + k^*(\mu - r) - \frac{\gamma \times k^{*2} \times \sigma^2}{2}$$
+
+### Optimal Spending Rate
+
+For an infinite horizon:
+
+$$c^* = r_{CE} - \frac{r_{CE} - \rho}{\gamma}$$
+
+Where $\rho$ is your time preference (discount rate).
+
+## Quick Start
+
+```python
+from fundedness import (
+    calculate_merton_optimal,
+    MarketModel,
+    UtilityModel,
+)
+
+# Define market assumptions
+market = MarketModel(
+    stock_return=0.05,      # 5% expected real return
+    bond_return=0.015,      # 1.5% risk-free rate
+    stock_volatility=0.16,  # 16% annual volatility
+)
+
+# Define your preferences
+utility = UtilityModel(
+    gamma=3.0,              # Risk aversion (typical: 2-5)
+    subsistence_floor=30000,  # Minimum annual spending
+    time_preference=0.02,   # 2% discount rate
+)
+
+# Calculate optimal policy
+result = calculate_merton_optimal(
+    wealth=1_000_000,
+    market_model=market,
+    utility_model=utility,
+    remaining_years=30,
+)
+
+print(f"Optimal equity allocation: {result.optimal_equity_allocation:.1%}")
+print(f"Wealth-adjusted allocation: {result.wealth_adjusted_allocation:.1%}")
+print(f"Optimal spending rate: {result.optimal_spending_rate:.1%}")
+print(f"Year 1 spending: ${1_000_000 * result.optimal_spending_rate:,.0f}")
+```
+
+## Wealth-Adjusted Allocation
+
+Near the subsistence floor, you can't afford to take risk. The wealth-adjusted allocation accounts for this:
+
+$$k_{adj} = k^* \times \frac{W - F}{W}$$
+
+Where $W$ is wealth and $F$ is the subsistence floor.
+
+As wealth approaches the floor, allocation approaches zero. As wealth rises far above the floor, allocation approaches the unconstrained optimal.
+
+```python
+from fundedness import wealth_adjusted_optimal_allocation
+
+# Near the floor: low allocation
+k_low = wealth_adjusted_optimal_allocation(
+    wealth=50_000,  # Just above $30k floor
+    market_model=market,
+    utility_model=utility,
+)
+print(f"Allocation at $50k: {k_low:.1%}")  # ~18%
+
+# Well above floor: approaches optimal
+k_high = wealth_adjusted_optimal_allocation(
+    wealth=2_000_000,
+    market_model=market,
+    utility_model=utility,
+)
+print(f"Allocation at $2M: {k_high:.1%}")  # ~44%
+```
+
+## Spending Rate by Age
+
+Optimal spending rate increases with age as the remaining horizon shortens:
+
+```python
+from fundedness import optimal_spending_by_age
+
+rates = optimal_spending_by_age(
+    market_model=market,
+    utility_model=utility,
+    starting_age=65,
+    end_age=95,
+)
+
+for age in [65, 75, 85, 95]:
+    print(f"Age {age}: {rates[age]:.1%}")
+```
+
+Example output:
+```
+Age 65: 3.8%
+Age 75: 5.2%
+Age 85: 7.8%
+Age 95: 100.0%
+```
+
+## Using Merton Policies in Simulation
+
+### Merton Spending Policy
+
+```python
+from fundedness.withdrawals import MertonOptimalSpendingPolicy
+from fundedness.allocation import MertonOptimalAllocationPolicy
+from fundedness import run_simulation_with_utility, SimulationConfig
+
+# Create policies
+spending_policy = MertonOptimalSpendingPolicy(
+    market_model=market,
+    utility_model=utility,
+    starting_age=65,
+    end_age=95,
+)
+
+allocation_policy = MertonOptimalAllocationPolicy(
+    market_model=market,
+    utility_model=utility,
+)
+
+# Run simulation with utility tracking
+config = SimulationConfig(
+    n_simulations=5000,
+    n_years=30,
+    market_model=market,
+)
+
+result = run_simulation_with_utility(
+    initial_wealth=1_000_000,
+    spending_policy=spending_policy,
+    allocation_policy=allocation_policy,
+    config=config,
+    utility_model=utility,
+)
+
+print(f"Expected lifetime utility: {result.expected_lifetime_utility:.2e}")
+print(f"Certainty equivalent: ${result.certainty_equivalent_consumption:,.0f}/year")
+print(f"Success rate: {result.success_rate:.1%}")
+```
+
+## Key Insights
+
+1. **Spending rate increases with age** - As the horizon shortens, you should spend more
+2. **Allocation decreases near the floor** - You can't afford risk when close to subsistence
+3. **Risk aversion (gamma) is critical** - Higher gamma means lower allocation and spending
+4. **The 4% rule is often suboptimal** - Merton optimal typically starts lower and ends higher
+
+## Choosing Your Risk Aversion
+
+Risk aversion (gamma) is the most important input. Guidelines:
+
+| Gamma | Risk Tolerance | Profile |
+|-------|----------------|---------|
+| 1-2 | High | Comfortable with volatility |
+| 2-3 | Moderate | Typical investor |
+| 3-5 | Low | Prefers stability |
+| 5+ | Very low | Strong loss aversion |
+
+## References
+
+- Merton, R. C. (1969). Lifetime Portfolio Selection under Uncertainty: The Continuous-Time Case. *The Review of Economics and Statistics*, 51(3), 247-257.
+- Haghani, V., & White, J. (2023). *The Missing Billionaires: A Guide to Better Financial Decisions*. Wiley.

{fundedness-0.1.0 → fundedness-0.2.1}/docs/index.md

@@ -8,7 +8,8 @@ A comprehensive Python financial planning toolkit with CEFR calculations, Monte
 
 - **CEFR (Certainty-Equivalent Funded Ratio)**: A fundedness metric that accounts for taxes, liquidity, and concentration risk
 - **Monte Carlo Simulations**: Project retirement outcomes with configurable market assumptions
-- **Withdrawal Strategy Lab**: Compare strategies including fixed SWR, guardrails, VPW, and RMD-style
+- **Withdrawal Strategy Lab**: Compare strategies including fixed SWR, guardrails, VPW, RMD-style, and Merton optimal
+- **Utility Optimization**: Merton optimal spending and allocation based on lifetime utility maximization
 - **Beautiful Visualizations**: Interactive Plotly charts with fan charts, waterfalls, and survival curves
 - **REST API**: FastAPI backend for programmatic access
 - **Streamlit App**: User-friendly web interface
@@ -55,6 +56,7 @@ print(f"CEFR: {result.cefr:.2f}")
 - [CEFR Explained](guide/cefr.md) - Understanding the CEFR metric
 - [Monte Carlo Simulations](guide/simulations.md) - Running projections
 - [Withdrawal Strategies](guide/withdrawals.md) - Comparing approaches
+- [Utility Optimization](guide/utility-optimization.md) - Merton optimal spending and allocation
 - [Visualizations](guide/visualizations.md) - Creating charts
 
 ## API Reference

{fundedness-0.1.0 → fundedness-0.2.1}/examples/01_cefr_basics.ipynb

@@ -10,7 +10,7 @@
    "execution_count": null,
    "metadata": {},
    "outputs": [],
-   "source": "# Install the fundedness package from GitHub\n!pip install git+https://github.com/engineerinvestor/financial-health-calculator.git -q"
+   "source": "# Install the fundedness package\n!pip install fundedness -q"
   },
   {
    "cell_type": "code",

{fundedness-0.1.0 → fundedness-0.2.1}/examples/02_time_distribution.ipynb

@@ -10,7 +10,7 @@
    "execution_count": null,
    "metadata": {},
    "outputs": [],
-   "source": "# Install the fundedness package from GitHub\n!pip install git+https://github.com/engineerinvestor/financial-health-calculator.git -q"
+   "source": "# Install the fundedness package\n!pip install fundedness -q"
   },
   {
    "cell_type": "code",

{fundedness-0.1.0 → fundedness-0.2.1}/examples/03_withdrawal_comparison.ipynb

@@ -10,7 +10,7 @@
    "execution_count": null,
    "metadata": {},
    "outputs": [],
-   "source": "# Install the fundedness package from GitHub\n!pip install git+https://github.com/engineerinvestor/financial-health-calculator.git -q"
+   "source": "# Install the fundedness package\n!pip install fundedness -q"
   },
   {
    "cell_type": "code",