terret-store-sqlite 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: deca4043ba1082b662376023c97027ae2f4f2a917c45cdc9561b7ab6cd68eb9c
+  data.tar.gz: f9e3b51ee478574126bf02e7e1338a64fd7eeeabf5fdf7c7fbe8aba363ccbf03
+SHA512:
+  metadata.gz: b8a023c93e4c19877279820949f8f7e0f75ecc62a58347bf77300c4a503af8e08ae51838034ebcd6beaec72c6c30980b3b8ed9cc63eb6e2233d354773cb9b52a
+  data.tar.gz: 87910a8fa2db133ea0a25d7e2c864303cea11a694649a0ea041c2d5a5a891e2c26bfd8c046d5f366693a8ce1aba53fb59b233da08a43c6e07f22f6b9dcda1973

data/lib/terret/store/sqlite.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+begin
+  require "terret"
+rescue LoadError
+  require_relative "../../../../terret-core/lib/terret" # monorepo path source
+end
+require "sqlite3"
+require "json"
+require "time"
+require "fileutils"
+
+module Terret
+  module Store
+    # SQLite provider: the durable default for long-lived processes. WAL for
+    # concurrent readers, busy_timeout instead of hand-rolled retries, one
+    # row per event keyed (session_id, seq). Appends are synchronous; the
+    # per-session writer task from plan §8 is deferred until many-agent
+    # load exists.
+    class SQLite < Hames::Service
+      service_key :session_store
+      config_schema path: { type: String, required: true,
+                            doc: "SQLite database file for the append-only session log" }
+
+      SCHEMA = <<~SQL
+        CREATE TABLE IF NOT EXISTS events (
+          session_id TEXT NOT NULL,
+          seq        INTEGER NOT NULL,
+          id         TEXT NOT NULL,
+          at         TEXT NOT NULL,
+          type       TEXT NOT NULL,
+          payload    TEXT NOT NULL,
+          PRIMARY KEY (session_id, seq)
+        )
+      SQL
+
+      def start(_ctx)
+        @db ||= begin
+          path = config.fetch(:path)
+          FileUtils.mkdir_p(File.dirname(path))
+          db = SQLite3::Database.new(path)
+          db.busy_timeout = 5_000
+          db.execute("PRAGMA journal_mode=WAL")
+          db.execute(SCHEMA)
+          db
+        end
+      end
+
+      def stop(_ctx)
+        @db&.close
+        @db = nil
+      end
+
+      def append(event)
+        @db.execute(
+          "INSERT INTO events (session_id, seq, id, at, type, payload) VALUES (?, ?, ?, ?, ?, ?)",
+          [event.session_id, event.seq, event.id, event.at.iso8601(6),
+           event.type, JSON.generate(event.payload)]
+        )
+      end
+
+      def read(session_id, from_seq: 0)
+        rows = @db.execute(
+          "SELECT id, seq, at, type, payload FROM events WHERE session_id = ? AND seq >= ? ORDER BY seq",
+          [session_id, from_seq]
+        )
+        rows.map do |id, seq, at, type, payload|
+          SessionEvent.new(id:, session_id:, seq:, at: Time.iso8601(at), type: type,
+                           payload: JSON.parse(payload, symbolize_names: true))
+        end
+      end
+
+      def session_ids
+        @db.execute("SELECT DISTINCT session_id FROM events ORDER BY session_id").flatten
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: terret-store-sqlite
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Obie Fernandez
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: terret-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+description: 'Durable session persistence for Terret: the append-only session log
+  stored one event per row in SQLite (WAL mode), behind the ctx[:session_store] seam,
+  so sessions survive process restarts with byte-identical derived context.'
+email:
+- obiefernandez@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/terret/store/sqlite.rb
+homepage: https://terret.org
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://terret.org
+  source_code_uri: https://github.com/terret-org/terret
+  bug_tracker_uri: https://github.com/terret-org/terret/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: SQLite session store for the Terret agent harness
+test_files: []