]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-21n-xtm-name-reification-originals.md
perf(tmdm): index topic normalization merge candidates
[topic-maps.git] / docs / slice-21n-xtm-name-reification-originals.md
1 # Slice 21N — Drei Name-Reification-Originalverträge registrieren
2
3 ## Ausgangszustand und Umfang
4
5 Branch: `codex/xtm-slice-21n`. Ausgangscommit und Parent:
6 `9daceb816dbd75446ecb8ec0ef4cb5413d381588`.
7 Der vorgefundene Branch war `codex/xtm-slice-21m`; Index und Arbeitsbaum waren sauber.
8 [initial-state.json](../reports/slice-21n/initial-state.json) erhält die damaligen SHA-256 aller versionierten Dateien.
9
10 **Keine Produktionscodeänderung.** Reader, TMDM, CTM, CXTM und XML bleiben bytegenau unverändert.
11 Die drei aus Slice 21M bekannten Erfolge werden hier mit neuen öffentlichen Reader-Aufrufen,
12 nativen Modellprüfungen und vollständigen Originalvergleichen dauerhaft registriert.
13 Historische Beobachtungen werden weder ersetzt noch rückwirkend als registrierte PASS gewertet.
14
15 Vor allen Repository-Änderungen liefen der vollständige Ausgangstest und die 124 Diagnosen
16 in frischen SBCL-2.5.4-Prozessen, ohne System-/Benutzerinitialisierung, mit Netzwerk-
17 und Repository-Schreibsperre. Der Ausgangsreport reproduziert **2157 XTM-Prüfungen**
18 und **XTM 65 PASS / 0 FAIL / 59 NOT-RUN** exakt zu Slice 21M. Auch die vollständige
19 CTM-/TMDM-/CXTM-Regression reproduziert **CTM 262 PASS / 4 FAIL / 7 NOT-RUN**.
20 Alle 124 Diagnosen und 48 Nicht-XTM-Teilberichte stimmen strukturell überein.
21 Siehe [baseline-execution.json](../reports/slice-21n/baseline-execution.json),
22 [baseline.log](../reports/slice-21n/baseline.log),
23 [baseline-xtm.json](../reports/slice-21n/baseline-xtm.json),
24 [baseline-regression.log](../reports/slice-21n/baseline-regression.log),
25 [baseline-retained/](../reports/slice-21n/baseline-retained/) und
26 [baseline-ctm.validation.json](../reports/slice-21n/baseline-ctm.validation.json).
27
28 ## Drei unveränderte Originalquellen und Baselines
29
30 Alle Aussagen unten sind neu beobachtete Ausführungsbefunde. Grundlage sind die
31 unveränderten Quellen und Baselines des gepinnten Korpus
32 `cd165b150176c1d6842b37be9cc9051b40d4996b`.
33
34 | Originalquelle | Quellbytes | Name-Elemente | Besonderheit | CXTM Ist/Soll | Ergebnis |
35 | --- | ---: | ---: | --- | ---: | --- |
36 | [name-duplicate-reified2.xtm](../vendor/cxtm/xtm2/in/name-duplicate-reified2.xtm) | 397 | 2 | Variant am ersten Name | **701/701** | PASS |
37 | [name-duplicate-reified3.xtm](../vendor/cxtm/xtm2/in/name-duplicate-reified3.xtm) | 286 | 2 | `#name` am ersten Name | **497/497** | PASS |
38 | [name-duplicate-reified4.xtm](../vendor/cxtm/xtm2/in/name-duplicate-reified4.xtm) | 286 | 2 | `#name` am zweiten Name | **497/497** | PASS |
39
40 | Original | SHA-256 Quelle | SHA-256 Baseline = tatsächliche Ausgabe |
41 | --- | --- | --- |
42 | `name-duplicate-reified2.xtm` | `27784c98583ec549d0572ad655fd052598525918f0aaa956bf4a4c8dab186ebb` | `38ba091848a16e79c529088e5554e689c15d6ccbc34ae032434ee193fcce90fd` |
43 | `name-duplicate-reified3.xtm` | `454f3dd3f062f5cd2569f043ea87a9e9f3c571087c7999e4508f834ac94131ff` | `bf6cf3cbff769f3c1f23ab4227db60492d55651806cd316201137df7da5b2331` |
44 | `name-duplicate-reified4.xtm` | `562d1f8f781ff394d3c699046d727b03e38426eb78c231f830bf7edc1bf90207` | `bf6cf3cbff769f3c1f23ab4227db60492d55651806cd316201137df7da5b2331` |
45
46 Die Größen und Hashes wurden direkt an den gepinnten Dateien geprüft und zusätzlich
47 mit den historischen [Slice-21M-Beobachtungen](../reports/slice-21m/further-name-reification-observations.json)
48 verglichen. Der erfolgreiche historische Befund ersetzt keinen neuen Test.
49 Vollständige Quellen als Hex und Text sowie Baselines stehen in
50 [candidate-inventory.json](../reports/slice-21n/candidate-inventory.json);
51 [name-followup-originals.json](../reports/slice-21n/name-followup-originals.json) ergänzt
52 die neu ausgeführten Modelle, Traces, Conditions und vollständigen CXTM-Texte.
53 Die tatsächlichen Ausgabebytes bleiben in [actual/](../reports/slice-21n/actual/) erhalten.
54
55 Die Document IRI ist jeweils folgender Präfix plus Case-ID `xtm2/in/<Dateiname>`:
56
57 ```text
58 https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/
59 ```
60
61 Der primäre Source Key ist die Case-ID. Alle drei Eingaben gehen als unveränderte
62 Rohbytes an `topic-maps.xtm:deserialize-octets`. Die instrumentierte primäre
63 Vertragsausführung belegt genau einen Aufruf des qualifizierten XML-Parsers mit
64 dem originalen Bytevektor per EQ. Quellen und Baselines werden nicht umgeschrieben.
65
66 ## Native Name-, Reifier-, Variant- und Identifier-Beziehungen
67
68 Alle drei Quellen enthalten genau ein Topic `id="topic"` mit zwei gleichwertigen
69 Name-Elementen. Beide haben Value `Topic`, keinen expliziten Type, leeren Scope
70 und dasselbe `reifier="#reifier1"`. Der Default-Type hat ausschließlich den SI
71 `http://psi.topicmaps.org/iso13250/model/topic-name`.
72
73 Die tatsächlichen TMDM-Objekte belegen:
74
75 - Genau ein kanonischer Name gehört zum Parent `DocumentIRI#topic`.
76 `topic-name-parent` und Parent-Topic sowie `topic-name-type` und Default-Type
77 sind jeweils EQ. Value ist exakt `Topic`, Name-Scope ist leer.
78 - `item-reifier(name)` ist EQ zum kanonischen `DocumentIRI#reifier1`-Topic.
79 `topic-reified(reifier)` ist EQ zum selben Name. Parent, Type und Map werden
80 durch diese Beziehung nicht reifiziert. Reifier-II und Parent-II bleiben getrennt;
81 die Map hat keine Item Identifier. Es entstehen keine SL oder zusätzlichen SI.
82 - `name-duplicate-reified2.xtm` enthält vier Topics und genau einen erhaltenen
83 Variant. Value ist exakt `topic`, Datatype ist
84 `http://www.w3.org/2001/XMLSchema#string`. Sein Parent ist EQ zum kanonischen Name;
85 sein Scope besteht ausschließlich aus dem kanonischen Theme `DocumentIRI#ahwell`.
86 Der Theme-Topic hat ausschließlich diesen II. Der Variant hat weder II noch Reifier.
87 - `name-duplicate-reified3.xtm` und `name-duplicate-reified4.xtm` enthalten je drei
88 Topics und keine Variants. Der aufgelöste II `DocumentIRI#name` gehört ausschließlich
89 zum kanonischen Name. Die native Suche über alle Information Items liefert per EQ
90 nur diesen Name; Parent, Reifier und Type erhalten den Locator nicht zusätzlich.
91 - Globale Identifier-Eindeutigkeit, kanonische Parent-/Type-/Scope-Referenzen und
92 Reification-Inversen bestehen. Es gibt keine Associations, Occurrences oder Rollen.
93
94 Diese Prüfungen verwenden die vorhandenen nativen APIs und tatsächliche EQ-Referenzen.
95 Die CXTM-Ausgabe allein ist nicht ihr Identitätsnachweis.
96
97 ## Reihenfolge, Normalisierung und erhaltene Handles
98
99 Ein gesonderter Gegenversuch verarbeitet die **ursprünglichen Name-Knoten** mit den
100 vorhandenen `read-name`-/TMDM-Operationen nacheinander. Der primäre Originalvertrag
101 bleibt immer die öffentliche Deserialisierung der vollständigen Originalbytes.
102 Der Gegenversuch erzeugt keine weiteren Case Records und zählt nicht als Ersatzmap.
103
104 | Original | Name-II nach erstem Knoten | Name-II nach zweitem Knoten | Variant nach beiden Knoten |
105 | --- | --- | --- | --- |
106 | `name-duplicate-reified2.xtm` | leer | leer | dasselbe ursprüngliche Variant-Objekt |
107 | `name-duplicate-reified3.xtm` | `DocumentIRI#name` | `DocumentIRI#name` | keiner |
108 | `name-duplicate-reified4.xtm` | leer | `DocumentIRI#name` | keiner |
109
110 In jedem Fall liefern beide `read-name`-Aufrufe **denselben Handle per EQ**.
111 Der aktuelle Name und `canonical-topic-name` dieses Handles sind EQ. Der zuerst
112 festgehaltene Reifier bleibt EQ zum aktuellen Name-Reifier und seine inverse
113 Beziehung bezeichnet weiterhin denselben Name. Im Variant-Fall bleibt das zuerst
114 festgehaltene Variant-Objekt per EQ erhalten, einschließlich kanonischem Parent.
115 Das vollständige Endmodell des Gegenversuchs entspricht dem öffentlichen Originalmodell.
116 JSON enthält `afterFirstName`, `afterSecondName` und die tatsächlich berechneten EQ-Befunde.
117
118 Wiederholte CXTM-Kanonisierung erhält vollständigen Modellzustand, native
119 Identifier und aktuelle wie festgehaltene Handles. Ein anderer diagnostischer
120 Source Key bei gleicher Document IRI erzeugt dasselbe vollständige Modell und
121 dieselben CXTM-Bytes. Die beiden Identifier-Reihenfolgen ergeben auch denselben
122 vollständigen kanonischen CXTM-Text; beide unabhängigen Originalvergleiche sind bytegenau.
123
124 ## Bestehender Harness und genau drei Registrierungen
125
126 [tests/xtm-name-reification-originals.lisp](../tests/xtm-name-reification-originals.lisp)
127 ist ein weiterer Bestandteil des bestehenden ASDF-Testsystems. Die neue Funktion
128 wird ausdrücklich von `run-tests` aufgerufen. Sie verwendet dieselben Case Records,
129 `record-original-result`, öffentlichen Reader und Bytevergleiche wie Slice 21M.
130 Es gibt keine zweite Testarchitektur und keine Änderung der Ergebnissemantik.
131
132 Jeder der drei Verträge erhält genau einen Case Record und genau eine primäre
133 Vertragsausführung. Source-Key- und Normalisierungsgegenproben sind ausdrücklich
134 separate Beobachtungen ohne weitere Registrierung. Erst nach tatsächlicher
135 Deserialisierung, nativen Modellprüfungen und vollständiger Bytegleichheit wird PASS registriert.
136 Alle drei Conditions und `firstDifferentByte` sind null.
137
138 Insgesamt gibt es **68 eindeutige Case Records: 60 positive und acht negative Originale**.
139 Alle 65 bisherigen Originalergebnisse und alle bisherigen Berichtsfelder außer
140 Scope/Statistik/Checkliste/Case-Liste bleiben exakt identisch zu Slice 21M.
141 Der reguläre Lauf besteht mit **2204 eindeutigen XTM-Prüfungen**:
142 **2157 erhaltene ohne Umbenennung** und **47 neue**.
143 Die relative Reihenfolge aller alten Prüflabel bleibt erhalten.
144
145 ## Unveränderte Diagnosen, neue Registrierung
146
147 Alle **124 ursprünglichen Reader-Diagnosen sind vor und nach dieser Aufgabe
148 vollständig identisch** zu Slice 21M, einschließlich Condition-Klassen, Codes,
149 Positionen, Causes und CXTM-Ausgaben. [diagnostic-changes.json](../reports/slice-21n/diagnostic-changes.json)
150 ist die leere Liste; [diagnostics.json](../reports/slice-21n/diagnostics.json) trennt
151 die unveränderte erfolgreiche Beobachtung von den drei neuen Konformitätsregistrierungen.
152 Es gibt keine neue Sprachunterstützung und keinen verschobenen Unsupported-Befund.
153 Alle bisherigen acht negativen Originale und deren Ursachen bleiben unverändert.
154 Die drei offenen negativen Verträge bleiben unregistriert.
155
156 ## Vollständige Offline-Abnahme und Integrität
157
158 [execution.json](../reports/slice-21n/execution.json) erhält alle **98** frischen
159 Prozessaufrufe mit Kommando, UTC-Zeiten und tatsächlichen/erwarteten Exitcodes.
160 Jeder Ausführungsprozess verwendet eine Netzwerk- und Repository-Schreibsperre.
161 SBCL ist exakt 2.5.4 mit `--no-sysinit --no-userinit`. Gepinnte lokale Quellen
162 und die bestehenden XML-Patches werden geprüft und temporär vorbereitet.
163 Die unveränderte native Name-Reifier-API-Vorprüfung aus Slice 21M wird erneut ausgeführt.
164 Kein Download, kein Nix-Rebuild und kein langlebiges Lisp-Image.
165 [validate-slice-21n.py](../scripts/validate-slice-21n.py) führt die vorhandene Validierungskette fort.
166
167 | Bereich | Tatsächliches Ergebnis |
168 | --- | ---: |
169 | Erhaltene TMDM-/CTM-/CXTM-Prüfungen | 12100 PASS |
170 | XML-Qualifikation | 146 PASS |
171 | XTM | 2204 PASS |
172 | CTM/XTM-Mergemap | 217 PASS |
173 | Slice 20A / 20B / 20C | 286 / 25 / 171 PASS |
174 | Slice 20E / 20F / 20G / 20H | 13 / 112 / 226 / 722 PASS |
175 | Python-Unittests | 2 PASS |
176 | NFC-Oracle | 16294 Vergleiche PASS |
177 | Executor-Fehlerkontrollen | 92 erwartete ASDF-Fehlschläge nachgewiesen |
178
179 Alle 77 bisherigen Executor-Kontrollen bleiben erhalten. Für **jeden** der drei
180 neuen positiven Verträge werden zusätzlich CXTM-Byteabweichung, XML-Fehler,
181 XTM-Fehler, Unsupported und ein tatsächlicher nativer Reification-Konflikt injiziert.
182 Die 15 neuen Kontrollen erhalten jeweils alle vorausgehenden korrekten PASS und
183 klassifizieren den beschädigten Vertrag niemals als PASS. Native Konflikte bleiben
184 `REIFICATION-ERROR/:reifier-conflict`; sie sind Ausführungsfehler des positiven Vertrags.
185 Die bestehenden falschen-Condition-Kontrollen bleiben ebenfalls erhalten.
186 Siehe [failure-controls.json](../reports/slice-21n/failure-controls.json),
187 [failure-controls.lisp](../reports/slice-21n/failure-controls.lisp) und die Einzelberichte/Logs.
188
189 [regression.log](../reports/slice-21n/regression.log) und [retained/](../reports/slice-21n/retained/)
190 belegen die vollständige Abnahme. Alle **48 bisherigen Nicht-XTM-Berichte**
191 sind strukturell identisch. Die bekannten CTM-Abweichungen bleiben unverändert:
192 `include-template.ctm`, `include-wildcard2.ctm`, `occurrence-datetime-timezone2.ctm`,
193 `occurrence-datetime2.ctm`.
194
195 Erst nach tatsächlicher Ausführung ermittelter registrierter Stand:
196 **XTM 68 PASS / 0 FAIL / 56 NOT-RUN**; **CTM 262 PASS / 4 FAIL / 7 NOT-RUN**.
197
198 [integrity.json](../reports/slice-21n/integrity.json) prüft **2006 gepinnte Korpusdateien**
199 nach Größe und SHA-256, **3138 historische Berichte** und
200 **5402 geschützte Dateien des Ausgangscommits**. Sämtlicher Produktionscode,
201 Originalquellen, Baselines, Corpus-Lock und historische Reports bleiben unverändert.
202 Ausgeführte Test- und Treiberquellen werden zusätzlich vor und nach der gesamten
203 Abnahme auf identische Hashes geprüft. [precommit-audit.json](../reports/slice-21n/precommit-audit.json)
204 und [artifacts.json](../reports/slice-21n/artifacts.json) erhalten die abschließende
205 Pfad-/Hashprüfung und SHA-256 aller neuen Artefakte, Manifest selbst ausgenommen.
206
207 [development-attempts.json](../reports/slice-21n/development-attempts.json) bewahrt
208 zwei nicht abgenommene Testentwicklungsversuche mit vollständigen Logs:
209 eine zusätzliche schließende Klammer und den anfangs falschen Zugriff auf den
210 bestehenden JSON-OBJECT-Typ. Beides wurde vor der abschließenden Abnahme korrigiert.
211
212 Keine Implementierung von Variant-/Occurrence-/Association-/Role-Reification.
213 Keine Produktionsänderung, Downloads, HyperDoc-Änderung, langlebige Lisp-Images,
214 Pushes oder Deployments. Slice 21N endet mit dem gemeinsamen lokalen Commit
215 von Testregistrierung, Dokumentation und Ausführungsevidenz.