parapet-rails 0.1.0

data/db/parapet_migrate/20260929184300_create_parapet_sessions.rb

@@ -0,0 +1,9 @@
+class CreateParapetSessions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :sessions do |t|
+      t.references :user, null: false, foreign_key: true
+
+      t.timestamps
+    end
+  end
+end

data/db/parapet_migrate/20260930000000_create_parapet_runtime_settings.rb

@@ -0,0 +1,12 @@
+class CreateParapetRuntimeSettings < ActiveRecord::Migration[8.1]
+  def change
+    create_table :runtime_settings do |t|
+      t.string :setting_key, null: false
+      t.text :value, null: false
+
+      t.timestamps
+    end
+
+    add_index :runtime_settings, :setting_key, unique: true
+  end
+end

data/db/parapet_migrate/20260930000100_create_parapet_suite_assignments.rb

@@ -0,0 +1,14 @@
+class CreateParapetSuiteAssignments < ActiveRecord::Migration[8.1]
+  def change
+    create_table :suite_assignments do |t|
+      t.references :user, null: false, foreign_key: true
+      t.string :suite, null: false
+      t.string :role, limit: 64
+      t.string :tier, null: false, default: "novice"
+
+      t.timestamps
+    end
+
+    add_index :suite_assignments, [ :user_id, :suite ], unique: true
+  end
+end

data/db/parapet_migrate/20261002000000_create_parapet_activities.rb

@@ -0,0 +1,16 @@
+class CreateParapetActivities < ActiveRecord::Migration[8.1]
+  def change
+    create_table :activities do |t|
+      t.references :user, foreign_key: true
+      t.string :activity_type, null: false
+      t.string :action, null: false
+      t.string :performed_via, null: false, default: "human"
+      t.references :trackable, polymorphic: true
+      t.json :details, null: false, default: {}
+
+      t.timestamps
+    end
+
+    add_index :activities, [ :activity_type, :action ]
+  end
+end

data/db/parapet_migrate/20261002000100_create_parapet_draft_recoveries.rb

@@ -0,0 +1,13 @@
+class CreateParapetDraftRecoveries < ActiveRecord::Migration[8.1]
+  def change
+    create_table :draft_recoveries do |t|
+      t.references :user, null: false, foreign_key: true
+      t.string :file_path, null: false
+      t.text :content, null: false, default: ""
+
+      t.timestamps
+    end
+
+    add_index :draft_recoveries, [ :user_id, :file_path ], unique: true
+  end
+end

data/db/parapet_schema.rb

@@ -0,0 +1,64 @@
+ActiveRecord::Schema[8.1].define(version: 2026_10_02_000100) do
+  create_table "activities", force: :cascade do |t|
+    t.string "activity_type", null: false
+    t.string "action", null: false
+    t.string "performed_via", default: "human", null: false
+    t.integer "trackable_id"
+    t.string "trackable_type"
+    t.json "details", default: {}, null: false
+    t.integer "user_id"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["activity_type", "action"], name: "index_activities_on_activity_type_and_action"
+    t.index ["trackable_type", "trackable_id"], name: "index_activities_on_trackable"
+    t.index ["user_id"], name: "index_activities_on_user_id"
+  end
+
+  create_table "draft_recoveries", force: :cascade do |t|
+    t.integer "user_id", null: false
+    t.string "file_path", null: false
+    t.text "content", default: "", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["user_id", "file_path"], name: "index_draft_recoveries_on_user_id_and_file_path", unique: true
+    t.index ["user_id"], name: "index_draft_recoveries_on_user_id"
+  end
+  create_table "runtime_settings", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.string "setting_key", null: false
+    t.datetime "updated_at", null: false
+    t.text "value", null: false
+    t.index ["setting_key"], name: "index_runtime_settings_on_setting_key", unique: true
+  end
+
+  create_table "sessions", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.integer "user_id", null: false
+    t.index ["user_id"], name: "index_sessions_on_user_id"
+  end
+
+  create_table "suite_assignments", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.string "role", limit: 64
+    t.string "suite", null: false
+    t.string "tier", default: "novice", null: false
+    t.datetime "updated_at", null: false
+    t.integer "user_id", null: false
+    t.index ["user_id", "suite"], name: "index_suite_assignments_on_user_id_and_suite", unique: true
+    t.index ["user_id"], name: "index_suite_assignments_on_user_id"
+  end
+
+  create_table "users", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.string "email_address", null: false
+    t.string "password_digest", null: false
+    t.datetime "updated_at", null: false
+    t.index ["email_address"], name: "index_users_on_email_address", unique: true
+  end
+
+  add_foreign_key "activities", "users"
+  add_foreign_key "draft_recoveries", "users"
+  add_foreign_key "sessions", "users"
+  add_foreign_key "suite_assignments", "users"
+end

data/db/schema.rb

@@ -0,0 +1,21 @@
+# Parapet Schema VCS — HEAD
+# This file is the source of truth for the run-history database.
+# Edit directly, then run db:rebuild.
+
+ActiveRecord::Schema[7.1].define(version: 2026_10_02_000000) do
+  create_table "run_history", force: :cascade do |t|
+    t.string "run_type", null: false
+    t.string "command", null: false
+    t.string "status", null: false
+    t.integer "exit_code"
+    t.text "raw_output"
+    t.string "triggered_by_actor_type", null: false
+    t.integer "user_id"
+    t.string "performed_via", default: "human", null: false
+    t.datetime "started_at", null: false
+    t.datetime "finished_at"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["user_id"], name: "index_run_history_on_user_id"
+  end
+end

data/lib/parapet/engine.rb

@@ -0,0 +1,11 @@
+require "parapet/environment_guard"
+require "turbo-rails"
+require "sass-embedded"
+
+module Parapet
+  class Engine < ::Rails::Engine
+    EnvironmentGuard.verify!(::Rails.env)
+
+    isolate_namespace Parapet
+  end
+end

data/lib/parapet/environment_guard.rb

@@ -0,0 +1,14 @@
+module Parapet
+  class EnvironmentError < StandardError; end
+
+  module EnvironmentGuard
+    ALLOWED_ENVIRONMENTS = %w[development test].freeze
+
+    def self.verify!(env)
+      environment = env.to_s
+      return if ALLOWED_ENVIRONMENTS.include?(environment)
+
+      raise EnvironmentError, "Parapet can only run in development or test (current environment: #{environment})"
+    end
+  end
+end

data/lib/parapet/version.rb

@@ -0,0 +1,3 @@
+module Parapet
+  VERSION = "0.1.0"
+end

data/lib/parapet-rails.rb

@@ -0,0 +1 @@
+require "parapet"

data/lib/parapet.rb

@@ -0,0 +1,59 @@
+require "parapet/version"
+require "parapet/engine"
+require "qss"
+# Parapet is a QSS consumer: its QSS settings (prefix, palette extras, registry, ...) live in its own config file.
+QSS.configure(root: File.expand_path("..", __dir__), config: "config/parapet/qss_config.yml")
+require "sass-embedded"
+require "turbo-rails"
+require "ostruct"
+
+module Parapet
+  class << self
+    attr_accessor :test_framework
+    attr_writer :test_root
+    attr_writer :mount_subdomain
+
+    def configure
+      yield self
+    end
+
+    def test_framework
+      @test_framework || :rspec
+    end
+
+    def test_framework=(val)
+      @test_framework = val
+    end
+
+    def test_root=(val)
+      @test_root = val
+    end
+
+    def test_root
+      @test_root || default_test_root
+    end
+
+    # The subdomain Parapet's engine is mounted under, e.g. "parapet" or, for a host
+    # app that already lives on its own subdomain, a compound value like "parapet.sub".
+    # Priority: ENV var (12-factor/container-friendly) > Ruby config (set via
+    # Parapet.configure, e.g. from a host app's config/initializers/parapet.rb) >
+    # the "parapet" default. The engine's mount constraint and the request-time
+    # subdomain check both read this single method so they can never drift apart.
+    def mount_subdomain
+      ENV["PARAPET_SUBDOMAIN"] || @mount_subdomain || "parapet"
+    end
+
+    private
+
+    def default_test_root
+      case (test_framework || :rspec).to_sym
+      when :rspec
+        "spec"
+      else
+        "test"
+      end
+    end
+  end
+
+  self.test_framework = :rspec
+end

data/lib/tasks/parapet_qss.rake

@@ -0,0 +1,26 @@
+# Parapet's QSS tasks. QSS itself is the qss gem (in this repo at qss/); these tasks apply Parapet's settings to it.
+namespace :parapet do
+  namespace :qss do
+    parapet_root = File.expand_path("../..", __dir__)
+
+    desc "Compile Parapet's stylesheet: its QSS settings, QSS core (from the qss gem), then Parapet's own rules"
+    task :compile do
+      require "qss"
+      require "sass-embedded"
+      stylesheets = File.join(parapet_root, "app", "assets", "stylesheets")
+      input = File.join(stylesheets, "parapet", "qss_application.scss")
+      output = File.join(stylesheets, "parapet", "qss_application.css")
+      File.write(output, Sass.compile(input, load_paths: [ stylesheets, QSS.stylesheets_path ]).css)
+      puts "Compiled #{output}"
+    end
+
+    desc "Regenerate QSS's generated files with Parapet's config (config/parapet/qss_config.yml)"
+    task :sync do
+      require "qss"
+      require "rbconfig"
+      Dir.chdir(parapet_root) do
+        sh({ "QSS_CONSUMER_CONFIG" => "config/parapet/qss_config.yml" }, RbConfig.ruby, File.join(QSS.root, "exe", "qss-sync"))
+      end
+    end
+  end
+end

data/lib/tasks/parapet_tasks.rake

@@ -0,0 +1,25 @@
+namespace :parapet do
+  desc "Run RSpec and Cucumber to verify the codebase before landing changes"
+  task publish: :environment do
+    puts "Starting Parapet Publish Gate..."
+    result = Parapet::PublishGate.new(triggered_by_actor_type: "human").run
+
+    if result.passed?
+      puts "\n✅ PUBLISH PASSED"
+      puts result.run_history.raw_output
+      exit 0
+    else
+      puts "\n❌ PUBLISH FAILED (Exit Code: #{result.run_history.exit_code})"
+      puts "--------------------------------------------------------------------------------"
+      puts result.run_history.raw_output
+      puts "--------------------------------------------------------------------------------"
+      exit result.run_history.exit_code || 1
+    end
+  end
+
+  namespace :db do
+    task migrate: :environment do
+      Parapet::InternalRecord.migrate!
+    end
+  end
+end

data/lib/tasks/randomize_explorer_health.rb

@@ -0,0 +1,101 @@
+require 'json'
+
+def randomize_status
+  # Large percentage red or green, some amber, few grey
+  # red: 35%, green: 40%, orange (amber): 15%, grey: 10%
+  r = rand(100)
+  if r < 35
+    'red'
+  elsif r < 75
+    'green'
+  elsif r < 90
+    'orange'
+  else
+    'grey'
+  end
+end
+
+def process_node(node, is_top_level = false)
+  if node['type'] == 'file'
+    node['status'] = randomize_status
+    return {
+      'counts' => { node['status'] => 1 },
+      'file_count' => 1,
+      'sub_folder_count' => 0
+    }
+  end
+
+  # It's a directory
+  total_counts = { 'red' => 0, 'green' => 0, 'orange' => 0, 'grey' => 0 }
+  total_files = 0
+  sub_folders = 0
+
+  if node['children']
+    node['children'].each do |child|
+      sub_folders += 1 if child['type'] == 'directory'
+      result = process_node(child, false)
+      result['counts'].each { |status, count| total_counts[status] += count }
+      total_files += result['file_count']
+    end
+  end
+
+  # Calculate health percentages
+  if total_files > 0
+    health = {}
+    total_counts.each do |status, count|
+      percent = (count.to_f / total_files * 100).round
+      health[status] = percent if percent > 0
+    end
+
+    # Enforce constraints
+    show_health = false
+    if is_top_level
+      # display only if it contains >= 5 files total OR > 2 sub-folders
+      show_health = true if total_files >= 5 || sub_folders > 2
+    else
+      # sub-folders: display only if it contains >= 3 files
+      show_health = true if total_files >= 3
+    end
+
+    if show_health
+      node['health'] = health
+    else
+      node.delete('health')
+    end
+  else
+    node.delete('health')
+  end
+
+  {
+    'counts' => total_counts,
+    'file_count' => total_files,
+    'sub_folder_count' => sub_folders
+  }
+end
+
+# Process all seed files
+Dir.glob(File.expand_path("../../storage/seeds-*-explorer.json", __dir__)).each do |file_path|
+  puts "Processing #{file_path}..."
+  data = JSON.parse(File.read(file_path))
+
+  global_counts = { 'red' => 0, 'green' => 0, 'orange' => 0, 'grey' => 0 }
+  global_files = 0
+
+  # Root itself is not shown usually, so we process its children as top-level
+  if data['children']
+    data['children'].each do |top_level_node|
+      result = process_node(top_level_node, true)
+      result['counts'].each { |status, count| global_counts[status] += count }
+      global_files += result['file_count']
+    end
+  end
+
+  data['summary'] = {
+    'counts' => global_counts,
+    'total_files' => global_files
+  }
+
+  File.write(file_path, JSON.pretty_generate(data))
+end
+
+puts "Done!"