temper-rb 0.5.1

data/lib/temper/generated/models/standing_shape.rb

@@ -0,0 +1,355 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # A finding's evidential-standing shape (SQL `resource_standing_shape`). All fields are non-nullable: the access gate is INSIDE the SQL (a `gated` CTE over `resources_readable_by`), so an unreadable finding yields zero rows — never a partial/nullable row — and the caller-side read returns `Option<StandingShape>`, `None` for \"not readable.\"  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+  class StandingShape < ApiModelBase
+    # How many of those distinct sources carry at least one audit. Monotone under the append-only audit trail (spec §4.1) — once a source is audited it stays covered. The *evaluated-ness* axis, and the thing that tells \"nobody tried\" apart from \"N sources were evaluated.\"  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :audit_coverage
+
+    # Lossy read-time summary band (`provisional` / `reinforced` / `disputed` / `near-canonical`) computed over the shape above. Carried WITH the shape, never presented instead of it (spec §1.1).  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :band
+
+    # Count of **distinct live** sources the finding cites (Set 5, spec §3.1). Monotone — citing more evidence never lowers it. The *findability* axis: deliberately NOT `r_parent`, which counts provenance rows including duplicates. Ten citations of one source is `r_parent = 10, citation_magnitude = 1`, and collapsing the two reintroduces the actor-count fallacy.  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :citation_magnitude
+
+    # Mean, over the **audited subset only**, of each audited source's decay-weighted audit value, in `[-1.0, 1.0]`. Reads as a neutral `0.0` when `audit_coverage = 0`: an unaudited finding makes no quality claim, and its low standing comes from the band gate, never from a poisoned mean (spec §3.2).  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :citation_quality
+
+    # Supports minus contradicts, as a vector-sum over declared edges (spec §1) — not a headcount.  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :contradiction_balance
+
+    # `kb_resources.id` of the finding this shape describes. Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :finding_id
+
+    # Reversible time-decay off the finding's most recent uncorrected reinforcement; computed live at read (never from the memo) because it must reflect the current moment.  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :freshness
+
+    # Reinforcement breadth: count of uncorrected provenance over the finding's live blocks.  Reader-independent by decision: one value for every caller who can read the finding, with per-contributor attribution on the citation-audit trail, never on the shape (stored-aggregates exception: `internal/decisions/2026-08-26-stored-region-aggregates-are-region-truth.md`).
+    attr_accessor :r_parent
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'audit_coverage' => :'audit_coverage',
+        :'band' => :'band',
+        :'citation_magnitude' => :'citation_magnitude',
+        :'citation_quality' => :'citation_quality',
+        :'contradiction_balance' => :'contradiction_balance',
+        :'finding_id' => :'finding_id',
+        :'freshness' => :'freshness',
+        :'r_parent' => :'r_parent'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'audit_coverage' => :'Integer',
+        :'band' => :'String',
+        :'citation_magnitude' => :'Integer',
+        :'citation_quality' => :'Float',
+        :'contradiction_balance' => :'Float',
+        :'finding_id' => :'String',
+        :'freshness' => :'Float',
+        :'r_parent' => :'Float'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Temper::Generated::StandingShape` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Temper::Generated::StandingShape`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'audit_coverage')
+        self.audit_coverage = attributes[:'audit_coverage']
+      else
+        self.audit_coverage = nil
+      end
+
+      if attributes.key?(:'band')
+        self.band = attributes[:'band']
+      else
+        self.band = nil
+      end
+
+      if attributes.key?(:'citation_magnitude')
+        self.citation_magnitude = attributes[:'citation_magnitude']
+      else
+        self.citation_magnitude = nil
+      end
+
+      if attributes.key?(:'citation_quality')
+        self.citation_quality = attributes[:'citation_quality']
+      else
+        self.citation_quality = nil
+      end
+
+      if attributes.key?(:'contradiction_balance')
+        self.contradiction_balance = attributes[:'contradiction_balance']
+      else
+        self.contradiction_balance = nil
+      end
+
+      if attributes.key?(:'finding_id')
+        self.finding_id = attributes[:'finding_id']
+      else
+        self.finding_id = nil
+      end
+
+      if attributes.key?(:'freshness')
+        self.freshness = attributes[:'freshness']
+      else
+        self.freshness = nil
+      end
+
+      if attributes.key?(:'r_parent')
+        self.r_parent = attributes[:'r_parent']
+      else
+        self.r_parent = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @audit_coverage.nil?
+        invalid_properties.push('invalid value for "audit_coverage", audit_coverage cannot be nil.')
+      end
+
+      if @band.nil?
+        invalid_properties.push('invalid value for "band", band cannot be nil.')
+      end
+
+      if @citation_magnitude.nil?
+        invalid_properties.push('invalid value for "citation_magnitude", citation_magnitude cannot be nil.')
+      end
+
+      if @citation_quality.nil?
+        invalid_properties.push('invalid value for "citation_quality", citation_quality cannot be nil.')
+      end
+
+      if @contradiction_balance.nil?
+        invalid_properties.push('invalid value for "contradiction_balance", contradiction_balance cannot be nil.')
+      end
+
+      if @finding_id.nil?
+        invalid_properties.push('invalid value for "finding_id", finding_id cannot be nil.')
+      end
+
+      if @freshness.nil?
+        invalid_properties.push('invalid value for "freshness", freshness cannot be nil.')
+      end
+
+      if @r_parent.nil?
+        invalid_properties.push('invalid value for "r_parent", r_parent cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @audit_coverage.nil?
+      return false if @band.nil?
+      return false if @citation_magnitude.nil?
+      return false if @citation_quality.nil?
+      return false if @contradiction_balance.nil?
+      return false if @finding_id.nil?
+      return false if @freshness.nil?
+      return false if @r_parent.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] audit_coverage Value to be assigned
+    def audit_coverage=(audit_coverage)
+      if audit_coverage.nil?
+        fail ArgumentError, 'audit_coverage cannot be nil'
+      end
+
+      @audit_coverage = audit_coverage
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] band Value to be assigned
+    def band=(band)
+      if band.nil?
+        fail ArgumentError, 'band cannot be nil'
+      end
+
+      @band = band
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] citation_magnitude Value to be assigned
+    def citation_magnitude=(citation_magnitude)
+      if citation_magnitude.nil?
+        fail ArgumentError, 'citation_magnitude cannot be nil'
+      end
+
+      @citation_magnitude = citation_magnitude
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] citation_quality Value to be assigned
+    def citation_quality=(citation_quality)
+      if citation_quality.nil?
+        fail ArgumentError, 'citation_quality cannot be nil'
+      end
+
+      @citation_quality = citation_quality
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] contradiction_balance Value to be assigned
+    def contradiction_balance=(contradiction_balance)
+      if contradiction_balance.nil?
+        fail ArgumentError, 'contradiction_balance cannot be nil'
+      end
+
+      @contradiction_balance = contradiction_balance
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] finding_id Value to be assigned
+    def finding_id=(finding_id)
+      if finding_id.nil?
+        fail ArgumentError, 'finding_id cannot be nil'
+      end
+
+      @finding_id = finding_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] freshness Value to be assigned
+    def freshness=(freshness)
+      if freshness.nil?
+        fail ArgumentError, 'freshness cannot be nil'
+      end
+
+      @freshness = freshness
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] r_parent Value to be assigned
+    def r_parent=(r_parent)
+      if r_parent.nil?
+        fail ArgumentError, 'r_parent cannot be nil'
+      end
+
+      @r_parent = r_parent
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          audit_coverage == o.audit_coverage &&
+          band == o.band &&
+          citation_magnitude == o.citation_magnitude &&
+          citation_quality == o.citation_quality &&
+          contradiction_balance == o.contradiction_balance &&
+          finding_id == o.finding_id &&
+          freshness == o.freshness &&
+          r_parent == o.r_parent
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [audit_coverage, band, citation_magnitude, citation_quality, contradiction_balance, finding_id, freshness, r_parent].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/temper/generated/models/subscription.rb

@@ -0,0 +1,267 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # A sync subscription — scopes which resources materialize locally.  Each subscription is self-contained with its own sync and merge settings. `local_paths` and `repos` enable CWD-to-context inference.
+  class Subscription < ApiModelBase
+    # Run local-only manifest pre-flight on every temper command
+    attr_accessor :auto_sync
+
+    # Which kb_context this subscription targets
+    attr_accessor :context
+
+    # Doc type filter (None = all types)
+    attr_accessor :doc_types
+
+    # Local directories mapped to this context
+    attr_accessor :local_paths
+
+    # Conflict resolution policy for this subscription
+    attr_accessor :merge_policy
+
+    # Resource owner — `@handle`, `+team`, or `@me` (None = use `team` fallback then `@me`)
+    attr_accessor :owner
+
+    # Git repos associated with this context (owner/repo or local paths)
+    attr_accessor :repos
+
+    # Team-owned context (None = profile-owned). Deprecated: use `owner` instead.
+    attr_accessor :team
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'auto_sync' => :'auto_sync',
+        :'context' => :'context',
+        :'doc_types' => :'doc_types',
+        :'local_paths' => :'local_paths',
+        :'merge_policy' => :'merge_policy',
+        :'owner' => :'owner',
+        :'repos' => :'repos',
+        :'team' => :'team'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'auto_sync' => :'Boolean',
+        :'context' => :'String',
+        :'doc_types' => :'Array<String>',
+        :'local_paths' => :'Array<String>',
+        :'merge_policy' => :'MergePolicy',
+        :'owner' => :'String',
+        :'repos' => :'Array<String>',
+        :'team' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'doc_types',
+        :'owner',
+        :'team'
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Temper::Generated::Subscription` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Temper::Generated::Subscription`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'auto_sync')
+        self.auto_sync = attributes[:'auto_sync']
+      end
+
+      if attributes.key?(:'context')
+        self.context = attributes[:'context']
+      else
+        self.context = nil
+      end
+
+      if attributes.key?(:'doc_types')
+        if (value = attributes[:'doc_types']).is_a?(Array)
+          self.doc_types = value
+        end
+      end
+
+      if attributes.key?(:'local_paths')
+        if (value = attributes[:'local_paths']).is_a?(Array)
+          self.local_paths = value
+        end
+      end
+
+      if attributes.key?(:'merge_policy')
+        self.merge_policy = attributes[:'merge_policy']
+      end
+
+      if attributes.key?(:'owner')
+        self.owner = attributes[:'owner']
+      end
+
+      if attributes.key?(:'repos')
+        if (value = attributes[:'repos']).is_a?(Array)
+          self.repos = value
+        end
+      end
+
+      if attributes.key?(:'team')
+        self.team = attributes[:'team']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @context.nil?
+        invalid_properties.push('invalid value for "context", context cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @context.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] context Value to be assigned
+    def context=(context)
+      if context.nil?
+        fail ArgumentError, 'context cannot be nil'
+      end
+
+      @context = context
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          auto_sync == o.auto_sync &&
+          context == o.context &&
+          doc_types == o.doc_types &&
+          local_paths == o.local_paths &&
+          merge_policy == o.merge_policy &&
+          owner == o.owner &&
+          repos == o.repos &&
+          team == o.team
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [auto_sync, context, doc_types, local_paths, merge_policy, owner, repos, team].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end