]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-21j-xtm-variant-uri-data.md
Support arbitrary absolute XTM resourceData datatypes (Slice 22D)
[topic-maps.git] / docs / slice-21j-xtm-variant-uri-data.md
1 # Slice 21J — Variant ResourceData mit xsd:anyURI
2
3 ## Ausgangszustand und Norm
4
5 Branch: `codex/xtm-slice-21j`. Ausgangscommit und vorgesehener Parent:
6 `4d7adecb3c2d5df90579aa37dfa41128988cb56c`.
7 Der vorgefundene Branch war `codex/xtm-slice-21i`; Index und Arbeitsbaum waren
8 sauber. [initial-state.json](../reports/slice-21j/initial-state.json) sichert den
9 Zustand und die SHA-256-Werte aller ursprünglich versionierten Dateien.
10
11 Vor jeder Reader-Änderung reproduzierte ein frischer SBCL-Prozess alle 1557
12 XTM-Prüfungen und sämtliche 124 Originaldiagnosen. Der registrierte
13 Ausgangsstand ist **XTM 59 PASS, 0 FAIL, 65 NOT-RUN** und
14 **CTM 262 PASS, 4 FAIL, 7 NOT-RUN**. Die Ausgaben entsprechen Slice 21I.
15 Siehe [baseline.log](../reports/slice-21j/baseline.log),
16 [baseline-xtm.json](../reports/slice-21j/baseline-xtm.json) und
17 [before-diagnostics.json](../reports/slice-21j/before-diagnostics.json).
18
19 Normativ hergeleitet aus
20 [XTM 2.0 §§4.3.4 und 4.16.1–4.16.2](https://www.isotopicmaps.org/sam/sam-xtm/):
21 Der textuelle `resourceData`-Inhalt mit Datentyp `xsd:anyURI` wird über die
22 XTM-Prozent-/UTF-8-Dekodierung und Auflösung gegen die Document IRI zum absoluten
23 Locator. Kindelemente sind dabei ein Fehler. Das `datatype`-Attribut bezeichnet
24 selbst eine absolute IRI und wird als Datentyp übernommen. Ohne Datentyp sowie
25 mit `xsd:string` bleibt der Textwert erhalten. §§4.12–4.13 und
26 [TMDM §5.5](https://www.isotopicmaps.org/sam/sam-model/2006-06-18/) bestimmen
27 Parent, Scope-Vereinigung, echte Obermengenbedingung und Variant-Gleichheit.
28 Die folgenden Befunde sind tatsächliche Ausführungsergebnisse.
29
30 ## Begrenzte Reader-Erweiterung
31
32 Nur `src/xtm/reader.lisp` enthält Produktionsänderungen:
33
34 - `validate-source` akzeptiert nun textuelles `resourceData` mit `xsd:anyURI`.
35 Das Datentypattribut wird mit den vorhandenen Scheme-/IRI-Prüfungen als
36 absolute IRI validiert; es wird weder relativ aufgelöst noch als gespeicherter
37 Datentyp umgeschrieben. Relative oder ungültige Datentypattribute werden
38 zurückgewiesen. Andere gültige, nicht unterstützte Datentypen bleiben
39 `XTM-UNSUPPORTED/:resource-data-datatype`.
40 - Alle XML-Kindelemente unter anyURI-`resourceData` ergeben
41 `XTM-REJECTION/:unexpected-child`, einschließlich fremder Namespaces.
42 - `read-variant` sammelt die XML-Zeicheninformationen unverändert und ruft für
43 anyURI-Text den vorhandenen XTM-`resolve-iri` auf. Der absolute Wert und
44 `iri-datatype` gehen an das bestehende `add-variant`. Es gibt keine
45 zusätzliche Whitespace-Bereinigung und keine zweite IRI-Implementierung.
46 - Der `resourceRef`-Pfad bleibt `leaf-href` mit demselben Resolver. Der
47 textuelle String-Pfad, Scope-Vereinigung, Normalisierung und kanonische
48 Handles bleiben bestehen. Ressourcen werden nicht abgerufen.
49
50 TMDM, CTM, CXTM, XML und deren Produktionsdateien sind unverändert.
51 Weitere Datentypen, `xsd:anyType`/XML-Kanonisierung, Variant-Item-Identifier,
52 Reification, Occurrences, explizite Associations/Roles, XTM-`mergeMap` und
53 XTM 2.1 wurden nicht implementiert.
54
55 ## Unveränderter Originalvertrag
56
57 Einziger neu registrierter Originalvertrag:
58 [variant-resourcedata-uri.xtm](../vendor/cxtm/xtm2/in/variant-resourcedata-uri.xtm).
59 Die vollständige Originalquelle hat **405 Bytes**, SHA-256
60 `9bfd355a4f3f4a8c5a1d9ca7af842e1f9330d10f0b0a3be6b4606f614b2c8ba0`. Der tatsächliche Inhalt lautet
61 `http://example.org/command.wav`; das tatsächliche Datentypattribut ist
62 `http://www.w3.org/2001/XMLSchema#anyURI`. Der Zeilenumbruch vor dem schließenden
63 Starttag gehört zur Attributdarstellung, nicht zum Ressourceninhalt.
64
65 Document IRI:
66 `https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/xtm2/in/variant-resourcedata-uri.xtm`.
67 Source Key: `xtm2/in/variant-resourcedata-uri.xtm`.
68 Die unveränderten Rohbytes werden durch `topic-maps.xtm:deserialize-octets` und
69 den qualifizierten XML-Parser verarbeitet. Es ist keine weitere Sprachfähigkeit
70 für dieses Original nötig.
71
72 Das tatsächliche TMDM-Modell hat drei Topics, keine Associations, einen Name
73 `Topic` am Owner `DocumentIRI#topic` und genau einen Variant:
74
75 - Absoluter Value: **`http://example.org/command.wav`**.
76 - Datatype: **`http://www.w3.org/2001/XMLSchema#anyURI`**.
77 - Parent ist per `EQ` genau der tatsächliche kanonische Name. Name-Parent und
78 Owner sind `EQ`; Name und Variant sind jeweils ihre kanonischen Handles.
79 - Name-Scope: leer. Variant-Scope: genau der kanonische `DocumentIRI#command`-
80 Topic, per `EQ` geprüft. Der Default-Name-Type besitzt seinen vorgesehenen SI.
81 - Keine zusätzlichen Ressourcen-Topics, Subject Locators, Subject Identifier
82 oder Item Identifier entstehen. Owner und Theme behalten ausschließlich
83 ihre dokumentbezogenen Item Identifier. Name und Variant haben keine Item
84 Identifier oder Reifier.
85
86 Die Originalbaseline hat **621 Bytes**. Tatsächlich erzeugt und vollständig
87 verglichen wurden **621/621 identische Bytes**, einschließlich abschließendem
88 LF. `firstDifferentByte` und tatsächliche Condition sind `null`.
89 Die [tatsächliche CXTM-Ausgabe](../reports/slice-21j/actual/variant-resourcedata-uri.xtm.cxtm)
90 und die [Originalbaseline](../vendor/cxtm/xtm2/baseline/variant-resourcedata-uri.xtm.cxtm)
91 haben beide SHA-256:
92
93 ```text
94 d4df2bef650becff7918ee85af338631c87a4309ad65e64a26ee93edbb42a8bb
95 ```
96
97 Die Kanonisierung ist deterministisch und verändert das native Modell oder die
98 Rohbytes nicht. Ein anderer Source Key bei gleicher Document IRI erzeugt
99 dasselbe Modell und dieselben CXTM-Bytes.
100
101 [variant-uri-data-original.json](../reports/slice-21j/variant-uri-data-original.json)
102 enthält alle Originalbytes als Hex und Text, vollständige Ist-/Soll-CXTM-Texte,
103 Hashes, Document IRI, Condition und tatsächliches Modell.
104 Der vorhandene Case-Record-Executor klassifiziert nach Deserialisierung und
105 nativen Modellprüfungen den vollständigen Bytevergleich. Das Original wird im
106 regulären ASDF-Testlauf genau einmal ausgeführt und als `cxtm-match`/PASS
107 registriert. Es gibt insgesamt 60 eindeutige Case Records: 52 positive und acht
108 ursachenqualifizierte negative Originalverträge. Die bisherigen 59 Ergebnisse
109 sind unverändert.
110
111 ## ResourceData-/ResourceRef-Äquivalenz und native Gegenproben
112
113 Die synthetische Gegenprobe verwendet dieselbe Document IRI, denselben Name-
114 Scope `base`, denselben expliziten Scope `extra` und den Locatorinhalt
115 `relative-resource.wav` in beiden XML-Formen. Beide erzeugen denselben
116 absoluten Value:
117
118 ```text
119 https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/xtm2/in/relative-resource.wav
120 ```
121
122 Das vollständige native Modell, `xsd:anyURI`, der vereinigte Scope und CXTM
123 sind gleich. Bei beiden XML-Formen gemeinsam entsteht durch Normalisierung
124 nur ein Variant; es bleiben vier Topics ohne zusätzliche Ressourcenidentität.
125 Eine weitere schrittweise Gegenprobe vereinigt zwei Parent-Topics über ihren
126 Item Identifier und prüft erhaltene Name-/Variant-Handles beider Formen mit
127 `canonical-topic-name`, `canonical-variant` und `EQ`.
128 Diese synthetischen Gegenproben zählen nicht als Originalverträge.
129
130 Die **58 neuen protokollierten Kontrollen** umfassen 14 positive XTM-Eingaben,
131 zehn schrittweise native Handle-Prüfungen, eine explizite Äquivalenzprüfung und
132 33 Fehler-/Unsupported-/Atomaritätsprüfungen. Sie decken absolute und relative
133 IRIs, Fragmente, leere Referenzen, Unicode, UTF-8-Prozentkodierung, reservierte
134 Zeichen, XML-Escaping, andere Document IRI, Datei-/Netzlocators ohne Abruf und
135 die Trennung von Ressourcenwerten und Topic-SI/SL/II ab.
136
137 Doppelte Variants normalisieren; unterschiedliche Values, Datatypes oder
138 Scopes bleiben getrennt. Scope-Vererbung, Forward References und alle neun
139 Kombinationen von Parent-/Name-Scope-/Variant-Scope-Merging mit SI/SL/II
140 behalten kanonische Parent-, Name-, Variant- und Theme-Referenzen. Drei native
141 Gegenproben belegen atomare Zurückweisung von Scope-Kollapsen ohne Änderung
142 vorhandener Zustände oder Handles. Ein Parse-Zähler belegt, dass eine externe
143 XML-Ressource nicht rekursiv deserialisiert wird. Auch ein nicht vorhandener
144 `file:`-Locator wird nur als Wert verarbeitet.
145
146 Die früheren `resourceRef`-Original- und Kontrollreports bleiben vollständig
147 identisch. Alle bisherigen XTM-Prüfungen bleiben in ihrer relativen Reihenfolge
148 erhalten; lediglich zwei Labels der umgestellten Unsupported-Gegenprobe
149 wurden umbenannt. Der reguläre Lauf besteht mit **1713
150 Prüfungen**, davon **156 neue** zusätzlich zu den bisherigen 1557.
151
152 ## Tatsächliche Conditions und Syntaxgrenzen
153
154 Die folgende Tabelle stammt aus `variantResourceDataURIControls` in
155 [xtm.json](../reports/slice-21j/xtm.json). Die vollständigen Eingaben, Kontexte
156 und Causes sind dort erhalten. SAX-Zeilen/Spalten sind ungefähre
157 Zeichenpositionen; native TMDM-Conditions besitzen keine Quellposition.
158
159 | Gegenprobe | Condition | Fehlercode | Zeile:Spalte |
160 | --- | --- | --- | --- |
161 | `invalid-iri` | `XTM-REJECTION` | `invalid-iri` | 1:209 |
162 | `leading-space-not-trimmed` | `XTM-REJECTION` | `invalid-iri` | 1:209 |
163 | `trailing-space-not-trimmed` | `XTM-REJECTION` | `invalid-iri` | 1:209 |
164 | `tab-not-trimmed` | `XTM-REJECTION` | `invalid-iri` | 1:209 |
165 | `invalid-decoded-iri` | `XTM-REJECTION` | `invalid-iri` | 1:209 |
166 | `invalid-relative-iri` | `XTM-REJECTION` | `invalid-iri` | 1:209 |
167 | `percent-short` | `XTM-REJECTION` | `invalid-percent-escape` | 1:209 |
168 | `percent-hex` | `XTM-REJECTION` | `invalid-percent-escape` | 1:209 |
169 | `percent-incomplete-utf8` | `XTM-REJECTION` | `invalid-percent-utf8` | 1:209 |
170 | `percent-overlong-utf8` | `XTM-REJECTION` | `invalid-percent-utf8` | 1:209 |
171 | `percent-surrogate` | `XTM-REJECTION` | `invalid-percent-utf8` | 1:209 |
172 | `extra-attribute` | `XTM-REJECTION` | `unexpected-attribute` | 1:221 |
173 | `relative-datatype` | `XTM-REJECTION` | `invalid-resource-data-datatype` | 1:178 |
174 | `empty-datatype` | `XTM-REJECTION` | `invalid-resource-data-datatype` | 1:170 |
175 | `invalid-datatype-scheme` | `XTM-REJECTION` | `invalid-resource-data-datatype` | 1:183 |
176 | `invalid-datatype-IRI` | `XTM-REJECTION` | `invalid-iri` | 1:186 |
177 | `invalid-datatype-percent` | `XTM-REJECTION` | `invalid-percent-escape` | 1:178 |
178 | `foreign-child` | `XTM-REJECTION` | `unexpected-child` | 1:232 |
179 | `XTM-child` | `XTM-REJECTION` | `unexpected-child` | 1:216 |
180 | `mixed-resources` | `XTM-REJECTION` | `variant-resource-cardinality` | 1:256 |
181 | `multiple-data` | `XTM-REJECTION` | `variant-resource-cardinality` | 1:294 |
182 | `wrong-order` | `XTM-REJECTION` | `missing-variant-scope` | 1:173 |
183 | `scope-after-resource` | `XTM-REJECTION` | `element-order` | 1:236 |
184 | `integer-still-unsupported` | `XTM-UNSUPPORTED` | `resource-data-datatype` | 1:210 |
185 | `anyType-still-unsupported` | `XTM-UNSUPPORTED` | `resource-data-datatype` | 1:210 |
186 | `equal-scope` | `VARIANT-ERROR` | `invalid-variant-scope` | nicht vorhanden (TMDM) |
187 | `duplicate-scope-no-new-theme` | `VARIANT-ERROR` | `invalid-variant-scope` | nicht vorhanden (TMDM) |
188 | `SI-alias-adds-no-theme` | `VARIANT-ERROR` | `invalid-variant-scope` | nicht vorhanden (TMDM) |
189 | `forward-merge-collapses-proper-scope` | `VARIANT-ERROR` | `variant-scope-collapse` | nicht vorhanden (TMDM) |
190 | `invalid-raw-UTF8` | `XTM-XML-ERROR` | `xml-not-well-formed` | 1:7 |
191 | `collapse-SUBJECT-IDENTIFIER` | `VARIANT-ERROR` | `variant-scope-collapse` | nicht vorhanden (TMDM) |
192 | `collapse-SUBJECT-LOCATOR` | `VARIANT-ERROR` | `variant-scope-collapse` | nicht vorhanden (TMDM) |
193 | `collapse-ITEM-IDENTIFIER` | `VARIANT-ERROR` | `variant-scope-collapse` | nicht vorhanden (TMDM) |
194
195 Die rohe UTF-8-Fehleingabe bewahrt die XML-Cause
196 `WELL-FORMEDNESS-VIOLATION` zum ungültigen Startbyte `11111111`.
197 Beide anyURI-XML-Kindfälle erreichen ausdrücklich Syntaxfehler und kein
198 Unsupported. Gültiges `xsd:integer` mit Wert `42` und `xsd:anyType` mit fremdem
199 XML bleiben spezifisch Unsupported. Führende, folgende und eingebettete
200 Whitespace-Zeichen werden nicht stillschweigend entfernt. Die Tests bewahren
201 die Trennung von Syntaxfehlern, XML-Fehlern, Unsupported und TMDM-Conditions.
202
203 ## Umgestellte Unsupported-Fixtures
204
205 Vorhandene Fixtures mit inzwischen unterstütztem anyURI-Inhalt wurden durch
206 gültiges `xsd:integer` mit lexikalischem Wert `42` ersetzt. Klasse und Code
207 bleiben `XTM-UNSUPPORTED/:resource-data-datatype`. Dies betrifft die
208 Klassifikationskontrollen, die Unsupported-Gegenproben für Names, Scope, Item
209 Identity und Variants sowie die entsprechende Testeingabe im CTM/XTM-Adapter.
210 Nur Tests wurden dabei angepasst; kein CTM-Produktionscode änderte sich.
211
212 Fünf vorhandene XTM-Kontrollzeilen erhalten neue Fixture-Eingaben und passende
213 Positionen; eine weitere Zeile zum unverändert ausgeschlossenen Datentyp
214 `urn:other` ändert ausschließlich die präzisierte Unsupported-Meldung.
215 Die Labels `variant-syntax:resourceData-anyURI:class-code` und
216 `variant-syntax:resourceData-anyURI:context-position` heißen jetzt entsprechend
217 `resourceData-integer`. Alle anderen alten Kontrollzeilen sind unverändert.
218 Die 48 übernommenen Nicht-XTM-Reports sind strukturell identisch zu Slice 21I.
219
220 ## Vollständiger Diagnosevergleich aller 124 Originale
221
222 Es ändern sich genau zwei Beobachtungen:
223
224 1. `xtm2/in/variant-resourcedata-uri.xtm`: zuvor
225 `XTM-UNSUPPORTED/:resource-data-datatype`, Position **10:24**; danach keine
226 Condition und vollständiger 621-Byte-CXTM-Vergleich bestanden. Nur dieses
227 Original wird neu registriert.
228 2. `xtm2/in/variant-datatype-unknown.xtm`: weiterhin
229 `XTM-UNSUPPORTED/:resource-data-datatype`, Position **9:59**. Nur `detail`
230 und der entsprechende Meldungsteil nennen nun `xsd:string` und
231 `xsd:anyURI` als implementierte Datentypen. Klasse, Code, Position,
232 Ablehnung und NOT-RUN-Registrierung bleiben unverändert.
233
234 Die übrigen **122 vollständigen Beobachtungen sind identisch**.
235 [diagnostic-changes.json](../reports/slice-21j/diagnostic-changes.json) enthält
236 beide vollständigen Vorher-/Nachher-Beobachtungen mit konkreter Ursache.
237 Aus Diagnoseerfolgen wird kein weiterer Originalvertrag registriert.
238
239 ## Vollständige Offline-Abnahme
240
241 Alle Testprozesse laufen in frischem **SBCL 2.5.4** ohne System-/Benutzerinit.
242 Die bereits gepinnten lokalen Abhängigkeiten und vorhandenen XML-Patches werden
243 geprüft und temporär verwendet. Für Quellvorbereitung, Tests und Diagnose gilt
244 zusätzlich:
245
246 ```text
247 (version 1)(allow default)(deny network*)(deny file-write* (subpath "/Users/rgb/workspace/topic-maps"))
248 ```
249
250 Die reguläre `require_escalated`-Freigabe war erfolgreich. Die Konfiguration
251 und `~/.nix-profile` wurden nicht verändert. Es gibt keine neuen Downloads,
252 keinen Zugriff auf langlebige Lisp-Images und keinen vollständigen Nix-Neubau.
253 Letzterer ist ausdrücklich NOT-RUN; die frische Offline-SBCL-Regression wurde
254 vollständig ausgeführt.
255
256 | Bereich | Bestandene Prüfungen |
257 | --- | ---: |
258 | Bisherige Lisp-Regression einschließlich TMDM, CTM/CXTM, Include und Mergemap | 12100 |
259 | XTM einschließlich aller bisherigen und des neuen Originals | 1713 |
260 | XML-Qualifikation | 146 |
261 | XTM-MERGEMAP | 217 |
262 | REGISTERED-ORIGINALS | 286 |
263 | REGISTERED-NEGATIVES | 25 |
264 | PROLOG | 171 |
265 | EMPTY2 | 13 |
266 | CTM-INTEGER | 112 |
267 | TRIPLE | 226 |
268 | ENCODING | 722 |
269 | Python-Unittests | 2 |
270 | NFC-Oracle-Vergleiche | 16294 |
271 | Isolierte, erwartet scheiternde Executor-Kontrollen | 50 |
272
273 Die **50 Executor-Kontrollen** erhalten die bisherigen 45 Fehlerpfade und
274 fügen für das neue Original Byteabweichung, XML-Fehler, Unsupported, TMDM-Fehler
275 und eine falsche XTM-Condition hinzu. Alle erzeugen den erwarteten ASDF-Exit 1;
276 keine dieser Injektionen zählt als positiver PASS. Die zuvor registrierten
277 Originalergebnisse bleiben jeweils erhalten. Siehe
278 [failure-controls.json](../reports/slice-21j/failure-controls.json) und die
279 zugehörigen Logs und Einzelreports.
280
281 Nach tatsächlicher erfolgreicher Ausführung lautet der registrierte Stand:
282
283 | Korpus | PASS | FAIL | NOT-RUN |
284 | --- | ---: | ---: | ---: |
285 | XTM | 60 | 0 | 64 |
286 | CTM | 262 | 4 | 7 |
287
288 Die XTM-NOT-RUN-Zahl umfasst 61 positive und drei negative offene Originale.
289 Die vier bekannten CTM-FAILs bleiben unverändert: `include-template.ctm`,
290 `include-wildcard2.ctm`, `occurrence-datetime-timezone2.ctm` und
291 `occurrence-datetime2.ctm`.
292
293 ## Integrität und Reproduktion
294
295 Alle **2006 gepinnten Korpusdateien** entsprechen
296 weiterhin in Größe und SHA-256 `references/corpus-lock.json`.
297 Alle **2319 historischen Reportdateien** und
298 **4564 geschützten Dateien** des Ausgangscommits
299 bleiben byteidentisch. Die Hashlisten sowie alle geprüften Ausführungsquellen
300 stehen in [integrity.json](../reports/slice-21j/integrity.json).
301
302 [execution.json](../reports/slice-21j/execution.json) enthält sämtliche Befehle,
303 UTC-Zeitpunkte, erwarteten und tatsächlichen Exitcodes sowie die registrierten
304 Stände. [precommit-audit.json](../reports/slice-21j/precommit-audit.json) sichert
305 den finalen Änderungsumfang;
306 [artifacts.json](../reports/slice-21j/artifacts.json) enthält Größen und
307 SHA-256-Werte aller neuen Artefakte.
308
309 Reproduktion mit unbenutztem Ausgabeverzeichnis außerhalb des Repositorys:
310
311 ```sh
312 python3 scripts/validate-slice-21j.py --sbcl /nix/store/hlsiblxpxr1hax3dw9x8znd6zy097ddj-sbcl-2.5.4/bin/sbcl --output /private/tmp/topic-maps-21j-recheck
313 ```
314
315 Reader-Erweiterung, Tests, Dokumentation und geprüfte Ausführungsevidenz werden
316 zusammen lokal committet. Slice 21J endet damit.