X-Git-Url: https://dreyeck.freedombox.rocks/gitweb/topic-maps.git/blobdiff_plain/66664dbff6275d60dab1bc6a232fa70f7b916b8c..6a2f8446afca0915882f0d4a06cb891ccfcdc96d:/README.md diff --git a/README.md b/README.md index 5316919..6148594 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,61 @@ -# Common Lisp Topic Maps — Slice 2 - -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. +# Common Lisp Topic Maps — Slice 11 + +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, 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. Templates and cross-document merging remain +outside the implementation. 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 +remain explicitly unsupported. Slice 7 adds integer literals, lexical validation +and pure xsd:integer canonical output; qualified strings retain their stored +lexical values. Slice 8 adds decimal literals, exact character-based xsd:decimal +canonicalization and lexical validation, with the same separation of stored +strings, TMDM equality and canonical serialization. Slice 9 adds timezone-free +xsd:date literals, Gregorian calendar validation and pure CXTM Date output. +Negative-year leap validation follows the documented XSD 1.0 E.1 interpretation. +Slice 10 adds xsd:dateTime with absent/zero zones, exact fractional precision and +midnight rollover. A noncandidate leap-second baseline disagrees with XSD D.1 +following-minute interpretation and remains FAIL. Slice 11 adds exact nonzero-offset UTC canonicalization; the original timezone2 +contract now executes and reports its known inconsistent baseline as FAIL. +Nonzero-offset BCE day rollover and leap-second contexts remain explicitly +unsupported; existing zero/absent-zone behavior is retained. 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`, plus `topic-maps/cxtm` and +`topic-maps/cxtm/tests`, `topic-maps/ctm/occurrence-tests` and `topic-maps/ctm/prefix-tests` and `topic-maps/ctm/integer-tests`, plus `topic-maps/ctm/decimal-tests` and `topic-maps/ctm/date-tests` and `topic-maps/ctm/datetime-tests` and `topic-maps/ctm/timezone-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. -Start with [Reading Topic Identity and Merging](docs/reading-topic-merging.md) +Start with [Reading DateTime Timezone Canonicalization](docs/reading-datetime-timezones.md) +for UTC conversion, calendar limits, actual stored strings and executable inspection. +[Reading DateTime Occurrences](docs/reading-datetime-occurrences.md) +for lexical/value/canonical distinctions and the two normative discrepancies. +[Reading Date Occurrences](docs/reading-date-occurrences.md) +for the ten original Date cases, calendar rules, stored values and inspection. +[Reading Decimal Occurrences](docs/reading-decimal-occurrences.md) +for the seven Decimal cases, string representation, equality and inspection. +[Reading Integer Occurrences](docs/reading-integer-occurrences.md) +for integer representation, lexical equality, canonicalization and inspection. +[Reading Prefixes and Explicit Datatypes](docs/reading-prefixes-and-datatypes.md) +for the seven original cases, current API, object properties and diagnostics. +[Reading the First Four CTM Occurrences](docs/reading-first-occurrences.md) +for actual parent/type references, literal values, datatypes and executable inspection. +[Reading Canonical Topic Maps](docs/reading-canonical-topic-maps.md) +for the CXTM API, normative clauses, base-locator policy and actual byte comparisons. +[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. +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. @@ -40,6 +78,8 @@ 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/ctm/association-tests") +(asdf:test-system "topic-maps/ctm/decimal-tests") ; includes retained Integer/Prefix/Occurrence/CXTM suites (topic-maps.test-foundation:write-validation-report *corpus* #p"/tmp/topic-maps-inventory.json") ``` @@ -81,19 +121,45 @@ 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 -inputs, 231 CXTM baselines and 22 CTM auxiliary files. Sixteen 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 +inputs, 231 CXTM baselines and 22 CTM auxiliary files. Fifty-four selected positive +cases pass actual CXTM byte comparisons, including three added by Slice 10. These 54 `:CXTM-EQUAL` +contracts are PASS. Eight rejection contracts also pass: the five selected Date +cases and `prefix-undefined`, `prefix-collision`, `prefix-undefined2`. +One executed leap-second `:CXTM-EQUAL` contract is FAIL due to a documented normative +baseline discrepancy; 210 imported contracts remain NOT-RUN, including the +nonzero-offset DateTime original. A green local test run preserves that FAIL, +rather than changing the upstream baseline. 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 -property evidence. A report path also produces `.semantics.json` with -separate model observations, plus `.merging.json` for the new cases. +fixtures, 123 retained identity checks, 646 merge checks, 657 Association checks, +imported-report validation and selected baseline +property evidence, 445 retained CXTM checks, 1,101 Occurrence checks, 150 prefix/datatype checks, 665 integer checks, 715 Decimal checks, 1,806 Date checks, 215 DateTime checks and +16,294 independent Unicode NFC oracle +comparisons. The oracle needs Python UCD 15.0 or 15.1 (tables use UCD 15.1.0). +A report path also produces `.semantics.json` with +separate model observations, plus `.merging.json`, `.associations.json` +and `.cxtm.json` (complete actual/expected XML and byte counts), +plus `.occurrences.json` with separate actual Occurrence objects/properties +and `.prefixes.json` with all seven selected observations, plus `.integers.json` for integer objects +and independently checked arithmetic probes, plus `.decimals.json` with +seven Decimal object observations and 157 independent Decimal arithmetic probes, +plus `.dates.json` with five original Date results, five original rejections, +396 independent date/calendar probes and 15 century decisions. `.datetimes.json` records five actual DateTime +models, 45 independent lexical/canonical probes and two executed baseline +discrepancies. `.timezones.json` adds exact UTC, fraction and model-purity +probes, including every one of the 1681 permitted signed offset minutes. 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 11 validation](docs/slice-11-validation.md) for current evidence. +[Slice 10 validation](docs/slice-10-validation.md) preserves the earlier DateTime baseline. +[Slice 9 validation](docs/slice-9-validation.md) records the accepted Date subset. +[Slice 8 validation](docs/slice-8-validation.md) records the accepted Decimal subset. +[Slice 7 validation](docs/slice-7-validation.md) records the accepted Integer subset. +[Slice 6 validation](docs/slice-6-validation.md) records the preceding accepted subset. +[Slice 5 validation](docs/slice-5-validation.md) records the preceding accepted subset. +[Slice 4 validation](docs/slice-4-validation.md) records the accepted baseline. +[Slice 3 validation](docs/slice-3-validation.md), [imported contracts](reports/slice-1/validation.json) and [semantic observations](reports/slice-1/semantics.json). @@ -104,4 +170,21 @@ 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`. -Associations/Roles are not part of this slice; await review before continuing. +Slice 11 starts from `8741d155d948c7317945eee423a977940cad995e` on +`codex/ctm-slice-11`. +Slice 10 starts from `2ad41cd1a945a4ce97824464de40646bb899259e` on +`codex/ctm-slice-10`. +Slice 9 starts from `195d5f5444d776096b765d04c815c23c3db5f84c` on +`codex/ctm-slice-9`. +Slice 8 starts from `17dd58775e25ab495e3c83deb4b5a36f5e5a124b` on +`codex/ctm-slice-8`. +Slice 7 starts from `3924d1eac5a070fe5a6a26683e23ac338793f544` on +`codex/ctm-slice-7`. +Slice 6 starts from `437ad53ea7539d36db3fa871d0931650b7a6a03e` on +`codex/ctm-slice-6`. +Slice 5 starts from `8036a2b1ce009218f33d300edcc5f715ec1d1124` on +`codex/ctm-slice-5`. +Slice 4 starts from `35648c4dcc71e8dc6448b64abcacb438e53d64a2` on +`codex/ctm-slice-4`. +Slice 3 starts from accepted `66664dbff6275d60dab1bc6a232fa70f7b916b8c` on +`codex/ctm-slice-3`. Await review before continuing to the next slice.