pandorga 1.2.1

data/scripts/lib/normalize-display-math.mjs

@@ -0,0 +1,52 @@
+/**
+ * Repair common display-math row-break corruption before MathJax typesets.
+ *
+ * Editorial / CMS pipelines sometimes turn LaTeX `\\` row separators into a
+ * single `\` (end of line) or `\ ` (backslash + space inside matrix/cases).
+ * MathJax then treats the rows as one horizontal equation.
+ *
+ * Keep in sync with `_includes/content-runtime/20-markdown.html`
+ * (`normalizeDisplayMathTex`).
+ */
+
+const ROW_ENV =
+  'align\\*?|aligned|gather\\*?|eqnarray\\*?|split|cases|matrix|bmatrix|pmatrix|vmatrix|Vmatrix|smallmatrix|array';
+
+const ROW_ENV_BLOCK = new RegExp(
+  `\\\\begin\\{(${ROW_ENV})\\}([\\s\\S]*?)\\\\end\\{\\1\\}`,
+  'g'
+);
+
+export function normalizeDisplayMathTex(math) {
+  let text = String(math || '');
+
+  // Odd-length trailing backslash run at EOL → add one `\` so the run is even.
+  text = text
+    .split('\n')
+    .map((line) => {
+      const match = line.match(/(\\+)([ \t]*)$/);
+      if (!match) return line;
+      if (match[1].length % 2 === 0) return line;
+      return line.slice(0, line.length - match[0].length) + match[1] + '\\' + match[2];
+    })
+    .join('\n');
+
+  // Inside ams/matrix row environments, lone `\ ` is almost always a corrupted `\\`.
+  text = text.replace(ROW_ENV_BLOCK, (full, env, body) => {
+    const fixed = body.replace(/(^|[^\\])\\([ \t]+)/g, (_, prefix, ws) => `${prefix}\\\\${ws}`);
+    return `\\begin{${env}}${fixed}\\end{${env}}`;
+  });
+
+  return text;
+}
+
+export function normalizeMathRegion(mathMatch) {
+  const raw = String(mathMatch || '');
+  if (raw.startsWith('$$') && raw.endsWith('$$')) {
+    return `$$${normalizeDisplayMathTex(raw.slice(2, -2))}$$`;
+  }
+  if (raw.startsWith('\\[') && raw.endsWith('\\]')) {
+    return `\\[${normalizeDisplayMathTex(raw.slice(2, -2))}\\]`;
+  }
+  return raw;
+}

data/scripts/lib/r2_json_sync.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# Plan an incremental JSON prefix replace against S3-compatible list-objects.
+# A single-part ETag is an MD5 hex digest; matching local MD5 means skip PUT.
+# Multipart ETags contain "-" and must be re-uploaded. Missing/blank ETags too.
+# Remote keys absent locally are deleted so withdrawn/renamed objects cannot stay.
+module R2JsonSync
+  FORCE_UPLOAD_BASENAMES = %w[writing_index.json].freeze
+
+  module_function
+
+  def normalize_etag(etag)
+    etag.to_s.gsub('"', "").strip
+  end
+
+  def multipart_etag?(etag)
+    normalize_etag(etag).include?("-")
+  end
+
+  def skip_upload?(remote_etag, local_md5, key: nil)
+    return false if force_upload_key?(key)
+
+    etag = normalize_etag(remote_etag)
+    return false if etag.empty? || multipart_etag?(etag)
+
+    etag.casecmp?(local_md5.to_s)
+  end
+
+  def force_upload_key?(key)
+    FORCE_UPLOAD_BASENAMES.include?(File.basename(key.to_s))
+  end
+
+  def contents_to_etags(contents)
+    etags = {}
+    Array(contents).each do |item|
+      key = item.is_a?(Hash) ? item["Key"].to_s : ""
+      next if key.empty? || key.end_with?("/")
+
+      etags[key] = normalize_etag(item["ETag"])
+    end
+    etags
+  end
+
+  # local_files: array of { "key" =>, "md5" => }
+  # remote_etags: { key => etag }
+  def plan(local_files, remote_etags)
+    remote = remote_etags.transform_keys(&:to_s)
+    upload = []
+    skip = []
+    local_keys = []
+
+    Array(local_files).each do |file|
+      key = file["key"].to_s
+      next if key.empty?
+
+      local_keys << key
+      md5 = file["md5"].to_s
+      if skip_upload?(remote[key], md5, key: key)
+        skip << key
+      else
+        upload << key
+      end
+    end
+
+    {
+      "upload" => upload,
+      "skip" => skip,
+      "delete" => (remote.keys - local_keys).sort
+    }
+  end
+
+  def summary_line(prefix, plan)
+    "R2 replace sync #{prefix}/: uploaded=#{Array(plan['upload']).length} " \
+      "skipped=#{Array(plan['skip']).length} deleted=#{Array(plan['delete']).length}"
+  end
+end

data/scripts/lib/withdrawn_public_objects.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Public-store objects that must not exist after a clean publish.
+module WithdrawnPublicObjects
+  EXPORT_PATHS = %w[
+    data/transcriptions/2026-04-11-choque-de-cultura.json
+    data/tabs/roda-viva.json
+    collections/posts/2026-04-17-roda-viva.json
+    collections/posts/2026-04-12-falha-de-cobertura.json
+    collections/posts/2026-04-11-falha-de-cobertura.json
+    collections/articles/2026-07-17-soft-drones-went-to-war.json
+    pages/cv/summary-detailed.json
+    pages/cv/summary-short.json
+    data/skills.json
+  ].freeze
+
+  STALE_PHRASES = [
+    "every engineer feels",
+    "three-ounce shaped explosive",
+    "detecção de minas terrestres",
+    "Este comentário no Reddit"
+  ].freeze
+end

data/scripts/lib/writing_index_contract.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "json"
+require "pathname"
+
+# writing_index slugs must resolve to an exported collections JSON object.
+# Catches the Freshy-class bug (index date 2026-08-23, file still 2026-08-22).
+module WritingIndexContract
+  TYPE_TO_COLLECTION = {
+    "article" => "articles",
+    "post" => "posts",
+    "product" => "products",
+    "project" => "projects",
+    "articles" => "articles",
+    "posts" => "posts",
+    "products" => "products",
+    "projects" => "projects"
+  }.freeze
+
+  module_function
+
+  def collection_for(entry)
+    TYPE_TO_COLLECTION[entry["collection"].to_s] ||
+      TYPE_TO_COLLECTION[entry["type"].to_s]
+  end
+
+  def export_path_for(entry)
+    collection = collection_for(entry)
+    slug = entry["slug"].to_s
+    return nil if collection.nil? || slug.empty?
+
+    "collections/#{collection}/#{slug}.json"
+  end
+
+  def mismatches(output_root, entries = nil)
+    root = Pathname.new(output_root)
+    entries = JSON.parse(root.join("data/writing_index.json").read) if entries.nil?
+    errors = []
+
+    Array(entries).each do |entry|
+      relative = export_path_for(entry)
+      if relative.nil?
+        errors << "writing_index entry #{entry['key'].inspect} missing collection/slug"
+        next
+      end
+
+      next if root.join(relative).file?
+
+      errors << "writing_index slug #{entry['slug'].inspect} (key=#{entry['key']}) " \
+                "has no #{relative}"
+    end
+    errors
+  end
+
+  def assert_slugs_match_export!(output_root, entries = nil)
+    errors = mismatches(output_root, entries)
+    return if errors.empty?
+
+    raise "writing_index slug/export mismatch:\n  - #{errors.join("\n  - ")}"
+  end
+end