Fix heston calibration (#45)

Author: lsbardel

.github/copilot-instructions.md

@@ -30,8 +30,14 @@ applyTo: '/**'
 * Do not use em dashes (—) in documentation files or docstrings. Use colons, parentheses, or restructure the sentence instead.
 * Math in documentation and docstrings: always use `\begin{equation}...\end{equation}` for any formula or equation. Use `$...$` only for brief inline references to variables (e.g. $F$, $K$). Do not use `$$...$$`, `` `...` ``, or RST syntax (`.. math::`, `:math:`).
 * Glossary entries in `docs/glossary.md` must be kept in alphabetical order.
+* Do not repeat concept definitions inline in tutorials or docstrings — link to the glossary instead using a relative markdown link (e.g. `[moneyness](../glossary.md#moneyness)`).
 * To rebuild doc examples run `uv run ./dev/build-examples` — runs all scripts in `docs/examples/` and writes their output to `docs/examples_output/`
 
+## Pydantic models
+
+* Always document Pydantic fields with `Field(description=...)` — never use a docstring below a field assignment
+* Split long description strings across lines using implicit string concatenation rather than shortening the text
+
 ## Package structure
 
 * Strategy runtime markdown descriptions (read by `load_description()` at runtime) live inside the package at `quantflow/options/strategies/docs/` — they must be inside the package to be accessible when the library is installed

.github/instructions/makefile.instructions.md

@@ -0,0 +1,5 @@
+# Makefile Conventions
+
+- Keep all targets sorted alphabetically.
+- targets should be separated by a one blank line only.
+- Each target should have a one-line description, starting with `##`, that describes what the target does. This description is used by the `help` target to generate documentation for all targets.

.github/workflows/build.yml

@@ -23,6 +23,8 @@ jobs:
       - uses: actions/checkout@v4
       - name: install rops
         uses: quantmind/rops/.github/actions/setup-rops@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.TOKEN_DEPLOYMENT }}
       - name: install taplo
         run: rops tools update taplo
       - name: Set up Python ${{ matrix.python-version }}

.github/workflows/docker-multiarch.yml

@@ -23,6 +23,8 @@ jobs:
           password: ${{ github.token }}
       - name: install rops
         uses: quantmind/rops/.github/actions/setup-rops@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.TOKEN_DEPLOYMENT }}
       - name: build amd64
         run: rops docker build ${{ inputs.image-name }}
       - name: push amd64
@@ -44,6 +46,8 @@ jobs:
           password: ${{ github.token }}
       - name: install rops
         uses: quantmind/rops/.github/actions/setup-rops@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.TOKEN_DEPLOYMENT }}
       - name: build arm64
         run: rops docker build ${{ inputs.image-name }}
       - name: push arm64
@@ -64,5 +68,7 @@ jobs:
           password: ${{ github.token }}
       - name: install rops
         uses: quantmind/rops/.github/actions/setup-rops@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.TOKEN_DEPLOYMENT }}
       - name: create manifest
         run: rops docker manifest ${{ inputs.image-name }}

CLAUDE.md

@@ -1,2 +1,3 @@
 @readme.md
 @.github/copilot-instructions.md
+@.github/instructions/makefile.instructions.md

Makefile

@@ -5,38 +5,39 @@ help:
 	@fgrep -h "##" $(MAKEFILE_LIST) | fgrep -v fgrep | sed -e 's/\\$$//' | sed -e 's/##//'
 	@echo ================================================================================
 
+.PHONY: docs
+docs:				## build documentation
+	@cp docs/index.md readme.md
+	@uv run ./dev/build-examples
+	@uv run mkdocs build
+
+.PHONY: docs-examples
+docs-examples:			## Regenerate docs examples
+	@uv run ./dev/build-examples
+
+.PHONY: docs-serve
+docs-serve:			## serve documentation
+	@uv run mkdocs serve --livereload --watch quantflow --watch docs
+
+.PHONY: install-dev
+install-dev:			## Install development dependencies
+	@./dev/install
 
 .PHONY: lint
 lint:				## Lint and fix
 	@uv run ./dev/lint fix
 
-
 .PHONY: lint-check
 lint-check:			## Lint check only
 	@uv run ./dev/lint
 
-
-.PHONY: install-dev
-install-dev:			## Install development dependencies
-	@./dev/install
-
 .PHONY: marimo
 marimo:				## Run marimo for editing notebooks
 	@./dev/marimo edit
 
-.PHONY: docs-png
-docs-png:			## Regenerate PNG assets in docs/assets/ (requires Chrome via kaleido)
-	@for f in docs/examples_png/*.py; do uv run python $$f; done
-
-.PHONY: docs
-docs:				## build documentation
-	@cp docs/index.md readme.md
-	@uv run ./dev/build-examples
-	@uv run mkdocs build
-
-.PHONY: docs-serve
-docs-serve:			## serve documentation
-	@uv run mkdocs serve --livereload --watch quantflow --watch docs
+.PHONY: outdated
+outdated:			## Show outdated packages
+	uv tree --outdated
 
 .PHONY: publish
 publish:			## Release to pypi
@@ -47,11 +48,6 @@ publish:			## Release to pypi
 tests:				## Unit tests
 	@./dev/test
 
-
-.PHONY: outdated
-outdated:			## Show outdated packages
-	uv tree --outdated
-
 .PHONY: upgrade
 upgrade:			## Upgrade dependencies
 	uv lock --upgrade

dev/build-examples

@@ -1,28 +1,10 @@
 #!/usr/bin/env python
 """Run all example scripts in docs/examples/ and capture their stdout to .out files."""
-import subprocess
 import sys
-from pathlib import Path
 
-out_dir = Path("docs/examples_output")
-out_dir.mkdir(exist_ok=True)
+from docs.examples._utils import build_examples
 
-examples = sorted(Path("docs/examples").glob("*.py"))
-failed = []
-
-for script in examples:
-    out_file = out_dir / script.with_suffix(".out").name
-    print(f"running {script} -> {out_file}")
-    result = subprocess.run(
-        [sys.executable, str(script)],
-        capture_output=True,
-        text=True,
-    )
-    if result.returncode != 0:
-        print(f"FAILED: {script}\n{result.stderr}", file=sys.stderr)
-        failed.append(script)
-    else:
-        out_file.write_text(result.stdout)
+failed = build_examples()
 
 if failed:
     sys.exit(1)

dev/lint

@@ -5,6 +5,7 @@ ISORT_ARGS="-c"
 BLACK_ARG="--check"
 RUFF_ARG=""
 TAPLO_ARG="format --check"
+PACKAGES="quantflow quantflow_tests docs/examples"
 
 if [ "$1" = "fix" ] ; then
     ISORT_ARGS=""
@@ -15,12 +16,10 @@ fi
 
 taplo ${TAPLO_ARG}
 echo isort
-uv run isort quantflow quantflow_tests ${ISORT_ARGS}
+uv run isort ${PACKAGES} ${ISORT_ARGS}
 echo black
-uv run black quantflow quantflow_tests ${BLACK_ARG}
+uv run black ${PACKAGES} ${BLACK_ARG}
 echo ruff
-uv run ruff check quantflow quantflow_tests ${RUFF_ARG}
+uv run ruff check ${PACKAGES} ${RUFF_ARG}
 echo mypy
-uv run mypy quantflow
-echo mypy tests
-uv run mypy quantflow_tests --explicit-package-bases
+uv run mypy ${PACKAGES}

docs/__init__.py

@@ -1,5 +1,9 @@
 # Vol Model Calibration
 
+::: quantflow.options.calibration.OptionEntry
+
 ::: quantflow.options.calibration.VolModelCalibration
 
-::: quantflow.options.calibration.HestonCalibration
+::: quantflow.options.heston_calibration.HestonCalibration
+
+::: quantflow.options.heston_calibration.HestonJCalibration