prompt_engine 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ff080a302295b4fa4c7e44073f35e9063d347189e1735a17b12f939592dd666d
+  data.tar.gz: 67120aafde4e7f86942aa7e1cda951fa2a1360ec29cbad463dc1e800c91c2100
+SHA512:
+  metadata.gz: d3ca1b299754fa4d91f2160a8b77da940fdc4e40eb3a10f56338d32bfa993b07650cd0cea463353e39dd8ccb59aabbc7526a9b5e624e8d9419e8edee0a5ce37c
+  data.tar.gz: 17bfa392e4971b830082ff6c70c18a2b56a19d7f3581eeae5111c43b7e34f3d9a2696a9daff72d3eacd81bcb23a5743f0c8b1f4c78e64744f9ddde859c73d920

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Avi Flombaum
+
+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,67 @@
+# PromptEngine
+
+A Rails engine for managing AI prompts with version control and secure API key storage.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "prompt_engine"
+```
+
+And then execute:
+```bash
+$ bundle
+$ rails prompt_engine:install:migrations
+$ rails db:migrate
+```
+
+## Setup
+
+### Configure Encryption
+
+PromptEngine uses Rails encryption to secure API keys. Add to your environment files:
+
+```ruby
+# config/environments/development.rb
+config.active_record.encryption.primary_key = 'development' * 4
+config.active_record.encryption.deterministic_key = 'development' * 4
+config.active_record.encryption.key_derivation_salt = 'development' * 4
+```
+
+For production, use `rails db:encryption:init` to generate secure keys.
+
+### Configure API Keys
+
+PromptEngine requires API keys for AI providers. See [API Credentials Setup](docs/API_CREDENTIALS.md) for detailed configuration instructions.
+
+Quick setup:
+```bash
+rails credentials:edit
+```
+
+Add your API keys:
+```yaml
+openai:
+  api_key: sk-your-openai-api-key
+anthropic:
+  api_key: sk-ant-your-anthropic-api-key
+```
+
+### Mount the Engine
+
+In your `config/routes.rb`:
+
+```ruby
+mount PromptEngine::Engine => "/prompt_engine"
+```
+
+## Usage
+
+Visit `/prompt_engine` to access the admin interface.
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,22 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"
+
+require "rspec/core"
+require "rspec/core/rake_task"
+
+desc "Run all specs in spec directory"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = "spec/**{,/*/**}/*_spec.rb"
+end
+
+# Add setup task shortcut
+desc "Setup PromptEngine dummy app for development and testing"
+task setup: "app:prompt_engine:setup"
+
+task default: :spec

data/app/assets/stylesheets/prompt_engine/application.css

@@ -0,0 +1,22 @@
+/* PromptEngine Admin Styles
+ * 
+ * Import all component styles in the correct order
+ */
+
+@import url("foundation.css");
+@import url("layout.css");
+@import url("sidebar.css");
+@import url("buttons.css");
+@import url("forms.css");
+@import url("tables.css");
+@import url("cards.css");
+@import url("dashboard.css");
+@import url("prompts.css");
+@import url("versions.css");
+@import url("notifications.css");
+@import url("loading.css");
+@import url("comparison.css");
+@import url("evaluations.css");
+@import url("utilities.css");
+@import url("overrides.css");
+@import url("components/_test_runs.css");

data/app/assets/stylesheets/prompt_engine/buttons.css

@@ -0,0 +1,124 @@
+/* Button Component */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-family: inherit;
+  font-weight: 500;
+  text-decoration: none;
+  border: 1px solid transparent;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: all var(--transition-fast);
+  white-space: nowrap;
+  user-select: none;
+  vertical-align: middle;
+  -webkit-appearance: none;
+  -moz-appearance: none;
+  appearance: none;
+  min-height: 2.25rem;
+  gap: 0.5rem;
+}
+
+.btn:focus {
+  outline: 2px solid transparent;
+  outline-offset: 2px;
+}
+
+.btn:focus-visible {
+  box-shadow:
+    0 0 0 2px var(--color-gray-50),
+    0 0 0 4px var(--color-primary-500);
+}
+
+/* Button Sizes */
+.btn--small {
+  padding: 0.375rem 0.75rem;
+  font-size: var(--font-size-sm);
+  line-height: 1.5;
+}
+
+.btn--medium {
+  padding: 0.5rem 1rem;
+  font-size: var(--font-size-sm);
+  line-height: 1.5;
+}
+
+.btn--large {
+  padding: 0.625rem 1.25rem;
+  font-size: var(--font-size-base);
+  line-height: 1.5;
+}
+
+/* Primary Button */
+.btn--primary {
+  background-color: var(--color-primary-600);
+  color: white;
+  border-color: var(--color-primary-600);
+  padding: var(--spacing-sm);
+}
+
+.btn--primary:hover {
+  background-color: var(--color-primary-700);
+  border-color: var(--color-primary-700);
+  color: white;
+  text-decoration: none;
+}
+
+.btn--primary:active {
+  background-color: var(--color-primary-800);
+  border-color: var(--color-primary-800);
+  color: white;
+}
+
+/* Secondary Button */
+.btn--secondary {
+  background-color: white;
+  color: var(--color-gray-700);
+  border-color: var(--color-gray-300);
+}
+
+.btn--secondary:hover {
+  background-color: var(--color-gray-50);
+  color: var(--color-gray-900);
+  text-decoration: none;
+}
+
+.btn--secondary:active {
+  background-color: var(--color-gray-100);
+}
+
+/* Danger Button */
+.btn--danger {
+  background-color: var(--color-danger);
+  color: white;
+  border-color: var(--color-danger);
+}
+
+.btn--danger:hover {
+  background-color: var(--color-danger-hover);
+  border-color: var(--color-danger-hover);
+  color: white;
+  text-decoration: none;
+}
+
+.btn--danger:active {
+  background-color: #b91c1c;
+  border-color: #b91c1c;
+  color: white;
+}
+
+/* Disabled State */
+.btn:disabled,
+.btn--disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+/* Button Group */
+.btn-group {
+  display: inline-flex;
+  gap: var(--spacing-sm);
+  align-items: center;
+}

data/app/assets/stylesheets/prompt_engine/cards.css

@@ -0,0 +1,63 @@
+/* Card Components */
+.card {
+  background-color: white;
+  border: 1px solid var(--color-gray-200);
+  border-radius: var(--radius-lg);
+  box-shadow: var(--shadow-sm);
+  overflow: hidden;
+}
+
+.card--shadowed {
+  box-shadow: var(--shadow-md);
+  border: none;
+}
+
+/* Card Header */
+.card__header {
+  padding: var(--spacing-lg);
+  border-bottom: 1px solid var(--color-gray-200);
+  background-color: var(--color-gray-50);
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.card__title {
+  font-size: var(--font-size-lg);
+  font-weight: 600;
+  color: var(--color-gray-900);
+  margin: 0;
+}
+
+.card__actions {
+  flex-shrink: 0;
+  margin-left: var(--spacing-md);
+}
+
+
+/* Card Body */
+.card__body {
+  padding: var(--spacing-lg);
+}
+
+.card__body--compact {
+  padding: var(--spacing-md);
+}
+
+
+/* Card Sections */
+.card__section {
+  padding: var(--spacing-lg) 0;
+}
+
+.card__section:first-child {
+  padding-top: 0;
+}
+
+.card__section:last-child {
+  padding-bottom: 0;
+}
+
+.card__section + .card__section {
+  border-top: 1px solid var(--color-gray-200);
+}

data/app/assets/stylesheets/prompt_engine/comparison.css

@@ -0,0 +1,244 @@
+/* Comparison View Styles */
+
+/* Comparison Grid */
+.comparison-grid {
+  display: grid;
+  grid-template-columns: 1fr auto 1fr;
+  gap: var(--spacing-lg);
+  align-items: start;
+}
+
+@media (max-width: 1024px) {
+  .comparison-grid {
+    grid-template-columns: 1fr;
+    gap: var(--spacing-xl);
+  }
+  
+  .comparison-divider {
+    display: none;
+  }
+}
+
+/* Comparison Column */
+.comparison-column {
+  flex: 1;
+  min-width: 0;
+}
+
+.comparison-header {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+  margin-bottom: var(--spacing-lg);
+  padding-bottom: var(--spacing-md);
+  border-bottom: 1px solid var(--color-gray-200);
+}
+
+.comparison-header h4 {
+  margin: 0;
+  font-size: var(--font-size-lg);
+  font-weight: 600;
+  color: var(--color-gray-900);
+}
+
+/* Comparison Divider */
+.comparison-divider {
+  width: 1px;
+  background-color: var(--color-gray-200);
+  align-self: stretch;
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+/* Comparison Indicator */
+.comparison-indicator {
+  position: absolute;
+  background: white;
+  padding: var(--spacing-md);
+  border-radius: var(--radius-full);
+  box-shadow: var(--shadow-md);
+}
+
+.indicator {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-xs);
+  font-weight: 600;
+  font-size: var(--font-size-lg);
+}
+
+.indicator__icon {
+  width: 1.5rem;
+  height: 1.5rem;
+}
+
+.indicator--success {
+  color: var(--color-success);
+}
+
+.indicator--danger {
+  color: var(--color-danger);
+}
+
+.indicator--neutral {
+  color: var(--color-gray-500);
+}
+
+/* Comparison Metrics */
+.comparison-metrics {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+}
+
+.metric {
+  text-align: center;
+}
+
+.metric__label {
+  font-size: var(--font-size-sm);
+  color: var(--color-gray-600);
+  margin-bottom: var(--spacing-xs);
+}
+
+.metric__value {
+  font-size: var(--font-size-lg);
+  font-weight: 600;
+  color: var(--color-gray-900);
+}
+
+.metric__value--large {
+  font-size: var(--font-size-2xl);
+}
+
+/* Comparison Content */
+.comparison-content {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+}
+
+.comparison-section {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+}
+
+.comparison-section__title {
+  font-size: var(--font-size-sm);
+  font-weight: 600;
+  color: var(--color-gray-700);
+  margin: 0;
+}
+
+/* Prompt Content for Comparison */
+.prompt-content--comparison {
+  background-color: var(--color-gray-50);
+  border: 1px solid var(--color-gray-200);
+  border-radius: var(--radius-md);
+  padding: var(--spacing-md);
+  font-family: var(--font-mono);
+  font-size: var(--font-size-sm);
+  line-height: 1.6;
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 400px;
+  overflow-y: auto;
+  margin: 0;
+}
+
+/* Comparison List */
+.comparison-list {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: var(--spacing-sm) var(--spacing-md);
+  margin: 0;
+}
+
+.comparison-list dt {
+  font-weight: 500;
+  color: var(--color-gray-600);
+  font-size: var(--font-size-sm);
+}
+
+.comparison-list dd {
+  font-weight: 500;
+  color: var(--color-gray-900);
+  margin: 0;
+}
+
+/* Table Checkbox Column */
+.table__checkbox-column {
+  width: 60px;
+  text-align: center;
+  padding: var(--spacing-sm);
+}
+
+.compare-checkbox {
+  cursor: pointer;
+  width: 1rem;
+  height: 1rem;
+}
+
+.compare-checkbox:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
+/* Visual Diff Highlighting */
+.diff-added {
+  background-color: rgba(34, 197, 94, 0.1);
+  color: var(--color-success);
+  padding: 0.125rem 0.25rem;
+  border-radius: var(--radius-sm);
+}
+
+.diff-removed {
+  background-color: rgba(239, 68, 68, 0.1);
+  color: var(--color-danger);
+  text-decoration: line-through;
+  padding: 0.125rem 0.25rem;
+  border-radius: var(--radius-sm);
+}
+
+.diff-changed {
+  background-color: rgba(251, 146, 60, 0.1);
+  color: var(--color-warning);
+  padding: 0.125rem 0.25rem;
+  border-radius: var(--radius-sm);
+}
+
+/* Text Utilities for Comparison */
+.text-warning {
+  color: var(--color-warning);
+}
+
+/* Responsive Adjustments */
+@media (max-width: 768px) {
+  .comparison-grid {
+    gap: var(--spacing-md);
+  }
+  
+  .comparison-header {
+    flex-direction: row;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--spacing-xs);
+  }
+  
+  .comparison-metrics {
+    flex-direction: row;
+    justify-content: space-around;
+  }
+  
+  .metric {
+    flex: 1;
+  }
+  
+  .prompt-content--comparison {
+    max-height: 300px;
+    font-size: var(--font-size-xs);
+  }
+}

data/app/assets/stylesheets/prompt_engine/components/_test_runs.css

@@ -0,0 +1,144 @@
+/* Test Runs List */
+.test-runs-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0;
+}
+
+.test-run-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem 0;
+  border-bottom: 1px solid hsl(var(--border));
+  transition: all 0.2s;
+}
+
+.test-run-item:last-child {
+  border-bottom: none;
+}
+
+.test-run-item:hover {
+  background-color: hsl(var(--muted) / 0.3);
+}
+
+.test-run-item__main {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  flex: 1;
+}
+
+.test-run-item__info {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.test-run-item__date {
+  font-size: 0.875rem;
+  color: hsl(var(--foreground));
+  font-weight: 500;
+}
+
+.test-run-item__version {
+  font-size: 0.75rem;
+  padding: 0.125rem 0.5rem;
+  background-color: hsl(var(--primary) / 0.1);
+  color: hsl(var(--primary));
+  border-radius: 0.25rem;
+  font-weight: 500;
+}
+
+.test-run-item__provider {
+  font-size: 0.75rem;
+  padding: 0.125rem 0.5rem;
+  background-color: hsl(var(--muted));
+  color: hsl(var(--muted-foreground));
+  border-radius: 0.25rem;
+  text-transform: capitalize;
+}
+
+.test-run-item__model {
+  font-size: 0.75rem;
+  color: hsl(var(--muted-foreground));
+}
+
+.test-run-item__metrics {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  font-size: 0.75rem;
+  color: hsl(var(--muted-foreground));
+}
+
+.test-run-item__time {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+}
+
+.test-run-item__time::before {
+  content: "⏱";
+  opacity: 0.7;
+}
+
+.test-run-item__tokens {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+}
+
+.test-run-item__tokens::before {
+  content: "🎯";
+  opacity: 0.7;
+}
+
+.test-run-item__actions {
+  flex-shrink: 0;
+}
+
+
+/* Small button variant */
+.btn--sm {
+  padding: 0.25rem 0.75rem;
+  font-size: 0.875rem;
+  height: auto;
+  min-height: 0;
+}
+
+/* Parameter value display */
+.parameter-value {
+  font-family: var(--font-mono);
+  font-size: 0.875rem;
+  color: hsl(var(--foreground));
+  background-color: hsl(var(--muted));
+  padding: 0.125rem 0.5rem;
+  border-radius: 0.25rem;
+  display: inline-block;
+}
+
+/* Link styling */
+.link {
+  color: hsl(var(--primary));
+  text-decoration: none;
+  transition: opacity 0.2s;
+}
+
+.link:hover {
+  opacity: 0.8;
+  text-decoration: underline;
+}
+
+/* Empty state */
+.empty-state {
+  text-align: center;
+  padding: 3rem 1rem;
+}
+
+.empty-state__message {
+  color: hsl(var(--muted-foreground));
+  margin-bottom: 1.5rem;
+  font-size: 1.125rem;
+}