htm 0.0.2 → 0.0.10

data/db/migrate/20250101000003_create_nodes.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-class CreateNodes < ActiveRecord::Migration[7.1]
-  def change
-    unless table_exists?(:nodes)
-      create_table :nodes, comment: 'Core memory storage for conversation messages and context' do |t|
-        t.text :content, null: false, comment: 'The conversation message/utterance content'
-        t.text :source, default: '', comment: 'From where the content came (empty string if unknown)'
-        t.integer :access_count, default: 0, null: false, comment: 'Number of times this node has been accessed/retrieved'
-        t.timestamptz :created_at, default: -> { 'CURRENT_TIMESTAMP' }, comment: 'When this memory was created'
-        t.timestamptz :updated_at, default: -> { 'CURRENT_TIMESTAMP' }, comment: 'When this memory was last modified'
-        t.timestamptz :last_accessed, default: -> { 'CURRENT_TIMESTAMP' }, comment: 'When this memory was last accessed'
-        t.integer :token_count, comment: 'Number of tokens in the content (for context budget management)'
-        t.boolean :in_working_memory, default: false, comment: 'Whether this memory is currently in working memory'
-        t.bigint :robot_id, null: false, comment: 'ID of the robot that owns this memory'
-        t.vector :embedding, limit: 2000, comment: 'Vector embedding (max 2000 dimensions) for semantic search'
-        t.integer :embedding_dimension, comment: 'Actual number of dimensions used in the embedding vector (max 2000)'
-      end
-
-      # Basic indexes for common queries
-      add_index :nodes, :created_at, name: 'idx_nodes_created_at'
-      add_index :nodes, :updated_at, name: 'idx_nodes_updated_at'
-      add_index :nodes, :last_accessed, name: 'idx_nodes_last_accessed'
-      add_index :nodes, :access_count, name: 'idx_nodes_access_count'
-      add_index :nodes, :robot_id, name: 'idx_nodes_robot_id'
-      add_index :nodes, :source, name: 'idx_nodes_source'
-      add_index :nodes, :in_working_memory, name: 'idx_nodes_in_working_memory'
-
-      # Add check constraint for embedding dimensions
-      # Only validates when embedding_dimension is provided (allows NULL for nodes without embeddings)
-      execute <<-SQL
-        ALTER TABLE nodes ADD CONSTRAINT check_embedding_dimension
-          CHECK (embedding_dimension IS NULL OR (embedding_dimension > 0 AND embedding_dimension <= 2000))
-      SQL
-    end
-
-    # Foreign key to robots table (outside table_exists check so it gets added even if table already exists)
-    unless foreign_key_exists?(:nodes, :robots, column: :robot_id)
-      add_foreign_key :nodes, :robots, column: :robot_id, primary_key: :id, on_delete: :cascade
-    end
-  end
-end

data/db/migrate/20250101000005_create_tags.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-class CreateTags < ActiveRecord::Migration[7.1]
-  def change
-    # Create tags table with unique tag names
-    unless table_exists?(:tags)
-      create_table :tags, comment: 'Unique tag names for categorization' do |t|
-        t.text :name, null: false, comment: 'Hierarchical tag in format: root:level1:level2 (e.g., database:postgresql:timescaledb)'
-        t.timestamptz :created_at, default: -> { 'CURRENT_TIMESTAMP' }, comment: 'When this tag was created'
-      end
-
-      add_index :tags, :name, unique: true, name: 'idx_tags_name_unique'
-      add_index :tags, :name, using: :btree, opclass: :text_pattern_ops, name: 'idx_tags_name_pattern'
-    end
-
-    # Create join table for many-to-many relationship
-    unless table_exists?(:node_tags)
-      create_table :node_tags, comment: 'Join table connecting nodes to tags (many-to-many)' do |t|
-        t.bigint :node_id, null: false, comment: 'ID of the node being tagged'
-        t.bigint :tag_id, null: false, comment: 'ID of the tag being applied'
-        t.timestamptz :created_at, default: -> { 'CURRENT_TIMESTAMP' }, comment: 'When this association was created'
-      end
-
-      add_index :node_tags, [:node_id, :tag_id], unique: true, name: 'idx_node_tags_unique'
-      add_index :node_tags, :node_id, name: 'idx_node_tags_node_id'
-      add_index :node_tags, :tag_id, name: 'idx_node_tags_tag_id'
-    end
-
-    # Add foreign keys (outside table_exists check so they get added even if table already exists)
-    unless foreign_key_exists?(:node_tags, :nodes, column: :node_id)
-      add_foreign_key :node_tags, :nodes, column: :node_id, primary_key: :id, on_delete: :cascade
-    end
-
-    unless foreign_key_exists?(:node_tags, :tags, column: :tag_id)
-      add_foreign_key :node_tags, :tags, column: :tag_id, primary_key: :id, on_delete: :cascade
-    end
-  end
-end

data/db/migrate/20250101000007_add_node_vector_indexes.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-class AddNodeVectorIndexes < ActiveRecord::Migration[7.1]
-  def up
-    # Vector similarity search index (HNSW for better performance)
-    execute <<-SQL
-      CREATE INDEX IF NOT EXISTS idx_nodes_embedding ON nodes
-        USING hnsw (embedding vector_cosine_ops)
-        WITH (m = 16, ef_construction = 64)
-    SQL
-
-    # Full-text search on conversation content
-    execute <<-SQL
-      CREATE INDEX IF NOT EXISTS idx_nodes_content_gin ON nodes
-        USING gin(to_tsvector('english', content))
-    SQL
-
-    # Trigram indexes for fuzzy matching on conversation content
-    execute <<-SQL
-      CREATE INDEX IF NOT EXISTS idx_nodes_content_trgm ON nodes
-        USING gin(content gin_trgm_ops)
-    SQL
-  end
-
-  def down
-    remove_index :nodes, name: 'idx_nodes_embedding'
-    remove_index :nodes, name: 'idx_nodes_content_gin'
-    remove_index :nodes, name: 'idx_nodes_content_trgm'
-  end
-end

data/db/migrate/20250125000001_add_content_hash_to_nodes.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-class AddContentHashToNodes < ActiveRecord::Migration[7.1]
-  def change
-    unless column_exists?(:nodes, :content_hash)
-      # Add content_hash column for SHA-256 hash of content (64 hex characters)
-      add_column :nodes, :content_hash, :string, limit: 64,
-                 comment: 'SHA-256 hash of content for deduplication'
-
-      # Unique index to prevent duplicate content
-      add_index :nodes, :content_hash, unique: true, name: 'idx_nodes_content_hash_unique'
-    end
-  end
-end

data/db/migrate/20250125000002_create_robot_nodes.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-class CreateRobotNodes < ActiveRecord::Migration[7.1]
-  def change
-    unless table_exists?(:robot_nodes)
-      create_table :robot_nodes, comment: 'Join table connecting robots to nodes (many-to-many)' do |t|
-        t.bigint :robot_id, null: false, comment: 'ID of the robot that remembered this node'
-        t.bigint :node_id, null: false, comment: 'ID of the node being remembered'
-        t.timestamptz :first_remembered_at, default: -> { 'CURRENT_TIMESTAMP' },
-                      comment: 'When this robot first remembered this content'
-        t.timestamptz :last_remembered_at, default: -> { 'CURRENT_TIMESTAMP' },
-                      comment: 'When this robot last tried to remember this content'
-        t.integer :remember_count, default: 1, null: false,
-                  comment: 'Number of times this robot has tried to remember this content'
-        t.timestamptz :created_at, default: -> { 'CURRENT_TIMESTAMP' }
-        t.timestamptz :updated_at, default: -> { 'CURRENT_TIMESTAMP' }
-      end
-
-      # Unique constraint: each robot can only link to a node once
-      add_index :robot_nodes, [:robot_id, :node_id], unique: true, name: 'idx_robot_nodes_unique'
-      add_index :robot_nodes, :robot_id, name: 'idx_robot_nodes_robot_id'
-      add_index :robot_nodes, :node_id, name: 'idx_robot_nodes_node_id'
-      add_index :robot_nodes, :last_remembered_at, name: 'idx_robot_nodes_last_remembered_at'
-    end
-
-    # Add foreign keys
-    unless foreign_key_exists?(:robot_nodes, :robots, column: :robot_id)
-      add_foreign_key :robot_nodes, :robots, column: :robot_id, primary_key: :id, on_delete: :cascade
-    end
-
-    unless foreign_key_exists?(:robot_nodes, :nodes, column: :node_id)
-      add_foreign_key :robot_nodes, :nodes, column: :node_id, primary_key: :id, on_delete: :cascade
-    end
-  end
-end

data/db/migrate/20250125000003_remove_source_and_robot_id_from_nodes.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-class RemoveSourceAndRobotIdFromNodes < ActiveRecord::Migration[7.1]
-  def change
-    # Remove foreign key constraint first
-    if foreign_key_exists?(:nodes, :robots, column: :robot_id)
-      remove_foreign_key :nodes, :robots, column: :robot_id
-    end
-
-    # Remove indexes
-    if index_exists?(:nodes, :robot_id, name: 'idx_nodes_robot_id')
-      remove_index :nodes, name: 'idx_nodes_robot_id'
-    end
-
-    if index_exists?(:nodes, :source, name: 'idx_nodes_source')
-      remove_index :nodes, name: 'idx_nodes_source'
-    end
-
-    # Remove columns
-    if column_exists?(:nodes, :robot_id)
-      remove_column :nodes, :robot_id
-    end
-
-    if column_exists?(:nodes, :source)
-      remove_column :nodes, :source
-    end
-  end
-end

data/db/migrate/20250126000001_create_working_memories.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-class CreateWorkingMemories < ActiveRecord::Migration[7.1]
-  def change
-    create_table :working_memories, comment: 'Per-robot working memory state (optional persistence)' do |t|
-      t.bigint :robot_id, null: false, comment: 'Robot whose working memory this belongs to'
-      t.bigint :node_id, null: false, comment: 'Node currently in working memory'
-      t.timestamptz :added_at, default: -> { 'CURRENT_TIMESTAMP' }, comment: 'When node was added to working memory'
-      t.integer :token_count, comment: 'Cached token count for budget tracking'
-    end
-
-    add_index :working_memories, :robot_id, name: 'idx_working_memories_robot_id'
-    add_index :working_memories, :node_id, name: 'idx_working_memories_node_id'
-    add_index :working_memories, [:robot_id, :node_id], unique: true, name: 'idx_working_memories_unique'
-
-    add_foreign_key :working_memories, :robots, on_delete: :cascade
-    add_foreign_key :working_memories, :nodes, on_delete: :cascade
-  end
-end

data/db/migrate/20250126000002_remove_unused_columns.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-class RemoveUnusedColumns < ActiveRecord::Migration[7.1]
-  def change
-    # Remove in_working_memory from nodes - now tracked per-robot in working_memories table
-    remove_index :nodes, name: 'idx_nodes_in_working_memory', if_exists: true
-    remove_column :nodes, :in_working_memory, :boolean, default: false
-
-    # Remove unused metadata column from robots
-    remove_column :robots, :metadata, :jsonb
-  end
-end

data/docs/database/public.working_memories.md

@@ -1,40 +0,0 @@
-# public.working_memories
-
-## Description
-
-Per-robot working memory state (optional persistence)
-
-## Columns
-
-| Name | Type | Default | Nullable | Children | Parents | Comment |
-| ---- | ---- | ------- | -------- | -------- | ------- | ------- |
-| id | bigint | nextval('working_memories_id_seq'::regclass) | false |  |  |  |
-| robot_id | bigint |  | false |  | [public.robots](public.robots.md) | Robot whose working memory this belongs to |
-| node_id | bigint |  | false |  | [public.nodes](public.nodes.md) | Node currently in working memory |
-| added_at | timestamp with time zone | CURRENT_TIMESTAMP | true |  |  | When node was added to working memory |
-| token_count | integer |  | true |  |  | Cached token count for budget tracking |
-
-## Constraints
-
-| Name | Type | Definition |
-| ---- | ---- | ---------- |
-| fk_rails_4b7c3eb07b | FOREIGN KEY | FOREIGN KEY (robot_id) REFERENCES robots(id) ON DELETE CASCADE |
-| fk_rails_2c1d8b383c | FOREIGN KEY | FOREIGN KEY (node_id) REFERENCES nodes(id) ON DELETE CASCADE |
-| working_memories_pkey | PRIMARY KEY | PRIMARY KEY (id) |
-
-## Indexes
-
-| Name | Definition |
-| ---- | ---------- |
-| working_memories_pkey | CREATE UNIQUE INDEX working_memories_pkey ON public.working_memories USING btree (id) |
-| idx_working_memories_robot_id | CREATE INDEX idx_working_memories_robot_id ON public.working_memories USING btree (robot_id) |
-| idx_working_memories_node_id | CREATE INDEX idx_working_memories_node_id ON public.working_memories USING btree (node_id) |
-| idx_working_memories_unique | CREATE UNIQUE INDEX idx_working_memories_unique ON public.working_memories USING btree (robot_id, node_id) |
-
-## Relations
-
-![er](public.working_memories.svg)
-
----
-
-> Generated by [tbls](https://github.com/k1LoW/tbls)

data/docs/database/public.working_memories.svg

@@ -1,112 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
- "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<!-- Generated by graphviz version 12.1.2 (20240928.0832)
- -->
-<!-- Title: public.working_memories Pages: 1 -->
-<svg width="1046pt" height="756pt"
- viewBox="0.00 0.00 1046.14 756.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 752)">
-<title>public.working_memories</title>
-<polygon fill="white" stroke="none" points="-4,4 -4,-752 1042.14,-752 1042.14,4 -4,4"/>
-<!-- public.working_memories -->
-<g id="node1" class="node">
-<title>public.working_memories</title>
-<polygon fill="#efefef" stroke="none" points="355.64,-666.2 355.64,-701.8 683.59,-701.8 683.59,-666.2 355.64,-666.2"/>
-<polygon fill="none" stroke="black" points="355.64,-666.2 355.64,-701.8 683.59,-701.8 683.59,-666.2 355.64,-666.2"/>
-<text text-anchor="start" x="362.64" y="-679.6" font-family="Arial Bold" font-size="18.00">public.working_memories</text>
-<text text-anchor="start" x="552.11" y="-679.6" font-family="Arial" font-size="14.00">    </text>
-<text text-anchor="start" x="583.22" y="-679.6" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
-<polygon fill="none" stroke="black" points="355.64,-635.4 355.64,-666.2 683.59,-666.2 683.59,-635.4 355.64,-635.4"/>
-<text text-anchor="start" x="362.64" y="-647.6" font-family="Arial" font-size="14.00">id </text>
-<text text-anchor="start" x="377.43" y="-647.6" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
-<polygon fill="none" stroke="black" points="355.64,-604.6 355.64,-635.4 683.59,-635.4 683.59,-604.6 355.64,-604.6"/>
-<text text-anchor="start" x="362.64" y="-616.8" font-family="Arial" font-size="14.00">robot_id </text>
-<text text-anchor="start" x="417.12" y="-616.8" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
-<polygon fill="none" stroke="black" points="355.64,-573.8 355.64,-604.6 683.59,-604.6 683.59,-573.8 355.64,-573.8"/>
-<text text-anchor="start" x="362.64" y="-586" font-family="Arial" font-size="14.00">node_id </text>
-<text text-anchor="start" x="416.36" y="-586" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
-<polygon fill="none" stroke="black" points="355.64,-543 355.64,-573.8 683.59,-573.8 683.59,-543 355.64,-543"/>
-<text text-anchor="start" x="362.64" y="-555.2" font-family="Arial" font-size="14.00">added_at </text>
-<text text-anchor="start" x="424.92" y="-555.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-<polygon fill="none" stroke="black" points="355.64,-512.2 355.64,-543 683.59,-543 683.59,-512.2 355.64,-512.2"/>
-<text text-anchor="start" x="362.64" y="-524.4" font-family="Arial" font-size="14.00">token_count </text>
-<text text-anchor="start" x="442.81" y="-524.4" font-family="Arial" font-size="14.00" fill="#666666">[integer]</text>
-<polygon fill="none" stroke="black" stroke-width="3" points="354.14,-510.7 354.14,-703.3 685.09,-703.3 685.09,-510.7 354.14,-510.7"/>
-</g>
-<!-- public.robots -->
-<g id="node2" class="node">
-<title>public.robots</title>
-<polygon fill="#efefef" stroke="none" points="212.73,-258.8 212.73,-294.4 462.5,-294.4 462.5,-258.8 212.73,-258.8"/>
-<polygon fill="none" stroke="black" points="212.73,-258.8 212.73,-294.4 462.5,-294.4 462.5,-258.8 212.73,-258.8"/>
-<text text-anchor="start" x="228.13" y="-272.2" font-family="Arial Bold" font-size="18.00">public.robots</text>
-<text text-anchor="start" x="322.62" y="-272.2" font-family="Arial" font-size="14.00">    </text>
-<text text-anchor="start" x="353.74" y="-272.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
-<polygon fill="none" stroke="black" points="212.73,-228 212.73,-258.8 462.5,-258.8 462.5,-228 212.73,-228"/>
-<text text-anchor="start" x="219.73" y="-240.2" font-family="Arial" font-size="14.00">id </text>
-<text text-anchor="start" x="234.52" y="-240.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
-<polygon fill="none" stroke="black" points="212.73,-197.2 212.73,-228 462.5,-228 462.5,-197.2 212.73,-197.2"/>
-<text text-anchor="start" x="219.73" y="-209.4" font-family="Arial" font-size="14.00">name </text>
-<text text-anchor="start" x="258.64" y="-209.4" font-family="Arial" font-size="14.00" fill="#666666">[text]</text>
-<polygon fill="none" stroke="black" points="212.73,-166.4 212.73,-197.2 462.5,-197.2 462.5,-166.4 212.73,-166.4"/>
-<text text-anchor="start" x="219.73" y="-178.6" font-family="Arial" font-size="14.00">created_at </text>
-<text text-anchor="start" x="289.78" y="-178.6" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-<polygon fill="none" stroke="black" points="212.73,-135.6 212.73,-166.4 462.5,-166.4 462.5,-135.6 212.73,-135.6"/>
-<text text-anchor="start" x="219.73" y="-147.8" font-family="Arial" font-size="14.00">last_active </text>
-<text text-anchor="start" x="289.77" y="-147.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-</g>
-<!-- public.working_memories&#45;&gt;public.robots -->
-<g id="edge1" class="edge">
-<title>public.working_memories:robot_id&#45;&gt;public.robots:id</title>
-<path fill="none" stroke="black" d="M344.41,-619.21C291.15,-610.26 333.43,-526.77 355.64,-466 381.12,-396.26 436.88,-407.28 462.5,-337.6 476.95,-298.3 505.37,-243.4 463.5,-243.4"/>
-<polygon fill="black" stroke="black" points="344.34,-619.21 353.96,-624.46 349.65,-619.62 353.97,-619.95 353.97,-619.95 353.97,-619.95 349.65,-619.62 354.65,-615.49 344.34,-619.21"/>
-<text text-anchor="start" x="7" y="-630" font-family="Arial" font-size="10.00">FOREIGN KEY (robot_id) REFERENCES robots(id) ON DELETE CASCADE</text>
-</g>
-<!-- public.nodes -->
-<g id="node3" class="node">
-<title>public.nodes</title>
-<polygon fill="#efefef" stroke="none" points="566.45,-351.2 566.45,-386.8 838.78,-386.8 838.78,-351.2 566.45,-351.2"/>
-<polygon fill="none" stroke="black" points="566.45,-351.2 566.45,-386.8 838.78,-386.8 838.78,-351.2 566.45,-351.2"/>
-<text text-anchor="start" x="594.63" y="-364.6" font-family="Arial Bold" font-size="18.00">public.nodes</text>
-<text text-anchor="start" x="686.12" y="-364.6" font-family="Arial" font-size="14.00">    </text>
-<text text-anchor="start" x="717.23" y="-364.6" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
-<polygon fill="none" stroke="black" points="566.45,-320.4 566.45,-351.2 838.78,-351.2 838.78,-320.4 566.45,-320.4"/>
-<text text-anchor="start" x="573.45" y="-332.6" font-family="Arial" font-size="14.00">id </text>
-<text text-anchor="start" x="588.24" y="-332.6" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
-<polygon fill="none" stroke="black" points="566.45,-289.6 566.45,-320.4 838.78,-320.4 838.78,-289.6 566.45,-289.6"/>
-<text text-anchor="start" x="573.45" y="-301.8" font-family="Arial" font-size="14.00">content </text>
-<text text-anchor="start" x="623.27" y="-301.8" font-family="Arial" font-size="14.00" fill="#666666">[text]</text>
-<polygon fill="none" stroke="black" points="566.45,-258.8 566.45,-289.6 838.78,-289.6 838.78,-258.8 566.45,-258.8"/>
-<text text-anchor="start" x="573.45" y="-271" font-family="Arial" font-size="14.00">access_count </text>
-<text text-anchor="start" x="662.95" y="-271" font-family="Arial" font-size="14.00" fill="#666666">[integer]</text>
-<polygon fill="none" stroke="black" points="566.45,-228 566.45,-258.8 838.78,-258.8 838.78,-228 566.45,-228"/>
-<text text-anchor="start" x="573.45" y="-240.2" font-family="Arial" font-size="14.00">created_at </text>
-<text text-anchor="start" x="643.5" y="-240.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-<polygon fill="none" stroke="black" points="566.45,-197.2 566.45,-228 838.78,-228 838.78,-197.2 566.45,-197.2"/>
-<text text-anchor="start" x="573.45" y="-209.4" font-family="Arial" font-size="14.00">updated_at </text>
-<text text-anchor="start" x="647.41" y="-209.4" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-<polygon fill="none" stroke="black" points="566.45,-166.4 566.45,-197.2 838.78,-197.2 838.78,-166.4 566.45,-166.4"/>
-<text text-anchor="start" x="573.45" y="-178.6" font-family="Arial" font-size="14.00">last_accessed </text>
-<text text-anchor="start" x="666.06" y="-178.6" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-<polygon fill="none" stroke="black" points="566.45,-135.6 566.45,-166.4 838.78,-166.4 838.78,-135.6 566.45,-135.6"/>
-<text text-anchor="start" x="573.45" y="-147.8" font-family="Arial" font-size="14.00">token_count </text>
-<text text-anchor="start" x="653.62" y="-147.8" font-family="Arial" font-size="14.00" fill="#666666">[integer]</text>
-<polygon fill="none" stroke="black" points="566.45,-104.8 566.45,-135.6 838.78,-135.6 838.78,-104.8 566.45,-104.8"/>
-<text text-anchor="start" x="573.45" y="-117" font-family="Arial" font-size="14.00">embedding </text>
-<text text-anchor="start" x="646.62" y="-117" font-family="Arial" font-size="14.00" fill="#666666">[vector(2000)]</text>
-<polygon fill="none" stroke="black" points="566.45,-74 566.45,-104.8 838.78,-104.8 838.78,-74 566.45,-74"/>
-<text text-anchor="start" x="573.45" y="-86.2" font-family="Arial" font-size="14.00">embedding_dimension </text>
-<text text-anchor="start" x="718.22" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[integer]</text>
-<polygon fill="none" stroke="black" points="566.45,-43.2 566.45,-74 838.78,-74 838.78,-43.2 566.45,-43.2"/>
-<text text-anchor="start" x="573.45" y="-55.4" font-family="Arial" font-size="14.00">content_hash </text>
-<text text-anchor="start" x="661.41" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[varchar(64)]</text>
-</g>
-<!-- public.working_memories&#45;&gt;public.nodes -->
-<g id="edge2" class="edge">
-<title>public.working_memories:node_id&#45;&gt;public.nodes:id</title>
-<path fill="none" stroke="black" d="M694.76,-588.13C736.16,-578.52 714.08,-506.91 683.59,-466 651.05,-422.32 599.05,-473.63 566.45,-430 541.39,-396.46 523.58,-335.8 565.45,-335.8"/>
-<polygon fill="black" stroke="black" points="694.87,-588.11 684.45,-584.69 689.57,-588.67 685.26,-589.13 685.26,-589.13 685.26,-589.13 689.57,-588.67 685.4,-593.64 694.87,-588.11"/>
-<text text-anchor="start" x="691.59" y="-599.2" font-family="Arial" font-size="10.00">FOREIGN KEY (node_id) REFERENCES nodes(id) ON DELETE CASCADE</text>
-</g>
-</g>
-</svg>

data/lib/htm/models/working_memory_entry.rb

@@ -1,88 +0,0 @@
-# frozen_string_literal: true
-
-class HTM
-  module Models
-    # WorkingMemoryEntry - Tracks which nodes are in each robot's working memory
-    #
-    # This provides optional database persistence for working memory state.
-    # Useful for:
-    # - Restoring working memory after process restart
-    # - Querying what nodes robots are actively working with
-    # - Debugging/monitoring working memory across robots
-    #
-    # Note: The in-memory WorkingMemory class remains the primary interface.
-    # This table is for persistence/observability, not required for operation.
-    #
-    class WorkingMemoryEntry < ActiveRecord::Base
-      self.table_name = 'working_memories'
-
-      belongs_to :robot, class_name: 'HTM::Models::Robot'
-      belongs_to :node, class_name: 'HTM::Models::Node'
-
-      validates :robot_id, presence: true
-      validates :node_id, presence: true
-      validates :robot_id, uniqueness: { scope: :node_id, message: 'already has this node in working memory' }
-
-      # Scopes
-      scope :by_robot, ->(robot_id) { where(robot_id: robot_id) }
-      scope :recent, -> { order(added_at: :desc) }
-
-      # Class methods
-
-      # Sync working memory state from in-memory hash to database
-      #
-      # @param robot_id [Integer] Robot ID
-      # @param node_entries [Hash] Hash of node_id => { token_count:, ... }
-      #
-      def self.sync_from_memory(robot_id, node_entries)
-        transaction do
-          # Clear existing entries for this robot
-          where(robot_id: robot_id).delete_all
-
-          # Insert current entries
-          node_entries.each do |node_id, data|
-            create!(
-              robot_id: robot_id,
-              node_id: node_id,
-              token_count: data[:token_count],
-              added_at: data[:added_at] || Time.current
-            )
-          end
-        end
-      end
-
-      # Load working memory state from database
-      #
-      # @param robot_id [Integer] Robot ID
-      # @return [Hash] Hash suitable for WorkingMemory restoration
-      #
-      def self.load_for_robot(robot_id)
-        by_robot(robot_id).includes(:node).each_with_object({}) do |entry, hash|
-          hash[entry.node_id] = {
-            content: entry.node.content,
-            token_count: entry.token_count,
-            added_at: entry.added_at,
-            access_count: entry.node.access_count
-          }
-        end
-      end
-
-      # Clear working memory for a robot
-      #
-      # @param robot_id [Integer] Robot ID
-      #
-      def self.clear_for_robot(robot_id)
-        where(robot_id: robot_id).delete_all
-      end
-
-      # Get total token count for a robot's working memory
-      #
-      # @param robot_id [Integer] Robot ID
-      # @return [Integer] Total tokens
-      #
-      def self.total_tokens_for_robot(robot_id)
-        where(robot_id: robot_id).sum(:token_count)
-      end
-    end
-  end
-end