pandorga 1.7.2 → 1.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13bf0047d336a1cfa896a02c88b8bcb172175c564d922474bf65136b113db106
-  data.tar.gz: e146ecadc0250a2315ab17b887a8b2425d9c7ded47cfc0f45c6a3ee1bc0edc6d
+  metadata.gz: 8935cbf5ca2ee93ea990c5e18d61831877f04f03b3ba569b3d4347dec3387718
+  data.tar.gz: 5c9663302fcce8b2ecf4a5197b03ca66f1f0cca0c7eb2ee0b9d9c9ab2d5e320e
 SHA512:
-  metadata.gz: e5ccb2966deff68f8c3292f997cd39980024e47eeaab2e756f74d193e03ff6b40fd5f235c51fc30a69277057c31350246451004b25f1086df24a163efd45c777
-  data.tar.gz: df67d8c8be5fd84ffca3abde105d4b05e6c76030e9e1d45f9e26c6dfdb1722a2ecd82ba55a4b9d699a73f1dacd5bc5999402d1ae7f60f727bee5a8058f7f1c16
+  metadata.gz: ba771e313ba7ecbc5d13473c75454468d22d18f6f2ec1d22ca896d3bf9bec124aa9b32f5efff0dce38c7495a20a422110313910d56808f7b123ce4e07b29e322
+  data.tar.gz: b29d2e32efc698af41f0fdcf7b9da605adfbc238a249dd050c157103493b9305e9fb71a355f919e8189a4a43d41b76b25df2a96b446627a3ba6380f6631fc1f5

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [1.7.4] — 2026-10-12
+
+### Fixed
+
+- The footer imprint separator uses `outline` on the panel step.
+  `outline-variant` on that panel is 1.80:1 in light (`#b8b8b8` on
+  `#f4f4f4`) and 1.93:1 in dark (`#45454c` on `#141418`). `outline`
+  on the same panels is 6.08:1 and 5.95:1.
+
+### Changed
+
+- Unused selectors are gone. `assets/css/ledger/home.css` drops
+  `.home-hero-pandorga-svg` (25 bytes). The hero SVG uses
+  `home-hero-art-svg`. `assets/css/ledger/detail.css` drops 916 bytes:
+  the author byline suppressor and the `.table-csv` companions. No
+  template or runtime emits either class. 941 bytes in all.
+- The one-shot key backfill is gone (`scripts/content/backfill-content-keys.rb`,
+  3,432 bytes). Nothing called it.
+- The watch-path test that read `docs/ops/cloudflare.md` is gone
+  (1,230 bytes). That path is not in the tree.
+- Deploy notes pin `~> 1.3` and tag `v1.7.4`. The Pages watch paths
+  include `*` and exclude `content/*` and `docs/*`.
+
+No `pandorga:` config keys were added or renamed. Font roles and the
+ledger fallbacks are unchanged.
+
+## [1.7.3] — 2026-10-12
+
+### Fixed
+
+- A detail URL is the listing shell again. The build does not write a
+  static page per article, post, project, or product, and those URLs
+  are not in the sitemap. The published `_redirects` keeps the splat
+  200 rewrites onto the listing shells, and adds any line the source
+  file is missing. The source file is unchanged. The client sets the
+  canonical link and `og:url` when it renders the entry.
+
+No `pandorga:` config keys were added or renamed. Font roles and the
+ledger fallbacks are unchanged.
+
 ## [1.7.2] — 2026-10-11
 
 ### Fixed

data/_includes/content-runtime/50-detail.html

@@ -515,6 +515,17 @@
       el.setAttribute('content', content);
     }
 
+    function setCanonicalLink(url) {
+      if (!url) return;
+      var el = document.head.querySelector('link[rel="canonical"]');
+      if (!el) {
+        el = document.createElement('link');
+        el.setAttribute('rel', 'canonical');
+        document.head.appendChild(el);
+      }
+      el.setAttribute('href', url);
+    }
+
     function applyDocumentMeta(meta) {
       meta = meta || {};
       var siteSuffix = (window.ContentRuntimeConfig && window.ContentRuntimeConfig.siteSuffix) || '';
@@ -523,7 +534,11 @@
       if (meta.description) setMetaTag('description', meta.description);
       setMetaTag('og:title', title, 'property');
       if (meta.description) setMetaTag('og:description', meta.description, 'property');
-      if (meta.url) setMetaTag('og:url', absoluteUrl(meta.url), 'property');
+      if (meta.url) {
+        var pageUrl = absoluteUrl(meta.url);
+        setMetaTag('og:url', pageUrl, 'property');
+        setCanonicalLink(pageUrl);
+      }
 
       var defaultOgImage = '/assets/images/og-default-dark.png';
       var imagePath = meta.image || defaultOgImage;

data/_includes/content-runtime/60-fragments.html

@@ -385,7 +385,7 @@
     }
 
     /* The home page's reference band opens each panel with a plate drawn from
-     * that section's own content by the export (docs/features/home-band-art.md).
+     * that section's own content by the export (docs/deploy/cloudflare.md).
      * The markup arrives as an SVG document and is injected inline, never as an
      * <img>: every stroke and fill in it is a custom property, and an external
      * document cannot see the palette the page is currently wearing.

data/_includes/theme/json-ld.html

@@ -1,8 +1,7 @@
 {%- comment -%}
-  WebSite and Person from identity. A detail page with schema_type
-  Article or BlogPosting also emits that type. No new required keys:
-  name is already required, and url is the existing optional canonical
-  origin.
+  WebSite and Person from identity. Detail Article and BlogPosting
+  JSON-LD is not written into the shell. No new required keys: name is
+  already required, and url is the existing optional canonical origin.
 {%- endcomment -%}
 {%- assign ld_name = site.pandorga.identity.name | default: site.author | default: site.title -%}
 {%- assign ld_url = site.pandorga.identity.url | default: site.url -%}
@@ -11,37 +10,6 @@
 {%- else -%}
   {%- assign ld_website = "/" | absolute_url -%}
 {%- endif -%}
-{%- assign ld_canonical = canonical_path | default: page.canonical_url | default: page.url -%}
-{%- if page.schema_type == "Article" or page.schema_type == "BlogPosting" -%}
-{%- if page.title != blank -%}
-<script type="application/ld+json">
-{
-  "@context": "https://schema.org",
-  "@type": {{ page.schema_type | jsonify }},
-  "headline": {{ page.title | jsonify }},
-  "url": {{ ld_canonical | absolute_url | jsonify }}
-  {%- if page.description != blank -%},
-  "description": {{ page.description | jsonify }}
-  {%- endif -%}
-  {%- if page.date -%},
-  "datePublished": {{ page.date | date_to_xmlschema | jsonify }}
-  {%- endif -%}
-  {%- if page.last_updated -%},
-  "dateModified": {{ page.last_updated | date_to_xmlschema | jsonify }}
-  {%- endif -%}
-  {%- if page.lang -%},
-  "inLanguage": {{ page.lang | jsonify }}
-  {%- endif -%}
-  {%- if ld_name != blank -%},
-  "author": {
-    "@type": "Person",
-    "name": {{ ld_name | jsonify }}
-  }
-  {%- endif -%}
-}
-</script>
-{%- endif -%}
-{%- endif -%}
 {%- if ld_name != blank -%}
 <script type="application/ld+json">
 {

data/_plugins/local_detail_rewrites.rb

@@ -6,14 +6,6 @@ require "net/http"
 require "uri"
 require_relative "content_detail_paths"
 
-# The gem copy and the _plugins copy stay the same file. Either path can
-# resolve the shared helper.
-detail_routes = [
-  File.expand_path("../../../detail_routes", __dir__),
-  File.expand_path("../lib/pandorga/detail_routes", __dir__)
-].find { |path| File.file?("#{path}.rb") }
-require detail_routes if detail_routes
-
 # Mirrors Cloudflare _redirects detail rewrites during `jekyll serve` so
 # /posts/:slug/ and /articles/:slug/ work locally without per-slug HTML files.
 # Also handles the local dev re-export endpoint and proxies /api/studio/* to
@@ -123,8 +115,7 @@ module Jekyll
           end
 
           target = ContentDetailPaths.rewrite_path(req.path)
-          root = instance_variable_get(:@root)
-          if target && !Pandorga::DetailRoutes.static_index?(root, req.path)
+          if target
             req.instance_variable_set(:@path, target)
             req.instance_variable_set(:@path_info, target)
           end

data/assets/css/ledger/detail.css

@@ -485,11 +485,9 @@ aside:has(> .text-detail-sidebar) {
   font-variant-numeric: tabular-nums;
 }
 
-/* Projects and products can carry no meta at all, and on articles and posts
-   the byline below is the block's only child. Either way an all-empty meta
+/* Projects and products can carry no meta at all. An all-empty meta
    block must not hang a stub of padding off the bottom of the panel. */
-.text-detail-sidebar .article-meta:has(> div:empty),
-.text-detail-sidebar .article-meta:has(> div > span.text-secondary:not(.font-bold):only-child) {
+.text-detail-sidebar .article-meta:has(> div:empty) {
   display: none;
 }
 
@@ -497,14 +495,6 @@ aside:has(> .text-detail-sidebar) {
   gap: var(--space-sm);
 }
 
-/* Author byline. Dropped: single-author site. The runtime still emits it, so
-   it is suppressed here until `buildTextSidebar` stops rendering it — see the
-   runtime-change note in this branch's commit message. The product/company
-   line is the same colour but carries `font-bold`, hence the :not(). */
-.text-detail-sidebar .article-meta>div>span.text-secondary:not(.font-bold) {
-  display: none;
-}
-
 .text-detail-sidebar .article-meta .text-tertiary,
 .text-detail-sidebar .article-meta span.font-bold {
   font-family: var(--font-label);
@@ -861,8 +851,7 @@ aside:has(> .text-detail-sidebar) {
    header, and figures that line up. */
 /* No table surface: the header band and the hover row are the only fills, so
    both read against the page canvas in either palette. */
-.article-content table,
-.article-content .table-csv {
+.article-content table {
   margin: var(--space-xl) 0;
   font-size: var(--type-dek);
   font-variant-numeric: tabular-nums;
@@ -870,9 +859,7 @@ aside:has(> .text-detail-sidebar) {
 }
 
 .article-content th,
-.article-content td,
-.article-content .table-csv th,
-.article-content .table-csv td {
+.article-content td {
   border: 0;
   border-bottom: 1px solid var(--border-gentle-subtle);
   padding: var(--space-sm) var(--space-md);
@@ -899,8 +886,7 @@ aside:has(> .text-detail-sidebar) {
   font-variant-numeric: tabular-nums;
 }
 
-.article-content thead th,
-.article-content .table-csv thead th {
+.article-content thead th {
   background: var(--color-surface-container);
   font-family: var(--font-body);
   font-size: var(--type-body);
@@ -910,13 +896,11 @@ aside:has(> .text-detail-sidebar) {
 }
 
 /* Zebra striping fights the row rules; the hover row is the reading aid. */
-.article-content tbody tr:nth-child(even),
-.article-content .table-csv tbody tr:nth-child(even) td {
+.article-content tbody tr:nth-child(even) {
   background: transparent;
 }
 
-.article-content tbody tr:hover,
-.article-content .table-csv tbody tr:hover {
+.article-content tbody tr:hover {
   background: var(--color-surface-container-low);
 }
 
@@ -1131,8 +1115,7 @@ nav.text-page-nav:not(:has(a)) {
      too wide then scrolls inside the table rather than moving the page. The
      runtime emits the table with no wrapper, so the table itself has to be the
      scroll container. */
-  .article-content table,
-  .article-content .table-csv {
+  .article-content table {
     display: block;
     width: 100%;
     max-width: 100%;
@@ -1140,9 +1123,7 @@ nav.text-page-nav:not(:has(a)) {
   }
 
   .article-content th,
-  .article-content td,
-  .article-content .table-csv th,
-  .article-content .table-csv td {
+  .article-content td {
     padding: var(--space-xs) var(--space-sm);
   }
 }

data/assets/css/ledger/footer.css

@@ -230,11 +230,14 @@
 }
 
 /* A middot between items rather than a separator element, so an absent
-   license leaves no orphaned punctuation behind. */
+   license leaves no orphaned punctuation behind. outline-variant is the
+   hairline token: #b8b8b8 on #f4f4f4 is 1.80:1, and #45454c on #141418
+   is 1.93:1. outline clears 4.5:1 on the same panel (6.08:1 light,
+   5.95:1 dark). */
 .site-footer-imprint-item+.site-footer-imprint-item::before {
   content: "·";
   margin-right: var(--space-md);
-  color: var(--color-outline-variant);
+  color: var(--color-outline);
 }
 
 .site-footer-imprint-link {

data/assets/css/ledger/home.css

@@ -91,8 +91,7 @@
   opacity: 0.42;
 }
 
-.home-hero-art-svg,
-.home-hero-pandorga-svg {
+.home-hero-art-svg {
   width: 100%;
   height: 100%;
   display: block;

data/lib/pandorga/commands/new.rb

@@ -24,7 +24,7 @@ module Pandorga
 
         gem "pandorga", "~> 1.3"
         # Local checkout: gem "pandorga", path: "../pandorga"
-        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.5.0"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.7.4"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/detail_routes.rb

@@ -1,29 +1,36 @@
 # frozen_string_literal: true
 
 module Pandorga
-  # Detail URLs that used to be 200-rewritten onto a listing shell.
-  # Cloudflare follows `_redirects` even when a static file exists, so the
-  # built file must drop those splat lines or the generated page is never
-  # served. The source file is left alone.
+  # Splat 200 lines that serve every detail URL from one listing shell.
+  # Cloudflare follows `_redirects` for the request, and the shell loads
+  # the entry from the content runtime. The source file is left alone;
+  # a missing line is added only to the published copy.
   module DetailRoutes
-    SPLAT_LINE = %r{\A/(?:articles|posts|blog|projects|products)/(?::slug|\*)/?\s+\S+\s+200\s*\z}
+    SHELL_REWRITES = [
+      ["/articles/:slug", "/pages/articles/"],
+      ["/posts/:slug", "/pages/blog/"],
+      ["/blog/:slug", "/pages/blog/"],
+      ["/projects/:slug", "/pages/projects/"],
+      ["/products/:slug", "/pages/cv/"]
+    ].freeze
 
     module_function
 
-    def strip_splat_rewrites(text)
-      text.to_s.lines.reject { |line| SPLAT_LINE.match?(line.strip) }.join
-    end
-
-    def static_index?(root, path)
-      root = root.to_s
-      return false if root.empty?
+    def ensure_shell_rewrites(text)
+      body = text.to_s
+      missing = SHELL_REWRITES.reject { |prefix, _target| rewrite_present?(body, prefix) }
+      return body if missing.empty?
 
-      clean = path.to_s.split("?").first.to_s
-      relative = clean.sub(%r{\A/}, "").sub(%r{/\z}, "")
-      return false if relative.empty? || relative.include?("..")
+      addition = missing.map { |prefix, target| "#{prefix} #{target} 200" }.join("\n")
+      stripped = body.rstrip
+      stripped.empty? ? "#{addition}\n" : "#{stripped}\n#{addition}\n"
+    end
 
-      File.file?(File.join(root, relative, "index.html")) ||
-        File.file?(File.join(root, "#{relative}.html"))
+    def rewrite_present?(text, prefix)
+      text.to_s.lines.any? do |line|
+        stripped = line.strip
+        stripped.match?(%r{\A#{Regexp.escape(prefix)}/?\s+\S+\s+200\z})
+      end
     end
   end
 end

data/lib/pandorga/jekyll/plugins/local_detail_rewrites.rb

@@ -6,14 +6,6 @@ require "net/http"
 require "uri"
 require_relative "content_detail_paths"
 
-# The gem copy and the _plugins copy stay the same file. Either path can
-# resolve the shared helper.
-detail_routes = [
-  File.expand_path("../../../detail_routes", __dir__),
-  File.expand_path("../lib/pandorga/detail_routes", __dir__)
-].find { |path| File.file?("#{path}.rb") }
-require detail_routes if detail_routes
-
 # Mirrors Cloudflare _redirects detail rewrites during `jekyll serve` so
 # /posts/:slug/ and /articles/:slug/ work locally without per-slug HTML files.
 # Also handles the local dev re-export endpoint and proxies /api/studio/* to
@@ -123,8 +115,7 @@ module Jekyll
           end
 
           target = ContentDetailPaths.rewrite_path(req.path)
-          root = instance_variable_get(:@root)
-          if target && !Pandorga::DetailRoutes.static_index?(root, req.path)
+          if target
             req.instance_variable_set(:@path, target)
             req.instance_variable_set(:@path_info, target)
           end

data/lib/pandorga/jekyll/plugins/shell_redirects.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "jekyll"
+
+require_relative "../../detail_routes"
+
+# Jekyll skips underscore files, so a source `_redirects` never reaches
+# the output unless the site lists it under `include`. The published
+# file is the one Cloudflare reads. Detail URLs stay on the listing
+# shell, so the splat 200 lines have to be in that file. The source
+# file is not edited.
+Jekyll::Hooks.register :site, :post_write do |site|
+  dest = File.join(site.dest, "_redirects")
+  source = File.join(site.source, "_redirects")
+  text = if File.file?(source)
+           File.read(source)
+         elsif File.file?(dest)
+           File.read(dest)
+         else
+           ""
+         end
+  updated = Pandorga::DetailRoutes.ensure_shell_rewrites(text)
+  next if File.file?(dest) && File.read(dest) == updated
+
+  File.write(dest, updated)
+end

data/lib/pandorga/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pandorga
-  VERSION = "1.7.2"
+  VERSION = "1.7.4"
 end

data/scripts/content/band_art.rb

@@ -27,7 +27,7 @@
 # because the plates went stale otherwise. Cloudflare Pages excludes `content/*`
 # from its build watch paths, so a Studio save never rebuilds the shell, and art
 # committed into a layout is art that stops counting the day it is written. See
-# docs/features/home-band-art.md.
+# docs/deploy/cloudflare.md.
 #
 # The output is SVG whose every stroke and fill is a custom property, because the
 # site has two complete palettes and switches between them on a `data-theme`

data/scripts/content/export-content-json.rb

@@ -653,7 +653,7 @@ def export_derived_data(content_root, output_root)
 end
 
 # The home page's reference band, drawn from the corpus this run just exported
-# rather than from committed markup. See docs/features/home-band-art.md for why
+# rather than from committed markup. See docs/deploy/cloudflare.md for why
 # it lives here: a Studio save never rebuilds the shell, so art baked into a
 # layout stops counting the day it is written.
 def export_band_art(output_root, writing_index)

data/scripts/test/test-css-structure.rb

@@ -86,7 +86,12 @@ sheets.each do |path|
     home-index-shard--gamma
     home-index-note
     post-content
+    home-hero-pandorga-svg
+    table-csv
   ]
+  if cleaned.include?("span.text-secondary:not(.font-bold)")
+    errors << "#{relative}: author byline suppressor matches no markup"
+  end
   retired.each do |name|
     next unless cleaned.match?(/[.#]#{Regexp.escape(name)}\b/)
 

data/scripts/test/test-discovery.rb

@@ -3,11 +3,8 @@
 
 # Portrait sources and discovery documents (PLT-AC-20, PLT-AC-21).
 
-require "fileutils"
 require "pathname"
 
-require "tmpdir"
-
 require_relative "../../lib/pandorga/discovery"
 require_relative "../../lib/pandorga/detail_routes"
 
@@ -51,32 +48,38 @@ image_meta = shell[/<meta name="image"[^>]*>/]
 fail!("shell missing name=image") unless image_meta
 fail!("name=image also sets property=og:image") if image_meta.include?("property=")
 fail!("discovery generator is not loaded from the plugin dir") unless ROOT.join("lib/pandorga/jekyll/plugins/discovery.rb").file?
-fail!("detail pages are not generated from the plugin dir") unless ROOT.join("lib/pandorga/jekyll/plugins/detail_documents.rb").file?
+fail!("detail pages are still generated") if ROOT.join("lib/pandorga/jekyll/plugins/detail_documents.rb").file?
+fail!("shell redirect hook is missing") unless ROOT.join("lib/pandorga/jekyll/plugins/shell_redirects.rb").file?
 
 redirects = <<~TXT
   /legacy /articles/2026-01-01-welcome/ 301
-  /articles/:slug /pages/articles/ 200
   /posts/:slug/ /pages/blog/ 200
-  /blog/:slug /pages/blog/ 200
-  /projects/:slug /pages/projects/ 200
-  /products/* /pages/cv/ 200
   /keep /pages/articles/ 301
 TXT
-stripped = Pandorga::DetailRoutes.strip_splat_rewrites(redirects)
-fail!("splat 200 rewrite survived") if stripped.match?(%r{/(?:articles|posts|blog|projects|products)/(?::slug|\*)})
-fail!("a 301 was stripped with the splats") unless stripped.include?("/legacy /articles/2026-01-01-welcome/ 301")
-fail!("a listing 301 was stripped") unless stripped.include?("/keep /pages/articles/ 301")
-
-Dir.mktmpdir("detail-static") do |dir|
-  FileUtils.mkdir_p(File.join(dir, "articles", "welcome"))
-  File.write(File.join(dir, "articles", "welcome", "index.html"), "<p>welcome</p>")
-  fail!("a built detail page must not be rewritten") unless Pandorga::DetailRoutes.static_index?(dir, "/articles/welcome/")
-  fail!("a missing detail page must still be rewritten") if Pandorga::DetailRoutes.static_index?(dir, "/articles/missing/")
+ensured = Pandorga::DetailRoutes.ensure_shell_rewrites(redirects)
+%w[/articles/:slug /posts/:slug /blog/:slug /projects/:slug /products/:slug].each do |prefix|
+  present = ensured.lines.any? { |line| line.strip.start_with?("#{prefix} ") || line.strip.start_with?("#{prefix}/ ") }
+  fail!("published _redirects missing #{prefix}") unless present
 end
+fail!("a 301 was dropped") unless ensured.include?("/legacy /articles/2026-01-01-welcome/ 301")
+fail!("a listing 301 was dropped") unless ensured.include?("/keep /pages/articles/ 301")
+posts = ensured.lines.select { |line| line.include?("/posts/:slug") }
+fail!("an existing splat was duplicated") unless posts.size == 1
+fail!("an existing splat target was rewritten") unless posts.first.include?("/pages/blog/")
+fail!("ensure is not idempotent") unless Pandorga::DetailRoutes.ensure_shell_rewrites(ensured) == ensured
+
+serve = ROOT.join("lib/pandorga/jekyll/plugins/local_detail_rewrites.rb").read
+plugins_serve = ROOT.join("_plugins/local_detail_rewrites.rb").read
+fail!("the two local serve copies diverged") unless serve == plugins_serve
+fail!("local serve skips a detail URL") if serve.include?("static_index?")
+fail!("local serve does not rewrite detail URLs") unless serve.include?("ContentDetailPaths.rewrite_path(req.path)")
+
+detail = ROOT.join("_includes/content-runtime/50-detail.html").read
+fail!("the client does not set the canonical link") unless detail.include?("setCanonicalLink")
+fail!("the client does not set og:url") unless detail.include?("setMetaTag('og:url'")
 
 json_ld = ROOT.join("_includes/theme/json-ld.html").read
-fail!("detail pages have no Article schema") unless json_ld.include?('page.schema_type == "Article"')
-fail!("detail pages have no BlogPosting schema") unless json_ld.include?('page.schema_type == "BlogPosting"')
-fail!("detail schema omits datePublished") unless json_ld.include?("datePublished")
+fail!("the build still emits detail JSON-LD") if json_ld.include?("schema_type")
+fail!("shell JSON-LD dropped the person") unless json_ld.include?('"@type": "Person"')
 
 puts "PASS test-discovery"

data/scripts/test/test-examples-build.rb

@@ -39,17 +39,6 @@ end
   begin
   run!("bundle", "install", "--quiet", chdir: example) if example.join("Gemfile").file?
   run!("ruby", EXE.to_s, "export", "content", "_content_json", chdir: example)
-  if name == "full" && redirects_path.file?
-    splat = <<~TXT
-
-      /articles/:slug /pages/articles/ 200
-      /posts/:slug /pages/blog/ 200
-      /blog/:slug /pages/blog/ 200
-      /projects/:slug /pages/projects/ 200
-      /products/:slug /pages/cv/ 200
-    TXT
-    redirects_path.write("#{redirects_path.read.rstrip}\n#{splat}")
-  end
   run!("bundle", "exec", "jekyll", "build", "--quiet", chdir: example)
 
   index = example.join("_site/index.html")
@@ -113,65 +102,46 @@ end
     warn "FAIL test-examples-build: #{name} robots missing the sitemap line\n#{robots}"
     exit 1
   end
-  if name == "full"
-    {
-      "/articles/2026-01-01-welcome/" => "Article",
-      "/posts/2026-01-02-note/" => "BlogPosting"
-    }.each do |path, schema|
-      loc = "#{origin}#{path}"
-      unless sitemap.include?("<loc>#{loc}</loc>")
-        warn "FAIL test-examples-build: sitemap missing #{loc}\n#{sitemap}"
-        exit 1
-      end
-      page = example.join("_site#{path}index.html")
-      unless page.file?
-        warn "FAIL test-examples-build: missing static detail #{page}"
-        exit 1
-      end
-      body = page.read
-      canonical = body[/rel="canonical" href="([^"]+)"/, 1].to_s
-      og_url = body[/property="og:url" content="([^"]+)"/, 1].to_s
-      unless canonical.include?(path) && !canonical.include?("/pages/")
-        warn "FAIL test-examples-build: canonical for #{path} is #{canonical}"
-        exit 1
-      end
-      unless og_url.include?(path) && !og_url.include?("/pages/")
-        warn "FAIL test-examples-build: og:url for #{path} is #{og_url}"
-        exit 1
-      end
-      unless body.include?(%("@type": "#{schema}"))
-        warn "FAIL test-examples-build: #{path} missing #{schema} JSON-LD"
-        exit 1
-      end
-      listing_attr = path.include?("/posts/") ? "/pages/blog/" : "/pages/articles/"
-      unless body.include?(%(data-listing-path="#{listing_attr}"))
-        warn "FAIL test-examples-build: #{path} lost the listing path"
-        exit 1
-      end
+  built_redirects_path = example.join("_site/_redirects")
+  unless built_redirects_path.file?
+    warn "FAIL test-examples-build: #{name} missing built _redirects"
+    exit 1
+  end
+  built_redirects = built_redirects_path.read
+  [
+    "/articles/:slug /pages/articles/ 200",
+    "/posts/:slug /pages/blog/ 200",
+    "/blog/:slug /pages/blog/ 200",
+    "/projects/:slug /pages/projects/ 200",
+    "/products/:slug /pages/cv/ 200"
+  ].each do |line|
+    unless built_redirects.include?(line)
+      warn "FAIL test-examples-build: #{name} built _redirects missing #{line}\n#{built_redirects}"
+      exit 1
     end
-    ["/projects/demo-kit/", "/products/ledger-tool/"].each do |path|
+  end
+  if original_redirects && redirects_path.read != original_redirects
+    warn "FAIL test-examples-build: #{name} build edited the source _redirects"
+    exit 1
+  end
+  if name == "full"
+    %w[
+      /articles/2026-01-01-welcome/
+      /posts/2026-01-02-note/
+      /projects/demo-kit/
+      /products/ledger-tool/
+    ].each do |path|
       loc = "#{origin}#{path}"
-      unless sitemap.include?("<loc>#{loc}</loc>")
-        warn "FAIL test-examples-build: sitemap missing #{loc}\n#{sitemap}"
+      if sitemap.include?("<loc>#{loc}</loc>")
+        warn "FAIL test-examples-build: sitemap lists detail #{loc}"
         exit 1
       end
       page = example.join("_site#{path}index.html")
-      body = page.file? ? page.read : ""
-      canonical = body[/rel="canonical" href="([^"]+)"/, 1].to_s
-      unless canonical.include?(path)
-        warn "FAIL test-examples-build: canonical for #{path} is #{canonical}"
+      if page.file?
+        warn "FAIL test-examples-build: static detail page #{page}"
         exit 1
       end
     end
-    built_redirects = example.join("_site/_redirects").read
-    if built_redirects.match?(%r{/(?:articles|posts|blog|projects|products)/:slug})
-      warn "FAIL test-examples-build: built _redirects still rewrites detail URLs\n#{built_redirects}"
-      exit 1
-    end
-    unless redirects_path.read.match?(%r{/articles/:slug\s+/pages/articles/\s+200})
-      warn "FAIL test-examples-build: the build edited the source _redirects"
-      exit 1
-    end
   end
   unless html.include?('application/ld+json') && html.include?('"@type": "Person"')
     warn "FAIL test-examples-build: #{name} home is missing JSON-LD"

data/scripts/test/test-home-band-art.rb

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-# Home band art (docs/features/home-band-art.md).
+# Home band art. Watch paths: docs/deploy/cloudflare.md.
 #
 # AC-BAND-01 the export writes both plates under data/
 # AC-BAND-03 a second export with no content change reports them unchanged

data/scripts/test/test-new.rb

@@ -32,6 +32,46 @@ if readme.include?("once 1.1 is on RubyGems")
   exit 1
 end
 
+version = ROOT.join("lib/pandorga/version.rb").read[/VERSION = "([^"]+)"/, 1]
+unless version
+  warn "FAIL test-new: Pandorga::VERSION missing"
+  exit 1
+end
+
+deploy = ROOT.join("docs/deploy/cloudflare.md").read
+upgrading = ROOT.join("docs/upgrading.md").read
+scaffold = ROOT.join("lib/pandorga/commands/new.rb").read
+[
+  [deploy, "docs/deploy/cloudflare.md"],
+  [upgrading, "docs/upgrading.md"],
+  [scaffold, "lib/pandorga/commands/new.rb"]
+].each do |text, label|
+  if text.include?("v1.0.0") || text.include?("v1.3.11") || text.include?("v1.5.0")
+    warn "FAIL test-new: #{label} still names a stale release pin"
+    exit 1
+  end
+end
+unless deploy.include?('~> 1.3') && deploy.include?(%(tag: "v#{version}"))
+  warn "FAIL test-new: deploy doc must pin ~> 1.3 and tag v#{version}"
+  exit 1
+end
+unless deploy.include?("content/*") && deploy.include?("docs/*") && deploy.include?("Gemfile.lock")
+  warn "FAIL test-new: deploy doc lost the watch-path include and excludes"
+  exit 1
+end
+unless deploy.include?("3.4.4") && deploy.include?("SKIP_DEPENDENCY_INSTALL")
+  warn "FAIL test-new: deploy doc lost the Pages Ruby pin or SKIP_DEPENDENCY_INSTALL"
+  exit 1
+end
+unless upgrading.include?(%(tag: "v#{version}")) && upgrading.include?("pandorga-#{version}.gem")
+  warn "FAIL test-new: upgrading examples are not v#{version}"
+  exit 1
+end
+unless scaffold.include?(%(tag: "v#{version}"))
+  warn "FAIL test-new: scaffold comment is not tag v#{version}"
+  exit 1
+end
+
 FileUtils.rm_rf(DEST)
 
 stdout, stderr, status = run_new(DEST.to_s)

data/scripts/test/test-r2-config-consistency.rb

@@ -36,7 +36,7 @@ end
 
 if ContentStorageConfig.placeholder?(base)
   puts "SKIP: R2 URL alignment checks (content_api_base_url is still placeholder: #{base})"
-  puts "      Fill the URL per docs/ops/cloudflare.md before production cutover."
+  puts "      Fill the URL per docs/deploy/cloudflare.md before production cutover."
   exit 0
 end
 

data/scripts/test/test-theme-contrast.rb

@@ -40,4 +40,24 @@ fail!("dark tertiary container moved") unless background.casecmp("#6a684f").zero
 ratio = contrast(foreground, background)
 fail!("#{foreground} on #{background} is #{ratio.round(2)}:1") unless ratio >= 4.5
 
-puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1)"
+# Footer imprint middot. outline-variant is a hairline and fails as ink
+# on the panel step. The separator uses outline, which clears 4.5:1.
+footer = ROOT.join("assets/css/ledger/footer.css").read
+fail!("footer imprint separator still uses outline-variant") if footer.include?("color: var(--color-outline-variant)")
+fail!("footer imprint separator lost outline") unless footer.include?("color: var(--color-outline)")
+
+light = YAML.safe_load(ROOT.join("_data/themes/light.yml").read) || {}
+pairs = {
+  "light" => [light.dig("neutrals", "outline"), light.dig("neutrals", "panel_contrast")],
+  "dark" => [dark.dig("neutrals", "outline"), dark.dig("neutrals", "panel_contrast")]
+}
+reports = []
+pairs.each do |name, (ink, panel)|
+  fail!("#{name} outline or panel missing") if ink.to_s.empty? || panel.to_s.empty?
+
+  pair_ratio = contrast(ink, panel)
+  fail!("#{name} outline #{ink} on panel #{panel} is #{pair_ratio.round(2)}:1") unless pair_ratio >= 4.5
+  reports << "#{name} #{ink} on #{panel} = #{pair_ratio.round(2)}:1"
+end
+
+puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1; #{reports.join('; ')})"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 1.7.4
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -304,7 +304,6 @@ files:
 - lib/pandorga/jekyll/plugins/content_validators_hook.rb
 - lib/pandorga/jekyll/plugins/content_writing_index.rb
 - lib/pandorga/jekyll/plugins/content_writing_paths.rb
-- lib/pandorga/jekyll/plugins/detail_documents.rb
 - lib/pandorga/jekyll/plugins/discovery.rb
 - lib/pandorga/jekyll/plugins/fonts.rb
 - lib/pandorga/jekyll/plugins/force_utf8_encoding.rb
@@ -319,6 +318,7 @@ files:
 - lib/pandorga/jekyll/plugins/lib/text_excerpt.rb
 - lib/pandorga/jekyll/plugins/lib/writing_entry.rb
 - lib/pandorga/jekyll/plugins/local_detail_rewrites.rb
+- lib/pandorga/jekyll/plugins/shell_redirects.rb
 - lib/pandorga/jekyll/plugins/timeline.rb
 - lib/pandorga/jekyll/plugins/web_manifest.rb
 - lib/pandorga/jekyll/plugins/writing_slug_limits.rb
@@ -328,7 +328,6 @@ files:
 - lib/pandorga/version.rb
 - scripts/cdn-allowlist.json
 - scripts/check_home_lists.mjs
-- scripts/content/backfill-content-keys.rb
 - scripts/content/band_art.rb
 - scripts/content/export-content-json.rb
 - scripts/content/flatten-ansi-capture.mjs
@@ -405,7 +404,6 @@ files:
 - scripts/test/render-parity/youtube.json
 - scripts/test/test-absent-field-absent-element.rb
 - scripts/test/test-cdn-pins.rb
-- scripts/test/test-cloudflare-watch-paths-doc.rb
 - scripts/test/test-configuration-doc.rb
 - scripts/test/test-content-backend.rb
 - scripts/test/test-content-detail-urls.rb

data/lib/pandorga/jekyll/plugins/detail_documents.rb

@@ -1,154 +0,0 @@
-# frozen_string_literal: true
-
-require "jekyll"
-require "pathname"
-
-require_relative "../../detail_routes"
-require_relative "lib/writing_entry"
-
-module Pandorga
-  module Jekyll
-    # One static page per published article, post, project, and product.
-    # The listing layout stays, so the client still opens the entry from
-    # the URL. `listing_path` stays the listing URL. The permalink is the
-    # detail URL, which is what the sitemap and the static canonical use.
-    class DetailDocumentsGenerator < ::Jekyll::Generator
-      safe true
-      priority :low
-
-      COLLECTION_FOR_TYPE = {
-        "article" => "articles",
-        "post" => "posts",
-        "project" => "projects",
-        "product" => "products"
-      }.freeze
-
-      DETAIL_PATTERN = {
-        "article" => "/articles/:slug/",
-        "post" => "/posts/:slug/",
-        "project" => "/projects/:slug/",
-        "product" => "/products/:slug/"
-      }.freeze
-
-      SCHEMA = {
-        "article" => "Article",
-        "post" => "BlogPosting"
-      }.freeze
-
-      def generate(site)
-        return if site.config["shell_content_agnostic"]
-
-        root = Pathname.new(site.source)
-        COLLECTION_FOR_TYPE.each do |type, collection|
-          listing = listing_page(site, type)
-          next unless listing
-          next if listing.data["listing_path"].to_s.empty?
-
-          directory = root.join(ContentKeys::CONTENT_PATHS.fetch(type))
-          next unless directory.directory?
-
-          Dir.glob(directory.join("*.{md,markdown}")).sort.each do |absolute|
-            emit(site, listing, type, collection, absolute, root)
-          end
-        end
-      end
-
-      private
-
-      def emit(site, listing, type, collection, absolute, root)
-        relative = Pathname.new(absolute).relative_path_from(root.join("content"))
-        repo_relative = Pathname.new("content").join(relative).to_s
-        record = WritingEntry.build(absolute, collection, repo_relative)
-        return if record.nil?
-
-        detail_path = record["url"].to_s
-        return if detail_path.empty?
-        return if taken?(site, detail_path)
-
-        front_matter, = ContentKeys.split_front_matter(File.read(absolute))
-        dir = detail_path.sub(%r{\A/}, "").sub(%r{/\z}, "")
-        page = ::Jekyll::PageWithoutAFile.new(site, site.source, dir, "index.html")
-        page.data["layout"] = listing.data["layout"]
-        page.data["permalink"] = detail_path
-        page.data["canonical_url"] = detail_path
-        page.data["listing_path"] = listing.data["listing_path"]
-        page.data["collection"] = collection
-        page.data["detail"] = listing.data["detail"].to_s
-        page.data["detail"] = DETAIL_PATTERN.fetch(type) if page.data["detail"].empty?
-        page.data["detail_document"] = true
-        page.data["accent"] = listing.data["accent"] if listing.data["accent"]
-        title = record["title"].to_s.strip
-        title = record["key"].to_s if title.empty?
-        page.data["title"] = title unless title.empty?
-        description = record["description"].to_s.strip
-        description = record["excerpt"].to_s.strip if description.empty?
-        page.data["description"] = description unless description.empty?
-        page.data["date"] = record["date"] unless record["date"].to_s.empty?
-        page.data["last_updated"] = record["last_updated"] unless record["last_updated"].to_s.empty?
-        thumbnail = record["thumbnail"].to_s.strip
-        page.data["thumbnail"] = thumbnail unless thumbnail.empty?
-        lang = front_matter["language"] || front_matter["lang"] || listing.data["lang"]
-        page.data["lang"] = lang if lang
-        if SCHEMA.key?(type)
-          page.data["og_type"] = "article"
-          page.data["schema_type"] = SCHEMA.fetch(type)
-        end
-        page.content = ""
-        site.pages << page
-      end
-
-      def taken?(site, detail_path)
-        site.pages.any? do |page|
-          page.data["permalink"].to_s == detail_path || page.url.to_s == detail_path
-        end
-      end
-
-      def listing_page(site, type)
-        entry = registry_entry(site, type)
-        return nil unless entry
-
-        site.pages.find do |page|
-          page.data["detail_document"] != true && page.data["key"].to_s == entry["key"].to_s
-        end
-      end
-
-      def registry_entry(site, type)
-        pages = site.data["pandorga_pages"]
-        return nil unless pages.is_a?(Array)
-
-        pages.find { |entry| entry.is_a?(Hash) && registry_match?(entry, type) }
-      end
-
-      def registry_match?(entry, type)
-        case type
-        when "article"
-          entry["template"].to_s == "articles" || entry["collection"].to_s == "articles"
-        when "post"
-          entry["template"].to_s == "blog" || entry["collection"].to_s == "posts"
-        when "project"
-          entry["template"].to_s == "portfolio" || entry["collection"].to_s == "projects"
-        when "product"
-          cols = entry["collections"]
-          entry["template"].to_s == "cv" ||
-            (cols.is_a?(Hash) && !cols["products"].to_s.empty?)
-        else
-          false
-        end
-      end
-    end
-  end
-end
-
-Jekyll::Hooks.register :site, :post_write do |site|
-  # Jekyll skips underscore files, so a source `_redirects` never reaches
-  # the output unless the site lists it under `include`. The published
-  # file has to be the one Cloudflare reads.
-  dest = File.join(site.dest, "_redirects")
-  source = File.join(site.source, "_redirects")
-  File.write(dest, File.read(source)) if !File.file?(dest) && File.file?(source)
-  next unless File.file?(dest)
-
-  original = File.read(dest)
-  stripped = Pandorga::DetailRoutes.strip_splat_rewrites(original)
-  File.write(dest, stripped) if stripped != original
-end

data/scripts/content/backfill-content-keys.rb

@@ -1,99 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-require "yaml"
-
-require_relative "../../_plugins/content_keys"
-require_relative "../../_plugins/content_detail_paths"
-require_relative "../../_plugins/git_chronology"
-
-REPO_ROOT = Pathname.new(__dir__).join("..", "..").expand_path
-CONTENT_ROOT = REPO_ROOT.join("content")
-
-KEY_OVERRIDES = {
-  "content/collections/posts/2026-03-06-horse-auto-follow.md" => "horse-auto-follow-pt",
-  "content/collections/posts/2026-03-02-mcmc.md" => "mcmc-pt"
-}.freeze
-
-def split_front_matter(text)
-  ContentKeys.split_front_matter(text)
-end
-
-def write_front_matter(path, front_matter, body)
-  yaml = front_matter.to_yaml.sub(/\A---\n/, "").strip
-  path.write("---\n#{yaml}\n---\n\n#{body}")
-end
-
-def infer_key(entry)
-  override = KEY_OVERRIDES[entry["repo_relative_path"]]
-  return override if override
-
-  key = ContentKeys.normalize_key(entry["key"])
-  return key unless key.empty?
-
-  ContentKeys.infer_key_from_filename(entry["path"], entry["type"])
-end
-
-def legacy_detail_path(type, legacy_segment)
-  case type
-  when "article" then ContentDetailPaths.article_detail_path(legacy_segment)
-  when "post" then ContentDetailPaths.post_detail_path(legacy_segment)
-  when "project" then ContentDetailPaths.project_detail_path(legacy_segment)
-  when "product" then ContentDetailPaths.product_detail_path(legacy_segment)
-  else
-    raise "unknown type #{type}"
-  end
-end
-
-def migrate_redirect_fields!(front_matter)
-  redirects = ContentKeys.normalize_redirects(front_matter)
-  front_matter.delete("redirect_from")
-  front_matter["redirects"] = redirects unless redirects.empty?
-  front_matter
-end
-
-def ensure_legacy_redirect!(front_matter, type, legacy_segment, canonical_path)
-  redirects = ContentKeys.normalize_redirects(front_matter)
-  legacy = legacy_detail_path(type, legacy_segment).chomp("/")
-  canonical = canonical_path.chomp("/")
-  redirects << legacy unless legacy == canonical
-  redirects = redirects.map { |path| ContentKeys.normalize_redirect_path(path) }.compact.uniq
-  front_matter["redirects"] = redirects unless redirects.empty?
-  front_matter.delete("redirects") if redirects.empty?
-  front_matter
-end
-
-updated = 0
-ContentKeys::CONTENT_PATHS.each do |type, relative_dir|
-  directory = CONTENT_ROOT.join(relative_dir.sub(%r{\Acontent/}, ""))
-  next unless directory.directory?
-
-  Dir.glob(directory.join("*.{md,markdown}")).sort.each do |absolute_path|
-    entry = ContentKeys.load_entry(absolute_path, type, repo_root: REPO_ROOT)
-    text = File.read(absolute_path).sub(/\A\xEF\xBB\xBF/, "")
-    front_matter, body = split_front_matter(text)
-    original_yaml = front_matter.to_yaml
-
-    key = infer_key(entry)
-    front_matter["key"] = key
-    migrate_redirect_fields!(front_matter)
-
-    if %w[article post].include?(type)
-      GitChronology.apply!(front_matter, entry["repo_relative_path"], type)
-    end
-
-    canonical = ContentKeys.detail_path(type, key, date: front_matter["date"])
-    ensure_legacy_redirect!(front_matter, type, entry["legacy_segment"], canonical)
-
-    next if front_matter.to_yaml == original_yaml
-
-    write_front_matter(Pathname(absolute_path), front_matter, body.sub(/\A\n+/, ""))
-    updated += 1
-    puts "updated #{entry['repo_relative_path']} (key=#{key})"
-  end
-end
-
-ContentKeys.validate!(REPO_ROOT)
-ContentKeys.sync_redirects_file!(REPO_ROOT)
-puts "Backfill complete (#{updated} file(s) updated). Redirects synced to _redirects."

data/scripts/test/test-cloudflare-watch-paths-doc.rb

@@ -1,31 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-
-ROOT = Pathname.new(__dir__).join("..", "..").expand_path
-DOC = ROOT.join("docs/ops/cloudflare.md")
-
-def check!(condition, message = "condition was false")
-  raise "Assertion failed: #{message}" unless condition
-end
-
-text = DOC.read
-
-puts "Testing Cloudflare watch paths documentation..."
-
-check! text.include?("`*`"), "missing include pattern `*`"
-check! text.include?("`content/*`"), "missing exclude pattern content/*"
-check! text.include?("`docs/*`"), "missing exclude pattern docs/*"
-check! text.include?("Settings → Build → Build watch paths"),
-       "missing dashboard navigation path"
-check! text.include?("SKIP_DEPENDENCY_INSTALL"),
-       "missing SKIP_DEPENDENCY_INSTALL (avoids Pages pip install of study deps)"
-check! text.include?("bundle install") && text.include?("jekyll build"),
-       "missing lean Pages build command with explicit bundle install"
-check! text.include?("pandorga install-functions"),
-       "missing pandorga install-functions in Pages build command (PLT-0.2)"
-check! text.include?("3.4.4"),
-       "missing Pages v3 Ruby 3.4.4 pin (avoids compiling Ruby from source)"
-
-puts "Cloudflare watch paths documentation OK."