tramway 3.0.4 → 3.0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f1294b704f5b6bc2779d6eae4168a9c63508af6b485dfe267fa70a1b2ca786e
-  data.tar.gz: 662bf3c75f819a46229a55cce0804b11a70511ade1ecbc08e8aa50a09d246381
+  metadata.gz: 6df450ba2be14dca796231458310c25cbbc33d51d39de0bbeb7af4d8c0fadba1
+  data.tar.gz: 26ded3945beb84b04c0ea7c7916a3a8b1bc9beb14e7df7886a8add7d1bebb983
 SHA512:
-  metadata.gz: 90eb4ab0b7d5e871f904d320a42469ea92d35a83ebad3c014b167fe7b5294e7c046c1c0ebc41f64a09693794995e82641d69b3cb9d59d3e5183f5108ace44745
-  data.tar.gz: 53bc0d610787669587ed26f4c6bbadce0c0e476ae34b8f4ea49128ad7e20265080d09abdf3726fea93aea1014a2a935b12077b6049c47fd46c199c044ad6872f
+  metadata.gz: 350d5eaf8eb2aadc8b458bc9834340ee34efe36ce4dbec2960214331b89e6979329b1c61c607b7cf64b595fb7c81e62959144d78708755c2e8964872f0f89dd2
+  data.tar.gz: 1d7215149e091f8b967fbee6471d68a77c90f57294022f66327626e300759ad31f01d4e30e019c1a17f571e7adba9f09f404089f0960bd129fc1c4918f0c86b7

data/README.md

@@ -1,8 +1,8 @@
 # Tramway
 Unite Ruby on Rails brilliance. Streamline development with Tramway.
 
-Tramway ships with full CRUD (index, show, create, update, destroy) out of the box, and it includes a great AGENTS.md guide
-that helps you generate good, Tramway-native code with all the framework features.
+Tramway ships with full CRUD (index, show, create, update, destroy) out of the box. Its install generator also adds a
+Codex instruction that points agents to the Tramway skill for Tramway-native code generation.
 
 [![RubyGems Version](https://img.shields.io/gem/v/tramway.svg)](https://rubygems.org/gems/tramway)
 [![Tests](https://github.com/Purple-Magic/tramway/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/Purple-Magic/tramway/actions/workflows/test.yml)

data/app/components/tramway/table/content_cells.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Table
+    # Helpers for extracting and normalizing visible table content cells from HTML fragments.
+    module ContentCells
+      private
+
+      def visible_cells_from(content)
+        fragment = Nokogiri::HTML.fragment(content)
+        parsed_cells = fragment.xpath(
+          './*[@class and contains(concat(" ", normalize-space(@class), " "), " div-table-cell ")]'
+        )
+
+        parsed_cells.each { |cell| remove_hidden_class!(cell) }
+      end
+
+      def remove_hidden_class!(node)
+        classes = node['class'].to_s.split
+        return if classes.empty?
+
+        node['class'] = classes.reject { |class_name| class_name == 'hidden' }.join(' ')
+      end
+    end
+  end
+end

data/app/components/tramway/table/header_component.html.haml

@@ -1,4 +1,5 @@
-%div{ class: "#{header_row_classes} md:grid-cols-#{columns_count}", aria: { label: "Table Header" }, role: "row" }
+- parsed_cells = headers.any? ? nil : visible_cells_from(content)
+%div{ class: "#{header_row_classes} md:grid-cols-#{columns_count(parsed_cells: parsed_cells)}", aria: { label: "Table Header" }, role: "row" }
   - if headers.any?
     - headers.each do |header|
       .div-table-cell{ class: header_cell_classes }

data/app/components/tramway/table/header_component.rb

@@ -4,11 +4,17 @@ module Tramway
   module Table
     # Component for rendering a header in a table
     class HeaderComponent < Tramway::BaseComponent
+      include ContentCells
+
       option :headers, optional: true, default: -> { [] }
       option :columns, optional: true, default: -> { 3 }
 
-      def columns_count
-        headers.present? ? headers.size : columns
+      def columns_count(content = nil, parsed_cells: nil)
+        return headers.size if headers.present?
+        return parsed_cells.size if parsed_cells
+        return visible_cells_from(content).size if content.present?
+
+        columns
       end
 
       def header_row_classes

data/app/components/tramway/table/row_component.rb

@@ -4,6 +4,8 @@ module Tramway
   module Table
     # Component for rendering a row in a table
     class RowComponent < Tramway::BaseComponent
+      include ContentCells
+
       option :cells, optional: true, default: -> { [] }
       option :href, optional: true
       option :preview, optional: true, default: -> { true }
@@ -58,22 +60,6 @@ module Tramway
 
       private
 
-      def visible_cells_from(content)
-        fragment = Nokogiri::HTML.fragment(content)
-        parsed_cells = fragment.xpath(
-          './*[@class and contains(concat(" ", normalize-space(@class), " "), " div-table-cell ")]'
-        )
-
-        parsed_cells.each { |cell| remove_hidden_class!(cell) }
-      end
-
-      def remove_hidden_class!(node)
-        classes = node['class'].to_s.split
-        return if classes.empty?
-
-        node['class'] = classes.reject { |class_name| class_name == 'hidden' }.join(' ')
-      end
-
       def ensure_view_context_accessor
         return if view_context.respond_to?(:tramway_inside_cell=)
 

data/docs/AGENTS.md

@@ -32,7 +32,7 @@ Generated code should:
 bin/rails g tramway:install
 ```
 
-- The install generator appends missing gems, copies Tailwind safelist config, ensures `app/assets/tailwind/application.css` imports Tailwind, and writes an `AGENTS.md` guide in the project root.
+- The install generator appends missing gems, copies Tailwind safelist config, ensures `app/assets/tailwind/application.css` imports Tailwind, and adds a Codex instruction to use or install `tramway-skill`.
 
 ---
 

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

@@ -2,7 +2,6 @@
 
 require 'rails/generators'
 require 'fileutils'
-require 'net/http'
 
 module Tramway
   module Generators
@@ -86,50 +85,9 @@ module Tramway
         @agents_file_path ||= File.join(destination_root, 'AGENTS.md')
       end
 
-      def project_tramway_agents_path
-        @project_tramway_agents_path ||= File.join(destination_root, 'docs/agents/tramway.md')
-      end
-
-      def agents_template_url
-        'https://raw.githubusercontent.com/Purple-Magic/tramway-skill/refs/heads/main/skills/tramway-skill/agents/tramway.md'
-      end
-
-      def agents_template_body
-        return @agents_template_body if defined?(@agents_template_body)
-
-        uri = URI.parse(agents_template_url)
-        response = Net::HTTP.get_response(uri)
-        body = response.body.to_s
-        body = body.dup.force_encoding(Encoding::UTF_8)
-        @agents_template_body = sanitize_agents_template_body(
-          body.encode(Encoding::UTF_8, invalid: :replace, undef: :replace, replace: '')
-        )
-      end
-
-      def sanitize_agents_template_body(content)
-        stripped_content = content.strip
-        section_pattern = /\A#{Regexp.escape(agents_section_start)}\s*\n?(.*?)\n?#{Regexp.escape(agents_section_end)}\s*\z/m # rubocop:disable Layout/LineLength
-        match = stripped_content.match(section_pattern)
-
-        return stripped_content unless match
-
-        match[1].to_s.strip
-      end
-
-      def agents_section_start
-        '## Start of Tramway AGENTS.md'
-      end
-
-      def agents_section_end
-        '## End of Tramway AGENTS.md'
-      end
-
-      def agents_template
-        @agents_template ||= [agents_section_start, agents_template_body.rstrip, agents_section_end].join("\n")
-      end
-
-      def agents_section_present?(content)
-        content.include?(agents_section_start) && content.include?(agents_section_end)
+      def codex_agents_instruction
+        'If you are Codex, use the tramway-skill skill for Tramway/Rails work in this project. ' \
+          'If tramway-skill is not installed, install it from https://github.com/Purple-Magic/tramway-skill/.'
       end
 
       def create_tailwind_config
@@ -170,9 +128,9 @@ module Tramway
         line[/^\s*/] || '  '
       end
 
-      def insert_agents_template(content)
+      def append_codex_agents_instruction(content)
         separator = agents_separator(content)
-        "#{content}#{separator}#{agents_template}"
+        "#{content}#{separator}#{codex_agents_instruction}\n"
       end
 
       def agents_separator(content)
@@ -181,15 +139,6 @@ module Tramway
         content.end_with?("\n") ? "\n" : "\n\n"
       end
 
-      def replace_agents_section(content)
-        return insert_agents_template(content) unless agents_section_present?(content)
-
-        content.sub(
-          /#{Regexp.escape(agents_section_start)}.*?#{Regexp.escape(agents_section_end)}/m,
-          agents_template
-        )
-      end
-
       # rubocop:disable Metrics/MethodLength
       def append_missing_imports(content)
         missing_imports = stimulus_controller_imports.reject { |line| content.include?(line) }
@@ -226,6 +175,12 @@ module Tramway
         updated << insertion
         updated
       end
+
+      def with_agents_update_fallback
+        yield
+      rescue StandardError => e
+        say_status(:warning, "Skipping AGENTS.md update: #{e.message}")
+      end
     end
     # rubocop:enable Metrics/ModuleLength
 
@@ -236,36 +191,19 @@ module Tramway
 
       desc 'Installs Tramway dependencies and Tailwind safelist configuration.'
 
-      # rubocop:disable Metrics/MethodLength
       def ensure_agents_file
         with_agents_update_fallback do
-          if File.exist?(project_tramway_agents_path)
-            say_status(:info, "Skipping AGENTS.md update because #{project_tramway_agents_path} exists.")
-            return
-          end
-
-          say_status(
-            :info,
-            "Tramway will replace the content between \"#{agents_section_start}\" and " \
-            "\"#{agents_section_end}\" in AGENTS.md."
-          )
-
-          return create_file(agents_file_path, "#{agents_template}\n") unless File.exist?(agents_file_path)
+          return create_file(agents_file_path, "#{codex_agents_instruction}\n") unless File.exist?(agents_file_path)
 
           content = File.read(agents_file_path)
-          updated = replace_agents_section(content)
+          return if content.include?(codex_agents_instruction)
+
+          updated = append_codex_agents_instruction(content)
           return if updated == content
 
           File.write(agents_file_path, updated, mode: 'w:UTF-8')
         end
       end
-      # rubocop:enable Metrics/MethodLength
-
-      def with_agents_update_fallback
-        yield
-      rescue StandardError => e
-        say_status(:warning, "Skipping AGENTS.md update: #{e.message}")
-      end
 
       def ensure_dependencies
         missing_dependencies = gem_dependencies.reject do |dependency|

data/lib/tramway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tramway
-  VERSION = '3.0.4'
+  VERSION = '3.0.4.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 3.0.4
+  version: 3.0.4.2
 platform: ruby
 authors:
 - kalashnikovisme
@@ -230,6 +230,7 @@ files:
 - app/components/tramway/pagination/prev_page_component.rb
 - app/components/tramway/table/cell_component.html.haml
 - app/components/tramway/table/cell_component.rb
+- app/components/tramway/table/content_cells.rb
 - app/components/tramway/table/header_component.html.haml
 - app/components/tramway/table/header_component.rb
 - app/components/tramway/table/row/preview_component.html.haml