igniter 0.5.0 → 0.5.1

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/README.md.erb

@@ -0,0 +1,37 @@
+# <%= module_name %>
+
+This stack was generated with the `dashboard` scaffold profile.
+
+The intended reading order is simple:
+
+1. `stack.rb`
+2. `stack.yml`
+3. `apps/dashboard/app.rb`
+4. `apps/dashboard/contexts/home_context.rb`
+5. `apps/dashboard/web/views/home_page.arb`
+
+## What This Profile Adds
+
+- a mounted `dashboard` app at `/dashboard`
+- `igniter-frontend` as the recommended app UI path
+- a page context object for request-shaped view state
+- Arbre page objects with `.arb` templates
+- Tailwind via the browser runtime for fast operator UI authoring
+- app-owned frontend assets under `apps/dashboard/frontend/`
+
+## Boot
+
+```bash
+bundle install
+ruby bin/demo
+bin/start
+bin/console
+bin/dev
+```
+
+Then open:
+
+- `http://127.0.0.1:4567/`
+- `http://127.0.0.1:4567/dashboard`
+
+`bin/dev` also writes per-node logs to `var/log/dev/*.log`.

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/app.rb.erb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "igniter/app"
+require "igniter/core"
+require "igniter-frontend"
+require_relative "web/handlers/home_handler"
+
+module <%= module_name %>
+  class DashboardApp < Igniter::App
+    include Igniter::Frontend::App
+
+    root_dir __dir__
+    config_file "app.yml"
+    frontend_assets path: "frontend"
+    mount_operator_surface
+
+    get "/", to: <%= module_name %>::Dashboard::Web::Handlers::HomeHandler
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/contexts/home_context.rb.erb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module <%= module_name %>
+  module Dashboard
+    module Contexts
+      class HomeContext < Igniter::Frontend::Context
+        def title
+          fetch(:title)
+        end
+
+        def snapshot
+          fetch(:snapshot)
+        end
+
+        def stack
+          snapshot.fetch(:stack)
+        end
+
+        def apps
+          snapshot.fetch(:apps)
+        end
+
+        def nodes
+          snapshot.fetch(:nodes)
+        end
+
+        def mounts
+          stack.fetch("mounts", {})
+        end
+
+        def current_node
+          snapshot.fetch(:current_node)
+        end
+
+        def summary_metrics
+          [
+            { label: "Apps", value: apps.size },
+            { label: "Mounts", value: mounts.size },
+            { label: "Nodes", value: nodes.size },
+            { label: "Current Node", value: current_node }
+          ]
+        end
+
+        def panel_payloads
+          [
+            { title: "Mounted Apps", payload: apps },
+            { title: "Mounts", payload: mounts },
+            { title: "Nodes", payload: nodes }
+          ]
+        end
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/frontend/application.js.erb

@@ -0,0 +1,3 @@
+(() => {
+  document.documentElement.dataset.igniterDashboard = "ready";
+})();

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/spec/dashboard_app_spec.rb.erb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require_relative "spec_helper"
+require "json"
+require "stringio"
+
+RSpec.describe <%= module_name %>::DashboardApp do
+  it "renders the canonical operator endpoint" do
+    app = described_class.rack_app
+
+    status, headers, body = app.call(
+      "REQUEST_METHOD" => "GET",
+      "PATH_INFO" => "/api/operator",
+      "rack.input" => StringIO.new
+    )
+
+    payload = JSON.parse(body.each.to_a.join)
+
+    expect(status).to eq(200)
+    expect(headers["Content-Type"]).to include("application/json")
+    expect(payload["app"]).to eq("<%= module_name %>::DashboardApp")
+    expect(payload["scope"]).to eq("mode" => "app")
+    expect(payload.dig("summary", "total")).to eq(0)
+  end
+
+  it "serves frontend assets for progressive enhancement" do
+    app = described_class.rack_app
+
+    status, headers, body = app.call(
+      "REQUEST_METHOD" => "GET",
+      "PATH_INFO" => "/__frontend/assets/application.js",
+      "rack.input" => StringIO.new
+    )
+
+    javascript = body.each.to_a.join
+
+    expect(status).to eq(200)
+    expect(headers["Content-Type"]).to include("text/javascript")
+    expect(javascript).to include("igniterDashboard")
+  end
+
+  it "renders the built-in operator console" do
+    app = described_class.rack_app
+
+    status, headers, body = app.call(
+      "REQUEST_METHOD" => "GET",
+      "PATH_INFO" => "/operator",
+      "rack.input" => StringIO.new
+    )
+
+    html = body.each.to_a.join
+
+    expect(status).to eq(200)
+    expect(headers["Content-Type"]).to include("text/html")
+    expect(html).to include("Operator Console")
+    expect(html).to include("/api/operator")
+  end
+
+  it "renders the mounted dashboard home page" do
+    app = described_class.rack_app
+
+    status, headers, body = app.call(
+      "REQUEST_METHOD" => "GET",
+      "PATH_INFO" => "/",
+      "rack.input" => StringIO.new
+    )
+
+    html = body.each.to_a.join
+
+    expect(status).to eq(200)
+    expect(headers["Content-Type"]).to include("text/html")
+    expect(html).to include("<%= module_name %> Dashboard")
+    expect(html).to include("/dashboard")
+    expect(html).to include("/api/operator")
+    expect(html).to include("@tailwindcss/browser@4")
+    expect(html).to include("/__frontend/assets/application.js")
+    expect(html).to include("Mounted Apps")
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/support/stack_overview.rb.erb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module <%= module_name %>
+  module Dashboard
+    module Support
+      module StackOverview
+        module_function
+
+        def build
+          snapshot = <%= stack_class_name %>.deployment_snapshot
+          current_node = ENV["IGNITER_NODE"].to_s
+
+          {
+            stack: snapshot.fetch("stack"),
+            apps: snapshot.fetch("apps"),
+            nodes: snapshot.fetch("nodes"),
+            current_node: current_node.empty? ? snapshot.dig("stack", "default_node") : current_node
+          }
+        end
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/handlers/home_handler.rb.erb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "igniter-frontend"
+require_relative "../../contexts/home_context"
+require_relative "../../support/stack_overview"
+require_relative "../views/home_page"
+
+module <%= module_name %>
+  module Dashboard
+    module Web
+      module Handlers
+        class HomeHandler < Igniter::Frontend::Handler
+          def call
+            render(
+              Views::HomePage,
+              context: build_context(
+                Contexts::HomeContext,
+                title: "<%= module_name %> Dashboard",
+                snapshot: Support::StackOverview.build
+              )
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/views/home_page.arb.erb

@@ -0,0 +1,44 @@
+section class: "relative overflow-hidden rounded-[2rem] border border-stone-800 bg-stone-900/80 p-8 shadow-glow" do
+  div class: "absolute inset-x-0 top-0 h-px bg-gradient-to-r from-transparent via-amber-400/60 to-transparent"
+
+  div class: "flex flex-col gap-6 lg:flex-row lg:items-end lg:justify-between" do
+    div class: "max-w-3xl space-y-3" do
+      p "Operator Surface", class: "text-xs font-semibold uppercase tracking-[0.28em] text-amber-300/80"
+      h1 page_context.title, class: "font-display text-4xl tracking-tight text-stone-50 sm:text-5xl"
+      p "Mounted stack overview generated by the dashboard scaffold profile.", class: "max-w-2xl text-sm leading-6 text-stone-300 sm:text-base"
+      p class: "text-sm text-stone-500" do
+        text_node "root_app=#{page_context.stack["root_app"]} · "
+        text_node "default_node=#{page_context.stack["default_node"]} · "
+        text_node "current_node=#{page_context.current_node}"
+      end
+    end
+
+    div class: "flex flex-wrap items-center gap-3" do
+      a "Refresh", href: page_context.route("/"), class: "rounded-full border border-stone-700 px-4 py-2 text-sm font-medium text-stone-100 transition hover:border-amber-300 hover:text-amber-200"
+      a "Operator Console", href: page_context.route("/operator"), class: "rounded-full bg-amber-500 px-4 py-2 text-sm font-semibold text-stone-950 transition hover:bg-amber-400"
+      a "Operator API", href: page_context.route("/api/operator"), class: "rounded-full border border-stone-700 px-4 py-2 text-sm font-medium text-stone-100 transition hover:border-amber-300 hover:text-amber-200"
+    end
+  end
+end
+
+section class: "grid gap-4 md:grid-cols-2 xl:grid-cols-4" do
+  page_context.summary_metrics.each do |metric|
+    article class: "rounded-3xl border border-stone-800 bg-stone-900/70 p-5" do
+      p metric.fetch(:label), class: "text-xs font-semibold uppercase tracking-[0.22em] text-stone-500"
+      p metric.fetch(:value).to_s, class: "mt-3 font-display text-3xl text-stone-50"
+    end
+  end
+end
+
+section class: "grid gap-4 xl:grid-cols-3" do
+  page_context.panel_payloads.each do |entry|
+    article class: "rounded-3xl border border-stone-800 bg-stone-900/70 p-5" do
+      div class: "flex items-center justify-between gap-3" do
+        h2 entry.fetch(:title), class: "font-display text-2xl text-stone-50"
+        span "json", class: "rounded-full border border-stone-700 px-3 py-1 text-[11px] font-semibold uppercase tracking-[0.2em] text-stone-400"
+      end
+
+      pre pretty_json(entry.fetch(:payload)), class: "mt-4 overflow-x-auto rounded-2xl border border-stone-800 bg-stone-950/80 p-4 text-xs leading-6 text-stone-300"
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/views/home_page.rb.erb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "json"
+require "igniter-frontend"
+
+module <%= module_name %>
+  module Dashboard
+    module Web
+      module Views
+        class HomePage < Igniter::Frontend::ArbrePage
+          template_root __dir__
+          template "home_page"
+          layout "layout"
+
+          def initialize(context:)
+            @context = context
+          end
+
+          def template_locals
+            { page_context: @context }
+          end
+
+          def page_title
+            @context.title
+          end
+
+          def body_class
+            ops_theme.fetch(:body_class)
+          end
+
+          def main_class
+            ops_theme.fetch(:main_class)
+          end
+
+          def tailwind_cdn_url
+            Igniter::Frontend::Tailwind::PLAY_CDN_URL
+          end
+
+          def tailwind_config_script
+            "tailwind.config = #{JSON.generate(ops_theme.fetch(:tailwind_config))};"
+          end
+
+          def pretty_json(payload)
+            JSON.pretty_generate(payload)
+          end
+
+          private
+
+          def ops_theme
+            @ops_theme ||= Igniter::Frontend::Tailwind.theme(:ops)
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/views/layout.arb.erb

@@ -0,0 +1,17 @@
+html lang: "en" do
+  head do
+    meta charset: "utf-8"
+    meta name: "viewport", content: "width=device-width, initial-scale=1"
+    title page_title
+    script src: tailwind_cdn_url
+    script(type: "text/javascript") { raw_text tailwind_config_script }
+  end
+
+  body class: body_class do
+    main class: main_class do
+      render_template_content
+    end
+
+    render_frontend_javascript "application"
+  end
+end

data/packages/igniter-app/lib/igniter/app/host_adapter.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Igniter
+  class App
+    # Abstract host adapter seam for application runtimes.
+    #
+    # App owns app assembly (autoloading, config layering, registration,
+    # scheduling), while the host adapter owns deployment/runtime specifics such
+    # as transport activation and the concrete object returned by #start/#rack_app.
+    class HostAdapter
+      def build_config(app_config)
+        raise NotImplementedError, "#{self.class} must implement #build_config"
+      end
+
+      def activate_transport!; end
+
+      def start(config:)
+        raise NotImplementedError, "#{self.class} must implement #start"
+      end
+
+      def rack_app(config:)
+        raise NotImplementedError, "#{self.class} must implement #rack_app"
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/host_config.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Igniter
+  class App
+    # Neutral hosting config produced by the application layer.
+    #
+    # It captures the runtime-facing needs of an assembled application without
+    # tying them to any specific host implementation such as the built-in HTTP
+    # server, Rack, or a future event loop / process model.
+    class HostConfig
+      attr_accessor :store, :metrics_collector, :custom_routes,
+                    :before_request_hooks, :after_request_hooks, :around_request_hooks
+
+      attr_reader :registrations, :host_settings
+
+      def initialize
+        @store                = nil
+        @metrics_collector    = nil
+        @custom_routes        = []
+        @before_request_hooks = []
+        @after_request_hooks  = []
+        @around_request_hooks = []
+        @registrations        = {}
+        @host_settings        = {}
+      end
+
+      def register(name, contract_class)
+        @registrations[name.to_s] = contract_class
+      end
+
+      def configure_host(name, settings)
+        @host_settings[name.to_sym] = settings.dup
+      end
+
+      def host_settings_for(name)
+        @host_settings.fetch(name.to_sym, {})
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/host_registry.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Igniter
+  class App
+    # Global registry of canonical application host builders.
+    #
+    # Host profiles such as :app and :cluster_app are registered here so the
+    # application DSL can stay declarative while runtime-specific packs remain
+    # pluggable.
+    class HostRegistry
+      class << self
+        def register(name, builder = nil, &block)
+          resolved_builder = builder || block
+          raise ArgumentError, "host registration requires a builder block or callable" unless resolved_builder
+
+          registry[normalize_name(name)] = resolved_builder
+        end
+
+        def fetch(name)
+          registry.fetch(normalize_name(name))
+        end
+
+        def names
+          registry.keys
+        end
+
+        def registered?(name)
+          registry.key?(normalize_name(name))
+        end
+
+        private
+
+        def registry
+          @registry ||= {}
+        end
+
+        def normalize_name(name)
+          name.to_sym
+        end
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/loader_adapter.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Igniter
+  class App
+    # Abstract seam for application code loading.
+    #
+    # App declares which path groups exist, while the loader adapter owns
+    # how those files are discovered and required.
+    class LoaderAdapter
+      def load!(base_dir:, paths:)
+        raise NotImplementedError, "#{self.class} must implement #load!"
+      end
+    end
+  end
+end

data/packages/igniter-app/lib/igniter/app/loader_pack.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "loader_registry"
+require_relative "filesystem_loader_adapter"
+
+Igniter::App::LoaderRegistry.register(:filesystem) do
+  Igniter::App::FilesystemLoaderAdapter.new
+end

data/packages/igniter-app/lib/igniter/app/loader_registry.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Igniter
+  class App
+    # Registry of canonical application code loaders.
+    class LoaderRegistry
+      class << self
+        def register(name, builder = nil, &block)
+          resolved_builder = builder || block
+          raise ArgumentError, "loader registration requires a builder block or callable" unless resolved_builder
+
+          registry[normalize_name(name)] = resolved_builder
+        end
+
+        def fetch(name)
+          registry.fetch(normalize_name(name))
+        end
+
+        def names
+          registry.keys
+        end
+
+        def registered?(name)
+          registry.key?(normalize_name(name))
+        end
+
+        private
+
+        def registry
+          @registry ||= {}
+        end
+
+        def normalize_name(name)
+          name.to_sym
+        end
+      end
+    end
+  end
+end