From 789fa822b5098fdd73069887553e3d60125e773f Mon Sep 17 00:00:00 2001
From: HunterCML <5335527+HunterCML@users.noreply.github.com>
Date: Tue, 19 May 2026 20:25:43 -0500
Subject: [PATCH] Add SLA credit revenue guard

---
 sla-credit-revenue-guard/README.md           |  28 ++
 sla-credit-revenue-guard/acceptance-notes.md |  12 +
 sla-credit-revenue-guard/demo.js             |  41 +++
 sla-credit-revenue-guard/demo.mp4            | Bin 0 -> 47310 bytes
 sla-credit-revenue-guard/demo.svg            |  23 ++
 sla-credit-revenue-guard/index.js            | 314 +++++++++++++++++++
 sla-credit-revenue-guard/requirements-map.md |  18 ++
 sla-credit-revenue-guard/test.js             | 119 +++++++
 8 files changed, 555 insertions(+)
 create mode 100644 sla-credit-revenue-guard/README.md
 create mode 100644 sla-credit-revenue-guard/acceptance-notes.md
 create mode 100644 sla-credit-revenue-guard/demo.js
 create mode 100644 sla-credit-revenue-guard/demo.mp4
 create mode 100644 sla-credit-revenue-guard/demo.svg
 create mode 100644 sla-credit-revenue-guard/index.js
 create mode 100644 sla-credit-revenue-guard/requirements-map.md
 create mode 100644 sla-credit-revenue-guard/test.js

diff --git a/sla-credit-revenue-guard/README.md b/sla-credit-revenue-guard/README.md
new file mode 100644
index 00000000..9d7d0b74
--- /dev/null
+++ b/sla-credit-revenue-guard/README.md
@@ -0,0 +1,28 @@
+# SLA Credit Revenue Guard
+
+This module adds a focused Revenue Infrastructure slice for issue #20. It evaluates institutional contracts, AI compute usage, service incidents, and anonymized licensing exports before invoice release.
+
+It covers:
+
+- tiered subscription plan rules for individual, lab, and institutional accounts
+- AI compute usage metering, included quotas, and overage invoice lines
+- SLA uptime measurement and capped service-credit calculations
+- institutional invoice packets with approval and postmortem warnings
+- licensing/API export readiness checks that block private content and weak aggregation
+- stable audit digests for finance review and revenue operations traceability
+
+This is not another generic billing ledger, tax module, renewal true-up, margin guard, pricing experiment, or procurement workflow. The focus is the operational revenue moment when an outage or service-level breach must be converted into an auditable credit before billing AI compute and institutional licensing access.
+
+## Local Validation
+
+```sh
+node sla-credit-revenue-guard/test.js
+node sla-credit-revenue-guard/demo.js
+```
+
+## Demo Evidence
+
+- [demo.mp4](demo.mp4) shows the problem, implementation scope, invoice packet, and validation commands.
+- [demo.svg](demo.svg) provides a static finance dashboard preview.
+- [requirements-map.md](requirements-map.md) maps the implementation to issue #20.
+- [acceptance-notes.md](acceptance-notes.md) lists reviewer checks.
diff --git a/sla-credit-revenue-guard/acceptance-notes.md b/sla-credit-revenue-guard/acceptance-notes.md
new file mode 100644
index 00000000..44e624cc
--- /dev/null
+++ b/sla-credit-revenue-guard/acceptance-notes.md
@@ -0,0 +1,12 @@
+# Acceptance Notes
+
+Reviewer checks:
+
+1. Run `node sla-credit-revenue-guard/test.js`.
+2. Run `node sla-credit-revenue-guard/demo.js`.
+3. Confirm institutional usage over quota creates an AI compute overage line.
+4. Confirm SLA incidents below the contracted uptime produce capped service credits.
+5. Confirm private or under-aggregated licensing exports hold the invoice.
+6. Confirm audit digests remain stable for the same input.
+
+The module is dependency-free and uses synthetic revenue events only, so it can be reviewed without payment credentials, cloud accounts, or private customer data.
diff --git a/sla-credit-revenue-guard/demo.js b/sla-credit-revenue-guard/demo.js
new file mode 100644
index 00000000..7ce40a57
--- /dev/null
+++ b/sla-credit-revenue-guard/demo.js
@@ -0,0 +1,41 @@
+"use strict";
+
+const { evaluateRevenueGuard } = require("./index");
+
+const result = evaluateRevenueGuard({
+  period: { id: "2026-05", totalMinutes: 43_200 },
+  contracts: [
+    {
+      customerId: "midwest-university",
+      plan: "institutional",
+      monthlyBaseCents: 275000,
+      includedComputeUnits: 50000,
+      overageUnitCents: 7,
+    },
+  ],
+  usageEvents: [
+    { customerId: "midwest-university", computeUnits: 42_500 },
+    { customerId: "midwest-university", computeUnits: 11_000 },
+  ],
+  incidents: [
+    {
+      id: "inc-ai-review-outage",
+      impactMinutes: 75,
+      impactedCustomerIds: ["midwest-university"],
+      postmortemReady: true,
+    },
+  ],
+  licensingExports: [
+    {
+      customerId: "midwest-university",
+      billableCents: 80000,
+      minimumAggregationCount: 100,
+      privateContentIncluded: false,
+      customerNoticeReady: true,
+    },
+  ],
+});
+
+console.log("SLA credit revenue guard demo");
+console.log(JSON.stringify(result.dashboard, null, 2));
+console.log(JSON.stringify(result.packets[0], null, 2));
diff --git a/sla-credit-revenue-guard/demo.mp4 b/sla-credit-revenue-guard/demo.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..ed84aaacdc4c7d296bb2d358511c063dc69df25f
GIT binary patch
literal 47310
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
O|8Y@RHqBqFw);P-q>T#z

literal 0
HcmV?d00001

diff --git a/sla-credit-revenue-guard/demo.svg b/sla-credit-revenue-guard/demo.svg
new file mode 100644
index 00000000..86fa0c2b
--- /dev/null
+++ b/sla-credit-revenue-guard/demo.svg
@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" role="img" aria-labelledby="title desc">
+  <title id="title">SLA Credit Revenue Guard demo dashboard</title>
+  <desc id="desc">Static dashboard preview for institutional revenue invoice controls.</desc>
+  <rect width="1280" height="720" fill="#f6f8fb"/>
+  <rect x="64" y="52" width="1152" height="616" rx="12" fill="#ffffff" stroke="#d7deea"/>
+  <text x="104" y="108" font-family="Arial, sans-serif" font-size="34" font-weight="700" fill="#172033">SLA Credit Revenue Guard</text>
+  <text x="104" y="146" font-family="Arial, sans-serif" font-size="18" fill="#526071">Issue #20 revenue infrastructure slice</text>
+  <rect x="104" y="190" width="312" height="132" rx="10" fill="#eef7f1" stroke="#b7dfc1"/>
+  <text x="130" y="232" font-family="Arial, sans-serif" font-size="18" font-weight="700" fill="#174d29">Invoice Ready</text>
+  <text x="130" y="288" font-family="Arial, sans-serif" font-size="54" font-weight="700" fill="#0f7a36">1</text>
+  <rect x="464" y="190" width="312" height="132" rx="10" fill="#fff3ef" stroke="#efc2b2"/>
+  <text x="490" y="232" font-family="Arial, sans-serif" font-size="18" font-weight="700" fill="#7a2f1b">Service Credits</text>
+  <text x="490" y="288" font-family="Arial, sans-serif" font-size="54" font-weight="700" fill="#b33a1c">$550</text>
+  <rect x="824" y="190" width="312" height="132" rx="10" fill="#edf3ff" stroke="#bfd0f3"/>
+  <text x="850" y="232" font-family="Arial, sans-serif" font-size="18" font-weight="700" fill="#1f3c75">Compute Overage</text>
+  <text x="850" y="288" font-family="Arial, sans-serif" font-size="54" font-weight="700" fill="#285bb8">3500</text>
+  <rect x="104" y="370" width="1032" height="176" rx="10" fill="#fbfcff" stroke="#dfe5f1"/>
+  <text x="130" y="412" font-family="Arial, sans-serif" font-size="20" font-weight="700" fill="#182033">Finance packet</text>
+  <text x="130" y="454" font-family="Arial, sans-serif" font-size="17" fill="#394559">- Base subscription fee plus AI compute overage line</text>
+  <text x="130" y="488" font-family="Arial, sans-serif" font-size="17" fill="#394559">- SLA uptime breach converted to a capped service credit</text>
+  <text x="130" y="522" font-family="Arial, sans-serif" font-size="17" fill="#394559">- Licensing export blocks private content and weak aggregation</text>
+  <text x="104" y="610" font-family="Arial, sans-serif" font-size="16" fill="#526071">Validation: node sla-credit-revenue-guard/test.js && node sla-credit-revenue-guard/demo.js</text>
+</svg>
diff --git a/sla-credit-revenue-guard/index.js b/sla-credit-revenue-guard/index.js
new file mode 100644
index 00000000..e9848f08
--- /dev/null
+++ b/sla-credit-revenue-guard/index.js
@@ -0,0 +1,314 @@
+"use strict";
+
+const crypto = require("node:crypto");
+
+const PLAN_RULES = {
+  individualPro: {
+    monthlyBaseCents: 4900,
+    includedComputeUnits: 250,
+    overageUnitCents: 18,
+    slaPercent: 0,
+    monthlyCreditCapPercent: 0,
+    approvalThresholdCents: 0,
+  },
+  lab: {
+    monthlyBaseCents: 19900,
+    includedComputeUnits: 2500,
+    overageUnitCents: 12,
+    slaPercent: 99.5,
+    monthlyCreditCapPercent: 10,
+    approvalThresholdCents: 15000,
+  },
+  institutional: {
+    monthlyBaseCents: 250000,
+    includedComputeUnits: 50000,
+    overageUnitCents: 7,
+    slaPercent: 99.9,
+    monthlyCreditCapPercent: 20,
+    approvalThresholdCents: 50000,
+  },
+};
+
+function stableStringify(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (value && typeof value === "object") {
+    return `{${Object.keys(value)
+      .sort()
+      .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function stableDigest(value) {
+  return crypto.createHash("sha256").update(stableStringify(value)).digest("hex");
+}
+
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function cents(value) {
+  return Math.round(Number(value || 0));
+}
+
+function formatUsd(centsValue) {
+  return `$${(centsValue / 100).toFixed(2)}`;
+}
+
+function normalizePlan(plan) {
+  const planKey = plan || "individualPro";
+  if (!PLAN_RULES[planKey]) {
+    throw new Error(`Unknown plan: ${planKey}`);
+  }
+  return planKey;
+}
+
+function getMonthMinutes(period) {
+  if (period && Number.isFinite(period.totalMinutes)) return period.totalMinutes;
+  return 30 * 24 * 60;
+}
+
+function sumIncidentMinutes(incidents) {
+  return asArray(incidents).reduce((sum, incident) => sum + Number(incident.impactMinutes || 0), 0);
+}
+
+function calculateUptimePercent(period, incidents) {
+  const totalMinutes = getMonthMinutes(period);
+  const incidentMinutes = sumIncidentMinutes(incidents);
+  return Math.max(0, ((totalMinutes - incidentMinutes) / totalMinutes) * 100);
+}
+
+function calculateServiceCredit(contract, period, incidents) {
+  const plan = PLAN_RULES[normalizePlan(contract.plan)];
+  if (!plan.slaPercent) {
+    return {
+      eligible: false,
+      uptimePercent: calculateUptimePercent(period, incidents),
+      creditCents: 0,
+      reason: "Plan does not include an SLA credit.",
+    };
+  }
+
+  const uptimePercent = calculateUptimePercent(period, incidents);
+  if (uptimePercent >= plan.slaPercent) {
+    return {
+      eligible: false,
+      uptimePercent,
+      creditCents: 0,
+      reason: "Measured uptime meets the contracted SLA.",
+    };
+  }
+
+  const baseAmount = cents(contract.monthlyBaseCents || plan.monthlyBaseCents);
+  const gap = plan.slaPercent - uptimePercent;
+  const rawCreditPercent = Math.min(plan.monthlyCreditCapPercent, Math.ceil(gap * 4));
+  const creditCents = Math.round(baseAmount * (rawCreditPercent / 100));
+
+  return {
+    eligible: true,
+    uptimePercent,
+    creditCents,
+    creditPercent: rawCreditPercent,
+    reason: `Uptime ${uptimePercent.toFixed(3)}% is below ${plan.slaPercent}% SLA.`,
+  };
+}
+
+function meterCompute(contract, usageEvents) {
+  const plan = PLAN_RULES[normalizePlan(contract.plan)];
+  const units = asArray(usageEvents).reduce((sum, event) => sum + Number(event.computeUnits || 0), 0);
+  const includedUnits = Number(contract.includedComputeUnits || plan.includedComputeUnits);
+  const overageUnits = Math.max(0, units - includedUnits);
+  const overageUnitCents = cents(contract.overageUnitCents || plan.overageUnitCents);
+
+  return {
+    units,
+    includedUnits,
+    overageUnits,
+    overageUnitCents,
+    overageCents: overageUnits * overageUnitCents,
+  };
+}
+
+function validateLicensingExport(licensingExport) {
+  if (!licensingExport) {
+    return {
+      ready: false,
+      findings: [
+        {
+          severity: "warning",
+          code: "missing-licensing-export",
+          message: "No anonymized licensing API export metadata was attached to the revenue packet.",
+        },
+      ],
+    };
+  }
+
+  const findings = [];
+  if (licensingExport.privateContentIncluded) {
+    findings.push({
+      severity: "blocker",
+      code: "private-content-in-export",
+      message: "Licensing export includes private project content and must not be billed or shipped.",
+    });
+  }
+  if (Number(licensingExport.minimumAggregationCount || 0) < 25) {
+    findings.push({
+      severity: "blocker",
+      code: "aggregation-threshold-too-low",
+      message: "Licensing export aggregation threshold is below the institutional minimum of 25.",
+    });
+  }
+  if (!licensingExport.customerNoticeReady) {
+    findings.push({
+      severity: "warning",
+      code: "customer-notice-missing",
+      message: "Customer notice for licensing/API analytics access is not ready.",
+    });
+  }
+
+  return {
+    ready: findings.every((finding) => finding.severity !== "blocker"),
+    findings,
+  };
+}
+
+function buildInvoicePacket(input) {
+  const contract = input.contract;
+  const plan = PLAN_RULES[normalizePlan(contract.plan)];
+  const baseCents = cents(contract.monthlyBaseCents || plan.monthlyBaseCents);
+  const compute = meterCompute(contract, input.usageEvents);
+  const serviceCredit = calculateServiceCredit(contract, input.period, input.incidents);
+  const licensing = validateLicensingExport(input.licensingExport);
+
+  const lines = [
+    {
+      code: "subscription-base",
+      description: `${contract.plan} subscription base fee`,
+      amountCents: baseCents,
+    },
+  ];
+
+  if (compute.overageCents > 0) {
+    lines.push({
+      code: "ai-compute-overage",
+      description: `${compute.overageUnits} AI compute units over included quota`,
+      amountCents: compute.overageCents,
+    });
+  }
+
+  if (serviceCredit.creditCents > 0) {
+    lines.push({
+      code: "sla-service-credit",
+      description: `Service credit for ${serviceCredit.reason}`,
+      amountCents: -serviceCredit.creditCents,
+    });
+  }
+
+  if (input.licensingExport?.billableCents) {
+    lines.push({
+      code: "licensing-api-access",
+      description: "Anonymized analytics licensing/API access",
+      amountCents: cents(input.licensingExport.billableCents),
+    });
+  }
+
+  const findings = [...licensing.findings];
+  const approvalThresholdCents = cents(contract.approvalThresholdCents || plan.approvalThresholdCents);
+
+  if (serviceCredit.creditCents > approvalThresholdCents && approvalThresholdCents > 0) {
+    findings.push({
+      severity: "warning",
+      code: "finance-approval-needed",
+      message: `${formatUsd(serviceCredit.creditCents)} SLA credit exceeds automatic approval threshold.`,
+    });
+  }
+
+  for (const incident of asArray(input.incidents)) {
+    if (!incident.postmortemReady) {
+      findings.push({
+        severity: "warning",
+        code: "postmortem-missing",
+        message: `${incident.id} needs customer-ready incident evidence before sending the invoice adjustment.`,
+      });
+    }
+  }
+
+  const totalCents = lines.reduce((sum, line) => sum + line.amountCents, 0);
+  const blockers = findings.filter((finding) => finding.severity === "blocker");
+
+  const packet = {
+    customerId: contract.customerId,
+    plan: contract.plan,
+    period: input.period?.id || "current",
+    compute,
+    serviceCredit,
+    licensingReady: licensing.ready,
+    lines,
+    totalCents,
+    total: formatUsd(totalCents),
+    decision: blockers.length > 0 ? "hold" : "invoice-ready",
+    findings,
+  };
+
+  return {
+    ...packet,
+    auditDigest: stableDigest({
+      customerId: packet.customerId,
+      period: packet.period,
+      lines: packet.lines,
+      totalCents: packet.totalCents,
+      findings: packet.findings.map((finding) => finding.code),
+    }),
+  };
+}
+
+function evaluateRevenueGuard(input) {
+  const packets = asArray(input.contracts).map((contract) =>
+    buildInvoicePacket({
+      contract,
+      period: input.period,
+      usageEvents: asArray(input.usageEvents).filter((event) => event.customerId === contract.customerId),
+      incidents: asArray(input.incidents).filter((incident) =>
+        asArray(incident.impactedCustomerIds).includes(contract.customerId),
+      ),
+      licensingExport: asArray(input.licensingExports).find((exportRow) => exportRow.customerId === contract.customerId),
+    }),
+  );
+
+  const dashboard = {
+    invoiceReady: packets.filter((packet) => packet.decision === "invoice-ready").length,
+    held: packets.filter((packet) => packet.decision === "hold").length,
+    totalBilledCents: packets.reduce((sum, packet) => sum + packet.totalCents, 0),
+    totalCreditsCents: packets.reduce(
+      (sum, packet) => sum + Math.abs(packet.lines.filter((line) => line.amountCents < 0).reduce((lineSum, line) => lineSum + line.amountCents, 0)),
+      0,
+    ),
+    blockerCount: packets.flatMap((packet) => packet.findings).filter((finding) => finding.severity === "blocker").length,
+    warningCount: packets.flatMap((packet) => packet.findings).filter((finding) => finding.severity === "warning").length,
+  };
+
+  return {
+    dashboard: {
+      ...dashboard,
+      totalBilled: formatUsd(dashboard.totalBilledCents),
+      totalCredits: formatUsd(dashboard.totalCreditsCents),
+    },
+    packets,
+    auditRoot: stableDigest(packets.map((packet) => packet.auditDigest).sort()),
+  };
+}
+
+module.exports = {
+  PLAN_RULES,
+  buildInvoicePacket,
+  calculateServiceCredit,
+  calculateUptimePercent,
+  evaluateRevenueGuard,
+  formatUsd,
+  meterCompute,
+  stableDigest,
+  validateLicensingExport,
+};
diff --git a/sla-credit-revenue-guard/requirements-map.md b/sla-credit-revenue-guard/requirements-map.md
new file mode 100644
index 00000000..2c4f8305
--- /dev/null
+++ b/sla-credit-revenue-guard/requirements-map.md
@@ -0,0 +1,18 @@
+# Requirements Map
+
+| Issue #20 requirement | Implementation coverage |
+| --- | --- |
+| Tiered subscription billing | `PLAN_RULES` defines individual, lab, and institutional plan pricing, SLA, quotas, overages, caps, and approval thresholds. |
+| Institutional licenses | Invoice packets are grouped by customer contract and include institutional SLA/approval behavior. |
+| AI compute billing | `meterCompute()` turns usage events into quota and overage invoice lines. |
+| Transparent quotas and usage meters | Each packet reports compute units, included units, overage units, unit price, and overage amount. |
+| Institutional invoicing | `buildInvoicePacket()` creates base fee, overage, SLA credit, and licensing/API lines with a release decision. |
+| Licensing APIs and analytics | `validateLicensingExport()` blocks private content, enforces aggregation thresholds, and tracks customer notice readiness. |
+| Predictable recurring revenue controls | SLA credits are capped by plan and approval thresholds so finance can release or hold invoice adjustments. |
+| Auditability | Every invoice packet and the dashboard root include stable SHA-256 digests. |
+
+## Non-goals
+
+- No live Stripe, PayPal, ERP, or bank integration.
+- No real customer or private research data.
+- No attempt to replace a full revenue-recognition close engine.
diff --git a/sla-credit-revenue-guard/test.js b/sla-credit-revenue-guard/test.js
new file mode 100644
index 00000000..0c46844b
--- /dev/null
+++ b/sla-credit-revenue-guard/test.js
@@ -0,0 +1,119 @@
+"use strict";
+
+const assert = require("node:assert/strict");
+const {
+  buildInvoicePacket,
+  calculateServiceCredit,
+  calculateUptimePercent,
+  evaluateRevenueGuard,
+  formatUsd,
+  meterCompute,
+  stableDigest,
+  validateLicensingExport,
+} = require("./index");
+
+const period = { id: "2026-05", totalMinutes: 43_200 };
+const institutionalContract = {
+  customerId: "university-health",
+  plan: "institutional",
+  monthlyBaseCents: 300000,
+  includedComputeUnits: 50000,
+  overageUnitCents: 6,
+};
+
+const incidents = [
+  {
+    id: "inc-2026-05-18",
+    impactMinutes: 90,
+    impactedCustomerIds: ["university-health"],
+    postmortemReady: true,
+  },
+];
+
+const uptime = calculateUptimePercent(period, incidents);
+assert.ok(uptime < 99.9);
+
+const credit = calculateServiceCredit(institutionalContract, period, incidents);
+assert.equal(credit.eligible, true);
+assert.ok(credit.creditCents > 0);
+assert.ok(credit.reason.includes("below"));
+
+const compute = meterCompute(institutionalContract, [
+  { customerId: "university-health", computeUnits: 49_000 },
+  { customerId: "university-health", computeUnits: 3_000 },
+]);
+assert.equal(compute.units, 52_000);
+assert.equal(compute.overageUnits, 2_000);
+assert.equal(compute.overageCents, 12000);
+
+const packet = buildInvoicePacket({
+  contract: institutionalContract,
+  period,
+  incidents,
+  usageEvents: [
+    { customerId: "university-health", computeUnits: 49_000 },
+    { customerId: "university-health", computeUnits: 3_000 },
+  ],
+  licensingExport: {
+    customerId: "university-health",
+    billableCents: 65000,
+    minimumAggregationCount: 50,
+    privateContentIncluded: false,
+    customerNoticeReady: true,
+  },
+});
+
+assert.equal(packet.decision, "invoice-ready");
+assert.ok(packet.lines.some((line) => line.code === "sla-service-credit" && line.amountCents < 0));
+assert.ok(packet.lines.some((line) => line.code === "ai-compute-overage"));
+assert.ok(packet.lines.some((line) => line.code === "licensing-api-access"));
+assert.match(packet.auditDigest, /^[a-f0-9]{64}$/);
+
+const unsafeLicensing = validateLicensingExport({
+  customerId: "agency-1",
+  minimumAggregationCount: 8,
+  privateContentIncluded: true,
+});
+assert.equal(unsafeLicensing.ready, false);
+assert.equal(unsafeLicensing.findings.filter((finding) => finding.severity === "blocker").length, 2);
+
+const guard = evaluateRevenueGuard({
+  period,
+  contracts: [
+    institutionalContract,
+    {
+      customerId: "solo-researcher",
+      plan: "individualPro",
+      monthlyBaseCents: 4900,
+      includedComputeUnits: 250,
+    },
+  ],
+  usageEvents: [
+    { customerId: "university-health", computeUnits: 52_000 },
+    { customerId: "solo-researcher", computeUnits: 310 },
+  ],
+  incidents,
+  licensingExports: [
+    {
+      customerId: "university-health",
+      billableCents: 65000,
+      minimumAggregationCount: 50,
+      privateContentIncluded: false,
+      customerNoticeReady: true,
+    },
+    {
+      customerId: "solo-researcher",
+      minimumAggregationCount: 4,
+      privateContentIncluded: true,
+    },
+  ],
+});
+
+assert.equal(guard.dashboard.invoiceReady, 1);
+assert.equal(guard.dashboard.held, 1);
+assert.ok(guard.dashboard.blockerCount >= 2);
+assert.ok(guard.dashboard.totalCreditsCents > 0);
+assert.equal(formatUsd(12345), "$123.45");
+assert.equal(stableDigest({ b: 2, a: 1 }), stableDigest({ a: 1, b: 2 }));
+
+console.log("sla credit revenue guard tests passed");