@nexus-cortex/server 4.26.0

package/.cortex/skills/pdf-documents/sections/06-svg-charts.md

@@ -0,0 +1,100 @@
+# SVG Charts and Diagrams (Inline)
+
+Always use **inline SVG** for charts — no external dependencies, scales perfectly in print.
+
+## Bar Chart Pattern
+
+```html
+<div class="chart-container">
+  <p class="chart-title">Monthly Revenue</p>
+  <svg viewBox="0 0 600 300" xmlns="http://www.w3.org/2000/svg" style="width:100%;height:auto;">
+    <!-- Y-axis -->
+    <line x1="50" y1="20" x2="50" y2="250" stroke="#333" stroke-width="1"/>
+    <!-- X-axis -->
+    <line x1="50" y1="250" x2="580" y2="250" stroke="#333" stroke-width="1.5"/>
+    <!-- Grid lines (light, behind bars) -->
+    <line x1="50" y1="150" x2="580" y2="150" stroke="#eee" stroke-width="1"/>
+    <!-- Bars: x = 60 + (i * barSpacing), height = value * scale -->
+    <rect x="70" y="100" width="35" height="150" rx="3" fill="#2563eb"/>
+    <text x="87" y="270" text-anchor="middle" font-size="10">Jan</text>
+    <text x="87" y="95" text-anchor="middle" font-size="9" fill="#333">$15K</text>
+    <!-- ... more bars ... -->
+  </svg>
+</div>
+```
+
+**Key SVG print rules:**
+- Use `viewBox` + `style="width:100%;height:auto;"` for responsive scaling
+- Font sizes in SVG are independent of CSS — use `font-size="10"` (unitless = px in SVG)
+- Colors: use `fill` and `stroke`, not CSS `color`
+- For print, avoid very thin strokes (`stroke-width` < 0.5) — they may vanish
+- Prefer `font-family="sans-serif"` in SVG for cross-platform rendering
+
+## Pie Chart Pattern (Path-based)
+
+```html
+<!-- Pie slice: M center, L start-point, A rx,ry rotation large-arc-flag sweep-flag end-point Z -->
+<!-- 25% slice (90 degrees) starting at 12 o'clock -->
+<path d="M150,150 L150,50 A100,100 0 0,1 250,150 Z" fill="#2563eb"/>
+```
+
+**Calculating pie slices:**
+```
+For a pie centered at (cx, cy) with radius r:
+  Start angle (radians) = (startPercent / 100) * 2 * PI - PI/2
+  End angle (radians) = (endPercent / 100) * 2 * PI - PI/2
+  Start point: (cx + r * cos(startAngle), cy + r * sin(startAngle))
+  End point: (cx + r * cos(endAngle), cy + r * sin(endAngle))
+  Large arc flag: 1 if slice > 50%, else 0
+```
+
+## Line Chart Pattern
+
+```html
+<svg viewBox="0 0 600 300" style="width:100%;height:auto;">
+  <!-- Data line -->
+  <polyline
+    points="60,200 120,180 180,120 240,140 300,80 360,60 420,90"
+    fill="none" stroke="#2563eb" stroke-width="2.5" stroke-linejoin="round"/>
+  <!-- Area fill (optional) -->
+  <polygon
+    points="60,200 120,180 180,120 240,140 300,80 360,60 420,90 420,250 60,250"
+    fill="#2563eb" fill-opacity="0.1"/>
+  <!-- Data points -->
+  <circle cx="60" cy="200" r="4" fill="#2563eb"/>
+  <!-- ... more circles ... -->
+</svg>
+```
+
+## Map / Diagram Pattern
+
+Use simplified SVG `<path>` for geographic outlines. For complex maps, trace from a reference SVG and simplify to essential boundaries. Keep path data minimal — agents don't need cartographic precision, just recognisable shapes with labelled regions.
+
+```html
+<svg viewBox="0 0 400 300" style="width:100%;height:auto;">
+  <!-- Simplified coastline/boundary -->
+  <path d="M50,150 C80,100 120,80 160,90 S240,120 280,100 S360,130 380,160"
+        fill="none" stroke="#333" stroke-width="1.5"/>
+  <!-- Region labels -->
+  <text x="200" y="80" text-anchor="middle" font-size="12" font-weight="bold">Region A</text>
+  <!-- Route line -->
+  <path d="M80,180 Q200,220 350,140" fill="none" stroke="#e53e3e" 
+        stroke-width="2" stroke-dasharray="5,3"/>
+  <!-- Location markers -->
+  <circle cx="80" cy="180" r="5" fill="#e53e3e"/>
+  <circle cx="350" cy="140" r="5" fill="#e53e3e"/>
+</svg>
+```
+
+## Print-Specific Chart Considerations
+
+- Wrap ALL charts in `.chart-container { break-inside: avoid; }` to prevent page splits
+- Use `fill-opacity` instead of RGBA for better print rendering
+- Minimum `stroke-width="0.5"` for lines that must be visible in print
+- For color-blind accessibility, add patterns or labels to distinguish series:
+  ```html
+  <pattern id="stripe" patternUnits="userSpaceOnUse" width="4" height="4">
+    <path d="M-1,1 l2,-2 M0,4 l4,-4 M3,5 l2,-2" stroke="#333" stroke-width="0.5"/>
+  </pattern>
+  <rect ... fill="url(#stripe)"/>
+  ```

package/.cortex/skills/pdf-documents/sections/07-templates.md

@@ -0,0 +1,224 @@
+# Document Layout Templates and External Template Sources
+
+## Built-In CSS Layout Snippets
+
+### Research Report (A4/Letter)
+
+```css
+body { font-family: Georgia, 'Times New Roman', serif; font-size: 11pt; line-height: 1.6; }
+@page { size: A4; margin: 25mm 20mm 30mm 20mm; }
+h1 { font-size: 22pt; } h2 { font-size: 16pt; } h3 { font-size: 13pt; }
+table { font-size: 9.5pt; }
+figcaption { font-size: 9pt; }
+.cover { text-align: center; padding-top: 80mm; break-after: page; }
+```
+
+### Technical Specification (A4 two-column)
+
+```css
+body { font-family: 'Helvetica Neue', Arial, sans-serif; font-size: 9.5pt; }
+@page { size: A4; margin: 15mm 12mm 20mm 12mm; }
+.content { column-count: 2; column-gap: 8mm; }
+.content h2 { column-span: all; }  /* headers span full width */
+table { font-size: 8.5pt; break-inside: avoid; }
+code { font-size: 8pt; }
+```
+
+### Presentation / Slide Deck (Landscape)
+
+```css
+@page { size: A4 landscape; margin: 10mm; }
+.slide {
+  height: 170mm;       /* A4 landscape height minus margins */
+  break-after: page;
+  display: flex; flex-direction: column; justify-content: center;
+  padding: 15mm;
+}
+.slide h1 { font-size: 28pt; text-align: center; }
+```
+
+### Book / Booklet (Facing Pages)
+
+```css
+@page { size: B5; margin: 20mm 15mm 25mm 20mm; }
+@page :left { margin-left: 25mm; margin-right: 15mm; }   /* gutter on left */
+@page :right { margin-left: 15mm; margin-right: 25mm; }  /* gutter on right */
+@page :first { margin-top: 50mm; }  /* extra space on title page */
+```
+
+---
+
+## Using Existing Document Templates
+
+Thousands of professionally designed templates already exist. Use them as **conversion targets** (direct HTML extraction) or **design references** (extract the tokens, rebuild in clean HTML).
+
+### Template Sources by Format
+
+| Source | Formats | Cost | Best For |
+|--------|---------|------|----------|
+| **Microsoft Office Templates** | `.docx`, `.pptx` | Free (with Office) | Business reports, letters, proposals, invoices |
+| **Google Docs/Slides Templates** | Google Docs (export `.docx`) | Free | Quick collaborative drafts |
+| **LaTeX Document Classes** | `.cls`, `.sty`, `.tex` | Free | Academic papers, theses, CVs, books |
+| **Canva** | Export as PDF | Free tier + Pro | Marketing, social media, presentations |
+| **Adobe InDesign** | `.indd`, export PDF/IDML | Paid | Magazines, brochures, print-heavy layouts |
+| **Figma** | Export PDF/SVG | Free tier | Modern UI-influenced layouts, cards |
+| **HTML Template Libraries** | HTML/CSS | Free-Paid | Direct drop-in — already HTML |
+| **Typst** | `.typ` | Free | Modern LaTeX alternative, cleaner syntax |
+
+### Direct Conversion: Template → HTML
+
+**DOCX → HTML (Best fidelity for Word templates)**
+
+```bash
+# Mammoth.js — semantic conversion (recommended for clean HTML)
+npx mammoth input.docx --output=output.html --style-map="p[style-name='Title'] => h1:fresh"
+
+# LibreOffice headless — preserves visual layout more closely
+libreoffice --headless --convert-to html input.docx
+
+# Pandoc — universal converter (good for body text, loses complex layout)
+pandoc input.docx -o output.html --standalone --embed-resources
+```
+
+Mammoth produces the cleanest HTML. LibreOffice preserves visual layout but generates messy markup. **Always Mammoth first**, fall back to LibreOffice when layout fidelity matters more than clean code.
+
+**PPTX → HTML**
+
+```bash
+libreoffice --headless --convert-to html input.pptx
+pandoc input.pptx -o output.html --standalone
+```
+
+PowerPoint templates are better treated as **design references** — the absolute-positioned HTML from converters is unusable for responsive print CSS.
+
+**LaTeX → HTML**
+
+```bash
+# make4ht — best LaTeX→HTML (preserves math as MathML or SVG)
+make4ht input.tex "html5,mathml" "" "" "--output-dir=out"
+
+# Pandoc — simpler, handles most LaTeX well
+pandoc input.tex -o output.html --standalone --mathjax --embed-resources
+
+# LaTeXML — highest fidelity for complex documents
+latexml input.tex | latexmlpost --dest=output.html
+```
+
+**LaTeX class → CSS equivalents:**
+
+| LaTeX Class | CSS Equivalent |
+|-------------|---------------|
+| `\documentclass[twocolumn]{article}` | `column-count: 2; column-gap: 8mm;` |
+| `\geometry{margin=1in}` | `@page { margin: 25.4mm; }` |
+| `\setmainfont{Palatino}` | `body { font-family: 'Palatino Linotype', Palatino, serif; }` |
+| `\linespread{1.25}` | `body { line-height: 1.25; }` |
+| `\parindent 1.5em` | `p + p { text-indent: 1.5em; }` |
+
+**Typst → HTML/PDF**
+
+```bash
+typst compile input.typ output.pdf
+pandoc -f typst input.typ -o output.html --standalone  # experimental
+```
+
+**Canva / Figma → HTML**: No reliable direct conversion. Use the design reference workflow below.
+
+**HTML Template Libraries (Direct Use)**
+
+| Library | License | Templates |
+|---------|---------|-----------|
+| **HTML5 UP** | CC BY 3.0 (free) | 40+ responsive templates |
+| **Tailwind UI** | Paid | Component library — cards, heroes, pricing |
+| **Bootstrap Examples** | MIT | 20+ example layouts |
+| **Paged.js Templates** | MIT | Print-specific — book, report, thesis (built for `@page`) |
+
+Paged.js templates are the best starting point — built specifically for `@page` rules, `break-*` properties, and running headers/footers.
+
+### The Design Reference Workflow
+
+When direct conversion produces messy HTML (most of the time), treat the template as a **visual specification**:
+
+```
+1. BROWSE the template (open in viewer/browser/renderer)
+   → Screenshot key pages (cover, body, table page, chart page)
+
+2. EXTRACT design tokens: fonts, colors, spacing, column layout, decorative elements
+
+3. BUILD a CSS custom properties block:
+   :root {
+     --font-heading: 'Playfair Display', Georgia, serif;
+     --font-body: 'Source Sans 3', 'Segoe UI', sans-serif;
+     --color-bg: oklch(0.99 0.005 240);
+     --color-text: oklch(0.20 0.02 240);
+     --color-accent: oklch(0.55 0.18 250);
+     --margin-page: 20mm 18mm 25mm 18mm;
+     --font-size-body: 10.5pt;
+   }
+
+4. WRITE the HTML using your token system (normal pipeline from SKILL.md onward)
+```
+
+This produces **cleaner, more maintainable HTML** than any automated converter.
+
+### Ready-to-Use Template Recipes
+
+**Academic Paper (from LaTeX `article` class)**
+
+```css
+@page { size: letter; margin: 1in; }
+body { font-family: 'Computer Modern Serif', 'Latin Modern Roman', Georgia, serif;
+       font-size: 10pt; line-height: 1.4; }
+h1 { font-size: 17pt; text-align: center; margin-bottom: 6pt; }
+h2 { font-size: 12pt; font-style: italic; }
+.abstract { font-size: 9pt; margin: 0 15mm; font-style: italic; }
+.two-col { column-count: 2; column-gap: 6mm; }
+p + p { text-indent: 1.5em; margin-top: 0; }
+```
+
+**Corporate Report (from Word "Facet" template)**
+
+```css
+@page { size: A4; margin: 20mm 18mm 25mm 18mm; }
+body { font-family: 'Source Sans 3', 'Segoe UI', sans-serif;
+       font-size: 10.5pt; line-height: 1.5; color: oklch(0.25 0.02 250); }
+h1 { font-size: 26pt; font-weight: 300; color: oklch(0.35 0.15 250);
+     border-bottom: 3px solid oklch(0.55 0.20 250); padding-bottom: 8pt; }
+h2 { font-size: 14pt; font-weight: 600; color: oklch(0.35 0.15 250); }
+.cover { break-after: page; display: flex; flex-direction: column;
+         justify-content: center; height: 100vh;
+         background: linear-gradient(135deg, oklch(0.30 0.12 250), oklch(0.20 0.08 250)); color: white; }
+table thead { background: oklch(0.35 0.12 250); color: white; }
+```
+
+**Magazine / Newsletter (from InDesign layout)**
+
+```css
+@page { size: A4; margin: 12mm 10mm 15mm 10mm; }
+body { font-family: 'Libre Franklin', 'Helvetica Neue', sans-serif;
+       font-size: 9.5pt; line-height: 1.45; }
+.spread { column-count: 3; column-gap: 5mm; }
+.pullquote { font-size: 18pt; font-family: 'Playfair Display', Georgia, serif;
+             font-style: italic; color: oklch(0.50 0.20 30);
+             border-left: 4px solid oklch(0.50 0.20 30); padding-left: 12pt;
+             column-span: all; margin: 16pt 0; }
+.caption { font-size: 7.5pt; color: oklch(0.45 0.02 250); }
+figure { break-inside: avoid; margin: 0 0 8pt 0; }
+```
+
+**Invoice / Receipt (from Google Docs template)**
+
+```css
+@page { size: letter; margin: 15mm; }
+body { font-family: 'Inter', system-ui, sans-serif;
+       font-size: 9pt; line-height: 1.4; color: oklch(0.25 0 0); }
+.header { display: flex; justify-content: space-between; align-items: flex-start;
+          border-bottom: 2px solid oklch(0.85 0 0); padding-bottom: 12pt; margin-bottom: 16pt; }
+.company { font-size: 18pt; font-weight: 700; }
+.invoice-number { font-size: 14pt; color: oklch(0.45 0 0); text-align: right; }
+table { width: 100%; border-collapse: collapse; }
+table th { text-align: left; border-bottom: 1px solid oklch(0.80 0 0);
+           font-size: 8pt; text-transform: uppercase; letter-spacing: 0.05em;
+           padding: 6pt 8pt; color: oklch(0.45 0 0); }
+table td { padding: 8pt; border-bottom: 1px solid oklch(0.92 0 0); }
+.total-row td { font-weight: 700; font-size: 11pt; border-top: 2px solid oklch(0.25 0 0); }
+```

package/.cortex/skills/pdf-documents/sections/08-scaled-output.md

@@ -0,0 +1,164 @@
+# Scaled / Blueprint / Poster Output
+
+## Principles of 1:1 Scaled Output
+
+For blueprints, engineering drawings, and physical-dimension-accurate output, the PDF must print at **exact real-world measurements**. This means:
+
+1. **CSS dimensions in physical units** (`mm`, `cm`, `in`) — never `px` or `%`
+2. **No browser scaling** — `@page` margins + content must exactly fill the paper
+3. **User must print at 100% scale** (no "Fit to page") — include a scale verification bar
+
+## Scale Verification Bar (ALWAYS include)
+
+```html
+<!-- Place this on every blueprint page -->
+<div class="scale-bar" style="break-inside:avoid; margin:5mm 0;">
+  <svg width="100mm" height="8mm" viewBox="0 0 100 8" xmlns="http://www.w3.org/2000/svg">
+    <rect x="0" y="2" width="100" height="4" fill="none" stroke="black" stroke-width="0.5"/>
+    <rect x="0" y="2" width="10" height="4" fill="black"/>
+    <rect x="20" y="2" width="10" height="4" fill="black"/>
+    <rect x="40" y="2" width="10" height="4" fill="black"/>
+    <rect x="60" y="2" width="10" height="4" fill="black"/>
+    <rect x="80" y="2" width="10" height="4" fill="black"/>
+    <text x="0" y="1.5" font-size="2" font-family="sans-serif">0</text>
+    <text x="50" y="1.5" font-size="2" font-family="sans-serif" text-anchor="middle">50mm</text>
+    <text x="100" y="1.5" font-size="2" font-family="sans-serif" text-anchor="end">100mm</text>
+  </svg>
+  <p style="font-size:7pt;color:#666;margin:1mm 0 0;">
+    VERIFY: This bar should measure exactly 100mm when printed at 100% scale.
+  </p>
+</div>
+```
+
+## Common Scaled Formats
+
+### Architectural Blueprint (ANSI D — 22" x 34")
+
+```css
+@page {
+  size: 558.8mm 863.6mm;  /* ANSI D */
+  margin: 10mm;
+}
+body {
+  font-family: 'Courier New', monospace;  /* traditional blueprint font */
+  font-size: 10pt;
+}
+/* Title block: bottom-right corner, standard 150mm x 50mm */
+.title-block {
+  position: fixed;
+  bottom: 10mm;
+  right: 10mm;
+  width: 150mm;
+  height: 50mm;
+  border: 0.5mm solid black;
+}
+/* Drawing area uses remaining space */
+.drawing-area {
+  width: 833.6mm;
+  height: 508.8mm;
+}
+/* Grid: 10mm squares */
+.grid-overlay {
+  background-image:
+    linear-gradient(rgba(0,0,0,0.1) 0.3mm, transparent 0.3mm),
+    linear-gradient(90deg, rgba(0,0,0,0.1) 0.3mm, transparent 0.3mm);
+  background-size: 10mm 10mm;
+}
+```
+
+### Scale Ratios for Blueprints
+
+| Scale | Meaning | CSS Factor | Use Case |
+|-------|---------|-----------|----------|
+| **1:1** | Full size | `1mm = 1mm` | Small parts, PCBs, jewelry |
+| **1:2** | Half size | `1mm = 0.5mm` on paper | Mechanical parts |
+| **1:5** | Fifth size | `1mm = 0.2mm` on paper | Furniture, cabinets |
+| **1:10** | Tenth size | `1mm = 0.1mm` on paper | Room layouts |
+| **1:20** | | `1mm = 0.05mm` | Floor plans |
+| **1:50** | | `1m = 20mm` on paper | Building floor plans |
+| **1:100** | | `1m = 10mm` on paper | Site plans |
+| **1:200** | | `1m = 5mm` on paper | Large site plans |
+| **1:500** | | `1m = 2mm` on paper | Master plans, neighborhoods |
+| **1:1000** | | `1m = 1mm` on paper | City blocks, terrain |
+
+**CSS scale helper:**
+```css
+/* 1:50 scale — every 1mm CSS = 50mm real world */
+.scale-1-50 {
+  /* A room 5m x 4m = 5000mm x 4000mm real
+     At 1:50: 100mm x 80mm on paper */
+}
+.scale-label::after { content: "Scale 1:50"; font-size: 8pt; }
+```
+
+### Poster (A1 Portrait — Conference Poster)
+
+```css
+@page {
+  size: 594mm 841mm;  /* A1 */
+  margin: 15mm;
+}
+body { font-family: 'Helvetica Neue', Arial, sans-serif; }
+/* Poster text must be readable from 1-2 metres */
+h1 { font-size: 72pt; }          /* title: readable from 3m */
+h2 { font-size: 36pt; }          /* section heads */
+p, li { font-size: 24pt; }       /* body: readable from 1.5m */
+figcaption { font-size: 18pt; }  /* captions */
+/* Three-column layout */
+.poster-body {
+  display: grid;
+  grid-template-columns: 1fr 1fr 1fr;
+  gap: 10mm;
+}
+```
+
+### Banner (Custom — e.g. 300mm x 1500mm)
+
+```css
+@page {
+  size: 300mm 1500mm;  /* tall/narrow banner */
+  margin: 5mm;
+}
+body {
+  font-family: Impact, 'Arial Black', sans-serif;
+  text-align: center;
+}
+h1 { font-size: 96pt; letter-spacing: 2mm; }
+```
+
+**Chromium custom size:**
+```bash
+# Chromium --paper-width and --paper-height are in INCHES
+# 300mm = 11.81in, 1500mm = 59.06in
+chromium --headless --no-sandbox --disable-gpu \
+  --print-to-pdf=banner.pdf \
+  --print-to-pdf-no-header \
+  --paper-width=11.81 --paper-height=59.06 \
+  banner.html
+```
+
+## Puppeteer for Exact Control (Recommended for Scaled Work)
+
+```javascript
+const puppeteer = require('puppeteer');
+
+async function printBlueprint(htmlPath, outputPath, widthMM, heightMM) {
+  const browser = await puppeteer.launch({ headless: true, args: ['--no-sandbox'] });
+  const page = await browser.newPage();
+  await page.goto(`file://${htmlPath}`, { waitUntil: 'networkidle0' });
+
+  await page.pdf({
+    path: outputPath,
+    width: `${widthMM}mm`,
+    height: `${heightMM}mm`,
+    printBackground: true,
+    margin: { top: '0mm', bottom: '0mm', left: '0mm', right: '0mm' },
+    preferCSSPageSize: true,  // CRITICAL: respect @page CSS, don't override
+  });
+
+  await browser.close();
+}
+
+// Usage:
+// printBlueprint('/path/to/blueprint.html', 'output.pdf', 558.8, 863.6);  // ANSI D
+```

package/.cortex/skills/pdf-documents/sections/09-preview-qa.md

@@ -0,0 +1,66 @@
+# Preview and QA Loop
+
+> **Delivery model note (see SKILL.md).** The print-to-pdf QA loop below is
+> **Model B only** — it needs a real `chromium`. In **Model A (Nexus)** you
+> cannot print-to-pdf to inspect your own output; QA by re-reading your
+> generated HTML for the checklist issues (structure, page-break CSS, image
+> embedding correctness, overflow), then deliver the `.html` to the VFS and
+> tell the user to print it from their browser. The user's browser print *is*
+> the final render — get the print CSS right by reading, you won't see the
+> rendered pages yourself.
+
+## Strategy: Print-to-PDF then Review (Cheapest)
+
+The most token-efficient QA loop is:
+
+```
+1. Write HTML
+2. chromium --print-to-pdf (fast, headless, no browser session cost)
+3. Read the PDF (agent reads pages via PDF reader tool)
+4. Check: blank pages, orphaned headings, cut tables, chart overflow
+5. Fix CSS and repeat
+```
+
+This costs fewer tokens than maintaining a browser session because:
+- No browser startup / scan / screenshot overhead
+- PDF reader gives structured text extraction (faster to parse than screenshots)
+- One command generates the PDF — no interactive steps
+
+## When to Use Browser Preview Instead
+
+Use nexus-browser or a headless browser session when:
+- The document has **interactive elements** (forms, expandable sections) to verify before flattening
+- You need **visual diff comparison** between two versions (screenshot comparison)
+- The document uses **web fonts** that may not load in headless file:// mode
+- You need to verify **responsive layout** at specific viewport sizes before print
+
+```
+# Browser preview workflow:
+1. browse({ url: "file:///path/to/document.html" })
+2. screenshot()  — verify screen layout
+3. Ctrl+P / print preview (not automatable in headless — use print-to-pdf instead)
+4. close_session()
+```
+
+## Automated QA Checklist
+
+After generating the PDF, check for these common issues:
+
+```
+[ ] No blank pages (caused by break-inside:avoid on tall elements)
+[ ] No orphaned headings (heading alone at page bottom, content on next page)
+[ ] Tables not split mid-row (thead repeats on new pages)
+[ ] SVG charts fully visible (not cut at page boundary)
+[ ] Images not overflowing margins
+[ ] Page numbers correct (if using running footers)
+[ ] Cover page breaks correctly to its own page
+[ ] Fonts readable at intended print size (11pt+ body, 8pt+ captions)
+[ ] Scale bar accurate (for blueprints/scaled output)
+[ ] Dark backgrounds removed or inverted for print (save ink)
+[ ] Links show URLs in parentheses (for print readability)
+[ ] No screen-only UI elements visible (navigation, toolbars)
+```
+
+## QA by PDF Page Count
+
+A useful quick check: if the task is a ~5 page report and you get 7 pages, there are probably 2 blank pages from the break-inside bug. Read the PDF and look for pages with no content.