]> dreyeck.freedombox.rocks Git - topic-maps.git/blob - docs/slice-17a-validation.md
Implement XTM association and role core with original conformance evidence
[topic-maps.git] / docs / slice-17a-validation.md
1 # Slice 17A — Association arity validation
2
3 Base: `f1270a43720ab1454bebfb3d0a9e3555554a7ab9`; local branch
4 `codex/ctm-slice-17a`. Runtime, UTC interval, source hashes and artifact hashes
5 are recorded in `reports/slice-17a/execution.json`.
6
7 From the repository root:
8
9 ```sh
10 python3 scripts/validate-slice-17a.py --sbcl /nix/store/hlsiblxpxr1hax3dw9x8znd6zy097ddj-sbcl-2.5.4/bin/sbcl
11 ```
12
13 The complete retained suite runs in a fresh SBCL process with user startup and
14 user ASDF registries excluded, under `sandbox-exec` denying network access.
15 No extra runtime versions, relocation, or cache-management changes are involved.
16
17 ## Acceptance and evidence
18
19 - **10,301 Lisp checks pass: 9,964 retained and 337 new arity checks.**
20 All retained assertions remain, including adapted feature-boundary
21 assertions for now-supported n-ary Associations. Additional arity checks cover
22 1/2/3/4/32/64 declarations, all 24 permutations of four Roles, repeated
23 declarations, and declarations that normalize to only one or two Role items.
24 - Player, Role Type, Association Type and Scope-theme merging are exercised
25 through both explicit merges and shared Topic identifiers, in both orders.
26 Role and Association Item Identifiers, Reifiers, inverse references and old
27 handles survive, including further replacement steps and scope collapse.
28 - QNames, explicit Item Identifiers, Subject Locators, Wildcards, Embedded Topics,
29 nonempty Scope and source Role/Association Reifiers retain their existing
30 semantics. Syntax errors and undefined prefixes have exact class/code/position
31 assertions. `isa`/`ako` remain unsupported.
32 - Exactly one imported contract transitions: `association-duplicate-role.ctm`,
33 NOT-RUN → PASS after real deserialization and 1,157 byte-equal CXTM bytes.
34 - Corpus: **107 PASS, 2 FAIL, 0 UNSUPPORTED, 164 NOT-RUN**.
35 The FAILs remain `occurrence-datetime2.ctm` and
36 `occurrence-datetime-timezone2.ctm` with unchanged outputs and diagnostics.
37 - The validator compares all prior 94 successful and two failing CXTM outputs,
38 every retained model observation, all unchanged imported case records and
39 prior suite counts. TMDM/CXTM source, references and corpus match the base.
40 - `arity.json` contains per-check labels, original source and actual EQ-reference
41 observations; twelve additional XML witnesses are checked independently for
42 canonical serialization, numbering and complete Role/Topic references.
43 - `original-reader-control.log` demonstrates the original reader's
44 CTM-UNSUPPORTED/:ASSOCIATION-ARITY at position 48 in another disposable process.
45 The documented inspection forms run independently and produce `describe.log`.
46
47 Both Python unit tests, the 16,294 independent NFC comparisons and every
48 independent report checker pass. The recorded full-run total and individual suite counts are in `execution.json`;
49 `tests.log` includes Python, NFC, Lisp and independent report-checker outcomes.
50 The open Core-Subject identity requirement for 17B is documented in
51 `reading-association-arity.md`. No change to that model behavior is claimed.