eric/promptkit-backend-openrouter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Prepare OpenRouter catalog version two contract

Browse Source
This commit is contained in:
Eric Rakestraw
2026-09-22 12:11:24 +00:00
parent 5039cf6b42
commit ad0b16f770
3 changed files with 37 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/release.md
View File

@@ -1,6 +1,18 @@
# Catalog Release Procedure
This repository releases source tags only. It has no generated artifacts.
This repository releases source tags only. It has no generated artifacts. The
module path is `gitea.maximumdirect.net/eric/promptkit-backend-openrouter/v2`.
## Version selection
Release versions use `v2.YYYYMMDD.N`. `YYYYMMDD` is the actual UTC publication
date. Begin at revision `0` for a date and increment `N` for each additional
release on that date. Versions are immutable: correct a published catalog with
a new dated version rather than moving or recreating a tag. This repository
releases independently of other catalog modules, so dates and revisions need
not match theirs.
## Validate the source candidate
Before creating a semantic version tag, start from a clean, synchronized
`main` branch. Confirm that no Go workspace, `replace` directive, or `vendor`
@@ -8,8 +20,13 @@ tree is active, then run `GOWORK=off go test ./...`, `GOWORK=off go test -race
./...`, `GOWORK=off go vet ./...`, `GOWORK=off go build ./...`, formatting,
repository-hygiene, credential, and ordinary module-resolution checks.
Create an annotated tag only after that validation succeeds. Do not create or
move an existing tag. Push `main`, push only the selected tag, and verify the
remote tag identifies the intended commit. Finally, from a temporary module
with `GOWORK=off` and no replacement, resolve the published module version and
verify the resolved version is the selected tag.
Confirm the module reports the `/v2` identity before publication. Create an
annotated tag only after validation succeeds. Do not create or move an existing
tag. Publish the validated source commit through `main`, then push only the
selected annotated tag and verify that the remote tag and its peeled commit
identify that source commit.
Finally, from a temporary module with `GOWORK=off`, no workspace, no
replacement, and no vendor tree, resolve the exact published
`gitea.maximumdirect.net/eric/promptkit-backend-openrouter/v2@version`. Verify
both the resolved module identity and version match the selected tag.