]> dreyeck.freedombox.rocks Git - topic-maps.git/blobdiff - README.md
feat(ctm): read associations and roles with merge-safe topic references
[topic-maps.git] / README.md
index 5316919ef9f1373f938336dddfe8e5e7aa07a549..1bbb48e3039c91fea62d251104f97940938db373 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,23 +1,27 @@
-# Common Lisp Topic Maps — Slice 2
+# Common Lisp Topic Maps — Slice 3
 
 
-A working ANSI Common Lisp reader for the first CTM identity/default-name
-subset, with same-map Topic/Name merging in a minimal TMDM model. HyperDoc
-remains a possible future client and is neither the codebase nor a dependency. There is no CXTM
-canonicalizer, association/template implementation or cross-document merge engine.
+A working ANSI Common Lisp reader for CTM identity/default-name syntax and
+unary/binary Associations, with same-map merging of Topics, Names, Associations
+and Roles in a bounded TMDM model. HyperDoc remains a possible future client
+and is neither the codebase nor a dependency. There is no CXTM canonicalizer,
+Template implementation or cross-document merge engine.
 
 Systems: `topic-maps` (the retained foundation), `topic-maps/tests`,
 `topic-maps/tmdm`, `topic-maps/ctm`, `topic-maps/ctm/tests` and
 
 Systems: `topic-maps` (the retained foundation), `topic-maps/tests`,
 `topic-maps/tmdm`, `topic-maps/ctm`, `topic-maps/ctm/tests` and
-`topic-maps/ctm/merging-tests`.
+`topic-maps/ctm/merging-tests` and `topic-maps/ctm/association-tests`.
 The core reader/model uses ANSI Common Lisp; the foundation/tooling uses
 ASDF/UIOP and Python's standard library. No Quicklisp packages are required.
 
 The core reader/model uses ANSI Common Lisp; the foundation/tooling uses
 ASDF/UIOP and Python's standard library. No Quicklisp packages are required.
 
-Start with [Reading Topic Identity and Merging](docs/reading-topic-merging.md)
+Start with [Reading the First CTM Associations](docs/reading-first-ctm-associations.md)
+for actual Association/Role items, late Topic merges and current subset boundaries.
+[Reading Topic Identity and Merging](docs/reading-topic-merging.md)
 for the current API, reference replacement, identifier tails and exact subset
 boundaries. See [Reading the First Five CTM Documents](docs/reading-first-five-ctm-documents.md)
 for original sources, actual objects, normative clauses, baseline evidence and
 copy-pasteable DESCRIBE forms. [API and boundaries](docs/slice-1-api-and-boundaries.md)
 document the accepted Slice 1 baseline; the Slice 2 document supersedes its
 statements about absent identity tails, merging and immutable Name references.
 for the current API, reference replacement, identifier tails and exact subset
 boundaries. See [Reading the First Five CTM Documents](docs/reading-first-five-ctm-documents.md)
 for original sources, actual objects, normative clauses, baseline evidence and
 copy-pasteable DESCRIBE forms. [API and boundaries](docs/slice-1-api-and-boundaries.md)
 document the accepted Slice 1 baseline; the Slice 2 document supersedes its
 statements about absent identity tails, merging and immutable Name references.
+The Slice 3 document supersedes historical statements about absent Associations/Roles.
 
 The pinned suite targets the **CTM draft dated 2010-03-31**. Passing it alone
 does not establish full ISO/IEC 13250-6:2010 conformity.
 
 The pinned suite targets the **CTM draft dated 2010-03-31**. Passing it alone
 does not establish full ISO/IEC 13250-6:2010 conformity.
@@ -40,6 +44,7 @@ In a new Common Lisp process, with this checkout selected:
 (asdf:test-system "topic-maps/tests")
 (asdf:test-system "topic-maps/ctm/tests")
 (asdf:test-system "topic-maps/ctm/merging-tests")
 (asdf:test-system "topic-maps/tests")
 (asdf:test-system "topic-maps/ctm/tests")
 (asdf:test-system "topic-maps/ctm/merging-tests")
+(asdf:test-system "topic-maps/ctm/association-tests")
 (topic-maps.test-foundation:write-validation-report
  *corpus* #p"/tmp/topic-maps-inventory.json")
 ```
 (topic-maps.test-foundation:write-validation-report
  *corpus* #p"/tmp/topic-maps-inventory.json")
 ```
@@ -81,19 +86,20 @@ CXTM baselines only under `ctm/baseline`. Auxiliary files are reported separatel
 ## Current validation and historical foundation
 
 The complete pinned corpus remains unchanged: 231 valid CTM inputs, 42 invalid
 ## Current validation and historical foundation
 
 The complete pinned corpus remains unchanged: 231 valid CTM inputs, 42 invalid
-inputs, 231 CXTM baselines and 22 CTM auxiliary files. Sixteen selected semantic
+inputs, 231 CXTM baselines and 22 CTM auxiliary files. Twenty-four selected semantic
 cases pass; their imported canonical contracts remain NOT-RUN. Only
 `ctm/invalid/prefix-undefined.ctm` is PASS under its CTM rejection contract;
 272 imported contracts remain NOT-RUN. Unsupported constructs and I/O errors
 cannot count as that required rejection.
 
 The full launcher runs the retained 54 foundation checks, two Python integrity
 cases pass; their imported canonical contracts remain NOT-RUN. Only
 `ctm/invalid/prefix-undefined.ctm` is PASS under its CTM rejection contract;
 272 imported contracts remain NOT-RUN. Unsupported constructs and I/O errors
 cannot count as that required rejection.
 
 The full launcher runs the retained 54 foundation checks, two Python integrity
-fixtures, 123 retained identity checks, 646 merge checks, imported-report validation and selected baseline
+fixtures, 123 retained identity checks, 646 merge checks, 657 Association checks,
+imported-report validation and selected baseline
 property evidence. A report path also produces `<path>.semantics.json` with
 property evidence. A report path also produces `<path>.semantics.json` with
-separate model observations, plus `<path>.merging.json` for the new cases.
+separate model observations, plus `<path>.merging.json` and `<path>.associations.json`.
 The merge checks include 128 graph/order variants with an independent reachability
 oracle. Reports are deterministic across the tested SBCL versions and checkout
 The merge checks include 128 graph/order variants with an independent reachability
 oracle. Reports are deterministic across the tested SBCL versions and checkout
-relocation. See [Slice 2 validation](docs/slice-2-validation.md),
+relocation. See [Slice 3 validation](docs/slice-3-validation.md),
 [imported contracts](reports/slice-1/validation.json) and
 [semantic observations](reports/slice-1/semantics.json).
 
 [imported contracts](reports/slice-1/validation.json) and
 [semantic observations](reports/slice-1/semantics.json).
 
@@ -104,4 +110,5 @@ about absent reader/model systems describe Slice 0, not the current branch.
 Slice 1 is built from `9c83db34eb1ba8091b004433f088056717dbaa7e` on
 `codex/ctm-slice-1`. Slice 2 starts from the accepted Slice 1a commit
 `fb60afd548d679d83fd8ec76bc5ff384c1e23e5f` on `codex/ctm-slice-2`.
 Slice 1 is built from `9c83db34eb1ba8091b004433f088056717dbaa7e` on
 `codex/ctm-slice-1`. Slice 2 starts from the accepted Slice 1a commit
 `fb60afd548d679d83fd8ec76bc5ff384c1e23e5f` on `codex/ctm-slice-2`.
-Associations/Roles are not part of this slice; await review before continuing.
+Slice 3 starts from accepted `66664dbff6275d60dab1bc6a232fa70f7b916b8c` on
+`codex/ctm-slice-3`. Await review before continuing to the next slice.