admin_suite 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbd2bda3cff05667e7f164b70d06c7f91e4ba7cde4dfe720291720fe589cfde6
-  data.tar.gz: c2fea65bd3721677eee67904174664038c9e256d347770775bbfc3a3714bceb2
+  metadata.gz: f761dd4e5538b7fb655ce9a29c936bfa57d1cf56e06d3aa73e064e4721ec69a9
+  data.tar.gz: e4a584d9645f7f848ad48c6f94a47ce34d9a9820cbe1c6271c635b17f1176719
 SHA512:
-  metadata.gz: 68580753a81e6e77b5a3cda22038f5d62919ab22e3bb00746504e18578847119528872f0bf94960c6d7d0df3ceb06a7df723ae872e8cce7d6d240fc0a5c08ab6
-  data.tar.gz: b342407db536c0cd5f7264aff7ea6fa57f224b03b66d2675b1b928394490ee743424ea7608ff9845e71e391765ecac7da0823e101b1922cea9c8613dae44c48a
+  metadata.gz: 9e0c72f5c7494b4a5378cd0895781bbbb41c8ed372788bf9cbcbeaa2830866f87c0636fce56872ee6998dbb516552f8bd105a828864ee29d7f23cc2ec77949e5
+  data.tar.gz: 4f2fc0a2d4d6edcb75ab99d7e888e8cd7abef38a9790e5ff45b74f8a8e6e9b6d7d657186776e2fc4132b59b051b21769ff966b2a33f050007505648116a74652

data/.gitignore

@@ -8,4 +8,5 @@
 !/test/dummy/log/.keep
 /test/dummy/tmp/
 /test/dummy/storage/
-admin_suite-*.gem
+admin_suite-*.gem
+/.bundle/

data/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to AdminSuite
+
+Thank you for your interest in contributing to AdminSuite!
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork locally
+3. Install dependencies: `bundle install`
+4. Run the test suite: `bundle exec rake test`
+5. (Optional) Run tests with coverage: `COVERAGE=true bundle exec rake test`
+
+## Development
+
+See `docs/development.md` for detailed information on:
+- Setting up your development environment
+- Running tests
+- Code style guidelines
+
+## Pull Requests
+
+1. Create a feature branch from `main`
+2. Make your changes
+3. Add or update tests as needed
+4. Ensure all tests pass: `bundle exec rake test`
+5. Push your branch and create a pull request
+
+### CI Checks
+
+All pull requests must pass the following checks before merging:
+- **Tests**: Automated test suite runs on Ruby 3.2 and 3.3
+- **Coverage**: Code coverage is automatically generated and uploaded to Codecov
+- **Code Review**: At least one maintainer approval required
+
+The CI workflow runs automatically on every pull request.
+
+## Releasing
+
+See `docs/releasing.md` for information on how releases are managed.
+
+Releases are automated via GitHub Actions when changes are merged to `main` with a version bump.
+
+### Required Secrets for Maintainers
+
+The repository requires the following secrets to be configured:
+- **`RUBYGEMS_API_KEY`**: Required for automated gem publishing to RubyGems
+- **`CODECOV_TOKEN`**: Optional, for uploading code coverage reports to Codecov (workflow continues without it)
+
+## Questions?
+
+Feel free to open an issue for questions or discussion.

data/docs/configuration.md

@@ -36,6 +36,12 @@ These are the defaults in `AdminSuite::Configuration` / `AdminSuite::Engine`:
   - `Rails.root/config/admin_suite/portals/*.rb`
   - `Rails.root/app/admin/portals/*.rb`
   - `Rails.root/app/admin_suite/portals/*.rb`
+
+Note: portal files are DSL side-effects (they don't define constants). If your host app
+autoloads `app/admin` as `Admin::*` with Zeitwerk, AdminSuite will ignore
+`app/admin/portals` for Zeitwerk to prevent eager-load `Zeitwerk::NameError`s.
+We recommend placing portal DSL files under `config/admin_suite/portals` or
+`app/admin_suite/portals` when possible.
 - `portals`: default portal metadata for `:ops`, `:email`, `:ai`, `:assistant`
 - `custom_renderers`: `{}`
 - `icon_renderer`: `nil` (uses lucide-rails by default when available)

data/docs/releasing.md

@@ -2,15 +2,39 @@
 
 This page is intended for maintainers publishing `admin_suite` to RubyGems.
 
-## Checklist
+## Automated Release Process (Recommended)
 
-1. Bump the version
+The gem is automatically published to RubyGems when changes are merged to `main`, provided the version has been bumped.
 
-- Update `lib/admin_suite/version.rb`
+### Steps
 
-2. Update changelog
+1. **Bump the version**
+   - Update `lib/admin_suite/version.rb`
+
+2. **Update changelog**
+   - Add an entry to `CHANGELOG.md`
+
+3. **Create a PR and get it merged**
+   - The CI workflow will run tests automatically on the PR
+   - Once merged to `main`, after CI passes, the publish workflow will:
+     - Check if the version already exists on RubyGems
+     - Build and publish the gem (if it's a new version)
+     - Create a Git tag for the release (if it doesn't already exist)
+
+### Requirements
+
+- The `RUBYGEMS_API_KEY` secret must be configured in the repository settings
+- The version in `lib/admin_suite/version.rb` must be unique (not already published)
 
-- Add an entry to `CHANGELOG.md`
+## Manual Release Process
+
+If you need to publish manually:
+
+1. Bump the version
+   - Update `lib/admin_suite/version.rb`
+
+2. Update changelog
+   - Add an entry to `CHANGELOG.md`
 
 3. Run tests and build the gem
 
@@ -19,7 +43,7 @@ bundle exec rake test
 gem build admin_suite.gemspec
 ```
 
-4. (Recommended) Tag the release
+4. Tag the release
 
 ```bash
 git tag -a "vX.Y.Z" -m "AdminSuite vX.Y.Z"
@@ -32,7 +56,10 @@ git push --tags
 gem push "admin_suite-X.Y.Z.gem"
 ```
 
-Notes:
+## Notes
 
-- RubyGems commonly requires MFA/OTP for pushes (this gem is configured with `rubygems_mfa_required`).
+- RubyGems commonly requires MFA/OTP for pushes (this gem is configured with `rubygems_mfa_required`)
+- The automated workflow uses a GitHub Actions bot to push tags
+- The publish workflow only runs after the CI workflow completes successfully
+- You can manually trigger the publish workflow from the GitHub Actions tab if needed
 

data/lib/admin_suite/engine.rb

@@ -14,14 +14,40 @@ module AdminSuite
     end
 
     initializer "admin_suite.host_dsl_ignore" do
-      # Host apps sometimes store AdminSuite DSL files under `app/admin_suite/**`.
-      # Those are not constant definitions, so we must prevent Zeitwerk from
-      # expecting constants like `Portals::Ai` during eager load.
-      host_dsl_dir = Rails.root.join("app/admin_suite")
-      next unless host_dsl_dir.exist?
+      # Host apps sometimes store AdminSuite DSL files under `app/admin_suite/**`
+      # and/or `app/admin/portals/**`.
+      #
+      # These are *side-effect* DSL files (e.g. `AdminSuite.portal :ops do ... end`),
+      # not constant definitions. If a host app adds those dirs to Zeitwerk (common
+      # when autoloading `app/admin` as `Admin::*`), eager loading will crash with:
+      #   expected file ... to define constant ...
+      #
+      # So we proactively ignore these directories for all Zeitwerk loaders.
+      host_dsl_dirs = [ Rails.root.join("app/admin_suite") ]
+
+      # `app/admin/portals` is a more common location in host apps and could also
+      # contain real constants. Only ignore it if it appears to contain AdminSuite
+      # portal DSL definitions.
+      host_admin_portals_dir = Rails.root.join("app/admin/portals")
+      if host_admin_portals_dir.exist?
+        portal_files = Dir[host_admin_portals_dir.join("**/*.rb").to_s]
+        contains_admin_suite_portals =
+          portal_files.any? do |file|
+            content = File.binread(file)
+            content = content.encode("UTF-8", invalid: :replace, undef: :replace, replace: "")
+            portal_dsl_pattern = /(::)?AdminSuite\s*\.\s*portal\b/
+            portal_dsl_pattern.match?(content)
+          rescue StandardError
+            false
+          end
+
+        host_dsl_dirs << host_admin_portals_dir if contains_admin_suite_portals
+      end
 
       Rails.autoloaders.each do |loader|
-        loader.ignore(host_dsl_dir)
+        host_dsl_dirs.each do |dir|
+          loader.ignore(dir) if dir.exist?
+        end
       end
     end
 

data/lib/admin_suite/version.rb

@@ -2,7 +2,7 @@
 
 module AdminSuite
   module Version
-    VERSION = "0.1.2"
+    VERSION = "0.2.0"
   end
 
   # Backward-compatible constant.

data/lib/admin_suite.rb

@@ -34,7 +34,10 @@ module AdminSuite
 
     # Defines (or updates) a portal using a Ruby DSL.
     #
-    # Host apps typically place these in `app/admin/portals/*.rb`.
+    # Host apps typically place these in:
+    # - `config/admin_suite/portals/*.rb` (recommended; not a Zeitwerk autoload path)
+    # - `app/admin_suite/portals/*.rb` (supported; AdminSuite ignores for Zeitwerk)
+    # - `app/admin/portals/*.rb` (supported; AdminSuite will ignore for Zeitwerk if files contain `AdminSuite.portal`)
     #
     # @param key [Symbol, String]
     # @yield Portal definition DSL

data/lib/generators/admin_suite/install/templates/admin_suite.rb

@@ -24,6 +24,11 @@ AdminSuite.configure do |config|
   # Files typically call `AdminSuite.portal :ops do ... end`
   config.portal_globs = [
     Rails.root.join("config/admin_suite/portals/*.rb").to_s,
+    # Prefer `app/admin_suite/portals` for DSL files so Zeitwerk never expects
+    # application constants (e.g. `Admin::Portals::OpsPortal` for
+    # `app/admin/portals/ops_portal.rb`) during eager load.
+    Rails.root.join("app/admin_suite/portals/*.rb").to_s,
+    # Legacy/fallback: still support portals defined under app/admin/portals.
     Rails.root.join("app/admin/portals/*.rb").to_s
   ]
 

data/test/lib/zeitwerk_integration_test.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require "test_helper"
+require "tmpdir"
+
+module AdminSuite
+  class ZeitwerkIntegrationTest < ActiveSupport::TestCase
+    setup do
+      @temp_dir = Dir.mktmpdir("admin_suite_test")
+    end
+
+    teardown do
+      FileUtils.rm_rf(@temp_dir) if @temp_dir && File.exist?(@temp_dir)
+    end
+
+    # Helper method to create a loader that tracks ignored directories
+    def create_tracked_loader
+      loader = Zeitwerk::Loader.new
+      ignored_dirs = []
+
+      loader.define_singleton_method(:ignore) do |path|
+        ignored_dirs << path.to_s
+      end
+
+      [loader, ignored_dirs]
+    end
+
+    # Helper method that simulates the Zeitwerk integration logic from engine.rb
+    def simulate_zeitwerk_integration(app_root, loader)
+      host_dsl_dirs = [app_root.join("app/admin_suite")]
+      host_admin_portals_dir = app_root.join("app/admin/portals")
+
+      if host_admin_portals_dir.exist?
+        portal_files = Dir[host_admin_portals_dir.join("**/*.rb").to_s]
+        contains_admin_suite_portals =
+          portal_files.any? do |file|
+            content = File.binread(file).encode("UTF-8", invalid: :replace, undef: :replace, replace: "")
+            content.include?("AdminSuite.portal")
+          rescue StandardError
+            false
+          end
+
+        host_dsl_dirs << host_admin_portals_dir if contains_admin_suite_portals
+      end
+
+      host_dsl_dirs.each do |dir|
+        loader.ignore(dir) if dir.exist?
+      end
+    end
+
+    test "ignores app/admin/portals when it contains AdminSuite portal DSL" do
+      # Create app/admin/portals directory with portal DSL file
+      portals_dir = File.join(@temp_dir, "app", "admin", "portals")
+      FileUtils.mkdir_p(portals_dir)
+      File.write(
+        File.join(portals_dir, "ops_portal.rb"),
+        "AdminSuite.portal :ops do\n  # portal config\nend"
+      )
+
+      # Create loader and simulate initializer logic
+      app_root = Pathname.new(@temp_dir)
+      loader, ignored_dirs = create_tracked_loader
+      simulate_zeitwerk_integration(app_root, loader)
+
+      # Verify that app/admin/portals was ignored
+      expected_path = app_root.join("app/admin/portals").to_s
+      assert_includes ignored_dirs, expected_path,
+                      "Expected app/admin/portals to be ignored when it contains AdminSuite portal DSL"
+    end
+
+    test "does not ignore app/admin/portals when it contains only real constants" do
+      # Create app/admin/portals directory with a real constant definition
+      portals_dir = File.join(@temp_dir, "app", "admin", "portals")
+      FileUtils.mkdir_p(portals_dir)
+      File.write(
+        File.join(portals_dir, "admin_user.rb"),
+        "module Admin\n  module Portals\n    class AdminUser\n    end\n  end\nend"
+      )
+
+      # Create loader and simulate initializer logic
+      app_root = Pathname.new(@temp_dir)
+      loader, ignored_dirs = create_tracked_loader
+      simulate_zeitwerk_integration(app_root, loader)
+
+      # Verify that app/admin/portals was NOT ignored
+      unexpected_path = app_root.join("app/admin/portals").to_s
+      assert_not_includes ignored_dirs, unexpected_path,
+                          "Expected app/admin/portals to NOT be ignored when it contains only real constants"
+    end
+
+    test "always ignores app/admin_suite directory when it exists" do
+      # Create app/admin_suite directory
+      admin_suite_dir = File.join(@temp_dir, "app", "admin_suite")
+      FileUtils.mkdir_p(admin_suite_dir)
+      File.write(
+        File.join(admin_suite_dir, "some_config.rb"),
+        "# Some DSL configuration"
+      )
+
+      # Create loader and simulate initializer logic
+      app_root = Pathname.new(@temp_dir)
+      loader, ignored_dirs = create_tracked_loader
+      simulate_zeitwerk_integration(app_root, loader)
+
+      # Verify that app/admin_suite was ignored
+      expected_path = app_root.join("app/admin_suite").to_s
+      assert_includes ignored_dirs, expected_path,
+                      "Expected app/admin_suite to always be ignored"
+    end
+
+    test "handles mixed content - ignores app/admin/portals if any file contains portal DSL" do
+      # Create app/admin/portals directory with both real constants and portal DSL
+      portals_dir = File.join(@temp_dir, "app", "admin", "portals")
+      FileUtils.mkdir_p(portals_dir)
+
+      # File with real constant
+      File.write(
+        File.join(portals_dir, "admin_user.rb"),
+        "module Admin\n  module Portals\n    class AdminUser\n    end\n  end\nend"
+      )
+
+      # File with portal DSL
+      File.write(
+        File.join(portals_dir, "ops_portal.rb"),
+        "AdminSuite.portal :ops do\n  # portal config\nend"
+      )
+
+      # Create loader and simulate initializer logic
+      app_root = Pathname.new(@temp_dir)
+      loader, ignored_dirs = create_tracked_loader
+      simulate_zeitwerk_integration(app_root, loader)
+
+      # Verify that app/admin/portals was ignored due to presence of portal DSL
+      expected_path = app_root.join("app/admin/portals").to_s
+      assert_includes ignored_dirs, expected_path,
+                      "Expected app/admin/portals to be ignored when any file contains portal DSL"
+    end
+
+    test "handles file read errors gracefully" do
+      # Create app/admin/portals directory with a file
+      portals_dir = File.join(@temp_dir, "app", "admin", "portals")
+      FileUtils.mkdir_p(portals_dir)
+      test_file = File.join(portals_dir, "test.rb")
+      File.write(test_file, "AdminSuite.portal :ops do; end")
+
+      # Create loader
+      app_root = Pathname.new(@temp_dir)
+      loader, ignored_dirs = create_tracked_loader
+
+      # Temporarily override File.binread to simulate read errors
+      original_binread = File.singleton_class.instance_method(:binread)
+      
+      File.singleton_class.define_method(:binread) do |path|
+        if path == test_file
+          raise StandardError, "Simulated read error"
+        else
+          original_binread.bind(File).call(path)
+        end
+      end
+
+      begin
+        # Simulate the initializer logic
+        simulate_zeitwerk_integration(app_root, loader)
+
+        # Verify that app/admin/portals was NOT ignored due to read error
+        unexpected_path = app_root.join("app/admin/portals").to_s
+        assert_not_includes ignored_dirs, unexpected_path,
+                            "Expected app/admin/portals to NOT be ignored when file read fails"
+      ensure
+        # Restore original method
+        File.singleton_class.define_method(:binread, original_binread)
+      end
+    end
+  end
+end

data/test/test_helper.rb

@@ -2,6 +2,19 @@
 
 ENV["RAILS_ENV"] ||= "test"
 
+# Configure SimpleCov for coverage reporting
+if ENV["COVERAGE"]
+  require "simplecov"
+  SimpleCov.start "rails" do
+    add_filter "/test/"
+    add_filter "/config/"
+    add_group "Models", "app/models"
+    add_group "Controllers", "app/controllers"
+    add_group "Helpers", "app/helpers"
+    add_group "Libraries", "lib"
+  end
+end
+
 require_relative "dummy/config/environment"
 require "minitest/autorun"
 require "active_support/test_case"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: admin_suite
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - TechWright Labs
 bindir: bin
 cert_chain: []
-date: 2026-02-07 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -115,6 +115,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -236,7 +237,6 @@ files:
 - test/dummy/config/puma.rb
 - test/dummy/config/routes.rb
 - test/dummy/db/seeds.rb
-- test/dummy/log/test.log
 - test/dummy/public/400.html
 - test/dummy/public/404.html
 - test/dummy/public/406-unsupported-browser.html
@@ -246,13 +246,13 @@ files:
 - test/dummy/public/icon.svg
 - test/dummy/public/robots.txt
 - test/dummy/test/test_helper.rb
-- test/dummy/tmp/local_secret.txt
 - test/fixtures/docs/progress/PROGRESS_REPORT.md
 - test/integration/dashboard_test.rb
 - test/integration/docs_test.rb
 - test/integration/theme_test.rb
 - test/lib/markdown_renderer_test.rb
 - test/lib/theme_palette_test.rb
+- test/lib/zeitwerk_integration_test.rb
 - test/test_helper.rb
 homepage: https://github.com/techwright-lab/admin_suite
 licenses:
@@ -275,7 +275,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Reusable admin suite engine
 test_files: []

data/test/dummy/log/test.log

@@ -1,147 +0,0 @@
-------------------------------------------------------------------
-AdminSuite::ThemeTest: test_layout_includes_scoped_theme_variables
-------------------------------------------------------------------
-Started GET "/internal/admin_suite" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DashboardController#index as HTML
-  Rendering layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb
-  Rendering /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/dashboard/index.html.erb within layouts/admin_suite/application
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.2ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_cards.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.2ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.3ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/dashboard/index.html.erb within layouts/admin_suite/application (Duration: 13.9ms | GC: 9.4ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.8ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_topbar.html.erb (Duration: 0.1ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_flash.html.erb (Duration: 1.1ms | GC: 0.0ms)
-  Rendered layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb (Duration: 18.4ms | GC: 9.5ms)
-Completed 200 OK in 28ms (Views: 19.8ms | GC: 9.7ms)
------------------------------------------------------------------
-AdminSuite::ThemeTest: test_body_is_scoped_with_admin-suite_class
------------------------------------------------------------------
-Started GET "/internal/admin_suite" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DashboardController#index as HTML
-  Rendering layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb
-  Rendering /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/dashboard/index.html.erb within layouts/admin_suite/application
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_cards.html.erb (Duration: 0.1ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/dashboard/index.html.erb within layouts/admin_suite/application (Duration: 0.7ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.6ms | GC: 0.1ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_topbar.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_flash.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb (Duration: 1.9ms | GC: 0.1ms)
-Completed 200 OK in 2ms (Views: 2.0ms | GC: 0.1ms)
------------------------------------------------------------------------------------
-AdminSuite::ThemePaletteTest: test_resolve_returns_fallback_for_unknown_color/shade
------------------------------------------------------------------------------------
---------------------------------------------------------------------------------
-AdminSuite::ThemePaletteTest: test_resolve_returns_hex_for_known_palette_entries
---------------------------------------------------------------------------------
-------------------------------------------------------------
-AdminSuite::ThemePaletteTest: test_hex?_validates_hex_colors
-------------------------------------------------------------
----------------------------------------------------------------------------
-AdminSuite::DashboardTest: test_GET_/internal/admin_suite_renders_dashboard
----------------------------------------------------------------------------
-Started GET "/internal/admin_suite" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DashboardController#index as HTML
-  Rendering layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb
-  Rendering /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/dashboard/index.html.erb within layouts/admin_suite/application
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_health.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_cards.html.erb (Duration: 0.1ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_stat.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/panels/_recent.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/dashboard/index.html.erb within layouts/admin_suite/application (Duration: 0.6ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_topbar.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_flash.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb (Duration: 1.7ms | GC: 0.0ms)
-Completed 200 OK in 2ms (Views: 1.8ms | GC: 0.0ms)
-----------------------------------------------------------------------------------
-AdminSuite::MarkdownRendererTest: test_renders_html_and_extracts_toc_from_headings
-----------------------------------------------------------------------------------
--------------------------------------------------------------------------
-AdminSuite::DocsTest: test_docs_path_config_can_be_overridden_with_a_proc
--------------------------------------------------------------------------
-Started GET "/internal/admin_suite/docs" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DocsController#index as HTML
-  Rendering layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb
-  Rendering /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/docs/index.html.erb within layouts/admin_suite/application
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/docs/index.html.erb within layouts/admin_suite/application (Duration: 0.2ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_topbar.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_flash.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb (Duration: 1.3ms | GC: 0.0ms)
-Completed 200 OK in 2ms (Views: 1.4ms | GC: 0.0ms)
-------------------------------------------------------------------------------
-AdminSuite::DocsTest: test_GET_/internal/admin_suite/docs_renders_successfully
-------------------------------------------------------------------------------
-Started GET "/internal/admin_suite/docs" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DocsController#index as HTML
-  Rendering layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb
-  Rendering /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/docs/index.html.erb within layouts/admin_suite/application
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/docs/index.html.erb within layouts/admin_suite/application (Duration: 0.1ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_topbar.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_flash.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb (Duration: 1.2ms | GC: 0.0ms)
-Completed 200 OK in 2ms (Views: 1.2ms | GC: 0.0ms)
------------------------------------------------------
-AdminSuite::DocsTest: test_docs_blocks_path_traversal
------------------------------------------------------
-Started GET "/internal/admin_suite/docs/../../secrets.md" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DocsController#show as MD
-  Parameters: {"path" => "../../secrets.md"}
-Redirected to http://www.example.com/internal/admin_suite/docs/
-Completed 302 Found in 0ms (GC: 0.0ms)
----------------------------------------------------------------------------------------
-AdminSuite::DocsTest: test_GET_/internal/admin_suite/docs/<path>_renders_a_markdown_doc
----------------------------------------------------------------------------------------
-Started GET "/internal/admin_suite/docs/progress/PROGRESS_REPORT.md" for 127.0.0.1 at 2026-02-05 00:05:41 +0100
-Processing by AdminSuite::DocsController#show as MD
-  Parameters: {"path" => "progress/PROGRESS_REPORT.md"}
-  Rendering layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb
-  Rendering /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/docs/index.html.erb within layouts/admin_suite/application
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/docs/index.html.erb within layouts/admin_suite/application (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 0.4ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_sidebar.html.erb (Duration: 4.1ms | GC: 3.6ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_topbar.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered /Users/ravi/projects/techwright/admin_suite_repo/app/views/admin_suite/shared/_flash.html.erb (Duration: 0.0ms | GC: 0.0ms)
-  Rendered layout /Users/ravi/projects/techwright/admin_suite_repo/app/views/layouts/admin_suite/application.html.erb (Duration: 4.9ms | GC: 3.6ms)
-Completed 200 OK in 5ms (Views: 5.0ms | GC: 3.6ms)

data/test/dummy/tmp/local_secret.txt

@@ -1 +0,0 @@
-779b8d659160590188c0642593c35a5df6e84bf258fa58b6e8d5e8ccfa620a8c36e911e98a2736ebfd699b1359e726ab30c27ab8a6ef25ed10d9fadacaff451f