]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-21h-xtm-variant-merge-original.md
test: prove CTM/XTM anyType equivalence (slice 22T)
[topic-maps.git] / docs / slice-21h-xtm-variant-merge-original.md
1 # Slice 21H — XTM Variant-Merge-Originalvertrag
2
3 ## Ausgeführter Auftrag und Ausgangszustand
4
5 Branch: `codex/xtm-slice-21h`. Ausgangscommit und vorgesehener Parent:
6 `39c125bf9d462f538403aa633c56054511c210da`.
7 Vor Beginn waren Index und Arbeitsbaum sauber; der vorgefundene Branch war
8 `codex/xtm-slice-21g`. Der neue Branch setzt denselben Commit fort.
9 [initial-state.json](../reports/slice-21h/initial-state.json) enthält den
10 Ausgangszustand und die SHA-256-Werte aller damals versionierten Dateien.
11
12 Ein neuer Prozess ohne System-/Benutzerinitialisierung reproduzierte zunächst
13 1397 XTM-Prüfungen und den gespeicherten Stand **56 PASS, 0 FAIL, 68 NOT-RUN**.
14 Sein Report ist strukturell identisch mit dem Abschlussreport aus Slice 21G.
15 CTM startete unverändert bei **262 PASS, 4 FAIL, 7 NOT-RUN**.
16 Siehe [baseline.log](../reports/slice-21h/baseline.log) und
17 [baseline-xtm.json](../reports/slice-21h/baseline-xtm.json).
18
19 Die frühere Beobachtung aus
20 [Slice 21G](../reports/slice-21g/diagnostic-changes.json) ist historische Evidenz.
21 Sie wurde anhand der Originalbytes erneut reproduziert, bevor und nachdem die
22 Registrierung ergänzt wurde. Sie ersetzt keinen der neuen Ausführungsschritte.
23
24 ## Unveränderter Originalvertrag
25
26 Einziger neu registrierter Case Record:
27 `xtm2/in/merge-itemid-with-variants.xtm`.
28
29 - [Originalquelle](../vendor/cxtm/xtm2/in/merge-itemid-with-variants.xtm): **641 Bytes**,
30 SHA-256 `1712d72a0f3d908a259c539c13197af5e0d405a1572bbfd865aed8603b1edb45`.
31 - [Originalbaseline](../vendor/cxtm/xtm2/baseline/merge-itemid-with-variants.xtm.cxtm):
32 **919 Bytes**, SHA-256
33 `f157b2f40fa516c51dcc99cc7e151ed709d9ae3e29ba5c5c2bb5d9e9ef8a016a`.
34 - Document IRI:
35 `https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/xtm2/in/merge-itemid-with-variants.xtm`.
36 - Source Key: `xtm2/in/merge-itemid-with-variants.xtm`.
37
38 Die vollständigen Originalbytes als Hex und UTF-8-Text sowie das tatsächliche
39 Modell, beide Original-Reader-Zwischenstände und die vollständigen tatsächlichen
40 und erwarteten CXTM-Texte stehen in
41 [variant-merge-original.json](../reports/slice-21h/variant-merge-original.json).
42 Die Inventur mit historischer Ausgangsbeobachtung steht in
43 [candidate-inventory.json](../reports/slice-21h/candidate-inventory.json).
44
45 Beobachtet am tatsächlichen XML: Die zwei Topic-Elemente mit `id="topic"` und
46 `id="topic2"` besitzen beide den Item Identifier `http://example.org/#topic`.
47 Der erste Topic enthält den Name `Topic` mit Variant `TOPIC!`, der zweite den
48 Name `Topic 2` mit Variant `TOPIC2!`. Beide Name-Scopes sind leer. Beide expliziten
49 Variant-Scopes referenzieren `#theme`. Beide Werte sind textuelle `resourceData`
50 ohne ausdrücklichen Datentyp. Andere Sprachfähigkeiten werden nicht benötigt.
51
52 ## Native Modell- und Identitätsnachweise
53
54 Die primäre Prüfung verarbeitet die unveränderten 641 Originalbytes über
55 `topic-maps.xtm:deserialize-octets` und den vorhandenen qualifizierten XML-Parser.
56 Sie erzeugt drei Topics, zwei verschiedene Names, zwei verschiedene Variants und
57 keine Associations. Die folgenden Aussagen sind ausgeführte Lisp-Assertions;
58 Objektgleichheit bedeutet dabei natives `EQ`, keine Gleichheit einer
59 nachgebildeten Identitätsstruktur.
60
61 1. `by-id("topic")`, `by-id("topic2")` und der kanonische Owner sind `EQ`.
62 Seine Item-Identifier-Menge besteht genau aus `DocumentIRI#topic`,
63 `DocumentIRI#topic2` und `http://example.org/#topic`. Er hat keine Subject
64 Identifiers oder Subject Locators.
65 2. Der kanonische Theme-Topic besitzt genau `DocumentIRI#theme` als Item
66 Identifier. Der Default-Name-Type besitzt genau den Subject Identifier
67 `http://psi.topicmaps.org/iso13250/model/topic-name`. Weitere Identifier
68 dieser Topics sowie Map-Item-Identifier fehlen. Die vorhandene globale
69 Item-Identifier-Validierung besteht.
70 3. Beide Names bleiben verschieden. Ihre Parent-Topics sind `EQ` mit dem
71 gemeinsamen kanonischen Owner, ihre Types mit dem Default-Name-Type.
72 Beide haben leeren Scope und keine Item Identifier oder Reifier.
73 4. Die Variants bleiben verschieden und sind jeweils `EQ` mit ihrem aktuellen
74 kanonischen Handle. `TOPIC!` gehört zu `Topic`, `TOPIC2!` zu `Topic 2`.
75 Beide behalten den Datentyp
76 `http://www.w3.org/2001/XMLSchema#string` und genau den kanonischen
77 Theme-Topic im Scope. Variant-Parent und zugehöriger Name sind `EQ`.
78 Es entstehen keine Variant-Item-Identifier oder Reifier.
79 5. Eine zusätzliche Handle-Spur liest denselben vollständigen qualifizierten
80 Originalbaum mit den bestehenden Reader-Operationen Topic für Topic.
81 Nach Topic 1 werden Owner-, Name-, Variant- und Theme-Handles festgehalten.
82 Nach Topic 2 ist der alte rohe Owner-Handle vom neuen Owner verschieden;
83 `canonical-topic(old-owner)` ist aber `EQ` mit dem gemeinsamen Owner.
84 Der festgehaltene Name und Variant bleiben unmittelbar `EQ` mit den
85 aktuellen Objekten, der Name-Parent wird auf den gemeinsamen Owner
86 aktualisiert, Variant-Parent und Theme-Referenz bleiben kanonisch.
87 Die beiden Zwischenstände sind im Originalreport enthalten. Das endgültige
88 Modell und die CXTM-Bytes entsprechen denen der öffentlichen API.
89 6. Wiederholte CXTM-Kanonisierung ist deterministisch und verändert keinen
90 nativen Modellzustand. Die Originaloctets bleiben erhalten. Derselbe
91 Document IRI mit Source Key `independent:variant-merge-provenance` ergibt
92 dasselbe vollständige Modell und dieselben CXTM-Bytes. Die aufgelösten
93 Identitäten hängen damit vom Document IRI, nicht vom Source Key ab.
94
95 Die Handle-Spur ist eine zusätzliche Prüfung desselben Originals. Sie wird
96 nicht als weiterer Originalvertrag gezählt. Es wird keine Ersatzmap als
97 Originalvergleich registriert.
98
99 ## Bytevergleich, Registrierung und Fehlerklassifikation
100
101 Tatsächlich erzeugte Ausgabe: **919 Bytes**. Originalbaseline: **919 Bytes**.
102 Der Vergleich sämtlicher Bytes ist erfolgreich, `firstDifferentByte` ist `null`.
103 Die [tatsächliche Ausgabe](../reports/slice-21h/actual/merge-itemid-with-variants.xtm.cxtm)
104 hat denselben oben angegebenen SHA-256-Wert wie die Baseline.
105 Die tatsächliche Condition ist `null`; entsprechend gibt es für diesen
106 positiven Vertrag keinen Fehlercode und keine Fehlerposition.
107
108 Der bestehende ASDF-Testlauf ruft `variant-merge-original-contract` aus
109 `run-tests` tatsächlich auf. Originalvergleich und native Modellprüfungen
110 verwenden den vorhandenen Case Record und dieselbe Ergebnisklassifikation wie
111 die bisherigen Verträge. Es gibt insgesamt genau 57 eindeutige Case Records:
112 49 positive CXTM-Verträge und acht nach Ursache qualifizierte negative
113 Verträge. Alle bisherigen 56 Case Records bleiben unverändert.
114
115 Der XTM-Lauf besteht mit **1414 eindeutigen Prüfungen**, davon **17 neue**.
116 Alle bisherigen 1397 Prüfungsnamen bleiben in ihrer bisherigen relativen
117 Reihenfolge erhalten. Neue Prüfungen sind in
118 [xtm.json](../reports/slice-21h/xtm.json) und
119 [xtm.log](../reports/slice-21h/xtm.log) nachvollziehbar.
120
121 35 isolierte Fehlerkontrollen prüfen die unveränderte Ergebnisklassifikation.
122 Die fünf Kontrollen des neuen Originals erzwingen Byteabweichung, XML-Fehler,
123 Unsupported, TMDM-Fehler und XTM-Syntaxfehler. Der ASDF-Test scheitert jeweils
124 wie erwartet mit Exit 1; keiner dieser Fälle zählt als positiver PASS und die
125 vorherigen 56 PASS bleiben erhalten. Die erwarteten Outcomes sind
126 `cxtm-mismatch`, `execution-error`, `unsupported`, `execution-error` und
127 `execution-error`. Die übrigen 30 Kontrollen bleiben erhalten. Einzelreports,
128 Logs und [failure-controls.json](../reports/slice-21h/failure-controls.json)
129 dokumentieren die tatsächlichen Klassifikationen. Dies sind Testinjektionen,
130 keine zusätzlichen ausgeführten Korpusverträge.
131
132 ## Vollständige Offline-Abnahme
133
134 Die Abnahme lief in frischen **SBCL-2.5.4-Prozessen**, jeweils mit
135 `--no-sysinit --no-userinit`. Für Quellvorbereitung, Tests und Diagnose galt
136 zusätzlich die macOS-Sandboxregel:
137
138 ```text
139 (version 1)(allow default)(deny network*)(deny file-write* (subpath "/Users/rgb/workspace/topic-maps"))
140 ```
141
142 Die vorhandenen gepinnten lokalen Abhängigkeiten und vorhandenen XML-Patches
143 wurden geprüft und in temporären Verzeichnissen verwendet. Es gab keinen
144 Download, keinen Nix-Daemon-Aufruf, keinen vollständigen Nix-Neubau und keinen
145 Zugriff auf langlebige Lisp-Images. Der vollständige Nix-Neubau ist ausdrücklich
146 `NOT-RUN`; ausgeführt wurde die geforderte frische Offline-SBCL-Regression.
147
148 Die reguläre Freigabe über `require_escalated` war erfolgreich. Damit wurde
149 die nicht startfähige Standard-Sandbox wegen ihres symlinkbehafteten Writable
150 Root nicht verändert. Der zuvor beobachtete Startfehler lautet:
151 `writable root /Users/rgb/.nix-profile contains symlink component /Users/rgb/.nix-profile; symlinked writable roots are not supported.`
152 Weder `~/.nix-profile` noch die Sandbox-Konfiguration wurden geändert.
153
154 | Ausgeführter Bereich | Bestandene Prüfungen |
155 | --- | ---: |
156 | Bisherige Lisp-Regression einschließlich TMDM, CTM/CXTM, Include und Mergemap | 12100 |
157 | XTM-Originale, Identität, Names, Scopes, Item Identity, Variants und neuer Originalvertrag | 1414 |
158 | XML-Qualifikation | 146 |
159 | CTM/XTM-Mergemap | 217 |
160 | Slice 20A: registrierte Originale | 286 |
161 | Slice 20B: negative Originale | 25 |
162 | Slice 20C: Prolog | 171 |
163 | Slice 20E: empty2 | 13 |
164 | Slice 20F: CTM-Integer | 112 |
165 | Slice 20G: Triple Strings | 226 |
166 | Slice 20H: Encoding | 722 |
167 | Python-Unit-Tests | 2 |
168 | NFC-Oracle-Vergleiche | 16294 |
169 | Erwartet scheiternde Fehlerkontrollen | 35 |
170
171 Alle 48 übernommenen Nicht-XTM-JSON-Reports sind strukturell identisch mit
172 Slice 21G. Sämtliche 124 separaten Originaldiagnosen bleiben identisch;
173 [diagnostics.json](../reports/slice-21h/diagnostics.json) hält die leere
174 Änderungsliste fest. Diese Diagnoseaufrufe bewirken keine zusätzliche
175 Konformitätsregistrierung.
176
177 Tatsächlich registrierter Abschlussstand nach der Ausführung:
178
179 | Korpus | PASS | FAIL | NOT-RUN |
180 | --- | ---: | ---: | ---: |
181 | XTM | 57 | 0 | 67 |
182 | CTM | 262 | 4 | 7 |
183
184 Die vier bekannten CTM-Abweichungen bleiben unverändert:
185 `include-template.ctm`, `include-wildcard2.ctm`,
186 `occurrence-datetime-timezone2.ctm`, `occurrence-datetime2.ctm`.
187 Die XTM-NOT-RUN-Zahl setzt sich aus 64 positiven und drei negativen
188 unregistrierten Originalverträgen zusammen.
189
190 ## Integrität, Umfang und Reproduktion
191
192 Die Größe und SHA-256 sämtlicher **2006 gepinnter Korpusdateien** entsprechen
193 `references/corpus-lock.json`. Alle **2013 historischen Reportdateien** sowie
194 alle **4259 geschützten Dateien** des Ausgangscommits bleiben unverändert.
195 Die Hashlisten stehen in [integrity.json](../reports/slice-21h/integrity.json).
196 Es gibt keine Produktionscodeänderung. Insbesondere bleiben TMDM, CTM, CXTM,
197 XML und der XTM-Reader byteidentisch zum Ausgangscommit.
198
199 Geändert wurden nur die vorhandenen XTM-Testdateien und die beschreibende
200 ASDF-Testsystem-Zeile. Hinzu kommen dieser Bericht, ein Abnahmeskript und neue
201 Slice-21H-Evidenz. Historische Reports werden ausschließlich gelesen.
202 Das Skript orchestriert die vorhandenen Tests, Case Records und Reports und
203 führt keine zweite Konformitätsprüfung ein.
204
205 Die vollständigen Befehle, Zeitpunkte, erwarteten und tatsächlichen Exitcodes
206 sowie die Abnahmeprüfungen stehen in
207 [execution.json](../reports/slice-21h/execution.json).
208 [precommit-audit.json](../reports/slice-21h/precommit-audit.json) und
209 [artifacts.json](../reports/slice-21h/artifacts.json) sichern den finalen
210 Änderungsumfang und die neuen Artefakte.
211
212 Reproduktion mit einem noch unbenutzten Ausgabeverzeichnis außerhalb des
213 Repositorys:
214
215 ```sh
216 python3 scripts/validate-slice-21h.py --sbcl /nix/store/hlsiblxpxr1hax3dw9x8znd6zy097ddj-sbcl-2.5.4/bin/sbcl --output /private/tmp/topic-maps-21h-recheck
217 ```
218
219 Nach erfolgreicher Abnahme werden Registrierung, Dokumentation und Evidenz
220 zusammen lokal committet. Slice 21H endet damit.