]> dreyeck.freedombox.rocks Git - topic-maps.git/blobdiff - README.md
perf(tmdm): index association normalization merge candidates
[topic-maps.git] / README.md
index 9ddb0b7749e5ef1719a0ec75c1ccfa5f4bcfa998..cd0258875e12be3c46ccd9ac18a848cd3079cb70 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,4 +1,51 @@
-# Common Lisp Topic Maps — Slice 19A
+# Common Lisp Topic Maps — Slice 19D2
+
+Slice 19D2 adds the explicit **`topic-maps/ctm/xtm`** adapter for `%mergemap`
+with `http://psi.topicmaps.org/iso13250/xtm`. The existing resolver passes raw
+bytes to the qualified XTM reader; existing TMDM Map-content import transfers
+its result. The unchanged 1,519-byte original baseline matches end-to-end.
+CTM now has **205 PASS / 4 known FAIL / 64 NOT-RUN** with the adapter loaded;
+the separate XTM corpus has **6 PASS / 0 FAIL / 118 NOT-RUN**.
+See [XTM Mergemap: API, objects, diagnostics and reproduction](docs/slice-19d2-xtm-mergemap.md).
+
+
+Slice 19D1 adds **`topic-maps/xtm`**, an XTM 2.0 identity/`instanceOf` subset.
+Six unchanged XTM sources match their original CXTM baselines byte-for-byte;
+results are separate from the unchanged **204 PASS / 4 FAIL / 65 NOT-RUN** CTM
+contracts. No CTM XTM-Mergemap integration or full XTM conformance is claimed.
+See [the XTM API, model and reproduction guide](docs/slice-19d1-xtm-identity.md).
+
+
+Slice 19D0B qualifies local, versioned CXML/closure-common encoding corrections:
+**58 original and 88 additional XML checks PASS** in fresh offline SBCL 2.5.4.
+The required entry point is `topic-maps.xml:parse-octets` after offline source
+patch preparation; it enforces external-resource denial. Slice 19D1 uses that boundary for its independent XTM 2.0 identity reader. See [encoding qualification](docs/slice-19d0b-cxml-encoding.md).
+
+Slice 19D0 made pinned CXML sources available to ASDF through the Nix source
+environment. Its initial parser qualification failed on UTF-16 supplementary
+characters and invalid UTF-8; those historical failures are retained. See
+[CXML provisioning and qualification](docs/slice-19d0-cxml.md) for exact hashes,
+offline loading, external-entity policy, the failing probes and retained regression.
+
+Slice 19C adds `%include` with controlled resources, per-level Topic-II aliases,
+immediate-parent Document/Wildcard environments, Counter propagation and
+source-preserving Template import. Imported bodies execute in the caller's
+identity/Prefix environment while errors preserve definition and invocation
+sources. See [Reading CTM Include](docs/reading-ctm-include.md) and
+[Slice 19C validation](docs/slice-19c-validation.md).
+The registered corpus is **204 PASS, 4 FAIL, 65 NOT-RUN**. All twelve Include
+contracts execute: seven byte-equal positives, three intended rejections, two
+explicit normative/baseline mismatches. The two earlier DateTime FAILs remain.
+
+Slice 19B adds CTM `%mergemap` with the CTM notation and an explicit
+`:resource-resolver` on `deserialize-string` / `deserialize-file`. Resources are
+supplied as bytes by the caller, deserialized with independent environments,
+and transferred by Slice 19A's TMDM content import. No implicit file/network
+retrieval is provided (Include is added by Slice 19C). XTM Mergemap is added by the explicit Slice 19D2 adapter.
+See [Reading CTM Mergemap](docs/reading-ctm-mergemap.md) and
+[Slice 19B validation](docs/slice-19b-validation.md).
+The registered corpus now has **194 PASS, 2 known DateTime FAIL, 77 NOT-RUN**:
+four new byte-exact positive contracts and three intended negative rejections.
 
 Slice 19A adds `topic-maps.tmdm:import-map-content`: source-preserving copying
 of Topics, Associations and their children into a target Map, followed by the
 
 Slice 19A adds `topic-maps.tmdm:import-map-content`: source-preserving copying
 of Topics, Associations and their children into a target Map, followed by the
@@ -14,8 +61,7 @@ A working ANSI Common Lisp reader for CTM identity/name syntax and
 Associations with one or more Roles, with same-map merging of Topics, Names, Associations
 and Roles, plus string/IRI-valued Occurrences, in a bounded TMDM model. HyperDoc remains a possible future client
 and is neither the codebase nor a dependency. Slice 4 adds a pure, independent
 Associations with one or more Roles, with same-map merging of Topics, Names, Associations
 and Roles, plus string/IRI-valued Occurrences, in a bounded TMDM model. HyperDoc remains a possible future client
 and is neither the codebase nor a dependency. Slice 4 adds a pure, independent
-CXTM canonicalizer for this model. Include/Mergemap and cross-document merging remain
-outside the implementation. Slice 5 adds Occurrence items and replacement merging
+CXTM canonicalizer for this model. Controlled Include/Mergemap and Map content import are described above. Slice 5 adds Occurrence items and replacement merging
 without expanding Scope, Reification or Variants. Slice 6 adds document-local
 prefixes, QName resolution and explicit datatype locators on quoted Occurrence
 values. Unknown datatypes retain their lexical values; Date timezone CXTM rules
 without expanding Scope, Reification or Variants. Slice 6 adds document-local
 prefixes, QName resolution and explicit datatype locators on quoted Occurrence
 values. Unknown datatypes retain their lexical values; Date timezone CXTM rules
@@ -220,7 +266,7 @@ the existing single-runtime environment. `<path>.typed-names.json` records Name
 atomic Core Subject conflict observations.
 `<path>.templates.json` records the 57 model observations and ten specific
 rejections, including original positions and invocation contexts.
 atomic Core Subject conflict observations.
 `<path>.templates.json` records the 57 model observations and ten specific
 rejections, including original positions and invocation contexts.
-See [Slice 19A validation](docs/slice-19a-validation.md) for current evidence.
+See [Slice 19B validation](docs/slice-19b-validation.md) for current evidence.
 [Slice 12A validation](docs/slice-12a-validation.md) records explicit Name types.
 [Slice 11 validation](docs/slice-11-validation.md) preserves the prior timezone evidence.
 [Slice 10 validation](docs/slice-10-validation.md) preserves the earlier DateTime baseline.
 [Slice 12A validation](docs/slice-12a-validation.md) records explicit Name types.
 [Slice 11 validation](docs/slice-11-validation.md) preserves the prior timezone evidence.
 [Slice 10 validation](docs/slice-10-validation.md) preserves the earlier DateTime baseline.