Add locales (#8107)

.github/workflows/tests.yml

@@ -384,13 +384,11 @@ jobs:
           bundle exec setup_exercism_local_aws
 
       - name: Install Chrome
-        env:
-          CHROME_VERSION: "127.0.6533.119"
         run: |
-          # Download specific Chrome version
-          wget https://dl.google.com/linux/chrome/deb/pool/main/g/google-chrome-stable/google-chrome-stable_${CHROME_VERSION}-1_amd64.deb
+          # Download current stable Chrome version
+          wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
           # Install Chrome
-          sudo apt-get install -y --allow-downgrades ./google-chrome-stable_${CHROME_VERSION}-1_amd64.deb
+          sudo apt-get install -y ./google-chrome-stable_current_amd64.deb
 
       - uses: nanasess/setup-chromedriver@v2
       - name: Start chromedriver

.gitignore

@@ -59,5 +59,5 @@ config/settings.local.yml
 app/javascript/i18n/.env
 vendor/bundle/
 
-# Claude local settings
+# Claude files
 .claude/

.rubocop.yml

@@ -15,6 +15,8 @@ AllCops:
     - "node_modules/**/*"
     - "lib/solargraph-rails.rb"
     - "scripts/**/*"
+    - "i18n/**/*"
+    - "config/initializers/i18n.rb"
 
 Bundler/OrderedGems:
   Enabled: false

AGENTS.md

@@ -100,6 +100,13 @@ rm -rf .built-assets/              # Clear asset cache if needed
 - `app/controllers/spi/` - Internal service endpoints
 - `test/` - All test files
 - `docs/context/` - Detailed component documentation
+- `scripts/llm/` - Helper scripts created by AI agents
+
+**Script Organization:**
+
+- **Always create new scripts in `scripts/llm/`** - This keeps AI-generated scripts organized and separate from core application scripts
+- Use descriptive names like `merge_locales.rb` or `fix_data.rb`
+- Include comments explaining what the script does and when to use it
 
 **When editing:**
 
@@ -109,6 +116,11 @@ rm -rf .built-assets/              # Clear asset cache if needed
 4. Add appropriate tests (see testing docs)
 5. Run pre-commit validation commands
 
+**Code Style:**
+
+- **Always use symbol key syntax (`key:`) in hashes** - Use `{ name: "value" }` not `{ "name" => "value" }` unless there's a specific reason to use string keys (like when the key contains special characters or spaces)
+- This applies to serializers, API responses, and all Ruby hash structures
+
 ## Reference Documentation
 
 - `docs/context/overview.md` - Complete codebase documentation and setup guide

Gemfile

@@ -38,6 +38,7 @@ gem 'octokit' # GitHub
 gem 'mandate', '~> 2.0'
 gem 'kaminari'
 gem 'oj', '~> 3.14.0'
+gem 'i18n', '>= 0.5.0'
 
 # Setup dependencies
 gem 'exercism-config', '>= 0.130.0'

Gemfile.lock

@@ -665,6 +665,7 @@ DEPENDENCIES
   haml_lint
   hamlit
   humanize
+  i18n (>= 0.5.0)
   image_processing (~> 1.2)
   jsbundling-rails
   kaminari

app/assemblers/assemble_localization_glossary_entries.rb

@@ -0,0 +1,32 @@
+class AssembleLocalizationGlossaryEntries
+  include Mandate
+
+  initialize_with :user, :params
+
+  def self.keys
+    %i[criteria status page exclude_uuids]
+  end
+
+  def call
+    SerializePaginatedCollection.(
+      glossary_entries,
+      serializer: SerializeLocalizationGlossaryEntries,
+      serializer_args: user,
+      meta: {
+        unscoped_total: Localization::GlossaryEntry.count
+      }
+    )
+  end
+
+  memoize
+  def glossary_entries
+    Localization::GlossaryEntry::Search.(
+      user,
+      criteria: params[:criteria],
+      status: params[:status],
+      page: params[:page],
+      locale: params[:filter_locale],
+      exclude_uuids: params[:exclude_uuids]
+    )
+  end
+end

app/assemblers/assemble_localization_originals.rb

@@ -0,0 +1,30 @@
+class AssembleLocalizationOriginals
+  include Mandate
+
+  initialize_with :user, :params
+
+  def self.keys
+    %i[criteria status page]
+  end
+
+  def call
+    SerializePaginatedCollection.(
+      translations,
+      serializer: SerializeLocalizationOriginals,
+      serializer_args: user,
+      meta: {
+        unscoped_total: Localization::Original.count
+      }
+    )
+  end
+
+  memoize
+  def translations
+    Localization::Original::Search.(
+      user,
+      criteria: params[:criteria],
+      status: params[:status],
+      page: params[:page]
+    )
+  end
+end

app/channels/localization_translation_channel.rb

@@ -0,0 +1,22 @@
+class LocalizationTranslationChannel < ApplicationCable::Channel
+  def self.broadcast!(translation)
+    ActionCable.server.broadcast(
+      channel_name(translation.locale),
+      {
+        key: translation.key,
+        locale: translation.locale,
+        value: translation.value
+      }
+    )
+  end
+
+  def subscribed
+    stream_from self.class.channel_name(params[:locale])
+  end
+
+  def unsubscribed; end
+
+  def self.channel_name(locale)
+    "localization_translations_#{locale}"
+  end
+end

app/commands/cache/key_for_footer.rb

@@ -9,7 +9,8 @@ def call
     parts << ::Track.num_active
     parts << user_part
     parts << stripe_version
-    parts << "v3"
+    parts << I18n.available_locales.count
+    parts << "3" # Basic expiry key
 
     parts.join(':')
   end

app/commands/generic_exercise/create_or_update.rb

@@ -1,20 +1,43 @@
 class GenericExercise::CreateOrUpdate
   include Mandate
 
-  initialize_with :slug, :title, :blurb, :source, :source_url, :deep_dive_youtube_id, :deep_dive_blurb, :status
+  initialize_with :repo_exercise
 
   def call
     create!.tap do |exercise|
       exercise.update!(attributes)
+
+      localize!(:generic_exercise_instructions, repo_exercise.instructions, exercise)
+      localize!(:generic_exercise_introduction, repo_exercise.introduction, exercise)
+      localize!(:generic_exercise_title, repo_exercise.title, exercise)
+      localize!(:generic_exercise_blurb, repo_exercise.blurb, exercise)
+      localize!(:generic_exercise_source, repo_exercise.source, exercise)
     end
   end
 
   private
   def create!
-    GenericExercise.find_create_or_find_by!(slug:) do |exercise|
+    GenericExercise.find_create_or_find_by!(slug: repo_exercise.slug) do |exercise|
       exercise.attributes = attributes
     end
   end
 
-  def attributes = { title:, blurb:, source:, source_url:, deep_dive_youtube_id:, deep_dive_blurb:, status: }
+  def localize!(type, content, exercise)
+    return unless content.present?
+
+    Localization::Text::AddToLocalization.defer(type, content, exercise)
+  end
+
+  memoize
+  def attributes
+    {
+      title: repo_exercise.title,
+      blurb: repo_exercise.blurb&.truncate(255),
+      source: repo_exercise.source,
+      source_url: repo_exercise.source_url,
+      deep_dive_youtube_id: repo_exercise.deep_dive_youtube_id,
+      deep_dive_blurb: repo_exercise.deep_dive_blurb,
+      status: repo_exercise.deprecated? ? :deprecated : :active
+    }
+  end
 end

app/commands/git/sync_blog.rb

@@ -35,10 +35,20 @@ def create_or_update_post(data)
     end
 
     post.update!(attributes)
+
+    localize!(:post_title, post.title, post.id)
+    localize!(:post_description, post.description, post.id)
+    localize!(:post_content, post.content, post.id)
   rescue StandardError => e
     Github::Issue::OpenForBlogSyncFailure.(e, repo.head_commit.oid)
   end
 
+  def localize!(type, content, post_id)
+    return unless content.present?
+
+    Localization::Text::AddToLocalization.defer(type, content, post_id)
+  end
+
   def create_or_update_story(data)
     interviewer = User.find_by!(handle: data[:interviewer_handle])
     interviewee = User.find_by!(handle: data[:interviewee_handle])

app/commands/git/sync_concept.rb

@@ -20,11 +20,22 @@ def call
 
     Git::SyncConceptAuthors.(concept)
     Git::SyncConceptContributors.(concept)
+
+    localize!(:concept_name, concept.name)
+    localize!(:concept_blurb, concept.blurb)
+    localize!(:concept_introduction, concept.introduction)
+    localize!(:concept_about, concept.about)
   end
 
   private
   attr_reader :concept, :force_sync
 
+  def localize!(type, content)
+    return unless content.present?
+
+    Localization::Text::AddToLocalization.defer(type, content, concept.id)
+  end
+
   def concept_needs_updating?
     track_config_concept_modified? || concept_config_modified?
   end

app/commands/git/sync_concept_exercise.rb

@@ -31,11 +31,23 @@ def call
     Git::SyncExerciseArticles.(exercise)
     ::Exercise::UpdateHasApproaches.(exercise)
     SiteUpdates::ProcessNewExerciseUpdate.(exercise)
+
+    localize!(:exercise_instructions, exercise.instructions, exercise)
+    localize!(:exercise_introduction, exercise.introduction, exercise)
+    localize!(:exercise_title, exercise.title, exercise)
+    localize!(:exercise_blurb, exercise.blurb, exercise)
+    localize!(:exercise_source, exercise.source, exercise)
   end
 
   private
   attr_reader :exercise, :force_sync
 
+  def localize!(type, content, exercise)
+    return unless content.present?
+
+    Localization::Text::AddToLocalization.defer(type, content, exercise)
+  end
+
   def exercise_needs_updating?
     track_config_exercise_modified? || exercise_config_modified? || exercise_files_modified?
   end

app/commands/git/sync_practice_exercise.rb

@@ -32,11 +32,23 @@ def call
     Git::SyncExerciseArticles.(exercise)
     ::Exercise::UpdateHasApproaches.(exercise)
     SiteUpdates::ProcessNewExerciseUpdate.(exercise)
+
+    localize!(:exercise_instructions, exercise.instructions, exercise)
+    localize!(:exercise_introduction, exercise.introduction, exercise)
+    localize!(:exercise_title, exercise.title, exercise)
+    localize!(:exercise_blurb, exercise.blurb, exercise)
+    localize!(:exercise_source, exercise.source, exercise)
   end
 
   private
   attr_reader :exercise, :force_sync
 
+  def localize!(type, content, exercise)
+    return unless content.present?
+
+    Localization::Text::AddToLocalization.defer(type, content, exercise)
+  end
+
   def exercise_needs_updating?
     track_config_exercise_modified? || exercise_config_modified? || exercise_files_modified?
   end

app/commands/git/sync_problem_specifications.rb

@@ -7,12 +7,7 @@ def call
     repo.update!
 
     repo.exercises.each do |exercise|
-      GenericExercise::CreateOrUpdate.(
-        exercise.slug, exercise.title, exercise.blurb,
-        exercise.source, exercise.source_url,
-        exercise.deep_dive_youtube_id, exercise.deep_dive_blurb,
-        exercise.deprecated? ? :deprecated : :active
-      )
+      GenericExercise::CreateOrUpdate.(exercise)
     rescue StandardError => e
       Bugsnag.notify(e)
     end

app/commands/llm/exec.rb

@@ -0,0 +1,22 @@
+class LLM::Exec
+  include Mandate
+
+  initialize_with :service, :model, :prompt, :spi_endpoint, :stream_channel
+
+  def call
+    raise "Service cannot be nil" if service.nil?
+    raise "Model cannot be nil" if model.nil?
+    raise "Prompt cannot be nil" if prompt.nil?
+    raise "SPI endpoint cannot be nil" if spi_endpoint.nil?
+
+    LLM::ExecWithPayload.(
+      {
+        service: service,
+        model: model,
+        spi_endpoint: "llm/#{spi_endpoint}",
+        stream_channel: stream_channel,
+        prompt: prompt
+      }
+    )
+  end
+end

app/commands/llm/exec_gemini_flash.rb

@@ -0,0 +1,9 @@
+class LLM::ExecGeminiFlash
+  include Mandate
+
+  initialize_with :prompt, :spi_endpoint, stream_channel: nil
+
+  def call
+    LLM::Exec.(:gemini, :flash, prompt, spi_endpoint, stream_channel)
+  end
+end

app/commands/llm/exec_with_payload.rb

@@ -0,0 +1,18 @@
+# Don't call this directly unless you're
+# dealing with specific LLM retries etc.
+# Instead use the LLM::Exec command.
+class LLM::ExecWithPayload
+  include Mandate
+
+  initialize_with :payload
+
+  def call
+    RestClient.post(
+      proxy_url,
+      payload.to_json,
+      { content_type: :json, accept: :json }
+    )
+  end
+
+  def proxy_url = "http://localhost:8080/exec"
+end

app/commands/localization/cache/retrieve.rb

@@ -0,0 +1,11 @@
+class Localization::Cache::Retrieve
+  include Mandate
+
+  initialize_with :locale, :key
+
+  def call
+    return unless Localization.use_cache
+
+    Localization.translations.dig(locale.to_sym, key)
+  end
+end