jekyll-theme-zer0 1.28.0 → 1.30.0

data/scripts/translate.rb

@@ -170,8 +170,30 @@ module Zer0Translate
       masked
     end
 
+    # A masked span can carry a placeholder minted by an earlier pattern: a
+    # Liquid expression inside a link destination (`](⟦3⟧)`), or inside an
+    # inline code span (`` `⟦8⟧` ``). `gsub` never rescans its own replacement
+    # text, so one pass restores the outer span and strands the inner token as
+    # a literal ⟦N⟧ in the published page. Substitute until the text stops
+    # changing — nesting can only run as deep as the pattern list is long — and
+    # refuse to hand back anything still holding a placeholder, so a corrupt
+    # page fails its job instead of shipping.
     def unmask(text)
-      text.gsub(PLACEHOLDER_RE) { |token| @map.fetch(token, token) }
+      result = text
+      (INLINE_PATTERNS.length + 1).times do
+        expanded = result.gsub(PLACEHOLDER_RE) { |token| @map.fetch(token, token) }
+        break if expanded == result
+
+        result = expanded
+      end
+
+      leftover = result.scan(PLACEHOLDER_RE).uniq
+      unless leftover.empty?
+        raise Translator::TranslationError,
+              "unresolved placeholder(s) #{leftover.join(', ')} after unmasking"
+      end
+
+      result
     end
   end
 
@@ -424,16 +446,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 +476,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 +568,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 +749,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 +785,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.30.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-09 00:00:00.000000000 Z
+date: 2026-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -79,6 +79,7 @@ files:
 - README.md
 - _data/README.md
 - _data/ai.yml
+- _data/ai_pricing.yml
 - _data/authors.yml
 - _data/backlog.yml
 - _data/consumers.yml
@@ -92,6 +93,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,10 +105,12 @@ 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
 - _data/series.yml
+- _data/site_builder.yml
 - _data/statistics_config.yml
 - _data/theme-manifest.yml
 - _data/theme_backgrounds.yml
@@ -129,6 +133,7 @@ files:
 - _includes/components/author-card.html
 - _includes/components/author-eeat.html
 - _includes/components/background-customizer.html
+- _includes/components/background-image.html
 - _includes/components/background-settings.html
 - _includes/components/book-card.html
 - _includes/components/book-nav.html
@@ -159,11 +164,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
@@ -226,6 +245,8 @@ files:
 - _includes/navigation/unified-drawer.html
 - _includes/obsidian/full-graph.html
 - _includes/search-data.json
+- _includes/setup/claude-session.html
+- _includes/setup/prereq-checklist.html
 - _includes/setup/wizard.html
 - _includes/stats/README.md
 - _includes/stats/stats-categories.html
@@ -244,6 +265,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 +273,7 @@ files:
 - _layouts/news.html
 - _layouts/note.html
 - _layouts/notebook.html
+- _layouts/recipe.html
 - _layouts/root.html
 - _layouts/search.html
 - _layouts/section.html
@@ -272,11 +295,15 @@ files:
 - _sass/components/_content-tables.scss
 - _sass/components/_cookie-banner.scss
 - _sass/components/_footer.scss
+- _sass/components/_mermaid.scss
 - _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 +337,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
@@ -334,7 +362,10 @@ files:
 - assets/js/code-copy.js
 - assets/js/config-utility.js
 - assets/js/docs.min.js
+- assets/js/fleet-feedback-capture.js
+- assets/js/fleet-feedback.js
 - assets/js/halfmoon.js
+- assets/js/mermaid-diagrams.js
 - assets/js/modules/navigation/config.js
 - assets/js/modules/navigation/focus.js
 - assets/js/modules/navigation/gestures.js
@@ -356,14 +387,17 @@ 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
 - assets/js/side-bar-folders.js
+- assets/js/site-builder.js
 - assets/js/skin-editor.js
 - assets/js/stats.js
 - assets/js/table-copy.js
@@ -409,6 +443,10 @@ files:
 - assets/vendor/mathjax/es5/tex-mml-chtml.js
 - assets/vendor/mermaid/mermaid.min.js
 - scripts/README.md
+- scripts/ai/README.md
+- scripts/ai/api_call.rb
+- scripts/ai/usage.rb
+- scripts/ai/usage_report.rb
 - scripts/analyze-commits.sh
 - scripts/bin/audit-consumer
 - scripts/bin/build
@@ -420,9 +458,14 @@ 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/ci/test_visual_evidence_autogen.py
+- scripts/ci/visual_evidence_autogen.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 +568,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 +593,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
@@ -559,6 +604,7 @@ files:
 - scripts/test/lib/test_pixelate_images.sh
 - scripts/test/lib/test_validation.sh
 - scripts/test/lib/test_version.sh
+- scripts/test/lib/test_visual_evidence_autogen.sh
 - scripts/test/theme/validate
 - scripts/translate.rb
 - scripts/update-preview-paths.sh