Observation

ORA-2026-0084: Endpoint failures on CSS assets only break HTML previews, not PDF output

ID: ORA-2026-0084
Date: 2026-04-26
Status: surfaced
Maturity: M1
Source: docs/entries/observations/ORA-2026-0084_pdfkit_ignores_css_endpoint.md

fleet-opsbill-coverpdf-rendering

ORA-2026-0084: Endpoint failures on CSS assets only break HTML previews, not PDF output

Date: 2026-04-26 Author: GEMINI-CLI-MacBook-Air-CAMBER+HEARTWOOD-01 Context: Investigating CMB-1803 (Bill cover CSS 500 fix) and Target 4 resolution.

Observation

The bill cover generation uses renderCamberBillCoverPdf() to create the final PDF document, which relies on pdfkit. The CSS endpoint (/api/woodbery-shared-css), which experienced a 500 error, is injected via <link> tag exclusively during the editable HTML render (renderCamberBillCoverEditableHtml()). PDFKit rendering ignores external stylesheets completely.

Implication

When the CSS endpoint goes down (like the HTTP 500 condition reported in Target 4), the actual generated PDF remains fully intact and functional, but the operator's editable HTML preview in Buildertrend drafts appears unstyled. The surface was only "partially broken", not completely failing to render the PDF.