feat(works)!: reclassify mappings to alternateOf and isReferencedBy (ADR-0006) - #13
Merged
Merged
Conversation
maehr
added a commit
to maehr/textrefs.org
that referenced
this pull request
Aug 11, 2026
Points data/ at textrefs/registry#13, which carries the alternateOf / isReferencedBy records this branch's compiler requires. Re-bump to the registry main tip once textrefs#13 merges. Also ticks the ADR-0006 follow-ups completed by the previous commit. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Updates the registry data and contributor guidance to implement ADR-0006’s mapping-relation semantics: mapping relations are now chosen by what the target is (entity vs document/page), and the old exactMatch/closeMatch relations are removed from use across the registry work files.
Changes:
- Reclassified all work-file mappings from
exactMatch→alternateOf(Wikidata entities) andcloseMatch→isReferencedBy(Wikipedia articles), and bumpedmodifiedtimestamps accordingly. - Updated
AGENTS.mdauthoring rules to reflect the new relation-selection rule and removed the prior “encode attribution uncertainty viacloseMatch” guidance. - Updated the PR template re-mint checklist to rely on
superseded_byrather than a successor-linkingMappingAssertion.
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| works/wittgenstein.tractatus.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/wittgenstein.philosophical-investigations.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/tanakh.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/plato.republic.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/new-testament.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/murasaki-shikibu.genji.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/laozi.daodejing.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/homer.odyssey.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/homer.iliad.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/dhammapada.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/confucius.analects.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| works/aristotle.nicomachean-ethics.yaml | Reclassifies Wikidata/Wikipedia mappings to alternateOf/isReferencedBy and updates modified. |
| AGENTS.md | Updates authoring guidance to the ADR-0006 rule and removes outdated closeMatch-based guidance. |
| .github/PULL_REQUEST_TEMPLATE.md | Updates re-mint checklist to use superseded_by for successor linkage. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
This was referenced Aug 11, 2026
maehr
added a commit
to maehr/textrefs.org
that referenced
this pull request
Aug 12, 2026
Points data/ at textrefs/registry#13, which carries the alternateOf / isReferencedBy records this branch's compiler requires. Re-bump to the registry main tip once textrefs#13 merges. Also ticks the ADR-0006 follow-ups completed by the previous commit. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…ADR-0006) Wikidata entity targets become alternateOf (prov:alternateOf); Wikipedia article targets become isReferencedBy (dcterms:isReferencedBy). exactMatch and closeMatch are removed from the vocabulary. BREAKING CHANGE: relation is part of the MappingAssertion UUID seed, so all 24 mapping IRIs are re-minted. Permitted because every record is still draft under ADR-0004 and carries no persistence promise. Requires the parent-side change (textrefs/textrefs.org#67); CI here validates against textrefs.org@staging and stays red until that merges. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
maehr
force-pushed
the
feat/mapping-relation-vocabulary
branch
from
August 12, 2026 20:17
ea61fd3 to
24c854d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Registry half of ADR-0006. The parent-side change is textrefs/textrefs.org#67; the two must merge together.
What changed
Every mapping is reclassified by what its target is, which is the rule ADR-0006 replaces the old confidence-based one with:
exactMatchalternateOfprov:alternateOfcloseMatchisReferencedBydcterms:isReferencedByexactMatchandcloseMatchare removed from the vocabulary entirely. Each of the 12 work files also gets itsmodifiedbumped, on the work and on both mappings.AGENTS.mdauthoring rules are rewritten around the new rule. The disputed-attribution guidance ("encode uncertainty via acloseMatchmapping") is dropped rather than translated —closeMatchnever actually expressed attribution uncertainty and no record used it that way; ADR-0006 records finding a real mechanism as a follow-up..github/PULL_REQUEST_TEMPLATE.mdno longer tells contributors to link a re-minted record to its successor with anexactMatchMappingAssertion; succession is already carried bysuperseded_by(dcterms:isReplacedBy), so the instruction was redundant rather than translatable.Identifier churn
relationis part of the MappingAssertion UUID seed (subject \n relation \n target.identifier, ADR-0002), so all 24 mapping IRIs are re-minted. Every record isstatus: draftand there are no tags, so under ADR-0004 these identifiers carry no persistence promise — this is free now and will not be after the first promotion toactive.Verified locally against the parent branch:
npm run build:datacompiles andvalidate-data.tsindependently recomputes all 24 UUIDs from the new seeds — 39250/39250 records valid.CI will be red until the parent merges
.github/workflows/validate.ymlvalidates registry PRs againsttextrefs.org@staging, which still has the old two-value enum. This PR cannot go green until textrefs/textrefs.org#67 reachesstaging. That is the intended behaviour for a coordinated schema+data change, per the workflow's own comment.Stacking
Based on
docs/preferred-citation-system(#11) rather thanmain, because #11 editsAGENTS.mdimmediately adjacent to the relation-guidance line this PR rewrites. Merge #11 first; retarget this tomainafterwards.Merge order overall: textrefs.org#63 + registry#11, then textrefs.org#67 + this.
Refs textrefs/textrefs.org#58, textrefs/textrefs.org#59.
🤖 Generated with Claude Code