temper-rb 0.5.1

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

@@ -0,0 +1,341 @@
+=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 row of the `cogmap list` surface — a cognitive map's identity + orientation, as returned by the `cogmap_list_rows` SQL function (`migrations/20260724000010_cogmap_list_rows.sql`) field-for-field, so the service read can `query_as!` straight into it.  This is the charter-bearing sibling of the Atlas's `HomeCogmap` view: same visible-maps base (`cogmap_visible_maps`), plus `telos_resource_id` and the charter `statement` so a caller can orient — *what is this map for* — from the list itself, without a second round-trip. The decorated `ref` (`sluggify(name)-<uuid>`) is injected render-time by the CLI (never persisted, never on this wire type), exactly as context rows carry one.
+  class CogmapRow < ApiModelBase
+    # The charter's statement-of-purpose (block-0 of the telos). `None` when the charter has no authored statement yet (e.g. an MCP genesis that minted an empty charter).
+    attr_accessor :charter_statement
+
+    # The cognitive map's id.
+    attr_accessor :id
+
+    # The map's name.
+    attr_accessor :name
+
+    # Held-by scope: the already-sigil'd owner (`+<team-slug>` for a team-held map, or the universal `temper` marker for a public/system kernel that joins no member team).
+    attr_accessor :owner_ref
+
+    # Count of the map's live (non-folded) materialized regions.
+    attr_accessor :region_count
+
+    # Count of resources homed in the map (`anchor_table = 'kb_cogmaps'`).
+    attr_accessor :resource_count
+
+    # The member teams (self-or-ancestor) the map is joined to — the teams that make it visible.
+    attr_accessor :team_ids
+
+    # The telos/charter resource id.
+    attr_accessor :telos_resource_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'charter_statement' => :'charter_statement',
+        :'id' => :'id',
+        :'name' => :'name',
+        :'owner_ref' => :'owner_ref',
+        :'region_count' => :'region_count',
+        :'resource_count' => :'resource_count',
+        :'team_ids' => :'team_ids',
+        :'telos_resource_id' => :'telos_resource_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
+      {
+        :'charter_statement' => :'String',
+        :'id' => :'String',
+        :'name' => :'String',
+        :'owner_ref' => :'String',
+        :'region_count' => :'Integer',
+        :'resource_count' => :'Integer',
+        :'team_ids' => :'Array<String>',
+        :'telos_resource_id' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'charter_statement',
+      ])
+    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::CogmapRow` 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::CogmapRow`. 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?(:'charter_statement')
+        self.charter_statement = attributes[:'charter_statement']
+      end
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      else
+        self.id = nil
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      else
+        self.name = nil
+      end
+
+      if attributes.key?(:'owner_ref')
+        self.owner_ref = attributes[:'owner_ref']
+      else
+        self.owner_ref = nil
+      end
+
+      if attributes.key?(:'region_count')
+        self.region_count = attributes[:'region_count']
+      else
+        self.region_count = nil
+      end
+
+      if attributes.key?(:'resource_count')
+        self.resource_count = attributes[:'resource_count']
+      else
+        self.resource_count = nil
+      end
+
+      if attributes.key?(:'team_ids')
+        if (value = attributes[:'team_ids']).is_a?(Array)
+          self.team_ids = value
+        end
+      else
+        self.team_ids = nil
+      end
+
+      if attributes.key?(:'telos_resource_id')
+        self.telos_resource_id = attributes[:'telos_resource_id']
+      else
+        self.telos_resource_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 @id.nil?
+        invalid_properties.push('invalid value for "id", id cannot be nil.')
+      end
+
+      if @name.nil?
+        invalid_properties.push('invalid value for "name", name cannot be nil.')
+      end
+
+      if @owner_ref.nil?
+        invalid_properties.push('invalid value for "owner_ref", owner_ref cannot be nil.')
+      end
+
+      if @region_count.nil?
+        invalid_properties.push('invalid value for "region_count", region_count cannot be nil.')
+      end
+
+      if @resource_count.nil?
+        invalid_properties.push('invalid value for "resource_count", resource_count cannot be nil.')
+      end
+
+      if @team_ids.nil?
+        invalid_properties.push('invalid value for "team_ids", team_ids cannot be nil.')
+      end
+
+      if @telos_resource_id.nil?
+        invalid_properties.push('invalid value for "telos_resource_id", telos_resource_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 @id.nil?
+      return false if @name.nil?
+      return false if @owner_ref.nil?
+      return false if @region_count.nil?
+      return false if @resource_count.nil?
+      return false if @team_ids.nil?
+      return false if @telos_resource_id.nil?
+      true
+    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
+
+    # Custom attribute writer method with validation
+    # @param [Object] name Value to be assigned
+    def name=(name)
+      if name.nil?
+        fail ArgumentError, 'name cannot be nil'
+      end
+
+      @name = name
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] owner_ref Value to be assigned
+    def owner_ref=(owner_ref)
+      if owner_ref.nil?
+        fail ArgumentError, 'owner_ref cannot be nil'
+      end
+
+      @owner_ref = owner_ref
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] region_count Value to be assigned
+    def region_count=(region_count)
+      if region_count.nil?
+        fail ArgumentError, 'region_count cannot be nil'
+      end
+
+      @region_count = region_count
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] resource_count Value to be assigned
+    def resource_count=(resource_count)
+      if resource_count.nil?
+        fail ArgumentError, 'resource_count cannot be nil'
+      end
+
+      @resource_count = resource_count
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] team_ids Value to be assigned
+    def team_ids=(team_ids)
+      if team_ids.nil?
+        fail ArgumentError, 'team_ids cannot be nil'
+      end
+
+      @team_ids = team_ids
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] telos_resource_id Value to be assigned
+    def telos_resource_id=(telos_resource_id)
+      if telos_resource_id.nil?
+        fail ArgumentError, 'telos_resource_id cannot be nil'
+      end
+
+      @telos_resource_id = telos_resource_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 &&
+          charter_statement == o.charter_statement &&
+          id == o.id &&
+          name == o.name &&
+          owner_ref == o.owner_ref &&
+          region_count == o.region_count &&
+          resource_count == o.resource_count &&
+          team_ids == o.team_ids &&
+          telos_resource_id == o.telos_resource_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
+      [charter_statement, id, name, owner_ref, region_count, resource_count, team_ids, telos_resource_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

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

@@ -0,0 +1,185 @@
+=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
+  # Anchor-level staleness readout: when the shape was last materialized, the latest touch to the anchor's regions/edges **that the reading principal may see**, and whether the read is stale. Staleness is LEGIBLE — reported, never blocking. `materialized_at` is `None` when the anchor has never been materialized.  Carried by BOTH anchor kinds: nested inside [`CogmapAnalyticsRow`] for a cognitive map (`cogmap_staleness`) and returned bare by `GET /api/contexts/{id}/analytics` for a context (`context_analytics`), which has nothing to put in that row's other two fields. Both are thin wrappers over the one gated core, `anchor_staleness`, so the three values mean the same thing on either anchor. The `Cogmap` in the name is historical — the same \"shared on purpose, the `cogmap_*` naming is what M3 retires, not the shape\" convention `CogmapRegionMetricsRow` already rides on for the context region-metrics route.  The touch is **gated** as of migration `20260825000020`: a region holding no member this principal can read does not move this clock, and neither does an edge with an unreadable endpoint. Folded regions and edges are still counted deliberately — a fold advances `last_event_id` and IS a touch, so narrowing either arm to live rows would make a stale anchor read fresh.
+  class CogmapStaleness < ApiModelBase
+    attr_accessor :is_stale
+
+    attr_accessor :latest_touch
+
+    attr_accessor :materialized_at
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'is_stale' => :'is_stale',
+        :'latest_touch' => :'latest_touch',
+        :'materialized_at' => :'materialized_at'
+      }
+    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
+      {
+        :'is_stale' => :'Boolean',
+        :'latest_touch' => :'Time',
+        :'materialized_at' => :'Time'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'latest_touch',
+        :'materialized_at'
+      ])
+    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::CogmapStaleness` 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::CogmapStaleness`. 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?(:'is_stale')
+        self.is_stale = attributes[:'is_stale']
+      else
+        self.is_stale = nil
+      end
+
+      if attributes.key?(:'latest_touch')
+        self.latest_touch = attributes[:'latest_touch']
+      end
+
+      if attributes.key?(:'materialized_at')
+        self.materialized_at = attributes[:'materialized_at']
+      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 @is_stale.nil?
+        invalid_properties.push('invalid value for "is_stale", is_stale 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 @is_stale.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] is_stale Value to be assigned
+    def is_stale=(is_stale)
+      if is_stale.nil?
+        fail ArgumentError, 'is_stale cannot be nil'
+      end
+
+      @is_stale = is_stale
+    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 &&
+          is_stale == o.is_stale &&
+          latest_touch == o.latest_touch &&
+          materialized_at == o.materialized_at
+    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
+      [is_stale, latest_touch, materialized_at].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