ruby_llm-registry 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b8cc22de69b90a698ba2fe765043e40881411bdef7d689fc38c3f4571a337a80
+  data.tar.gz: 461d0a268c6cf3970f3ba03e120085ec6620ae46c390ff0ba9648961cf3ae01b
+SHA512:
+  metadata.gz: a9d1f5d97587744bf9090e7ba493cdbbb53842690a3faef1879acc6b99105c95f2a8937829e3b5c7f64ae60a8ac13c1ec823f1461bf7db3783cdad7bdfa53295
+  data.tar.gz: e6f9d1b75b75eb40e08b1534aaceec12e9d34b72f9a50b88a1b9fcdfd011d9059900592dbb2f1f367e11d3aec9dd7e0e74eb3893d7b830411d697afc5e170004

data/.idea/.gitignore

@@ -0,0 +1,5 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/

data/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,5 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+  </profile>
+</component>

data/.idea/jsLibraryMappings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JavaScriptLibraryMappings">
+    <includedPredefinedLibrary name="Node.js Core" />
+  </component>
+</project>

data/.idea/misc.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JavaScriptSettings">
+    <option name="languageLevel" value="ES6" />
+  </component>
+  <component name="JsFlowSettings">
+    <service-enabled>true</service-enabled>
+    <exe-path />
+    <annotation-enable>false</annotation-enable>
+    <other-services-enabled>true</other-services-enabled>
+    <auto-save>true</auto-save>
+  </component>
+  <component name="ProjectDictionaryState">
+    <dictionary name="washu" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="rbenv: 2.4.2" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/ruby_llm-registry.iml" filepath="$PROJECT_DIR$/.idea/ruby_llm-registry.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/ruby_llm-registry.iml

@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="rbenv: 3.4.9" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="activemodel (v8.1.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="activerecord (v8.1.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="activesupport (v8.1.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="aws-eventstream (v1.4.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="aws-partitions (v1.1257.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="aws-sdk-core (v3.251.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="aws-sdk-kms (v1.129.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="aws-sdk-s3 (v1.225.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="aws-sigv4 (v1.12.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="base64 (v0.3.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bigdecimal (v4.1.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bson (v5.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.6.9, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="concurrent-ruby (v1.3.6, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="connection_pool (v3.0.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="date (v3.5.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="diff-lcs (v1.6.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="docile (v1.4.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="drb (v2.2.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="erb (v6.0.4, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="i18n (v1.14.8, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="io-console (v0.8.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="irb (v1.18.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="jmespath (v1.6.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json (v2.19.8, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="language_server-protocol (v3.17.0.5, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="lint_roller (v1.1.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="logger (v1.7.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v6.0.6, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="mongo (v2.24.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v2.1.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parser (v3.3.11.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="pp (v0.6.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prettyprint (v0.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prism (v1.9.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="psych (v5.4.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="racc (v1.8.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.4.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rdoc (v7.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="regexp_parser (v2.12.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="reline (v0.6.3, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="rexml (v3.4.4, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="rspec (v3.13.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-core (v3.13.6, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-expectations (v3.13.5, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-mocks (v3.13.8, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-support (v3.13.7, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop (v1.87.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-ast (v1.49.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.13.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="securerandom (v0.4.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="simplecov (v0.22.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="simplecov-html (v0.13.2, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="simplecov_json_formatter (v0.1.4, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="TEST" name="sqlite3 (v2.9.4, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="stringio (v3.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="timeout (v0.6.1, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tsort (v0.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tzinfo (v2.0.6, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v3.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-emoji (v4.2.0, rbenv: 3.4.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="uri (v1.1.1, rbenv: 3.4.9) [gem]" level="application" />
+  </component>
+</module>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,65 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.3
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+
+Layout/LineLength:
+  Enabled: false
+
+Layout/TrailingEmptyLines:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Lint/ConstantDefinitionInBlock:
+  Enabled: false
+
+Lint/MissingSuper:
+  Enabled: false
+
+Lint/UselessAssignment:
+  Enabled: false
+
+Lint/UnusedBlockArgument:
+  Enabled: false
+
+Style/ArgumentsForwarding:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/SafeNavigation:
+  Enabled: false
+
+Style/StringLiteralsInInterpolation:
+  Enabled: false
+

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-06-05
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Sal Scotto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+# RubyLlm::Registry
+
+[![CI](https://github.com/washu/ruby_llm-registry/actions/workflows/ci.yml/badge.svg)](https://github.com/washu/ruby_llm-registry/actions/workflows/ci.yml)
+
+Local-first, versioned prompt storage and rendering for RubyLLM applications.
+
+## What it does
+
+`RubyLlm::Registry` treats prompts as immutable artifacts stored outside your app code. It can:
+
+- load the latest or a specific semantic version
+- resolve labels like `production` or `staging`
+- read prompt files from a filesystem-backed registry
+- render ERB templates with required-variable validation
+- export/import prompts as YAML, JSON, or markdown
+- compare prompt revisions and surface a field/body diff
+- optionally store prompts in SQLite, ActiveRecord, MongoDB, or S3 backends when those gems/services are loaded
+
+## Quick start
+
+```ruby
+prompt = RubyLlm::Registry.get("email/summarizer", label: :production)
+
+rendered = prompt.render(
+  user_name: "Ava",
+  email_body: "Thanks for the update",
+  summary_length: "concise"
+)
+
+diff = RubyLlm::Registry.diff(prompt, prompt.export(format: :markdown))
+puts diff.changed_fields
+```
+
+## Optional adapters
+
+The gem stays filesystem-first by default. If you need a different store, opt in explicitly:
+
+```ruby
+sqlite = RubyLlm::Registry.database_backend(:sqlite, path: "tmp/prompts.db")
+
+# or, when those integrations are available in your app:
+# RubyLlm::Registry.database_backend(:active_record)
+# RubyLlm::Registry.database_backend(:mongo, collection: MyCollection)
+# RubyLlm::Registry.backend(:s3, client: s3_client, bucket: "my-bucket")
+```
+
+All non-filesystem adapters are loaded lazily, so your app only pulls in the storage stack it actually uses.
+
+## Prompt file layout
+
+```text
+prompts/
+└── email/
+	└── summarizer/
+		├── v1.0.0.md
+		├── v1.1.0.md
+		└── v1.2.3.md
+```
+
+Each file may include YAML front matter:
+
+```markdown
+---
+version: 1.2.3
+labels: [production]
+required_vars: [user_name, email_body]
+metadata:
+  description: Concise email thread summarizer
+---
+
+Hello <%= user_name %>
+```
+
+## Development
+
+Run the test suite with:
+
+```bash
+bundle exec rspec
+```
+
+SimpleCov enforces a 90% minimum coverage threshold, and the latest verified local run is 93%.
+
+The integration specs exercise real fixtures plus optional Docker-backed services:
+
+- SQLite and ActiveRecord use local temp databases
+- MongoDB spins up a `mongo:8` container when Docker is available
+- S3 uses a `minio/minio` container for compatibility testing
+
+If Docker is unavailable, those examples skip cleanly.
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/build_release.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+set -e
+
+# Extract version from version.rb
+VERSION=$(ruby -r ./lib/ruby_llm/registry/version.rb -e "puts RubyLLM::Registry::VERSION")
+
+echo "Building gem version ${VERSION}..."
+gem build ruby_llm-registry.gemspec
+
+echo "Pushing to RubyGems..."
+gem push ruby_llm-registry-${VERSION}.gem
+
+echo "Done!"

data/lib/ruby_llm/registry/adapters/active_record.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+require "json"
+
+module RubyLLM
+  module Registry
+    module Adapters
+      # ActiveRecord-backed prompt repository.
+      class ActiveRecord < Base
+        def initialize(model: nil, table_name: "ruby_llm_registry_prompts")
+          require_active_record!
+          @model = model || build_model(table_name)
+          ensure_schema!
+        end
+
+        def get(path, version: nil, label: nil)
+          scope = model.where(path: path)
+          raise PromptNotFoundError, "Prompt path not found: #{path}" if scope.none?
+
+          record = if version
+                     scope.find_by(version: Version.parse(version).to_s)
+                   elsif label
+                     label = label.to_sym
+                     scope.to_a.find { |row| labels_for(row).include?(label) } || scope.find_by(version: label.to_s)
+                   else
+                     scope.to_a.max_by { |row| Version.parse(row.version) }
+                   end
+
+          raise PromptNotFoundError, "Prompt not found: #{path}" unless record
+
+          prompt_from_record(record)
+        end
+
+        def available_versions(path)
+          model.where(path: path).map { |row| Version.parse(row.version) }.sort
+        end
+
+        def store(prompt, overwrite: false)
+          existing = model.find_by(path: prompt.path, version: prompt.version.to_s)
+          raise Error, "Prompt #{prompt.path}@#{prompt.version} already exists" if existing && !overwrite
+
+          attrs = serialize_prompt(prompt)
+          existing ? existing.update!(attrs) : model.create!(attrs)
+          prompt
+        end
+
+        private
+
+        attr_reader :model
+
+        def require_active_record!
+          require "active_record"
+        rescue LoadError
+          raise LoadError, "active_record gem is required for the ActiveRecord adapter"
+        end
+
+        def build_model(table_name)
+          Class.new(::ActiveRecord::Base) do
+            self.table_name = table_name
+          end
+        end
+
+        def ensure_schema!
+          return if model.connection.data_source_exists?(model.table_name)
+
+          model.connection.create_table(model.table_name) do |table|
+            table.string :path, null: false
+            table.string :namespace, null: false
+            table.string :name, null: false
+            table.string :version, null: false
+            table.text :body, null: false
+            table.text :labels_json, null: false, default: "[]"
+            table.text :metadata_json, null: false, default: "{}"
+            table.text :required_vars_json, null: false, default: "[]"
+            table.string :source_path
+            table.timestamps null: false
+            table.index %i[path version], unique: true
+          end
+        end
+
+        def serialize_prompt(prompt)
+          {
+            path: prompt.path,
+            namespace: prompt.namespace,
+            name: prompt.name,
+            version: prompt.version.to_s,
+            body: prompt.body,
+            labels_json: JSON.generate(prompt.labels),
+            metadata_json: JSON.generate(prompt.metadata),
+            required_vars_json: JSON.generate(prompt.required_vars),
+            source_path: prompt.source_path
+          }
+        end
+
+        def prompt_from_record(record)
+          Prompt.new(
+            name: record.name,
+            namespace: record.namespace,
+            version: record.version,
+            body: record.body,
+            source_path: record.source_path,
+            labels: JSON.parse(record.labels_json || "[]"),
+            metadata: JSON.parse(record.metadata_json || "{}"),
+            required_vars: JSON.parse(record.required_vars_json || "[]")
+          )
+        end
+
+        def labels_for(record)
+          JSON.parse(record.labels_json || "[]").map(&:to_sym)
+        end
+      end
+    end
+  end
+end
+

data/lib/ruby_llm/registry/adapters/base.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module RubyLLM
+  module Registry
+    module Adapters
+      # Shared adapter behavior for prompt storage backends.
+      class Base
+        def get(_path, version: nil, label: nil)
+          raise NotImplementedError, "#{self.class} must implement #get"
+        end
+
+        def available_versions(_path)
+          []
+        end
+
+        def store(_prompt, **)
+          raise NotImplementedError, "#{self.class} must implement #store"
+        end
+
+        def export(path, version: nil, label: nil, format: :markdown, **options)
+          prompt = get(path, version: version, label: label)
+          Exporter.new(prompt).public_send(exporter_method(format), **options)
+        end
+
+        def import(payload, format: :auto, **options)
+          prompt = Importer.new(payload, format: format, **options).to_prompt
+          store(prompt)
+          prompt
+        end
+
+        private
+
+        def exporter_method(format)
+          case format.to_sym
+          when :yaml then :to_yaml
+          when :json then :to_json
+          when :markdown, :md then :to_markdown
+          when :hash then :to_h
+          else
+            raise ArgumentError, "Unsupported export format: #{format.inspect}"
+          end
+        end
+      end
+    end
+  end
+end
+