Merge pull request #680 from git-stunts/release/v18.1.2

release: prepare v18.1.2

Author: flyingrobots

ARCHITECTURE.md

@@ -10,11 +10,13 @@ If you are learning the product for the first time, start with:
 
 ## Release posture
 
-`v18.1.1` is the current release target. Architecturally, it carries the v18
+`v18.1.2` is the current release target. Architecturally, it carries the v18
 read-model closeout from the current `main` release state: `Optic` is a
 runtime noun, observer reading envelopes are explicit, bounded support planning
 is named, the public learning shelf is consolidated under `docs/topics/`, and
-operator workflows live outside that shelf under `docs/operations/`.
+operator workflows live outside that shelf under `docs/operations/`. This patch
+adds a generated source-backed reference gate; it does not add a new runtime
+boundary.
 
 The longer release notes live in [CHANGELOG.md](CHANGELOG.md). The runtime
 architecture below describes current implementation boundaries, not aspirational

CHANGELOG.md

@@ -7,13 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [18.1.2] - 2026-06-25
+
+### Release notes
+
+`v18.1.2` is a release-hygiene and public-reference patch for the v18.1 line.
+It publishes the source-backed reference shelf so package entrypoints, root API
+exports, CLI commands, structured CLI error output, and public error classes
+are generated from source instead of hand-maintained Markdown.
+
+It also carries the corrected release publication path: merged `release/*` PRs
+autotag the exact `main` commit after final preflight, and a JSR scope-member
+maintainer manually dispatches the registry publish workflow for that tag.
+That keeps GitHub Release evidence, npm publication, and JSR OIDC identity
+aligned without relying on bot-dispatched registry publishing.
+
 ### Added
 
 - Added a generated source-backed reference topic for package entrypoints, root
   API exports, CLI commands, structured CLI error output, and public error
   classes, plus a docs-topology gate that fails when the reference drifts from
   source.
 
+### Changed
+
+- Updated release automation and maintainer documentation so release autotagging
+  stops after creating the tag, while npm and JSR publication run from an
+  explicit maintainer-dispatched workflow.
+- Added the source-backed reference topic to release guard and documentation
+  topology checks so release prep fails if the generated reference is missing.
+
 ## [18.1.1] - 2026-06-25
 
 ### Release notes

README.md

@@ -42,10 +42,10 @@ It lets you:
 
 ## Latest release
 
-`v18.1.1` republishes the v18.1 line from the current `main` release state.
-It carries the reified `Optic` read model, observer reading envelopes, bounded
-support planning, the consolidated docs topology, and the upstream
-`@git-stunts/alfred` timeout fix without relying on the old local patch.
+`v18.1.2` publishes the source-backed reference shelf for package entrypoints,
+root API exports, CLI commands, structured CLI errors, and public error classes.
+It also locks the release path to autotag the exact merged `main` commit, then
+publish npm and JSR from a maintainer-dispatched workflow.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full in-repository release notes.
 

docs/topics/README.md

@@ -5,11 +5,13 @@ specific task.
 
 ## Current release
 
-`v18.1.1` focuses the public docs around the shipped v18 read model:
+`v18.1.2` keeps the public docs focused around the shipped v18 read model:
 worldlines, coordinates, reified optics, observers, bounded support, strands,
-Git substrate, sync, CLI, and troubleshooting. Operator workflows live outside
-the topic shelf in [Operations](../operations/). The full release narrative
-lives in the root [CHANGELOG](../../CHANGELOG.md).
+Git substrate, sync, CLI, and troubleshooting. It also adds the generated
+[Source-backed reference](reference.md) for exact package, API, CLI, and error
+inventories. Operator workflows live outside the topic shelf in
+[Operations](../operations/). The full release narrative lives in the root
+[CHANGELOG](../../CHANGELOG.md).
 
 ## Start here
 

jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-warp",
-  "version": "18.1.1",
+  "version": "18.1.2",
   "imports": {
     "roaring": "npm:roaring@^2.7.0"
   },

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-warp",
-  "version": "18.1.1",
+  "version": "18.1.2",
   "description": "Worldline-first WARP graph over Git: deterministic multi-writer causal history, readings, and tooling.",
   "type": "module",
   "license": "Apache-2.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/warp-adapters",
-  "version": "18.1.1",
+  "version": "18.1.2",
   "description": "Infrastructure adapters: Git/CAS, crypto, and HTTP for git-warp.",
   "private": true,
   "type": "module",

packages/warp-adapters/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/warp-kernel",
-  "version": "18.1.1",
+  "version": "18.1.2",
   "description": "Domain engine: services, WarpState, and controllers for git-warp.",
   "private": true,
   "type": "module",

packages/warp-kernel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/warp-orset",
-  "version": "18.1.1",
+  "version": "18.1.2",
   "description": "ORSet engine: trie, cursor, cache, and session primitives for git-warp.",
   "private": true,
   "type": "module",