postnhost 0.1.0 → 0.2.0

data/app/views/postnhost/templates/edit.html.erb

@@ -55,7 +55,7 @@
               <p class="text-sm leading-6 text-gray-600">If your changes add new Tailwind classes, install and run the optional host Tailwind pipeline:</p>
               <div class="space-y-1">
                 <code class="block overflow-x-auto rounded-lg bg-gray-900 px-3 py-2 text-xs leading-5 text-white">bin/rails g postnhost:tailwindcss:install</code>
-                <code class="block overflow-x-auto rounded-lg bg-gray-900 px-3 py-2 text-xs leading-5 text-white">bundle exec rails postnhost:tailwindcss:watch</code>
+                <code class="block overflow-x-auto rounded-lg bg-gray-900 px-3 py-2 text-xs leading-5 text-white">bin/rails postnhost:tailwindcss:watch</code>
               </div>
             </div>
           </div>

data/config/routes.rb

@@ -33,6 +33,7 @@ Postnhost::Engine.routes.draw do
   end
 
   # Admin routes
+  resources :api_tokens, only: %i[index create destroy]
   resource :onboarding, only: %i[show update], controller: "onboarding"
   resource :session, only: %i[new create destroy], controller: "sessions"
   resources :users, only: %i[index new create edit update destroy] do
@@ -106,6 +107,17 @@ Postnhost::Engine.routes.draw do
     resources :site_scripts, only: %i[create update destroy], controller: "settings/site_scripts"
   end
 
+  # Management API and MCP
+  namespace :api do
+    namespace :v1 do
+      get "openapi", to: "commands#schema", as: :openapi
+      get "commands", to: "commands#index", as: :commands
+      post "commands/:command", to: "commands#create", as: :command
+      post "mcp", to: "mcp#create", as: :mcp
+      match "mcp", to: "mcp#unsupported", via: %i[get delete]
+    end
+  end
+
   # Public static pages from host app views:
   # app/views/postnhost/static_pages/*.html.erb
   get "/:slug", to: "public/static_pages#show", as: :public_static_page

data/db/migrate/20261008120000_create_api_tokens.rb

@@ -0,0 +1,12 @@
+class CreateApiTokens < ActiveRecord::Migration[7.2]
+  def change
+    create_table :postnhost_api_tokens do |t|
+      t.references :user, null: false, foreign_key: { to_table: :postnhost_users }
+      t.string :name, null: false
+      t.string :token_digest, null: false
+      t.datetime :revoked_at
+      t.timestamps
+    end
+    add_index :postnhost_api_tokens, :token_digest, unique: true
+  end
+end

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

@@ -5,7 +5,7 @@ module Postnhost
 
       source_root File.expand_path("templates", __dir__)
 
-      desc "Creates Postnhost initializer and mounts the engine"
+      desc "Creates the PostnHost initializer and mounts the engine"
 
       def create_initializer
         template "postnhost.rb", "config/initializers/postnhost.rb"
@@ -24,7 +24,7 @@ module Postnhost
       def show_post_install
         say ""
         say "=" * 60
-        say "Postnhost has been installed!", :green
+        say "PostnHost has been installed!", :green
         say "=" * 60
         say ""
         say "Next steps:"
@@ -32,23 +32,22 @@ module Postnhost
         say "     bin/rails postnhost:install:migrations"
         say "     bin/rails db:migrate"
         say ""
-        say "  2. Open first-time setup in the browser:"
-        say "     http://localhost:3000#{DEFAULT_MOUNT_PATH}/onboarding"
+        say "  2. Open first-time setup in your app:"
+        say "     #{DEFAULT_MOUNT_PATH}/onboarding"
         say "     Or create a CMS user interactively: bin/rails g postnhost:user"
         say ""
-        say "  3. Update config/initializers/postnhost.rb with your site settings."
+        say "  3. Review config/initializers/postnhost.rb for optional defaults, production uploads, and AI translations."
         say ""
         say "  4. (Optional) Customize public views:"
-        say "     rails g postnhost:views --views-scope=minimal"
-        say "     # or"
-        say "     rails g postnhost:views --views-scope=full"
+        say "     bin/rails g postnhost:views --views-scope=minimal"
+        say "     or"
+        say "     bin/rails g postnhost:views --views-scope=full"
         say ""
-        say "  5. (Optional) Enable host Tailwind pipeline for custom Postnhost classes:"
-        say "     rails g postnhost:tailwindcss:install"
-        say "     bundle exec rails postnhost:tailwindcss:watch"
+        say "  5. (Optional) Enable host Tailwind support for custom PostnHost classes:"
+        say "     bin/rails g postnhost:tailwindcss:install"
         say ""
         say "  6. (Optional) Add a new public locale (copy English strings into your app):"
-        say "     rails g postnhost:locale sv"
+        say "     bin/rails g postnhost:locale sv"
         say ""
       end
     end

data/lib/generators/postnhost/locale/locale_generator.rb

@@ -5,7 +5,7 @@ module Postnhost
     class LocaleGenerator < Rails::Generators::Base
       argument :locale, type: :string, desc: "Locale code to match Language#html_lang (e.g. sv, pt-BR)"
 
-      desc "Copies Postnhost English locale (en.yml) to config/locales/<locale>.yml in your app for translation."
+      desc "Copies the PostnHost English locale (en.yml) to config/locales/<locale>.yml in your app for translation."
 
       def copy_postnhost_locale
         code = locale.to_s.strip

data/lib/generators/postnhost/static_pages/static_pages_generator.rb

@@ -7,7 +7,7 @@ module Postnhost
 
       def create_static_pages
         if slugs.empty?
-          say("Please provide at least one page slug, e.g. rails g postnhost:static_pages terms privacy", :red)
+          say("Please provide at least one page slug, e.g. bin/rails g postnhost:static_pages terms privacy", :red)
           return
         end
 

data/lib/generators/postnhost/tailwindcss/install_generator.rb

@@ -7,19 +7,12 @@ module Postnhost
         source_root File.expand_path("templates", __dir__)
 
         namespace "postnhost:tailwindcss:install"
-        desc "Install host Tailwind pipeline for Postnhost view overrides."
+        desc "Install host Tailwind support for PostnHost view overrides."
 
         def create_stylesheet_directory
           empty_directory "app/assets/stylesheets/postnhost"
         end
 
-        def create_tailwind_config
-          path = Rails.root.join("postnhost.tailwind.config.js")
-          return if path.exist?
-
-          copy_file "tailwind.config.js", path
-        end
-
         def create_host_stylesheet
           path = Rails.root.join("app/assets/stylesheets/postnhost/host.tailwind.css")
           return if path.exist?
@@ -31,12 +24,14 @@ module Postnhost
           path = Rails.root.join("package.json")
           return say_package_json_instructions unless path.exist?
 
+          @package_json_present = true
+
           json_data = JSON.parse(File.read(path))
           json_data["scripts"] ||= {}
           json_data["devDependencies"] ||= {}
 
-          json_data["scripts"]["postnhost:tailwindcss"] = tailwind_build_command
-          json_data["scripts"]["postnhost:tailwindcss:watch"] = "#{tailwind_build_command} --watch"
+          json_data["scripts"]["postnhost:tailwindcss"] = "bundle exec rails postnhost:tailwindcss:build"
+          json_data["scripts"]["postnhost:tailwindcss:watch"] = "bundle exec rails postnhost:tailwindcss:watch"
 
           ensure_dependency(json_data, "tailwindcss", "^4.1.12")
           ensure_dependency(json_data, "@tailwindcss/cli", "^4.1.12")
@@ -44,8 +39,7 @@ module Postnhost
 
           File.write(path, "#{JSON.pretty_generate(json_data)}\n")
 
-          say "Updated package.json script:", :green
-          say "  yarn postnhost:tailwindcss:watch"
+          say "Updated package.json with PostnHost Tailwind scripts and dependencies.", :green
         end
 
         def wire_procfile_dev
@@ -54,32 +48,41 @@ module Postnhost
 
           if path.exist?
             if File.read(path).include?("postnhost:tailwindcss:watch")
-              say "Procfile.dev already includes Postnhost watcher.", :green
+              say "Procfile.dev already includes the PostnHost watcher.", :green
             else
               append_to_file path, "\n#{entry}\n"
-              say "Added Postnhost watcher to Procfile.dev.", :green
+              say "Added the PostnHost watcher to Procfile.dev.", :green
             end
           else
             create_file "Procfile.dev", "#{entry}\n"
-            say "Created Procfile.dev with Postnhost watcher.", :green
+            say "Created Procfile.dev with the PostnHost watcher.", :green
           end
         end
 
         def print_next_steps
           say ""
-          say "Postnhost host-tailwind mode installed.", :green
+          say "PostnHost host Tailwind support installed.", :green
           say "Next steps:"
-          say "  1. Run bin/dev (Postnhost watcher is wired in Procfile.dev)."
-          say "  2. Keep default layout tags; Postnhost auto-loads postnhost/host when config is present."
+          step = 1
+
+          if @package_json_present
+            say "  #{step}. Install dependencies with the JavaScript package manager used by this app."
+            step += 1
+          end
+
+          if Rails.root.join("bin/dev").exist?
+            say "  #{step}. Run bin/dev; the PostnHost watcher is wired in Procfile.dev."
+          else
+            say "  #{step}. Run bin/rails postnhost:tailwindcss:watch alongside your Rails server."
+          end
+
+          say "  #{step + 1}. Use normal Tailwind classes in copied PostnHost views."
+          say "  #{step + 2}. Keep the default layout tags; the combined build overrides postnhost/application automatically."
           say ""
         end
 
         private
 
-        def tailwind_build_command
-          "./node_modules/.bin/tailwindcss -i ./app/assets/stylesheets/postnhost/host.tailwind.css -o ./app/assets/builds/postnhost/host.css -c ./postnhost.tailwind.config.js --minify"
-        end
-
         def ensure_dependency(json_data, package_name, version)
           return if json_data["dependencies"]&.key?(package_name) || json_data["devDependencies"].key?(package_name)
 
@@ -87,9 +90,9 @@ module Postnhost
         end
 
         def say_package_json_instructions
-          say "package.json not found. Add these scripts manually:", :yellow
-          say "  \"postnhost:tailwindcss\": \"#{tailwind_build_command}\""
-          say "  \"postnhost:tailwindcss:watch\": \"#{tailwind_build_command} --watch\""
+          say "package.json not found. Add a Tailwind CSS 4 compiler to the host Gemfile:", :yellow
+          say '  gem "tailwindcss-ruby", "~> 4.0"'
+          say "Then run bundle install."
         end
       end
     end

data/lib/generators/postnhost/tailwindcss/templates/host.tailwind.css

@@ -1,6 +1,3 @@
-@import "tailwindcss";
-@plugin "@tailwindcss/typography";
-
 @source "../../../views/postnhost/**/*.erb";
 @source "../../../views/layouts/postnhost/**/*.erb";
 @source "../../../helpers/**/*.rb";

data/lib/generators/postnhost/user/user_generator.rb

@@ -1,7 +1,7 @@
 module Postnhost
   module Generators
     class UserGenerator < Rails::Generators::Base
-      desc "Interactively creates a Postnhost CMS user"
+      desc "Interactively creates a PostnHost CMS user"
 
       def create_user
         attributes = prompt_for_user_attributes

data/lib/generators/postnhost/views/views_generator.rb

@@ -1,7 +1,7 @@
 module Postnhost
   module Generators
     class ViewsGenerator < Rails::Generators::Base
-      desc "Copies public Postnhost views to your application for customization"
+      desc "Copies public PostnHost views to your application for customization"
       class_option :views_scope,
                    type: :string,
                    required: true,
@@ -28,7 +28,7 @@ module Postnhost
         copy_file "layouts/postnhost/public_header/_dashboard_sign_in.html.erb", "app/views/layouts/postnhost/public_header/_dashboard_sign_in.html.erb"
         say ""
         warn_if_host_tailwind_not_installed
-        say "Public views copied (#{views_scope})! Full scope includes every public template and layout under app/views/postnhost/public/templates/ and app/views/layouts/postnhost/public/templates/.", :green
+        say views_scope == "full" ? "All public templates and layouts were copied." : "The minimal public view set was copied.", :green
       end
 
       def engine_views_path
@@ -123,15 +123,13 @@ module Postnhost
       def warn_if_host_tailwind_not_installed
         return if host_tailwind_enabled?
 
-        say "Tip: if you add new Tailwind classes in copied views, install host pipeline:", :yellow
-        say "  rails g postnhost:tailwindcss:install"
-        say "  bundle exec rails postnhost:tailwindcss:watch"
+        say "Tip: if you add new Tailwind classes in copied views, install host Tailwind support:", :yellow
+        say "  bin/rails g postnhost:tailwindcss:install"
         say ""
       end
 
       def host_tailwind_enabled?
-        Rails.root.join("postnhost.tailwind.config.js").exist? &&
-          Rails.root.join("app/assets/stylesheets/postnhost/host.tailwind.css").exist?
+        Rails.root.join("app/assets/stylesheets/postnhost/host.tailwind.css").exist?
       end
 
       def source_paths

data/lib/postnhost/css_build.rb

@@ -0,0 +1,68 @@
+require "English"
+require "fileutils"
+
+require_relative "css_scope"
+
+module Postnhost
+  class CssBuild
+    POLL_INTERVAL = 0.1
+
+    class << self
+      def run(command:, unscoped_path:, output_path:, watch: false)
+        FileUtils.rm_f(unscoped_path)
+
+        if watch
+          watch(command:, unscoped_path:, output_path:)
+        else
+          system(*command, exception: true)
+          CssScope.scope_file(unscoped_path, output_path)
+        end
+      ensure
+        FileUtils.rm_f(unscoped_path)
+      end
+
+      private
+
+      def watch(command:, unscoped_path:, output_path:)
+        process_id = Process.spawn(*command)
+        applied_signature = nil
+        pending_signature = nil
+
+        loop do
+          process_status = Process.waitpid(process_id, Process::WNOHANG)
+          signature = file_signature(unscoped_path)
+
+          if signature && signature == pending_signature && signature != applied_signature
+            CssScope.scope_file(unscoped_path, output_path)
+            applied_signature = signature
+          end
+
+          pending_signature = signature
+          break if process_status
+
+          sleep POLL_INTERVAL
+        end
+
+        raise "Tailwind CSS watcher exited unsuccessfully" unless $CHILD_STATUS.success?
+      ensure
+        terminate(process_id)
+      end
+
+      def file_signature(path)
+        return unless File.exist?(path)
+
+        stat = File.stat(path)
+        [stat.mtime.to_f, stat.size]
+      end
+
+      def terminate(process_id)
+        return unless process_id
+
+        Process.kill("TERM", process_id)
+        Process.wait(process_id)
+      rescue Errno::ESRCH, Errno::ECHILD
+        nil
+      end
+    end
+  end
+end

data/lib/postnhost/css_scope.rb

@@ -0,0 +1,77 @@
+require "crass"
+require "fileutils"
+
+module Postnhost
+  class CssScope
+    ROOT_SELECTOR = "html[data-postnhost]"
+    ROOT_OR_DESCENDANT_SELECTOR = ":is(#{ROOT_SELECTOR}, #{ROOT_SELECTOR} *)"
+    GROUP_AT_RULES = %w[container layer media starting-style supports].freeze
+
+    class << self
+      def call(css)
+        rules = Crass::Parser.parse_stylesheet(css, preserve_comments: true)
+        scope_rules(rules)
+        Crass::Parser.stringify(rules)
+      end
+
+      def scope_file(input_path, output_path = input_path)
+        output_path = File.expand_path(output_path)
+        FileUtils.mkdir_p(File.dirname(output_path))
+        temporary_path = "#{output_path}.tmp"
+        File.write(temporary_path, call(File.read(input_path)))
+        FileUtils.mv(temporary_path, output_path)
+      ensure
+        FileUtils.rm_f(temporary_path) if temporary_path
+      end
+
+      private
+
+      def scope_rules(rules)
+        rules.each do |rule|
+          case rule[:node]
+          when :style_rule
+            scope_style_rule(rule)
+          when :at_rule
+            scope_at_rule(rule)
+          end
+        end
+      end
+
+      def scope_at_rule(rule)
+        return unless rule[:block] && GROUP_AT_RULES.include?(rule[:name])
+
+        nested_rules = Crass::Parser.parse_rules(rule[:block], preserve_comments: true)
+        scope_rules(nested_rules)
+        rule[:block] = nested_rules
+      end
+
+      def scope_style_rule(rule)
+        selectors = split_selectors(rule.dig(:selector, :tokens)).map { |selector| scope_selector(selector) }.uniq
+        scoped_rule = Crass::Parser.parse_rules("#{selectors.join(',')}{}").first
+        rule[:selector] = scoped_rule[:selector]
+      end
+
+      def split_selectors(tokens)
+        selectors = tokens.each_with_object([[]]) do |token, groups|
+          if token[:node] == :comma
+            groups << []
+          else
+            groups.last << token
+          end
+        end
+
+        selectors.map { |selector_tokens| Crass::Parser.stringify(selector_tokens).strip }
+      end
+
+      def scope_selector(selector)
+        return ROOT_SELECTOR if selector.match?(/\A(?::root|:host)\z/)
+        return selector.sub(/\A:root/, ROOT_SELECTOR) if selector.match?(/\A:root(?=$|[\s.#\[:>+~])/)
+        return selector.sub(/\Ahtml/, ROOT_SELECTOR) if selector.match?(/\Ahtml(?=$|[\s.#\[:>+~])/)
+        return selector.sub(/\A\*/, ROOT_OR_DESCENDANT_SELECTOR) if selector.start_with?("*")
+        return "#{ROOT_OR_DESCENDANT_SELECTOR}#{selector}" if selector.match?(/\A[.#\[:]/)
+
+        "#{ROOT_SELECTOR} #{selector}"
+      end
+    end
+  end
+end

data/lib/postnhost/sample_data.rb

@@ -785,7 +785,7 @@ module Postnhost
           <li>⏰ <strong>Post scheduling</strong> — Schedule publication through your application’s Active Job adapter</li>
           <li>🌐 <strong>Localized SEO</strong> — Localized routes, language switcher, sitemap, and hreflang tags</li>
           <li>⚙️ <strong>Settings</strong> — Update key copy and assets from the CMS</li>
-          <li>🎨 <strong>Customizable views</strong> — Override public templates in the host app (<code>rails g postnhost:views</code>)</li>
+          <li>🎨 <strong>Customizable views</strong> — Override public templates in the host app (<code>bin/rails g postnhost:views --views-scope=minimal</code>)</li>
           <li>⚡ <strong>Hotwire UI</strong> — Turbo Frames/Streams and Stimulus</li>
           <li>🔐 <strong>Session-based auth</strong> — Built-in admin authentication</li>
         </ul>

data/lib/postnhost/tailwind_compiler.rb

@@ -0,0 +1,75 @@
+require "json"
+require "pathname"
+require "rubygems/version"
+
+module Postnhost
+  class TailwindCompiler
+    REQUIRED_MAJOR = 4
+
+    class MissingCompiler < StandardError; end
+    class IncompatibleVersion < StandardError; end
+
+    def initialize(root:, loaded_specs: Gem.loaded_specs)
+      @root = Pathname.new(root)
+      @loaded_specs = loaded_specs
+    end
+
+    def command(input_path:, output_path:, watch: false)
+      command = npm_command(input_path:, output_path:) || ruby_command(input_path:, output_path:)
+      raise MissingCompiler, missing_compiler_message unless command
+
+      command << "--watch" if watch
+      command
+    end
+
+    private
+
+    attr_reader :root, :loaded_specs
+
+    def ruby_command(input_path:, output_path:)
+      spec = loaded_specs["tailwindcss-ruby"]
+      return unless spec
+
+      validate_version!(spec.version, "tailwindcss-ruby")
+      require "tailwindcss/ruby"
+      executable = Tailwindcss::Ruby.executable
+      return if executable.to_s.empty?
+
+      [executable, "-i", input_path.to_s, "-o", output_path.to_s, "--minify"]
+    end
+
+    def npm_command(input_path:, output_path:)
+      executable = root.join("node_modules/.bin/tailwindcss")
+      return unless executable.file?
+
+      validate_package_version!("tailwindcss")
+      validate_package_version!("@tailwindcss/cli")
+
+      [executable.to_s, "-i", input_path.to_s, "-o", output_path.to_s, "--minify"]
+    end
+
+    def validate_package_version!(package_name)
+      package_path = root.join("node_modules", package_name, "package.json")
+      raise MissingCompiler, "[postnhost] Missing #{package_name}. Install Tailwind CSS 4 and @tailwindcss/cli 4." unless package_path.file?
+
+      version = JSON.parse(package_path.read).fetch("version")
+      validate_version!(version, package_name)
+    rescue JSON::ParserError, KeyError
+      raise MissingCompiler, "[postnhost] Cannot read the installed #{package_name} version."
+    end
+
+    def validate_version!(version, source)
+      return if Gem::Version.new(version.to_s).segments.first == REQUIRED_MAJOR
+
+      raise IncompatibleVersion,
+            "[postnhost] Host CSS requires Tailwind CSS 4; found #{source} #{version}."
+    end
+
+    def missing_compiler_message
+      <<~MESSAGE.strip
+        [postnhost] No Tailwind CSS 4 compiler found for host customization.
+        Add tailwindcss-ruby 4, or install tailwindcss 4 and @tailwindcss/cli 4.
+      MESSAGE
+    end
+  end
+end

data/lib/postnhost/tailwind_input.rb

@@ -0,0 +1,32 @@
+require "pathname"
+
+module Postnhost
+  class TailwindInput
+    SOURCE_PATTERN = /@source\s+"([^"]+)";/
+
+    class << self
+      def build(engine_source:, host_source:)
+        [
+          expand_sources(engine_source),
+          expand_sources(host_source)
+        ].join("\n\n")
+      end
+
+      private
+
+      def expand_sources(path)
+        source_path = Pathname.new(path)
+
+        source_path.read.gsub(SOURCE_PATTERN) do
+          relative_source = Regexp.last_match(1)
+          absolute_source = source_path.dirname.join(relative_source).expand_path
+          %(@source "#{css_path(absolute_source)}";)
+        end
+      end
+
+      def css_path(path)
+        Pathname.new(path).expand_path.to_s.tr("\\", "/").gsub('"', '\\"')
+      end
+    end
+  end
+end

data/lib/postnhost/version.rb

@@ -1,3 +1,3 @@
 module Postnhost
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end