infotable 1.5.0 → 1.6.0

data/lib/infotable/mcp/table_checker.rb

@@ -0,0 +1,80 @@
+module Infotable
+  module Mcp
+    # Loads a table and looks for mistakes before the app does: columns the model lacks,
+    # a default sort on a missing column, a query that raises. Optionally returns a few rows.
+    class TableChecker
+      def initialize(name: nil, source: nil, preview: 0)
+        @name = name
+        @source = source
+        @preview = preview.to_i.clamp(0, 20)
+      end
+
+      def call
+        table = load_table
+        problems = []
+        model = nil
+
+        begin
+          model = table.base_query.model
+        rescue StandardError => e
+          return { ok: false, problems: [ "query raises #{e.class}: #{e.message}" ] }
+        end
+
+        problems.concat(column_problems(table, model))
+        problems.concat(sort_problems(table))
+        problems << "no authorize block: anyone who can reach the engine routes can read this table" if table.table_authorize.nil?
+
+        rows = preview_rows(table, problems)
+        { ok: problems.none? { !_1.start_with?("no authorize") }, table: table.name, model: model.name, problems: problems, preview: rows }.compact
+      end
+
+      private
+
+      def load_table
+        if @source
+          mod = Module.new
+          mod.module_eval(@source.sub(/class \S+ </, "class CheckedTable <"), "infotable_mcp_check.rb")
+          mod.const_get(:CheckedTable)
+        else
+          reload_app
+          Infotable::TableResolver.resolve(@name)
+        end
+      end
+
+      # A table written a moment ago is not known to the autoloader yet
+      def reload_app
+        Rails.application.reloader.reload! if Rails.application.config.enable_reloading
+      rescue StandardError
+        nil
+      end
+
+      def column_problems(table, model)
+        table.columns.filter_map do |col|
+          next if col[:value] || col[:virtual] || col[:sql] || %i[action actions].include?(col[:type])
+          next if model.column_names.include?(col[:name].to_s) || model.method_defined?(col[:name])
+
+          "column :#{col[:name]} is not an attribute of #{model.name}: add value:, sql: or virtual:"
+        end
+      end
+
+      def sort_problems(table)
+        column = table.sort_settings[:column]
+        return [] if column.nil? || table.columns.any? { _1[:name].to_s == column.to_s }
+
+        [ "default_sort :#{column} is not a defined column" ]
+      end
+
+      def preview_rows(table, problems)
+        return nil if @preview.zero?
+
+        columns = table.visible_columns.reject { %i[action actions].include?(_1[:type]) }
+        table.base_query.limit(@preview).map do |record|
+          columns.to_h { |col| [ col[:name], table.cell_value(record, col).to_s ] }
+        end
+      rescue StandardError => e
+        problems << "query raises #{e.class}: #{e.message}"
+        nil
+      end
+    end
+  end
+end

data/lib/infotable/mcp/table_writer.rb

@@ -0,0 +1,66 @@
+require "generators/infotable/table/table_generator"
+
+module Infotable
+  module Mcp
+    # Renders a table with the `infotable:table` generator into a scratch directory,
+    # so the code can be shown first and written to app/infotable only on request.
+    class TableWriter
+      Result = Struct.new(:path, :code, keyword_init: true)
+
+      class Error < StandardError; end
+
+      FLAGS = %i[only skip per_page sort toolbar row_click infinite_scroll countless checkbox authorize].freeze
+
+      def initialize(model, settings = {})
+        @model = model.to_s
+        @settings = settings.to_h.symbolize_keys.slice(*FLAGS).compact
+      end
+
+      def render
+        raise Error, "unknown model #{@model}" unless @model.safe_constantize.is_a?(Class)
+
+        Dir.mktmpdir("infotable-mcp") do |dir|
+          shell = Thor::Base.shell.new
+          generator = Infotable::Generators::TableGenerator.new([ @model ], switches, destination_root: dir, shell: shell)
+          shell.mute { generator.invoke_all }
+
+          file = Dir.glob("app/infotable/**/*.rb", base: dir).first or raise Error, "the generator wrote nothing"
+          code = File.read(File.join(dir, file))
+          check_syntax!(code)
+          Result.new(path: file, code: code)
+        end
+      end
+
+      # Writes the rendered table into the app; an existing file is only replaced with overwrite: true
+      def write(overwrite: false)
+        result = render
+        target = Rails.root.join(result.path)
+        raise Error, "#{result.path} already exists, pass overwrite: true to replace it" if target.exist? && !overwrite
+
+        target.dirname.mkpath
+        target.write(result.code)
+        result
+      end
+
+      private
+
+      def switches
+        @settings.flat_map do |key, value|
+          flag = "--#{key.to_s.dasherize}"
+          case value
+          when true then [ flag ]
+          when false then [ "--no-#{key.to_s.dasherize}" ]
+          when Array then [ flag, *value.map(&:to_s) ]
+          else [ flag, value.to_s ]
+          end
+        end
+      end
+
+      def check_syntax!(code)
+        RubyVM::InstructionSequence.compile(code)
+      rescue SyntaxError => e
+        raise Error, "generated code does not parse (check authorize/sort values): #{e.message.lines.first&.strip}"
+      end
+    end
+  end
+end

data/lib/infotable/mcp/tools.rb

@@ -0,0 +1,122 @@
+module Infotable
+  module Mcp
+    class ListModels < ::MCP::Tool
+      tool_name "list_models"
+      description "Models of this Rails app with column types, enums and associations. Call first, so column names are not guessed."
+      input_schema(properties: {})
+      annotations(read_only_hint: true)
+
+      def self.call(server_context: nil)
+        Mcp.text(Introspection.models)
+      end
+    end
+
+    class ListTables < ::MCP::Tool
+      tool_name "list_tables"
+      description "InfoTable tables that already exist in app/infotable, with their columns and settings. Use them as the house style."
+      input_schema(properties: {})
+      annotations(read_only_hint: true)
+
+      def self.call(server_context: nil)
+        Mcp.text(Introspection.tables)
+      end
+    end
+
+    class DescribeDsl < ::MCP::Tool
+      tool_name "describe_dsl"
+      description "The table DSL of the installed infotable version: column options, types, filters, formatters, settings. The full guide is the infotable://readme resource."
+      input_schema(properties: {})
+      annotations(read_only_hint: true)
+
+      def self.call(server_context: nil)
+        Mcp.text(Introspection.dsl)
+      end
+    end
+
+    class TableOptions < ::MCP::Tool
+      tool_name "table_options"
+      description "Settings of a new table for a model, as questions with defaults proposed from the model. " \
+                  "Ask the user these (all at once, defaults pre-filled) before calling generate_table."
+      input_schema(properties: { model: { type: "string", description: "Model class name, e.g. Order or Admin::Invoice" } }, required: [ "model" ])
+      annotations(read_only_hint: true)
+
+      def self.call(model:, server_context: nil)
+        Mcp.text(Introspection.table_options(model) || "#{model} is not an ActiveRecord model; call list_models")
+      end
+    end
+
+    class GenerateTable < ::MCP::Tool
+      tool_name "generate_table"
+      description "Generates app/infotable/<models>_table.rb for a model with the infotable:table generator. " \
+                  "Shows the code only; set write: true to save it (refuses to replace a file unless overwrite: true). " \
+                  "Answers from table_options map to the parameters. Run validate_table afterwards."
+      input_schema(
+        properties: {
+          model: { type: "string" },
+          only: { type: "array", items: { type: "string" }, description: "Only these columns" },
+          skip: { type: "array", items: { type: "string" }, description: "Leave these columns out" },
+          per_page: { type: "integer" },
+          sort: { type: "string", description: "column:direction, e.g. created_at:desc" },
+          toolbar: { type: "string", enum: %w[header rail] },
+          row_click: { type: "boolean" },
+          infinite_scroll: { type: "boolean" },
+          countless: { type: "boolean" },
+          checkbox: { type: "boolean" },
+          authorize: { type: "string", description: "Ruby expression over `controller`, e.g. controller.current_user&.admin?" },
+          write: { type: "boolean", description: "Save the file (default: only show the code)" },
+          overwrite: { type: "boolean" }
+        },
+        required: [ "model" ]
+      )
+
+      def self.call(model:, write: false, overwrite: false, server_context: nil, **settings)
+        writer = TableWriter.new(model, settings)
+        result = write ? writer.write(overwrite: overwrite) : writer.render
+        Mcp.text(path: result.path, written: write, code: result.code)
+      rescue TableWriter::Error => e
+        Mcp.error(e.message)
+      end
+    end
+
+    class ValidateTable < ::MCP::Tool
+      tool_name "validate_table"
+      description "Loads a table (by name like posts_table, or from source code) and reports mistakes: missing columns, bad default sort, " \
+                  "failing query. preview: N also returns the first N rows as the table would show them."
+      input_schema(
+        properties: {
+          name: { type: "string", description: "Table name, e.g. orders_table or admin_orders_table" },
+          source: { type: "string", description: "Table source code to check without saving it" },
+          preview: { type: "integer", description: "Rows to return (max 20)" }
+        }
+      )
+      annotations(read_only_hint: true)
+
+      def self.call(name: nil, source: nil, preview: 0, server_context: nil)
+        return Mcp.error("pass name or source") if name.blank? && source.blank?
+
+        Mcp.text(TableChecker.new(name: name, source: source, preview: preview).call)
+      rescue Infotable::TableResolver::NotFound, ScriptError, StandardError => e
+        Mcp.error("#{e.class}: #{e.message}")
+      end
+    end
+
+    class NewTablePrompt < ::MCP::Prompt
+      prompt_name "new_table"
+      description "Create an InfoTable table for a model, asking the user about its settings first"
+      arguments [ ::MCP::Prompt::Argument.new(name: "model", description: "Model class name", required: true) ]
+
+      def self.template(args, server_context: nil)
+        model = args["model"] || args[:model]
+        text = <<~TEXT
+          Create an InfoTable table for #{model}.
+          1. Call list_tables to see how tables in this app look, and table_options for #{model}.
+          2. Ask the user the questions of table_options in ONE message, with the proposed defaults filled in, and wait for the answers.
+          3. Call generate_table with the answers (without write) and show the code.
+          4. After the user agrees, call generate_table with write: true, then validate_table with preview: 5 and report the result.
+          Add a batch action, formatter or association column only when the user asks; describe_dsl lists what exists.
+        TEXT
+        ::MCP::Prompt::Result.new(messages: [ ::MCP::Prompt::Message.new(role: "user", content: ::MCP::Content::Text.new(text)) ])
+      end
+    end
+  end
+end

data/lib/infotable/mcp.rb

@@ -0,0 +1,30 @@
+begin
+  require "mcp"
+rescue LoadError
+  abort "infotable-mcp needs the mcp gem: add `gem \"mcp\", group: :development` to your Gemfile and run bundle install"
+end
+
+require "json"
+require "rails/generators"
+require "tmpdir"
+
+module Infotable
+  # MCP server for creating tables with an AI assistant. See exe/infotable-mcp.
+  module Mcp
+    autoload :Introspection, "infotable/mcp/introspection"
+    autoload :Server, "infotable/mcp/server"
+    autoload :TableWriter, "infotable/mcp/table_writer"
+    autoload :TableChecker, "infotable/mcp/table_checker"
+
+    def self.text(payload)
+      text = payload.is_a?(String) ? payload : JSON.pretty_generate(payload)
+      ::MCP::Tool::Response.new([ { type: "text", text: text } ])
+    end
+
+    def self.error(message)
+      ::MCP::Tool::Response.new([ { type: "text", text: message } ], error: true)
+    end
+  end
+end
+
+require "infotable/mcp/tools"

data/lib/infotable/version.rb

@@ -1,3 +1,3 @@
 module Infotable
-  VERSION = "1.5.0"
+  VERSION = "1.6.0"
 end

data/lib/infotable.rb

@@ -1,3 +1,4 @@
+require "rails-i18n"
 require "infotable/version"
 require "infotable/configuration"
 require "infotable/engine"
@@ -24,6 +25,27 @@ module Infotable
     autoload :LinkFormatter, "infotable/formatters/link_formatter"
     autoload :AvatarFormatter, "infotable/formatters/avatar_formatter"
     autoload :PercentFormatter, "infotable/formatters/percent_formatter"
+    autoload :NumberFormatter, "infotable/formatters/number_formatter"
+    autoload :TagsFormatter, "infotable/formatters/tags_formatter"
+    autoload :TruncateFormatter, "infotable/formatters/truncate_formatter"
+    autoload :ImageFormatter, "infotable/formatters/image_formatter"
+    autoload :FilesizeFormatter, "infotable/formatters/filesize_formatter"
+    autoload :DurationFormatter, "infotable/formatters/duration_formatter"
+
+    # `formatter: :name` => class. Anything else is looked up as a custom "<Name>Formatter" constant.
+    def self.built_in
+      @built_in ||= {
+        date: DateFormatter, datetime: DateFormatter,
+        currency: CurrencyFormatter,
+        boolean: BooleanFormatter,
+        badge: BadgeFormatter, status: BadgeFormatter,
+        action: ActionFormatter, actions: ActionFormatter,
+        link: LinkFormatter, avatar: AvatarFormatter, percent: PercentFormatter,
+        number: NumberFormatter, tags: TagsFormatter, list: TagsFormatter,
+        truncate: TruncateFormatter, image: ImageFormatter,
+        filesize: FilesizeFormatter, duration: DurationFormatter
+      }.freeze
+    end
   end
 
   # Returns the root path of the InfoTable gem

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: infotable
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Jakub Cieślar
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2026-10-25 00:00:00.000000000 Z
+date: 2026-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: rails-i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
 - !ruby/object:Gem::Dependency
   name: csv
   requirement: !ruby/object:Gem::Requirement
@@ -122,12 +136,27 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: InfoTable provides server-side datatable functionality with filtering,
   sorting, searching, and pagination. Built with Hotwire, Stimulus, and Tailwind CSS
   for a modern, no-reload user experience.
 email:
 - jakub@infovation.pl
-executables: []
+executables:
+- infotable-mcp
 extensions: []
 extra_rdoc_files: []
 files:
@@ -165,9 +194,15 @@ files:
 - app/views/infotable/tables/show.html.erb
 - app/views/layouts/infotable/application.html.erb
 - config/importmap.rb
+- config/locales/de.yml
+- config/locales/el.yml
 - config/locales/en.yml
+- config/locales/es.yml
+- config/locales/fr.yml
+- config/locales/it.yml
 - config/locales/pl.yml
 - config/routes.rb
+- exe/infotable-mcp
 - lib/generators/infotable/install/install_generator.rb
 - lib/generators/infotable/install/templates/initializer.rb
 - lib/generators/infotable/install/templates/tailwind.config.js
@@ -186,8 +221,20 @@ files:
 - lib/infotable/formatters/boolean_formatter.rb
 - lib/infotable/formatters/currency_formatter.rb
 - lib/infotable/formatters/date_formatter.rb
+- lib/infotable/formatters/duration_formatter.rb
+- lib/infotable/formatters/filesize_formatter.rb
+- lib/infotable/formatters/image_formatter.rb
 - lib/infotable/formatters/link_formatter.rb
+- lib/infotable/formatters/number_formatter.rb
 - lib/infotable/formatters/percent_formatter.rb
+- lib/infotable/formatters/tags_formatter.rb
+- lib/infotable/formatters/truncate_formatter.rb
+- lib/infotable/mcp.rb
+- lib/infotable/mcp/introspection.rb
+- lib/infotable/mcp/server.rb
+- lib/infotable/mcp/table_checker.rb
+- lib/infotable/mcp/table_writer.rb
+- lib/infotable/mcp/tools.rb
 - lib/infotable/search_processor.rb
 - lib/infotable/sql.rb
 - lib/infotable/table_resolver.rb