context_drop 0.1.0

data/lib/context_drop/mcp/tools/list_feedbacks.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module ContextDrop
+  module MCP
+    module Tools
+      class ListFeedbacks
+        MAX_LIMIT = 100
+        DEFAULT_LIMIT = 20
+
+        DEFINITION = {
+          name: "list_feedbacks",
+          description: "List and search ContextDrop feedback submissions filtered by status, page_url, or free-text query.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              status: {
+                type: "string",
+                enum: %w[new reviewed resolved dismissed],
+                description: "Filter feedback by workflow status."
+              },
+              page_url: {
+                type: "string",
+                description: "Filter feedback by originating page URL substring (e.g. '/checkout')."
+              },
+              query: {
+                type: "string",
+                description: "Free-text search matching feedback message or attached DOM element selectors, paths, or text."
+              },
+              limit: {
+                type: "integer",
+                description: "Maximum records to return (default 20, max 100)."
+              },
+              offset: {
+                type: "integer",
+                description: "Pagination offset (default 0)."
+              }
+            }
+          }
+        }.freeze
+
+        def self.call(args = {})
+          params = stringify_keys(args)
+          scope = ContextDrop::Feedback.includes(:submitter, :element_references, :attachments).recent
+
+          status = params["status"].to_s.strip
+          if status.present?
+            unless ContextDrop::Feedback::STATUSES.include?(status)
+              return error_result("Invalid status '#{status}'. Must be one of: #{ContextDrop::Feedback::STATUSES.join(', ')}")
+            end
+
+            scope = scope.where(status: status)
+          end
+
+          page_url = params["page_url"].to_s.strip
+          if page_url.present?
+            scope = scope.where("context_drop_feedbacks.page_url LIKE ?", "%#{escape_like(page_url)}%")
+          end
+
+          query = params["query"].to_s.strip
+          if query.present?
+            pattern = "%#{escape_like(query)}%"
+            scope = scope.left_outer_joins(:element_references).where(
+              "context_drop_feedbacks.message LIKE :q OR " \
+              "context_drop_element_references.selector LIKE :q OR " \
+              "context_drop_element_references.dom_path LIKE :q OR " \
+              "context_drop_element_references.text_content LIKE :q",
+              q: pattern
+            ).distinct
+          end
+
+          raw_limit = params["limit"] ? params["limit"].to_i : DEFAULT_LIMIT
+          limit = raw_limit.clamp(1, MAX_LIMIT)
+          offset = [params["offset"].to_i, 0].max
+
+          total_count = scope.count
+          records = scope.limit(limit).offset(offset).map { |fb| serialize_summary(fb) }
+
+          {
+            content: [
+              {
+                type: "text",
+                text: JSON.pretty_generate(
+                  total: total_count,
+                  limit: limit,
+                  offset: offset,
+                  feedbacks: records
+                )
+              }
+            ],
+            isError: false
+          }
+        end
+
+        def self.serialize_summary(feedback)
+          {
+            id: feedback.id,
+            status: feedback.status,
+            message: feedback.message,
+            page_url: feedback.page_url,
+            submitter: feedback.submitter_label,
+            attachments_count: feedback.attachments.size,
+            element_references_count: feedback.element_references.size,
+            element_selectors: feedback.element_references.map(&:selector),
+            created_at: feedback.created_at&.iso8601
+          }
+        end
+
+        def self.error_result(msg)
+          {
+            content: [{ type: "text", text: JSON.generate(error: msg) }],
+            isError: true
+          }
+        end
+
+        def self.escape_like(str)
+          ActiveRecord::Base.sanitize_sql_like(str.to_s)
+        rescue StandardError
+          str.to_s.gsub(/[%_\\]/) { |m| "\\#{m}" }
+        end
+
+        def self.stringify_keys(hash)
+          hash.is_a?(Hash) ? hash.transform_keys(&:to_s) : {}
+        end
+      end
+    end
+  end
+end

data/lib/context_drop/mcp/tools/update_feedback_status.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module ContextDrop
+  module MCP
+    module Tools
+      class UpdateFeedbackStatus
+        DEFINITION = {
+          name: "update_feedback_status",
+          description: "Transition a ContextDrop feedback record's status ('new', 'reviewed', 'resolved', 'dismissed').",
+          inputSchema: {
+            type: "object",
+            required: %w[id status],
+            properties: {
+              id: {
+                type: %w[integer string],
+                description: "The ID of the ContextDrop::Feedback record."
+              },
+              status: {
+                type: "string",
+                enum: %w[new reviewed resolved dismissed],
+                description: "Target workflow status."
+              }
+            }
+          }
+        }.freeze
+
+        def self.call(args = {})
+          params = args.is_a?(Hash) ? args.transform_keys(&:to_s) : {}
+          feedback_id = params["id"] || params["feedback_id"]
+          next_status = params["status"].to_s.strip
+
+          return error_result("Missing required parameter: id") if feedback_id.nil? || feedback_id.to_s.strip.empty?
+
+          unless ContextDrop::Feedback::STATUSES.include?(next_status)
+            return error_result(
+              "Invalid status '#{next_status}'. Must be one of: #{ContextDrop::Feedback::STATUSES.join(', ')}"
+            )
+          end
+
+          feedback = ContextDrop::Feedback.find_by(id: feedback_id)
+          return error_result("Feedback ##{feedback_id} not found") unless feedback
+
+          previous_status = feedback.status
+          feedback.update!(status: next_status)
+
+          {
+            content: [
+              {
+                type: "text",
+                text: JSON.pretty_generate(
+                  id: feedback.id,
+                  previous_status: previous_status,
+                  status: feedback.status,
+                  page_url: feedback.page_url,
+                  updated_at: feedback.updated_at&.iso8601
+                )
+              }
+            ],
+            isError: false
+          }
+        end
+
+        def self.error_result(msg)
+          {
+            content: [{ type: "text", text: JSON.generate(error: msg) }],
+            isError: true
+          }
+        end
+      end
+    end
+  end
+end

data/lib/context_drop/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ContextDrop
+  VERSION = "0.1.0"
+end

data/lib/context_drop.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "context_drop/version"
+require_relative "context_drop/base64_util"
+require_relative "context_drop/configuration"
+require_relative "context_drop/mcp/server"
+require_relative "context_drop/engine" if defined?(Rails::Engine)
+
+module ContextDrop
+  class Error < StandardError; end
+
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    alias configuration config
+
+    def configure
+      yield(config) if block_given?
+      config
+    end
+
+    def reset_configuration!
+      @config = Configuration.new
+    end
+
+    def enabled?
+      !!config.enabled
+    end
+  end
+end

data/lib/generators/context_drop/install/install_generator.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module ContextDrop
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Installs ContextDrop initializer, mounts Engine routes, copies migrations, and checks Active Storage."
+
+      def create_initializer_file
+        template "initializer.rb.tt", "config/initializers/context_drop.rb"
+      end
+
+      def mount_engine_routes
+        routes_path = File.join(destination_root, "config/routes.rb")
+        return unless File.exist?(routes_path)
+
+        content = File.read(routes_path)
+        return if content.include?("ContextDrop::Engine")
+
+        route 'mount ContextDrop::Engine => "/context_drop"'
+      end
+
+      def copy_engine_migrations
+        rake "context_drop:install:migrations"
+      end
+
+      def verify_active_storage
+        migrations_dir = File.join(destination_root, "db/migrate")
+        has_active_storage = Dir.exist?(migrations_dir) &&
+                             Dir.glob(File.join(migrations_dir, "*create_active_storage_tables*.rb")).any?
+
+        return if has_active_storage
+
+        say_status(
+          :info,
+          "Active Storage migrations not detected. Run `bin/rails active_storage:install` if Active Storage is not yet installed.",
+          :yellow
+        )
+      end
+
+      def print_post_install_instructions
+        say "\nContextDrop installed! Next steps:", :green
+        say "  1. Run `bin/rails db:migrate` to create context_drop_* tables."
+        say "  2. Set `CONTEXT_DROP_ENABLED=true` in your environment."
+        say "  3. Add `<%= context_drop_widget %>` before `</body>` in `app/views/layouts/application.html.erb`."
+      end
+    end
+  end
+end

data/lib/generators/context_drop/install/templates/initializer.rb.tt

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+ContextDrop.configure do |config|
+  # Environment-based master switch (disables widget, dashboard, and ingestion endpoints when false)
+  config.enabled = ENV.fetch("CONTEXT_DROP_ENABLED", "false") == "true"
+
+  # Widget position: :bottom_right, :bottom_left, :top_right, :top_left
+  config.position = :bottom_right
+
+  # Attachment storage backend
+  config.storage = :active_storage
+  config.active_storage_service = nil # nil uses host app's default Active Storage service
+
+  # Submission permissions
+  config.allow_anonymous = true
+
+  # Attachment & element limits
+  config.max_attachments = 10
+  config.max_element_references = 10
+  config.max_attachment_size = 10.megabytes
+  config.allowed_content_types = %w[image/png image/jpeg image/webp image/gif]
+  config.max_image_dimensions = [4096, 4096]
+
+  # Widget feature flags
+  config.element_selection = true
+  config.screenshot_capture = true
+  config.element_capture_padding = 16
+
+  # DOM selectors excluded from selection and redacted in screenshots
+  config.excluded_selectors = [
+    "[data-feedback-ignore]",
+    "[data-feedback-sensitive]",
+    "input[type='password']",
+    "input[type='hidden']",
+    "[autocomplete^='cc-']"
+  ]
+
+  # Host authentication integration (returns any ActiveRecord model for polymorphic `submitter`, or nil)
+  config.current_submitter = ->(controller) { controller.try(:current_user) }
+
+  # Authorization policies
+  config.authorize_submission = ->(_controller) { true }
+  config.authorize_dashboard = ->(controller) { controller.try(:current_user)&.try(:admin?) || Rails.env.development? }
+
+  # Rate limiting on submission/upload endpoints
+  config.rate_limit = { max_requests: 20, period: 1.hour }
+
+  # Optional lifecycle callback invoked after feedback creation
+  config.on_feedback_created = ->(feedback) {}
+
+  # Model Context Protocol (MCP) server settings (Phase 2)
+  config.mcp_enabled = ENV.fetch("CONTEXT_DROP_MCP_ENABLED", "false") == "true"
+  config.mcp_api_key = ENV["CONTEXT_DROP_MCP_API_KEY"]
+  config.authorize_mcp = nil
+end

data/lib/tasks/context_drop_tasks.rake

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+namespace :context_drop do
+  desc "Start the ContextDrop Model Context Protocol (MCP) server over stdio"
+  task :mcp do
+    # Reserve original STDOUT strictly for MCP JSON-RPC frames while loading the Rails environment
+    mcp_stdout = $stdout.dup
+    $stdout.reopen($stderr)
+
+    Rake::Task["environment"].invoke if Rake::Task.task_defined?("environment")
+
+    ContextDrop::MCP::Server.run_stdio(input: $stdin, output: mcp_stdout, error: $stderr)
+  end
+end

metadata

@@ -0,0 +1,246 @@
+--- !ruby/object:Gem::Specification
+name: context_drop
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kemal Elmizan
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-11-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: activestorage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: marcel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: |
+  ContextDrop is a self-hosted contextual feedback library for Ruby on Rails applications.
+  It provides a mountable Rails Engine with engine-owned persistence, a decoupled TypeScript
+  Shadow DOM prompt-style feedback composer with interactive DOM element selection and
+  privacy-redacted screenshots, a self-hosted triage dashboard, and a built-in Model Context
+  Protocol (MCP) server for IDEs and coding agents.
+email:
+- kemal@elmizan.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- SPEC.md
+- app/assets/javascripts/context_drop/context_drop.js
+- app/assets/stylesheets/context_drop/application.css
+- app/controllers/context_drop/application_controller.rb
+- app/controllers/context_drop/attachments_controller.rb
+- app/controllers/context_drop/configs_controller.rb
+- app/controllers/context_drop/dashboard/feedbacks_controller.rb
+- app/controllers/context_drop/feedbacks_controller.rb
+- app/controllers/context_drop/health_controller.rb
+- app/controllers/context_drop/mcp_controller.rb
+- app/helpers/context_drop/widget_helper.rb
+- app/javascript/context_drop/__tests__/widget.test.ts
+- app/javascript/context_drop/api-client.ts
+- app/javascript/context_drop/element-picker.ts
+- app/javascript/context_drop/icons.ts
+- app/javascript/context_drop/index.ts
+- app/javascript/context_drop/sanitizer.ts
+- app/javascript/context_drop/screenshot.ts
+- app/javascript/context_drop/styles.ts
+- app/javascript/context_drop/types.ts
+- app/javascript/context_drop/widget.ts
+- app/models/context_drop/application_record.rb
+- app/models/context_drop/attachment.rb
+- app/models/context_drop/element_reference.rb
+- app/models/context_drop/feedback.rb
+- app/services/context_drop/metadata_sanitizer.rb
+- app/services/context_drop/upload_validator.rb
+- app/views/context_drop/dashboard/feedbacks/index.html.erb
+- app/views/context_drop/dashboard/feedbacks/show.html.erb
+- app/views/layouts/context_drop/application.html.erb
+- config/routes.rb
+- db/migrate/20261109000001_create_context_drop_feedbacks.rb
+- db/migrate/20261109000002_create_context_drop_element_references.rb
+- db/migrate/20261109000003_create_context_drop_attachments.rb
+- lib/context_drop.rb
+- lib/context_drop/base64_util.rb
+- lib/context_drop/configuration.rb
+- lib/context_drop/engine.rb
+- lib/context_drop/mcp/dispatcher.rb
+- lib/context_drop/mcp/prompts/investigate_feedback.rb
+- lib/context_drop/mcp/server.rb
+- lib/context_drop/mcp/stdio_runner.rb
+- lib/context_drop/mcp/tools/get_feedback.rb
+- lib/context_drop/mcp/tools/get_feedback_attachment.rb
+- lib/context_drop/mcp/tools/list_feedbacks.rb
+- lib/context_drop/mcp/tools/update_feedback_status.rb
+- lib/context_drop/version.rb
+- lib/generators/context_drop/install/install_generator.rb
+- lib/generators/context_drop/install/templates/initializer.rb.tt
+- lib/tasks/context_drop_tasks.rake
+homepage: https://github.com/kemalelmizan/context-drop
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/kemalelmizan/context-drop
+  source_code_uri: https://github.com/kemalelmizan/context-drop
+  changelog_uri: https://github.com/kemalelmizan/context-drop/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Self-hosted contextual feedback engine, Shadow DOM widget, and MCP server
+  for Ruby on Rails.
+test_files: []