portage-ucp 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a245e863596f643972f10c9be20792055d6bf1d2925b90373571966896ee429a
-  data.tar.gz: ad0008e190d5c865e613b616653a7d5dbd5f6b19166f8f71723e57ae70ef7ce0
+  metadata.gz: 3030cd7b510d8e0e829878dd48ab11fd18f70e0d0e5cac5107852ead26a0077c
+  data.tar.gz: 7e6abed9cd7ea40da3ee5f8681ec69f80a6f8c852e8956901f4fce1b383816da
 SHA512:
-  metadata.gz: d9a93b39705265b1095da290e5615ddbfcf3d3ea529d9b5863308ad99819c70b11ed77bc9805444a003b78c61bb418d4faa756617148d74b964b88beb90b5330
-  data.tar.gz: c2c95f6b3217ea2c2dc6b86318eaa845677b45c753b707ad2eb17f2ae7599f92fe457f7f82a34d46cfea26f1b5bfa8bc17ff4ee46459c94967c6de5ed6286611
+  metadata.gz: 4c4dddb8b6aaeaa674d270400287420f3bcbbfc028c8d38b9482fe53fe2cb47b493711cd7fffe50051b892b49f720f4332ba0e3af89fe595df9d46cdf80c5306
+  data.tar.gz: 5b1c1ee5a21fae8d7c8821c43820bcdcca15f54001e9d6e25af3b4916965da69a1bedb144faadb06ec222c11a59d3cd7e60c753579a4d8931924f51e62f06b78

data/CHANGELOG.md

@@ -6,6 +6,10 @@ pre-1.0, so APIs may still shift between minor versions.
 
 ## [Unreleased]
 
+## [0.15.0] - 2026-10-13
+
+- **Added: optional `policies:` on `Cart`, `Checkout`, `Order`, `Product`, `CatalogSearchResult` and `ProductDetail`** (UCP 2026-08-25 `policies[]`). An array of `policy.json` hashes (`type` and `description` required; `applies_to` and `url` optional), default `[]`, omitted from the wire payload when empty. `portage-ucp-shopify` 0.7.0 supplies it (design-log §60).
+
 ## [0.14.0] - 2026-10-09
 
 Moves the gem to UCP 2026-08-25 (design-log §56-58). Minor-level for a pre-1.0 gem, with breaking config changes below.

data/lib/portage/ucp/adapter.rb

@@ -105,7 +105,7 @@ module Portage
 
       # --- Reorder (app.portage-ucp.reorder — Portage extension, not part of
       # the UCP spec: dev.ucp.dev has no reorder/cart-hydration capability as
-      # of the 2026-04-08 spec) ---
+      # of the 2026-08-25 spec) ---
       # Hydrates a cart from a previous order's line items so a caller doesn't
       # have to re-walk get_order + create_cart itself. Re-checks each item's
       # current price/availability rather than replaying the order's snapshot

data/lib/portage/ucp/security/signature.rb

@@ -7,7 +7,7 @@ module Portage
     module Security
       # Verifies that an inbound agent request carries a valid RFC 9421 HTTP
       # Message Signature, per UCP's own signature spec
-      # (ucp.dev/2026-04-08/specification/signatures/, pinned 2026-09-15 —
+      # (ucp.dev/2026-08-25/specification/signatures/, pinned 2026-09-15 —
       # this is the piece §22 of the design log flagged as unresearched
       # before writing code, now checked against the live spec rather than
       # guessed). This is a distinct concern from three other signing

data/lib/portage/ucp/value_objects.rb

@@ -115,9 +115,10 @@ module Portage
     # (Shopify/Wix metafields etc.) — see Portage::Ucp::Shopify.configure's
     # metadata_field.
     Product = Data.define(:id, :title, :description, :price_range, :variants, :handle, :url, :categories,
-                          :list_price_range, :media, :options, :tags, :metadata, :rating) do
+                          :list_price_range, :media, :options, :tags, :metadata, :rating, :policies) do
       def initialize(id:, title:, description:, price_range:, variants:, handle: nil, url: nil, categories: [],
-                     list_price_range: nil, media: [], options: [], tags: [], metadata: nil, rating: nil)
+                     list_price_range: nil, media: [], options: [], tags: [], metadata: nil, rating: nil,
+                     policies: [])
         super
       end
 
@@ -135,6 +136,7 @@ module Portage
         h["media"] = media.map(&:to_wire_h) unless media.empty?
         h["options"] = options.map(&:to_wire_h) unless options.empty?
         h["tags"] = tags unless tags.empty?
+        h["policies"] = policies unless policies.empty?
         h
       end
     end
@@ -144,12 +146,13 @@ module Portage
     # isn't schema-conformant (search_response requires `ucp` + `products` at
     # the top level, not a bare array). `messages` entries are left as plain
     # wire-shaped hashes, same rationale as Variant#barcodes above.
-    CatalogSearchResult = Data.define(:products, :messages) do
-      def initialize(products:, messages: []) = super
+    CatalogSearchResult = Data.define(:products, :messages, :policies) do
+      def initialize(products:, messages: [], policies: []) = super
 
       def to_wire_h
         h = { "products" => products.map(&:to_wire_h) }
         h["messages"] = messages unless messages.empty?
+        h["policies"] = policies unless policies.empty?
         h
       end
     end
@@ -161,8 +164,14 @@ module Portage
     # extension (interactive variant narrowing) — Adapter#get_product's
     # signature has no `selected:`/`preferences:` params to source it from
     # yet; unresearched, same status as design-log §16's other backlog items.
-    ProductDetail = Data.define(:product) do
-      def to_wire_h = { "product" => product.to_wire_h }
+    ProductDetail = Data.define(:product, :policies) do
+      def initialize(product:, policies: []) = super
+
+      def to_wire_h
+        h = { "product" => product.to_wire_h }
+        h["policies"] = policies unless policies.empty?
+        h
+      end
     end
 
     # One cost-breakdown entry (schemas/shopping/types/total.json). `amount` is a
@@ -198,6 +207,10 @@ module Portage
       end
     end
 
+    # `policies` (cart/checkout/order/catalog responses and products) is the
+    # 2026-08-25 policy.json array (return/warranty terms), optional and omitted
+    # when empty. Entries stay wire-shaped hashes (`type` and `description` are
+    # required, `applies_to`/`url` optional), same posture as `messages`.
     # schemas/shopping/types/link.json
     Link = Data.define(:type, :url, :title) do
       def initialize(type:, url:, title: nil) = super
@@ -380,13 +393,14 @@ module Portage
     # `discounts` is the dev.ucp.shopping.discount extension (optional on both
     # cart.json and its own schema) — omitted from the wire payload when empty,
     # same as Order#adjustments.
-    Cart = Data.define(:id, :line_items, :currency, :totals, :discounts) do
-      def initialize(id:, line_items:, currency:, totals:, discounts: Discounts.new) = super
+    Cart = Data.define(:id, :line_items, :currency, :totals, :discounts, :policies) do
+      def initialize(id:, line_items:, currency:, totals:, discounts: Discounts.new, policies: []) = super
 
       def to_wire_h
         h = { "id" => id, "line_items" => line_items.map(&:to_wire_h), "currency" => currency,
               "totals" => totals.map(&:to_wire_h) }
         h["discounts"] = discounts.to_wire_h unless discounts.empty?
+        h["policies"] = policies unless policies.empty?
         h
       end
     end
@@ -415,9 +429,9 @@ module Portage
     # omitted from the wire payload when empty), same posture as
     # Order#adjustments.
     Checkout = Data.define(:id, :status, :line_items, :currency, :totals, :links, :order, :discounts,
-                           :fulfillment) do
+                           :fulfillment, :policies) do
       def initialize(id:, status:, line_items:, currency:, totals:, links:, order: nil, discounts: Discounts.new,
-                     fulfillment: CheckoutFulfillment.new)
+                     fulfillment: CheckoutFulfillment.new, policies: [])
         super
       end
 
@@ -427,6 +441,7 @@ module Portage
         h["order"] = order.to_wire_h if order
         h["discounts"] = discounts.to_wire_h unless discounts.empty?
         h["fulfillment"] = fulfillment.to_wire_h unless fulfillment.empty?
+        h["policies"] = policies unless policies.empty?
         h
       end
     end
@@ -508,9 +523,9 @@ module Portage
     # line_items/fulfillment/currency/totals. `adjustments` is optional —
     # omitted from the wire payload when empty.
     Order = Data.define(:id, :checkout_id, :permalink_url, :line_items, :fulfillment, :currency, :totals,
-                        :adjustments) do
+                        :adjustments, :policies) do
       def initialize(id:, checkout_id:, permalink_url:, line_items:, fulfillment:, currency:, totals:,
-                     adjustments: [])
+                     adjustments: [], policies: [])
         super
       end
 
@@ -519,6 +534,7 @@ module Portage
               "line_items" => line_items.map(&:to_wire_h), "fulfillment" => fulfillment.to_wire_h,
               "currency" => currency, "totals" => totals.map(&:to_wire_h) }
         h["adjustments"] = adjustments.map(&:to_wire_h) unless adjustments.empty?
+        h["policies"] = policies unless policies.empty?
         h
       end
     end

data/lib/portage/ucp/version.rb

@@ -1,5 +1,5 @@
 module Portage
   module Ucp
-    VERSION = "0.14.0".freeze
+    VERSION = "0.15.0".freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: portage-ucp
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Tom Whitbread
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-09 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: json_schemer
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: mcp
   requirement: !ruby/object:Gem::Requirement