build(release): publish the showcase the cut produced, not the one lying in target

.gitignore

@@ -45,14 +45,6 @@ render-pdf/logs/
 *.pdf
 # Allow PDF previews that are committed README assets.
 !assets/readme/**/*.pdf
-# Allow PDF previews that ship with the GitHub Pages showcase site.
-!docs/assets/**/*.pdf
-!docs/showcase/**/*.pdf
-# Same whitelist for the Next.js showcase site under site/ — 53 PDFs
-# mirrored from docs/showcase by Sync-SiteShowcase, plus 3 Playground
-# preview PDFs (hello/invoice/cv) bundled with site/public/previews/.
-!site/public/showcase/**/*.pdf
-!site/public/previews/*.pdf
 # Same whitelist for the live GitHub Pages showcase under web/. The showcase
 # moved out of docs/ into web/ but this list was not updated, so every newly
 # added example PDF was silently ignored and 404'd on the deployed site.

CHANGELOG.md

@@ -22,6 +22,23 @@ follow semantic versioning; release dates are ISO 8601.
 - **`graph-compose-render-pptx` declares PDFBox.** It compiles against
   `org.apache.pdfbox` types while declaring only `fontbox`, taking the rest
   transitively; the resolved version is unchanged.
+- **The release publishes the showcase it just built.** `cut-release.ps1` never
+  ran `GenerateAllExamples`, so the site was synced from whatever happened to be
+  in `examples/target/generated-pdfs` — nothing at all on a clean checkout, which
+  aborted the cut. Step 4 regenerates the catalogue first.
+- **A removed example stops being published.** `ShowcaseSync` copied but never
+  deleted, so an artifact whose example was renamed or removed stayed live on the
+  site indefinitely, reachable by URL and absent from the manifest. Three such
+  documents are gone.
+- **Every generated document has a showcase card.** Eight artifacts had no
+  metadata entry and published as filename-derived placeholders linking the
+  examples root — among them both flagships the 2.1 line exists to show.
+  `EngineDeckV2Example`, which renders the deck the README banner is cut from,
+  was never wired into the example runner at all.
+- **Five committed previews were re-rendered.** The largest, the PDF-chrome
+  preview, was drawn at low alpha throughout with the watermark bleeding through
+  every panel. Eleven committed binaries that nothing references, 9 MiB of them,
+  are removed.
 - **The release script owns the README release-status block.** It was a
   hand-edit the script only validated, and the validation demanded the *target*
   version — so between releases `develop` had to advertise an unpublished version

examples/src/main/java/com/demcha/examples/GenerateAllExamples.java

@@ -46,6 +46,7 @@
 import com.demcha.examples.flagships.BusinessReportExample;
 import com.demcha.examples.flagships.BusinessReportPptxExample;
 import com.demcha.examples.flagships.EngineDeckExample;
+import com.demcha.examples.flagships.EngineDeckV2Example;
 import com.demcha.examples.flagships.EngineDeckPptxExample;
 import com.demcha.examples.flagships.FeatureCatalogExample;
 import com.demcha.examples.flagships.FinancialReportExample;
@@ -222,7 +223,12 @@ public static void main(String[] args) throws Exception {
         System.out.println("Generated: " + BusinessReportExample.generate());
         System.out.println("Generated: " + BusinessReportPptxExample.generate());
         System.out.println("Generated: " + EngineDeckExample.generate());
+        System.out.println("Generated: " + EngineDeckV2Example.generate());
         System.out.println("Generated: " + EngineDeckPptxExample.generate());
+        // The PDF first: ShowcaseSync builds a card per PDF and publishes a PPTX only
+        // as the same-named companion beside one, so a deck without its PDF twin never
+        // reaches the site at all.
+        System.out.println("Generated: " + MavenBannerPptxExample.generatePdf());
         System.out.println("Generated: " + MavenBannerPptxExample.generate());
         System.out.println("Generated: " + SocialCardExample.generate());
         System.out.println("Generated: " + SocialCardExample.generatePptx());