@@ -55,7 +55,11 @@ jobs:
         uv pip install --editable .
 
     - name: Run pytest
-      run: uv run python -m pytest tests/ -v --tb=short
+      # Coverage must stay at 100% (pyproject.toml), except on 3.15: PyYAML
+      # has no wheel for it yet, so the gallery scripts' tests are skipped there
+      run: >-
+        uv run python -m pytest tests/ -v --tb=short --cov --cov-report=term-missing
+        ${{ matrix.python-version == '3.15' && '--cov-fail-under=0' || '' }}
 
     - name: Generate GitStats Report (smoke test)
       if: ${{ matrix.python-version == '3.10' }}
 
@@ -1122,7 +1122,7 @@ def _collect_commit_subjects(self) -> None:
             except ValueError:
                 continue
             subject = line[pos + 1 :].strip()
-            if subject:
+            if subject:  # pragma: no branch - a stripped line has text after its space
                 by_year.setdefault(year, []).append(subject[:100])
 
         self.commit_subjects_by_year = {
@@ -1154,7 +1154,7 @@ def refine(self) -> None:
         # Compute new contributors per month from author first-commit stamps
         for name in self.authors:
             a = self.authors[name]
-            if "first_commit_stamp" in a:
+            if "first_commit_stamp" in a:  # pragma: no branch - every author has one by now
                 first_month = datetime.datetime.fromtimestamp(a["first_commit_stamp"]).strftime(
                     "%Y-%m"
                 )
 
@@ -74,7 +74,7 @@ def format_duration(delta: datetime.timedelta) -> str:
 
 def format_bytes(size: float) -> str:
     """Render a byte count in binary units (161307.78 -> "157.5 KB")."""
-    for unit in ("bytes", "KB", "MB", "GB"):
+    for unit in ("bytes", "KB", "MB", "GB"):  # pragma: no branch - breaks at GB at the latest
         if abs(size) < 1024 or unit == "GB":
             break
         size /= 1024
 
@@ -47,7 +47,7 @@ documentation = "https://gitstats.readthedocs.io/"
 [project.optional-dependencies]
 dev = ["nox"]
 # PyYAML: the gallery scripts' tests, where it has a wheel (not yet on 3.15)
-test = ["pytest>=7.0", "pyyaml>=6.0; python_version < '3.15'"]
+test = ["pytest>=7.0", "pytest-cov", "pyyaml>=6.0; python_version < '3.15'"]
 docs = ["sphinx", "sphinx-rtd-theme", "sphinx-autobuild"]
 ai = [
     "openai>=1.0",
@@ -72,13 +72,14 @@ fallback_version = "0.0.0"
 testpaths = ["tests"]
 pythonpath = ["."]
 
-# Coverage is not installed by the test extra; measure it with, for example,
-#   uv run --extra test --with pytest-cov python -m pytest --cov
+# The test extra installs pytest-cov: `python -m pytest --cov` measures line
+# and branch coverage, and fails under 100% (CI runs it so)
 [tool.coverage.run]
 source = ["gitstats", "scripts"]
 branch = true
 
 [tool.coverage.report]
+fail_under = 100
 show_missing = true
 skip_covered = true
 exclude_also = ['if __name__ == "__main__":', '@(abc\.)?abstractmethod']
 
@@ -118,6 +118,17 @@ def test_retry_gives_up_after_the_last_attempt():
     assert isinstance(error.value.__cause__, RuntimeError)
 
 
+def test_retry_with_no_attempts_never_calls_the_function():
+    """``max_retries`` counts the attempts: with none, the function is not
+    called at all and nothing comes back."""
+    provider = _EchoProvider({"max_retries": 0, "retry_delay": 0})
+    func = MagicMock(return_value="ok")
+    with patch("gitstats.ai_providers.time.sleep") as sleep:
+        assert provider._retry_with_backoff(func) is None
+    func.assert_not_called()
+    sleep.assert_not_called()
+
+
 # ── OpenAI ───────────────────────────────────────────────────────────────
 
 
 
@@ -10,6 +10,7 @@
 
 from gitstats import load_config
 from gitstats.badge import (
+    _HEALTH,
     BADGE_FILENAME,
     BADGES_DIRNAME,
     STYLE_NAMES,
@@ -270,6 +271,20 @@ def test_health_badge_dot_replaces_terminal_prefix(mock_data_collector):
     assert ">//</text>" not in svg
 
 
+def test_health_last_tier_takes_what_no_limit_covers(mock_data_collector, monkeypatch):
+    """The last tier is the catch-all: even without its open limit, an age
+    past every limit still falls to it."""
+    monkeypatch.setattr("gitstats.badge._HEALTH", _HEALTH[:2])
+    health = composite_badges(
+        mock_data_collector, "gitstats", "", "flat", now=datetime.datetime(2025, 6, 1)
+    )["health"]
+    assert (health.label, health.message, health.color) == (
+        "quiet",
+        "last commit 2 years ago",
+        "#9a6700",
+    )
+
+
 # ── create_badges ────────────────────────────────────────────────────────
 
 
 
@@ -167,3 +167,21 @@ def test_load_repos_reads_only_a_yml_file_here(repos_script, tmp_path, monkeypat
     monkeypatch.chdir(inside)
     with pytest.raises(repos_script.RepoListError, match="under the current directory"):
         repos_script.load_repos(name)
+
+
+def test_load_repos_rejects_a_file_commonpath_cannot_compare(repos_script, tmp_path, monkeypatch):
+    # A list whose real path lands somewhere commonpath() cannot compare to
+    # the current directory (another drive on Windows) is not under it:
+    # os.path.commonpath() raises ValueError for that case.
+    monkeypatch.chdir(tmp_path)
+    (tmp_path / "repos.yml").write_text("groups: []\n", encoding="utf-8")
+    real_realpath = os.path.realpath
+
+    def fake_realpath(path):
+        if str(path).endswith("repos.yml"):
+            return r"D:\elsewhere\repos.yml"
+        return real_realpath(path)
+
+    monkeypatch.setattr(repos_script.os.path, "realpath", fake_realpath)
+    with pytest.raises(repos_script.RepoListError, match="under the current directory"):
+        repos_script.load_repos("repos.yml")
@@ -417,3 +417,33 @@ def test_add_note_stays_in_its_directory(gallery_script, temp_dir):
     assert gallery_script.add_note(inside, outside, "NOTE") is False
     assert gallery_script.add_note(inside, os.path.join(inside, "..", "outside.html"), "N") is False
     assert _read(outside) == "<p>a</p></body>"
+
+
+def test_add_note_skips_a_page_commonpath_cannot_compare(gallery_script, temp_dir, monkeypatch):
+    # A page whose real path lands somewhere commonpath() cannot compare to
+    # the gallery (another drive on Windows) is not inside it:
+    # os.path.commonpath() raises ValueError for that case.
+    page = os.path.join(temp_dir, "page.html")
+    with open(page, "w", encoding="utf-8") as f:
+        f.write("<p>a</p></body>")
+    real_realpath = os.path.realpath
+
+    def fake_realpath(path):
+        if path.endswith("page.html"):
+            return r"D:\outside\page.html"
+        return real_realpath(path)
+
+    monkeypatch.setattr(gallery_script.os.path, "realpath", fake_realpath)
+    assert gallery_script.add_note(temp_dir, page, "NOTE") is False
+    assert _read(page) == "<p>a</p></body>"
+
+
+def test_add_report_notes_skips_a_report_without_a_folder(gallery_script, temp_dir):
+    gallery = os.path.join(temp_dir, "gallery")
+    os.makedirs(gallery)
+    summaries = [
+        {"report_path": "missing/index.html", "name": "no folder"},
+        {"report_path": "../index.html", "name": "outside the gallery"},
+        {"report_path": "./index.html", "name": "the gallery itself"},
+    ]
+    assert gallery_script.add_report_notes(gallery, summaries, "") == 0
@@ -8,6 +8,7 @@
 import subprocess
 import sys
 from pathlib import Path
+from types import SimpleNamespace
 from unittest.mock import MagicMock, patch
 
 import pytest
@@ -1489,6 +1490,53 @@ def test_main_default_outputpath(git_repo_minimal, temp_dir):
     assert os.path.isdir("gitstats-report")
 
 
+@pytest.mark.skipif(
+    sys.version_info < (3, 12),
+    reason="argparse before 3.12 rejects a positional that follows an option",
+)
+def test_main_outputpath_after_an_option(git_repo_minimal, temp_dir):
+    """`gitstats repo -f json out`: argparse itself hands the last path to
+    outputpath, so main() has nothing to move out of gitpath."""
+    import gitstats
+    import gitstats.main
+
+    cfg = dict(gitstats.DEFAULT_CONFIG, ai_enabled=False)
+    gitstats._config = cfg
+    gitstats.main.conf = cfg
+
+    output = os.path.join(temp_dir, "report")
+
+    with patch.object(sys, "argv", ["gitstats", git_repo_minimal, "-f", "json", output]):
+        ret = main()
+    assert ret == 0
+    assert os.path.isfile(os.path.join(output, "index.html"))
+    assert os.path.isfile(f"{output}.json")  # the JSON goes next to the report
+
+
+def test_main_keeps_an_outputpath_argparse_filled(git_repo_minimal, temp_dir, monkeypatch):
+    """Same contract on every Python: when the parser already filled outputpath,
+    main() leaves gitpath alone instead of moving its last entry."""
+    import gitstats
+    import gitstats.main
+
+    cfg = dict(gitstats.DEFAULT_CONFIG, ai_enabled=False)
+    gitstats._config = cfg
+    gitstats.main.conf = cfg
+
+    output = os.path.join(temp_dir, "report")
+    args = gitstats.main.get_parser().parse_args([git_repo_minimal, "-f", "json"])
+    args.outputpath = output
+    monkeypatch.setattr(
+        gitstats.main, "get_parser", lambda: SimpleNamespace(parse_args=lambda: args)
+    )
+
+    ret = main()
+    assert ret == 0
+    assert args.gitpath == [git_repo_minimal]
+    assert os.path.isfile(os.path.join(output, "index.html"))
+    assert os.path.isfile(f"{output}.json")
+
+
 def test_main_with_config_override(git_repo_minimal, temp_dir):
     """Test main() with -c overrides."""
     import gitstats
 
@@ -1071,6 +1071,26 @@ def test_contributor_timeline_years_and_bots(mock_data_collector):
     assert "width: 0.000%" in html
 
 
+def test_contributor_timeline_places_a_month_inside_the_collapsed_stretch(mock_data_collector):
+    """The stretch is squeezed into its slot, not cut out: a month inside it
+    lands inside the band, in proportion, never past it."""
+    months = {f"2010-{m:02d}": 2 for m in range(1, 13)}
+    months.update({f"2013-{m:02d}": 3 for m in range(1, 13)})
+    mock_data_collector.commits_by_month = months
+    mock_data_collector.author_of_month = {m: {"Alice Smith": n} for m, n in months.items()}
+    # a commit the monthly totals do not have, in the quiet 2011-01 .. 2012-12
+    mock_data_collector.author_of_month["2011-07"] = {"Bob Jones": 1}
+    html = HTMLReportCreator()._contributor_timeline_html(
+        mock_data_collector, ["Alice Smith", "Bob Jones"]
+    )
+    # 48 months, the 24 quiet ones in one slot of 25: the band is at 48%, 4% wide
+    assert '<span class="timeline-gap is-collapsed" style="left: 48.000%; width: 4.000%" ' in html
+    # 2011-07 is 6.5 months into the 24 of the stretch: that far into the slot,
+    # (12 + 6.5 / 24) / 25 of the axis
+    assert 'aria-label="Bob Jones: 15 commits, 2011-07 to 2011-07"' in html
+    assert 'class="timeline-mark" style="left: 49.083%;' in html
+
+
 # ── HTMLReportCreator.create_files_html ──────────────────────────────────