From 0d0e755a58b98b4e2ae239323ccca6acc72668f0 Mon Sep 17 00:00:00 2001
From: Aaryabrat Chhatkuli <chhateauuu@users.noreply.github.com>
Date: Fri, 31 Jul 2026 11:09:05 -0700
Subject: [PATCH] Explain swallow-by-design parse-failure handling in
 DeploymentReport

---
 src/DeploymentReport.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/DeploymentReport.ts b/src/DeploymentReport.ts
index 8ed7a9e2..331030d8 100644
--- a/src/DeploymentReport.ts
+++ b/src/DeploymentReport.ts
@@ -54,6 +54,9 @@ export function parseDeploymentReport(xml: string): DeploymentReport {
     try {
         parsed = parser.parse(xml);
     } catch {
+        // Reporting is best-effort and must never fail a deployment: malformed or
+        // unexpected report XML yields an empty result so the summary simply omits
+        // the changes section instead of surfacing an error.
         return { operations: [], alerts: [] };
     }