stigg 0.1.0.pre.beta.59 → 0.1.0.pre.beta.60

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b110182dabf0144099cb775786f7cbd2c23130d8f7cbf652dc23bdeb7b91aa8e
-  data.tar.gz: baab0f7102a3d40e12a398e22bf0b745c295d359455857541fff9a0457c0bb97
+  metadata.gz: f4df7ce34a642b404fc2611ff28b9f890a05ee5bf3c429cd2a7f20f4941559e8
+  data.tar.gz: 642be85db9effde32debffe25dbd4662b8182bf8eb00d3056e0e1a44c225af5b
 SHA512:
-  metadata.gz: 9a274dfef112b685dad6a6fcd69a966a446defcdfe554d5ce12d3f5b4e831a92a33ce6165307bd1920a640a446bf991dad0abad6f3c57266ed29342ce2016ead
-  data.tar.gz: 67f5d938b25e4aa07a3ce4ada5e8bfde9789c3a639dbf116ebf1e860281693d60a4ef8794327b20dc846c6a23f31acc083568da11be5d9c6610791531379470c
+  metadata.gz: cf248127d326fba3fc53e55b12dc66353d1a7fcb6a433a5ee4a11884ac3880f2ef30027089b93fd03bcfffa8d093cc94d4b97795c7182da369f638552c58bf60
+  data.tar.gz: b22a07fc1cfff5757ee17c667e16640a6285bd65094595c40543a29b08db5ae9f46afe80a4d8d9f7d3c9ec02766fb2a964362f02a8f1d3283ddb70075f1cfb89

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.1.0-beta.60](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.59...v0.1.0-beta.60) (2026-10-28)
+
+
+### Features
+
+* **STIGG-10529:** governance query as paginated v1Beta.customers.governance.list ([2fc1286](https://github.com/stiggio/stigg-ruby/commit/2fc128611f63f6d1f9796f809ce0e544e3180a2b))
+
+
+### Bug Fixes
+
+* sync OpenAPI spec from stigg-api ([52f3751](https://github.com/stiggio/stigg-ruby/commit/52f37510727f8e194121d9a25653604b5fc5effd))
+* sync OpenAPI spec from stigg-api ([a9f365b](https://github.com/stiggio/stigg-ruby/commit/a9f365b4575f6fcf1533b41ab8fa6ce7cb4a6572))
+* sync OpenAPI spec from stigg-api ([02707c8](https://github.com/stiggio/stigg-ruby/commit/02707c8c8d471921155cfcc15e5ab95088fa32c3))
+* sync OpenAPI spec from stigg-api ([38173fc](https://github.com/stiggio/stigg-ruby/commit/38173fc2c35268bfcd3e85cc0520a542cc567b3f))
+
+
+### Chores
+
+* normalize version.rb to gem prerelease format for stlc codegen ([9071057](https://github.com/stiggio/stigg-ruby/commit/9071057684924855f38983cc91fca3f9095af8fc))
+
 ## [0.1.0-beta.59](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.58...v0.1.0-beta.59) (2026-10-22)
 
 

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "stigg", "~> 0.1.0.pre.beta.58"
+gem "stigg", "~> 0.1.0.pre.beta.59"
 ```
 
 <!-- x-release-please-end -->

data/lib/stigg/models/v1/credits/reservation_release_response.rb

@@ -152,6 +152,7 @@ module Stigg
 
                 ACTIVE = :ACTIVE
                 RELEASED = :RELEASED
+                EXPIRED = :EXPIRED
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

data/lib/stigg/models/v1/customer_check_entitlement_response.rb

@@ -485,6 +485,7 @@ module Stigg
 
                 ACTIVE = :ACTIVE
                 RELEASED = :RELEASED
+                EXPIRED = :EXPIRED
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

data/lib/stigg/models/v1/customer_retrieve_entitlements_response.rb

@@ -527,6 +527,7 @@ module Stigg
 
                   ACTIVE = :ACTIVE
                   RELEASED = :RELEASED
+                  EXPIRED = :EXPIRED
 
                   # @!method self.values
                   #   @return [Array<Symbol>]

data/lib/stigg/models/v1/events/beta/customer_retrieve_governance_params.rb

@@ -16,14 +16,22 @@ module Stigg
             required :id, String
 
             # @!attribute after
-            #   Return items that come after this cursor
+            #   Opaque cursor from a page’s `next`; returns the page after it. Mutually
+            #   exclusive with `before`.
             #
             #   @return [String, nil]
             optional :after, String
 
+            # @!attribute before
+            #   Opaque cursor from a page’s `prev`; returns the page before it. Mutually
+            #   exclusive with `after`.
+            #
+            #   @return [String, nil]
+            optional :before, String
+
             # @!attribute currency_ids
-            #   Currency ids to include, repeated per value (e.g. `?currencyIds=credits`). Omit
-            #   both featureIds and currencyIds for tree mode.
+            #   Currency ids to include, comma-separated (e.g. `?currencyIds=credits`), up
+            #   to 100. Omit both featureIds and currencyIds for tree mode.
             #
             #   @return [Array<String>, nil]
             optional :currency_ids, Stigg::Internal::Type::ArrayOf[String]
@@ -36,17 +44,16 @@ module Stigg
             optional :entity_id_search, String
 
             # @!attribute entity_type_ids
-            #   Filter to one or more entity types, repeated per value (e.g.
-            #   `?entityTypeIds=team&entityTypeIds=user`).
+            #   Filter to one or more entity types, comma-separated (e.g.
+            #   `?entityTypeIds=team,user`), up to 100.
             #
             #   @return [Array<String>, nil]
             optional :entity_type_ids, Stigg::Internal::Type::ArrayOf[String]
 
             # @!attribute feature_ids
-            #   Feature ids to include, repeated per value (e.g.
-            #   `?featureIds=ai-tokens&featureIds=seats`). Omit both featureIds and currencyIds
-            #   for tree mode — every node in the hierarchy with no usage configuration
-            #   attached.
+            #   Feature ids to include, comma-separated (e.g. `?featureIds=ai-tokens,seats`), up
+            #   to 100. Omit both featureIds and currencyIds for tree mode — every node in the
+            #   hierarchy with no usage configuration attached.
             #
             #   @return [Array<String>, nil]
             optional :feature_ids, Stigg::Internal::Type::ArrayOf[String]
@@ -94,22 +101,24 @@ module Stigg
             #   @return [String, nil]
             optional :x_environment_id, String
 
-            # @!method initialize(id:, after: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+            # @!method initialize(id:, after: nil, before: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
             #   Some parameter documentations has been truncated, see
             #   {Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceParams} for more
             #   details.
             #
             #   @param id [String]
             #
-            #   @param after [String] Return items that come after this cursor
+            #   @param after [String] Opaque cursor from a page’s `next`; returns the page after it. Mutually exclusiv
+            #
+            #   @param before [String] Opaque cursor from a page’s `prev`; returns the page before it. Mutually exclusi
             #
-            #   @param currency_ids [Array<String>] Currency ids to include, repeated per value (e.g. `?currencyIds=credits`). Omit
+            #   @param currency_ids [Array<String>] Currency ids to include, comma-separated (e.g. `?currencyIds=credits`), up to 10
             #
             #   @param entity_id_search [String] Case-insensitive substring match on the entity id or its display name (`%`/`_` m
             #
-            #   @param entity_type_ids [Array<String>] Filter to one or more entity types, repeated per value (e.g. `?entityTypeIds=tea
+            #   @param entity_type_ids [Array<String>] Filter to one or more entity types, comma-separated (e.g. `?entityTypeIds=team,u
             #
-            #   @param feature_ids [Array<String>] Feature ids to include, repeated per value (e.g. `?featureIds=ai-tokens&featureI
+            #   @param feature_ids [Array<String>] Feature ids to include, comma-separated (e.g. `?featureIds=ai-tokens,seats`), up
             #
             #   @param limit [Integer] Maximum number of items to return
             #

data/lib/stigg/models/v1/events/beta/customer_retrieve_governance_response.rb

@@ -164,12 +164,20 @@ module Stigg
               #   @return [String, nil]
               required :next_, String, api_name: :next, nil?: true
 
-              # @!method initialize(next_:)
+              # @!attribute prev
+              #   Cursor for fetching the previous page of results, or null if at the beginning
+              #
+              #   @return [String, nil]
+              required :prev, String, nil?: true
+
+              # @!method initialize(next_:, prev:)
               #   Some parameter documentations has been truncated, see
               #   {Stigg::Models::V1::Events::Beta::CustomerRetrieveGovernanceResponse::Pagination}
               #   for more details.
               #
               #   @param next_ [String, nil] Cursor for fetching the next page of results, or null if no additional pages exi
+              #
+              #   @param prev [String, nil] Cursor for fetching the previous page of results, or null if at the beginning
             end
           end
         end

data/lib/stigg/models/v1/subscription_provision_response.rb

@@ -571,6 +571,7 @@ module Stigg
 
                   ACTIVE = :ACTIVE
                   RELEASED = :RELEASED
+                  EXPIRED = :EXPIRED
 
                   # @!method self.values
                   #   @return [Array<Symbol>]

data/lib/stigg/models/v1_beta/customers/assignment_upsert_params.rb

@@ -72,7 +72,8 @@ module Stigg
             # @!attribute parent_id
             #   Parent entity ID in the hierarchy. Omit to leave the current parent untouched (a
             #   new node defaults to a root); `null` detaches to a root; an ID sets or changes
-            #   the parent. Reparenting an existing node is leaf-only.
+            #   the parent. Reparenting or detaching an existing node is leaf-only; place a
+            #   parent before its children, or in the same batch.
             #
             #   @return [String, nil]
             optional :parent_id, String, api_name: :parentId, nil?: true

data/lib/stigg/models/v1_beta/customers/entitlement_check_response.rb

@@ -629,6 +629,7 @@ module Stigg
 
                   ACTIVE = :ACTIVE
                   RELEASED = :RELEASED
+                  EXPIRED = :EXPIRED
 
                   # @!method self.values
                   #   @return [Array<Symbol>]

data/lib/stigg/models/v1_beta/customers/governance_list_params.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1Beta
+      module Customers
+        # @see Stigg::Resources::V1Beta::Customers::Governance#list
+        class GovernanceListParams < Stigg::Internal::Type::BaseModel
+          extend Stigg::Internal::Type::RequestParameters::Converter
+          include Stigg::Internal::Type::RequestParameters
+
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute after
+          #   Opaque cursor from a page’s `next`; returns the page after it. Mutually
+          #   exclusive with `before`.
+          #
+          #   @return [String, nil]
+          optional :after, String
+
+          # @!attribute before
+          #   Opaque cursor from a page’s `prev`; returns the page before it. Mutually
+          #   exclusive with `after`.
+          #
+          #   @return [String, nil]
+          optional :before, String
+
+          # @!attribute currency_ids
+          #   Currency ids to include, comma-separated (e.g. `?currencyIds=credits`), up
+          #   to 100. Omit both featureIds and currencyIds for tree mode.
+          #
+          #   @return [Array<String>, nil]
+          optional :currency_ids, Stigg::Internal::Type::ArrayOf[String]
+
+          # @!attribute entity_id_search
+          #   Case-insensitive substring match on the entity id or its display name (`%`/`_`
+          #   matched literally).
+          #
+          #   @return [String, nil]
+          optional :entity_id_search, String
+
+          # @!attribute entity_type_ids
+          #   Filter to one or more entity types, comma-separated (e.g.
+          #   `?entityTypeIds=team,user`), up to 100.
+          #
+          #   @return [Array<String>, nil]
+          optional :entity_type_ids, Stigg::Internal::Type::ArrayOf[String]
+
+          # @!attribute feature_ids
+          #   Feature ids to include, comma-separated (e.g. `?featureIds=ai-tokens,seats`), up
+          #   to 100. Omit both featureIds and currencyIds for tree mode — every node in the
+          #   hierarchy with no usage configuration attached.
+          #
+          #   @return [Array<String>, nil]
+          optional :feature_ids, Stigg::Internal::Type::ArrayOf[String]
+
+          # @!attribute limit
+          #   Maximum number of items to return
+          #
+          #   @return [Integer, nil]
+          optional :limit, Integer
+
+          # @!attribute min_utilization
+          #   Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over
+          #   limit).
+          #
+          #   @return [Float, nil]
+          optional :min_utilization, Float
+
+          # @!attribute order
+          #   Sort direction: `asc` or `desc` (default `desc`).
+          #
+          #   @return [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::Order, nil]
+          optional :order, enum: -> { Stigg::V1Beta::Customers::GovernanceListParams::Order }
+
+          # @!attribute scope
+          #   Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or
+          #   `scoped` (non-empty only).
+          #
+          #   @return [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::Scope, nil]
+          optional :scope, enum: -> { Stigg::V1Beta::Customers::GovernanceListParams::Scope }
+
+          # @!attribute sort_by
+          #   Sort key: `utilization` (default, cross-capability-safe), `currentUsage`,
+          #   `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+          #
+          #   @return [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::SortBy, nil]
+          optional :sort_by, enum: -> { Stigg::V1Beta::Customers::GovernanceListParams::SortBy }
+
+          # @!attribute x_account_id
+          #
+          #   @return [String, nil]
+          optional :x_account_id, String
+
+          # @!attribute x_environment_id
+          #
+          #   @return [String, nil]
+          optional :x_environment_id, String
+
+          # @!method initialize(id:, after: nil, before: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1Beta::Customers::GovernanceListParams} for more details.
+          #
+          #   @param id [String]
+          #
+          #   @param after [String] Opaque cursor from a page’s `next`; returns the page after it. Mutually exclusiv
+          #
+          #   @param before [String] Opaque cursor from a page’s `prev`; returns the page before it. Mutually exclusi
+          #
+          #   @param currency_ids [Array<String>] Currency ids to include, comma-separated (e.g. `?currencyIds=credits`), up to 10
+          #
+          #   @param entity_id_search [String] Case-insensitive substring match on the entity id or its display name (`%`/`_` m
+          #
+          #   @param entity_type_ids [Array<String>] Filter to one or more entity types, comma-separated (e.g. `?entityTypeIds=team,u
+          #
+          #   @param feature_ids [Array<String>] Feature ids to include, comma-separated (e.g. `?featureIds=ai-tokens,seats`), up
+          #
+          #   @param limit [Integer] Maximum number of items to return
+          #
+          #   @param min_utilization [Float] Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over limit
+          #
+          #   @param order [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::Order] Sort direction: `asc` or `desc` (default `desc`).
+          #
+          #   @param scope [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::Scope] Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or `scop
+          #
+          #   @param sort_by [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::SortBy] Sort key: `utilization` (default, cross-capability-safe), `currentUsage`, `usage
+          #
+          #   @param x_account_id [String]
+          #
+          #   @param x_environment_id [String]
+          #
+          #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+          # Sort direction: `asc` or `desc` (default `desc`).
+          module Order
+            extend Stigg::Internal::Type::Enum
+
+            ASC = :asc
+            DESC = :desc
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or
+          # `scoped` (non-empty only).
+          module Scope
+            extend Stigg::Internal::Type::Enum
+
+            ALL = :all
+            NODE_WIDE = :nodeWide
+            SCOPED = :scoped
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Sort key: `utilization` (default, cross-capability-safe), `currentUsage`,
+          # `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+          module SortBy
+            extend Stigg::Internal::Type::Enum
+
+            UTILIZATION = :utilization
+            CURRENT_USAGE = :currentUsage
+            USAGE_LIMIT = :usageLimit
+            SCOPE_SIZE = :scopeSize
+            ID = :id
+            CREATED_AT = :createdAt
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1_beta/customers/governance_list_response.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1Beta
+      module Customers
+        # @see Stigg::Resources::V1Beta::Customers::Governance#list
+        class GovernanceListResponse < Stigg::Internal::Type::BaseModel
+          # @!attribute cadence
+          #   Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+          #   `PT1M`; `null` when the node has no usage configuration.
+          #
+          #   @return [String, nil]
+          required :cadence, String, nil?: true
+
+          # @!attribute current_usage
+          #   Usage consumed in the current cadence period (may lag the live counter by a
+          #   short interval).
+          #
+          #   @return [Float, nil]
+          required :current_usage, Float, api_name: :currentUsage, nil?: true
+
+          # @!attribute display_name
+          #   Human-readable name of the entity, or null when none is set (display the entity
+          #   id instead).
+          #
+          #   @return [String, nil]
+          required :display_name, String, api_name: :displayName, nil?: true
+
+          # @!attribute entity_id
+          #   External id of the entity at this node.
+          #
+          #   @return [String]
+          required :entity_id, String, api_name: :entityId
+
+          # @!attribute entity_type_id
+          #   External id of the entity type (e.g. `team`, `user`).
+          #
+          #   @return [String]
+          required :entity_type_id, String, api_name: :entityTypeId
+
+          # @!attribute parent_id
+          #   External id of the parent entity in the tree. `null` means the entity is either
+          #   a root or not yet placed in the hierarchy — placement rides on an assignment, so
+          #   an entity with no limits set has no parent yet. Both render at the top level;
+          #   use it to rebuild the tree.
+          #
+          #   @return [String, nil]
+          required :parent_id, String, api_name: :parentId, nil?: true
+
+          # @!attribute scope_entity_ids
+          #   The configuration scope (entity ids). Empty is the node-wide configuration; a
+          #   non-empty set is a dimension-scoped sub-configuration.
+          #
+          #   @return [Array<String>]
+          required :scope_entity_ids, Stigg::Internal::Type::ArrayOf[String], api_name: :scopeEntityIds
+
+          # @!attribute usage_limit
+          #   Hard usage limit for this node per cadence period.
+          #
+          #   @return [Float, nil]
+          required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+          # @!attribute usage_period_end
+          #   Exclusive end of the cadence period in progress now — when usage resets. `null`
+          #   when the node has no usage configuration, or when a stored cadence cannot be
+          #   parsed.
+          #
+          #   @return [Time, nil]
+          required :usage_period_end, Time, api_name: :usagePeriodEnd, nil?: true
+
+          # @!attribute usage_period_start
+          #   Start of the cadence period in progress now, derived from the cadence and the
+          #   assignment anchor — it stays correct across a rollover. `null` when the node has
+          #   no usage configuration, or when a stored cadence cannot be parsed.
+          #
+          #   @return [Time, nil]
+          required :usage_period_start, Time, api_name: :usagePeriodStart, nil?: true
+
+          # @!attribute utilization
+          #   `currentUsage / usageLimit` (1 when usageLimit is 0 — always at limit). The
+          #   cross-capability-safe sort key.
+          #
+          #   @return [Float, nil]
+          required :utilization, Float, nil?: true
+
+          # @!attribute currency_id
+          #   The metered currency ID (present when the configured capability is a credit
+          #   currency).
+          #
+          #   @return [String, nil]
+          optional :currency_id, String, api_name: :currencyId
+
+          # @!attribute feature_id
+          #   The metered feature ID (present when the configured capability is a feature).
+          #
+          #   @return [String, nil]
+          optional :feature_id, String, api_name: :featureId
+
+          # @!method initialize(cadence:, current_usage:, display_name:, entity_id:, entity_type_id:, parent_id:, scope_entity_ids:, usage_limit:, usage_period_end:, usage_period_start:, utilization:, currency_id: nil, feature_id: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1Beta::Customers::GovernanceListResponse} for more details.
+          #
+          #   A node of the governance hierarchy tree with its usage configuration (limit,
+          #   cadence, scope) and current usage. Usage is read from a periodically-refreshed
+          #   read model and may lag the live counter by a short interval; it never gates
+          #   access.
+          #
+          #   @param cadence [String, nil] Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`, `PT
+          #
+          #   @param current_usage [Float, nil] Usage consumed in the current cadence period (may lag the live counter by a shor
+          #
+          #   @param display_name [String, nil] Human-readable name of the entity, or null when none is set (display the entity
+          #
+          #   @param entity_id [String] External id of the entity at this node.
+          #
+          #   @param entity_type_id [String] External id of the entity type (e.g. `team`, `user`).
+          #
+          #   @param parent_id [String, nil] External id of the parent entity in the tree. `null` means the entity is either
+          #
+          #   @param scope_entity_ids [Array<String>] The configuration scope (entity ids). Empty is the node-wide configuration; a no
+          #
+          #   @param usage_limit [Float, nil] Hard usage limit for this node per cadence period.
+          #
+          #   @param usage_period_end [Time, nil] Exclusive end of the cadence period in progress now — when usage resets. `null`
+          #
+          #   @param usage_period_start [Time, nil] Start of the cadence period in progress now, derived from the cadence and the as
+          #
+          #   @param utilization [Float, nil] `currentUsage / usageLimit` (1 when usageLimit is 0 — always at limit). The cros
+          #
+          #   @param currency_id [String] The metered currency ID (present when the configured capability is a credit curr
+          #
+          #   @param feature_id [String] The metered feature ID (present when the configured capability is a feature).
+        end
+      end
+    end
+  end
+end

data/lib/stigg/resources/v1/events/beta/customers.rb

@@ -16,19 +16,21 @@ module Stigg
             # tree can be rebuilt client-side. Usage is read from a periodically-refreshed
             # read model and never gates access.
             #
-            # @overload retrieve_governance(id, after: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+            # @overload retrieve_governance(id, after: nil, before: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
             #
             # @param id [String] Path param: The customer ID.
             #
-            # @param after [String] Query param: Return items that come after this cursor
+            # @param after [String] Query param: Opaque cursor from a page’s `next`; returns the page after it. Mutu
             #
-            # @param currency_ids [Array<String>] Query param: Currency ids to include, repeated per value (e.g. `?currencyIds=cre
+            # @param before [String] Query param: Opaque cursor from a page’s `prev`; returns the page before it. Mut
+            #
+            # @param currency_ids [Array<String>] Query param: Currency ids to include, comma-separated (e.g. `?currencyIds=credit
             #
             # @param entity_id_search [String] Query param: Case-insensitive substring match on the entity id or its display na
             #
-            # @param entity_type_ids [Array<String>] Query param: Filter to one or more entity types, repeated per value (e.g. `?enti
+            # @param entity_type_ids [Array<String>] Query param: Filter to one or more entity types, comma-separated (e.g. `?entityT
             #
-            # @param feature_ids [Array<String>] Query param: Feature ids to include, repeated per value (e.g. `?featureIds=ai-to
+            # @param feature_ids [Array<String>] Query param: Feature ids to include, comma-separated (e.g. `?featureIds=ai-token
             #
             # @param limit [Integer] Query param: Maximum number of items to return
             #
@@ -53,6 +55,7 @@ module Stigg
               query_params =
                 [
                   :after,
+                  :before,
                   :currency_ids,
                   :entity_id_search,
                   :entity_type_ids,

data/lib/stigg/resources/v1_beta/customers/governance.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Resources
+    class V1Beta
+      class Customers
+        class Governance
+          # Some parameter documentations has been truncated, see
+          # {Stigg::Models::V1Beta::Customers::GovernanceListParams} for more details.
+          #
+          # Queries the customer's governance hierarchy tree, returning a cursor-paginated
+          # list of nodes with their usage configuration (limit, cadence, scope) and current
+          # usage, sortable and filterable by usage. Each node carries `parentId` so the
+          # tree can be rebuilt client-side. Usage is read from a periodically-refreshed
+          # read model and never gates access.
+          #
+          # @overload list(id, after: nil, before: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+          #
+          # @param id [String] Path param: The customer ID.
+          #
+          # @param after [String] Query param: Opaque cursor from a page’s `next`; returns the page after it. Mutu
+          #
+          # @param before [String] Query param: Opaque cursor from a page’s `prev`; returns the page before it. Mut
+          #
+          # @param currency_ids [Array<String>] Query param: Currency ids to include, comma-separated (e.g. `?currencyIds=credit
+          #
+          # @param entity_id_search [String] Query param: Case-insensitive substring match on the entity id or its display na
+          #
+          # @param entity_type_ids [Array<String>] Query param: Filter to one or more entity types, comma-separated (e.g. `?entityT
+          #
+          # @param feature_ids [Array<String>] Query param: Feature ids to include, comma-separated (e.g. `?featureIds=ai-token
+          #
+          # @param limit [Integer] Query param: Maximum number of items to return
+          #
+          # @param min_utilization [Float] Query param: Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for
+          #
+          # @param order [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::Order] Query param: Sort direction: `asc` or `desc` (default `desc`).
+          #
+          # @param scope [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::Scope] Query param: Filter by configuration scope: `all` (default), `nodeWide` (`[]` on
+          #
+          # @param sort_by [Symbol, Stigg::Models::V1Beta::Customers::GovernanceListParams::SortBy] Query param: Sort key: `utilization` (default, cross-capability-safe), `currentU
+          #
+          # @param x_account_id [String] Header param: Account ID — optional when authenticating with a user JWT (Bearer
+          #
+          # @param x_environment_id [String] Header param: Environment ID — required when authenticating with a user JWT (Bea
+          #
+          # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Stigg::Internal::MyCursorIDPage<Stigg::Models::V1Beta::Customers::GovernanceListResponse>]
+          #
+          # @see Stigg::Models::V1Beta::Customers::GovernanceListParams
+          def list(id, params = {})
+            query_params =
+              [
+                :after,
+                :before,
+                :currency_ids,
+                :entity_id_search,
+                :entity_type_ids,
+                :feature_ids,
+                :limit,
+                :min_utilization,
+                :order,
+                :scope,
+                :sort_by
+              ]
+            parsed, options = Stigg::V1Beta::Customers::GovernanceListParams.dump_request(params)
+            query = Stigg::Internal::Util.encode_query_params(parsed.slice(*query_params))
+            @client.request(
+              method: :get,
+              path: ["api/v1-beta/customers/%1$s/governance", id],
+              query: query.transform_keys(
+                currency_ids: "currencyIds",
+                entity_id_search: "entityIdSearch",
+                entity_type_ids: "entityTypeIds",
+                feature_ids: "featureIds",
+                min_utilization: "minUtilization",
+                sort_by: "sortBy"
+              ),
+              headers: parsed.except(*query_params).transform_keys(
+                x_account_id: "x-account-id",
+                x_environment_id: "x-environment-id"
+              ),
+              page: Stigg::Internal::MyCursorIDPage,
+              model: Stigg::Models::V1Beta::Customers::GovernanceListResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Stigg::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end