@measurequick/measurequick-report-generator 1.5.180 → 1.5.181

package/base-64/mq-vitals-heatpump-heating.js

@@ -0,0 +1,8 @@
+// Heat Pump Heating Vitals Report Template
+// TODO: Replace with actual PDF template containing heat pump heating labels:
+// - Page 1 measurements: Temp Rise, LLT, COP, OAT, Static Pressure, Airflow
+// - Page 2 factors: Static Pressure (20pts), Air-Side Heat Delivery (20pts),
+//   Capacity Delivery (20pts), System Balance (20pts), Efficiency/COP (20pts)
+//
+// For now, this re-exports the cooling template as a placeholder
+export { base64 } from "./mq-vitals-cooling.js";

package/index.js

@@ -7,6 +7,7 @@ import * as photosReport from "./report-gen-scripts/photos-report.js";
 import * as photosReportS3 from "./report-gen-scripts/photos-report-s3.js";
 import * as ptcsHeatPumpReport from "./report-gen-scripts/ptcs-heat-pump-report.js";
 import * as vitalsCoolingReport from "./report-gen-scripts/vitals-cooling-report.js";
+import * as vitalsHeatPumpHeatingReport from "./report-gen-scripts/vitals-heatpump-heating-report.js";
 import * as vitalsHeatingReport from "./report-gen-scripts/vitals-heating-report.js";
 import * as vitalsHeatingReportNoCombustion from "./report-gen-scripts/vitals-heating-report-no-combustion.js";
 import * as ductScreeningReport from "./report-gen-scripts/nci-report.js";
@@ -17,6 +18,7 @@ import * as energyStarCertificate from "./report-gen-scripts/energy-star-certifi
 import * as franklinEnergyReport from "./report-gen-scripts/franklin-energy-report.js";
 import * as nciCustomerReport from "./report-gen-scripts/nci-report-customer.js";
 import * as nciContractorReport from "./report-gen-scripts/nci-report-contractor.js";
+import * as mqAiSummaryReport from "./report-gen-scripts/mq-ai-summary-report.js";
 
 export function getReport(payload) {
   switch (payload.meta.report_type) {
@@ -38,6 +40,8 @@ export function getReport(payload) {
       return ptcsHeatPumpReport.getReport(payload);
     case "VitalsCoolingReport":
       return vitalsCoolingReport.getReport(payload, false);
+    case "VitalsHeatPumpHeatingReport":
+      return vitalsHeatPumpHeatingReport.getReport(payload, false);
     case "VitalsHeatingReport":
       return vitalsHeatingReport.getReport(payload, false);
     case "VitalsHeatingReportNoCombustion":
@@ -61,5 +65,7 @@ export function getReport(payload) {
       return nciCustomerReport.getReport(payload);
     case "NCIReportContractor":
       return nciContractorReport.getReport(payload);
+    case "MqAiSummaryReport":
+      return mqAiSummaryReport.getReport(payload);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@measurequick/measurequick-report-generator",
-  "version": "1.5.180",
+  "version": "1.5.181",
   "description": "Generates PDF documents for various measureQuick applications.",
   "main": "index.js",
   "scripts": {

package/report-gen-scripts/ai-summary-page.js

@@ -0,0 +1,293 @@
+import { PDFDocument, rgb, StandardFonts } from 'pdf-lib';
+import * as base64 from '../base-64/icons.js';
+import * as util from '../util.js';
+
+// Color definitions matching MeasureQuick brand
+const colors = {
+  headerBg: rgb(0.18, 0.31, 0.47),      // Dark blue header
+  scoreGreen: rgb(0.18, 0.62, 0.35),    // Green for A grades
+  scoreYellow: rgb(0.91, 0.73, 0.18),   // Yellow for B grades
+  scoreOrange: rgb(0.91, 0.49, 0.18),   // Orange for C grades
+  scoreRed: rgb(0.78, 0.22, 0.22),      // Red for D/F grades
+  lightGray: rgb(0.95, 0.95, 0.95),     // Light gray background
+  mediumGray: rgb(0.7, 0.7, 0.7),       // Medium gray for borders
+  darkGray: rgb(0.3, 0.3, 0.3),         // Dark gray for text
+  black: rgb(0, 0, 0),
+  white: rgb(1, 1, 1)
+};
+
+function getScoreColor(grade) {
+  if (!grade) return colors.mediumGray;
+  if (grade.includes('A')) return colors.scoreGreen;
+  if (grade.includes('B')) return colors.scoreYellow;
+  if (grade.includes('C')) return colors.scoreOrange;
+  return colors.scoreRed;
+}
+
+/**
+ * Add AI Summary page(s) to an existing PDF document
+ * @param {PDFDocument} pdfDoc - The existing PDF document to add pages to
+ * @param {Object} payload - The report payload containing AI summary and test data
+ * @returns {Promise<void>}
+ */
+export async function addAiSummaryPages(pdfDoc, payload) {
+  // Check if we should show the AI summary
+  if (!util.shouldShowAiSummary(payload)) {
+    return;
+  }
+
+  const aiSummary = util.getAiSummary(payload);
+  if (!aiSummary) return;
+
+  // Embed fonts
+  const fontRegular = await pdfDoc.embedFont(StandardFonts.Helvetica);
+  const fontBold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+
+  // Page dimensions (Letter size: 612 x 792 points)
+  const pageWidth = 612;
+  const pageHeight = 792;
+  const margin = 36;
+  const contentWidth = pageWidth - (margin * 2);
+
+  // Create the AI summary page
+  let page = pdfDoc.addPage([pageWidth, pageHeight]);
+  let yPos = pageHeight - margin;
+
+  // Load mQ logo
+  const mqLogoBytes = util._base64ToArrayBuffer(base64.mqLogo);
+  const mqLogo = await pdfDoc.embedPng(mqLogoBytes);
+
+  // Load company logo if available
+  let companyImage = null;
+  const companyImageType = util.checkCompanyLogo(payload.meta);
+  if (companyImageType === 'jpg') {
+    companyImage = await pdfDoc.embedJpg(util._base64ToArrayBuffer(payload.meta.profile_settings.companyLogoBase64));
+  } else if (companyImageType === 'png') {
+    companyImage = await pdfDoc.embedPng(util._base64ToArrayBuffer(payload.meta.profile_settings.companyLogoBase64));
+  }
+
+  // === HEADER SECTION ===
+  const headerHeight = 45;
+  page.drawRectangle({
+    x: margin,
+    y: yPos - headerHeight,
+    width: contentWidth,
+    height: headerHeight,
+    color: colors.headerBg
+  });
+
+  // Header title
+  page.drawText('mQ AI Summary', {
+    x: margin + 15,
+    y: yPos - 28,
+    size: 16,
+    font: fontBold,
+    color: colors.white
+  });
+
+  // Draw logo in header (right side)
+  const logoToUse = companyImage || mqLogo;
+  if (logoToUse) {
+    const logoHeight = 30;
+    const logoWidth = logoHeight * (logoToUse.width / logoToUse.height);
+    page.drawImage(logoToUse, {
+      x: pageWidth - margin - logoWidth - 10,
+      y: yPos - headerHeight + 7,
+      width: logoWidth,
+      height: logoHeight
+    });
+  }
+
+  yPos -= headerHeight + 15;
+
+  // === VITALS SCORES AND DATE/TIME SECTION ===
+  const hasTest1 = payload.tests && payload.tests[0] && payload.tests[0].testInfo && payload.tests[0].testInfo.data;
+  const hasTest2 = payload.tests && payload.tests[1] && payload.tests[1].testInfo && payload.tests[1].testInfo.data;
+  const hasTwoTests = hasTest1 && hasTest2;
+
+  // Get date/time from test
+  let dateTimeStr = '';
+  if (hasTest1 && payload.tests[0].testInfo.data.datetimeStart) {
+    const date = new Date(payload.tests[0].testInfo.data.datetimeStart);
+    dateTimeStr = date.toLocaleDateString('en-US', {
+      year: 'numeric',
+      month: 'short',
+      day: 'numeric',
+      hour: 'numeric',
+      minute: '2-digit'
+    });
+  }
+
+  // Draw score and date/time in a compact row
+  const rowHeight = 35;
+
+  if (hasTest1) {
+    const score1 = payload.tests[0].testInfo.data.vitals_score;
+    const scorePercent1 = score1 ? Math.round(score1) + '%' : '--';
+    const grade1 = score1 ? util.getGradeFromScore(Math.round(score1)) : '';
+    const scoreColor1 = getScoreColor(grade1);
+    const scoreLabel1 = hasTwoTests ? 'Test In:' : 'Score:';
+    const scoreText1 = scorePercent1 + (grade1 ? ' ' + grade1 : '');
+
+    // Score label and value
+    page.drawText(scoreLabel1, {
+      x: margin,
+      y: yPos - 12,
+      size: 10,
+      font: fontRegular,
+      color: colors.darkGray
+    });
+
+    page.drawText(scoreText1, {
+      x: margin + 50,
+      y: yPos - 12,
+      size: 14,
+      font: fontBold,
+      color: scoreColor1
+    });
+
+    // Test Out score if exists
+    if (hasTwoTests) {
+      const score2 = payload.tests[1].testInfo.data.vitals_score;
+      const scorePercent2 = score2 ? Math.round(score2) + '%' : '--';
+      const grade2 = score2 ? util.getGradeFromScore(Math.round(score2)) : '';
+      const scoreColor2 = getScoreColor(grade2);
+      const scoreText2 = scorePercent2 + (grade2 ? ' ' + grade2 : '');
+
+      page.drawText('Test Out:', {
+        x: margin + 130,
+        y: yPos - 12,
+        size: 10,
+        font: fontRegular,
+        color: colors.darkGray
+      });
+
+      page.drawText(scoreText2, {
+        x: margin + 180,
+        y: yPos - 12,
+        size: 14,
+        font: fontBold,
+        color: scoreColor2
+      });
+    }
+
+    // Date/time on the right
+    if (dateTimeStr) {
+      const dateWidth = fontRegular.widthOfTextAtSize(dateTimeStr, 10);
+      page.drawText(dateTimeStr, {
+        x: pageWidth - margin - dateWidth,
+        y: yPos - 12,
+        size: 10,
+        font: fontRegular,
+        color: colors.darkGray
+      });
+    }
+
+    yPos -= rowHeight;
+  }
+
+  // Draw separator line
+  page.drawLine({
+    start: { x: margin, y: yPos },
+    end: { x: pageWidth - margin, y: yPos },
+    thickness: 1,
+    color: colors.mediumGray
+  });
+  yPos -= 15;
+
+  // === AI SUMMARY CONTENT ===
+  const lineHeight = 14;
+  const summaryLines = util.wrapTextWithNewlines(aiSummary, fontRegular, 10, contentWidth);
+
+  for (const line of summaryLines) {
+    if (yPos < margin + 50) {
+      // Add new page if needed
+      page = pdfDoc.addPage([pageWidth, pageHeight]);
+      yPos = pageHeight - margin;
+
+      // Add continuation header
+      page.drawText('mQ AI Summary (continued)', {
+        x: margin,
+        y: yPos,
+        size: 12,
+        font: fontBold,
+        color: colors.headerBg
+      });
+      yPos -= 20;
+
+      page.drawLine({
+        start: { x: margin, y: yPos },
+        end: { x: pageWidth - margin, y: yPos },
+        thickness: 1,
+        color: colors.mediumGray
+      });
+      yPos -= 15;
+    }
+
+    if (line) {
+      page.drawText(line, {
+        x: margin,
+        y: yPos,
+        size: 10,
+        font: fontRegular,
+        color: colors.black
+      });
+    }
+    yPos -= lineHeight;
+  }
+
+  // === NOTES SECTION (if exists) ===
+  const notes = util.getAiNotes(payload);
+  if (notes && notes.trim().length > 0) {
+    yPos -= 15;
+
+    if (yPos < margin + 100) {
+      page = pdfDoc.addPage([pageWidth, pageHeight]);
+      yPos = pageHeight - margin;
+    }
+
+    page.drawText('Notes', {
+      x: margin,
+      y: yPos,
+      size: 12,
+      font: fontBold,
+      color: colors.headerBg
+    });
+    yPos -= 5;
+
+    page.drawLine({
+      start: { x: margin, y: yPos },
+      end: { x: pageWidth - margin, y: yPos },
+      thickness: 1,
+      color: colors.headerBg
+    });
+    yPos -= 15;
+
+    const notesLines = util.wrapTextWithNewlines(notes, fontRegular, 10, contentWidth);
+
+    for (const line of notesLines) {
+      if (yPos < margin + 50) {
+        page = pdfDoc.addPage([pageWidth, pageHeight]);
+        yPos = pageHeight - margin;
+      }
+
+      if (line) {
+        page.drawText(line, {
+          x: margin,
+          y: yPos,
+          size: 10,
+          font: fontRegular,
+          color: colors.black
+        });
+      }
+      yPos -= lineHeight;
+    }
+  }
+}
+
+/**
+ * Check if AI summary should be shown based on payload settings
+ */
+export function shouldShow(payload) {
+  return util.shouldShowAiSummary(payload);
+}

package/report-gen-scripts/measurement-details.js

@@ -622,7 +622,10 @@ export async function getReport(payload) {
               ) {
                 let v = measurement.value;
                 if (typeof v == "string") v = parseFloat(v);
-                if (v > 9) rangeIcon = embeddedIcons.iconRangeHigh;
+                if (v !== null && v !== undefined && !isNaN(v)) {
+                  if (v > 9) rangeIcon = embeddedIcons.iconRangeHigh;
+                  else rangeIcon = embeddedIcons.iconRangeNormal;
+                }
               } else
                 rangeIcon = util.getRangeIcon(
                   test,

package/report-gen-scripts/mq-ai-summary-report.js

@@ -0,0 +1,490 @@
+import { PDFDocument, rgb, StandardFonts } from 'pdf-lib';
+import fontkit from '@pdf-lib/fontkit';
+import * as base64 from '../base-64/icons.js';
+import * as util from '../util.js';
+
+// Check if project is CoolMaxx or HeatMaxx (NCI branded)
+function isNCIProject(payload) {
+  if (payload && payload.project && payload.project.specialProjectType) {
+    const type = payload.project.specialProjectType;
+    return type === 'CoolMaxx' || type === 'HeatMaxx';
+  }
+  return false;
+}
+
+// Color definitions matching MeasureQuick brand
+const colors = {
+  headerBg: rgb(0.18, 0.31, 0.47),      // Dark blue header
+  scoreGreen: rgb(0.18, 0.62, 0.35),    // Green for A grades
+  scoreYellow: rgb(0.91, 0.73, 0.18),   // Yellow for B grades
+  scoreOrange: rgb(0.91, 0.49, 0.18),   // Orange for C grades
+  scoreRed: rgb(0.78, 0.22, 0.22),      // Red for D/F grades
+  lightGray: rgb(0.95, 0.95, 0.95),     // Light gray background
+  mediumGray: rgb(0.7, 0.7, 0.7),       // Medium gray for borders
+  darkGray: rgb(0.3, 0.3, 0.3),         // Dark gray for text
+  black: rgb(0, 0, 0),
+  white: rgb(1, 1, 1)
+};
+
+function getScoreColor(grade) {
+  if (grade.includes('A')) return colors.scoreGreen;
+  if (grade.includes('B')) return colors.scoreYellow;
+  if (grade.includes('C')) return colors.scoreOrange;
+  return colors.scoreRed;
+}
+
+// Wrap text to fit within a given width
+function wrapText(text, font, fontSize, maxWidth) {
+  if (!text) return [];
+  const words = text.split(' ');
+  const lines = [];
+  let currentLine = '';
+
+  for (const word of words) {
+    const testLine = currentLine ? currentLine + ' ' + word : word;
+    const testWidth = font.widthOfTextAtSize(testLine, fontSize);
+
+    if (testWidth > maxWidth && currentLine) {
+      lines.push(currentLine);
+      currentLine = word;
+    } else {
+      currentLine = testLine;
+    }
+  }
+
+  if (currentLine) {
+    lines.push(currentLine);
+  }
+
+  return lines;
+}
+
+// Handle newlines and wrap text
+function wrapTextWithNewlines(text, font, fontSize, maxWidth) {
+  if (!text) return [];
+  const paragraphs = text.split('\n');
+  const allLines = [];
+
+  for (const paragraph of paragraphs) {
+    if (paragraph.trim() === '') {
+      allLines.push('');
+    } else {
+      const wrappedLines = wrapText(paragraph, font, fontSize, maxWidth);
+      allLines.push(...wrappedLines);
+    }
+  }
+
+  return allLines;
+}
+
+export async function getReport(payload) {
+  try {
+    // Create a new PDF document
+    const pdfDoc = await PDFDocument.create();
+    pdfDoc.registerFontkit(fontkit);
+
+    // Embed fonts
+    const fontRegular = await pdfDoc.embedFont(StandardFonts.Helvetica);
+    const fontBold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+
+    // Page dimensions (Letter size: 612 x 792 points)
+    const pageWidth = 612;
+    const pageHeight = 792;
+    const margin = 36; // 0.5 inch margins
+    const contentWidth = pageWidth - (margin * 2);
+
+    // Create first page
+    let page = pdfDoc.addPage([pageWidth, pageHeight]);
+
+    // Load mQ logo
+    const mqLogoBytes = util._base64ToArrayBuffer(base64.mqLogo);
+    const mqLogo = await pdfDoc.embedPng(mqLogoBytes);
+
+    // Load NCI logo if applicable
+    let nciLogo = null;
+    const isNCI = isNCIProject(payload) && base64.nciLogo;
+    if (isNCI) {
+      const nciLogoBytes = util._base64ToArrayBuffer(base64.nciLogo);
+      nciLogo = await pdfDoc.embedPng(nciLogoBytes);
+    }
+
+    // Load company logo and profile picture
+    let profileImage = null, companyImage = null;
+    const profileImageType = util.checkProfilePicture(payload.meta);
+    const companyImageType = util.checkCompanyLogo(payload.meta);
+
+    if (profileImageType) {
+      let profileData;
+      if (profileImageType.shape === 'square') {
+        profileData = payload.meta.profile_settings.profilePicSquareBase64;
+      } else if (profileImageType.shape === 'circle') {
+        profileData = payload.meta.profile_settings.profilePicCircleBase64;
+      }
+      if (profileData) {
+        if (profileImageType.type === 'jpg') {
+          profileImage = await pdfDoc.embedJpg(util._base64ToArrayBuffer(profileData));
+        } else if (profileImageType.type === 'png') {
+          profileImage = await pdfDoc.embedPng(util._base64ToArrayBuffer(profileData));
+        }
+      }
+    }
+
+    if (companyImageType === 'jpg') {
+      companyImage = await pdfDoc.embedJpg(util._base64ToArrayBuffer(payload.meta.profile_settings.companyLogoBase64));
+    } else if (companyImageType === 'png') {
+      companyImage = await pdfDoc.embedPng(util._base64ToArrayBuffer(payload.meta.profile_settings.companyLogoBase64));
+    }
+
+    let yPos = pageHeight - margin;
+
+    // === HEADER SECTION ===
+    const headerHeight = 50;
+    page.drawRectangle({
+      x: margin,
+      y: yPos - headerHeight,
+      width: contentWidth,
+      height: headerHeight,
+      color: colors.headerBg
+    });
+
+    // Header title
+    page.drawText('mQ AI Summary & Notes', {
+      x: margin + 15,
+      y: yPos - 32,
+      size: 18,
+      font: fontBold,
+      color: colors.white
+    });
+
+    // Draw logo in header (right side)
+    const logoToUse = isNCI ? nciLogo : (companyImage || mqLogo);
+    if (logoToUse) {
+      const logoHeight = 35;
+      const logoWidth = logoHeight * (logoToUse.width / logoToUse.height);
+      page.drawImage(logoToUse, {
+        x: pageWidth - margin - logoWidth - 10,
+        y: yPos - headerHeight + 7,
+        width: logoWidth,
+        height: logoHeight
+      });
+    }
+
+    yPos -= headerHeight + 15;
+
+    // === CUSTOMER INFO SECTION ===
+    const customerName = payload.project && payload.project.customer_name ? payload.project.customer_name : '';
+    const address1 = payload.project && payload.project.address ? payload.project.address : '';
+    const city = payload.project && payload.project.city ? payload.project.city : '';
+    const state = payload.project && payload.project.state ? payload.project.state : '';
+    const zip = payload.project && payload.project.zip ? payload.project.zip : '';
+    const cityStateZip = [city, state, zip].filter(x => x).join(', ');
+
+    if (customerName) {
+      page.drawText(customerName, { x: margin, y: yPos, size: 11, font: fontBold, color: colors.darkGray });
+      yPos -= 14;
+    }
+    if (address1) {
+      page.drawText(address1, { x: margin, y: yPos, size: 10, font: fontRegular, color: colors.darkGray });
+      yPos -= 12;
+    }
+    if (cityStateZip) {
+      page.drawText(cityStateZip, { x: margin, y: yPos, size: 10, font: fontRegular, color: colors.darkGray });
+      yPos -= 12;
+    }
+
+    // Date of service
+    let dateStr = '';
+    if (payload.tests && payload.tests[0] && payload.tests[0].testInfo && payload.tests[0].testInfo.data && payload.tests[0].testInfo.data.datetimeStart) {
+      const date = new Date(payload.tests[0].testInfo.data.datetimeStart);
+      dateStr = date.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' });
+    }
+    if (dateStr) {
+      page.drawText('Date: ' + dateStr, { x: margin, y: yPos, size: 10, font: fontRegular, color: colors.darkGray });
+    }
+
+    // Tech name (right aligned)
+    const techFirstName = payload.meta && payload.meta.profile_settings && payload.meta.profile_settings.techFirstName ? payload.meta.profile_settings.techFirstName : '';
+    const techLastName = payload.meta && payload.meta.profile_settings && payload.meta.profile_settings.techLastName ? payload.meta.profile_settings.techLastName : '';
+    const techName = [techFirstName, techLastName].filter(x => x).join(' ');
+    if (techName) {
+      const techText = 'Technician: ' + techName;
+      const techWidth = fontRegular.widthOfTextAtSize(techText, 10);
+      page.drawText(techText, { x: pageWidth - margin - techWidth, y: yPos, size: 10, font: fontRegular, color: colors.darkGray });
+    }
+
+    yPos -= 25;
+
+    // === VITALS SCORES SECTION ===
+    const hasTest1 = payload.tests && payload.tests[0] && payload.tests[0].testInfo && payload.tests[0].testInfo.data;
+    const hasTest2 = payload.tests && payload.tests[1] && payload.tests[1].testInfo && payload.tests[1].testInfo.data;
+    const hasTwoTests = hasTest1 && hasTest2;
+
+    const scoreBoxWidth = hasTwoTests ? (contentWidth - 20) / 2 : contentWidth;
+    const scoreBoxHeight = 60;
+
+    // Draw score box(es)
+    if (hasTest1) {
+      const score1 = payload.tests[0].testInfo.data.vitals_score;
+      const scorePercent1 = score1 ? Math.round(score1) + '%' : '--';
+      const grade1 = score1 ? util.getGradeFromScore(Math.round(score1)) : '';
+      const scoreColor1 = score1 ? getScoreColor(grade1) : colors.mediumGray;
+      const scoreLabel1 = hasTwoTests ? 'Test In Score' : 'System Vitals Score';
+
+      // Score box background
+      page.drawRectangle({
+        x: margin,
+        y: yPos - scoreBoxHeight,
+        width: scoreBoxWidth,
+        height: scoreBoxHeight,
+        color: colors.lightGray,
+        borderColor: scoreColor1,
+        borderWidth: 2
+      });
+
+      // Score label
+      page.drawText(scoreLabel1, {
+        x: margin + 10,
+        y: yPos - 18,
+        size: 10,
+        font: fontRegular,
+        color: colors.darkGray
+      });
+
+      // Score value
+      const scoreText1 = scorePercent1 + (grade1 ? ' ' + grade1 : '');
+      page.drawText(scoreText1, {
+        x: margin + 10,
+        y: yPos - 45,
+        size: 24,
+        font: fontBold,
+        color: scoreColor1
+      });
+    }
+
+    if (hasTwoTests) {
+      const score2 = payload.tests[1].testInfo.data.vitals_score;
+      const scorePercent2 = score2 ? Math.round(score2) + '%' : '--';
+      const grade2 = score2 ? util.getGradeFromScore(Math.round(score2)) : '';
+      const scoreColor2 = score2 ? getScoreColor(grade2) : colors.mediumGray;
+
+      // Score box background
+      page.drawRectangle({
+        x: margin + scoreBoxWidth + 20,
+        y: yPos - scoreBoxHeight,
+        width: scoreBoxWidth,
+        height: scoreBoxHeight,
+        color: colors.lightGray,
+        borderColor: scoreColor2,
+        borderWidth: 2
+      });
+
+      // Score label
+      page.drawText('Test Out Score', {
+        x: margin + scoreBoxWidth + 30,
+        y: yPos - 18,
+        size: 10,
+        font: fontRegular,
+        color: colors.darkGray
+      });
+
+      // Score value
+      const scoreText2 = scorePercent2 + (grade2 ? ' ' + grade2 : '');
+      page.drawText(scoreText2, {
+        x: margin + scoreBoxWidth + 30,
+        y: yPos - 45,
+        size: 24,
+        font: fontBold,
+        color: scoreColor2
+      });
+    }
+
+    yPos -= scoreBoxHeight + 20;
+
+    // === AI SUMMARY SECTION ===
+    page.drawText('AI Summary', {
+      x: margin,
+      y: yPos,
+      size: 14,
+      font: fontBold,
+      color: colors.headerBg
+    });
+    yPos -= 5;
+
+    // Draw line under header
+    page.drawLine({
+      start: { x: margin, y: yPos },
+      end: { x: pageWidth - margin, y: yPos },
+      thickness: 1,
+      color: colors.headerBg
+    });
+    yPos -= 15;
+
+    // AI Summary content
+    const aiSummary = payload.ai_summary || payload.project && payload.project.ai_summary || 'No AI summary available.';
+    const summaryLines = wrapTextWithNewlines(aiSummary, fontRegular, 10, contentWidth);
+    const lineHeight = 14;
+
+    for (const line of summaryLines) {
+      if (yPos < margin + 100) {
+        // Add new page if needed
+        page = pdfDoc.addPage([pageWidth, pageHeight]);
+        yPos = pageHeight - margin;
+      }
+
+      if (line) {
+        page.drawText(line, {
+          x: margin,
+          y: yPos,
+          size: 10,
+          font: fontRegular,
+          color: colors.black
+        });
+      }
+      yPos -= lineHeight;
+    }
+
+    yPos -= 20;
+
+    // === NOTES SECTION ===
+    if (yPos < margin + 150) {
+      page = pdfDoc.addPage([pageWidth, pageHeight]);
+      yPos = pageHeight - margin;
+    }
+
+    page.drawText('Notes', {
+      x: margin,
+      y: yPos,
+      size: 14,
+      font: fontBold,
+      color: colors.headerBg
+    });
+    yPos -= 5;
+
+    // Draw line under header
+    page.drawLine({
+      start: { x: margin, y: yPos },
+      end: { x: pageWidth - margin, y: yPos },
+      thickness: 1,
+      color: colors.headerBg
+    });
+    yPos -= 15;
+
+    // Notes content - check multiple possible sources
+    let notes = payload.notes || '';
+    if (!notes && payload.project && payload.project.notes) {
+      notes = payload.project.notes;
+    }
+    if (!notes && payload.tests && payload.tests[0] && payload.tests[0].testInfo && payload.tests[0].testInfo.notes) {
+      notes = payload.tests[0].testInfo.notes;
+    }
+
+    if (!notes) {
+      notes = 'No notes available.';
+    }
+
+    const notesLines = wrapTextWithNewlines(notes, fontRegular, 10, contentWidth);
+
+    for (const line of notesLines) {
+      if (yPos < margin + 50) {
+        // Add new page if needed
+        page = pdfDoc.addPage([pageWidth, pageHeight]);
+        yPos = pageHeight - margin;
+      }
+
+      if (line) {
+        page.drawText(line, {
+          x: margin,
+          y: yPos,
+          size: 10,
+          font: fontRegular,
+          color: colors.black
+        });
+      }
+      yPos -= lineHeight;
+    }
+
+    // === FOOTER SECTION ===
+    const footerY = margin;
+
+    // Draw footer on all pages
+    const pages = pdfDoc.getPages();
+    for (let i = 0; i < pages.length; i++) {
+      const p = pages[i];
+
+      // Footer line
+      p.drawLine({
+        start: { x: margin, y: footerY + 25 },
+        end: { x: pageWidth - margin, y: footerY + 25 },
+        thickness: 0.5,
+        color: colors.mediumGray
+      });
+
+      // Profile picture (if available and not NCI)
+      if (!isNCI && profileImage) {
+        const profileSize = 20;
+        p.drawImage(profileImage, {
+          x: margin,
+          y: footerY,
+          width: profileSize,
+          height: profileSize
+        });
+
+        // Tech name next to profile
+        if (techName) {
+          p.drawText(techName, {
+            x: margin + profileSize + 5,
+            y: footerY + 6,
+            size: 8,
+            font: fontRegular,
+            color: colors.darkGray
+          });
+        }
+      } else if (techName) {
+        p.drawText(techName, {
+          x: margin,
+          y: footerY + 6,
+          size: 8,
+          font: fontRegular,
+          color: colors.darkGray
+        });
+      }
+
+      // Page number (center)
+      const pageNumText = 'Page ' + (i + 1) + ' of ' + pages.length;
+      const pageNumWidth = fontRegular.widthOfTextAtSize(pageNumText, 8);
+      p.drawText(pageNumText, {
+        x: (pageWidth - pageNumWidth) / 2,
+        y: footerY + 6,
+        size: 8,
+        font: fontRegular,
+        color: colors.darkGray
+      });
+
+      // mQ logo or company logo (right side)
+      const footerLogo = companyImage || mqLogo;
+      if (footerLogo) {
+        const footerLogoHeight = 18;
+        const footerLogoWidth = footerLogoHeight * (footerLogo.width / footerLogo.height);
+        p.drawImage(footerLogo, {
+          x: pageWidth - margin - footerLogoWidth,
+          y: footerY,
+          width: footerLogoWidth,
+          height: footerLogoHeight
+        });
+      }
+    }
+
+    // Save and return
+    return {
+      status: 200,
+      data: await pdfDoc.saveAsBase64({ dataUri: true })
+    };
+
+  } catch (error) {
+    console.error('Error generating AI Summary report:', error);
+    return {
+      status: 400,
+      data: error.message || error
+    };
+  }
+}

package/report-gen-scripts/vitals-cooling-report.js

@@ -3,6 +3,7 @@ import * as base64 from "../base-64/icons.js";
 import * as pdf from "../base-64/mq-vitals-cooling.js";
 import * as systemInfoPage from "./system-info-page.js";
 import * as util from "../util.js";
+import * as aiSummaryPage from "./ai-summary-page.js";
 
 // Check if project is CoolMaxx or HeatMaxx (NCI branded)
 function isNCIProject(payload) {
@@ -420,8 +421,12 @@ export async function getReport(payload, _test) {
         pdfDoc.insertPage(pdfDoc.getPages().length, _systemInfoPageDoc);
     }
 
-    // flatten and return as base64
+    // flatten form fields before adding AI summary pages
     form.flatten();
+
+    // Add AI summary page if enabled and summary exists
+    await aiSummaryPage.addAiSummaryPages(pdfDoc, payload);
+
     return { status: 200, data: await pdfDoc.saveAsBase64({ dataUri: true }) };
   } catch (error) {
     return { status: 400, data: error };

package/report-gen-scripts/vitals-heating-report.js

@@ -2,8 +2,8 @@ import { PDFDocument } from "pdf-lib";
 import * as base64 from "../base-64/icons.js";
 import * as pdf from "../base-64/mq-vitals-heating.js";
 import * as systemInfoPage from "./system-info-page.js";
-
 import * as util from "../util.js";
+import * as aiSummaryPage from "./ai-summary-page.js";
 
 // Check if project is CoolMaxx or HeatMaxx (NCI branded)
 function isNCIProject(payload) {
@@ -628,8 +628,12 @@ export async function getReport(payload, _test) {
         pdfDoc.insertPage(pdfDoc.getPages().length, _systemInfoPageDoc);
     }
 
-    // flatten and return as base64
+    // flatten form fields before adding AI summary pages
     form.flatten();
+
+    // Add AI summary page if enabled and summary exists
+    await aiSummaryPage.addAiSummaryPages(pdfDoc, payload);
+
     return { status: 200, data: await pdfDoc.saveAsBase64({ dataUri: true }) };
   } catch (error) {
     return { status: 400, data: error };

package/report-gen-scripts/vitals-heatpump-heating-report.js

@@ -0,0 +1,339 @@
+import { PDFDocument, rgb, StandardFonts } from "pdf-lib";
+import * as base64 from "../base-64/icons.js";
+import * as pdf from "../base-64/mq-vitals-heatpump-heating.js";
+import * as systemInfoPage from "./system-info-page.js";
+import * as util from "../util.js";
+import * as aiSummaryPage from "./ai-summary-page.js";
+
+// Check if project is CoolMaxx or HeatMaxx (NCI branded)
+function isNCIProject(payload) {
+  if (payload && payload.project && payload.project.specialProjectType) {
+    const type = payload.project.specialProjectType;
+    return type === 'CoolMaxx' || type === 'HeatMaxx';
+  }
+  return false;
+}
+
+export async function getReport(payload, _test) {
+  try {
+    // fetch and load form
+    const formPdfBytes = util._base64ToArrayBuffer(pdf.base64);
+    const pdfDoc = await PDFDocument.load(formPdfBytes);
+
+    // Embed font for custom text overlays
+    const helveticaBold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+    const helvetica = await pdfDoc.embedFont(StandardFonts.Helvetica);
+
+    // fetch resources
+    const iconRangeGreenBytes = util._base64ToArrayBuffer(base64.iconRangeGreen);
+    const iconRangeRedBytes = util._base64ToArrayBuffer(base64.iconRangeRed);
+    const iconFlagBlackBytes = util._base64ToArrayBuffer(base64.iconFlagBlack);
+    const iconFlagGreenBytes = util._base64ToArrayBuffer(base64.iconFlagGreen);
+    const iconFlagRedBytes = util._base64ToArrayBuffer(base64.iconFlagRed);
+    const iconFlagYellowBytes = util._base64ToArrayBuffer(base64.iconFlagYellow);
+    const iconStabilityBytes = util._base64ToArrayBuffer(base64.iconStability);
+    const iconThumbprintGreenBytes = util._base64ToArrayBuffer(base64.iconThumbprintGreen);
+    const iconThumbprintRedBytes = util._base64ToArrayBuffer(base64.iconThumbprintRed);
+    const mqLogoBytes = util._base64ToArrayBuffer(base64.mqLogo);
+
+    // load resources
+    const iconRangeGreen = await pdfDoc.embedPng(iconRangeGreenBytes);
+    const iconRangeRed = await pdfDoc.embedPng(iconRangeRedBytes);
+    const iconFlagBlack = await pdfDoc.embedPng(iconFlagBlackBytes);
+    const iconFlagGreen = await pdfDoc.embedPng(iconFlagGreenBytes);
+    const iconFlagRed = await pdfDoc.embedPng(iconFlagRedBytes);
+    const iconFlagYellow = await pdfDoc.embedPng(iconFlagYellowBytes);
+    const iconStability = await pdfDoc.embedPng(iconStabilityBytes);
+    const iconThumbprintGreen = await pdfDoc.embedPng(iconThumbprintGreenBytes);
+    const iconThumbprintRed = await pdfDoc.embedPng(iconThumbprintRedBytes);
+    const mqLogo = await pdfDoc.embedPng(mqLogoBytes);
+
+    // embed company logo and profile picture
+    let profileImage, companyImage;
+    let profileImageType = util.checkProfilePicture(payload.meta);
+    let companyImageType = util.checkCompanyLogo(payload.meta);
+    if (profileImageType) {
+      if (profileImageType.shape == "square")
+        profileImage = payload.meta.profile_settings.profilePicSquareBase64;
+      else if (profileImageType.shape == "circle")
+        profileImage = payload.meta.profile_settings.profilePicCircleBase64;
+      if (profileImageType.type == "jpg")
+        profileImage = await pdfDoc.embedJpg(util._base64ToArrayBuffer(profileImage));
+      else if (profileImageType.type == "png")
+        profileImage = await pdfDoc.embedPng(util._base64ToArrayBuffer(profileImage));
+    }
+    if (companyImageType == "jpg")
+      companyImage = await pdfDoc.embedJpg(
+        util._base64ToArrayBuffer(payload.meta.profile_settings.companyLogoBase64)
+      );
+    else if (companyImageType == "png")
+      companyImage = await pdfDoc.embedPng(
+        util._base64ToArrayBuffer(payload.meta.profile_settings.companyLogoBase64)
+      );
+
+    // get form for filling
+    const form = pdfDoc.getForm();
+
+    // print system diagnostics section
+    let t = payload.tests[0].testInfo;
+    if (_test) t = _test.testInfo;
+    if (
+      t &&
+      t.diagnostics &&
+      t.diagnostics.multi_point_analysis &&
+      t.diagnostics.multi_point_analysis.length > 0
+    ) {
+      for (let i = 0; i < 9; i++) {
+        let d = t.diagnostics.multi_point_analysis[i];
+        if (d) {
+          let diagnosticIcon = iconFlagBlack;
+          if (d.type === "stability") diagnosticIcon = iconStability;
+          else if (d.score > 1 && d.score < 10) diagnosticIcon = iconFlagRed;
+          else if (d.score >= 10 && d.score < 15) diagnosticIcon = iconFlagYellow;
+          form.getButton(`ImageDiagnostics${i + 1}_af_image`).setImage(diagnosticIcon);
+          form.getTextField(`SystemDiagnostics${i + 1}`).setText(`${d.title}`);
+          if (diagnosticIcon !== iconFlagYellow)
+            form.getTextField(`SystemDiagnostics${i + 1}a`).setText(`${d.score}`);
+        }
+      }
+    } else {
+      form.getButton("ImageDiagnostics1_af_image").setImage(iconFlagGreen);
+      form.getTextField("SystemDiagnostics1").setText("No system-wide issues were detected.");
+    }
+
+    // Set header for heat pump heating
+    let header = payload.meta.header ? payload.meta.header : "Heat Pump Heating Vitals";
+    form.getTextField("Header").setText(header);
+
+    // Get text fields for heat pump heating
+    let textFields = getTextFields(payload, t);
+
+    // For NCI projects, handle logo placement
+    let isNCI = isNCIProject(payload) && base64.nciLogo;
+    if (isNCI) {
+      const nciLogoImage = await pdfDoc.embedPng(util._base64ToArrayBuffer(base64.nciLogo));
+      const pages = pdfDoc.getPages();
+      const profilePictureButton = form.getButton("ProfilePicture");
+      const widgets = profilePictureButton.acroField.getWidgets();
+      for (let i = 0; i < widgets.length; i++) {
+        const rect = widgets[i].getRectangle();
+        const page = pages[i] || pages[0];
+        const logoWidth = rect.width * 1.15;
+        const logoHeight = logoWidth * (nciLogoImage.height / nciLogoImage.width);
+        const x = rect.x + (rect.width - logoWidth) / 2;
+        const y = rect.y + (rect.height - logoHeight) / 2;
+        page.drawImage(nciLogoImage, { x, y, width: logoWidth, height: logoHeight });
+      }
+      if (companyImage) {
+        form.getButton("HalfWidthLogo").setImage(companyImage);
+      } else {
+        form.getButton("HalfWidthLogo").setImage(mqLogo);
+      }
+      if (payload.meta.profile_settings.techFirstName || payload.meta.profile_settings.techLastName)
+        form.getTextField("TechName").setText(
+          `${payload.meta.profile_settings.techFirstName} ${payload.meta.profile_settings.techLastName}`
+        );
+    }
+
+    // print company logo and profile picture
+    if (!isNCI && profileImage && companyImage) {
+      form.getButton("ProfilePicture").setImage(profileImage);
+      form.getButton("HalfWidthLogo").setImage(companyImage);
+      if (payload.meta.profile_settings.techFirstName || payload.meta.profile_settings.techLastName)
+        form.getTextField("TechName").setText(
+          `${payload.meta.profile_settings.techFirstName} ${payload.meta.profile_settings.techLastName}`
+        );
+    } else if (!isNCI && profileImage) {
+      form.getButton("ProfilePicture").setImage(profileImage);
+      form.getButton("HalfWidthLogo").setImage(mqLogo);
+      if (payload.meta.profile_settings.techFirstName || payload.meta.profile_settings.techLastName)
+        form.getTextField("TechName").setText(
+          `${payload.meta.profile_settings.techFirstName} ${payload.meta.profile_settings.techLastName}`
+        );
+    } else if (!isNCI) {
+      if (companyImage) form.getButton("FullWidthLogo").setImage(companyImage);
+      else form.getButton("FullWidthLogo").setImage(mqLogo);
+    }
+
+    // print customer data
+    let date = new Date();
+    if (textFields.cName && textFields.address && textFields.city && textFields.state && textFields.zip) {
+      form.getTextField("Name").setText(`${textFields.cName}`);
+      form.getTextField("Address1").setText(`${textFields.address}`);
+      if (textFields.address2) {
+        form.getTextField("Address2").setText(`${textFields.address2}`);
+        form.getTextField("CityStateZip").setText(`${textFields.city}${textFields.state}${textFields.zip}`);
+      } else {
+        form.getTextField("Address2").setText(`${textFields.city}${textFields.state}${textFields.zip}`);
+      }
+      form.getTextField("DateOfServiceLabelUpper").setText("");
+      form.getTextField("TimeOfServiceLabelUpper").setText("");
+      form.getTextField("DateOfServiceLabelLower").setText("Date of Service:");
+      form.getTextField("TimeOfServiceLabelLower").setText("Time of Service:");
+      form.getTextField("DateOfServiceLower").setText(date.toLocaleDateString("en-US"));
+      form.getTextField("TimeOfServiceLower").setText(date.toLocaleTimeString("en-US"));
+    } else {
+      form.getTextField("DateOfServiceLabelLower").setText("");
+      form.getTextField("TimeOfServiceLabelLower").setText("");
+      form.getTextField("DateOfServiceLabelUpper").setText("Date of Service:");
+      form.getTextField("TimeOfServiceLabelUpper").setText("Time of Service:");
+      form.getTextField("DateOfServiceUpper").setText(date.toLocaleDateString("en-US"));
+      form.getTextField("TimeOfServiceUpper").setText(date.toLocaleTimeString("en-US"));
+    }
+
+    // System score
+    let systemScorePercentage = t.data.vitals_score ? +t.data.vitals_score.toFixed(0) : 0;
+    let systemScoreGrade = util.getGradeFromScore(systemScorePercentage);
+    let systemScoreColor = util.getColorFromGrade(systemScoreGrade);
+    if (!t.data.vitals_score) {
+      systemScorePercentage = "--";
+      systemScoreGrade = "";
+    } else {
+      systemScorePercentage += "%";
+    }
+
+    // Print system score
+    form.getTextField(`YourSystemScore${systemScoreColor}`).setText(`${systemScorePercentage} ${systemScoreGrade}`);
+
+    // Heat pump heating measurements (using existing form fields with different data)
+    form.getTextField("Superheat").setText(`${textFields.tempRise} °${payload.units.temperature} Rise`);
+    form.getTextField("Subcooling").setText(`${textFields.llt} °${payload.units.temperature} LLT`);
+    form.getTextField("CondenserApproach").setText(`${textFields.cop} COP`);
+    form.getTextField("TemperatureSplit").setText(`${textFields.oat} °${payload.units.temperature} OAT`);
+    form.getTextField("TotalExternalStaticPressure").setText(`${textFields.tesp} inH2O`);
+    form.getTextField("FilterFaceVelocity").setText(`${textFields.airflow} CFM`);
+
+    // Heat pump heating scoring factors (points-based, not losses)
+    let ptsFilter = textFields.ptsFilter;
+    let ptsA = textFields.ptsA;
+    let ptsB = textFields.ptsB;
+    let ptsC = textFields.ptsC;
+    let ptsD = textFields.ptsD;
+
+    // Determine colors based on points (green if >= 15, red otherwise)
+    let filterColor = ptsFilter !== "--" && +ptsFilter >= 15 ? "Green" : "Red";
+    let aColor = ptsA !== "--" && +ptsA >= 15 ? "Green" : "Red";
+    let bColor = ptsB !== "--" && +ptsB >= 15 ? "Green" : "Red";
+    let cColor = ptsC !== "--" && +ptsC >= 15 ? "Green" : "Red";
+    let dColor = ptsD !== "--" && +ptsD >= 15 ? "Green" : "Red";
+
+    // Set scoring factor values
+    form.getTextField(`AgeLosses${filterColor}`).setText(`${ptsFilter}/20`);
+    form.getTextField(`TemperatureSplitLosses${aColor}`).setText(`${ptsA}/20`);
+    form.getTextField(`StaticPressureLosses${bColor}`).setText(`${ptsB}/20`);
+    form.getTextField(`ApproachLosses${cColor}`).setText(`${ptsC}/20`);
+    form.getTextField(`RefrigerantChargeIssues${dColor}`).setText(`${ptsD}/20`);
+
+    form.getTextField("YourSystemScorePage2").setText(`${systemScorePercentage} ${systemScoreGrade}`);
+
+    // Get pages for label overlays
+    const pages = pdfDoc.getPages();
+
+    // Overlay custom labels for heat pump heating on page 2 (factors page)
+    // Note: These positions may need adjustment based on actual PDF layout
+    if (pages.length >= 2) {
+      const page2 = pages[1];
+      const labelFontSize = 9;
+      const labelColor = rgb(0.2, 0.2, 0.2);
+
+      // Draw white rectangles to cover original labels, then draw new labels
+      // Factor 1: Static Pressure (was Age & Efficiency)
+      page2.drawRectangle({ x: 45, y: 635, width: 150, height: 12, color: rgb(1, 1, 1) });
+      page2.drawText("Static Pressure", { x: 47, y: 637, size: labelFontSize, font: helveticaBold, color: labelColor });
+
+      // Factor 2: Air-Side Heat Delivery (was Temperature Split)
+      page2.drawRectangle({ x: 45, y: 580, width: 150, height: 12, color: rgb(1, 1, 1) });
+      page2.drawText("Air-Side Heat Delivery", { x: 47, y: 582, size: labelFontSize, font: helveticaBold, color: labelColor });
+
+      // Factor 3: Capacity Delivery (was Static Pressure)
+      page2.drawRectangle({ x: 45, y: 525, width: 150, height: 12, color: rgb(1, 1, 1) });
+      page2.drawText("Capacity Delivery", { x: 47, y: 527, size: labelFontSize, font: helveticaBold, color: labelColor });
+
+      // Factor 4: System Balance (was Approach)
+      page2.drawRectangle({ x: 45, y: 470, width: 150, height: 12, color: rgb(1, 1, 1) });
+      page2.drawText("System Balance", { x: 47, y: 472, size: labelFontSize, font: helveticaBold, color: labelColor });
+
+      // Factor 5: Efficiency (COP) (was Refrigerant Charge)
+      page2.drawRectangle({ x: 45, y: 415, width: 150, height: 12, color: rgb(1, 1, 1) });
+      page2.drawText("Efficiency (COP)", { x: 47, y: 417, size: labelFontSize, font: helveticaBold, color: labelColor });
+    }
+
+    // Print targets and range icons (using appropriate values for heat pump heating)
+    const measureLabels = ["Superheat", "Subcooling", "Condenser", "TempSplit", "Tesp", "FilterFace"];
+    for (let i = 0; i < measureLabels.length; i++) {
+      // For heat pump heating, show green icons for valid measurements
+      let icon = iconRangeGreen;
+      let iconPlacement = "Mid";
+      try {
+        form.getButton(`Image${measureLabels[i]}${iconPlacement}_af_image`).setImage(icon);
+      } catch (e) {
+        // Field may not exist
+      }
+      // Clear target zone text for heat pump heating (different targets apply)
+      try {
+        form.getTextField(`${measureLabels[i]}Target`).setText("");
+      } catch (e) {
+        // Field may not exist
+      }
+    }
+
+    // Skip pass/fail subsystem review for heat pump heating
+    form.getTextField("SSR1").setText("Heat Pump Heating Mode");
+
+    // Add system info page
+    if (payload.meta.report_type != "FullReport") {
+      let systemInfoPageBase64 = await systemInfoPage.getReport(payload);
+      const systemInfoPageDoc = systemInfoPageBase64
+        ? await PDFDocument.load(util._base64ToArrayBuffer(systemInfoPageBase64.data))
+        : false;
+      const [_systemInfoPageDoc] = systemInfoPageDoc
+        ? await pdfDoc.copyPages(systemInfoPageDoc, [0])
+        : false;
+      if (_systemInfoPageDoc) pdfDoc.insertPage(pdfDoc.getPages().length, _systemInfoPageDoc);
+    }
+
+    // flatten form fields before adding AI summary pages
+    form.flatten();
+
+    // Add AI summary page if enabled and summary exists
+    await aiSummaryPage.addAiSummaryPages(pdfDoc, payload);
+
+    return { status: 200, data: await pdfDoc.saveAsBase64({ dataUri: true }) };
+  } catch (error) {
+    console.error("[VitalsHeatPumpHeatingReport] Error:", error);
+    return { status: 400, data: error };
+  }
+}
+
+function getTextFields(payload, test) {
+  // Calculate temperature rise
+  let tempRise = "--";
+  if (test.data.temperature_leaving_dry_bulb !== undefined && test.data.temperature_entering_dry_bulb !== undefined) {
+    tempRise = (test.data.temperature_leaving_dry_bulb - test.data.temperature_entering_dry_bulb).toFixed(1);
+  }
+
+  return {
+    cName:
+      payload.site.customer.first_name && payload.site.customer.last_name
+        ? `${payload.site.customer.first_name} ${payload.site.customer.last_name}`
+        : "",
+    address: payload.site.location.address ? payload.site.location.address : "",
+    address2: payload.site.location.address2 ? payload.site.location.address2 : "",
+    city: payload.site.location.city ? payload.site.location.city : "",
+    state: payload.site.location.state ? `, ${payload.site.location.state}` : "",
+    zip: payload.site.location.zip ? ` ${payload.site.location.zip}` : "",
+    // Heat pump heating specific fields
+    tempRise: tempRise,
+    llt: test.data.temperature_liquid_line !== undefined ? (+test.data.temperature_liquid_line).toFixed(1) : "--",
+    cop: test.data.cop !== undefined ? (+test.data.cop).toFixed(2) : "--",
+    oat: test.data.temperature_outdoor_dry_bulb !== undefined ? (+test.data.temperature_outdoor_dry_bulb).toFixed(1) : "--",
+    tesp: test.data.pressure_static_total_external !== undefined ? (+test.data.pressure_static_total_external).toFixed(2) : "--",
+    airflow: test.data.airflow !== undefined ? (+test.data.airflow).toFixed(0) : "--",
+    // Heat pump heating scoring factors (points earned, not losses)
+    ptsFilter: test.data.hp_heating_pts_filter !== undefined ? (+test.data.hp_heating_pts_filter).toFixed(0) : "--",
+    ptsA: test.data.hp_heating_pts_a !== undefined ? (+test.data.hp_heating_pts_a).toFixed(0) : "--",
+    ptsB: test.data.hp_heating_pts_b !== undefined ? (+test.data.hp_heating_pts_b).toFixed(0) : "--",
+    ptsC: test.data.hp_heating_pts_c !== undefined ? (+test.data.hp_heating_pts_c).toFixed(0) : "--",
+    ptsD: test.data.hp_heating_pts_d !== undefined ? (+test.data.hp_heating_pts_d).toFixed(0) : "--",
+  };
+}

package/util.js

@@ -1006,3 +1006,74 @@ function prettifyData(val, type, units) {
 //       reader.readAsDataURL(file);
 //     }
 // }
+
+// AI Summary helper functions
+export function wrapText(text, font, fontSize, maxWidth) {
+  if (!text) return [];
+  const words = text.split(' ');
+  const lines = [];
+  let currentLine = '';
+
+  for (const word of words) {
+    const testLine = currentLine ? currentLine + ' ' + word : word;
+    const testWidth = font.widthOfTextAtSize(testLine, fontSize);
+
+    if (testWidth > maxWidth && currentLine) {
+      lines.push(currentLine);
+      currentLine = word;
+    } else {
+      currentLine = testLine;
+    }
+  }
+
+  if (currentLine) {
+    lines.push(currentLine);
+  }
+
+  return lines;
+}
+
+export function wrapTextWithNewlines(text, font, fontSize, maxWidth) {
+  if (!text) return [];
+  const paragraphs = text.split('\n');
+  const allLines = [];
+
+  for (const paragraph of paragraphs) {
+    if (paragraph.trim() === '') {
+      allLines.push('');
+    } else {
+      const wrappedLines = wrapText(paragraph, font, fontSize, maxWidth);
+      allLines.push(...wrappedLines);
+    }
+  }
+
+  return allLines;
+}
+
+export function shouldShowAiSummary(payload) {
+  // Check if toggle is enabled in pdf_settings
+  if (payload.meta && payload.meta.pdf_settings && payload.meta.pdf_settings.showAiSummaryOnReport === false) {
+    return false;
+  }
+  // Check if AI summary exists
+  const aiSummary = getAiSummary(payload);
+  return aiSummary && aiSummary.trim().length > 0 && aiSummary !== 'No AI summary available.';
+}
+
+export function getAiSummary(payload) {
+  // Check multiple possible sources for AI summary
+  if (payload.ai_summary) return payload.ai_summary;
+  if (payload.project && payload.project.ai_summary) return payload.project.ai_summary;
+  if (payload.project && payload.project.mq_ai_summary) return payload.project.mq_ai_summary;
+  return null;
+}
+
+export function getAiNotes(payload) {
+  // Check multiple possible sources for notes
+  if (payload.notes) return payload.notes;
+  if (payload.project && payload.project.notes) return payload.project.notes;
+  if (payload.tests && payload.tests[0] && payload.tests[0].testInfo && payload.tests[0].testInfo.notes) {
+    return payload.tests[0].testInfo.notes;
+  }
+  return null;
+}