summoner-engine 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0c140e7b6dcffcd46213c17ea06f93723b115aae006686c64de4cda0e66d0824
+  data.tar.gz: bf77ad299888e02d1e2e9712249776eb6ae6b17d01157f3b20be024350886306
+SHA512:
+  metadata.gz: 85eba4331932b10f9bf10aaf3eeeb48f8e12083145c4f247ef8f4e92f475a3112d3da3837863146dac9e2ed24f01bbe4a9a813bbfcc1d99d2ab7178740d4fa2f
+  data.tar.gz: 84e1a26a354c4e6cba7507d61b22a02567b960a8b934e992f362947c6b4cc372083d3ec3bbc51f83c900075397b1f0ff5f5e18e5b462ebf76fc72d945ea68351

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Felipe Rodrigues
+
+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,205 @@
+# Summoner
+An advanced, flexible, and powerful Feature Toggle, Dynamic Configuration, and Attribute-Based Access Control (ABAC) engine for Ruby on Rails.
+
+Summoner goes way beyond simple booleans. It allows you to manage global or **Entity-specific** configurations (e.g., `User`, `Account`), perform gradual rollouts based on attributes (like `role` or `plan`), attach editable descriptions to each feature, and create surgical exceptions (_overrides_) directly through an elegant Web UI. All wrapped in a **lightning-fast Caching layer** to protect your database.
+
+## Table of Contents
+- [Key Features](#key-features)
+- [Installation](#installation)
+- [Configuration](#configuration)
+  - [The Web Dashboard](#the-web-dashboard)
+- [Usage](#usage)
+  - [1. Defining your Source of Truth (`features.yml`)](#1-defining-your-source-of-truth-featuresyml)
+  - [2. Setting up your Entities](#2-setting-up-your-entities)
+  - [3. Checking Features in your Code](#3-checking-features-in-your-code)
+- [Targeted Overrides and Rollouts](#targeted-overrides-and-rollouts)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Key Features
+- **Dynamic Entity Injection**: Features become native methods on your models (e.g., `user.new_dashboard?`).
+- **Attribute-Based Access Control (ABAC)**: Automatically evaluate feature access by matching permission arrays against entity attributes (e.g., checking if a user's role is in the allowed list).
+- **Instant Global Rollouts**: Use the wildcard `["*"]` to release a feature to everyone in seconds, without touching the codebase.
+- **Granular Overrides**: The default rule might be X, but for User ID 42, the rule is Y. Summoner manages these exceptions flawlessly.
+- **Strong Typing**: Native support for complex data types (`boolean`, `integer`, `float`, `json`, `string`).
+- **YAML Synchronization**: Keep a `features.yml` file as your single source of truth and sync it to the database on every deploy. YAML changes update the tracked defaults and descriptions, while manual dashboard edits remain in place until the YAML changes again.
+- **Built-in Web Dashboard**: A mountable Rails Engine for you and your team to manage everything visually.
+
+## Installation
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem "summoner"
+```
+
+Install the gem and run the installation generator:
+
+```bash
+bundle install
+rails generate summoner:install
+```
+
+The generator will create the database migrations, an initializer, and your `config/features.yml` template. Then, build the tables:
+
+```bash
+rails db:migrate
+```
+
+## Configuration
+You can customize the engine's behavior, especially the built-in Cache, in `config/initializers/summoner.rb`:
+
+```ruby
+Summoner.configure do |config|
+  # Enables or disables the use of Rails.cache (Default: true)
+  config.cache_enabled = true
+  
+  # A safe namespace to prevent key collisions in Redis/Memcached
+  config.cache_namespace = 'summoner'
+
+  # Defines expiration time for the cache (Default: 1.hour)
+  config.cache_expires_in = 1.hour
+end
+```
+
+### The Web Dashboard
+To manage your features and overrides visually, mount the UI inside your `config/routes.rb`:
+
+```ruby
+Rails.application.routes.draw do
+  # ... your application routes ...
+  mount Summoner::Engine => "/summoner"
+end
+```
+
+Now visit `http://localhost:3000/summoner` to see the magic happen!
+
+<img width="1912" height="573" alt="image" src="https://github.com/user-attachments/assets/2ee2e48b-98c9-4d53-9dcb-f0b2b28e1993" />
+
+## Usage
+Summoner's true power lies in its organization by **Namespaces (Entities)** and **Data Types**.
+
+### 1. Defining your Source of Truth (`features.yml`)
+Declare your application's base behavior in your `config/features.yml`. The structure uses the Entity name as the root key. Each feature can define a `default` value and an optional `description`:
+
+```yaml
+# =========================================================================
+# Whenever you update this file, run in your terminal: rails summoner:sync
+# =========================================================================
+
+user:
+  # Example 1: Simple Boolean injected into the model
+  "new_dashboard?":
+    default: false
+    description: Enables the new dashboard experience for users.
+
+  # Example 2: ABAC (Attribute-Based Access Control)
+  # Checks if the User's `role` method matches the values in the Array
+  "can_access_admin?":
+    default: ["admin", "manager"]
+    match_attribute: "role"
+    description: Allow admins and managers to access the admin area.
+
+  # Example 3: Global Release with Wildcard ("*")
+  # Everyone gets access, ignoring the `role` attribute entirely!
+  "can_access_beta?":
+    default: ["*"]
+    match_attribute: "role"
+
+  # Example 4: Dynamic Values (Integer, String, JSON)
+  max_items_per_page:
+    default: 20
+    description: Maximum number of items shown per page.
+
+system:
+  # Features that do not belong to a specific entity
+  maintenance_mode:
+    default: false
+    description: Toggle the maintenance page for all users.
+
+app:
+  # Global application configurations
+  api_timeout:
+    default: 30
+    description: Request timeout in seconds for external API calls.
+```
+
+Sync these definitions with your database by running:
+
+```bash
+rails summoner:sync
+```
+
+If you edit a feature through the dashboard, the manual change stays active until the same feature changes in `features.yml` again. At that point, Summoner updates the tracked YAML value and YAML description back to match the file.
+
+### 2. Setting up your Entities
+To allow Summoner to inject these configurations directly into your classes (like your `User` model), simply include the core module:
+
+```ruby
+class User < ApplicationRecord
+  include Summoner::Entity
+end
+```
+
+### 3. Checking Features in your Code
+Summoner exposes an elegant, fluent API with automatic caching out of the box.
+
+**A. Checking Boolean Toggles and ABAC:**
+Keys ending with a `?` in your YAML are converted into direct query methods on your entity:
+
+```ruby
+user = User.first
+
+# Respects the YAML default or a database Override
+if user.new_dashboard?
+  render "dashboards/v2"
+else
+  render "dashboards/v1"
+end
+
+# Automatically evaluates the ABAC array against user.role!
+user.can_access_admin? # => true (if the role is "admin")
+```
+
+**B. Getting Complex Typed Values:**
+To retrieve integers, strings, or JSON, just call the exact key name:
+
+```ruby
+# Returns 20 (or the specific overridden value for this user)
+limit = user.max_items_per_page 
+
+Product.limit(limit)
+```
+
+**C. Global Features (Without Entities):**
+Not every feature is tied to a user or an account. You can create arbitrary namespaces in your `features.yml` (like `system:`, `app:`, or `global:`) to group application-wide settings. 
+
+Since these don't belong to an Active Record model, you can query them directly through the `Summoner` module using the `"namespace.feature_key"` format:
+
+```ruby
+# Checking a global boolean toggle
+if Summoner.active?("system.maintenance_mode")
+  redirect_to maintenance_path
+end
+
+# Getting a global typed value
+api_timeout = Summoner.get("app.api_timeout")
+```
+
+## Targeted Overrides and Rollouts
+Your YAML defines the "General Rule," but real-world apps require exceptions. Through the Web Dashboard, you can create Overrides for specific instances.
+
+**Common Use Cases:**
+- **Beta Testing**: The `user.new_dashboard?` feature is `false` for everyone, but you create an Override set to `true` strictly for User ID: `1` and User ID: `42`.
+- **Tenant Customization**: The `max_items_per_page` limit is `20`, but you sold a VIP plan to User ID: `99` and created an Override with the value `100` just for them.
+- **ABAC Bypass**: `can_access_admin?` only allows `["admin"]`, but you want to grant temporary access to a specific regular user.
+
+Summoner's Evaluation Engine always respects the following priority hierarchy:  
+**Entity-specific Override > ABAC / Wildcard Rule > Global Default Value.**
+
+<img width="1914" height="990" alt="image" src="https://github.com/user-attachments/assets/70a7452a-01b8-4737-a7e8-82a2f9ccbd41" />
+
+## Contributing
+Bug reports and pull requests are warmly welcome on GitHub at https://github.com/feliperodrigs1/summoner.
+
+## 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,6 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+require "bundler/gem_tasks"

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

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/summoner/application_controller.rb

@@ -0,0 +1,7 @@
+module Summoner
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception
+
+    layout 'summoner/application'
+  end
+end

data/app/controllers/summoner/features_controller.rb

@@ -0,0 +1,40 @@
+module Summoner
+  class FeaturesController < ApplicationController
+    before_action :set_feature, only: %i[show edit update]
+
+    def index
+      @features = Summoner::Feature.all.order(:namespace, :name)
+    end
+
+    def show
+      @feature = Summoner::Feature.find(params[:id])
+      @overrides = Summoner::FeatureOverride.where(feature_key: @feature.key)
+    end
+
+    def edit; end
+
+    def update
+      raw_value = params[:feature][:default_value]
+      description = params[:feature][:description]
+
+      unless @feature.valid_value?(raw_value)
+        flash.now[:alert] = "Invalid value for type #{@feature.value_type}."
+        return render :edit
+      end
+
+      parsed_value = @feature.cast_value(params[:feature][:default_value])
+
+      if @feature.update(default_value: parsed_value, description: description)
+        redirect_to feature_path(@feature), notice: 'Feature updated successfully.'
+      else
+        render :edit
+      end
+    end
+
+    private
+
+    def set_feature
+      @feature = Summoner::Feature.find(params[:id])
+    end
+  end
+end

data/app/controllers/summoner/overrides_controller.rb

@@ -0,0 +1,64 @@
+module Summoner
+  class OverridesController < ApplicationController
+    before_action :set_feature
+    before_action :set_override, only: [:edit, :update, :destroy]
+    before_action :validate_type, only: [:create, :update]
+
+    def create
+      @override = Summoner::FeatureOverride.new(override_params)
+
+      @override.feature_key = @feature.key
+      @override.flaggable_type = @feature.namespace.classify
+      @override.value = @feature.cast_value(params[:feature_override][:value])
+
+      if @override.save
+        redirect_to feature_path(@feature), notice: 'Override created successfully!'
+      else
+        redirect_to feature_path(@feature), alert: "Error: #{@override.errors.full_messages.to_sentence}"
+      end
+    end
+
+    def edit; end
+
+    def update
+      parsed_value = @feature.cast_value(params[:feature_override][:value])
+
+      if @override.update(value: parsed_value)
+        redirect_to feature_path(@feature), notice: 'Override updated successfully!'
+      else
+        render :edit
+      end
+    end
+
+    def destroy
+      @override.destroy
+      redirect_to feature_path(@feature), notice: 'Override removed!'
+    end
+
+    private
+
+    def set_feature
+      @feature = Summoner::Feature.find(params[:feature_id])
+    end
+
+    def set_override
+      @override = Summoner::FeatureOverride.find(params[:id])
+    end
+
+    def validate_type
+      value = params[:feature_override][:value]
+  
+      unless @feature.valid_value?(value)
+        if action_name == 'update'
+          redirect_to edit_feature_override_path(@feature, @override), alert: "Invalid value for type #{@feature.value_type}."
+        else
+          redirect_to feature_path(@feature), alert: "Invalid value for type #{@feature.value_type}."
+        end
+      end
+    end
+
+    def override_params
+      params.require(:feature_override).permit(:flaggable_id)
+    end
+  end
+end

data/app/helpers/summoner/application_helper.rb

@@ -0,0 +1,4 @@
+module Summoner
+  module ApplicationHelper
+  end
+end

data/app/jobs/summoner/application_job.rb

@@ -0,0 +1,4 @@
+module Summoner
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/summoner/application_mailer.rb

@@ -0,0 +1,6 @@
+module Summoner
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/summoner/application_record.rb

@@ -0,0 +1,5 @@
+module Summoner
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/summoner/feature.rb

@@ -0,0 +1,61 @@
+module Summoner
+  class Feature < ApplicationRecord
+    self.table_name = "summoner_features"
+
+    validates :key, presence: true, uniqueness: true
+    validates :namespace, presence: true
+    validates :name, presence: true
+    validates :value_type, presence: true
+
+    after_commit :clear_cache
+
+    def cast_value(raw_value)
+      case value_type
+      when 'boolean'
+        raw_value.to_s.strip.downcase == 'true'
+      when 'integer'
+        raw_value.to_i
+      when 'float'
+        raw_value.to_f
+      when 'json'
+        raw_value.is_a?(String) ? JSON.parse(raw_value) : raw_value
+      else
+        raw_value.to_s
+      end
+    rescue
+      raw_value
+    end
+
+    def valid_value?(raw_value)
+      str_val = raw_value.to_s.strip
+      
+      case value_type
+      when 'boolean'
+        str_val.downcase.in?(['true', 'false'])
+      when 'integer'
+        str_val.match?(/\A-?\d+\z/)
+      when 'float'
+        str_val.match?(/\A-?\d+(\.\d+)?\z/)
+      when 'json'
+        begin
+          JSON.parse(str_val)
+          true
+        rescue JSON::ParserError
+          false
+        end
+      else
+        true
+      end
+    end
+
+    private
+
+    def clear_cache
+      return unless Summoner.configuration.cache_enabled
+
+      base_key = "#{Summoner.configuration.cache_namespace}:#{key}"
+      
+      Rails.cache.delete_matched(/#{Regexp.escape(base_key)}/)
+    end
+  end
+end

data/app/models/summoner/feature_override.rb

@@ -0,0 +1,22 @@
+module Summoner
+  class FeatureOverride < ApplicationRecord
+    self.table_name = 'summoner_feature_overrides'
+
+    belongs_to :flaggable, polymorphic: true, optional: true
+
+    validates :feature_key, presence: true
+    validates :feature_key, uniqueness: { scope: [:flaggable_id, :flaggable_type] }
+
+    after_commit :clear_cache
+
+    private
+
+    def clear_cache
+      return unless Summoner.configuration.cache_enabled
+
+      cache_key = "#{Summoner.configuration.cache_namespace}:#{feature_key}:#{flaggable_type.underscore}:#{flaggable_id}"
+
+      Rails.cache.delete(cache_key)
+    end
+  end
+end

data/app/views/layouts/summoner/application.html.erb

@@ -0,0 +1,139 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Summoner Dashboard</title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+  <link rel="icon" type="image/x-icon" href="<%= image_path('summoner/favicon.ico') %>" />
+  
+  <style>
+    :root {
+      --bg-main: #f3f4f6;
+      --bg-card: #ffffff;
+      --text-main: #111827;
+      --text-muted: #6b7280;
+      --border-color: #e5e7eb;
+      --nav-bg: #aa526b;
+      --nav-text: #ffffff;
+      --btn-primary: #2596be;
+      --btn-primary-hover: #1e7a9b;
+      --btn-danger: #ef4444;
+      --btn-danger-hover: #dc2626;
+      --btn-text: #ffffff;
+      --code-bg: #e0e7ff;
+      --code-text: #4f46e5;
+      --badge-active-bg: #d1fae5;
+      --badge-active-text: #065f46;
+      --badge-inactive-bg: #fee2e2;
+      --badge-inactive-text: #991b1b;
+      --input-bg: #ffffff;
+    }
+    
+    @media (prefers-color-scheme: dark) {
+      :root {
+        --bg-main: #111111;
+        --bg-card: #1c1c1e;
+        --text-main: #f4f4f5;
+        --text-muted: #a1a1aa;
+        --border-color: #2c2c2e;
+        --nav-bg: #1c1c1e;
+        --nav-text: #aa526b;
+        --btn-primary: #2596be;
+        --btn-primary-hover: #48a5c8;
+        --btn-danger: #dc2626;
+        --btn-danger-hover: #ef4444;
+        --btn-text: #ffffff;
+        --code-bg: #282836;
+        --code-text: #818cf8;
+        --badge-active-bg: #064e3b;
+        --badge-active-text: #34d399;
+        --badge-inactive-bg: #7f1d1d;
+        --badge-inactive-text: #fca5a5;
+        --input-bg: #111111;
+      }
+    }
+
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background: var(--bg-main); color: var(--text-main); margin: 0; padding: 0; }
+    
+    .navbar { background: var(--nav-bg); color: var(--nav-text); padding: 1rem 0; border-bottom: 1px solid var(--border-color); }
+    .navbar .container { display: flex; align-items: center; margin: 0 auto; padding-top: 0; padding-bottom: 0; }
+    .navbar h1 { margin: 0; font-size: 1.5rem; font-weight: 600; letter-spacing: -0.025em; }
+    
+    .container { max-width: 1100px; margin: 2rem auto; padding: 0 1.5rem; }
+    
+    .card { background: var(--bg-card); border-radius: 8px; border: 1px solid var(--border-color); box-shadow: 0 1px 3px rgba(0,0,0,0.05); overflow: hidden; margin-bottom: 2rem; }
+    .card-header { padding: 1rem 1.5rem; border-bottom: 1px solid var(--border-color); background: var(--bg-card); }
+    .card-header h2, .card-header h3 { margin: 0; font-size: 1.125rem; font-weight: 600; }
+    .card-body { padding: 1.25rem 1.5rem; }
+    
+    table { width: 100%; border-collapse: collapse; text-align: left; }
+    th { background: var(--bg-main); color: var(--text-muted); font-weight: 600; font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.05em; padding: 0.75rem 1.5rem; border-bottom: 1px solid var(--border-color); border-top: 1px solid var(--border-color); }
+    td { padding: 1rem 1.5rem; border-bottom: 1px solid var(--border-color); color: var(--text-main); vertical-align: middle; }
+    tr:last-child td { border-bottom: none; }
+    
+    code { background: var(--code-bg); color: var(--code-text); padding: 0.2rem 0.4rem; border-radius: 4px; font-size: 0.85em; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; }
+    
+    .badge { display: inline-flex; align-items: center; padding: 0.25rem 0.625rem; border-radius: 9999px; font-size: 0.75rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.025em; }
+    .badge.active { background: var(--badge-active-bg); color: var(--badge-active-text); }
+    .badge.inactive { background: var(--badge-inactive-bg); color: var(--badge-inactive-text); }
+    
+    a { color: var(--btn-primary); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+
+    .btn { display: inline-flex; align-items: center; justify-content: center; padding: 0.4rem 1rem; border-radius: 6px; font-size: 0.875rem; font-weight: 500; border: 1px solid transparent; cursor: pointer; transition: all 0.15s; text-decoration: none; line-height: 1.25rem; }
+    .btn:hover { text-decoration: none; }
+    .btn-sm { padding: 0.25rem 0.625rem; font-size: 0.75rem; }
+    .btn-primary { background: var(--btn-primary); color: var(--btn-text); }
+    .btn-primary:hover { background: var(--btn-primary-hover); color: var(--btn-text); }
+    .btn-danger { background: var(--btn-danger); color: var(--btn-text); }
+    .btn-danger:hover { background: var(--btn-danger-hover); color: var(--btn-text); }
+    .btn-outline { background: transparent; border-color: var(--border-color); color: var(--text-main); }
+    .btn-outline:hover { background: var(--bg-main); color: var(--text-main); }
+    
+    .form-group { margin-bottom: 1rem; }
+    .form-label { display: block; font-size: 0.875rem; font-weight: 500; color: var(--text-main); margin-bottom: 0.35rem; }
+    .form-control { display: block; width: 100%; padding: 0.4rem 0.6rem; font-size: 0.875rem; line-height: 1.5rem; color: var(--text-main); background-color: var(--input-bg); border: 1px solid var(--border-color); border-radius: 6px; box-sizing: border-box; transition: border-color 0.15s ease-in-out; }
+    .form-control:focus { border-color: var(--btn-primary); outline: 0; box-shadow: 0 0 0 1px var(--btn-primary); }
+    .form-control[readonly] { background-color: var(--bg-main); cursor: not-allowed; color: var(--text-muted); }
+    
+    .d-flex { display: flex; }
+    .gap-2 { gap: 0.5rem; }
+    .gap-3 { gap: 1rem; }
+    .align-items-center { align-items: center; }
+    .align-items-end { align-items: flex-end; }
+    .justify-content-between { justify-content: space-between; }
+    .flex-wrap { flex-wrap: wrap; }
+    
+    .text-center { text-align: center; }
+    .text-muted { color: var(--text-muted); }
+    .mb-0 { margin-bottom: 0; }
+    .mb-3 { margin-bottom: 1rem; }
+    .mb-4 { margin-bottom: 1.5rem; }
+    
+    .grid-details { display: grid; grid-template-columns: minmax(130px, max-content) 1fr; gap: 0.75rem 1rem; align-items: baseline; }
+    .grid-details > span:nth-child(odd) { font-weight: 500; color: var(--text-muted); font-size: 0.875rem; }
+
+    .flash { padding: 1rem; margin-bottom: 1.5rem; border-radius: 6px; font-weight: 500; font-size: 0.875rem; }
+    .flash.notice { background: var(--badge-active-bg); color: var(--badge-active-text); border: 1px solid var(--badge-active-text); }
+    .flash.alert { background: var(--badge-inactive-bg); color: var(--badge-inactive-text); border: 1px solid var(--badge-inactive-text); }
+  </style>
+</head>
+<body>
+  <div class="navbar">
+    <div class="container">
+      <h1>Summoner</h1>
+    </div>
+  </div>
+
+  <div class="container">
+    <% flash.each do |key, message| %>
+      <div class="flash <%= key %>">
+        <%= message %>
+      </div>
+    <% end %>
+
+    <%= yield %>
+  </div>
+</body>
+</html>

data/app/views/summoner/features/edit.html.erb

@@ -0,0 +1,38 @@
+<div class="mb-4">
+  <%= link_to "← Back to Feature", feature_path(@feature), class: "btn btn-outline btn-sm", style: "text-decoration: none;" %>
+</div>
+
+<div class="card" style="max-width: 600px;">
+  <div class="card-header">
+    <h2 class="mb-0">Edit Default Value</h2>
+  </div>
+  
+  <div class="card-body">
+    <div class="grid-details mb-4">
+      <span>Feature:</span> <code><%= @feature.key %></code>
+      <span>Expected Type:</span> <code><%= @feature.value_type %></code>
+      <span>Description:</span>
+      <span><%= @feature.description.presence || "No description set" %></span>
+      
+      <% if @feature.match_attribute.present? %>
+        <span>Matches Attribute:</span> <code style="background: #fef08a; color: #854d0e;"><%= @feature.match_attribute %></code>
+      <% end %>
+    </div>
+
+    <hr style="border: 0; border-top: 1px solid var(--border-color); margin: 1.5rem 0;">
+
+    <%= form_with model: @feature, local: true do |f| %>
+      <div class="form-group mb-4">
+        <%= f.label :default_value, "New Default Value", class: "form-label" %>
+        <%= f.text_field :default_value, value: @feature.default_value.is_a?(String) ? @feature.default_value : @feature.default_value.to_json, class: "form-control" %>
+      </div>
+
+      <div class="form-group mb-4">
+        <%= f.label :description, "Description", class: "form-label" %>
+        <%= f.text_area :description, rows: 4, class: "form-control" %>
+      </div>
+      
+      <%= f.submit "Save & Lock Sync", class: "btn btn-primary" %>
+    <% end %>
+  </div>
+</div>