Skip to content

fix(http): a tenant-unique natural key replaces Idempotency-Key on create (0.60.3) - #87

Merged
indykish merged 3 commits into
mainfrom
chore/http-idemkey-natural-key
Nov 20, 2026
Merged

indykish merged 3 commits into
mainfrom
chore/http-idemkey-natural-key

Conversation

@indykish

Copy link
Copy Markdown
Contributor

Summary

HTTP-IDEMKEY had one exception, POST /v1/workspaces, and said it covered no other endpoint. This makes the exception a rule:

  • A create whose resource has a tenant-unique natural key takes no Idempotency-Key. 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.
  • Workspace creation (the workspace name) and runner registration (the tenant's host_id) are the examples.

agentsfleet M253_002 §14 needs it: runner registration drops its receipt table and becomes unique on (tenant_id, host_id). A replay under the old receipt carried no token, so the receipt never made a retry useful. Indy approved the change: "Change the rule, drop receipts".

Release: 0.60.3 (package.json, .orly/orly.json, docs/CHANGELOG.md). Consumers pick it up with bunx --bun @agentsfleet/orly@0.60.3 update once the release workflow publishes it.

Verification

orly gate pr on c0b924e:

  • make conform (bin/orly verify): standards.catalogue, generated.root.current, packs.sources.current green
  • bun run typecheck: exit 0
  • bun test src: 591 pass, 0 fail
  • docs.language: changed documentation prose is clean

🤖 Generated with Claude Code

…eate (0.60.3)

HTTP-IDEMKEY's one exception, workspace creation, becomes a rule: a create
whose resource has a tenant-unique natural key takes no key, a unique
constraint refuses the second row, and a retry answers 409 naming the
existing resource so the client recovers by reading it. Runner
registration, keyed by the tenant's host_id, is the second example.

Indy approved the change: "Change the rule, drop receipts".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

indykish and others added 2 commits November 20, 2026 21:38
Main's #86 raised engines.bun to >=1.4.5 without a version bump, so 0.60.3
ships it beside the HTTP-IDEMKEY change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@indykish
indykish merged commit d21a063 into main Nov 20, 2026
4 checks passed
@indykish
indykish deleted the chore/http-idemkey-natural-key branch November 20, 2026 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants