Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Docs: plans update

Damian Legawiec326e3d83bc33
diff --git a/CLAUDE.md b/CLAUDE.md
index 0f1518ca72..525bb7ceeb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -11,42 +11,49 @@ When proposing significant architectural changes:
Use `/project:create-plan` and `/project:update-plan` for plan management.
-Current plans:
+Active plans (6.0 target, work pending):
- `6.0-cart-order-split.md` — Cart/Order model separation, polymorphic LineItem
- `6.0-admin-api.md` — Admin REST API conventions, auth, endpoint list (~300 endpoints)
- `6.0-admin-spa.md` — React admin architecture, extension points, table registry
- `6.0-product-types.md` — Prototype → ProductType rename, MetafieldDefinition schema enforcement
- `6.0-remove-master-variant.md` — Eliminate is_master, add default_variant_id FK on Product
- `6.0-split-adjustments.md` — Replace polymorphic Adjustment with TaxLine, Discount, Fee
-- `6.0-stock-reservations.md` — Time-limited stock reservations during checkout
- `6.0-typed-stock-movements.md` — Replace generic StockMovement with typed kinds + concrete FKs
- `6.0-normalize-state-to-status.md` — Rename state → status on Payment, Shipment, InventoryUnit, ReturnAuthorization, GiftCard
- `6.0-fulfillment-and-delivery.md` — Shipment→Fulfillment, ShippingMethod→DeliveryMethod, drop ShippingCategory, FulfillmentProvider strategy, pickup (merchant StockLocation) + pickup_point (third-party PickupPointProvider)
- `6.0-returns-exchanges-claims.md` — First-class Return, Exchange, Claim models replacing ReturnAuthorization/Reimbursement chain
-- `6.0-channels-catalogs-b2b.md` — Channel, Catalog, ProductListing (replaces StoreProduct), Company/CompanyLocation/CompanyContact for B2B
-- `6.0-platform-auth.md` — Drop Devise, own auth stack, User→Customer/Staff rename
-- `5.4-search-provider.md` — Pluggable SearchProvider interface (5.4: Database + Meilisearch, 6.0: MetafieldDefinition faceting)
+- `6.0-channels-catalogs-b2b.md` — Channel, Catalog, ProductListing (replaces StoreProduct), Company/CompanyLocation/CompanyContact for B2B (Channel shipped in 5.5)
+- `6.0-platform-auth.md` — Drop Devise, own auth stack, User→Customer/Staff rename (RefreshToken shipped in 5.4)
- `6.0-tax-provider.md` — Per-Market TaxProvider, replaces TaxRate.adjust + Calculator, drop Zone model (TaxRate gets direct country/state FKs)
- `6.0-delivery-rate-provider.md` — Per-DeliveryMethod DeliveryRateProvider, replaces Estimator + Calculator, DeliveryZone with postal code support
-- `6.0-rich-text-descriptions.md` — Drop ActionText storage, store HTML in text columns, sanitize on write, serve `description` + `description_html` in API
-- `5.4-store-api-naming-standardization.md` — Standardize API naming against industry (address fields, discounts, customer_note, label, brand/last4, etc.)
-- `5.4-6.0-eu-legal-compliance.md` — GDPR (data export/anonymization, consent timestamps), Omnibus (PriceHistory, lowest-in-30-days), Consumer Rights (withdrawal period). Core primitives + enterprise hooks.
-- `6.0-order-routing.md` — Two-tier extension: pluggable `Spree::OrderRouting::Strategy::Base` (whole algorithms) + STI subclasses of `Spree::OrderRoutingRule` (signals consumed by `Rules` strategy). Adds `Spree::Order.preferred_stock_location_id`, `Spree::Order.channel_id` (FK replacing the deprecated string column), `Spree::Channel`, `Spree::OrderRoutingRule`. Phase 1 (5.5) ships channel-scoped rules + minimal `Spree::Channel`; Phase 2 (6.0) layers ProductListing/Catalog/Company on top via `6.0-channels-catalogs-b2b.md`.
-- `5.5-6.0-order-cancellation-and-approval.md` — First-class `OrderCancellation` + `OrderApproval` models, capture reasons/restock/refund decisions, polymorphic actor; 6.0 drops denormalized columns
-- `5.5-admin-api-key-scopes.md` — Shopify-style `read_*`/`write_*` scopes on `Spree::ApiKey` for Admin API authorization (apps), independent of CanCanCan (which stays for JWT users)
-- `5.4-disjunctive-option-faceting.md` — Per-option-type filter params with disjunctive facet counts (OR within option type, AND across)
-- `5.4-option-type-enhancements.md` — Add `kind` (dropdown/color_swatch/buttons) to OptionType, `color_code` + `image` to OptionValue for swatch support
-- `5.4-6.0-custom-fields-rename.md` — Rename Metafields → Custom Fields (5.4 API bridge + 6.0 model rename)
+- `6.0-rich-text-descriptions.md` — Drop ActionText storage, store HTML in text columns, sanitize on write, serve `description` + `description_html` in API (description_html serializer field shipped in 5.4)
+- `6.0-inventory-operations.md` — StockTransfer lifecycle (draft → ready_to_ship → in_transit → received with partial receive), new `Spree::PurchaseOrder` + `Spree::Vendor` replacing today's "external receive" hack, variant + stock-location stock history panels. Consumes the typed-movement primitives from `6.0-typed-stock-movements.md`.
+- `6.0-replace-taxons-with-categories.md` — Split Taxon into Category (hierarchy) + Collection (flat/rule-based). `Spree::Category < Spree::Taxon` alias + Category API surface shipped in 5.5; table rename + Collection pending.
+
+Multi-version plans (some phases shipped, some pending):
+- `5.4-store-api-naming-standardization.md` — Standardize API naming against industry (address fields, discounts, customer_note, label, brand/last4, etc.). 5.4 model/API aliases shipped; 6.0 column/table renames pending.
+- `5.4-6.0-eu-legal-compliance.md` — GDPR (data export/anonymization, consent timestamps), Omnibus (PriceHistory, lowest-in-30-days), Consumer Rights (withdrawal period). 5.4 PriceHistory + `prior_price` shipped; GDPR endpoints + withdrawal period still pending.
+- `5.4-6.0-custom-fields-rename.md` — Rename Metafields → Custom Fields. 5.4 API bridge + 5.5 `Spree::CustomField`/`CustomFieldDefinition` constant aliases shipped; 6.0 model/table rename pending.
+- `5.4-6.0-product-media-system.md` — Product-level media gallery. 5.5 data model (spree_variant_media, media_type, focal_point, external_video_url) shipped; admin UIs in progress; 6.0 cleanup pending.
+- `5.5-6.0-order-cancellation-and-approval.md` — First-class `OrderCancellation` + `OrderApproval` models. 5.5 models + migrations shipped; 6.0 drops denormalized columns.
+- `5.5-6.0-display-on-to-boolean.md` — Collapse `display_on` tri-state to a single `storefront_visible` boolean. 5.5 bridge (`storefront_visible` accessor + Ransacker on `Spree::DisplayOn`) shipped; 6.0 schema rename pending.
+- `6.0-order-routing.md` — Two-tier extension: pluggable `Spree::OrderRouting::Strategy::Base` + STI subclasses of `Spree::OrderRoutingRule`. Phase 1 (5.5) shipped: `Channel`, `OrderRoutingRule`, strategy base + Rules + Reducer + Legacy, `preferred_stock_location_id` + `channel_id` on Order. Phase 2+ (6.0) layers ProductListing/Catalog/Company on top via `6.0-channels-catalogs-b2b.md`.
+
+Pending design work (drafts, no implementation yet):
- `5.4-centralized-translations-admin.md` — Centralized Translations admin page under Products, overview grid + bulk CSV import/export
- `5.4-metafield-translations.md` — Translate MetafieldDefinition names + Metafield text values (ShortText, LongText, RichText) via Mobility translation tables
-- `5.5-admin-auth-cookie-refresh.md` — Move admin SPA refresh token to httpOnly cookie, access token in memory, double-submit CSRF, server-side logout that destroys RefreshToken row. Breaking change shipped as a single coordinated bump (admin-sdk is unreleased)
-- `5.5-admin-spa-csv-export.md` — Reuse existing `Spree::Export` infra; add Admin API CRUD + `client.exports` SDK + toolbar button/modal + polling flow on Products/Orders/Customers index pages. Filters round-trip via Ransack JSON; download via short-lived signed Blob URL
-- `5.5-6.0-display-on-to-boolean.md` — Collapse `display_on` tri-state on PaymentMethod + ShippingMethod/DeliveryMethod to a single `storefront_visible` boolean. 5.5 ships `alias_attribute` + dual serializer fields; 6.0 drops the column and the `Spree::DisplayOn` concern. Mirrors the custom-fields rename pattern.
-- `6.0-inventory-operations.md` — StockTransfer lifecycle (draft → ready_to_ship → in_transit → received with partial receive), new `Spree::PurchaseOrder` + `Spree::Vendor` replacing today's "external receive" hack, variant + stock-location stock history panels. Consumes the typed-movement primitives from `6.0-typed-stock-movements.md`.
-Completed plans:
-- `5.4-store-api-bridges.md` — Bridge 6.0 naming into 5.4 Store API (implemented, PR #13782)
-- `spree-starter-and-create-spree-app.md` — Replace monorepo server/ with spree-starter template repo
+Shipped plans:
+- `5.4-store-api-bridges.md` — Bridge 6.0 naming into 5.4 Store API (PR #13782)
+- `5.4-spree-starter-and-create-spree-app.md` — Replace monorepo server/ with spree-starter template repo
+- `5.4-option-type-enhancements.md` — `kind` (dropdown/color_swatch/buttons) on OptionType + `color_code` on OptionValue
+- `5.4-search-provider.md` — Pluggable SearchProvider interface (Database + Meilisearch); PgSearch + `add_search_scope` removed (6.0 MetafieldDefinition faceting still pending)
+- `5.4-disjunctive-option-faceting.md` — Per-option-type filter params with disjunctive facet counts (`FiltersAggregator` for DB, `merge_disjunctive_facets` for Meilisearch)
+- `6.0-stock-reservations.md` — Time-limited stock reservations during checkout (PR #13978; Cart/Order split integration + `allocated_count` term still pending for 6.0)
+- `5.5-admin-api-key-scopes.md` — Shopify-style `read_*`/`write_*` scopes on `Spree::ApiKey` for app authorization
+- `5.5-admin-auth-cookie-refresh.md` — Admin SPA refresh token in httpOnly cookie, access token in memory, server-side logout
+- `5.5-admin-customers-api.md` — Admin Customers + nested addresses/credit_cards/store_credits + CustomerGroups
+- `5.5-admin-spa-csv-export.md` — Admin API ExportsController + admin-sdk + `useExport` + toolbar export button
## Monorepo Structure
diff --git a/docs/plans/5.4-6.0-eu-legal-compliance.md b/docs/plans/5.4-6.0-eu-legal-compliance.md
index 7d04352682..344995e820 100644
--- a/docs/plans/5.4-6.0-eu-legal-compliance.md
+++ b/docs/plans/5.4-6.0-eu-legal-compliance.md
@@ -1,10 +1,10 @@
# EU Legal Compliance (GDPR, Omnibus, Consumer Rights)
-**Status:** Draft
-**Target:** Spree 5.4 (Phase 1), Spree 6.0 (Phase 2)
+**Status:** Phase 1 partially shipped (`Spree::PriceHistory` model + migration + `prior_price` on Price); GDPR data export/anonymization endpoints + Consumer Rights withdrawal still pending; Phase 2 pending
+**Target:** Spree 5.4 (Phase 1 — partial), Spree 6.0 (Phase 2)
**Depends on:** 6.0-platform-auth.md (Customer/Staff rename), 6.0-channels-catalogs-b2b.md (Market-level config)
**Author:** Damian + Claude
-**Last updated:** 2026-03-23
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.4-6.0-product-media-system.md b/docs/plans/5.4-6.0-product-media-system.md
index fbe11bdd2b..b129996d28 100644
--- a/docs/plans/5.4-6.0-product-media-system.md
+++ b/docs/plans/5.4-6.0-product-media-system.md
@@ -1,10 +1,10 @@
# Product Media System
-**Status:** In Progress
-**Target:** Spree 5.4 (foundation) + Spree 5.5 (data model + admin UIs) + Spree 6.0 (cleanup with master removal)
+**Status:** 5.5 data model shipped (PR #14000 — `spree_variant_media`, `media_type`, `focal_point_x/y`, `external_video_url`, column renames); admin UIs in progress; 6.0 cleanup pending
+**Target:** Spree 5.4 (foundation) + Spree 5.5 (data model + admin UIs ✓ data model) + Spree 6.0 (cleanup with master removal)
**Depends on:** None
**Author:** Damian + Claude
-**Last updated:** 2026-05-11
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.4-disjunctive-option-faceting.md b/docs/plans/5.4-disjunctive-option-faceting.md
index 744083d8d9..ca83a299ca 100644
--- a/docs/plans/5.4-disjunctive-option-faceting.md
+++ b/docs/plans/5.4-disjunctive-option-faceting.md
@@ -1,10 +1,10 @@
# Disjunctive Option Value Faceting
-**Status:** In Progress
+**Status:** Shipped in 5.4 (`FiltersAggregator` for Database provider, `merge_disjunctive_facets` for Meilisearch provider)
**Target:** Spree 5.4
**Depends on:** `5.4-search-provider.md` (SearchProvider interface)
**Author:** Damian
-**Last updated:** 2026-03-26
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.4-search-provider.md b/docs/plans/5.4-search-provider.md
index 94910b2d79..08e595b9c3 100644
--- a/docs/plans/5.4-search-provider.md
+++ b/docs/plans/5.4-search-provider.md
@@ -1,10 +1,10 @@
# Search Provider Interface
-**Status:** In progress
-**Target:** Spree 5.4 (provider + DB provider + PgSearch removal + add_search_scope removal + Meilisearch provider), 6.0 (metafield faceting)
+**Status:** 5.4 portion shipped (`Spree::SearchProvider::Base/Database/Meilisearch`, PgSearch removed, `add_search_scope` removed); 6.0 metafield faceting pending
+**Target:** Spree 5.4 (provider + DB provider + PgSearch removal + add_search_scope removal + Meilisearch provider ✓), 6.0 (metafield faceting)
**Depends on:** None for 5.4. ProductType (6.0-product-types.md) for metafield faceting in 6.0.
**Author:** Damian + Claude
-**Last updated:** 2026-03-18
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.4-store-api-naming-standardization.md b/docs/plans/5.4-store-api-naming-standardization.md
index 2887045ddc..bc37b188c6 100644
--- a/docs/plans/5.4-store-api-naming-standardization.md
+++ b/docs/plans/5.4-store-api-naming-standardization.md
@@ -1,10 +1,10 @@
# Store API Naming Standardization
-**Status:** In Progress
-**Target:** Spree 5.4 (API surface + model aliases); Spree 6.0 (database columns/tables)
+**Status:** 5.4 portion largely shipped (API + model aliases: `customer_note`, `billing/shipping_address`, `label`, `last4`, `brand`, etc.); 6.0 column/table renames pending
+**Target:** Spree 5.4 (API surface + model aliases ✓); Spree 6.0 (database columns/tables)
**Depends on:** `5.4-store-api-bridges.md` (same pattern: rename API surface now, models/DB later)
**Author:** Damian + Claude
-**Last updated:** 2026-03-19
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-6.0-custom-fields-rename.md b/docs/plans/5.5-6.0-custom-fields-rename.md
index a5402ec175..02aff8e29a 100644
--- a/docs/plans/5.5-6.0-custom-fields-rename.md
+++ b/docs/plans/5.5-6.0-custom-fields-rename.md
@@ -1,10 +1,10 @@
# Metafields → Custom Fields Rename
-**Status:** In Progress — 5.4 serializer bridge shipped; 5.5 CRUD API + SDK + alias classes shipping; 6.0 model rename pending
-**Target:** 5.4 (Store API serializer bridge, shipped) + 5.5 (Admin CRUD API + SDK + `Spree::CustomField` constant alias) + 6.0 (model/table rename + visibility simplification + STI rename)
+**Status:** 5.4 serializer bridge ✓; 5.5 alias classes (`Spree::CustomField`, `Spree::CustomFieldDefinition`) ✓; 6.0 model/table rename pending
+**Target:** 5.4 (Store API serializer bridge ✓) + 5.5 (Admin CRUD API + SDK + `Spree::CustomField` constant alias ✓) + 6.0 (model/table rename + visibility simplification + STI rename)
**Depends on:** None — 5.4/5.5 changes are additive. 6.0 rename is part of the model rename wave.
**Author:** Damian + Claude
-**Last updated:** 2026-05-04
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-6.0-display-on-to-boolean.md b/docs/plans/5.5-6.0-display-on-to-boolean.md
index ef05b0a584..1d5b3cae4a 100644
--- a/docs/plans/5.5-6.0-display-on-to-boolean.md
+++ b/docs/plans/5.5-6.0-display-on-to-boolean.md
@@ -1,10 +1,10 @@
# `display_on` → `storefront_visible` (PaymentMethod, ShippingMethod / DeliveryMethod)
-**Status:** Draft
-**Target:** 5.5 (API alias + `alias_attribute` shim) + 6.0 (schema rename, drop the `Spree::DisplayOn` tri-state concern)
+**Status:** 5.5 bridge shipped (`storefront_visible` accessor + Ransacker on the `Spree::DisplayOn` concern); 6.0 schema rename + concern drop pending
+**Target:** 5.5 (API alias + `alias_attribute` shim ✓) + 6.0 (schema rename, drop the `Spree::DisplayOn` tri-state concern)
**Depends on:** `5.5-6.0-custom-fields-rename.md` (same bridge pattern, already in flight). `6.0-fulfillment-and-delivery.md` (drives the `ShippingMethod → DeliveryMethod` rename — this plan piggybacks on that wave).
**Author:** Damian + Claude
-**Last updated:** 2026-05-15
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-6.0-order-cancellation-and-approval.md b/docs/plans/5.5-6.0-order-cancellation-and-approval.md
index b29c1cd5eb..8938de19ab 100644
--- a/docs/plans/5.5-6.0-order-cancellation-and-approval.md
+++ b/docs/plans/5.5-6.0-order-cancellation-and-approval.md
@@ -1,10 +1,10 @@
# Order Cancellation & Approval Models
-**Status:** Draft
-**Target:** Spree 5.5 (models + API) and 6.0 (drop denormalized columns, B2B order-side approvals)
+**Status:** 5.5 shipped (OrderCancellation + OrderApproval models + migrations); 6.0 cleanup (drop denormalized columns) pending
+**Target:** Spree 5.5 (models + API ✓) and 6.0 (drop denormalized columns, B2B order-side approvals)
**Depends on:** `6.0-admin-api.md`, `6.0-channels-catalogs-b2b.md`, `6.0-cart-order-split.md`
**Author:** Damian + Claude
-**Last updated:** 2026-04-29
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-admin-api-key-scopes.md b/docs/plans/5.5-admin-api-key-scopes.md
index 56023be5e1..a86461e0ca 100644
--- a/docs/plans/5.5-admin-api-key-scopes.md
+++ b/docs/plans/5.5-admin-api-key-scopes.md
@@ -1,10 +1,10 @@
# Admin API Key Scopes
-**Status:** Design Finalized
+**Status:** Shipped in 5.5
**Target:** Spree 5.5
**Depends on:** `6.0-admin-api.md`
**Author:** Damian
-**Last updated:** 2026-04-29
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-admin-auth-cookie-refresh.md b/docs/plans/5.5-admin-auth-cookie-refresh.md
index ae06490965..9751690d07 100644
--- a/docs/plans/5.5-admin-auth-cookie-refresh.md
+++ b/docs/plans/5.5-admin-auth-cookie-refresh.md
@@ -1,11 +1,11 @@
# Admin Auth — Cookie-Backed Refresh Tokens
-**Status:** Design Finalized — implementation on PR for Spree 5.5
+**Status:** Shipped in 5.5
**Target:** Spree 5.5
**Depends on:** `6.0-admin-spa.md`
**Related:** `6.0-platform-auth.md` (broader auth direction, lands in 6.0)
**Author:** Damian Legawiec
-**Last updated:** 2026-05-06
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-admin-customers-api.md b/docs/plans/5.5-admin-customers-api.md
index b5515f0998..cdbb377f5b 100644
--- a/docs/plans/5.5-admin-customers-api.md
+++ b/docs/plans/5.5-admin-customers-api.md
@@ -1,10 +1,10 @@
# Admin Customers API
-**Status:** Draft
+**Status:** Shipped in 5.5 (CustomersController + nested addresses, credit_cards, store_credits; CustomerGroupsController)
**Target:** Spree 5.5
**Depends on:** `6.0-admin-api.md`, `6.0-platform-auth.md`, `5.4-6.0-eu-legal-compliance.md`
**Author:** damian
-**Last updated:** 2026-04-28
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/5.5-admin-spa-csv-export.md b/docs/plans/5.5-admin-spa-csv-export.md
index f70cef59ae..69c60e895c 100644
--- a/docs/plans/5.5-admin-spa-csv-export.md
+++ b/docs/plans/5.5-admin-spa-csv-export.md
@@ -1,10 +1,10 @@
# Admin SPA CSV Export
-**Status:** Draft
+**Status:** Shipped in 5.5 (ExportsController + admin-sdk + `useExport` + `export-button.tsx`)
**Target:** Spree 5.5
**Depends on:** `6.0-admin-spa.md`, `6.0-admin-api.md`, `5.5-admin-api-key-scopes.md`
**Author:** Damian Legawiec
-**Last updated:** 2026-05-07
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/6.0-order-routing.md b/docs/plans/6.0-order-routing.md
index c6e6c556a0..c9b8a935a8 100644
--- a/docs/plans/6.0-order-routing.md
+++ b/docs/plans/6.0-order-routing.md
@@ -1,10 +1,10 @@
# Order Routing
-**Status:** Design Finalized
-**Target:** Spree 5.5 (Phase 1) → 6.0 (Phase 2+)
+**Status:** Phase 1 shipped in 5.5 (Channel + OrderRoutingRule + strategy base/Rules/Reducer/Legacy); Phase 2+ pending in 6.0
+**Target:** Spree 5.5 (Phase 1 ✓) → 6.0 (Phase 2+)
**Depends on:** none for Phase 1; 6.0 phases extend `6.0-channels-catalogs-b2b.md`, `6.0-stock-reservations.md`, `6.0-typed-stock-movements.md`, `6.0-cart-order-split.md`
**Author:** Damian + Claude
-**Last updated:** 2026-05-10
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/6.0-replace-taxons-with-categories.md b/docs/plans/6.0-replace-taxons-with-categories.md
index c78ef30c9e..0882b88100 100644
--- a/docs/plans/6.0-replace-taxons-with-categories.md
+++ b/docs/plans/6.0-replace-taxons-with-categories.md
@@ -1,10 +1,10 @@
# Replace Taxons with Categories & Add Collections
-**Status:** Design finalized, implementation not started
-**Target:** Spree 6.0
+**Status:** API/serializer bridge shipped in 5.5 (`Spree::Category < Spree::Taxon` constant alias + `categories` controllers/serializers/associations); table rename + `Collection` split + rule engine pending in 6.0
+**Target:** Spree 6.0 (5.5 ships the `Spree::Category` alias + Category API surface; 6.0 renames the table and adds `Collection`)
**Depends on:** API v3 conventions, ProductType plan (6.0-product-types.md)
**Author:** Damian + Claude
-**Last updated:** 2026-03-16
+**Last updated:** 2026-05-20
## Summary
diff --git a/docs/plans/6.0-stock-reservations.md b/docs/plans/6.0-stock-reservations.md
index 3fee564996..80e94bc60a 100644
--- a/docs/plans/6.0-stock-reservations.md
+++ b/docs/plans/6.0-stock-reservations.md
@@ -1,10 +1,10 @@
# Stock Reservations
-**Status:** Implementation in progress (5.5)
-**Target:** Spree 5.5 (Store API + Admin API), refined in 6.0 (Cart/Order split integration, allocated_count term)
+**Status:** Shipped in 5.5 (PR #13978); 6.0 refinements (Cart/Order split integration, `allocated_count` term) still pending
+**Target:** Spree 5.5 (Store API + Admin API ✓), refined in 6.0 (Cart/Order split integration, allocated_count term)
**Depends on:** None for 5.5. In 6.0: Cart/Order split (6.0-cart-order-split.md), Typed Stock Movements (6.0-typed-stock-movements.md)
**Author:** Damian + Claude
-**Last updated:** 2026-05-01
+**Last updated:** 2026-05-20
## Summary