docs: add scriv-managed changelog, backfill fork releases

Unisay · Unisay · commit c19dc14d9500 · 2026-06-25T10:34:18.000+02:00
Adds a CHANGELOG.md managed with scriv (fragments in changelog.d/), provides scriv in the flake dev shell, and records the fork's Lua 5.1 FFI release line. Where the upstream PureScript changelog existed it is preserved below the fork section. The AGENTS.md Releasing note now points at the scriv flow instead of "no changelog entry". Part of the ecosystem-wide changelog adoption (purescript-lua/purescript-lua#101); canon in package-set ADR 0009.
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 `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.
 
 ## Decisions
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,34 @@
 # Changelog
 
-Notable changes to this project are documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+Notable changes to this Lua fork of `purescript-enums` are recorded here. The fork
+tracks its own release line (Lua 5.1 FFI on the [pslua](https://github.com/purescript-lua/purescript-lua)
+compiler); the upstream PureScript history is preserved below. The format
+is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
+fork entries are assembled from fragments in `changelog.d/` with
+[scriv](https://scriv.readthedocs.io/) on each release.
+
+<!-- scriv-insert-here -->
+
+## v6.1.2 - 2026-06-15
+
+### Fixed
+
+- `toCharCode` is length-guarded, so a lone code-unit byte no longer crashes
+  (#102).
+
+## v6.1.1 - 2026-06-15
+
+### Fixed
+
+- `Data.Enum` `toCharCode`/`fromCharCode` handle UTF-8 `Char` code points
+  (#79, #80).
+
+<!-- scriv-end-here -->
+
+---
+
+The sections below are inherited from the upstream PureScript project and
+predate the Lua fork.
 
 ## [Unreleased]
 
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
@@ -44,6 +44,7 @@
             nixfmt-rfc-style
             pslua.packages.${system}.default
             purs-bin.purs-0_15_16
+            scriv
             spago-bin.spago-1_0_4
             treefmt
           ];
