From 85fb9113a9d619cdd9565962ff7eae84abdff4a4 Mon Sep 17 00:00:00 2001
From: zzstoatzz <thrast36@gmail.com>
Date: Wed, 10 Jun 2026 14:17:27 -0500
Subject: [PATCH] Prepare v0.0.2 release

---
 Dockerfile         |  2 +-
 README.md          |  1 +
 build.zig          |  2 +-
 build.zig.zon      |  2 +-
 docs/operations.md | 21 +++++++++++++++++++++
 justfile           |  6 ++++++
 6 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 405a299..1187dba 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -7,7 +7,7 @@ RUN apt-get update \
     && rm -rf /var/lib/apt/lists/*
 
 ARG ZIG_VERSION=0.16.0
-ARG ZDS_VERSION=0.0.1
+ARG ZDS_VERSION=0.0.2
 ARG BUILDARCH
 ARG TARGETARCH=amd64
 RUN set -eux; \
diff --git a/README.md b/README.md
index 21ddaae..78ae54e 100644
--- a/README.md
+++ b/README.md
@@ -109,6 +109,7 @@ to publish:
 just docker-publish
 just docker-publish v0.1.0
 just docker-publish-current
+just docker-publish-release v0.0.2
 ```
 
 </details>
diff --git a/build.zig b/build.zig
index e04df00..1722d95 100644
--- a/build.zig
+++ b/build.zig
@@ -3,7 +3,7 @@ const std = @import("std");
 pub fn build(b: *std.Build) void {
     const target = b.standardTargetOptions(.{});
     const optimize = b.standardOptimizeOption(.{});
-    const version = b.option([]const u8, "version", "Build version reported by /xrpc/_health") orelse "0.0.1";
+    const version = b.option([]const u8, "version", "Build version reported by /xrpc/_health") orelse "0.0.2";
 
     const zat = b.dependency("zat", .{
         .target = target,
diff --git a/build.zig.zon b/build.zig.zon
index b7f1da8..46f38ea 100644
--- a/build.zig.zon
+++ b/build.zig.zon
@@ -1,6 +1,6 @@
 .{
     .name = .zds,
-    .version = "0.0.1",
+    .version = "0.0.2",
     .fingerprint = 0x6ebabab1f62e1904,
     .minimum_zig_version = "0.16.0",
     .dependencies = .{
diff --git a/docs/operations.md b/docs/operations.md
index dc72e5a..7a945a6 100644
--- a/docs/operations.md
+++ b/docs/operations.md
@@ -127,6 +127,27 @@ Publish commands:
 just docker-publish
 just docker-publish v0.1.0
 just docker-publish-current
+just docker-publish-release v0.0.2
+```
+
+## releases
+
+ZDS uses SemVer tags (`vMAJOR.MINOR.PATCH`). Before `v1.0.0`, patch releases
+are still appropriate for user-visible compatibility fixes and operator-safe
+bug fixes. Minor releases are for meaningful protocol surface, storage shape,
+or operator workflow changes. Major releases are reserved for explicit
+incompatible production contracts once ZDS declares a stable surface.
+
+Release checklist:
+
+```sh
+just test
+just smoke
+git diff --check
+zig zen
+git tag -a vX.Y.Z -m "vX.Y.Z"
+git push origin main vX.Y.Z
+just docker-publish-release vX.Y.Z
 ```
 
 ## migration
diff --git a/justfile b/justfile
index f046b00..0a13792 100644
--- a/justfile
+++ b/justfile
@@ -46,3 +46,9 @@ docker-publish tag="latest" platform="linux/amd64" arch="amd64":
 docker-publish-current:
     just docker-publish latest
     just docker-publish $(git rev-parse --short=12 HEAD)
+
+# publish latest, a semver tag, and the current git commit tag
+docker-publish-release version:
+    just docker-publish {{version}}
+    just docker-publish latest
+    just docker-publish $(git rev-parse --short=12 HEAD)
-- 
2.51.2