Skip to content

Fix the scaffold that propagates 'License: PMPL-1.0-or-later' (runbook §7a source fix) #645

Description

@hyperpolymath

docs/migrations/pmpl-to-mpl-sweep-runbook.adoc §7a already prescribes the fix; this issue exists to track doing it at the source.

The runbook's instruction, verbatim

Strategy — fix at the source, not 236 times. Locate the scaffold generator (rsr-template-repo / scaffoldia / the llm-warmup-* template) and flip the template's licence line to the correct per-category value, THEN re-propagate. Doing 236 manual edits invites immediate re-drift on the next scaffold run.

Measured in standards today, 2026-08-26

54 files still carry a PMPL declaration. By filename, the template origin is obvious:

File Count
humans.txt 12
REUSE dep5 12
README.adoc 11
trust.txt 5
everything else 1 each

Many still carry unfilled {{AUTHOR}} / {{OWNER}} / {{CURRENT_DATE}} placeholders — proof they are scaffold output, not authored text. Note the SPDX header on these files is already correct (MPL-2.0); only the body License: line is wrong, so the legally operative licence is right and this is metadata hygiene rather than a licence defect.

Must NOT be touched

  • LICENSES/PMPL-1.0-or-later.txt — the licence exhibit text (runbook §1 says "Leave")
  • docs/migrations/pmpl-to-mpl-sweep-runbook.adoc — documents the migration
  • rhodium-standard-repositories/satellites/rsr-certifier/PALIMPSEST.adoc
  • scripts/tests/spdx-header-block-test.sh — a test that asserts on these strings; editing it would break the check rather than fix anything

What to do

  1. Find which scaffold emits humans.txt / trust.txt / dep5 / README.adoc carrying License: PMPL-1.0-or-later — candidates per the runbook are rsr-template-repo, scaffoldia, and the llm-warmup-* templates
  2. Fix the template's licence line per category (code → MPL-2.0, prose → CC-BY-SA-4.0)
  3. Re-propagate, excluding the Rule 2 carve-outs, 007, son-shared repos, and vendored forks — exactly as §1/§3 specify
  4. Only then clean the residue

Why this is filed rather than done

I found these 54 files and was about to correct them directly. The runbook explicitly forbids that, and is right to: they are the output of a generator that will reproduce them on the next scaffold run. Recording the measurement here so the source fix has a denominator to verify against.

Related: standards#643 (removed the PMPL preference comments — a different, non-templated surface, already done).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    scope:estateAffects many or all repos across the estatetech-debtKnown shortcut, drift, or hygiene owed - includes cleanup

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions