chore(release): bump to v1.15.3 — doc-only fix for PyPI hero banner

brycewang-stanford · claude · brycewang-stanford · commit f89a3965a397 · 2026-05-17T15:58:47.000-07:00
The v1.15.2 PyPI project page rendered the hero banner as a broken
image because both READMEs pointed at the repo-relative path
docs/logo/readme-1.png, which GitHub resolves correctly but PyPI's
long-description renderer cannot. v1.15.3 rewrites the &lt;img&gt; tag in
README.md and README_CN.md to the absolute raw GitHub URL so the
banner loads on PyPI / TestPyPI / any off-GitHub README renderer.

No code changes. All shipped module files match v1.15.2 exactly;
only the long-description metadata baked into the wheel + sdist
regenerates.

Co-Authored-By: Claude Opus 4.7 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,24 @@ All notable changes to StatsPAI will be documented in this file.
 
 ## [Unreleased]
 
+## [1.15.3] — 2026-05-17
+
+### Fixed — PyPI long-description hero banner
+
+- The v1.15.2 PyPI project page rendered the hero banner as a broken
+  image. Root cause: [`README.md`](README.md) and
+  [`README_CN.md`](README_CN.md) referenced
+  `docs/logo/readme-1.png` with a **repo-relative** path, which GitHub
+  resolves against the rendered tree but PyPI's long-description
+  renderer has no base URL for and therefore leaves as a 404. Both
+  READMEs now point at the absolute raw GitHub URL
+  `https://raw.githubusercontent.com/brycewang-stanford/StatsPAI/main/docs/logo/readme-1.png`
+  so the banner loads on PyPI / TestPyPI / Open Source Insights /
+  any other off-GitHub README renderer.
+- **No code changes.** All shipped artifacts have the same module
+  hashes as v1.15.2 except for the regenerated long-description
+  metadata baked into the wheel + sdist.
+
 ## [1.15.2] — 2026-05-17
 
 ### Headline
diff --git a/CITATION.cff b/CITATION.cff
@@ -16,7 +16,7 @@ authors:
     given-names: "Biaoyue"
     affiliation: "Stanford REAP, Stanford University"
     email: "brycew6m@stanford.edu"
-version: "1.15.2"
+version: "1.15.3"
 date-released: "2026-05-17"
 license: MIT
 # Zenodo *concept* DOI — always resolves to the latest archived version.
diff --git a/MIGRATION.md b/MIGRATION.md
@@ -7,6 +7,19 @@ Internal version-to-version migrations are at the top; the long-form
 
 <a id="sp-rdrobust-bwselect-cct-r-parity-opt-in"></a>
 
+## v1.15.2 → v1.15.3 — doc-only PyPI hero-banner fix
+
+**No code changes, no migration step.** The v1.15.2 PyPI project page
+rendered the hero banner as a broken image because the `<img>` tag in
+`README.md` / `README_CN.md` used a repo-relative path
+(`docs/logo/readme-1.png`) that PyPI's long-description renderer
+cannot resolve. v1.15.3 swaps the path for the absolute raw GitHub
+URL so the banner loads on PyPI / TestPyPI / off-GitHub mirrors.
+Module hashes match v1.15.2 bit-for-bit; only the long-description
+metadata baked into the wheel + sdist changes.
+
+---
+
 ## v1.15.1 → v1.15.2 — strict-JSON MCP wire, dual-track replicate, packaging
 
 **No estimator numerical path changes.** Three classes of consumers
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 [English](https://github.com/brycewang-stanford/statspai/blob/main/README.md) | [中文](https://github.com/brycewang-stanford/statspai/blob/main/README_CN.md)
 
 <p align="center">
-  <img src="docs/logo/readme-1.png" alt="StatsPAI — Agent-Native Causal Inference for Python" width="780">
+  <img src="https://raw.githubusercontent.com/brycewang-stanford/StatsPAI/main/docs/logo/readme-1.png" alt="StatsPAI — Agent-Native Causal Inference for Python" width="780">
 </p>
 
 # StatsPAI: The Agent-Native Causal Inference & Econometrics Toolkit for Python
@@ -128,6 +128,18 @@ StatsPAI's focus is **causal inference** — and on this axis we aim to be the m
 
 ---
 
+**📦 v1.15.3 (2026-05-17) — Doc-only patch: PyPI hero banner image fix**
+
+The v1.15.2 PyPI project page rendered the hero banner as a broken
+image because both READMEs pointed at the repo-relative path
+`docs/logo/readme-1.png`, which GitHub resolves correctly but PyPI's
+long-description renderer cannot. v1.15.3 rewrites the `<img>` tag in
+[`README.md`](README.md) and [`README_CN.md`](README_CN.md) to the
+absolute raw GitHub URL so the banner loads on PyPI / TestPyPI / any
+off-GitHub README renderer. **No code changes** — all shipped module
+files match v1.15.2 exactly; only the long-description metadata baked
+into the wheel + sdist regenerates.
+
 **📦 v1.15.2 (2026-05-17) — Strict-JSON MCP wire + dual-track replicate guides + release-packaging hardening**
 
 Patch release on top of v1.15.1 with **no estimator numerical change**.
@@ -1363,7 +1375,7 @@ resolves to the latest version):
   author       = {Wang, Biaoyue},
   title        = {StatsPAI: The Agent-Native Causal Inference \& Econometrics Toolkit for Python},
   year         = {2026},
-  version      = {1.15.2},
+  version      = {1.15.3},
   doi          = {10.5281/zenodo.19933900},
   url          = {https://doi.org/10.5281/zenodo.19933900},
   license      = {MIT},
diff --git a/README_CN.md b/README_CN.md
@@ -1,7 +1,7 @@
 [English](https://github.com/brycewang-stanford/statspai/blob/main/README.md) | [中文](https://github.com/brycewang-stanford/statspai/blob/main/README_CN.md)
 
 <p align="center">
-  <img src="docs/logo/readme-1.png" alt="StatsPAI — 面向 Agent 的 Python 因果推断工具包" width="780">
+  <img src="https://raw.githubusercontent.com/brycewang-stanford/StatsPAI/main/docs/logo/readme-1.png" alt="StatsPAI — 面向 Agent 的 Python 因果推断工具包" width="780">
 </p>
 
 # StatsPAI：面向 Agent 的因果推断与计量经济学 Python 工具包
@@ -50,6 +50,17 @@ StatsPAI 聚焦**因果推断**——在这条主线上，我们的目标是成
 
 ---
 
+**📦 v1.15.3（2026-05-17）— 文档 patch：修复 PyPI 主页 banner 图加载失败**
+
+v1.15.2 PyPI 项目主页的 hero banner 渲染成裂图，原因是两份 README
+里的 `<img>` 写的是仓库相对路径 `docs/logo/readme-1.png`，GitHub 能解
+析但 PyPI 的 long-description 渲染器没有 base URL 概念。v1.15.3 把
+[`README.md`](README.md) 和 [`README_CN.md`](README_CN.md) 的图片地
+址改成 `raw.githubusercontent.com` 绝对 URL，PyPI / TestPyPI / 其他
+脱离 GitHub 的 README 渲染器都能正常加载。**代码零变化**——
+wheel/sdist 里所有模块文件与 v1.15.2 一致，只有 long-description
+元数据重新生成。
+
 **📦 v1.15.2（2026-05-17）— MCP 严格 JSON + Replicate 双轨指南 + 发布打包加固**
 
 v1.15.1 之上的 patch 发布，**估计器数值路径零变化**，三条独立的加固
@@ -581,7 +592,7 @@ sp.__citation__                 # 与 sp.citation("bibtex") 等价
   author       = {Wang, Biaoyue},
   title        = {StatsPAI: The Agent-Native Causal Inference \& Econometrics Toolkit for Python},
   year         = {2026},
-  version      = {1.15.2},
+  version      = {1.15.3},
   doi          = {10.5281/zenodo.19933900},
   url          = {https://doi.org/10.5281/zenodo.19933900},
   license      = {MIT},
diff --git a/docs/index.md b/docs/index.md
@@ -171,7 +171,7 @@ method that returns the correct BibTeX entry) and this package:
   title   = {StatsPAI: A Unified, Agent-Native Python Toolkit for
              Causal Inference and Applied Econometrics},
   year    = {2026},
-  version = {1.15.2},
+  version = {1.15.3},
   url     = {https://github.com/brycewang-stanford/StatsPAI}
 }
 ```
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "StatsPAI"
-version = "1.15.2"
+version = "1.15.3"
 description = "The Agent-Native Causal Inference & Econometrics Toolkit for Python"
 readme = "README.md"
 license = "MIT"
diff --git a/src/statspai/__init__.py b/src/statspai/__init__.py
@@ -22,7 +22,7 @@
 >>> sp.outreg2(result, filename="results.xlsx")
 """
 
-__version__ = "1.15.2"
+__version__ = "1.15.3"
 __author__ = "Biaoyue Wang"
 __email__ = "brycew6m@stanford.edu"
 

Original file line number	Diff line number	Diff line change
`@@ -171,7 +171,7 @@ method that returns the correct BibTeX entry) and this package:`
`171`	`171`	`title = {StatsPAI: A Unified, Agent-Native Python Toolkit for`
`172`	`172`	`Causal Inference and Applied Econometrics},`
`173`	`173`	`year = {2026},`
`174`		`- version = {1.15.2},`
	`174`	`+ version = {1.15.3},`
`175`	`175`	`url = {https://github.com/brycewang-stanford/StatsPAI}`
`176`	`176`	`}`
`177`	`177`	```