poetry-ui 0.0.2

data/config/locales/en.yml

@@ -0,0 +1,93 @@
+en:
+  poetry:
+    button:
+      loading: "Loading…"
+    calendar:
+      month: "Month"
+      year: "Year"
+    combobox:
+      clear: "Clear selection"
+      empty: "No results found."
+      filter_label: "Filter options"
+      remove: "Remove %{label}"
+    command:
+      empty: "No results found."
+      loading: "Loading…"
+      results:
+        zero: "0 results"
+        one: "1 result"
+        other: "%{count} results"
+      list_label: "Commands"
+      input_label: "Search commands"
+      dialog_title: "Command palette"
+      dialog_description: "Search for a command to run…"
+    deferred:
+      failed: "This section failed to load."
+      retry: "Retry"
+    stat:
+      trend_up: "trending up"
+      trend_down: "trending down"
+      trend_flat: "flat"
+    file_input:
+      prompt: "Drag and drop or click to browse"
+      clear: "Clear selection"
+    number_field:
+      roledescription: "Number field"
+      increment: "Increase"
+      decrement: "Decrease"
+    search_field:
+      clear: "Clear search"
+    clipboard_text:
+      copy: "Copy"
+      copied: "Copied to clipboard"
+    code_block:
+      label: "Code"
+    sensitive_input:
+      masked_label: "%{label}, masked."
+      masked_fallback: "Sensitive value, masked."
+      hint: "Click or press Enter to reveal."
+      reveal_hint: "Click to reveal"
+      hidden: "Value hidden"
+      hide: "Hide value"
+    data_table:
+      select_all: "Select all rows"
+      select_row: "Select row"
+      selected_count: "%{count} selected"
+    tree:
+      expand: "Expand"
+      collapse: "Collapse"
+      empty: "No items"
+    tag_group:
+      remove: "Remove"
+    date_field:
+      empty: "Empty"
+      year: "year"
+      month: "month"
+      day: "day"
+      hour: "hour"
+      minute: "minute"
+      second: "second"
+      day_period: "AM/PM"
+      placeholder_year: "yyyy"
+      placeholder_month: "mm"
+      placeholder_day: "dd"
+      placeholder_time: "––"
+    dialog:
+      close: "Close"
+    sheet:
+      close: "Close"
+    toast:
+      region_label: "Notifications (%{hotkey})"
+      close: "Close"
+    context_menu:
+      menu_label_fallback: "Context menu"
+    attachment:
+      state:
+        uploading: "Uploading attachment"
+        processing: "Processing attachment"
+        error: "Attachment failed"
+    input_otp:
+      label: "One-time code"
+    message_scroller:
+      region: "Conversation"
+      scroll_to_end: "Scroll to latest messages"

data/config/routes.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# Mounted by the host (mount Poetry::Ui::Engine => "/poetry"); serves the
+# LLM-facing docs generated live from the component registry.
+Poetry::Ui::Engine.routes.draw do
+  get "llms.txt", to: "poetry/ui/llms#index", format: false
+  get "llms-full.txt", to: "poetry/ui/llms#full", format: false
+end

data/config/template_classes.txt

@@ -0,0 +1,113 @@
+# static template classes - generated by `bin/rake css:template_classes:generate`. DO NOT EDIT.
+absolute
+animate-spin
+aspect-square
+bg-popover
+bg-primary
+bg-sidebar-primary
+border
+border-2
+border-b
+border-border
+border-destructive/50
+border-primary
+bottom-2
+contents
+data-[side]:visible
+data-open:opacity-100
+data-open:translate-y-0
+flex
+flex-1
+flex-col
+flex-wrap
+focus-visible:ring-2
+focus-visible:ring-ring
+font-medium
+font-semibold
+gap-1
+gap-2
+gap-3
+gap-4
+gap-6
+grid
+grid-cols-2
+grid-cols-3
+group-has-data-[collapsible=icon]/sidebar-wrapper:h-12
+h-14
+h-96
+h-px
+inline-block
+inset-x-8
+invisible
+items-center
+items-end
+items-start
+justify-between
+justify-center
+justify-end
+leading-none
+leading-tight
+max-w-2xl
+max-w-3xl
+max-w-5xl
+max-w-md
+max-w-xl
+md:grid-cols-3
+min-h-64
+min-h-72
+min-w-0
+min-w-8
+ms-auto
+mt-6
+mx-auto
+not-data-open:opacity-0
+not-data-open:translate-y-2
+outline-none
+overflow-hidden
+p-2
+p-3
+p-4
+p-6
+pb-16
+px-2
+px-4
+px-6
+py-1
+py-2
+relative
+rounded-full
+rounded-lg
+rounded-md
+shadow-lg
+shrink-0
+size-8
+space-y-0.5
+space-y-1
+space-y-2
+space-y-3
+space-y-4
+sr-only
+tabular-nums
+text-2xl
+text-base
+text-destructive
+text-left
+text-lg
+text-muted-foreground
+text-popover-foreground
+text-primary
+text-primary-foreground
+text-sidebar-primary-foreground
+text-sm
+text-xs
+tracking-tight
+transition-[height]
+transition-[opacity,translate]
+truncate
+underline
+underline-offset-4
+w-64
+w-80
+w-96
+w-full
+z-10

data/lib/generators/poetry/add/add_generator.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "yaml"
+require_relative "../block/block_generator"
+
+module Poetry
+  # `rails g poetry:add Button [@acme/fancy-chart ...]` - the copy-in tier
+  # plus the ecosystem address scheme.
+  #
+  # Bare names and @poetry/* are the installed gems' own items: component
+  # source copies into app/components where Rails autoload precedence
+  # shadows the gem ("own the code"; dependencies resolve recursively,
+  # existing files are SKIPPED - local edits win, always), and block names
+  # hand off to poetry:block. Everything else is a REMOTE registry address -
+  # a URL, a local item file, or @namespace/item against the registries:
+  # section of config/poetry_components.yml - resolved through
+  # RegistryClient + RegistryInstaller: the dependency DAG fetches
+  # recursively and writes in topo order, poetry components satisfy at
+  # RUNTIME (the gem provides them - no copy), targets are
+  # traversal-checked, and gem dependencies are REPORTED, never installed.
+  # Every install records provenance in the manifest.
+  #
+  # @example
+  #   bin/rails g poetry:add button
+  class AddGenerator < Rails::Generators::Base
+    argument :addresses, type: :array,
+                         banner: "Component|@registry/item|https://…/item.json|./item.json ..."
+
+    # Composition edges - single-sourced on the gem module (the
+    # registry items emit the same map as registryDependencies).
+    DEPENDENCIES = Poetry::Ui::COMPONENT_DEPENDENCIES
+
+    # The copy-in provenance manifest poetry:install seeds.
+    MANIFEST = "config/poetry_components.yml"
+    # The host's Tailwind entry stylesheet (for @source injection).
+    TAILWIND_ENTRY = "app/assets/tailwind/application.css"
+
+    desc "Copy poetry components/blocks (plus dependencies) into the app, from the gems or any registry address"
+
+    # Generator step: partitions the addresses and installs local
+    # (gem-owned) and remote items.
+    # @api private
+    def add_components
+      local, remote = addresses.map { |raw| Poetry::Core::RegistryAddress.parse(raw) }
+                               .partition { |address| local?(address) }
+      install_local(local) if local.any?
+      install_remote(remote) if remote.any?
+    end
+
+    private
+
+    # Bare names and @poetry/* resolve against the installed gems; anything
+    # the gems don't ship is a hard error for @poetry (never a fetch - the
+    # gem IS the official registry on a poetry host) and a hard error with
+    # the classic message for bare names.
+    def local?(address)
+      address.kind == :bare || (address.kind == :namespace && address.namespace == "@poetry")
+    end
+
+    def install_local(local)
+      names = local.map { |address| address.name.tr("-", "_") }
+      components, rest = names.partition { |name| source_dir(name).directory? }
+      blocks, rest = rest.partition { |name| gem_blocks.include?(name.tr("_", "-")) }
+      recipes, missing = rest.partition { |name| gem_recipes.include?(name.tr("_", "-")) }
+      raise ArgumentError, "unknown component(s): #{missing.join(", ")}" if missing.any?
+
+      copy_components(components) if components.any?
+      blocks.each { |name| install_block(name.tr("_", "-")) }
+      recipes.each { |name| install_recipe(name.tr("_", "-")) }
+    end
+
+    def copy_components(names)
+      resolved = resolve(names)
+      resolved.each { |name| copy_component(name) }
+      record_in_manifest(resolved.to_h { |name| [name, { "version" => Poetry::Ui::VERSION }] })
+      # A newly-shadowing file is not hot-reloaded over the already-loaded
+      # gem constant.
+      say_status :note, "restart your server so the local copies take precedence over the gem", :yellow
+    end
+
+    def resolve(names, seen = [])
+      names.each do |name|
+        next if seen.include?(name)
+
+        seen << name
+        resolve(DEPENDENCIES.fetch(name, []), seen)
+      end
+      seen
+    end
+
+    def source_dir(name)
+      Poetry::Ui.root.join("app/components/poetry/ui", name)
+    end
+
+    def copy_component(name)
+      dir = source_dir(name)
+      # Recursive: a component owns its nested subcomponents (command ships
+      # command/dialog). skip-if-exists: a customized local copy is never
+      # overwritten.
+      dir.glob("**/*").select(&:file?).each do |file|
+        create_file "app/components/poetry/ui/#{name}/#{file.relative_path_from(dir)}",
+                    file.read, skip: true
+      end
+    end
+
+    # -- the remote path ----------------------------------------------------
+
+    def install_remote(remote)
+      plan = build_plan(remote)
+      plan.writes.each { |write| create_file write.target, write.content, skip: true }
+      plan.block_installs.each { |name| install_block(name) }
+      apply_css(plan)
+      report(plan)
+      record_in_manifest(plan.manifest)
+    end
+
+    def build_plan(remote)
+      config = manifest_config
+      client = Poetry::Core::RegistryClient.new(
+        registries: config["registries"] || {}, directory: config["directory"],
+        base_dir: destination_root
+      )
+      Poetry::Core::RegistryInstaller.new(
+        client: client, destination_root: destination_root,
+        local_components: gem_components, local_blocks: gem_blocks
+      ).plan(remote)
+    end
+
+    def apply_css(plan)
+      plan.css_writes.each { |css| create_file css[:path], css[:content], skip: true }
+      return if plan.entry_lines.empty?
+
+      unless File.exist?(File.join(destination_root, TAILWIND_ENTRY))
+        say_status :note, "no #{TAILWIND_ENTRY} - add yourself: #{plan.entry_lines.join(" ")}", :yellow
+        return
+      end
+      plan.entry_lines.each { |line| inject_unless_present(TAILWIND_ENTRY, line) }
+    end
+
+    def report(plan)
+      plan.gem_satisfied.each do |name|
+        say_status :runtime, "#{name} - provided by the installed poetry gems (no copy needed)", :cyan
+      end
+      plan.gem_deps.each do |dep|
+        say_status :gemfile, "this item needs gem #{dep.inspect} - add it to your Gemfile (never run for you)", :yellow
+      end
+      plan.docs.each { |docs| say_status :docs, docs, :blue }
+    end
+
+    def install_block(name)
+      BlockGenerator.new([name], [], destination_root: destination_root).invoke_all
+    end
+
+    # -- recipes ------------------------------------------------------------
+
+    # A recipe's files write to their declared targets (skip-if-exists:
+    # local edits win, always); its registryDependencies are block names,
+    # installed through the same block path. Recorded in the manifest
+    # under recipes:.
+    def install_recipe(name)
+      item = Poetry::Ui.recipe_items.item(name)
+      item["files"].each { |file| create_file file["target"], file["content"], skip: true }
+      item["registryDependencies"].each { |dep| install_block(dep) }
+      record_in_manifest({ name => { "version" => Poetry::Ui::VERSION } }, section: "recipes")
+      routes_hint = item["description"][/Add `[^`]+` to routes/]
+      say_status :note, routes_hint, :yellow if routes_hint
+    end
+
+    def gem_recipes
+      @gem_recipes ||= Poetry::Ui.recipe_items.names
+    end
+
+    # The gems' own item names (kebab), read boot-free from the committed
+    # registries - what "provided at runtime" means on this host.
+    def gem_components
+      @gem_components ||= gem_item_sources.flat_map do |root, prefix|
+        registry = YAML.safe_load_file(root.join(Poetry::Core::Registry::RELATIVE_PATH))
+        (registry["components"] || {}).keys.map { |path| path.delete_prefix(prefix).tr("/", "_").tr("_", "-") }
+      end
+    end
+
+    def gem_blocks
+      @gem_blocks ||= begin
+        registry = YAML.safe_load_file(Poetry::Ui.root.join(Poetry::Core::Registry::RELATIVE_PATH))
+        (registry["blocks"] || {}).keys
+      end
+    end
+
+    def gem_item_sources
+      sources = [[Poetry::Ui.root, "poetry/ui/"]]
+      sources << [Poetry::Charts.root, "poetry/charts/"] if defined?(Poetry::Charts::Engine)
+      sources
+    end
+
+    def manifest_config
+      path = File.join(destination_root, MANIFEST)
+      config = File.exist?(path) ? YAML.safe_load_file(path) : nil
+      config.is_a?(Hash) ? config : {}
+    end
+
+    def record_in_manifest(entries, section: "components")
+      manifest = manifest_config
+      manifest[section] = {} unless manifest[section].is_a?(Hash)
+      entries.each { |name, record| manifest[section][name] ||= record }
+      create_file MANIFEST, YAML.dump(manifest), force: true
+    end
+
+    # The idempotency lives in the file-mutation primitive - same as
+    # poetry:install's.
+    def inject_unless_present(relative, line)
+      path = File.join(destination_root, relative)
+      return if File.exist?(path) && File.read(path).include?(line)
+
+      append_to_file relative, "#{line}\n"
+    end
+  end
+end

data/lib/generators/poetry/agent_rules/agent_rules_generator.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Poetry
+  # `rails g poetry:agent_rules` - the two-file, opposite-lifecycle agent
+  # ruleset:
+  #
+  #   .poetry/agent-rules.md  gem-owned, FORCE-overwritten every run
+  #                           (generated live from the component registry)
+  #   .poetry/house-rules.md  seeded once, then user-owned - never touched again
+  #
+  # plus an idempotent marker-import into CLAUDE.md and AGENTS.md:
+  # insert-between-markers, replace-on-rerun, and detect-but-never-rewrite
+  # when a file carries a broken half-marker.
+  #
+  # @example
+  #   bin/rails g poetry:agent_rules
+  class AgentRulesGenerator < Rails::Generators::Base
+    # The opening half of the marker pair bounding the import block.
+    START_MARKER = "<!-- poetry:agent-rules:start -->"
+    # The closing half of the marker pair bounding the import block.
+    END_MARKER = "<!-- poetry:agent-rules:end -->"
+
+    # The marker-bounded pointer inserted into CLAUDE.md and AGENTS.md.
+    IMPORT_BLOCK = <<~MD.freeze
+      #{START_MARKER}
+      Follow the poetry component rules in `.poetry/agent-rules.md` (generated - do not edit)
+      and the project overrides in `.poetry/house-rules.md`.
+      #{END_MARKER}
+    MD
+
+    # The once-only seed content of .poetry/house-rules.md.
+    HOUSE_RULES_SEED = <<~MD
+      # poetry house rules
+
+      Project-specific overrides and additions to the generated poetry agent
+      rules. This file is yours - poetry seeds it once and never touches it
+      again.
+    MD
+
+    desc "Install the poetry agent ruleset (.poetry/agent-rules.md + house-rules.md + CLAUDE.md/AGENTS.md import)"
+
+    # Step: force-writes the generated .poetry/agent-rules.md.
+    # @api private
+    def create_agent_rules
+      create_file ".poetry/agent-rules.md", generated_rules, force: true
+    end
+
+    # Step: seeds .poetry/house-rules.md once (never overwritten).
+    # @api private
+    def seed_house_rules
+      return if File.exist?(File.join(destination_root, ".poetry/house-rules.md"))
+
+      create_file ".poetry/house-rules.md", HOUSE_RULES_SEED
+    end
+
+    # Step: marker-imports the ruleset into CLAUDE.md and AGENTS.md.
+    # @api private
+    def import_into_instruction_files
+      %w[CLAUDE.md AGENTS.md].each { |file| marker_import(file) }
+    end
+
+    private
+
+    def generated_rules
+      registry = Poetry::Core::Registry.new(source_root: Poetry::Ui.root)
+      body = Poetry::Core::LlmsText.new(registry: registry).full
+      "<!-- generated by `rails g poetry:agent_rules` - DO NOT EDIT; " \
+        "project overrides go in .poetry/house-rules.md -->\n\n#{body}"
+    end
+
+    def marker_import(relative)
+      path = File.join(destination_root, relative)
+      existing = File.exist?(path) ? File.read(path) : nil
+
+      if existing.nil?
+        create_file relative, IMPORT_BLOCK
+      elsif existing.include?(START_MARKER) && existing.include?(END_MARKER)
+        replaced = existing.sub(/#{Regexp.escape(START_MARKER)}.*?#{Regexp.escape(END_MARKER)}\n?/mo, IMPORT_BLOCK)
+        create_file relative, replaced, force: true
+      elsif existing.include?(START_MARKER) || existing.include?(END_MARKER)
+        # Detect-but-never-rewrite: a half-marker means a human edited the
+        # block - surface it, do not guess.
+        say_status :conflict, "#{relative} has a broken poetry marker pair - fix it manually", :red
+      else
+        append_to_file relative, "\n#{IMPORT_BLOCK}"
+      end
+    end
+  end
+end

data/lib/generators/poetry/agents/agents_generator.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require_relative "../agents_section"
+
+module Poetry
+  # `rails g poetry:agents` - writes or refreshes the poetry section of the
+  # host's AGENTS.md (the agent-facing pointer to llms.txt / poetry check)
+  # without running the full install. poetry:install performs the same step.
+  #
+  # @example
+  #   bin/rails g poetry:agents
+  class AgentsGenerator < Rails::Generators::Base
+    include Generators::AgentsSection
+
+    desc "Write or refresh the poetry section of AGENTS.md (pointer to llms.txt + poetry check)"
+
+    # Step: applies the shared AGENTS.md section.
+    # @api private
+    def write_agents_md
+      apply_agents_section
+    end
+  end
+end