portage-ucp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +15 -0
  3. data/LICENSE +21 -0
  4. data/README.md +97 -0
  5. data/exe/portage-ucp-check +25 -0
  6. data/lib/portage/ucp/adapter.rb +58 -0
  7. data/lib/portage/ucp/authenticator.rb +26 -0
  8. data/lib/portage/ucp/capabilities/cart.rb +16 -0
  9. data/lib/portage/ucp/capabilities/catalog.rb +11 -0
  10. data/lib/portage/ucp/capabilities/checkout.rb +17 -0
  11. data/lib/portage/ucp/capabilities/identity_linking.rb +13 -0
  12. data/lib/portage/ucp/capabilities/order.rb +11 -0
  13. data/lib/portage/ucp/capability.rb +27 -0
  14. data/lib/portage/ucp/capability_negotiator.rb +40 -0
  15. data/lib/portage/ucp/capability_registry.rb +21 -0
  16. data/lib/portage/ucp/check.rb +96 -0
  17. data/lib/portage/ucp/configuration.rb +35 -0
  18. data/lib/portage/ucp/dispatcher.rb +39 -0
  19. data/lib/portage/ucp/errors.rb +12 -0
  20. data/lib/portage/ucp/manifest.rb +58 -0
  21. data/lib/portage/ucp/mcp/server.rb +83 -0
  22. data/lib/portage/ucp/observability.rb +31 -0
  23. data/lib/portage/ucp/payment_token_guard.rb +41 -0
  24. data/lib/portage/ucp/rack/manifest_endpoint.rb +49 -0
  25. data/lib/portage/ucp/rack/webhook_endpoint.rb +54 -0
  26. data/lib/portage/ucp/rate_limiter.rb +27 -0
  27. data/lib/portage/ucp/resolver.rb +133 -0
  28. data/lib/portage/ucp/schema_validator.rb +53 -0
  29. data/lib/portage/ucp/support/amounts.rb +43 -0
  30. data/lib/portage/ucp/support/api_error.rb +39 -0
  31. data/lib/portage/ucp/support/checkout_state.rb +42 -0
  32. data/lib/portage/ucp/support/http_client.rb +54 -0
  33. data/lib/portage/ucp/support/idempotency.rb +26 -0
  34. data/lib/portage/ucp/support/line_item_status.rb +44 -0
  35. data/lib/portage/ucp/support/not_found.rb +25 -0
  36. data/lib/portage/ucp/support/token_exchange.rb +43 -0
  37. data/lib/portage/ucp/support/totals.rb +31 -0
  38. data/lib/portage/ucp/value_objects.rb +186 -0
  39. data/lib/portage/ucp/version.rb +5 -0
  40. data/lib/portage/ucp/wire_envelope.rb +25 -0
  41. data/lib/portage/ucp.rb +44 -0
  42. data/schemas/2026-04-08/schemas/capability.json +70 -0
  43. data/schemas/2026-04-08/schemas/payment_handler.json +67 -0
  44. data/schemas/2026-04-08/schemas/service.json +190 -0
  45. data/schemas/2026-04-08/schemas/shopping/cart.json +134 -0
  46. data/schemas/2026-04-08/schemas/shopping/catalog_lookup.json +207 -0
  47. data/schemas/2026-04-08/schemas/shopping/catalog_search.json +64 -0
  48. data/schemas/2026-04-08/schemas/shopping/checkout.json +131 -0
  49. data/schemas/2026-04-08/schemas/shopping/discount.json +148 -0
  50. data/schemas/2026-04-08/schemas/shopping/fulfillment.json +154 -0
  51. data/schemas/2026-04-08/schemas/shopping/order.json +113 -0
  52. data/schemas/2026-04-08/schemas/shopping/payment.json +16 -0
  53. data/schemas/2026-04-08/schemas/shopping/types/adjustment.json +69 -0
  54. data/schemas/2026-04-08/schemas/shopping/types/amount.json +8 -0
  55. data/schemas/2026-04-08/schemas/shopping/types/attribution.json +11 -0
  56. data/schemas/2026-04-08/schemas/shopping/types/available_payment_instrument.json +22 -0
  57. data/schemas/2026-04-08/schemas/shopping/types/business_fulfillment_config.json +38 -0
  58. data/schemas/2026-04-08/schemas/shopping/types/buyer.json +25 -0
  59. data/schemas/2026-04-08/schemas/shopping/types/category.json +20 -0
  60. data/schemas/2026-04-08/schemas/shopping/types/context.json +42 -0
  61. data/schemas/2026-04-08/schemas/shopping/types/description.json +22 -0
  62. data/schemas/2026-04-08/schemas/shopping/types/detail_option_value.json +22 -0
  63. data/schemas/2026-04-08/schemas/shopping/types/error_code.json +17 -0
  64. data/schemas/2026-04-08/schemas/shopping/types/error_response.json +31 -0
  65. data/schemas/2026-04-08/schemas/shopping/types/expectation.json +62 -0
  66. data/schemas/2026-04-08/schemas/shopping/types/fulfillment.json +25 -0
  67. data/schemas/2026-04-08/schemas/shopping/types/fulfillment_available_method.json +45 -0
  68. data/schemas/2026-04-08/schemas/shopping/types/fulfillment_destination.json +16 -0
  69. data/schemas/2026-04-08/schemas/shopping/types/fulfillment_event.json +67 -0
  70. data/schemas/2026-04-08/schemas/shopping/types/fulfillment_group.json +45 -0
  71. data/schemas/2026-04-08/schemas/shopping/types/fulfillment_method.json +67 -0
  72. data/schemas/2026-04-08/schemas/shopping/types/fulfillment_option.json +56 -0
  73. data/schemas/2026-04-08/schemas/shopping/types/info_code.json +13 -0
  74. data/schemas/2026-04-08/schemas/shopping/types/input_correlation.json +24 -0
  75. data/schemas/2026-04-08/schemas/shopping/types/item.json +33 -0
  76. data/schemas/2026-04-08/schemas/shopping/types/line_item.json +46 -0
  77. data/schemas/2026-04-08/schemas/shopping/types/link.json +25 -0
  78. data/schemas/2026-04-08/schemas/shopping/types/media.json +36 -0
  79. data/schemas/2026-04-08/schemas/shopping/types/message.json +18 -0
  80. data/schemas/2026-04-08/schemas/shopping/types/message_error.json +49 -0
  81. data/schemas/2026-04-08/schemas/shopping/types/message_info.json +37 -0
  82. data/schemas/2026-04-08/schemas/shopping/types/message_warning.json +53 -0
  83. data/schemas/2026-04-08/schemas/shopping/types/option_value.json +20 -0
  84. data/schemas/2026-04-08/schemas/shopping/types/order_confirmation.json +26 -0
  85. data/schemas/2026-04-08/schemas/shopping/types/order_line_item.json +69 -0
  86. data/schemas/2026-04-08/schemas/shopping/types/pagination.json +62 -0
  87. data/schemas/2026-04-08/schemas/shopping/types/payment_credential.json +17 -0
  88. data/schemas/2026-04-08/schemas/shopping/types/payment_instrument.json +58 -0
  89. data/schemas/2026-04-08/schemas/shopping/types/platform_fulfillment_config.json +14 -0
  90. data/schemas/2026-04-08/schemas/shopping/types/postal_address.json +44 -0
  91. data/schemas/2026-04-08/schemas/shopping/types/price.json +22 -0
  92. data/schemas/2026-04-08/schemas/shopping/types/price_filter.json +17 -0
  93. data/schemas/2026-04-08/schemas/shopping/types/price_range.json +21 -0
  94. data/schemas/2026-04-08/schemas/shopping/types/product.json +89 -0
  95. data/schemas/2026-04-08/schemas/shopping/types/product_option.json +25 -0
  96. data/schemas/2026-04-08/schemas/shopping/types/rating.json +34 -0
  97. data/schemas/2026-04-08/schemas/shopping/types/retail_location.json +28 -0
  98. data/schemas/2026-04-08/schemas/shopping/types/reverse_domain_name.json +8 -0
  99. data/schemas/2026-04-08/schemas/shopping/types/search_filters.json +20 -0
  100. data/schemas/2026-04-08/schemas/shopping/types/selected_option.json +25 -0
  101. data/schemas/2026-04-08/schemas/shopping/types/shipping_destination.json +26 -0
  102. data/schemas/2026-04-08/schemas/shopping/types/signals.json +22 -0
  103. data/schemas/2026-04-08/schemas/shopping/types/signed_amount.json +7 -0
  104. data/schemas/2026-04-08/schemas/shopping/types/total.json +75 -0
  105. data/schemas/2026-04-08/schemas/shopping/types/totals.json +98 -0
  106. data/schemas/2026-04-08/schemas/shopping/types/variant.json +193 -0
  107. data/schemas/2026-04-08/schemas/shopping/types/warning_code.json +13 -0
  108. data/schemas/2026-04-08/schemas/transports/embedded_config.json +27 -0
  109. data/schemas/2026-04-08/schemas/ucp.json +364 -0
  110. data/schemas/2026-04-08/services/shopping/embedded.openrpc.json +634 -0
  111. data/schemas/2026-04-08/services/shopping/mcp.openrpc.json +492 -0
  112. metadata +283 -0
metadata ADDED
@@ -0,0 +1,283 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: portage-ucp
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Tom Whitbread
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2026-08-14 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: base64
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - "~>"
18
+ - !ruby/object:Gem::Version
19
+ version: '0.2'
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - "~>"
25
+ - !ruby/object:Gem::Version
26
+ version: '0.2'
27
+ - !ruby/object:Gem::Dependency
28
+ name: json_schemer
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - "~>"
32
+ - !ruby/object:Gem::Version
33
+ version: '2.5'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - "~>"
39
+ - !ruby/object:Gem::Version
40
+ version: '2.5'
41
+ - !ruby/object:Gem::Dependency
42
+ name: mcp
43
+ requirement: !ruby/object:Gem::Requirement
44
+ requirements:
45
+ - - "~>"
46
+ - !ruby/object:Gem::Version
47
+ version: '0.24'
48
+ type: :runtime
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - "~>"
53
+ - !ruby/object:Gem::Version
54
+ version: '0.24'
55
+ - !ruby/object:Gem::Dependency
56
+ name: rack
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - "~>"
60
+ - !ruby/object:Gem::Version
61
+ version: '3.0'
62
+ type: :runtime
63
+ prerelease: false
64
+ version_requirements: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - "~>"
67
+ - !ruby/object:Gem::Version
68
+ version: '3.0'
69
+ - !ruby/object:Gem::Dependency
70
+ name: rack-test
71
+ requirement: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - "~>"
74
+ - !ruby/object:Gem::Version
75
+ version: '2.1'
76
+ type: :development
77
+ prerelease: false
78
+ version_requirements: !ruby/object:Gem::Requirement
79
+ requirements:
80
+ - - "~>"
81
+ - !ruby/object:Gem::Version
82
+ version: '2.1'
83
+ - !ruby/object:Gem::Dependency
84
+ name: rspec
85
+ requirement: !ruby/object:Gem::Requirement
86
+ requirements:
87
+ - - "~>"
88
+ - !ruby/object:Gem::Version
89
+ version: '3.13'
90
+ type: :development
91
+ prerelease: false
92
+ version_requirements: !ruby/object:Gem::Requirement
93
+ requirements:
94
+ - - "~>"
95
+ - !ruby/object:Gem::Version
96
+ version: '3.13'
97
+ - !ruby/object:Gem::Dependency
98
+ name: rubocop
99
+ requirement: !ruby/object:Gem::Requirement
100
+ requirements:
101
+ - - "~>"
102
+ - !ruby/object:Gem::Version
103
+ version: '1.88'
104
+ type: :development
105
+ prerelease: false
106
+ version_requirements: !ruby/object:Gem::Requirement
107
+ requirements:
108
+ - - "~>"
109
+ - !ruby/object:Gem::Version
110
+ version: '1.88'
111
+ - !ruby/object:Gem::Dependency
112
+ name: webmock
113
+ requirement: !ruby/object:Gem::Requirement
114
+ requirements:
115
+ - - "~>"
116
+ - !ruby/object:Gem::Version
117
+ version: '3.24'
118
+ type: :development
119
+ prerelease: false
120
+ version_requirements: !ruby/object:Gem::Requirement
121
+ requirements:
122
+ - - "~>"
123
+ - !ruby/object:Gem::Version
124
+ version: '3.24'
125
+ - !ruby/object:Gem::Dependency
126
+ name: yard
127
+ requirement: !ruby/object:Gem::Requirement
128
+ requirements:
129
+ - - "~>"
130
+ - !ruby/object:Gem::Version
131
+ version: '0.9'
132
+ type: :development
133
+ prerelease: false
134
+ version_requirements: !ruby/object:Gem::Requirement
135
+ requirements:
136
+ - - "~>"
137
+ - !ruby/object:Gem::Version
138
+ version: '0.9'
139
+ description: 'Protocol-only core gem: Adapter contract, capability registry, manifest
140
+ builder, and an MCP server wrapper. No commerce-backend deps.'
141
+ email:
142
+ executables:
143
+ - portage-ucp-check
144
+ extensions: []
145
+ extra_rdoc_files: []
146
+ files:
147
+ - CHANGELOG.md
148
+ - LICENSE
149
+ - README.md
150
+ - exe/portage-ucp-check
151
+ - lib/portage/ucp.rb
152
+ - lib/portage/ucp/adapter.rb
153
+ - lib/portage/ucp/authenticator.rb
154
+ - lib/portage/ucp/capabilities/cart.rb
155
+ - lib/portage/ucp/capabilities/catalog.rb
156
+ - lib/portage/ucp/capabilities/checkout.rb
157
+ - lib/portage/ucp/capabilities/identity_linking.rb
158
+ - lib/portage/ucp/capabilities/order.rb
159
+ - lib/portage/ucp/capability.rb
160
+ - lib/portage/ucp/capability_negotiator.rb
161
+ - lib/portage/ucp/capability_registry.rb
162
+ - lib/portage/ucp/check.rb
163
+ - lib/portage/ucp/configuration.rb
164
+ - lib/portage/ucp/dispatcher.rb
165
+ - lib/portage/ucp/errors.rb
166
+ - lib/portage/ucp/manifest.rb
167
+ - lib/portage/ucp/mcp/server.rb
168
+ - lib/portage/ucp/observability.rb
169
+ - lib/portage/ucp/payment_token_guard.rb
170
+ - lib/portage/ucp/rack/manifest_endpoint.rb
171
+ - lib/portage/ucp/rack/webhook_endpoint.rb
172
+ - lib/portage/ucp/rate_limiter.rb
173
+ - lib/portage/ucp/resolver.rb
174
+ - lib/portage/ucp/schema_validator.rb
175
+ - lib/portage/ucp/support/amounts.rb
176
+ - lib/portage/ucp/support/api_error.rb
177
+ - lib/portage/ucp/support/checkout_state.rb
178
+ - lib/portage/ucp/support/http_client.rb
179
+ - lib/portage/ucp/support/idempotency.rb
180
+ - lib/portage/ucp/support/line_item_status.rb
181
+ - lib/portage/ucp/support/not_found.rb
182
+ - lib/portage/ucp/support/token_exchange.rb
183
+ - lib/portage/ucp/support/totals.rb
184
+ - lib/portage/ucp/value_objects.rb
185
+ - lib/portage/ucp/version.rb
186
+ - lib/portage/ucp/wire_envelope.rb
187
+ - schemas/2026-04-08/schemas/capability.json
188
+ - schemas/2026-04-08/schemas/payment_handler.json
189
+ - schemas/2026-04-08/schemas/service.json
190
+ - schemas/2026-04-08/schemas/shopping/cart.json
191
+ - schemas/2026-04-08/schemas/shopping/catalog_lookup.json
192
+ - schemas/2026-04-08/schemas/shopping/catalog_search.json
193
+ - schemas/2026-04-08/schemas/shopping/checkout.json
194
+ - schemas/2026-04-08/schemas/shopping/discount.json
195
+ - schemas/2026-04-08/schemas/shopping/fulfillment.json
196
+ - schemas/2026-04-08/schemas/shopping/order.json
197
+ - schemas/2026-04-08/schemas/shopping/payment.json
198
+ - schemas/2026-04-08/schemas/shopping/types/adjustment.json
199
+ - schemas/2026-04-08/schemas/shopping/types/amount.json
200
+ - schemas/2026-04-08/schemas/shopping/types/attribution.json
201
+ - schemas/2026-04-08/schemas/shopping/types/available_payment_instrument.json
202
+ - schemas/2026-04-08/schemas/shopping/types/business_fulfillment_config.json
203
+ - schemas/2026-04-08/schemas/shopping/types/buyer.json
204
+ - schemas/2026-04-08/schemas/shopping/types/category.json
205
+ - schemas/2026-04-08/schemas/shopping/types/context.json
206
+ - schemas/2026-04-08/schemas/shopping/types/description.json
207
+ - schemas/2026-04-08/schemas/shopping/types/detail_option_value.json
208
+ - schemas/2026-04-08/schemas/shopping/types/error_code.json
209
+ - schemas/2026-04-08/schemas/shopping/types/error_response.json
210
+ - schemas/2026-04-08/schemas/shopping/types/expectation.json
211
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment.json
212
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment_available_method.json
213
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment_destination.json
214
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment_event.json
215
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment_group.json
216
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment_method.json
217
+ - schemas/2026-04-08/schemas/shopping/types/fulfillment_option.json
218
+ - schemas/2026-04-08/schemas/shopping/types/info_code.json
219
+ - schemas/2026-04-08/schemas/shopping/types/input_correlation.json
220
+ - schemas/2026-04-08/schemas/shopping/types/item.json
221
+ - schemas/2026-04-08/schemas/shopping/types/line_item.json
222
+ - schemas/2026-04-08/schemas/shopping/types/link.json
223
+ - schemas/2026-04-08/schemas/shopping/types/media.json
224
+ - schemas/2026-04-08/schemas/shopping/types/message.json
225
+ - schemas/2026-04-08/schemas/shopping/types/message_error.json
226
+ - schemas/2026-04-08/schemas/shopping/types/message_info.json
227
+ - schemas/2026-04-08/schemas/shopping/types/message_warning.json
228
+ - schemas/2026-04-08/schemas/shopping/types/option_value.json
229
+ - schemas/2026-04-08/schemas/shopping/types/order_confirmation.json
230
+ - schemas/2026-04-08/schemas/shopping/types/order_line_item.json
231
+ - schemas/2026-04-08/schemas/shopping/types/pagination.json
232
+ - schemas/2026-04-08/schemas/shopping/types/payment_credential.json
233
+ - schemas/2026-04-08/schemas/shopping/types/payment_instrument.json
234
+ - schemas/2026-04-08/schemas/shopping/types/platform_fulfillment_config.json
235
+ - schemas/2026-04-08/schemas/shopping/types/postal_address.json
236
+ - schemas/2026-04-08/schemas/shopping/types/price.json
237
+ - schemas/2026-04-08/schemas/shopping/types/price_filter.json
238
+ - schemas/2026-04-08/schemas/shopping/types/price_range.json
239
+ - schemas/2026-04-08/schemas/shopping/types/product.json
240
+ - schemas/2026-04-08/schemas/shopping/types/product_option.json
241
+ - schemas/2026-04-08/schemas/shopping/types/rating.json
242
+ - schemas/2026-04-08/schemas/shopping/types/retail_location.json
243
+ - schemas/2026-04-08/schemas/shopping/types/reverse_domain_name.json
244
+ - schemas/2026-04-08/schemas/shopping/types/search_filters.json
245
+ - schemas/2026-04-08/schemas/shopping/types/selected_option.json
246
+ - schemas/2026-04-08/schemas/shopping/types/shipping_destination.json
247
+ - schemas/2026-04-08/schemas/shopping/types/signals.json
248
+ - schemas/2026-04-08/schemas/shopping/types/signed_amount.json
249
+ - schemas/2026-04-08/schemas/shopping/types/total.json
250
+ - schemas/2026-04-08/schemas/shopping/types/totals.json
251
+ - schemas/2026-04-08/schemas/shopping/types/variant.json
252
+ - schemas/2026-04-08/schemas/shopping/types/warning_code.json
253
+ - schemas/2026-04-08/schemas/transports/embedded_config.json
254
+ - schemas/2026-04-08/schemas/ucp.json
255
+ - schemas/2026-04-08/services/shopping/embedded.openrpc.json
256
+ - schemas/2026-04-08/services/shopping/mcp.openrpc.json
257
+ homepage: https://github.com/tomtom87/Portage/tree/main/portage-ucp
258
+ licenses:
259
+ - MIT
260
+ metadata:
261
+ source_code_uri: https://github.com/tomtom87/Portage/tree/main/portage-ucp
262
+ changelog_uri: https://github.com/tomtom87/Portage/blob/main/portage-ucp/CHANGELOG.md
263
+ rubygems_mfa_required: 'true'
264
+ post_install_message:
265
+ rdoc_options: []
266
+ require_paths:
267
+ - lib
268
+ required_ruby_version: !ruby/object:Gem::Requirement
269
+ requirements:
270
+ - - ">="
271
+ - !ruby/object:Gem::Version
272
+ version: '3.2'
273
+ required_rubygems_version: !ruby/object:Gem::Requirement
274
+ requirements:
275
+ - - ">="
276
+ - !ruby/object:Gem::Version
277
+ version: '0'
278
+ requirements: []
279
+ rubygems_version: 3.5.22
280
+ signing_key:
281
+ specification_version: 4
282
+ summary: Expose a commerce backend to AI shopping agents over MCP and UCP
283
+ test_files: []