portage-cli 0.13.0 → 0.14.0

data/lib/portage/cli/version.rb

@@ -1,5 +1,5 @@
 module Portage
   module Cli
-    VERSION = "0.13.0".freeze
+    VERSION = "0.14.0".freeze
   end
 end

data/lib/portage/cli.rb

@@ -17,6 +17,7 @@ require_relative "cli/find"
 require_relative "cli/compare"
 require_relative "cli/check"
 require_relative "cli/history"
+require_relative "cli/order_history"
 require_relative "cli/quotes"
 require_relative "cli/money"
 require_relative "cli/human_prompt"
@@ -77,6 +78,7 @@ module Portage
                                  [--velocity-count N --velocity-window-seconds N]
                                  [--allow HOST ...] [--clear-allowlist]
                                  [--require-approval person|any|off]  (lowering asks at a terminal)
+             portage orders list [--query Q] [--limit N] [--json]
              portage orders reconcile [--checkout ID] [--json]
              portage index build [--sources a,b] [--queries FILE] [--dry-run] [--export DIR] [--json]
              portage index refresh [--sources a,b] [--queries FILE] [--dry-run] [--export DIR] [--json]
@@ -95,6 +97,7 @@ module Portage
              portage setup [--json]  (interactive wizard on a TTY; --json/no TTY: today's doctor report)
              portage generate adapter NAME [--dir DIR]
              portage generate agent-profile [--out FILE] [--key-out FILE] [--rotate]
+             portage mcp  (MCP server on stdio for the shopper's agent; read-only and quotes only)
              portage --version
 
            proxy flags (buy/find/compare/check/doctor/payment enroll):
@@ -108,7 +111,8 @@ module Portage
                  "history" => :run_history, "payment" => :run_payment, "policy" => :run_policy,
                  "orders" => :run_orders, "index" => :run_index, "browser" => :run_browser,
                  "doctor" => :run_doctor,
-                 "configure" => :run_doctor, "setup" => :run_setup, "generate" => :run_generate }.freeze
+                 "configure" => :run_doctor, "setup" => :run_setup, "generate" => :run_generate,
+                 "mcp" => :run_mcp }.freeze
 
     VERSION_FLAGS = %w[--version -v version].freeze
 
@@ -123,6 +127,19 @@ module Portage
       1
     end
 
+    # `portage mcp` (docs/plans/buyer-mcp-server.md): the buyer MCP server
+    # on stdio. Loaded only here, so other commands don't pay for it.
+    def self.run_mcp(argv)
+      unless argv.empty?
+        warn USAGE
+        return 1
+      end
+
+      require_relative "cli/mcp/server"
+      ::MCP::Server::Transports::StdioTransport.new(Mcp::Server.build).open
+      0
+    end
+
     # So a packaged install (Homebrew's `test do` block, `portage doctor`)
     # can confirm which release it's running without hitting the network.
     def self.run_version
@@ -1217,12 +1234,49 @@ module Portage
     # an error, so a scheduled run never needs its own filtering logic.
     def self.run_orders(argv)
       sub = argv.first && !argv.first.start_with?("-") ? argv.shift : nil
+      return run_orders_list(argv) if sub == "list"
       return run_orders_reconcile(argv) if sub == "reconcile"
 
       warn USAGE
       1
     end
 
+    def self.run_orders_list(argv)
+      opts = {}
+      OptionParser.new do |parser|
+        parser.on("--query Q") { |v| opts[:query] = v }
+        parser.on("--limit N", Integer) { |v| opts[:limit] = v }
+        parser.on("--json") { opts[:json] = true }
+      end.parse!(argv)
+      raise OptionParser::InvalidArgument, "--limit must be positive" if opts[:limit]&.<(1)
+
+      entries = OrderHistory.new.call(query: opts[:query], limit: opts[:limit])
+      puts opts[:json] ? JSON.pretty_generate(entries) : format_orders(entries)
+      0
+    rescue OptionParser::ParseError => e
+      warn "#{e.message}\n#{USAGE}"
+      1
+    end
+
+    def self.format_orders(entries)
+      return "(no orders)" if entries.empty?
+
+      entries.map { |entry| format_order(entry) }.join("\n\n")
+    end
+
+    def self.format_order(entry)
+      items = entry["items"].map { |item| "  #{item['title'] || item['product_id']} x#{item['quantity']}" }
+      link = entry.values_at("permalink_url", "checkout_url").compact.first
+      adjustments = entry["adjustments"].map { |adj| "  #{adj['type']}: #{adj['status']}" }
+      [order_head(entry), *items, ("  #{link}" if link), *adjustments].compact.join("\n")
+    end
+
+    def self.order_head(entry)
+      total = Money.format_amount(entry["total"], entry["currency"]) if entry["total"]
+      [entry["recorded_at"], entry["shop"], entry["order_id"] || entry["outcome"], total,
+       "[#{entry['source']}]"].compact.join(" — ")
+    end
+
     def self.run_orders_reconcile(argv)
       opts = {}
       OptionParser.new do |parser|

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: portage-cli
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Tom Whitbread
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-05 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: irb
   requirement: !ruby/object:Gem::Requirement
@@ -24,20 +38,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.24'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.24'
 - !ruby/object:Gem::Dependency
   name: portage-ucp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.16'
 - !ruby/object:Gem::Dependency
   name: portage-ucp-client
   requirement: !ruby/object:Gem::Requirement
@@ -86,6 +114,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -253,10 +295,14 @@ files:
 - lib/portage/cli/index/store.rb
 - lib/portage/cli/install_doctor.rb
 - lib/portage/cli/macos_notifier.rb
+- lib/portage/cli/mcp/runner.rb
+- lib/portage/cli/mcp/server.rb
+- lib/portage/cli/mcp/tools.rb
 - lib/portage/cli/money.rb
 - lib/portage/cli/notifier.rb
 - lib/portage/cli/offer_choice.rb
 - lib/portage/cli/offer_sources.rb
+- lib/portage/cli/order_history.rb
 - lib/portage/cli/payment_methods.rb
 - lib/portage/cli/payment_methods/env_backend.rb
 - lib/portage/cli/payment_methods/keychain_backend.rb