jekyll-theme-zer0 1.28.0 → 1.29.0

data/scripts/translate.rb

@@ -424,16 +424,26 @@ module Zer0Translate
     def initialize(model:, max_tokens:)
       @model = model
       @max_tokens = max_tokens
-      @auth = resolve_auth
+      @candidates = resolve_auth_candidates
       raise "No Anthropic credential found. Set CLAUDE_CODE_OAUTH_TOKEN " \
-            "(from `claude setup-token`), ANTHROPIC_AUTH_TOKEN, or ANTHROPIC_API_KEY." unless @auth
+            "(from `claude setup-token`), ANTHROPIC_AUTH_TOKEN, or ANTHROPIC_API_KEY." if @candidates.empty?
+
+      @auth = @candidates.first
     end
 
     def name = "claude (#{@model})"
 
     def translate(segments, target_lang, context)
-      payload = build_payload(segments, target_lang, context)
-      body = request_with_retries(payload)
+      body = begin
+        # Rebuilt on retry, not hoisted: the payload's first system block
+        # depends on @auth[:mode], so falling back to a different credential
+        # has to re-derive it.
+        request_with_retries(build_payload(segments, target_lang, context))
+      rescue AuthError => e
+        raise ProviderError, e.message unless advance_credential!(e)
+
+        retry
+      end
       text = (body["content"] || []).select { |b| b["type"] == "text" }
                                     .map { |b| b["text"] }.join("\n")
       parsed = extract_json(text)
@@ -444,16 +454,38 @@ module Zer0Translate
 
     class ProviderError < StandardError; end
 
+    # A credential the API refused (401/403), as opposed to any other failure.
+    # Separate so `translate` can fall through to the next configured
+    # credential rather than failing the run outright.
+    class AuthError < ProviderError; end
+
     private
 
-    def resolve_auth
-      if (token = ENV["CLAUDE_CODE_OAUTH_TOKEN"] || ENV["ANTHROPIC_AUTH_TOKEN"])
-        return { mode: :oauth, token: token } unless token.empty?
-      end
-      if (key = ENV["ANTHROPIC_API_KEY"])
-        return { mode: :api_key, token: key } unless key.empty?
-      end
-      nil
+    # Every configured credential, in precedence order.
+    #
+    # Returning the whole list rather than just the first match is the point:
+    # the old lookup skipped credentials that were UNSET but had no way to skip
+    # one the API refused, so a set-but-revoked CLAUDE_CODE_OAUTH_TOKEN shadowed
+    # a working ANTHROPIC_API_KEY and took the whole run down with it.
+    def resolve_auth_candidates
+      [
+        { mode: :oauth,   token: ENV["CLAUDE_CODE_OAUTH_TOKEN"], label: "CLAUDE_CODE_OAUTH_TOKEN" },
+        { mode: :oauth,   token: ENV["ANTHROPIC_AUTH_TOKEN"],    label: "ANTHROPIC_AUTH_TOKEN" },
+        { mode: :api_key, token: ENV["ANTHROPIC_API_KEY"],       label: "ANTHROPIC_API_KEY" },
+      ].reject { |c| c[:token].nil? || c[:token].empty? }
+    end
+
+    # Switch to the next configured credential after this one was refused.
+    # Sticky by design — @auth stays switched for the rest of the run, so a
+    # dead credential costs one rejection in total rather than one per chunk.
+    def advance_credential!(error)
+      current = @candidates.index { |c| c.equal?(@auth) }
+      nxt = @candidates[current + 1]
+      return false unless nxt
+
+      Log.warn "#{@auth[:label]} rejected (#{error.message}); retrying with #{nxt[:label]}"
+      @auth = nxt
+      true
     end
 
     def system_blocks(target_lang)
@@ -514,7 +546,10 @@ module Zer0Translate
         body = JSON.parse(response.body)
         unless code == 200
           message = body.dig("error", "message") || response.body[0, 300]
-          raise ProviderError, "Anthropic API #{code}: #{message}"
+          # 401/403 is the credential, not the request — surface it as an
+          # AuthError so the caller can try the next configured one.
+          klass = [401, 403].include?(code) ? AuthError : ProviderError
+          raise klass, "Anthropic API #{code}: #{message}"
         end
         body
       rescue RetryableError
@@ -692,13 +727,34 @@ module Zer0Translate
       pages[url] ||= {}
     end
 
+    # Writes the manifest only when the mapping itself changed.
+    #
+    # `updated_at` used to be stamped on every save, which meant a run that
+    # translated NOTHING still rewrote the file. That is not hypothetical: with
+    # the API credential rejected, every page failed and the run still produced
+    # a one-line `updated_at` diff — enough for translate.yml to open a PR that
+    # reads like a routine translation refresh and contains no translations.
+    # Serializing with the PREVIOUS timestamp first and comparing against disk
+    # keeps that run a no-op, while any real change (a translated page, a prune)
+    # still stamps and writes.
     def save(source_lang, languages)
+      previous = @data["updated_at"]
       @data["version"] = 1
       @data["source_lang"] = source_lang
       @data["languages"] = languages
-      @data["updated_at"] = Time.now.utc.iso8601
       @data["pages"] = pages.sort.to_h
+
+      @data["updated_at"] = previous
+      return if File.file?(@path) && File.read(@path, encoding: "bom|utf-8") == render
+
+      @data["updated_at"] = Time.now.utc.iso8601
       FileUtils.mkdir_p(File.dirname(@path))
+      File.write(@path, render)
+    end
+
+    private
+
+    def render
       header = <<~HEADER
         # ================================================================
         # GENERATED FILE — do not edit by hand.
@@ -707,7 +763,7 @@ module Zer0Translate
         # _includes/components/language-toggle.html and _includes/core/hreflang.html.
         # ================================================================
       HEADER
-      File.write(@path, header + @data.to_yaml.sub(/\A---\n/, ""))
+      header + @data.to_yaml.sub(/\A---\n/, "")
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.28.0
+  version: 1.29.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-09 00:00:00.000000000 Z
+date: 2026-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -92,6 +92,7 @@ files:
 - _data/i18n/fr.yml
 - _data/i18n/languages.yml
 - _data/i18n/manifest.yml
+- _data/ingredient_densities.yml
 - _data/landing.yml
 - _data/navigation/README.md
 - _data/navigation/about.yml
@@ -103,6 +104,7 @@ files:
 - _data/navigation/quickstart.yml
 - _data/posts_organization.yml
 - _data/prerequisites.yml
+- _data/recipe_courses.yml
 - _data/roadmap.yml
 - _data/roadmap_plan.yml
 - _data/routing.yml
@@ -159,11 +161,25 @@ files:
 - _includes/components/nav-export.html
 - _includes/components/nav-overview.html
 - _includes/components/page-feedback.html
+- _includes/components/page-views-init.html
+- _includes/components/page-views.html
 - _includes/components/post-card.html
 - _includes/components/post-type-badge.html
 - _includes/components/powered-by.html
 - _includes/components/preview-image.html
 - _includes/components/quick-index.html
+- _includes/components/recipe-card.html
+- _includes/components/recipe-duration.html
+- _includes/components/recipe-grams.html
+- _includes/components/recipe-index.html
+- _includes/components/recipe-ingredients.html
+- _includes/components/recipe-meta.html
+- _includes/components/recipe-nutrition.html
+- _includes/components/recipe-qty.html
+- _includes/components/recipe-ratio.html
+- _includes/components/recipe-scaler.html
+- _includes/components/recipe-steps.html
+- _includes/components/recipe-temp.html
 - _includes/components/search-modal.html
 - _includes/components/searchbar.html
 - _includes/components/section.html
@@ -244,6 +260,7 @@ files:
 - _layouts/book-story.html
 - _layouts/book.html
 - _layouts/collection.html
+- _layouts/cookbook.html
 - _layouts/default.html
 - _layouts/home.html
 - _layouts/index.html
@@ -251,6 +268,7 @@ files:
 - _layouts/news.html
 - _layouts/note.html
 - _layouts/notebook.html
+- _layouts/recipe.html
 - _layouts/root.html
 - _layouts/search.html
 - _layouts/section.html
@@ -275,8 +293,11 @@ files:
 - _sass/components/_notes-index.scss
 - _sass/components/_notes.scss
 - _sass/components/_page-feedback.scss
+- _sass/components/_page-views.scss
 - _sass/components/_post-navigation.scss
+- _sass/components/_recipe.scss
 - _sass/components/_search-modal.scss
+- _sass/components/_setup-wizard.scss
 - _sass/components/_skeleton.scss
 - _sass/components/_theme-preview.scss
 - _sass/components/_ui-enhancements.scss
@@ -310,6 +331,7 @@ files:
 - _sass/tokens/_index.scss
 - _sass/tokens/_layers.scss
 - _sass/tokens/_motion.scss
+- _sass/tokens/_radius.scss
 - _sass/tokens/_shadow.scss
 - _sass/tokens/_spacing.scss
 - _sass/tokens/_typography.scss
@@ -356,10 +378,12 @@ files:
 - assets/js/obsidian-local-graph.js
 - assets/js/obsidian-wiki-links.js
 - assets/js/page-feedback.js
+- assets/js/page-views.js
 - assets/js/palette-generator.js
 - assets/js/particles-source.js
 - assets/js/particles.js
 - assets/js/posts-pagination.js
+- assets/js/recipe-scaler.js
 - assets/js/search-modal.js
 - assets/js/setup-wizard.js
 - assets/js/share-actions.js
@@ -420,9 +444,12 @@ files:
 - scripts/bin/test
 - scripts/bin/validate
 - scripts/build
+- scripts/ci/agent_review_result.py
 - scripts/ci/classify_changes.py
+- scripts/ci/test_agent_review_result.py
 - scripts/content-review.rb
 - scripts/convert-notebooks.sh
+- scripts/design-system-check.rb
 - scripts/dev/css-diff.sh
 - scripts/dev/rasterize-svg.js
 - scripts/dev/shot.js
@@ -525,6 +552,7 @@ files:
 - scripts/lib/template.sh
 - scripts/lib/validation.sh
 - scripts/lib/version.sh
+- scripts/lint-liquid-raw.rb
 - scripts/lint-pages
 - scripts/migrate-nav-modes.sh
 - scripts/migrate.sh
@@ -549,6 +577,7 @@ files:
 - scripts/test/integration/auto-version
 - scripts/test/integration/mermaid
 - scripts/test/lib/run_tests.sh
+- scripts/test/lib/test_agent_review_result.sh
 - scripts/test/lib/test_analyze_commits.sh
 - scripts/test/lib/test_changelog.sh
 - scripts/test/lib/test_content_review.sh