glidepath 0.2.0__tar.gz

glidepath-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 williajm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

glidepath-0.2.0/LICENSE-DATA

@@ -0,0 +1,28 @@
+Data licence notice
+===================
+
+Everything in this repository is MIT-licensed (see LICENSE) EXCEPT the
+following bundled data file:
+
+    src/glidepath/regions/uk/data/returns_history.toml
+
+That file is a derived work of the JST Macrohistory Database
+(https://www.macrohistory.net/database/) — © Òscar Jordà, Moritz
+Schularick, Alan M. Taylor and co-authors — and is distributed under the
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+licence (CC BY-NC-SA 4.0):
+
+    https://creativecommons.org/licenses/by-nc-sa/4.0/
+
+In particular, the figures in that file may be used and redistributed
+only non-commercially, with attribution, and under the same licence
+terms. Cite Jordà, Schularick & Taylor (2017), "Macrofinancial History
+and the New Business Cycle Facts", and — for the return series — Jordà,
+Knoll, Kuvshinov, Schularick & Taylor (2019), "The Rate of Return on
+Everything, 1870-2015", The Quarterly Journal of Economics
+(https://doi.org/10.1093/qje/qjz012).
+
+The MIT licence grant does not extend to that file. To obtain a
+distribution free of CC BY-NC-SA material, delete the file and
+regenerate a replacement from a source of your choosing with
+scripts/build_returns_history.py as a starting point.

glidepath-0.2.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: glidepath
+Version: 0.2.0
+Summary: Desktop retirement and investment planner (UK-first, region-extensible).
+License-Expression: MIT AND CC-BY-NC-SA-4.0
+License-File: LICENSE
+License-File: LICENSE-DATA
+Requires-Dist: pyside6>=6.11.1
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="src/glidepath/gui/assets/wordmark.png" alt="glidepath" width="420">
+</p>
+
+[![CI](https://github.com/williajm/glidepath/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/williajm/glidepath/actions/workflows/ci.yml)
+[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=williajm_glidepath&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=williajm_glidepath)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=williajm_glidepath&metric=coverage)](https://sonarcloud.io/summary/new_code?id=williajm_glidepath)
+[![Python 3.14](https://img.shields.io/badge/python-3.14-blue)](https://github.com/williajm/glidepath/blob/main/.python-version)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![License: MIT](https://img.shields.io/github/license/williajm/glidepath)](LICENSE)
+
+<p align="center">
+  <a href="https://williajm.github.io/glidepath/"><b>williajm.github.io/glidepath</b></a>
+</p>
+
+A desktop retirement and investment planner. UK-first, built so other
+regions can be added later. Every number in a plan is a **fact** you
+stated, a **decision** you made, or an **assumption** the app defaulted
+— always inspectable, never silently guessed. All data stays local;
+nothing is transmitted.
+
+<p align="center">
+  <img src="docs/screenshots/charts.png"
+       alt="The charts tab: the Monte Carlo fan chart — nested percentile bands deepening toward the median line — beside the success-rate readout and the retirement-age and backtest cards"
+       width="800">
+</p>
+
+*(All screenshots show example data, not anyone's real finances.)*
+
+What it models today (single person, UK):
+
+- **Wrappers** — workplace DC, SIPP, S&S ISA, LISA, GIA and cash, with
+  UK contribution relief mechanics and dividend/savings taxation.
+- **Defined benefit pensions** — deferred entitlements or active
+  CARE-style accrual, with revaluation, early/late factors and
+  commutation; **state pension** from your official DWP forecast,
+  including deferral.
+- **Tax** — rUK and Scottish income tax from verified 2026/27 data
+  files; pension allowances (AA/taper/MPAA, lump-sum allowance).
+- **Projection** — deterministic or Monte Carlo runs from the app:
+  success rate, probability of ruin, ending-pot percentiles, and a
+  probability fan chart on its own tab, reproducible from a seed. With
+  a de-risking glide path, tax-aware decumulation with optional
+  go-go/slow-go/no-go retirement spending multipliers, and annuity
+  purchases entered in the facts form. (The engine also models
+  alternative withdrawal strategies — fixed %, guardrails, natural
+  yield — and tax-free-cash strategies; the app currently runs the
+  fixed-real defaults, with no strategy picker in the UI yet.)
+- **"When can I retire?"** — a solver for the earliest retirement age
+  that sustains a target income (a replacement rate you choose, 66% of
+  employment income by default), met deterministically or at a Monte
+  Carlo success target.
+- **Historical backtesting** — replays the plan over every rolling
+  window of world market history since 1900 (global equities in
+  sterling terms, UK gilts and cash, deflated by UK inflation):
+  the share of historical starting years the plan survives, the worst
+  starting year, and the range of outcomes as chart bands —
+  sequence-of-returns risk that independent Monte Carlo draws miss.
+- **Scenarios** — named what-ifs over your decisions and assumptions,
+  with a side-by-side comparison; plans saved as a local JSON file.
+
+## More screenshots
+
+Facts entry — everything on this screen is either a fact you state or
+a choice you make; anything estimated lives in the assumptions
+inspector instead:
+
+<p align="center">
+  <img src="docs/screenshots/facts.png"
+       alt="The facts tab: the About you, Household spending, and State pension cards of the entry form, with the example plan's values filled in"
+       width="800">
+</p>
+
+Stated vs assumed — the provenance view: the facts you stated, the
+choices in effect, and every assumption the run used with its value,
+default/overridden status, source, and date:
+
+<p align="center">
+  <img src="docs/screenshots/stated_vs_assumed.png"
+       alt="The stated-vs-assumed tab: tables of stated facts, choices in effect, assumptions used with sources, and the plan structure"
+       width="800">
+</p>
+
+## Disclaimer
+
+Glidepath is a personal modelling tool for exploring retirement scenarios.
+It is not financial advice and is not regulated; its outputs depend on
+assumptions that will not match reality. Do not make financial decisions
+based solely on this tool.
+
+## Run
+
+Requires only [uv](https://docs.astral.sh/uv/). Install the latest
+release [from PyPI](https://pypi.org/project/glidepath/) and launch it:
+
+```sh
+uv tool install glidepath
+glidepath
+```
+
+(`pipx install glidepath` works too. Glidepath is a desktop app
+distributed through PyPI, not a library — importing `glidepath`
+modules is not a supported API.)
+
+Or run straight from a checkout:
+
+```sh
+git clone https://github.com/williajm/glidepath.git
+cd glidepath
+uv run glidepath
+```
+
+The first run from a checkout creates a virtual environment and
+installs the locked dependencies automatically, then launches the
+desktop app. Accept the
+disclaimer and a fresh install
+opens with an example plan already projected, so every tab has
+something to show — replace its values with your own facts, or clear
+the form and start blank. Charts label each bar with the tax year and
+your age and switch between today's money and nominal; Help → "How to
+use glidepath" walks through every tab. Save your plan from the File
+menu as a `.glidepath.json` file you own, stored wherever you choose;
+the next launch reopens your last plan automatically.
+
+## Developing
+
+Development additionally requires GNU Make, which drives every workflow
+command:
+
+```sh
+make sync          # create the platform venv from the lockfile (fails if the lock has drifted)
+make hooks         # install the pre-commit hooks (required before committing)
+```
+
+One-time per machine: set `UV_PROJECT_ENVIRONMENT` user-wide (`.venv-win`
+on Windows, `.venv-wsl` in WSL) so bare `uv` commands and the git hooks use
+the same venv as make. See `CLAUDE.md`. (Skipping this only matters for a
+shared Windows/WSL checkout — for trying the app, uv's default `.venv` is
+fine.)
+
+## Everyday commands
+
+```sh
+make check   # all merge gates: ruff, format, mypy --strict, pytest (>=90% cov), dep age
+make fix     # auto-fix lint issues and reformat
+make test    # tests with coverage
+make deps    # the ONLY way to add/upgrade dependencies (7-day cooldown lock)
+make audit   # pip-audit the lockfile for known CVEs
+```
+
+Dependencies are never added with plain `uv add`/`uv lock`: run `make deps`
+so the 7-day supply-chain cooldown is applied. CI runs every `make check`
+gate plus `make audit` and the SonarCloud quality gate on each PR — so a
+clean `make check` locally does not quite guarantee a green pipeline. See
+`CLAUDE.md` for the full policies.
+
+## Releases
+
+Releases are `vX.Y.Z` tags on `main`; each GitHub Release carries its
+notes from [`CHANGELOG.md`](CHANGELOG.md). There are no packaged builds
+yet — run from source as above.
+
+## Data licences
+
+The code is MIT-licensed (see `LICENSE`). One data file is not: the
+historical return series
+(`src/glidepath/regions/uk/data/returns_history.toml`) is derived from
+the [JST Macrohistory Database](https://www.macrohistory.net/database/)
+(Jordà, Schularick & Taylor; return series per Jordà, Knoll, Kuvshinov,
+Schularick & Taylor 2019) and is distributed under
+[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) —
+attribution required, non-commercial use only, share-alike. The package
+metadata declares `MIT AND CC-BY-NC-SA-4.0` accordingly; `LICENSE-DATA`
+and the file's own header carry the full notice, and
+`scripts/build_returns_history.py` regenerates the file from the
+upstream dataset.

glidepath-0.2.0/README.md

@@ -0,0 +1,178 @@
+<p align="center">
+  <img src="src/glidepath/gui/assets/wordmark.png" alt="glidepath" width="420">
+</p>
+
+[![CI](https://github.com/williajm/glidepath/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/williajm/glidepath/actions/workflows/ci.yml)
+[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=williajm_glidepath&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=williajm_glidepath)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=williajm_glidepath&metric=coverage)](https://sonarcloud.io/summary/new_code?id=williajm_glidepath)
+[![Python 3.14](https://img.shields.io/badge/python-3.14-blue)](https://github.com/williajm/glidepath/blob/main/.python-version)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![License: MIT](https://img.shields.io/github/license/williajm/glidepath)](LICENSE)
+
+<p align="center">
+  <a href="https://williajm.github.io/glidepath/"><b>williajm.github.io/glidepath</b></a>
+</p>
+
+A desktop retirement and investment planner. UK-first, built so other
+regions can be added later. Every number in a plan is a **fact** you
+stated, a **decision** you made, or an **assumption** the app defaulted
+— always inspectable, never silently guessed. All data stays local;
+nothing is transmitted.
+
+<p align="center">
+  <img src="docs/screenshots/charts.png"
+       alt="The charts tab: the Monte Carlo fan chart — nested percentile bands deepening toward the median line — beside the success-rate readout and the retirement-age and backtest cards"
+       width="800">
+</p>
+
+*(All screenshots show example data, not anyone's real finances.)*
+
+What it models today (single person, UK):
+
+- **Wrappers** — workplace DC, SIPP, S&S ISA, LISA, GIA and cash, with
+  UK contribution relief mechanics and dividend/savings taxation.
+- **Defined benefit pensions** — deferred entitlements or active
+  CARE-style accrual, with revaluation, early/late factors and
+  commutation; **state pension** from your official DWP forecast,
+  including deferral.
+- **Tax** — rUK and Scottish income tax from verified 2026/27 data
+  files; pension allowances (AA/taper/MPAA, lump-sum allowance).
+- **Projection** — deterministic or Monte Carlo runs from the app:
+  success rate, probability of ruin, ending-pot percentiles, and a
+  probability fan chart on its own tab, reproducible from a seed. With
+  a de-risking glide path, tax-aware decumulation with optional
+  go-go/slow-go/no-go retirement spending multipliers, and annuity
+  purchases entered in the facts form. (The engine also models
+  alternative withdrawal strategies — fixed %, guardrails, natural
+  yield — and tax-free-cash strategies; the app currently runs the
+  fixed-real defaults, with no strategy picker in the UI yet.)
+- **"When can I retire?"** — a solver for the earliest retirement age
+  that sustains a target income (a replacement rate you choose, 66% of
+  employment income by default), met deterministically or at a Monte
+  Carlo success target.
+- **Historical backtesting** — replays the plan over every rolling
+  window of world market history since 1900 (global equities in
+  sterling terms, UK gilts and cash, deflated by UK inflation):
+  the share of historical starting years the plan survives, the worst
+  starting year, and the range of outcomes as chart bands —
+  sequence-of-returns risk that independent Monte Carlo draws miss.
+- **Scenarios** — named what-ifs over your decisions and assumptions,
+  with a side-by-side comparison; plans saved as a local JSON file.
+
+## More screenshots
+
+Facts entry — everything on this screen is either a fact you state or
+a choice you make; anything estimated lives in the assumptions
+inspector instead:
+
+<p align="center">
+  <img src="docs/screenshots/facts.png"
+       alt="The facts tab: the About you, Household spending, and State pension cards of the entry form, with the example plan's values filled in"
+       width="800">
+</p>
+
+Stated vs assumed — the provenance view: the facts you stated, the
+choices in effect, and every assumption the run used with its value,
+default/overridden status, source, and date:
+
+<p align="center">
+  <img src="docs/screenshots/stated_vs_assumed.png"
+       alt="The stated-vs-assumed tab: tables of stated facts, choices in effect, assumptions used with sources, and the plan structure"
+       width="800">
+</p>
+
+## Disclaimer
+
+Glidepath is a personal modelling tool for exploring retirement scenarios.
+It is not financial advice and is not regulated; its outputs depend on
+assumptions that will not match reality. Do not make financial decisions
+based solely on this tool.
+
+## Run
+
+Requires only [uv](https://docs.astral.sh/uv/). Install the latest
+release [from PyPI](https://pypi.org/project/glidepath/) and launch it:
+
+```sh
+uv tool install glidepath
+glidepath
+```
+
+(`pipx install glidepath` works too. Glidepath is a desktop app
+distributed through PyPI, not a library — importing `glidepath`
+modules is not a supported API.)
+
+Or run straight from a checkout:
+
+```sh
+git clone https://github.com/williajm/glidepath.git
+cd glidepath
+uv run glidepath
+```
+
+The first run from a checkout creates a virtual environment and
+installs the locked dependencies automatically, then launches the
+desktop app. Accept the
+disclaimer and a fresh install
+opens with an example plan already projected, so every tab has
+something to show — replace its values with your own facts, or clear
+the form and start blank. Charts label each bar with the tax year and
+your age and switch between today's money and nominal; Help → "How to
+use glidepath" walks through every tab. Save your plan from the File
+menu as a `.glidepath.json` file you own, stored wherever you choose;
+the next launch reopens your last plan automatically.
+
+## Developing
+
+Development additionally requires GNU Make, which drives every workflow
+command:
+
+```sh
+make sync          # create the platform venv from the lockfile (fails if the lock has drifted)
+make hooks         # install the pre-commit hooks (required before committing)
+```
+
+One-time per machine: set `UV_PROJECT_ENVIRONMENT` user-wide (`.venv-win`
+on Windows, `.venv-wsl` in WSL) so bare `uv` commands and the git hooks use
+the same venv as make. See `CLAUDE.md`. (Skipping this only matters for a
+shared Windows/WSL checkout — for trying the app, uv's default `.venv` is
+fine.)
+
+## Everyday commands
+
+```sh
+make check   # all merge gates: ruff, format, mypy --strict, pytest (>=90% cov), dep age
+make fix     # auto-fix lint issues and reformat
+make test    # tests with coverage
+make deps    # the ONLY way to add/upgrade dependencies (7-day cooldown lock)
+make audit   # pip-audit the lockfile for known CVEs
+```
+
+Dependencies are never added with plain `uv add`/`uv lock`: run `make deps`
+so the 7-day supply-chain cooldown is applied. CI runs every `make check`
+gate plus `make audit` and the SonarCloud quality gate on each PR — so a
+clean `make check` locally does not quite guarantee a green pipeline. See
+`CLAUDE.md` for the full policies.
+
+## Releases
+
+Releases are `vX.Y.Z` tags on `main`; each GitHub Release carries its
+notes from [`CHANGELOG.md`](CHANGELOG.md). There are no packaged builds
+yet — run from source as above.
+
+## Data licences
+
+The code is MIT-licensed (see `LICENSE`). One data file is not: the
+historical return series
+(`src/glidepath/regions/uk/data/returns_history.toml`) is derived from
+the [JST Macrohistory Database](https://www.macrohistory.net/database/)
+(Jordà, Schularick & Taylor; return series per Jordà, Knoll, Kuvshinov,
+Schularick & Taylor 2019) and is distributed under
+[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) —
+attribution required, non-commercial use only, share-alike. The package
+metadata declares `MIT AND CC-BY-NC-SA-4.0` accordingly; `LICENSE-DATA`
+and the file's own header carry the full notice, and
+`scripts/build_returns_history.py` regenerates the file from the
+upstream dataset.

glidepath-0.2.0/pyproject.toml

@@ -0,0 +1,153 @@
+[project]
+name = "glidepath"
+version = "0.2.0"
+description = "Desktop retirement and investment planner (UK-first, region-extensible)."
+readme = "README.md"
+# MIT code plus one CC BY-NC-SA 4.0 data file (returns_history.toml —
+# scope and attribution in LICENSE-DATA).
+license = "MIT AND CC-BY-NC-SA-4.0"
+license-files = ["LICENSE", "LICENSE-DATA"]
+requires-python = ">=3.14"
+dependencies = [
+    "pyside6>=6.11.1",
+]
+
+[project.gui-scripts]
+glidepath = "glidepath.gui.main:main"
+
+[dependency-groups]
+dev = [
+    "hypothesis",
+    "mypy",
+    "pip-audit",
+    "pre-commit",
+    "pytest",
+    "pytest-cov",
+    "pytest-timeout",
+    "ruff",
+]
+
+[build-system]
+requires = ["uv_build>=0.11,<0.13"]
+build-backend = "uv_build"
+
+# --- uv ---------------------------------------------------------------------
+[tool.uv]
+# Supply-chain cooldown: resolution ignores anything published to PyPI after
+# this timestamp (now minus 7 days). Updated ONLY by `make deps`.
+exclude-newer = "2026-07-30T09:40:45Z"
+
+# PyPI is the ONLY permitted index (supply-chain policy; see CLAUDE.md).
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple"
+default = true
+
+# --- ruff -------------------------------------------------------------------
+[tool.ruff]
+src = ["src", "tests", "scripts"]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "COM812", # Redundant with (and conflicts with) the ruff formatter.
+    "ISC001", # Redundant with (and conflicts with) the ruff formatter.
+    "CPY001", # No per-file copyright headers; repository-level licensing applies.
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.lint.per-file-ignores]
+"src/glidepath/core/randomness.py" = [
+    "S311", # Seeded Monte Carlo simulation draws, never security material (planning §4.6).
+]
+"src/glidepath/core/montecarlo.py" = [
+    "PLR0913", # run_paths/sustainable_income take the §5.2 engine quartet plus keyword-only run knobs; bundling would obscure the run(plan, assumptions, region, config) shape.
+]
+"src/glidepath/core/backtest.py" = [
+    "PLR0913", # run_windows and its chunk worker mirror the §5.2 runner signature (see core/montecarlo.py).
+]
+"scripts/build_returns_history.py" = [
+    "S314", # xml.etree parses the JST workbook the developer supplies locally, never untrusted input.
+]
+"src/glidepath/core/retirement.py" = [
+    "PLR0913", # earliest_retirement_age mirrors the §5.2 runner signature (see core/montecarlo.py).
+]
+"src/glidepath/app/montecarlo.py" = [
+    "BLE001", # The slow-run transition must fold ANY failure into state (§4.7): an exception escaping past the shell's worker thread holds the in-flight guard forever.
+]
+"src/glidepath/app/retirement.py" = [
+    "BLE001", # Same in-flight-guard rationale as app/montecarlo.py.
+]
+"src/glidepath/app/drawdown.py" = [
+    "BLE001", # Same in-flight-guard rationale as app/montecarlo.py.
+]
+"src/glidepath/app/backtest.py" = [
+    "BLE001", # Same in-flight-guard rationale as app/montecarlo.py.
+]
+"tests/**" = [
+    "S101",    # pytest tests use bare assert by design.
+    "PLR2004", # Literal expected values in assertions are idiomatic in tests.
+    "INP001",  # tests/ is intentionally not a package (pytest src-layout).
+    "PLR0913", # Test-data factories take many optional keyword knobs by design.
+]
+"scripts/**" = [
+    "T201",   # Standalone CLI scripts report via print.
+    "INP001", # scripts/ is intentionally not a package.
+]
+
+# --- mypy -------------------------------------------------------------------
+[tool.mypy]
+strict = true
+warn_unused_ignores = true
+python_version = "3.14"
+files = ["src", "tests", "scripts"]
+# Lets the tests' top-level script imports (e.g. `import check_dep_age`)
+# resolve to scripts/ — mirrors pytest's pythonpath below.
+mypy_path = ["scripts"]
+
+# --- pytest / coverage ------------------------------------------------------
+[tool.pytest.ini_options]
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--cov=glidepath",
+    "--cov=scripts",
+    "--cov-report=term-missing",
+    "--cov-report=xml",
+]
+testpaths = ["tests"]
+# scripts/ is not a package; tests import the operational scripts (the
+# gates behind `make deps`/`make bump`/releases) as top-level modules.
+pythonpath = ["scripts"]
+# Fail a stuck test fast instead of hanging CI for the runner limit: the
+# GUI suite waits on worker pools for up to 60s, so the ceiling sits
+# safely above that while still cutting a wedged run short.
+timeout = 120
+markers = [
+    "gui: exercises the PySide6 shell on the offscreen Qt platform",
+    "slow: long-running engine sweeps (Monte Carlo, backtest, solvers); deselect with -m 'not slow'",
+]
+
+[tool.coverage.run]
+branch = true
+# The Monte Carlo performance harness is a manual measurement tool
+# (planning §4.6), run by hand and read by a human — the only scripts/
+# entry outside the coverage gate.
+omit = ["scripts/measure_mc_performance.py"]
+
+[tool.coverage.report]
+# The suite sits at ~98%; a floor close behind it means an entire module
+# losing its tests fails CI instead of coasting on the old 90% margin.
+fail_under = 96
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    # Script entry-point guards: the tests call main() directly.
+    'if __name__ == "__main__":',
+]

glidepath-0.2.0/src/glidepath/__init__.py

@@ -0,0 +1,3 @@
+"""glidepath: a desktop retirement and investment planner (UK-first)."""
+
+__version__ = "0.1.0"