Skip to content

~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.

fix(release): make Towncrier links work for issues and PRs (#7132)

LearningCircuite4d013ea7485
diff --git a/changelog.d/+towncrier-issue-links.bugfix.md b/changelog.d/+towncrier-issue-links.bugfix.md
new file mode 100644
index 0000000000..c97f160f90
--- /dev/null
+++ b/changelog.d/+towncrier-issue-links.bugfix.md
@@ -0,0 +1 @@
+Fix release-note links for numbered issue fragments while keeping PR fragment links working.
diff --git a/pyproject.toml b/pyproject.toml
index 06e9cfd3a0..df49f3a591 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -542,7 +542,9 @@ directory = "changelog.d"
# version as its title, and per-version files don't need an inline
# version header either.
title_format = false
-issue_format = "[#{issue}](https://github.com/LearningCircuit/local-deep-research/pull/{issue})"
+# Fragments name both issues and PRs. GitHub's /issues/<number> route opens
+# issues directly and redirects PR numbers to their pull request pages.
+issue_format = "[#{issue}](https://github.com/LearningCircuit/local-deep-research/issues/{issue})"
underlines = ["", "", ""]
[[tool.towncrier.type]]
diff --git a/tests/ci/test_towncrier_links.py b/tests/ci/test_towncrier_links.py
new file mode 100644
index 0000000000..f365da6f20
--- /dev/null
+++ b/tests/ci/test_towncrier_links.py
@@ -0,0 +1,61 @@
+"""Keep rendered release-note links valid for both issues and PRs."""
+
+# allow: no-sut-import — this invokes the release-notes CLI against fixtures.
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+from pathlib import Path
+
+import pytest
+
+
+ROOT = Path(__file__).resolve().parents[2]
+BASE = "https://github.com/LearningCircuit/local-deep-research"
+
+
+ shutil.which("towncrier") is None, reason="towncrier unavailable"
+)
+def test_towncrier_links_issue_and_pr_fragments_to_unified_github_route(
+ tmp_path,
+):
+ # Build against synthetic fragments, never the real changelog.d: the
+ # release consumes (deletes) those fragments, so asserting on them would
+ # go red on main right after release. Only the repo's real
+ # [tool.towncrier] config (pyproject.toml) is exercised.
+ shutil.copy(ROOT / "pyproject.toml", tmp_path / "pyproject.toml")
+ frag_dir = tmp_path / "changelog.d"
+ frag_dir.mkdir()
+ (frag_dir / "11111.bugfix.md").write_text("Fix reported in an issue.\n")
+ (frag_dir / "22222.feature.md").write_text("Feature delivered by a PR.\n")
+ (frag_dir / "+orphan-slug.misc.md").write_text("Fragment without a link.\n")
+
+ result = subprocess.run(
+ [
+ "towncrier",
+ "build",
+ "--draft",
+ "--version",
+ "0.0.0",
+ "--dir",
+ str(tmp_path),
+ "--config",
+ str(tmp_path / "pyproject.toml"),
+ ],
+ check=True,
+ capture_output=True,
+ text=True,
+ timeout=30,
+ )
+ notes = result.stdout
+
+ # /issues/ resolves for both issue numbers and PR numbers; the previous
+ # /pull/ template left issue-number fragments as broken links.
+ for number in (11111, 22222):
+ assert f"[#{number}]({BASE}/issues/{number})" in notes
+ assert "/pull/" not in notes
+ # The +slug fragment has no issue, so it renders its text with no link.
+ assert "Fragment without a link." in notes
+ assert "+orphan-slug" not in notes