]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-2-validation.md
perf(tmdm): index association normalization merge candidates
[topic-maps.git] / docs / slice-2-validation.md
1 # Slice 2 validation: Topic Identity and Merging
2
3 The base was clean on `codex/ctm-slice-1` at the accepted commit
4 `fb60afd548d679d83fd8ec76bc5ff384c1e23e5f`. Work is on `codex/ctm-slice-2`.
5 The final commit is reported in the handoff; tests and implementation are
6 committed together only after successful validation.
7
8 ## Executed results
9
10 | Check | SBCL 2.5.4 | SBCL 2.4.10, relocated checkout |
11 | --- | --- | --- |
12 | Retained identity/name suite | 123 PASS | 123 PASS |
13 | Same-map merging suite | 646 PASS | 646 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 additional baseline property checks | PASS | PASS |
19 | Failures | 0 | 0 |
20
21 Both runs used fresh processes, ignored SBCL user/system initialization, and
22 ran under OS-denied networking. The second checkout was copied excluding Git
23 metadata and Python caches. All three generated JSON report pairs are
24 byte-identical across runtimes and relocation. Full logs, reports, exact
25 commands and artifact digests are retained in `reports/slice-2/`.
26 Both documented Lisp inspection blocks also ran in a fresh offline process;
27 `describe.log` records their objects and successful reference assertions.
28
29 The 646 merge checks comprise 134 concrete corpus/API/parser assertions and
30 512 assertions over 128 graph/order variants. An independent reachability
31 oracle considers all 64 undirected graphs on four Topics, each in forward and
32 reverse edge order. It checks components, identifier unions, Name coalescence,
33 retained handles and raw stored references. This is semantic testing, not
34 canonicalization. One previous unsupported-tail assertion was adapted to
35 check the newly implemented identity assignment; other Slice 1/1a assertions
36 remain in place.
37
38 ## Exact complete test 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-2-final-2.5.4.json /Users/rgb/workspace/topic-maps/scripts/test.sh
43
44 # Working directory: /private/tmp/ctm-slice-2-relocated-vwd_hic2/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-2-final-2.4.10.json /private/tmp/ctm-slice-2-relocated-vwd_hic2/checkout/scripts/test.sh
46 ```
47
48 Both exited zero. The execution recorder compared each byte stream directly
49 before copying it into the retained artifacts. The comparisons can also be
50 reproduced with:
51
52 ```sh
53 cmp /private/tmp/ctm-slice-2-final-2.5.4.json /private/tmp/ctm-slice-2-final-2.4.10.json
54 cmp /private/tmp/ctm-slice-2-final-2.5.4.json.semantics.json /private/tmp/ctm-slice-2-final-2.4.10.json.semantics.json
55 cmp /private/tmp/ctm-slice-2-final-2.5.4.json.merging.json /private/tmp/ctm-slice-2-final-2.4.10.json.merging.json
56 ```
57
58 For another installed SBCL, use `SBCL=/path/to/sbcl
59 TOPIC_MAPS_REPORT=/tmp/slice-2.json ./scripts/test.sh` from the checkout.
60 The launcher includes all retained and new ASDF test systems and Python
61 baseline-property checks. No network dependency is needed during execution.
62
63 ## Scope and evidence
64
65 The original five semantic case records are exactly unchanged from the
66 committed Slice 1 report. Eleven additional original identity-tail/duplicate
67 cases are separately checked against unchanged CXTM baselines. Topic matching
68 uses identifier sets, without treating observation order as canonical numbering.
69 No XML is generated or canonical output compared.
70
71 Imported status counts remain **PASS 1, FAIL 0, UNSUPPORTED 0, NOT-RUN 272**.
72 All 16 positive CXTM-EQUAL contracts remain NOT-RUN. The only imported PASS is
73 the existing specifically verified undefined-prefix rejection. No status is
74 inferred from a successful semantic property check.
75
76 All 2,006 pinned files still match their original hashes and sizes; upstream
77 inputs, baselines and corpus locks are unchanged. The corpus targets draft
78 2010-03-31, so these results do not establish full ISO conformance. No blocking
79 published-standard/corpus conflict was found for the selected cases.
80
81 Implemented requirements are bounded to TMDM 5.3.5, 5.4, 6.1, 6.2 and 6.3 for
82 the existing Topic/Name model, and CTM 3.9 identity tails using existing 3.3.6
83 resolution. See `reading-topic-merging.md` and `references/slice-2-sources.json`.
84 Reification conflicts and references in unimplemented item types remain outside
85 this model. Cross-map merges are rejected before mutation. Full IRI validation,
86 Associations/Roles, typed-name deserialization, Templates, directives and CXTM
87 canonicalization remain unsupported. No HyperDoc, server, SSH or deployment
88 work occurred. Await review before starting the next slice.