]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-22j-xtm-association-role-core.md
Qualify closed XML/C14N 1.0 infrastructure for XTM resourceData
[topic-maps.git] / docs / slice-22j-xtm-association-role-core.md
1 # Slice 22J — XTM 2.0 Association-/Role-Kern
2
3 Der produktive XTM-Reader verarbeitet explizite Associations und Roles über die
4 bestehende native TMDM-API. Die neun beauftragten positiven Originale bestehen
5 bytegenau; der negative Originalvertrag erreicht seine beabsichtigte
6 `topicRef`-Ablehnung. Es entstehen zehn zusätzliche registrierte Original-PASS.
7
8 Ausgangscommit und Commit-Parent dieses Slices:
9 `f27f0af85e49cf25948bc4f2325fb02e77698de9`.
10 Arbeitsbranch: `codex/xtm-slice-22j`.
11 Beim Beginn waren Index und Arbeitsbaum sauber; der Ausgangsbranch war
12 `codex/xtm-slice-22h`. Der vollständige Hashbestand der 9086 verfolgten Dateien
13 steht in [initial-state.json](../reports/slice-22j/initial-state.json).
14
15 ## Normative Herleitung und Editionsgrenze
16
17 **Aus der Norm abgeleitet:** [XTM 2.0 §§4.13–4.14, 4.18–4.20 und Annex A](https://www.isotopicmaps.org/sam/sam-xtm/)
18 fordert `association { reifiable, type, scope?, role+ }` und
19 `role { reifiable, type, topicRef }`. Scope ist eine Topic-Menge. Type und Player
20 verwenden die gemeinsame Referenzauflösung; `topicRef` benötigt ein
21 Shorthand-Fragment. Ein vorhandener SI-/II-Treffer wird wiederverwendet; nur bei
22 fehlendem Treffer entsteht ein Topic mit dem Referenzlocator als II. Relative
23 IRIs folgen §4.3. Importierte Inhalte folgen dem vorhandenen §4.21-Pfad.
24
25 **Aus der Norm abgeleitet:** [TMDM 2006 §§5.7–5.8, 6.2 und 6.6–6.7](https://www.isotopicmaps.org/sam/sam-model/2006-06-18/)
26 legt Association-Parent, Type, Scope und nichtleere Role-Menge sowie Role-Parent,
27 Type und Player fest. Association-Gleichheit berücksichtigt Type, Scope und
28 Role-Menge; Role-Gleichheit berücksichtigt auch ihren Parent. Deshalb dürfen
29 ähnliche Roles verschiedener Associations allein keinen Association-Merge
30 verursachen. Identitätsmerges müssen die Referenzen aktualisieren.
31
32 **Geprüfte Editionsgrenze:** Die [online korrigierte Fassung vom 2008-06-03](https://www.isotopicmaps.org/sam/sam-model/)
33 kennzeichnet sich ausdrücklich als vom ISO-Text abweichend. Die
34 [veröffentlichten Errata](https://www.isotopicmaps.org/sam/errata.html) nennen den
35 Default-Name-Type (§7.5) und die Variant-Vereinigung beim Name-Merge (§6.3).
36 Die oben verwendeten Association-/Role-Regeln unterscheiden sich in den
37 verglichenen datierten Abschnitten nicht. Dieser Slice führt daraus keine neue
38 Modellanforderung ab und ändert weder Core-Identifier noch Name-/Variant-Regeln.
39
40 **Aus der Norm abgeleitet:** [CXTM §§3.9–3.10 und 4.10–4.11](https://www.isotopicmaps.org/cxtm/cxtm.html)
41 ordnet Associations und Roles kanonisch. Rollenreihenfolge im XTM-Quelltext
42 ist kein TMDM-Gleichheitsmerkmal.
43
44 ## Produktiver Pfad
45
46 `src/xtm/reader.lisp` enthält die einzige Produktionsänderung:
47
48 - `validate-source` prüft Association-/Role-Kontext, Namespace, Attribute,
49 Reihenfolge und Kardinalitäten vor dem Modellaufbau. Genau ein Type, optional
50 ein Scope und mindestens eine Role; jede Role hat genau einen Type und Player.
51 - `read-association` löst Type, Scope und Role-Referenzen mit dem bestehenden
52 `reference-iri`/`find-reference-topic` auf und ruft einmal `make-association`
53 mit den vollständigen nativen Role-Argumenten auf.
54 - `deserialize-document` dispatcht explizite Associations getrennt von Topics.
55
56 TMDM besitzt weiterhin allein Erzeugung, Gleichheit, Normalisierung,
57 Forwarding-Handles und inverse `rolesPlayed`-Beziehungen. Es gibt keine zweite
58 Objektverwaltung und keine Änderung an TMDM, CTM, CXTM oder XML.
59 Die bestehende `instanceOf`-Verarbeitung nutzt dieselbe native Association-API.
60
61 Association-/Role-II und -Reification bleiben ausdrücklich `XTM-UNSUPPORTED`.
62 Die Source-Prüfung beansprucht weiterhin keine vollständige Schemaqualifikation
63 der ausgeschlossenen Untergrammatiken. Occurrence-Metadaten, `xsd:anyType`,
64 zyklische Mergemap-Semantik und XTM 2.1 bleiben ausgeschlossen.
65
66 ## Zehn ausgeführte Originalverträge
67
68 Alle Eingaben sind unveränderte Originalbytes unter `vendor/cxtm/xtm2/`.
69 [originals-before.json](../reports/slice-22j/originals-before.json) enthält
70 Quelltext, vollständige Hexbytes, SHA-256 und Baselines.
71 [original-contracts.json](../reports/slice-22j/after/original-contracts.json)
72 enthält die tatsächlichen Modellbeobachtungen und Vergleiche;
73 [actual/](../reports/slice-22j/after/actual/) die vollständigen erzeugten CXTM-Dateien.
74
75 | Original unter `in/` | Actual/Baseline Bytes | Native Associations/Roles | Ergebnis |
76 |---|---:|---:|---|
77 | association.xtm | 507/507 | 1/1 | PASS |
78 | association-binary.xtm | 833/833 | 1/2 | PASS |
79 | association-binary-duplicate.xtm | 833/833 | 1/2 | PASS |
80 | association-ternary.xtm | 1157/1157 | 1/3 | PASS |
81 | association-scope.xtm | 991/991 | 1/2 | PASS |
82 | association-duplicate-role.xtm | 1157/1157 | 1/3 | PASS |
83 | association-instanceof-duplicate.xtm | 1167/1167 | 1/2 | PASS |
84 | association-instanceof-scope.xtm | 1320/1320 | 1/2 | PASS |
85 | merge-itemid-with-association.xtm | 904/904 | 1/2 | PASS |
86
87 Bei allen neun Vergleichen ist die erste abweichende Byteposition `null`.
88 Vor der PASS-Registrierung werden native Eigenschaften, kanonische interne
89 EQ-Referenzen, ursprüngliche Parser-Octets, auflösbare alte Handles, reine
90 wiederholte CXTM-Kanonisierung und Source-Key-Unabhängigkeit geprüft.
91
92 Der negative Vertrag `invalid/topicref-no-fragment-id.xtm` ist XML-wohlgeformt,
93 verwendet im Association-Scope aber `href="scopingtopic"` ohne Fragment.
94 Beobachtet: `XTM-REJECTION`, Code `invalid-topic-ref`, Detail
95 `topicRef requires an XPointer shorthand fragment.`, approximative SAX-Position
96 **7:38**, Cause `null`. Document IRI und Source Key entsprechen dem Original.
97 Die beabsichtigte Ablehnung ist erreicht; kein vorgelagertes Unsupported.
98 Der bestehende negative Harness verwendet dafür seinen historischen generischen
99 Outcome-Token `ctm-rejection`; die Ausführung erfolgte tatsächlich durch XTM.
100
101 Document-IRI-Konvention für jedes Original:
102 `https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/`
103 plus vollständiger Case-ID. Der Source Key ist die Case-ID; eine erneute
104 Deserialisierung mit anderem diagnostischem Key erzeugt denselben Modellzustand
105 und dieselben CXTM-Bytes. Document-lokale II werden regulär kanonisiert, nicht
106 nachträglich entfernt oder ersetzt.
107
108 ## Native Normalisierung und Gegenproben
109
110 **Beobachtet:** Vor-/Nach-Normalisierung gezählte native Items:
111
112 - Doppelte binäre Associations: 2 Associations/4 Roles werden zu 1/2.
113 - `association-duplicate-role`: 1/4 wird zu 1/3.
114 - `association-instanceof-duplicate`: explizite und implizite Association bleiben
115 zunächst 2/4; spätere Core-SI-Definitionen normalisieren zu 1/2.
116 - Item-Identifier-Merge des Originalplayers: beide Topic-IDs und
117 `http://example.org/#topic` bleiben am kanonischen Topic; Associations 2/4 → 1/2.
118 - Zusätzliche späte SI-, SL- und II-Merges von Type, Role Type, Player und Theme:
119 jeweils 2/2 → 1/1. Zusammenfall zweier Players innerhalb einer Association:
120 1/2 → 1/1. Alle tatsächlich gehaltenen alten Handles bleiben auflösbar.
121 - Vertauschte Rollenreihenfolge normalisiert zu 1/2. Abweichende Association
122 Types, Players, Role Types oder Scopes bleiben jeweils 2/4; unterschiedliche
123 Arity bleibt 2/3. Rollen gleicher Signatur in verschiedenen Parents verursachen
124 damit keine falsche Zusammenführung.
125
126 Der passive Testbeobachter erfasst `normalize-associations` pro tatsächlicher
127 Map. Private Schattenmaps der bestehenden atomaren Core-Preflights sind eigene
128 Graphs und zählen nicht als Handles des Reader-Ergebnisses. Ein anfänglicher
129 Beobachter vermischte diese Graphs; korrigiert wurde ausschließlich die
130 Beobachtung, nicht das Modell. Lokale Klammer-/Fixture-Korrekturen vor dem
131 Abnahmelauf zählen nicht als erfolgreiche Tests.
132
133 46 neue strukturierte Kontrollbeobachtungen stehen in `associationControls` des
134 [aktuellen XTM-Berichts](../reports/slice-22j/after/xtm.json): Gleichheit,
135 Forward References, SI-Treffer ohne zusätzliche II, absolute/relative Referenzen,
136 Scope-Mengen, späte Merges, Syntaxfehler, XML-Fehler und ausgeschlossene Features.
137 Der reale native Core-Identitätskonflikt bleibt `CORE-SUBJECT-ERROR` mit
138 `core-subject-conflict`. Wie bisher besitzt diese native Condition selbst keine
139 Source-Key-/Document-IRI-/Positionsslots; die Evidenz hält ihre konkrete Quelle
140 und Klasse separat fest. XTM-/XML-Conditions erhalten Kontext und SAX-Position;
141 XML-Fehler behalten ihre ursprüngliche Cause.
142
143 Der zusätzliche verschachtelte Import läuft ohne manuelle Ersatzmap:
144 Root → `mid.xtm` → `leaf.xtm`; jede Ressource durchläuft den qualifizierten
145 XML-Parser mit eigener Document IRI und rein diagnostischem Source Key.
146 Native Association-/Role-Objekte werden durch `import-map-content` übertragen;
147 SI-Merging des Players, Scope/Type/Parent und inverse Roles bleiben kanonisch.
148 Die Resolve-Handles beziehen sich bei jedem Schritt auf dessen jeweilige Zielmap.
149 Beide Quellmaps und ihre CXTM bleiben unverändert. Der Kind-Map-II wird nicht
150 übernommen. Exakte Resolverargumente stehen in `mergemapControls`.
151
152 ## Erhaltene Prüfzwecke und Diagnosen
153
154 [retargetings.json](../reports/slice-22j/retargetings.json) dokumentiert die zwei
155 bestehenden Unsupported-Quellen vollständig vor/nach der Anpassung. Sie behalten
156 Label, Klasse, Code und Kontextprüfungen; nur ein Association-Reifier macht die
157 bisher einfache, jetzt unterstützte Quelle wieder zu einer tatsächlich
158 außerhalb des Slices liegenden Fähigkeit. Die bestehende Reification-Kontrolle
159 benötigt keine Quelländerung, erhält aber die präzisere Diagnose.
160
161 Das bestehende Äquivalenz-Gap `explicit-association` verwendet unveränderte
162 CTM-/XTM-Quellen und läuft nun durch `run-pair`: native TMDM-Eigenschaften gleich,
163 interne EQ-Prüfungen bestanden, CXTM **493/493 Bytes**, erste Differenz `null`.
164 Alle bisherigen 27 Paare, drei Kontraste und zwei weiteren Gaps bleiben erhalten.
165 Nun 28 tatsächliche Paare, 501 Checks; daraus folgt kein weiterer Original-PASS.
166
167 [all-124-original-statuses.json](../reports/slice-22j/after/all-124-original-statuses.json)
168 und [diagnostic-changes.json](../reports/slice-22j/after/diagnostic-changes.json)
169 vergleichen sämtliche Originale: **28 Diagnosedifferenzen**, davon zehn
170 beauftragte Ergebnisse und 18 präzisere Unsupported-Grenzen für Association-/Role-II
171 oder -Reification. Die übrigen **96 Diagnosen** bleiben identisch. Alle bisherigen
172 **88 registrierten PASS** bleiben erhalten; nur die zehn beauftragten Fälle
173 wechseln registriert von NOT-RUN zu PASS. Insbesondere bleiben `mergemap-itemid`
174 und `mergemap-loop` unverändert offen.
175
176 ## Vollständige Offline-Abnahme
177
178 [execution.json](../reports/slice-22j/after/execution.json) und
179 [runs.json](../reports/slice-22j/after/runs.json) sichern alle 119 Prozesse mit
180 Befehlen, Laufzeiten, Exitcodes, Source-/Log-/Report-Hashes. Bestehender Collector:
181 `scripts/validate-slice-22d.py::collect`; Audit: `scripts/validate-slice-22j.py`.
182 SBCL **2.5.4**, frische Prozesse, ohne System-/Benutzerinitialisierung;
183 Kindprozesse mit gesperrtem Netzwerk und Schreibsperre für Repository/HyperDoc.
184 Abhängigkeiten ausschließlich aus vorhandenen lokalen Pins.
185
186 - 12100 bisherige Kernchecks und sämtliche CTM-/Slice-20-Stufen erhalten.
187 - XTM: **3130 Checks**, davon 2965 bisherige Labels erhalten und 165 neue.
188 - XML-Qualifikation: **146 PASS**.
189 - CTM/XTM-Mergemap: **217 Checks**; bestehende XTM-Mergemap- und
190 Occurrence-Normalisierungstests erhalten.
191 - CTM/XTM-Äquivalenz: **501 Checks**, **28 tatsächliche Reader-Paare**.
192 - **113/113 Executor-Fehlerkontrollen** erreichen ihre erwartete ASDF-Ablehnung;
193 Case Records, Outcomes und Kontrollchecks bleiben gleich. Eine absichtliche
194 Fault-Ausführung wird niemals als neuer positiver Originalvergleich gezählt.
195 - Python: **2 Tests**; NFC-Oracle: **16294 Vergleiche**.
196 - 48 Nicht-XTM-Berichte bleiben byteidentisch; der zusätzliche Äquivalenzbericht
197 ändert das nun erfüllte Association-Gap und dessen Prüfungen sowie die präzisere
198 Unsupported-Meldung des unverändert ausgeschlossenen Reification-Gaps.
199
200 Tatsächlich registrierter Abschlussstand:
201
202 | Korpus | PASS | FAIL | NOT-RUN |
203 |---|---:|---:|---:|
204 | XTM 2.0 | 98 | 0 | 26 |
205 | CTM | 262 | 4 | 7 |
206
207 Die vier bekannten CTM-DateTime-/Include-FAILs bleiben sichtbar und unverändert.
208 [integrity.json](../reports/slice-22j/after/integrity.json) bestätigt Größe/SHA-256
209 aller **2006 gepinnten Korpusdateien**, **6793 historischen Reportdateien** und
210 sämtlicher geschützter Ausgangsdateien. Originale, Baselines und historische
211 Berichte werden nicht geändert. Kein Download, Push, Deployment oder Zugriff auf
212 langlebige Lisp-Images. Der Slice endet mit dem lokalen Commit.