Add dynamic version display in docs, VQC sensitivity experiment, and minor improvements

- Add MkDocs hook to read package version from setuptools-scm at build
  time, replacing the hardcoded v0.1 on the docs homepage. The hook
  falls back to importing from the installed package for non-editable
  CI installs, and to "dev" if neither source is available.
- Add fetch-depth: 0 to the CI docs job so setuptools-scm can resolve
  version from git tags (matching deploy-docs.yml).
- Add VQC hyperparameter sensitivity analysis experiment (Stage 6a.5)
  with grid search over learning rates and variational layers.
- Add comprehensive tests for the sensitivity analysis pipeline.
- Add paper/ to .gitignore for private drafts.
- Switch PyPI badge to shields.io in README.
- Improve instantiation consistency test with batched timings.

Author: ashutoshm1771

.github/workflows/ci.yml

@@ -150,6 +150,8 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Set up Python
         uses: actions/setup-python@v5

.gitignore

@@ -71,6 +71,9 @@ experiments/plotting_journal.py
 # Verification folder (temporary)
 verification/
 
+# Paper (private drafts)
+paper/
+
 # OS
 .DS_Store
 Thumbs.db

README.md

@@ -4,7 +4,7 @@
 
 **The comprehensive library for quantum data encodings in machine learning**
 
-[![PyPI version](https://badge.fury.io/py/encoding-atlas.svg)](https://pypi.org/project/encoding-atlas/)
+[![PyPI version](https://img.shields.io/pypi/v/encoding-atlas.svg)](https://pypi.org/project/encoding-atlas/)
 [![Python versions](https://img.shields.io/pypi/pyversions/encoding-atlas.svg)](https://pypi.org/project/encoding-atlas/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://img.shields.io/github/actions/workflow/status/encoding-atlas/quantum-encoding-atlas/ci.yml?branch=master&logo=github&label=CI)](https://github.com/encoding-atlas/quantum-encoding-atlas/actions/workflows/ci.yml)

docs/hooks/version_hook.py

@@ -0,0 +1,37 @@
+"""MkDocs hook to inject the package version into template context."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+
+def _read_version() -> str:
+    """Read version from _version.py or the installed package."""
+    # Try 1: Read from source tree (editable install / local dev)
+    version_file = (
+        Path(__file__).resolve().parents[2] / "src" / "encoding_atlas" / "_version.py"
+    )
+    if version_file.exists():
+        match = re.search(
+            r'__version__\s*=\s*version\s*=\s*["\']([^"\']+)["\']',
+            version_file.read_text(),
+        )
+        if match:
+            return match.group(1)
+
+    # Try 2: Import from installed package (non-editable pip install in CI)
+    try:
+        from encoding_atlas._version import __version__
+
+        return __version__
+    except ImportError:
+        pass
+
+    return "dev"
+
+
+def on_config(config, **kwargs):
+    """Inject package_version into extra config for Jinja2 templates."""
+    config["extra"]["package_version"] = _read_version()
+    return config