timegym 1.1.0__tar.gz

timegym-1.1.0/.dockerignore

@@ -0,0 +1,12 @@
+.git
+.venv
+__pycache__
+**/__pycache__
+.pytest_cache
+.ipynb_checkpoints
+**/.ipynb_checkpoints
+dist
+build
+site
+paper/build
+.DS_Store

timegym-1.1.0/.github/workflows/checks.yml

@@ -0,0 +1,171 @@
+name: checks
+on:
+  push:
+    branches: ['**']
+  pull_request:
+  workflow_call:
+    inputs:
+      ref:
+        type: string
+        required: false
+permissions:
+  contents: read
+concurrency:
+  group: checks-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+env:
+  MPLBACKEND: Agg
+  OPENBLAS_NUM_THREADS: '1'
+  OMP_NUM_THREADS: '1'
+jobs:
+  source:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.15' # current-python
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install -e '.[dev]'
+      - run: python tools/export_notebooks.py --check
+      - run: python paper/build_standalone.py --check
+      - run: python tools/sync_citation.py --check
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13', '3.14', '3.15']
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install -e '.[dev]'
+      - run: python -m pytest
+      - run: python examples/quickstart.py
+  compatibility:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install -e '.[dev]' 'numpy==1.26.4' 'pandas==2.2.3' 'scipy==1.11.4' 'scikit-learn==1.4.2' 'matplotlib==3.8.4'
+      - run: python -m pytest
+  installed-wheel:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install build 'twine>=6,<7'
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - run: python -c "import glob, subprocess, sys; subprocess.check_call([sys.executable, '-m', 'pip', 'install', glob.glob('dist/*.whl')[0]])"
+      - run: python -I tools/smoke_installed.py --report wheel-report.json
+      - run: python -I examples/reproduce_report.py wheel-report.json --require-same-environment
+      - uses: actions/upload-artifact@v4
+        with:
+          name: distribution-${{ matrix.os }}
+          path: dist/*
+  documentation:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.15' # current-python
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install -e '.[docs]' pytest
+      - run: python -m pytest -q tests/test_docs_hooks.py tests/test_docs_navigation.py
+      - run: python -m mkdocs build --strict
+      - run: python tools/check_site_links.py site
+  research-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install -r requirements-study.txt
+      - run: python -m pip install --no-build-isolation --no-deps -e .
+      - run: python -m experiments.run_study --output /tmp/timegym-study
+      - run: python -m experiments.run_supplement --output /tmp/timegym-supplement
+      - name: Compare numerical records with frozen hashes
+        run: |
+          python -m experiments.compare_results --results /tmp/timegym-study/results.json --manifest experiments/results/manifest.json --report /tmp/timegym-pilot-hash.json --warn
+          python -m experiments.compare_results --results /tmp/timegym-supplement/results.json --manifest experiments/results-v2/manifest.json --report /tmp/timegym-supplement-hash.json --warn
+      - uses: actions/upload-artifact@v4
+        with:
+          name: research-linux-hashes
+          path: /tmp/timegym-*-hash.json
+
+  notebooks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.15' # current-python
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-study.txt
+      - run: python -m pip install -e '.[notebooks]'
+      - run: python notebooks/check_notebooks.py
+  paper:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref || github.sha }}
+      - name: Install LaTeX
+        # cm-super supplies Type 1 T1 fonts; without it Metafont bitmap fonts fail to build.
+        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends latexmk texlive-latex-recommended texlive-pictures texlive-fonts-recommended cm-super
+      - name: Compile standalone manuscript
+        working-directory: paper
+        run: latexmk -pdf -interaction=nonstopmode -halt-on-error -outdir=build timegym.tex
+      - uses: actions/upload-artifact@v4
+        with:
+          name: paper-pdf
+          path: paper/build/timegym.pdf

timegym-1.1.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,45 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+

timegym-1.1.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr *)'
+

timegym-1.1.0/.github/workflows/compatibility-release.yml

@@ -0,0 +1,47 @@
+name: Release merged Python compatibility update
+on:
+  pull_request:
+    types: [closed]
+permissions:
+  contents: read
+jobs:
+  checks:
+    if: >-
+      github.event.pull_request.merged == true &&
+      github.event.pull_request.head.repo.full_name == github.repository &&
+      github.event.pull_request.base.ref == github.event.repository.default_branch &&
+      github.event.pull_request.head.ref == 'automation/python-compatibility' &&
+      contains(github.event.pull_request.labels.*.name, 'python-compatibility')
+    uses: ./.github/workflows/checks.yml
+    with:
+      ref: ${{ github.event.pull_request.merge_commit_sha }}
+  tag:
+    needs: checks
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.merge_commit_sha }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.15' # current-python
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: python -m pip install -e '.[release]'
+      - name: Validate and tag the new package version
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_SHA: ${{ github.event.pull_request.merge_commit_sha }}
+        run: |
+          version=$(python -c 'from timegym import __version__; print(__version__)')
+          tag="v$version"
+          python tools/sync_citation.py --check --tag "$tag"
+          if gh api "repos/$GITHUB_REPOSITORY/git/ref/tags/$tag" >/dev/null 2>&1; then
+            echo "Tag $tag already exists; no publication requested."
+            exit 0
+          fi
+          gh api "repos/$GITHUB_REPOSITORY/git/refs" -f "ref=refs/tags/$tag" -f "sha=$RELEASE_SHA"
+          gh workflow run release.yml --ref "$tag"

timegym-1.1.0/.github/workflows/pages.yml

@@ -0,0 +1,37 @@
+name: docs site
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+concurrency:
+  group: pages
+  cancel-in-progress: false
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: python -m pip install -e '.[docs]'
+      - run: python -m mkdocs build --strict
+      - run: python tools/check_site_links.py site
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

timegym-1.1.0/.github/workflows/python-compatibility.yml

@@ -0,0 +1,64 @@
+name: Python compatibility proposal
+on:
+  schedule:
+    - cron: '23 7 * * 1'
+  workflow_dispatch:
+permissions:
+  contents: write
+  pull-requests: write
+concurrency:
+  group: python-compatibility-proposal
+  cancel-in-progress: false
+jobs:
+  propose:
+    runs-on: ubuntu-latest
+    env:
+      MPLBACKEND: Agg
+      OPENBLAS_NUM_THREADS: '1'
+      OMP_NUM_THREADS: '1'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.15' # current-python
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: python -m pip install packaging
+      - id: support
+        run: python tools/update_python_support.py --apply --github-output "$GITHUB_OUTPUT"
+      - uses: actions/setup-python@v5
+        if: steps.support.outputs.changed == 'true'
+        with:
+          python-version: ${{ steps.support.outputs.latest }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - if: steps.support.outputs.changed == 'true'
+        run: |
+          python -m pip install -e '.[dev,docs,release,notebooks]'
+          python tools/export_notebooks.py
+          python -m pip install --no-deps -e .
+          python tools/sync_citation.py
+          python paper/build_standalone.py
+          python tools/export_notebooks.py --check
+          python tools/sync_citation.py --check
+          python paper/build_standalone.py --check
+          python -m pytest -q
+          python notebooks/check_notebooks.py
+          python examples/quickstart.py
+          python -m mkdocs build --strict
+          python -m build
+          python -m twine check dist/*
+          docker build -t timegym-compatibility .
+          docker run --rm timegym-compatibility
+      - uses: peter-evans/create-pull-request@v7
+        if: steps.support.outputs.changed == 'true'
+        with:
+          branch: automation/python-compatibility
+          title: Update Python support following pandas
+          commit-message: Update Python support following pandas
+          labels: python-compatibility
+          body: |
+            Update the supported CPython range after a stable Python release and pandas wheel support.
+            Synchronizes classifiers, requires-python, CI, Docker and documentation; increments the fix counter.
+            The proposal passed tests, notebooks, export/citation checks, strict docs, distributions and the development image on the newest Python.
+            Merging runs the complete check matrix, then tags and dispatches the release when this version is unpublished.

timegym-1.1.0/.github/workflows/release.yml

@@ -0,0 +1,89 @@
+name: release
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+jobs:
+  checks:
+    if: startsWith(github.ref, 'refs/tags/v')
+    uses: ./.github/workflows/checks.yml
+  build:
+    needs: checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.15' # current-python
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: python -m pip install -e '.[release]'
+      - run: python tools/sync_citation.py --check --tag "$RELEASE_TAG"
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - run: python paper/build_standalone.py
+      - name: Install LaTeX
+        # cm-super supplies Type 1 T1 fonts; without it Metafont bitmap fonts fail to build.
+        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends latexmk texlive-latex-recommended texlive-pictures texlive-fonts-recommended cm-super
+      - name: Compile standalone manuscript
+        working-directory: paper
+        run: latexmk -pdf -interaction=nonstopmode -halt-on-error -outdir=build timegym.tex
+      - uses: actions/upload-artifact@v4
+        with:
+          name: release-distributions
+          path: dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: release-paper
+          path: |
+            paper/build/timegym.pdf
+            paper/timegym.tex
+  pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/timegym
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: release-distributions
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+  github-release:
+    needs: [build, pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: release-distributions
+          path: dist
+      - uses: actions/download-artifact@v4
+        with:
+          name: release-paper
+          path: paper-artifacts
+      - name: Publish versioned code and manuscript
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          if ! gh release view "$RELEASE_TAG" >/dev/null 2>&1; then
+            gh release create "$RELEASE_TAG" --verify-tag --draft --title "TimeGym $RELEASE_TAG" --generate-notes
+          fi
+          find paper-artifacts -type f -exec gh release upload "$RELEASE_TAG" --clobber {} +
+          gh release upload "$RELEASE_TAG" --clobber dist/*
+          gh release edit "$RELEASE_TAG" --draft=false

timegym-1.1.0/AGENTS.md

@@ -0,0 +1,62 @@
+# Repository guidance
+
+TimeGym is notebook-first. Every Python file under `timegym/` is generated from
+marked implementation cells owned by `notebooks/source-map.json`. Edit the
+owning notebook, preserve cell IDs and `metadata.timegym.role`, save it, then
+run `.venv/bin/python tools/export_notebooks.py` and its `--check` mode. Never
+edit generated modules by hand. Read `tools/README.md` and `notebooks/README.md`
+before changing library code. Paper result fragments and `paper/timegym.tex`
+are generated too; edit their inputs and run their builders.
+
+Create the environment with `python3 -m venv .venv` and
+`.venv/bin/pip install -e '.[dev]'`; use `.venv/bin/python` thereafter. Add
+`.[notebooks]` to execute notebooks, `.[docs]` for documentation, and `.[release]`
+for distribution checks. Before handoff run the exporter check, `python -m
+pytest -q`, and `python -m mkdocs build --strict` when documentation changes.
+Use the venv interpreter for each command.
+
+## Version policy
+
+The three integers in `M.X.Y` are independent counters, not a decimal number.
+The leading zero in the former `0.X.Y` was the major version; this round starts
+`1.0.0`. An implemented feature increments X; a fix increments Y. Increasing X
+must not reset Y: for example, a feature after `1.2.7` becomes `1.3.7`, and a fix
+then becomes `1.3.8`. Only Diogo Seca decides when to change the major version.
+Do not infer a major bump from another project's versioning convention.
+
+The authoritative version string is `__version__` in notebook 12's package cell,
+exported to `timegym/__init__.py`; flit reads it dynamically. Update the matching
+CITATION.cff version/date and the leading CHANGELOG heading, run
+`tools/sync_citation.py`, then regenerate the standalone manuscript. Never
+invent a DOI. Follow `docs/release.md` for DOI registration and publication.
+
+## Compatibility policy
+
+Follow pandas when choosing current Python and scientific dependency support.
+Prefer the latest stable Python and dependency releases supported by pandas;
+when uncertain, use pandas' support policy and release timing. Keep explicit
+NumPy, pandas and SciPy major-version ceilings until compatibility is reviewed.
+The scheduled compatibility workflow proposes coordinated metadata, CI, Docker
+and documentation updates and tests them before opening a pull request. Keep
+the historical study lock and its Python version separate from current support.
+A successful local check is not evidence that another OS or Python version passed.
+
+Publication is tag-driven after owner review. Do not publish, push tags, or
+change external PyPI/Zenodo settings as part of ordinary implementation work.
+
+## Working agreements
+
+Work on a branch and hand over a pull request; never push to `main`, never
+push tags, never force-push. Before handoff run, with the venv interpreter,
+`tools/export_notebooks.py --check`, `python -m pytest -q`,
+`python -m mkdocs build --strict` followed by `tools/check_site_links.py site`,
+`paper/build_standalone.py --check`,
+`tools/sync_citation.py --check`, and `notebooks/check_notebooks.py` on every
+notebook you touched, with `--write` when outputs change, because the docs
+site renders saved outputs. When the manuscript changes, also compile
+`paper/timegym.tex` with latexmk as `paper/README.md` describes. Recount
+every stated count (source notebooks, generated modules, active notebooks,
+tests) when it changes. Commit messages
+have an imperative subject and no trailers: no `Co-Authored-By`, no session
+links, no tool attribution of any kind. Delegate to subagents on Opus; the
+session's own model is for orchestration and review.

timegym-1.1.0/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+## 1.1.0 — 2026-11-05
+
+- Added reversible target transforms to `timegym.target`: `LogTransform`,
+  `BoxCoxTransform`, `DifferenceTransform` and `ComposedTransform`, with
+  `transform_config` and `transform_from_config` for configuration and replay.
+- `Pipeline(..., target_transform=None)` fits a fresh copy of the transform on each
+  context and inverts the model's forecast before evaluation.
+- `SklearnForecaster` adds the `direct` and `multioutput` reductions beside
+  `recursive`; `timegym.models.REDUCTIONS` lists them and `Pipeline(reduction=...)`
+  selects one.
+- Pipeline configuration schema 3 records `target_transform`; schema 2
+  configurations remain readable.
+- Added tutorials 29 (target transforms) and 30 (reductions).
+- Removed the command-line interface: the `timegym` console script,
+  `python -m timegym`, the `timegym.cli` module and source notebook 13.
+  TimeGym is used as a Python package.
+- `examples/reproduce_report.py` is a standalone script: it replays one case with
+  `TestReport.read(...).replay_case(...)`, prints the comparison and exits 1 when
+  the case is not reproduced. The installed-wheel CI job replays the report saved
+  by `tools/smoke_installed.py --report`.
+- Removed `Pipeline.plot_error()`, the 1.0 alias of `Pipeline.plot_errors()`.
+- Pipeline configuration schema 1 (`strategy` instead of `reduction`) is no longer
+  read; `pipeline_from_config` accepts schemas 2 and 3.
+- Removed `timegym.joint_processes.resolve_joint_process()`; call
+  `timegym.processes.resolve_process()` with the same arguments.
+- Renamed the supplement's paired loss fields `repair_minus_faulty_mse` and
+  `repair_minus_faulty_reference_mse` to `clean_minus_faulty_mse` and
+  `clean_minus_faulty_reference_mse` in `experiments/results-v2`, as a recorded
+  offline migration; no value changed.
+
+## 1.0.0 — 2026-10-30
+
+Prepared release; publication is performed only by the version-tag workflow.
+
+- Unified package, citation and manuscript version metadata; added checked
+  citation rendering and a tag-driven PyPI/GitHub release workflow.
+- Added scheduled Python compatibility updates following pandas support,
+  bounded runtime dependencies, and a pinned development Docker image.
+- Documented module imports, built-in models, fault fixtures, and release setup.
+- Excluded historical notebooks from the source archive and consolidated CI checks.
+- `get_stock` now defaults to `auto_adjust=True` (adjusted OHLC); pass `False` for the
+  provider's unadjusted fields.
+
+- Renamed Pipeline’s `strategy` parameter and attribute to `reduction`. Pipeline
+  configuration schema 2 uses `reduction`; saved schema-1 configurations remain
+  replayable. `NaiveForecaster(strategy=...)` continues to select its baseline.
+
+- Renamed `Pipeline.plot_error()` to `Pipeline.plot_errors()` for consistency with
+  retained runs. The singular spelling remains a forwarding alias for the 1.0
+  release; migrate callers before the next release.
+
+### Joint controlled processes
+
+- Extended composed, Merton, GARCH and Markov scenarios to multiple dependent targets.
+- Added correlated shocks, shared jump events, shared hidden regimes, and state-specific correlation matrices.
+- Added CCC-GARCH with exact joint simulation and explicitly labelled numerical cross-covariance.
+- Added source notebook 15 and application notebook 27, including dependence-fault and repair examples.
+- Preserved scalar-case outputs, seed behaviour, and replay records.
+
+
+TimeGym now provides a reproducible verification and diagnosis workflow for
+forecasting pipelines, with a new manuscript and bounded controlled studies.
+
+- Explicit contracts for point means, marginal quantiles, and joint samples.
+- Controlled scalar and joint compositions and parameter changes, Merton jump diffusion,
+  GARCH volatility, and hidden Markov regimes with optional jumps.
+- Non-Gaussian conditional simulation references with explicit quantile and
+  filtering approximation metadata.
+- Conditional Gaussian references and reproducible multivariate scenarios.
+- Parameter-aware plot labels distinguish fixed-mean white noise, linear trend
+  plus noise, and random walks with or without drift, including mixed-target drift.
+- Fresh-fitting pipeline adapters and training-only recursive sklearn forecasts.
+- Structured diagnostics, validated report loading, and allowlisted model replay.
+- A command-line alignment-fault demo, report inspection, and replay.
+- Retained forecast matrices with observation dots and unconnected forecast
+  crosses; plots reuse fitted results.
+- Notebook-first source with deterministic nbdev export and drift checks.
+- Univariate and multivariate uncertainty demos, fault/repair examples, and local
+  real-data applications. The 11 original notebooks remain archived unchanged.
+- Strict documentation and distribution checks, citation metadata, and CI jobs
+  that exercise an installed wheel outside the checkout.
+
+The 2021 API and dependency assumptions changed substantially. Follow the
+migration guide. Direct/multioutput forecasting strategies,
+automatic repair discovery, and universal fault detection are not claimed.