]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-22l-xtm-occurrence-reification.md
Qualify closed XML/C14N 1.0 infrastructure for XTM resourceData
[topic-maps.git] / docs / slice-22l-xtm-occurrence-reification.md
1 # Slice 22L — XTM 2.0 Occurrence-Reification
2
3 Ausgangscommit und vorgesehener Commit-Parent:
4 `c02207856f1927302ea064bc901e07183242f2da`.
5 Branch: `codex/xtm-slice-22l`, aus dem sauberen Branch `codex/xtm-slice-22k`.
6 Der ursprüngliche Parent ist `cc1a0e02803a5705c97fb5457f6e93ad22f8b347`.
7 Der gespeicherte Ausgangsharness zählt XTM **107 PASS, 0 FAIL, 17 NOT-RUN** und
8 CTM **262 PASS, 4 FAIL, 7 NOT-RUN**. Der Ausgangsindex war leer.
9 [initial-state.json](../reports/slice-22l/initial-state.json) enthält die SHA-256
10 aller 9705 verfolgten Ausgangsdateien.
11
12 ## Normativer Vertrag und Editionsgrenze
13
14 **Normativ abgeleitet:** [XTM 2.0 §§4.3.2, 4.3.4, 4.5 und 4.15](https://www.isotopicmaps.org/sam/sam-xtm/)
15 verlangt die Auflösung der Reifier-IRI gegen die Document IRI, die Suche nach
16 einem Topic mit entsprechendem Item Identifier und bei Fehlen dessen Erzeugung.
17 Das Topic reifiziert die durch das Element dargestellte Occurrence. Der Locator
18 ist kein Item Identifier dieser Occurrence. Die Lookup-Regel ist II-basiert;
19 sie entspricht nicht dem SI-/II-Suchpfad für `topicRef`.
20
21 **Normativ abgeleitet:** [TMDM 2006 §§5.1, 5.3.4–5.3.5, 5.6, 6.2 und 6.5](https://www.isotopicmaps.org/sam/sam-model/2006-06-18/)
22 verknüpft Occurrence und Reifier invers. Gleiche Occurrences werden anhand ihrer
23 fachlichen Eigenschaften vereinigt; vorhandene Item Identifier bleiben erhalten
24 und ihre Reifier-Topics werden erforderlichenfalls zusammengeführt. Ein Topic
25 darf nicht zwei verschiedene Items reifizieren. Gleiche Item Identifier auf
26 verschiedenen Items bleiben ein Konflikt.
27
28 **Geprüfte Editionsgrenze:** Die [korrigierte Onlinefassung von 2008](https://www.isotopicmaps.org/sam/sam-model/)
29 und die [publizierten Errata](https://www.isotopicmaps.org/sam/errata.html) wurden
30 abgeglichen. Die dort benannten Korrekturen betreffen Default-Name-Type (§7.5)
31 und die Variant-Vereinigung beim Name-Merge (§6.3). Für den hier verwendeten
32 Reification-Vertrag wurde keine relevante neue Anforderung festgestellt.
33 Es erfolgt keine TMDM-Änderung und keine stillschweigende Übernahme einer anderen
34 Modellfassung.
35
36 ## Tatsächlich vor der Reader-Änderung ausgeführtes Modell-Gate
37
38 [api-preflight.lisp](../reports/slice-22l/api-preflight.lisp) führt ausschließlich
39 native Modellprüfungen aus. Der frische SBCL-2.5.4-Prozess hat weder Reader
40 aufgerufen noch Originalverträge registriert. Netzwerk und Repository-Schreiben
41 waren gesperrt. Reader- und TMDM-Hashes wurden vor und nach der Ausführung geprüft;
42 zu diesem Zeitpunkt war der Produktionsdiff leer.
43 [native-before-execution.json](../reports/slice-22l/native-before-execution.json)
44 sichert Ablauf und Hashes; [Report](../reports/slice-22l/native-before/report.json)
45 und [Log](../reports/slice-22l/native-before/run.log) enthalten das Ergebnis.
46
47 **Beobachtet:** Alle neun Checks bestanden: inverse Einzelzuweisung; Vereinigung
48 gleicher Occurrences nach Parent-Merging mit einem beziehungsweise zwei Reifiern;
49 II-Vereinigung; auflösbare alte Handles; Zusammenführung beider Reifier-Topics;
50 atomare Ablehnung einer konfliktbehafteten Zuweisung, eines späteren Reifier-Topic-
51 Merges, einer Kollision zwischen Occurrence-II und Reifier-Topic-II sowie der
52 Map-/Occurrence-Kollision des negativen Originals. Sechs strukturierte
53 Beobachtungen werden im regulären ASDF-Lauf unverändert wiederholt.
54
55 ## Minimale produktive Änderung
56
57 Nur `src/xtm/reader.lisp` ändert Produktionsverhalten:
58
59 - `validate-source` prüft die Reifier-IRI weiterhin, verwirft aber das gültige
60 Occurrence-Attribut nicht länger als Unsupported.
61 - `read-occurrence` verwendet nach `add-occurrence` und `read-item-identities`
62 den vorhandenen `read-item-reifier` und liefert `canonical-occurrence` zurück.
63
64 `read-item-reifier` verwendet den vorhandenen II-Lookup, `intern-topic` und
65 `set-item-reifier`. Ein II-Miss kann anschließend durch bestehendes TMDM-
66 Cross-Merging mit einem SI-Topic vereinigt werden; diese Folge ersetzt den
67 II-Lookup nicht. Eine Gegenprobe verlangt dabei den zusätzlichen Topic-II,
68 der bei einem fälschlich vorgezogenen SI-Treffer fehlen würde. Es werden keine
69 SI oder SL aus der Reifier-IRI erfunden. Modellrepräsentation, Fehlerbedingungen,
70 Normalisierung und Handle-Verwaltung bleiben im TMDM.
71
72 ## Drei Originalverträge
73
74 Die unveränderten Bytes, Texte, SHA-256 und Baselines sind in
75 [originals-before.json](../reports/slice-22l/originals-before.json) gesichert.
76 Die erneuten tatsächlichen Ergebnisse stehen in
77 [original-contracts.json](../reports/slice-22l/after/original-contracts.json).
78
79 | Original unter `xtm2/` | Quellbytes | Actual/Baseline | Ergebnis |
80 |---|---:|---:|---|
81 | `in/occurrence-reifier.xtm` | 284 | 476/476 | PASS |
82 | `in/occurrence-duplicate-reifier.xtm` | 459 | 476/476 | PASS |
83 | `invalid/reifier-collision.xtm` | 353 | negativer Vertrag | PASS, vorgesehener nativer Konflikt |
84
85 Beide positiven Maps haben genau drei Topics mit den lokalen II `#topic`,
86 `#occtype`, `#reifier` und eine Occurrence: Parent `#topic`, Type `#occtype`,
87 Value `Testing resource data.`, Datatype `xsd:string`, leerer Scope, keine eigenen
88 Occurrence-II. Reifier und inverse `reified`-Referenz sind kanonisch `EQ`.
89 Das zweite Original enthält zwei gleiche Occurrences und normalisiert sie auf
90 eine; ein ersetztes Occurrence-Handle bleibt auflösbar. Die vollständigen
91 [erzeugten CXTM-Dateien](../reports/slice-22l/after/actual/) sind byteidentisch;
92 die erste abweichende Byteposition ist jeweils `null`.
93 Beide Baselines haben SHA-256
94 `3e948871c0c2729e2b1171acaa3a7efdc25564d81b3f2d82806b4dabac4ce34e`.
95
96 Die Originale gehen über `deserialize-octets` und den qualifizierten XML-Parser,
97 mit identischen Original-Octets und genau einem Parseraufruf je positiver
98 Deserialisierung. Document IRI ist
99 `https://xtm-tests.example.invalid/cd165b150176c1d6842b37be9cc9051b40d4996b/`
100 plus vollständiger Case-ID. Source Key ist getrennt die Case-ID; ein zweiter
101 Reader-Aufruf mit anderem Key liefert gleiche native Eigenschaften und Bytes.
102 Wiederholte Kanonisierung erhält den vollständigen Modellzustand und Handles.
103
104 **Beobachteter negativer Originalfall:** Die Root-Map trägt `reifier="#reifier"`;
105 eine enthaltene Occurrence fordert denselben Topic als Reifier. Es kollidieren
106 somit **Topic-Map-Item und Occurrence**, keine Association oder Role.
107 Die tatsächliche native Zuweisung löst `REIFICATION-ERROR`, Code
108 `:reifier-conflict`, Detail `Topic already reifies a different information item.`
109 aus. Der beobachtete Zuweisungsframe nennt `OCCURRENCE` und zuvor `TOPIC-MAP`.
110 Der Modellzustand vor und nach dieser fehlgeschlagenen nativen Zuweisung ist
111 gleich. Das behauptet keine allgemeine transaktionale Deserialisierung.
112
113 Die native Condition besitzt keine Source-, Document-IRI-, Positions- oder
114 Cause-Slots. Die entsprechenden Reportwerte bleiben `null`; XML-Quelle,
115 Document IRI und Source Key stehen separat im Beobachtungsdatensatz. Es wird
116 keine Fehlerposition erfunden. Der vorhandene Harness nennt seinen generischen
117 negativen Outcome historisch `ctm-rejection`; hier qualifiziert der gemeinsame
118 Negativprüfer ausdrücklich die originale native Reification-Condition.
119 Kein vorgelagerter Unsupported-Fehler wird als PASS gezählt.
120
121 ## Dauerhafte Gegenproben und Beobachtungsgrenzen
122
123 Die beiden neuen Testdateien sind serielle Komponenten des vorhandenen
124 `topic-maps/xtm/tests` und werden von dessen `run-tests` wirklich ausgeführt.
125 Die Originale ergänzen bestehende Case Records genau einmal und erst nach
126 Modellprüfung und Originalvergleich. Alle bisherigen 107 PASS-Records bleiben
127 inhaltlich unverändert.
128
129 Vierzehn positive Reader-Proben prüfen unbekannte, vorher oder später definierte
130 Reifier, II-Treffer und SI-Cross-Merging nach II-Miss, URN sowie relative
131 prozentkodierte Unicode-IRIs, getrennte Occurrence-II, gleiche Occurrences mit
132 verschiedenen Reifiern, beide Reihenfolgen reifizierter/unreifizierter Duplikate,
133 `resourceRef` und spätes SI-/SL-/II-Merging von Parent, Type, Scope und Reifier.
134 Native Referenzen und Inversen sind `EQ`; alte Handles bleiben gültig.
135
136 Achtzehn negative Proben unterscheiden Syntax-, XML-, native Modellfehler und
137 weiterhin Unsupported. Die nachstehende Tabelle stammt aus dem tatsächlich
138 ausgeführten Report; XTM-Positionen sind approximative SAX-Zeile/Spalte.
139 Native Conditions besitzen hier keine solche Position.
140
141 | Gegenprobe | Condition | Code | Position |
142 |---|---|---|---|
143 | `bad-percent` | `XTM-REJECTION` | `invalid-percent-escape` | 1:103 |
144 | `bad-percent-UTF8` | `XTM-REJECTION` | `invalid-percent-utf8` | 1:106 |
145 | `bad-IRI` | `XTM-REJECTION` | `invalid-iri` | 1:105 |
146 | `extra-attribute` | `XTM-REJECTION` | `unexpected-attribute` | 1:112 |
147 | `reifier-on-type` | `XTM-REJECTION` | `unexpected-attribute` | 1:108 |
148 | `reifier-on-Topic` | `XTM-REJECTION` | `unexpected-attribute` | 1:91 |
149 | `reifier-on-scope` | `XTM-REJECTION` | `unexpected-attribute` | 1:143 |
150 | `malformed-XML` | `XTM-XML-ERROR` | `xml-not-well-formed` | 1:110 |
151 | `two-different-Occurrences-same-Reifier` | `REIFICATION-ERROR` | `reifier-conflict` | keine nativen Slots |
152 | `Name-and-Occurrence-same-Reifier` | `REIFICATION-ERROR` | `reifier-conflict` | keine nativen Slots |
153 | `Map-and-Occurrence-same-Reifier` | `REIFICATION-ERROR` | `reifier-conflict` | keine nativen Slots |
154 | `late-conflicting-Reifier-merge-subjectIdentifier` | `REIFICATION-ERROR` | `reifier-conflict` | keine nativen Slots |
155 | `late-conflicting-Reifier-merge-subjectLocator` | `REIFICATION-ERROR` | `reifier-conflict` | keine nativen Slots |
156 | `late-conflicting-Reifier-merge-itemIdentity` | `REIFICATION-ERROR` | `reifier-conflict` | keine nativen Slots |
157 | `Occurrence-own-II-cannot-be-Reifier-Topic-II` | `OCCURRENCE-IDENTIFIER-ERROR` | `duplicate-item-identifier` | keine nativen Slots |
158 | `anyType-remains-Unsupported` | `XTM-UNSUPPORTED` | `resource-data-datatype` | 1:202 |
159 | `Association-Reification-remains-Unsupported` | `XTM-UNSUPPORTED` | `unsupported-construct` | 1:89 |
160 | `Role-Reification-remains-Unsupported` | `XTM-UNSUPPORTED` | `unsupported-construct` | 1:129 |
161
162 Eine zusätzliche Importprobe durchläuft den bestehenden XTM-`mergeMap`-Pfad mit
163 reifizierter Occurrence, II und Scope. Sie prüft Parent-Merging, inverse
164 Beziehungen, kanonische Referenzen und den unveränderten Quellmap-Zustand.
165 Die 33 neuen Kontrolldatensätze enthalten somit 14 positive, 18 negative und
166 eine Importbeobachtung. Quellen, native Eigenschaften und Conditions stehen in
167 `after/xtm.json`, Feld `occurrenceReifierControls`; der Importpfad zusätzlich in
168 `mergemapControls`.
169
170 Die vorhandene sprachübergreifende Probe `occurrence-scope-reifier` wird von
171 einer dokumentierten Fähigkeitslücke zu einem tatsächlich deserialisierten
172 Vergleichspaar: vier Topics, eine Integer-Occurrence mit Scope und Reifier,
173 übereinstimmende native Eigenschaften, kanonisches EQ innerhalb jeder Map und
174 **588/588 CXTM-Bytes**. Es wird kein EQ zwischen unabhängigen Maps verlangt.
175 Alle bisherigen 28 Paare und drei Kontraste bleiben unverändert. Insgesamt
176 bestehen 29 Paare und 515 Checks; die Association-/Role-Reification-Lücke bleibt
177 sichtbar. Das zusätzliche Paar erhöht keine Original-PASS-Zahl.
178
179 ## Erhaltene Unsupported- und Executor-Kontrollen
180
181 [retargetings.json](../reports/slice-22l/retargetings.json) dokumentiert elf
182 angepasste Eingaben einschließlich ursprünglichem Zweck, alter und neuer Quelle
183 sowie erwartetem Code. Occurrence-Reification ist nun gültig; die Quellen
184 verwenden deshalb das normativ gültige, weiterhin nicht implementierte
185 `xsd:anyType`. Reifier, II und Scope bleiben gegebenenfalls erhalten.
186 `XTM-UNSUPPORTED` bleibt die Klasse, der Code wechselt gezielt von
187 `unsupported-construct` zu `resource-data-datatype`. Positive Kontrollen für
188 beliebige absolute Datentypen bleiben erhalten.
189
190 Acht strukturierte XTM-Kontrollzeilen ändern sich entsprechend; zwei ältere
191 Identity-Kontrollen sind durch ihre tatsächlich ausgeführten Checklabels
192 belegt. Die elfte ist der CTM/XTM-Mergemap-Adapter: äußerer
193 `MERGEMAP-SOURCE-UNSUPPORTED`, originale `XTM-UNSUPPORTED`-Cause, Resource-IRI,
194 Source Key und XML-Position bleiben geprüft. Sein gespeicherter Report ändert
195 ausschließlich den erwarteten Code. Die realen Unterschiede stehen in
196 [retargeted-control-observations.json](../reports/slice-22l/after/retargeted-control-observations.json)
197 und [adapter-retargeting.json](../reports/slice-22l/after/adapter-retargeting.json).
198
199 Der erste vollständige Versuch scheiterte an genau dieser zusätzlichen,
200 zunächst übersehenen Adapterquelle. Er ist als **nicht abgenommen** mit Log in
201 [attempts/](../reports/slice-22l/attempts/) erhalten. Die anschließende Änderung
202 betrifft ausschließlich die Testquelle und erwartete Diagnose. Danach wurde
203 die vollständige Regression neu ausgeführt. Kein fehlgeschlagener Versuch
204 zählt als erfolgreiche Abnahme.
205
206 Alle **113** bestehenden Executor-Fehlerkontrollen verwenden denselben
207 unveränderten Treiber. Jede wird separat ausgeführt und muss den vorgesehenen
208 ASDF-Fehlerausgang erreichen. Ihre bisherigen Case Records, Outcomes, Status
209 und Checklabels bleiben gleich; sie werden nicht als erfolgreiche
210 Originalverträge gezählt. Die neuen Originaltests werden durch diese alten
211 Fehlerinjektionen nicht irrtümlich als PASS ausgegeben.
212
213 ## Umfangsgrenze
214
215 Association-/Role-Reification, `xsd:anyType`, zyklische `mergeMap`-Semantik,
216 Map-II-Übertragung und XML-ID-Soundness bleiben unverändert außerhalb dieses
217 Slices. Keine Produktionsänderungen an TMDM, CTM, CXTM oder XML; keine Downloads,
218 HyperDoc-Änderungen, langlebigen Image-Loads, Pushes oder Deployments.
219
220 ## Vollständige Offline-Abnahme und Integrität
221
222 **Beobachtet und auditiert:** Der frische SBCL-2.5.4-Lauf mit
223 `--no-sysinit --no-userinit`, ausschließlich lokalen gepinnten Abhängigkeiten,
224 Netzwerksperre sowie gesperrten Schreibzugriffen auf Repository und HyperDoc ist
225 vollständig bestanden. Die 119 Prozesse des vollständigen Sammlers erreichen
226 jeweils ihren erwarteten Exitcode. Mit dem vorangegangenen nativen Gate sind
227 120 frische Prozesse belegt; darunter sind auch Hilfsprozesse zur lokalen
228 Vorbereitung und Python-Prüfung. Befehle, Laufzeiten, Exitcodes und Loghashes
229 stehen in [runs.json](../reports/slice-22l/after/runs.json) und
230 [execution.json](../reports/slice-22l/after/execution.json).
231
232 | Prüfung | Tatsächliches Ergebnis |
233 |---|---:|
234 | Standalone-XTM | 3447 Checks, bisherige 3339 erhalten |
235 | Native Occurrence-Reification vor Reader-Änderung | 9 Checks |
236 | TMDM-/CTM-/CXTM-Kern | 12100 Checks |
237 | XML-Qualifikation | 146 PASS, 0 FAIL |
238 | CTM/XTM-Mergemap-Integration | 217 Checks |
239 | CTM/XTM-Äquivalenz | 515 Checks, 29 Paare, 3 Kontraste, 1 verbleibende Lücke |
240 | Registrierte Slice-20A-Originale | 286 Checks |
241 | Slice-20B-Negativfälle | 25 Checks |
242 | Slice-20C-Prolog | 171 Checks |
243 | Slice-20E-empty2 | 13 Checks |
244 | Slice-20F-Integer | 112 Checks |
245 | Slice-20G-Triple-Strings | 226 Checks |
246 | Slice-20H-Encoding | 722 Checks |
247 | Executor-Fehlerkontrollen | alle 113, erwarteter Fehlerausgang |
248 | Python | 2 Tests |
249 | NFC-Oracle | 16294 Vergleiche |
250
251 Alle weiteren bisherigen XTM-Names-, Scopes-, Variants-, II-, Association-/Role-,
252 Reification- und Mergemap-Prüfungen laufen im regulären ASDF-Testsystem.
253 47 Nicht-XTM-Reports bleiben byteidentisch. Die zwei weiteren Reports enthalten
254 exakt die dokumentierte Adapter-Codeänderung beziehungsweise die neue tatsächliche
255 Äquivalenzprobe. Neue Featurefelder in alten Fault-Reports sind leer; deren
256 Kontrolländerungen beschränken sich auf die qualifizierten Retargetings.
257
258 | Registrierter Korpus | Vorher PASS/FAIL/NOT-RUN | Nachher PASS/FAIL/NOT-RUN |
259 |---|---:|---:|
260 | XTM 2.0 | 107/0/17 | **110/0/14** |
261 | CTM | 262/4/7 | **262/4/7** |
262
263 [all-124-original-statuses.json](../reports/slice-22l/after/all-124-original-statuses.json)
264 enthält jede alte/neue Registrierung und tatsächliche Diagnose.
265 [diagnostic-changes.json](../reports/slice-22l/after/diagnostic-changes.json)
266 belegt genau drei Änderungen und 121 unveränderte Diagnosen. Keine bisherige
267 PASS-Registrierung geht verloren. Der zyklische Mergemap-Vertrag, die Map-II-
268 Baselinefrage und alle anderen offenen Verträge werden nicht hochgestuft.
269
270 Die vier bekannten CTM-FAILs bleiben sichtbar:
271 `include-template.ctm`, `include-wildcard2.ctm`,
272 `occurrence-datetime-timezone2.ctm`, `occurrence-datetime2.ctm`.
273
274 [integrity.json](../reports/slice-22l/after/integrity.json) prüft Größe und SHA-256
275 aller **2006 gepinnten Korpusdateien**, einschließlich Originalquellen und
276 Baselines. Außerdem bleiben sämtliche **7406 historischen Reportdateien** und
277 alle geschützten Ausgangsdateien hashidentisch. Corpus Lock und alte Berichte
278 werden nicht verändert. Die einzige geänderte Produktionsdatei ist der
279 XTM-Reader. TMDM, CTM, CXTM und XML bleiben byteidentisch zum Ausgangscommit.
280
281 Der neue Validator verwendet den unveränderten Offline-Sammler aus Slice 22D.
282 Reproduktion in ein neues Ausgabeverzeichnis außerhalb des Repositorys:
283
284 ```sh
285 python3 scripts/validate-slice-22l.py --output /private/tmp/topic-maps-22l-new
286 python3 scripts/validate-slice-22l.py --audit-only --output /private/tmp/topic-maps-22l-new
287 ```
288
289 Das gespeicherte native Vorab-Gate ist historische Ausführungsevidenz vor der
290 Reader-Änderung; seine identischen Prüfungen werden bei der Reproduktion im
291 ASDF-Lauf wiederholt. Der Validator prüft Gate-Hashes, Produktionsausgang und
292 Reihenfolge der ursprünglichen Ausführung. Er behauptet nicht, ein neuer Lauf
293 mit dem fertigen Reader sei selbst vor dessen Änderung erfolgt.
294
295 [completion-audit.json](../reports/slice-22l/completion-audit.json) bindet die
296 abgenommenen Quellen, Dokumentation und sämtliche neuen Evidenzdateien über
297 SHA-256 an den lokalen Commit-Inhalt. Der Bericht nennt den Parent; die finale
298 Commit-ID wird nach Erstellung separat ausgegeben.