|
The agreement check compared ten fields of each object. That was enough
to find the blank-first-line defect and not enough for anything
subtler, so this adds ocda-dump: the whole loaded model written out
canonically, every field, sorted dictionaries, sections in format
order, defaults omitted. It is an oracle, not an output format. Two
implementations of this model can now be compared with diff.
Run against the reference collection it found four disagreements
between the two loaders, none of which the ten-field check could see.
1. .identifier and .anchor. The .ssp emits a property only when it
carries information, so the identifier is absent when it is simply
the ocn and the anchor is absent when it is the segment name; the
database stores both unconditionally. Over one document that is
1,314 identifiers and 69 anchors. The loader now derives them, which
is what the model means: an object's identifier is its ocn unless it
says otherwise.
2. make and doc_has. The database has one metadata table where the
text form has three blocks, and tells them apart by a key prefix.
The loader now unprefixes them, so a writer asks doc.make["footer"]
whichever serialisation it was handed and never
doc.metadata["make.footer"].
3. The JSON columns were read by a character scan that stripped
brackets and quotes, which is wrong the moment a value holds an
escape: JSONValue.toString escapes "/" as "\/", so every heading
containing a slash came back with a backslash in it. All 36
document-languages differed on heading_ancestors_text. Now parsed as
JSON.
4. translation.ocn_aligned is in the database and not in the .ssp,
legitimately: it says whether the languages share one numbering, and
a .ssp is one language and cannot know. It is a fact about the file
rather than the document, so the loader leaves it out rather than
letting a writer tell which serialisation it was given.
Metadata values are also stripped now, as the text loader strips them:
one topic_register value carried surrounding spaces in the database
that the text form cannot represent.
After all four: 36 of 36 document-languages give byte identical dumps
from their .ssp and from their .ocda.db.
(assisted by Claude-Code)
|