]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-22s-xtm-anytype-integration.md
test: prove CTM/XTM anyType equivalence (slice 22T)
[topic-maps.git] / docs / slice-22s-xtm-anytype-integration.md
1 # Slice 22S — produktive XTM-2.0-anyType-Integration
2
3 ## Ergebnis und Ausgangspunkt
4
5 Basis `c1fa847c85017d4edf5c2439c772d903261e5a12` (22R), Parent
6 `0cb182ebab1b90dd871048c031612acd9d302678`; Index und Arbeitsbaum waren sauber.
7 Neuer Branch `codex/xtm-slice-22s`.
8 [Ausgangszustand und Quellenhashes](../reports/slice-22s/initial-state.json).
9
10 `resourceData` mit `http://www.w3.org/2001/XMLSchema#anyType` wird nun über den
11 produktiven XTM-Reader zu einem kanonischen Unicode-String und anschließend
12 über die bisherigen Konstruktoren zu einer nativen Occurrence oder Variant.
13 Die API `deserialize-octets` bleibt unverändert. Der C14N-Algorithmus und die
14 TMDM-, CTM-, CXTM- sowie XML-Quellen bleiben byteidentisch.
15
16 Normbasis bleibt [XTM §§4.3.1, 4.16.2–4.16.3](https://www.isotopicmaps.org/sam/sam-xtm/)
17 und die [in 22R qualifizierte C14N-1.0-Infrastruktur](slice-22r-xml-resource-c14n.md).
18 **Normativ abgeleitet:** anyType verwendet die kanonische XML-Stringrepräsentation;
19 sonstige textuelle Datentypen erlauben keine Kindelemente. Eingebettetes Markup
20 schließt Elemente im XTM-Namespace auf jeder Tiefe aus. Diese Integration
21 ändert weder Datentyp-IRIs noch native Identitäts-/Gleichheitsregeln.
22 Die unabhängige Prüfung gegen die offiziellen ISO-Ausgaben bleibt ausstehend;
23 Abnahmetore A, B und C werden durch diesen Slice nicht pauschal abgeschlossen.
24
25 ## Integrationsvertrag — vor der Reader-Änderung ausgeführt
26
27 [Vorabnachweis](../reports/slice-22s/integration-preflight.json),
28 [Run mit unverändertem Reader-Hash](../reports/slice-22s/integration-preflight-run.json),
29 [Log](../reports/slice-22s/integration-preflight.log) und
30 [damals ausgeführtes Werkzeug](../reports/slice-22s/integration-preflight.lisp).
31 Der Run fand vor der Reader-Änderung statt: UTF-8, UTF-16LE und UTF-16BE;
32 zwölf unabhängig erwartete indexierte Werte; gemischte Datentypen, mehrere
33 Ressourcen und verschachteltes fremdes `resourceData`.
34 Dieses historische Vorabwerkzeug ist vor Reader-Änderungen auszuführen und
35 wird nicht als erneuter Vorabnachweis des jetzt geänderten Readers ausgegeben.
36
37 **Beobachtet:** Die vorhandene XML-API stellt keine introspektierbare Provenienz
38 des opaken Kontexts bereit. Gleiche Anzahl allein genügt deshalb nicht.
39 **Durch Konstruktion gesichert und ausführbar geprüft:** Ein Kontext wird
40 innerhalb eines privaten Dokumentrahmens ausschließlich aus dessen ursprünglichen
41 Octets erzeugt; der Reader nimmt keinen von außen gelieferten Kontext entgegen.
42 Die Kopie wird vor dem ersten Parsing angelegt. Der bisherige SAX-Einstieg
43 bekommt weiterhin das Originalvector-Objekt; die C14N-Anbindung dessen bytegleichen
44 Snapshot. Die Bytes müssen vor/nach der Kontextvorbereitung und bei der
45 Wertübernahme unverändert übereinstimmen.
46
47 Beide Inventare verwenden denselben erweiterten Namen (XTM-Namespace plus
48 `resourceData`) und vollständige Präorder im Originaldokument. **Alle**
49 `resourceData`-Elemente zählen, auch andere Datentypen; fremde lokale Namen
50 zählen nicht. Fremde Unterbäume werden bei der Inventur nicht übersprungen.
51 Die Inventarlängen müssen identisch sein. Jeder tatsächliche Source-Node
52 gehört per `EQ` genau einem dokumentlokalen Ordinalplatz; Tabellen-Lookup und
53 Node-Vektor werden gegengeprüft. Document IRI und diagnostischer Source Key
54 müssen zum aktuellen Rahmen passen. Der Source Key erzeugt keine Modellidentität.
55
56 Die definierten Namespace-/Präorder-Verträge beider vorhandener APIs werden
57 verwendet; der Reader liest weder private DOM-Felder noch konstruiert er XML neu.
58 Der opake Kontext bleibt während der gesamten Kanonisierung erhalten. Alle
59 anyType-Werte werden vor den weiteren Modelloperationen vorbereitet und danach über die
60 geprüften Source-Node-Bindungen übernommen. Der Kontext wird nicht in TMDM-Items
61 abgelegt. Separate `mergeMap`-Deserialisierungen besitzen eigene Rahmen und
62 Child-Document-IRIs; dynamische Bindung stellt den Parent-Rahmen anschließend wieder her.
63
64 Die Runtime-Gegenproben beschädigen Index, Ownership, Frame, Document IRI,
65 Octets oder Inventaranzahl. Sämtliche sechs Abweichungen werden sicher
66 zurückgewiesen. Der Fremdrahmentest benutzt sogar dieselben Bytes und denselben
67 Dokumentkontext, aber andere Source-Node-Objekte; gleiche Anzahl ist kein Ersatz
68 für `EQ`-Ownership.
69
70 ## Produktiver Datenfluss und Grenzen
71
72 [Reader](../src/xtm/reader.lisp):
73
74 1. `deserialize-document` erhält Originalbytes, Doc IRI, Source Key und einen lokalen Snapshot.
75 2. Die vorhandene XML-Bytegrenze baut den bisherigen SAX-Source-Tree; `validate-source` prüft die XTM-Struktur.
76 3. `prepare-xml-resources` erzeugt nur bei anyType den privaten XML-Kontext, inventarisiert und kanonisiert.
77 4. `read-resource-value` übernimmt für anyType den geprüften String und unveränderten Datentyp.
78 5. `read-occurrence`/`read-variant` verwenden weiterhin die bestehenden Konstruktoren, Identifier-, Reifier- und Normalisierungsoperationen.
79 6. CXTM serialisiert das unveränderte native Modell deterministisch.
80
81 Keine zweite Modell- oder Kanonisierungsimplementierung. `xsd:string`,
82 `xsd:anyURI`, andere absolute Datentypen und `resourceRef` behalten ihre bisherigen
83 Pfade. Gewöhnliche Dokumente ohne anyType benötigen keinen zusätzlichen DOM-Parse.
84 Die bisherigen Bytegrenzen-Prüfungen (ein Aufruf und Originaloctets per `EQ`)
85 bleiben erhalten. DOCTYPE-Verbot, verweigerte externe Ressourcen und der
86 qualifizierte XML-Parser bleiben verbindlich.
87
88 Neue Diagnosen: `XTM-REJECTION/:embedded-xtm-element` für XTM-Elemente im
89 Markup; `XTM-XML-ERROR/:relative-namespace-uri` mit originaler
90 `CANONICALIZATION-ERROR`-Cause; `XTM-XML-ERROR/:resource-data-association` für
91 beschädigte interne Zuordnung. Die beiden letzten Diagnosen haben keine erfundenen
92 nativen Zeilen-/Spaltenpositionen. Sonstige XML-, Syntax- und native TMDM-Conditions
93 behalten ihre bisherigen Wege. Eine Zuordnungsstörung wird nicht als normative
94 Ungültigkeit des Originaldokuments behauptet.
95
96 ## Dauerhafte Reader- und Modellbelege
97
98 [ASDF-Tests](../tests/xtm-anytype.lisp), registriert im vorhandenen
99 [System](../topic-maps.asd) und aufgerufen durch
100 [run-tests](../tests/xtm-identity.lisp).
101
102 23 positive vollständige XTM-Dokumente verwenden tatsächliche Original-Octets
103 und feste, von der neuen Reader-Ausgabe unabhängige Sollwerte:
104 16 unveränderte 22Q-Inhalte über den produktiven Reader; Unicode in drei
105 Encodings; gemischte Ressourcen/Datentypen inklusive `resourceRef`, leere Werte
106 und reiner Text; Occurrence-/Variant-Identifier und Reification; native
107 Duplikatnormalisierung lexikalisch verschiedener XML-Schreibweisen; Parent und
108 UTF-16-Kindressource mit verschiedenen Namespace-Bindungen und gleichem Source Key.
109
110 Jede Probe prüft erwartete native Werte/Datentypen, Parent/Type/Scope/Reifier,
111 kanonische EQ-Referenzen, unveränderte Originalbytes, Source-Key-Unabhängigkeit
112 und wiederholte modellunverändernde CXTM-Ausgabe. Der vorhandene vollständige
113 `occurrence-model`-Bericht enthält auch die vorhandenen Name-/Variant-/Reifier-
114 Beziehungen. Native Referenznummern bezeichnen die dortige Topic-Reihenfolge,
115 keine neu eingeführte Objektidentität oder CXTM-Nummerierung.
116
117 Bei XML-gleichen Occurrences vereinigt die bestehende TMDM-Normalisierung die
118 Identifier `urn:first` und `urn:second`. Die Metadatenprobe prüft getrennt
119 Occurrence `urn:o` und Variant `urn:v`, ihre Eltern, Typen, Scopes und inversen
120 Reifier-Beziehungen. Die Child-Probe prüft die exakten Resolverargumente und
121 Child-Document-IRI, nicht nur gleiche Werte.
122
123 17 negative Proben prüfen malformed XML, nicht gebundene Prefixe, relative
124 Namespace-URIs, DOCTYPE/externe Entity, fremdes XML außerhalb des Markups,
125 XTM-Elemente tief im Markup, verbotene Kindelemente bei vier anderen Datentypen
126 und die sechs beschädigten Zuordnungen.
127
128 [Vollständige Probe-Octets, Soll-/Istwerte, native Modellzustände, Conditions und CXTM-Hex](../reports/slice-22s/after/xtm.json),
129 Feld `anyTypeReader`. Die 44 Byteprüfungen und 41 nativen Werte aus 22R sind
130 unverändert enthalten. `resourceDataC14N` und `c14nPreflight` behalten ihre
131 komponentenbezogenen Herkunftsfelder; die aktuelle Reader-Unterstützung ist
132 separat in `anyTypeReader.XTMReaderAnyTypeIntegration` belegt. Die acht Fehler
133 des alten CXML-Kandidaten bleiben historische Charakterisierung.
134
135 ## Unsupported-Kontrollen: ausdrückliche Retargetings
136
137 Die alten Quellen dürfen nicht weiter fälschlich als fehlende anyType-Fähigkeit
138 gelten. Die bestehenden Kontrollhelfer ergänzen bei den ausdrücklich umgestellten
139 Erwartungen ein gültiges `mergeMap` vor den lokalen Inhalten:
140 fehlender expliziter Resolver bzw. bei zwei bereits mit Resolver gelesenen
141 Kindressourcen ein unmittelbarer Selbstverweis unter der bestehenden Zyklusschutz-Policy.
142 Dies ist keine neue Zyklussemantik. Die ursprüngliche Aufgabe der Kontrollen —
143 reale Unsupported-Ausgänge, Diagnostik und Nicht-PASS-Klassifikation — bleibt erhalten.
144
145 36 ursprüngliche vollständige anyType-Quellen werden zusätzlich **ohne** diese
146 Policy-Auslöser über den produktiven Reader erneut ausgeführt. Alle werden
147 jetzt erfolgreich gelesen; native Werte und vollständiges CXTM sind gespeichert.
148 Historische Labels wie `anyType-still-Unsupported` bleiben zur Nachverfolgung
149 erhalten und beschreiben ausdrücklich keine aktuelle Fähigkeitsgrenze.
150
151 [Alle Vorher-/Nachher-Quellen, Conditions, Positionsänderungen und Replays](../reports/slice-22s/after/retargetings.json).
152 Die geänderten regulären Berichtszeilen verteilen sich wie folgt:
153
154 | Vorhandenes Berichtsfeld | Geänderte Kontrollzeilen |
155 | --- | ---: |
156 | negativeControls | 1 |
157 | nameControls | 2 |
158 | scopeControls | 3 |
159 | nameItemIdentityControls | 2 |
160 | variantControls | 5 |
161 | variantResourceDataURIControls | 2 |
162 | variantItemIdentityControls | 2 |
163 | mapReifierControls | 3 |
164 | nameReifierControls | 1 |
165 | variantReifierControls | 1 |
166 | datatypeControls | 3 |
167 | mergemapControls | 2 |
168 | occurrenceControls | 4 |
169 | roleReifierControls | 1 |
170 | occurrenceReifierControls | 1 |
171 | itemIdentityControls | 1 |
172
173 Die zwei CTM/XTM-Mergemap-Kindressourcen wurden ebenfalls ausdrücklich retargetet.
174 Deren gespeicherter Integrationsbericht ändert genau zwei Code-Felder:
175 `RESOURCE-DATA-DATATYPE` → `RESOURCE-RESOLVER-REQUIRED`; äußere Conditions,
176 Prüfzwecke und übrige Belege bleiben erhalten. Keine CTM-Produktionsänderung.
177
178 Die historische [22D-Fehlersteuerung](../reports/slice-22d/failure-controls.lisp)
179 bleibt unverändert. Die [22S-Kopie](../reports/slice-22s/failure-controls.lisp)
180 ändert ausschließlich den Kommentar und die reale Unsupported-Fixture zu einem
181 unaufgelösten `mergeMap`. Alle 113 Ziel-/Moduskombinationen und ihre erwarteten
182 Fehlerausgänge bleiben erhalten. Falsche Originalausgaben, XML-/XTM-/TMDM-Fehler,
183 Unsupported und falsche negative Ursachen werden weiterhin auseinandergehalten.
184
185 ## Vollständige Offline-Abnahme und Integrität
186
187 [Ausführung](../reports/slice-22s/after/execution.json),
188 [Kommandos/Zeiten/Loghashes](../reports/slice-22s/after/runs.json),
189 [113 Fehlerkontrollen](../reports/slice-22s/after/failure-controls-audit.json).
190 Frische Prozesse in SBCL 2.5.4 ohne Benutzer-/Systeminitialisierung;
191 `sandbox-exec` verbietet Netzwerk und Repository-Schreibzugriffe einschließlich HyperDoc.
192 Sieben vorhandene lokale Pins und bestehende Encoding-Patches, keine Downloads
193 oder neuen Abhängigkeiten. Der vorhandene Collector und ASDF-Executor werden wiederverwendet.
194
195 Der endgültige reguläre XTM-Lauf besteht mit **4.327 Checks**:
196 4.123 erhaltene Check-Labels und 204 neue. Alle 119 erwarteten Prozessausgänge,
197 darunter 113 erwartete Executor-Fehler, sind eingetreten. Diese Fehlerkontrollen
198 werden nicht als erfolgreiche Originalverträge gezählt. Erhalten: 12.100
199 Kernchecks, 146 XML-Checks, sämtliche Slice-20-/22-Prüfungen, CTM/XTM- und
200 XTM-Mergemap, 30 Äquivalenzpaare mit 529 Checks und drei Kontrasten, zwei Python-
201 Tests und 16.294 NFC-Oracle-Vergleiche. Keine neue Äquivalenzprobe wird abgeleitet.
202
203 Die 124 Originaldiagnosen und alle 121 bisherigen XTM-PASS bleiben unverändert.
204 Die drei offenen XTM-Dispositionen aus [22O](slice-22o-qualified-xtm-corpus-disposition.md)
205 und die vier bekannten CTM-FAILs werden nicht umregistriert.
206
207 | Korpus | PASS | FAIL | NOT-RUN |
208 | --- | ---: | ---: | ---: |
209 | XTM 2.0 | 121 | 0 | 3 |
210 | CTM | 262 | 4 | 7 |
211
212 [Integritätsaudit](../reports/slice-22s/after/integrity.json): **11.245** geschützte
213 Basisdateien, darunter 2006 Korpusdateien und 8947 historische
214 Reportdateien. 45 erneut erzeugte Teilberichte sind byteidentisch; ausschließlich
215 der oben erläuterte CTM/XTM-Kontrollbericht besitzt zwei retargetete Codes.
216 C14N-, XML-, TMDM-, CTM- und CXTM-Quellen, Originale und Baselines bleiben unverändert.
217
218 ```sh
219 python3 reports/slice-22s/reproduce.py --output /private/tmp/topic-maps-22s-new
220 python3 reports/slice-22s/reproduce.py --output /private/tmp/topic-maps-22s-new --audit-only
221 ```
222
223 `--audit-only` prüft gespeicherte Ausführung und zählt nicht als neuer Testlauf.
224 Die beiden fehlgeschlagenen Entwicklungsanläufe (Testklammer und zunächst
225 unvollständiges Kindressourcen-Retargeting) sowie der korrigierte Audit-Formatfehler
226 sind getrennt unter `reports/slice-22s/attempts/` belegt. Ein erster Gesamtlauf war
227 erfolgreich, wurde aber nach der zusätzlichen Präzisierung der nativen Parent-/
228 Type-/Scope-/Reifier-Belege vollständig mit den endgültigen Quellen wiederholt.
229 Der Abschlussaudit bezieht sich ausschließlich auf diesen letzten Lauf.
230
231 Keine Erweiterung des XML-Profils oder der Zyklussemantik, keine Änderung
232 langlebiger Images, kein Push/Deployment und keine HyperDoc-Arbeit. Nach dem
233 lokalen Commit endet Slice 22S; kein automatischer Folgeauftrag.