wiq-cli 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bffdea54163c5b95a5cab8b219d3e5cb3a898a059d7edce13afa8ae02928b27a
-  data.tar.gz: 0f9e49529c6bc9fb37b75761e581d1de90a186107242a6c3092fcca55687f9ba
+  metadata.gz: ee99cfc6ad08abdf7e1318883bcfa3ecc45635d2d521de150ed1622d867b0ebc
+  data.tar.gz: d9b6f3d18c731b4ddfe1060a03a40310e4d58b940d1f00f97dd3ef480f22dd74
 SHA512:
-  metadata.gz: 57f4ccba1f18ca17207739d051e94fcfb1b52b712c2d87e97fc64951acd4041d37a69f6d89d262dfde73cc44d278549d6ac9af02b67a572e3dd549dd2c58cd95
-  data.tar.gz: a317f13e135ab5b7a20f24b7f0c8a6640cbf84afc6a0a3e8d38d9d6483a537c302289f479b1cac0d454ca9c10485ebbcf453804decf4cdf02dbd73b822b0b933
+  metadata.gz: 89f8f34ae2184fab2069c8a0d51eaf53936dcb69e538e2fd7c0f659900e1be6ea3ee2f43101726ecb25bcd933a77beb20b2b954af4facbbfb248f4f0e40ae914
+  data.tar.gz: b63afbb5f6755e1821f268d0a797fc1d1f12d97148f790aa340ad0ec55bdf86df91ee649d003caaabe33351e91a25f848217fd6e26da09c3cf6dcc136b173d15

data/docs/deferred.md

@@ -68,9 +68,16 @@ Last updated: 2026-05-12 (after L1 ships).
   --all flag, base payload kept tight. Filters translate to Ransack
   (--first-name, --last-name, --weight-class, --academic-class, --age,
   --roster, --profile-type) + legacy free-text --query. --expand opts
-  into rosters / registration_answers per row. Multi-roster
+  into rosters / registration_answers / notification_preferences
+  (coach-only, Aug 2026 — see wiq_api_notes.md) per row. Multi-roster
   intersection deferred (API supports it; CLI surface didn't justify
   the complexity for v1). `wiq wrestlers show <id>` paired.
+- ~~**`wiq parents list/show`**~~ SHIPPED narrow (Aug 2026, alongside
+  the `expand_notification_preferences` param from wrestling PR #2460).
+  Filters: --query (legacy name search), --first-name / --last-name
+  (Ransack). --expand notification_preferences (coach-only). Slim
+  payload by design (id, user_id, type, names); no wrestler refs —
+  family linkage stays on the wrestlers side.
 - **`wiq url parse <url>`** — extract team/roster/event IDs from WIQ web
   URLs. Initial-plan item; useful for agents pasted URLs by humans.
 - **`wiq paid_sessions create/update`**, **`wiq rosters create/update`**,

data/docs/wiq_api_notes.md

@@ -390,6 +390,60 @@ them. PATs minted by parents/wrestlers will 403 here.
   shape (`category`, `subcategory`, `detail_category`, `total_net_amount`)
   — special-case it in the formatter.
 
+## Wrestlers + parents: `expand_notification_preferences`
+
+Shipped Aug 2026 (wrestling PR #2460). All four endpoints accept
+`expand_notification_preferences=true`:
+
+- `GET /api/v1/wrestlers` / `GET /api/v1/wrestlers/:id`
+- `GET /api/v1/parents` / `GET /api/v1/parents/:id`
+
+When set, each profile gains two fields, mirroring the "Notified via"
+section on the web profile pages:
+
+```json
+{
+  "wiq_app_installed": true,
+  "notification_preferences": {
+    "email": true, "sms": false, "push": true, "push_user_pref": true
+  }
+}
+```
+
+Things to know:
+
+- **Coach-gated, silently.** `expand_notification_preferences?` in
+  `base_controller.rb` requires `current_profile.coach?`. A parent- or
+  wrestler-bound PAT gets a normal 200 with the fields simply absent —
+  no error. Don't diagnose missing fields as a bug; check the PAT's
+  profile type first (`wiq auth status`).
+- **Nullable prefs.** `notification_preference` is a `has_one` that may
+  not exist; each key can be `null` (rendered via `np&.email` etc.).
+  Treat `null` as "no explicit preference recorded", not "off".
+- The controller eager-loads `:notification_preference` only when the
+  flag is set, so the index cost is opt-in.
+
+CLI exposure: `wiq wrestlers list|show --expand notification_preferences`
+(composes with `rosters`, `registration_answers` in the same CSV) and
+`wiq parents list|show --expand notification_preferences`.
+
+While we're here, the parents endpoints themselves
+(`app/controllers/api/v1/parents_controller.rb`):
+
+- Index scope is `team.parent_profiles.teammates` ordered by first
+  name — guest parents (camp signups) are excluded. Policy scope:
+  coaches see the whole team (roster-restricted coaches see only their
+  allowed parents), wrestlers see their own guardians, parents see
+  nobody.
+- Filters: legacy `?query=` name search, plus Ransack limited to
+  `id, first_name, last_name` (`ParentProfile.ransackable_attributes`).
+- The jbuilder payload is slim: `id, user_id, type, first_name,
+  last_name, full_name` (+ the expand fields above). No wrestler refs —
+  walk the family from the wrestler side (`wiq wrestlers show <id>`
+  embeds parent refs).
+- `show` uses `ParentProfile.with_deleted` — soft-deleted parents still
+  resolve by id.
+
 ## Check-ins (attendance)
 
 Two index endpoints + create/update on the event-scoped path.

data/lib/wiq/cli.rb

@@ -83,6 +83,9 @@ module Wiq
     desc "wrestlers SUBCOMMAND", "Search wrestlers — narrow ID-discovery surface (list, show)"
     subcommand "wrestlers", Wiq::Commands::Wrestlers
 
+    desc "parents SUBCOMMAND", "Search parents — narrow ID-discovery surface (list, show)"
+    subcommand "parents", Wiq::Commands::Parents
+
     desc "charges SUBCOMMAND", "Payment history — list charges by family, status, type, date (admin only)"
     subcommand "charges", Wiq::Commands::Charges
 

data/lib/wiq/commands/parents.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Wiq
+  module Commands
+    class Parents < Base
+      DEFAULT_PER_PAGE = 20
+
+      desc "list", "Search parents — narrow ID-discovery surface"
+      long_desc <<~DESC
+        Narrow listing over the team's parent profiles (teammates only —
+        guest parents from camp signups are excluded server-side). Rows
+        are slim: id, user_id, type, first_name, last_name, full_name.
+        Sorted by first name. Default page size is 20; there's no --all
+        flag.
+
+        Filters:
+          --query        free-text name search (legacy `?query=`)
+          --first-name   q[first_name_cont]
+          --last-name    q[last_name_cont]
+
+        --expand opts into a wider payload:
+          notification_preferences  Adds wiq_app_installed + a
+                                    notification_preferences object
+                                    (email, sms, push, push_user_pref)
+                                    per parent — "which parents can we
+                                    reach, and how?". Coach PATs only;
+                                    the server silently omits it for
+                                    parent/wrestler tokens.
+
+        The parent → wrestler linkage is NOT in this payload. To see a
+        family's kids, go the other direction: `wiq wrestlers show <id>`
+        embeds parent refs, or `wiq wrestlers list --query <last name>`.
+      DESC
+      method_option :query, type: :string, desc: "Free-text name search"
+      method_option :first_name, type: :string, desc: "First name (contains)"
+      method_option :last_name, type: :string, desc: "Last name (contains)"
+      method_option :expand, type: :string,
+                             desc: "CSV: notification_preferences"
+      method_option :per_page, type: :numeric, default: DEFAULT_PER_PAGE,
+                               desc: "Page size (default 20; narrow surface)"
+      def list
+        params = build_list_params
+
+        records, total = fetch_index("/api/v1/parents", params, key: "parent_profiles")
+        render_index(
+          records, total: total,
+          summary: "Listed #{records.size} parents#{summary_filters_suffix}.",
+          breadcrumbs: [
+            { "cmd" => "wiq parents show <id>", "description" => "Drill into one parent" },
+            { "cmd" => "wiq billing_profiles show <id> --profile-type ParentProfile",
+              "description" => "Billing profile for a parent (admin only)" },
+            { "cmd" => "wiq wrestlers list --last-name <name>",
+              "description" => "Find the family's wrestlers (parent refs embedded)" }
+          ]
+        )
+      end
+
+      desc "show ID", "Fetch a single parent profile"
+      long_desc <<~DESC
+        Single-parent drill-down. Same slim payload as the index (id,
+        user_id, type, names); soft-deleted parents still resolve here.
+
+        Pass --expand for additional sections:
+          notification_preferences  wiq_app_installed + notification_preferences
+                                    (email, sms, push, push_user_pref) —
+                                    "can this parent be reached, and how?"
+                                    Coach PATs only; silently omitted for
+                                    parent/wrestler tokens.
+      DESC
+      method_option :expand, type: :string,
+                             desc: "CSV: notification_preferences"
+      def show(id)
+        params = {}
+        params["expand_notification_preferences"] = true if expand_includes?("notification_preferences")
+        parent = client.get("/api/v1/parents/#{id}", params)
+        render(parent,
+               summary: "Parent #{parent["id"]} — #{parent["full_name"]}",
+               breadcrumbs: [
+                 { "cmd" => "wiq billing_profiles show #{parent["id"]} --profile-type ParentProfile",
+                   "description" => "Billing profile for this parent (admin only)" },
+                 { "cmd" => "wiq wrestlers list --last-name #{parent["last_name"]}",
+                   "description" => "Likely wrestlers for this family" }
+               ])
+      end
+
+      no_commands do
+        # Extracted so the spec can verify the option → query-param mapping
+        # without round-tripping a real Faraday connection.
+        def build_list_params
+          params = { "per_page" => options[:per_page] || DEFAULT_PER_PAGE }
+          params["query"] = options[:query] if options[:query]
+          params["q[first_name_cont]"] = options[:first_name] if options[:first_name]
+          params["q[last_name_cont]"] = options[:last_name] if options[:last_name]
+          params["expand_notification_preferences"] = true if expand_includes?("notification_preferences")
+          params
+        end
+
+        def expand_includes?(part)
+          return false unless options[:expand]
+
+          options[:expand].split(",").map(&:strip).include?(part)
+        end
+
+        def summary_filters_suffix
+          bits = []
+          bits << "matching #{options[:query].inspect}" if options[:query]
+          bits << "first name ~ #{options[:first_name].inspect}" if options[:first_name]
+          bits << "last name ~ #{options[:last_name].inspect}" if options[:last_name]
+          bits.empty? ? "" : " (#{bits.join(", ")})"
+        end
+      end
+    end
+  end
+end

data/lib/wiq/commands/wrestlers.rb

@@ -35,8 +35,14 @@ module Wiq
         client-side.
 
         --expand opts into a wider payload:
-          rosters                Adds full roster details per wrestler
-          registration_answers   Adds intake-form answers per wrestler
+          rosters                   Adds full roster details per wrestler
+          registration_answers      Adds intake-form answers per wrestler
+          notification_preferences  Adds wiq_app_installed + a
+                                    notification_preferences object
+                                    (email, sms, push, push_user_pref)
+                                    per wrestler. Coach PATs only — the
+                                    server silently omits it for
+                                    parent/wrestler tokens.
 
         Base payload is already wider than most index endpoints (parents,
         coach_guardians, profile_photos, basic roster refs all render by
@@ -58,7 +64,7 @@ module Wiq
                                    desc: "Default 'teammate' matches the WIQ web UI default; " \
                                          "'all' removes the filter entirely"
       method_option :expand, type: :string,
-                             desc: "CSV: rosters, registration_answers"
+                             desc: "CSV: rosters, registration_answers, notification_preferences"
       method_option :per_page, type: :numeric, default: DEFAULT_PER_PAGE,
                                desc: "Page size (default 20; narrow surface)"
       def list
@@ -84,15 +90,21 @@ module Wiq
         rosters refs).
 
         Pass --expand for additional sections:
-          rosters                Full roster details with tags
-          registration_answers   Intake-form answers
+          rosters                   Full roster details with tags
+          registration_answers      Intake-form answers
+          notification_preferences  wiq_app_installed + notification_preferences
+                                    (email, sms, push, push_user_pref) —
+                                    "can this family be reached, and how?"
+                                    Coach PATs only; silently omitted for
+                                    parent/wrestler tokens.
       DESC
       method_option :expand, type: :string,
-                             desc: "CSV: rosters, registration_answers"
+                             desc: "CSV: rosters, registration_answers, notification_preferences"
       def show(id)
         params = {}
         params["expand_rosters"] = true if expand_includes?("rosters")
         params["expand_registration_answers"] = true if expand_includes?("registration_answers")
+        params["expand_notification_preferences"] = true if expand_includes?("notification_preferences")
         wrestler = client.get("/api/v1/wrestlers/#{id}", params)
         render(wrestler,
                summary: "Wrestler #{wrestler["id"]} — #{wrestler["full_name"] || wrestler["display_name"]}",
@@ -120,6 +132,7 @@ module Wiq
           params["q[profile_type_eq]"] = options[:profile_type] if profile_type_filter?
           params["expand_rosters"] = true if expand_includes?("rosters")
           params["expand_registration_answers"] = true if expand_includes?("registration_answers")
+          params["expand_notification_preferences"] = true if expand_includes?("notification_preferences")
           params
         end
 

data/lib/wiq/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wiq
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/wiq.rb

@@ -26,6 +26,7 @@ require "wiq/commands/prospect_families"
 require "wiq/commands/workflows"
 require "wiq/commands/setup"
 require "wiq/commands/wrestlers"
+require "wiq/commands/parents"
 require "wiq/commands/charges"
 require "wiq/commands/billing_profiles"
 require "wiq/cli"

data/share/skills/wiq/SKILL.md

@@ -343,6 +343,25 @@ For exhaustive exports go through `wiq reports run RosterReport`
 `profile_type=teammate` (matching the WIQ web UI default); pass
 `--profile-type alumnus|guest|all` to widen.
 
+For "can this family be reached, and how?" questions, add
+`--expand notification_preferences` to `wrestlers list|show` or
+`parents list|show`. Each row gains `wiq_app_installed` plus a
+`notification_preferences` object (`email`, `sms`, `push`,
+`push_user_pref`; `null` means no explicit preference recorded). Coach
+PATs only — with a parent/wrestler token the server returns 200 with
+the fields silently absent, so a missing field means "check the
+token's profile type", not "API bug".
+
+### Parents
+
+`wiq parents list [--query <name>] [--first-name X] [--last-name Y]`
+and `wiq parents show <id>` — slim payload (id, user_id, names) over
+the team's teammate parents. There are no wrestler refs on a parent
+row; to walk a family, start from the wrestler side
+(`wiq wrestlers show <id>` embeds parent refs). Main uses: parent-first
+ID discovery for `wiq billing_profiles show <id> --profile-type
+ParentProfile`, and the notification-reachability expand above.
+
 ## Locations (multi-site clubs)
 
 WIQ has a structured Location model (name + street address, per team).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wiq-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - WrestlingIQ
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-02 00:00:00.000000000 Z
+date: 2026-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -93,6 +93,7 @@ files:
 - lib/wiq/commands/locations.rb
 - lib/wiq/commands/metrics.rb
 - lib/wiq/commands/paid_sessions.rb
+- lib/wiq/commands/parents.rb
 - lib/wiq/commands/prospect_families.rb
 - lib/wiq/commands/prospects.rb
 - lib/wiq/commands/registrations.rb