]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-22k-xtm-item-identities.md
perf(tmdm): index topic normalization merge candidates
[topic-maps.git] / docs / slice-22k-xtm-item-identities.md
1 # Slice 22K — XTM Item Identity für Occurrences, Associations und Roles
2
3 Die neun beauftragten unveränderten Originalverträge werden über den produktiven
4 XTM-Reader deserialisiert, nativ geprüft und bytegenau bestanden. Identifier
5 werden ausschließlich durch die vorhandene TMDM-Operation `add-item-identifier`
6 zugewiesen. Es entsteht keine neue Identifier- oder Objektverwaltung.
7
8 Ausgangscommit und Commit-Parent:
9 `cc1a0e02803a5705c97fb5457f6e93ad22f8b347`.
10 Branch: `codex/xtm-slice-22k`. Beim Beginn waren Index und Arbeitsbaum sauber,
11 Ausgangsbranch `codex/xtm-slice-22j`. Der tatsächlich gespeicherte Harness wies
12 XTM **98 PASS, 0 FAIL, 26 NOT-RUN** und CTM **262 PASS, 4 FAIL, 7 NOT-RUN** aus.
13 [initial-state.json](../reports/slice-22k/initial-state.json) enthält die SHA-256
14 aller 9396 verfolgten Ausgangsdateien.
15
16 ## Normative Grundlage und Editionsgrenze
17
18 **Normativ abgeleitet:** [XTM 2.0 §§4.3.3–4.3.4 und 4.6](https://www.isotopicmaps.org/sam/sam-xtm/)
19 ordnet den aufgelösten `itemIdentity/@href`-Locator dem durch das Parent-Element
20 repräsentierten Item zu. Prozentkodierung wird als UTF-8 dekodiert und relativ
21 zur Document IRI aufgelöst. `itemIdentity*` steht gemäß §§4.15, 4.18–4.19 und
22 Annex A vor Type, Scope und weiteren Kindern. Die explizite Topic-Merge-Anweisung
23 in §4.6 ist auf Topics bezogen; für die drei neuen Parent-Typen ersetzt II keine
24 fachliche Gleichheitsentscheidung.
25
26 **Normativ abgeleitet:** [TMDM 2006 §§5.1, 5.6–5.8 und 6.5–6.7](https://www.isotopicmaps.org/sam/sam-model/2006-06-18/)
27 verbietet gleiche Item-Identifier auf verschiedenen Information Items.
28 Gleiche Occurrences, Associations oder Roles werden anhand ihrer bestehenden
29 fachlichen Eigenschaften normalisiert; ihre II-Mengen werden dabei vereinigt.
30 Identifier sind kein Ersatz für Parent, Type, Scope, Value/Datatype oder Player.
31 Role-Parent bleibt Teil der Role-Gleichheit. Locatorgleichheit folgt §4.3.
32
33 **Geprüfte Editionsgrenze:** Die [korrigierte Onlinefassung von 2008](https://www.isotopicmaps.org/sam/sam-model/)
34 weist ausdrücklich auf Abweichungen zur ISO-Ausgabe hin. Die
35 [publizierten Errata](https://www.isotopicmaps.org/sam/errata.html) betreffen den
36 Default-Name-Type (§7.5) und die Variant-Vereinigung beim Name-Merge (§6.3).
37 Für die hier verwendeten II-Eindeutigkeits- und Merge-Regeln wurde keine relevante
38 Editionsabweichung festgestellt. Es werden keine zusätzlichen Anforderungen aus
39 2008 eingeführt und keine bestehenden TMDM-Regeln geändert.
40
41 ## Produktive Reader-Operationen
42
43 Die einzige Produktionsänderung liegt in `src/xtm/reader.lisp`:
44
45 - `validate-source` akzeptiert `itemIdentity*` bei Occurrence, Association und
46 Role. Der gemeinsame Locator-/Leaf-Pfad prüft die Quelle. Reihenfolge,
47 Kardinalitäten und zulässige Parent-Kontexte bleiben strikt.
48 - `read-item-identities` verwendet `leaf-href` und `add-item-identifier` für alle
49 fünf unterstützten Nicht-Topic-Parent-Typen. Die bisherigen Name-/Variant-
50 Schleifen werden damit ohne Semantikänderung wiederverwendet.
51 - `read-occurrence` erzeugt beziehungsweise normalisiert zuerst das native Item
52 und weist ihm anschließend seine Identifier zu.
53 - `read-association` erzeugt die vollständige native Association, die bereits
54 Associations und Roles normalisieren kann. Association-II gehen an den
55 kanonischen Parent. Jede Quell-Role wird innerhalb dieses Parents anhand des
56 kanonischen Role Type und Player wiedergefunden und erhält dann ihre II.
57 XML-Reihenfolge und II entscheiden nicht über die Role-Zuordnung.
58
59 Die temporären Listen sind Konstruktorargumente und XML-Quellknoten. TMDM besitzt
60 weiterhin die alleinige Modellrepräsentation, Normalisierung und Handles.
61 Identifier-Zuweisung erzeugt keine Topics. SI, SL und II bleiben getrennt.
62 Keine Änderung an TMDM, CTM, CXTM, XML oder der Map-Item-Identitätssemantik.
63
64 ## Neun tatsächliche Originalvergleiche
65
66 Alle Dateien liegen unverändert unter `vendor/cxtm/xtm2/in/`; die vollständigen
67 Quellbytes, Texte, SHA-256 und Baselines stehen in
68 [originals-before.json](../reports/slice-22k/originals-before.json).
69 Die tatsächlichen Modelle, Handles, Quellkontexte und CXTM-Vergleiche stehen in
70 [original-contracts.json](../reports/slice-22k/after/original-contracts.json).
71
72 | Original | Actual/Baseline Bytes | Item mit II | Erhaltene lokale II |
73 |---|---:|---|---|
74 | itemid-occurrence.xtm | 443/443 | Occurrence | `#the-occurrence` |
75 | occurrence-duplicate-iid.xtm | 443/443 | kanonische Occurrence | `#the-occurrence` |
76 | itemid-association.xtm | 580/580 | Association | `#the-association` |
77 | association-duplicate-iid.xtm | 580/580 | kanonische Association | `#the-association` |
78 | association-duplicate-iid2.xtm | 617/617 | kanonische Association | `#the-association`, `#the-association2` |
79 | association-duplicate-iid3.xtm | 617/617 | kanonische Association | `#the-association`, `#the-association2` |
80 | itemid-role.xtm | 573/573 | Role | `#the-role` |
81 | role-duplicate-iid.xtm | 573/573 | kanonische Role | `#the-role` |
82 | role-duplicate-iid2.xtm | 573/573 | Role der kanonischen Association | `#the-role` |
83
84 Alle neun Ergebnisse sind **PASS**, Condition `null`, erste abweichende Byteposition
85 `null`. Die vollständigen erzeugten Ausgaben sind unter
86 [actual/](../reports/slice-22k/after/actual/) gesichert. Keine Ersatzmap und keine
87 nachträgliche Änderung der CXTM-Ausgaben.
88
89 Jeder Originaltest verwendet `topic-maps.xtm:deserialize-octets` und genau einen
90 qualifizierten Parseraufruf mit den tatsächlichen Original-Octets.
91 Document IRI ist
92 `https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/`
93 plus vollständiger Case-ID. Source Key ist die Case-ID. Erneutes tatsächliches
94 Deserialisieren mit einem anderen diagnostischen Key liefert identische native
95 Eigenschaften und CXTM-Bytes. Vor der Registrierung werden II-Eigentümer,
96 Topiczahlen, Parent, Type, Scope, Value/Datatype, Player, inverse Roles und
97 kanonische EQ-Referenzen geprüft. Ein Locator gehört jeweils genau einem aktuellen
98 Item; bloße II-Zuweisung fügt weder Topics noch SI/SL hinzu.
99
100 ## Native Normalisierung und Konflikte
101
102 **Beobachtet:** Gleiche Items mit unterschiedlichen II normalisieren bei allen
103 drei Itemtypen zu einem Item mit der vollständigen II-Vereinigung. Ein einzelnes
104 Item unterstützt einen, mehrere und wiederholte II als Menge. Relative,
105 absolute und prozentkodierte Unicode-IRIs werden über den bestehenden Pfad
106 aufgelöst.
107
108 Die zusätzliche Role-Gegenprobe verwendet zwei äquivalente Associations mit
109 vertauschter Rollenreihenfolge. II `urn:r1`/`urn:r3` landen ausschließlich bei
110 Role Type `#r`, Player `#p`; `urn:r2`/`urn:r4` bei `#rr`, `#q`. Die Association
111 behält `urn:as1` und `urn:as2`. Das prüft gezielt die Metadatenzuordnung nach der
112 bereits im Konstruktor erfolgten Normalisierung.
113
114 Späte SI-, SL- und II-Merges werden getrennt ausgeführt. Zunächst bestehen zwei
115 Occurrence-Parents, Association Types, Role Types, Players und Scope-Themes.
116 Nach Identitätszusammenführung bestehen jeweils eine Occurrence, Association und
117 Role mit zwei erhaltenen II; ihre Referenzen und alten Handles sind kanonisch
118 auflösbar. Wiederholte CXTM-Kanonisierung verändert weder Modell, Identifier noch
119 Handles. Die Beobachter filtern private TMDM-Preflight-Graphs anhand der tatsächlichen
120 zurückgegebenen Map und ändern keine Modelloperation.
121
122 Die Gegenproben enthalten Kollisionen mit dem Map-Item, zwischen unterschiedlichen
123 Occurrences/Associations/Roles, über Itemtypgrenzen, bei gleichen Role-Signaturen
124 in verschiedenen Parents und nach bereits erfolgtem Topic-Merging. Sie erreichen
125 jeweils **`ITEM-IDENTIFIER-ERROR / duplicate-item-identifier`**. Die gescheiterte
126 native Zuweisung verändert ihren vor dem Aufruf beobachteten Graph nicht. Items
127 werden nicht allein wegen gleicher II zusammengeführt.
128
129 Die neue reale XTM-Mergemap-Gegenprobe importiert Occurrence-, Association- und
130 Role-II über die vorhandene Importoperation. Native Referenzen, Identifier und
131 Quellmap bleiben korrekt; Root-Map-Metadaten werden nicht übernommen. Eine
132 kollidierende Child-Association erreicht **`XTM-RESOURCE-ERROR /
133 mergemap-import-failure` bei 1:131**, mit ursprünglicher nativer
134 `ITEM-IDENTIFIER-ERROR / duplicate-item-identifier` als Cause.
135
136 ## Tatsächliche Fehlerdiagnosen und Evidenzgrenzen
137
138 Der aktuelle [XTM-Bericht](../reports/slice-22k/after/xtm.json) enthält unter
139 `itemIdentityControls` **46** strukturierte Beobachtungen: 16 positive
140 Normalisierungs-/Identitätsproben und 30 Fehler-/Grenzbeobachtungen. Der zusätzliche
141 positive Import steht in `mergemapControls`. Jede neue negative Quelle wird durch
142 den produktiven Reader verarbeitet; ein beliebiger Fehler genügt nie.
143
144 Repräsentative tatsächlich beobachtete Conditions; Positionseinheit ist
145 approximative SAX-Zeile/-Spalte, kein Byteoffset:
146
147 | Ursache | Condition / Code | Position |
148 |---|---|---|
149 | Occurrence-II `%ZZ` | XTM-REJECTION / invalid-percent-escape | 1:115 |
150 | Association-II `%C3%28` | XTM-REJECTION / invalid-percent-utf8 | 1:105 |
151 | Role-II `a#b#c` | XTM-REJECTION / invalid-iri | 1:144 |
152 | Occurrence-II nach Type | XTM-REJECTION / element-order | 1:151 |
153 | Association-II nach Type | XTM-REJECTION / element-order | 1:138 |
154 | Role-II nach Type | XTM-REJECTION / element-order | 1:178 |
155 | II innerhalb von Type | XTM-REJECTION / unexpected-element | 1:110 |
156 | II innerhalb von Scope | XTM-REJECTION / unexpected-element | 1:145 |
157 | Nichtleeres itemIdentity | XTM-REJECTION / unexpected-child | 1:103 |
158 | Fehlendes href | XTM-REJECTION / missing-attribute | 1:91 |
159 | Fehlerhafte XML-Struktur | XTM-XML-ERROR / xml-not-well-formed | 1:117 |
160 | Occurrence-Reification | XTM-UNSUPPORTED / unsupported-construct | 1:102 |
161 | Unterschiedliche Items mit gleicher II | ITEM-IDENTIFIER-ERROR / duplicate-item-identifier | native Slots nicht vorhanden |
162
163 XTM-/XML-Conditions behalten Document IRI, Source Key und verfügbare SAX-Position;
164 XML- und Ressourcenfehler behalten ihre ursprüngliche Cause. Native TMDM-
165 Identifier-Conditions werden wie bisher unverändert propagiert. Sie besitzen
166 selbst keine Source-/Positionsslots und werden nicht als positionsbehaftete
167 XTM-Rejections ausgegeben. Die Evidenz hält dafür die tatsächlich ausgeführte
168 Quelle, Document IRI, Source Key, native Klasse/Code und atomare Zuweisungsprüfung
169 separat fest. Positionen werden nicht erfunden.
170
171 **Explizit ausgeschlossen:** `occurrence-duplicate-iid2.xtm` enthält zwei
172 `topic`-Elemente mit XML-ID `topic`. Nach Wegfall des früheren Unsupported bei
173 der ersten Occurrence erreicht die bestehende Source-Prüfung die zweite ID:
174 **XTM-REJECTION / duplicate-id bei 11:21**. Die XML-ID-Soundness wird nicht geändert.
175 Die weitergehende normative Qualifikation und jede Registrierung dieses positiven
176 Korpusvertrags bleiben außerhalb des Slices; sein registrierter Status bleibt
177 **NOT-RUN**. Auch Reification, `xsd:anyType`, zyklische Mergemap-Semantik,
178 `mergemap-itemid` und XTM 2.1 bleiben ausgeschlossen.
179
180 ## Erhaltene Kontrollen und Originaldiagnosen
181
182 [retargetings.json](../reports/slice-22k/retargetings.json) dokumentiert drei
183 bestehende Unsupported-Kontrollen mit exakten Quellzeilen vor/nach der Anpassung:
184 `item-identity` im Occurrence-Test sowie `association-II` und `role-II` im
185 Association-Test. Sie behalten ihre ursprünglichen II und vollständigen übrigen
186 Quellen, erhalten jeweils einen Reifier am betreffenden Parent und prüfen damit
187 weiter eine bekannte, ausgeschlossene Metadatenfähigkeit. Erwartete Klasse,
188 Code, Checklabels und Kontextprüfungen bleiben erhalten. Neue positive II-Tests
189 prüfen zusätzlich die nun erfüllten Sprachfähigkeiten.
190
191 Alle **113 bestehenden Executor-Fehlerkontrollen** verwenden denselben unveränderten
192 Fault-Treiber. Ihre Case Records, Outcomes und Checklisten stimmen mit Slice 22J
193 überein. Absichtlich gescheiterte ASDF-Läufe werden nicht als Original-PASS gezählt.
194
195 [all-124-original-statuses.json](../reports/slice-22k/after/all-124-original-statuses.json)
196 und [diagnostic-changes.json](../reports/slice-22k/after/diagnostic-changes.json)
197 zeigen: **10 Diagnosedifferenzen**, davon neun neue erfolgreiche Originalvergleiche
198 und die beschriebene ausgeschlossene Duplicate-ID-Diagnose. **114 Diagnosen**
199 bleiben identisch. Sämtliche bisherigen **98 registrierten XTM-PASS** bleiben
200 unverändert; nur die neun beauftragten Originale wechseln zu PASS.
201
202 ## Vollständige Offline-Abnahme
203
204 [execution.json](../reports/slice-22k/after/execution.json) und
205 [runs.json](../reports/slice-22k/after/runs.json) sichern alle **119 Prozesse** mit
206 Kommandos, Laufzeiten, erwarteten/tatsächlichen Exitcodes und SHA-256.
207 Der unveränderte Collector `scripts/validate-slice-22d.py::collect` führt die
208 bestehende Testarchitektur aus; `scripts/validate-slice-22k.py` auditierte die
209 Ergebnisse. `--audit-only` prüft gespeicherte Ausführung und startet keine Tests.
210
211 SBCL **2.5.4**, frische Prozesse ohne System-/Benutzerinitialisierung. Alle
212 Test-Kindprozesse laufen mit Netzwerksperre und Schreibsperre für Repository und
213 HyperDoc. Die Abhängigkeiten stammen ausschließlich aus vorhandenen lokalen Pins.
214
215 - **12100** bisherige Kernchecks und sämtliche bisherigen Slice-20-/22-Stufen.
216 - **3339 XTM-Checks**, davon **3130** bisherige Labels erhalten und **209** neue.
217 - **146** XML-Qualifikationschecks.
218 - CTM/XTM-Mergemap mit **217** Checks und sämtliche bisherigen XTM-Mergemap-Tests.
219 - **501** unveränderte Äquivalenzchecks über **28** tatsächliche Reader-Paare.
220 - **113/113** erwartete ASDF-Ablehnungen der Executor-Fehlerkontrollen.
221 - **2 Python-Tests** und **16294 NFC-Oracle-Vergleiche**.
222 - **49 Nicht-XTM-Berichte byteidentisch**, einschließlich des Äquivalenzberichts.
223
224 Tatsächlich registrierter Abschlussstand:
225
226 | Korpus | PASS | FAIL | NOT-RUN |
227 |---|---:|---:|---:|
228 | XTM 2.0 | 107 | 0 | 17 |
229 | CTM | 262 | 4 | 7 |
230
231 Die vier bekannten CTM-DateTime-/Include-FAILs bleiben sichtbar und unverändert.
232 [integrity.json](../reports/slice-22k/after/integrity.json) belegt Größe und SHA-256
233 aller **2006 gepinnten Korpusdateien** sowie **7100 historischen Reportdateien**.
234 Originalquellen, Baselines und historische Berichte bleiben unverändert.
235 Keine HyperDoc-/Fremdrepository-Änderungen, Downloads, Pushes, Deployments oder
236 Änderungen an langlebigen Lisp-Images. Der Slice endet mit dem lokalen Commit.