pandorga 1.11.0 → 1.13.0

data/scripts/test/test-studio-taxonomy.rb

@@ -0,0 +1,246 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Refs: PLT-AC-43
+require "pathname"
+require "yaml"
+require "fileutils"
+require "tmpdir"
+require "open3"
+require "date"
+
+ROOT = Pathname.new(__dir__).join("../..").expand_path
+EXE = ROOT.join("exe/pandorga")
+GEM_SCHEMA = ROOT.join("studio/schema.yml")
+FIXTURES = ROOT.join("scripts/test/fixtures/studio-taxonomy")
+TOP_LEVEL_CONFIG = FIXTURES.join("top-level/_config.yml")
+PAGE_LOCAL_CONFIG = FIXTURES.join("page-local/_config.yml")
+
+LEFTOVER_TAGS = %w[
+  Aesthetics
+  Social
+  Mathematics
+  Robotics
+  DevOps
+  brasilidade
+  engraçadinho
+  devaneio
+  provocação
+].freeze
+
+def fail!(message)
+  warn "FAIL test-studio-taxonomy: #{message}"
+  exit 1
+end
+
+def run_install_functions(dest)
+  env = { "RUBYOPT" => "-I#{ROOT.join('lib')}" }
+  Open3.capture3(env, "ruby", EXE.to_s, "install-functions", dest.to_s)
+end
+
+def load_yaml(path)
+  YAML.safe_load(path.read, permitted_classes: [Date, Time], aliases: true) || {}
+end
+
+def find_content_collection(schema, name)
+  Array(schema["content"]).each do |group|
+    next unless group.is_a?(Hash)
+
+    Array(group["items"]).each do |item|
+      next unless item.is_a?(Hash)
+      next unless item["type"].to_s == "collection"
+
+      return item if item["name"].to_s == name.to_s
+    end
+  end
+  nil
+end
+
+def find_tags_field(entry)
+  return nil unless entry.is_a?(Hash)
+
+  Array(entry["fields"]).find { |f| f.is_a?(Hash) && f["name"].to_s == "tags" }
+end
+
+# a, b, e, d. Top-level fixture, no leftovers, overrides, and config change.
+Dir.mktmpdir("pandorga-studio-tax-top-") do |dir|
+  site = Pathname.new(dir)
+  FileUtils.cp(TOP_LEVEL_CONFIG, site.join("_config.yml"))
+
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case a CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  installed_path = site.join("studio/schema.yml")
+  fail!("installed schema missing at #{installed_path}") unless installed_path.file?
+
+  schema = load_yaml(installed_path)
+  [
+    ["content.articles", find_content_collection(schema, "articles")],
+    ["collections.articles", schema.dig("collections", "articles")]
+  ].each do |label, entry|
+    # The gem's schema has no collections index; the installer must not add one.
+    next if label.start_with?("collections.") && !schema.key?("collections")
+
+    fail!("missing #{label}") unless entry.is_a?(Hash)
+    opts = find_tags_field(entry)&.fetch("options", nil)
+    fail!("missing tags options on #{label}") unless opts.is_a?(Hash)
+    unless opts["values"] == %w[Design Organizations]
+      fail!("#{label} values expected [Design, Organizations], got #{opts['values'].inspect}")
+    end
+    fail!("#{label} max expected 2, got #{opts['max'].inspect}") unless opts["max"] == 2
+    fail!("#{label} min expected 1, got #{opts['min'].inspect}") unless opts["min"] == 1
+  end
+
+  [
+    ["content.posts", find_content_collection(schema, "posts")],
+    ["collections.posts", schema.dig("collections", "posts")]
+  ].each do |label, entry|
+    # The gem's schema has no collections index; the installer must not add one.
+    next if label.start_with?("collections.") && !schema.key?("collections")
+
+    fail!("missing #{label}") unless entry.is_a?(Hash)
+    opts = find_tags_field(entry)&.fetch("options", nil)
+    fail!("missing tags options on #{label}") unless opts.is_a?(Hash)
+    unless opts["values"] == %w[alpha beta gamma]
+      fail!("#{label} values expected [alpha, beta, gamma], got #{opts['values'].inspect}")
+    end
+    fail!("#{label} max expected 3, got #{opts['max'].inspect}") unless opts["max"] == 3
+    if opts.key?("min")
+      fail!("#{label} should not have min key, got #{opts['min'].inspect}")
+    end
+  end
+
+  fail!("installer must not add a collections index") if schema.key?("collections")
+
+  # Free-text tags (type string, list) are not pickers and stay untouched.
+  projects_tags = find_tags_field(find_content_collection(schema, "projects"))
+  gem_projects_tags = find_tags_field(find_content_collection(load_yaml(GEM_SCHEMA), "projects"))
+  unless projects_tags && projects_tags == gem_projects_tags
+    fail!("free-text projects tags changed: #{projects_tags.inspect}")
+  end
+
+  # b. No leftover site vocabulary in installed schema.
+  raw_text = installed_path.read
+  LEFTOVER_TAGS.each do |word|
+    if raw_text.include?(word)
+      fail!("installed schema still contains leftover tag #{word.inspect}")
+    end
+  end
+
+  # e. Overrides applied after taxonomies.
+  site.join("studio.overrides.yml").write(<<~YAML)
+    collections:
+      articles:
+        label: Essays
+  YAML
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case e CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  overridden = load_yaml(installed_path)
+  articles_item = find_content_collection(overridden, "articles")
+  unless articles_item&.fetch("label", nil) == "Essays"
+    fail!("expected overridden articles label 'Essays', got #{articles_item&.fetch('label', nil).inspect}")
+  end
+  articles_vals = find_tags_field(articles_item)&.dig("options", "values")
+  unless articles_vals == %w[Design Organizations]
+    fail!("expected overridden articles tags [Design, Organizations], got #{articles_vals.inspect}")
+  end
+  FileUtils.rm_f(site.join("studio.overrides.yml"))
+
+  # d. Changing _config.yml changes the output.
+  site.join("_config.yml").write(<<~YAML)
+    pandorga:
+      taxonomies:
+        articles:
+          tags: [Zeta]
+          max: 2
+        posts:
+          tags: [alpha, beta, gamma]
+          max: 3
+  YAML
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case d CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  updated = load_yaml(installed_path)
+  updated_vals = find_tags_field(find_content_collection(updated, "articles"))&.dig("options", "values")
+  unless updated_vals == %w[Zeta]
+    fail!("expected updated articles tags [Zeta], got #{updated_vals.inspect}")
+  end
+end
+
+# c. Page-local fixture: articles falls back to pages[].taxonomy; posts stays [] with a warning.
+Dir.mktmpdir("pandorga-studio-tax-page-") do |dir|
+  site = Pathname.new(dir)
+  FileUtils.cp(PAGE_LOCAL_CONFIG, site.join("_config.yml"))
+
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case c CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  schema = load_yaml(site.join("studio/schema.yml"))
+  articles_opts = find_tags_field(find_content_collection(schema, "articles"))&.fetch("options", nil)
+  fail!("case c missing articles tags options") unless articles_opts.is_a?(Hash)
+  unless articles_opts["values"] == %w[Notes]
+    fail!("case c articles values expected [Notes], got #{articles_opts['values'].inspect}")
+  end
+  unless articles_opts["max"] == 1
+    fail!("case c articles max expected 1, got #{articles_opts['max'].inspect}")
+  end
+
+  posts_opts = find_tags_field(find_content_collection(schema, "posts"))&.fetch("options", nil)
+  fail!("case c missing posts tags options") unless posts_opts.is_a?(Hash)
+  unless posts_opts["values"] == []
+    fail!("case c posts values expected [], got #{posts_opts['values'].inspect}")
+  end
+
+  combined = "#{stdout}\n#{stderr}"
+  unless combined.match?(/warning:.*posts/i)
+    fail!("case c expected warning mentioning posts, got:\n#{combined}")
+  end
+end
+
+# f. Gem source: studio/schema.yml has values: [] on every select tags field.
+gem_schema = load_yaml(GEM_SCHEMA)
+gem_tag_fields = 0
+Array(gem_schema["content"]).each do |group|
+  next unless group.is_a?(Hash)
+
+  Array(group["items"]).each do |item|
+    next unless item.is_a?(Hash) && item["type"].to_s == "collection"
+
+    field = find_tags_field(item)
+    next unless field && (field["type"].to_s == "select" || field["options"].is_a?(Hash))
+
+    gem_tag_fields += 1
+    vals = field.dig("options", "values")
+    unless vals == []
+      fail!("gem studio/schema.yml #{item['name']} tags values expected [], got #{vals.inspect}")
+    end
+  end
+end
+if gem_schema["collections"].is_a?(Hash)
+  gem_schema["collections"].each do |name, item|
+    field = find_tags_field(item)
+    next unless field && (field["type"].to_s == "select" || field["options"].is_a?(Hash))
+
+    vals = field.dig("options", "values")
+    unless vals == []
+      fail!("gem studio/schema.yml collections.#{name} tags values expected [], got #{vals.inspect}")
+    end
+  end
+end
+fail!("expected select tags fields in gem studio/schema.yml") if gem_tag_fields.zero?
+
+# g. No _config.yml in destination: command succeeds and copies schema unchanged.
+Dir.mktmpdir("pandorga-studio-tax-noconfig-") do |dir|
+  site = Pathname.new(dir)
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case g CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  installed_path = site.join("studio/schema.yml")
+  fail!("case g missing studio/schema.yml") unless installed_path.file?
+  unless installed_path.read == GEM_SCHEMA.read
+    fail!("case g expected studio/schema.yml to be copied unchanged when _config.yml is absent")
+  end
+end
+
+puts "PASS test-studio-taxonomy"

data/scripts/test/test-thumbnail-variants.rb

@@ -0,0 +1,380 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Refs: PLT-AC-44
+require "fileutils"
+require "json"
+require "open3"
+require "pathname"
+require "tmpdir"
+require "yaml"
+
+ROOT = Pathname.new(__dir__).join("../..").expand_path
+EXE = ROOT.join("exe/pandorga")
+EXPORT = ROOT.join("scripts/content/export-content-json.rb")
+
+def fail!(message)
+  warn "FAIL test-thumbnail-variants: #{message}"
+  exit 1
+end
+
+def find_imagemagick
+  %w[magick convert].find do |bin|
+    _out, _err, status = Open3.capture3("which", bin)
+    status.success?
+  rescue Errno::ENOENT
+    false
+  end
+end
+
+magick_bin = find_imagemagick
+unless magick_bin
+  if ENV["CI"]
+    fail!("ImageMagick is missing on CI")
+  else
+    puts "SKIP test-thumbnail-variants: ImageMagick not installed"
+    exit 0
+  end
+end
+
+def run_magick(magick_bin, *args)
+  cmd = magick_bin == "magick" ? ["magick", *args] : [args.first == "identify" ? "identify" : "convert", *(args.first == "identify" ? args.drop(1) : args)]
+  out, err, status = Open3.capture3(*cmd)
+  fail!("ImageMagick failed (#{cmd.join(' ')}): #{out}\n#{err}") unless status.success?
+  out
+end
+
+def create_image(magick_bin, path, size, color = "steelblue")
+  FileUtils.mkdir_p(path.dirname)
+  run_magick(magick_bin, "-size", size, "xc:#{color}", path.to_s)
+end
+
+def inject_minimal_exif!(jpeg_path)
+  data = File.binread(jpeg_path)
+  return unless data.start_with?("\xFF\xD8".b)
+
+  # Minimal big-endian TIFF header with Artist tag (0x013B) = "Test"
+  tiff = "MM\x00*\x00\x00\x00\x08\x00\x01\x01\x3B\x00\x02\x00\x00\x00\x05\x00\x00\x00\x1ATest\x00".b
+  payload = "Exif\x00\x00".b + tiff
+  app1 = "\xFF\xE1".b + [payload.bytesize + 2].pack("n") + payload
+  File.binwrite(jpeg_path, data[0, 2] + app1 + data[2..])
+end
+
+def identify_info(magick_bin, path)
+  raw = run_magick(magick_bin, "identify", "-format", "%w %h %m|%[EXIF:*]", path.to_s)
+  dims, exif = raw.split("|", 2)
+  w, h, fmt = dims.to_s.strip.split(/\s+/, 3)
+  { width: w.to_i, height: h.to_i, format: fmt.to_s, exif: exif.to_s.strip }
+end
+
+def write_fixture_site(site, magick_bin)
+  site.join("_config.yml").write(<<~YAML)
+    title: "Test Site"
+    url: "https://example.com"
+    pandorga:
+      identity:
+        name: "Ada Example"
+        url: "https://example.com"
+      content:
+        backend: static
+      pages:
+        - key: projects
+          template: portfolio
+          collection: projects
+          path: /pages/projects/
+          detail: /projects/:slug/
+  YAML
+
+  covers = site.join("content/media/images/covers")
+  create_image(magick_bin, covers.join("wide.jpg"), "3000x2000", "navy")
+  create_image(magick_bin, covers.join("tall.png"), "1200x1600", "darkgreen")
+  create_image(magick_bin, covers.join("small.jpg"), "800x450", "darkred")
+  FileUtils.mkdir_p(covers)
+  covers.join("clip.mp4").write("fake video bytes")
+
+  projects_dir = site.join("content/collections/projects")
+  FileUtils.mkdir_p(projects_dir)
+
+  entries = [
+    ["wide-a", "Wide Alpha", "/media/images/covers/wide.jpg", 1],
+    ["wide-b", "Wide Beta", "/media/images/covers/wide.jpg", 2],
+    ["tall-p", "Tall Project", "/media/images/covers/tall.png", 3],
+    ["small-p", "Small Project", "/media/images/covers/small.jpg", 4],
+    ["ext-url", "External Thumbnail", "https://example.com/x.jpg", 5],
+    ["video-p", "Video Thumbnail", "/media/images/covers/clip.mp4", 6],
+    ["missing-p", "Missing Thumbnail", "/media/images/covers/nope.jpg", 7]
+  ]
+
+  entries.each do |key, title, thumb, order|
+    projects_dir.join("#{key}.md").write(<<~MD)
+      ---
+      key: #{key}
+      project: #{title}
+      title: #{title}
+      tagline: "Summary for #{title}."
+      start_date: "2025-01"
+      status: ongoing
+      label: Ruby
+      icon: terminal
+      sort_order: #{order}
+      thumbnail: #{thumb}
+      tags:
+        - Ruby
+      ---
+
+      Body for #{title}.
+    MD
+  end
+end
+
+begin
+  require "pandorga/thumbnail_variants"
+rescue LoadError => e
+  fail!("cannot load pandorga/thumbnail_variants: #{e.message}")
+end
+
+# 1. Library entry point + idempotency + regeneration when original is newer.
+Dir.mktmpdir("pandorga-thumb-lib-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+
+  covers = site.join("content/media/images/covers")
+  variants = covers.join("variants")
+
+  summary = Pandorga::ThumbnailVariants.generate(site)
+  fail!("expected generate to return a Hash, got #{summary.inspect}") unless summary.is_a?(Hash)
+
+  # Check wide.jpg variants: 480x270, 960x540, 1440x810
+  [[480, 270], [960, 540], [1440, 810]].each do |w, h|
+    vpath = variants.join("wide-#{w}.jpg")
+    fail!("missing #{vpath}") unless vpath.file?
+    info = identify_info(magick_bin, vpath)
+    fail!("wide-#{w}.jpg expected #{w}x#{h}, got #{info[:width]}x#{info[:height]}") unless info[:width] == w && info[:height] == h
+    fail!("wide-#{w}.jpg expected JPEG, got #{info[:format]}") unless info[:format] == "JPEG"
+    fail!("wide-#{w}.jpg expected empty EXIF, got #{info[:exif].inspect}") unless info[:exif].empty?
+  end
+
+  # Check tall.png (1200x1600): 480 and 960 exist, 1440 skipped
+  [[480, 270], [960, 540]].each do |w, h|
+    vpath = variants.join("tall-#{w}.jpg")
+    fail!("missing #{vpath}") unless vpath.file?
+    info = identify_info(magick_bin, vpath)
+    fail!("tall-#{w}.jpg expected #{w}x#{h}, got #{info[:width]}x#{info[:height]}") unless info[:width] == w && info[:height] == h
+    fail!("tall-#{w}.jpg expected JPEG, got #{info[:format]}") unless info[:format] == "JPEG"
+    fail!("tall-#{w}.jpg expected empty EXIF, got #{info[:exif].inspect}") unless info[:exif].empty?
+  end
+  fail!("tall-1440.jpg must be skipped (no upscaling)") if variants.join("tall-1440.jpg").exist?
+
+  # Check small.jpg (800x450): only 480 exists, 960 and 1440 skipped
+  v480 = variants.join("small-480.jpg")
+  fail!("missing #{v480}") unless v480.file?
+  info480 = identify_info(magick_bin, v480)
+  fail!("small-480.jpg expected 480x270, got #{info480[:width]}x#{info480[:height]}") unless info480[:width] == 480 && info480[:height] == 270
+  fail!("small-480.jpg expected JPEG, got #{info480[:format]}") unless info480[:format] == "JPEG"
+  fail!("small-480.jpg expected empty EXIF, got #{info480[:exif].inspect}") unless info480[:exif].empty?
+  fail!("small-960.jpg must be skipped") if variants.join("small-960.jpg").exist?
+  fail!("small-1440.jpg must be skipped") if variants.join("small-1440.jpg").exist?
+
+  # Nothing written for URL, video, missing
+  written_names = variants.children.map { |p| p.basename.to_s }.sort
+  expected_names = %w[
+    small-480.jpg
+    tall-480.jpg
+    tall-960.jpg
+    wide-1440.jpg
+    wide-480.jpg
+    wide-960.jpg
+  ]
+  fail!("unexpected files in variants/: #{written_names.inspect}") unless written_names == expected_names
+
+  # Check srcset_for helper
+  wide_srcset = Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/wide.jpg")
+  fail!("unexpected wide srcset: #{wide_srcset.inspect}") unless wide_srcset ==
+    "/media/images/covers/variants/wide-480.jpg 480w, /media/images/covers/variants/wide-960.jpg 960w, /media/images/covers/variants/wide-1440.jpg 1440w"
+
+  tall_srcset = Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/tall.png")
+  fail!("unexpected tall srcset: #{tall_srcset.inspect}") unless tall_srcset ==
+    "/media/images/covers/variants/tall-480.jpg 480w, /media/images/covers/variants/tall-960.jpg 960w"
+
+  small_srcset = Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/small.jpg")
+  fail!("unexpected small srcset: #{small_srcset.inspect}") unless small_srcset ==
+    "/media/images/covers/variants/small-480.jpg 480w"
+
+  fail!("expected nil srcset for external URL") unless Pandorga::ThumbnailVariants.srcset_for(site, "https://example.com/x.jpg").nil?
+  fail!("expected nil srcset for video") unless Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/clip.mp4").nil?
+  fail!("expected nil srcset for missing file") unless Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/nope.jpg").nil?
+
+  # Idempotent rerun: set variant mtimes in the future of original, verify rerun keeps mtimes
+  past = Time.now - 120
+  variant_time = Time.now - 60
+  [covers.join("wide.jpg"), covers.join("tall.png"), covers.join("small.jpg")].each do |orig|
+    File.utime(past, past, orig.to_s)
+  end
+  variants.children.each { |v| File.utime(variant_time, variant_time, v.to_s) }
+  mtimes_before = variants.children.to_h { |v| [v.basename.to_s, v.mtime] }
+
+  Pandorga::ThumbnailVariants.generate(site)
+  mtimes_after = variants.children.to_h { |v| [v.basename.to_s, v.mtime] }
+  fail!("rerun modified up-to-date variants: #{mtimes_before.inspect} vs #{mtimes_after.inspect}") unless mtimes_before == mtimes_after
+
+  # Touch original newer: only that image's variant set is regenerated
+  newer = Time.now
+  File.utime(newer, newer, covers.join("small.jpg").to_s)
+  Pandorga::ThumbnailVariants.generate(site)
+  fail!("expected small-480.jpg to be regenerated when small.jpg is newer") unless variants.join("small-480.jpg").mtime > mtimes_before["small-480.jpg"]
+  fail!("expected wide-480.jpg mtime unchanged") unless variants.join("wide-480.jpg").mtime == mtimes_before["wide-480.jpg"]
+end
+
+# 2. CLI entry point `exe/pandorga thumbnails <root>`
+Dir.mktmpdir("pandorga-thumb-cli-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+
+  env = { "RUBYOPT" => "-I#{ROOT.join('lib')}" }
+  stdout, stderr, status = Open3.capture3(env, "ruby", EXE.to_s, "thumbnails", site.to_s)
+  fail!("CLI pandorga thumbnails failed:\n#{stdout}\n#{stderr}") unless status.success?
+
+  variants = site.join("content/media/images/covers/variants")
+  %w[wide-480.jpg wide-960.jpg wide-1440.jpg tall-480.jpg tall-960.jpg small-480.jpg].each do |name|
+    fail!("CLI did not write #{name}") unless variants.join(name).file?
+  end
+end
+
+# 3. Full gem export runs generation itself and rewrites thumbnail_srcset URLs
+Dir.mktmpdir("pandorga-thumb-export-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+  out = site.join("_content_json")
+  variants = site.join("content/media/images/covers/variants")
+  fail!("variants must not exist before export") if variants.exist?
+
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => site.to_s,
+    "CONTENT_API_BASE_URL" => "https://cdn.example.com",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1"
+  }
+  stdout, stderr, status = Open3.capture3(
+    env, "ruby", EXPORT.to_s,
+    site.join("content").to_s, out.to_s,
+    chdir: site.to_s
+  )
+  fail!("export failed:\n#{stdout}\n#{stderr}") unless status.success?
+  fail!("export did not generate variants/") unless variants.join("wide-480.jpg").file?
+
+  wide_json = JSON.parse(out.join("collections/projects/wide-a.json").read)
+  wide_fm = wide_json.fetch("front_matter")
+  expected_wide_srcset = [
+    "https://cdn.example.com/media/images/covers/variants/wide-480.jpg 480w",
+    "https://cdn.example.com/media/images/covers/variants/wide-960.jpg 960w",
+    "https://cdn.example.com/media/images/covers/variants/wide-1440.jpg 1440w"
+  ].join(", ")
+  unless wide_fm["thumbnail"] == "https://cdn.example.com/media/images/covers/wide.jpg"
+    fail!("wide-a thumbnail unexpected: #{wide_fm['thumbnail'].inspect}")
+  end
+  unless wide_fm["thumbnail_srcset"] == expected_wide_srcset
+    fail!("wide-a thumbnail_srcset unexpected: #{wide_fm['thumbnail_srcset'].inspect}")
+  end
+
+  tall_fm = JSON.parse(out.join("collections/projects/tall-p.json").read).fetch("front_matter")
+  expected_tall_srcset = [
+    "https://cdn.example.com/media/images/covers/variants/tall-480.jpg 480w",
+    "https://cdn.example.com/media/images/covers/variants/tall-960.jpg 960w"
+  ].join(", ")
+  unless tall_fm["thumbnail_srcset"] == expected_tall_srcset
+    fail!("tall-p thumbnail_srcset unexpected: #{tall_fm['thumbnail_srcset'].inspect}")
+  end
+
+  small_fm = JSON.parse(out.join("collections/projects/small-p.json").read).fetch("front_matter")
+  expected_small_srcset = "https://cdn.example.com/media/images/covers/variants/small-480.jpg 480w"
+  unless small_fm["thumbnail_srcset"] == expected_small_srcset
+    fail!("small-p thumbnail_srcset unexpected: #{small_fm['thumbnail_srcset'].inspect}")
+  end
+
+  %w[ext-url video-p missing-p].each do |slug|
+    fm = JSON.parse(out.join("collections/projects/#{slug}.json").read).fetch("front_matter")
+    if fm.key?("thumbnail_srcset")
+      fail!("#{slug} must not have thumbnail_srcset, got #{fm['thumbnail_srcset'].inspect}")
+    end
+  end
+
+  # Also check writing_index.json carries thumbnail_srcset for the home specimen
+  index = JSON.parse(out.join("data/writing_index.json").read)
+  wide_idx = index.find { |e| e["slug"] == "wide-a" }
+  fail!("wide-a missing from writing_index.json") unless wide_idx
+  unless wide_idx["thumbnail_srcset"] == expected_wide_srcset
+    fail!("writing_index wide-a thumbnail_srcset unexpected: #{wide_idx['thumbnail_srcset'].inspect}")
+  end
+  %w[ext-url video-p missing-p].each do |slug|
+    entry = index.find { |e| e["slug"] == slug }
+    fail!("#{slug} missing from writing_index.json") unless entry
+    if entry.key?("thumbnail_srcset")
+      fail!("writing_index #{slug} must not have thumbnail_srcset, got #{entry['thumbnail_srcset'].inspect}")
+    end
+  end
+end
+
+# 4. Without ImageMagick: export succeeds, prints one warning line, writes no variants and no thumbnail_srcset
+Dir.mktmpdir("pandorga-thumb-nomagick-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+  out = site.join("_content_json")
+
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => site.to_s,
+    "CONTENT_API_BASE_URL" => "",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1",
+    "PANDORGA_IMAGEMAGICK" => "/nonexistent/magick"
+  }
+  stdout, stderr, status = Open3.capture3(
+    env, "ruby", EXPORT.to_s,
+    site.join("content").to_s, out.to_s,
+    chdir: site.to_s
+  )
+  fail!("export without ImageMagick failed:\n#{stdout}\n#{stderr}") unless status.success?
+
+  combined_lines = "#{stdout}\n#{stderr}".lines.map(&:strip).reject(&:empty?)
+  warnings = combined_lines.select { |l| l.match?(/warning.*imagemagick|imagemagick.*warning/i) }
+  unless warnings.length == 1
+    fail!("expected exactly 1 ImageMagick warning line, got #{warnings.length}: #{warnings.inspect}\nAll output:\n#{stdout}\n#{stderr}")
+  end
+
+  variants = site.join("content/media/images/covers/variants")
+  if variants.exist? && variants.children.any?
+    fail!("expected no variants written when ImageMagick is unavailable")
+  end
+
+  wide_fm = JSON.parse(out.join("collections/projects/wide-a.json").read).fetch("front_matter")
+  if wide_fm.key?("thumbnail_srcset")
+    fail!("expected no thumbnail_srcset when ImageMagick is unavailable, got #{wide_fm['thumbnail_srcset'].inspect}")
+  end
+end
+
+# 5. An unreadable image warns, keeps its original, and does not stop the export.
+Dir.mktmpdir("pandorga-thumb-corrupt-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+  site.join("content/media/images/covers/small.jpg").write("not a jpeg")
+  out = site.join("_content_json")
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => site.to_s,
+    "CONTENT_API_BASE_URL" => "",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1"
+  }
+  stdout, stderr, status = Open3.capture3(
+    env, "ruby", EXPORT.to_s,
+    site.join("content").to_s, out.to_s,
+    chdir: site.to_s
+  )
+  fail!("export with an unreadable image failed:\n#{stdout}\n#{stderr}") unless status.success?
+  fail!("expected a warning naming small.jpg") unless "#{stdout}\n#{stderr}".match?(/warning.*small\.jpg/)
+  variants = site.join("content/media/images/covers/variants")
+  fail!("unreadable image must not get variants") if variants.join("small-480.jpg").exist?
+  fail!("readable images must still get variants") unless variants.join("wide-480.jpg").file?
+  small_fm = JSON.parse(out.join("collections/projects/small-p.json").read).fetch("front_matter")
+  fail!("unreadable image must not get thumbnail_srcset") if small_fm.key?("thumbnail_srcset")
+end
+
+puts "PASS test-thumbnail-variants"

data/scripts/validate.sh

@@ -44,6 +44,7 @@ TESTS=(
   scripts/test/test-studio-api-contract.rb
   scripts/test/test-studio-rewrite-api-contract.rb
   scripts/test/test-studio-schema-composition.rb
+  scripts/test/test-studio-taxonomy.rb
   scripts/test/test-text-excerpt.rb
   scripts/test/test-git-chronology.rb
   scripts/test/test-math-row-breaks.rb
@@ -70,6 +71,7 @@ TESTS=(
   scripts/test/test-css-delivery.rb
   scripts/test/test-discovery.rb
   scripts/test/test-hero-portraits.rb
+  scripts/test/test-thumbnail-variants.rb
 )
 
 failed=0
@@ -90,6 +92,11 @@ if ! node scripts/test/test-hero-portraits.mjs; then
   failed=1
 fi
 
+echo "-- scripts/test/test-poster-srcset.mjs"
+if ! node scripts/test/test-poster-srcset.mjs; then
+  failed=1
+fi
+
 echo "-- scripts/test/test-studio-pipeline-config.mjs"
 if ! node scripts/test/test-studio-pipeline-config.mjs; then
   failed=1