diff --git a/.github/scripts/stack-breadcrumb.cjs b/.github/scripts/stack-breadcrumb.cjs index 60ca830b..07badb04 100644 --- a/.github/scripts/stack-breadcrumb.cjs +++ b/.github/scripts/stack-breadcrumb.cjs @@ -2,6 +2,16 @@ // Adapted from the taskless/taskless stack-breadcrumb implementation // (@taskless/stack-breadcrumb) and brought into this repository under its MIT // license, with permission. +// +// THIS COPY IS THE AUTHORITATIVE ONE, and copies exist downstream: taskless/taskless +// vendors it rather than maintaining its own. Fixes are made here and re-vendored +// from here, so a change made downstream is a fork that the next sync discards. +// +// Nothing checks that the copies match, deliberately. This repository moves ahead +// of the vendored copy by design, so a drift test would fail on exactly the changes +// that are supposed to happen. The stakes suit that: a diverged breadcrumb renders a +// PR body slightly differently, where a diverged rule layout writes rules to the +// wrong place — which is why THAT one has a drift test and this one has a sentence. "use strict"; /** diff --git a/.github/scripts/stack-breadcrumb.test.cjs b/.github/scripts/stack-breadcrumb.test.cjs index 91779673..d16070cc 100644 --- a/.github/scripts/stack-breadcrumb.test.cjs +++ b/.github/scripts/stack-breadcrumb.test.cjs @@ -2,6 +2,16 @@ // Adapted from the taskless/taskless stack-breadcrumb implementation // (@taskless/stack-breadcrumb) and brought into this repository under its MIT // license, with permission. +// +// THIS COPY IS THE AUTHORITATIVE ONE, and copies exist downstream: taskless/taskless +// vendors it rather than maintaining its own. Fixes are made here and re-vendored +// from here, so a change made downstream is a fork that the next sync discards. +// +// Nothing checks that the copies match, deliberately. This repository moves ahead +// of the vendored copy by design, so a drift test would fail on exactly the changes +// that are supposed to happen. The stakes suit that: a diverged breadcrumb renders a +// PR body slightly differently, where a diverged rule layout writes rules to the +// wrong place — which is why THAT one has a drift test and this one has a sentence. "use strict"; const test = require("node:test"); diff --git a/.github/workflows/stack-breadcrumb.yml b/.github/workflows/stack-breadcrumb.yml index 9f3c4e1e..0f07ac0b 100644 --- a/.github/workflows/stack-breadcrumb.yml +++ b/.github/workflows/stack-breadcrumb.yml @@ -1,6 +1,9 @@ # SPDX-License-Identifier: MIT # Adapted from the taskless/taskless stack-breadcrumb workflow and brought into # this repository under its MIT license, with permission. +# +# Authoritative here; taskless/taskless vendors this workflow and the module it +# loads. Fixes are made in this repository and re-vendored from it. name: Stack Breadcrumb # Self-contained stacked-PR breadcrumb. All logic lives in a zero-dependency