Prepare OpenRouter catalog version two contract

README.md

@@ -17,11 +17,19 @@ consequence of extracting a dependency.
 
 ## Compatibility
 
-Catalog IDs are stable. New profiles are additive. Corrections are released as
+This compatibility policy applies to the `/v2` module. Catalog profiles track
-compatible catalog updates when they preserve the profile contract; deprecated
+upstream availability and may be added, removed, renamed, or modified without
-profiles are announced before removal in a compatible-major release. Manifest
+deprecation or advance notice. Consumers that need a particular profile set
-schema changes follow semantic-version compatibility rules and retain support
+should use the catalog version selected by their Promptkit release.
-for compatible published catalog versions.
+
+Backend definitions, the exported Go API, and the catalog manifest schema do
+not share that profile-data exception. Their compatibility follows the normal
+semantic-versioning rules. Published v1 releases retain their historical
+contract; this README does not retroactively alter it.
+
+Catalog releases use dated versions in the form `v2.YYYYMMDD.N`. The date
+identifies when the catalog snapshot was published in UTC; it does not certify
+that a provider currently offers a model or endpoint named by the data.
 
 ## Validation and releases
 

catalog/profiles/google/gemini-2-flash-lite.yml

@@ -1,8 +0,0 @@
-id: gemini-2-flash-lite
-backend: openrouter
-model: "google/gemini-2.5-flash-lite"
-#temperature: 0.15
-reasoning_effort: high
-#top_p: 0.98
-timeout_seconds: 240
-service_tier: flex

catalog/profiles/google/gemini-2-flash.yml

@@ -1,8 +0,0 @@
-id: gemini-2-flash
-backend: openrouter
-model: "google/gemini-2.5-flash"
-#temperature: 0.15
-reasoning_effort: high
-#top_p: 0.98
-timeout_seconds: 240
-service_tier: flex

catalog/profiles/google/gemini-2-pro.yml

@@ -1,8 +0,0 @@
-id: gemini-2-pro
-backend: openrouter
-model: "google/gemini-2.5-pro"
-#temperature: 0.15
-reasoning_effort: high
-#top_p: 0.98
-timeout_seconds: 240
-service_tier: flex

catalog/profiles/google/gemini-3-5-flash-lite.yml

@@ -0,0 +1,4 @@
+id: gemini-3-5-flash-lite
+backend: openrouter
+model: "google/gemini-3.5-flash-lite"
+service_tier: flex

catalog/profiles/google/gemini-3-5-flash.yml

@@ -0,0 +1,4 @@
+id: gemini-3-5-flash
+backend: openrouter
+model: "google/gemini-3.5-flash"
+service_tier: flex

catalog/profiles/google/gemini-3-6-flash.yml

@@ -0,0 +1,4 @@
+id: gemini-3-6-flash
+backend: openrouter
+model: "google/gemini-3.6-flash"
+service_tier: flex

catalog/profiles/google/gemini-3-7-flash.yml

@@ -0,0 +1,4 @@
+id: gemini-3-7-flash
+backend: openrouter
+model: "google/gemini-3.7-flash"
+service_tier: flex

catalog/profiles/google/gemini-3-8-flash.yml

@@ -0,0 +1,4 @@
+id: gemini-3-8-flash
+backend: openrouter
+model: "google/gemini-3.8-flash"
+service_tier: flex

catalog/profiles/openai/gpt-5-6-luna.yml

@@ -0,0 +1,4 @@
+id: gpt-5-6-luna
+backend: openrouter
+model: "openai/gpt-5.6-luna"
+service_tier: flex

catalog/profiles/openai/gpt-5-6-sol.yml

@@ -0,0 +1,4 @@
+id: gpt-5-6-sol
+backend: openrouter
+model: "openai/gpt-5.6-sol"
+service_tier: flex

catalog/profiles/openai/gpt-5-6-terra.yml

@@ -0,0 +1,4 @@
+id: gpt-5-6-terra
+backend: openrouter
+model: "openai/gpt-5.6-terra"
+service_tier: flex

catalog/profiles/openai/gpt-5-mini.yml

@@ -1,6 +0,0 @@
-id: gpt-5-mini
-backend: openrouter
-model: "openai/gpt-5.4-mini"
-reasoning_effort: high
-timeout_seconds: 240
-service_tier: flex

catalog/profiles/openai/gpt-5-nano.yml

@@ -1,6 +0,0 @@
-id: gpt-5-nano
-backend: openrouter
-model: "openai/gpt-5.4-nano"
-reasoning_effort: high
-timeout_seconds: 240
-service_tier: flex

catalog/profiles/openai/gpt-6-astra.yml

@@ -0,0 +1,4 @@
+id: gpt-6-astra
+backend: openrouter
+model: "openai/gpt-6-astra"
+service_tier: flex

catalog/profiles/openai/gpt-astra-latest.yml

@@ -0,0 +1,4 @@
+id: gpt-astra-latest
+backend: openrouter
+model: "~openai/gpt-astra-latest"
+service_tier: flex

catalog/profiles/openai/gpt-luna-latest.yml

@@ -0,0 +1,4 @@
+id: gpt-luna-latest
+backend: openrouter
+model: "~openai/gpt-luna-latest"
+service_tier: flex

catalog/profiles/openai/gpt-sol-latest.yml

@@ -0,0 +1,4 @@
+id: gpt-sol-latest
+backend: openrouter
+model: "~openai/gpt-sol-latest"
+service_tier: flex

catalog/profiles/openai/gpt-terra-latest.yml

@@ -0,0 +1,4 @@
+id: gpt-terra-latest
+backend: openrouter
+model: "~openai/gpt-terra-latest"
+service_tier: flex

docs/release.md

@@ -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
+Confirm the module reports the `/v2` identity before publication. Create an
-move an existing tag. Push `main`, push only the selected tag, and verify the
+annotated tag only after validation succeeds. Do not create or move an existing
-remote tag identifies the intended commit. Finally, from a temporary module
+tag. Publish the validated source commit through `main`, then push only the
-with `GOWORK=off` and no replacement, resolve the published module version and
+selected annotated tag and verify that the remote tag and its peeled commit
-verify the resolved version is the selected tag.
+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.

go.mod

@@ -1,4 +1,4 @@
-module gitea.maximumdirect.net/eric/promptkit-backend-openrouter
+module gitea.maximumdirect.net/eric/promptkit-backend-openrouter/v2
 
 go 1.25.5