wokku-cli 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ca5f8ef74b0d7c4991fde4d09e2fe741bd2925152b20a1337ca34b20f4a54cd
-  data.tar.gz: 661e85e21edc58b048532701bc32f5e9ef062d5fc610898d9d18718d051b39b5
+  metadata.gz: cce452abf4b37774f8aef5230edb8e3a1b88150ed88f69f9409474db937af0e6
+  data.tar.gz: a4b224d6cbcfa18aa08b5cf427c2dcab36c0ba5b5cb161647ce94f5abc043cc9
 SHA512:
-  metadata.gz: 73e67bb05dbbba4f756a0fc69312d8bebd626d826779a5496404363786b45121046a0cc4e669a635d51e527932d19bfb92aa70bdc376b1df7b864fc75a3f404b
-  data.tar.gz: b08a864fce04de1fc2435c0aa071d4ce343aee48214b963f4cc3859c67e14fef3a08250631ab343aaee155ab1c5406613f990f2fc30fd5cc79f5cfe0454bd0d9
+  metadata.gz: 69815ec5eb9d7869c7214190df8423632c94ad0e0f2a953ed09f0d9b5936aea0b0c431cc4ea5c3b7f3dd2d46f8263ea43d4ded955239f1794c3cf4a91eed924a
+  data.tar.gz: b43e5e78b17056f2ca1e82cf9e6cf60dd1d8977478654260201f5bd043d7685ed9117b28029712e2d2f61fe82cffa6468590d356315c92cf7ab70783c98622db

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.8.0 — 2026-10-23
+
+- `incidents [--all] [--app APP]`, `incidents:info ID` — what is down now and recent outages.
+- `alerts:mutes`, `alerts:mute [--app APP] [--event EVENT] [--for 1h|8h|1d]`, `alerts:unmute ID` — per-person push mutes.
+- Coverage gate no longer needs ignores for `dynos.update`/`dynos.replace`/`servers.dokku` (deprecated in the contract).
+
+## 0.7.0 — 2026-10-23
+
+Full API parity for everything customers can do (CI now fails if the CLI falls behind the API contract).
+
+- New: `deploys`, `deploys:info`, `deploy:tarball`, `releases:info`, `ps`, `ps:sizes`, `ps:dynos`, `ps:resize` (usage: `ps:resize APP TYPE --memory MB [--cpu N]`), `run:status`, `backups`, `backups:capture`, `backups:download`, `backups:restore`, `databases:import`, `addons:remove`, `apps:update`, `tokens`, `tokens:create`, `tokens:revoke`, `doctor`, `ai:diagnose`, `servers:status`, `templates:info`.
+- Fixed: `wokku run` now waits for the command and exits with its exit code (it used to return immediately).
+- Fixed: `wokku config` prints `KEY=value` (it printed the response wrapper); viewers see `(hidden — viewer)`.
+- `auth:logout` also revokes the token on the server. It also signs out the MCP plugin (they share ~/.wokku/config.json).
+- Retired: `billing:usage` (usage is per resource now; see `billing:plan`) and `addons:add` (use `addons:shared:enable` / `addons:dedicated:upgrade`).
+
 ## 0.6.0 — 2026-07-30
 
 ### Removed

data/lib/wokku/api_client.rb

@@ -47,6 +47,28 @@ module Wokku
       parse_response(resp)
     end
 
+    # Raw-body POST (databases.import). Streams the file — dumps can be GBs.
+    def upload(path, file_path)
+      @last_path = path
+      raise NotAuthenticated, "Not logged in. Run: wokku auth:login" unless token
+
+      uri = URI("#{url}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = OPEN_TIMEOUT
+      http.read_timeout = 900
+
+      req = Net::HTTP::Post.new(uri)
+      req["Authorization"] = "Bearer #{token}"
+      req["Content-Type"] = "application/octet-stream"
+      req["User-Agent"] = @user_agent
+      File.open(file_path, "rb") do |f|
+        req["Content-Length"] = f.size.to_s
+        req.body_stream = f
+        parse_response(perform(http, req, uri))
+      end
+    end
+
     def stream(method, path, &block)
       @last_path = path
       raise NotAuthenticated, "Not logged in. Run: wokku auth:login" unless token

data/lib/wokku/commands/addons.rb

@@ -20,17 +20,9 @@ register "addons", "List add-ons (usage: wokku addons APP)" do
   end
 end
 
-register "addons:add", "[LEGACY pre-Bundle-v2] Add add-on (usage: wokku addons:add APP postgres). Returns 410 under Bundle v2 — use addons:shared:enable or addons:dedicated:upgrade instead." do
-  id = ARGV.shift || abort("Usage: wokku addons:add APP SERVICE_TYPE")
-  service_type = ARGV.shift || abort("Missing service type (postgres, redis, mysql, etc)")
-  name = nil
-  while (arg = ARGV.shift)
-    name = ARGV.shift if arg == "--name"
-  end
-  body = { service_type: service_type }
-  body[:name] = name if name
-  data = api(:post, "/apps/#{id}/addons", body)
-  Wokku::Output.status "Added #{service_type}: #{data['name'] || data['id']}"
+register "addons:add", "Retired — use addons:shared:enable or addons:dedicated:upgrade" do
+  ARGV.clear
+  abort "addons:add is retired — use addons:shared:enable APP ENGINE (free) or addons:dedicated:upgrade APP ENGINE"
 end
 
 # --- Bundle v2 — shared engines ---
@@ -78,3 +70,12 @@ register "addons:dedicated:upgrade", "Upgrade a box to a dedicated DB or Redis (
   data   = api(:post, "/apps/#{id}/addons/dedicated", { engine: engine })
   Wokku::Output.status(data["message"] || "Dedicated #{engine} upgrade queued for #{id}")
 end
+
+register "addons:remove", "Remove an add-on from an app (usage: wokku addons:remove APP ADDON_ID)" do
+  id = ARGV.shift || abort("Usage: wokku addons:remove APP ADDON_ID")
+  addon = ARGV.shift || abort("Missing ADDON_ID (see: wokku addons #{id})")
+  print "Are you sure you want to remove add-on #{addon} from #{id}? This destroys the database (a farewell snapshot is taken). (y/N): "
+  abort "Cancelled." unless $stdin.gets.to_s.strip.downcase == "y"
+  api(:delete, "/apps/#{id}/addons/#{addon}")
+  Wokku::Output.status "Add-on removed."
+end

data/lib/wokku/commands/apps.rb

@@ -51,3 +51,16 @@ register "apps:destroy", "Delete app (usage: wokku apps:destroy APP)" do
   api(:delete, "/apps/#{id}")
   Wokku::Output.status "App deleted."
 end
+
+register "apps:update", "Update app settings (usage: wokku apps:update APP [--branch BRANCH] [--name NAME])" do
+  id = ARGV.shift || abort("Usage: wokku apps:update APP [--branch BRANCH] [--name NAME]")
+  body = {}
+  { "--branch" => :deploy_branch, "--name" => :name }.each do |flag, key|
+    next unless (i = ARGV.index(flag))
+    body[key] = ARGV[i + 1] || abort("Missing value for #{flag}")
+    ARGV.slice!(i, 2)
+  end
+  abort "Nothing to update. Pass --branch and/or --name." if body.empty?
+  api(:patch, "/apps/#{id}", body)
+  Wokku::Output.status "App updated."
+end

data/lib/wokku/commands/auth.rb

@@ -9,9 +9,17 @@ register "auth:login", "Authenticate with Wokku via browser device flow" do
   Wokku::Auth.login_with_device_flow!(Wokku::Config.api_url)
 end
 
-register "auth:logout", "Log out" do
+register "auth:logout", "Log out (revokes this token on the server)" do
   path = Wokku::Config.file
   if File.exist?(path)
+    begin
+      # covers: api(:delete, "/auth/logout")
+      # only revoke a token this file holds, never an env-provided (CI) one
+      Wokku.api_client.request(:delete, "/auth/logout") if Wokku::Config.load["token"]
+    rescue Wokku::ApiClient::NotAuthenticated, Wokku::ApiClient::Timeout,
+           Wokku::ApiClient::Unreachable, Wokku::ApiClient::Error
+      nil # best effort: always clear the local login
+    end
     File.delete(path)
     Wokku::Output.status "Logged out."
   else

data/lib/wokku/commands/backups.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# --- Database backups ---
+register "backups", "List backups (usage: wokku backups DB)" do
+  db = ARGV.shift || abort("Usage: wokku backups DB")
+  data = api(:get, "/databases/#{db}/backups")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Array)
+    table(d.map { |b| { "id" => b["id"], "status" => b["status"], "size" => b["size_bytes"], "created" => b["created_at"].to_s[0..18] } })
+  end
+end
+
+register "backups:capture", "Start a backup now (usage: wokku backups:capture DB)" do
+  db = ARGV.shift || abort("Usage: wokku backups:capture DB")
+  data = api(:post, "/databases/#{db}/backups")
+  Wokku::Output.status "Backup started#{data.is_a?(Hash) && data['id'] ? " (#{data['id']})" : ''}."
+end
+
+register "backups:download", "Download a backup, or print its URL (usage: wokku backups:download DB BACKUP_ID [FILE])" do
+  db = ARGV.shift || abort("Usage: wokku backups:download DB BACKUP_ID [FILE]")
+  backup_id = ARGV.shift || abort("Missing BACKUP_ID")
+  out = ARGV.shift
+  data = api(:get, "/databases/#{db}/backups/#{backup_id}/download")
+  url = data.is_a?(Hash) && data["url"]
+  abort "Unexpected response: #{data.inspect[0..200]}" unless url
+  next puts(url) unless out
+
+  uri = URI(url)
+  Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
+    http.request(Net::HTTP::Get.new(uri)) do |resp|
+      abort "Download failed: HTTP #{resp.code}" unless resp.is_a?(Net::HTTPSuccess)
+      File.open(out, "wb") { |f| resp.read_body { |chunk| f.write(chunk) } }
+    end
+  end
+  Wokku::Output.status "Saved #{out}"
+end
+
+register "backups:restore", "Restore a backup — overwrites the database (usage: wokku backups:restore DB BACKUP_ID)" do
+  db = ARGV.shift || abort("Usage: wokku backups:restore DB BACKUP_ID")
+  backup_id = ARGV.shift || abort("Missing BACKUP_ID")
+  print "Are you sure you want to overwrite #{db} with backup #{backup_id}? (y/N): "
+  abort "Cancelled." unless $stdin.gets.to_s.strip.downcase == "y"
+  data = api(:post, "/databases/#{db}/backups/#{backup_id}/restore")
+  Wokku::Output.status((data.is_a?(Hash) && data["message"]) || "Restore requested.")
+end

data/lib/wokku/commands/billing.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# --- Billing (plan + usage; checkout/portal stay in the dashboard) ---
+# --- Billing (plan; checkout/portal stay in the dashboard) ---
 
 register "billing:plan", "Show your current Wokku plan + limits (usage: wokku billing:plan)" do
   data = api(:get, "/billing/current_plan")
@@ -10,21 +10,6 @@ register "billing:plan", "Show your current Wokku plan + limits (usage: wokku bi
   Wokku::Output.status "max databases: #{data['max_databases']}" if data.key?("max_databases")
 end
 
-register "billing:usage", "Show month-to-date usage (usage: wokku billing:usage)" do
-  data = api(:get, "/billing/usage")
-  data = {} unless data.is_a?(Hash)
-
-  Wokku::Output.status "current: $#{format('%.2f', data['current_cost_dollars'] || 0.0)}"
-  Wokku::Output.status "projected: $#{format('%.2f', data['projected_cost_dollars'] || 0.0)}"
-  Wokku::Output.status "payment method: #{data['has_payment_method'] ? 'yes' : 'no'}"
-
-  resources = Array(data["resources"])
-  if resources.any?
-    Wokku::Output.status ""
-    Wokku::Output.status "resources:"
-    resources.each do |r|
-      cents = r["current_cost_cents"].to_i
-      Wokku::Output.status "  #{r['resource_type']}  #{r['tier_name']}  $#{format('%.2f', cents / 100.0)}"
-    end
-  end
+register "billing:usage", "Retired — usage is now per resource (see billing:plan)" do
+  abort "billing:usage is retired — usage is now per resource; see wokku billing:plan or the dashboard"
 end

data/lib/wokku/commands/config.rb

@@ -5,11 +5,9 @@ register "config", "Show config vars (usage: wokku config APP)" do
   id = ARGV.shift || abort("Usage: wokku config APP")
   data = api(:get, "/apps/#{id}/config")
   Wokku::Output.render(data) do |d|
-    if d.is_a?(Hash)
-      d.each { |k, v| puts "#{k}=#{v}" }
-    else
-      puts_json d
-    end
+    next puts_json(d) unless d.is_a?(Hash)
+    vars = d["config"] || d
+    vars.each { |k, v| puts(d["masked"] && v.nil? ? "#{k}=(hidden — viewer)" : "#{k}=#{v}") }
   end
 end
 
@@ -35,6 +33,7 @@ register "config:get", "Show one config var (usage: wokku config:get APP KEY)" d
   key = ARGV.shift || abort("Missing KEY")
   data = api(:get, "/apps/#{id}/config")
   vars = data.is_a?(Hash) ? (data["config"] || data) : {}
+  abort "Values are hidden for viewers — ask a team member or admin." if data.is_a?(Hash) && data["masked"]
   abort "Key not set: #{key}" unless vars.key?(key)
   Wokku::Output.render({ "key" => key, "value" => vars[key] }) { |_| puts vars[key] }
 end
@@ -42,6 +41,7 @@ end
 register "config:export", "Export config as .env (usage: wokku config:export APP)" do
   id = ARGV.shift || abort("Usage: wokku config:export APP")
   data = api(:get, "/apps/#{id}/config")
+  abort "Values are hidden for viewers — ask a team member or admin." if data.is_a?(Hash) && data["masked"]
   vars = data.is_a?(Hash) ? (data["config"] || data) : {}
   Wokku::Output.render(vars) do |d|
     d.each do |k, v|

data/lib/wokku/commands/databases.rb

@@ -81,3 +81,13 @@ register "databases:unlink", "Unlink a database from an app (usage: wokku databa
   api(:post, "/databases/#{db_name}/unlink", { app_id: app })
   Wokku::Output.status "Unlinked '#{db_name}' from '#{app}'."
 end
+
+register "databases:import", "Import a dump — overwrites the database (usage: wokku databases:import DB FILE)" do
+  db = ARGV.shift || abort("Usage: wokku databases:import DB FILE")
+  file = ARGV.shift || abort("Missing FILE (e.g. a pg_dump -Fc dump)")
+  abort "File not found: #{file}" unless File.file?(file)
+  print "Are you sure you want to overwrite #{db} with #{File.basename(file)}? (y/N): "
+  abort "Cancelled." unless $stdin.gets.to_s.strip.downcase == "y"
+  data = api_upload(:post, "/databases/#{db}/import", file)
+  Wokku::Output.status(data.is_a?(Hash) && data["message"] ? data["message"] : "Imported.")
+end

data/lib/wokku/commands/deploys.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "tmpdir"
+
+# --- Deploys ---
+register "deploys", "List deploys (usage: wokku deploys APP)" do
+  id = ARGV.shift || abort("Usage: wokku deploys APP")
+  data = api(:get, "/apps/#{id}/deploys")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Array)
+    table(d.map { |x| { "id" => x["id"], "status" => x["status"], "commit" => x["commit_sha"].to_s[0, 7], "created" => x["created_at"].to_s[0..18] } })
+  end
+end
+
+register "deploys:info", "Show a deploy and its build log (usage: wokku deploys:info APP DEPLOY_ID)" do
+  id = ARGV.shift || abort("Usage: wokku deploys:info APP DEPLOY_ID")
+  deploy_id = ARGV.shift || abort("Missing DEPLOY_ID")
+  data = api(:get, "/apps/#{id}/deploys/#{deploy_id}")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Hash)
+    puts "status: #{d['status']}"
+    puts d["log"] if d["log"]
+  end
+end
+
+TERMINAL_DEPLOY_STATUSES = %w[succeeded failed timed_out].freeze
+
+register "deploy:tarball", "Deploy a local directory without git push (usage: wokku deploy:tarball APP [DIR])" do
+  id = ARGV.shift || abort("Usage: wokku deploy:tarball APP [DIR]")
+  dir = File.expand_path(ARGV.shift || ".")
+  abort "Not a directory: #{dir}" unless Dir.exist?(dir)
+  if Dir.exist?(File.join(dir, ".git")) && !IO.popen([ "git", "-C", dir, "status", "--porcelain" ], &:read).strip.empty?
+    $stderr.puts "warning: uncommitted changes are not deployed (git archive uses HEAD)"
+  end
+  Dir.mktmpdir do |tmp|
+    archive = File.join(tmp, "source.tar.gz")
+    build_tarball(dir, archive)
+    slot = api(:post, "/apps/#{id}/deploys/uploads")
+    upload_presigned(slot["upload_url"], archive)
+    dep = api(:post, "/apps/#{id}/deploys", { archive_key: slot["archive_key"] })
+    Wokku::Output.status "Build queued (#{dep['deploy_id']}). Following..."
+    final = poll_until("/apps/#{id}/deploys/#{dep['deploy_id']}", attempts: 320, interval: 3) { |d| d.is_a?(Hash) && TERMINAL_DEPLOY_STATUSES.include?(d["status"].to_s) }
+    abort "Still building after 16 minutes. Check: wokku deploys:info #{id} #{dep['deploy_id']}" unless final
+    Wokku::Output.status "Deploy #{final['status']}."
+    exit 1 unless final["status"] == "succeeded"
+  end
+end

data/lib/wokku/commands/doctor.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# --- Diagnostics ---
+register "doctor", "Check auth, client version, host health and app state (usage: wokku doctor)" do
+  data = api(:get, "/doctor")
+  Wokku::Output.render(data) { |d| puts_json d }
+end
+
+register "ai:diagnose", "AI diagnosis of a failed deploy (usage: wokku ai:diagnose APP [DEPLOY_ID])" do
+  id = ARGV.shift || abort("Usage: wokku ai:diagnose APP [DEPLOY_ID]")
+  deploy_id = ARGV.shift
+  unless deploy_id
+    deploys = api(:get, "/apps/#{id}/deploys")
+    deploy_id = Array(deploys).first&.dig("id") || abort("No deploys for #{id}")
+  end
+  data = api(:post, "/ai/diagnose", { deploy_id: deploy_id })
+  Wokku::Output.render(data) { |d| d.is_a?(Hash) && d["diagnosis"] ? puts(d["diagnosis"]) : puts_json(d) }
+end

data/lib/wokku/commands/incidents.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "time"
+require "uri"
+
+# --- Incidents & alert mutes ---
+# Command files are required at top level, so helper names are prefixed to stay out of the global namespace.
+def incidents_rows(list)
+  list.map do |x|
+    { "id" => x["id"], "subject" => x["app_name"] || "server #{x['server_id']}", "reason" => x["reason"],
+      "started" => x["started_at"].to_s[0..18], "status" => x["open"] ? "OPEN" : "resolved after #{x['duration_seconds']}s" }
+  end
+end
+
+def incidents_flag_value(name)
+  i = ARGV.index(name) or return nil
+  ARGV.delete_at(i)
+  ARGV.delete_at(i) || abort("Missing value for #{name}")
+end
+
+register "incidents", "List incidents (usage: wokku incidents [--all] [--app APP])" do
+  query = { state: ARGV.delete("--all") ? "all" : "open" }
+  app = incidents_flag_value("--app")
+  query[:app_id] = app if app
+  data = api(:get, "/incidents?#{URI.encode_www_form(query)}")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Array)
+    d.empty? ? puts("No incidents.") : table(incidents_rows(d))
+  end
+end
+
+register "incidents:info", "Show one incident (usage: wokku incidents:info ID)" do
+  id = ARGV.shift || abort("Usage: wokku incidents:info ID")
+  data = api(:get, "/incidents/#{id}")
+  Wokku::Output.render(data) { |d| puts_json d }
+end
+
+register "alerts:mutes", "List your push alert mutes (usage: wokku alerts:mutes)" do
+  data = api(:get, "/alert_mutes")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Array)
+    next puts("No mutes.") if d.empty?
+    table(d.map { |m| { "id" => m["id"], "app" => m["app_name"] || "(all apps)", "event" => m["event"] || "(all events)", "until" => m["until"].to_s[0..18].then { |u| u.empty? ? "(until unmuted)" : u } } })
+  end
+end
+
+MUTE_UNITS = { "m" => 60, "h" => 3600, "d" => 86_400 }.freeze
+
+register "alerts:mute", "Mute push alerts on your phone (usage: wokku alerts:mute [--app APP] [--event EVENT] [--for 1h|8h|1d])" do
+  usage = "Usage: wokku alerts:mute [--app APP] [--event EVENT] [--for 1h|8h|1d]"
+  body = { app_id: incidents_flag_value("--app"), event: incidents_flag_value("--event") }.compact
+  abort "#{usage} (give --app and/or --event)" if body.empty?
+  if (span = incidents_flag_value("--for"))
+    m = span.match(/\A(\d+)([mhd])\z/) || abort("#{usage} (--for looks like 30m, 8h or 1d)")
+    body[:until] = (Time.now + m[1].to_i * MUTE_UNITS[m[2]]).utc.iso8601
+  end
+  data = api(:post, "/alert_mutes", body)
+  Wokku::Output.render(data) { |d| Wokku::Output.status "Muted (#{d['id']})." }
+end
+
+register "alerts:unmute", "Remove a push alert mute (usage: wokku alerts:unmute ID)" do
+  id = ARGV.shift || abort("Usage: wokku alerts:unmute ID")
+  api(:delete, "/alert_mutes/#{id}")
+  Wokku::Output.status "Unmuted."
+end

data/lib/wokku/commands/ps.rb

@@ -44,3 +44,41 @@ register "ps:scale", "Scale processes (usage: wokku ps:scale APP web=2 worker=1)
   api(:patch, "/apps/#{id}/ps", { scaling: scaling })
   Wokku::Output.status "Scaled: #{scaling.map { |t, c| "#{t}=#{c}" }.join(' ')}"
 end
+
+register "ps", "Show process formation (usage: wokku ps APP)" do
+  id = ARGV.shift || abort("Usage: wokku ps APP")
+  data = api(:get, "/apps/#{id}/ps")
+  Wokku::Output.render(data) { |d| d.is_a?(Hash) && d["processes"].is_a?(Hash) ? d["processes"].each { |k, v| puts "#{k}: #{v}" } : puts_json(d) }
+end
+
+register "ps:sizes", "List box sizes (usage: wokku ps:sizes)" do
+  data = api(:get, "/dyno_tiers")
+  Wokku::Output.render(data) { |d| d.is_a?(Array) ? table(d) : puts_json(d) }
+end
+
+register "ps:dynos", "Show process allocations and box sizes (usage: wokku ps:dynos APP)" do
+  id = ARGV.shift || abort("Usage: wokku ps:dynos APP")
+  data = api(:get, "/apps/#{id}/dynos")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Array)
+    table(d.map { |a| { "type" => a["process_type"], "count" => a["count"], "size" => a["size_label"], "monthly" => format("%.2f", a["monthly_cost_cents"].to_i / 100.0) } })
+  end
+end
+
+register "ps:resize", "Change a process type's size (usage: wokku ps:resize APP TYPE --memory MB [--cpu N])" do
+  usage = "Usage: wokku ps:resize APP TYPE --memory MB [--cpu N]"
+  shape = {}
+  if (i = ARGV.index("--memory"))
+    shape[:memory_mb] = Integer(ARGV[i + 1] || abort("Missing value for --memory"))
+    ARGV.slice!(i, 2)
+  end
+  if (i = ARGV.index("--cpu"))
+    shape[:cpu] = Float(ARGV[i + 1] || abort("Missing value for --cpu"))
+    ARGV.slice!(i, 2)
+  end
+  id = ARGV.shift || abort(usage)
+  type = ARGV.shift || abort(usage)
+  abort "#{usage} (give --memory and/or --cpu; see: wokku ps:sizes)" if shape.empty?
+  api(:patch, "/apps/#{id}/ps", { resources: { type => shape } })
+  Wokku::Output.status "Resizing #{type}: #{shape.map { |k, v| "#{k}=#{v}" }.join(' ')}; applied in the background."
+end

data/lib/wokku/commands/releases.rb

@@ -19,3 +19,10 @@ register "rollback", "Rollback to release (usage: wokku rollback APP RELEASE_ID)
   api(:post, "/apps/#{id}/releases/#{release_id}/rollback")
   Wokku::Output.status "Rolling back..."
 end
+
+register "releases:info", "Show one release (usage: wokku releases:info APP RELEASE_ID)" do
+  id = ARGV.shift || abort("Usage: wokku releases:info APP RELEASE_ID")
+  release_id = ARGV.shift || abort("Missing RELEASE_ID")
+  data = api(:get, "/apps/#{id}/releases/#{release_id}")
+  Wokku::Output.render(data) { |d| puts_json d }
+end

data/lib/wokku/commands/run.rb

@@ -1,13 +1,27 @@
 # frozen_string_literal: true
 
 # --- One-off command in an ephemeral container ---
-register "run", "Run a one-off command (usage: wokku run APP -- COMMAND [ARGS...])" do
+# apps.run is async (202 {run_id}); poll runs.show to a terminal status.
+register "run", "Run a one-off command (usage: wokku run APP -- COMMAND [ARGS...], e.g. wokku run APP -- bin/rails db:migrate)" do
   id = ARGV.shift || abort("Usage: wokku run APP -- COMMAND")
   ARGV.shift if ARGV.first == "--"
   cmd = ARGV.join(" ")
   ARGV.clear
-  abort "Missing command. Example: wokku run APP -- bin/rails console" if cmd.strip.empty?
-  data = api(:post, "/apps/#{id}/run", { command: cmd })
-  puts data["output"] if data.is_a?(Hash) && data["output"]
-  exit (data["exit_code"] || 0).to_i if data.is_a?(Hash) && data.key?("exit_code")
+  abort "Missing command. Example: wokku run APP -- bin/rails db:migrate" if cmd.strip.empty?
+  started = api(:post, "/apps/#{id}/run", { command: cmd })
+  run_id = started.is_a?(Hash) && started["run_id"]
+  abort "Unexpected response: #{started.inspect[0..200]}" unless run_id
+  $stderr.puts "Run #{run_id} started — check later with: wokku run:status #{id} #{run_id}"
+  final = poll_until("/apps/#{id}/runs/#{run_id}", attempts: 300, interval: 2) { |d| d.is_a?(Hash) && %w[succeeded failed].include?(d["status"].to_s) }
+  abort "Still running after 10 minutes. Check: wokku run:status #{id} #{run_id}" unless final
+  puts final["output"] if final["output"]
+  $stderr.puts final["error"] if final["error"]
+  exit (final["exit_code"] || (final["status"] == "succeeded" ? 0 : 1)).to_i
+end
+
+register "run:status", "Show a one-off run (usage: wokku run:status APP RUN_ID)" do
+  id = ARGV.shift || abort("Usage: wokku run:status APP RUN_ID")
+  run_id = ARGV.shift || abort("Missing RUN_ID")
+  data = api(:get, "/apps/#{id}/runs/#{run_id}")
+  Wokku::Output.render(data) { |d| puts_json d }
 end

data/lib/wokku/commands/servers.rb

@@ -32,3 +32,9 @@ register "servers:default", "Set the default server (usage: wokku servers:defaul
     Wokku::Output.status "Default server set to: #{arg}"
   end
 end
+
+register "servers:status", "Show server health (usage: wokku servers:status SERVER)" do
+  server = ARGV.shift || abort("Usage: wokku servers:status SERVER")
+  data = api(:get, "/servers/#{server}/status")
+  Wokku::Output.render(data) { |d| puts_json d }
+end

data/lib/wokku/commands/templates.rb

@@ -29,3 +29,9 @@ register "deploy", "Deploy template (usage: wokku deploy TEMPLATE [--server SERV
   Wokku::Output.status "Deploying #{slug}..."
   Wokku::Output.render(data) { |d| puts_json d }
 end
+
+register "templates:info", "Show a template (usage: wokku templates:info SLUG)" do
+  slug = ARGV.shift || abort("Usage: wokku templates:info SLUG")
+  data = api(:get, "/templates/#{slug}")
+  Wokku::Output.render(data) { |d| puts_json d }
+end

data/lib/wokku/commands/tokens.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# --- API tokens ---
+register "tokens", "List API tokens (usage: wokku tokens)" do
+  data = api(:get, "/auth/tokens")
+  Wokku::Output.render(data) do |d|
+    next puts_json(d) unless d.is_a?(Array)
+    table(d.map { |t| { "id" => t["id"], "name" => t["name"], "last_used" => t["last_used_at"].to_s[0..18], "expires" => t["expires_at"].to_s[0..18] } })
+  end
+end
+
+register "tokens:create", "Create an API token (usage: wokku tokens:create NAME)" do
+  name = ARGV.shift || abort("Usage: wokku tokens:create NAME")
+  data = api(:post, "/auth/tokens", { name: name })
+  Wokku::Output.render(data) do |d|
+    puts d["token"]
+    Wokku::Output.status "Copy it now — it won't be shown again."
+  end
+end
+
+register "tokens:revoke", "Revoke an API token (usage: wokku tokens:revoke TOKEN_ID)" do
+  token_id = ARGV.shift || abort("Usage: wokku tokens:revoke TOKEN_ID")
+  api(:delete, "/auth/tokens/#{token_id}")
+  Wokku::Output.status "Token revoked."
+end

data/lib/wokku/helpers.rb

@@ -34,3 +34,31 @@ def resolve_server(explicit: nil)
   names = servers.map { |s| s["name"] }.join(", ")
   abort "Multiple servers available (#{names}). Pass --server NAME or set a default: wokku servers:default NAME"
 end
+
+# PUT a file to a presigned bucket URL. No Authorization header: the
+# signature in the URL is the credential and an extra header breaks it.
+def upload_presigned(url, file_path)
+  uri = URI(url)
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = uri.scheme == "https"
+  http.read_timeout = 300
+  req = Net::HTTP::Put.new(uri)
+  req["Content-Type"] = "application/gzip"
+  req.body = File.binread(file_path)
+  resp = http.request(req)
+  abort "Upload failed: HTTP #{resp.code}" unless resp.is_a?(Net::HTTPSuccess)
+  true
+end
+
+# .tar.gz of dir: committed files only for git repos, otherwise everything
+# except .git/node_modules/tmp/log. COPYFILE_DISABLE stops macOS tar from
+# adding ._ AppleDouble files that break builds.
+def build_tarball(dir, archive_path)
+  ok = if Dir.exist?(File.join(dir, ".git"))
+    system("git", "-C", dir, "archive", "--format=tar.gz", "--output=#{archive_path}", "HEAD")
+  else
+    system({ "COPYFILE_DISABLE" => "1" }, "tar", "-czf", archive_path,
+      "--exclude=.git", "--exclude=node_modules", "--exclude=tmp", "--exclude=log", "-C", dir, ".")
+  end
+  abort "Could not archive #{dir}" unless ok
+end

data/lib/wokku/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Wokku
-  VERSION = "0.6.0"
+  VERSION = "0.8.0"
 end

data/lib/wokku.rb

@@ -80,6 +80,15 @@ rescue Wokku::ApiClient::NotAuthenticated, Wokku::ApiClient::Timeout,
   abort e.message
 end
 
+def api_upload(method, path, file_path)
+  abort "uploads are POST only" unless method == :post
+  abort "File not found: #{file_path}" unless File.file?(file_path.to_s)
+  Wokku.api_client.upload(path, file_path)
+rescue Wokku::ApiClient::NotAuthenticated, Wokku::ApiClient::Timeout,
+       Wokku::ApiClient::Unreachable, Wokku::ApiClient::Error => e
+  abort e.message
+end
+
 # Poll GET <path> until the block returns truthy (returns that data) or the
 # attempt budget is exhausted (returns nil). interval is injectable so specs
 # can run with no real sleep.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wokku-cli
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Johannes Dwicahyo
@@ -45,6 +45,7 @@ files:
 - lib/wokku/commands/apps.rb
 - lib/wokku/commands/apps_lifecycle.rb
 - lib/wokku/commands/auth.rb
+- lib/wokku/commands/backups.rb
 - lib/wokku/commands/billing.rb
 - lib/wokku/commands/cdn.rb
 - lib/wokku/commands/certs.rb
@@ -53,10 +54,13 @@ files:
 - lib/wokku/commands/cron.rb
 - lib/wokku/commands/databases.rb
 - lib/wokku/commands/db_monitor.rb
+- lib/wokku/commands/deploys.rb
 - lib/wokku/commands/dev.rb
+- lib/wokku/commands/doctor.rb
 - lib/wokku/commands/domains.rb
 - lib/wokku/commands/github.rb
 - lib/wokku/commands/https.rb
+- lib/wokku/commands/incidents.rb
 - lib/wokku/commands/logs.rb
 - lib/wokku/commands/maintenance.rb
 - lib/wokku/commands/mcp.rb
@@ -72,6 +76,7 @@ files:
 - lib/wokku/commands/ssh_keys.rb
 - lib/wokku/commands/teams.rb
 - lib/wokku/commands/templates.rb
+- lib/wokku/commands/tokens.rb
 - lib/wokku/commands/tunnel.rb
 - lib/wokku/commands/version.rb
 - lib/wokku/commands/vitals.rb