# Changelog

All notable changes to *Neural Networks as Sheaves* will be documented here.
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
and this project aims to adhere to [Semantic Versioning](https://semver.org/).

## [Unreleased]

### Added
- Initial Quarto project scaffold.
- 14 chapter stubs + Chapter 0, across 6 parts.
- 3 appendix stubs (A: CPWA/Filippov proofs; B: sheaf-theoretic identities; C: reproducing experiments).
- 14 Jupyter notebook stubs under `labs/`.
- `PLAN.md` with the full first-pass scaffold.
- `_quarto.yml` with HTML + PDF output targets.
- `requirements.txt` for lab dependencies.
- GitHub Actions workflow for auto-deploying HTML book to GitHub Pages.
- `references/source/bosca-ghrist-2026.pdf` — local copy of the source paper (arXiv:2603.14831v3).
- Bibliography entries for all 30 paper references: Gould 2025, Seely 2025, Clarke 1983, Filippov 1988, Shevitz–Paden 1994, Barbero et al. 2022, Hernandez Caralt et al. 2024, Parada-Mayorga et al. 2020, Seigal et al. 2023, Millidge et al. 2022, Scellier–Bengio 2017, Whittington–Bogacz 2017, He et al. 2015/2016, Srivastava et al. 2014, Liu et al. 2023, Bosca et al. 2025.

### Changed
- **Corrected CPWA citation.** Replaced the speculative "Gould 2011 Oxford" / "Thuan–Çamlıbel 2011" placeholder with the real reference: **Gould, *Cellular Sheaves of Hilbert Spaces*, PhD thesis, University of Pennsylvania, 2025**. This is the paper's ref [12] and is the source of the fast selection rule, CPWA convergence, and local-adjoint machinery used throughout §4.
- Fixed the Hansen–Ghrist 2021 opinion-dynamics entry: journal is **SIAM J. Applied Mathematics** 81(5):2033–2060, not SIAM J. Applied Algebra and Geometry.
- PLAN.md: resolved-flags block replaces the "verify" block; prereq table and open-questions list updated.

### To do (next passes)
- Fill `[TO FILL: ...]` slots chapter by chapter.
- Add figures and a visual style guide.
- ~~Verify paper section numbering~~ ✅ done.
- ~~Verify GitHub repo URL~~ ✅ `github.com/vicenbosca/neural-sheaf` confirmed (paper footnote 1). License on that repo still to check.
- ~~Resolve CPWA-thesis citation ambiguity~~ ✅ done — Gould 2025 Penn.
- Retire [2, 3, 1] running-network in favor of [2, 4, 1] / [2, 30, 1] to match the paper.
- Enable GitHub Pages and add live URL to README + `_quarto.yml`.
- Add a new section (Ch. 11 or appendix) covering partial clamping (paper's Note 5.1).