]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-1-validation.md
Add XTM name scope with five original contracts and offline evidence
[topic-maps.git] / docs / slice-1-validation.md
1 # Slice 1 validation
2
3 Implemented on `codex/ctm-slice-1` in `/Users/rgb/workspace/topic-maps`, from the
4 observed clean Slice 0 commit `9c83db34eb1ba8091b004433f088056717dbaa7e`.
5 The delivery commit is obtained with `git rev-parse HEAD` and reported in the
6 handoff; implementation and its tests are committed together after passing.
7
8 **100 semantic checks pass; zero fail.** The five selected original files yield
9 actual Topic Map, Topic and Topic Name objects. The required negative original
10 file is rejected specifically for its undefined prefix. The retained 54
11 foundation checks and two Python integrity fixture tests pass. The obsolete
12 foundation assumption that no reader/model system exists is adapted to verify
13 the still-absent canonicalizer; its other tests are retained.
14
15 The immutable corpus remains at `cd165b150176c1d6842b37be9cc9051b40d4996b`.
16 All 2,006 upstream hashes match. **It targets CTM draft 2010-03-31; passing it
17 alone cannot establish full ISO/IEC 13250-6:2010 conformity.** Published ISO
18 standards remain authoritative. No conflict was found blocking a selected case.
19
20 ## Separate results
21
22 | Result class | Observed result |
23 | --- | --- |
24 | Five imported semantic cases | PASS, actual model properties and cardinalities checked |
25 | Independent semantic regressions | PASS: Document IRI, separate identifier kinds, duplicate references, default type reuse, parent/type object identity, Unicode, UTF-8, errors and unsupported constructs |
26 | Original positive `CXTM-EQUAL` contracts | All five remain NOT-RUN |
27 | Original `prefix-undefined.ctm` rejection contract | PASS: typed undefined-prefix condition at character 1, line 2, column 1 |
28 | All imported statuses | PASS 1; FAIL 0; UNSUPPORTED 0; NOT-RUN 272 |
29 | Selected baseline evidence | Expected properties checked against five frozen XML baselines; no XML generated and no canonical equality claimed |
30 | OS-enforced offline runs | PASS with fresh SBCL 2.5.4 and 2.4.10 |
31 | Relocation | Both imported and semantic JSON reports reproduce byte-for-byte |
32 | Standard DESCRIBE inspection | PASS in a fresh SBCL process |
33 | HyperDoc / services | Both observed checkouts clean; no server, deployment or running-image changes |
34
35 [Imported contracts](../reports/slice-1/validation.json),
36 [separate semantic observations](../reports/slice-1/semantics.json),
37 [successful 2.5.4 log](../reports/slice-1/tests-2.5.4.log),
38 [relocated 2.4.10 log](../reports/slice-1/tests-2.4.10-relocated.log), and
39 [execution record with digests](../reports/slice-1/execution.json) are retained.
40 The semantic report's Topic ordinals describe creation/inspection order; they
41 are not CXTM numbering or a canonicalization implementation.
42
43 ## Exact reproduction commands
44
45 From `/Users/rgb/workspace/topic-maps`:
46
47 ```sh
48 /usr/bin/sandbox-exec -p '(version 1)(allow default)(deny network*)' \
49 /usr/bin/env \
50 SBCL=/nix/store/hlsiblxpxr1hax3dw9x8znd6zy097ddj-sbcl-2.5.4/bin/sbcl \
51 TOPIC_MAPS_REPORT=/private/tmp/ctm-slice-1-final.json \
52 scripts/test.sh
53 ```
54
55 A copy of the final implementation checkout excluding `.git` and Python caches
56 was made at `/private/tmp/ctm-slice-1-relocated`, then:
57
58 ```sh
59 /usr/bin/sandbox-exec -p '(version 1)(allow default)(deny network*)' \
60 /usr/bin/env \
61 SBCL=/nix/store/y96nx8571mpdvjd40krkdim2av0in972-sbcl-2.4.10/bin/sbcl \
62 TOPIC_MAPS_REPORT=/private/tmp/ctm-slice-1-relocated.json \
63 /private/tmp/ctm-slice-1-relocated/scripts/test.sh
64
65 cmp /private/tmp/ctm-slice-1-final.json /private/tmp/ctm-slice-1-relocated.json
66 cmp /private/tmp/ctm-slice-1-final.json.semantics.json \
67 /private/tmp/ctm-slice-1-relocated.json.semantics.json
68 ```
69
70 Both commands and comparisons exited zero. `scripts/test.sh` runs corpus hashes,
71 Python integrity fixtures, `asdf:test-system "topic-maps/tests"`,
72 `asdf:test-system "topic-maps/ctm/tests"`, independent JSON validation and
73 selected baseline-property checks. On another machine substitute installed SBCL
74 paths and an appropriate network-denial executor. The library itself has no
75 macOS dependency; SBCL launch flags remain outside the ANSI reader/model.
76
77 For a simple installed-runtime reproduction:
78
79 ```sh
80 SBCL=/path/to/sbcl TOPIC_MAPS_REPORT=/tmp/slice-1.json ./scripts/test.sh
81 ```
82
83 Implemented clauses and precise subset boundaries are in
84 [API and boundaries](slice-1-api-and-boundaries.md) and the
85 [consulted-source record](../references/slice-1-sources.json).
86 [Reading the First Five CTM Documents](reading-first-five-ctm-documents.md)
87 provides original sources, actual observations and exercised inspection forms.
88 Remaining unsupported functionality includes the full merge model, CXTM,
89 associations/roles, occurrences, variants, scope/reification, templates,
90 directives, typed names, topic-tail identity assignments and other encodings.
91 Full IRI/scheme validation is also outside this slice.
92
93 **Ready for Slice 2: Yes.** Slice 2 is not started. Await review of this reader,
94 minimal model and the distinct test/report contracts before continuing.