temper-rb 0.5.1

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

@@ -0,0 +1,366 @@
+=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
+  # One audit of one citation, with its auditor named — an element of the response to `GET /api/resources/{id}/citation-audits` (SQL `resource_citation_audit_trail`, `migrations/20260724000220`).  **This is the attribution `StandingShape` collapses away.** `audit_coverage` and `citation_quality` are aggregates over exactly these rows, so a finding pushed to `disputed` by one auditor and a finding pushed there by three read identically on the shape and differently here. Spec §5.2: identity travels on the emitting event (`kb_events.emitter_entity_id → kb_entities.profile_id`), which Beat 1 materialized as `kb_citation_audits.audited_by_profile_id`; this row carries that profile plus the two human-readable columns of `kb_profiles` (`handle`, `display_name` — both `NOT NULL`), so a caller never has to make a second round trip to name a voter.  All fields are non-nullable except `reason`, which is nullable on the ledger. The access gate is INSIDE the SQL, so an unreadable finding produces no rows at all rather than a redacted one.
+  class CitationAuditRow < ApiModelBase
+    # `kb_citation_audits.id` — the same id `POST /api/resources/{id}/citation-audits` returns (`handlers::citation_audits::record` → `Json<Uuid>`), which is why it is a bare `Uuid` here and not a newtype. A **masked surrogate**: the replay-stable identity of an audit is its `audited_by_event_id`, so this addresses the row in this response, not across a replay.
+    attr_accessor :audit_id
+
+    # The auditor's `kb_profiles.display_name`.
+    attr_accessor :auditor_display_name
+
+    # The auditor's unique `kb_profiles.handle`.
+    attr_accessor :auditor_handle
+
+    # The auditor's profile. **Not the citer** — the self-audit denial arm exists precisely so the two cannot be the same profile for a given citation.
+    attr_accessor :auditor_profile_id
+
+    # The audited citation's block. Carried alongside `source_id` because a citation IS the `(block, source)` pair — one source cited by two of the finding's blocks is two citations, separately auditable.
+    attr_accessor :block_id
+
+    # When the audit was emitted, stamped from the owning event's `occurred_at` (never `now()`). Load-bearing, not decoration: `resource_citation_quality` weights each audit by `pow(0.5, age/30d)`, so this is the row's weight in the number the shape read returned.
+    attr_accessor :created
+
+    # The auditor's free-text rationale, if it gave one.
+    attr_accessor :reason
+
+    # The audited citation's cited source. Always resource-kind — only resource-kind citations are auditable (the `citation_audit` write path rejects every other kind), so no `source_kind` discriminator is carried.
+    attr_accessor :source_id
+
+    # The auditor's signed verdict in `[-1.0, 1.0]`: how much defensibility this citation confers for the connection it makes (spec §3.3), never a claim about what the source says.
+    attr_accessor :value
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'audit_id' => :'audit_id',
+        :'auditor_display_name' => :'auditor_display_name',
+        :'auditor_handle' => :'auditor_handle',
+        :'auditor_profile_id' => :'auditor_profile_id',
+        :'block_id' => :'block_id',
+        :'created' => :'created',
+        :'reason' => :'reason',
+        :'source_id' => :'source_id',
+        :'value' => :'value'
+      }
+    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_id' => :'String',
+        :'auditor_display_name' => :'String',
+        :'auditor_handle' => :'String',
+        :'auditor_profile_id' => :'String',
+        :'block_id' => :'String',
+        :'created' => :'Time',
+        :'reason' => :'String',
+        :'source_id' => :'String',
+        :'value' => :'Float'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'reason',
+      ])
+    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::CitationAuditRow` 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::CitationAuditRow`. 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_id')
+        self.audit_id = attributes[:'audit_id']
+      else
+        self.audit_id = nil
+      end
+
+      if attributes.key?(:'auditor_display_name')
+        self.auditor_display_name = attributes[:'auditor_display_name']
+      else
+        self.auditor_display_name = nil
+      end
+
+      if attributes.key?(:'auditor_handle')
+        self.auditor_handle = attributes[:'auditor_handle']
+      else
+        self.auditor_handle = nil
+      end
+
+      if attributes.key?(:'auditor_profile_id')
+        self.auditor_profile_id = attributes[:'auditor_profile_id']
+      else
+        self.auditor_profile_id = nil
+      end
+
+      if attributes.key?(:'block_id')
+        self.block_id = attributes[:'block_id']
+      else
+        self.block_id = nil
+      end
+
+      if attributes.key?(:'created')
+        self.created = attributes[:'created']
+      else
+        self.created = nil
+      end
+
+      if attributes.key?(:'reason')
+        self.reason = attributes[:'reason']
+      end
+
+      if attributes.key?(:'source_id')
+        self.source_id = attributes[:'source_id']
+      else
+        self.source_id = nil
+      end
+
+      if attributes.key?(:'value')
+        self.value = attributes[:'value']
+      else
+        self.value = 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_id.nil?
+        invalid_properties.push('invalid value for "audit_id", audit_id cannot be nil.')
+      end
+
+      if @auditor_display_name.nil?
+        invalid_properties.push('invalid value for "auditor_display_name", auditor_display_name cannot be nil.')
+      end
+
+      if @auditor_handle.nil?
+        invalid_properties.push('invalid value for "auditor_handle", auditor_handle cannot be nil.')
+      end
+
+      if @auditor_profile_id.nil?
+        invalid_properties.push('invalid value for "auditor_profile_id", auditor_profile_id cannot be nil.')
+      end
+
+      if @block_id.nil?
+        invalid_properties.push('invalid value for "block_id", block_id cannot be nil.')
+      end
+
+      if @created.nil?
+        invalid_properties.push('invalid value for "created", created cannot be nil.')
+      end
+
+      if @source_id.nil?
+        invalid_properties.push('invalid value for "source_id", source_id cannot be nil.')
+      end
+
+      if @value.nil?
+        invalid_properties.push('invalid value for "value", value 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_id.nil?
+      return false if @auditor_display_name.nil?
+      return false if @auditor_handle.nil?
+      return false if @auditor_profile_id.nil?
+      return false if @block_id.nil?
+      return false if @created.nil?
+      return false if @source_id.nil?
+      return false if @value.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] audit_id Value to be assigned
+    def audit_id=(audit_id)
+      if audit_id.nil?
+        fail ArgumentError, 'audit_id cannot be nil'
+      end
+
+      @audit_id = audit_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] auditor_display_name Value to be assigned
+    def auditor_display_name=(auditor_display_name)
+      if auditor_display_name.nil?
+        fail ArgumentError, 'auditor_display_name cannot be nil'
+      end
+
+      @auditor_display_name = auditor_display_name
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] auditor_handle Value to be assigned
+    def auditor_handle=(auditor_handle)
+      if auditor_handle.nil?
+        fail ArgumentError, 'auditor_handle cannot be nil'
+      end
+
+      @auditor_handle = auditor_handle
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] auditor_profile_id Value to be assigned
+    def auditor_profile_id=(auditor_profile_id)
+      if auditor_profile_id.nil?
+        fail ArgumentError, 'auditor_profile_id cannot be nil'
+      end
+
+      @auditor_profile_id = auditor_profile_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] block_id Value to be assigned
+    def block_id=(block_id)
+      if block_id.nil?
+        fail ArgumentError, 'block_id cannot be nil'
+      end
+
+      @block_id = block_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] created Value to be assigned
+    def created=(created)
+      if created.nil?
+        fail ArgumentError, 'created cannot be nil'
+      end
+
+      @created = created
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] source_id Value to be assigned
+    def source_id=(source_id)
+      if source_id.nil?
+        fail ArgumentError, 'source_id cannot be nil'
+      end
+
+      @source_id = source_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] value Value to be assigned
+    def value=(value)
+      if value.nil?
+        fail ArgumentError, 'value cannot be nil'
+      end
+
+      @value = value
+    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_id == o.audit_id &&
+          auditor_display_name == o.auditor_display_name &&
+          auditor_handle == o.auditor_handle &&
+          auditor_profile_id == o.auditor_profile_id &&
+          block_id == o.block_id &&
+          created == o.created &&
+          reason == o.reason &&
+          source_id == o.source_id &&
+          value == o.value
+    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_id, auditor_display_name, auditor_handle, auditor_profile_id, block_id, created, reason, source_id, value].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/claimed_audit_job.rb

@@ -0,0 +1,249 @@
+=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 citation-audit job claimed for fan-out — the auditor twin of [`crate::types::workflow_job::ClaimedJob`], carrying the citation list the job was enqueued with.  One isolated session per entry, exactly as the steward's fan-out works; the difference is that each session iterates `citations` rather than tending one target.
+  class ClaimedAuditJob < ApiModelBase
+    # How many times this job has now been claimed (1 on first dispatch).
+    attr_accessor :attempts
+
+    # The citations this run must weigh — the payload the enqueue carried, read back verbatim.  Every entry is work this principal has NOT already done: the enqueue resolved them through `resource_auditable_citations`, so the session needs no skip logic and is given no opportunity to exercise any. That is the whole point of the grain change — the invariant is held by what the session receives, not by an instruction it is asked to follow.
+    attr_accessor :citations
+
+    # The single cognitive map this claimed run audits within.
+    attr_accessor :cogmap_id
+
+    # The queue row id.
+    attr_accessor :id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'attempts' => :'attempts',
+        :'citations' => :'citations',
+        :'cogmap_id' => :'cogmap_id',
+        :'id' => :'id'
+      }
+    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
+      {
+        :'attempts' => :'Integer',
+        :'citations' => :'Array<AuditCitation>',
+        :'cogmap_id' => :'String',
+        :'id' => :'String'
+      }
+    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::ClaimedAuditJob` 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::ClaimedAuditJob`. 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?(:'attempts')
+        self.attempts = attributes[:'attempts']
+      else
+        self.attempts = nil
+      end
+
+      if attributes.key?(:'citations')
+        if (value = attributes[:'citations']).is_a?(Array)
+          self.citations = value
+        end
+      else
+        self.citations = nil
+      end
+
+      if attributes.key?(:'cogmap_id')
+        self.cogmap_id = attributes[:'cogmap_id']
+      else
+        self.cogmap_id = nil
+      end
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      else
+        self.id = 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 @attempts.nil?
+        invalid_properties.push('invalid value for "attempts", attempts cannot be nil.')
+      end
+
+      if @citations.nil?
+        invalid_properties.push('invalid value for "citations", citations cannot be nil.')
+      end
+
+      if @cogmap_id.nil?
+        invalid_properties.push('invalid value for "cogmap_id", cogmap_id cannot be nil.')
+      end
+
+      if @id.nil?
+        invalid_properties.push('invalid value for "id", id 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 @attempts.nil?
+      return false if @citations.nil?
+      return false if @cogmap_id.nil?
+      return false if @id.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] attempts Value to be assigned
+    def attempts=(attempts)
+      if attempts.nil?
+        fail ArgumentError, 'attempts cannot be nil'
+      end
+
+      @attempts = attempts
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] citations Value to be assigned
+    def citations=(citations)
+      if citations.nil?
+        fail ArgumentError, 'citations cannot be nil'
+      end
+
+      @citations = citations
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] cogmap_id Value to be assigned
+    def cogmap_id=(cogmap_id)
+      if cogmap_id.nil?
+        fail ArgumentError, 'cogmap_id cannot be nil'
+      end
+
+      @cogmap_id = cogmap_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] id Value to be assigned
+    def id=(id)
+      if id.nil?
+        fail ArgumentError, 'id cannot be nil'
+      end
+
+      @id = id
+    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 &&
+          attempts == o.attempts &&
+          citations == o.citations &&
+          cogmap_id == o.cogmap_id &&
+          id == o.id
+    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
+      [attempts, citations, cogmap_id, id].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