<?xml version="1.0" encoding="UTF-8"?>
<!--
  The decision log.

  Every relationship between decisions lives here, out of line. No ADR document
  records that it was superseded, amended or withdrawn: those are properties of
  this graph, derived at read time. That is why an accepted ADR is never edited
  after the fact, and why "what was in force on date X" is a question with an
  answer rather than a reconstruction.

  Arcroles: dcterms:replaces and prov:wasInfluencedBy are ratified vocabulary
  and cold-read well. The amends and withdraws arcroles are local to this
  profile — named here so a reader can see exactly which semantics are borrowed
  and which are ours.
-->
<decision-log xmlns="urn:xenon:adr"
              xmlns:xlink="http://www.w3.org/1999/xlink"
              xlink:type="extended"
              id="billing-platform-log">

  <!-- Participants ....................................................... -->

  <ref xlink:type="locator" xlink:href="../adr/ADR-001.xml" xlink:label="adr-001"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-002.xml" xlink:label="adr-002"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-003.xml" xlink:label="adr-003"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-004.xml" xlink:label="adr-004"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-005.xml" xlink:label="adr-005"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-006.xml" xlink:label="adr-006"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-007.xml" xlink:label="adr-007"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-010.xml" xlink:label="adr-010"/>

  <!--
    Labels need not be unique. These two locators share one, so a single arc
    below reaches both: one requirement change, one supersession, two decisions
    retired together. This is the whole reason the relationship is an XLink
    extended link rather than a pair of pointers — a "superseded by" field in
    each document could record the same fact twice, but not that it is one
    fact.
  -->
  <ref xlink:type="locator" xlink:href="../adr/ADR-008.xml" xlink:label="auth-legacy"/>
  <ref xlink:type="locator" xlink:href="../adr/ADR-009.xml" xlink:label="auth-legacy"/>

  <ref xlink:type="locator" xlink:href="../req/requirements.xml#REQ-017-v3" xlink:label="req-017-v3"/>
  <ref xlink:type="locator" xlink:href="../req/requirements.xml#REQ-024-v1" xlink:label="req-024-v1"/>
  <ref xlink:type="locator" xlink:href="../req/requirements.xml#REQ-029-v1" xlink:label="req-029-v1"/>
  <ref xlink:type="locator" xlink:href="../req/requirements.xml#REQ-031-v2" xlink:label="req-031-v2"/>
  <ref xlink:type="locator" xlink:href="../req/requirements.xml#REQ-038-v1" xlink:label="req-038-v1"/>

  <!-- Supersession ....................................................... -->

  <supersession xlink:type="arc"
                xlink:from="adr-004" xlink:to="adr-002"
                xlink:arcrole="http://purl.org/dc/terms/replaces"
                xlink:title="ADR-004 replaces ADR-002 in full"
                scope="whole" effective="2025-11-06"/>

  <supersession xlink:type="arc"
                xlink:from="adr-005" xlink:to="adr-004"
                xlink:arcrole="http://purl.org/dc/terms/replaces"
                xlink:title="ADR-005 replaces ADR-004 in full"
                scope="whole" effective="2026-03-18"/>

  <!-- One arc, two endings: ADR-010 retires ADR-008 and ADR-009 together. -->

  <supersession xlink:type="arc"
                xlink:from="adr-010" xlink:to="auth-legacy"
                xlink:arcrole="http://purl.org/dc/terms/replaces"
                xlink:title="ADR-010 replaces both legacy authentication decisions"
                scope="whole" effective="2026-07-21"/>

  <!-- Clause amendment ................................................... -->

  <amendment xlink:type="arc"
             xlink:from="adr-007" xlink:to="adr-001"
             xlink:arcrole="urn:xenon:arcrole:amends"
             xlink:title="ADR-007 amends the retention clause of ADR-001"
             scope="clause" clause="retention" effective="2026-09-09"/>

  <!-- Withdrawal with no replacement ..................................... -->

  <withdrawal xlink:type="arc"
              xlink:from="adr-006" xlink:to="adr-003"
              xlink:arcrole="urn:xenon:arcrole:withdraws"
              xlink:title="ADR-006 withdraws ADR-003; nothing replaces it"
              scope="whole" effective="2026-06-02"/>

  <!-- Drivers: why each change happened .................................. -->

  <driver xlink:type="arc" xlink:from="adr-004" xlink:to="req-017-v3"
          xlink:arcrole="http://www.w3.org/ns/prov#wasInfluencedBy"/>
  <driver xlink:type="arc" xlink:from="adr-005" xlink:to="req-024-v1"
          xlink:arcrole="http://www.w3.org/ns/prov#wasInfluencedBy"/>
  <driver xlink:type="arc" xlink:from="adr-006" xlink:to="req-029-v1"
          xlink:arcrole="http://www.w3.org/ns/prov#wasInfluencedBy"/>
  <driver xlink:type="arc" xlink:from="adr-007" xlink:to="req-031-v2"
          xlink:arcrole="http://www.w3.org/ns/prov#wasInfluencedBy"/>
  <driver xlink:type="arc" xlink:from="adr-010" xlink:to="req-038-v1"
          xlink:arcrole="http://www.w3.org/ns/prov#wasInfluencedBy"/>

</decision-log>
