From 90686d74b7f0fd18b919bbbddea7f2fffe728715 Mon Sep 17 00:00:00 2001
From: Seowoo Han <swhan0329@gmail.com>
Date: Wed, 20 May 2026 13:05:36 +0900
Subject: [PATCH] Add partner royalty settlement guard

---
 README.md                                     |   4 +
 partner-royalty-settlement-guard/README.md    |  45 +++
 .../acceptance-notes.md                       |  23 ++
 partner-royalty-settlement-guard/demo.js      | 100 ++++++
 partner-royalty-settlement-guard/demo.mp4     | Bin 0 -> 47489 bytes
 partner-royalty-settlement-guard/demo.svg     |  32 ++
 partner-royalty-settlement-guard/index.js     | 288 ++++++++++++++++++
 .../requirements-map.md                       |  19 ++
 partner-royalty-settlement-guard/test.js      | 110 +++++++
 9 files changed, 621 insertions(+)
 create mode 100644 partner-royalty-settlement-guard/README.md
 create mode 100644 partner-royalty-settlement-guard/acceptance-notes.md
 create mode 100644 partner-royalty-settlement-guard/demo.js
 create mode 100644 partner-royalty-settlement-guard/demo.mp4
 create mode 100644 partner-royalty-settlement-guard/demo.svg
 create mode 100644 partner-royalty-settlement-guard/index.js
 create mode 100644 partner-royalty-settlement-guard/requirements-map.md
 create mode 100644 partner-royalty-settlement-guard/test.js

diff --git a/README.md b/README.md
index d338cf68..0f91fed8 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,6 @@
 # deepevents.ai
 deepevents.ai main codebase
+
+## Revenue Infrastructure Slices
+
+- [Partner Royalty Settlement Guard](partner-royalty-settlement-guard/README.md) - audit-ready settlement checks for data-licensing and white-label analytics revenue shares.
diff --git a/partner-royalty-settlement-guard/README.md b/partner-royalty-settlement-guard/README.md
new file mode 100644
index 00000000..8a45b310
--- /dev/null
+++ b/partner-royalty-settlement-guard/README.md
@@ -0,0 +1,45 @@
+# Partner Royalty Settlement Guard
+
+Self-contained Revenue Infrastructure slice for issue #20. It focuses on a narrow gap that is different from the existing subscription, metering, tax, dispute, SLA, procurement, pricing experiment, renewal, margin, and privacy-gate modules: audit-ready settlement of data-licensing and white-label analytics revenue shares.
+
+The guard evaluates each license invoice before money is released to dataset contributors, reseller partners, and the platform.
+
+## What It Does
+
+- Calculates platform fees, reseller fees, contributor royalty pools, reserves, and payable lines.
+- Blocks duplicate invoices, expired agreements, unauthorized use cases, missing consent attestations, excessive reseller fees, and broken royalty split percentages.
+- Holds otherwise-valid settlements when anonymized subject counts are below the configured aggregation floor or payout lines are below the minimum payout threshold.
+- Produces a deterministic SHA-256 audit digest that finance can archive with the invoice packet.
+- Returns reviewer-ready actions for settlement, hold, and blocker states.
+
+## Files
+
+- `index.js` - dependency-free settlement evaluator.
+- `test.js` - Node assertions covering ready, held, blocked, duplicate, and validation paths.
+- `demo.js` - terminal demo over a synthetic license batch.
+- `requirements-map.md` - explicit mapping to issue #20 requirements.
+- `acceptance-notes.md` - verification notes and limitations.
+- `demo.svg` / `demo.mp4` - short visual demo artifacts for bounty review.
+
+## Run
+
+```bash
+node partner-royalty-settlement-guard/test.js
+node partner-royalty-settlement-guard/demo.js
+```
+
+## Example Output
+
+```text
+Partner Royalty Settlement Guard Demo
+=====================================
+settlements: 3
+ready: 1, held: 1, blocked: 1
+ready payouts: $925.00
+held payouts: $232.56
+blocked gross: $640.00
+```
+
+## Design Notes
+
+The module is synthetic-data-only and has no network, payment, Stripe, PayPal, bank, or credential integration. It is intended to be the policy and audit layer that would run before a real payout provider is called.
diff --git a/partner-royalty-settlement-guard/acceptance-notes.md b/partner-royalty-settlement-guard/acceptance-notes.md
new file mode 100644
index 00000000..7532d5da
--- /dev/null
+++ b/partner-royalty-settlement-guard/acceptance-notes.md
@@ -0,0 +1,23 @@
+# Acceptance Notes
+
+## Validation
+
+Run from the repository root:
+
+```bash
+node partner-royalty-settlement-guard/test.js
+node partner-royalty-settlement-guard/demo.js
+ffprobe -v error -show_entries format=duration,size -show_entries stream=codec_name,width,height -of default=noprint_wrappers=1 partner-royalty-settlement-guard/demo.mp4
+```
+
+## Expected Review Signals
+
+- Ready settlement releases payout lines and archives the digest.
+- Low anonymized subject count becomes a hold, not a blocker, so finance can aggregate more usage.
+- Duplicate invoice, expired agreement, missing consent, unauthorized use case, and split mismatch block release.
+- Audit digest remains stable for identical input.
+- All calculations use integer cents.
+
+## Scope Boundary
+
+This is an audit and policy module. It intentionally stops before live payout-provider integration so the demo remains credential-free and safe to run in CI or during review.
diff --git a/partner-royalty-settlement-guard/demo.js b/partner-royalty-settlement-guard/demo.js
new file mode 100644
index 00000000..916a00b9
--- /dev/null
+++ b/partner-royalty-settlement-guard/demo.js
@@ -0,0 +1,100 @@
+"use strict";
+
+const { evaluateSettlement, money } = require("./index");
+
+const sampleBatch = {
+  agreements: [
+    {
+      id: "agr-national-knowledge-graph",
+      datasetId: "dataset-citation-network-2026q2",
+      status: "active",
+      endsAt: "2027-03-31",
+      platformFeeRate: 0.18,
+      resellerFeeRate: 0.08,
+      allowedUseCases: ["policy-planning", "meta-research"],
+      contributorRoyaltySplits: [
+        { contributorId: "lab-north", share: 0.45 },
+        { contributorId: "lab-south", share: 0.35 },
+        { contributorId: "data-trust", share: 0.2 },
+      ],
+    },
+    {
+      id: "agr-white-label-pilot",
+      datasetId: "dataset-method-trends",
+      status: "active",
+      endsAt: "2026-09-30",
+      platformFeeRate: 0.2,
+      resellerFeeRate: 0.12,
+      allowedUseCases: ["white-label-dashboard"],
+      contributorRoyaltySplits: [
+        { contributorId: "methods-lab", share: 0.5 },
+        { contributorId: "instrument-core", share: 0.5 },
+      ],
+    },
+    {
+      id: "agr-expired-consortium",
+      datasetId: "dataset-private-notes",
+      status: "active",
+      endsAt: "2026-01-31",
+      allowedUseCases: ["market-intelligence"],
+      contributorRoyaltySplits: [{ contributorId: "legacy-lab", share: 1 }],
+    },
+  ],
+  licenseEvents: [
+    {
+      id: "lic-001",
+      invoiceId: "INV-2026-05-101",
+      agreementId: "agr-national-knowledge-graph",
+      customerId: "nih-policy-office",
+      datasetId: "dataset-citation-network-2026q2",
+      useCase: "policy-planning",
+      grossCents: 125000,
+      subjectCount: 480,
+      consentAttestation: true,
+    },
+    {
+      id: "lic-002",
+      invoiceId: "INV-2026-05-102",
+      agreementId: "agr-white-label-pilot",
+      customerId: "research-dashboard-reseller",
+      datasetId: "dataset-method-trends",
+      useCase: "white-label-dashboard",
+      grossCents: 36000,
+      subjectCount: 18,
+      consentAttestation: true,
+    },
+    {
+      id: "lic-003",
+      invoiceId: "INV-2026-05-101",
+      agreementId: "agr-expired-consortium",
+      customerId: "market-intel-firm",
+      datasetId: "dataset-private-notes",
+      useCase: "market-intelligence",
+      grossCents: 64000,
+      subjectCount: 72,
+      consentAttestation: false,
+    },
+  ],
+};
+
+const report = evaluateSettlement(sampleBatch);
+
+console.log("Partner Royalty Settlement Guard Demo");
+console.log("=====================================");
+console.log(`settlements: ${report.settlementCount}`);
+console.log(`ready: ${report.totals.readyCount}, held: ${report.totals.heldCount}, blocked: ${report.totals.blockedCount}`);
+console.log(`ready payouts: ${money(report.totals.readyPayoutCents)}`);
+console.log(`held payouts: ${money(report.totals.heldPayoutCents)}`);
+console.log(`blocked gross: ${money(report.totals.blockedGrossCents)}`);
+console.log(`audit digest: ${report.auditDigest.slice(0, 16)}...`);
+
+for (const settlement of report.settlements) {
+  console.log("");
+  console.log(`${settlement.eventId} ${settlement.status.toUpperCase()} ${money(settlement.grossCents)} ${settlement.invoiceId}`);
+  for (const finding of settlement.findings) {
+    console.log(`- ${finding.severity}: ${finding.code} - ${finding.message}`);
+  }
+  for (const action of settlement.recommendedActions) {
+    console.log(`  action: ${action}`);
+  }
+}
diff --git a/partner-royalty-settlement-guard/demo.mp4 b/partner-royalty-settlement-guard/demo.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..9c484b6d7f53f5762578253374abd1f066ff12cd
GIT binary patch
literal 47489
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

literal 0
HcmV?d00001

diff --git a/partner-royalty-settlement-guard/demo.svg b/partner-royalty-settlement-guard/demo.svg
new file mode 100644
index 00000000..e7a04e1b
--- /dev/null
+++ b/partner-royalty-settlement-guard/demo.svg
@@ -0,0 +1,32 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" role="img" aria-label="Partner royalty settlement guard demo summary">
+  <rect width="1280" height="720" fill="#0f172a"/>
+  <rect x="72" y="64" width="1136" height="592" rx="24" fill="#111827" stroke="#334155" stroke-width="2"/>
+  <text x="108" y="128" fill="#f8fafc" font-family="Arial, sans-serif" font-size="42" font-weight="700">Partner Royalty Settlement Guard</text>
+  <text x="108" y="172" fill="#cbd5e1" font-family="Arial, sans-serif" font-size="22">Revenue Infrastructure slice for data-licensing and white-label analytics payouts</text>
+
+  <g transform="translate(108 230)">
+    <rect width="310" height="150" rx="16" fill="#052e16" stroke="#22c55e"/>
+    <text x="28" y="48" fill="#86efac" font-family="Arial, sans-serif" font-size="20" font-weight="700">READY</text>
+    <text x="28" y="92" fill="#f8fafc" font-family="Arial, sans-serif" font-size="34" font-weight="700">$925.00</text>
+    <text x="28" y="124" fill="#bbf7d0" font-family="Arial, sans-serif" font-size="18">release payout lines</text>
+  </g>
+
+  <g transform="translate(485 230)">
+    <rect width="310" height="150" rx="16" fill="#422006" stroke="#f59e0b"/>
+    <text x="28" y="48" fill="#fbbf24" font-family="Arial, sans-serif" font-size="20" font-weight="700">HELD</text>
+    <text x="28" y="92" fill="#f8fafc" font-family="Arial, sans-serif" font-size="34" font-weight="700">$232.56</text>
+    <text x="28" y="124" fill="#fde68a" font-family="Arial, sans-serif" font-size="18">aggregation floor</text>
+  </g>
+
+  <g transform="translate(862 230)">
+    <rect width="310" height="150" rx="16" fill="#450a0a" stroke="#ef4444"/>
+    <text x="28" y="48" fill="#fca5a5" font-family="Arial, sans-serif" font-size="20" font-weight="700">BLOCKED</text>
+    <text x="28" y="92" fill="#f8fafc" font-family="Arial, sans-serif" font-size="34" font-weight="700">$640.00</text>
+    <text x="28" y="124" fill="#fecaca" font-family="Arial, sans-serif" font-size="18">duplicate + consent</text>
+  </g>
+
+  <rect x="108" y="430" width="1064" height="126" rx="18" fill="#020617" stroke="#1e293b"/>
+  <text x="140" y="474" fill="#e2e8f0" font-family="Arial, sans-serif" font-size="23" font-weight="700">Audit controls</text>
+  <text x="140" y="512" fill="#cbd5e1" font-family="Arial, sans-serif" font-size="20">duplicate invoice protection - split checks - consent gates - reserve recommendations - stable SHA-256 digest</text>
+  <text x="140" y="606" fill="#94a3b8" font-family="Arial, sans-serif" font-size="18">Validation: node test.js | node demo.js | ffprobe demo.mp4</text>
+</svg>
diff --git a/partner-royalty-settlement-guard/index.js b/partner-royalty-settlement-guard/index.js
new file mode 100644
index 00000000..fd84b0a4
--- /dev/null
+++ b/partner-royalty-settlement-guard/index.js
@@ -0,0 +1,288 @@
+"use strict";
+
+const crypto = require("crypto");
+
+const DEFAULT_POLICY = Object.freeze({
+  asOf: "2026-05-20",
+  platformFeeRate: 0.18,
+  reserveRate: 0.05,
+  minimumPayoutCents: 5000,
+  minimumAggregationSubjects: 25,
+  maximumResellerFeeRate: 0.3,
+});
+
+function evaluateSettlement(input, policyOverrides = {}) {
+  const policy = { ...DEFAULT_POLICY, ...policyOverrides };
+  const agreements = new Map((input.agreements || []).map((agreement) => [agreement.id, agreement]));
+  const seenInvoices = new Set();
+  const settlements = [];
+
+  for (const event of input.licenseEvents || []) {
+    const agreement = agreements.get(event.agreementId);
+    const findings = [];
+
+    if (!agreement) {
+      findings.push(blocker("missing_agreement", `No agreement found for ${event.agreementId}`));
+      settlements.push(buildBlockedSettlement(event, findings));
+      continue;
+    }
+
+    const grossCents = assertCents(event.grossCents, event.id, "grossCents");
+    const platformFeeRate = rateOrDefault(agreement.platformFeeRate, policy.platformFeeRate);
+    const resellerFeeRate = rateOrDefault(event.resellerFeeRate, agreement.resellerFeeRate || 0);
+    const contributorSplits = agreement.contributorRoyaltySplits || [];
+
+    if (seenInvoices.has(event.invoiceId)) {
+      findings.push(blocker("duplicate_invoice", `Invoice ${event.invoiceId} already appeared in this settlement batch`));
+    }
+    seenInvoices.add(event.invoiceId);
+
+    if (agreement.status !== "active") {
+      findings.push(blocker("inactive_agreement", `Agreement ${agreement.id} has status ${agreement.status || "unknown"}`));
+    }
+
+    if (agreement.endsAt && agreement.endsAt < policy.asOf) {
+      findings.push(blocker("expired_agreement", `Agreement expired on ${agreement.endsAt}`));
+    }
+
+    if (event.datasetId !== agreement.datasetId) {
+      findings.push(blocker("dataset_mismatch", `Event dataset ${event.datasetId} does not match agreement dataset ${agreement.datasetId}`));
+    }
+
+    if (!event.consentAttestation) {
+      findings.push(blocker("missing_consent", "Consent attestation is required before licensing revenue can be settled"));
+    }
+
+    if ((event.subjectCount || 0) < policy.minimumAggregationSubjects) {
+      findings.push(
+        hold(
+          "aggregation_floor",
+          `Only ${event.subjectCount || 0} subjects are represented; minimum is ${policy.minimumAggregationSubjects}`
+        )
+      );
+    }
+
+    if (agreement.allowedUseCases && !agreement.allowedUseCases.includes(event.useCase)) {
+      findings.push(blocker("use_case_not_allowed", `${event.useCase} is not allowed by agreement ${agreement.id}`));
+    }
+
+    if (resellerFeeRate > policy.maximumResellerFeeRate) {
+      findings.push(
+        blocker(
+          "reseller_fee_cap",
+          `Reseller fee ${percent(resellerFeeRate)} exceeds cap ${percent(policy.maximumResellerFeeRate)}`
+        )
+      );
+    }
+
+    const splitTotal = roundRate(contributorSplits.reduce((sum, split) => sum + Number(split.share || 0), 0));
+    if (contributorSplits.length === 0) {
+      findings.push(blocker("missing_contributor_splits", "At least one contributor split is required"));
+    } else if (splitTotal !== 1) {
+      findings.push(blocker("split_mismatch", `Contributor splits total ${percent(splitTotal)}, expected 100%`));
+    }
+
+    const platformFeeCents = roundCents(grossCents * platformFeeRate);
+    const resellerFeeCents = roundCents(grossCents * resellerFeeRate);
+    const royaltyPoolCents = Math.max(0, grossCents - platformFeeCents - resellerFeeCents);
+    const reserveCents = findings.some((finding) => finding.severity !== "info")
+      ? roundCents(royaltyPoolCents * policy.reserveRate)
+      : 0;
+    const distributableCents = royaltyPoolCents - reserveCents;
+
+    const payoutLines = contributorSplits.map((split) => {
+      const payableCents = roundCents(distributableCents * Number(split.share || 0));
+      const needsHold = payableCents > 0 && payableCents < policy.minimumPayoutCents;
+      if (needsHold) {
+        findings.push(
+          hold(
+            "minimum_payout",
+            `${split.contributorId} has ${money(payableCents)}, below minimum payout ${money(policy.minimumPayoutCents)}`
+          )
+        );
+      }
+      return {
+        contributorId: split.contributorId,
+        share: roundRate(Number(split.share || 0)),
+        payableCents,
+        status: needsHold ? "held" : "payable",
+      };
+    });
+
+    const status = settlementStatus(findings);
+    settlements.push({
+      eventId: event.id,
+      invoiceId: event.invoiceId,
+      agreementId: agreement.id,
+      customerId: event.customerId,
+      datasetId: event.datasetId,
+      useCase: event.useCase,
+      status,
+      grossCents,
+      platformFeeCents,
+      resellerFeeCents,
+      royaltyPoolCents,
+      reserveCents,
+      distributableCents: status === "blocked" ? 0 : distributableCents,
+      payoutLines: status === "blocked" ? payoutLines.map((line) => ({ ...line, status: "blocked" })) : payoutLines,
+      findings,
+      recommendedActions: recommendedActions(status, findings),
+    });
+  }
+
+  const totals = summarize(settlements);
+  const report = {
+    asOf: policy.asOf,
+    policy,
+    settlementCount: settlements.length,
+    totals,
+    settlements,
+  };
+
+  return {
+    ...report,
+    auditDigest: digest(report),
+  };
+}
+
+function buildBlockedSettlement(event, findings) {
+  return {
+    eventId: event.id,
+    invoiceId: event.invoiceId,
+    agreementId: event.agreementId,
+    customerId: event.customerId,
+    datasetId: event.datasetId,
+    useCase: event.useCase,
+    status: "blocked",
+    grossCents: assertCents(event.grossCents || 0, event.id, "grossCents"),
+    platformFeeCents: 0,
+    resellerFeeCents: 0,
+    royaltyPoolCents: 0,
+    reserveCents: 0,
+    distributableCents: 0,
+    payoutLines: [],
+    findings,
+    recommendedActions: recommendedActions("blocked", findings),
+  };
+}
+
+function settlementStatus(findings) {
+  if (findings.some((finding) => finding.severity === "blocker")) return "blocked";
+  if (findings.some((finding) => finding.severity === "hold")) return "held";
+  return "ready";
+}
+
+function summarize(settlements) {
+  const totals = {
+    grossCents: 0,
+    platformFeeCents: 0,
+    resellerFeeCents: 0,
+    reserveCents: 0,
+    readyPayoutCents: 0,
+    heldPayoutCents: 0,
+    blockedGrossCents: 0,
+    readyCount: 0,
+    heldCount: 0,
+    blockedCount: 0,
+  };
+
+  for (const settlement of settlements) {
+    totals.grossCents += settlement.grossCents;
+    totals.platformFeeCents += settlement.platformFeeCents;
+    totals.resellerFeeCents += settlement.resellerFeeCents;
+    totals.reserveCents += settlement.reserveCents;
+
+    if (settlement.status === "ready") {
+      totals.readyCount += 1;
+      totals.readyPayoutCents += settlement.payoutLines.reduce((sum, line) => sum + line.payableCents, 0);
+    } else if (settlement.status === "held") {
+      totals.heldCount += 1;
+      totals.heldPayoutCents += settlement.payoutLines.reduce((sum, line) => sum + line.payableCents, 0);
+    } else {
+      totals.blockedCount += 1;
+      totals.blockedGrossCents += settlement.grossCents;
+    }
+  }
+
+  return totals;
+}
+
+function recommendedActions(status, findings) {
+  if (status === "ready") {
+    return ["Release payout lines", "Archive the audit digest with the invoice packet"];
+  }
+
+  const actions = new Set();
+  for (const finding of findings) {
+    if (finding.code === "missing_consent") actions.add("Collect consent attestation before settlement");
+    if (finding.code === "aggregation_floor") actions.add("Hold settlement until additional anonymized usage is aggregated");
+    if (finding.code === "duplicate_invoice") actions.add("Reconcile duplicate invoice before payout");
+    if (finding.code === "expired_agreement") actions.add("Renew or replace the agreement before recognizing revenue");
+    if (finding.code === "split_mismatch") actions.add("Correct royalty split percentages to total 100%");
+    if (finding.code === "minimum_payout") actions.add("Accrue small royalty lines until the payout threshold is reached");
+    if (finding.code === "use_case_not_allowed") actions.add("Obtain written approval for the requested license use case");
+    if (finding.code === "reseller_fee_cap") actions.add("Cap or approve reseller fee before settlement");
+  }
+  return Array.from(actions);
+}
+
+function blocker(code, message) {
+  return { severity: "blocker", code, message };
+}
+
+function hold(code, message) {
+  return { severity: "hold", code, message };
+}
+
+function assertCents(value, eventId, field) {
+  if (!Number.isInteger(value) || value < 0) {
+    throw new Error(`${eventId || "settlement"} ${field} must be a non-negative integer number of cents`);
+  }
+  return value;
+}
+
+function rateOrDefault(value, fallback) {
+  if (value === undefined || value === null) return fallback;
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric) || numeric < 0) {
+    throw new Error(`Invalid rate: ${value}`);
+  }
+  return numeric;
+}
+
+function roundCents(value) {
+  return Math.round(value);
+}
+
+function roundRate(value) {
+  return Math.round(value * 10000) / 10000;
+}
+
+function percent(value) {
+  return `${(value * 100).toFixed(2)}%`;
+}
+
+function money(cents) {
+  return `$${(cents / 100).toFixed(2)}`;
+}
+
+function digest(value) {
+  return crypto.createHash("sha256").update(canonicalJson(value)).digest("hex");
+}
+
+function canonicalJson(value) {
+  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+  if (value && typeof value === "object") {
+    return `{${Object.keys(value)
+      .sort()
+      .map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+module.exports = {
+  DEFAULT_POLICY,
+  evaluateSettlement,
+  money,
+};
diff --git a/partner-royalty-settlement-guard/requirements-map.md b/partner-royalty-settlement-guard/requirements-map.md
new file mode 100644
index 00000000..972f6e1a
--- /dev/null
+++ b/partner-royalty-settlement-guard/requirements-map.md
@@ -0,0 +1,19 @@
+# Requirement Map
+
+Issue #20 asks for modular revenue infrastructure spanning subscription billing, AI compute billing, and licensing APIs and analytics. This slice targets the licensing and analytics revenue stream after a license invoice exists but before payout settlement.
+
+| Issue requirement | Coverage in this module |
+| --- | --- |
+| Data licensing models for institutional customers and government partners | Models partner/customer license events against agreement metadata and allowed use cases. |
+| Licensing APIs and analytics | Treats white-label analytics and policy-planning exports as license events with dataset IDs, customers, use cases, and invoice IDs. |
+| Monetize structured, anonymized usage and research metadata | Enforces a minimum aggregation subject floor and consent attestation before revenue can be settled. |
+| Predictable recurring revenue and high margins | Calculates platform fees, reseller fees, contributor pools, reserves, and held payouts in cents. |
+| Secure payment integrations and institutional invoicing | Produces pre-payment settlement decisions and audit-ready recommended actions without touching live payment rails. |
+| Volume/consortium pricing and partner channels | Supports reseller fee rates, contributor royalty splits, payout thresholds, and duplicate invoice protection. |
+| Compliance and audit readiness | Emits deterministic audit digests, blocker/hold findings, and finance actions for each settlement. |
+
+## Non-Goals
+
+- Does not integrate with Stripe, PayPal, banks, or Algora.
+- Does not store real customer, contributor, or payment data.
+- Does not duplicate existing broad subscription billing, dispute, tax, SLA, renewal, pricing experiment, procurement, margin, or privacy-safe licensing gate modules.
diff --git a/partner-royalty-settlement-guard/test.js b/partner-royalty-settlement-guard/test.js
new file mode 100644
index 00000000..252da063
--- /dev/null
+++ b/partner-royalty-settlement-guard/test.js
@@ -0,0 +1,110 @@
+"use strict";
+
+const assert = require("assert/strict");
+const { evaluateSettlement } = require("./index");
+
+function baseAgreement(overrides = {}) {
+  return {
+    id: "agreement-a",
+    datasetId: "dataset-a",
+    status: "active",
+    endsAt: "2026-12-31",
+    platformFeeRate: 0.18,
+    resellerFeeRate: 0.08,
+    allowedUseCases: ["policy-planning"],
+    contributorRoyaltySplits: [
+      { contributorId: "lab-a", share: 0.6 },
+      { contributorId: "lab-b", share: 0.4 },
+    ],
+    ...overrides,
+  };
+}
+
+function baseEvent(overrides = {}) {
+  return {
+    id: "event-a",
+    invoiceId: "INV-A",
+    agreementId: "agreement-a",
+    customerId: "customer-a",
+    datasetId: "dataset-a",
+    useCase: "policy-planning",
+    grossCents: 100000,
+    subjectCount: 80,
+    consentAttestation: true,
+    ...overrides,
+  };
+}
+
+{
+  const report = evaluateSettlement({
+    agreements: [baseAgreement()],
+    licenseEvents: [baseEvent()],
+  });
+
+  assert.equal(report.settlements[0].status, "ready");
+  assert.equal(report.totals.readyCount, 1);
+  assert.equal(report.totals.readyPayoutCents, 74000);
+  assert.equal(report.settlements[0].payoutLines[0].payableCents, 44400);
+  assert.match(report.auditDigest, /^[a-f0-9]{64}$/);
+}
+
+{
+  const first = evaluateSettlement({
+    agreements: [baseAgreement()],
+    licenseEvents: [baseEvent()],
+  });
+  const second = evaluateSettlement({
+    agreements: [baseAgreement()],
+    licenseEvents: [baseEvent()],
+  });
+  assert.equal(first.auditDigest, second.auditDigest);
+}
+
+{
+  const report = evaluateSettlement({
+    agreements: [baseAgreement()],
+    licenseEvents: [baseEvent({ subjectCount: 8 })],
+  });
+
+  assert.equal(report.settlements[0].status, "held");
+  assert.equal(report.totals.heldCount, 1);
+  assert.equal(report.settlements[0].reserveCents, 3700);
+  assert.ok(report.settlements[0].findings.some((finding) => finding.code === "aggregation_floor"));
+}
+
+{
+  const report = evaluateSettlement({
+    agreements: [baseAgreement({ contributorRoyaltySplits: [{ contributorId: "lab-a", share: 0.7 }] })],
+    licenseEvents: [baseEvent()],
+  });
+
+  assert.equal(report.settlements[0].status, "blocked");
+  assert.ok(report.settlements[0].findings.some((finding) => finding.code === "split_mismatch"));
+}
+
+{
+  const report = evaluateSettlement({
+    agreements: [baseAgreement()],
+    licenseEvents: [
+      baseEvent({ id: "event-a", invoiceId: "INV-DUP" }),
+      baseEvent({ id: "event-b", invoiceId: "INV-DUP", grossCents: 22000 }),
+    ],
+  });
+
+  assert.equal(report.settlements[0].status, "ready");
+  assert.equal(report.settlements[1].status, "blocked");
+  assert.ok(report.settlements[1].findings.some((finding) => finding.code === "duplicate_invoice"));
+}
+
+{
+  assert.throws(
+    () =>
+      evaluateSettlement({
+        agreements: [baseAgreement()],
+        licenseEvents: [baseEvent({ grossCents: 10.5 })],
+      }),
+    /grossCents must be a non-negative integer/
+  );
+}
+
+console.log("partner-royalty-settlement-guard tests passed");