]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-3-validation.md
Support XTM topic map reification (Slice 21L)
[topic-maps.git] / docs / slice-3-validation.md
1 # Slice 3 validation: Associations and Roles
2
3 Base was observed clean on `codex/ctm-slice-2` at accepted commit
4 `66664dbff6275d60dab1bc6a232fa70f7b916b8c`. Work is on `codex/ctm-slice-3`.
5 The final delivery commit is reported in the handoff after validation.
6
7 ## Executed complete runs
8
9 | Check | SBCL 2.5.4 | SBCL 2.4.10, relocated checkout |
10 | --- | --- | --- |
11 | Identity/name suite | 123 PASS | 123 PASS |
12 | Topic/Name merging suite | 646 PASS | 646 PASS |
13 | Association/Role suite | 657 PASS | 657 PASS |
14 | Foundation regressions | 54 PASS | 54 PASS |
15 | Python integrity fixtures | 2 PASS | 2 PASS |
16 | Imported report validation | PASS | PASS |
17 | Original five baseline property checks | PASS | PASS |
18 | Eleven Slice 2 baseline property checks | PASS | PASS |
19 | Eight Association baseline property checks | PASS | PASS |
20 | Failures | 0 | 0 |
21
22 There are 1,426 semantic assertions per runtime. The 657 Association checks
23 include 145 concrete corpus/API/parser/reference assertions and 512 assertions
24 over 128 graph/order variants. Seven nonempty combinations of affected
25 Association type, Role type and Role player are tested after construction.
26 Stored fields, retained handles, transitive replacements, combined Name and
27 Association references, duplicate Roles/Associations, inverse roles played,
28 unordered Role sets and atomic rejection of foreign-map references are checked.
29 One former unsupported-Association assertion is adapted to successful parsing;
30 other prior suites retain their totals.
31
32 Both runs use fresh processes with user/system initialization disabled and
33 OS-denied networking. The relocated copy excludes `.git` and Python caches.
34 All four JSON report pairs are byte-identical across runtimes and relocation.
35 Full logs, reports, exact command vectors and artifact hashes are retained
36 under `reports/slice-3/`.
37
38 ## Exact commands
39
40 ```sh
41 # Working directory: /Users/rgb/workspace/topic-maps
42 /usr/bin/sandbox-exec -p '(version 1)(allow default)(deny network*)' /usr/bin/env PYTHONDONTWRITEBYTECODE=1 SBCL=/nix/store/hlsiblxpxr1hax3dw9x8znd6zy097ddj-sbcl-2.5.4/bin/sbcl TOPIC_MAPS_REPORT=/private/tmp/ctm-slice-3-final-2.5.4.json /Users/rgb/workspace/topic-maps/scripts/test.sh
43
44 # Working directory: /private/tmp/ctm-slice-3-relocated-f2q69ba3/checkout
45 /usr/bin/sandbox-exec -p '(version 1)(allow default)(deny network*)' /usr/bin/env PYTHONDONTWRITEBYTECODE=1 SBCL=/nix/store/y96nx8571mpdvjd40krkdim2av0in972-sbcl-2.4.10/bin/sbcl TOPIC_MAPS_REPORT=/private/tmp/ctm-slice-3-final-2.4.10.json /private/tmp/ctm-slice-3-relocated-f2q69ba3/checkout/scripts/test.sh
46 ```
47
48 Both exited zero. The recorder compares complete byte streams before retaining
49 the reports. Equivalent comparison commands:
50
51 ```sh
52 cmp /private/tmp/ctm-slice-3-final-2.5.4.json /private/tmp/ctm-slice-3-final-2.4.10.json
53 cmp /private/tmp/ctm-slice-3-final-2.5.4.json.semantics.json /private/tmp/ctm-slice-3-final-2.4.10.json.semantics.json
54 cmp /private/tmp/ctm-slice-3-final-2.5.4.json.merging.json /private/tmp/ctm-slice-3-final-2.4.10.json.merging.json
55 cmp /private/tmp/ctm-slice-3-final-2.5.4.json.associations.json /private/tmp/ctm-slice-3-final-2.4.10.json.associations.json
56 ```
57
58 For another installed runtime, set `SBCL=/path/to/sbcl` and
59 `TOPIC_MAPS_REPORT=/tmp/slice-3.json` when invoking `./scripts/test.sh`.
60 The launcher runs all retained and new ASDF tests and the independent Python
61 property oracles. No network acquisition is required.
62
63 ## Acceptance evidence and boundaries
64
65 `association.ctm` produces three Topics, an Association and a distinct Role:
66 five information items apart from the map, six including it. The binary case
67 produces five Topics, an Association and two Roles, nine including the map.
68 Role parent/type/player are actual references. The required late-merge matrix
69 inspects raw stored reference fields, so forwarding getters cannot hide stale
70 live references. Computed roles-played is checked against the live Role set.
71
72 The eight originals exercised are `association.ctm`, `association-binary.ctm`,
73 `association-binary-duplicate.ctm`, `association-type-sid.ctm` and the four
74 `association-with-comment` cases. The property oracle maps Topics by identifier
75 sets and Associations/Roles by structural signatures, and checks inverse links.
76 No observation order is treated as CXTM numbering; no XML is generated.
77
78 All prior 16 selected case observations are exactly unchanged from committed
79 Slice 2 reports. Imported statuses remain **PASS 1, FAIL 0, UNSUPPORTED 0,
80 NOT-RUN 272**. All 24 inspected positive CXTM-EQUAL contracts remain NOT-RUN;
81 only the existing specific undefined-prefix rejection is an imported PASS.
82
83 All 2,006 upstream files match pinned sizes and SHA-256 hashes. Inputs,
84 baselines and corpus locks are unchanged. The corpus targets draft 2010-03-31;
85 these selected properties do not prove full CTM/TMDM or CXTM conformity. No
86 blocking published-standard/corpus conflict was found for the selected cases.
87
88 Scope is limited to CTM one/two-role declarations and unscoped, unreified
89 Association/Role items. Empty/null properties are implicit. Larger CTM arities,
90 embedded Topics, scope/reification, prefix directives, Templates, typed Names,
91 Occurrences/Variants, special vocabulary relationships, full IRI validation,
92 cross-document merging and CXTM canonicalization remain outside this slice.
93 See `reading-first-ctm-associations.md` and `references/slice-3-sources.json`.
94 No HyperDoc, server, SSH or deployment work occurred. Await review before the
95 next slice.