locallingo 0.1.0

data/lib/locallingo/validators/missing.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Locallingo
+  module Validators
+    # Reports keys present in the source locale but absent from a target locale.
+    class Missing
+      def initialize(cli_name: "lingo")
+        @cli_name = cli_name
+      end
+
+      # +source+ and +target+ are flat key=>value hashes for one target +locale+.
+      def call(source:, target:, locale:)
+        (source.keys - target.keys).map do |key|
+          {
+            type: :missing,
+            locale:,
+            key:,
+            suggestion: "Run: #{@cli_name} translate --locale #{locale}"
+          }
+        end
+      end
+    end
+  end
+end

data/lib/locallingo/validators/outdated.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "../state_store"
+
+module Locallingo
+  module Validators
+    # Reports target keys whose recorded source hash no longer matches the
+    # current source value — i.e. the English text changed after translation.
+    class Outdated
+      def initialize(cli_name: "lingo")
+        @cli_name = cli_name
+      end
+
+      # +source+ is the flat source hash; +locale_state+ is the target locale's
+      # loaded state (key => { "source_hash" => ... }).
+      def call(source:, locale_state:, locale:)
+        outdated_keys(source, locale_state).map do |key|
+          {
+            type: :outdated,
+            locale:,
+            key:,
+            suggestion: "Source changed. Run: #{@cli_name} translate --locale #{locale} --force-key #{key}"
+          }
+        end
+      end
+
+      # Keys whose stored source_hash differs from the current source hash.
+      def outdated_keys(source, locale_state)
+        source.filter_map do |key, value|
+          stored = locale_state.dig(key, "source_hash")
+          key if stored && stored != StateStore.hash(value)
+        end
+      end
+    end
+  end
+end

data/lib/locallingo/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Locallingo
+  VERSION = "0.1.0"
+end

data/lib/locallingo.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "locallingo/version"
+require_relative "locallingo/configuration"
+require_relative "locallingo/json_extraction"
+require_relative "locallingo/key_flattener"
+require_relative "locallingo/state_store"
+require_relative "locallingo/providers/ruby_llm"
+require_relative "locallingo/validators/missing"
+require_relative "locallingo/validators/outdated"
+require_relative "locallingo/validators/duplicate_values"
+require_relative "locallingo/validators/manual_edits"
+require_relative "locallingo/quality/static_rules"
+require_relative "locallingo/quality/british_spellings"
+require_relative "locallingo/quality/terminology"
+require_relative "locallingo/manager"
+require_relative "locallingo/quality_checker"
+require_relative "locallingo/reporter"
+require_relative "locallingo/cli"
+
+# Locallingo — AI-assisted i18n translation, drift detection and quality linting.
+#
+# The public entry points are the `lingo` CLI (exe/lingo → Locallingo::CLI) and,
+# programmatically, Locallingo::Manager / Locallingo::QualityChecker, both driven
+# by a Locallingo::Configuration loaded from `.locallingo.yml`.
+module Locallingo
+  class Error < StandardError; end
+
+  # Raised when an LLM call is attempted but the configured provider has no
+  # credentials available.
+  class MissingCredentialsError < Error; end
+
+  # Load the configuration for +root_path+ (defaults to the current directory),
+  # optionally scoped to a package path from the `packages:` list.
+  def self.configuration(root_path: Dir.pwd, package: nil)
+    Configuration.load(root_path:, package:)
+  end
+end

data/lib/rubocop/cop/locallingo/relative_i18n_key.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Locallingo
+      # Enforces fully-qualified i18n keys instead of relative keys.
+      #
+      # Relative keys (e.g. `t(".notice")`) depend on Rails' lazy lookup, which is
+      # implicit and fragile: moving a translation between files, renaming an
+      # action, or reusing a string in a different context all silently break the
+      # lookup. Fully qualified keys are explicit and grep-able.
+      #
+      # The autocorrector mirrors Rails' lazy-lookup scope, deriving the prefix
+      # from the file path (mapped through `ScopedDirectories`) plus the enclosing
+      # method name. When the path does not map to a known convention it flags the
+      # offense but leaves qualification to the developer rather than guessing.
+      #
+      # The set of scoped directories is configurable so the cop fits apps with
+      # different layouts:
+      #
+      #   Locallingo/RelativeI18nKey:
+      #     ScopedDirectories: [controllers, mailers, views, components]
+      #
+      # @example
+      #   # bad
+      #   t(".title")
+      #   t(".nested.key")
+      #
+      #   # good
+      #   t("users.index.title")
+      #   t("users.show.nested.key")
+      class RelativeI18nKey < Base
+        extend AutoCorrector
+
+        MSG = "Use fully-qualified i18n key instead of relative key `%<key>s`."
+
+        DEFAULT_SCOPED_DIRECTORIES = %w[
+          controllers mailers views components models services jobs notifiers
+        ].freeze
+
+        # @!method t_with_string_arg?(node)
+        def_node_matcher :t_with_string_arg?, <<~PATTERN
+          (send nil? :t (str $_) ...)
+        PATTERN
+
+        def on_send(node)
+          t_with_string_arg?(node) do |key|
+            next unless key.start_with?(".")
+
+            add_offense(node, message: format(MSG, key:)) do |corrector|
+              qualified = qualify(node, key)
+              next unless qualified
+
+              corrector.replace(node.first_argument, "\"#{qualified}\"")
+            end
+          end
+        end
+
+        private
+
+        def scoped_directories
+          Array(cop_config["ScopedDirectories"]).then do |configured|
+            configured.empty? ? DEFAULT_SCOPED_DIRECTORIES : configured
+          end
+        end
+
+        def qualify(node, relative_key)
+          scope = lazy_lookup_scope(node)
+          return nil unless scope
+
+          "#{scope}#{relative_key}"
+        end
+
+        # Mirrors Rails' lazy-lookup scope. Returns nil if the path does not map
+        # to a known convention (we'd rather flag and require manual
+        # qualification than guess wrong).
+        def lazy_lookup_scope(node)
+          path = processed_source.file_path
+          return nil if path.nil?
+
+          rel = path.sub(%r{\A.*?app/}, "")
+          dir = rel.split("/").first
+          return nil unless scoped_directories.include?(dir)
+
+          file_scope = rel.sub(%r{\A[^/]+/}, "").delete_suffix(".rb")
+          file_scope = file_scope.delete_suffix("_controller").delete_suffix("_mailer")
+          base = file_scope.tr("/", ".")
+
+          method_name = enclosing_method(node)
+          method_name ? "#{base}.#{method_name}" : base
+        end
+
+        def enclosing_method(node)
+          node.each_ancestor(:def).first&.method_name&.to_s
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/locallingo/strftime_in_view.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Locallingo
+      # Enforces `I18n.l(value, format: :name)` instead of `.strftime(...)` in
+      # view files.
+      #
+      # Hardcoded strftime patterns bypass locale-aware formatting. Use I18n.l
+      # with named formats defined in config/locales/time.*.yml and date.*.yml.
+      #
+      # `.strftime` inside a `value:` pair is exempt: HTML datetime-local input
+      # values must follow the HTML spec, not locale display formatting.
+      #
+      # Scope with the standard RuboCop `Include`/`Exclude` in your config:
+      #
+      #   Locallingo/StrftimeInView:
+      #     Include: [app/views/**/*.rb]
+      #     Exclude: [app/views/**/*_mailer/**/*.rb]
+      #
+      # @example
+      #   # bad
+      #   @user.created_at.strftime("%B %d, %Y")
+      #
+      #   # good
+      #   I18n.l(@user.created_at, format: :long)
+      class StrftimeInView < Base
+        MSG = "Use `I18n.l(value, format: :name)` instead of `.strftime(...)`. " \
+              "Define formats in config/locales/{time,date}.*.yml."
+
+        RESTRICT_ON_SEND = %i[strftime].freeze
+
+        def on_send(node)
+          return if in_html_input_context?(node)
+
+          add_offense(node.loc.selector)
+        end
+
+        private
+
+        # Allow strftime for HTML datetime-local input values, where the format
+        # is dictated by the HTML spec, not user display.
+        def in_html_input_context?(node)
+          node.each_ancestor(:pair).any? do |pair|
+            pair.key.value == :value if pair.key.respond_to?(:value)
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: locallingo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mikael Henriksson
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.75'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.75'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+description: Locallingo extends i18n-tasks with AI translation (via RubyLLM — OpenAI,
+  Anthropic, and more), source-hash drift detection so only missing/changed keys are
+  re-translated, and a static + AI translation-quality linter. Everything app-specific
+  — target locales, provider/model, prompt context and glossary, per-language style
+  guides, which validators and quality rules run, and post-translate hooks — is config-driven
+  via `.locallingo.yml`, with a default block plus optional per-package overrides.
+  Ships the `lingo` CLI.
+email: mikael@zoolutions.llc
+executables:
+- lingo
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- config/default.yml
+- config/locallingo.default.yml
+- exe/lingo
+- lib/locallingo.rb
+- lib/locallingo/cli.rb
+- lib/locallingo/configuration.rb
+- lib/locallingo/json_extraction.rb
+- lib/locallingo/key_flattener.rb
+- lib/locallingo/manager.rb
+- lib/locallingo/providers/ruby_llm.rb
+- lib/locallingo/quality/british_spellings.rb
+- lib/locallingo/quality/static_rules.rb
+- lib/locallingo/quality/terminology.rb
+- lib/locallingo/quality_checker.rb
+- lib/locallingo/reporter.rb
+- lib/locallingo/rubocop.rb
+- lib/locallingo/state_store.rb
+- lib/locallingo/validators/duplicate_values.rb
+- lib/locallingo/validators/manual_edits.rb
+- lib/locallingo/validators/missing.rb
+- lib/locallingo/validators/outdated.rb
+- lib/locallingo/version.rb
+- lib/rubocop/cop/locallingo/relative_i18n_key.rb
+- lib/rubocop/cop/locallingo/strftime_in_view.rb
+homepage: https://github.com/mhenrixon/locallingo
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/mhenrixon/locallingo
+  changelog_uri: https://github.com/mhenrixon/locallingo/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/mhenrixon/locallingo/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.9
+specification_version: 4
+summary: AI-assisted i18n translation, drift detection, and quality linting on top
+  of i18n-tasks
+test_files: []