diff --git a/.orly/orly.json b/.orly/orly.json index 2da3c13..62eacf9 100644 --- a/.orly/orly.json +++ b/.orly/orly.json @@ -1,6 +1,6 @@ { "schema_version": 1, - "orly_version": "0.60.2", + "orly_version": "0.60.3", "packs": [ "domain.auth", "domain.changelog", diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 2b18b2a..b0f1294 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## 0.60.3 (2026-11-20) + +A create keyed by a tenant-unique natural key takes no `Idempotency-Key`. + +- **HTTP** — HTTP-IDEMKEY's workspace exception becomes a rule. A retry of such a create answers `409` naming the existing resource, and the client recovers by reading it. Workspace creation and runner registration are the examples. +- **Bun** — orly now needs Bun 1.4.5 or later (`engines.bun` is `>=1.4.5`); the harness, release and test workflows pin 1.4.5. +- **Upgrade** — Run `bunx --bun @agentsfleet/orly@0.60.3 update` after this version is published. + ## 0.60.2 (2026-11-18) SQL identity guidance leaves Universally Unique Identifier (UUID) version validation in the application. diff --git a/package.json b/package.json index aed4f8d..348bd75 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@agentsfleet/orly", - "version": "0.60.2", + "version": "0.60.3", "description": "Repository-scoped engineering harness: renders agent rules, materialises the gates that enforce them, and proves the PR boundary — for any coding agent.", "license": "MIT", "type": "module", diff --git a/standards/domains/http.md b/standards/domains/http.md index c864d7e..b3fadef 100644 --- a/standards/domains/http.md +++ b/standards/domains/http.md @@ -141,8 +141,10 @@ A verb this binary does not serve gets `None` from `handler_for` and answers `40 - **Why:** a client cannot tell a lost response from a lost request, so only the key makes its retry safe. Pure reads and internal-only `POST`s are exempt, and the OpenAPI description lists the endpoints that honor the key. -`POST /v1/workspaces` takes no key: a tenant-unique name makes a retry answer `409`, and clients recover by reading. -That exception covers no other endpoint. + +A create whose resource has a tenant-unique natural key takes no key, and a unique constraint on that key refuses the second row. +A retry answers `409` naming the existing resource, and the client recovers by reading it. +`POST /v1/workspaces` is keyed by the workspace name, and runner registration by the tenant's `host_id`. ### HTTP-MSGKEY — A project or draft `/messages` send carries one UUIDv7 `operation_id` in its body and refuses an `Idempotency-Key` header. - **Applies to:** project and creator-private draft message sends, and draft creation with a first message