startup-valuation 1.0.0__tar.gz

startup_valuation-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Type check
+        run: mypy src/startup_valuation --ignore-missing-imports
+
+      - name: Run tests
+        run: pytest --cov=startup_valuation --cov-report=term-missing -v

startup_valuation-1.0.0/.github/workflows/docs.yml

@@ -0,0 +1,52 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[docs]"
+
+      - name: Build docs
+        run: mkdocs build --strict
+
+      - name: Upload artifact
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

startup_valuation-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,56 @@
+name: Publish
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: python -m pip install --upgrade build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-to-pypi:
+    needs: build-and-upload
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/startup-valuation
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: python -m pip install --upgrade build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

startup_valuation-1.0.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+output/
+Startup_Valuation.docx
+convert.py
+omml_to_latex.py
+site/

startup_valuation-1.0.0/AGENTS.md

@@ -0,0 +1,40 @@
+# AGENTS.md — Startup Valuation
+
+## Commands
+
+```bash
+pip install -e ".[dev]"        # install with dev deps (pytest, ruff, coverage, mypy)
+pytest                          # run all 101 tests (~6s)
+pytest --cov=startup_valuation  # with coverage (88%)
+ruff check .                    # lint
+mypy src/startup_valuation      # type check
+```
+
+CI runs `mypy` + `pytest --cov=... -v` on Python 3.10/3.11/3.12. Docs build with `mkdocs build --strict`.
+
+## Architecture
+
+- `src/startup_valuation/` — 14 modules, 100+ functions. All return `ValuationResult` (never bare numbers).
+- `src/startup_valuation/types.py` — `ValuationResult`, `Distribution`, `Scenario`, `SensitivityResult` dataclasses.
+- `mcp_server/server.py` — FastMCP server with 60+ tools. Run: `cd mcp_server && python server.py`. Requires `pip install -e ".[mcp]"`.
+- `skills/` — 5 AI-Agent SKILL.md files (core, advanced, industry, stakeholder, emerging).
+- `docs/` — MkDocs Material site (API reference, examples, chapter index). Deployed to GitHub Pages.
+- `output/` — Textbook source markdown (reference material, not generated).
+- `specs/` — SDD artifacts for valuation-engine and model-enhancement-publish projects.
+
+## Key Conventions
+
+- Every library function returns `ValuationResult` with `value`, `method`, `inputs`, `assumptions`, `sensitivity`, `chapter`.
+- MCP tools unwrap `ValuationResult` to plain dicts (`{"value": ..., "method": ...}`) for agent consumption.
+- Tests validate against textbook example values — do not change expected values without verifying against the source book.
+- `scipy.stats` used for Poisson and Black-Scholes `N(d)` calculations (avoids `math.factorial` overflow).
+- `scipy.integrate.quad` used for continuous expected value numerical integration.
+- `numpy` used for Monte Carlo simulations.
+- Per-module test files: one `test_*.py` per module in `tests/`.
+
+## Gotchas
+
+- `src/` layout: must use `pip install -e` or set `PYTHONPATH=src` for imports to resolve.
+- `fastmcp` is an optional dependency (`.[mcp]`) — not installed by default with `.[dev]`.
+- Test tolerances use `pytest.approx(abs=N)` — textbook values have ±$1–5 rounding variance.
+- MkDocs uses `mkdocstrings` for auto-generated API docs — docstrings must be Google-style.

startup_valuation-1.0.0/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] — 2026-05-20
+
+### Added
+- Book-aligned documentation site with Amazon purchase link
+- Book hero section on homepage with cover image and description
+- Chapter-to-module mapping table
+- Ascent Partners branding (logo, `#0083AB` color, Titillium Web/Open Sans fonts)
+- `expected_value_continuous` — numerical integration for continuous random variables
+- `binomial_valuation` — high-resolution binomial tree (steps=50) for startup options
+- `payment_processor_valuation` — DCF-based payment processor valuation
+- `neobank_valuation` — customer-based LTV × P/E neobank valuation
+- `buyer_retention` — marketplace buyer retention rate
+- `network_density` — marketplace network density ratio
+- `risk_adjusted_synergy` — PV of risk-adjusted M&A synergies
+- `intrinsic_option_value` — intrinsic value of equity options
+- `probability_weighted_employee_value` — employee option value across scenarios
+- `vesting_adjusted_value` — option value adjusted for vesting schedule
+- `cash_equity_breakeven` — salary vs equity tradeoff analysis
+- `max_asset_based_loan` — collateral-based maximum loan calculation
+- `safe_conversion_cap` — SAFE conversion with valuation cap
+- `safe_expected_value` — expected SAFE value across cap/discount
+- `nvt_ratio` — Network Value to Transactions ratio for crypto
+- `esg_premium_valuation` — ESG premium impact on valuation
+- `esg_discount_valuation` — ESG risk discount on valuation
+- `data_moat_value` — DCF of data competitive advantage
+- `remote_first_premium` — remote-first company valuation premium
+- 19 new MCP server tools for all new functions
+- Per-module test files (14 files, one per module)
+- GitHub Pages documentation site (MkDocs Material)
+- `CITATION.cff` for academic referencing
+- mypy type checking in CI
+
+### Changed
+- Split monolithic test files into per-module test files
+- Expanded test suite from 50 to 101 tests
+- Bumped to production-stable release
+
+## [0.1.0] — 2026-05-19
+
+### Added
+- Initial release: 80+ valuation formulas across 14 modules
+- MCP server with 40+ tools
+- 5 AI-Agent Skills
+- 50 unit tests against textbook example values
+- GitHub Actions CI workflow

startup_valuation-1.0.0/CITATION.cff

@@ -0,0 +1,30 @@
+cff-version: "1.2.0"
+message: "If you use this software, please cite it as below."
+title: "Startup Valuation Engine"
+version: "0.2.0"
+authors:
+  - family-names: "Mak"
+    given-names: "Simon"
+    orcid: "https://orcid.org/0000-0000-0000-0000"
+abstract: >
+  A comprehensive Python library implementing 80+ startup valuation formulas
+  from the Startup Valuation textbook. Includes an MCP server for AI agents
+  and AI-Agent Skills for workflow guidance. Covers probability theory, time
+  value of money, CAPM, Scorecard, Berkus, VC Method, Black-Scholes, Monte
+  Carlo, SaaS metrics, biotech rNPV, fintech, marketplace, hardware,
+  international valuation, stakeholder analysis, and emerging topics.
+keywords:
+  - startup valuation
+  - venture capital
+  - financial modeling
+  - Black-Scholes
+  - Monte Carlo
+  - MCP server
+  - AI agents
+  - SaaS metrics
+  - biotech valuation
+  - fintech
+repository-code: "https://github.com/simonplmak-cloud/startup-valuation"
+license: MIT
+type: software
+date-released: "2026-05-20"

startup_valuation-1.0.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: startup-valuation
+Version: 1.0.0
+Summary: Comprehensive startup valuation library implementing 80+ formulas from the Startup Valuation textbook. Includes Python library, MCP server, and AI-Agent Skills.
+Project-URL: Homepage, https://github.com/simonplmak-cloud/startup-valuation
+Project-URL: Documentation, https://simonplmak-cloud.github.io/startup-valuation
+Project-URL: Repository, https://github.com/simonplmak-cloud/startup-valuation
+Project-URL: Bug Tracker, https://github.com/simonplmak-cloud/startup-valuation/issues
+Author: Simon Mak
+License-Expression: MIT
+Keywords: ai-agent,finance,mcp,startup,valuation,vc
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: scipy>=1.10.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.5.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
+Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=0.1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# Startup Valuation Engine
+
+> Comprehensive startup valuation library implementing **80+ formulas** from the Startup Valuation textbook. Python library + MCP server + AI-Agent Skills.
+
+[![CI](https://github.com/simonplmak-cloud/startup-valuation/actions/workflows/ci.yml/badge.svg)](https://github.com/simonplmak-cloud/startup-valuation/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Docs](https://img.shields.io/badge/docs-GitHub_Pages-blue)](https://simonplmak-cloud.github.io/startup-valuation/)
+
+## Overview
+
+A production-grade Python library for startup valuation, implementing every formula from the **Startup Valuation** textbook. Designed for developers, financial analysts, and AI agents who need auditable, structured valuation computations.
+
+**Three-layer architecture:**
+1. **Python Library** — 14 modules, 80+ typed functions, all returning `ValuationResult` (value + assumptions + sensitivity)
+2. **MCP Server** — 60+ tools for AI agents (Claude, OpenCode, etc.) via stdio/SSE
+3. **AI-Agent Skills** — 5 skill definitions with workflow guidance for valuation domains
+
+## Installation
+
+```bash
+pip install startup-valuation          # library only
+pip install startup-valuation[mcp]     # + MCP server
+pip install startup-valuation[dev]     # + pytest, ruff, coverage
+```
+
+## Quick Start
+
+### Python Library
+
+```python
+from startup_valuation.core import scorecard_valuation, vc_method_post_money
+from startup_valuation.advanced import black_scholes, scenario_analysis
+from startup_valuation.types import Scenario
+
+# Scorecard Method (pre-revenue startups)
+result = scorecard_valuation(
+    average_valuation=1_500_000,
+    weights=[0.30, 0.25, 0.15, 0.10, 0.10, 0.05, 0.05],
+    scores=[1.25, 1.50, 1.20, 0.75, 1.00, 0.90, 1.00],
+)
+print(f"Scorecard: ${result.value:,.0f}")  # $1,800,000
+
+# Black-Scholes for real options (startup equity)
+result = black_scholes(
+    underlying=20_000_000, strike=5_000_000,
+    risk_free_rate=0.05, volatility=0.40, time_to_maturity=1.0,
+)
+print(f"Option value: ${result.value:,.0f}")  # $15,240,000
+
+# Scenario Analysis
+scenarios = [
+    Scenario("bull", 0.20, 10_000_000),
+    Scenario("base", 0.60, 5_000_000),
+    Scenario("bear", 0.20, 1_000_000),
+]
+result = scenario_analysis(scenarios)
+print(f"Expected value: ${result.value:,.0f}")  # $5,200,000
+```
+
+### MCP Server (for AI Agents)
+
+```bash
+cd mcp_server && python server.py
+```
+
+Connect with any MCP-compatible AI agent. All 60+ valuation tools available.
+
+### AI-Agent Skills
+
+Copy the `skills/` directory to your agent's skills folder:
+- **`valuation-core`** — Scorecard, Berkus, VC Method, Risk Factor Summation
+- **`valuation-advanced`** — Black-Scholes, Binomial, Monte Carlo, Scenario Analysis
+- **`valuation-industry`** — SaaS, Biotech, Fintech, Marketplace, Hardware
+- **`valuation-stakeholder`** — Dilution, OPM, PWERM, Liquidation Preference
+- **`valuation-emerging`** — SAFE, Crypto (MV=PQ), ESG, Metcalfe's Law
+
+## Valuation Methods by Category
+
+| Category | Methods | Chapter |
+|----------|---------|---------|
+| **Probability** | Expected value, joint probability, Poisson | 2 |
+| **Time Value** | PV, NPV, annuity | 2 |
+| **CAPM** | CAPM, portfolio beta, startup-adjusted | 2 |
+| **Core** | Scorecard, Berkus, Risk Factor, VC Method | 3 |
+| **Advanced** | Black-Scholes, Binomial, Monte Carlo, Scenario | 4 |
+| **Comparables** | P/E, P/S, EV/EBITDA, regression-adjusted | 5 |
+| **SaaS** | LTV, CAC, NRR, Magic Number, Rule of 40 | 11 |
+| **Biotech** | rNPV, decision tree, peak sales, pipeline | 11 |
+| **Fintech** | Payment revenue, lending, neobank, network effects | 11 |
+| **Marketplace** | GMV, take rate, liquidity, network density | 11 |
+| **Hardware** | TRL-adjusted, break-even, P-weighted DCF | 11 |
+| **International** | PPP, CRP, currency-adjusted DCF, Damodaran | 12 |
+| **Stakeholders** | Dilution, OPM, PWERM, liquidation, synergies | 13 |
+| **Emerging** | SAFE, MV=PQ, ESG, Metcalfe's, data moat | 14 |
+
+## Why This Library?
+
+- **Auditable** — Every function returns `ValuationResult` with value, method, inputs, assumptions, and sensitivity analysis
+- **Textbook-accurate** — All formulas verified against book example values with unit tests
+- **AI-ready** — MCP server and Skills for seamless AI agent integration
+- **Industry-specific** — Dedicated modules for SaaS, biotech, fintech, marketplace, and hardware startups
+- **Open source** — MIT license, extensible, well-documented
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests (146 tests, ~6s)
+pytest
+
+# Run with coverage
+pytest --cov=startup_valuation --cov-report=term-missing
+
+# Lint
+ruff check .
+
+# Type check
+mypy src/startup_valuation
+```
+
+## Documentation
+
+- **API Reference:** [GitHub Pages](https://simonplmak-cloud.github.io/startup-valuation/)
+- **Chapter Index:** Maps every function to its textbook chapter
+- **Examples:** Interactive code snippets for each valuation category
+
+## Citing This Project
+
+```bibtex
+@software{startup_valuation_engine,
+  author = {Mak, Simon},
+  title = {Startup Valuation Engine},
+  year = {2026},
+  url = {https://github.com/simonplmak-cloud/startup-valuation},
+  license = {MIT},
+}
+```
+
+Based on formulas from the **Startup Valuation** textbook. See `output/` for the full textbook source in markdown.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

startup_valuation-1.0.0/README.md

@@ -0,0 +1,146 @@
+# Startup Valuation Engine
+
+> Comprehensive startup valuation library implementing **80+ formulas** from the Startup Valuation textbook. Python library + MCP server + AI-Agent Skills.
+
+[![CI](https://github.com/simonplmak-cloud/startup-valuation/actions/workflows/ci.yml/badge.svg)](https://github.com/simonplmak-cloud/startup-valuation/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Docs](https://img.shields.io/badge/docs-GitHub_Pages-blue)](https://simonplmak-cloud.github.io/startup-valuation/)
+
+## Overview
+
+A production-grade Python library for startup valuation, implementing every formula from the **Startup Valuation** textbook. Designed for developers, financial analysts, and AI agents who need auditable, structured valuation computations.
+
+**Three-layer architecture:**
+1. **Python Library** — 14 modules, 80+ typed functions, all returning `ValuationResult` (value + assumptions + sensitivity)
+2. **MCP Server** — 60+ tools for AI agents (Claude, OpenCode, etc.) via stdio/SSE
+3. **AI-Agent Skills** — 5 skill definitions with workflow guidance for valuation domains
+
+## Installation
+
+```bash
+pip install startup-valuation          # library only
+pip install startup-valuation[mcp]     # + MCP server
+pip install startup-valuation[dev]     # + pytest, ruff, coverage
+```
+
+## Quick Start
+
+### Python Library
+
+```python
+from startup_valuation.core import scorecard_valuation, vc_method_post_money
+from startup_valuation.advanced import black_scholes, scenario_analysis
+from startup_valuation.types import Scenario
+
+# Scorecard Method (pre-revenue startups)
+result = scorecard_valuation(
+    average_valuation=1_500_000,
+    weights=[0.30, 0.25, 0.15, 0.10, 0.10, 0.05, 0.05],
+    scores=[1.25, 1.50, 1.20, 0.75, 1.00, 0.90, 1.00],
+)
+print(f"Scorecard: ${result.value:,.0f}")  # $1,800,000
+
+# Black-Scholes for real options (startup equity)
+result = black_scholes(
+    underlying=20_000_000, strike=5_000_000,
+    risk_free_rate=0.05, volatility=0.40, time_to_maturity=1.0,
+)
+print(f"Option value: ${result.value:,.0f}")  # $15,240,000
+
+# Scenario Analysis
+scenarios = [
+    Scenario("bull", 0.20, 10_000_000),
+    Scenario("base", 0.60, 5_000_000),
+    Scenario("bear", 0.20, 1_000_000),
+]
+result = scenario_analysis(scenarios)
+print(f"Expected value: ${result.value:,.0f}")  # $5,200,000
+```
+
+### MCP Server (for AI Agents)
+
+```bash
+cd mcp_server && python server.py
+```
+
+Connect with any MCP-compatible AI agent. All 60+ valuation tools available.
+
+### AI-Agent Skills
+
+Copy the `skills/` directory to your agent's skills folder:
+- **`valuation-core`** — Scorecard, Berkus, VC Method, Risk Factor Summation
+- **`valuation-advanced`** — Black-Scholes, Binomial, Monte Carlo, Scenario Analysis
+- **`valuation-industry`** — SaaS, Biotech, Fintech, Marketplace, Hardware
+- **`valuation-stakeholder`** — Dilution, OPM, PWERM, Liquidation Preference
+- **`valuation-emerging`** — SAFE, Crypto (MV=PQ), ESG, Metcalfe's Law
+
+## Valuation Methods by Category
+
+| Category | Methods | Chapter |
+|----------|---------|---------|
+| **Probability** | Expected value, joint probability, Poisson | 2 |
+| **Time Value** | PV, NPV, annuity | 2 |
+| **CAPM** | CAPM, portfolio beta, startup-adjusted | 2 |
+| **Core** | Scorecard, Berkus, Risk Factor, VC Method | 3 |
+| **Advanced** | Black-Scholes, Binomial, Monte Carlo, Scenario | 4 |
+| **Comparables** | P/E, P/S, EV/EBITDA, regression-adjusted | 5 |
+| **SaaS** | LTV, CAC, NRR, Magic Number, Rule of 40 | 11 |
+| **Biotech** | rNPV, decision tree, peak sales, pipeline | 11 |
+| **Fintech** | Payment revenue, lending, neobank, network effects | 11 |
+| **Marketplace** | GMV, take rate, liquidity, network density | 11 |
+| **Hardware** | TRL-adjusted, break-even, P-weighted DCF | 11 |
+| **International** | PPP, CRP, currency-adjusted DCF, Damodaran | 12 |
+| **Stakeholders** | Dilution, OPM, PWERM, liquidation, synergies | 13 |
+| **Emerging** | SAFE, MV=PQ, ESG, Metcalfe's, data moat | 14 |
+
+## Why This Library?
+
+- **Auditable** — Every function returns `ValuationResult` with value, method, inputs, assumptions, and sensitivity analysis
+- **Textbook-accurate** — All formulas verified against book example values with unit tests
+- **AI-ready** — MCP server and Skills for seamless AI agent integration
+- **Industry-specific** — Dedicated modules for SaaS, biotech, fintech, marketplace, and hardware startups
+- **Open source** — MIT license, extensible, well-documented
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests (146 tests, ~6s)
+pytest
+
+# Run with coverage
+pytest --cov=startup_valuation --cov-report=term-missing
+
+# Lint
+ruff check .
+
+# Type check
+mypy src/startup_valuation
+```
+
+## Documentation
+
+- **API Reference:** [GitHub Pages](https://simonplmak-cloud.github.io/startup-valuation/)
+- **Chapter Index:** Maps every function to its textbook chapter
+- **Examples:** Interactive code snippets for each valuation category
+
+## Citing This Project
+
+```bibtex
+@software{startup_valuation_engine,
+  author = {Mak, Simon},
+  title = {Startup Valuation Engine},
+  year = {2026},
+  url = {https://github.com/simonplmak-cloud/startup-valuation},
+  license = {MIT},
+}
+```
+
+Based on formulas from the **Startup Valuation** textbook. See `output/` for the full textbook source in markdown.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.