watchfor 0.15.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5ad40afc1187be8bcdf41c4c418b3c18b304b097a901219edfe777ae41087d1
-  data.tar.gz: b4da046bc763240825953b51a69e13e50838272d7e642bf78f450b4f7914810d
+  metadata.gz: 440bd3cc9c46afea4d4952984e93294db18a02ded76d8a5d5bbaded7d8a927a5
+  data.tar.gz: d0798e7395d9471d562ccbe0f299c330603e20cae7141cf68c0e13db4e9acf94
 SHA512:
-  metadata.gz: 73e41e8dc6673385ab4bfca74bb41a6e2d83d08429b88ff1bf826c835201295eda5c5b1edd76cf32518cb86ba9829b4b8d9b4641e9f1ee0f5a50743e2fe848e6
-  data.tar.gz: 1a4951d407a131eec5206d4b909de80a26f4833aaa916a08aa914846c6f71b8b6161cb5ceb90b982c3a0a2ce91fb465d5f7c297ce7bac2db92215e3b3481160d
+  metadata.gz: 6b1a026e89c31b6c2bf93f405655f360bffd2a91692d15f4df0da6dda625b25f54acf3d5d5fe54dfa5f25d53bef9476233b0d222852dcc7901baa2983177f988
+  data.tar.gz: '0288f489a53a6029f352dad623296943e3e917bfa0cf93fec0dec6f5262ca122bc62b6b5e8869e359a4994e8639ae9b885d13a944bcfc43abac7cc156e5f9676'

data/README.md

@@ -37,6 +37,12 @@ wf.incidents.list(status: "firing")["data"].each { |i| puts i["message"] }
 # uptime, SLA, reports and the status page (include undoes it)
 wf.incidents.exclude(19351, reason: "Probe-side DNS hiccup")
 
+# Post-mortem: creates the draft on first use; only the sections you name change
+wf.incidents.update_postmortem(19351, {
+  sections: { summary: "Checkout returned 502 for 14 minutes." },
+  add_action_items: [{ title: "Validate upstreams in CI" }]
+})
+
 # Irreversible: wipe a monitor's checks and incidents; uptime restarts "since reset"
 wf.monitors.reset(mon["id"])
 
@@ -113,7 +119,7 @@ Runs need a `write` key (a probe sends real traffic from WatchFor's IPs)
 and spend the same per-plan hourly allowance as the dashboard Toolbox.
 Details: <https://watchfor.io/docs/api/diagnostics>
 
-Namespaces: `wf.monitors`, `wf.alert_rules`, `wf.incidents`,
+Namespaces: `wf.organizations`, `wf.monitors`, `wf.alert_rules`, `wf.incidents`,
 `wf.hosts`, `wf.status_pages`, `wf.on_call`, `wf.notification_channels`, `wf.maintenance_windows`, `wf.contacts`, `wf.contact_groups`,
 `wf.diagnostics`, `wf.playwright`, `wf.variables`. Top-level:
 `wf.summary`, `wf.plan`, `wf.me`, `wf.locations`, `wf.monitor_types`,
@@ -129,12 +135,21 @@ belongs to; choose one with `organization:` — the SDK sends it as the
 `X-WatchFor-Organization` header on every request:
 
 ```ruby
+wf = Watchfor::Client.new(api_key: oauth_access_token)
+wf.organizations.list["data"].each do |org|
+  puts "#{org['id']} #{org['name']} #{org['role']} is_default=#{org['is_default']} is_current=#{org['is_current']}"
+end
+
 acme = Watchfor::Client.new(api_key: oauth_access_token, organization: "<organization-id>")
 acme.me # {"organization" => {"id", "name", "slug"}, "scope" => ...}
 other = acme.with_organization("<another-organization-id>") # new client, same token
 other.monitors.list
 ```
 
+- `organizations.list` returns the ids to use: every organization of the
+  token's user with their `role`, `is_default` (used without `organization:`)
+  and `is_current` (what this client acts on). With an API key it returns just
+  the key's own organization (`role` is `nil`).
 - Without `organization:`, an OAuth token acts on the user's oldest owned
   organization (else their oldest membership).
 - The user must be a member of that organization (otherwise `403
@@ -165,6 +180,7 @@ watchfor incidents
 watchfor checks <monitor_id> [--cursor <next_cursor>]
 watchfor report --period 30d
 watchfor me                       # which organization + scope
+watchfor organizations            # ids for --organization
 
 # OAuth token: pick the organization per call or via the environment
 export WATCHFOR_API_KEY=<oauth-access-token>

data/exe/watchfor

@@ -42,6 +42,7 @@ begin
   result =
     case command
     when "me" then wf.me
+    when "organizations", "orgs" then wf.organizations.list
     when "summary" then wf.summary
     when "plan" then wf.plan
     when "monitors" then wf.monitors.list
@@ -60,7 +61,7 @@ begin
       exit 0
     else
       warn "Usage: watchfor [--organization <id>] " \
-           "[me|summary|plan|monitors|locations|monitor-types|incidents|checks <monitor_id> [--cursor c]|" \
+           "[me|organizations|summary|plan|monitors|locations|monitor-types|incidents|checks <monitor_id> [--cursor c]|" \
            "report [--period 7d|30d]|metrics [--tag t] [--type t]]\n" \
            "Env: WATCHFOR_API_KEY (API key or OAuth access token), WATCHFOR_ORGANIZATION, WATCHFOR_BASE_URL"
       exit 2

data/lib/watchfor/client.rb

@@ -36,7 +36,7 @@ module Watchfor
   # An API key belongs to one organization: leave +organization:+ unset, or
   # pass that same id (any other id is 403 forbidden).
   class Client
-    attr_reader :monitors, :alert_rules, :incidents, :hosts, :status_pages, :on_call, :notification_channels,
+    attr_reader :organizations, :monitors, :alert_rules, :incidents, :hosts, :status_pages, :on_call, :notification_channels,
                 :maintenance_windows, :contacts, :contact_groups,
                 :diagnostics, :playwright, :variables, :organization
 
@@ -48,6 +48,7 @@ module Watchfor
       @timeout = timeout
       org = organization.to_s.strip
       @organization = org.empty? ? nil : org
+      @organizations = Organizations.new(self)
       @monitors = Monitors.new(self)
       @alert_rules = AlertRules.new(self)
       @incidents = Incidents.new(self)
@@ -268,6 +269,15 @@ module Watchfor
       def delete(name) = @c.request("DELETE", "/variables/#{name}")
     end
 
+    # The organizations this credential can act on: the ids +organization:+ /
+    # +with_organization+ accept. An OAuth token lists every organization of
+    # its user ("role", plus "is_default" for the one used without
+    # +organization:+ and "is_current" for the one the request acted on); an
+    # API key only its own ("role" nil).
+    class Organizations < Namespace
+      def list = @c.request("GET", "/organizations")
+    end
+
     class AlertRules < Namespace
       def list(monitor_id) = @c.request("GET", "/monitors/#{monitor_id}/alert-rules")
       def get(monitor_id, rule_id) = @c.request("GET", "/monitors/#{monitor_id}/alert-rules/#{rule_id}")
@@ -295,6 +305,13 @@ module Watchfor
       def mark_maintenance(id, idempotency_key: nil)
         @c.request("POST", "/incidents/#{id}/mark-maintenance", idempotency_key: idempotency_key)
       end
+      # The incident's post-mortem (404 when it has none yet - #update_postmortem creates it).
+      def get_postmortem(id) = @c.request("GET", "/incidents/#{id}/postmortem")
+      # Create the post-mortem draft on first use, then apply only what is given:
+      # "sections" replaces just the sections named; "add_timeline" and
+      # "add_action_items" append (repeats skipped). Publishing and deleting stay
+      # in the dashboard.
+      def update_postmortem(id, body) = @c.request("PATCH", "/incidents/#{id}/postmortem", body: body)
     end
 
     class StatusPages < Namespace

data/lib/watchfor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Watchfor
-  VERSION = "0.15.0"
+  VERSION = "0.17.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: watchfor
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.17.0
 platform: ruby
 authors:
 - WatchFor