purescript-lua · Unisay · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -48,7 +48,7 @@ A bare `function … end` or an unparenthesised expression fails to parse.
 
 ## Releasing
 
-Tag-driven, with no GitHub Release or changelog entry. The full conventions live in the [package-set repo](https://github.com/purescript-lua/purescript-lua-package-sets/blob/master/CONTRIBUTING.md): push an annotated tag on `master`, bump this fork's `version` in the package set's `src/packages.json`, refresh `latest-compatible-sets.json`, and push a `psc-*` set tag.
+Tag-driven. The full conventions live in the [package-set repo](https://github.com/purescript-lua/purescript-lua-package-sets/blob/master/CONTRIBUTING.md): write a `changelog.d/` fragment for any `src/` change, run `scriv collect --version <tag>` and commit the updated `CHANGELOG.md`, then push an annotated tag on `main`, bump this fork's `version` in the package set's `src/packages.json`, refresh `latest-compatible-sets.json`, and push a `psc-*` set tag.
 
 ## Decisions
 

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,24 @@
+# Changelog
+
+Notable changes to `purescript-lua-ngx` (PureScript bindings to the OpenResty
+`ngx_http_lua` API, targeting Lua 5.1) are recorded here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and entries are
+assembled from fragments in `changelog.d/` with
+[scriv](https://scriv.readthedocs.io/) on each release.
+
+<!-- scriv-insert-here -->
+
+## v0.2.0 - 2024-04-16
+
+### Changed
+
+- Refreshed the flake and dependencies for the current toolchain.
+
+## v0.1.0 - 2023-03-31
+
+### Added
+
+- Initial PureScript bindings to the OpenResty / `ngx_http_lua` API for the Lua
+  target.
+
+<!-- scriv-end-here -->
diff --git a/changelog.d/0001-new-spago-and-run-script.md b/changelog.d/0001-new-spago-and-run-script.md
@@ -0,0 +1,9 @@
+### Added
+
+- `scripts/run`: an OpenResty demo runner that serves the compiled dist under
+  `content_by_lua`.
+
+### Changed
+
+- Migrated to the new spago (`spago.yaml` + the published Lua package set) and
+  fixed the push-CI trigger so it runs on `main`.
diff --git a/changelog.d/scriv.ini b/changelog.d/scriv.ini
@@ -0,0 +1,9 @@
+[scriv]
+format = md
+md_header_level = 2
+categories = Added, Changed, Fixed, Removed
+# Hyphen separator (Keep a Changelog style), not scriv's default em dash, so
+# collected entries match the hand-written backfill. The `%` are doubled
+# because scriv reads this file with configparser interpolation, which treats a
+# bare `%` specially; `%%` is an escaped literal `%`.
+entry_title_template = {%% if version %%}{{ version }} - {%% endif %%}{{ date.strftime('%%Y-%%m-%%d') }}
diff --git a/flake.nix b/flake.nix
@@ -45,6 +45,7 @@
             openresty # nginx + lua-nginx-module, for ./scripts/run
             pslua.packages.${system}.default
             purs-bin.purs-0_15_16
+            scriv
             spago-bin.spago-1_0_4
             treefmt
           ];